@expressive/mvc 0.84.3 → 0.86.0

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 import { Context } from "./context.js";
 import { State, unbind } from "./state.js";
-import { transition } from "./runtime.js";
+import { Caught } from "./caught.js";
 import { Component } from "./component.js";
+import { pending } from "./dispatch.js";
 import { def } from "./field/def.js";
 import { get } from "./field/get.js";
 import { has } from "./field/has.js";
 import { map } from "./field/map.js";
 import { ref } from "./field/ref.js";
 import { set } from "./field/set.js";
-export { Component, Context, State, def, State as default, get, has, map, ref, set, transition, unbind };
+export { Caught, Component, Context, State, def, State as default, get, has, map, pending, ref, set, unbind };

package/dist/index.js

@@ -1,4 +1,6 @@
+import { Caught } from "./caught.js";
 import { State, unbind } from "./state.js";
+import { pending } from "./dispatch.js";
 import { Context } from "./context.js";
 import { def } from "./field/def.js";
 import { set } from "./field/set.js";
@@ -7,6 +9,11 @@ import { get } from "./field/get.js";
 import { has } from "./field/has.js";
 import { map } from "./field/map.js";
 import { ref } from "./field/ref.js";
-import { transition } from "./runtime.js";
 
-export { Component, Context, State, def, State as default, get, has, map, ref, set, transition, unbind };
+//#region src/index.ts
+/** @deprecated Import `{ State }` as a named export. Adapter-augmented `State.*` types are not visible through the default alias. */
+var src_default = State;
+
+//#endregion
+export { Caught, Component, Context, State, def, src_default as default, get, has, map, pending, ref, set, unbind };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export { def } from './field/def';\nexport { get } from './field/get';\nexport { has } from './field/has';\nexport { map } from './field/map';\nexport { set } from './field/set';\nexport { ref } from './field/ref';\n\nimport { State } from './state';\n\nexport { State, unbind } from './state';\n\n/** @deprecated Import `{ State }` as a named export. Adapter-augmented `State.*` types are not visible through the default alias. */\nexport default State;\nexport { Context } from './context';\nexport { Component } from './component';\nexport { pending } from './dispatch';\nexport { Caught } from './caught';\n"],"mappings":";;;;;;;;;;;;;;AAYA,kBAAe"}

package/dist/observable.d.ts

@@ -40,7 +40,7 @@ declare function observer(state: object, create?: boolean): Observer | undefined
 declare function touch(from: object, key: any): void;
 declare function touch<T>(from: object, key: any, value?: T): T;
 declare function listener<T extends object>(subject: T, callback: Observer.Notify, select?: Observer.Signal | Set<Observer.Signal>): () => boolean;
-declare function pending<K extends Observer.Event>(state: object): K[] & PromiseLike<K[]>;
+declare function queued<K extends Observer.Event>(state: object): K[] & PromiseLike<K[]>;
 declare function event(state: object, key?: Observer.Event | null, silent?: boolean): void;
 /**
  * Create a side-effect which will update whenever values accessed change.
@@ -50,9 +50,9 @@ declare function event(state: object, key?: Observer.Event | null, silent?: bool
  * @param callback - Function to invoke when values change.
  * @param requireValues - If `true` will throw if accessing a value which is `undefined`.
  */
-declare function watch<T extends object>(target: T, callback: Observer.Effect<Required<T>>, requireValues: true): () => void;
-declare function watch<T extends object>(target: T, callback: Observer.Effect<T>, recursive?: boolean): () => void;
+declare function watch<T extends object>(target: T, callback: Observer.Effect<Required<T>>, requireValues: true, transition?: (work: () => void) => void): () => void;
+declare function watch<T extends object>(target: T, callback: Observer.Effect<T>, recursive?: boolean, transition?: (work: () => void) => void): () => void;
 declare function capture(scope: (release: (update?: boolean | null) => void) => void): void;
 //#endregion
-export { Observer, capture, event, listener, observer, pending, touch, watch };
+export { Observer, capture, event, listener, observer, queued, touch, watch };
 //# sourceMappingURL=observable.d.ts.map

package/dist/observable.js

@@ -1,4 +1,4 @@
-import { enqueue } from "./dispatch.js";
+import { enqueue, hold } from "./dispatch.js";
 
 //#region src/observable.ts
 const Observer = Symbol("Observer");
@@ -20,11 +20,18 @@ function observer(state, create) {
 	}
 	return o;
 }
-function observe(object, callback, required) {
+function observe(object, callback, required, cleanup = []) {
 	const watching = /* @__PURE__ */ new Set();
+	const observing = {
+		callback,
+		watching,
+		required,
+		release: cleanup
+	};
 	const release = listener(object, (key) => {
-		if (watching.has(key)) return callback();
+		if (watching.has(key)) return observing.callback();
 	});
+	cleanup.push(release);
 	if (EffectContext) EffectContext.add((update) => {
 		if (update !== true) release();
 	});
@@ -33,21 +40,20 @@ function observe(object, callback, required) {
 		value: object.is,
 		writable: true
 	});
-	return Object.defineProperty(proxy, Observing, { value: {
-		callback,
-		watching,
-		required
-	} });
+	return Object.defineProperty(proxy, Observing, { value: observing });
 }
 function touch(from, key, value) {
 	const active = from[Observing];
 	if (active) {
 		if (value === void 0 && arguments.length === 3 && active.required) throw new Error(`${Object.getPrototypeOf(from)}.${String(key)} is required in this context.`);
 		active.watching.add(key);
-		if (value instanceof Object && observer(value)) return observe(value, active.callback, active.required);
+		if (value instanceof Object && observer(value)) return observe(value, () => active.callback(), active.required, active.release);
 	}
 	return value;
 }
