docs: create public API surface

Closes angular#1181

Author: mhevery

modules/angular2/change_detection.js

@@ -39,6 +39,10 @@ export var defaultPipes = {
   ]
 };
 
+
+/**
+ * @publicModule angular2/change_detection
+ */
 export class DynamicChangeDetection extends ChangeDetection {
   registry:PipeRegistry;
 
@@ -52,6 +56,9 @@ export class DynamicChangeDetection extends ChangeDetection {
   }
 }
 
+/**
+ * @publicModule angular2/change_detection
+ */
 export class JitChangeDetection extends ChangeDetection {
   registry:PipeRegistry;
 

modules/angular2/pipes.js

@@ -0,0 +1,3 @@
+/**
+ * Define public API for Angular here.
+ */

modules/angular2/src/change_detection/binding_propagation_config.js

@@ -2,7 +2,7 @@ import {ChangeDetector} from './interfaces';
 import {CHECK_ONCE, DETACHED, CHECK_ALWAYS} from './constants';
 
 /**
- * @publicModule angular2/angular2
+ * @publicModule angular2/change_detection
  */
 export class BindingPropagationConfig {
   _cd:ChangeDetector;

modules/angular2/src/change_detection/pipes/iterable_changes.js

@@ -26,6 +26,9 @@ export class IterableChangesFactory {
   }
 }
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class IterableChanges extends Pipe {
   _collection;
   _length:int;
@@ -501,6 +504,9 @@ export class IterableChanges extends Pipe {
   }
 }
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class CollectionChangeRecord  {
   currentIndex:int;
   previousIndex:int;

modules/angular2/src/change_detection/pipes/keyvalue_changes.js

@@ -3,6 +3,9 @@ import {stringify, looseIdentical, isJsObject} from 'angular2/src/facade/lang';
 
 import {NO_CHANGE, Pipe} from './pipe';
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class KeyValueChangesFactory {
   supports(obj):boolean {
     return KeyValueChanges.supportsObj(obj);
@@ -13,6 +16,9 @@ export class KeyValueChangesFactory {
   }
 }
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class KeyValueChanges extends Pipe {
   _records:Map;
 
@@ -349,6 +355,9 @@ export class KeyValueChanges extends Pipe {
 
 
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class KVChangeRecord {
   key;
   previousValue;

modules/angular2/src/change_detection/pipes/null_pipe.js

@@ -1,6 +1,9 @@
 import {isBlank} from 'angular2/src/facade/lang';
 import {Pipe, NO_CHANGE} from './pipe';
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class NullPipeFactory {
   supports(obj):boolean {
     return NullPipe.supportsObj(obj);
@@ -11,6 +14,9 @@ export class NullPipeFactory {
   }
 }
 
+/**
+ * @publicModule angular2/pipes
+ */
 export class NullPipe extends Pipe {
   called:boolean;
   constructor() {

modules/angular2/src/change_detection/pipes/pipe.js

@@ -1,5 +1,8 @@
 export var NO_CHANGE = new Object();
 
+/**
+ * @publicModule angular2/angular2
+ */
 export class Pipe {
   supports(obj):boolean {return false;}
   onDestroy() {}

modules/angular2/src/core/compiler/compiler.js

@@ -22,7 +22,6 @@ import {CssProcessor} from './css_processor';
 /**
  * Cache that stores the ProtoView of the template of a component.
  * Used to prevent duplicate work and resolve cyclic dependencies.
- * @publicModule angular2/angular2
  */
 @Injectable()
 export class CompilerCache {
@@ -49,7 +48,8 @@ export class CompilerCache {
  * The compiler loads and translates the html templates of components into
  * nested ProtoViews. To decompose its functionality it uses
  * the CompilePipeline and the CompileSteps.
- * @publicModule angular2/angular2
+ *
+ * @publicModule angular2/template
  */
 @Injectable()
 export class Compiler {
@@ -90,6 +90,7 @@ export class Compiler {
     this._cssProcessor = cssProcessor;
   }
 
+  // todo(misko): should be private method
   createSteps(component:Type, template: Template):List<CompileStep> {
     var dirMetadata = ListWrapper.map(this._flattenDirectives(template),
       (d) => this._reader.read(d));

modules/angular2/src/core/compiler/shadow_dom_strategy.js

@@ -30,6 +30,9 @@ function _emptyStep() {
   return _EMPTY_STEP;
 }
 
+/**
+ * @publicModule angular2/template
+ */
 export class ShadowDomStrategy {
   attachTemplate(el, view:viewModule.View) {}
   constructLightDom(lightDomView:viewModule.View, shadowDomView:viewModule.View, el): LightDom { return null; }
@@ -77,6 +80,8 @@ export class ShadowDomStrategy {
  * Notes:
  * - styles are **not** scoped to their component and will apply to the whole document,
  * - you can **not** use shadow DOM specific selectors in the styles
+ * 
+ * @publicModule angular2/template
  */
 @Injectable()
 export class EmulatedUnscopedShadowDomStrategy extends ShadowDomStrategy {
@@ -119,6 +124,8 @@ export class EmulatedUnscopedShadowDomStrategy extends ShadowDomStrategy {
  * - styles are scoped to their component and will apply only to it,
  * - a common subset of shadow DOM selectors are supported,
  * - see `ShadowCss` for more information and limitations.
+ * 
+ * @publicModule angular2/template
  */
 @Injectable()
 export class EmulatedScopedShadowDomStrategy extends EmulatedUnscopedShadowDomStrategy {

modules/angular2/src/core/compiler/template_loader.js

@@ -11,7 +11,7 @@ import {UrlResolver} from 'angular2/src/services/url_resolver';
 
 /**
  * Strategy to load component templates.
- * @publicModule angular2/angular2
+ * @publicModule angular2/template
  */
 @Injectable()
 export class TemplateLoader {