@expressive/mvc 0.52.0 → 0.52.2-alpha.74

package/dist/index.d.ts

@@ -5,16 +5,16 @@ declare namespace Model {
     type Init<T extends Model = Model> = (new (...args: Model.Args<T>) => T) & Omit<typeof Model, never>;
     /**
      * Model constructor callback - is called when Model finishes intializing.
-     * Returned function will call when model is destroyed.
+     * Returned function will run when model is destroyed.
      */
     type Callback<T extends Model = Model> = (this: T, thisArg: T) => Promise<void> | (() => void) | Assign<T> | void;
     /** Model constructor argument */
     type Argument<T extends Model = Model> = Assign<T> | Callback<T> | string | void;
     /** Model constructor arguments */
-    type Args<T extends Model = any> = Argument<T>[];
+    type Args<T extends Model = any> = (Argument<T> | Args<T>)[];
     /** Subset of `keyof T` which are not methods or defined by base Model U. **/
     type Field<T> = Exclude<keyof T, keyof Model>;
-    /** Any valid key for controller, including but not limited to Field<T>. */
+    /** Any valid key for model, including but not limited to Field<T>. */
     type Event<T> = Field<T> | (string & {}) | number | symbol;
     /** Object overlay to override values and methods on a model. */
     type Assign<T> = {
@@ -24,12 +24,12 @@ declare namespace Model {
     type Export<R> = R extends {
         get(): infer T;
     } ? T : R;
-    /** Value for a property managed by a controller. */
+    /** Value for a property managed by a model. */
     type Value<T extends Model, K extends Event<T>> = K extends keyof T ? Export<T[K]> : unknown;
     type OnEvent<T extends Model> = (this: T, key: unknown, source: T) => (() => void) | void | null;
     type OnUpdate<T extends Model, K extends Event<T>> = (this: T, value: Value<T, K>, key: K, thisArg: K) => void;
     /**
-     * Values from current state of given controller.
+     * Values from current state of given model.
      * Differs from `Values` as values here will drill
      * into "real" values held by exotics like ref.Object.
      */
@@ -48,7 +48,7 @@ declare namespace Model {
     /**
      * A callback function which is subscribed to parent and updates when accessed properties change.
      *
-     * @param current - Current state of this controller. This is a proxy which detects properties which
+     * @param current - Current state of this model. This is a proxy which detects properties which
      * where accessed, and thus depended upon to stay current.
      *
      * @param update - Set of properties which have changed, and events fired, since last update.
@@ -59,7 +59,7 @@ declare namespace Model {
     /**
      * A callback function returned by effect. Will be called when effect is stale.
      *
-     * @param update - `true` if update is pending, `false` effect has been cancelled, `null` if controller is destroyed.
+     * @param update - `true` if update is pending, `false` effect has been cancelled, `null` if model is destroyed.
      */
     type EffectCallback = ((update: boolean | null) => void);
     /**
@@ -88,7 +88,7 @@ declare abstract class Model {
     /**
      * Pull current values from state. Flattens all models and exotic values recursively.
      *
-     * @returns Object with all values from this controller.
+     * @returns Object with all values from this model.
      **/
     get(): Model.State<this>;
     /**
@@ -96,7 +96,7 @@ declare abstract class Model {
      *
      * @param effect Function to run, and again whenever accessed values change.
      *               If effect returns a function, it will be called when a change occurs (syncronously),
-     *               effect is cancelled, or parent controller is destroyed.
+     *               effect is cancelled, or parent model is destroyed.
      * @returns Function to cancel listener.
      */
     get(effect: Model.Effect<this>): () => void;
@@ -133,29 +133,17 @@ declare abstract class Model {
     /**
      * Get update in progress.
      *
-     * @returns Promise which resolves object with updated values. Is `undefined` if there is no update.
+     * @returns Promise which resolves object with updated values, `undefined` if there no update is pending.
      **/
     set(): PromiseLike<Model.Event<this>[]> | undefined;
     /**
-     * Call a function when update occurs.
-     *
-     * Given function is called for every assignment (which changes value) or explicit `set`.
-     *
-     * To run logic on final value only, callback may return a function. Using the same
-     * function for one or more events will ensure it is called only when events are settled.
-     *
-     * @param callback - Function to call when update occurs.
-     * @returns Function to remove listener. Will return `true` if removed, `false` if inactive already.
-     *
-    */
-    set(callback: Model.OnEvent<this>): () => boolean;
-    /**
-     * Declare an end to updates. This event is final and will freeze state.
-     * This event can be watched for as well, to run cleanup logic and internally will remove all listeners.
+     * Update mulitple properties at once. Merges argument with current state.
+     * Properties which are not managed by this model will be ignored.
      *
-     * @param status - `null` to end updates.
+     * @param assign - Object with properties to update.
+     * @returns Promise resolving an array of keys updated, `undefined` (immediately) if a noop.
      */
-    set(status: null): void;
+    set(assign: Model.Assign<this>): PromiseLike<Model.Event<this>[]> | undefined;
     /**
      * Push an update. This will not change the value of associated property.
      *
@@ -168,32 +156,45 @@ declare abstract class Model {
      * to prefix an event with "!" and/or use dash-case. e.g. `set("!event")` or `set("my-event")`.
      *
      * @param key - Property or event to dispatch.
-     * @returns Promise which resolves an array of keys which were updated.
+     * @returns Promise resolves an array of keys updated.
      */
     set(key: Model.Event<this>): PromiseLike<Model.Event<this>[]>;
-    /**
-     * Update mulitple properties at once. Merges argument with current state.
-     * Properties which are not managed by this controller will be ignored.
-     *
-     * @param assign - Object with properties to update.
-     * @returns Promise which resolves an array of keys which were updated.
-     */
-    set(assign: Model.Assign<this>): PromiseLike<Model.Event<this>[]> | undefined;
     /**
      * Update a property with value.
      *
      * @param key - property to update
      * @param value - value to update property with (if the same as current, no update will occur)
      * @param silent - if true, will not notify listeners of an update
+     * @returns Promise resolving an array of keys updated, `undefined` (immediately) if a noop.
+     */
+    set<K extends string>(key: K, value: Model.Value<this, K>, silent?: boolean): PromiseLike<Model.Event<this>[]> | undefined;
+    /**
+     * Call a function when update occurs.
+     *
+     * Given function is called for every assignment (which changes value) or explicit `set`.
+     *
+     * To run logic on final value only, callback may return a function. Using the same
+     * function for one or more events will ensure it is called only when events are settled.
+     *
+     * @param callback - Function to call when update occurs.
+     * @returns Function to remove listener. Will return `true` if removed, `false` if inactive already.
+     *
+    */
+    set(callback: Model.OnEvent<this>): () => boolean;
+    /**
+     * Declare an end to updates. This event is final and will freeze state.
+     * This event can be watched for as well, to run cleanup logic and internally will remove all listeners.
+     *
+     * @param status - `null` to end updates.
      */
-    set<K extends string>(key: K, value?: Model.Value<this, K>, silent?: boolean): PromiseLike<Model.Event<this>[]> | undefined;
+    set(status: null): void;
     /**
      * Iterate over managed properties in this instance of Model.
      * Yeilds the key and underlying value for each property.
      */
     [Symbol.iterator](): Iterator<[string, unknown]>;
     /**
-     * Create and activate a new instance of this controller.
+     * Create and activate a new instance of this model.
      *
      * **Important** - Unlike `new this(...)` - this method also activates state.
      *
@@ -325,10 +326,10 @@ declare namespace set {
     type Factory<T, S = any> = (this: S, key: string) => Promise<T> | T;
 }
 /**
- * Set property with a placeholder.
+ * Set property as `undefined` but required.
  *
  * Property cannot be accessed until it is defined. If accessed while undefined, a hybrid
- * `Promise`/`Error` (ala: [Suspense](https://reactjs.org/docs/concurrent-mode-suspense.html)) will be thrown.
+ * `Promise`/`Error` (aka: [Suspense](https://reactjs.org/docs/concurrent-mode-suspense.html)) will be thrown.
  */
 declare function set<T = any>(): T;
 /**
@@ -366,6 +367,21 @@ declare namespace has {
 declare function has<T extends Model>(type: Model.Type<T>, callback?: has.Callback<T>): readonly T[];
 declare function has(callback?: has.Callback): readonly Model[];
 
+/**
+ * Update callback function.
+ *
+ * @param key -
+ *   - `string` - property which has updated.
+ *   - `false` - a normal update has completed.
+ *   - `true` - initial event; instance is ready.
+ *   - `null` - terminal event; instance is expired.
+ * @param source - Instance of Model for which update has occured.
+ */
+type OnUpdate<T = any> = (this: T, key: unknown, source: T) => (() => void) | null | void;
+type OnAccess<T, R = unknown> = (from: T, key: string | number, value: R) => unknown;
+type Event = number | string | null | boolean | symbol;
+declare function addListener(subject: {}, callback: OnUpdate, select?: Event): () => boolean;
+declare function createProxy<T extends {}>(from: T, observer: OnAccess<T>): any;
 type Effect<T extends {}> = (this: T, argument: T) => ((update: boolean | null) => void) | Promise<void> | null | void;
 /**
  * Create a side-effect which will update whenever values accessed change.
@@ -375,11 +391,15 @@ type Effect<T extends {}> = (this: T, argument: T) => ((update: boolean | null)
  * @param callback - Function to invoke when values change.
  * @param requireValues - If `true` will throw if accessing a value which is `undefined`.
  */
-declare function effect<T extends {}>(target: T, callback: Effect<Required<T>>, requireValues: true): () => void;
-declare function effect<T extends {}>(target: T, callback: Effect<T>, requireValues?: boolean): () => void;
+declare function createEffect<T extends {}>(target: T, callback: Effect<Required<T>>, requireValues: true): () => void;
+declare function createEffect<T extends {}>(target: T, callback: Effect<T>, requireValues?: boolean): () => void;
 
 declare namespace Context {
-    type Input = Record<string | number, Model | Model.Init>;
+    type Multiple<T extends Model> = {
+        [key: string | number]: Model.Init<T> | T;
+    };
+    type Accept<T extends Model = Model> = T | Model.Init<T> | Multiple<T>;
+    type ForEach = (added: Model, explicit: boolean) => void;
     type Expect = (model: Model) => (() => void) | void;
 }
 interface Context {
@@ -391,30 +411,15 @@ declare class Context {
     id: string;
     protected layer: Map<string | number, Model | Model.Type<Model>>;
     protected cleanup: Set<() => void>;
-    constructor(inputs?: Context.Input);
+    constructor(inputs?: Context.Accept);
+    /** Run callback when a specified type is registered to a **child** context. */
+    has<T extends Model>(Type: Model.Type<T>, callback: (model: T) => void): void;
+    /** Find specified type registered to a parent context. Returns undefined if none are found. */
     get<T extends Model>(Type: Model.Type<T>): T | undefined;
-    get<T extends Model>(Type: Model.Type<T>, callback: (model: T) => void): void;
-    push(inputs?: Context.Input): this;
+    push(inputs?: Context.Accept): this;
     pop(): void;
-    include(inputs: Context.Input, forEach?: (added: Model, explicit: boolean) => void): void;
+    include<T extends Model>(inputs: Context.Accept<T>, forEach?: Context.ForEach | Model.Assign<T>): void;
     protected add<T extends Model>(input: T | Model.Init<T>, implicit?: boolean): T;
 }
 
-declare global {
-    /**
-     * Defines MVC specific matchers for [Jest](https://jestjs.io/) test suites.
-     *
-     * For these to work you will need to add `@expressive/mvc/jest`
-     * under `setupFilesAfterEnv` in your Jest configuration.
-     */
-    namespace jest {
-        interface Matchers<R> {
-            /** Assert model does have one or more updates pending. */
-            toUpdate(timeout?: number): Promise<R>;
-            /** Assert model did update with keys specified. */
-            toHaveUpdated<R>(...keys: (string | symbol | number)[]): Promise<R>;
-        }
-    }
-}
-
-export { Context, Model, Model as default, effect, get, has, ref, set, use };
+export { Context, Model, addListener, createEffect, createProxy, Model as default, get, has, ref, set, use };

package/dist/index.js

@@ -22,8 +22,10 @@ var src_exports = {};
 __export(src_exports, {
   Context: () => Context,
   Model: () => Model,
+  addListener: () => addListener,
+  createEffect: () => createEffect,
+  createProxy: () => createProxy,
   default: () => Model,
-  effect: () => effect,
   get: () => get,
   has: () => has,
   ref: () => ref,
@@ -35,25 +37,30 @@ module.exports = __toCommonJS(src_exports);
 // src/control.ts
 var DISPATCH = /* @__PURE__ */ new Set();
 var OBSERVER = /* @__PURE__ */ new WeakMap();
-var LISTENER = /* @__PURE__ */ new WeakMap();
+var LISTENERS = /* @__PURE__ */ new WeakMap();
+var PENDING = /* @__PURE__ */ new WeakMap();
 var onReady = () => null;
 function addListener(subject, callback, select) {
-  let subs = LISTENER.get(subject);
+  let subs = LISTENERS.get(subject);
   if (!subs)
-    LISTENER.set(subject, subs = /* @__PURE__ */ new Map([[onReady, false]]));
-  const filter = select !== void 0 && /* @__PURE__ */ new Set([select]);
-  if (!filter && !subs.has(onReady))
+    LISTENERS.set(subject, subs = /* @__PURE__ */ new Map([[onReady, void 0]]));
+  const filter = select === void 0 ? void 0 : /* @__PURE__ */ new Set([select]);
+  if (!subs.has(onReady) && !filter)
     callback(true, subject);
   subs.set(callback, filter);
   return () => subs.delete(callback);
 }
+function createProxy(from, observer) {
+  const proxy = Object.create(from);
+  OBSERVER.set(proxy, observer);
+  return proxy;
+}
 function watch(from, key2, value) {
   const access = OBSERVER.get(from);
   return access ? access(from, key2, value) : value;
 }
-var PENDING = /* @__PURE__ */ new WeakMap();
 function emit(source, key2) {
-  const subs = LISTENER.get(source);
+  const subs = LISTENERS.get(source);
   const ready = !subs.has(onReady);
   if (key2 === true && ready)
     return;
@@ -79,27 +86,28 @@ function emit(source, key2) {
   });
   PENDING.delete(source);
 }
-function queue(event2) {
+function queue(eventHandler) {
   if (!DISPATCH.size)
     setTimeout(() => {
-      DISPATCH.forEach((event3) => {
+      DISPATCH.forEach((event2) => {
         try {
-          event3();
+          event2();
         } catch (err) {
           console.error(err);
         }
       });
       DISPATCH.clear();
     }, 0);
-  DISPATCH.add(event2);
+  DISPATCH.add(eventHandler);
 }
-function effect(target, callback, requireValues) {
-  const listeners = LISTENER.get(target);
+function createEffect(target, callback, requireValues) {
+  const listeners = LISTENERS.get(target);
   let unset;
   let reset;
   function invoke() {
     let stale;
-    const subscriber = Object.create(target);
+    const subscriber = createProxy(target, access);
+    LISTENERS.set(subscriber, listeners);
     function onUpdate() {
       if (stale)
         return null;
@@ -113,20 +121,19 @@ function effect(target, callback, requireValues) {
     function access(from, key2, value) {
       if (value === void 0 && requireValues)
         throw new Error(`${from}.${key2} is required in this context.`);
-      const listeners2 = LISTENER.get(from);
+      const listeners2 = LISTENERS.get(from);
       let listener = listeners2.get(onUpdate);
       if (!listener)
         listeners2.set(onUpdate, listener = /* @__PURE__ */ new Set());
       listener.add(key2);
-      const nested = LISTENER.get(value);
-      if (nested) {
-        LISTENER.set(value = Object.create(value), nested);
-        OBSERVER.set(value, access);
-      }
+      const nested = LISTENERS.get(value);
+      if (nested)
+        LISTENERS.set(
+          value = createProxy(value, access),
+          nested
+        );
       return value;
     }
-    LISTENER.set(subscriber, listeners);
-    OBSERVER.set(subscriber, access);
     try {
       const out = callback.call(subscriber, subscriber);
       unset = typeof out == "function" ? out : void 0;
@@ -163,27 +170,24 @@ var PENDING2 = /* @__PURE__ */ new WeakMap();
 var PARENT = /* @__PURE__ */ new WeakMap();
 var METHODS = /* @__PURE__ */ new WeakMap();
 var METHOD = /* @__PURE__ */ new WeakMap();
-var EXPORT;
-var Model = class _Model {
+var Model = class {
   constructor(...args) {
-    ID.set(this, `${this.constructor}-${uid()}`);
-    STATE.set(this, {});
     prepare(this);
     define(this, "is", { value: this });
-    apply(this, [...args, init]);
+    init(this, args);
   }
   get(arg1, arg2) {
     const self = this.is;
     if (arg1 === void 0)
-      return values(self);
+      return snapshot(self);
     if (typeof arg1 == "function") {
       let pending = /* @__PURE__ */ new Set();
-      return effect(self, (state) => {
+      return createEffect(self, (state) => {
         const cb = arg1.call(state, state, pending);
         return cb === null ? cb : (update2) => {
           pending = PENDING2.get(self);
           if (typeof cb == "function")
-            return cb(update2);
+            cb(update2);
         };
       });
     }
@@ -238,14 +242,13 @@ var Model = class _Model {
     return Object.entries(STATE.get(this.is))[Symbol.iterator]();
   }
   /**
-   * Create and activate a new instance of this controller.
+   * Create and activate a new instance of this model.
    * 
    * **Important** - Unlike `new this(...)` - this method also activates state.
    * 
    * @param args - arguments sent to constructor
    */
   static new(...args) {
-    _Model.is(this);
     const instance = new this(...args);
     emit(instance, true);
     return instance;
@@ -257,9 +260,7 @@ var Model = class _Model {
    * methods and properties of this class.
    */
   static is(maybe) {
-    if (maybe === _Model)
-      throw new Error("Model is abstract and not a valid type.");
-    return typeof maybe == "function" && maybe.prototype instanceof this;
+    return maybe === this || typeof maybe == "function" && maybe.prototype instanceof this;
   }
   /**
    * Register a callback to run when any instance of this Model is updated. 
@@ -283,50 +284,59 @@ define(Model, "toString", {
   }
 });
 function prepare(model) {
+  let T = model.constructor;
+  if (T === Model)
+    throw new Error("Cannot create base Model.");
   const chain = [];
-  let type = model.constructor;
   let keys2 = /* @__PURE__ */ new Set();
-  while (type.name) {
-    chain.unshift(type);
-    type = Object.getPrototypeOf(type);
-  }
-  for (const type2 of chain) {
-    for (const cb of NOTIFY.get(type2) || [])
+  ID.set(model, `${T}-${uid()}`);
+  while (T.name) {
+    for (const cb of NOTIFY.get(T) || [])
       addListener(model, cb);
-    if (type2 == Model)
-      continue;
-    if (METHODS.has(type2)) {
-      keys2 = METHODS.get(type2);
+    if (T === Model)
+      break;
+    else
+      chain.unshift(T);
+    T = Object.getPrototypeOf(T);
+  }
+  for (const type of chain) {
+    if (METHODS.has(type)) {
+      keys2 = METHODS.get(type);
       continue;
     }
-    METHODS.set(type2, keys2 = new Set(keys2));
-    for (const { key: key2, value } of entries(type2.prototype)) {
-      let set3 = function(method) {
+    METHODS.set(type, keys2 = new Set(keys2));
+    for (const [key2, { value }] of Object.entries(
+      Object.getOwnPropertyDescriptors(type.prototype)
+    )) {
+      let get3 = function() {
+        return this.hasOwnProperty(key2) ? value : set3.call(this, value);
+      }, set3 = function(method) {
         const value2 = method.bind(this.is);
         METHOD.set(value2, method);
         define(this.is, key2, { value: value2, writable: true });
         return value2;
       };
-      var set2 = set3;
+      var get2 = get3, set2 = set3;
       if (!value || key2 == "constructor")
         continue;
       keys2.add(key2);
-      Object.defineProperty(type2.prototype, key2, {
-        set: set3,
-        get() {
-          return this.hasOwnProperty(key2) ? value : set3.call(this, value);
-        }
-      });
+      define(type.prototype, key2, { get: get3, set: set3 });
     }
   }
 }
-function apply(model, args) {
-  for (const arg of args)
-    if (typeof arg == "string")
-      ID.set(model, arg);
+function init(model, args) {
+  const state = {};
+  const clean = /* @__PURE__ */ new Set();
+  STATE.set(model, state);
+  args = args.flat().filter((arg) => {
+    if (typeof arg != "string")
+      return true;
+    ID.set(model, arg);
+  });
   addListener(model, () => {
-    const done = /* @__PURE__ */ new Set();
-    for (const arg of args) {
+    if (!PARENT.has(model))
+      PARENT.set(model, null);
+    args.forEach((arg) => {
       const use2 = typeof arg == "function" ? arg.call(model, model) : arg;
       if (use2 instanceof Promise)
         use2.catch((err) => {
@@ -336,37 +346,30 @@ function apply(model, args) {
       else if (typeof use2 == "object")
         assign(model, use2);
       else if (typeof use2 == "function")
-        done.add(use2);
+        clean.add(use2);
+    });
+    for (const key2 in model) {
+      const desc = Object.getOwnPropertyDescriptor(model, key2);
+      if ("value" in desc) {
+        update(model, key2, desc.value, true);
+        define(model, key2, {
+          configurable: false,
+          set: (x) => update(model, key2, x),
+          get() {
+            return watch(this, key2, state[key2]);
+          }
+        });
+      }
     }
-    addListener(model, () => {
-      done.forEach((x) => x());
-    }, null);
     return null;
   });
-}
-function init(model) {
-  const state = STATE.get(model);
-  if (!PARENT.has(model))
-    PARENT.set(model, null);
-  for (const key2 in model) {
-    const desc = Object.getOwnPropertyDescriptor(model, key2);
-    if ("value" in desc) {
-      update(model, key2, desc.value, true);
-      define(model, key2, {
-        configurable: false,
-        set: (x) => update(model, key2, x),
-        get() {
-          return watch(this, key2, state[key2]);
-        }
-      });
-    }
-  }
-  return () => {
+  addListener(model, () => {
+    clean.forEach((x) => x());
     for (const [_, value] of model)
       if (value instanceof Model && PARENT.get(value) === model)
         value.set(null);
     Object.freeze(state);
-  };
+  }, null);
 }
 function fetch(subject, property, required) {
   const state = STATE.get(subject);
@@ -393,6 +396,25 @@ function fetch(subject, property, required) {
     stack: error.stack
   });
 }
+var EXPORT;
+function snapshot(model) {
+  const values = {};
+  let isNotRecursive;
+  if (!EXPORT) {
+    isNotRecursive = true;
+    EXPORT = /* @__PURE__ */ new Map([[model, values]]);
+  }
+  for (let [key2, value] of model) {
+    if (EXPORT.has(value))
+      value = EXPORT.get(value);
+    else if (value && typeof value == "object" && "get" in value && typeof value.get === "function")
+      EXPORT.set(value, value = value.get());
+    values[key2] = value;
+  }
+  if (isNotRecursive)
+    EXPORT = void 0;
+  return Object.freeze(values);
+}
 function update(subject, key2, value, arg) {
   const state = STATE.get(subject);
   if (Object.isFrozen(state))
@@ -429,42 +451,23 @@ function event(subject, key2, silent) {
   if (!silent)
     emit(subject, key2);
 }
-function assign(to, values2) {
+function assign(to, values) {
   const methods = METHODS.get(to.constructor);
-  for (const key2 in values2)
+  for (const key2 in values)
     if (key2 in to || methods.has(key2))
-      to[key2] = values2[key2];
-}
-function values(model) {
-  const values2 = {};
-  const current = !EXPORT && (EXPORT = /* @__PURE__ */ new Map([[model, values2]]));
-  for (let [key2, value] of model) {
-    if (EXPORT.has(value))
-      value = EXPORT.get(value);
-    else if (value && typeof value.get === "function")
-      EXPORT.set(value, value = value.get());
-    values2[key2] = value;
-  }
-  if (current)
-    EXPORT = void 0;
-  return Object.freeze(values2);
+      to[key2] = values[key2];
 }
 function uid() {
   return (Math.random() * 0.722 + 0.278).toString(36).substring(2, 8).toUpperCase();
 }
-function entries(object) {
-  return Object.entries(
-    Object.getOwnPropertyDescriptors(object)
-  ).map(([key2, desc]) => ({ key: key2, ...desc }));
-}
 
 // src/context.ts
-var Register = /* @__PURE__ */ new WeakMap();
-var Table = /* @__PURE__ */ new Map();
+var LOOKUP = /* @__PURE__ */ new WeakMap();
+var KEYS = /* @__PURE__ */ new Map();
 function key(T, upstream) {
-  let K = Table.get(T);
+  let K = KEYS.get(T);
   if (!K)
-    Table.set(T, K = Symbol(
+    KEYS.set(T, K = Symbol(
       typeof T == "symbol" ? "get " + T.description : String(T)
     ));
   return upstream ? key(K) : K;
@@ -484,7 +487,7 @@ var Context = class _Context {
       this.include(inputs);
   }
   static get(from, callback) {
-    const waiting = Register.get(from);
+    const waiting = LOOKUP.get(from);
     if (waiting instanceof _Context) {
       if (callback)
         callback(waiting);
@@ -494,11 +497,14 @@ var Context = class _Context {
       if (waiting)
         waiting.push(callback);
       else
-        Register.set(from, [callback]);
+        LOOKUP.set(from, [callback]);
   }
-  get(Type, callback) {
-    if (callback)
-      Object.defineProperty(this, key(Type, true), { value: callback });
+  /** Run callback when a specified type is registered to a **child** context. */
+  has(Type, callback) {
+    define(this, key(Type, true), { value: callback });
+  }
+  /** Find specified type registered to a parent context. Returns undefined if none are found. */
+  get(Type) {
     const result = this[key(Type)];
     if (result === null)
       throw new Error(`Did find ${Type} in context, but multiple were defined.`);
@@ -520,9 +526,16 @@ var Context = class _Context {
   }
   include(inputs, forEach) {
     const init2 = /* @__PURE__ */ new Map();
+    if (typeof inputs == "function" || inputs instanceof Model)
+      inputs = { 0: inputs };
     Object.entries(inputs).forEach(([K, V]) => {
-      if (!(Model.is(V) || V instanceof Model))
-        throw new Error(`Context can only include Model or instance but got ${V}${K && " as " + K}.`);
+      if (Model.is(V) || V instanceof Model)
+        return;
+      if (K && K != V)
+        V = `${V} (as '${K}')`;
+      throw new Error(
+        `Context may only include instance or class \`extends Model\` but got ${V}.`
+      );
     });
     for (const key2 in inputs) {
       const input = inputs[key2];
@@ -538,9 +551,11 @@ var Context = class _Context {
       }
     }
     for (const [model, explicit] of init2) {
-      model.set();
-      if (forEach)
+      emit(model, true);
+      if (typeof forEach == "function")
         forEach(model, explicit);
+      else if (forEach && explicit)
+        assign(model, forEach);
       for (const [_key, value] of model)
         if (PARENT.get(value) === model) {
           this.add(value, true);
@@ -571,15 +586,15 @@ var Context = class _Context {
     keys(T).forEach((K) => {
       const value = this.hasOwnProperty(K) ? null : I;
       if (value || this[K] !== I && !implicit)
-        Object.defineProperty(this, K, {
+        define(this, K, {
           configurable: true,
           value
         });
     });
-    const waiting = Register.get(I);
+    const waiting = LOOKUP.get(I);
     if (waiting instanceof Array)
       waiting.forEach((cb) => cb(this));
-    Register.set(I, this);
+    LOOKUP.set(I, this);
     return I;
   }
 };
@@ -611,7 +626,8 @@ function use(arg1, arg2) {
 }
 Model.on((_, model) => {
   const state = STATE.get(model);
-  for (const { key: key2, value } of entries(model)) {
+  for (const key2 in model) {
+    const { value } = Object.getOwnPropertyDescriptor(model, key2);
     const instruction = INSTRUCT.get(value);
     if (!instruction) {
       if (value instanceof Model && key2 !== "is")
@@ -626,7 +642,7 @@ Model.on((_, model) => {
     const desc = typeof output == "object" ? output : { get: output };
     if ("value" in desc)
       state[key2] = desc.value;
-    Object.defineProperty(model, key2, {
+    define(model, key2, {
       enumerable: desc.enumerable !== false,
       get() {
         return watch(
@@ -679,7 +695,7 @@ function get(arg0, arg1) {
     }
     if (typeof arg1 == "function") {
       let connect2 = function(model) {
-        reset = effect(model, (current) => {
+        reset = createEffect(model, (current) => {
           proxy = current;
           if (!(key2 in state) || STALE.delete(compute2))
             compute2(!reset);
@@ -723,7 +739,6 @@ function get(arg0, arg1) {
 }
 
 // src/instruction/ref.ts
-var define2 = Object.defineProperty;
 function ref(arg, arg2) {
   return use((key2, subject, state) => {
     let value = {};
@@ -731,20 +746,20 @@ function ref(arg, arg2) {
       subject.get(() => {
         for (const key3 in state)
           if (typeof arg2 == "function")
-            define2(value, key3, {
+            define(value, key3, {
               configurable: true,
               get() {
                 const out = arg2(key3);
-                define2(value, key3, { value: out });
+                define(value, key3, { value: out });
                 return out;
               }
             });
           else {
             const get2 = () => state[key3];
             const set2 = (value2) => subject.set(key3, value2);
-            define2(set2, "current", { get: get2, set: set2 });
-            define2(set2, "get", { value: get2 });
-            define2(value, key3, { value: set2 });
+            define(set2, "current", { get: get2, set: set2 });
+            define(set2, "get", { value: get2 });
+            define(value, key3, { value: set2 });
           }
       });
     else if (typeof arg == "object")
@@ -769,7 +784,7 @@ function ref(arg, arg2) {
         get: { value: get2 }
       });
     }
-    define2(subject, key2, { value });
+    define(subject, key2, { value });
   });
 }
 
@@ -856,7 +871,7 @@ function has(arg1, arg2) {
     };
     if (Model.is(arg1))
       Context.get(subject, (context) => {
-        context.get(arg1, (got) => {
+        context.has(arg1, (got) => {
           let remove;
           let disconnect;
           if (applied.has(got))
@@ -920,7 +935,9 @@ function has(arg1, arg2) {
 0 && (module.exports = {
   Context,
   Model,
-  effect,
+  addListener,
+  createEffect,
+  createProxy,
   get,
   has,
   ref,

package/dist/index.mjs

@@ -1,25 +1,30 @@
 // src/control.ts
 var DISPATCH = /* @__PURE__ */ new Set();
 var OBSERVER = /* @__PURE__ */ new WeakMap();
-var LISTENER = /* @__PURE__ */ new WeakMap();
+var LISTENERS = /* @__PURE__ */ new WeakMap();
+var PENDING = /* @__PURE__ */ new WeakMap();
 var onReady = () => null;
 function addListener(subject, callback, select) {
-  let subs = LISTENER.get(subject);
+  let subs = LISTENERS.get(subject);
   if (!subs)
-    LISTENER.set(subject, subs = /* @__PURE__ */ new Map([[onReady, false]]));
-  const filter = select !== void 0 && /* @__PURE__ */ new Set([select]);
-  if (!filter && !subs.has(onReady))
+    LISTENERS.set(subject, subs = /* @__PURE__ */ new Map([[onReady, void 0]]));
+  const filter = select === void 0 ? void 0 : /* @__PURE__ */ new Set([select]);
+  if (!subs.has(onReady) && !filter)
     callback(true, subject);
   subs.set(callback, filter);
   return () => subs.delete(callback);
 }
+function createProxy(from, observer) {
+  const proxy = Object.create(from);
+  OBSERVER.set(proxy, observer);
+  return proxy;
+}
 function watch(from, key2, value) {
   const access = OBSERVER.get(from);
   return access ? access(from, key2, value) : value;
 }
-var PENDING = /* @__PURE__ */ new WeakMap();
 function emit(source, key2) {
-  const subs = LISTENER.get(source);
+  const subs = LISTENERS.get(source);
   const ready = !subs.has(onReady);
   if (key2 === true && ready)
     return;
@@ -45,27 +50,28 @@ function emit(source, key2) {
   });
   PENDING.delete(source);
 }
-function queue(event2) {
+function queue(eventHandler) {
   if (!DISPATCH.size)
     setTimeout(() => {
-      DISPATCH.forEach((event3) => {
+      DISPATCH.forEach((event2) => {
         try {
-          event3();
+          event2();
         } catch (err) {
           console.error(err);
         }
       });
       DISPATCH.clear();
     }, 0);
-  DISPATCH.add(event2);
+  DISPATCH.add(eventHandler);
 }
-function effect(target, callback, requireValues) {
-  const listeners = LISTENER.get(target);
+function createEffect(target, callback, requireValues) {
+  const listeners = LISTENERS.get(target);
   let unset;
   let reset;
   function invoke() {
     let stale;
-    const subscriber = Object.create(target);
+    const subscriber = createProxy(target, access);
+    LISTENERS.set(subscriber, listeners);
     function onUpdate() {
       if (stale)
         return null;
@@ -79,20 +85,19 @@ function effect(target, callback, requireValues) {
     function access(from, key2, value) {
       if (value === void 0 && requireValues)
         throw new Error(`${from}.${key2} is required in this context.`);
-      const listeners2 = LISTENER.get(from);
+      const listeners2 = LISTENERS.get(from);
       let listener = listeners2.get(onUpdate);
       if (!listener)
         listeners2.set(onUpdate, listener = /* @__PURE__ */ new Set());
       listener.add(key2);
-      const nested = LISTENER.get(value);
-      if (nested) {
-        LISTENER.set(value = Object.create(value), nested);
-        OBSERVER.set(value, access);
-      }
+      const nested = LISTENERS.get(value);
+      if (nested)
+        LISTENERS.set(
+          value = createProxy(value, access),
+          nested
+        );
       return value;
     }
-    LISTENER.set(subscriber, listeners);
-    OBSERVER.set(subscriber, access);
     try {
       const out = callback.call(subscriber, subscriber);
       unset = typeof out == "function" ? out : void 0;
@@ -129,27 +134,24 @@ var PENDING2 = /* @__PURE__ */ new WeakMap();
 var PARENT = /* @__PURE__ */ new WeakMap();
 var METHODS = /* @__PURE__ */ new WeakMap();
 var METHOD = /* @__PURE__ */ new WeakMap();
-var EXPORT;
-var Model = class _Model {
+var Model = class {
   constructor(...args) {
-    ID.set(this, `${this.constructor}-${uid()}`);
-    STATE.set(this, {});
     prepare(this);
     define(this, "is", { value: this });
-    apply(this, [...args, init]);
+    init(this, args);
   }
   get(arg1, arg2) {
     const self = this.is;
     if (arg1 === void 0)
-      return values(self);
+      return snapshot(self);
     if (typeof arg1 == "function") {
       let pending = /* @__PURE__ */ new Set();
-      return effect(self, (state) => {
+      return createEffect(self, (state) => {
         const cb = arg1.call(state, state, pending);
         return cb === null ? cb : (update2) => {
           pending = PENDING2.get(self);
           if (typeof cb == "function")
-            return cb(update2);
+            cb(update2);
         };
       });
     }
@@ -204,14 +206,13 @@ var Model = class _Model {
     return Object.entries(STATE.get(this.is))[Symbol.iterator]();
   }
   /**
-   * Create and activate a new instance of this controller.
+   * Create and activate a new instance of this model.
    * 
    * **Important** - Unlike `new this(...)` - this method also activates state.
    * 
    * @param args - arguments sent to constructor
    */
   static new(...args) {
-    _Model.is(this);
     const instance = new this(...args);
     emit(instance, true);
     return instance;
@@ -223,9 +224,7 @@ var Model = class _Model {
    * methods and properties of this class.
    */
   static is(maybe) {
-    if (maybe === _Model)
-      throw new Error("Model is abstract and not a valid type.");
-    return typeof maybe == "function" && maybe.prototype instanceof this;
+    return maybe === this || typeof maybe == "function" && maybe.prototype instanceof this;
   }
   /**
    * Register a callback to run when any instance of this Model is updated. 
@@ -249,50 +248,59 @@ define(Model, "toString", {
   }
 });
 function prepare(model) {
+  let T = model.constructor;
+  if (T === Model)
+    throw new Error("Cannot create base Model.");
   const chain = [];
-  let type = model.constructor;
   let keys2 = /* @__PURE__ */ new Set();
-  while (type.name) {
-    chain.unshift(type);
-    type = Object.getPrototypeOf(type);
-  }
-  for (const type2 of chain) {
-    for (const cb of NOTIFY.get(type2) || [])
+  ID.set(model, `${T}-${uid()}`);
+  while (T.name) {
+    for (const cb of NOTIFY.get(T) || [])
       addListener(model, cb);
-    if (type2 == Model)
-      continue;
-    if (METHODS.has(type2)) {
-      keys2 = METHODS.get(type2);
+    if (T === Model)
+      break;
+    else
+      chain.unshift(T);
+    T = Object.getPrototypeOf(T);
+  }
+  for (const type of chain) {
+    if (METHODS.has(type)) {
+      keys2 = METHODS.get(type);
       continue;
     }
-    METHODS.set(type2, keys2 = new Set(keys2));
-    for (const { key: key2, value } of entries(type2.prototype)) {
-      let set3 = function(method) {
+    METHODS.set(type, keys2 = new Set(keys2));
+    for (const [key2, { value }] of Object.entries(
+      Object.getOwnPropertyDescriptors(type.prototype)
+    )) {
+      let get3 = function() {
+        return this.hasOwnProperty(key2) ? value : set3.call(this, value);
+      }, set3 = function(method) {
         const value2 = method.bind(this.is);
         METHOD.set(value2, method);
         define(this.is, key2, { value: value2, writable: true });
         return value2;
       };
-      var set2 = set3;
+      var get2 = get3, set2 = set3;
       if (!value || key2 == "constructor")
         continue;
       keys2.add(key2);
-      Object.defineProperty(type2.prototype, key2, {
-        set: set3,
-        get() {
-          return this.hasOwnProperty(key2) ? value : set3.call(this, value);
-        }
-      });
+      define(type.prototype, key2, { get: get3, set: set3 });
     }
   }
 }
-function apply(model, args) {
-  for (const arg of args)
-    if (typeof arg == "string")
-      ID.set(model, arg);
+function init(model, args) {
+  const state = {};
+  const clean = /* @__PURE__ */ new Set();
+  STATE.set(model, state);
+  args = args.flat().filter((arg) => {
+    if (typeof arg != "string")
+      return true;
+    ID.set(model, arg);
+  });
   addListener(model, () => {
-    const done = /* @__PURE__ */ new Set();
-    for (const arg of args) {
+    if (!PARENT.has(model))
+      PARENT.set(model, null);
+    args.forEach((arg) => {
       const use2 = typeof arg == "function" ? arg.call(model, model) : arg;
       if (use2 instanceof Promise)
         use2.catch((err) => {
@@ -302,37 +310,30 @@ function apply(model, args) {
       else if (typeof use2 == "object")
         assign(model, use2);
       else if (typeof use2 == "function")
-        done.add(use2);
+        clean.add(use2);
+    });
+    for (const key2 in model) {
+      const desc = Object.getOwnPropertyDescriptor(model, key2);
+      if ("value" in desc) {
+        update(model, key2, desc.value, true);
+        define(model, key2, {
+          configurable: false,
+          set: (x) => update(model, key2, x),
+          get() {
+            return watch(this, key2, state[key2]);
+          }
+        });
+      }
     }
-    addListener(model, () => {
-      done.forEach((x) => x());
-    }, null);
     return null;
   });
-}
-function init(model) {
-  const state = STATE.get(model);
-  if (!PARENT.has(model))
-    PARENT.set(model, null);
-  for (const key2 in model) {
-    const desc = Object.getOwnPropertyDescriptor(model, key2);
-    if ("value" in desc) {
-      update(model, key2, desc.value, true);
-      define(model, key2, {
-        configurable: false,
-        set: (x) => update(model, key2, x),
-        get() {
-          return watch(this, key2, state[key2]);
-        }
-      });
-    }
-  }
-  return () => {
+  addListener(model, () => {
+    clean.forEach((x) => x());
     for (const [_, value] of model)
       if (value instanceof Model && PARENT.get(value) === model)
         value.set(null);
     Object.freeze(state);
-  };
+  }, null);
 }
 function fetch(subject, property, required) {
   const state = STATE.get(subject);
@@ -359,6 +360,25 @@ function fetch(subject, property, required) {
     stack: error.stack
   });
 }
+var EXPORT;
+function snapshot(model) {
+  const values = {};
+  let isNotRecursive;
+  if (!EXPORT) {
+    isNotRecursive = true;
+    EXPORT = /* @__PURE__ */ new Map([[model, values]]);
+  }
+  for (let [key2, value] of model) {
+    if (EXPORT.has(value))
+      value = EXPORT.get(value);
+    else if (value && typeof value == "object" && "get" in value && typeof value.get === "function")
+      EXPORT.set(value, value = value.get());
+    values[key2] = value;
+  }
+  if (isNotRecursive)
+    EXPORT = void 0;
+  return Object.freeze(values);
+}
 function update(subject, key2, value, arg) {
   const state = STATE.get(subject);
   if (Object.isFrozen(state))
@@ -395,42 +415,23 @@ function event(subject, key2, silent) {
   if (!silent)
     emit(subject, key2);
 }
-function assign(to, values2) {
+function assign(to, values) {
   const methods = METHODS.get(to.constructor);
-  for (const key2 in values2)
+  for (const key2 in values)
     if (key2 in to || methods.has(key2))
-      to[key2] = values2[key2];
-}
-function values(model) {
-  const values2 = {};
-  const current = !EXPORT && (EXPORT = /* @__PURE__ */ new Map([[model, values2]]));
-  for (let [key2, value] of model) {
-    if (EXPORT.has(value))
-      value = EXPORT.get(value);
-    else if (value && typeof value.get === "function")
-      EXPORT.set(value, value = value.get());
-    values2[key2] = value;
-  }
-  if (current)
-    EXPORT = void 0;
-  return Object.freeze(values2);
+      to[key2] = values[key2];
 }
 function uid() {
   return (Math.random() * 0.722 + 0.278).toString(36).substring(2, 8).toUpperCase();
 }
-function entries(object) {
-  return Object.entries(
-    Object.getOwnPropertyDescriptors(object)
-  ).map(([key2, desc]) => ({ key: key2, ...desc }));
-}
 
 // src/context.ts
-var Register = /* @__PURE__ */ new WeakMap();
-var Table = /* @__PURE__ */ new Map();
+var LOOKUP = /* @__PURE__ */ new WeakMap();
+var KEYS = /* @__PURE__ */ new Map();
 function key(T, upstream) {
-  let K = Table.get(T);
+  let K = KEYS.get(T);
   if (!K)
-    Table.set(T, K = Symbol(
+    KEYS.set(T, K = Symbol(
       typeof T == "symbol" ? "get " + T.description : String(T)
     ));
   return upstream ? key(K) : K;
@@ -450,7 +451,7 @@ var Context = class _Context {
       this.include(inputs);
   }
   static get(from, callback) {
-    const waiting = Register.get(from);
+    const waiting = LOOKUP.get(from);
     if (waiting instanceof _Context) {
       if (callback)
         callback(waiting);
@@ -460,11 +461,14 @@ var Context = class _Context {
       if (waiting)
         waiting.push(callback);
       else
-        Register.set(from, [callback]);
+        LOOKUP.set(from, [callback]);
   }
-  get(Type, callback) {
-    if (callback)
-      Object.defineProperty(this, key(Type, true), { value: callback });
+  /** Run callback when a specified type is registered to a **child** context. */
+  has(Type, callback) {
+    define(this, key(Type, true), { value: callback });
+  }
+  /** Find specified type registered to a parent context. Returns undefined if none are found. */
+  get(Type) {
     const result = this[key(Type)];
     if (result === null)
       throw new Error(`Did find ${Type} in context, but multiple were defined.`);
@@ -486,9 +490,16 @@ var Context = class _Context {
   }
   include(inputs, forEach) {
     const init2 = /* @__PURE__ */ new Map();
+    if (typeof inputs == "function" || inputs instanceof Model)
+      inputs = { 0: inputs };
     Object.entries(inputs).forEach(([K, V]) => {
-      if (!(Model.is(V) || V instanceof Model))
-        throw new Error(`Context can only include Model or instance but got ${V}${K && " as " + K}.`);
+      if (Model.is(V) || V instanceof Model)
+        return;
+      if (K && K != V)
+        V = `${V} (as '${K}')`;
+      throw new Error(
+        `Context may only include instance or class \`extends Model\` but got ${V}.`
+      );
     });
     for (const key2 in inputs) {
       const input = inputs[key2];
@@ -504,9 +515,11 @@ var Context = class _Context {
       }
     }
     for (const [model, explicit] of init2) {
-      model.set();
-      if (forEach)
+      emit(model, true);
+      if (typeof forEach == "function")
         forEach(model, explicit);
+      else if (forEach && explicit)
+        assign(model, forEach);
       for (const [_key, value] of model)
         if (PARENT.get(value) === model) {
           this.add(value, true);
@@ -537,15 +550,15 @@ var Context = class _Context {
     keys(T).forEach((K) => {
       const value = this.hasOwnProperty(K) ? null : I;
       if (value || this[K] !== I && !implicit)
-        Object.defineProperty(this, K, {
+        define(this, K, {
           configurable: true,
           value
         });
     });
-    const waiting = Register.get(I);
+    const waiting = LOOKUP.get(I);
     if (waiting instanceof Array)
       waiting.forEach((cb) => cb(this));
-    Register.set(I, this);
+    LOOKUP.set(I, this);
     return I;
   }
 };
@@ -577,7 +590,8 @@ function use(arg1, arg2) {
 }
 Model.on((_, model) => {
   const state = STATE.get(model);
-  for (const { key: key2, value } of entries(model)) {
+  for (const key2 in model) {
+    const { value } = Object.getOwnPropertyDescriptor(model, key2);
     const instruction = INSTRUCT.get(value);
     if (!instruction) {
       if (value instanceof Model && key2 !== "is")
@@ -592,7 +606,7 @@ Model.on((_, model) => {
     const desc = typeof output == "object" ? output : { get: output };
     if ("value" in desc)
       state[key2] = desc.value;
-    Object.defineProperty(model, key2, {
+    define(model, key2, {
       enumerable: desc.enumerable !== false,
       get() {
         return watch(
@@ -645,7 +659,7 @@ function get(arg0, arg1) {
     }
     if (typeof arg1 == "function") {
       let connect2 = function(model) {
-        reset = effect(model, (current) => {
+        reset = createEffect(model, (current) => {
           proxy = current;
           if (!(key2 in state) || STALE.delete(compute2))
             compute2(!reset);
@@ -689,7 +703,6 @@ function get(arg0, arg1) {
 }
 
 // src/instruction/ref.ts
-var define2 = Object.defineProperty;
 function ref(arg, arg2) {
   return use((key2, subject, state) => {
     let value = {};
@@ -697,20 +710,20 @@ function ref(arg, arg2) {
       subject.get(() => {
         for (const key3 in state)
           if (typeof arg2 == "function")
-            define2(value, key3, {
+            define(value, key3, {
               configurable: true,
               get() {
                 const out = arg2(key3);
-                define2(value, key3, { value: out });
+                define(value, key3, { value: out });
                 return out;
               }
             });
           else {
             const get2 = () => state[key3];
             const set2 = (value2) => subject.set(key3, value2);
-            define2(set2, "current", { get: get2, set: set2 });
-            define2(set2, "get", { value: get2 });
-            define2(value, key3, { value: set2 });
+            define(set2, "current", { get: get2, set: set2 });
+            define(set2, "get", { value: get2 });
+            define(value, key3, { value: set2 });
           }
       });
     else if (typeof arg == "object")
@@ -735,7 +748,7 @@ function ref(arg, arg2) {
         get: { value: get2 }
       });
     }
-    define2(subject, key2, { value });
+    define(subject, key2, { value });
   });
 }
 
@@ -822,7 +835,7 @@ function has(arg1, arg2) {
     };
     if (Model.is(arg1))
       Context.get(subject, (context) => {
-        context.get(arg1, (got) => {
+        context.has(arg1, (got) => {
           let remove;
           let disconnect;
           if (applied.has(got))
@@ -885,8 +898,10 @@ function has(arg1, arg2) {
 export {
   Context,
   Model,
+  addListener,
+  createEffect,
+  createProxy,
   Model as default,
-  effect,
   get,
   has,
   ref,

package/package.json

@@ -32,6 +32,6 @@
     "jest": "^27.0.6",
     "tsup": "^8.0.2"
   },
-  "version": "0.52.0",
-  "gitHead": "b6b92114b8b0c69f1a36eae8c03fec2e068d03c4"
+  "version": "0.52.2-alpha.74+088f4ba5",
+  "gitHead": "088f4ba53762f0b185871570c58f349084eb29af"
 }