Adding Angular and dependent packages for testing

third_party/pkg/angular/lib/directive/ng_repeat.dart

+part of angular.directive;
+
+class _Row {
+  var id;
+  Scope scope;
+  Block block;
+  dom.Element startNode;
+  dom.Element endNode;
+  List<dom.Element> elements;
+
+  _Row(this.id);
+}
+
+/**
+ * The `ngRepeat` directive instantiates a template once per item from a collection. Each template
+ * instance gets its own scope, where the given loop variable is set to the current collection item,
+ * and `$index` is set to the item index or key.
+ *
+ * Special properties are exposed on the local scope of each template instance, including:
+ *
+ * <table>
+ * <tr><th> Variable  </th><th> Type </th><th> Details                                                                     <th></tr>
+ * <tr><td> `$index`  </td><td>[num] </td><td> iterator offset of the repeated element (0..length-1)                       <td></tr>
+ * <tr><td> `$first`  </td><td>[bool]</td><td> true if the repeated element is first in the iterator.                      <td></tr>
+ * <tr><td> `$middle` </td><td>[bool]</td><td> true if the repeated element is between the first and last in the iterator. <td></tr>
+ * <tr><td> `$last`   </td><td>[bool]</td><td> true if the repeated element is last in the iterator.                       <td></tr>
+ * <tr><td> `$even`   </td><td>[bool]</td><td> true if the iterator position `$index` is even (otherwise false).           <td></tr>
+ * <tr><td> `$odd`    </td><td>[bool]</td><td> true if the iterator position `$index` is odd (otherwise false).            <td></tr>
+ * </table>
+ *
+ *
+ * [repeat_expression] ngRepeat The expression indicating how to enumerate a collection. These
+ *   formats are currently supported:
+ *
+ *   * `variable in expression` – where variable is the user defined loop variable and `expression`
+ *     is a scope expression giving the collection to enumerate.
+ *
+ *     For example: `album in artist.albums`.
+ *
+ *   * `variable in expression track by tracking_expression` – You can also provide an optional
+ *     tracking function which can be used to associate the objects in the collection with the DOM
+ *     elements. If no tracking function is specified the ng-repeat associates elements by identity
+ *     in the collection. It is an error to have more than one tracking function to resolve to the
+ *     same key. (This would mean that two distinct objects are mapped to the same DOM element,
+ *     which is not possible.)  Filters should be applied to the expression, before specifying a
+ *     tracking expression.
+ *
+ *     For example: `item in items` is equivalent to `item in items track by $id(item)'. This
+ *     implies that the DOM elements will be associated by item identity in the array.
+ *
+ *     For example: `item in items track by $id(item)`. A built in `$id()` function can be used
+ *     to assign a unique `$$hashKey` property to each item in the array. This property is then
+ *     used as a key to associated DOM elements with the corresponding item in the array by
+ *     identity. Moving the same object in array would move the DOM element in the same way ian the
+ *     DOM.
+ *
+ *     For example: `item in items track by item.id` is a typical pattern when the items come from
+ *     the database. In this case the object identity does not matter. Two objects are considered
+ *     equivalent as long as their `id` property is same.
+ *
+ *     For example: `item in items | filter:searchText track by item.id` is a pattern that might be
+ *     used to apply a filter to items in conjunction with a tracking expression.
+ *
+ *
+ * # Example:
+ *
+ *     <ul ng-repeat="item in ['foo', 'bar', 'baz']">
+ *       <li>{{$item}}</li>
+ *     </ul>
+ */
+
+@NgDirective(
+    children: NgAnnotation.TRANSCLUDE_CHILDREN,
+    selector: '[ng-repeat]',
+    map: const {'.': '@expression'})
+class NgRepeatDirective extends AbstractNgRepeatDirective {
+  NgRepeatDirective(BlockHole blockHole,
+                    BoundBlockFactory boundBlockFactory,
+                    Scope scope): super(blockHole, boundBlockFactory, scope);
+  get _shalow => false;
+}
+
+/**
+ * *EXPERIMENTAL:* This feature is experimental. We reserve the right to change or delete it.
+ *
+ * [ng-shallow-repeat] is same as [ng-repeat] with some tradeoffs designed for speed. Use
+ * [ng-shollow-repeat] when you expect that your items you are repeating over do not change
+ * during the repeater lifetime.
+ *
+ * The shallow repeater introduces these changes:
+ *
+ *  * The repeater only fires if the identity of the list changes or if the list [length] property
+ *    changes. This means that the repeater will still see additions and deletions but not changes
+ *    to the array.
+ *  * The child scopes for each item are created in the lazy mode (see [Scope.$new]). This means
+ *    the scopes are effectivly taken out of the digest cycle and will not update on changes
+ *    to the model.
+ *
+ */
+@NgDirective(
+    children: NgAnnotation.TRANSCLUDE_CHILDREN,
+    selector: '[ng-shallow-repeat]',
+    map: const {'.': '@expression'})
+class NgShalowRepeatDirective extends AbstractNgRepeatDirective {
+  NgShalowRepeatDirective(BlockHole blockHole,
+                          BoundBlockFactory boundBlockFactory,
+                          Scope scope): super(blockHole, boundBlockFactory, scope);
+  get _shalow => true;
+}
+
+abstract class AbstractNgRepeatDirective  {
+  static RegExp _SYNTAX = new RegExp(r'^\s*(.+)\s+in\s+(.*?)\s*(\s+track\s+by\s+(.+)\s*)?(\s+lazily\s*)?$');
+  static RegExp _LHS_SYNTAX = new RegExp(r'^(?:([\$\w]+)|\(([\$\w]+)\s*,\s*([\$\w]+)\))$');
+
+  BlockHole _blockHole;
+  BoundBlockFactory _boundBlockFactory;
+  Scope _scope;
+
+  String _expression;
+  String _valueIdentifier;
+  String _keyIdentifier;
+  String _listExpr;
+  Map<Object, _Row> _rows = new Map<dynamic, _Row>();
+  Function _trackByIdFn = (key, value, index) => value;
+  Function _removeWatch = () => null;
+  Iterable _lastCollection;
+
+  AbstractNgRepeatDirective(BlockHole this._blockHole,
+                            BoundBlockFactory this._boundBlockFactory,
+                            Scope this._scope);
+
+  get _shalow;
+
+  set expression(value) {
+    _expression = value;
+    _removeWatch();
+    Match match = _SYNTAX.firstMatch(_expression);
+    if (match == null) {
+      throw "[NgErr7] ngRepeat error! Expected expression in form of '_item_ in _collection_[ track by _id_]' but got '$_expression'.";
+    }
+    _listExpr = match.group(2);
+    var assignExpr = match.group(1);
+    match = _LHS_SYNTAX.firstMatch(assignExpr);
+    if (match == null) {
+      throw "[NgErr8] ngRepeat error! '_item_' in '_item_ in _collection_' should be an identifier or '(_key_, _value_)' expression, but got '$assignExpr'.";
+    }
+    _valueIdentifier = match.group(3);
+    if (_valueIdentifier == null) _valueIdentifier = match.group(1);
+    _keyIdentifier = match.group(2);
+
+    _removeWatch = _scope.$watchCollection(_listExpr, _onCollectionChange, value, _shalow);
+  }
+
+  List<_Row> _computeNewRows(Iterable collection, trackById) {
+    List<_Row> newRowOrder = [];
+    // Same as lastBlockMap but it has the current state. It will become the
+    // lastBlockMap on the next iteration.
+    Map<dynamic, _Row> newRows = new Map<dynamic, _Row>();
+    var arrayLength = collection.length;
+    // locate existing items
+    var length = newRowOrder.length = collection.length;
+    for (var index = 0; index < length; index++) {
+      var value = collection.elementAt(index);
+      trackById = _trackByIdFn(index, value, index);
+      if (_rows.containsKey(trackById)) {
+        var row = _rows[trackById];
+        _rows.remove(trackById);
+        newRows[trackById] = row;
+        newRowOrder[index] = row;
+      } else if (newRows.containsKey(trackById)) {
+        // restore lastBlockMap
+        newRowOrder.forEach((row) {
+          if (row != null && row.startNode != null) {
+            _rows[row.id] = row;
+          }
+        });
+        // This is a duplicate and we need to throw an error
+        throw "[NgErr50] ngRepeat error! Duplicates in a repeater are not allowed. Use 'track by' expression to specify unique keys. Repeater: $_expression, Duplicate key: $trackById";
+      } else {
+        // new never before seen row
+        newRowOrder[index] = new _Row(trackById);
+        newRows[trackById] = null;
+      }
+    }
+    // remove existing items
+    _rows.forEach((key, row){
+      row.block.remove();
+      row.scope.$destroy();
+    });
+    _rows = newRows;
+    return newRowOrder;
+  }
+
+  _onCollectionChange(Iterable collection) {
+    var previousNode = _blockHole.elements[0],     // current position of the node
+        nextNode,
+        childScope,
+        trackById,
+        cursor = _blockHole,
+        arrayChange = _lastCollection != collection;
+
+    if (arrayChange) { _lastCollection = collection; }
+    if (collection is! Iterable) {
+      collection = [];
+    }
+
+    List<_Row> newRowOrder = _computeNewRows(collection, trackById);
+
+    for (var index = 0, length = collection.length; index < length; index++) {
+      var key = index;
+      var value = collection.elementAt(index);
+      _Row row = newRowOrder[index];
+
+      if (row.startNode != null) {
+        // if we have already seen this object, then we need to reuse the
+        // associated scope/element
+        childScope = row.scope;
+
+        nextNode = previousNode;
+        do {
+          nextNode = nextNode.nextNode;
+        } while(nextNode != null);
+
+        if (row.startNode == nextNode) {
+          // do nothing
+        } else {
+          // existing item which got moved
+          row.block.moveAfter(cursor);
+        }
+        previousNode = row.endNode;
+      } else {
+        // new item which we don't know about
+        childScope = _scope.$new(lazy:_shalow);
+      }
+
+      if (!identical(childScope[_valueIdentifier], value)) {
+        childScope[_valueIdentifier] = value;
+        childScope.$dirty();
+      }
+      childScope[r'$index'] = index;
+      childScope[r'$first'] = (index == 0);
+      childScope[r'$last'] = (index == (collection.length - 1));
+      childScope[r'$middle'] = !(childScope.$first || childScope.$last);
+      childScope[r'$odd'] = index & 1 == 1;
+      childScope[r'$even'] = index & 1 == 0;
+      if (arrayChange && _shalow) {
+        childScope.$dirty();
+      }
+
+      if (row.startNode == null) {
+        _rows[row.id] = row;
+        var block = _boundBlockFactory(childScope);
+        row..block = block
+          ..scope = childScope
+          ..elements = block.elements
+          ..startNode = row.elements[0]
+          ..endNode = row.elements[row.elements.length - 1];
+        block.insertAfter(cursor);
+      }
+      cursor = row.block;
+    }
+  }
+}