@expressive/mvc 0.5.0 → 0.6.2

package/lib/index.d.ts

@@ -229,9 +229,8 @@ declare function act<S>(action: Async<S>): typeof action & {
 };
 
 declare namespace get {
-    type Function<T, O = any> = (this: O, on: O) => T;
-    type Factory<T, O = any> = (key: string) => Function<T, O>;
-    type Getter = (controller: Controller, key: string) => any;
+    type Function<T, S = any> = (this: S, on: S) => T;
+    type Factory<T, S = unknown> = (this: S, key: string, thisArg: S) => T;
 }
 /**
  * Implement a computed value; output will be generated by provided function.
@@ -248,35 +247,8 @@ declare function get<R, T>(source: T, compute: (this: T, on: T) => R, suspend?:
  * @param compute - Factory function to generate a getter to subscribe dependancies.
  * @param suspend - Value will throw suspense when evaulating to undefined.
  */
-declare function get<R, T>(compute: (property: string) => (this: T, state: T) => R, suspend: true): Exclude<R, undefined>;
-declare function get<R, T>(compute: (property: string) => (this: T, state: T) => R, suspend?: boolean): R;
-
-declare namespace ref {
-    type Callback<T, S = any> = (this: S, argument: T) => ((next: T) => void) | Promise<void> | void | boolean;
-    interface Object<T = any> {
-        (next: T): void;
-        current: T | null;
-    }
-    /** Object with references to all managed values of `T`. */
-    type Proxy<T extends Model> = {
-        [P in Model.Field<T>]: Model.Ref<T[P]>;
-    };
-}
-/**
- * Creates a ref-compatible property.
- * Will persist value, and updates to this are made part of controller event-stream.
- *
- * *Output is simultaneously a ref-function and ref-object, use as needed.*
- *
- * @param callback - Optional callback to synchronously fire when reference is first set or does update.
- */
-declare function ref<T = HTMLElement>(callback?: ref.Callback<T>): ref.Object<T>;
-declare function ref<T, S>(callback?: ref.Callback<T, S>): ref.Object<T>;
-
-declare namespace set$1 {
-    type Factory<T, S = unknown> = (this: S, key: string, subject: S) => T;
-    type Callback<T, S = any> = (this: S, argument: T) => ((next: T) => void) | Promise<any> | void | boolean;
-}
+declare function get<R, T>(compute: (property: string, on: T) => (this: T, state: T) => R, suspend: true): Exclude<R, undefined>;
+declare function get<R, T>(compute: (property: string, on: T) => (this: T, state: T) => R, suspend?: boolean): R;
 /**
  * Set property with an async function.
  *
@@ -292,12 +264,10 @@ declare namespace set$1 {
  * @param factory - Callback run to derrive property value.
  * @param required - (default: true) Run factory immediately on creation, otherwise on access.
  */
-declare function put<T>(factory: set$1.Factory<Promise<T>>, required: false): T | undefined;
-declare function put<T, S>(factory: set$1.Factory<Promise<T>, S>, required: false): T | undefined;
-declare function put<T>(factory: set$1.Factory<Promise<T>>, required?: boolean): T;
-declare function put<T, S>(factory: set$1.Factory<Promise<T>, S>, required?: boolean): T;
-declare function put<T>(value: set$1.Factory<Promise<T>>, onUpdate: set$1.Callback<T>): T;
-declare function put<T, S>(value: set$1.Factory<Promise<T>, S>, onUpdate: set$1.Callback<T, S>): T;
+declare function get<T>(factory: get.Factory<Promise<T>>, required: false): T | undefined;
+declare function get<T, S>(factory: get.Factory<Promise<T>, S>, required: false): T | undefined;
+declare function get<T>(factory: get.Factory<Promise<T>>, required?: boolean): T;
+declare function get<T, S>(factory: get.Factory<Promise<T>, S>, required?: boolean): T;
 /**
  * Set property with a factory function.
  *
@@ -310,24 +280,37 @@ declare function put<T, S>(value: set$1.Factory<Promise<T>, S>, onUpdate: set$1.
  * @param factory - Callback run to derrive property value.
  * @param required - (default: true) Run factory immediately on creation, otherwise on access.
  */
-declare function put<T>(factory: set$1.Factory<T>, required: false): T | undefined;
-declare function put<T, S>(factory: set$1.Factory<T, S>, required: false): T | undefined;
-declare function put<T>(factory: set$1.Factory<T>, required?: boolean): T;
-declare function put<T, S>(factory: set$1.Factory<T, S>, required?: boolean): T;
-declare function put<T>(value: set$1.Factory<T>, onUpdate: set$1.Callback<T>): T;
-declare function put<T, S>(value: set$1.Factory<T, S>, onUpdate: set$1.Callback<T, S>): T;
+declare function get<T>(factory: get.Factory<T>, required: false): T | undefined;
+declare function get<T, S>(factory: get.Factory<T, S>, required: false): T | undefined;
+declare function get<T>(factory: get.Factory<T>, required?: boolean): T;
+declare function get<T, S>(factory: get.Factory<T, S>, required?: boolean): T;
 /**
  * Assign a property with result of a promise.
  */
