@expressive/mvc 1.0.0-beta.42 → 1.0.0-beta.45

package/lib/index.d.ts

@@ -18,6 +18,8 @@ declare function act<S>(action: Async<S>): typeof action & {
     active: boolean;
 };
 
+declare function array<T = any>(): T[];
+
 type Callback = () => void;
 type Class = new (...args: any[]) => any;
 type InstanceOf<T> = T extends { prototype: infer U } ? U : never;
@@ -34,7 +36,7 @@ declare class Subscriber<T extends Stateful = any> {
     commit: () => () => void;
     active: boolean;
     dependant: Set<Listener>;
-    watch: { [key in Model.Event<T, Model>]: true | Callback; };
+    watch: { [key in Model.Event<T, Model>]: boolean | Callback; };
     constructor(target: Controller<T> | T, onUpdate: Controller.OnEvent);
 }
 
@@ -200,41 +202,31 @@ declare class Controller<T extends Stateful = any> {
  * Property initializer, will run upon instance creation.
  * Optional returned callback will run when once upon first access.
  */
-type Instruction<T> = (this: Controller, key: string, thisArg: Controller) =>
-  | Instruction.Getter<T> 
-  | Instruction.ExplicitDescriptor
-  | Instruction.Descriptor<T>
-  | Instruction.RecursiveDescriptor<T>
-  | boolean
-  | void;
-
+declare type Instruction<T> = (this: Controller, key: string, thisArg: Controller) => Instruction.Getter<T> | Instruction.ExplicitDescriptor | Instruction.Descriptor<T> | Instruction.RecursiveDescriptor<T> | boolean | void;
 declare namespace Instruction {
-  type Getter<T> = (state: T, within?: Subscriber) => T;
-  type Setter<T> = (value: T, state: any) => boolean | void;
-
-  type Runner<T> = (this: Controller, key: string, on: Controller) => Instruction.Descriptor<T> | boolean | undefined;
-
-  interface Descriptor<T> {
-    configurable?: boolean;
-    enumerable?: boolean;
-    value?: T;
-    writable?: boolean;
-    get?: Getter<T>;
-    set?: Setter<T> | false | void;
-  }
-
-  interface ExplicitDescriptor extends PropertyDescriptor {
-    explicit: true;
-  }
-
-  interface RecursiveDescriptor<T> {
-    recursive: true;
-    enumerable?: boolean;
-    value?: T;
-    set?: Setter<T> | false | void;
-  }
+    type Getter<T> = (state: T, within?: Subscriber) => T;
+    type Setter<T> = (value: T, state: any) => boolean | void;
+    type Runner<T> = (this: Controller, key: string, on: Controller) => Instruction.Descriptor<T> | boolean | undefined;
+    interface Descriptor<T> {
+        configurable?: boolean;
+        enumerable?: boolean;
+        value?: T;
+        writable?: boolean;
+        get?: Getter<T>;
+        set?: Setter<T> | false;
+        suspense?: boolean;
+    }
+    interface ExplicitDescriptor extends PropertyDescriptor {
+        explicit: true;
+    }
+    interface RecursiveDescriptor<T> {
+        recursive: true;
+        enumerable?: boolean;
+        value?: T;
+        set?: Setter<T> | false;
+        suspense?: boolean;
+    }
 }
-
 /**
  * Run instruction as controller sets itself up.
  * This will specialize the behavior of a given property.
@@ -533,8 +525,23 @@ declare class Global extends MVC {
      * Returns a thenable; resolves after successful update.
      * If instance does not already exist, one will be created.
      */
-    static set<T extends typeof Global>(this: T, updates: Partial<InstanceOf<T>>): PromiseLike<false | readonly Model.Event<Global, Model>[]>;
-    static get(arg?: boolean | string): any;
+    static set<T extends typeof Global>(this: T, updates: Partial<InstanceOf<T>>): Promise<false>;
+    /**
+     * **React Hook** - Fetch most instance of this controller from context, if it exists.
+     *
+     * @param required - If false, may return undefined.
+     */
+    static get<T extends Class>(this: T, required?: true): InstanceOf<T>;
+    /**
+     * **React Hook** - Fetch most instance of this controller from context.
+     *
+     * @param required - Unless false, will throw where instance cannot be found.
+     */
+    static get<T extends Class>(this: T, required: boolean): InstanceOf<T> | undefined;
+    /**
+     * **React Hook** - Fetch specific value from instance of this controller in context.
+     */
+    static get<T extends Class, K extends Model.Field<InstanceOf<T>>>(this: T, key: K): InstanceOf<T>[K];
     /** Destroy current instance of Global, if it exists. */
     static reset(): void;
     destroy(): void;
@@ -590,4 +597,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, from, parent, ref, set, tap, use, useFrom, useInContext, useModel, useTap };
+export { CONTROL, Consumer, Global, LOCAL, MVC as Model, Provider, STATE, Stateful, WHY, act, apply, array, MVC as default, from, parent, ref, set, tap, use, useFrom, useInContext, useModel, useTap };