Initial commit of generated dart:chrome app_window and app_runtime

tools/dom/src/chrome/app_window.dart

+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// Generated from namespace: app.window
+
+part of chrome;
+
+/**
+ * Types
+ */
+
+class Bounds extends ChromeObject {
+  /*
+   * Public constructor
+   */
+  Bounds({int left, int top, int width, int height}) {
+    if (?left)
+      this.left = left;
+    if (?top)
+      this.top = top;
+    if (?width)
+      this.width = width;
+    if (?height)
+      this.height = height;
+  }
+
+  /*
+   * Private constructor
+   */
+  Bounds._proxy(_jsObject) : super._proxy(_jsObject);
+
+  /*
+   * Public accessors
+   */
+
+  int get left => JS('int', '#.left', this._jsObject);
+
+  void set left(int left) {
+    JS('void', '#.left = #', this._jsObject, left);
+  }
+
+  int get top => JS('int', '#.top', this._jsObject);
+
+  void set top(int top) {
+    JS('void', '#.top = #', this._jsObject, top);
+  }
+
+  int get width => JS('int', '#.width', this._jsObject);
+
+  void set width(int width) {
+    JS('void', '#.width = #', this._jsObject, width);
+  }
+
+  int get height => JS('int', '#.height', this._jsObject);
+
+  void set height(int height) {
+    JS('void', '#.height = #', this._jsObject, height);
+  }
+}
+
+class CreateWindowOptions extends ChromeObject {
+  /*
+   * Public constructor
+   */
+  CreateWindowOptions({String id, int defaultWidth, int defaultHeight, int defaultLeft, int defaultTop, int width, int height, int left, int top, int minWidth, int minHeight, int maxWidth, int maxHeight, String type, String frame, Bounds bounds, bool transparentBackground, bool hidden, bool singleton}) {
+    if (?id)
+      this.id = id;
+    if (?defaultWidth)
+      this.defaultWidth = defaultWidth;
+    if (?defaultHeight)
+      this.defaultHeight = defaultHeight;
+    if (?defaultLeft)
+      this.defaultLeft = defaultLeft;
+    if (?defaultTop)
+      this.defaultTop = defaultTop;
+    if (?width)
+      this.width = width;
+    if (?height)
+      this.height = height;
+    if (?left)
+      this.left = left;
+    if (?top)
+      this.top = top;
+    if (?minWidth)
+      this.minWidth = minWidth;
+    if (?minHeight)
+      this.minHeight = minHeight;
+    if (?maxWidth)
+      this.maxWidth = maxWidth;
+    if (?maxHeight)
+      this.maxHeight = maxHeight;
+    if (?type)
+      this.type = type;
+    if (?frame)
+      this.frame = frame;
+    if (?bounds)
+      this.bounds = bounds;
+    if (?transparentBackground)
+      this.transparentBackground = transparentBackground;
+    if (?hidden)
+      this.hidden = hidden;
+    if (?singleton)
+      this.singleton = singleton;
+  }
+
+  /*
+   * Private constructor
+   */
+  CreateWindowOptions._proxy(_jsObject) : super._proxy(_jsObject);
+
+  /*
+   * Public accessors
+   */
+
+  /// Id to identify the window. This will be used to remember the size and
+  /// position of the window and restore that geometry when a window with the
+  /// same id (and no explicit size or position) is later opened.
+  String get id => JS('String', '#.id', this._jsObject);
+
+  void set id(String id) {
+    JS('void', '#.id = #', this._jsObject, id);
+  }
+
+  /// Default width of the window. (Deprecated; regular bounds act like this
+  /// now.)
+  int get defaultWidth => JS('int', '#.defaultWidth', this._jsObject);
+
+  void set defaultWidth(int defaultWidth) {
+    JS('void', '#.defaultWidth = #', this._jsObject, defaultWidth);
+  }
+
+  /// Default height of the window. (Deprecated; regular bounds act like this
+  /// now.)
+  int get defaultHeight => JS('int', '#.defaultHeight', this._jsObject);
+
+  void set defaultHeight(int defaultHeight) {
+    JS('void', '#.defaultHeight = #', this._jsObject, defaultHeight);
+  }
+
+  /// Default X coordinate of the window. (Deprecated; regular bounds act like
+  /// this now.)
+  int get defaultLeft => JS('int', '#.defaultLeft', this._jsObject);
+
+  void set defaultLeft(int defaultLeft) {
+    JS('void', '#.defaultLeft = #', this._jsObject, defaultLeft);
+  }
+
+  /// Default Y coordinate of the window. (Deprecated; regular bounds act like
+  /// this now.)
+  int get defaultTop => JS('int', '#.defaultTop', this._jsObject);
+
+  void set defaultTop(int defaultTop) {
+    JS('void', '#.defaultTop = #', this._jsObject, defaultTop);
+  }
+
+  /// Width of the window. (Deprecated; use 'bounds'.)
+  int get width => JS('int', '#.width', this._jsObject);
+
+  void set width(int width) {
+    JS('void', '#.width = #', this._jsObject, width);
+  }
+
+  /// Height of the window. (Deprecated; use 'bounds'.)
+  int get height => JS('int', '#.height', this._jsObject);
+
+  void set height(int height) {
+    JS('void', '#.height = #', this._jsObject, height);
+  }
+
+  /// X coordinate of the window. (Deprecated; use 'bounds'.)

[blois, 2013/02/08 00:08:04]

These were here before, but is it possible to remove the deprecated APIs? We're
starting with a clean slate.

[benwells, 2013/02/08 00:17:46]

We have no way of automatically ignoring deprecated things. We could assume if
the comment has the word 'deprecated' somewhere it is deprecated, but that would
be fragile - I can imaging a comment saying 'Use this instead of foo, as foo is
deprecated;.

An alternative would be to manually override all of these.

+  int get left => JS('int', '#.left', this._jsObject);
+
+  void set left(int left) {
+    JS('void', '#.left = #', this._jsObject, left);
+  }
+
+  /// Y coordinate of the window. (Deprecated; use 'bounds'.)
+  int get top => JS('int', '#.top', this._jsObject);
+
+  void set top(int top) {
+    JS('void', '#.top = #', this._jsObject, top);
+  }
+
+  /// Minimum width of the window.
+  int get minWidth => JS('int', '#.minWidth', this._jsObject);
+
+  void set minWidth(int minWidth) {
+    JS('void', '#.minWidth = #', this._jsObject, minWidth);
+  }
+
+  /// Minimum height of the window.
+  int get minHeight => JS('int', '#.minHeight', this._jsObject);
+
+  void set minHeight(int minHeight) {
+    JS('void', '#.minHeight = #', this._jsObject, minHeight);
+  }
+
+  /// Maximum width of the window.
+  int get maxWidth => JS('int', '#.maxWidth', this._jsObject);
+
+  void set maxWidth(int maxWidth) {
+    JS('void', '#.maxWidth = #', this._jsObject, maxWidth);
+  }
+
+  /// Maximum height of the window.
+  int get maxHeight => JS('int', '#.maxHeight', this._jsObject);
+
+  void set maxHeight(int maxHeight) {
+    JS('void', '#.maxHeight = #', this._jsObject, maxHeight);
+  }
+
+  /// Window type:  'shell' - the default window type  'panel' - a panel, managed
+  /// by the OS (Currently experimental, Ash only)
+  String get type => JS('String', '#.type', this._jsObject);
+
+  void set type(String type) {
+    JS('void', '#.type = #', this._jsObject, type);
+  }
+
+  /// Frame type: 'none' or 'chrome' (defaults to 'chrome').
+  String get frame => JS('String', '#.frame', this._jsObject);
+
+  void set frame(String frame) {
+    JS('void', '#.frame = #', this._jsObject, frame);
+  }
+
+  /// Size of the content in the window (excluding the titlebar). If specified in
+  /// addition to any of the left/top/width/height parameters, this field takes
+  /// precedence. If a frameBounds is specified, the frameBounds take precedence.
+  Bounds get bounds => new Bounds._proxy(JS('', '#.bounds', this._jsObject));
+
+  void set bounds(Bounds bounds) {
+    JS('void', '#.bounds = #', this._jsObject, convertArgument(bounds));
+  }
+
+  /// Enable window background transparency. Only supported in ash. Requires
+  /// experimental API permission.
+  bool get transparentBackground => JS('bool', '#.transparentBackground', this._jsObject);
+
+  void set transparentBackground(bool transparentBackground) {
+    JS('void', '#.transparentBackground = #', this._jsObject, transparentBackground);
+  }
+
+  /// If true, the window will be created in a hidden state. Call show() on the
+  /// window to show it once it has been created. Defaults to false.
+  bool get hidden => JS('bool', '#.hidden', this._jsObject);
+
+  void set hidden(bool hidden) {
+    JS('void', '#.hidden = #', this._jsObject, hidden);
+  }
+
+  /// By default if you specify an id for the window, the window will only be
+  /// created if another window with the same id doesn't already exist. If a
+  /// window with the same id already exists that window is activated instead. If
+  /// you do want to create multiple windows with the same id, you can set this
+  /// property to false.
+  bool get singleton => JS('bool', '#.singleton', this._jsObject);
+
+  void set singleton(bool singleton) {
+    JS('void', '#.singleton = #', this._jsObject, singleton);
+  }
+}
+
+class AppWindow extends ChromeObject {
+  /*
+   * Private constructor
+   */
+  AppWindow._proxy(_jsObject) : super._proxy(_jsObject);
+
+  /*
+   * Public accessors
+   */
+
+  /// The JavaScript 'window' object for the created child.
+  // TODO(sashab, sra): Detect whether this is the current window, or an
+  // external one, and return an appropriately-typed object
+  WindowBase get contentWindow =>
+    JS("Window", "#.contentWindow", this._jsObject);
+
+  /*
+   * Methods
+   */
+  /// Focus the window.
+  void focus() => JS('void', '#.focus()', this._jsObject);
+  /// Minimize the window.
+  void minimize() => JS('void', '#.minimize()', this._jsObject);
+  /// Is the window minimized?
+  void isMinimized() => JS('void', '#.isMinimized()', this._jsObject);
+  /// Maximize the window.
+  void maximize() => JS('void', '#.maximize()', this._jsObject);
+  /// Is the window maximized?
+  void isMaximized() => JS('void', '#.isMaximized()', this._jsObject);
+  /// Restore the window.
+  void restore() => JS('void', '#.restore()', this._jsObject);
+  /// Move the window to the position (|left|, |top|).
+  void moveTo(int left, int top) => JS('void', '#.moveTo(#, #)', this._jsObject, left, top);
+  /// Resize the window to |width|x|height| pixels in size.
+  void resizeTo(int width, int height) => JS('void', '#.resizeTo(#, #)', this._jsObject, width, height);
+  /// Draw attention to the window.
+  void drawAttention() => JS('void', '#.drawAttention()', this._jsObject);
+  /// Clear attention to the window.
+  void clearAttention() => JS('void', '#.clearAttention()', this._jsObject);
+  /// Close the window.
+  void close() => JS('void', '#.close()', this._jsObject);
+  /// Show the window. Does nothing if the window is already visible.
+  void show() => JS('void', '#.show()', this._jsObject);
+  /// Hide the window. Does nothing if the window is already hidden.
+  void hide() => JS('void', '#.hide()', this._jsObject);
+  /// Get the window's bounds as a $ref:Bounds object.
+  void getBounds() => JS('void', '#.getBounds()', this._jsObject);
+  /// Set the window's bounds.
+  void setBounds(Bounds bounds) => JS('void', '#.setBounds(#)', this._jsObject, convertArgument(bounds));
+  /// Set the app icon for the window (experimental). Currently this is only
+  /// being implemented on Ash. TODO(stevenjb): Investigate implementing this on
+  /// Windows and OSX.
+  void setIcon(String icon_url) => JS('void', '#.setIcon(#)', this._jsObject, icon_url);
+}
+
+/**
+ * Events
+ */
+
+/// Fired when the window is resized.
+class Event_app_window_onBoundsChanged extends Event {
+  void addListener(void callback()) => super.addListener(callback);
+
+  void removeListener(void callback()) => super.removeListener(callback);
+
+  bool hasListener(void callback()) => super.hasListener(callback);
+
+  Event_app_window_onBoundsChanged(jsObject) : super._(jsObject, 0);
+}
+
+/// Fired when the window is closed.
+class Event_app_window_onClosed extends Event {
+  void addListener(void callback()) => super.addListener(callback);
+
+  void removeListener(void callback()) => super.removeListener(callback);
+
+  bool hasListener(void callback()) => super.hasListener(callback);
+
+  Event_app_window_onClosed(jsObject) : super._(jsObject, 0);
+}
+
+/// Fired when the window is maximized.
+class Event_app_window_onMaximized extends Event {
+  void addListener(void callback()) => super.addListener(callback);
+
+  void removeListener(void callback()) => super.removeListener(callback);
+
+  bool hasListener(void callback()) => super.hasListener(callback);
+
+  Event_app_window_onMaximized(jsObject) : super._(jsObject, 0);
+}
+
+/// Fired when the window is minimized.
+class Event_app_window_onMinimized extends Event {
+  void addListener(void callback()) => super.addListener(callback);
+
+  void removeListener(void callback()) => super.removeListener(callback);
+
+  bool hasListener(void callback()) => super.hasListener(callback);
+
+  Event_app_window_onMinimized(jsObject) : super._(jsObject, 0);
+}
+
+/// Fired when the window is restored from being minimized or maximized.
+class Event_app_window_onRestored extends Event {
+  void addListener(void callback()) => super.addListener(callback);
+
+  void removeListener(void callback()) => super.removeListener(callback);
+
+  bool hasListener(void callback()) => super.hasListener(callback);
+
+  Event_app_window_onRestored(jsObject) : super._(jsObject, 0);
+}
+
+/**
+ * Functions
+ */
+
+class API_app_window {
+  /*
+   * API connection
+   */
+  Object _jsObject;
+
+  /*
+   * Events
+   */
+  Event_app_window_onBoundsChanged onBoundsChanged;
+  Event_app_window_onClosed onClosed;
+  Event_app_window_onMaximized onMaximized;
+  Event_app_window_onMinimized onMinimized;
+  Event_app_window_onRestored onRestored;
+
+  /*
+   * Functions
+   */
+
+  /// The size and position of a window can be specified in a number of different
+  /// ways. The most simple option is not specifying anything at all, in which
+  /// case a default size and platform dependent position will be used.<br/><br/>
+  /// Another option is to use the top/left and width/height properties, which
+  /// will always put the window at the specified coordinates with the specified
+  /// size.<br/><br/> Yet another option is to give the window a (unique) id.
+  /// This id is then used to remember the size and position of the window
+  /// whenever it is moved or resized. This size and position is then used
+  /// instead of the specified bounds on subsequent opening of a window with the
+  /// same id. If you need to open a window with an id at a location other than
+  /// the remembered default, you can create it hidden, move it to the desired
+  /// location, then show it.<br/><br/> You can also combine these various
+  /// options, explicitly specifying for example the size while having the
+  /// position be remembered or other combinations like that. Size and position
+  /// are dealt with seperately, but individual coordinates are not. So if you
+  /// specify a top (or left) coordinate, you should also specify a left (or top)
+  /// coordinate, and similar for size.<br/><br/> If you specify both a regular
+  /// and a default value for the same option the regular value is the only one
+  /// that takes effect.
+  void create(String url, [CreateWindowOptions options, void callback(AppWindow created_window)]) {
+    void __proxy_callback(created_window) {
+      if (?callback) {
+        callback(new AppWindow._proxy(created_window));
+      }
+    }
+    JS('void', '#.create(#, #, #)', this._jsObject, url, convertArgument(options), convertDartClosureToJS(__proxy_callback, 1));
+  }
+
+  /// Returns an $ref:AppWindow object for the current script context (ie
+  /// JavaScript 'window' object). This can also be called on a handle to a
+  /// script context for another page, for example:
+  /// otherWindow.chrome.app.window.current().
+  void current() => JS('void', '#.current()', this._jsObject);
+
+  void initializeAppWindow(Object state) => JS('void', '#.initializeAppWindow(#)', this._jsObject, convertArgument(state));
+
+  API_app_window(this._jsObject) {
+    onBoundsChanged = new Event_app_window_onBoundsChanged(JS('', '#.onBoundsChanged', this._jsObject));
+    onClosed = new Event_app_window_onClosed(JS('', '#.onClosed', this._jsObject));
+    onMaximized = new Event_app_window_onMaximized(JS('', '#.onMaximized', this._jsObject));
+    onMinimized = new Event_app_window_onMinimized(JS('', '#.onMinimized', this._jsObject));
+    onRestored = new Event_app_window_onRestored(JS('', '#.onRestored', this._jsObject));
+  }
+}