-declare function put<T>(factory: Promise<T>, required: false): T | undefined;
-declare function put<T>(factory: Promise<T>, required?: boolean): T;
-declare function put<T>(value: Promise<T>, onUpdate: set$1.Callback<T>): T;
+declare function get<T>(factory: Promise<T>, required: false): T | undefined;
+declare function get<T>(factory: Promise<T>, required?: boolean): T;
+
+declare namespace ref {
+    type Callback<T, S = any> = (this: S, argument: T) => ((next: T) => void) | Promise<void> | void | boolean;
+    interface Object<T = any> {
+        (next: T): void;
+        current: T | null;
+    }
+    /** Object with references to all managed values of `T`. */
+    type Proxy<T extends Model> = {
+        [P in Model.Field<T>]: Model.Ref<T[P]>;
+    };
+}
 /**
- * Assign a property.
+ * Creates a ref-compatible property.
+ * Will persist value, and updates to this are made part of controller event-stream.
+ *
+ * *Output is simultaneously a ref-function and ref-object, use as needed.*
+ *
+ * @param callback - Optional callback to synchronously fire when reference is first set or does update.
  */
-declare function put<T>(factory: T, required: false): T | undefined;
-declare function put<T>(factory: T, required?: boolean): T;
-declare function put<T>(value: T, onUpdate: set$1.Callback<T>): T;
+declare function ref<T = HTMLElement>(callback?: ref.Callback<T>): ref.Object<T>;
+declare function ref<T, S>(callback?: ref.Callback<T, S>): ref.Object<T>;
 
 declare namespace set {
     type Callback<T, S = any> = (this: S, argument: T) => ((next: T) => void) | Promise<any> | void | boolean;
@@ -347,10 +330,11 @@ declare function set<T>(value: T, onUpdate: set.Callback<T>): T;
 declare function set<T, S>(value: T, onUpdate: set.Callback<T, S>): T;
 
 declare type MapFunction<T, R> = T extends Map<infer K, infer V> ? (value: V, key: K, map: T) => R | void : T extends Set<infer K> ? (value: K, key: K, set: T) => R | void : never;
-declare type Managed<T> = T & {
+declare type Managed<T> = Exclude<T, "forEach"> & {
     from?: T;
     forEach<R>(mapFunction: MapFunction<T, R>, thisArg?: any): Exclude<R, undefined>[] | void;
 };
+
 declare function use<K = any>(initial: SetConstructor): Managed<Set<K>>;
 declare function use<K = any, V = any>(initial: MapConstructor): Managed<Map<K, V>>;
 declare function use(initial: Set<unknown>): Managed<Set<any>>;
@@ -363,6 +347,8 @@ declare function use<T extends Set<any> | Map<any, any>>(from: () => T): Managed
  * Create a placeholder for specified Model type.
  */
 declare function use<T extends Model>(): T | undefined;
+declare function use<T extends Model>(from: () => T, required: false): T | undefined;
+declare function use<T extends Model>(from: () => T, required: boolean): T;
 /**
  * Create a new child instance of model.
  */
@@ -370,6 +356,9 @@ declare function use<T extends Class>(Type: T, callback?: (i: InstanceOf<T>) =>
 /**
  * Create a managed child from factory function.
  */
+declare function use<T extends {}>(from: () => Promise<T>, required: false): T | undefined;
+declare function use<T extends {}>(from: () => Promise<T>, required: boolean): T;
+declare function use<T extends {}>(from: () => Promise<T>, callback?: (i: T) => void): T;
 declare function use<T extends {}>(from: () => T, callback?: (i: T) => void): T;
 /**
  * Create child-instance relationship with provided model.
@@ -625,4 +614,4 @@ declare function useTap<T extends Stateful, K extends Model.Field<T>>(source: T
 declare function useTap<T extends Stateful, R>(source: T | (() => T) | useTap.Tappable, compute: (this: T, from: T) => R, expect: true): Exclude<R, undefined>;
 declare function useTap<T extends Stateful, R>(source: T | (() => T) | useTap.Tappable, compute: (this: T, from: T) => R, expect?: boolean): R;
 
-export { CONTROL, Consumer, Global, LOCAL, MVC as Model, Provider, STATE, Stateful, WHY, act, apply, MVC as default, get, has, put, ref, set, tap, use, useFrom, useLocal, useModel, useTap };
+export { CONTROL, Consumer, Global, LOCAL, MVC as Model, Provider, STATE, Stateful, WHY, act, apply, MVC as default, get, has, ref, set, tap, use, useFrom, useLocal, useModel, useTap };