@expressive/mvc 0.24.2 → 0.25.0

package/lib/index.d.ts

@@ -57,16 +57,17 @@ declare namespace Control {
     type Getter<T> = (source: Model) => T;
     type Setter<T> = (value: T) => boolean | void;
     type PropertyDescriptor<T = any> = {
-        enumerable?: boolean;
-        value?: T;
         get?: Getter<T>;
         set?: Setter<T> | false;
+        enumerable?: boolean;
+        value?: T;
     };
+    type Callback = (control: Control) => void;
     /**
      * Callback for Controller.for() static method.
      * Returned callback is forwarded.
      */
-    type OnReady<T extends {}> = (control: Control<T>) => Callback | void;
+    type OnReady<T extends {}> = (control: Control<T>) => (() => void) | void;
     type RequestRefresh = (update: (tick: number) => number) => void;
     type GetContext = (target: Model) => (callback: (got: Context) => void) => void;
     type GetAdapter<T> = (refresh: RequestRefresh, context: Context) => {
@@ -75,15 +76,14 @@ declare namespace Control {
     } | void;
     type GetHook = <T>(adapter: GetAdapter<T>) => T | null;
     type UseAdapter<T extends Model, R> = (refresh: RequestRefresh) => {
-        local: T;
+        instance: T;
         mount: () => (() => void) | void;
         render: R;
     };
     type UseHook = <T extends Model, R>(adapter: UseAdapter<T, R>) => R;
 }
 declare class Control<T extends {} = any> {
-    subject: T;
-    id: string | number;
+    static ready: Set<Control.Callback>;
     static after: Set<Callback>;
     static before: Set<Callback>;
     static pending: Set<Callback>;
@@ -93,6 +93,8 @@ declare class Control<T extends {} = any> {
     static for: typeof control;
     static apply: typeof apply;
     static watch: typeof watch;
+    id: string | number;
+    subject: T;
     state: {
         [key: string]: any;
     };
@@ -154,19 +156,12 @@ type Debug<T extends Model = Model> = T & {
 
 /** Type may not be undefined - instead will be null.  */
 type NoVoid<T> = T extends undefined | void ? null : T;
-declare function get$1<T extends Model>(this: Model.Type<T>): T;
-/** Fetch instance of this class in passive mode. Will not subscribe to events. */
+/** Fetch instance of this class from context. */
 declare function get$1<T extends Model>(this: Model.Type<T>, ignoreUpdates?: true): T;
 /** Fetch instance of this class optionally. May be undefined, but will never subscribe. */
 declare function get$1<T extends Model>(this: Model.Type<T>, required: boolean): T | undefined;
-declare function get$1<T extends Model, R extends []>(this: Model.Type<T>, factory: Model.GetCallback<T, R | (() => R)>, expect?: boolean): R;
-declare function get$1<T extends Model, R extends []>(this: Model.Type<T>, factory: Model.GetCallback<T, Promise<R> | (() => R) | null>, expect?: boolean): R | null;
-declare function get$1<T extends Model, R extends []>(this: Model.Type<T>, factory: Model.GetCallback<T, Promise<R> | R>, expect: true): Exclude<R, undefined>;
-declare function get$1<T extends Model, R>(this: Model.Type<T>, init: Model.GetCallback<T, () => R>): NoVoid<R>;
-declare function get$1<T extends Model, R>(this: Model.Type<T>, init: Model.GetCallback<T, (() => R) | null>): NoVoid<R> | null;
-declare function get$1<T extends Model, R>(this: Model.Type<T>, compute: Model.GetCallback<T, Promise<R> | R>, expect: true): Exclude<R, undefined>;
-declare function get$1<T extends Model, R>(this: Model.Type<T>, compute: Model.GetCallback<T, Promise<R>>, expect?: boolean): NoVoid<R> | null;
-declare function get$1<T extends Model, R>(this: Model.Type<T>, compute: Model.GetCallback<T, R>, expect?: boolean): NoVoid<R>;
+declare function get$1<T extends Model, R>(this: Model.Type<T>, factory: Model.GetCallback<T, (() => R) | R | Promise<R>>): NoVoid<R>;
+declare function get$1<T extends Model, R>(this: Model.Type<T>, factory: Model.GetCallback<T, (() => R) | null>): NoVoid<R> | null;
 
 declare function use$1<T extends Model>(this: Model.New<T>, callback?: (instance: T) => void, repeat?: boolean): T;
 declare function use$1<T extends Model>(this: Model.New<T>, apply?: Model.Compat<T>, repeat?: boolean): T;
@@ -251,7 +246,7 @@ declare class Model {
     get<P extends Model.Key<this>>(select: Iterable<P>): Model.Get<this, P>;
     get<P extends Model.Key<this>>(select: P, listener: (this: this, value: this[P]) => void): Callback;
     get<P extends Model.Key<this>>(select: Iterable<P>, listener: (this: this, value: Model.Get<this, P>) => void): Callback;
-    set<T extends Model.Compat<this>>(source: T, select?: (keyof T)[]): Promise<Model.Key<T>[]>;
+    set<T extends Model.Compat<this>>(source: T, only?: (keyof T)[]): Promise<Model.Key<T>[]>;
     set<K extends Model.Event<this>>(key: K, value?: Model.ValueOf<this, K>): Promise<Model.Event<this>[] | false>;
     /** Mark this instance for garbage collection. */
     null(): void;

package/lib/index.esm.js

@@ -197,18 +197,18 @@ function awaitUpdate(source, select, timeout) {
 const Oops$6 = issues({
     NotFound: (name) => `Could not find ${name} in context.`
 });
-function get$1(arg1, arg2) {
+function get$1(argument) {
     return Control.get((dispatch, context) => {
         const refresh = () => dispatch(x => x + 1);
         let onUpdate;
         let value;
-        if (typeof arg1 !== "function") {
+        if (typeof argument !== "function") {
             const got = context.get(this);
             if (got)
-                value = arg1 === undefined
+                value = argument === undefined
                     ? Control.watch(got, k => k ? onUpdate : undefined)
                     : got;
-            else if (arg1 !== false)
+            else if (argument !== false)
                 throw Oops$6.NotFound(this);
             return {
                 mount() {
@@ -218,7 +218,7 @@ function get$1(arg1, arg2) {
                 render: () => value
             };
         }
-        let compute = arg1;
+        let compute = argument;
         let suspense;
         let getValue;
         let factory;
@@ -268,7 +268,7 @@ function get$1(arg1, arg2) {
         else
             onUpdate = () => {
                 const next = getValue();
-                if (notEqual(value, next))
+                if (value !== next)
                     didUpdate(next);
             };
         return {
@@ -278,30 +278,25 @@ function get$1(arg1, arg2) {
             render: () => {
                 if (value !== undefined)
                     return value;
-                if (arg2)
-                    throw new Promise(res => {
-                        suspense = res;
-                    });
-                return null;
+                if (onUpdate)
+                    return null;
+                throw new Promise(res => {
+                    suspense = res;
+                });
             }
         };
     });
-}
-/** Values are not equal for purposes of a refresh. */
-const notEqual = (a, b) => (b !== a && (!Array.isArray(a) ||
-    !Array.isArray(b) ||
-    a.length !== b.length ||
-    a.some((x, i) => x !== b[i])));
+}
 
-function use$1(arg1, arg2) {
+function use$1(apply, repeat) {
     const render = Control.use(dispatch => {
         const instance = this.new();
         const local = Control.watch(instance, () => onUpdate);
         const refresh = () => dispatch(x => x + 1);
         let onUpdate;
-        let apply = !!arg1;
+        let shouldApply = !!apply;
         return {
-            local,
+            instance,
             mount() {
                 onUpdate = refresh;
                 return () => {
@@ -310,7 +305,7 @@ function use$1(arg1, arg2) {
                 };
             },
             render(props) {
-                if (apply) {
+                if (shouldApply) {
                     onUpdate = undefined;
                     if (typeof props == "function")
                         props(instance);
@@ -318,15 +313,15 @@ function use$1(arg1, arg2) {
                         for (const key in instance)
                             if (props.hasOwnProperty(key))
                                 instance[key] = props[key];
-                    if (!arg2)
-                        apply = false;
+                    if (!repeat)
+                        shouldApply = false;
                     instance.on(0).then(() => onUpdate = refresh);
                 }
                 return local;
             }
         };
     });
-    return render(arg1);
+    return render(apply);
 }
 
 class Model {
@@ -427,17 +422,20 @@ const Oops$5 = issues({
     BadAssignment: (parent, expected, got) => `${parent} expected Model of type ${expected} but got ${got}.`,
 });
 const INSTRUCTION = new Map();
+const PENDING$1 = new WeakMap();
 const REGISTER = new WeakMap();
 const OBSERVER = new WeakMap();
 const PARENTS = new WeakMap();
 class Control {
-    constructor(subject, id = uid()) {
-        this.subject = subject;
-        this.id = id;
+    constructor(subject, id) {
+        this.state = {};
         this.frame = new Set();
         this.followers = new Set();
         this.observers = new Map([["", this.followers]]);
+        this.id = typeof id == "undefined" ? uid() : id;
+        this.subject = subject;
         REGISTER.set(subject, this);
+        PENDING$1.set(this, new Set(Control.ready));
     }
     add(key) {
         const { value } = getOwnPropertyDescriptor(this.subject, key);
@@ -529,31 +527,30 @@ class Control {
         this.observers.clear();
     }
 }
+Control.ready = new Set();
 Control.after = new Set();
 Control.before = new Set();
 Control.pending = new Set();
 Control.for = control;
 Control.apply = apply;
 Control.watch = watch;
-const PENDING_INIT = new WeakMap();
 function control(subject, ready) {
     const control = REGISTER.get(subject.is);
-    const onReady = typeof ready == "function" && ready;
-    if (!control.state && ready) {
-        let waiting = PENDING_INIT.get(control);
-        if (!waiting)
-            PENDING_INIT.set(control, waiting = new Set());
-        if (onReady) {
-            let callback;
-            waiting.add(() => callback = onReady(control));
-            return () => callback && callback();
-        }
-        control.state = {};
+    const pending = PENDING$1.get(control);
+    if (typeof ready == "function") {
+        if (!pending)
+            return ready(control);
+        let done;
+        pending.add(() => done = ready(control));
+        return () => done && done();
+    }
+    if (pending && ready) {
+        PENDING$1.delete(control);
         for (const key in control.subject)
             control.add(key);
-        waiting.forEach(cb => cb());
+        pending.forEach(cb => cb(control));
     }
-    return onReady ? onReady(control) : control;
+    return control;
 }
 function requestUpdateFrame(event) {
     const { after, before, pending } = Control;
@@ -586,10 +583,10 @@ function setRecursive(on, key, value) {
     on.watch(key, { set });
     set(value);
 }
-function parent(child, register) {
-    if (!register)
+function parent(child, assign) {
+    if (!assign)
         return PARENTS.get(child);
-    PARENTS.set(child, register);
+    PARENTS.set(child, assign);
 }
 function watch(on, cb) {
     if (!on.hasOwnProperty("is"))

package/lib/index.js

@@ -201,18 +201,18 @@ function awaitUpdate(source, select, timeout) {
 const Oops$6 = issues({
     NotFound: (name) => `Could not find ${name} in context.`
 });
-function get$1(arg1, arg2) {
+function get$1(argument) {
     return Control.get((dispatch, context) => {
         const refresh = () => dispatch(x => x + 1);
         let onUpdate;
         let value;
-        if (typeof arg1 !== "function") {
+        if (typeof argument !== "function") {
             const got = context.get(this);
             if (got)
-                value = arg1 === undefined
+                value = argument === undefined
                     ? Control.watch(got, k => k ? onUpdate : undefined)
                     : got;
-            else if (arg1 !== false)
+            else if (argument !== false)
                 throw Oops$6.NotFound(this);
             return {
                 mount() {
@@ -222,7 +222,7 @@ function get$1(arg1, arg2) {
                 render: () => value
             };
         }
-        let compute = arg1;
+        let compute = argument;
         let suspense;
         let getValue;
         let factory;
@@ -272,7 +272,7 @@ function get$1(arg1, arg2) {
         else
             onUpdate = () => {
                 const next = getValue();
-                if (notEqual(value, next))
+                if (value !== next)
                     didUpdate(next);
             };
         return {
@@ -282,30 +282,25 @@ function get$1(arg1, arg2) {
             render: () => {
                 if (value !== undefined)
                     return value;
-                if (arg2)
-                    throw new Promise(res => {
-                        suspense = res;
-                    });
-                return null;
+                if (onUpdate)
+                    return null;
+                throw new Promise(res => {
+                    suspense = res;
+                });
             }
         };
     });
-}
-/** Values are not equal for purposes of a refresh. */
-const notEqual = (a, b) => (b !== a && (!Array.isArray(a) ||
-    !Array.isArray(b) ||
-    a.length !== b.length ||
-    a.some((x, i) => x !== b[i])));
+}
 
-function use$1(arg1, arg2) {
+function use$1(apply, repeat) {
     const render = Control.use(dispatch => {
         const instance = this.new();
         const local = Control.watch(instance, () => onUpdate);
         const refresh = () => dispatch(x => x + 1);
         let onUpdate;
-        let apply = !!arg1;
+        let shouldApply = !!apply;
         return {
-            local,
+            instance,
             mount() {
                 onUpdate = refresh;
                 return () => {
@@ -314,7 +309,7 @@ function use$1(arg1, arg2) {
                 };
             },
             render(props) {
-                if (apply) {
+                if (shouldApply) {
                     onUpdate = undefined;
                     if (typeof props == "function")
                         props(instance);
@@ -322,15 +317,15 @@ function use$1(arg1, arg2) {
                         for (const key in instance)
                             if (props.hasOwnProperty(key))
                                 instance[key] = props[key];
-                    if (!arg2)
-                        apply = false;
+                    if (!repeat)
+                        shouldApply = false;
                     instance.on(0).then(() => onUpdate = refresh);
                 }
                 return local;
             }
         };
     });
-    return render(arg1);
+    return render(apply);
 }
 
 class Model {
@@ -431,17 +426,20 @@ const Oops$5 = issues({
     BadAssignment: (parent, expected, got) => `${parent} expected Model of type ${expected} but got ${got}.`,
 });
 const INSTRUCTION = new Map();
+const PENDING$1 = new WeakMap();
 const REGISTER = new WeakMap();
 const OBSERVER = new WeakMap();
 const PARENTS = new WeakMap();
 class Control {
-    constructor(subject, id = uid()) {
-        this.subject = subject;
-        this.id = id;
+    constructor(subject, id) {
+        this.state = {};
         this.frame = new Set();
         this.followers = new Set();
         this.observers = new Map([["", this.followers]]);
+        this.id = typeof id == "undefined" ? uid() : id;
+        this.subject = subject;
         REGISTER.set(subject, this);
+        PENDING$1.set(this, new Set(Control.ready));
     }
     add(key) {
         const { value } = getOwnPropertyDescriptor(this.subject, key);
@@ -533,31 +531,30 @@ class Control {
         this.observers.clear();
     }
 }
+Control.ready = new Set();
 Control.after = new Set();
 Control.before = new Set();
 Control.pending = new Set();
 Control.for = control;
 Control.apply = apply;
 Control.watch = watch;
-const PENDING_INIT = new WeakMap();
 function control(subject, ready) {
     const control = REGISTER.get(subject.is);
-    const onReady = typeof ready == "function" && ready;
-    if (!control.state && ready) {
-        let waiting = PENDING_INIT.get(control);
-        if (!waiting)
-            PENDING_INIT.set(control, waiting = new Set());
-        if (onReady) {
-            let callback;
-            waiting.add(() => callback = onReady(control));
-            return () => callback && callback();
-        }
-        control.state = {};
+    const pending = PENDING$1.get(control);
+    if (typeof ready == "function") {
+        if (!pending)
+            return ready(control);
+        let done;
+        pending.add(() => done = ready(control));
+        return () => done && done();
+    }
+    if (pending && ready) {
+        PENDING$1.delete(control);
         for (const key in control.subject)
             control.add(key);
-        waiting.forEach(cb => cb());
+        pending.forEach(cb => cb(control));
     }
-    return onReady ? onReady(control) : control;
+    return control;
 }
 function requestUpdateFrame(event) {
     const { after, before, pending } = Control;
@@ -590,10 +587,10 @@ function setRecursive(on, key, value) {
     on.watch(key, { set });
     set(value);
 }
-function parent(child, register) {
-    if (!register)
+function parent(child, assign) {
+    if (!assign)
         return PARENTS.get(child);
-    PARENTS.set(child, register);
+    PARENTS.set(child, assign);
 }
 function watch(on, cb) {
     if (!on.hasOwnProperty("is"))

package/package.json

@@ -26,6 +26,6 @@
     "prebuild": "rm -rf lib/",
     "preversion": "npm run test && npm run build"
   },
-  "version": "0.24.2",
-  "gitHead": "97e6daffcf793d8aa1152d553b4c427546e90dbc"
+  "version": "0.25.0",
+  "gitHead": "a7c707bf59325bd4bf1388e061f7991acb726a13"
 }