+function unobserve(observing) {
+	for (const release of observing.release) release();
+}
 function listener(subject, callback, select) {
 	const o = observer(subject, true);
 	if (select !== void 0 && !(select instanceof Set)) select = new Set([select]);
@@ -56,7 +62,7 @@ function listener(subject, callback, select) {
 	return () => o.listeners.delete(callback);
 }
 const EMPTY = Object.assign([], { then: Promise.prototype.then.bind(Promise.resolve([])) });
-function pending(state) {
+function queued(state) {
 	const o = observer(state);
 	if (!o?.events.size) return EMPTY;
 	const current = o.events;
@@ -75,17 +81,17 @@ function event(state, key, silent) {
 	if (key === null) {
 		if (!Object.getOwnPropertyDescriptor(state, Observer)) return;
 		state[Observer] = null;
-		return emit(o, key);
+		return emit(o, key, state);
 	}
-	if (key === void 0) return emit(o, true);
+	if (key === void 0) return emit(o, true, state);
 	if (!o.events.size && !silent) enqueue(() => {
-		emit(o, false);
+		emit(o, false, state);
 		o.events = /* @__PURE__ */ new Set();
-	});
+	}, void 0, state);
 	o.events.add(key);
-	if (!silent) emit(o, key);
+	if (!silent) emit(o, key, state);
 }
-function emit(o, key) {
+function emit(o, key, subject) {
 	const { listeners, pending, ready } = o;
 	if (key === ready) return;
 	if (pending.size) {
@@ -97,49 +103,57 @@ function emit(o, key) {
 	for (const k of pending) for (const [callback, filter] of listeners) if (!filter || filter.has(k)) {
 		const after = callback(k);
 		if (after === null) listeners.delete(callback);
-		else if (after) enqueue(after);
+		else if (typeof after == "function") enqueue(after, void 0, subject);
 	}
 	if (key === null) listeners.clear();
 	else if (key === true) o.ready = true;
 	pending.clear();
 }
-function watch(target, callback, argument) {
+function watch(target, callback, argument, transition) {
 	const o = observer(target, true);
 	let events = [];
 	let unset;
 	let reset;
 	let previous;
+	let latest;
 	let queued = false;
+	let suspense;
+	function resume() {
+		suspense?.();
+		suspense = void 0;
+	}
 	function invoke() {
-		if (observer(target) === null) return;
+		if (reset === null || observer(target) === null) return;
 		queued = false;
 		let ignore = true;
 		function onUpdate() {
 			events = [...o.events];
 			if (reset === null) return null;
 			if (ignore) {
-				if (queued) enqueue(invoke);
+				if (queued) enqueue(invoke, transition, target);
 				return;
 			}
 			ignore = true;
 			queued = true;
 			unset(true);
 			unset = void 0;
-			enqueue(invoke);
+			enqueue(invoke, transition, target);
 		}
 		function run(release) {
+			if (previous !== latest) unobserve(latest);
 			const proxy = observe(target, onUpdate, argument === true);
+			const current = latest = proxy[Observing];
 			const output = callback.call(proxy, proxy, events);
 			if (observer(target) === null) {
 				if (typeof output == "function") output(null);
 				if (release) release(null);
 				return;
 			}
-			if (previous && argument === false) {
-				const { watching } = proxy[Observing];
-				if (!watching.size) previous[Observing].watching.forEach((k) => watching.add(k));
+			if (previous && argument === false && !current.watching.size) previous.callback = onUpdate;
+			else {
+				if (previous) unobserve(previous);
+				previous = current;
 			}
-			previous = proxy;
 			ignore = false;
 			reset = output === null ? null : invoke;
 			unset = (key) => {
@@ -154,17 +168,30 @@ function watch(target, callback, argument) {
 		} catch (err) {
 			if (err instanceof Promise) {
 				reset = void 0;
-				err.then(invoke);
+				const suspended = suspense = hold(true, transition);
+				const replay = () => {
+					if (suspense !== suspended) return;
+					suspense = void 0;
+					suspended(invoke);
+				};
+				err.then(replay, replay);
 			} else throw err;
 		}
 	}
 	const unlisten = listener(target, (key) => {
 		if (key === true) invoke();
-		else if (!reset) return reset;
-		if (key === null && unset) unset(null);
+		else if (key === null) {
+			if (unset) unset(null);
+			resume();
+			reset = null;
+		} else if (!reset) {
+			suspense?.(false);
+			return reset;
+		}
 	});
 	function cleanup() {
 		if (unset) unset(false);
+		resume();
 		reset = null;
 		unlisten();
 	}
@@ -183,5 +210,5 @@ function capture(scope) {
 }
 
 //#endregion
-export { Observer, capture, event, listener, observer, pending, touch, watch };
+export { Observer, capture, event, listener, observer, queued, touch, watch };
 //# sourceMappingURL=observable.js.map

package/dist/observable.js.map

@@ -1 +1 @@
-{"version":3,"file":"observable.js","names":[],"sources":["../src/observable.ts"],"sourcesContent":["import { enqueue } from './dispatch';\n\ndeclare namespace Observer {\n  /**\n   * Update callback function.\n   *\n   * @param key -\n   *   - `string` - property which has updated.\n   *   - `false` - a normal update has completed.\n   *   - `true` - initial event; instance is ready.\n   *   - `null` - terminal event; instance is expired.\n   */\n  type Notify = (key: Signal) => (() => void) | null | void;\n\n  type EffectCleanup = (update: boolean | null) => void;\n\n  type Effect<T extends object> = (\n    this: T,\n    proxy: T,\n    changed: readonly Event[]\n  ) => EffectCleanup | Promise<void> | null | void;\n\n  type Event = number | string | symbol;\n\n  type Signal = Event | true | false | null;\n\n  type Callback = () => void | null;\n}\n\ninterface Observer {\n  /** Becomes `true` once the subject has emitted its initial event. */\n  ready?: true;\n  listeners: Map<Observer.Notify, Set<Observer.Signal> | undefined>;\n  /** Recursion guard for an in-progress emit pass. */\n  pending: Set<Observer.Signal>;\n  /** Accumulator drained by the next microtask. */\n  events: Set<Observer.Event>;\n}\n\ninterface Observing {\n  callback: Observer.Callback;\n  watching: Set<Observer.Signal>;\n  required?: boolean;\n}\n\nconst Observer: unique symbol = Symbol('Observer');\nconst Observing: unique symbol = Symbol('Observing');\n\ninterface Observable { [Observer]?: Observer | null }\ninterface Observed { [Observing]?: Observing }\n\n/**\n * Fetch the dispatch bundle attached to an object.\n * - returns the bundle if active\n * - returns `null` if the subject has been terminated\n * - returns `undefined` if the subject was never observable\n *\n * With `create: true`, attaches a fresh bundle iff the slot is undefined.\n * A terminated (null) slot is not resurrected.\n */\nfunction observer(state: object, create: true): Observer;\nfunction observer(state: object, create?: boolean): Observer | undefined | null;\nfunction observer(state: object, create?: boolean) {\n  const o = (state as Observable)[Observer];\n\n  if (!o && create) {\n    if (o === null)\n      throw new Error(\n        `${state} was destroyed - cannot be rendered, watched or updated.`\n      );\n\n    const value: Observer = {\n      listeners: new Map(),\n      pending: new Set(),\n      events: new Set()\n    };\n    Object.defineProperty(state, Observer, { value, writable: true });\n    return value;\n  }\n\n  return o;\n}\n\nfunction observe<T extends object>(\n  object: T,\n  callback: Observer.Callback,\n  required?: boolean\n): T {\n  const watching = new Set<Observer.Signal>();\n\n  const release = listener(object, (key) => {\n    if (watching.has(key)) return callback();\n  });\n\n  if (EffectContext)\n    EffectContext.add((update) => {\n      if (update !== true) release();\n    });\n\n  const proxy = Object.create(object) as T;\n\n  if ('is' in object)\n    Object.defineProperty(proxy, 'is', {\n      value: (object as { is?: unknown }).is,\n      writable: true\n    });\n\n  return Object.defineProperty(proxy, Observing, {\n    value: { callback, watching, required } as Observing\n  });\n}\n\nfunction touch(from: object, key: any): void;\nfunction touch<T>(from: object, key: any, value?: T): T;\nfunction touch(from: object, key: any, value?: any) {\n  const active = (from as Observed)[Observing];\n\n  if (active) {\n    if (value === undefined && arguments.length === 3 && active.required)\n      throw new Error(\n        `${Object.getPrototypeOf(from)}.${String(key)} is required in this context.`\n      );\n\n    active.watching.add(key);\n\n    if (value instanceof Object && observer(value))\n      return observe(value, active.callback, active.required);\n  }\n\n  return value;\n}\n\nfunction listener<T extends object>(\n  subject: T,\n  callback: Observer.Notify,\n  select?: Observer.Signal | Set<Observer.Signal>\n) {\n  const o = observer(subject, true);\n\n  if (select !== undefined && !(select instanceof Set))\n    select = new Set([select]);\n\n  if (o.ready && !select) callback(true);\n\n  o.listeners.set(callback, select);\n\n  return () => o.listeners.delete(callback);\n}\n\nconst EMPTY = Object.assign([], {\n  then: Promise.prototype.then.bind(Promise.resolve([]))\n} as PromiseLike<never[]>);\n\nfunction pending<K extends Observer.Event>(\n  state: object\n): K[] & PromiseLike<K[]> {\n  const o = observer(state);\n  if (!o?.events.size) return EMPTY;\n\n  const current = o.events as Set<K>;\n  const promise = new Promise<K[]>((res) => {\n    const callback: Observer.Notify = () => {\n      o.listeners.delete(callback);\n      return () => res([...current]);\n    };\n    o.listeners.set(callback, undefined);\n  });\n\n  return Object.assign([...current], {\n    then: promise.then.bind(promise)\n  });\n}\n\nfunction event(state: object, key?: Observer.Event | null, silent?: boolean) {\n  const o = observer(state, key === undefined);\n\n  if (!o) return;\n\n  if (key === null) {\n    if (!Object.getOwnPropertyDescriptor(state, Observer)) return;\n\n    (state as Observable)[Observer] = null;\n    return emit(o, key);\n  }\n\n  if (key === undefined) return emit(o, true);\n\n  if (!o.events.size && !silent)\n    enqueue(() => {\n      emit(o, false);\n      o.events = new Set();\n    });\n\n  o.events.add(key);\n\n  if (!silent) emit(o, key);\n}\n\nfunction emit(o: Observer, key: Observer.Signal): void {\n  const { listeners, pending, ready } = o;\n\n  if (key === ready) return;\n\n  if (pending.size) {\n    pending.add(key);\n    return;\n  }\n\n  if (!ready && key !== null) pending.add(true);\n\n  pending.add(key);\n\n  for (const k of pending)\n    for (const [callback, filter] of listeners)\n      if (!filter || filter.has(k)) {\n        const after = callback(k);\n        if (after === null) listeners.delete(callback);\n        else if (after) enqueue(after);\n      }\n\n  if (key === null) listeners.clear();\n  else if (key === true) o.ready = true;\n\n  pending.clear();\n}\n\n/**\n * Create a side-effect which will update whenever values accessed change.\n * Callback is called immediately and whenever values are stale.\n *\n * @param target - Instance of State to observe.\n * @param callback - Function to invoke when values change.\n * @param requireValues - If `true` will throw if accessing a value which is `undefined`.\n */\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<Required<T>>,\n  requireValues: true\n): () => void;\n\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<T>,\n  recursive?: boolean\n): () => void;\n\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<T>,\n  argument?: boolean\n) {\n  const o = observer(target, true);\n  let events: readonly Observer.Event[] = [];\n  let unset: ((update: boolean | null) => void) | undefined;\n  let reset: (() => void) | null | undefined;\n  let previous: T | undefined;\n  let queued = false;\n\n  function invoke() {\n    if (observer(target) === null) return;\n\n    queued = false;\n    let ignore: boolean = true;\n\n    function onUpdate() {\n      events = [...o.events];\n\n      if (reset === null) return null;\n      if (ignore) {\n        if (queued) enqueue(invoke);\n        return;\n      }\n\n      ignore = true;\n      queued = true;\n\n      unset!(true);\n      unset = undefined;\n\n      enqueue(invoke);\n    }\n\n    function run(release?: (update?: boolean | null) => void) {\n      const proxy = observe(target, onUpdate, argument === true);\n      const output = callback.call(proxy, proxy, events);\n\n      if (observer(target) === null) {\n        if (typeof output == 'function') output(null);\n        if (release) release(null);\n        return;\n      }\n\n      if (previous && argument === false) {\n        const { watching } = (proxy as Observed)[Observing]!;\n        if (!watching.size)\n          (previous as Observed)[Observing]!.watching.forEach((k) => watching.add(k));\n      }\n      \n      previous = proxy;\n      ignore = false;\n      reset = output === null ? null : invoke;\n      unset = (key) => {\n        if (typeof output == 'function') output(key);\n        if (release) release(key);\n      };\n\n      events = [];\n    }\n\n    try {\n      if (argument !== false) capture(run);\n      else run();\n    } catch (err) {\n      if (err instanceof Promise) {\n        reset = undefined;\n        err.then(invoke);\n      } else {\n        throw err;\n      }\n    }\n  }\n\n  const unlisten = listener(target, (key) => {\n    if (key === true) invoke();\n    else if (!reset) return reset;\n\n    if (key === null && unset) unset(null);\n  });\n\n  function cleanup() {\n    if (unset) unset(false);\n\n    reset = null;\n    unlisten();\n  }\n\n  if (EffectContext && argument !== false) EffectContext.add(cleanup);\n\n  return cleanup;\n}\n\nlet EffectContext: Set<(update?: boolean | null) => void> | undefined;\n\nfunction capture(scope: (release: (update?: boolean | null) => void) => void) {\n  const parent = EffectContext;\n  const context = (EffectContext = new Set());\n\n  try {\n    scope((update) => context.forEach((fn) => fn(update)));\n  } finally {\n    EffectContext = parent;\n  }\n}\n\nexport {\n  listener,\n  event,\n  Observer,\n  touch,\n  pending,\n  observer,\n  watch,\n  capture\n};\n"],"mappings":"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"}
+{"version":3,"file":"observable.js","names":[],"sources":["../src/observable.ts"],"sourcesContent":["import { enqueue, hold } from './dispatch';\n\ndeclare namespace Observer {\n  /**\n   * Update callback function.\n   *\n   * @param key -\n   *   - `string` - property which has updated.\n   *   - `false` - a normal update has completed.\n   *   - `true` - initial event; instance is ready.\n   *   - `null` - terminal event; instance is expired.\n   */\n  type Notify = (key: Signal) => (() => void) | null | void;\n\n  type EffectCleanup = (update: boolean | null) => void;\n\n  type Effect<T extends object> = (\n    this: T,\n    proxy: T,\n    changed: readonly Event[]\n  ) => EffectCleanup | Promise<void> | null | void;\n\n  type Event = number | string | symbol;\n\n  type Signal = Event | true | false | null;\n\n  type Callback = () => void | null;\n}\n\ninterface Observer {\n  /** Becomes `true` once the subject has emitted its initial event. */\n  ready?: true;\n  listeners: Map<Observer.Notify, Set<Observer.Signal> | undefined>;\n  /** Recursion guard for an in-progress emit pass. */\n  pending: Set<Observer.Signal>;\n  /** Accumulator drained by the next microtask. */\n  events: Set<Observer.Event>;\n}\n\ninterface Observing {\n  callback: Observer.Callback;\n  watching: Set<Observer.Signal>;\n  required?: boolean;\n  release: (() => void)[];\n}\n\nconst Observer: unique symbol = Symbol('Observer');\nconst Observing: unique symbol = Symbol('Observing');\n\ninterface Observable { [Observer]?: Observer | null }\ninterface Observed { [Observing]?: Observing }\n\n/**\n * Fetch the dispatch bundle attached to an object.\n * - returns the bundle if active\n * - returns `null` if the subject has been terminated\n * - returns `undefined` if the subject was never observable\n *\n * With `create: true`, attaches a fresh bundle iff the slot is undefined.\n * A terminated (null) slot is not resurrected.\n */\nfunction observer(state: object, create: true): Observer;\nfunction observer(state: object, create?: boolean): Observer | undefined | null;\nfunction observer(state: object, create?: boolean) {\n  const o = (state as Observable)[Observer];\n\n  if (!o && create) {\n    if (o === null)\n      throw new Error(\n        `${state} was destroyed - cannot be rendered, watched or updated.`\n      );\n\n    const value: Observer = {\n      listeners: new Map(),\n      pending: new Set(),\n      events: new Set()\n    };\n    Object.defineProperty(state, Observer, { value, writable: true });\n    return value;\n  }\n\n  return o;\n}\n\nfunction observe<T extends object>(\n  object: T,\n  callback: Observer.Callback,\n  required?: boolean,\n  cleanup: (() => void)[] = []\n): T {\n  const watching = new Set<Observer.Signal>();\n  const observing: Observing = { callback, watching, required, release: cleanup };\n\n  const release = listener(object, (key) => {\n    if (watching.has(key)) return observing.callback();\n  });\n\n  cleanup.push(release);\n\n  if (EffectContext)\n    EffectContext.add((update) => {\n      if (update !== true) release();\n    });\n\n  const proxy = Object.create(object) as T;\n\n  if ('is' in object)\n    Object.defineProperty(proxy, 'is', {\n      value: (object as { is?: unknown }).is,\n      writable: true\n    });\n\n  return Object.defineProperty(proxy, Observing, { value: observing });\n}\n\nfunction touch(from: object, key: any): void;\nfunction touch<T>(from: object, key: any, value?: T): T;\nfunction touch(from: object, key: any, value?: any) {\n  const active = (from as Observed)[Observing];\n\n  if (active) {\n    if (value === undefined && arguments.length === 3 && active.required)\n      throw new Error(\n        `${Object.getPrototypeOf(from)}.${String(key)} is required in this context.`\n      );\n\n    active.watching.add(key);\n\n    if (value instanceof Object && observer(value))\n      return observe(\n        value,\n        () => active.callback(),\n        active.required,\n        active.release\n      );\n  }\n\n  return value;\n}\n\nfunction unobserve(observing: Observing) {\n  for (const release of observing.release) release();\n}\n\nfunction listener<T extends object>(\n  subject: T,\n  callback: Observer.Notify,\n  select?: Observer.Signal | Set<Observer.Signal>\n) {\n  const o = observer(subject, true);\n\n  if (select !== undefined && !(select instanceof Set))\n    select = new Set([select]);\n\n  if (o.ready && !select) callback(true);\n\n  o.listeners.set(callback, select);\n\n  return () => o.listeners.delete(callback);\n}\n\nconst EMPTY = Object.assign([], {\n  then: Promise.prototype.then.bind(Promise.resolve([]))\n} as PromiseLike<never[]>);\n\nfunction queued<K extends Observer.Event>(\n  state: object\n): K[] & PromiseLike<K[]> {\n  const o = observer(state);\n  if (!o?.events.size) return EMPTY;\n\n  const current = o.events as Set<K>;\n  const promise = new Promise<K[]>((res) => {\n    const callback: Observer.Notify = () => {\n      o.listeners.delete(callback);\n      return () => res([...current]);\n    };\n    o.listeners.set(callback, undefined);\n  });\n\n  return Object.assign([...current], {\n    then: promise.then.bind(promise)\n  });\n}\n\nfunction event(state: object, key?: Observer.Event | null, silent?: boolean) {\n  const o = observer(state, key === undefined);\n\n  if (!o) return;\n\n  if (key === null) {\n    if (!Object.getOwnPropertyDescriptor(state, Observer)) return;\n\n    (state as Observable)[Observer] = null;\n    return emit(o, key, state);\n  }\n\n  if (key === undefined) return emit(o, true, state);\n\n  if (!o.events.size && !silent)\n    enqueue(() => {\n      emit(o, false, state);\n      o.events = new Set();\n    }, undefined, state);\n\n  o.events.add(key);\n\n  if (!silent) emit(o, key, state);\n}\n\nfunction emit(o: Observer, key: Observer.Signal, subject: object): void {\n  const { listeners, pending, ready } = o;\n\n  if (key === ready) return;\n\n  if (pending.size) {\n    pending.add(key);\n    return;\n  }\n\n  if (!ready && key !== null) pending.add(true);\n\n  pending.add(key);\n\n  for (const k of pending)\n    for (const [callback, filter] of listeners)\n      if (!filter || filter.has(k)) {\n        const after = callback(k);\n        if (after === null) listeners.delete(callback);\n        else if (typeof after == 'function') enqueue(after, undefined, subject);\n      }\n\n  if (key === null) listeners.clear();\n  else if (key === true) o.ready = true;\n\n  pending.clear();\n}\n\n/**\n * Create a side-effect which will update whenever values accessed change.\n * Callback is called immediately and whenever values are stale.\n *\n * @param target - Instance of State to observe.\n * @param callback - Function to invoke when values change.\n * @param requireValues - If `true` will throw if accessing a value which is `undefined`.\n */\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<Required<T>>,\n  requireValues: true,\n  transition?: (work: () => void) => void\n): () => void;\n\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<T>,\n  recursive?: boolean,\n  transition?: (work: () => void) => void\n): () => void;\n\nfunction watch<T extends object>(\n  target: T,\n  callback: Observer.Effect<T>,\n  argument?: boolean,\n  transition?: (work: () => void) => void\n) {\n  const o = observer(target, true);\n  let events: readonly Observer.Event[] = [];\n  let unset: ((update: boolean | null) => void) | undefined;\n  let reset: (() => void) | null | undefined;\n  let previous: Observing | undefined;\n  let latest: Observing | undefined;\n  let queued = false;\n  let suspense: ReturnType<typeof hold>;\n\n  function resume() {\n    suspense?.();\n    suspense = undefined;\n  }\n\n  function invoke() {\n    if (reset === null || observer(target) === null) return;\n\n    queued = false;\n    let ignore: boolean = true;\n\n    function onUpdate() {\n      events = [...o.events];\n\n      if (reset === null) return null;\n      if (ignore) {\n        if (queued) enqueue(invoke, transition, target);\n        return;\n      }\n\n      ignore = true;\n      queued = true;\n\n      unset!(true);\n      unset = undefined;\n\n      enqueue(invoke, transition, target);\n    }\n\n    function run(release?: (update?: boolean | null) => void) {\n      if (previous !== latest) unobserve(latest!);\n\n      const proxy = observe(target, onUpdate, argument === true);\n      const current = latest = (proxy as Observed)[Observing]!;\n      const output = callback.call(proxy, proxy, events);\n\n      if (observer(target) === null) {\n        if (typeof output == 'function') output(null);\n        if (release) release(null);\n        return;\n      }\n\n      if (previous && argument === false && !current.watching.size)\n        previous.callback = onUpdate;\n      else {\n        if (previous) unobserve(previous);\n        previous = current;\n      }\n\n      ignore = false;\n      reset = output === null ? null : invoke;\n      unset = (key) => {\n        if (typeof output == 'function') output(key);\n        if (release) release(key);\n      };\n\n      events = [];\n    }\n\n    try {\n      if (argument !== false) capture(run);\n      else run();\n    } catch (err) {\n      if (err instanceof Promise) {\n        reset = undefined;\n        const suspended = suspense = hold(true, transition)!;\n        const replay = () => {\n          if (suspense !== suspended) return;\n          suspense = undefined;\n          suspended(invoke);\n        };\n        err.then(replay, replay);\n      } else {\n        throw err;\n      }\n    }\n  }\n\n  const unlisten = listener(target, (key) => {\n    if (key === true) invoke();\n    else if (key === null) {\n      if (unset) unset(null);\n      resume();\n      reset = null;\n    } else if (!reset) {\n      suspense?.(false);\n      return reset;\n    }\n  });\n\n  function cleanup() {\n    if (unset) unset(false);\n\n    resume();\n    reset = null;\n    unlisten();\n  }\n\n  if (EffectContext && argument !== false) EffectContext.add(cleanup);\n\n  return cleanup;\n}\n\nlet EffectContext: Set<(update?: boolean | null) => void> | undefined;\n\nfunction capture(scope: (release: (update?: boolean | null) => void) => void) {\n  const parent = EffectContext;\n  const context = (EffectContext = new Set());\n\n  try {\n    scope((update) => context.forEach((fn) => fn(update)));\n  } finally {\n    EffectContext = parent;\n  }\n}\n\nexport {\n  listener,\n  event,\n  Observer,\n  touch,\n  queued,\n  observer,\n  watch,\n  capture\n};\n"],"mappings":"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"}

package/dist/runtime.d.ts

@@ -38,8 +38,6 @@ interface HostRuntime {
   jsxs(type: unknown, props: object, key?: unknown): Component.Node;
   propsOf(node: unknown): Record<string, unknown>;
   typeOf(node: unknown): unknown;
-  /** Non-urgent update bracket (e.g. React `startTransition`). Optional - see {@link transition}. */
-  transition?(work: () => void): void;
   Fragment: unknown;
 }
 /**
@@ -50,10 +48,9 @@ interface HostRuntime {
 declare const Fragment: unique symbol;
 /**
  * Register the host runtime. Idempotent for the same runtime - re-registering
- * picks up members added since (e.g. an optional dev or scheduler seam).
- * Element mechanics the host leaves unset keep defaults that throw a
- * setup-pointing error; the optional seams (`jsxDEV`, `transition`) are
- * routed around at the call sites instead.
+ * picks up members added since (e.g. an optional dev seam). Element mechanics
+ * the host leaves unset keep defaults that throw a setup-pointing error;
+ * `jsxDEV` is routed around at the call site instead.
  */
 declare function host(runtime: HostRuntime): void;
 declare function jsx(type: unknown, props: object, key?: unknown): Component.Node;
@@ -69,12 +66,6 @@ declare function isElement(node: unknown): boolean;
 declare function typeOf(node: unknown): unknown;
 /** Props carried by element `node`. */
 declare function propsOf(node: unknown): Record<string, unknown>;
-/**
- * Mark synchronous work as non-urgent. `work` runs inline through the host
- * scheduler; queued subscriber updates inherit the designation and replay it
- * after dispatch. Without a host scheduler, normal timing is retained.
- */
-declare function transition(work: () => void): void;
 //#endregion
-export { Fragment, Host, HostRuntime, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, transition, typeOf };
+export { Fragment, Host, HostRuntime, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -1,5 +1,3 @@
-import { schedule } from "./dispatch.js";
-
 //#region src/runtime.ts
 /**
 * Agnostic Fragment sentinel. The runtime entries translate it to the host's
@@ -23,10 +21,9 @@ const HOST = {
 let registered;
 /**
 * Register the host runtime. Idempotent for the same runtime - re-registering
-* picks up members added since (e.g. an optional dev or scheduler seam).
-* Element mechanics the host leaves unset keep defaults that throw a
-* setup-pointing error; the optional seams (`jsxDEV`, `transition`) are
-* routed around at the call sites instead.
+* picks up members added since (e.g. an optional dev seam). Element mechanics
+* the host leaves unset keep defaults that throw a setup-pointing error;
+* `jsxDEV` is routed around at the call site instead.
 */
 function host(runtime) {
 	if (registered && registered !== runtime) throw new Error("A different JSX host is already registered for @expressive/mvc. Only one host adapter may be active per build.");
@@ -65,15 +62,7 @@ function typeOf(node) {
 function propsOf(node) {
 	return HOST.propsOf(node);
 }
-/**
-* Mark synchronous work as non-urgent. `work` runs inline through the host
-* scheduler; queued subscriber updates inherit the designation and replay it
-* after dispatch. Without a host scheduler, normal timing is retained.
-*/
-function transition(work) {
-	schedule(work, HOST.transition);
-}
 
 //#endregion
-export { Fragment, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, transition, typeOf };
+export { Fragment, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
 //# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { Component } from './component';\nimport { schedule } from './dispatch';\n\n/**\n * Per-adapter interpretation manifest. Each adapter augments this interface to\n * declare how it renders; the first member is `node` - the element type produced\n * by `Component.render` (surfaced as `Component.Node`) - alongside `intrinsics`,\n * the host's tag map (surfaced as `JSX.IntrinsicElements`).\n *\n * ```ts\n * declare module '@expressive/mvc/runtime' {\n *   interface Host {\n *     node: React.ReactNode;\n *     intrinsics: React.JSX.IntrinsicElements;\n *   }\n * }\n * ```\n *\n * Only one adapter is expected per compilation; two augmenting the same member\n * with different types in the same build would conflict - by design.\n */\nexport interface Host { }\n\n/**\n * Host runtime, registered by an adapter (e.g. `@expressive/react`) as an\n * import side effect. One host per build - a second registration with a\n * different runtime throws.\n *\n * Members are ambient host capabilities: plain functions the host uniquely\n * owns, callable outside render - element mechanics always, plus optional\n * extras that fall back sanely when absent. Hook-shaped (render-resident)\n * capabilities do not belong here; those live with the adapter.\n */\nexport interface HostRuntime {\n  childrenOf(children: unknown): Component.Node[];\n  isElement(node: unknown): boolean;\n  jsx(type: unknown, props: object, key?: unknown): Component.Node;\n  jsxDEV?(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;\n  jsxs(type: unknown, props: object, key?: unknown): Component.Node;\n  propsOf(node: unknown): Record<string, unknown>;\n  typeOf(node: unknown): unknown;\n  /** Non-urgent update bracket (e.g. React `startTransition`). Optional - see {@link transition}. */\n  transition?(work: () => void): void;\n  Fragment: unknown;\n}\n\n/**\n * Agnostic Fragment sentinel. The runtime entries translate it to the host's\n * Fragment on element creation; `typeOf` translates back, so identity checks\n * against this value hold for fragments from either pragma.\n */\nexport const Fragment = Symbol.for('@expressive/mvc.Fragment');\n\n/** Default for seams only a registered host can provide. */\nfunction absent(): never {\n  throw new Error(\n    'No JSX host is registered for @expressive/mvc. ' +\n    \"Import a host adapter (e.g. '@expressive/react') before anything renders - \" +\n    'typically as the first import of your application entry module.'\n  );\n}\n\nconst HOST: HostRuntime = {\n  childrenOf: absent,\n  isElement: absent,\n  jsx: absent,\n  jsxs: absent,\n  propsOf: absent,\n  typeOf: absent,\n  Fragment\n};\n\nlet registered: HostRuntime | undefined;\n\n/**\n * Register the host runtime. Idempotent for the same runtime - re-registering\n * picks up members added since (e.g. an optional dev or scheduler seam).\n * Element mechanics the host leaves unset keep defaults that throw a\n * setup-pointing error; the optional seams (`jsxDEV`, `transition`) are\n * routed around at the call sites instead.\n */\nexport function host(runtime: HostRuntime) {\n  if (registered && registered !== runtime)\n    throw new Error(\n      'A different JSX host is already registered for @expressive/mvc. ' +\n      'Only one host adapter may be active per build.'\n    );\n\n  registered = runtime;\n  Object.assign(HOST, runtime);\n}\n\n/** Translate the agnostic Fragment sentinel to the host's Fragment. */\nfunction hostType(type: unknown): unknown {\n  return type === Fragment ? HOST.Fragment : type;\n}\n\nexport function jsx(type: unknown, props: object, key?: unknown): Component.Node {\n  return HOST.jsx(hostType(type), props, key);\n}\n\nexport function jsxs(type: unknown, props: object, key?: unknown): Component.Node {\n  return HOST.jsxs(hostType(type), props, key);\n}\n\n/** Dev-transpiled element creation. Hosts without a `jsxDEV` of their own fall\n * back to the production entries (prod-only host under a dev build). */\nexport function jsxDEV(\n  type: unknown,\n  props: object,\n  key?: unknown,\n  isStatic?: boolean,\n  source?: object,\n  self?: unknown\n): Component.Node {\n  return HOST.jsxDEV\n    ? HOST.jsxDEV(hostType(type), props, key, isStatic, source, self)\n    : isStatic\n      ? jsxs(type, props, key)\n      : jsx(type, props, key);\n}\n\n/** Flatten `children` to an array of nodes, per the host's semantics. */\nexport function childrenOf(children: unknown): Component.Node[] {\n  return HOST.childrenOf(children);\n}\n\n/** Is `node` a host element? */\nexport function isElement(node: unknown): boolean {\n  return HOST.isElement(node);\n}\n\n/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */\nexport function typeOf(node: unknown): unknown {\n  const type = HOST.typeOf(node);\n  return type === HOST.Fragment ? Fragment : type;\n}\n\n/** Props carried by element `node`. */\nexport function propsOf(node: unknown): Record<string, unknown> {\n  return HOST.propsOf(node);\n}\n\n/**\n * Mark synchronous work as non-urgent. `work` runs inline through the host\n * scheduler; queued subscriber updates inherit the designation and replay it\n * after dispatch. Without a host scheduler, normal timing is retained.\n */\nexport function transition(work: () => void): void {\n  schedule(work, HOST.transition);\n}\n"],"mappings":";;;;;;;;AAmDA,MAAa,WAAW,OAAO,IAAI,2BAA2B;;AAG9D,SAAS,SAAgB;AACvB,OAAM,IAAI,MACR,4LAGD;;AAGH,MAAM,OAAoB;CACxB,YAAY;CACZ,WAAW;CACX,KAAK;CACL,MAAM;CACN,SAAS;CACT,QAAQ;CACR;CACD;AAED,IAAI;;;;;;;;AASJ,SAAgB,KAAK,SAAsB;AACzC,KAAI,cAAc,eAAe,QAC/B,OAAM,IAAI,MACR,iHAED;AAEH,cAAa;AACb,QAAO,OAAO,MAAM,QAAQ;;;AAI9B,SAAS,SAAS,MAAwB;AACxC,QAAO,SAAS,WAAW,KAAK,WAAW;;AAG7C,SAAgB,IAAI,MAAe,OAAe,KAA+B;AAC/E,QAAO,KAAK,IAAI,SAAS,KAAK,EAAE,OAAO,IAAI;;AAG7C,SAAgB,KAAK,MAAe,OAAe,KAA+B;AAChF,QAAO,KAAK,KAAK,SAAS,KAAK,EAAE,OAAO,IAAI;;;;AAK9C,SAAgB,OACd,MACA,OACA,KACA,UACA,QACA,MACgB;AAChB,QAAO,KAAK,SACR,KAAK,OAAO,SAAS,KAAK,EAAE,OAAO,KAAK,UAAU,QAAQ,KAAK,GAC/D,WACE,KAAK,MAAM,OAAO,IAAI,GACtB,IAAI,MAAM,OAAO,IAAI;;;AAI7B,SAAgB,WAAW,UAAqC;AAC9D,QAAO,KAAK,WAAW,SAAS;;;AAIlC,SAAgB,UAAU,MAAwB;AAChD,QAAO,KAAK,UAAU,KAAK;;;AAI7B,SAAgB,OAAO,MAAwB;CAC7C,MAAM,OAAO,KAAK,OAAO,KAAK;AAC9B,QAAO,SAAS,KAAK,WAAW,WAAW;;;AAI7C,SAAgB,QAAQ,MAAwC;AAC9D,QAAO,KAAK,QAAQ,KAAK;;;;;;;AAQ3B,SAAgB,WAAW,MAAwB;AACjD,UAAS,MAAM,KAAK,WAAW"}
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import type { Component } from './component';\n\n/**\n * Per-adapter interpretation manifest. Each adapter augments this interface to\n * declare how it renders; the first member is `node` - the element type produced\n * by `Component.render` (surfaced as `Component.Node`) - alongside `intrinsics`,\n * the host's tag map (surfaced as `JSX.IntrinsicElements`).\n *\n * ```ts\n * declare module '@expressive/mvc/runtime' {\n *   interface Host {\n *     node: React.ReactNode;\n *     intrinsics: React.JSX.IntrinsicElements;\n *   }\n * }\n * ```\n *\n * Only one adapter is expected per compilation; two augmenting the same member\n * with different types in the same build would conflict - by design.\n */\nexport interface Host { }\n\n/**\n * Host runtime, registered by an adapter (e.g. `@expressive/react`) as an\n * import side effect. One host per build - a second registration with a\n * different runtime throws.\n *\n * Members are ambient host capabilities: plain functions the host uniquely\n * owns, callable outside render - element mechanics always, plus optional\n * extras that fall back sanely when absent. Hook-shaped (render-resident)\n * capabilities do not belong here; those live with the adapter.\n */\nexport interface HostRuntime {\n  childrenOf(children: unknown): Component.Node[];\n  isElement(node: unknown): boolean;\n  jsx(type: unknown, props: object, key?: unknown): Component.Node;\n  jsxDEV?(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;\n  jsxs(type: unknown, props: object, key?: unknown): Component.Node;\n  propsOf(node: unknown): Record<string, unknown>;\n  typeOf(node: unknown): unknown;\n  Fragment: unknown;\n}\n\n/**\n * Agnostic Fragment sentinel. The runtime entries translate it to the host's\n * Fragment on element creation; `typeOf` translates back, so identity checks\n * against this value hold for fragments from either pragma.\n */\nexport const Fragment = Symbol.for('@expressive/mvc.Fragment');\n\n/** Default for seams only a registered host can provide. */\nfunction absent(): never {\n  throw new Error(\n    'No JSX host is registered for @expressive/mvc. ' +\n    \"Import a host adapter (e.g. '@expressive/react') before anything renders - \" +\n    'typically as the first import of your application entry module.'\n  );\n}\n\nconst HOST: HostRuntime = {\n  childrenOf: absent,\n  isElement: absent,\n  jsx: absent,\n  jsxs: absent,\n  propsOf: absent,\n  typeOf: absent,\n  Fragment\n};\n\nlet registered: HostRuntime | undefined;\n\n/**\n * Register the host runtime. Idempotent for the same runtime - re-registering\n * picks up members added since (e.g. an optional dev seam). Element mechanics\n * the host leaves unset keep defaults that throw a setup-pointing error;\n * `jsxDEV` is routed around at the call site instead.\n */\nexport function host(runtime: HostRuntime) {\n  if (registered && registered !== runtime)\n    throw new Error(\n      'A different JSX host is already registered for @expressive/mvc. ' +\n      'Only one host adapter may be active per build.'\n    );\n\n  registered = runtime;\n  Object.assign(HOST, runtime);\n}\n\n/** Translate the agnostic Fragment sentinel to the host's Fragment. */\nfunction hostType(type: unknown): unknown {\n  return type === Fragment ? HOST.Fragment : type;\n}\n\nexport function jsx(type: unknown, props: object, key?: unknown): Component.Node {\n  return HOST.jsx(hostType(type), props, key);\n}\n\nexport function jsxs(type: unknown, props: object, key?: unknown): Component.Node {\n  return HOST.jsxs(hostType(type), props, key);\n}\n\n/** Dev-transpiled element creation. Hosts without a `jsxDEV` of their own fall\n * back to the production entries (prod-only host under a dev build). */\nexport function jsxDEV(\n  type: unknown,\n  props: object,\n  key?: unknown,\n  isStatic?: boolean,\n  source?: object,\n  self?: unknown\n): Component.Node {\n  return HOST.jsxDEV\n    ? HOST.jsxDEV(hostType(type), props, key, isStatic, source, self)\n    : isStatic\n      ? jsxs(type, props, key)\n      : jsx(type, props, key);\n}\n\n/** Flatten `children` to an array of nodes, per the host's semantics. */\nexport function childrenOf(children: unknown): Component.Node[] {\n  return HOST.childrenOf(children);\n}\n\n/** Is `node` a host element? */\nexport function isElement(node: unknown): boolean {\n  return HOST.isElement(node);\n}\n\n/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */\nexport function typeOf(node: unknown): unknown {\n  const type = HOST.typeOf(node);\n  return type === HOST.Fragment ? Fragment : type;\n}\n\n/** Props carried by element `node`. */\nexport function propsOf(node: unknown): Record<string, unknown> {\n  return HOST.propsOf(node);\n}\n\n"],"mappings":";;;;;;AAgDA,MAAa,WAAW,OAAO,IAAI,2BAA2B;;AAG9D,SAAS,SAAgB;AACvB,OAAM,IAAI,MACR,4LAGD;;AAGH,MAAM,OAAoB;CACxB,YAAY;CACZ,WAAW;CACX,KAAK;CACL,MAAM;CACN,SAAS;CACT,QAAQ;CACR;CACD;AAED,IAAI;;;;;;;AAQJ,SAAgB,KAAK,SAAsB;AACzC,KAAI,cAAc,eAAe,QAC/B,OAAM,IAAI,MACR,iHAED;AAEH,cAAa;AACb,QAAO,OAAO,MAAM,QAAQ;;;AAI9B,SAAS,SAAS,MAAwB;AACxC,QAAO,SAAS,WAAW,KAAK,WAAW;;AAG7C,SAAgB,IAAI,MAAe,OAAe,KAA+B;AAC/E,QAAO,KAAK,IAAI,SAAS,KAAK,EAAE,OAAO,IAAI;;AAG7C,SAAgB,KAAK,MAAe,OAAe,KAA+B;AAChF,QAAO,KAAK,KAAK,SAAS,KAAK,EAAE,OAAO,IAAI;;;;AAK9C,SAAgB,OACd,MACA,OACA,KACA,UACA,QACA,MACgB;AAChB,QAAO,KAAK,SACR,KAAK,OAAO,SAAS,KAAK,EAAE,OAAO,KAAK,UAAU,QAAQ,KAAK,GAC/D,WACE,KAAK,MAAM,OAAO,IAAI,GACtB,IAAI,MAAM,OAAO,IAAI;;;AAI7B,SAAgB,WAAW,UAAqC;AAC9D,QAAO,KAAK,WAAW,SAAS;;;AAIlC,SAAgB,UAAU,MAAwB;AAChD,QAAO,KAAK,UAAU,KAAK;;;AAI7B,SAAgB,OAAO,MAAwB;CAC7C,MAAM,OAAO,KAAK,OAAO,KAAK;AAC9B,QAAO,SAAS,KAAK,WAAW,WAAW;;;AAI7C,SAAgB,QAAQ,MAAwC;AAC9D,QAAO,KAAK,QAAQ,KAAK"}

package/dist/state.d.ts

@@ -1,5 +1,6 @@
 import { Context } from "./context.js";
 import { event } from "./observable.js";
+import { Caught } from "./caught.js";
 
 //#region src/state.d.ts
 /** Internal state assigned to states. */
@@ -52,6 +53,14 @@ declare namespace State {
      * observed and constructor args applied. May return a cleanup function.
      */
     after?(this: T, self: T): void | (() => void);
+    /**
+     * Receives a `Caught` mvc reports for this State or a subclass - most-derived
+     * class first, last registered first. Return it (or a replacement) to pass it
+     * on; return nothing to handle it; throw to let it escape uncaught. Passed off
+     * the end, a warning logs and anything else is thrown - to the writer for a
+     * destroyed write, else uncaught.
+     */
+    catch?(this: T, error: Caught): Caught | void;
   }
   /** Object overlay to override values and methods on a state. */
   type Assign<T> = Record<string, unknown> & { [K in Field<T>]?: T[K] extends ((...args: infer A) => infer R) ? (this: T, ...args: A) => R : T[K] };
@@ -208,7 +217,7 @@ declare abstract class State {
    * Properties which are not managed by this state will be ignored.
    *
    * @param assign - Object with properties to update.
-   * @param silent - If true, listeners will not be notified. If state is destroyed, will squash update without throwing.
+   * @param silent - If true, listeners will not be notified. If state is destroyed, drops the update without reporting it.
    * @returns Array of keys updated, syncronously contains keys updated immediately and may be resolved (to itself) when all updates are settled.
    */
   set(assign?: State.Assign<this>, silent?: boolean): State.Updated<this>;
@@ -332,9 +341,11 @@ declare function access(state: State, property: string, required?: boolean): any
  *
  * This is used internally to update properties, but can also be used to update properties which are not managed by state, or to update values without triggering setters.
  *
- * If `silent` is true, the update will not dispatch events and will return `false` instead of throwing if state is destroyed.
+ * A destroyed state reports the write - thrown to the writer unless a `catch` handler takes it - and returns `false`; `silent` skips both, and dispatch.
  */
 declare function update<T>(state: State, key: State.Event<T>, value: T, silent?: boolean, own?: boolean): boolean;
+/** Error thrown by a handler replaying in dispatch, attributed to the State which queued it. */
+declare function fault(err: unknown, owner?: object): void;
 /** Random alphanumberic of length 6; always starts with a letter. */
 declare function uid(): string;
 declare function unbind<T extends Function>(fn: T): T;
@@ -348,5 +359,5 @@ declare function unbind<T extends Function>(fn?: T): T | undefined;
 declare function parent(child: object): State | null | undefined;
 declare function parent(child: object, value: State | null): boolean;
 //#endregion
-export { PENDING, STORE, State, access, apply, children, compute, event, parent, uid, unbind, update };
+export { PENDING, STORE, State, access, apply, children, compute, event, fault, parent, uid, unbind, update };
 //# sourceMappingURL=state.d.ts.map