@expressive/mvc 0.81.0 → 0.83.0

package/README.md

@@ -26,7 +26,7 @@ npm install @expressive/mvc
 A `State` is a class whose fields are reactive - read to subscribe, assign to update. Getters are cached computed values.
 
 ```ts
-import { State } from '@expressive/mvc';
+import State from '@expressive/mvc';
 
 class Counter extends State {
   count = 0;
@@ -62,7 +62,7 @@ Field initializers that change how a property behaves:
 | `has()` | an owned reactive collection - an ordered list or a spawned pool |
 
 ```ts
-import { State, set, has, map } from '@expressive/mvc';
+import State, { set, has, map } from '@expressive/mvc';
 
 class Cart extends State {
   items = has<Item>();                      // reactive collection
@@ -92,7 +92,7 @@ timer.set(null);             // destroy - runs cleanup, freezes state
 States find each other through context, and compose by holding one another:
 
 ```ts
-import { State, get } from '@expressive/mvc';
+import State, { get } from '@expressive/mvc';
 
 class Session extends State {
   user = 'guest';

package/dist/component.d.ts

@@ -1,5 +1,5 @@
 import { State } from "./state.js";
-import { Host } from "./jsx-runtime.js";
+import { Host } from "./runtime.js";
 
 //#region src/component.d.ts
 type IfEquals<X, Y, A, B> = (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? A : B;

package/dist/component.js

@@ -7,6 +7,16 @@ const PENDING = /* @__PURE__ */ new WeakMap();
 /** Per-class composed content render. */
 const CHAIN = /* @__PURE__ */ new WeakMap();
 var Component = class extends State {
+	/**
+	* Content to display while this component or its children are suspended.
+	* Will cover suspense by pending properties in `this.render` as well.
+	* Can be set as a class property or overridden via the `fallback` JSX prop.
+	*
+	* Defaults to null - nothing will be rendered.
+	* Set `false` to opt out of having a boundary at all - suspension then
+	* bubbles to the nearest ancestor boundary.
+	*/
+	fallback = set(null);
 	constructor(props, ...rest) {
 		if (props == null) props = {};
 		const seen = {};
@@ -28,7 +38,6 @@ var Component = class extends State {
 				PENDING.delete(props);
 			}
 		]);
-		this.fallback = set(null);
 		if (copy) return copy;
 		PENDING.set(props, this);
 		this.props = props;

package/dist/component.js.map

@@ -1 +1 @@
-{"version":3,"file":"component.js","names":[],"sources":["../src/component.ts"],"sourcesContent":["import { Context } from './context';\nimport { set } from './field/set';\nimport { State, unbind } from './state';\n\nimport type { Host } from './jsx-runtime';\n\nconst PENDING = new WeakMap<object, Component>();\n\n/** Per-class composed content render. */\nconst CHAIN = new WeakMap<Function, Function>();\n\ntype IfEquals<X, Y, A, B> =\n  (<T>() => T extends X ? 1 : 2) extends\n  (<T>() => T extends Y ? 1 : 2) ? A : B;\n\n/** Keys of T which are settable (excludes get-only accessors and `readonly`). */\ntype Acceptable<T> = {\n  [P in keyof T]-?: IfEquals<\n    { [Q in P]: T[P] },\n    { -readonly [Q in P]: T[P] },\n    P, never\n  >;\n}[keyof T];\n\ndeclare namespace Component {\n  /**\n   * Host element type produced by `Component.render`. Delegates to the\n   * {@link Host} manifest on the jsx-runtime entry; falls back to `any`\n   * until an adapter augments it with `node`. `any` (not `unknown`) so an\n   * un-annotated `render` override in a host-agnostic package still emits a\n   * JSX-valid return - `any` is assignable to every host's node type, where\n   * `unknown` is assignable to none.\n   */\n  type Node = Host extends { node: infer T } ? T : any;\n\n  interface BaseProps<T extends Component> {\n    /**\n     * Callback for newly created instance. Only called once.\n     *\n     * Runs after props apply but **before** the `new()` lifecycle hook - so it\n     * may configure state that `new()` then observes. To react to a fully\n     * initialized instance instead, use `watch` or an effect.\n     */\n    is?: (instance: T) => void;\n\n    /**\n     * Fallback to show when suspended or in error recovery.\n     * Pass `false` to opt out of the component's own suspense boundary,\n     * letting suspension bubble to an ancestor.\n     */\n    fallback?: Component.Node;\n  }\n\n  type StateProps<T extends State> = {\n    [K in Exclude<keyof T, keyof Component> & Acceptable<T>]?: T[K];\n  };\n\n  type RenderProps<T> = [T] extends [(props: infer P) => any]\n    ? [keyof NonNullable<P>] extends [never]\n    ? { children?: Component.Node }\n    : NonNullable<P>\n    : { children?: Component.Node };\n\n  type Props<T extends Component> =\n    & StateProps<T>\n    & BaseProps<T>\n    & RenderProps<T['render']>;\n}\n\nclass Component extends State {\n  /**\n   * All JSX attributes passed to this component.\n   * Includes state-derived props, render props, and built-in props like `is` and `fallback`.\n   *\n   * Will incorperate extra props you declare as props parameter in `render` method.\n   */\n  declare readonly props: Component.Props<this>;\n\n  /** Stable identity used when this instance is rendered in a collection. */\n  declare readonly key: string;\n\n  /**\n   * Content to display while this component or its children are suspended.\n   * Will cover suspense by pending properties in `this.render` as well.\n   * Can be set as a class property or overridden via the `fallback` JSX prop.\n   *\n   * Defaults to null - nothing will be rendered.\n   * Set `false` to opt out of having a boundary at all - suspension then\n   * bubbles to the nearest ancestor boundary.\n   */\n  fallback: Component.Node = set(null);\n\n  constructor(props?: any, ...rest: any[]) {\n    if (props == null) props = {};\n\n    const seen = {} as Record<string, undefined>;\n    const copy = PENDING.get(props);\n\n    if (typeof props == 'object') merge(props);\n\n    function merge(props: {}) {\n      for (const k in props) seen[k] = undefined;\n      return { ...seen, ...props };\n    }\n\n    super(copy ? [] : [\n      props,\n      rest.filter((x) => !(x instanceof Context)),\n      () => {\n        props.is?.(this);\n        Object.defineProperty(this, 'props', { enumerable: false });\n        PENDING.delete(props);\n      }\n    ]);\n\n    if (copy) return copy;\n\n    PENDING.set(props, this);\n\n    this.props = props;\n    this.set('props', () => {\n      this.set(merge(this.props));\n    });\n\n    Object.defineProperty(this, 'render', {\n      writable: true,\n      configurable: true,\n      value: render(this)\n    });\n  }\n\n  /**\n   * Output for this component. Override to define custom JSX.\n   *\n   * Properties accessed via `this` are reactive and trigger a render when they\n   * change, in addition to props. Accepts an optional parameter to receive extra\n   * props from JSX, beyond those merged to state properties; declare its shape\n   * via `props = {} as { ... }`. Without a parameter (the default below),\n   * children pass through.\n   *\n   * The constructor installs a composed `render` per instance; the bootstrap\n   * `type` pass seals this and any override non-configurable, keeping it the\n   * content-render seam the chain reads.\n   */\n  render(props?: {}): Component.Node {\n    const { children } = (props || this.props) as { children?: Component.Node };\n    return children || null;\n  }\n\n  /**\n   * Called when a child component throws during render.\n   * While this is pending, `fallback` is displayed.\n   * When resolved, the error boundary resets and `render` is called again.\n   *\n   * Override to handle errors - set `this.fallback` for error-specific UI,\n   * await async recovery, or await user interaction before retrying. If you\n   * assign a fallback within catch, it will be reverted after resolved.\n   */\n  catch?(error: Error): Promise<void> | void;\n}\n\n/**\n * Default `key` accessor. The get/set pair keeps it off observed state.\n */\nObject.defineProperty(Component.prototype, 'key', {\n  configurable: true,\n  get() {\n    return String(this);\n  },\n  set(value) {\n    Object.defineProperty(this, 'key', { value });\n  }\n});\n\n/**\n * Seal each class's own `render` non-configurable at bootstrap so member\n * classification leaves it unbound - it stays the content-render seam the chain\n * reads (and which adapters like preact detect as the class-component marker).\n */\nComponent.on({\n  before(self) {\n    const key = Object.getOwnPropertyDescriptor(self, 'key');\n\n    if (key?.configurable)\n      Object.defineProperty(self, 'key', {\n        enumerable: false,\n        writable: false\n      });\n  },\n  type(type) {\n    const desc = Object.getOwnPropertyDescriptor(type.prototype, 'render');\n\n    if (desc && typeof desc.value == 'function')\n      Object.defineProperty(type.prototype, 'render', {\n        ...desc,\n        configurable: false\n      });\n  }\n});\n\n/**\n * Build (or fetch the cached) composed content render for an instance's class.\n * Walks the prototype chain for content renders strictly below Component - the\n * default render on Component.prototype is excluded and serves as the fallback\n * when a class authors none.\n */\nfunction render(target: Component) {\n  const cached = CHAIN.get(target.constructor);\n\n  if (cached) return cached;\n\n  let render: Function | undefined;\n  let proto = target;\n\n  while ((proto = Object.getPrototypeOf(proto)) !== Component.prototype) {\n    const desc = Object.getOwnPropertyDescriptor(proto, 'render');\n\n    if (desc) {\n      const layer = unbind(desc.get || desc.value);\n      render = render ? compose(layer, render) : layer;\n    }\n  }\n\n  if (!render)\n    render = Component.prototype.render;\n\n  CHAIN.set(target.constructor, render);\n\n  return render;\n}\n\n/** Wrap an outer render so it receives `inner` as a lazy `children` getter. */\nfunction compose(outer: Function, inner: Function): Function {\n  return function (this: Component, props?: {}) {\n    const self = this;\n    return outer.call(self, {\n      ...props,\n      get children() {\n        return inner.call(self, props);\n      }\n    });\n  };\n}\n\nexport { Component };\n"],"mappings":";;;;;AAMA,MAAM,0BAAU,IAAI,SAA4B;;AAGhD,MAAM,wBAAQ,IAAI,SAA6B;AA4D/C,IAAM,YAAN,cAAwB,MAAM;CAuB5B,YAAY,OAAa,GAAG,MAAa;AACvC,MAAI,SAAS,KAAM,SAAQ,EAAE;EAE7B,MAAM,OAAO,EAAE;EACf,MAAM,OAAO,QAAQ,IAAI,MAAM;AAE/B,MAAI,OAAO,SAAS,SAAU,OAAM,MAAM;EAE1C,SAAS,MAAM,OAAW;AACxB,QAAK,MAAM,KAAK,MAAO,MAAK,KAAK;AACjC,UAAO;IAAE,GAAG;IAAM,GAAG;IAAO;;AAG9B,QAAM,OAAO,EAAE,GAAG;GAChB;GACA,KAAK,QAAQ,MAAM,EAAE,aAAa,SAAS;SACrC;AACJ,UAAM,KAAK,KAAK;AAChB,WAAO,eAAe,MAAM,SAAS,EAAE,YAAY,OAAO,CAAC;AAC3D,YAAQ,OAAO,MAAM;;GAExB,CAAC;kBAvBuB,IAAI,KAAK;AAyBlC,MAAI,KAAM,QAAO;AAEjB,UAAQ,IAAI,OAAO,KAAK;AAExB,OAAK,QAAQ;AACb,OAAK,IAAI,eAAe;AACtB,QAAK,IAAI,MAAM,KAAK,MAAM,CAAC;IAC3B;AAEF,SAAO,eAAe,MAAM,UAAU;GACpC,UAAU;GACV,cAAc;GACd,OAAO,OAAO,KAAK;GACpB,CAAC;;;;;;;;;;;;;;;CAgBJ,OAAO,OAA4B;EACjC,MAAM,EAAE,aAAc,SAAS,KAAK;AACpC,SAAO,YAAY;;;;;;AAkBvB,OAAO,eAAe,UAAU,WAAW,OAAO;CAChD,cAAc;CACd,MAAM;AACJ,SAAO,OAAO,KAAK;;CAErB,IAAI,OAAO;AACT,SAAO,eAAe,MAAM,OAAO,EAAE,OAAO,CAAC;;CAEhD,CAAC;;;;;;AAOF,UAAU,GAAG;CACX,OAAO,MAAM;AAGX,MAFY,OAAO,yBAAyB,MAAM,MAAM,EAE/C,aACP,QAAO,eAAe,MAAM,OAAO;GACjC,YAAY;GACZ,UAAU;GACX,CAAC;;CAEN,KAAK,MAAM;EACT,MAAM,OAAO,OAAO,yBAAyB,KAAK,WAAW,SAAS;AAEtE,MAAI,QAAQ,OAAO,KAAK,SAAS,WAC/B,QAAO,eAAe,KAAK,WAAW,UAAU;GAC9C,GAAG;GACH,cAAc;GACf,CAAC;;CAEP,CAAC;;;;;;;AAQF,SAAS,OAAO,QAAmB;CACjC,MAAM,SAAS,MAAM,IAAI,OAAO,YAAY;AAE5C,KAAI,OAAQ,QAAO;CAEnB,IAAI;CACJ,IAAI,QAAQ;AAEZ,SAAQ,QAAQ,OAAO,eAAe,MAAM,MAAM,UAAU,WAAW;EACrE,MAAM,OAAO,OAAO,yBAAyB,OAAO,SAAS;AAE7D,MAAI,MAAM;GACR,MAAM,QAAQ,OAAO,KAAK,OAAO,KAAK,MAAM;AAC5C,YAAS,SAAS,QAAQ,OAAO,OAAO,GAAG;;;AAI/C,KAAI,CAAC,OACH,UAAS,UAAU,UAAU;AAE/B,OAAM,IAAI,OAAO,aAAa,OAAO;AAErC,QAAO;;;AAIT,SAAS,QAAQ,OAAiB,OAA2B;AAC3D,QAAO,SAA2B,OAAY;EAC5C,MAAM,OAAO;AACb,SAAO,MAAM,KAAK,MAAM;GACtB,GAAG;GACH,IAAI,WAAW;AACb,WAAO,MAAM,KAAK,MAAM,MAAM;;GAEjC,CAAC"}
+{"version":3,"file":"component.js","names":[],"sources":["../src/component.ts"],"sourcesContent":["import { Context } from './context';\nimport { set } from './field/set';\nimport { State, unbind } from './state';\n\nimport type { Host } from './runtime';\n\nconst PENDING = new WeakMap<object, Component>();\n\n/** Per-class composed content render. */\nconst CHAIN = new WeakMap<Function, Function>();\n\ntype IfEquals<X, Y, A, B> =\n  (<T>() => T extends X ? 1 : 2) extends\n  (<T>() => T extends Y ? 1 : 2) ? A : B;\n\n/** Keys of T which are settable (excludes get-only accessors and `readonly`). */\ntype Acceptable<T> = {\n  [P in keyof T]-?: IfEquals<\n    { [Q in P]: T[P] },\n    { -readonly [Q in P]: T[P] },\n    P, never\n  >;\n}[keyof T];\n\ndeclare namespace Component {\n  /**\n   * Host element type produced by `Component.render`. Delegates to the\n   * {@link Host} manifest on the jsx-runtime entry; falls back to `any`\n   * until an adapter augments it with `node`. `any` (not `unknown`) so an\n   * un-annotated `render` override in a host-agnostic package still emits a\n   * JSX-valid return - `any` is assignable to every host's node type, where\n   * `unknown` is assignable to none.\n   */\n  type Node = Host extends { node: infer T } ? T : any;\n\n  interface BaseProps<T extends Component> {\n    /**\n     * Callback for newly created instance. Only called once.\n     *\n     * Runs after props apply but **before** the `new()` lifecycle hook - so it\n     * may configure state that `new()` then observes. To react to a fully\n     * initialized instance instead, use `watch` or an effect.\n     */\n    is?: (instance: T) => void;\n\n    /**\n     * Fallback to show when suspended or in error recovery.\n     * Pass `false` to opt out of the component's own suspense boundary,\n     * letting suspension bubble to an ancestor.\n     */\n    fallback?: Component.Node;\n  }\n\n  type StateProps<T extends State> = {\n    [K in Exclude<keyof T, keyof Component> & Acceptable<T>]?: T[K];\n  };\n\n  type RenderProps<T> = [T] extends [(props: infer P) => any]\n    ? [keyof NonNullable<P>] extends [never]\n    ? { children?: Component.Node }\n    : NonNullable<P>\n    : { children?: Component.Node };\n\n  type Props<T extends Component> =\n    & StateProps<T>\n    & BaseProps<T>\n    & RenderProps<T['render']>;\n}\n\nclass Component extends State {\n  /**\n   * All JSX attributes passed to this component.\n   * Includes state-derived props, render props, and built-in props like `is` and `fallback`.\n   *\n   * Will incorperate extra props you declare as props parameter in `render` method.\n   */\n  declare readonly props: Component.Props<this>;\n\n  /** Stable identity used when this instance is rendered in a collection. */\n  declare readonly key: string;\n\n  /**\n   * Content to display while this component or its children are suspended.\n   * Will cover suspense by pending properties in `this.render` as well.\n   * Can be set as a class property or overridden via the `fallback` JSX prop.\n   *\n   * Defaults to null - nothing will be rendered.\n   * Set `false` to opt out of having a boundary at all - suspension then\n   * bubbles to the nearest ancestor boundary.\n   */\n  fallback: Component.Node = set(null);\n\n  constructor(props?: any, ...rest: any[]) {\n    if (props == null) props = {};\n\n    const seen = {} as Record<string, undefined>;\n    const copy = PENDING.get(props);\n\n    if (typeof props == 'object') merge(props);\n\n    function merge(props: {}) {\n      for (const k in props) seen[k] = undefined;\n      return { ...seen, ...props };\n    }\n\n    super(copy ? [] : [\n      props,\n      rest.filter((x) => !(x instanceof Context)),\n      () => {\n        props.is?.(this);\n        Object.defineProperty(this, 'props', { enumerable: false });\n        PENDING.delete(props);\n      }\n    ]);\n\n    if (copy) return copy;\n\n    PENDING.set(props, this);\n\n    this.props = props;\n    this.set('props', () => {\n      this.set(merge(this.props));\n    });\n\n    Object.defineProperty(this, 'render', {\n      writable: true,\n      configurable: true,\n      value: render(this)\n    });\n  }\n\n  /**\n   * Output for this component. Override to define custom JSX.\n   *\n   * Properties accessed via `this` are reactive and trigger a render when they\n   * change, in addition to props. Accepts an optional parameter to receive extra\n   * props from JSX, beyond those merged to state properties; declare its shape\n   * via `props = {} as { ... }`. Without a parameter (the default below),\n   * children pass through.\n   *\n   * The constructor installs a composed `render` per instance; the bootstrap\n   * `type` pass seals this and any override non-configurable, keeping it the\n   * content-render seam the chain reads.\n   */\n  render(props?: {}): Component.Node {\n    const { children } = (props || this.props) as { children?: Component.Node };\n    return children || null;\n  }\n\n  /**\n   * Called when a child component throws during render.\n   * While this is pending, `fallback` is displayed.\n   * When resolved, the error boundary resets and `render` is called again.\n   *\n   * Override to handle errors - set `this.fallback` for error-specific UI,\n   * await async recovery, or await user interaction before retrying. If you\n   * assign a fallback within catch, it will be reverted after resolved.\n   */\n  catch?(error: Error): Promise<void> | void;\n}\n\n/**\n * Default `key` accessor. The get/set pair keeps it off observed state.\n */\nObject.defineProperty(Component.prototype, 'key', {\n  configurable: true,\n  get() {\n    return String(this);\n  },\n  set(value) {\n    Object.defineProperty(this, 'key', { value });\n  }\n});\n\n/**\n * Seal each class's own `render` non-configurable at bootstrap so member\n * classification leaves it unbound - it stays the content-render seam the chain\n * reads (and which adapters like preact detect as the class-component marker).\n */\nComponent.on({\n  before(self) {\n    const key = Object.getOwnPropertyDescriptor(self, 'key');\n\n    if (key?.configurable)\n      Object.defineProperty(self, 'key', {\n        enumerable: false,\n        writable: false\n      });\n  },\n  type(type) {\n    const desc = Object.getOwnPropertyDescriptor(type.prototype, 'render');\n\n    if (desc && typeof desc.value == 'function')\n      Object.defineProperty(type.prototype, 'render', {\n        ...desc,\n        configurable: false\n      });\n  }\n});\n\n/**\n * Build (or fetch the cached) composed content render for an instance's class.\n * Walks the prototype chain for content renders strictly below Component - the\n * default render on Component.prototype is excluded and serves as the fallback\n * when a class authors none.\n */\nfunction render(target: Component) {\n  const cached = CHAIN.get(target.constructor);\n\n  if (cached) return cached;\n\n  let render: Function | undefined;\n  let proto = target;\n\n  while ((proto = Object.getPrototypeOf(proto)) !== Component.prototype) {\n    const desc = Object.getOwnPropertyDescriptor(proto, 'render');\n\n    if (desc) {\n      const layer = unbind(desc.get || desc.value);\n      render = render ? compose(layer, render) : layer;\n    }\n  }\n\n  if (!render)\n    render = Component.prototype.render;\n\n  CHAIN.set(target.constructor, render);\n\n  return render;\n}\n\n/** Wrap an outer render so it receives `inner` as a lazy `children` getter. */\nfunction compose(outer: Function, inner: Function): Function {\n  return function (this: Component, props?: {}) {\n    const self = this;\n    return outer.call(self, {\n      ...props,\n      get children() {\n        return inner.call(self, props);\n      }\n    });\n  };\n}\n\nexport { Component };\n"],"mappings":";;;;;AAMA,MAAM,0BAAU,IAAI,SAA4B;;AAGhD,MAAM,wBAAQ,IAAI,SAA6B;AA4D/C,IAAM,YAAN,cAAwB,MAAM;;;;;;;;;;CAqB5B,WAA2B,IAAI,KAAK;CAEpC,YAAY,OAAa,GAAG,MAAa;AACvC,MAAI,SAAS,KAAM,SAAQ,EAAE;EAE7B,MAAM,OAAO,EAAE;EACf,MAAM,OAAO,QAAQ,IAAI,MAAM;AAE/B,MAAI,OAAO,SAAS,SAAU,OAAM,MAAM;EAE1C,SAAS,MAAM,OAAW;AACxB,QAAK,MAAM,KAAK,MAAO,MAAK,KAAK;AACjC,UAAO;IAAE,GAAG;IAAM,GAAG;IAAO;;AAG9B,QAAM,OAAO,EAAE,GAAG;GAChB;GACA,KAAK,QAAQ,MAAM,EAAE,aAAa,SAAS;SACrC;AACJ,UAAM,KAAK,KAAK;AAChB,WAAO,eAAe,MAAM,SAAS,EAAE,YAAY,OAAO,CAAC;AAC3D,YAAQ,OAAO,MAAM;;GAExB,CAAC;AAEF,MAAI,KAAM,QAAO;AAEjB,UAAQ,IAAI,OAAO,KAAK;AAExB,OAAK,QAAQ;AACb,OAAK,IAAI,eAAe;AACtB,QAAK,IAAI,MAAM,KAAK,MAAM,CAAC;IAC3B;AAEF,SAAO,eAAe,MAAM,UAAU;GACpC,UAAU;GACV,cAAc;GACd,OAAO,OAAO,KAAK;GACpB,CAAC;;;;;;;;;;;;;;;CAgBJ,OAAO,OAA4B;EACjC,MAAM,EAAE,aAAc,SAAS,KAAK;AACpC,SAAO,YAAY;;;;;;AAkBvB,OAAO,eAAe,UAAU,WAAW,OAAO;CAChD,cAAc;CACd,MAAM;AACJ,SAAO,OAAO,KAAK;;CAErB,IAAI,OAAO;AACT,SAAO,eAAe,MAAM,OAAO,EAAE,OAAO,CAAC;;CAEhD,CAAC;;;;;;AAOF,UAAU,GAAG;CACX,OAAO,MAAM;AAGX,MAFY,OAAO,yBAAyB,MAAM,MAAM,EAE/C,aACP,QAAO,eAAe,MAAM,OAAO;GACjC,YAAY;GACZ,UAAU;GACX,CAAC;;CAEN,KAAK,MAAM;EACT,MAAM,OAAO,OAAO,yBAAyB,KAAK,WAAW,SAAS;AAEtE,MAAI,QAAQ,OAAO,KAAK,SAAS,WAC/B,QAAO,eAAe,KAAK,WAAW,UAAU;GAC9C,GAAG;GACH,cAAc;GACf,CAAC;;CAEP,CAAC;;;;;;;AAQF,SAAS,OAAO,QAAmB;CACjC,MAAM,SAAS,MAAM,IAAI,OAAO,YAAY;AAE5C,KAAI,OAAQ,QAAO;CAEnB,IAAI;CACJ,IAAI,QAAQ;AAEZ,SAAQ,QAAQ,OAAO,eAAe,MAAM,MAAM,UAAU,WAAW;EACrE,MAAM,OAAO,OAAO,yBAAyB,OAAO,SAAS;AAE7D,MAAI,MAAM;GACR,MAAM,QAAQ,OAAO,KAAK,OAAO,KAAK,MAAM;AAC5C,YAAS,SAAS,QAAQ,OAAO,OAAO,GAAG;;;AAI/C,KAAI,CAAC,OACH,UAAS,UAAU,UAAU;AAE/B,OAAM,IAAI,OAAO,aAAa,OAAO;AAErC,QAAO;;;AAIT,SAAS,QAAQ,OAAiB,OAA2B;AAC3D,QAAO,SAA2B,OAAY;EAC5C,MAAM,OAAO;AACb,SAAO,MAAM,KAAK,MAAM;GACtB,GAAG;GACH,IAAI,WAAW;AACb,WAAO,MAAM,KAAK,MAAM,MAAM;;GAEjC,CAAC"}

package/dist/context.d.ts

@@ -34,9 +34,12 @@ declare class Context {
    * Context will add or remove States as needed to keep with provided input.
    *
    * @param inputs State, State class, or map of States / State classes to register.
-   * @param forEach Optional callback to run for each State registered.
+   * @param forEach Optional callback to run for each State registered. Receives
+   *   whether this context created the State - and so will destroy it - as
+   *   opposed to it having been provided already active. May return a callback
+   *   to run before that entry is dropped.
    */
-  set<T extends State>(inputs: Accept<T>, forEach?: (state: T) => (() => void) | void): this;
+  set<T extends State>(inputs: Accept<T>, forEach?: (state: T, owned: boolean) => (() => void) | void): this;
   add(I: State, explicit?: boolean): () => void;
   /**
    * Create a child context, optionally registering one or more States to it.

package/dist/context.js

@@ -12,13 +12,14 @@ var Context = class Context {
 	static get(state) {
 		return state && LOOKUP.get(state.is) || Context.root;
 	}
+	id = uid();
+	parent;
+	scope = /* @__PURE__ */ new Set();
+	consume = /* @__PURE__ */ new Map();
+	provide = /* @__PURE__ */ new Map();
+	inputs = {};
+	cleanup = /* @__PURE__ */ new Map();
 	constructor(arg) {
-		this.id = uid();
-		this.scope = /* @__PURE__ */ new Set();
-		this.consume = /* @__PURE__ */ new Map();
-		this.provide = /* @__PURE__ */ new Map();
-		this.inputs = {};
-		this.cleanup = /* @__PURE__ */ new Map();
 		if (arg instanceof Context) {
 			this.parent = arg;
 			arg.scope.add(this);
@@ -81,7 +82,10 @@ var Context = class Context {
 	* Context will add or remove States as needed to keep with provided input.
 	*
 	* @param inputs State, State class, or map of States / State classes to register.
-	* @param forEach Optional callback to run for each State registered.
+	* @param forEach Optional callback to run for each State registered. Receives
+	*   whether this context created the State - and so will destroy it - as
+	*   opposed to it having been provided already active. May return a callback
+	*   to run before that entry is dropped.
 	*/
 	set(inputs, forEach) {
 		const init = /* @__PURE__ */ new Set();
@@ -99,19 +103,20 @@ var Context = class Context {
 				cleanup.delete(K);
 			}
 			if (!V) continue;
-			if (!(State.is(V) || V instanceof State)) {
+			const owned = State.is(V);
+			if (!(owned || V instanceof State)) {
 				const as = K == "0" || K == String(V) ? V : `${V} (as '${K}')`;
 				throw new Error(`Context can only include an instance or class of State but got ${as}.`);
 			}
-			const state = State.is(V) ? new V() : V.is;
+			const state = owned ? new V() : V.is;
 			const remove = this.add(state, true);
 			init.add(() => {
 				event(state);
-				const dispose = forEach && forEach(state);
+				const dispose = forEach?.(state, owned);
 				cleanup.set(K, () => {
-					if (dispose) dispose();
+					if (typeof dispose == "function") dispose();
 					remove();
-					if (State.is(V)) event(state, null);
+					if (owned) event(state, null);
 				});
 			});
 		}
@@ -126,7 +131,12 @@ var Context = class Context {
 		function conflict(T) {
 			const entries = provide.get(T);
 			if (entries) {
-				for (const entry of entries) if (!entry[1] && entry[0] !== I) return entries.delete(entry);
+				for (const entry of entries) if (!entry[1] && entry[0] !== I) {
+					const type = I.constructor;
+					const g = type.global;
+					if (entry[0].constructor === type && (typeof g == "function" ? g(I) : g)) throw new Error(`Cannot register ${I} as a global - ${entry[0]} already exists in root. Destroy the existing instance first, or provide additional ones via explicit context.`);
+					return entries.delete(entry);
+				}
 			}
 		}
 		for (let T = I.constructor; T !== State; T = Object.getPrototypeOf(T)) if (explicit || !root || !conflict(T)) TT.push(T);

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { listener } from \"./observable\";\nimport { event, State, uid } from \"./state\";\n\nconst LOOKUP = new WeakMap<State, Context>();\nlet ROOT: Context;\n\ntype Accept<T extends State = State> =\n  | T\n  | State.Type<T>\n  | Record<string | number, T | State.Type<T>>;\n\ntype Expect<T extends State = State> = (\n  state: T,\n  downstream: boolean,\n) => (() => void) | void;\n\ndeclare namespace Context {\n  export { Accept, Expect };\n}\n\nclass Context {\n  static get root(): Context {\n    return ROOT ??= new Context();\n  }\n\n  /** Get the context for a State. Adapters may override to provide framework context. */\n  static get(state?: State): Context {\n    return state && LOOKUP.get(state.is) || Context.root;\n  }\n\n  public id = uid();\n  public parent?: Context;\n  public scope = new Set<Context>();\n  public consume = new Map<\n    State.Extends,\n    Set<[Expect, boolean | undefined]> | null\n  >();\n  public provide = new Map<State.Extends, Set<[State, boolean]> | null>();\n\n  protected inputs: Record<string | number, State | State.Extends> = {};\n\n  private cleanup = new Map<string | number | Function, () => void>();\n\n  constructor(arg?: Context | Accept) {\n    if (arg instanceof Context) {\n      this.parent = arg;\n      arg.scope.add(this);\n    } else if (arg) {\n      this.set(arg);\n    }\n  }\n\n  private traverse(accept: (ctx: Context) => boolean | void) {\n    const queue = [...this.scope];\n    for (const ctx of queue)\n      if (accept(ctx) !== false) for (const c of ctx.scope) queue.push(c);\n  }\n\n  private register<T extends State>(\n    type: State.Extends<T>,\n    value: [Expect<T>, boolean | undefined],\n    asConsumer: true,\n  ): () => void;\n\n  private register<T extends State>(\n    type: State.Extends<T>,\n    value: [T, boolean],\n    asConsumer?: false,\n  ): () => void;\n\n  private register(type: State.Extends, value: any, asConsumer?: boolean) {\n    const mode = asConsumer ? \"consume\" : \"provide\";\n    let set = this[mode].get(type) as Set<any>;\n    if (!set) this[mode].set(type, (set = new Set()));\n    set.add(value);\n\n    for (let ctx = this.parent; ctx; ctx = ctx.parent) {\n      if (ctx[mode].has(type)) break;\n      ctx[mode].set(type, null);\n    }\n\n    return () => set.delete(value);\n  }\n\n  /** Find specified type upstream. Throws if not found. */\n  public get<T extends State>(Type: State.Extends<T>, required?: true): T;\n\n  /** Find specified type upstream. Returns undefined if not found. */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    required?: boolean,\n  ): T | undefined;\n\n  /** Subscribe to a type becoming available in context. */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    callback: Expect<T>,\n    downstream?: boolean,\n  ): () => void;\n\n  /** Lookup excluding a specific instance (used by State.prototype.get for upstream-of-self semantics). */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    arg: boolean | Expect<T> | undefined,\n    downstream: boolean | undefined,\n    skip: State,\n  ): T | undefined | (() => void);\n\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    arg?: boolean | Expect<T>,\n    downstream?: boolean,\n    skip?: State,\n  ) {\n    let found: T | null | undefined;\n    let priority = false;\n\n    for (let ctx: Context | undefined = this; ctx; ctx = ctx.parent) {\n      const entries = ctx.provide.get(Type);\n      if (!entries) continue;\n\n      for (const [state, explicit] of entries) {\n        if (state === skip || found === state) continue;\n        if (!found || (explicit && !priority)) {\n          found = state as T;\n          priority = explicit;\n          continue;\n        }\n        if (!priority) {\n          found = null;\n          break;\n        }\n        if (explicit)\n          throw new Error(\n            `Did find ${Type} in context, but multiple were defined.`,\n          );\n      }\n      if (found !== undefined) break;\n    }\n\n    if (typeof arg === \"function\") {\n      if (found && !downstream) arg(found, false);\n\n      if (downstream !== false) {\n        this.traverse((ctx) => {\n          const has = ctx.provide.get(Type);\n          if (has) for (const x of has) if (x[0] !== skip) arg(x[0] as T, true);\n          return has !== undefined;\n        });\n      }\n\n      return this.register(Type, [arg as Expect, downstream], true);\n    }\n\n    if (found) return found;\n    if (found === null) return null;\n    if (arg !== false) throw new Error(`Could not find ${Type} in context.`);\n  }\n\n  /**\n   * Register one or more States to this context.\n   *\n   * Context will add or remove States as needed to keep with provided input.\n   *\n   * @param inputs State, State class, or map of States / State classes to register.\n   * @param forEach Optional callback to run for each State registered.\n   */\n  public set<T extends State>(\n    inputs: Accept<T>,\n    forEach?: (state: T) => (() => void) | void,\n  ) {\n    const init = new Set<() => void>();\n    const { cleanup } = this;\n\n    if (typeof inputs == \"function\" || inputs instanceof State)\n      inputs = { [0]: inputs };\n\n    for (const K of Object.keys({ ...this.inputs, ...inputs })) {\n      const V = inputs[K];\n      const E = this.inputs[K];\n\n      if (E === V) continue;\n\n      if (E) {\n        cleanup.get(K)?.();\n        cleanup.delete(K);\n      }\n\n      if (!V) continue;\n\n      if (!(State.is(V) || V instanceof State)) {\n        const as = K == \"0\" || K == String(V) ? V : `${V} (as '${K}')`;\n        throw new Error(\n          `Context can only include an instance or class of State but got ${as}.`,\n        );\n      }\n\n      const state = State.is(V) ? new (V as State.Type)() : V.is;\n      const remove = this.add(state, true);\n\n      init.add(() => {\n        event(state);\n        const dispose = forEach && forEach(state as T);\n        cleanup.set(K, () => {\n          if (dispose) dispose();\n          remove();\n          if (State.is(V)) event(state, null);\n        });\n      });\n    }\n\n    for (const i of init) i();\n\n    this.inputs = inputs;\n\n    return this;\n  }\n\n  add(I: State, explicit = false) {\n    const { cleanup, provide } = this;\n    const root = this === Context.root;\n    const TT: State.Extends[] = [];\n\n    function conflict(T: State.Extends) {\n      const entries = provide.get(T);\n      if (entries)\n        for (const entry of entries)\n          if (!entry[1] && entry[0] !== I)\n            return entries.delete(entry);\n    }\n\n    for (\n      let T = I.constructor as State.Extends;\n      T !== State;\n      T = Object.getPrototypeOf(T)\n    )\n      if (explicit || !root || !conflict(T)) TT.push(T);\n\n    const expects = new Map<Expect, () => void>();\n    const onDone = new Set<() => void>();\n\n    for (const T of TT) onDone.add(this.register(T, [I, explicit]));\n\n    function queue(ctx: Context, downstream: boolean) {\n      let found = false;\n      for (const T of TT) {\n        const list = ctx.consume.get(T);\n        if (list !== undefined) found = true;\n        if (list)\n          for (const [cb, filter] of list)\n            if (filter === downstream || filter == null)\n              expects.set(cb, () => {\n                const r = cb(I, downstream);\n                if (r) onDone.add(r);\n              });\n      }\n      return found;\n    }\n\n    for (let ctx: Context | undefined = this; ctx; ctx = ctx.parent) queue(ctx, true);\n    this.traverse((ctx) => queue(ctx, false));\n\n    if (!LOOKUP.has(I)) LOOKUP.set(I, this);\n\n    listener(I, () => {\n      expects.forEach((f) => f());\n      expects.clear();\n      return null;\n    });\n\n    function flush() {\n      onDone.forEach((r) => r());\n      onDone.clear();\n    }\n\n    function remove() {\n      cleanup.delete(remove);\n      flush();\n    }\n\n    cleanup.set(remove, remove);\n\n    return remove;\n  }\n\n  /**\n   * Create a child context, optionally registering one or more States to it.\n   *\n   * @param inputs State, State class, or map of States / State classes to register.\n   */\n  public push(inputs?: Accept) {\n    const next = new Context(this);\n    if (inputs) next.set(inputs);\n    return next;\n  }\n\n  /**\n   * Remove all States from this context.\n   *\n   * Will also run any cleanup callbacks registered when States were added.\n   */\n  public pop() {\n    this.inputs = {};\n    this.scope.forEach((x) => x.pop());\n    this.scope.clear();\n    this.cleanup.forEach((cb) => cb());\n    this.cleanup.clear();\n    this.consume.clear();\n    this.provide.clear();\n    if (this.parent) {\n      this.parent.scope.delete(this);\n    }\n  }\n}\n\nObject.defineProperty(Context.prototype, \"toString\", {\n  value() {\n    return `Context-${this.id}`;\n  },\n});\n\nexport { Context };\n"],"mappings":"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"}
+{"version":3,"file":"context.js","names":[],"sources":["../src/context.ts"],"sourcesContent":["import { listener } from \"./observable\";\nimport { event, State, uid } from \"./state\";\n\nconst LOOKUP = new WeakMap<State, Context>();\nlet ROOT: Context;\n\ntype Accept<T extends State = State> =\n  | T\n  | State.Type<T>\n  | Record<string | number, T | State.Type<T>>;\n\ntype Expect<T extends State = State> = (\n  state: T,\n  downstream: boolean,\n) => (() => void) | void;\n\ndeclare namespace Context {\n  export { Accept, Expect };\n}\n\nclass Context {\n  static get root(): Context {\n    return ROOT ??= new Context();\n  }\n\n  /** Get the context for a State. Adapters may override to provide framework context. */\n  static get(state?: State): Context {\n    return state && LOOKUP.get(state.is) || Context.root;\n  }\n\n  public id = uid();\n  public parent?: Context;\n  public scope = new Set<Context>();\n  public consume = new Map<\n    State.Extends,\n    Set<[Expect, boolean | undefined]> | null\n  >();\n  public provide = new Map<State.Extends, Set<[State, boolean]> | null>();\n\n  protected inputs: Record<string | number, State | State.Extends> = {};\n\n  private cleanup = new Map<string | number | Function, () => void>();\n\n  constructor(arg?: Context | Accept) {\n    if (arg instanceof Context) {\n      this.parent = arg;\n      arg.scope.add(this);\n    } else if (arg) {\n      this.set(arg);\n    }\n  }\n\n  private traverse(accept: (ctx: Context) => boolean | void) {\n    const queue = [...this.scope];\n    for (const ctx of queue)\n      if (accept(ctx) !== false) for (const c of ctx.scope) queue.push(c);\n  }\n\n  private register<T extends State>(\n    type: State.Extends<T>,\n    value: [Expect<T>, boolean | undefined],\n    asConsumer: true,\n  ): () => void;\n\n  private register<T extends State>(\n    type: State.Extends<T>,\n    value: [T, boolean],\n    asConsumer?: false,\n  ): () => void;\n\n  private register(type: State.Extends, value: any, asConsumer?: boolean) {\n    const mode = asConsumer ? \"consume\" : \"provide\";\n    let set = this[mode].get(type) as Set<any>;\n    if (!set) this[mode].set(type, (set = new Set()));\n    set.add(value);\n\n    for (let ctx = this.parent; ctx; ctx = ctx.parent) {\n      if (ctx[mode].has(type)) break;\n      ctx[mode].set(type, null);\n    }\n\n    return () => set.delete(value);\n  }\n\n  /** Find specified type upstream. Throws if not found. */\n  public get<T extends State>(Type: State.Extends<T>, required?: true): T;\n\n  /** Find specified type upstream. Returns undefined if not found. */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    required?: boolean,\n  ): T | undefined;\n\n  /** Subscribe to a type becoming available in context. */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    callback: Expect<T>,\n    downstream?: boolean,\n  ): () => void;\n\n  /** Lookup excluding a specific instance (used by State.prototype.get for upstream-of-self semantics). */\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    arg: boolean | Expect<T> | undefined,\n    downstream: boolean | undefined,\n    skip: State,\n  ): T | undefined | (() => void);\n\n  public get<T extends State>(\n    Type: State.Extends<T>,\n    arg?: boolean | Expect<T>,\n    downstream?: boolean,\n    skip?: State,\n  ) {\n    let found: T | null | undefined;\n    let priority = false;\n\n    for (let ctx: Context | undefined = this; ctx; ctx = ctx.parent) {\n      const entries = ctx.provide.get(Type);\n      if (!entries) continue;\n\n      for (const [state, explicit] of entries) {\n        if (state === skip || found === state) continue;\n        if (!found || (explicit && !priority)) {\n          found = state as T;\n          priority = explicit;\n          continue;\n        }\n        if (!priority) {\n          found = null;\n          break;\n        }\n        if (explicit)\n          throw new Error(\n            `Did find ${Type} in context, but multiple were defined.`,\n          );\n      }\n      if (found !== undefined) break;\n    }\n\n    if (typeof arg === \"function\") {\n      if (found && !downstream) arg(found, false);\n\n      if (downstream !== false) {\n        this.traverse((ctx) => {\n          const has = ctx.provide.get(Type);\n          if (has) for (const x of has) if (x[0] !== skip) arg(x[0] as T, true);\n          return has !== undefined;\n        });\n      }\n\n      return this.register(Type, [arg as Expect, downstream], true);\n    }\n\n    if (found) return found;\n    if (found === null) return null;\n    if (arg !== false) throw new Error(`Could not find ${Type} in context.`);\n  }\n\n  /**\n   * Register one or more States to this context.\n   *\n   * Context will add or remove States as needed to keep with provided input.\n   *\n   * @param inputs State, State class, or map of States / State classes to register.\n   * @param forEach Optional callback to run for each State registered. Receives\n   *   whether this context created the State - and so will destroy it - as\n   *   opposed to it having been provided already active. May return a callback\n   *   to run before that entry is dropped.\n   */\n  public set<T extends State>(\n    inputs: Accept<T>,\n    forEach?: (state: T, owned: boolean) => (() => void) | void,\n  ) {\n    const init = new Set<() => void>();\n    const { cleanup } = this;\n\n    if (typeof inputs == \"function\" || inputs instanceof State)\n      inputs = { [0]: inputs };\n\n    for (const K of Object.keys({ ...this.inputs, ...inputs })) {\n      const V = inputs[K];\n      const E = this.inputs[K];\n\n      if (E === V) continue;\n\n      if (E) {\n        cleanup.get(K)?.();\n        cleanup.delete(K);\n      }\n\n      if (!V) continue;\n\n      // a class is constructed here - and so destroyed here; an instance is\n      // adopted as-is and outlives this context\n      const owned = State.is(V);\n\n      if (!(owned || V instanceof State)) {\n        const as = K == \"0\" || K == String(V) ? V : `${V} (as '${K}')`;\n        throw new Error(\n          `Context can only include an instance or class of State but got ${as}.`,\n        );\n      }\n\n      const state = owned ? new (V as State.Type)() : V.is;\n      const remove = this.add(state, true);\n\n      init.add(() => {\n        event(state);\n        const dispose = forEach?.(state as T, owned);\n        cleanup.set(K, () => {\n          if (typeof dispose == \"function\") dispose();\n          remove();\n          if (owned) event(state, null);\n        });\n      });\n    }\n\n    for (const i of init) i();\n\n    this.inputs = inputs;\n\n    return this;\n  }\n\n  add(I: State, explicit = false) {\n    const { cleanup, provide } = this;\n    const root = this === Context.root;\n    const TT: State.Extends[] = [];\n\n    function conflict(T: State.Extends) {\n      const entries = provide.get(T);\n      if (entries)\n        for (const entry of entries)\n          if (!entry[1] && entry[0] !== I) {\n            const type = I.constructor as State.Extends;\n            const g = type.global;\n\n            if (entry[0].constructor === type && (typeof g == 'function' ? g(I) : g))\n              throw new Error(\n                `Cannot register ${I} as a global - ${entry[0]} already exists in root. Destroy the existing instance first, or provide additional ones via explicit context.`\n              );\n\n            return entries.delete(entry);\n          }\n    }\n\n    for (\n      let T = I.constructor as State.Extends;\n      T !== State;\n      T = Object.getPrototypeOf(T)\n    )\n      if (explicit || !root || !conflict(T)) TT.push(T);\n\n    const expects = new Map<Expect, () => void>();\n    const onDone = new Set<() => void>();\n\n    for (const T of TT) onDone.add(this.register(T, [I, explicit]));\n\n    function queue(ctx: Context, downstream: boolean) {\n      let found = false;\n      for (const T of TT) {\n        const list = ctx.consume.get(T);\n        if (list !== undefined) found = true;\n        if (list)\n          for (const [cb, filter] of list)\n            if (filter === downstream || filter == null)\n              expects.set(cb, () => {\n                const r = cb(I, downstream);\n                if (r) onDone.add(r);\n              });\n      }\n      return found;\n    }\n\n    for (let ctx: Context | undefined = this; ctx; ctx = ctx.parent) queue(ctx, true);\n    this.traverse((ctx) => queue(ctx, false));\n\n    if (!LOOKUP.has(I)) LOOKUP.set(I, this);\n\n    listener(I, () => {\n      expects.forEach((f) => f());\n      expects.clear();\n      return null;\n    });\n\n    function flush() {\n      onDone.forEach((r) => r());\n      onDone.clear();\n    }\n\n    function remove() {\n      cleanup.delete(remove);\n      flush();\n    }\n\n    cleanup.set(remove, remove);\n\n    return remove;\n  }\n\n  /**\n   * Create a child context, optionally registering one or more States to it.\n   *\n   * @param inputs State, State class, or map of States / State classes to register.\n   */\n  public push(inputs?: Accept) {\n    const next = new Context(this);\n    if (inputs) next.set(inputs);\n    return next;\n  }\n\n  /**\n   * Remove all States from this context.\n   *\n   * Will also run any cleanup callbacks registered when States were added.\n   */\n  public pop() {\n    this.inputs = {};\n    this.scope.forEach((x) => x.pop());\n    this.scope.clear();\n    this.cleanup.forEach((cb) => cb());\n    this.cleanup.clear();\n    this.consume.clear();\n    this.provide.clear();\n    if (this.parent) {\n      this.parent.scope.delete(this);\n    }\n  }\n}\n\nObject.defineProperty(Context.prototype, \"toString\", {\n  value() {\n    return `Context-${this.id}`;\n  },\n});\n\nexport { Context };\n"],"mappings":"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"}

package/dist/dispatch.d.ts

@@ -0,0 +1,8 @@
+//#region src/dispatch.d.ts
+type Handler = () => void;
+type Transition = (work: Handler) => void;
+declare function enqueue(handler: Handler): void;
+declare function schedule(work: Handler, transition?: Transition): void;
+//#endregion
+export { enqueue, schedule };
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.js

@@ -0,0 +1,37 @@
+//#region src/dispatch.ts
+const DISPATCH = /* @__PURE__ */ new Map();
+let active;
+function execute(work, transition) {
+	if (!transition) return work();
+	const parent = active;
+	active = transition;
+	try {
+		transition(work);
+	} finally {
+		active = parent;
+	}
+}
+function enqueue(handler) {
+	if (!DISPATCH.size) queueMicrotask(() => {
+		for (const [handler, scheduled] of DISPATCH) {
+			DISPATCH.delete(handler);
+			try {
+				execute(handler, scheduled.transition);
+			} catch (err) {
+				console.error(err);
+			}
+		}
+	});
+	const scheduled = DISPATCH.get(handler);
+	if (scheduled) {
+		if (!active) scheduled.transition = void 0;
+	} else DISPATCH.set(handler, { transition: active });
+}
+function schedule(work, transition) {
+	if (!transition || transition === active) return work();
+	execute(work, transition);
+}
+
+//#endregion
+export { enqueue, schedule };
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","names":[],"sources":["../src/dispatch.ts"],"sourcesContent":["type Handler = () => void;\ntype Transition = (work: Handler) => void;\n\ninterface Scheduled {\n  transition?: Transition;\n}\n\nconst DISPATCH = new Map<Handler, Scheduled>();\nlet active: Transition | undefined;\n\nfunction execute(work: Handler, transition?: Transition) {\n  if (!transition) return work();\n\n  const parent = active;\n  active = transition;\n\n  try {\n    transition(work);\n  } finally {\n    active = parent;\n  }\n}\n\nfunction enqueue(handler: Handler) {\n  if (!DISPATCH.size)\n    queueMicrotask(() => {\n      for (const [handler, scheduled] of DISPATCH) {\n        DISPATCH.delete(handler);\n\n        try {\n          execute(handler, scheduled.transition);\n        } catch (err) {\n          console.error(err);\n        }\n      }\n    });\n\n  const scheduled = DISPATCH.get(handler);\n\n  if (scheduled) {\n    if (!active) scheduled.transition = undefined;\n  } else {\n    DISPATCH.set(handler, { transition: active });\n  }\n}\n\nfunction schedule(work: Handler, transition?: Transition) {\n  if (!transition || transition === active) return work();\n  execute(work, transition);\n}\n\nexport { enqueue, schedule };\n"],"mappings":";AAOA,MAAM,2BAAW,IAAI,KAAyB;AAC9C,IAAI;AAEJ,SAAS,QAAQ,MAAe,YAAyB;AACvD,KAAI,CAAC,WAAY,QAAO,MAAM;CAE9B,MAAM,SAAS;AACf,UAAS;AAET,KAAI;AACF,aAAW,KAAK;WACR;AACR,WAAS;;;AAIb,SAAS,QAAQ,SAAkB;AACjC,KAAI,CAAC,SAAS,KACZ,sBAAqB;AACnB,OAAK,MAAM,CAAC,SAAS,cAAc,UAAU;AAC3C,YAAS,OAAO,QAAQ;AAExB,OAAI;AACF,YAAQ,SAAS,UAAU,WAAW;YAC/B,KAAK;AACZ,YAAQ,MAAM,IAAI;;;GAGtB;CAEJ,MAAM,YAAY,SAAS,IAAI,QAAQ;AAEvC,KAAI,WACF;MAAI,CAAC,OAAQ,WAAU,aAAa;OAEpC,UAAS,IAAI,SAAS,EAAE,YAAY,QAAQ,CAAC;;AAIjD,SAAS,SAAS,MAAe,YAAyB;AACxD,KAAI,CAAC,cAAc,eAAe,OAAQ,QAAO,MAAM;AACvD,SAAQ,MAAM,WAAW"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { Context } from "./context.js";
 import { State, unbind } from "./state.js";
+import { transition } from "./runtime.js";
 import { Component } from "./component.js";
 import { def } from "./field/def.js";
 import { get } from "./field/get.js";
@@ -7,4 +8,4 @@ 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, unbind };
+export { Component, Context, State, def, State as default, get, has, map, ref, set, transition, unbind };

package/dist/index.js

@@ -7,5 +7,6 @@ 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, unbind };
+export { Component, Context, State, def, State as default, get, has, map, ref, set, transition, unbind };

package/dist/jsx-dev-runtime.d.ts

@@ -1,2 +1,3 @@
-import { Fragment, JSX, jsxDEV } from "./jsx-runtime.js";
+import { Fragment, jsxDEV } from "./runtime.js";
+import { JSX } from "./jsx-runtime.js";
 export { Fragment, type JSX, jsxDEV };

package/dist/jsx-dev-runtime.js

@@ -1,3 +1,3 @@
-import { Fragment, jsxDEV } from "./jsx-runtime.js";
+import { Fragment, jsxDEV } from "./runtime.js";
 
 export { Fragment, jsxDEV };

package/dist/jsx-runtime.d.ts

@@ -1,40 +1,7 @@
+import { Fragment, Host, jsx, jsxs } from "./runtime.js";
 import { Component } from "./component.js";
 
 //#region src/jsx-runtime.d.ts
-/**
- * Per-adapter interpretation manifest. Each adapter augments this interface to
- * declare how it renders; the first member is `node` - the element type produced
- * by `Component.render` (surfaced as `Component.Node`) - alongside `intrinsics`,
- * the host's tag map (surfaced as `JSX.IntrinsicElements`).
- *
- * ```ts
- * declare module '@expressive/mvc/jsx-runtime' {
- *   interface Host {
- *     node: React.ReactNode;
- *     intrinsics: React.JSX.IntrinsicElements;
- *   }
- * }
- * ```
- *
- * Only one adapter is expected per compilation; two augmenting the same member
- * with different types in the same build would conflict - by design.
- */
-interface Host {}
-/**
- * Host JSX runtime, registered by an adapter (e.g. `@expressive/react`) as an
- * import side effect. One host per build - a second registration with a
- * different runtime throws.
- */
-interface HostRuntime {
-  childrenOf(children: unknown): Component.Node[];
-  isElement(node: unknown): boolean;
-  jsx(type: unknown, props: object, key?: unknown): Component.Node;
-  jsxDEV?(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;
-  jsxs(type: unknown, props: object, key?: unknown): Component.Node;
-  propsOf(node: unknown): Record<string, unknown>;
-  typeOf(node: unknown): unknown;
-  Fragment: unknown;
-}
 declare namespace JSX {
   type Element = Component.Node;
   type ElementType = keyof IntrinsicElements | ((props: any) => Component.Node) | (abstract new (...args: any[]) => ElementClass);
@@ -64,27 +31,6 @@ declare namespace JSX {
     intrinsics: infer T extends object;
   } ? T : {};
 }
-/**
- * Agnostic Fragment sentinel. The runtime entries translate it to the host's
- * Fragment on element creation; `typeOf` translates back, so identity checks
- * against this value hold for fragments from either pragma.
- */
-declare const Fragment: unique symbol;
-/** Register the host JSX runtime. Idempotent for the same runtime. */
-declare function host(runtime: HostRuntime): void;
-declare function jsx(type: unknown, props: object, key?: unknown): Component.Node;
-declare function jsxs(type: unknown, props: object, key?: unknown): Component.Node;
-/** Dev-transpiled element creation. Falls back to the production runtime when
- * the host registered no `jsxDEV` (prod-only host under a dev build). */
-declare function jsxDEV(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;
-/** Flatten `children` to an array of nodes, per the host's semantics. */
-declare function childrenOf(children: unknown): Component.Node[];
-/** Is `node` a host element? */
-declare function isElement(node: unknown): boolean;
-/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */
-declare function typeOf(node: unknown): unknown;
-/** Props carried by element `node`. */
-declare function propsOf(node: unknown): Record<string, unknown>;
 //#endregion
-export { Fragment, Host, HostRuntime, JSX, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
+export { Fragment, JSX, jsx, jsxs };
 //# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/jsx-runtime.js

@@ -1,57 +1,3 @@
-//#region src/jsx-runtime.ts
-/**
-* Agnostic Fragment sentinel. The runtime entries translate it to the host's
-* Fragment on element creation; `typeOf` translates back, so identity checks
-* against this value hold for fragments from either pragma.
-*/
-const Fragment = Symbol.for("@expressive/mvc.Fragment");
-let HOST;
-/** Register the host JSX runtime. Idempotent for the same runtime. */
-function host(runtime) {
-	if (HOST && HOST !== runtime) throw new Error("A different JSX host is already registered for @expressive/mvc. Only one host adapter may be active per build.");
-	HOST = runtime;
-}
-/** Current host runtime; throws a setup-pointing error when none registered. */
-function resolved() {
-	if (HOST) return HOST;
-	throw new Error("No JSX host is registered for @expressive/mvc. Import a host adapter (e.g. '@expressive/react') before anything renders - typically as the first import of your application entry module.");
-}
-/** Translate the agnostic Fragment sentinel to the host's Fragment. */
-function hostType(type) {
-	return type === Fragment ? resolved().Fragment : type;
-}
-function jsx(type, props, key) {
-	return resolved().jsx(hostType(type), props, key);
-}
-function jsxs(type, props, key) {
-	return resolved().jsxs(hostType(type), props, key);
-}
-/** Dev-transpiled element creation. Falls back to the production runtime when
-* the host registered no `jsxDEV` (prod-only host under a dev build). */
-function jsxDEV(type, props, key, isStatic, source, self) {
-	const runtime = resolved();
-	const resolvedType = hostType(type);
-	return runtime.jsxDEV ? runtime.jsxDEV(resolvedType, props, key, isStatic, source, self) : isStatic ? runtime.jsxs(resolvedType, props, key) : runtime.jsx(resolvedType, props, key);
-}
-/** Flatten `children` to an array of nodes, per the host's semantics. */
-function childrenOf(children) {
-	return resolved().childrenOf(children);
-}
-/** Is `node` a host element? */
-function isElement(node) {
-	return resolved().isElement(node);
-}
-/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */
-function typeOf(node) {
-	const { typeOf, Fragment: hosted } = resolved();
-	const type = typeOf(node);
-	return type === hosted ? Fragment : type;
-}
-/** Props carried by element `node`. */
-function propsOf(node) {
-	return resolved().propsOf(node);
-}
+import { Fragment, jsx, jsxs } from "./runtime.js";
 
-//#endregion
-export { Fragment, childrenOf, host, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
-//# sourceMappingURL=jsx-runtime.js.map
+export { Fragment, jsx, jsxs };

package/dist/observable.js

@@ -1,8 +1,8 @@
+import { enqueue } from "./dispatch.js";
+
 //#region src/observable.ts
 const Observer = Symbol("Observer");
 const Observing = Symbol("Observing");
-/** Central event dispatch. Bunches all updates to occur at same time. */
-const DISPATCH = /* @__PURE__ */ new Set();
 function observer(state, create) {
 	const o = state[Observer];
 	if (!o && create) {
@@ -98,33 +98,26 @@ function emit(o, key) {
 	else if (key === true) o.ready = true;
 	pending.clear();
 }
-function enqueue(eventHandler) {
-	if (!DISPATCH.size) queueMicrotask(() => {
-		for (const event of DISPATCH) {
-			DISPATCH.delete(event);
-			try {
-				event();
-			} catch (err) {
-				console.error(err);
-			}
-		}
-	});
-	DISPATCH.add(eventHandler);
-}
 function watch(target, callback, argument) {
 	const o = observer(target, true);
 	let events = [];
 	let unset;
 	let reset;
 	let previous;
+	let queued = false;
 	function invoke() {
 		if (observer(target) === null) return;
+		queued = false;
 		let ignore = true;
 		function onUpdate() {
 			events = [...o.events];
 			if (reset === null) return null;
-			if (ignore) return;
+			if (ignore) {
+				if (queued) enqueue(invoke);
+				return;
+			}
 			ignore = true;
+			queued = true;
 			unset(true);
 			unset = void 0;
 			enqueue(invoke);

package/dist/observable.js.map

@@ -1 +1 @@
-{"version":3,"file":"observable.js","names":[],"sources":["../src/observable.ts"],"sourcesContent":["declare 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\n/** Central event dispatch. Bunches all updates to occur at same time. */\nconst DISPATCH = new Set<() => void>();\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('Object is not observable (terminated).');\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  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    (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) 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\nfunction enqueue(eventHandler: () => void) {\n  if (!DISPATCH.size)\n    queueMicrotask(() => {\n      for (const event of DISPATCH) {\n        DISPATCH.delete(event);\n        try {\n          event();\n        } catch (err) {\n          console.error(err);\n        }\n      }\n    });\n\n  DISPATCH.add(eventHandler);\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\n  function invoke() {\n    if (observer(target) === null) return;\n\n    let ignore: boolean = true;\n\n    function onUpdate() {\n      events = [...o.events];\n\n      if (reset === null) return null;\n      if (ignore) return;\n\n      ignore = 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 (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 } 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('Object is not observable (terminated).');\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  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    (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) 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 (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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"}

package/dist/runtime.d.ts

@@ -0,0 +1,80 @@
+import { Component } from "./component.js";
+
+//#region src/runtime.d.ts
+/**
+ * Per-adapter interpretation manifest. Each adapter augments this interface to
+ * declare how it renders; the first member is `node` - the element type produced
+ * by `Component.render` (surfaced as `Component.Node`) - alongside `intrinsics`,
+ * the host's tag map (surfaced as `JSX.IntrinsicElements`).
+ *
+ * ```ts
+ * declare module '@expressive/mvc/runtime' {
+ *   interface Host {
+ *     node: React.ReactNode;
+ *     intrinsics: React.JSX.IntrinsicElements;
+ *   }
+ * }
+ * ```
+ *
+ * Only one adapter is expected per compilation; two augmenting the same member
+ * with different types in the same build would conflict - by design.
+ */
+interface Host {}
+/**
+ * Host runtime, registered by an adapter (e.g. `@expressive/react`) as an
+ * import side effect. One host per build - a second registration with a
+ * different runtime throws.
+ *
+ * Members are ambient host capabilities: plain functions the host uniquely
+ * owns, callable outside render - element mechanics always, plus optional
+ * extras that fall back sanely when absent. Hook-shaped (render-resident)
+ * capabilities do not belong here; those live with the adapter.
+ */
+interface HostRuntime {
+  childrenOf(children: unknown): Component.Node[];
+  isElement(node: unknown): boolean;
+  jsx(type: unknown, props: object, key?: unknown): Component.Node;
+  jsxDEV?(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;
+  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;
+}
+/**
+ * Agnostic Fragment sentinel. The runtime entries translate it to the host's
+ * Fragment on element creation; `typeOf` translates back, so identity checks
+ * against this value hold for fragments from either pragma.
+ */
+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.
+ */
+declare function host(runtime: HostRuntime): void;
+declare function jsx(type: unknown, props: object, key?: unknown): Component.Node;
+declare function jsxs(type: unknown, props: object, key?: unknown): Component.Node;
+/** Dev-transpiled element creation. Hosts without a `jsxDEV` of their own fall
+ * back to the production entries (prod-only host under a dev build). */
+declare function jsxDEV(type: unknown, props: object, key?: unknown, isStatic?: boolean, source?: object, self?: unknown): Component.Node;
+/** Flatten `children` to an array of nodes, per the host's semantics. */
+declare function childrenOf(children: unknown): Component.Node[];
+/** Is `node` a host element? */
+declare function isElement(node: unknown): boolean;
+/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */
+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 };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -0,0 +1,79 @@
+import { schedule } from "./dispatch.js";
+
+//#region src/runtime.ts
+/**
+* Agnostic Fragment sentinel. The runtime entries translate it to the host's
+* Fragment on element creation; `typeOf` translates back, so identity checks
+* against this value hold for fragments from either pragma.
+*/
+const Fragment = Symbol.for("@expressive/mvc.Fragment");
+/** Default for seams only a registered host can provide. */
+function absent() {
+	throw new Error("No JSX host is registered for @expressive/mvc. Import a host adapter (e.g. '@expressive/react') before anything renders - typically as the first import of your application entry module.");
+}
+const HOST = {
+	childrenOf: absent,
+	isElement: absent,
+	jsx: absent,
+	jsxs: absent,
+	propsOf: absent,
+	typeOf: absent,
+	Fragment
+};
+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.
+*/
+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.");
+	registered = runtime;
+	Object.assign(HOST, runtime);
+}
+/** Translate the agnostic Fragment sentinel to the host's Fragment. */
+function hostType(type) {
+	return type === Fragment ? HOST.Fragment : type;
+}
+function jsx(type, props, key) {
+	return HOST.jsx(hostType(type), props, key);
+}
+function jsxs(type, props, key) {
+	return HOST.jsxs(hostType(type), props, key);
+}
+/** Dev-transpiled element creation. Hosts without a `jsxDEV` of their own fall
+* back to the production entries (prod-only host under a dev build). */
+function jsxDEV(type, props, key, isStatic, source, self) {
+	return HOST.jsxDEV ? HOST.jsxDEV(hostType(type), props, key, isStatic, source, self) : isStatic ? jsxs(type, props, key) : jsx(type, props, key);
+}
+/** Flatten `children` to an array of nodes, per the host's semantics. */
+function childrenOf(children) {
+	return HOST.childrenOf(children);
+}
+/** Is `node` a host element? */
+function isElement(node) {
+	return HOST.isElement(node);
+}
+/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */
+function typeOf(node) {
+	const type = HOST.typeOf(node);
+	return type === HOST.Fragment ? Fragment : type;
+}
+/** Props carried by element `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 };
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +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"}

