Add Media Router JS structs.

chrome/browser/resources/media_router/media_router_data.js

+// Copyright (c) 2015 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+// Any strings used here will already be localized. Values such as castMode or
+// IDs will be defined elsewhere and determined later.
+cr.define('media_router', function() {
+  'use strict';
+
+  /**
+   * @enum {string}
+   */
+  var SinkStatus = {
+    IDLE: 'idle',
+    ACTIVE: 'active',
+    REQUEST_PENDING: 'request_pending'
+  };
+
+
+  /**
+   * @param {number} castMode The type of cast mode.
+   * @param {string} title The title of the cast mode.
+   * @param {string} description The description of the cast mode.
+   * @constructor
+   * @struct
+   */
+  var CastMode = function(castMode, title, description) {
+    /** @type {number} */
+    this.castMode = castMode;
+
+    /** @type {string} */
+    this.title = title;
+
+    /** @type {string} */
+    this.description = description;
+  };
+
+
+  /**
+   * @param {string} id The ID of this issue.
+   * @param {string} title The issue title.
+   * @param {string} message The issue message.
+   * @param {string} defaultActionText The button text of default action.
+   * @param {number} defaultActionType The type of default action.
+   * @param {?string} opt_secondaryActionText The button text of optional

[haibinlu, 2015/03/25 00:22:58]

rename to secondaryActionText?

per closure annotation, if this is an optional param, it should {string=}, which
is string or undefined.

[apacible, 2015/03/25 00:50:20]

Talked offline with haibinlu@ -- for this case, we don't want to use the strict
definition of "optional" parameters, so we want to keep the names of these
parameters the same as before. "optAction*" will be "secondaryAction*".

+   *                  action.
+   * @param {?number} opt_secondaryActionType The type of optional action.
+   * @param {?string} opt_mediaRouteId The route ID to which this issue
+   *                  pertains. If not set, this is a global issue.
+   * @param {boolean} isBlocking True if this issue blocks other UI.
+   * @param {?string} opt_helpURL The URL to be opened if learn more is
+   *                  clicked.

[haibinlu, 2015/03/25 00:22:58]

ditto

[apacible, 2015/03/25 00:50:20]

Done.

+   * @constructor
+   * @struct
+   */
+  var Issue = function(id, title, message, defaultActionText,
+                       defaultActionType, opt_secondaryActionText,
+                       opt_secondaryActionType, opt_mediaRouteId, isBlocking,
+                       opt_helpURL) {
+    /** @type {string} */
+    this.id = id;
+
+    /** @type {string} */
+    this.title = title;
+
+    /** @type {string} */
+    this.message = message;
+
+    /** @type {string} */
+    this.defaultActionText = defaultActionText;
+
+    /** @type {number} */
+    this.defaultActionType = defaultActionType;
+
+    /** @type {?string} */
+    this.secondaryActionText = opt_secondaryActionText;
+
+    /** @type {?number} */
+    this.secondaryActionType = opt_secondaryActionType;
+
+    /** @type {?string} */
+    this.mediaRouteId = opt_mediaRouteId;
+
+    /** @type {boolean} */
+    this.isBlocking = isBlocking;
+
+    /** @type {?string} */
+    this.helpURL = opt_helpURL;
+  };
+
+
+  /**
+   * @param {string} id The media route ID.
+   * @param {string} sinkId The ID of the media sink running this route.
+   * @param {string} title The short description of this route.
+   * @param {?number} opt_tabId The ID of the tab in which web app is running
+   *                  and accessing the route.
+   * @param {boolean} isLocal True if this is a locally created route.
+   * @constructor
+   * @struct
+   */
+  var Route = function(id, sinkId, title, opt_tabId, isLocal) {
+    /** @type {string} */
+    this.id = id;
+
+    /** @type {string} */
+    this.sinkId = sinkId;
+
+    /** @type {string} */
+    this.title = title;
+
+    /** @type {?number} */
+    this.tabId = opt_tabId;
+
+    /** @type {boolean} */
+    this.isLocal = isLocal;
+  };
+
+
+  /**
+   * @param {string} id The ID of the media sink.
+   * @param {string} name The name of the sink.
+   * @param {media_router.SinkStatus} status The readiness state of the sink.
+   * @param {!Array<number>} castModes Cast modes compatible with the sink.
+   * @constructor
+   * @struct
+   */
+  var Sink = function(id, name, status) {
+    /** @type {string} */
+    this.id = id;
+
+    /** @type {string} */
+    this.name = name;
+
+    /** @type {media_router.SinkStatus} */
+    this.status = status;
+
+    /** @type {!Array<number>} */
+    this.castModes = castModes;
+  };
+
+
+  /**
+   * @param {number} tabId The current tab ID.
+   * @param {string} domain The domain of the current tab.
+   * @constructor
+   * @struct
+   */
+  var TabInfo = function(tabId, domain) {
+    /** @type {number} */
+    this.tabId = tabId;
+
+    /** @type {string} */
+    this.domain = domain;
+  };
+
+  return {
+    SinkStatus: SinkStatus,
+    CastMode: CastMode,
+    Issue: Issue,
+    Route: Route,
+    Sink: Sink,
+    TabInfo: TabInfo,
+  };
+});