@expressive/mvc 0.87.0 → 0.88.0

package/dist/caught.js

@@ -1,64 +0,0 @@
-//#region src/caught.ts
-const about = (cause) => {
-	const text = cause instanceof Error ? cause.message : String(cause);
-	return text ? `: ${text}` : ".";
-};
-/**
-* Reported to `State.on({ catch })` handlers instead of being thrown or logged.
-* Unhandled, a `warning` goes to `console.warn`; anything else escapes uncaught.
-*/
-var Caught = class Caught extends Error {
-	name = "Caught";
-	/** Non-urgent - unhandled, it logs as a warning. */
-	warning = false;
-	constructor(state, message, key, cause) {
-		super(message, arguments.length > 3 ? { cause } : void 0);
-		this.key = key;
-		Object.defineProperty(this, "state", { value: state });
-	}
-	/** A `catch` handler logging what would otherwise escape uncaught; warnings and destroyed writes pass on. */
-	static log(error) {
-		if (error.warning || error instanceof Caught.Destroyed) return error;
-		console.error(error);
-	}
-	/** A write to a destroyed state - thrown to the writer unless a handler takes it. */
-	static Destroyed = class Destroyed extends Caught {
-		name = "Caught.Destroyed";
-		constructor(state, key) {
-			super(state, `Tried to update ${state}.${key} but state is destroyed.`, key);
-		}
-	};
-	/** A state constructed but never activated. */
-	static Inactive = class Inactive extends Caught {
-		name = "Caught.Inactive";
-		warning = true;
-		constructor(state) {
-			super(state, `${state} was constructed but never activated.`);
-		}
-	};
-	/** A getter threw while refreshing; `cause` is what it threw. */
-	static Getter = class Getter extends Caught {
-		name = "Caught.Getter";
-		constructor(state, key, cause) {
-			super(state, `An exception was thrown while refreshing ${state.constructor}.${key}${about(cause)}`, key, cause);
-		}
-	};
-	/** An async initializer rejected; `cause` is the rejection. */
-	static Init = class Init extends Caught {
-		name = "Caught.Init";
-		constructor(state, cause) {
-			super(state, `Async error in constructor for ${state.constructor}${about(cause)}`, void 0, cause);
-		}
-	};
-	/** An effect or listener threw during a dispatch flush; `cause` is what it threw. */
-	static Effect = class Effect extends Caught {
-		name = "Caught.Effect";
-		constructor(state, cause) {
-			super(state, `An exception was thrown by an effect of ${state.constructor}${about(cause)}`, void 0, cause);
-		}
-	};
-};
-
-//#endregion
-export { Caught };
-//# sourceMappingURL=caught.js.map

