@expressive/mvc 0.48.0 → 0.49.0

package/dist/index.d.ts

@@ -354,6 +354,18 @@ declare function has<T extends Model>(type: Model.Type<T>, one: true): T;
 declare function has<T extends Model>(type: Model.Type<T>, required: boolean): T | undefined;
 declare function has<T extends Model>(type: Model.Type<T>, arg?: has.Callback<T>): Set<T>;
 
+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.
+ * Callback is called immediately and if ever values are stale.
+ *
+ * @param target - Instance of Model to observe.
+ * @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 namespace Context {
     type Input = Record<string | number, Model | Model.Type<Model>>;
 }
@@ -392,4 +404,4 @@ declare global {
     }
 }
 
-export { Context, Model, Model as default, get, has, ref, set, use };
+export { Context, Model, Model as default, effect, get, has, ref, set, use };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(src_exports, {
   Context: () => Context,
   Model: () => Model,
   default: () => Model,
+  effect: () => effect,
   get: () => get,
   has: () => has,
   ref: () => ref,
@@ -35,6 +36,7 @@ module.exports = __toCommonJS(src_exports);
 var DISPATCH = /* @__PURE__ */ new Set();
 var OBSERVER = /* @__PURE__ */ new WeakMap();
 var LISTENER = /* @__PURE__ */ new WeakMap();
+var REQUIRED = /* @__PURE__ */ new WeakSet();
 var onReady = () => null;
 function addListener(subject, callback, select) {
   let subs = LISTENER.get(subject);
@@ -59,11 +61,13 @@ function watch(from, key, value) {
       LISTENER.set(value = Object.create(value), nested);
       OBSERVER.set(value, observer);
     }
+    if (value === void 0 && REQUIRED.has(from))
+      throw new Error(`${from}.${key} is required in this context.`);
   }
   return value;
 }
 var PENDING = /* @__PURE__ */ new WeakMap();
-function event(source, key) {
+function emit(source, key) {
   const subs = LISTENER.get(source);
   const ready = !subs.has(onReady);
   if (key === true && ready)
@@ -90,21 +94,21 @@ function event(source, key) {
   });
   PENDING.delete(source);
 }
-function queue(event2) {
+function queue(event) {
   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(event);
 }
-function effect(target, callback) {
+function effect(target, callback, requireValues) {
   const listeners = LISTENER.get(target);
   let unset;
   let reset;
@@ -122,6 +126,8 @@ function effect(target, callback) {
       }
       return reset;
     });
+    if (requireValues)
+      REQUIRED.add(subscriber);
     try {
       const out = callback.call(subscriber, subscriber);
       unset = typeof out == "function" ? out : void 0;
@@ -267,11 +273,11 @@ var Model = class _Model {
           return arg1.call(self, key, self);
       });
     if (arg1 === null)
-      return event(this, null);
+      return emit(this, null);
     if (typeof arg1 == "object")
       assign(self, arg1);
     else if (arg1 == void 0)
-      event(this, true);
+      emit(this, true);
     else if (1 in arguments)
       update(self, arg1, arg2, arg3);
     else
@@ -301,7 +307,7 @@ var Model = class _Model {
    */
   static new(...args) {
     const instance = new this(...args);
-    event(instance, true);
+    emit(instance, true);
     return instance;
   }
   /**
@@ -368,7 +374,7 @@ function update(subject, key, value, silent) {
     return true;
   if (value instanceof Model && !PARENT.has(value)) {
     PARENT.set(value, subject);
-    event(value, true);
+    emit(value, true);
   }
   state[key] = value;
   if (silent !== true)
@@ -380,13 +386,13 @@ function push(subject, key, silent) {
     PENDING2.set(subject, pending = /* @__PURE__ */ new Set());
     if (!silent)
       queue(() => {
-        event(subject, false);
+        emit(subject, false);
         PENDING2.delete(subject);
       });
   }
   pending.add(key);
   if (!silent)
-    event(subject, key);
+    emit(subject, key);
 }
 var METHODS = new WeakMap([[Model, []]]);
 function assign(to, values) {
@@ -863,6 +869,7 @@ function has(type, argument) {
 0 && (module.exports = {
   Context,
   Model,
+  effect,
   get,
   has,
   ref,

package/dist/index.mjs

@@ -2,6 +2,7 @@
 var DISPATCH = /* @__PURE__ */ new Set();
 var OBSERVER = /* @__PURE__ */ new WeakMap();
 var LISTENER = /* @__PURE__ */ new WeakMap();
+var REQUIRED = /* @__PURE__ */ new WeakSet();
 var onReady = () => null;
 function addListener(subject, callback, select) {
   let subs = LISTENER.get(subject);
@@ -26,11 +27,13 @@ function watch(from, key, value) {
       LISTENER.set(value = Object.create(value), nested);
       OBSERVER.set(value, observer);
     }
+    if (value === void 0 && REQUIRED.has(from))
+      throw new Error(`${from}.${key} is required in this context.`);
   }
   return value;
 }
 var PENDING = /* @__PURE__ */ new WeakMap();
-function event(source, key) {
+function emit(source, key) {
   const subs = LISTENER.get(source);
   const ready = !subs.has(onReady);
   if (key === true && ready)
@@ -57,21 +60,21 @@ function event(source, key) {
   });
   PENDING.delete(source);
 }
-function queue(event2) {
+function queue(event) {
   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(event);
 }
-function effect(target, callback) {
+function effect(target, callback, requireValues) {
   const listeners = LISTENER.get(target);
   let unset;
   let reset;
@@ -89,6 +92,8 @@ function effect(target, callback) {
       }
       return reset;
     });
+    if (requireValues)
+      REQUIRED.add(subscriber);
     try {
       const out = callback.call(subscriber, subscriber);
       unset = typeof out == "function" ? out : void 0;
@@ -234,11 +239,11 @@ var Model = class _Model {
           return arg1.call(self, key, self);
       });
     if (arg1 === null)
-      return event(this, null);
+      return emit(this, null);
     if (typeof arg1 == "object")
       assign(self, arg1);
     else if (arg1 == void 0)
-      event(this, true);
+      emit(this, true);
     else if (1 in arguments)
       update(self, arg1, arg2, arg3);
     else
@@ -268,7 +273,7 @@ var Model = class _Model {
    */
   static new(...args) {
     const instance = new this(...args);
-    event(instance, true);
+    emit(instance, true);
     return instance;
   }
   /**
@@ -335,7 +340,7 @@ function update(subject, key, value, silent) {
     return true;
   if (value instanceof Model && !PARENT.has(value)) {
     PARENT.set(value, subject);
-    event(value, true);
+    emit(value, true);
   }
   state[key] = value;
   if (silent !== true)
@@ -347,13 +352,13 @@ function push(subject, key, silent) {
     PENDING2.set(subject, pending = /* @__PURE__ */ new Set());
     if (!silent)
       queue(() => {
-        event(subject, false);
+        emit(subject, false);
         PENDING2.delete(subject);
       });
   }
   pending.add(key);
   if (!silent)
-    event(subject, key);
+    emit(subject, key);
 }
 var METHODS = new WeakMap([[Model, []]]);
 function assign(to, values) {
@@ -830,6 +835,7 @@ export {
   Context,
   Model,
   Model as default,
+  effect,
   get,
   has,
   ref,

package/package.json

@@ -28,6 +28,6 @@
     "prebuild": "rm -rf dist",
     "preversion": "npm run test && npm run build"
   },
-  "version": "0.48.0",
-  "gitHead": "1f5ddf82e800cf53bf867ac5e546ad3186ce8bf5"
+  "version": "0.49.0",
+  "gitHead": "3a1423ef6d335d0e876904459d360a2e0ebdff7b"
 }