@gyral/core 0.2.0 → 0.3.1

package/dist/transitions.js

@@ -1,26 +1,23 @@
-// View Transitions for define() components (ADR 0001 addendum). An ADR 0003 enhancement:
-// without the API, or with reduced motion requested, updates render normally.
-const supportsViewTransitions = (doc) => 'startViewTransition' in doc;
+// View Transitions for the scheduler (view/04-scheduler.md "View transitions", ADR 0001
+// addendum). An ADR 0003 enhancement: without the API, or with reduced motion requested, the
+// flush runs as normal. Reached through core's `#spec-features` (spec-features.ts): compiled
+// builds bundle it only when a module names `viewTransition` (compiler/features.ts,
+// gyral-c5d.12).
 const ignore = () => undefined;
 /** True when a view transition may run now (API present, motion not reduced). */
-export function canTransition() {
-    if (typeof document === 'undefined' || !supportsViewTransitions(document))
-        return false;
-    return !window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-}
+const canTransition = () => 'startViewTransition' in document && !matchMedia('(prefers-reduced-motion: reduce)').matches;
 /**
- * Runs `update` inside `document.startViewTransition` when allowed, otherwise directly.
- * `update` must resolve once the DOM reflects the new state. The returned promise settles when
- * `update` has run. A transition skipped by a newer one still runs its update (per spec); its
- * rejected `ready` is expected and swallowed.
+ * Runs `update` (a whole flush) as a view transition's update callback and returns true, or
+ * returns false when no transition may run now (the caller then runs it). A transition skipped
+ * by a newer one still runs its update (per spec); its rejected promises are expected and
+ * swallowed.
  */
-export function withViewTransition(update) {
-    if (!canTransition() || !supportsViewTransitions(document))
-        return update();
-    return new Promise((resolve, reject) => {
-        const transition = document.startViewTransition(() => update().then(resolve, reject));
-        transition.ready.catch(ignore);
-        transition.finished.catch(ignore);
-    });
+export function startTransition(update) {
+    if (!canTransition())
+        return false;
+    const transition = document.startViewTransition(update);
+    transition.ready.catch(ignore);
+    transition.finished.catch(ignore);
+    return true;
 }
 //# sourceMappingURL=transitions.js.map

package/dist/transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../src/transitions.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,8EAA8E;AAW9E,MAAM,uBAAuB,GAAG,CAAC,GAAa,EAA4C,EAAE,CAC1F,qBAAqB,IAAI,GAAG,CAAC;AAE/B,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAErC,iFAAiF;AACjF,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACxF,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,EAAE,CAAC;IAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,UAAU,GAAG,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACtF,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// View Transitions for define() components (ADR 0001 addendum). An ADR 0003 enhancement:\n// without the API, or with reduced motion requested, updates render normally.\n\ninterface ViewTransitionLike {\n  readonly ready: Promise<unknown>;\n  readonly finished: Promise<unknown>;\n}\n\ninterface ViewTransitionDocument {\n  startViewTransition(update: () => Promise<void>): ViewTransitionLike;\n}\n\nconst supportsViewTransitions = (doc: Document): doc is Document & ViewTransitionDocument =>\n  'startViewTransition' in doc;\n\nconst ignore = (): void => undefined;\n\n/** True when a view transition may run now (API present, motion not reduced). */\nexport function canTransition(): boolean {\n  if (typeof document === 'undefined' || !supportsViewTransitions(document)) return false;\n  return !window.matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\n/**\n * Runs `update` inside `document.startViewTransition` when allowed, otherwise directly.\n * `update` must resolve once the DOM reflects the new state. The returned promise settles when\n * `update` has run. A transition skipped by a newer one still runs its update (per spec); its\n * rejected `ready` is expected and swallowed.\n */\nexport function withViewTransition(update: () => Promise<void>): Promise<void> {\n  if (!canTransition() || !supportsViewTransitions(document)) return update();\n  return new Promise((resolve, reject) => {\n    const transition = document.startViewTransition(() => update().then(resolve, reject));\n    transition.ready.catch(ignore);\n    transition.finished.catch(ignore);\n  });\n}\n"]}
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../src/transitions.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,6FAA6F;AAC7F,6FAA6F;AAC7F,oFAAoF;AACpF,iBAAiB;AAWjB,MAAM,MAAM,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAErC,iFAAiF;AACjF,MAAM,aAAa,GAAG,GAAY,EAAE,CAClC,qBAAqB,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;AAE/F;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB;IAChD,IAAI,CAAC,aAAa,EAAE;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,UAAU,GAAI,QAA8C,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/F,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["// View Transitions for the scheduler (view/04-scheduler.md \"View transitions\", ADR 0001\n// addendum). An ADR 0003 enhancement: without the API, or with reduced motion requested, the\n// flush runs as normal. Reached through core's `#spec-features` (spec-features.ts): compiled\n// builds bundle it only when a module names `viewTransition` (compiler/features.ts,\n// gyral-c5d.12).\n\ninterface ViewTransitionLike {\n  readonly ready: Promise<unknown>;\n  readonly finished: Promise<unknown>;\n}\n\ninterface ViewTransitionDocument {\n  startViewTransition(update: () => void): ViewTransitionLike;\n}\n\nconst ignore = (): void => undefined;\n\n/** True when a view transition may run now (API present, motion not reduced). */\nconst canTransition = (): boolean =>\n  'startViewTransition' in document && !matchMedia('(prefers-reduced-motion: reduce)').matches;\n\n/**\n * Runs `update` (a whole flush) as a view transition's update callback and returns true, or\n * returns false when no transition may run now (the caller then runs it). A transition skipped\n * by a newer one still runs its update (per spec); its rejected promises are expected and\n * swallowed.\n */\nexport function startTransition(update: () => void): boolean {\n  if (!canTransition()) return false;\n  const transition = (document as Document & ViewTransitionDocument).startViewTransition(update);\n  transition.ready.catch(ignore);\n  transition.finished.catch(ignore);\n  return true;\n}\n"]}

