dothtml-interfaces 0.1.9 → 0.1.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dothtml-interfaces",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Dependency injection interfaces for DOTHtml.",
   "main": "src/index.d.ts",
   "types": "src/index.d.ts",

package/src/i-dot.d.ts

@@ -52,7 +52,7 @@ export interface IDotDocument
 	 * @param callback The markup-generating callback.
 	*/
 	iterate(n: number, callback: (i: number)=>DotContent): IDotDocument;
-	each<T>(a: Array<T>|(()=>Array<T>)|{[key: string]: T}, callback: (x: T, i: number|string)=>DotContent): IDotDocument;
+	each<T>(a: Array<T>|{[key: string|number]: T}|IObservable<any, Array<T>|{[key: string|number]: T}>, callback: (x: T, i: string|number, k: string|number)=>DotContent): IDotDocument;
 
 	/**
 	 * Removes the targeted document and everything in it.
@@ -234,6 +234,8 @@ export interface IDotCore extends IDotDocument
 	css: IDotCss;
 	bus: IEventBus;
 	window: IDotWindowBuilder;
+
+	observe<Ti extends IObservable|Array<any>|{[key: string|number]: any}|string|number|boolean = any, To = Ti>(props: {value: Ti, key?: string, transformer?: (value: Ti)=>To}): IObservable<Ti, To>;
 	
 	component<T extends {new(...args: any[]): (IComponent)}>(ComponentClass: T): T&{new(...args: any[]): ({$: FrameworkItems})};
 }

package/src/i-observable.d.ts

@@ -8,7 +8,12 @@ export default interface IObservable<Ti = any, To = Ti>{
 	getValue(): To;
 	// Set the value.
 	setValue(v: Ti);
-	// Optional transformer that can .
+
+	// Key is used for observable array proxy bindings.
+	// If a key is provided, it's used to uniquely identify array elements.
+	// If a key is not provided, identification is done automatically by the framework by comparing object references.
+	key: string;
+	// Optional transformer that can transform the input.
 	transformer?: (input: Ti)=>To;
 	subscribeNode(node: IDotDocument): number;
 	subscribeAttr(node: IDotDocument, attributeName: string): number;