Split out non-auto-generatable externs from auto generated ones.

chrome/common/extensions/api/automation.idl

 // Copyright 2014 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.
 
 // The <code>chrome.automation</code> API allows developers to access the
 // automation (accessibility) tree for the browser. The tree resembles the DOM
 // tree, but only exposes the <em>semantic</em> structure of a page. It can be
 // used to programmatically interact with a page by examining names, roles, and
 // states, listening for events, and performing actions on nodes.
 [nocompile] namespace automation {
-  // Keep the following enums in sync with 'ui/accessibility/ax_enums.idl'.
-  // They are kept here purely for extension docs generation.
-
-  // Possible events fired on an $(ref:automation.AutomationNode).
-  enum EventType {
-    activedescendantchanged,
-    alert,
-    ariaAttributeChanged,
-    autocorrectionOccured,
-    blur,
-    checkedStateChanged,
-    childrenChanged,
-    clicked,
-    documentSelectionChanged,
-    expandedChanged,
-    focus,
-    imageFrameUpdated,
-    hide,
-    hover,
-    invalidStatusChanged,
-    layoutComplete,
-    liveRegionCreated,
-    liveRegionChanged,
-    loadComplete,
-    locationChanged,
-    mediaStartedPlaying,
-    mediaStoppedPlaying,
-    menuEnd,
-    menuListItemSelected,
-    menuListValueChanged,
-    menuPopupEnd,
-    menuPopupStart,
-    menuStart,
-    mouseCanceled,
-    mouseDragged,
-    mouseMoved,
-    mousePressed,
-    mouseReleased,
-    rowCollapsed,
-    rowCountChanged,
-    rowExpanded,
-    scrollPositionChanged,
-    scrolledToAnchor,
-    selectedChildrenChanged,
-    selection,
-    selectionAdd,
-    selectionRemove,
-    show,
-    textChanged,
-    textSelectionChanged,
-    treeChanged,
-    valueChanged
-  };
-
-  // Describes the purpose of an $(ref:automation.AutomationNode).
-  enum RoleType {
-    abbr,
-    alertDialog,
-    alert,
-    annotation,
-    application,
-    article,
-    audio,
-    banner,
-    blockquote,
-    busyIndicator,
-    button,
-    buttonDropDown,
-    canvas,
-    caption,
-    cell,
-    checkBox,
-    client,
-    colorWell,
-    columnHeader,
-    column,
-    comboBox,
-    complementary,
-    contentInfo,
-    date,
-    dateTime,
-    definition,
-    descriptionListDetail,
-    descriptionList,
-    descriptionListTerm,
-    desktop,
-    details,
-    dialog,
-    directory,
-    disclosureTriangle,
-    div,
-    document,
-    embeddedObject,
-    figcaption,
-    figure,
-    footer,
-    form,
-    grid,
-    group,
-    heading,
-    iframe,
-    iframePresentational,
-    ignored,
-    imageMapLink,
-    imageMap,
-    image,
-    inlineTextBox,
-    inputTime,
-    labelText,
-    legend,
-    lineBreak,
-    link,
-    listBoxOption,
-    listBox,
-    listItem,
-    listMarker,
-    list,
-    locationBar,
-    log,
-    main,
-    mark,
-    marquee,
-    math,
-    menuBar,
-    menuButton,
-    menuItem,
-    menuItemCheckBox,
-    menuItemRadio,
-    menuListOption,
-    menuListPopup,
-    menu,
-    meter,
-    navigation,
-    note,
-    outline,
-    pane,
-    paragraph,
-    popUpButton,
-    pre,
-    presentational,
-    progressIndicator,
-    radioButton,
-    radioGroup,
-    region,
-    rootWebArea,
-    rowHeader,
-    row,
-    ruby,
-    ruler,
-    svgRoot,
-    scrollArea,
-    scrollBar,
-    seamlessWebArea,
-    search,
-    searchBox,
-    slider,
-    sliderThumb,
-    spinButtonPart,
-    spinButton,
-    splitter,
-    staticText,
-    status,
-    switch,
-    tabGroup,
-    tabList,
-    tabPanel,
-    tab,
-    tableHeaderContainer,
-    table,
-    textField,
-    time,
-    timer,
-    titleBar,
-    toggleButton,
-    toolbar,
-    treeGrid,
-    treeItem,
-    tree,
-    unknown,
-    tooltip,
-    video,
-    webArea,
-    webView,
-    window
-  };
-
-  // Describes characteristics of an $(ref:automation.AutomationNode).
-  enum StateType {
-    busy,
-    checked,
-    collapsed,
-    default,
-    disabled,
-    editable,
-    expanded,
-    focusable,
-    focused,
-    haspopup,
-    horizontal,
-    hovered,
-    invisible,
-    linked,
-    multiline,
-    multiselectable,
-    offscreen,
-    pressed,
-    protected,
-    readOnly,
-    required,
-    richlyEditable,
-    selectable,
-    selected,
-    vertical,
-    visited
-  };
-
   // Possible changes to the automation tree. For any given atomic change
   // to the tree, each node that's added, removed, or changed, will appear
   // in exactly one TreeChange, with one of these types.
   //
   //
   // nodeCreated means that this node was added to the tree and its parent is
   // new as well, so it's just one node in a new subtree that was added.
   enum TreeChangeType {
     /**
      * This node was added to the tree and its parent is new as well,
@@ skipping 26 matching lines @@
 
   dictionary Rect {
     long left;
     long top;
     long width;
     long height;
   };
 
   // Arguments for the find() and findAll() methods.
   [nocompile, noinline_doc] dictionary FindParams {
-    RoleType? role;
+    DOMString? role;
 
-    // A map of $(ref:automation.StateType) to boolean, indicating for each
+    // A map of $(DOMString) to boolean, indicating for each
     // state whether it should be set or not. For example:
-    // <code>{ StateType.disabled: false }</code> would only match if
-    // <code>StateType.disabled</code> was <em>not</em> present in the node's
+    // disabled: false would only match if
+    // disabled: false was <em>not</em> present in the node's
     // <code>state</code> object.
     object? state;
 
     // A map of attribute name to expected value, for example
     // <code>{ name: 'Root directory', checkbox_mixed: true }</code>.
     // String attribute values may be specified as a regex, for example
     // <code>{ name: /stralia$/</code> }</code>.
     // Unless specifying a regex, the expected value must be an exact match
     // in type and value for the actual value. Thus, the type of expected value
     // must be one of:
@@ skipping 20 matching lines @@
 
   // Called when the result for a <code>query</code> is available.
   callback QueryCallback = void(AutomationNode node);
 
   // An event in the Automation tree.
   [nocompile, noinline_doc] dictionary AutomationEvent {
     // The $(ref:automation.AutomationNode) to which the event was targeted.
     AutomationNode target;
 
     // The type of the event.
-    EventType type;
+    DOMString type;
 
     // The source of this event.
     DOMString eventFrom;
 
     long mouseX;
     long mouseY;
 
     // Stops this event from further processing except for any remaining
     // listeners on $(ref:AutomationEvent.target).
     static void stopPropagation();
@@ skipping 25 matching lines @@
 
   // A single node in an Automation tree.
   [nocompile, noinline_doc] dictionary AutomationNode {
     // The root node of the tree containing this AutomationNode.
     AutomationNode root;
 
     // Whether this AutomationNode is a root node.
     boolean isRootNode;
 
     // The role of this node.
-    automation.RoleType role;
+    DOMString role;
 
-    // The $(ref:automation.StateType)s describing this node.
+    // The states describing this node.
     object state;
 
     // The rendered location (as a bounding box) of this node in global
     // screen coordinates.
     automation.Rect location;
 
     // Computes the bounding box of a subrange of this node in global screen
     // coordinates. Returns the same as |location| if range information
     // is not available. The start and end indices are zero-based offsets
     // into the node's "name" string attribute.
@@ skipping 215 matching lines @@
 
     // Sets selection within a text field.
     static void setSelection(long startIndex, long endIndex);
 
     // Clears focus and sets this node as the starting point for the next
     // time the user presses Tab or Shift+Tab.
     static void setSequentialFocusNavigationStartingPoint();
 
     // Adds a listener for the given event type and event phase.
     static void addEventListener(
-        EventType eventType, AutomationListener listener, boolean capture);
+        DOMString eventType, AutomationListener listener, boolean capture);
 
     // Removes a listener for the given event type and event phase.
     static void removeEventListener(
-        EventType eventType, AutomationListener listener, boolean capture);
+        DOMString eventType, AutomationListener listener, boolean capture);
 
     // Gets the first node in this node's subtree which matches the given CSS
     // selector and is within the same DOM context.
     //
     // If this node doesn't correspond directly with an HTML node in the DOM,
     // querySelector will be run on this node's nearest HTML node ancestor. Note
     // that this may result in the query returning a node which is not a
     // descendant of this node.
     //
     // If the selector matches a node which doesn't directly correspond to an
@@ skipping 21 matching lines @@
 
   // Called with the <code>AutomationNode</code> that currently has focus.
   callback FocusCallback = void(AutomationNode focusedNode);
 
   interface Functions {
     // Get the automation tree for the tab with the given tabId, or the current
     // tab if no tabID is given, enabling automation if necessary. Returns a
     // tree with a placeholder root node; listen for the "loadComplete" event to
     // get a notification that the tree has fully loaded (the previous root node
     // reference will stop working at or before this point).
-    [nocompile] static void getTree(optional long tabId, RootCallback callback);
+    [nocompile] static void getTree(long tabId, RootCallback callback);
 
     // Get the automation tree for the whole desktop which consists of all on
     // screen views. Note this API is currently only supported on Chrome OS.
     [nocompile] static void getDesktop(RootCallback callback);
 
     // Get the automation node that currently has focus, globally. Will return
     // null if none of the nodes in any loaded trees have focus.
     [nocompile] static void getFocus(FocusCallback callback);
 
     // Add a tree change observer. Tree change observers are static/global, they
@@ skipping 12 matching lines @@
     // Everything in the tree between the two node/offset pairs gets included
     // in the selection. The anchor is where the user started the selection,
     // while the focus is the point at which the selection gets extended
     // e.g. when dragging with a mouse or using the keyboard. For nodes with
     // the role staticText, the offset gives the character offset within
     // the value where the selection starts or ends, respectively.
     [nocompile] static void setDocumentSelection(
         SetDocumentSelectionParams params);
   };
 };