feat(ngRef): 1. bind controllers to scope

Author: drpicox

angularFiles.js

@@ -58,7 +58,6 @@ var angularFiles = {
     'src/ng/directive/attrs.js',
     'src/ng/directive/form.js',
     'src/ng/directive/input.js',
-    'src/ng/directive/ngAs.js',
     'src/ng/directive/ngBind.js',
     'src/ng/directive/ngChange.js',
     'src/ng/directive/ngClass.js',
@@ -75,6 +74,7 @@ var angularFiles = {
     'src/ng/directive/ngNonBindable.js',
     'src/ng/directive/ngOptions.js',
     'src/ng/directive/ngPluralize.js',
+    'src/ng/directive/ngRef.js',
     'src/ng/directive/ngRepeat.js',
     'src/ng/directive/ngShowHide.js',
     'src/ng/directive/ngStyle.js',

docs/content/error/ngRef/badident.ngdoc

@@ -0,0 +1,37 @@
+@ngdoc error
+@name ngRef:badident
+@fullName Invalid identifier expression
+@description
+
+Occurs when an invalid identifier is specified in an {@link ng.directive:ngRef ngRef} expression.
+
+The {@link ng.directive:ngRef ngRef} directive's symbol syntax is used to assign a reference for the component controller in scope.
+
+If the expression is not a simple identifier (such that you could declare it with `var {name}`, or if the expression is a reserved name,
+this error is thrown.
+
+Reserved names include:
+
+  - `null`
+  - `this`
+  - `undefined`
+  - `$parent`
+  - `$id`
+  - `$root`
+
+Invalid expressions might look like this:
+
+```html
+<my-component ng-ref="this"></my-component>
+<my-component ng-ref="some.objects["property"]"></my-component>
+<my-component ng-ref="$ctrl.propertyName"></my-component>
+<my-component ng-ref="resultOfSomeMethod()"></my-component>
+<my-component ng-ref="foo=6"></my-component>
+```
+
+Valid expressions might look like this:
+
+```html
+<my-component ng-ref="collections"></my-component>
+<my-component ng-ref="filteredCollection"></my-component>
+```

src/AngularPublic.js

@@ -12,7 +12,6 @@
   scriptDirective,
   selectDirective,
   optionDirective,
-  ngAsDirective,
   ngBindDirective,
   ngBindHtmlDirective,
   ngBindTemplateDirective,
@@ -29,6 +28,7 @@
   ngInitDirective,
   ngNonBindableDirective,
   ngPluralizeDirective,
+  ngRefDirective,
   ngRepeatDirective,
   ngShowDirective,
   ngStyleDirective,
@@ -180,7 +180,6 @@ function publishExternalAPI(angular) {
             script: scriptDirective,
             select: selectDirective,
             option: optionDirective,
-            ngAs: ngAsDirective,
             ngBind: ngBindDirective,
             ngBindHtml: ngBindHtmlDirective,
             ngBindTemplate: ngBindTemplateDirective,
@@ -196,6 +195,7 @@ function publishExternalAPI(angular) {
             ngInit: ngInitDirective,
             ngNonBindable: ngNonBindableDirective,
             ngPluralize: ngPluralizeDirective,
+            ngRef: ngRefDirective,
             ngRepeat: ngRepeatDirective,
             ngShow: ngShowDirective,
             ngStyle: ngStyleDirective,