dothtml-interfaces 0.1.9 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dothtml-interfaces",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "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})};
 }
@@ -577,9 +579,8 @@ interface IDotInput extends IDotElementDocument<IDotInput>{
 	width(value: unknown): IDotInput;
 
 	// Special functions:
-	bindTo(value: unknown): IDotInput;
-	getVal(): string
-	setVal(value: unknown): IDotInput;
+	// getVal(): string
+	// setVal(value: unknown): IDotInput;
 
 	// Input-specific events:
 	onSearch(callback: (e: Event)=>void): IDotInput;
@@ -642,9 +643,8 @@ interface IDotOption extends IDotElementDocument<IDotOption>{
 	value(value: unknown): IDotOption;
 
 	// Special functions:
-	bindTo(value: unknown): IDotOption;
-	getVal(): string;
-	setVal(value: unknown): IDotOption;
+	// getVal(): string;
+	// setVal(value: unknown): IDotOption;
 }
 interface IDotOutput extends IDotElementDocument<IDotOutput>{
 	for(value: unknown): IDotOutput;
@@ -673,9 +673,8 @@ interface IDotSelect extends IDotElementDocument<IDotSelect>{
 	whichForm(value: unknown): IDotSelect; // form
 
 	// Special functions:
-	bindTo(value: unknown): IDotSelect;
-	getVal(): string;
-	setVal(value: unknown): IDotSelect;
+	// getVal(): string;
+	// setVal(value: unknown): IDotSelect;
 }
 interface IDotSource extends IDotElementDocument<IDotSource>{
 	media(value: unknown): IDotSource;
@@ -713,9 +712,8 @@ interface IDotTextArea extends IDotElementDocument<IDotTextArea>{
 	wrap(value: unknown): IDotTextArea;
 
 	// Special functions:
-	bindTo(value: unknown): IDotTextArea;
-	getVal(): string;
-	setVal(value: unknown): IDotTextArea;
+	// getVal(): string;
+	// setVal(value: unknown): IDotTextArea;
 }
 interface IDotTBody extends IDotElementDocument<IDotTBody>{
 	/** @deprecated Deprecated in HTML5. Use CSS. */

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;