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

chrome/browser/resources/chromeos/chromevox/cvox2/background/desktop_automation_handler.js

 // Copyright 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.
 
 /**
  * @fileoverview Handles automation from a desktop automation node.
  */
 
 goog.provide('DesktopAutomationHandler');
 
 goog.require('AutomationObjectConstructorInstaller');
 goog.require('BaseAutomationHandler');
+goog.require('ChromeVoxAutomationEvent');
 goog.require('ChromeVoxState');
 goog.require('Stubs');
 goog.require('editing.TextEditHandler');
 
 goog.scope(function() {
 var AutomationEvent = chrome.automation.AutomationEvent;
 var AutomationNode = chrome.automation.AutomationNode;
 var Dir = constants.Dir;
 var EventType = chrome.automation.EventType;
 var RoleType = chrome.automation.RoleType;
@@ skipping 42 matching lines @@
   this.addListener_(e.textChanged, this.onTextChanged);
   this.addListener_(e.textSelectionChanged, this.onTextSelectionChanged);
   this.addListener_(e.valueChanged, this.onValueChanged);
 
   AutomationObjectConstructorInstaller.init(node, function() {
     chrome.automation.getFocus((function(focus) {
       if (ChromeVoxState.instance.mode != ChromeVoxMode.FORCE_NEXT)
         return;
 
       if (focus) {
-        this.onFocus(
-            new chrome.automation.AutomationEvent(
-                EventType.focus, focus, 'page'));
+        this.onFocus(new ChromeVoxAutomationEvent(
+            EventType.focus, focus, 'page'));
       }
     }).bind(this));
   }.bind(this));
 };
 
 /**
  * Time to wait until processing more value changed events.
  * @const {number}
  */
 DesktopAutomationHandler.VMIN_VALUE_CHANGE_DELAY_MS = 500;
 
 /**
  * Controls announcement of non-user-initiated events.
  * @type {boolean}
  */
 DesktopAutomationHandler.announceActions = false;
 
 DesktopAutomationHandler.prototype = {
   __proto__: BaseAutomationHandler.prototype,
 
   /** @override */
   willHandleEvent_: function(evt) {
     return !cvox.ChromeVox.isActive;
   },
 
   /**
    * Provides all feedback once ChromeVox's focus changes.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onEventDefault: function(evt) {
     var node = evt.target;
     if (!node)
       return;
 
     // Decide whether to announce and sync this event.
     if (!DesktopAutomationHandler.announceActions && evt.eventFrom == 'action')
       return;
 
@@ skipping 17 matching lines @@
       output.withBraille(
           ChromeVoxState.instance.currentRange, prevRange, evt.type);
     } else {
       // Delegate event handling to the text edit handler for braille.
       this.textEditHandler_.onEvent(evt);
     }
     output.go();
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onEventIfInRange: function(evt) {
     if (!this.shouldOutput_(evt))
       return;
 
     var prev = ChromeVoxState.instance.currentRange;
     if (prev.contentEquals(cursors.Range.fromNode(evt.target)) ||
         evt.target.state.focused) {
       // Category flush here since previous focus events via navigation can
       // cause double speak.
       Output.forceModeForNextSpeechUtterance(cvox.QueueMode.CATEGORY_FLUSH);
 
       // Intentionally skip setting range.
       new Output()
           .withRichSpeechAndBraille(cursors.Range.fromNode(evt.target),
                                     prev,
                                     Output.EventType.NAVIGATE)
           .go();
     }
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onEventIfSelected: function(evt) {
     if (evt.target.state.selected)
       this.onEventDefault(evt);
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onEventWithFlushedOutput: function(evt) {
     Output.forceModeForNextSpeechUtterance(cvox.QueueMode.FLUSH);
     this.onEventDefault(evt);
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onAriaAttributeChanged: function(evt) {
     if (evt.target.state.editable)
       return;
     this.onEventIfInRange(evt);
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onHover: function(evt) {
     if (ChromeVoxState.instance.currentRange &&
         evt.target == ChromeVoxState.instance.currentRange.start.node)
       return;
     Output.forceModeForNextSpeechUtterance(cvox.QueueMode.FLUSH);
     this.onEventDefault(evt);
   },
 
   /**
    * Makes an announcement without changing focus.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onActiveDescendantChanged: function(evt) {
     if (!evt.target.activeDescendant || !evt.target.state.focused)
       return;
-    this.onEventDefault(new chrome.automation.AutomationEvent(
+    this.onEventDefault(new ChromeVoxAutomationEvent(
         EventType.focus, evt.target.activeDescendant, evt.eventFrom));
   },
 
   /**
    * Makes an announcement without changing focus.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onAlert: function(evt) {
     var node = evt.target;
     if (!node || !this.shouldOutput_(evt))
       return;
 
     var range = cursors.Range.fromNode(node);
 
     new Output().withSpeechAndBraille(range, null, evt.type).go();
   },
 
   /**
    * Provides all feedback once a checked state changed event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onCheckedStateChanged: function(evt) {
     if (!AutomationPredicate.checkable(evt.target))
       return;
 
     Output.forceModeForNextSpeechUtterance(cvox.QueueMode.CATEGORY_FLUSH);
     this.onEventIfInRange(
-        new chrome.automation.AutomationEvent(
+        new ChromeVoxAutomationEvent(
             EventType.checkedStateChanged, evt.target, evt.eventFrom));
   },
 
   /**
    * Provides all feedback once a focus event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onFocus: function(evt) {
     // Invalidate any previous editable text handler state.
     this.textEditHandler_ = null;
 
     var node = evt.target;
 
     // Discard focus events on embeddedObject.
     if (node.role == RoleType.embeddedObject)
       return;
@@ skipping 19 matching lines @@
     }
 
     // If a previous node was saved for this focus, restore it.
     var savedRange = ChromeVoxState.instance.focusRecoveryMap.get(root);
     ChromeVoxState.instance.focusRecoveryMap.delete(root);
     if (savedRange) {
       ChromeVoxState.instance.navigateToRange(savedRange, false);
       return;
     }
 
-    this.onEventDefault(new chrome.automation.AutomationEvent(
+    this.onEventDefault(new ChromeVoxAutomationEvent(
         EventType.focus, node, evt.eventFrom));
   },
 
   /**
    * Provides all feedback once a load complete event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onLoadComplete: function(evt) {
     chrome.automation.getFocus(function(focus) {
       if (!focus || !AutomationUtil.isDescendantOf(focus, evt.target))
         return;
 
       // Create text edit handler, if needed, now in order not to miss initial
       // value change if text field has already been focused when initializing
       // ChromeVox.
       this.createTextEditHandlerIfNeeded_(focus);
@@ skipping 22 matching lines @@
         return;
 
       Output.forceModeForNextSpeechUtterance(cvox.QueueMode.FLUSH);
       o.withRichSpeechAndBraille(
           ChromeVoxState.instance.currentRange, null, evt.type).go();
     }.bind(this));
   },
 
   /**
    * Provides all feedback once a text changed event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onTextChanged: function(evt) {
     if (evt.target.state.editable)
       this.onEditableChanged_(evt);
   },
 
   /**
    * Provides all feedback once a text selection changed event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onTextSelectionChanged: function(evt) {
     if (evt.target.state.editable)
       this.onEditableChanged_(evt);
   },
 
   /**
    * Provides all feedback once a change event in a text field fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    * @private
    */
   onEditableChanged_: function(evt) {
     var topRoot = AutomationUtil.getTopLevelRoot(evt.target);
     if (!evt.target.state.focused ||
         (topRoot &&
             topRoot.parent &&
             !topRoot.parent.state.focused))
       return;
 
@@ skipping 20 matching lines @@
     }
 
     // TODO(plundblad): This can currently be null for contenteditables.
     // Clean up when it can't.
     if (this.textEditHandler_)
       this.textEditHandler_.onEvent(evt);
   },
 
   /**
    * Provides all feedback once a value changed event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onValueChanged: function(evt) {
     // Delegate to the edit text handler if this is an editable.
     if (evt.target.state.editable) {
       this.onEditableChanged_(evt);
       return;
     }
 
     if (!this.shouldOutput_(evt))
       return;
@@ skipping 13 matching lines @@
 
       if (t.root.role == RoleType.desktop)
         output.withQueueMode(cvox.QueueMode.FLUSH);
 
       output.format('$value', evt.target).go();
     }
   },
 
   /**
    * Handle updating the active indicator when the document scrolls.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onScrollPositionChanged: function(evt) {
     var currentRange = ChromeVoxState.instance.currentRange;
     if (currentRange && currentRange.isValid() && this.shouldOutput_(evt))
       new Output().withLocation(currentRange, null, evt.type).go();
   },
 
   /**
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onSelection: function(evt) {
     // Invalidate any previous editable text handler state since some nodes,
     // like menuitems, can receive selection while focus remains on an editable
     // leading to braille output routing to the editable.
     this.textEditHandler_ = null;
 
     chrome.automation.getFocus(function(focus) {
       // Desktop tabs get "selection" when there's a focused webview during tab
       // switching.
       if (focus.role == RoleType.webView && evt.target.role == RoleType.tab) {
         ChromeVoxState.instance.setCurrentRange(
             cursors.Range.fromNode(focus.firstChild));
         return;
       }
 
       // Some cases (e.g. in overview mode), require overriding the assumption
       // that focus is an ancestor of a selection target.
       var override = evt.target.role == RoleType.menuItem ||
           (evt.target.root == focus.root &&
               focus.root.role == RoleType.desktop);
       Output.forceModeForNextSpeechUtterance(cvox.QueueMode.FLUSH);
       if (override || AutomationUtil.isDescendantOf(evt.target, focus))
         this.onEventDefault(evt);
     }.bind(this));
   },
 
   /**
    * Provides all feedback once a menu start event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onMenuStart: function(evt) {
     ChromeVoxState.instance.markCurrentRange();
     this.onEventDefault(evt);
   },
 
   /**
    * Provides all feedback once a menu end event fires.
-   * @param {!AutomationEvent} evt
+   * @param {!AutomationEvent|!ChromeVoxAutomationEvent} evt
    */
   onMenuEnd: function(evt) {
     this.onEventDefault(evt);
 
     // This is a work around for Chrome context menus not firing a focus event
     // after you close them.
     chrome.automation.getFocus(function(focus) {
       if (focus) {
         this.onFocus(
-            new chrome.automation.AutomationEvent(
+            new ChromeVoxAutomationEvent(
                 EventType.focus, focus, 'page'));
       }
     }.bind(this));
   },
 
   /**
    * Create an editable text handler for the given node if needed.
    * @param {!AutomationNode} node
    */
   createTextEditHandlerIfNeeded_: function(node) {
@@ skipping 25 matching lines @@
 DesktopAutomationHandler.init_ = function() {
   chrome.automation.getDesktop(function(desktop) {
     ChromeVoxState.desktopAutomationHandler =
         new DesktopAutomationHandler(desktop);
   });
 };
 
 DesktopAutomationHandler.init_();
 
 });  // goog.scope