@gyral/core 0.3.0 → 0.3.1

package/dist/types.d.ts

@@ -1,19 +1,21 @@
+import type { GyralError } from './errors.js';
 import type { Prop } from './prop.js';
 import type { ChildValue, Styles } from './view/index.js';
 import type { CommandInfo } from './invokers.js';
 import type { HydrateStrategy } from './islands.js';
-import type { DriverOverrides, Next } from './command.js';
+import type { Command, Next } from './command.js';
 import type { AnyStore, StoreChanged, StoreRef } from './store.js';
+import type { FormAssociation, FormDisabled, FormReset, FormStateRestore } from './form-associated.js';
 /** Every message is a tagged object; the tag is also the intent name used in markup. */
 export interface Tagged {
     readonly _tag: string;
 }
-/** What the intent layer sees when a `data-intent` element fires its trigger event. */
+/** What the intent layer sees when an element's intent fires. */
 export interface IntentInput {
-    /** The `data-intent` value (a message tag). */
+    /** The intent's name (a message tag): the `data-intent-<event>` or `data-intent` value. */
     readonly name: string;
     readonly event: Event;
-    /** The element carrying `data-intent`. */
+    /** The element carrying the intent attribute (`event.currentTarget` is Gyral's root). */
     readonly target: Element;
     /** `value` of the input, select, textarea or button that carries the intent. */
     readonly value: string | undefined;
@@ -21,7 +23,10 @@ export interface IntentInput {
     readonly checked: boolean | undefined;
     /** Submitted data (including the submitter button) when the intent is on a `<form>`. */
     readonly formData: FormData | undefined;
-    /** The output a child component emitted, when the intent is on a child element. */
+    /**
+     * `detail` of any `CustomEvent`: a Gyral child's output, or the event of another custom
+     * element (a map's `marker-select`). Unknown until the parser checks it (a guard, a schema).
+     */
     readonly detail: unknown;
     /** `KeyboardEvent.key` for `keydown`/`keyup` intents. */
     readonly key: string | undefined;
@@ -39,6 +44,15 @@ export interface Ctx<P> {
     /** Stores from the side: `read(cart).lines`. The store must be in `spec.stores`. */
     readonly read: StoreReader;
 }
+/**
+ * What an intent parser gets besides the input: the reducers' context plus the component's
+ * current state, read-only. Parsers decide synchronously (`preventDefault()`), and where the
+ * user is often decides it: Tab leaves a grid only from its last cell.
+ */
+export interface ParserCtx<P, S = unknown> extends Ctx<P> {
+    /** The state when the event fires. */
+    readonly state: Readonly<S>;
+}
 /** Framework message: declared props changed after the first render (ADR 0007). */
 export interface PropsChanged<P> {
     readonly _tag: 'PropsChanged';
@@ -56,6 +70,17 @@ export interface Hydrated {
     /** `true` when the instance resumed from server-rendered markup (a hydration seed). */
     readonly serverRendered: boolean;
 }
+/**
+ * Framework message (ADR 0024): an update, an intent parser or a command of this component
+ * failed. The failure was reported (`reportError`, or claimed by an ancestor's boundary) and
+ * changed nothing; reduce it to show an error state or to reset. A failure while reducing
+ * `Errored` is reported and not sent again.
+ */
+export interface Errored {
+    readonly _tag: 'Errored';
+    readonly phase: 'update' | 'parse' | 'command';
+    readonly error: GyralError;
+}
 /** One validation problem. `path` is dot-joined and matches the field's `name`. */
 export interface FieldIssue {
     readonly path: string;
@@ -78,15 +103,40 @@ export interface IntentRejected {
 type ParseResult<M> = M | IntentRejected | undefined;
 /**
  * Parses a platform event into one message variant, `IntentRejected`, or `undefined` to
- * ignore it. May be async because schema validation may be.
+ * decline it: a synchronous `undefined` passes the event to the next intent outward for the
+ * same event (view/05-element.md "Declining"). May be async because schema validation may be;
+ * an async parser keeps the event. `ctx` is the read-only context reducers get (props as
+ * they are when the event fires, `read(store)`) plus `state`, the component's state at that
+ * moment; parsers that don't need it take one parameter.
  */
-export type IntentParser<M> = (input: IntentInput) => ParseResult<M> | Promise<ParseResult<M>>;
-type Variant<M extends Tagged, K extends M['_tag']> = Extract<M, {
+export type IntentParser<M, P = unknown, S = unknown> = (input: IntentInput, ctx: ParserCtx<P, S>) => ParseResult<M> | Promise<ParseResult<M>>;
+type Variant<M extends Tagged, K> = Extract<M, {
     readonly _tag: K;
 }>;
-/** Intent parsers keyed by the message tag they produce. Messages from drivers need none. */
-export type Intents<M extends Tagged> = {
-    readonly [K in M['_tag']]?: IntentParser<Variant<M, K>>;
+/**
+ * The parser for intent name `K` (ADR 0023): a name that is a message tag parses into that
+ * variant; any other name is an intent of its own whose parser may produce any message.
+ */
+export type ParserFor<M extends Tagged, P, K, S = unknown> = string extends K ? // The wide form (any intent name), which every specific spec is assignable to.
+IntentParser<M, P, S> | true | TrueOnlyForFieldlessMessage : K extends M['_tag'] ? IntentParser<Variant<M, K>, P, S> | TagOnly<Variant<M, K>> : IntentParser<M, P, S>;
+/**
+ * `true` in the intent table: the intent sends its own tag, `{ _tag: K }` (as Elm's `onClick
+ * Deal` names the message itself). Only for a variant with no field besides `_tag`; for any
+ * other the type names the rule.
+ */
+type TagOnly<V> = [Exclude<keyof V, '_tag'>] extends [never] ? true : TrueOnlyForFieldlessMessage;
+interface TrueOnlyForFieldlessMessage {
+    readonly 'true only sends a message with no fields besides _tag; write a parser': never;
+}
+/**
+ * Intent parsers keyed by intent name (ADR 0001, ADR 0023). The keys are the component's
+ * intent names: `define<State, Msg>()(tag, { intent: { Archive: …, Increment: … } })` gives the
+ * view `i.Archive` and `i.Increment`. A key that is a message tag must return that variant; any
+ * other key may return any message (several controls that change one thing can also share one
+ * intent and tell themselves apart by `name`). Messages from drivers need no parser.
+ */
+export type Intents<M extends Tagged, P = unknown, N extends string = string, S = unknown> = {
+    readonly [K in N]: ParserFor<M, P, K, S>;
 };
 type Reducer<S, M, Msg, P> = (state: S, msg: Msg, ctx: Ctx<P>) => Next<S, M>;
 /**
@@ -100,10 +150,17 @@ export type Update<S, M extends Tagged, P = object> = {
     readonly IntentRejected?: Reducer<S, M, IntentRejected, P>;
     readonly StoreChanged?: Reducer<S, M, StoreChanged, P>;
     readonly Hydrated?: Reducer<S, M, Hydrated, P>;
+    readonly Errored?: Reducer<S, M, Errored, P>;
+    readonly FormReset?: Reducer<S, M, FormReset, P>;
+    readonly FormDisabled?: Reducer<S, M, FormDisabled, P>;
+    readonly FormStateRestore?: Reducer<S, M, FormStateRestore, P>;
 };
-/** Typed intent names handed to the view, so `data-intent=${i.Increment}` is checked. */
-export type IntentNames<M extends Tagged> = {
-    readonly [K in M['_tag']]: K;
+/**
+ * A component's intent names, the keys of its `intent` object, as the view's `i` and as
+ * `intentsOf<typeof C>()`, so `data-intent=${i.Increment}` is checked (ADR 0023).
+ */
+export type IntentNames<N extends string> = {
+    readonly [K in N]: K;
 };
 /**
  * The prop builders for props type `P` (view/05-element.md "Props"): one `prop.*` builder per
@@ -123,16 +180,50 @@ type InitField<S, M extends Tagged, P> = Stateless extends S ? {
 } : {
     readonly init: Init<S, M, P>;
 };
-export type ComponentSpec<S, M extends Tagged, P> = SpecBody<S, M, P> & InitField<S, M, P>;
-interface SpecBody<S, M extends Tagged, P> {
+/**
+ * A component spec. `N` is the component's intent names, the keys of `intent` (ADR 0023).
+ */
+export type ComponentSpec<S, M extends Tagged, P, N extends string = string> = SpecBody<S, M, P, N> & IntentField<S, M, P, N> & UpdateField<S, M, P> & InitField<S, M, P>;
+interface IntentField<S, M extends Tagged, P, N extends string> {
+    /**
+     * INTENT: platform events to messages, keyed by intent name (ADR 0023). `Key: true` sends
+     * `{ _tag: 'Key' }`. Omit it when the component handles no events.
+     */
+    readonly intent?: Intents<M, P, N, S>;
+}
+type UpdateField<S, M extends Tagged, P> = [M] extends [never] ? {
+    /** MODEL: pure state transitions (only framework messages for a component without any). */
+    readonly update?: Update<S, M, P>;
+} : {
+    /** MODEL: pure state transitions, one reducer per message tag. */
+    readonly update: Update<S, M, P>;
+};
+/**
+ * `spec.shadow`: `true` (the default) or an object for a shadow root, `false` for light DOM.
+ * `delegatesFocus: true`: focusing the host, or clicking a non-focusable part of it, focuses its
+ * first focusable element, and `:focus` matches the host while focus is inside; the server
+ * writes `shadowrootdelegatesfocus` on the declarative shadow root (view/05-element.md "Focus").
+ */
+export type ShadowOption = boolean | {
+    readonly delegatesFocus?: boolean;
+};
+interface SpecBody<S, M extends Tagged, P, N extends string> {
+    /** Native form participation with pure value, restoration-state and validity projections. */
+    readonly formAssociated?: FormAssociation<S, P>;
     /** The component's inputs, declared with `prop.*` builders. */
     readonly props?: PropDeclarations<P>;
-    /** INTENT: platform events to messages. */
-    readonly intent: Intents<M>;
-    /** MODEL: pure state transitions. */
-    readonly update: Update<S, M, P>;
-    /** VIEW: pure function of state and props. Name intents in markup; never attach closures. */
-    readonly view: (state: S, intents: IntentNames<M>, ctx: Ctx<P>) => ChildValue;
+    /**
+     * VIEW: pure function of state and props. Name intents in markup; never attach closures.
+     * (A method, so a class typed with fewer intent names, e.g. `GyralElementClass<S, M, P, O>`
+     * for a recursive component, still accepts it.)
+     */
+    view(state: S, intents: IntentNames<N>, ctx: Ctx<P>): ChildValue;
+    /**
+     * What to show when `init` or the view throws (ADR 0024): `state` is `undefined` when `init`
+     * threw. Without it, a failed first render leaves the host empty and a failed later render
+     * keeps its previous DOM. A fallback that throws too is reported and the previous DOM stays.
+     */
+    error?(failure: GyralError, state: S | undefined): ChildValue;
     /**
      * Shadow-root styles: `css` values, plain CSS strings, or arrays of them, nested freely.
      * Each maps to one shared `CSSStyleSheet`. Ignored (with a warning) when `shadow: false`.
@@ -142,18 +233,15 @@ interface SpecBody<S, M extends Tagged, P> {
      * `false` renders the view as the element's own light-DOM children (ADR 0014): document CSS
      * applies, and the server writes plain children instead of a `<template shadowrootmode>`.
      * For page-level components (listings, articles). No `<slot>`s and no `styles`. Default `true`.
+     * An object configures the shadow root (`{ delegatesFocus: true }`).
      */
-    readonly shadow?: boolean;
+    readonly shadow?: ShadowOption;
     /**
      * When a server-rendered instance hydrates (gyral-4k7.4): `load` (default), `idle`,
      * `visible` (scrolled into view) or `interaction` (first pointer/focus). Client-only
      * renders are unaffected.
      */
     readonly hydrate?: HydrateStrategy;
-    /** Extra event types that may trigger intents via `data-intent-on` (e.g. `pointerdown`). */
-    readonly events?: readonly string[];
-    /** Driver substitutions by name, for every instance (ADR 0006). */
-    readonly drivers?: DriverOverrides;
     /**
      * Stores this component reads with `ctx.read(store)` and writes with `send(store, msg)`.
      * Their changes re-render it (and reach the optional `StoreChanged` reducer). ADR 0013.
@@ -178,5 +266,14 @@ interface SpecBody<S, M extends Tagged, P> {
      * `gy-x:state(loading)`. Applied after each render; feature-detected; not on the server.
      */
     readonly states?: (state: S) => Readonly<Record<string, boolean>>;
+    /**
+     * The long-lived commands that should be running now (ADR 0025): polling, clocks, sockets,
+     * store or media-query watches. Evaluated after init, every update and every props change;
+     * the runtime starts lanes that appear, aborts lanes that disappear, and restarts a lane whose
+     * input changed (compared by JSON text). They stop with the host's other commands on removal
+     * and start again from the current state when it is attached again:
+     * `subscriptions: (s, p) => (s.live ? [every(30_000, (now) => ({ _tag: 'Tick', now }))] : [])`.
+     */
+    readonly subscriptions?: (state: S, props: P) => readonly Command<M>[];
 }
 export {};

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Prop } from './prop.js';\nimport type { ChildValue, Styles } from './view/index.js';\nimport type { CommandInfo } from './invokers.js';\nimport type { HydrateStrategy } from './islands.js';\nimport type { DriverOverrides, Next } from './command.js';\nimport type { AnyStore, StoreChanged, StoreRef } from './store.js';\n\n/** Every message is a tagged object; the tag is also the intent name used in markup. */\nexport interface Tagged {\n  readonly _tag: string;\n}\n\n/** What the intent layer sees when a `data-intent` element fires its trigger event. */\nexport interface IntentInput {\n  /** The `data-intent` value (a message tag). */\n  readonly name: string;\n  readonly event: Event;\n  /** The element carrying `data-intent`. */\n  readonly target: Element;\n  /** `value` of the input, select, textarea or button that carries the intent. */\n  readonly value: string | undefined;\n  /** `checked` for checkbox and radio inputs. */\n  readonly checked: boolean | undefined;\n  /** Submitted data (including the submitter button) when the intent is on a `<form>`. */\n  readonly formData: FormData | undefined;\n  /** The output a child component emitted, when the intent is on a child element. */\n  readonly detail: unknown;\n  /** `KeyboardEvent.key` for `keydown`/`keyup` intents. */\n  readonly key: string | undefined;\n  /** For `toggle` intents (popover, `<details>`): the state it changed to. */\n  readonly newState: 'open' | 'closed' | undefined;\n  /** For `command` intents: the invoker's command (e.g. `--clear`) and source (gyral-czi.6). */\n  readonly command: CommandInfo | undefined;\n}\n\n/** Reads a declared store's current state, typed by the store (ADR 0013). */\nexport type StoreReader = <S>(store: StoreRef<S>) => S;\n\n/** Read-only context handed to every reducer and to the view (ADR 0007, 0013). */\nexport interface Ctx<P> {\n  /** Props from above. */\n  readonly props: P;\n  /** Stores from the side: `read(cart).lines`. The store must be in `spec.stores`. */\n  readonly read: StoreReader;\n}\n\n/** Framework message: declared props changed after the first render (ADR 0007). */\nexport interface PropsChanged<P> {\n  readonly _tag: 'PropsChanged';\n  readonly props: P;\n  readonly prev: P;\n}\n\n/**\n * Framework message: the component is live in the browser (ADR 0012 addendum). Sent once,\n * after the first client render has completed, to every client-side instance. Use it for\n * progressive enhancement: render the no-JS form on the server and in the first client render\n * (so hydration matches), then switch to the enhanced UI in the `Hydrated` reducer.\n */\nexport interface Hydrated {\n  readonly _tag: 'Hydrated';\n  /** `true` when the instance resumed from server-rendered markup (a hydration seed). */\n  readonly serverRendered: boolean;\n}\n\n/** One validation problem. `path` is dot-joined and matches the field's `name`. */\nexport interface FieldIssue {\n  readonly path: string;\n  readonly message: string;\n}\n\n/** Submitted text values of a form (Files are dropped: they can't be re-filled). */\nexport type FormFields = Readonly<Record<string, string | readonly string[]>>;\n\n/** Framework message: an intent's input failed schema validation (ADR 0008). */\nexport interface IntentRejected {\n  readonly _tag: 'IntentRejected';\n  /** The `data-intent` name whose input was rejected. */\n  readonly intent: string;\n  readonly issues: readonly FieldIssue[];\n  /**\n   * For `form()` rejections: what the user submitted, so the view can re-fill the form. On\n   * the no-JS path (ADR 0008 server half) the server re-renders the page from this.\n   */\n  // `| undefined` so schemas with plain optional fields (valibot `optional`) can produce it.\n  readonly values?: FormFields | undefined;\n}\n\ntype ParseResult<M> = M | IntentRejected | undefined;\n\n/**\n * Parses a platform event into one message variant, `IntentRejected`, or `undefined` to\n * ignore it. May be async because schema validation may be.\n */\nexport type IntentParser<M> = (input: IntentInput) => ParseResult<M> | Promise<ParseResult<M>>;\n\ntype Variant<M extends Tagged, K extends M['_tag']> = Extract<M, { readonly _tag: K }>;\n\n/** Intent parsers keyed by the message tag they produce. Messages from drivers need none. */\nexport type Intents<M extends Tagged> = {\n  readonly [K in M['_tag']]?: IntentParser<Variant<M, K>>;\n};\n\ntype Reducer<S, M, Msg, P> = (state: S, msg: Msg, ctx: Ctx<P>) => Next<S, M>;\n\n/**\n * One pure reducer per message tag (exhaustive by construction), plus optional reducers\n * for framework messages. Reducers may return commands.\n */\nexport type Update<S, M extends Tagged, P = object> = {\n  readonly [K in M['_tag']]: Reducer<S, M, Variant<M, K>, P>;\n} & {\n  readonly PropsChanged?: Reducer<S, M, PropsChanged<P>, P>;\n  readonly IntentRejected?: Reducer<S, M, IntentRejected, P>;\n  readonly StoreChanged?: Reducer<S, M, StoreChanged, P>;\n  readonly Hydrated?: Reducer<S, M, Hydrated, P>;\n};\n\n/** Typed intent names handed to the view, so `data-intent=${i.Increment}` is checked. */\nexport type IntentNames<M extends Tagged> = { readonly [K in M['_tag']]: K };\n\n/**\n * The prop builders for props type `P` (view/05-element.md \"Props\"): one `prop.*` builder per\n * key. A builder's output type must fit the prop's type, so a prop whose type excludes\n * `undefined` needs `required: true` or a `default` (the honesty rule, ADR 0007 addendum).\n * Without explicit type arguments, `define()` infers `P` from the builders.\n */\nexport type PropDeclarations<P> = { readonly [K in keyof P]-?: Prop<P[K]> };\n\n/** State of a component that keeps none (a pure view of its props). Its `init` is optional. */\nexport type Stateless = Readonly<Record<string, never>>;\n\n/** Initial model state (and optional commands), computed from props on first render. */\ntype Init<S, M, P> = (props: P) => Next<S, M>;\n\n// `init` may be omitted only when an empty object is a valid state (Stateless, all-optional).\ntype InitField<S, M extends Tagged, P> = Stateless extends S\n  ? { readonly init?: Init<S, M, P> }\n  : { readonly init: Init<S, M, P> };\n\nexport type ComponentSpec<S, M extends Tagged, P> = SpecBody<S, M, P> & InitField<S, M, P>;\n\ninterface SpecBody<S, M extends Tagged, P> {\n  /** The component's inputs, declared with `prop.*` builders. */\n  readonly props?: PropDeclarations<P>;\n  /** INTENT: platform events to messages. */\n  readonly intent: Intents<M>;\n  /** MODEL: pure state transitions. */\n  readonly update: Update<S, M, P>;\n  /** VIEW: pure function of state and props. Name intents in markup; never attach closures. */\n  readonly view: (state: S, intents: IntentNames<M>, ctx: Ctx<P>) => ChildValue;\n  /**\n   * Shadow-root styles: `css` values, plain CSS strings, or arrays of them, nested freely.\n   * Each maps to one shared `CSSStyleSheet`. Ignored (with a warning) when `shadow: false`.\n   */\n  readonly styles?: Styles;\n  /**\n   * `false` renders the view as the element's own light-DOM children (ADR 0014): document CSS\n   * applies, and the server writes plain children instead of a `<template shadowrootmode>`.\n   * For page-level components (listings, articles). No `<slot>`s and no `styles`. Default `true`.\n   */\n  readonly shadow?: boolean;\n  /**\n   * When a server-rendered instance hydrates (gyral-4k7.4): `load` (default), `idle`,\n   * `visible` (scrolled into view) or `interaction` (first pointer/focus). Client-only\n   * renders are unaffected.\n   */\n  readonly hydrate?: HydrateStrategy;\n  /** Extra event types that may trigger intents via `data-intent-on` (e.g. `pointerdown`). */\n  readonly events?: readonly string[];\n  /** Driver substitutions by name, for every instance (ADR 0006). */\n  readonly drivers?: DriverOverrides;\n  /**\n   * Stores this component reads with `ctx.read(store)` and writes with `send(store, msg)`.\n   * Their changes re-render it (and reach the optional `StoreChanged` reducer). ADR 0013.\n   */\n  readonly stores?: readonly AnyStore[];\n  /**\n   * Return `true` to render this state change inside a View Transition (route changes, list\n   * reorders). Skipped without browser support or when reduced motion is requested.\n   */\n  readonly viewTransition?: (prev: S, next: S, msg: Tagged) => boolean;\n  /**\n   * Messages from bursty sources (a WebSocket feed, a sensor) whose renders wait for the next\n   * animation frame, so many messages in one frame cost one render: `renderOnFrame: ['Ticked']`.\n   * Reducers still run at once. Any other change to the component renders in the usual\n   * microtask flush, taking pending frame work with it. `'StoreChanged'` covers store changes.\n   * Pages that get no frames (hidden) render from a 100 ms timer. view/04-scheduler.md.\n   */\n  readonly renderOnFrame?: readonly (M['_tag'] | 'StoreChanged')[];\n  /**\n   * Boolean facts about the state, exposed to CSS as custom states:\n   * `states: (s) => ({ loading: s._tag === 'Loading' })` enables `:host(:state(loading))` and\n   * `gy-x:state(loading)`. Applied after each render; feature-detected; not on the server.\n   */\n  readonly states?: (state: S) => Readonly<Record<string, boolean>>;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { GyralError } from './errors.js';\nimport type { Prop } from './prop.js';\nimport type { ChildValue, Styles } from './view/index.js';\nimport type { CommandInfo } from './invokers.js';\nimport type { HydrateStrategy } from './islands.js';\nimport type { Command, Next } from './command.js';\nimport type { AnyStore, StoreChanged, StoreRef } from './store.js';\nimport type {\n  FormAssociation,\n  FormDisabled,\n  FormReset,\n  FormStateRestore,\n} from './form-associated.js';\n\n/** Every message is a tagged object; the tag is also the intent name used in markup. */\nexport interface Tagged {\n  readonly _tag: string;\n}\n\n/** What the intent layer sees when an element's intent fires. */\nexport interface IntentInput {\n  /** The intent's name (a message tag): the `data-intent-<event>` or `data-intent` value. */\n  readonly name: string;\n  readonly event: Event;\n  /** The element carrying the intent attribute (`event.currentTarget` is Gyral's root). */\n  readonly target: Element;\n  /** `value` of the input, select, textarea or button that carries the intent. */\n  readonly value: string | undefined;\n  /** `checked` for checkbox and radio inputs. */\n  readonly checked: boolean | undefined;\n  /** Submitted data (including the submitter button) when the intent is on a `<form>`. */\n  readonly formData: FormData | undefined;\n  /**\n   * `detail` of any `CustomEvent`: a Gyral child's output, or the event of another custom\n   * element (a map's `marker-select`). Unknown until the parser checks it (a guard, a schema).\n   */\n  readonly detail: unknown;\n  /** `KeyboardEvent.key` for `keydown`/`keyup` intents. */\n  readonly key: string | undefined;\n  /** For `toggle` intents (popover, `<details>`): the state it changed to. */\n  readonly newState: 'open' | 'closed' | undefined;\n  /** For `command` intents: the invoker's command (e.g. `--clear`) and source (gyral-czi.6). */\n  readonly command: CommandInfo | undefined;\n}\n\n/** Reads a declared store's current state, typed by the store (ADR 0013). */\nexport type StoreReader = <S>(store: StoreRef<S>) => S;\n\n/** Read-only context handed to every reducer and to the view (ADR 0007, 0013). */\nexport interface Ctx<P> {\n  /** Props from above. */\n  readonly props: P;\n  /** Stores from the side: `read(cart).lines`. The store must be in `spec.stores`. */\n  readonly read: StoreReader;\n}\n\n/**\n * What an intent parser gets besides the input: the reducers' context plus the component's\n * current state, read-only. Parsers decide synchronously (`preventDefault()`), and where the\n * user is often decides it: Tab leaves a grid only from its last cell.\n */\nexport interface ParserCtx<P, S = unknown> extends Ctx<P> {\n  /** The state when the event fires. */\n  readonly state: Readonly<S>;\n}\n\n/** Framework message: declared props changed after the first render (ADR 0007). */\nexport interface PropsChanged<P> {\n  readonly _tag: 'PropsChanged';\n  readonly props: P;\n  readonly prev: P;\n}\n\n/**\n * Framework message: the component is live in the browser (ADR 0012 addendum). Sent once,\n * after the first client render has completed, to every client-side instance. Use it for\n * progressive enhancement: render the no-JS form on the server and in the first client render\n * (so hydration matches), then switch to the enhanced UI in the `Hydrated` reducer.\n */\nexport interface Hydrated {\n  readonly _tag: 'Hydrated';\n  /** `true` when the instance resumed from server-rendered markup (a hydration seed). */\n  readonly serverRendered: boolean;\n}\n\n/**\n * Framework message (ADR 0024): an update, an intent parser or a command of this component\n * failed. The failure was reported (`reportError`, or claimed by an ancestor's boundary) and\n * changed nothing; reduce it to show an error state or to reset. A failure while reducing\n * `Errored` is reported and not sent again.\n */\nexport interface Errored {\n  readonly _tag: 'Errored';\n  readonly phase: 'update' | 'parse' | 'command';\n  readonly error: GyralError;\n}\n\n/** One validation problem. `path` is dot-joined and matches the field's `name`. */\nexport interface FieldIssue {\n  readonly path: string;\n  readonly message: string;\n}\n\n/** Submitted text values of a form (Files are dropped: they can't be re-filled). */\nexport type FormFields = Readonly<Record<string, string | readonly string[]>>;\n\n/** Framework message: an intent's input failed schema validation (ADR 0008). */\nexport interface IntentRejected {\n  readonly _tag: 'IntentRejected';\n  /** The `data-intent` name whose input was rejected. */\n  readonly intent: string;\n  readonly issues: readonly FieldIssue[];\n  /**\n   * For `form()` rejections: what the user submitted, so the view can re-fill the form. On\n   * the no-JS path (ADR 0008 server half) the server re-renders the page from this.\n   */\n  // `| undefined` so schemas with plain optional fields (valibot `optional`) can produce it.\n  readonly values?: FormFields | undefined;\n}\n\ntype ParseResult<M> = M | IntentRejected | undefined;\n\n/**\n * Parses a platform event into one message variant, `IntentRejected`, or `undefined` to\n * decline it: a synchronous `undefined` passes the event to the next intent outward for the\n * same event (view/05-element.md \"Declining\"). May be async because schema validation may be;\n * an async parser keeps the event. `ctx` is the read-only context reducers get (props as\n * they are when the event fires, `read(store)`) plus `state`, the component's state at that\n * moment; parsers that don't need it take one parameter.\n */\nexport type IntentParser<M, P = unknown, S = unknown> = (\n  input: IntentInput,\n  ctx: ParserCtx<P, S>,\n) => ParseResult<M> | Promise<ParseResult<M>>;\n\ntype Variant<M extends Tagged, K> = Extract<M, { readonly _tag: K }>;\n\n/**\n * The parser for intent name `K` (ADR 0023): a name that is a message tag parses into that\n * variant; any other name is an intent of its own whose parser may produce any message.\n */\nexport type ParserFor<M extends Tagged, P, K, S = unknown> = string extends K\n  ? // The wide form (any intent name), which every specific spec is assignable to.\n    IntentParser<M, P, S> | true | TrueOnlyForFieldlessMessage\n  : K extends M['_tag']\n    ? IntentParser<Variant<M, K>, P, S> | TagOnly<Variant<M, K>>\n    : IntentParser<M, P, S>;\n\n/**\n * `true` in the intent table: the intent sends its own tag, `{ _tag: K }` (as Elm's `onClick\n * Deal` names the message itself). Only for a variant with no field besides `_tag`; for any\n * other the type names the rule.\n */\ntype TagOnly<V> = [Exclude<keyof V, '_tag'>] extends [never] ? true : TrueOnlyForFieldlessMessage;\n\ninterface TrueOnlyForFieldlessMessage {\n  readonly 'true only sends a message with no fields besides _tag; write a parser': never;\n}\n\n/**\n * Intent parsers keyed by intent name (ADR 0001, ADR 0023). The keys are the component's\n * intent names: `define<State, Msg>()(tag, { intent: { Archive: …, Increment: … } })` gives the\n * view `i.Archive` and `i.Increment`. A key that is a message tag must return that variant; any\n * other key may return any message (several controls that change one thing can also share one\n * intent and tell themselves apart by `name`). Messages from drivers need no parser.\n */\nexport type Intents<M extends Tagged, P = unknown, N extends string = string, S = unknown> = {\n  readonly [K in N]: ParserFor<M, P, K, S>;\n};\n\ntype Reducer<S, M, Msg, P> = (state: S, msg: Msg, ctx: Ctx<P>) => Next<S, M>;\n\n/**\n * One pure reducer per message tag (exhaustive by construction), plus optional reducers\n * for framework messages. Reducers may return commands.\n */\nexport type Update<S, M extends Tagged, P = object> = {\n  readonly [K in M['_tag']]: Reducer<S, M, Variant<M, K>, P>;\n} & {\n  readonly PropsChanged?: Reducer<S, M, PropsChanged<P>, P>;\n  readonly IntentRejected?: Reducer<S, M, IntentRejected, P>;\n  readonly StoreChanged?: Reducer<S, M, StoreChanged, P>;\n  readonly Hydrated?: Reducer<S, M, Hydrated, P>;\n  readonly Errored?: Reducer<S, M, Errored, P>;\n  readonly FormReset?: Reducer<S, M, FormReset, P>;\n  readonly FormDisabled?: Reducer<S, M, FormDisabled, P>;\n  readonly FormStateRestore?: Reducer<S, M, FormStateRestore, P>;\n};\n\n/**\n * A component's intent names, the keys of its `intent` object, as the view's `i` and as\n * `intentsOf<typeof C>()`, so `data-intent=${i.Increment}` is checked (ADR 0023).\n */\nexport type IntentNames<N extends string> = { readonly [K in N]: K };\n\n/**\n * The prop builders for props type `P` (view/05-element.md \"Props\"): one `prop.*` builder per\n * key. A builder's output type must fit the prop's type, so a prop whose type excludes\n * `undefined` needs `required: true` or a `default` (the honesty rule, ADR 0007 addendum).\n * Without explicit type arguments, `define()` infers `P` from the builders.\n */\nexport type PropDeclarations<P> = { readonly [K in keyof P]-?: Prop<P[K]> };\n\n/** State of a component that keeps none (a pure view of its props). Its `init` is optional. */\nexport type Stateless = Readonly<Record<string, never>>;\n\n/** Initial model state (and optional commands), computed from props on first render. */\ntype Init<S, M, P> = (props: P) => Next<S, M>;\n\n// `init` may be omitted only when an empty object is a valid state (Stateless, all-optional).\ntype InitField<S, M extends Tagged, P> = Stateless extends S\n  ? { readonly init?: Init<S, M, P> }\n  : { readonly init: Init<S, M, P> };\n\n/**\n * A component spec. `N` is the component's intent names, the keys of `intent` (ADR 0023).\n */\nexport type ComponentSpec<S, M extends Tagged, P, N extends string = string> = SpecBody<\n  S,\n  M,\n  P,\n  N\n> &\n  IntentField<S, M, P, N> &\n  UpdateField<S, M, P> &\n  InitField<S, M, P>;\n\ninterface IntentField<S, M extends Tagged, P, N extends string> {\n  /**\n   * INTENT: platform events to messages, keyed by intent name (ADR 0023). `Key: true` sends\n   * `{ _tag: 'Key' }`. Omit it when the component handles no events.\n   */\n  readonly intent?: Intents<M, P, N, S>;\n}\n\n// `update` is required (and exhaustive) whenever the component has messages.\ntype UpdateField<S, M extends Tagged, P> = [M] extends [never]\n  ? {\n      /** MODEL: pure state transitions (only framework messages for a component without any). */\n      readonly update?: Update<S, M, P>;\n    }\n  : {\n      /** MODEL: pure state transitions, one reducer per message tag. */\n      readonly update: Update<S, M, P>;\n    };\n\n/**\n * `spec.shadow`: `true` (the default) or an object for a shadow root, `false` for light DOM.\n * `delegatesFocus: true`: focusing the host, or clicking a non-focusable part of it, focuses its\n * first focusable element, and `:focus` matches the host while focus is inside; the server\n * writes `shadowrootdelegatesfocus` on the declarative shadow root (view/05-element.md \"Focus\").\n */\nexport type ShadowOption = boolean | { readonly delegatesFocus?: boolean };\n\ninterface SpecBody<S, M extends Tagged, P, N extends string> {\n  /** Native form participation with pure value, restoration-state and validity projections. */\n  readonly formAssociated?: FormAssociation<S, P>;\n  /** The component's inputs, declared with `prop.*` builders. */\n  readonly props?: PropDeclarations<P>;\n  /**\n   * VIEW: pure function of state and props. Name intents in markup; never attach closures.\n   * (A method, so a class typed with fewer intent names, e.g. `GyralElementClass<S, M, P, O>`\n   * for a recursive component, still accepts it.)\n   */\n  view(state: S, intents: IntentNames<N>, ctx: Ctx<P>): ChildValue;\n  /**\n   * What to show when `init` or the view throws (ADR 0024): `state` is `undefined` when `init`\n   * threw. Without it, a failed first render leaves the host empty and a failed later render\n   * keeps its previous DOM. A fallback that throws too is reported and the previous DOM stays.\n   */\n  error?(failure: GyralError, state: S | undefined): ChildValue;\n  /**\n   * Shadow-root styles: `css` values, plain CSS strings, or arrays of them, nested freely.\n   * Each maps to one shared `CSSStyleSheet`. Ignored (with a warning) when `shadow: false`.\n   */\n  readonly styles?: Styles;\n  /**\n   * `false` renders the view as the element's own light-DOM children (ADR 0014): document CSS\n   * applies, and the server writes plain children instead of a `<template shadowrootmode>`.\n   * For page-level components (listings, articles). No `<slot>`s and no `styles`. Default `true`.\n   * An object configures the shadow root (`{ delegatesFocus: true }`).\n   */\n  readonly shadow?: ShadowOption;\n  /**\n   * When a server-rendered instance hydrates (gyral-4k7.4): `load` (default), `idle`,\n   * `visible` (scrolled into view) or `interaction` (first pointer/focus). Client-only\n   * renders are unaffected.\n   */\n  readonly hydrate?: HydrateStrategy;\n  /**\n   * Stores this component reads with `ctx.read(store)` and writes with `send(store, msg)`.\n   * Their changes re-render it (and reach the optional `StoreChanged` reducer). ADR 0013.\n   */\n  readonly stores?: readonly AnyStore[];\n  /**\n   * Return `true` to render this state change inside a View Transition (route changes, list\n   * reorders). Skipped without browser support or when reduced motion is requested.\n   */\n  readonly viewTransition?: (prev: S, next: S, msg: Tagged) => boolean;\n  /**\n   * Messages from bursty sources (a WebSocket feed, a sensor) whose renders wait for the next\n   * animation frame, so many messages in one frame cost one render: `renderOnFrame: ['Ticked']`.\n   * Reducers still run at once. Any other change to the component renders in the usual\n   * microtask flush, taking pending frame work with it. `'StoreChanged'` covers store changes.\n   * Pages that get no frames (hidden) render from a 100 ms timer. view/04-scheduler.md.\n   */\n  readonly renderOnFrame?: readonly (M['_tag'] | 'StoreChanged')[];\n  /**\n   * Boolean facts about the state, exposed to CSS as custom states:\n   * `states: (s) => ({ loading: s._tag === 'Loading' })` enables `:host(:state(loading))` and\n   * `gy-x:state(loading)`. Applied after each render; feature-detected; not on the server.\n   */\n  readonly states?: (state: S) => Readonly<Record<string, boolean>>;\n  /**\n   * The long-lived commands that should be running now (ADR 0025): polling, clocks, sockets,\n   * store or media-query watches. Evaluated after init, every update and every props change;\n   * the runtime starts lanes that appear, aborts lanes that disappear, and restarts a lane whose\n   * input changed (compared by JSON text). They stop with the host's other commands on removal\n   * and start again from the current state when it is attached again:\n   * `subscriptions: (s, p) => (s.live ? [every(30_000, (now) => ({ _tag: 'Tick', now }))] : [])`.\n   */\n  readonly subscriptions?: (state: S, props: P) => readonly Command<M>[];\n}\n"]}

package/dist/use-dialogs.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that uses the bindings runs. */
+export declare function register(): void;

package/dist/use-dialogs.js

@@ -0,0 +1,9 @@
+// Registers the dialog and popover bindings in a compiled build (gyral-1zd.27). Only the module
+// the build adds for a module that writes `?modal=` or `?popover-open=` imports it
+// (compiler/features.ts), so other builds leave modal.ts out.
+import { applyToggle, useToggles } from './view/index.js';
+/** Called once by the added module, before any module that uses the bindings runs. */
+export function register() {
+    useToggles(applyToggle);
+}
+//# sourceMappingURL=use-dialogs.js.map

package/dist/use-dialogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dialogs.js","sourceRoot":"","sources":["../src/use-dialogs.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,mFAAmF;AACnF,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE1D,sFAAsF;AACtF,MAAM,UAAU,QAAQ;IACtB,UAAU,CAAC,WAAW,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["// Registers the dialog and popover bindings in a compiled build (gyral-1zd.27). Only the module\n// the build adds for a module that writes `?modal=` or `?popover-open=` imports it\n// (compiler/features.ts), so other builds leave modal.ts out.\nimport { applyToggle, useToggles } from './view/index.js';\n\n/** Called once by the added module, before any module that uses the bindings runs. */\nexport function register(): void {\n  useToggles(applyToggle);\n}\n"]}

package/dist/use-disposal.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that defines such a hook runs. */
+export declare function register(): void;

package/dist/use-disposal.js

@@ -0,0 +1,9 @@
+// Registers hook disposal in a compiled build (gyral-1zd.24). Only the module the build adds for
+// a module that names `dispose` imports it (compiler/features.ts), so apps whose hooks have no
+// teardown leave dispose.ts out.
+import { commitTracked, useDisposableHooks } from './view/index.js';
+/** Called once by the added module, before any module that defines such a hook runs. */
+export function register() {
+    useDisposableHooks(commitTracked);
+}
+//# sourceMappingURL=use-disposal.js.map

package/dist/use-disposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-disposal.js","sourceRoot":"","sources":["../src/use-disposal.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,+FAA+F;AAC/F,iCAAiC;AACjC,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wFAAwF;AACxF,MAAM,UAAU,QAAQ;IACtB,kBAAkB,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC","sourcesContent":["// Registers hook disposal in a compiled build (gyral-1zd.24). Only the module the build adds for\n// a module that names `dispose` imports it (compiler/features.ts), so apps whose hooks have no\n// teardown leave dispose.ts out.\nimport { commitTracked, useDisposableHooks } from './view/index.js';\n\n/** Called once by the added module, before any module that defines such a hook runs. */\nexport function register(): void {\n  useDisposableHooks(commitTracked);\n}\n"]}

package/dist/use-error-view.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that names the field runs. */
+export declare function register(): void;

package/dist/use-error-view.js

@@ -0,0 +1,9 @@
+// Registers the `error` fallback view in a compiled build (ADR 0024, gyral-1zd.17). Only the
+// module the build adds for a module that names `error` imports it (compiler/features.ts).
+import { useErrorView } from '#spec-features';
+import { renderErrorView } from './error-view.js';
+/** Called once by the added module, before any module that names the field runs. */
+export function register() {
+    useErrorView(renderErrorView);
+}
+//# sourceMappingURL=use-error-view.js.map

package/dist/use-error-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-error-view.js","sourceRoot":"","sources":["../src/use-error-view.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,2FAA2F;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,YAAY,CAAC,eAAe,CAAC,CAAC;AAChC,CAAC","sourcesContent":["// Registers the `error` fallback view in a compiled build (ADR 0024, gyral-1zd.17). Only the\n// module the build adds for a module that names `error` imports it (compiler/features.ts).\nimport { useErrorView } from '#spec-features';\nimport { renderErrorView } from './error-view.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useErrorView(renderErrorView);\n}\n"]}

package/dist/use-errored.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that handles the message runs. */
+export declare function register(): void;

package/dist/use-errored.js

@@ -0,0 +1,9 @@
+// Registers the `Errored` message in a compiled build (ADR 0024, gyral-1zd.17). Only the module
+// the build adds for a module that names `Errored` imports it (compiler/features.ts).
+import { useErrored } from '#spec-features';
+import { sendErrored } from './error-view.js';
+/** Called once by the added module, before any module that handles the message runs. */
+export function register() {
+    useErrored(sendErrored);
+}
+//# sourceMappingURL=use-errored.js.map

package/dist/use-errored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-errored.js","sourceRoot":"","sources":["../src/use-errored.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,sFAAsF;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,wFAAwF;AACxF,MAAM,UAAU,QAAQ;IACtB,UAAU,CAAC,WAAW,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["// Registers the `Errored` message in a compiled build (ADR 0024, gyral-1zd.17). Only the module\n// the build adds for a module that names `Errored` imports it (compiler/features.ts).\nimport { useErrored } from '#spec-features';\nimport { sendErrored } from './error-view.js';\n\n/** Called once by the added module, before any module that handles the message runs. */\nexport function register(): void {\n  useErrored(sendErrored);\n}\n"]}

package/dist/use-form-associated.d.ts

@@ -0,0 +1,2 @@
+/** Installed only for compiled applications whose modules name formAssociated. */
+export declare function register(): void;

package/dist/use-form-associated.js

@@ -0,0 +1,7 @@
+import { useFormAssociation } from '#spec-features';
+import { formFeature } from './form-associated.js';
+/** Installed only for compiled applications whose modules name formAssociated. */
+export function register() {
+    useFormAssociation(formFeature);
+}
+//# sourceMappingURL=use-form-associated.js.map

package/dist/use-form-associated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-form-associated.js","sourceRoot":"","sources":["../src/use-form-associated.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,kFAAkF;AAClF,MAAM,UAAU,QAAQ;IACtB,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC","sourcesContent":["import { useFormAssociation } from '#spec-features';\nimport { formFeature } from './form-associated.js';\n\n/** Installed only for compiled applications whose modules name formAssociated. */\nexport function register(): void {\n  useFormAssociation(formFeature);\n}\n"]}

package/dist/use-frame-lane.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that names the field runs. */
+export declare function register(): void;

package/dist/use-frame-lane.js

@@ -0,0 +1,10 @@
+// Registers frameLane in a compiled build (gyral-c5d.12). Only the module the build adds for a
+// module that names the spec field imports it (compiler/features.ts), so other builds leave
+// frame-lane.ts out.
+import { useFrameLane } from '#spec-features';
+import { frameLane } from './frame-lane.js';
+/** Called once by the added module, before any module that names the field runs. */
+export function register() {
+    useFrameLane(frameLane);
+}
+//# sourceMappingURL=use-frame-lane.js.map

package/dist/use-frame-lane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-frame-lane.js","sourceRoot":"","sources":["../src/use-frame-lane.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,4FAA4F;AAC5F,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,YAAY,CAAC,SAAS,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["// Registers frameLane in a compiled build (gyral-c5d.12). Only the module the build adds for a\n// module that names the spec field imports it (compiler/features.ts), so other builds leave\n// frame-lane.ts out.\nimport { useFrameLane } from '#spec-features';\nimport { frameLane } from './frame-lane.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useFrameLane(frameLane);\n}\n"]}

package/dist/use-invokers.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that may need the fallback runs. */
+export declare function register(): void;

package/dist/use-invokers.js

@@ -0,0 +1,10 @@
+// Registers the invoker-command fallback in a client-only build (gyral-c5d.11). Only the module
+// the build adds for a module that may use command intents imports it (compiler/features.ts,
+// `virtual:gyral-use/invokers`), so only those builds carry the fallback's import().
+import { useInvokerShim } from '#invoker-fallback';
+import { loadInvokerShim } from './invoker-fallback.js';
+/** Called once by the added module, before any module that may need the fallback runs. */
+export function register() {
+    useInvokerShim(loadInvokerShim);
+}
+//# sourceMappingURL=use-invokers.js.map

package/dist/use-invokers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-invokers.js","sourceRoot":"","sources":["../src/use-invokers.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6FAA6F;AAC7F,qFAAqF;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,0FAA0F;AAC1F,MAAM,UAAU,QAAQ;IACtB,cAAc,CAAC,eAAe,CAAC,CAAC;AAClC,CAAC","sourcesContent":["// Registers the invoker-command fallback in a client-only build (gyral-c5d.11). Only the module\n// the build adds for a module that may use command intents imports it (compiler/features.ts,\n// `virtual:gyral-use/invokers`), so only those builds carry the fallback's import().\nimport { useInvokerShim } from '#invoker-fallback';\nimport { loadInvokerShim } from './invoker-fallback.js';\n\n/** Called once by the added module, before any module that may need the fallback runs. */\nexport function register(): void {\n  useInvokerShim(loadInvokerShim);\n}\n"]}

package/dist/use-states.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that names the field runs. */
+export declare function register(): void;

package/dist/use-states.js

@@ -0,0 +1,10 @@
+// Registers syncStates in a compiled build (gyral-c5d.12). Only the module the build adds for a
+// module that names the spec field imports it (compiler/features.ts), so other builds leave
+// states.ts out.
+import { useCustomStates } from '#spec-features';
+import { syncStates } from './states.js';
+/** Called once by the added module, before any module that names the field runs. */
+export function register() {
+    useCustomStates(syncStates);
+}
+//# sourceMappingURL=use-states.js.map

package/dist/use-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-states.js","sourceRoot":"","sources":["../src/use-states.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,4FAA4F;AAC5F,iBAAiB;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,eAAe,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["// Registers syncStates in a compiled build (gyral-c5d.12). Only the module the build adds for a\n// module that names the spec field imports it (compiler/features.ts), so other builds leave\n// states.ts out.\nimport { useCustomStates } from '#spec-features';\nimport { syncStates } from './states.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useCustomStates(syncStates);\n}\n"]}

package/dist/use-subscriptions.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that names the field runs. */
+export declare function register(): void;

package/dist/use-subscriptions.js

@@ -0,0 +1,10 @@
+// Registers subscriptionSet in a compiled build (ADR 0025). Only the module the build adds for a
+// module that names the spec field imports it (compiler/features.ts), so other builds leave
+// subscriptions.ts out.
+import { useSubscriptions } from '#spec-features';
+import { subscriptionSet } from './subscriptions.js';
+/** Called once by the added module, before any module that names the field runs. */
+export function register() {
+    useSubscriptions(subscriptionSet);
+}
+//# sourceMappingURL=use-subscriptions.js.map

package/dist/use-subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-subscriptions.js","sourceRoot":"","sources":["../src/use-subscriptions.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,4FAA4F;AAC5F,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,gBAAgB,CAAC,eAAe,CAAC,CAAC;AACpC,CAAC","sourcesContent":["// Registers subscriptionSet in a compiled build (ADR 0025). Only the module the build adds for a\n// module that names the spec field imports it (compiler/features.ts), so other builds leave\n// subscriptions.ts out.\nimport { useSubscriptions } from '#spec-features';\nimport { subscriptionSet } from './subscriptions.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useSubscriptions(subscriptionSet);\n}\n"]}

package/dist/use-transitions.d.ts

@@ -0,0 +1,2 @@
+/** Called once by the added module, before any module that names the field runs. */
+export declare function register(): void;

package/dist/use-transitions.js

@@ -0,0 +1,10 @@
+// Registers startTransition in a compiled build (gyral-c5d.12). Only the module the build adds for a
+// module that names the spec field imports it (compiler/features.ts), so other builds leave
+// transitions.ts out.
+import { useViewTransitions } from '#spec-features';
+import { startTransition } from './transitions.js';
+/** Called once by the added module, before any module that names the field runs. */
+export function register() {
+    useViewTransitions(startTransition);
+}
+//# sourceMappingURL=use-transitions.js.map

package/dist/use-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transitions.js","sourceRoot":"","sources":["../src/use-transitions.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,4FAA4F;AAC5F,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,kBAAkB,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC","sourcesContent":["// Registers startTransition in a compiled build (gyral-c5d.12). Only the module the build adds for a\n// module that names the spec field imports it (compiler/features.ts), so other builds leave\n// transitions.ts out.\nimport { useViewTransitions } from '#spec-features';\nimport { startTransition } from './transitions.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useViewTransitions(startTransition);\n}\n"]}

package/dist/view/attributes.d.ts

@@ -4,3 +4,8 @@ export declare const SEED_ATTRIBUTE = "data-gyral-seed";
 export declare const LIGHT_ATTRIBUTE = "data-gyral-light";
 /** A deferred island's strategy (07 "Islands"), next to `defer-hydration`. */
 export declare const ISLAND_ATTRIBUTE = "data-gyral-hydrate";
+/**
+ * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view
+ * (or nothing) and no seed, and the client starts it fresh instead of hydrating.
+ */
+export declare const ERROR_ATTRIBUTE = "data-gyral-error";

package/dist/view/attributes.js

@@ -7,4 +7,9 @@ export const SEED_ATTRIBUTE = 'data-gyral-seed';
 export const LIGHT_ATTRIBUTE = 'data-gyral-light';
 /** A deferred island's strategy (07 "Islands"), next to `defer-hydration`. */
 export const ISLAND_ATTRIBUTE = 'data-gyral-hydrate';
+/**
+ * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view
+ * (or nothing) and no seed, and the client starts it fresh instead of hydrating.
+ */
+export const ERROR_ATTRIBUTE = 'data-gyral-error';
 //# sourceMappingURL=attributes.js.map

package/dist/view/attributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/view/attributes.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,iEAAiE;AACjE,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAClD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC","sourcesContent":["// Host attributes the server renderer writes (view/06-server.md \"Components\") and the client\n// reads (07). Core's hydration.ts, light-dom.ts and islands.ts declare the same names for the\n// client; server-components.node.test.ts checks that they match.\n/** Host attribute holding a component's JSON seed (ADR 0012); the client removes it. */\nexport const SEED_ATTRIBUTE = 'data-gyral-seed';\n/** Marks a server-rendered light-DOM host (ADR 0014), so hydration knows its own content. */\nexport const LIGHT_ATTRIBUTE = 'data-gyral-light';\n/** A deferred island's strategy (07 \"Islands\"), next to `defer-hydration`. */\nexport const ISLAND_ATTRIBUTE = 'data-gyral-hydrate';\n"]}
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/view/attributes.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,iEAAiE;AACjE,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAClD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC","sourcesContent":["// Host attributes the server renderer writes (view/06-server.md \"Components\") and the client\n// reads (07). Core's hydration.ts, light-dom.ts and islands.ts declare the same names for the\n// client; server-components.node.test.ts checks that they match.\n/** Host attribute holding a component's JSON seed (ADR 0012); the client removes it. */\nexport const SEED_ATTRIBUTE = 'data-gyral-seed';\n/** Marks a server-rendered light-DOM host (ADR 0014), so hydration knows its own content. */\nexport const LIGHT_ATTRIBUTE = 'data-gyral-light';\n/** A deferred island's strategy (07 \"Islands\"), next to `defer-hydration`. */\nexport const ISLAND_ATTRIBUTE = 'data-gyral-hydrate';\n/**\n * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view\n * (or nothing) and no seed, and the client starts it fresh instead of hydrating.\n */\nexport const ERROR_ATTRIBUTE = 'data-gyral-error';\n"]}

package/dist/view/compiled.d.ts

@@ -1 +1 @@
-export { compiled } from './template.js';
+export { compiled, compiledSvg } from './template.js';

package/dist/view/compiled.js

@@ -2,5 +2,5 @@
 // from (view/01-templates.md "Compiled"). Internal: apps never import it themselves, and it is
 // not documented as API. A subpath of its own, so the main entry's API stays as documented
 // and compiled code still shares the one template module with `html` (same package copy).
-export { compiled } from './template.js';
+export { compiled, compiledSvg } from './template.js';
 //# sourceMappingURL=compiled.js.map

package/dist/view/compiled.js.map

@@ -1 +1 @@
-{"version":3,"file":"compiled.js","sourceRoot":"","sources":["../../src/view/compiled.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,2FAA2F;AAC3F,0FAA0F;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// `@gyral/core/compiled`: the entry the Vite template compiler's output imports `compiled`\n// from (view/01-templates.md \"Compiled\"). Internal: apps never import it themselves, and it is\n// not documented as API. A subpath of its own, so the main entry's API stays as documented\n// and compiled code still shares the one template module with `html` (same package copy).\nexport { compiled } from './template.js';\n"]}
+{"version":3,"file":"compiled.js","sourceRoot":"","sources":["../../src/view/compiled.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,2FAA2F;AAC3F,0FAA0F;AAC1F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// `@gyral/core/compiled`: the entry the Vite template compiler's output imports `compiled`\n// from (view/01-templates.md \"Compiled\"). Internal: apps never import it themselves, and it is\n// not documented as API. A subpath of its own, so the main entry's API stays as documented\n// and compiled code still shares the one template module with `html` (same package copy).\nexport { compiled, compiledSvg } from './template.js';\n"]}

package/dist/view/index.d.ts

@@ -1,5 +1,6 @@
 export { DEV } from '#view-dev';
-export { html, compiled, isTemplateResult, templateOf, type TemplateResult } from './template.js';
+export { codeName, docsLink, message, type MessageCode } from './message.js';
+export { html, svg, compiled, compiledSvg, isTemplateResult, templateOf, type TemplateResult, } from './template.js';
 export { templateElement } from './template-element.js';
 export { normalize, analyze, type Analysis } from './normalize/normalize.js';
 export { checkTemplate, type TemplateIssue } from './normalize/check.js';
@@ -12,10 +13,14 @@ export { render, renderBatch } from './render/render.js';
 export type { Markup, SeenMarkup } from './render/seen.js';
 export { HydrationMismatch } from './render/mismatch.js';
 export { each } from './render/list.js';
+export { keyed } from './render/keyed.js';
 export { raw } from './render/raw.js';
 export { nothing, type ChildValue, type ListResult, type RawResult } from './render/values.js';
 export { defineHook } from './render/hook-part.js';
-export type { HookAttributes, HookResult, HookSpec } from './render/hooks.js';
+export { useToggles } from './render/toggles.js';
+export { applyToggle } from './render/modal.js';
+export { commitTracked } from './render/dispose.js';
+export { flushHooks, onHookFailure, suspendHooks, useDisposableHooks, type HookAttributes, type HookResult, type HookSpec, } from './render/hooks.js';
 export { css, isStyleSource, sheetsFor, styleTexts, type CssValue, type StyleSource, type Styles, } from './styles.js';
-export { ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE } from './attributes.js';
-export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, type ServerComponent, type ServerProvider, type ServerRenderInput, type ServerRendering, } from './registry.js';
+export { ERROR_ATTRIBUTE, ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE, } from './attributes.js';
+export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, serverRegistryVersion, type ServerComponent, type ServerProvider, type ServerRenderInput, type ServerRendering, } from './registry.js';

package/dist/view/index.js

@@ -1,7 +1,8 @@
 // The view layer's entry point for the rest of core (ADR 0018 "Where it lives"): code outside
 // view/ imports only this module. @gyral/core's index re-exports the public part of it.
 export { DEV } from '#view-dev';
-export { html, compiled, isTemplateResult, templateOf } from './template.js';
+export { codeName, docsLink, message } from './message.js';
+export { html, svg, compiled, compiledSvg, isTemplateResult, templateOf, } from './template.js';
 export { templateElement } from './template-element.js';
 export { normalize, analyze } from './normalize/normalize.js';
 export { checkTemplate } from './normalize/check.js';
@@ -12,10 +13,15 @@ export { hydrate } from './render/hydrate.js';
 export { render, renderBatch } from './render/render.js';
 export { HydrationMismatch } from './render/mismatch.js';
 export { each } from './render/list.js';
+export { keyed } from './render/keyed.js';
 export { raw } from './render/raw.js';
 export { nothing } from './render/values.js';
 export { defineHook } from './render/hook-part.js';
+export { useToggles } from './render/toggles.js';
+export { applyToggle } from './render/modal.js';
+export { commitTracked } from './render/dispose.js';
+export { flushHooks, onHookFailure, suspendHooks, useDisposableHooks, } from './render/hooks.js';
 export { css, isStyleSource, sheetsFor, styleTexts, } from './styles.js';
-export { ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE } from './attributes.js';
-export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, } from './registry.js';
+export { ERROR_ATTRIBUTE, ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE, } from './attributes.js';
+export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, serverRegistryVersion, } from './registry.js';
 //# sourceMappingURL=index.js.map