package/dist/types.d.ts

@@ -1,19 +1,21 @@
-import type { PropertyDeclaration } from 'lit';
-import type { Styles } from './styles.js';
+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,31 +150,26 @@ 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;
 };
 /**
- * One prop's declaration: Lit's `PropertyDeclaration` plus Gyral's honesty rule (ADR 0007
- * addendum). A prop is `undefined` until a parent, an attribute or a hydration seed sets it,
- * so a prop whose type excludes `undefined` must say how that is guaranteed:
- * - `required: true`: a missing value is a bug, reported once per instance at first render;
- * - `default: value`: used whenever the element's value is `undefined`.
- * A prop whose type includes `undefined` needs neither.
+ * The prop builders for props type `P` (view/05-element.md "Props"): one `prop.*` builder per
+ * key. A builder's output type must fit the prop's type, so a prop whose type excludes
+ * `undefined` needs `required: true` or a `default` (the honesty rule, ADR 0007 addendum).
+ * Without explicit type arguments, `define()` infers `P` from the builders.
  */
-export type PropDeclaration<T> = PropertyDeclaration & (undefined extends T ? {
-    readonly required?: false;
-    readonly default?: T;
-} : {
-    readonly required: true;
-    readonly default?: undefined;
-} | {
-    readonly required?: false;
-    readonly default: T;
-});
 export type PropDeclarations<P> = {
-    readonly [K in keyof P]-?: PropDeclaration<P[K]>;
+    readonly [K in keyof P]-?: Prop<P[K]>;
 };
 /** State of a component that keeps none (a pure view of its props). Its `init` is optional. */
 export type Stateless = Readonly<Record<string, never>>;
@@ -135,37 +180,68 @@ 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> {
-    /** Lit reactive property declarations: the component's inputs. */
-    readonly props?: PropDeclarations<P>;
-    /** INTENT: platform events to messages. */
-    readonly intent: Intents<M>;
-    /** MODEL: pure state transitions. */
+/**
+ * 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>;
-    /** VIEW: pure function of state and props. Name intents in markup; never attach closures. */
-    readonly view: (state: S, intents: IntentNames<M>, ctx: Ctx<P>) => unknown;
+};
+/**
+ * `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>;
+    /**
+     * 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` templates, plain CSS strings, `CSSStyleSheet`s, or arrays of
-     * them. Ignored (with a warning) when `shadow: false`.
+     * 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`.
      */
     readonly styles?: Styles;
     /**
      * `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.
@@ -176,11 +252,28 @@ interface SpecBody<S, M extends Tagged, P> {
      * reorders). Skipped without browser support or when reduced motion is requested.
      */
     readonly viewTransition?: (prev: S, next: S, msg: Tagged) => boolean;
+    /**
+     * Messages from bursty sources (a WebSocket feed, a sensor) whose renders wait for the next
+     * animation frame, so many messages in one frame cost one render: `renderOnFrame: ['Ticked']`.
+     * Reducers still run at once. Any other change to the component renders in the usual
+     * microtask flush, taking pending frame work with it. `'StoreChanged'` covers store changes.
+     * Pages that get no frames (hidden) render from a 100 ms timer. view/04-scheduler.md.
+     */
+    readonly renderOnFrame?: readonly (M['_tag'] | 'StoreChanged')[];
     /**
      * Boolean facts about the state, exposed to CSS as custom states:
      * `states: (s) => ({ loading: s._tag === 'Loading' })` enables `:host(:state(loading))` and
      * `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 { PropertyDeclaration } from 'lit';\nimport type { Styles } from './styles.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 * One prop's declaration: Lit's `PropertyDeclaration` plus Gyral's honesty rule (ADR 0007\n * addendum). A prop is `undefined` until a parent, an attribute or a hydration seed sets it,\n * so a prop whose type excludes `undefined` must say how that is guaranteed:\n * - `required: true`: a missing value is a bug, reported once per instance at first render;\n * - `default: value`: used whenever the element's value is `undefined`.\n * A prop whose type includes `undefined` needs neither.\n */\nexport type PropDeclaration<T> = PropertyDeclaration &\n  (undefined extends T\n    ? { readonly required?: false; readonly default?: T }\n    : | { readonly required: true; readonly default?: undefined }\n      | { readonly required?: false; readonly default: T });\n\nexport type PropDeclarations<P> = { readonly [K in keyof P]-?: PropDeclaration<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  /** Lit reactive property declarations: the component's inputs. */\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>) => unknown;\n  /**\n   * Shadow-root styles: `css` templates, plain CSS strings, `CSSStyleSheet`s, or arrays of\n   * them. 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   * 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