package/dist/caught.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"caught.js","names":[],"sources":["../src/caught.ts"],"sourcesContent":["import type { State } from './state';\n\nconst about = (cause: unknown) => {\n  const text = cause instanceof Error ? cause.message : String(cause);\n  return text ? `: ${text}` : '.';\n};\n\n/**\n * Reported to `State.on({ catch })` handlers instead of being thrown or logged.\n * Unhandled, a `warning` goes to `console.warn`; anything else escapes uncaught.\n */\nclass Caught extends Error {\n  readonly name: string = 'Caught';\n\n  /** Non-urgent - unhandled, it logs as a warning. */\n  readonly warning: boolean = false;\n\n  declare readonly state: State;\n\n  constructor(\n    state: State,\n    message: string,\n    readonly key?: string,\n    cause?: unknown\n  ) {\n    super(message, arguments.length > 3 ? { cause } : undefined);\n    Object.defineProperty(this, 'state', { value: state });\n  }\n\n  /** A `catch` handler logging what would otherwise escape uncaught; warnings and destroyed writes pass on. */\n  static log(error: Caught): Caught | void {\n    if (error.warning || error instanceof Caught.Destroyed) return error;\n    console.error(error);\n  }\n\n  /** A write to a destroyed state - thrown to the writer unless a handler takes it. */\n  static Destroyed = class Destroyed extends Caught {\n    readonly name = 'Caught.Destroyed';\n\n    constructor(state: State, key: string) {\n      super(state, `Tried to update ${state}.${key} but state is destroyed.`, key);\n    }\n  };\n\n  /** A state constructed but never activated. */\n  static Inactive = class Inactive extends Caught {\n    readonly name = 'Caught.Inactive';\n    readonly warning = true;\n\n    constructor(state: State) {\n      super(state, `${state} was constructed but never activated.`);\n    }\n  };\n\n  /** A getter threw while refreshing; `cause` is what it threw. */\n  static Getter = class Getter extends Caught {\n    readonly name = 'Caught.Getter';\n\n    constructor(state: State, key: string, cause: unknown) {\n      super(state, `An exception was thrown while refreshing ${state.constructor}.${key}${about(cause)}`, key, cause);\n    }\n  };\n\n  /** An async initializer rejected; `cause` is the rejection. */\n  static Init = class Init extends Caught {\n    readonly name = 'Caught.Init';\n\n    constructor(state: State, cause: unknown) {\n      super(state, `Async error in constructor for ${state.constructor}${about(cause)}`, undefined, cause);\n    }\n  };\n\n  /** An effect or listener threw during a dispatch flush; `cause` is what it threw. */\n  static Effect = class Effect extends Caught {\n    readonly name = 'Caught.Effect';\n\n    constructor(state: State, cause: unknown) {\n      super(state, `An exception was thrown by an effect of ${state.constructor}${about(cause)}`, undefined, cause);\n    }\n  };\n}\n\ndeclare namespace Caught {\n  type Destroyed = InstanceType<typeof Caught.Destroyed>;\n  type Inactive = InstanceType<typeof Caught.Inactive>;\n  type Getter = InstanceType<typeof Caught.Getter>;\n  type Init = InstanceType<typeof Caught.Init>;\n  type Effect = InstanceType<typeof Caught.Effect>;\n}\n\nexport { Caught };\n"],"mappings":";AAEA,MAAM,SAAS,UAAmB;CAChC,MAAM,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACnE,QAAO,OAAO,KAAK,SAAS;;;;;;AAO9B,IAAM,SAAN,MAAM,eAAe,MAAM;CACzB,AAAS,OAAe;;CAGxB,AAAS,UAAmB;CAI5B,YACE,OACA,SACA,AAAS,KACT,OACA;AACA,QAAM,SAAS,UAAU,SAAS,IAAI,EAAE,OAAO,GAAG,OAAU;EAHnD;AAIT,SAAO,eAAe,MAAM,SAAS,EAAE,OAAO,OAAO,CAAC;;;CAIxD,OAAO,IAAI,OAA8B;AACvC,MAAI,MAAM,WAAW,iBAAiB,OAAO,UAAW,QAAO;AAC/D,UAAQ,MAAM,MAAM;;;CAItB,OAAO,YAAY,MAAM,kBAAkB,OAAO;EAChD,AAAS,OAAO;EAEhB,YAAY,OAAc,KAAa;AACrC,SAAM,OAAO,mBAAmB,MAAM,GAAG,IAAI,2BAA2B,IAAI;;;;CAKhF,OAAO,WAAW,MAAM,iBAAiB,OAAO;EAC9C,AAAS,OAAO;EAChB,AAAS,UAAU;EAEnB,YAAY,OAAc;AACxB,SAAM,OAAO,GAAG,MAAM,uCAAuC;;;;CAKjE,OAAO,SAAS,MAAM,eAAe,OAAO;EAC1C,AAAS,OAAO;EAEhB,YAAY,OAAc,KAAa,OAAgB;AACrD,SAAM,OAAO,4CAA4C,MAAM,YAAY,GAAG,MAAM,MAAM,MAAM,IAAI,KAAK,MAAM;;;;CAKnH,OAAO,OAAO,MAAM,aAAa,OAAO;EACtC,AAAS,OAAO;EAEhB,YAAY,OAAc,OAAgB;AACxC,SAAM,OAAO,kCAAkC,MAAM,cAAc,MAAM,MAAM,IAAI,QAAW,MAAM;;;;CAKxG,OAAO,SAAS,MAAM,eAAe,OAAO;EAC1C,AAAS,OAAO;EAEhB,YAAY,OAAc,OAAgB;AACxC,SAAM,OAAO,2CAA2C,MAAM,cAAc,MAAM,MAAM,IAAI,QAAW,MAAM"}

package/dist/runtime.d.ts

@@ -1,72 +0,0 @@
-import { hot_d_exports } from "./hot.js";
-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;
-  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 seam). Element mechanics
- * the host leaves unset keep defaults that throw a setup-pointing error;
- * `jsxDEV` is routed around at the call site instead.
- */
-declare function host(runtime: HostRuntime): void;
-declare function jsx(type: unknown, props: object, key?: unknown): Component.Node;
-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>;
-//#endregion
-export { Fragment, Host, HostRuntime, childrenOf, host, hot_d_exports as hot, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
-//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -1,70 +0,0 @@
-import { hot_exports } from "./hot.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 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, host, hot_exports as hot, isElement, jsx, jsxDEV, jsxs, propsOf, typeOf };
-//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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