MD Settings: Display: Add unified desktop control and modify api

third_party/closure_compiler/externs/system_display.js

 // Copyright 2016 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.
 
 // This file was generated by:
 //   ./tools/json_schema_compiler/compiler.py.
 // NOTE: The format of types has changed. 'FooType' is now
 //   'chrome.system.display.FooType'.
 // Please run the closure compiler before committing changes.
 // See https://chromium.googlesource.com/chromium/src/+/master/docs/closure_compilation.md
@@ skipping 99 matching lines @@
 chrome.system.display.DisplayLayout;
 
 /**
  * @typedef {{
  *   id: string,
  *   name: string,
  *   mirroringSourceId: string,
  *   isPrimary: boolean,
  *   isInternal: boolean,
  *   isEnabled: boolean,
+ *   isUnified: boolean,
  *   dpiX: number,
  *   dpiY: number,
  *   rotation: number,
  *   bounds: !chrome.system.display.Bounds,
  *   overscan: !chrome.system.display.Insets,
  *   workArea: !chrome.system.display.Bounds,
  *   modes: !Array<!chrome.system.display.DisplayMode>,
  *   hasTouchSupport: boolean
  * }}
  * @see https://developer.chrome.com/extensions/system.display#type-DisplayUnitInfo
  */
 chrome.system.display.DisplayUnitInfo;
 
 /**
  * @typedef {{
+ *   isUnified: (boolean|undefined),
  *   mirroringSourceId: (string|undefined),
  *   isPrimary: (boolean|undefined),
  *   overscan: (!chrome.system.display.Insets|undefined),
  *   rotation: (number|undefined),
  *   boundsOriginX: (number|undefined),
  *   boundsOriginY: (number|undefined),
  *   displayMode: (!chrome.system.display.DisplayMode|undefined)
  * }}
  * @see https://developer.chrome.com/extensions/system.display#type-DisplayProperties
  */
 chrome.system.display.DisplayProperties;
 
 /**
- * Get the information of all attached display devices.
+ * @typedef {{
+ *   singleUnified: (boolean|undefined)
+ * }}
+ * @see https://developer.chrome.com/extensions/system.display#type-GetInfoFlags
+ */
+chrome.system.display.GetInfoFlags;
+
+/**
+ * Requests the information for all attached display devices.
+ * @param {!chrome.system.display.GetInfoFlags} flags See $(ref:GetInfoFlags).
  * @param {function(!Array<!chrome.system.display.DisplayUnitInfo>):void}
- *     callback
+ *     callback This will be invoked with an array of $(ref:DisplayUnitInfo).
  * @see https://developer.chrome.com/extensions/system.display#method-getInfo
  */
-chrome.system.display.getInfo = function(callback) {};
+chrome.system.display.getInfo = function(flags, callback) {};
 
 /**
- * Get the layout info for all displays. NOTE: This is only available to Chrome
- * OS Kiosk apps and Web UI.
+ * Requests the layout info for all displays. NOTE: This is only available to
+ * Chrome OS Kiosk apps and Web UI.
  * @param {function(!Array<!chrome.system.display.DisplayLayout>):void} callback
+ *     This will be invoked with an array of $(ref:DisplayLayout).
  * @see https://developer.chrome.com/extensions/system.display#method-getDisplayLayout
  */
 chrome.system.display.getDisplayLayout = function(callback) {};
 
 /**
  * Updates the properties for the display specified by |id|, according to the
  * information provided in |info|. On failure, $(ref:runtime.lastError) will be
  * set. NOTE: This is only available to Chrome OS Kiosk apps and Web UI.
  * @param {string} id The display's unique identifier.
  * @param {!chrome.system.display.DisplayProperties} info The information about
@@ skipping 62 matching lines @@
 
 /**
  * Complete overscan adjustments for a display  by saving the current values and
  * hiding the overlay.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-overscanCalibrationComplete
  */
 chrome.system.display.overscanCalibrationComplete = function(id) {};
 
 /**
- * Starts native touch calibration for a display. This will show an overlay on
- * the screen and initialize the UX for touch calibration. If another native
- * touch calibration is already in progress this will throw an error.
+ * Displays the native touch calibration UX for the display with |id| as display
+ * id. This will show an overlay on the screen with required instructions on how
+ * to proceed. The callback will be invoked in case of successful calibraion
+ * only. If the calibration fails, this will throw an error.
  * @param {string} id The display's unique identifier.
+ * @param {function(boolean):void=} callback Optional callback to inform the
+ *     caller that the touch      calibration has ended. The argument of the
+ *     callback informs if the      calibration was a success or not.
  * @see https://developer.chrome.com/extensions/system.display#method-showNativeTouchCalibration
  */
-chrome.system.display.showNativeTouchCalibration = function(id) {};
+chrome.system.display.showNativeTouchCalibration = function(id, callback) {};
 
 /**
  * Starts custom touch calibration for a display. This should be called when
  * using a custom UX for collecting calibration data. If another touch
  * calibration is already in progress this will throw an error.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-startCustomTouchCalibration
  */
 chrome.system.display.startCustomTouchCalibration = function(id) {};
 
 /**
  * Sets the touch calibration pairs for a display. These |pairs| would be used
  * to calibrate the touch screen for display with |id| called in
  * startCustomTouchCalibration(). Always call |startCustomTouchCalibration|
  * before calling this method. If another touch calibration is already in
  * progress this will throw an error.
  * @param {!chrome.system.display.TouchCalibrationPairQuad} pairs The pairs of
  *     point used to calibrate the display.
  * @param {!chrome.system.display.Bounds} bounds Bounds of the display when the
- *     touch calibration was performed. |bounds.left| and |bounds.top|
+ *     touch calibration was performed.     |bounds.left| and |bounds.top|
  *     values are ignored.
  * @see https://developer.chrome.com/extensions/system.display#method-completeCustomTouchCalibration
  */
 chrome.system.display.completeCustomTouchCalibration = function(pairs, bounds) {};
 
 /**
- * Resets the touch calibration for the display and removes the saved
- * calibration data.
+ * Resets the touch calibration for the display and brings it back to its
+ * default state by clearing any touch calibration data associated with the
+ * display.
  * @param {string} id The display's unique identifier.
  * @see https://developer.chrome.com/extensions/system.display#method-clearTouchCalibration
  */
 chrome.system.display.clearTouchCalibration = function(id) {};
 
 /**
  * Fired when anything changes to the display configuration.
  * @type {!ChromeEvent}
  * @see https://developer.chrome.com/extensions/system.display#event-onDisplayChanged
  */
 chrome.system.display.onDisplayChanged;