@expressive/mvc 0.45.0 → 0.47.0

package/dist/index.d.ts

@@ -15,7 +15,7 @@ declare namespace Model {
     type Field<T> = Exclude<keyof T, keyof Model>;
     /** Any valid key for controller, including but not limited to Field<T>. */
     type Event<T> = Field<T> | (string & {}) | number | symbol;
-    /** Object overlay which may be used to override values and methods while creating model. */
+    /** Object overlay which may be used to override values and methods on a model. */
     type Assign<T> = {
         [K in Exclude<keyof T, keyof Model>]?: T[K] extends (...args: infer A) => infer R ? (this: T, ...args: A) => R : T[K];
     } & Record<string, unknown>;
@@ -201,8 +201,6 @@ declare class Model {
     static at<T extends Model>(this: Model.Type<T>, from: Model, cb: (got: T | undefined) => void): void;
 }
 
-declare function add<T = any>(instruction: Model.Instruction): T;
-
 declare namespace get {
     type Function<T, S = any> = (on: S, key: string) => T;
     type Factory<T, S = any> = (this: S, key: string, thisArg: S) => T;
@@ -346,19 +344,9 @@ declare function set<T>(factory: set.Factory<T> | Promise<T>, required?: boolean
  */
 declare function set<T>(value: T | undefined, onUpdate: set.Callback<T>): T;
 
-/** Create a placeholder for specified Model type. */
-declare function use<T extends Model>(): T | undefined;
-/** Create a new child instance of model. */
+declare function use<T = any>(instruction: Model.Instruction): T;
+declare function use<T extends Model>(Type: Model.Type<T>, required: false): T | undefined;
 declare function use<T extends Model>(Type: Model.Type<T>, ready?: (i: T) => void): T;
-/**
- * Use existing model as a child of model assigned to.
- *
- * Note: If `peer` is not already initialized before parent is
- * (created with `new` as opposed to create method), that model will
- * attach this via `parent()` instruction. It will not, however, if
- * already active.
- **/
-declare function use<T extends Model>(model: T, ready?: (i: T) => void): T;
 
 declare namespace has {
     type Callback<T = any> = (model: T) => void | boolean | (() => void);
@@ -380,7 +368,7 @@ declare class Context {
     key(T: Model.Type, upstream?: boolean): keyof this;
     has(model: Model): (() => void) | undefined;
     get<T extends Model>(Type: Model.Type<T>): T | undefined;
-    include(inputs: Context.Input): Map<Model, boolean>;
+    include(inputs: Context.Input, forEach?: (added: Model, explicit: boolean) => void): void;
     put<T extends Model>(T: Model.Type<T>, I: T | ((model: T) => void), implicit?: boolean, writable?: boolean): void;
     add<T extends Model>(input: T | Model.Type<T>, implicit?: boolean): T;
     push(inputs?: Context.Input): this;
@@ -404,4 +392,4 @@ declare global {
     }
 }
 
-export { Context, Model, add, Model as default, get, has, ref, set, use };
+export { Context, Model, Model as default, get, has, ref, set, use };

package/dist/index.js

@@ -22,7 +22,6 @@ var src_exports = {};
 __export(src_exports, {
   Context: () => Context,
   Model: () => Model,
-  add: () => add,
   default: () => Model,
   get: () => get,
   has: () => has,
@@ -66,13 +65,16 @@ function watch(from, key, value) {
 var PENDING = /* @__PURE__ */ new WeakMap();
 function event(source, key) {
   const subs = LISTENER.get(source);
+  const ready = !subs.has(onReady);
+  if (key === true && ready)
+    return;
   let pending = PENDING.get(source);
   if (pending) {
     pending.add(key);
     return;
   }
   PENDING.set(source, pending = new Set(
-    key !== true && subs.has(onReady) ? [true, key] : [key]
+    key !== true && ready ? [key] : [true, key]
   ));
   pending.forEach((key2) => {
     pending.delete(key2);
@@ -194,7 +196,7 @@ var Model = class _Model {
       for (const key in this) {
         const desc = Object.getOwnPropertyDescriptor(this, key);
         if ("value" in desc) {
-          state[key] = desc.value;
+          update(this, key, desc.value, true);
           define(this, key, {
             configurable: false,
             set: (x) => update(this, key, x),
@@ -204,6 +206,8 @@ var Model = class _Model {
           });
         }
       }
+      if (!PARENT.has(this))
+        PARENT.set(this, null);
       addListener(this, () => {
         if (!done)
           throw new Error(`Tried to destroy ${this} but not fully initialized.`);
@@ -266,11 +270,12 @@ var Model = class _Model {
       return event(this, null);
     if (typeof arg1 == "object")
       assign(self, arg1);
-    else if (arg1 !== void 0)
-      if (1 in arguments)
-        update(self, arg1, arg2, arg3);
-      else
-        push(self, arg1);
+    else if (arg1 == void 0)
+      event(this, true);
+    else if (1 in arguments)
+      update(self, arg1, arg2, arg3);
+    else
+      push(self, arg1);
     if (PENDING2.has(self))
       return {
         then: (res) => new Promise((res2) => {
@@ -364,6 +369,10 @@ function update(subject, key, value, silent) {
   const previous = state[key];
   if (value === previous)
     return true;
+  if (value instanceof Model && !PARENT.has(value)) {
+    PARENT.set(value, subject);
+    event(value, true);
+  }
   state[key] = value;
   if (silent !== true)
     push(subject, key);
@@ -420,26 +429,42 @@ function uid() {
   return (Math.random() * 0.722 + 0.278).toString(36).substring(2, 8).toUpperCase();
 }
 
-// src/instruction/add.ts
+// src/instruction/use.ts
 var INSTRUCT = /* @__PURE__ */ new Map();
-function add(instruction) {
+function use(model, argument) {
   const token = Symbol("instruction");
-  INSTRUCT.set(token, instruction);
+  if (Model.is(model)) {
+    const type = model;
+    const value = new model();
+    model = (key, subject) => {
+      function set2(next) {
+        if (next ? !(next instanceof type) : argument !== false)
+          throw new Error(`${subject}.${key} expected Model of type ${type} but got ${next && next.constructor}.`);
+        update(subject, key, next);
+        if (next && typeof argument == "function")
+          argument(next);
+        return false;
+      }
+      set2(value);
+      return { set: set2, value };
+    };
+  }
+  INSTRUCT.set(token, model);
   return token;
 }
 Model.on((_, subject) => {
   const state = STATE.get(subject);
-  Object.entries(
-    Object.getOwnPropertyDescriptors(subject)
-  ).forEach(([key, { value }]) => {
+  const props = Object.getOwnPropertyDescriptors(subject);
+  for (const key in props) {
+    const { value } = props[key];
     const instruction = INSTRUCT.get(value);
     if (!instruction)
-      return;
+      continue;
     INSTRUCT.delete(value);
     delete subject[key];
     const output = instruction.call(subject, key, subject, state);
     if (!output)
-      return;
+      continue;
     const desc = typeof output == "object" ? output : { get: output };
     const { enumerable = true } = desc;
     if ("value" in desc)
@@ -468,20 +493,21 @@ Model.on((_, subject) => {
         );
       }
     });
-  });
+  }
   return null;
 });
 
 // src/instruction/get.ts
+var STALE = /* @__PURE__ */ new WeakSet();
 function get(arg0, arg1) {
-  return add((key, subject) => {
+  return use((key, subject) => {
     let from = subject;
     if (typeof arg0 == "symbol")
       throw new Error(`Attempted to use an instruction result (probably use or get) as computed source for ${from}.${key}. This is not allowed.`);
     let source = (resolve) => resolve(from);
-    if (arg0 instanceof Model)
+    if (arg0 instanceof Model) {
       from = arg0;
-    else if (Model.is(arg0)) {
+    } else if (arg0.prototype instanceof Model) {
       const hasParent = PARENT.get(from);
       if (!hasParent) {
         if (arg1 === true)
@@ -498,63 +524,61 @@ function get(arg0, arg1) {
         from = hasParent;
       else
         throw new Error(`New ${from} created as child of ${hasParent}, but must be instanceof ${arg0}.`);
-    } else if (typeof arg0 == "function") {
+    } else {
       const fn = METHOD.get(arg0) || arg0;
       arg1 = (p, k) => fn.call(p, k, p);
     }
-    if (typeof arg1 == "function")
-      return compute(subject, key, source, arg1);
-    source((got) => subject.set(key, got));
-    return { get: arg1 };
-  });
-}
-var STALE = /* @__PURE__ */ new WeakSet();
-function compute(subject, key, source, setter) {
-  let reset;
-  let isAsync;
-  let proxy;
-  function connect(model) {
-    reset = effect(model, (current) => {
-      proxy = current;
-      if (!reset)
-        compute2(true);
-      else if (STALE.delete(compute2))
-        compute2();
-      return (didUpdate) => {
-        if (didUpdate) {
-          STALE.add(compute2);
-          push(subject, key, true);
+    if (typeof arg1 == "function") {
+      let connect2 = function(model) {
+        reset = effect(model, (current) => {
+          proxy = current;
+          if (!reset)
+            compute2(true);
+          else if (STALE.delete(compute2))
+            compute2();
+          return (didUpdate) => {
+            if (didUpdate) {
+              STALE.add(compute2);
+              push(subject, key, true);
+            }
+          };
+        });
+      }, compute2 = function(initial) {
+        let next;
+        try {
+          next = getter.call(proxy, proxy, key);
+        } catch (err) {
+          console.warn(`An exception was thrown while ${initial ? "initializing" : "refreshing"} ${subject}.${key}.`);
+          if (initial)
+            throw err;
+          console.error(err);
         }
+        update(subject, key, next, !isAsync);
       };
-    });
-  }
-  function compute2(initial) {
-    let next;
-    try {
-      next = setter.call(proxy, proxy, key);
-    } catch (err) {
-      console.warn(`An exception was thrown while ${initial ? "initializing" : "refreshing"} ${subject}.${key}.`);
-      if (initial)
-        throw err;
-      console.error(err);
-    }
-    update(subject, key, next, !isAsync);
-  }
-  return () => {
-    if (!proxy) {
-      source(connect);
-      isAsync = true;
-    }
-    if (STALE.delete(compute2))
-      compute2();
-    return fetch(subject, key, !proxy);
-  };
+      var connect = connect2, compute = compute2;
+      const getter = arg1;
+      let reset;
+      let isAsync;
+      let proxy;
+      return () => {
+        if (!proxy) {
+          source(connect2);
+          isAsync = true;
+        }
+        if (STALE.delete(compute2))
+          compute2();
+        return fetch(subject, key, !proxy);
+      };
+    } else
+      source((got) => subject.set(key, got));
+    return { get: arg1 };
+  });
 }
 
 // src/instruction/ref.ts
 var define2 = Object.defineProperty;
 function ref(arg, arg2) {
-  return add((key, subject, state) => {
+  return use((key, subject, state) => {
     let value = {};
     if (arg === subject)
       subject.get(() => {
@@ -604,7 +628,7 @@ function ref(arg, arg2) {
 
 // src/instruction/set.ts
 function set(value, argument) {
-  return add((key, subject) => {
+  return use((key, subject) => {
     const output = {};
     if (typeof value == "function" || value instanceof Promise) {
       let init2 = function() {
@@ -660,11 +684,11 @@ function set(value, argument) {
 function attempt(fn) {
   function retry(err) {
     if (err instanceof Promise)
-      return err.then(compute2);
+      return err.then(compute);
     else
       throw err;
   }
-  function compute2() {
+  function compute() {
     try {
       const output = fn();
       return output instanceof Promise ? output.catch(retry) : output;
@@ -672,27 +696,7 @@ function attempt(fn) {
       return retry(err);
     }
   }
-  return compute2();
-}
-
-// src/instruction/use.ts
-function use(value, argument) {
-  return add((property, subject) => {
-    if (typeof value === "function")
-      value = new value();
-    function set2(next) {
-      if (value instanceof Model && !(next instanceof value.constructor))
-        throw new Error(`${subject}.${property} expected Model of type ${value.constructor} but got ${next}.`);
-      if (next instanceof Model) {
-        PARENT.set(next, subject);
-        event(next, true);
-      }
-      if (typeof argument == "function")
-        argument(next);
-    }
-    set2(value);
-    return { set: set2, value };
-  });
+  return compute();
 }
 
 // src/context.ts
@@ -732,7 +736,7 @@ var Context = class {
       throw new Error(`Did find ${Type} in context, but multiple were defined.`);
     return result;
   }
-  include(inputs) {
+  include(inputs, forEach) {
     const init = /* @__PURE__ */ new Map();
     if (typeof inputs == "function" || inputs instanceof Model)
       inputs = { [0]: inputs };
@@ -752,10 +756,13 @@ var Context = class {
       } else if (exists !== input) {
         this.pop();
         this.id = uid();
-        return this.include(inputs);
+        this.include(inputs);
       }
     }
-    for (const [model] of init) {
+    for (const [model, explicit] of init) {
+      if (forEach)
+        forEach(model, explicit);
+      model.set();
       this.has(model);
       const expects = Expects.get(model);
       if (expects)
@@ -767,7 +774,6 @@ var Context = class {
           init.set(value, false);
         }
     }
-    return init;
   }
   put(T, I, implicit, writable) {
     do {
@@ -788,7 +794,7 @@ var Context = class {
     let I;
     if (typeof input == "function") {
       T = input;
-      I = input.new();
+      I = new input();
     } else {
       I = input;
       T = I.constructor;
@@ -823,7 +829,7 @@ function reject(argument) {
 
 // src/instruction/has.ts
 function has(type, argument) {
-  return add((key, subject, state) => {
+  return use((key, subject, state) => {
     if (typeof argument == "boolean") {
       Context.request(type, subject, (model) => {
         subject.set(key, model);
@@ -865,7 +871,6 @@ function has(type, argument) {
 0 && (module.exports = {
   Context,
   Model,
-  add,
   get,
   has,
   ref,

package/dist/index.mjs

@@ -32,13 +32,16 @@ function watch(from, key, value) {
 var PENDING = /* @__PURE__ */ new WeakMap();
 function event(source, key) {
   const subs = LISTENER.get(source);
+  const ready = !subs.has(onReady);
+  if (key === true && ready)
+    return;
   let pending = PENDING.get(source);
   if (pending) {
     pending.add(key);
     return;
   }
   PENDING.set(source, pending = new Set(
-    key !== true && subs.has(onReady) ? [true, key] : [key]
+    key !== true && ready ? [key] : [true, key]
   ));
   pending.forEach((key2) => {
     pending.delete(key2);
@@ -160,7 +163,7 @@ var Model = class _Model {
       for (const key in this) {
         const desc = Object.getOwnPropertyDescriptor(this, key);
         if ("value" in desc) {
-          state[key] = desc.value;
+          update(this, key, desc.value, true);
           define(this, key, {
             configurable: false,
             set: (x) => update(this, key, x),
@@ -170,6 +173,8 @@ var Model = class _Model {
           });
         }
       }
+      if (!PARENT.has(this))
+        PARENT.set(this, null);
       addListener(this, () => {
         if (!done)
           throw new Error(`Tried to destroy ${this} but not fully initialized.`);
@@ -232,11 +237,12 @@ var Model = class _Model {
       return event(this, null);
     if (typeof arg1 == "object")
       assign(self, arg1);
-    else if (arg1 !== void 0)
-      if (1 in arguments)
-        update(self, arg1, arg2, arg3);
-      else
-        push(self, arg1);
+    else if (arg1 == void 0)
+      event(this, true);
+    else if (1 in arguments)
+      update(self, arg1, arg2, arg3);
+    else
+      push(self, arg1);
     if (PENDING2.has(self))
       return {
         then: (res) => new Promise((res2) => {
@@ -330,6 +336,10 @@ function update(subject, key, value, silent) {
   const previous = state[key];
   if (value === previous)
     return true;
+  if (value instanceof Model && !PARENT.has(value)) {
+    PARENT.set(value, subject);
+    event(value, true);
+  }
   state[key] = value;
   if (silent !== true)
     push(subject, key);
@@ -386,26 +396,42 @@ function uid() {
   return (Math.random() * 0.722 + 0.278).toString(36).substring(2, 8).toUpperCase();
 }
 
-// src/instruction/add.ts
+// src/instruction/use.ts
 var INSTRUCT = /* @__PURE__ */ new Map();
-function add(instruction) {
+function use(model, argument) {
   const token = Symbol("instruction");
-  INSTRUCT.set(token, instruction);
+  if (Model.is(model)) {
+    const type = model;
+    const value = new model();
+    model = (key, subject) => {
+      function set2(next) {
+        if (next ? !(next instanceof type) : argument !== false)
+          throw new Error(`${subject}.${key} expected Model of type ${type} but got ${next && next.constructor}.`);
+        update(subject, key, next);
+        if (next && typeof argument == "function")
+          argument(next);
+        return false;
+      }
+      set2(value);
+      return { set: set2, value };
+    };
+  }
+  INSTRUCT.set(token, model);
   return token;
 }
 Model.on((_, subject) => {
   const state = STATE.get(subject);
-  Object.entries(
-    Object.getOwnPropertyDescriptors(subject)
-  ).forEach(([key, { value }]) => {
+  const props = Object.getOwnPropertyDescriptors(subject);
+  for (const key in props) {
+    const { value } = props[key];
     const instruction = INSTRUCT.get(value);
     if (!instruction)
-      return;
+      continue;
     INSTRUCT.delete(value);
     delete subject[key];
     const output = instruction.call(subject, key, subject, state);
     if (!output)
-      return;
+      continue;
     const desc = typeof output == "object" ? output : { get: output };
     const { enumerable = true } = desc;
     if ("value" in desc)
@@ -434,20 +460,21 @@ Model.on((_, subject) => {
         );
       }
     });
-  });
+  }
   return null;
 });
 
 // src/instruction/get.ts
+var STALE = /* @__PURE__ */ new WeakSet();
 function get(arg0, arg1) {
-  return add((key, subject) => {
+  return use((key, subject) => {
     let from = subject;
     if (typeof arg0 == "symbol")
       throw new Error(`Attempted to use an instruction result (probably use or get) as computed source for ${from}.${key}. This is not allowed.`);
     let source = (resolve) => resolve(from);
-    if (arg0 instanceof Model)
+    if (arg0 instanceof Model) {
       from = arg0;
-    else if (Model.is(arg0)) {
+    } else if (arg0.prototype instanceof Model) {
       const hasParent = PARENT.get(from);
       if (!hasParent) {
         if (arg1 === true)
@@ -464,63 +491,61 @@ function get(arg0, arg1) {
         from = hasParent;
       else
         throw new Error(`New ${from} created as child of ${hasParent}, but must be instanceof ${arg0}.`);
-    } else if (typeof arg0 == "function") {
+    } else {
       const fn = METHOD.get(arg0) || arg0;
       arg1 = (p, k) => fn.call(p, k, p);
     }
-    if (typeof arg1 == "function")
-      return compute(subject, key, source, arg1);
-    source((got) => subject.set(key, got));
-    return { get: arg1 };
-  });
-}
-var STALE = /* @__PURE__ */ new WeakSet();
-function compute(subject, key, source, setter) {
-  let reset;
-  let isAsync;
-  let proxy;
-  function connect(model) {
-    reset = effect(model, (current) => {
-      proxy = current;
-      if (!reset)
-        compute2(true);
-      else if (STALE.delete(compute2))
-        compute2();
-      return (didUpdate) => {
-        if (didUpdate) {
-          STALE.add(compute2);
-          push(subject, key, true);
+    if (typeof arg1 == "function") {
+      let connect2 = function(model) {
+        reset = effect(model, (current) => {
+          proxy = current;
+          if (!reset)
+            compute2(true);
+          else if (STALE.delete(compute2))
+            compute2();
+          return (didUpdate) => {
+            if (didUpdate) {
+              STALE.add(compute2);
+              push(subject, key, true);
+            }
+          };
+        });
+      }, compute2 = function(initial) {
+        let next;
+        try {
+          next = getter.call(proxy, proxy, key);
+        } catch (err) {
+          console.warn(`An exception was thrown while ${initial ? "initializing" : "refreshing"} ${subject}.${key}.`);
+          if (initial)
+            throw err;
+          console.error(err);
         }
+        update(subject, key, next, !isAsync);
       };
-    });
-  }
-  function compute2(initial) {
-    let next;
-    try {
-      next = setter.call(proxy, proxy, key);
-    } catch (err) {
-      console.warn(`An exception was thrown while ${initial ? "initializing" : "refreshing"} ${subject}.${key}.`);
-      if (initial)
-        throw err;
-      console.error(err);
-    }
-    update(subject, key, next, !isAsync);
-  }
-  return () => {
-    if (!proxy) {
-      source(connect);
-      isAsync = true;
-    }
-    if (STALE.delete(compute2))
-      compute2();
-    return fetch(subject, key, !proxy);
-  };
+      var connect = connect2, compute = compute2;
+      const getter = arg1;
+      let reset;
+      let isAsync;
+      let proxy;
+      return () => {
+        if (!proxy) {
+          source(connect2);
+          isAsync = true;
+        }
+        if (STALE.delete(compute2))
+          compute2();
+        return fetch(subject, key, !proxy);
+      };
+    } else
+      source((got) => subject.set(key, got));
+    return { get: arg1 };
+  });
 }
 
 // src/instruction/ref.ts
 var define2 = Object.defineProperty;
 function ref(arg, arg2) {
-  return add((key, subject, state) => {
+  return use((key, subject, state) => {
     let value = {};
     if (arg === subject)
       subject.get(() => {
@@ -570,7 +595,7 @@ function ref(arg, arg2) {
 
 // src/instruction/set.ts
 function set(value, argument) {
-  return add((key, subject) => {
+  return use((key, subject) => {
     const output = {};
     if (typeof value == "function" || value instanceof Promise) {
       let init2 = function() {
@@ -626,11 +651,11 @@ function set(value, argument) {
 function attempt(fn) {
   function retry(err) {
     if (err instanceof Promise)
-      return err.then(compute2);
+      return err.then(compute);
     else
       throw err;
   }
-  function compute2() {
+  function compute() {
     try {
       const output = fn();
       return output instanceof Promise ? output.catch(retry) : output;
@@ -638,27 +663,7 @@ function attempt(fn) {
       return retry(err);
     }
   }
-  return compute2();
-}
-
-// src/instruction/use.ts
-function use(value, argument) {
-  return add((property, subject) => {
-    if (typeof value === "function")
-      value = new value();
-    function set2(next) {
-      if (value instanceof Model && !(next instanceof value.constructor))
-        throw new Error(`${subject}.${property} expected Model of type ${value.constructor} but got ${next}.`);
-      if (next instanceof Model) {
-        PARENT.set(next, subject);
-        event(next, true);
-      }
-      if (typeof argument == "function")
-        argument(next);
-    }
-    set2(value);
-    return { set: set2, value };
-  });
+  return compute();
 }
 
 // src/context.ts
@@ -698,7 +703,7 @@ var Context = class {
       throw new Error(`Did find ${Type} in context, but multiple were defined.`);
     return result;
   }
-  include(inputs) {
+  include(inputs, forEach) {
     const init = /* @__PURE__ */ new Map();
     if (typeof inputs == "function" || inputs instanceof Model)
       inputs = { [0]: inputs };
@@ -718,10 +723,13 @@ var Context = class {
       } else if (exists !== input) {
         this.pop();
         this.id = uid();
-        return this.include(inputs);
+        this.include(inputs);
       }
     }
-    for (const [model] of init) {
+    for (const [model, explicit] of init) {
+      if (forEach)
+        forEach(model, explicit);
+      model.set();
       this.has(model);
       const expects = Expects.get(model);
       if (expects)
@@ -733,7 +741,6 @@ var Context = class {
           init.set(value, false);
         }
     }
-    return init;
   }
   put(T, I, implicit, writable) {
     do {
@@ -754,7 +761,7 @@ var Context = class {
     let I;
     if (typeof input == "function") {
       T = input;
-      I = input.new();
+      I = new input();
     } else {
       I = input;
       T = I.constructor;
@@ -789,7 +796,7 @@ function reject(argument) {
 
 // src/instruction/has.ts
 function has(type, argument) {
-  return add((key, subject, state) => {
+  return use((key, subject, state) => {
     if (typeof argument == "boolean") {
       Context.request(type, subject, (model) => {
         subject.set(key, model);
@@ -830,7 +837,6 @@ function has(type, argument) {
 export {
   Context,
   Model,
-  add,
   Model as default,
   get,
   has,

package/package.json

@@ -28,6 +28,6 @@
     "prebuild": "rm -rf dist",
     "preversion": "npm run test && npm run build"
   },
-  "version": "0.45.0",
-  "gitHead": "011596452831f785cc685c9124adff02176b489f"
+  "version": "0.47.0",
+  "gitHead": "7c0ddd5ea9b7e08bd5aa21aa8e1ab65ceef17fcf"
 }