@expressive/mvc 0.86.0 → 0.88.0

package/dist/jsx-runtime.js

@@ -1,3 +1,70 @@
-import { Fragment, jsx, jsxs } from "./runtime.js";
+import { compose } from "./component.js";
 
-export { Fragment, jsx, jsxs };
+//#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");
+/** 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 seam). Element mechanics
+* the host leaves unset keep defaults that throw a setup-pointing error;
+* `jsxDEV` is routed around at the call site instead.
+*/
+function host(runtime) {
+	if (registered && registered !== runtime) throw new Error("A different JSX host is already registered for @expressive/mvc. Only one host adapter may be active per build.");
+	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);
+}
+
+//#endregion
+export { Fragment, childrenOf, compose, host, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/jsx-runtime.js.map

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

package/dist/observable.js

@@ -3,6 +3,8 @@ import { enqueue, hold } from "./dispatch.js";
 //#region src/observable.ts
 const Observer = Symbol("Observer");
 const Observing = Symbol("Observing");
+/** Event every observer treats as watched, to force a refresh. */
+const REFRESH = Symbol.for("@expressive/mvc.refresh");
 function observer(state, create) {
 	const o = state[Observer];
 	if (!o && create) {
@@ -29,7 +31,7 @@ function observe(object, callback, required, cleanup = []) {
 		release: cleanup
 	};
 	const release = listener(object, (key) => {
-		if (watching.has(key)) return observing.callback();
+		if (watching.has(key) || key === REFRESH) return observing.callback();
 	});
 	cleanup.push(release);
 	if (EffectContext) EffectContext.add((update) => {

package/dist/observable.js.map

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

package/dist/state.d.ts

@@ -1,6 +1,5 @@
 import { Context } from "./context.js";
 import { event } from "./observable.js";
-import { Caught } from "./caught.js";
 
 //#region src/state.d.ts
 /** Internal state assigned to states. */
@@ -8,6 +7,17 @@ declare const STORE: WeakMap<State, Record<string | number | symbol, unknown>>;
 /** States under construction - added on `new`, removed when activated or released.
  *  Also carries work to run at the deadline, which `def` uses to bound its registry. */
 declare const PENDING: Set<State | (() => void)>;
+/** External lifecycle listeners for any given State class. */
+type Handler = State.On<any>;
+declare const SETUP: WeakMap<State.Extends<State>, Set<Handler>>;
+/** Reference bound instance methods, or their getter, to real one. */
+declare const UNBIND: WeakMap<any, any>;
+/** List of methods defined by a given type. */
+declare const METHODS: WeakMap<Function, Map<string, (value: any) => void>>;
+/** List of reactive getters defined by a given type. */
+declare const GETTERS: WeakMap<Function, Map<string, () => unknown>>;
+/** Replacement for a getter captured by live computed properties, for hot patching. */
+declare const LATEST: WeakMap<Function, Function>;
 declare namespace State {
   /** Any type of State, using own class constructor as its identifier. */
   type Extends<T extends State = State> = (abstract new (...args: any[]) => T) & typeof State;
@@ -30,10 +40,7 @@ declare namespace State {
    * will observe). Returned function will run when state is destroyed.
    */
   type Init<T extends State = State> = (this: T, thisArg: T) => Promise<void> | (() => void) | Args<T> | Assign<T> | void;
-  /**
-   * Lifecycle handlers for `State.on`, keyed by when they run. A bare `Init`
-   * function passed to `on` is sugar for `{ before }`.
-   */
+  /** Lifecycle handlers for `State.on`, keyed by when they run. */
   interface On<T extends State = State> {
     /**
      * Per-class setup, run once when the class is first bootstrapped - before
@@ -43,29 +50,39 @@ declare namespace State {
      */
     type?(type: State.Extends<T>): void;
     /**
-     * Per-instance setup, run in the `prepare` phase before `observe` and the
-     * `new()` hook. Equivalent to passing a bare function to `on`. May return a
-     * cleanup, constructor args, or an assign overlay.
+     * Per-instance, once constructed - before own values are observed and
+     * before constructor args and `new()`. May return a cleanup, constructor
+     * args, or an assign overlay.
+     */
+    setup?(this: T, self: T): void | (() => void) | Promise<void> | Args<T> | Assign<T>;
+    /**
+     * Per-instance, once ready - after own values are observed, constructor
+     * args applied and `new()` has run. May return a cleanup function.
      */
-    before?(this: T, thisArg: T): void | (() => void) | Promise<void> | Args<T> | Assign<T>;
+    ready?(this: T, self: T): void | (() => void);
     /**
-     * Per-instance setup, run at the `new()` slot - after own values are
-     * observed and constructor args applied. May return a cleanup function.
+     * Runs each time a method is bound to an instance - first access,
+     * reassignment, and the rebind after a hot patch - with the key, the bound
+     * function and the instance. Tooling and development use.
      */
-    after?(this: T, self: T): void | (() => void);
+    method?(this: T, key: string, fn: Function, self: T): void;
     /**
-     * Receives a `Caught` mvc reports for this State or a subclass - most-derived
-     * class first, last registered first. Return it (or a replacement) to pass it
-     * on; return nothing to handle it; throw to let it escape uncaught. Passed off
-     * the end, a warning logs and anything else is thrown - to the writer for a
-     * destroyed write, else uncaught.
+     * Receives what an effect, refreshing getter or async initializer of this State
+     * or a subclass threw, a destroyed write, or an instance never activated - with
+     * its `kind` (`effect`, `getter`, `setup`, `dead`, `unused`) and `key` where
+     * one applies. Most-derived class first, last registered first, each once. Return the error
+     * (or another) to pass it on; return nothing to handle it; throw to let it escape.
+     * Passed off the end, a destroyed write outputs nothing, `unused` warns,
+     * anything else escapes uncaught.
      */
-    catch?(this: T, error: Caught): Caught | void;
+    catch?(this: T, error: unknown, kind: 'effect' | 'getter' | 'setup' | 'dead' | 'unused', key?: string): unknown;
   }
   /** Object overlay to override values and methods on a state. */
-  type Assign<T> = Record<string, unknown> & { [K in Field<T>]?: T[K] extends ((...args: infer A) => infer R) ? (this: T, ...args: A) => R : T[K] };
+  type Assign<T> = Record<string, unknown> & { [K in Property<T>]?: T[K] extends ((...args: infer A) => infer R) ? (this: T, ...args: A) => R : T[K] };
   /** Subset of `keyof T` not defined by base State. **/
-  type Field<T> = Exclude<keyof T, keyof State>;
+  type Property<T> = Exclude<keyof T, keyof State>;
+  /** Managed subset of Property<T> - excludes unmanaged `_` keys. **/
+  type Field<T> = Exclude<Property<T>, `_${string}`>;
   /** Any valid key for state, including but not limited to Field<T>. */
   type Event<T = State> = Field<T> | number | symbol | (string & {});
   /** Any event signal dispatched to listeners, including lifecycle meta events. */
@@ -206,6 +223,18 @@ declare abstract class State {
    * @returns Function to cancel listener.
    */
   get<T extends State>(type: State.Type<T>, callback: Context.Expect<T>, downstream?: boolean): () => void;
+  /** Owner of this State. Throws if it has none. */
+  get<T extends typeof State>(type: T & (typeof State extends T ? unknown : never), required?: true): State;
+  /** Owner of this State. Undefined if it has none. */
+  get<T extends typeof State>(type: T & (typeof State extends T ? unknown : never), required: boolean): State | undefined;
+  /**
+   * Run a callback for each State this one owns - those owned now, then each
+   * one as it activates. Callback may return a function, called when that State
+   * is destroyed.
+   *
+   * @returns Function to stop watching.
+   */
+  get<T extends typeof State>(type: T & (typeof State extends T ? unknown : never), callback: (child: State) => void | (() => void), downstream: true): () => void;
   /**
    * Get update in progress.
    *
@@ -217,7 +246,7 @@ declare abstract class State {
    * Properties which are not managed by this state will be ignored.
    *
    * @param assign - Object with properties to update.
-   * @param silent - If true, listeners will not be notified. If state is destroyed, drops the update without reporting it.
+   * @param silent - If true, listeners will not be notified. If state is destroyed, stores the update without reporting it.
    * @returns Array of keys updated, syncronously contains keys updated immediately and may be resolved (to itself) when all updates are settled.
    */
   set(assign?: State.Assign<this>, silent?: boolean): State.Updated<this>;
@@ -251,7 +280,7 @@ declare abstract class State {
    */
   set(key: State.Event<this>): State.Updated<this>;
   /**
-   * Declare an end to updates. This event is final and will freeze state.
+   * Declare an end to updates. This event is final - later writes are stored but never dispatched.
    * This event can be watched for as well, to run cleanup logic and internally will remove all listeners.
    *
    * @param status - `null` to end updates.
@@ -300,16 +329,18 @@ declare abstract class State {
   /**
    * Register a lifecycle handler for this State and its subclasses.
    *
-   * A bare function is per-instance setup run in the `prepare` phase (sugar for
-   * `{ before }`); if it returns a function, that runs when the instance is
-   * destroyed. Pass a {@link State.On} object to hook by cadence - `type`
-   * (per-class, at bootstrap), `before` (per-instance, before `new()`), and
-   * `after` (per-instance, at the `new()` slot).
+   * Hooks by cadence - `type` (per-class, at bootstrap), `setup` (per-instance,
+   * before values are observed), `ready` (per-instance, after `new()`), and
+   * `method` (per method binding). A function alone is a `setup` handler. A
+   * function returned from `setup` or `ready` runs when the instance is destroyed.
    *
    * @returns Function to remove the handler.
    */
-  static on<T extends State>(this: State.Extends<T>, handler: State.Init<T> | State.On<T>): () => boolean;
+  static on<T extends State>(this: State.Extends<T>, setup: NonNullable<State.On<T>['setup']>): () => boolean;
+  static on<T extends State>(this: State.Extends<T>, handler: State.On<T>): () => boolean;
 }
+/** Bind own configurable methods of a type and collect its reactive getters. */
+declare function classify(type: State.Extends, keys: Map<string, (value: any) => void>, getters: Map<string, () => unknown>): void;
 /**
  * Install a reactive computed property on a state instance, derived from a prototype
  * getter or an arity-bearing `set` factory.
@@ -330,22 +361,37 @@ declare function compute(this: State, getter: (self: any) => unknown, key: strin
  * @param silent - If an update does occur, listeners will not be refreshed automatically.
  */
 declare function apply(state: State, key: string, config: State.Apply, silent?: boolean): void;
+/**
+ * Pending States constructed after this one - in a parent, the products of
+ * its own initializers, until the last one it kept.
+ */
+declare function trailing(state: State): State[];
 /**
  * Report States adopted by a parent - those already held, then each one
  * claimed later. Returns a callback to stop watching.
  */
 declare function children(state: State, callback: (child: State) => void): () => boolean;
+/**
+ * Report States owned by this one - those active now, then each one as it
+ * activates. A function returned by `callback` runs when that State is destroyed.
+ */
+declare function owned(state: State, callback: (child: State) => void | (() => void)): () => undefined;
 declare function access(state: State, property: string, required?: boolean): any;
 /**
  * Update a property on a state instance and notify listeners.
  *
  * 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.
  *
- * A destroyed state reports the write - thrown to the writer unless a `catch` handler takes it - and returns `false`; `silent` skips both, and dispatch.
+ * A destroyed state stores the write without dispatch, reports it unless `silent`, and returns `false`.
  */
 declare function update<T>(state: State, key: State.Event<T>, value: T, silent?: boolean, own?: boolean): boolean;
-/** Error thrown by a handler replaying in dispatch, attributed to the State which queued it. */
-declare function fault(err: unknown, owner?: object): void;
+/**
+ * Hand a value stored by an owning writer to that property's adopter,
+ * creating one the first time a State is stored there. A property which has
+ * held a State keeps its adopter, so a later non-State value releases the
+ * previous child.
+ */
+declare function adopt(state: State, key: unknown, value: unknown): void;
 /** Random alphanumberic of length 6; always starts with a letter. */
 declare function uid(): string;
 declare function unbind<T extends Function>(fn: T): T;
@@ -359,5 +405,5 @@ declare function unbind<T extends Function>(fn?: T): T | undefined;
 declare function parent(child: object): State | null | undefined;
 declare function parent(child: object, value: State | null): boolean;
 //#endregion
-export { PENDING, STORE, State, access, apply, children, compute, event, fault, parent, uid, unbind, update };
+export { GETTERS, type Handler, LATEST, METHODS, PENDING, SETUP, STORE, State, UNBIND, access, adopt, apply, children, classify, compute, event, owned, parent, trailing, uid, unbind, update };
 //# sourceMappingURL=state.d.ts.map