package/dist/state.d.ts

@@ -11,6 +11,15 @@ declare namespace State {
   type Type<T extends State = State> = (new (...args: State.Args<T>) => T) & Omit<typeof State, never>;
   /** State constructor arguments */
   type Args<T extends State = any> = (Args<T> | Init<T> | Assign<T> | void)[];
+  /**
+   * Value of `static global`. A boolean opts a State in or out of the
+   * process-global root; a resolver decides at activation, receiving the
+   * instance and returning whether it registers - use it to make the choice
+   * conditional (e.g. per environment). A bare literal (`= true` / `= false`)
+   * seals the choice for subclasses; widen a subclass's `static global` type to
+   * `State.Global` to permit a resolver or a later override.
+   */
+  type Global<T extends State = any> = boolean | ((self: T) => boolean);
   /**
    * State constructor callback - runs during activation, in argument order,
    * before the `new()` lifecycle hook (so it may configure state `new()`
@@ -103,6 +112,18 @@ declare namespace State {
   type Updated<T extends State> = readonly Event<T>[] & PromiseLike<readonly Event<T>[]>;
 }
 declare abstract class State {
+  /**
+   * Whether an instance activated with no enclosing context registers itself
+   * to the process-global root, where `get()` can resolve it from anywhere.
+   * `false` (the default) keeps a context-less instance fully functional but
+   * private - not injectable, though it can still read declared globals. Opt in
+   * with `static readonly global = true`; a resolver (see {@link State.Global})
+   * makes the choice conditional. It must be declared per class - a subclass
+   * that would inherit a global without its own declaration throws on
+   * activation, so an accidental global (a forgotten `Provider`, an extended
+   * global) cannot leak into the shared root.
+   */
+  static readonly global: State.Global;
   /**
    * Loopback to instance of this state. This is useful when in a subscribed context,
    * to keep write access to `this` after a destructure. You can use it to read variables silently as well.

package/dist/state.js

@@ -20,6 +20,18 @@ const GETTERS = /* @__PURE__ */ new WeakMap();
 /** Stale flags for compute closures awaiting refresh on next access. */
 const STALE = /* @__PURE__ */ new WeakSet();
 var State = class State {
+	/**
+	* Whether an instance activated with no enclosing context registers itself
+	* to the process-global root, where `get()` can resolve it from anywhere.
+	* `false` (the default) keeps a context-less instance fully functional but
+	* private - not injectable, though it can still read declared globals. Opt in
+	* with `static readonly global = true`; a resolver (see {@link State.Global})
+	* makes the choice conditional. It must be declared per class - a subclass
+	* that would inherit a global without its own declaration throws on
+	* activation, so an accidental global (a forgotten `Provider`, an extended
+	* global) cannot leak into the shared root.
+	*/
+	static global = false;
 	constructor(...args) {
 		define(this, "is", { value: this });
 		init(this, args, this.new);
@@ -117,7 +129,12 @@ function init(state, ...args) {
 		}
 	}
 	function register() {
-		if (Context.get(state) === Context.root) return Context.root.add(state);
+		if (Context.get(state) !== Context.root) return;
+		const type = state.constructor;
+		const g = type.global;
+		if (!(typeof g == "function" ? g(state) : g)) return;
+		if (!Object.prototype.hasOwnProperty.call(type, "global")) throw new Error(`${state} would register as a global by inheritance alone - re-declare \`static global\` on ${type.name} (\`true\` to keep it, \`false\` to opt out).`);
+		return Context.root.add(state);
 	}
 	listener(state, () => {
 		parent(state, null);

package/dist/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","names":[],"sources":["../src/state.ts"],"sourcesContent":["import { Context } from './context';\nimport {\n  event,\n  listener,\n  Observer,\n  observer,\n  pending,\n  touch,\n  watch\n} from './observable';\n\nconst define = Object.defineProperty;\n\n/** Register for all active states via string identifiers (usually unique). */\nconst ID = new WeakMap<State, string>();\n\n/** Internal state assigned to states. */\nconst STORE = new WeakMap<State, Record<string | number | symbol, unknown>>();\n\n/** External lifecycle listeners for any given State class. */\nconst SETUP = new WeakMap<State.Extends, Set<State.Init<any> | State.On<any>>>();\n\n/** Parent-child relationships. */\nconst PARENT = new WeakMap<object, State | null>();\n\n/** Reference bound instance methods, or their getter, to real one. */\nconst UNBIND = new WeakMap<any, any>();\n\n/** List of methods defined by a given type. */\nconst METHODS = new WeakMap<Function, Map<string, (value: any) => void>>();\n\n/** List of reactive getters defined by a given type. */\nconst GETTERS = new WeakMap<Function, Map<string, () => unknown>>();\n\n/** Stale flags for compute closures awaiting refresh on next access. */\nconst STALE = new WeakSet<() => void>();\n\ndeclare namespace State {\n  /** Any type of State, using own class constructor as its identifier. */\n  type Extends<T extends State = State> = (abstract new (...args: any[]) => T) &\n    typeof State;\n\n  /** A State constructor which may be instanciated. */\n  type Type<T extends State = State> = (new (...args: State.Args<T>) => T) &\n    Omit<typeof State, never>;\n\n  /** State constructor arguments */\n  type Args<T extends State = any> = (Args<T> | Init<T> | Assign<T> | void)[];\n\n  /**\n   * State constructor callback - runs during activation, in argument order,\n   * before the `new()` lifecycle hook (so it may configure state `new()`\n   * will observe). Returned function will run when state is destroyed.\n   */\n  type Init<T extends State = State> = (\n    this: T,\n    thisArg: T\n  ) => Promise<void> | (() => void) | Args<T> | Assign<T> | void;\n\n  /**\n   * Lifecycle handlers for `State.on`, keyed by when they run. A bare `Init`\n   * function passed to `on` is sugar for `{ before }`.\n   */\n  interface On<T extends State = State> {\n    /**\n     * Per-class setup, run once when the class is first bootstrapped - before\n     * its members are classified and bound. Receives the class, so a handler\n     * may inspect or reshape the prototype first. A handler registered on a\n     * base class runs for each subclass too.\n     */\n    type?(type: State.Extends<T>): void;\n\n    /**\n     * Per-instance setup, run in the `prepare` phase before `observe` and the\n     * `new()` hook. Equivalent to passing a bare function to `on`. May return a\n     * cleanup, constructor args, or an assign overlay.\n     */\n    before?(this: T, thisArg: T): void | (() => void) | Promise<void> | Args<T> | Assign<T>;\n\n    /**\n     * Per-instance setup, run at the `new()` slot - after own values are\n     * observed and constructor args applied. May return a cleanup function.\n     */\n    after?(this: T, self: T): void | (() => void);\n  }\n\n  /** Object overlay to override values and methods on a state. */\n  type Assign<T> = Record<string, unknown> & {\n    [K in Field<T>]?: T[K] extends (...args: infer A) => infer R\n    ? (this: T, ...args: A) => R\n    : T[K];\n  };\n\n  /** Subset of `keyof T` not defined by base State. **/\n  type Field<T> = Exclude<keyof T, keyof State>;\n\n  /** Any valid key for state, including but not limited to Field<T>. */\n  type Event<T = State> = Field<T> | number | symbol | (string & {});\n\n  /** Any event signal dispatched to listeners, including lifecycle meta events. */\n  type Signal<T = State> = Event<T> | true | false | null;\n\n  /** Export/Import compatible value for a given property in a State. */\n  type Export<R> = R extends State\n    ? Values<R>\n    : R extends { get(): infer T }\n    ? T\n    : R;\n\n  /**\n   * Values from current state of given state.\n   * Differs from `Values` as values here will drill\n   * into \"real\" values held by exotics like ref.Object.\n   */\n  type Values<T> = { [P in Field<T>]: Export<T[P]> };\n\n  /** Object comperable to data found in T. */\n  type Partial<T> = { [P in Field<T>]?: Export<T[P]> };\n\n  /** Value for a property applied by a state. */\n  type Value<T extends State, K extends State.Event<T>> = K extends keyof T\n    ? Export<T[K]>\n    : unknown;\n\n  type Setter<T> = (value: T, previous: T) => T | void;\n\n  /** Descriptor config for a managed property. */\n  type Apply<T = any> = {\n    value?: T;\n    get?: ((source: State) => T) | boolean;\n    set?: Setter<T> | boolean;\n    enumerable?: boolean;\n    // destroy?: () => void;\n  };\n\n  /** Descriptor config for set() overload - enforces type when key is a known field. */\n  type Define<T, K> = K extends Field<T> ? Apply<T[K] | Export<T[K]>> : Apply;\n\n  type OnEvent<T extends State> = (\n    this: T,\n    key: Signal<T>,\n    source: T\n  ) => void | (() => void) | null;\n\n  /** Exotic value, where actual value is contained within. */\n  type Ref<T = any> = {\n    (next: T): void;\n    current: T | null;\n  };\n\n  /**\n   * A callback function which is subscribed to parent and updates when accessed properties change.\n   *\n   * @param current - Current state of this state. This is a proxy which detects properties which\n   * where accessed, and thus depended upon to stay current.\n   *\n   * @param update - Set of properties which have changed, and events fired, since last update.\n   *\n   * @returns A callback function which will be called when this effect is stale.\n   */\n  type Effect<T> = (\n    this: T,\n    current: T,\n    update: readonly State.Event<T>[] | undefined\n  ) => EffectCallback | Promise<void> | null | void;\n\n  /**\n   * A callback function returned by effect. Will be called when effect is stale.\n   *\n   * @param update - `true` if update is pending, `false` effect has been cancelled, `null` if state is destroyed.\n   */\n  type EffectCallback = (update: boolean | null) => void;\n\n  /**\n   * A list of keys updated, or events fired, since last update.\n   * This may be awaited to get full list (same array) when update is settled.\n   */\n  type Updated<T extends State> = readonly Event<T>[] &\n    PromiseLike<readonly Event<T>[]>;\n}\n\nabstract class State {\n  /**\n   * Loopback to instance of this state. This is useful when in a subscribed context,\n   * to keep write access to `this` after a destructure. You can use it to read variables silently as well.\n   **/\n  declare is: this;\n\n  constructor(...args: State.Args) {\n    define(this, 'is', { value: this });\n    init(this, args, this.new);\n  }\n\n  /**\n   * Optional lifecycle hook called during State initialization.\n   * Can return a cleanup function to run when state is destroyed.\n   *\n   * It is recommended you protect this method.\n   */\n  protected new?(): void | (() => void);\n\n  /**\n   * Pull current values from state. Flattens all states and exotic values recursively.\n   *\n   * @returns Object with all values from this state.\n   **/\n  get(): State.Values<this>;\n\n  /**\n   * Run a function to run automatically when accessed values change.\n   *\n   * @param effect Function to run, and whenever accessed values change.\n   *               If effect returns a function, it will be called when a change occurs (syncronously),\n   *               effect is cancelled, or parent state is destroyed.\n   * @returns Function to cancel listener.\n   */\n  get(effect: State.Effect<this>): () => void;\n\n  /**\n   * Get value of a property. Will fetch underlying value from exotic values like ref.Object.\n   *\n   * Any value which implements `get()` (with no arguments) will be treated as such.\n   *\n   * @param key - Property to get value of.\n   * @param required - If true, will throw an error if property is not available.\n   * @returns Value of property.\n   */\n  get<T extends State.Event<this>>(\n    key: T,\n    required?: boolean\n  ): State.Value<this, T>;\n\n  /**\n   * Check if state is destroyed.\n   *\n   * @param status - `null` to check if state is destroyed.\n   * @returns `true` if state is destroyed, `false` otherwise.\n   */\n  get(status: null): boolean;\n\n  /**\n   * Callback when state is to be destroyed.\n   *\n   * @param callback - Function to call when state is destroyed.\n   * @returns Function to cancel listener.\n   */\n  get(status: null, callback: () => void): () => void;\n\n  /** Fetch State of type from context. Throws if not found. */\n  get<T extends State>(type: State.Type<T>, required?: true): T;\n\n  /** Fetch a State from context. Undefined if not found. */\n  get<T extends State>(type: State.Type<T>, required: boolean): T | undefined;\n\n  /**\n   * Subscribe to State becoming available in context.\n   *\n   * Will search both up and downstream by default.\n   * Normally you can ignore this because State you expect is rarely both.\n   *\n   * Specify downstream if you only want to watch for State in children, which can be useful if you expect multiple of the same State in different branches of the tree.\n   *\n   * @param type - Type of State to watch for.\n   * @param callback - Function to call when State is found. Will be called immediately if State is already available.\n   * @param downstream - If true, will only watch for State in children, if false will only for parents.\n   * @returns Function to cancel listener.\n   */\n  get<T extends State>(\n    type: State.Type<T>,\n    callback: Context.Expect<T>,\n    downstream?: boolean\n  ): () => void;\n\n  get(\n    arg1?: State.Effect<this> | State.Type | string | null,\n    arg2?: boolean | Context.Expect | (() => void),\n    arg3?: boolean\n  ) {\n    const self = this.is;\n\n    if (arg1 === undefined) return values(self);\n    if (State.is(arg1)) return Context.get(self).get(arg1, arg2, arg3, self);\n    if (typeof arg1 == 'function') return watch(self, unbind(arg1));\n    if (typeof arg2 == 'function') return callback(self, arg2, arg1);\n    if (arg1 === null) return observer(self) === null;\n    return access(self, arg1, arg2);\n  }\n\n  /**\n   * Get update in progress.\n   *\n   * @returns Promise which resolves object with updated values, `undefined` if there no update is pending.\n   **/\n  set(): State.Updated<this>;\n\n  /**\n   * Merge argument with current state, updating one or more properties at once.\n   * Properties which are not managed by this state will be ignored.\n   *\n   * @param assign - Object with properties to update.\n   * @param silent - If true, listeners will not be notified. If state is destroyed, will squash update without throwing.\n   * @returns Array of keys updated, syncronously contains keys updated immediately and may be resolved (to itself) when all updates are settled.\n   */\n  set(assign?: State.Assign<this>, silent?: boolean): State.Updated<this>;\n\n  /**\n   * Call a function when update occurs.\n   *\n   * Given function is called for every assignment (which changes value) or explicit `set`.\n   *\n   * To run logic on final value only, callback may return a function. The same\n   * function for one or more events will be called only once when update is settled.\n   *\n   * Return `null` from callback to stop listening.\n   *\n   * @param callback - Function to call when update occurs.\n   * @returns Function to remove listener. Will return `true` if removed, `false` if inactive already.\n   */\n  set(callback: State.OnEvent<this>): () => boolean;\n\n  /**\n   * Push an update. This will not change the value of associated property.\n   *\n   * Useful where a property value internally has changed, but the object is the same.\n   * For example: An array has pushed a new value, or a nested property is updated.\n   *\n   * You can also use this to dispatch arbitrary events.\n   * Symbols are recommended as non-property events, however you can use any string.\n   * If doing so, be sure to avoid collisions using property names. An easy way to do this is\n   * to prefix an event with \"!\" and/or use dash-case. e.g. `set(\"!event\")` or `set(\"my-event\")`.\n   *\n   * @param key - Property or event to dispatch.\n   * @returns Promise resolves an array of keys updated.\n   */\n  set(key: State.Event<this>): State.Updated<this>;\n\n  /**\n   * Declare an end to updates. This event is final and will freeze state.\n   * This event can be watched for as well, to run cleanup logic and internally will remove all listeners.\n   *\n   * @param status - `null` to end updates.\n   */\n  set(status: null): void;\n\n  /**\n   * Register a callback for a specific property or event.\n   *\n   * Callback receives the key, current value, and source instance.\n   *\n   * @param event - Property or event to watch. If `null`, will callback on destroy.\n   * @param callback - Function to call when event occurs.\n   * @returns Function to remove listener.\n   */\n  set<K extends State.Event<this>>(\n    event: K | null,\n    callback: State.OnEvent<this>\n  ): () => boolean;\n\n  /**\n   * Define or update a managed property using a descriptor config.\n   * If the property already is managed, config will only accept value.\n   * If the property does not exist, it will be created and made reactive.\n   *\n   * @param key - Property to define or update.\n   * @param config - Descriptor config with value, get, set, enumerable, and/or destroy.\n   * @returns Promise resolves an array of keys updated.\n   */\n  set<K extends State.Event<this>>(\n    key: K,\n    config: State.Define<this, K>\n  ): State.Updated<this>;\n\n  set(\n    arg1?: State.OnEvent<this> | State.Assign<this> | State.Event<this> | null,\n    arg2?: unknown\n  ) {\n    const self = this.is;\n\n    if (typeof arg1 == 'function')\n      return listener(self, (key) => {\n        if (\n          typeof key == 'string' ||\n          typeof key == 'number' ||\n          typeof key == 'symbol'\n        )\n          return arg1.call(self, key, self);\n      });\n\n    if (typeof arg2 == 'function')\n      return callback(self, arg2, arg1 as State.Signal);\n\n    if (arg1 && typeof arg1 == 'object') assign(self, arg1, arg2 === true);\n    else if (arg2) apply(self, arg1 as string, arg2);\n    else event(self, arg1);\n\n    return pending(self) as State.Updated<this>;\n  }\n\n  /**\n   * Iterate over managed properties in this instance of State.\n   * Yeilds the key and current value for each property.\n   */\n  [Symbol.iterator](): Iterator<[string, unknown]> {\n    return Object.entries(STORE.get(this.is)!)[Symbol.iterator]();\n  }\n\n  /**\n   * Create and activate a new instance of this state.\n   *\n   * **Important** - Unlike `new this(...)` - this method also activates state.\n   *\n   * @param args - arguments sent to constructor\n   */\n  static new<T extends State>(this: State.Type<T>, ...args: State.Args<T>): T {\n    const instance = new this(...args);\n    event(instance);\n    return instance;\n  }\n\n  /**\n   * Static equivalent of `x instanceof this`.\n   * Determines if provided class is a subtype of this one.\n   * If so, language server will make available all static\n   * methods and properties of this class.\n   */\n  static is<T extends State.Extends>(this: T, maybe: unknown): maybe is T {\n    return (\n      maybe === this ||\n      (typeof maybe == 'function' && maybe.prototype instanceof this)\n    );\n  }\n\n  /**\n   * Register a lifecycle handler for this State and its subclasses.\n   *\n   * A bare function is per-instance setup run in the `prepare` phase (sugar for\n   * `{ before }`); if it returns a function, that runs when the instance is\n   * destroyed. Pass a {@link State.On} object to hook by cadence - `type`\n   * (per-class, at bootstrap), `before` (per-instance, before `new()`), and\n   * `after` (per-instance, at the `new()` slot).\n   *\n   * @returns Function to remove the handler.\n   */\n  static on<T extends State>(\n    this: State.Extends<T>,\n    handler: State.Init<T> | State.On<T>\n  ) {\n    let setup = SETUP.get(this);\n\n    if (!setup) SETUP.set(this, (setup = new Set()));\n\n    setup.add(handler);\n\n    return () => setup.delete(handler);\n  }\n}\n\ndefine(State.prototype, 'toString', {\n  value() {\n    return ID.get(this.is);\n  }\n});\n\ndefine(State, 'toString', {\n  value() {\n    return this.name;\n  }\n});\n\n/** Register a user OnEvent callback, preserving `this` and `source`. */\nfunction callback<T extends State>(\n  self: T,\n  cb: Function,\n  select?: Observer.Signal | Set<Observer.Signal>\n) {\n  return listener(self, (key) => cb.call(self, key, self), select);\n}\n\n/**\n * Apply state arguemnts, run callbacks and observe properties.\n * Accumulate and handle cleanup events.\n **/\nfunction init(state: State, ...args: State.Args) {\n  const T = state.constructor as State.Extends;\n\n  if (T === State) throw new Error('Cannot create base State.');\n\n  const { before, after } = bootstrap(T);\n\n  ID.set(state, `${T}-${uid()}`);\n  STORE.set(state, {});\n\n  function observe() {\n    for (const key in state) {\n      const desc = Object.getOwnPropertyDescriptor(state, key)!;\n      if ('value' in desc && desc.configurable) apply(state, key, desc, true);\n    }\n  }\n\n  function register() {\n    if (Context.get(state) === Context.root) return Context.root.add(state);\n  }\n\n  listener(state, () => {\n    parent(state, null);\n\n    const queue = [...before, observe, ...args, ...after, register];\n\n    for (let i = 0; i < queue.length; i++) {\n      const arg = queue[i];\n      const out = typeof arg == 'function' ? arg.call(state, state) : arg;\n\n      if (out instanceof Promise)\n        out.catch((err) => {\n          console.error(`Async error in constructor for ${state}:`);\n          console.error(err);\n        });\n      else if (Array.isArray(out)) queue.splice(i + 1, 0, ...out);\n      else if (typeof out == 'function') listener(state, out, null);\n      else if (typeof out == 'object') assign(state, out, true);\n    }\n\n    return null;\n  });\n}\n\n/**\n * Apply instructions and inherited event listeners. Ensure class metadata is ready.\n *\n * @param T - State class to bootstrap.\n * @return Array of init functions to run on instance, in order of class hierarchy.\n */\nfunction bootstrap(T: State.Extends) {\n  const chain = [] as State.Extends[];\n  const before = new Set<State.Init>();\n  const after = new Set<State.Init>();\n  const onType = new Set<NonNullable<State.On['type']>>();\n  let keys = new Map<string, (value: any) => void>();\n  let getters = new Map<string, () => unknown>();\n\n  do {\n    chain.unshift(T);\n    T = Object.getPrototypeOf(T);\n  } while (T.name);\n\n  for (const type of chain) {\n    for (const handler of SETUP.get(type) || [])\n      if (typeof handler == 'function') before.add(handler);\n      else {\n        if (handler.before) before.add(handler.before);\n        if (handler.after) after.add(handler.after);\n        if (handler.type) onType.add(handler.type);\n      }\n\n    if (type === State) continue;\n\n    if (METHODS.has(type)) {\n      keys = METHODS.get(type)!;\n      getters = GETTERS.get(type)!;\n      continue;\n    }\n\n    for (const setupType of onType) setupType(type);\n\n    METHODS.set(type, (keys = new Map(keys)));\n    GETTERS.set(type, (getters = new Map(getters)));\n\n    for (const [key, desc] of Object.entries(\n      Object.getOwnPropertyDescriptors(type.prototype)\n    )) {\n      if (key == 'constructor' || !desc.configurable) continue;\n\n      if (typeof desc.get == 'function') {\n        if (desc.configurable && typeof desc.set != 'function')\n          getters.set(key, desc.get);\n\n        continue;\n      }\n\n      const { value } = desc;\n\n      if (typeof value !== 'function') continue;\n\n      function bind(this: State, original?: Function) {\n        const { is } = this;\n\n        if (is.hasOwnProperty(key) && !original) return value as Function;\n\n        const fn = original || value;\n        const bound = fn.bind(is);\n\n        UNBIND.set(bound, fn);\n        define(is, key, { value: bound, writable: true, configurable: true });\n\n        return bound;\n      }\n\n      UNBIND.set(bind, value);\n\n      keys.set(key, bind);\n      define(type.prototype, key, { get: bind, set: bind });\n    }\n  }\n\n  if (getters.size)\n    before.add((self) => getters.forEach(compute, self));\n\n  return { before, after };\n}\n\n/**\n * Install a reactive computed property on a state instance, derived from a prototype\n * getter or an arity-bearing `set` factory.\n *\n * The getter is invoked with the tracking proxy as both `this` and its first argument;\n * reads of managed properties through it create subscriptions. Result is cached and\n * emits a keyed event when stale.\n */\nfunction compute(this: State, getter: (self: any) => unknown, key: string) {\n  const store = STORE.get(this)!;\n  let reset: (() => void) | undefined;\n  let isAsync: boolean;\n  let proxy: any;\n\n  const connect = () => {\n    reset = watch(\n      this,\n      (current) => {\n        proxy = current;\n\n        if (!(key in store) || STALE.delete(run)) run(!reset);\n\n        return (didUpdate) => {\n          if (didUpdate) {\n            STALE.add(run);\n            event(this, key, true);\n          }\n        };\n      },\n      false\n    );\n  };\n\n  const run = (initial?: boolean) => {\n    let next: unknown;\n\n    try {\n      next = getter.call(proxy, proxy);\n    } catch (err) {\n      console.warn(\n        `An exception was thrown while ${initial ? 'initializing' : 'refreshing'\n        } ${this}.${key}.`\n      );\n\n      if (initial) throw err;\n\n      console.error(err);\n    }\n\n    update(this, key, next, !isAsync);\n  };\n\n  apply(\n    this,\n    key,\n    {\n      enumerable: true,\n      set: false,\n      get: () => {\n        if (!proxy) {\n          if (observer(this) === null) return store[key];\n\n          connect();\n          isAsync = true;\n        }\n\n        if (STALE.delete(run)) run();\n\n        return access(this, key, !proxy);\n      }\n    },\n    true\n  );\n}\n\n/**\n * Define or update a managed property using a descriptor config.\n * If the property already is managed, config will only accept value.\n * If the property does not exist, it will be created and made reactive.\n *\n * @param state - State to apply property to.\n * @param key - Property to define or update.\n * @param config - Descriptor config with value, get, set, enumerable, and/or destroy.\n * @param silent - If an update does occur, listeners will not be refreshed automatically.\n */\nfunction apply(\n  state: State,\n  key: string,\n  config: State.Apply,\n  silent?: boolean\n) {\n  const desc = Object.getOwnPropertyDescriptor(state, key);\n\n  if (desc && 'get' in desc) {\n    if (Object.keys(config).some((k) => k != 'value'))\n      throw new Error(`Property ${key} on ${state} is already defined.`);\n    if ('value' in config) update(state, key, config.value, silent);\n    return;\n  }\n\n  const adopt = config.value instanceof State && child(state);\n\n  function set(value: unknown, silent?: boolean) {\n    if (!update(state, key, value, silent)) return;\n    if (adopt) adopt(value);\n  }\n\n  define(state, key, {\n    configurable: true,\n    enumerable: config.enumerable !== false,\n    get(this: State) {\n      const value =\n        typeof config.get == 'function'\n          ? config.get(this)\n          : access(state, key, config.get);\n\n      return touch(this, key, value);\n    },\n    set(next: any, silent?: boolean) {\n      if (config.set === false)\n        throw new Error(`${state}.${String(key)} is read-only.`);\n\n      if (typeof config.set == 'function')\n        try {\n          const output = config.set(next, STORE.get(state)![key]);\n          if (output !== undefined) next = output;\n        } catch (err: unknown) {\n          if (err === false) return;\n          if (err === true) {\n            set(next, true);\n            return;\n          }\n          throw err;\n        }\n\n      set(next, silent);\n    }\n  });\n\n  if ('value' in config) set(config.value, silent);\n}\n\nfunction child(state: State) {\n  let cleanup: (() => void) | undefined;\n  const ctx = Context.get(state);\n\n  function reset() {\n    if (cleanup) cleanup();\n    cleanup = undefined;\n  }\n\n  listener(state, reset, null);\n\n  return (value: unknown) => {\n    reset();\n\n    if (!(value instanceof State)) return;\n\n    const remove = ctx.add(value);\n\n    if (parent(value, state)) {\n      cleanup = () => {\n        cancel();\n        remove();\n        event(value, null);\n      };\n      const cancel = listener(state, cleanup, null);\n    } else {\n      cleanup = remove;\n    }\n\n    event(value);\n  };\n}\n\n/** Currently accumulating export. Stores real values of placeholder properties such as ref() or child states. */\nlet EXPORT: Map<any, any> | undefined;\n\nfunction values<T extends State>(state: T): State.Values<T> {\n  const values = {} as any;\n  let notRecursive;\n\n  if (!EXPORT) {\n    notRecursive = true;\n    EXPORT = new Map();\n  }\n\n  EXPORT.set(state, values);\n\n  for (let [key, value] of state) {\n    if (EXPORT.has(value)) value = EXPORT.get(value);\n    else if (\n      value &&\n      typeof value == 'object' &&\n      'get' in value &&\n      typeof value.get === 'function'\n    )\n      value = value.get();\n\n    values[key] = value;\n  }\n\n  if (notRecursive) EXPORT = undefined;\n\n  return Object.freeze(values);\n}\n\nfunction access(state: State, property: string, required?: boolean) {\n  const store = STORE.get(state)!;\n\n  if (property in store || required === false) {\n    const value = store[property];\n\n    if (value !== undefined || !required) return value;\n  }\n\n  if (METHODS.get(state.constructor)!.has(property))\n    return unbind((state as any)[property]);\n\n  if (observer(state) === null) return undefined;\n\n  const error = new Error(`${state}.${property} is not yet available.`);\n  const promise = new Promise<any>((resolve, reject) => {\n    listener(state, (key) => {\n      if (key === property) {\n        resolve(store[key]);\n        return null;\n      }\n\n      if (key === null) {\n        reject(new Error(`${state} is destroyed.`));\n      }\n    });\n  });\n\n  throw Object.assign(promise, {\n    toString: () => String(error),\n    name: 'Suspense',\n    message: error.message,\n    stack: error.stack\n  });\n}\n\nfunction assign(state: State, data: State.Assign<State>, silent?: boolean) {\n  if (!silent) event(state);\n\n  const methods = METHODS.get(state.constructor)!;\n  const getters = GETTERS.get(state.constructor);\n\n  for (const key in data) {\n    const bind = methods.get(key);\n\n    if (bind) bind.call(state, data[key]);\n    else if (getters?.has(key)) continue;\n    else if (key in state && key !== 'is') {\n      const desc = Object.getOwnPropertyDescriptor(state, key)!;\n      const set = desc && (desc.set as (value: any, silent?: boolean) => void);\n\n      if (set) {\n        set.call(state, data[key], silent);\n      } else {\n        (state as any)[key] = data[key];\n      }\n    }\n  }\n}\n\n/**\n * Update a property on a state instance and notify listeners.\n *\n * 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.\n *\n * If `silent` is true, the update will not dispatch events and will return `false` instead of throwing if state is destroyed.\n */\nfunction update<T>(\n  state: State,\n  key: State.Event<T>,\n  value: T,\n  silent?: boolean\n) {\n  if (observer(state) === null) {\n    if (silent) return false;\n    throw new Error(\n      `Tried to update ${state}.${String(key)} but state is destroyed.`\n    );\n  }\n\n  const store = STORE.get(state)!;\n\n  if (key in store && value === store[key]) return false;\n\n  store[key] = value;\n\n  if (!silent) event(state, key);\n\n  return true;\n}\n\n/** Random alphanumberic of length 6; always starts with a letter. */\nfunction uid() {\n  return (0.278 + Math.random() * 0.722)\n    .toString(36)\n    .substring(2, 8)\n    .toUpperCase();\n}\n\nfunction unbind<T extends Function>(fn: T): T;\nfunction unbind<T extends Function>(fn?: T): T | undefined;\nfunction unbind(fn?: Function) {\n  return UNBIND.get(fn) || fn;\n}\n\n/**\n * Read or claim a parent for a given child. In read mode (one argument) returns\n * the current parent, or `undefined` if never assigned. In write mode assigns\n * only if unclaimed and returns whether the assignment applied - `true` means\n * this call freshly claimed it, `false` means it was already parented.\n */\nfunction parent(child: object): State | null | undefined;\nfunction parent(child: object, value: State | null): boolean;\nfunction parent(child: object, value?: State | null) {\n  if (arguments.length < 2) return PARENT.get(child as State);\n  if (PARENT.has(child as State)) return false;\n  PARENT.set(child as State, value ?? null);\n  return true;\n}\n\nexport { event, unbind, State, parent, STORE, uid, access, update, apply, compute };\n"],"mappings":"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"}
+{"version":3,"file":"state.js","names":[],"sources":["../src/state.ts"],"sourcesContent":["import { Context } from './context';\nimport {\n  event,\n  listener,\n  Observer,\n  observer,\n  pending,\n  touch,\n  watch\n} from './observable';\n\nconst define = Object.defineProperty;\n\n/** Register for all active states via string identifiers (usually unique). */\nconst ID = new WeakMap<State, string>();\n\n/** Internal state assigned to states. */\nconst STORE = new WeakMap<State, Record<string | number | symbol, unknown>>();\n\n/** External lifecycle listeners for any given State class. */\nconst SETUP = new WeakMap<State.Extends, Set<State.Init<any> | State.On<any>>>();\n\n/** Parent-child relationships. */\nconst PARENT = new WeakMap<object, State | null>();\n\n/** Reference bound instance methods, or their getter, to real one. */\nconst UNBIND = new WeakMap<any, any>();\n\n/** List of methods defined by a given type. */\nconst METHODS = new WeakMap<Function, Map<string, (value: any) => void>>();\n\n/** List of reactive getters defined by a given type. */\nconst GETTERS = new WeakMap<Function, Map<string, () => unknown>>();\n\n/** Stale flags for compute closures awaiting refresh on next access. */\nconst STALE = new WeakSet<() => void>();\n\ndeclare namespace State {\n  /** Any type of State, using own class constructor as its identifier. */\n  type Extends<T extends State = State> = (abstract new (...args: any[]) => T) &\n    typeof State;\n\n  /** A State constructor which may be instanciated. */\n  type Type<T extends State = State> = (new (...args: State.Args<T>) => T) &\n    Omit<typeof State, never>;\n\n  /** State constructor arguments */\n  type Args<T extends State = any> = (Args<T> | Init<T> | Assign<T> | void)[];\n\n  /**\n   * Value of `static global`. A boolean opts a State in or out of the\n   * process-global root; a resolver decides at activation, receiving the\n   * instance and returning whether it registers - use it to make the choice\n   * conditional (e.g. per environment). A bare literal (`= true` / `= false`)\n   * seals the choice for subclasses; widen a subclass's `static global` type to\n   * `State.Global` to permit a resolver or a later override.\n   */\n  type Global<T extends State = any> = boolean | ((self: T) => boolean);\n\n  /**\n   * State constructor callback - runs during activation, in argument order,\n   * before the `new()` lifecycle hook (so it may configure state `new()`\n   * will observe). Returned function will run when state is destroyed.\n   */\n  type Init<T extends State = State> = (\n    this: T,\n    thisArg: T\n  ) => Promise<void> | (() => void) | Args<T> | Assign<T> | void;\n\n  /**\n   * Lifecycle handlers for `State.on`, keyed by when they run. A bare `Init`\n   * function passed to `on` is sugar for `{ before }`.\n   */\n  interface On<T extends State = State> {\n    /**\n     * Per-class setup, run once when the class is first bootstrapped - before\n     * its members are classified and bound. Receives the class, so a handler\n     * may inspect or reshape the prototype first. A handler registered on a\n     * base class runs for each subclass too.\n     */\n    type?(type: State.Extends<T>): void;\n\n    /**\n     * Per-instance setup, run in the `prepare` phase before `observe` and the\n     * `new()` hook. Equivalent to passing a bare function to `on`. May return a\n     * cleanup, constructor args, or an assign overlay.\n     */\n    before?(this: T, thisArg: T): void | (() => void) | Promise<void> | Args<T> | Assign<T>;\n\n    /**\n     * Per-instance setup, run at the `new()` slot - after own values are\n     * observed and constructor args applied. May return a cleanup function.\n     */\n    after?(this: T, self: T): void | (() => void);\n  }\n\n  /** Object overlay to override values and methods on a state. */\n  type Assign<T> = Record<string, unknown> & {\n    [K in Field<T>]?: T[K] extends (...args: infer A) => infer R\n    ? (this: T, ...args: A) => R\n    : T[K];\n  };\n\n  /** Subset of `keyof T` not defined by base State. **/\n  type Field<T> = Exclude<keyof T, keyof State>;\n\n  /** Any valid key for state, including but not limited to Field<T>. */\n  type Event<T = State> = Field<T> | number | symbol | (string & {});\n\n  /** Any event signal dispatched to listeners, including lifecycle meta events. */\n  type Signal<T = State> = Event<T> | true | false | null;\n\n  /** Export/Import compatible value for a given property in a State. */\n  type Export<R> = R extends State\n    ? Values<R>\n    : R extends { get(): infer T }\n    ? T\n    : R;\n\n  /**\n   * Values from current state of given state.\n   * Differs from `Values` as values here will drill\n   * into \"real\" values held by exotics like ref.Object.\n   */\n  type Values<T> = { [P in Field<T>]: Export<T[P]> };\n\n  /** Object comperable to data found in T. */\n  type Partial<T> = { [P in Field<T>]?: Export<T[P]> };\n\n  /** Value for a property applied by a state. */\n  type Value<T extends State, K extends State.Event<T>> = K extends keyof T\n    ? Export<T[K]>\n    : unknown;\n\n  type Setter<T> = (value: T, previous: T) => T | void;\n\n  /** Descriptor config for a managed property. */\n  type Apply<T = any> = {\n    value?: T;\n    get?: ((source: State) => T) | boolean;\n    set?: Setter<T> | boolean;\n    enumerable?: boolean;\n    // destroy?: () => void;\n  };\n\n  /** Descriptor config for set() overload - enforces type when key is a known field. */\n  type Define<T, K> = K extends Field<T> ? Apply<T[K] | Export<T[K]>> : Apply;\n\n  type OnEvent<T extends State> = (\n    this: T,\n    key: Signal<T>,\n    source: T\n  ) => void | (() => void) | null;\n\n  /** Exotic value, where actual value is contained within. */\n  type Ref<T = any> = {\n    (next: T): void;\n    current: T | null;\n  };\n\n  /**\n   * A callback function which is subscribed to parent and updates when accessed properties change.\n   *\n   * @param current - Current state of this state. This is a proxy which detects properties which\n   * where accessed, and thus depended upon to stay current.\n   *\n   * @param update - Set of properties which have changed, and events fired, since last update.\n   *\n   * @returns A callback function which will be called when this effect is stale.\n   */\n  type Effect<T> = (\n    this: T,\n    current: T,\n    update: readonly State.Event<T>[] | undefined\n  ) => EffectCallback | Promise<void> | null | void;\n\n  /**\n   * A callback function returned by effect. Will be called when effect is stale.\n   *\n   * @param update - `true` if update is pending, `false` effect has been cancelled, `null` if state is destroyed.\n   */\n  type EffectCallback = (update: boolean | null) => void;\n\n  /**\n   * A list of keys updated, or events fired, since last update.\n   * This may be awaited to get full list (same array) when update is settled.\n   */\n  type Updated<T extends State> = readonly Event<T>[] &\n    PromiseLike<readonly Event<T>[]>;\n}\n\nabstract class State {\n  /**\n   * Whether an instance activated with no enclosing context registers itself\n   * to the process-global root, where `get()` can resolve it from anywhere.\n   * `false` (the default) keeps a context-less instance fully functional but\n   * private - not injectable, though it can still read declared globals. Opt in\n   * with `static readonly global = true`; a resolver (see {@link State.Global})\n   * makes the choice conditional. It must be declared per class - a subclass\n   * that would inherit a global without its own declaration throws on\n   * activation, so an accidental global (a forgotten `Provider`, an extended\n   * global) cannot leak into the shared root.\n   */\n  static readonly global: State.Global = false;\n\n  /**\n   * Loopback to instance of this state. This is useful when in a subscribed context,\n   * to keep write access to `this` after a destructure. You can use it to read variables silently as well.\n   **/\n  declare is: this;\n\n  constructor(...args: State.Args) {\n    define(this, 'is', { value: this });\n    init(this, args, this.new);\n  }\n\n  /**\n   * Optional lifecycle hook called during State initialization.\n   * Can return a cleanup function to run when state is destroyed.\n   *\n   * It is recommended you protect this method.\n   */\n  protected new?(): void | (() => void);\n\n  /**\n   * Pull current values from state. Flattens all states and exotic values recursively.\n   *\n   * @returns Object with all values from this state.\n   **/\n  get(): State.Values<this>;\n\n  /**\n   * Run a function to run automatically when accessed values change.\n   *\n   * @param effect Function to run, and whenever accessed values change.\n   *               If effect returns a function, it will be called when a change occurs (syncronously),\n   *               effect is cancelled, or parent state is destroyed.\n   * @returns Function to cancel listener.\n   */\n  get(effect: State.Effect<this>): () => void;\n\n  /**\n   * Get value of a property. Will fetch underlying value from exotic values like ref.Object.\n   *\n   * Any value which implements `get()` (with no arguments) will be treated as such.\n   *\n   * @param key - Property to get value of.\n   * @param required - If true, will throw an error if property is not available.\n   * @returns Value of property.\n   */\n  get<T extends State.Event<this>>(\n    key: T,\n    required?: boolean\n  ): State.Value<this, T>;\n\n  /**\n   * Check if state is destroyed.\n   *\n   * @param status - `null` to check if state is destroyed.\n   * @returns `true` if state is destroyed, `false` otherwise.\n   */\n  get(status: null): boolean;\n\n  /**\n   * Callback when state is to be destroyed.\n   *\n   * @param callback - Function to call when state is destroyed.\n   * @returns Function to cancel listener.\n   */\n  get(status: null, callback: () => void): () => void;\n\n  /** Fetch State of type from context. Throws if not found. */\n  get<T extends State>(type: State.Type<T>, required?: true): T;\n\n  /** Fetch a State from context. Undefined if not found. */\n  get<T extends State>(type: State.Type<T>, required: boolean): T | undefined;\n\n  /**\n   * Subscribe to State becoming available in context.\n   *\n   * Will search both up and downstream by default.\n   * Normally you can ignore this because State you expect is rarely both.\n   *\n   * Specify downstream if you only want to watch for State in children, which can be useful if you expect multiple of the same State in different branches of the tree.\n   *\n   * @param type - Type of State to watch for.\n   * @param callback - Function to call when State is found. Will be called immediately if State is already available.\n   * @param downstream - If true, will only watch for State in children, if false will only for parents.\n   * @returns Function to cancel listener.\n   */\n  get<T extends State>(\n    type: State.Type<T>,\n    callback: Context.Expect<T>,\n    downstream?: boolean\n  ): () => void;\n\n  get(\n    arg1?: State.Effect<this> | State.Type | string | null,\n    arg2?: boolean | Context.Expect | (() => void),\n    arg3?: boolean\n  ) {\n    const self = this.is;\n\n    if (arg1 === undefined) return values(self);\n    if (State.is(arg1)) return Context.get(self).get(arg1, arg2, arg3, self);\n    if (typeof arg1 == 'function') return watch(self, unbind(arg1));\n    if (typeof arg2 == 'function') return callback(self, arg2, arg1);\n    if (arg1 === null) return observer(self) === null;\n    return access(self, arg1, arg2);\n  }\n\n  /**\n   * Get update in progress.\n   *\n   * @returns Promise which resolves object with updated values, `undefined` if there no update is pending.\n   **/\n  set(): State.Updated<this>;\n\n  /**\n   * Merge argument with current state, updating one or more properties at once.\n   * Properties which are not managed by this state will be ignored.\n   *\n   * @param assign - Object with properties to update.\n   * @param silent - If true, listeners will not be notified. If state is destroyed, will squash update without throwing.\n   * @returns Array of keys updated, syncronously contains keys updated immediately and may be resolved (to itself) when all updates are settled.\n   */\n  set(assign?: State.Assign<this>, silent?: boolean): State.Updated<this>;\n\n  /**\n   * Call a function when update occurs.\n   *\n   * Given function is called for every assignment (which changes value) or explicit `set`.\n   *\n   * To run logic on final value only, callback may return a function. The same\n   * function for one or more events will be called only once when update is settled.\n   *\n   * Return `null` from callback to stop listening.\n   *\n   * @param callback - Function to call when update occurs.\n   * @returns Function to remove listener. Will return `true` if removed, `false` if inactive already.\n   */\n  set(callback: State.OnEvent<this>): () => boolean;\n\n  /**\n   * Push an update. This will not change the value of associated property.\n   *\n   * Useful where a property value internally has changed, but the object is the same.\n   * For example: An array has pushed a new value, or a nested property is updated.\n   *\n   * You can also use this to dispatch arbitrary events.\n   * Symbols are recommended as non-property events, however you can use any string.\n   * If doing so, be sure to avoid collisions using property names. An easy way to do this is\n   * to prefix an event with \"!\" and/or use dash-case. e.g. `set(\"!event\")` or `set(\"my-event\")`.\n   *\n   * @param key - Property or event to dispatch.\n   * @returns Promise resolves an array of keys updated.\n   */\n  set(key: State.Event<this>): State.Updated<this>;\n\n  /**\n   * Declare an end to updates. This event is final and will freeze state.\n   * This event can be watched for as well, to run cleanup logic and internally will remove all listeners.\n   *\n   * @param status - `null` to end updates.\n   */\n  set(status: null): void;\n\n  /**\n   * Register a callback for a specific property or event.\n   *\n   * Callback receives the key, current value, and source instance.\n   *\n   * @param event - Property or event to watch. If `null`, will callback on destroy.\n   * @param callback - Function to call when event occurs.\n   * @returns Function to remove listener.\n   */\n  set<K extends State.Event<this>>(\n    event: K | null,\n    callback: State.OnEvent<this>\n  ): () => boolean;\n\n  /**\n   * Define or update a managed property using a descriptor config.\n   * If the property already is managed, config will only accept value.\n   * If the property does not exist, it will be created and made reactive.\n   *\n   * @param key - Property to define or update.\n   * @param config - Descriptor config with value, get, set, enumerable, and/or destroy.\n   * @returns Promise resolves an array of keys updated.\n   */\n  set<K extends State.Event<this>>(\n    key: K,\n    config: State.Define<this, K>\n  ): State.Updated<this>;\n\n  set(\n    arg1?: State.OnEvent<this> | State.Assign<this> | State.Event<this> | null,\n    arg2?: unknown\n  ) {\n    const self = this.is;\n\n    if (typeof arg1 == 'function')\n      return listener(self, (key) => {\n        if (\n          typeof key == 'string' ||\n          typeof key == 'number' ||\n          typeof key == 'symbol'\n        )\n          return arg1.call(self, key, self);\n      });\n\n    if (typeof arg2 == 'function')\n      return callback(self, arg2, arg1 as State.Signal);\n\n    if (arg1 && typeof arg1 == 'object') assign(self, arg1, arg2 === true);\n    else if (arg2) apply(self, arg1 as string, arg2);\n    else event(self, arg1);\n\n    return pending(self) as State.Updated<this>;\n  }\n\n  /**\n   * Iterate over managed properties in this instance of State.\n   * Yeilds the key and current value for each property.\n   */\n  [Symbol.iterator](): Iterator<[string, unknown]> {\n    return Object.entries(STORE.get(this.is)!)[Symbol.iterator]();\n  }\n\n  /**\n   * Create and activate a new instance of this state.\n   *\n   * **Important** - Unlike `new this(...)` - this method also activates state.\n   *\n   * @param args - arguments sent to constructor\n   */\n  static new<T extends State>(this: State.Type<T>, ...args: State.Args<T>): T {\n    const instance = new this(...args);\n    event(instance);\n    return instance;\n  }\n\n  /**\n   * Static equivalent of `x instanceof this`.\n   * Determines if provided class is a subtype of this one.\n   * If so, language server will make available all static\n   * methods and properties of this class.\n   */\n  static is<T extends State.Extends>(this: T, maybe: unknown): maybe is T {\n    return (\n      maybe === this ||\n      (typeof maybe == 'function' && maybe.prototype instanceof this)\n    );\n  }\n\n  /**\n   * Register a lifecycle handler for this State and its subclasses.\n   *\n   * A bare function is per-instance setup run in the `prepare` phase (sugar for\n   * `{ before }`); if it returns a function, that runs when the instance is\n   * destroyed. Pass a {@link State.On} object to hook by cadence - `type`\n   * (per-class, at bootstrap), `before` (per-instance, before `new()`), and\n   * `after` (per-instance, at the `new()` slot).\n   *\n   * @returns Function to remove the handler.\n   */\n  static on<T extends State>(\n    this: State.Extends<T>,\n    handler: State.Init<T> | State.On<T>\n  ) {\n    let setup = SETUP.get(this);\n\n    if (!setup) SETUP.set(this, (setup = new Set()));\n\n    setup.add(handler);\n\n    return () => setup.delete(handler);\n  }\n}\n\ndefine(State.prototype, 'toString', {\n  value() {\n    return ID.get(this.is);\n  }\n});\n\ndefine(State, 'toString', {\n  value() {\n    return this.name;\n  }\n});\n\n/** Register a user OnEvent callback, preserving `this` and `source`. */\nfunction callback<T extends State>(\n  self: T,\n  cb: Function,\n  select?: Observer.Signal | Set<Observer.Signal>\n) {\n  return listener(self, (key) => cb.call(self, key, self), select);\n}\n\n/**\n * Apply state arguemnts, run callbacks and observe properties.\n * Accumulate and handle cleanup events.\n **/\nfunction init(state: State, ...args: State.Args) {\n  const T = state.constructor as State.Extends;\n\n  if (T === State) throw new Error('Cannot create base State.');\n\n  const { before, after } = bootstrap(T);\n\n  ID.set(state, `${T}-${uid()}`);\n  STORE.set(state, {});\n\n  function observe() {\n    for (const key in state) {\n      const desc = Object.getOwnPropertyDescriptor(state, key)!;\n      if ('value' in desc && desc.configurable) apply(state, key, desc, true);\n    }\n  }\n\n  function register() {\n    if (Context.get(state) !== Context.root) return;\n\n    const type = state.constructor as typeof State;\n    const g = type.global;\n\n    if (!(typeof g == 'function' ? g(state) : g)) return;\n\n    if (!Object.prototype.hasOwnProperty.call(type, 'global'))\n      throw new Error(\n        `${state} would register as a global by inheritance alone - re-declare \\`static global\\` on ${type.name} (\\`true\\` to keep it, \\`false\\` to opt out).`\n      );\n\n    return Context.root.add(state);\n  }\n\n  listener(state, () => {\n    parent(state, null);\n\n    const queue = [...before, observe, ...args, ...after, register];\n\n    for (let i = 0; i < queue.length; i++) {\n      const arg = queue[i];\n      const out = typeof arg == 'function' ? arg.call(state, state) : arg;\n\n      if (out instanceof Promise)\n        out.catch((err) => {\n          console.error(`Async error in constructor for ${state}:`);\n          console.error(err);\n        });\n      else if (Array.isArray(out)) queue.splice(i + 1, 0, ...out);\n      else if (typeof out == 'function') listener(state, out, null);\n      else if (typeof out == 'object') assign(state, out, true);\n    }\n\n    return null;\n  });\n}\n\n/**\n * Apply instructions and inherited event listeners. Ensure class metadata is ready.\n *\n * @param T - State class to bootstrap.\n * @return Array of init functions to run on instance, in order of class hierarchy.\n */\nfunction bootstrap(T: State.Extends) {\n  const chain = [] as State.Extends[];\n  const before = new Set<State.Init>();\n  const after = new Set<State.Init>();\n  const onType = new Set<NonNullable<State.On['type']>>();\n  let keys = new Map<string, (value: any) => void>();\n  let getters = new Map<string, () => unknown>();\n\n  do {\n    chain.unshift(T);\n    T = Object.getPrototypeOf(T);\n  } while (T.name);\n\n  for (const type of chain) {\n    for (const handler of SETUP.get(type) || [])\n      if (typeof handler == 'function') before.add(handler);\n      else {\n        if (handler.before) before.add(handler.before);\n        if (handler.after) after.add(handler.after);\n        if (handler.type) onType.add(handler.type);\n      }\n\n    if (type === State) continue;\n\n    if (METHODS.has(type)) {\n      keys = METHODS.get(type)!;\n      getters = GETTERS.get(type)!;\n      continue;\n    }\n\n    for (const setupType of onType) setupType(type);\n\n    METHODS.set(type, (keys = new Map(keys)));\n    GETTERS.set(type, (getters = new Map(getters)));\n\n    for (const [key, desc] of Object.entries(\n      Object.getOwnPropertyDescriptors(type.prototype)\n    )) {\n      if (key == 'constructor' || !desc.configurable) continue;\n\n      if (typeof desc.get == 'function') {\n        if (desc.configurable && typeof desc.set != 'function')\n          getters.set(key, desc.get);\n\n        continue;\n      }\n\n      const { value } = desc;\n\n      if (typeof value !== 'function') continue;\n\n      function bind(this: State, original?: Function) {\n        const { is } = this;\n\n        if (is.hasOwnProperty(key) && !original) return value as Function;\n\n        const fn = original || value;\n        const bound = fn.bind(is);\n\n        UNBIND.set(bound, fn);\n        define(is, key, { value: bound, writable: true, configurable: true });\n\n        return bound;\n      }\n\n      UNBIND.set(bind, value);\n\n      keys.set(key, bind);\n      define(type.prototype, key, { get: bind, set: bind });\n    }\n  }\n\n  if (getters.size)\n    before.add((self) => getters.forEach(compute, self));\n\n  return { before, after };\n}\n\n/**\n * Install a reactive computed property on a state instance, derived from a prototype\n * getter or an arity-bearing `set` factory.\n *\n * The getter is invoked with the tracking proxy as both `this` and its first argument;\n * reads of managed properties through it create subscriptions. Result is cached and\n * emits a keyed event when stale.\n */\nfunction compute(this: State, getter: (self: any) => unknown, key: string) {\n  const store = STORE.get(this)!;\n  let reset: (() => void) | undefined;\n  let isAsync: boolean;\n  let proxy: any;\n\n  const connect = () => {\n    reset = watch(\n      this,\n      (current) => {\n        proxy = current;\n\n        if (!(key in store) || STALE.delete(run)) run(!reset);\n\n        return (didUpdate) => {\n          if (didUpdate) {\n            STALE.add(run);\n            event(this, key, true);\n          }\n        };\n      },\n      false\n    );\n  };\n\n  const run = (initial?: boolean) => {\n    let next: unknown;\n\n    try {\n      next = getter.call(proxy, proxy);\n    } catch (err) {\n      console.warn(\n        `An exception was thrown while ${initial ? 'initializing' : 'refreshing'\n        } ${this}.${key}.`\n      );\n\n      if (initial) throw err;\n\n      console.error(err);\n    }\n\n    update(this, key, next, !isAsync);\n  };\n\n  apply(\n    this,\n    key,\n    {\n      enumerable: true,\n      set: false,\n      get: () => {\n        if (!proxy) {\n          if (observer(this) === null) return store[key];\n\n          connect();\n          isAsync = true;\n        }\n\n        if (STALE.delete(run)) run();\n\n        return access(this, key, !proxy);\n      }\n    },\n    true\n  );\n}\n\n/**\n * Define or update a managed property using a descriptor config.\n * If the property already is managed, config will only accept value.\n * If the property does not exist, it will be created and made reactive.\n *\n * @param state - State to apply property to.\n * @param key - Property to define or update.\n * @param config - Descriptor config with value, get, set, enumerable, and/or destroy.\n * @param silent - If an update does occur, listeners will not be refreshed automatically.\n */\nfunction apply(\n  state: State,\n  key: string,\n  config: State.Apply,\n  silent?: boolean\n) {\n  const desc = Object.getOwnPropertyDescriptor(state, key);\n\n  if (desc && 'get' in desc) {\n    if (Object.keys(config).some((k) => k != 'value'))\n      throw new Error(`Property ${key} on ${state} is already defined.`);\n    if ('value' in config) update(state, key, config.value, silent);\n    return;\n  }\n\n  const adopt = config.value instanceof State && child(state);\n\n  function set(value: unknown, silent?: boolean) {\n    if (!update(state, key, value, silent)) return;\n    if (adopt) adopt(value);\n  }\n\n  define(state, key, {\n    configurable: true,\n    enumerable: config.enumerable !== false,\n    get(this: State) {\n      const value =\n        typeof config.get == 'function'\n          ? config.get(this)\n          : access(state, key, config.get);\n\n      return touch(this, key, value);\n    },\n    set(next: any, silent?: boolean) {\n      if (config.set === false)\n        throw new Error(`${state}.${String(key)} is read-only.`);\n\n      if (typeof config.set == 'function')\n        try {\n          const output = config.set(next, STORE.get(state)![key]);\n          if (output !== undefined) next = output;\n        } catch (err: unknown) {\n          if (err === false) return;\n          if (err === true) {\n            set(next, true);\n            return;\n          }\n          throw err;\n        }\n\n      set(next, silent);\n    }\n  });\n\n  if ('value' in config) set(config.value, silent);\n}\n\nfunction child(state: State) {\n  let cleanup: (() => void) | undefined;\n  const ctx = Context.get(state);\n\n  function reset() {\n    if (cleanup) cleanup();\n    cleanup = undefined;\n  }\n\n  listener(state, reset, null);\n\n  return (value: unknown) => {\n    reset();\n\n    if (!(value instanceof State)) return;\n\n    const remove = ctx.add(value);\n\n    if (parent(value, state)) {\n      cleanup = () => {\n        cancel();\n        remove();\n        event(value, null);\n      };\n      const cancel = listener(state, cleanup, null);\n    } else {\n      cleanup = remove;\n    }\n\n    event(value);\n  };\n}\n\n/** Currently accumulating export. Stores real values of placeholder properties such as ref() or child states. */\nlet EXPORT: Map<any, any> | undefined;\n\nfunction values<T extends State>(state: T): State.Values<T> {\n  const values = {} as any;\n  let notRecursive;\n\n  if (!EXPORT) {\n    notRecursive = true;\n    EXPORT = new Map();\n  }\n\n  EXPORT.set(state, values);\n\n  for (let [key, value] of state) {\n    if (EXPORT.has(value)) value = EXPORT.get(value);\n    else if (\n      value &&\n      typeof value == 'object' &&\n      'get' in value &&\n      typeof value.get === 'function'\n    )\n      value = value.get();\n\n    values[key] = value;\n  }\n\n  if (notRecursive) EXPORT = undefined;\n\n  return Object.freeze(values);\n}\n\nfunction access(state: State, property: string, required?: boolean) {\n  const store = STORE.get(state)!;\n\n  if (property in store || required === false) {\n    const value = store[property];\n\n    if (value !== undefined || !required) return value;\n  }\n\n  if (METHODS.get(state.constructor)!.has(property))\n    return unbind((state as any)[property]);\n\n  if (observer(state) === null) return undefined;\n\n  const error = new Error(`${state}.${property} is not yet available.`);\n  const promise = new Promise<any>((resolve, reject) => {\n    listener(state, (key) => {\n      if (key === property) {\n        resolve(store[key]);\n        return null;\n      }\n\n      if (key === null) {\n        reject(new Error(`${state} is destroyed.`));\n      }\n    });\n  });\n\n  throw Object.assign(promise, {\n    toString: () => String(error),\n    name: 'Suspense',\n    message: error.message,\n    stack: error.stack\n  });\n}\n\nfunction assign(state: State, data: State.Assign<State>, silent?: boolean) {\n  if (!silent) event(state);\n\n  const methods = METHODS.get(state.constructor)!;\n  const getters = GETTERS.get(state.constructor);\n\n  for (const key in data) {\n    const bind = methods.get(key);\n\n    if (bind) bind.call(state, data[key]);\n    else if (getters?.has(key)) continue;\n    else if (key in state && key !== 'is') {\n      const desc = Object.getOwnPropertyDescriptor(state, key)!;\n      const set = desc && (desc.set as (value: any, silent?: boolean) => void);\n\n      if (set) {\n        set.call(state, data[key], silent);\n      } else {\n        (state as any)[key] = data[key];\n      }\n    }\n  }\n}\n\n/**\n * Update a property on a state instance and notify listeners.\n *\n * 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.\n *\n * If `silent` is true, the update will not dispatch events and will return `false` instead of throwing if state is destroyed.\n */\nfunction update<T>(\n  state: State,\n  key: State.Event<T>,\n  value: T,\n  silent?: boolean\n) {\n  if (observer(state) === null) {\n    if (silent) return false;\n    throw new Error(\n      `Tried to update ${state}.${String(key)} but state is destroyed.`\n    );\n  }\n\n  const store = STORE.get(state)!;\n\n  if (key in store && value === store[key]) return false;\n\n  store[key] = value;\n\n  if (!silent) event(state, key);\n\n  return true;\n}\n\n/** Random alphanumberic of length 6; always starts with a letter. */\nfunction uid() {\n  return (0.278 + Math.random() * 0.722)\n    .toString(36)\n    .substring(2, 8)\n    .toUpperCase();\n}\n\nfunction unbind<T extends Function>(fn: T): T;\nfunction unbind<T extends Function>(fn?: T): T | undefined;\nfunction unbind(fn?: Function) {\n  return UNBIND.get(fn) || fn;\n}\n\n/**\n * Read or claim a parent for a given child. In read mode (one argument) returns\n * the current parent, or `undefined` if never assigned. In write mode assigns\n * only if unclaimed and returns whether the assignment applied - `true` means\n * this call freshly claimed it, `false` means it was already parented.\n */\nfunction parent(child: object): State | null | undefined;\nfunction parent(child: object, value: State | null): boolean;\nfunction parent(child: object, value?: State | null) {\n  if (arguments.length < 2) return PARENT.get(child as State);\n  if (PARENT.has(child as State)) return false;\n  PARENT.set(child as State, value ?? null);\n  return true;\n}\n\nexport { event, unbind, State, parent, STORE, uid, access, update, apply, compute };\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressive/mvc",
-  "version": "0.81.0",
+  "version": "0.83.0",
   "description": "Class-based reactive state management - framework-agnostic core of Expressive MVC.",
   "sideEffects": false,
   "keywords": [
@@ -37,6 +37,10 @@
       "types": "./dist/observable.d.ts",
       "default": "./dist/observable.js"
     },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "default": "./dist/runtime.js"
+    },
     "./jsx-runtime": {
       "types": "./dist/jsx-runtime.d.ts",
       "default": "./dist/jsx-runtime.js"
@@ -54,7 +58,7 @@
   },
   "scripts": {
     "build": "tsdown",
-    "test": "tsc --noEmit && bun test --coverage --only-failures"
+    "test": "tsc --noEmit && vitest run --coverage"
   },
   "devDependencies": {
     "@types/node": "^18.19.0",

package/dist/jsx-runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsx-runtime.js","names":[],"sources":["../src/jsx-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/jsx-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 JSX 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 */\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\nexport declare namespace JSX {\n  type Element = Component.Node;\n  type ElementType =\n    | keyof IntrinsicElements\n    | ((props: any) => Component.Node)\n    | (abstract new (...args: any[]) => ElementClass);\n  /**\n   * Gates class element types on the `render` contract alone - requiring full\n   * `Component` assignability trips contravariance on `props` members (e.g.\n   * the `is` callback narrows per subclass), rejecting every subclass.\n   */\n  interface ElementClass { render(props?: any): Component.Node }\n  interface ElementAttributesProperty { props: {} }\n  interface ElementChildrenAttribute { children: {} }\n  interface IntrinsicAttributes { key?: string | number | null }\n  /**\n   * Host tag manifest, via the {@link Host} seam. Resolves to `{}` until an\n   * adapter augments `Host` with `intrinsics` - agnostic code is\n   * components-only by design, since it cannot know what tags a host renders.\n   */\n  type IntrinsicElements =\n    Host extends { intrinsics: infer T extends object } ? T : {};\n}\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\nlet HOST: HostRuntime | undefined;\n\n/** Register the host JSX runtime. Idempotent for the same runtime. */\nexport function host(runtime: HostRuntime) {\n  if (HOST && HOST !== 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  HOST = runtime;\n}\n\n/** Current host runtime; throws a setup-pointing error when none registered. */\nfunction resolved(): HostRuntime {\n  if (HOST) return HOST;\n\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\n/** Translate the agnostic Fragment sentinel to the host's Fragment. */\nfunction hostType(type: unknown): unknown {\n  return type === Fragment ? resolved().Fragment : type;\n}\n\nexport function jsx(type: unknown, props: object, key?: unknown): Component.Node {\n  return resolved().jsx(hostType(type), props, key);\n}\n\nexport function jsxs(type: unknown, props: object, key?: unknown): Component.Node {\n  return resolved().jsxs(hostType(type), props, key);\n}\n\n/** Dev-transpiled element creation. Falls back to the production runtime when\n * the host registered no `jsxDEV` (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  const runtime = resolved();\n  const resolvedType = hostType(type);\n\n  return runtime.jsxDEV\n    ? runtime.jsxDEV(resolvedType, props, key, isStatic, source, self)\n    : isStatic\n      ? runtime.jsxs(resolvedType, props, key)\n      : runtime.jsx(resolvedType, 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 resolved().childrenOf(children);\n}\n\n/** Is `node` a host element? */\nexport function isElement(node: unknown): boolean {\n  return resolved().isElement(node);\n}\n\n/** Element type of `node`; host Fragments surface as the agnostic `Fragment`. */\nexport function typeOf(node: unknown): unknown {\n  const { typeOf, Fragment: hosted } = resolved();\n  const type = typeOf(node);\n  return type === hosted ? Fragment : type;\n}\n\n/** Props carried by element `node`. */\nexport function propsOf(node: unknown): Record<string, unknown> {\n  return resolved().propsOf(node);\n}"],"mappings":";;;;;;AAoEA,MAAa,WAAW,OAAO,IAAI,2BAA2B;AAE9D,IAAI;;AAGJ,SAAgB,KAAK,SAAsB;AACzC,KAAI,QAAQ,SAAS,QACnB,OAAM,IAAI,MACR,iHAED;AAEH,QAAO;;;AAIT,SAAS,WAAwB;AAC/B,KAAI,KAAM,QAAO;AAEjB,OAAM,IAAI,MACR,4LAGD;;;AAIH,SAAS,SAAS,MAAwB;AACxC,QAAO,SAAS,WAAW,UAAU,CAAC,WAAW;;AAGnD,SAAgB,IAAI,MAAe,OAAe,KAA+B;AAC/E,QAAO,UAAU,CAAC,IAAI,SAAS,KAAK,EAAE,OAAO,IAAI;;AAGnD,SAAgB,KAAK,MAAe,OAAe,KAA+B;AAChF,QAAO,UAAU,CAAC,KAAK,SAAS,KAAK,EAAE,OAAO,IAAI;;;;AAKpD,SAAgB,OACd,MACA,OACA,KACA,UACA,QACA,MACgB;CAChB,MAAM,UAAU,UAAU;CAC1B,MAAM,eAAe,SAAS,KAAK;AAEnC,QAAO,QAAQ,SACX,QAAQ,OAAO,cAAc,OAAO,KAAK,UAAU,QAAQ,KAAK,GAChE,WACE,QAAQ,KAAK,cAAc,OAAO,IAAI,GACtC,QAAQ,IAAI,cAAc,OAAO,IAAI;;;AAI7C,SAAgB,WAAW,UAAqC;AAC9D,QAAO,UAAU,CAAC,WAAW,SAAS;;;AAIxC,SAAgB,UAAU,MAAwB;AAChD,QAAO,UAAU,CAAC,UAAU,KAAK;;;AAInC,SAAgB,OAAO,MAAwB;CAC7C,MAAM,EAAE,QAAQ,UAAU,WAAW,UAAU;CAC/C,MAAM,OAAO,OAAO,KAAK;AACzB,QAAO,SAAS,SAAS,WAAW;;;AAItC,SAAgB,QAAQ,MAAwC;AAC9D,QAAO,UAAU,CAAC,QAAQ,KAAK"}