@gyral/core 0.2.0 → 0.3.1

package/dist/define.js

@@ -1,338 +1,42 @@
-import { isServer, LitElement } from 'lit';
-import { providedDriver } from './drivers-scope.js';
-import { DEVTOOLS_ENABLED, devCommands, devConnect, devHydrated, devOwner, devUpdate, } from '#devtools';
-import { splitNext, } from './command.js';
-import { dispatchOutput, EMIT } from './children.js';
-import { FOCUS, focusAfterUpdate } from './focus.js';
-import { fillEmptyTextParts, takeSeed, writeSeed } from './hydration.js';
-import { markIsland, scheduleIsland } from './islands.js';
-import { runInit } from './init.js';
-import { handleIntent, intentNames, listenForIntents, markGyralHost } from './intent.js';
-import { componentStyles, hydrateLight, hydrateShadow, isLight, markLightHost, } from './light-dom.js';
-import { makeInterpreter } from './internal/interpreter.js';
-import { missingRequired, readProps, readRawProps, restoreProps, sameProps, shadowedBuiltins, } from './props.js';
-import { attachStates } from './states.js';
-import { STORE_SEND } from './store.js';
-import { StoreBinding } from './store-binding.js';
-import { withViewTransition } from './transitions.js';
-// Lit types `isServer` per build condition; widen it so both branches type-check (ADR 0012).
-const onServer = isServer;
-const DEFER_HYDRATION = 'defer-hydration';
-/**
- * Has Lit's hydrate support patched LitElement? It then defers `defer-hydration` elements
- * itself. A bundler can evaluate Lit before `@gyral/ssr/hydrate`, so it may not have
- * (gyral-czi.41); the patch adds an own static `observedAttributes` to LitElement.
- */
-const litDefers = () => Object.prototype.hasOwnProperty.call(LitElement, 'observedAttributes');
-/**
- * Compiles a Model-View-Intent spec into a custom element and registers it under `tag`.
- * See docs/design-docs/0001-mvi-parsed-intent.md, 0006-effects-and-drivers.md, 0007-props.md
- * 0008-forms.md and 0012-ssr.md.
- */
-export function define(tag, spec) {
-    const propTable = (spec.props ?? {});
-    const propNames = Object.keys(propTable);
-    const shadowed = onServer ? [] : shadowedBuiltins(propNames);
-    if (shadowed.length > 0) {
-        console.warn(`<${tag}> declares prop(s) that shadow built-in element properties: ` +
-            `${shadowed.join(', ')}. Setting them changes platform behaviour ` +
-            `(a prop named "hidden" hides the element). Rename them.`);
+import { elementClass } from './element.js';
+import { markGyralHost } from './intent.js';
+import { isLight } from './light-dom.js';
+import { features } from './features.js';
+import { recordSpec } from './server-specs.js';
+import { DEV, message } from './view/index.js';
+function checkSpec(tag, spec) {
+    const names = Object.keys(spec.props ?? {});
+    // The prop builders registered the prop feature (features.ts) if there are props.
+    if (names.length > 0)
+        features.props?.checkShadowed(tag, names);
+    if (DEV && isLight(spec) && spec.styles !== undefined) {
+        console.warn(`<${tag}> has shadow: false, so its styles are ignored; use document CSS.`);
     }
-    const parsers = spec.intent;
-    // Sound: #dispatch() only calls the reducer whose key equals msg._tag.
-    const reducers = spec.update;
-    class Element extends LitElement {
-        constructor() {
-            super(...arguments);
-            this.drivers = {};
-            this.stores = {};
-            this.initialMessages = [];
-            /** Reads, subscriptions and writes for spec.stores (ADR 0013). */
-            this.#binding = new StoreBinding(this, tag, spec.stores ?? [], () => this.stores, (store, state, prev) => {
-                this.#storeChanged(store, state, prev);
-            });
-            this.#listening = false;
-            this.#pending = [];
-            /** init's commands on the hydration path; started in firstUpdated (ADR 0012). */
-            this.#afterHydration = [];
-            /** Resumed from server markup; reported by the Hydrated message. */
-            this.#serverRendered = false;
-            /** The renderRoot is a server-rendered (declarative) shadow root to hydrate in place. */
-            this.#ssrShadow = false;
-            /** Mirrors spec.states onto CSS custom states; only attached when the spec asks. */
-            this.#syncStates = spec.states === undefined || onServer ? undefined : attachStates(this);
-            // el.drivers → nearest provider → spec.drivers → the command's own (gyral-czi.35).
-            this.#resolve = (driver) => this.drivers[driver.name] ??
-                providedDriver(this, driver.name) ??
-                spec.drivers?.[driver.name] ??
-                driver;
-            this.#onEvent = (event) => {
-                handleIntent(event, this.renderRoot, parsers, tag, this.#deliver);
-            };
-            this.#deliver = (msg) => {
-                if (msg !== undefined && this.isConnected)
-                    this.#dispatch(msg);
-            };
-        }
-        static { this.properties = spec.props ?? {}; }
-        static { this.styles = componentStyles(spec, tag); }
-        static { this.spec = spec; }
-        static { this.tagName = tag; }
-        // Always observe `defer-hydration`, so Gyral can defer server-rendered children itself
-        // when Lit's hydrate support isn't installed (gyral-czi.41, ADR 0012).
-        static get observedAttributes() {
-            const base = super.observedAttributes;
-            return base.includes(DEFER_HYDRATION) ? base : [...base, DEFER_HYDRATION];
-        }
-        /** Reads, subscriptions and writes for spec.stores (ADR 0013). */
-        #binding;
-        #model;
-        /** Props as of the last init or PropsChanged; the `prev` of the next PropsChanged. */
-        #seenProps;
-        #listening;
-        #interpreter;
-        #pending;
-        /** init's commands on the hydration path; started in firstUpdated (ADR 0012). */
-        #afterHydration;
-        /** Resumed from server markup; reported by the Hydrated message. */
-        #serverRendered;
-        /** The renderRoot is a server-rendered (declarative) shadow root to hydrate in place. */
-        #ssrShadow;
-        /** The latest view-transition update, awaited by updateComplete. */
-        #transition;
-        /** Mirrors spec.states onto CSS custom states; only attached when the spec asks. */
-        #syncStates;
-        get state() {
-            if (this.#model === undefined) {
-                const missing = missingRequired(this, propTable);
-                if (missing.length > 0) {
-                    console.warn(`<${tag}> is missing required prop(s): ${missing.join(', ')}.`);
-                }
-                this.#seenProps = this.#props();
-                this.#apply(runInit(spec, this.#seenProps));
-                for (const msg of this.initialMessages)
-                    this.#dispatch(msg, false);
-            }
-            return this.#model.value;
-        }
-        send(msg) {
-            this.#dispatch(msg);
-        }
-        #dispatch(msg, render = true) {
-            const reducer = reducers[msg._tag];
-            if (reducer === undefined) {
-                // Framework messages have optional reducers; props and stores stay readable as context.
-                if (msg._tag !== 'PropsChanged' && msg._tag !== 'StoreChanged') {
-                    console.warn(`<${tag}> has no update for message "${msg._tag}".`);
-                }
-                return;
-            }
-            const prev = this.state;
-            this.#apply(reducer(prev, msg, this.#ctx()));
-            if (DEVTOOLS_ENABLED)
-                devUpdate(this, tag, msg, prev, this.state);
-            if (!render)
-                return;
-            if (spec.viewTransition?.(prev, this.state, msg) === true) {
-                // The DOM change happens inside the transition callback (ADR 0001 addendum);
-                // updateComplete waits for it, so tests and callers see the new DOM.
-                this.#transition = withViewTransition(async () => {
-                    this.requestUpdate();
-                    await super.getUpdateComplete();
-                }).catch((error) => {
-                    console.error(`<${tag}> view transition update failed`, error);
-                });
-            }
-            else {
-                this.requestUpdate();
-            }
-        }
-        async getUpdateComplete() {
-            await this.#transition;
-            return super.getUpdateComplete();
-        }
-        connectedCallback() {
-            this.#resumeFromSeed();
-            // A component server-rendered inside another's view waits (`defer-hydration`) for its
-            // parent to hydrate first. Lit's hydrate support, when installed, defers LitElement
-            // itself; otherwise Gyral holds back Lit's connect until the attribute goes.
-            const waiting = this.hasAttribute(DEFER_HYDRATION);
-            if (!waiting || litDefers())
-                super.connectedCallback();
-            if (waiting) {
-                scheduleIsland(this); // lazy islands release themselves (gyral-4k7.4)
-                return;
-            }
-            this.#connect();
-        }
-        attributeChangedCallback(name, old, value) {
-            super.attributeChangedCallback(name, old, value);
-            if (name !== DEFER_HYDRATION || value !== null || !this.isConnected)
-                return;
-            if (!litDefers())
-                super.connectedCallback(); // Lit's support would have connected it
-            this.#connect();
-        }
-        #connect() {
-            // Re-resolve on every connect: the nearest <gyral-stores> may differ after a move.
-            if (this.#binding.connect())
-                this.requestUpdate();
-            this.#interpreter = makeInterpreter(this.#resolve, (msg) => {
-                this.#dispatch(msg);
-            }, DEVTOOLS_ENABLED ? devCommands(() => devOwner(this, tag)) : undefined);
-            if (DEVTOOLS_ENABLED)
-                devConnect(this, tag, true);
-            const pending = this.#pending;
-            this.#pending = [];
-            for (const cmd of pending)
-                this.#interpreter.run(cmd);
-            if (this.#listening)
-                return;
-            listenForIntents(this.renderRoot, spec.events ?? [], this.#onEvent);
-            this.#listening = true;
-        }
-        disconnectedCallback() {
-            super.disconnectedCallback();
-            this.#binding.disconnect();
-            this.#interpreter?.dispose();
-            this.#interpreter = undefined;
-            if (DEVTOOLS_ENABLED)
-                devConnect(this, tag, false);
-        }
-        willUpdate(changed) {
-            super.willUpdate(changed);
-            if (onServer) {
-                // Server renders run constructor, willUpdate and render only (ADR 0012).
-                // init is pure, so the client can recompute an unchanged state from the props.
-                const [initial] = splitNext(runInit(spec, this.#props()));
-                writeSeed(this, this.state, readRawProps(this, propTable), propTable, { value: initial });
-                if (isLight(spec))
-                    markLightHost(this);
-                markIsland(this, spec.hydrate);
-                return;
-            }
-            const prev = this.#seenProps;
-            if (prev === undefined)
-                return; // first render: init() sees the props
-            const props = this.#props();
-            if (sameProps(propNames, props, prev))
-                return;
-            this.#seenProps = props;
-            // Inside the update cycle, so the new state renders in this same pass.
-            this.#dispatch({ _tag: 'PropsChanged', props, prev }, false);
-        }
-        // Light-DOM mode (ADR 0014): render into the element itself. A server-rendered shadow root
-        // (Declarative Shadow DOM) is reused as is and hydrated in update() (gyral-czi.41): this
-        // bypasses Lit's hydrate-support patch on purpose, so hydration is correct whether or not
-        // that patch was installed before Lit evaluated (bundlers can reorder it; ADR 0012).
-        createRenderRoot() {
-            if (isLight(spec))
-                return this;
-            if (!onServer && this.shadowRoot !== null) {
-                this.#ssrShadow = true;
-                return this.shadowRoot;
-            }
-            return super.createRenderRoot();
-        }
-        update(changed) {
-            if (this.#ssrShadow && !this.hasUpdated) {
-                const styles = this.constructor.elementStyles;
-                hydrateShadow(this.renderRoot, this.render(), this.renderOptions, styles);
-            }
-            if (isLight(spec) && !this.hasUpdated && this.#serverRendered) {
-                hydrateLight(this, this.render(), this.renderOptions); // ADR 0014
-            }
-            super.update(changed);
-        }
-        render() {
-            return spec.view(this.state, intentNames, this.#ctx());
-        }
-        updated(changed) {
-            super.updated(changed);
-            if (spec.states !== undefined)
-                this.#syncStates?.(spec.states(this.state));
-        }
-        #apply(next) {
-            const [state, commands] = splitNext(next);
-            this.#model = { value: state };
-            if (onServer)
-                return; // commands never run on the server; the client's init starts them
-            for (const cmd of commands) {
-                if (cmd.driver === EMIT)
-                    dispatchOutput(this, cmd.input);
-                else if (cmd.driver === STORE_SEND)
-                    this.#binding.send(cmd.input);
-                else if (cmd.driver === FOCUS)
-                    focusAfterUpdate(this, tag, cmd.input);
-                else if (this.#interpreter === undefined)
-                    this.#pending.push(cmd);
-                else
-                    this.#interpreter.run(cmd);
-            }
-        }
-        /**
-         * Hydration (ADR 0012): use the server's state and restore props that only travelled in the
-         * seed. init(props) runs again for its commands only, and they start after the hydrating
-         * render: a driver that answers synchronously must not change state before hydration.
-         */
-        #resumeFromSeed() {
-            if (this.#model !== undefined)
-                return;
-            const seed = takeSeed(this);
-            if (seed === undefined)
-                return;
-            restoreProps(this, propNames, seed.props);
-            this.#seenProps = this.#props();
-            const [initial, commands] = splitNext(runInit(spec, this.#seenProps));
-            // Sound: the seed is this component's own state, serialized by writeSeed() on the server;
-            // when absent, the server's state was exactly init(props) (seed deduplication).
-            this.#model = { value: 'state' in seed ? seed.state : initial };
-            this.#afterHydration = commands;
-            this.#serverRendered = true;
-        }
-        firstUpdated(changed) {
-            super.firstUpdated(changed);
-            if (this.#serverRendered)
-                fillEmptyTextParts(this.renderRoot); // gyral-4k7.12
-            if (DEVTOOLS_ENABLED)
-                devHydrated(this, tag, this.#serverRendered);
-            const commands = this.#afterHydration;
-            const wantsHydrated = reducers['Hydrated'] !== undefined;
-            if (commands.length === 0 && !wantsHydrated)
-                return;
-            this.#afterHydration = [];
-            // After the first (possibly hydrating) update has fully completed, so whatever these
-            // change starts a fresh update instead of diverging from the server markup.
-            void this.updateComplete.then(() => {
-                if (wantsHydrated) {
-                    this.#dispatch({ _tag: 'Hydrated', serverRendered: this.#serverRendered });
-                }
-                if (commands.length > 0)
-                    this.#apply([this.state, commands]);
-            });
-        }
-        // el.drivers → nearest provider → spec.drivers → the command's own (gyral-czi.35).
-        #resolve;
-        #onEvent;
-        #deliver;
-        #ctx() {
-            return { props: this.#props(), read: (store) => this.#binding.read(store) };
-        }
-        #storeChanged(store, state, prev) {
-            if (reducers['StoreChanged'] === undefined)
-                this.requestUpdate();
-            else
-                this.#dispatch({ _tag: 'StoreChanged', store: store.name, state, prev });
-        }
-        #props() {
-            // Sound: propNames are exactly the declared props, P's keys.
-            return readProps(this, propTable);
+}
+// One function serves both call forms; the overloads type the result.
+export function define() {
+    return defineElement;
+}
+function defineElement(tag, spec) {
+    checkSpec(tag, spec);
+    if (typeof HTMLElement === 'undefined') {
+        // No DOM (Node, Workers): the server renderer renders the spec itself (Phase 4). Only the
+        // spec is recorded here, so the server registry code never reaches client bundles.
+        recordSpec(tag, spec);
+        return Object.assign(function Placeholder() {
+            throw new Error(message(1, tag));
+        }, { spec, tagName: tag });
+    }
+    const existing = customElements.get(tag);
+    if (existing !== undefined) {
+        if (DEV && existing.spec !== spec) {
+            console.warn(`<${tag}> is already defined with a different spec; keeping the first.`);
         }
+        return existing;
     }
+    const Element = elementClass(tag, spec);
     markGyralHost(Element);
-    if (customElements.get(tag) === undefined)
-        customElements.define(tag, Element);
-    // Sound: the declared props are reactive properties on every instance.
+    customElements.define(tag, Element);
     return Element;
 }
 //# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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","sourcesContent":["import { isServer, LitElement } from 'lit';\nimport { providedDriver } from './drivers-scope.js';\nimport {\n  DEVTOOLS_ENABLED,\n  devCommands,\n  devConnect,\n  devHydrated,\n  devOwner,\n  devUpdate,\n} from '#devtools';\nimport {\n  splitNext,\n  type AnyDriver,\n  type Command,\n  type DriverOverrides,\n  type Next,\n} from './command.js';\nimport { dispatchOutput, EMIT } from './children.js';\nimport { FOCUS, focusAfterUpdate, type FocusInput } from './focus.js';\nimport type { GyralElement, GyralElementClass } from './element-types.js';\nimport { fillEmptyTextParts, takeSeed, writeSeed } from './hydration.js';\nimport { markIsland, scheduleIsland } from './islands.js';\nimport { runInit } from './init.js';\nimport { handleIntent, intentNames, listenForIntents, markGyralHost } from './intent.js';\nimport {\n  componentStyles,\n  hydrateLight,\n  hydrateShadow,\n  isLight,\n  markLightHost,\n} from './light-dom.js';\nimport { makeInterpreter, type Interpreter } from './internal/interpreter.js';\nimport {\n  missingRequired,\n  readProps,\n  readRawProps,\n  restoreProps,\n  sameProps,\n  shadowedBuiltins,\n  type PropTable,\n} from './props.js';\nimport { attachStates, type StateSync } from './states.js';\nimport { STORE_SEND, type AnyStore, type StoreOverrides, type StoreSendInput } from './store.js';\nimport { StoreBinding } from './store-binding.js';\nimport { withViewTransition } from './transitions.js';\nimport type {\n  ComponentSpec,\n  Ctx,\n  IntentNames,\n  IntentParser,\n  IntentRejected,\n  Tagged,\n} from './types.js';\n\nexport type { GyralElement, GyralElementClass } from './element-types.js';\n\n// Lit types `isServer` per build condition; widen it so both branches type-check (ADR 0012).\nconst onServer: boolean = isServer;\n\nconst DEFER_HYDRATION = 'defer-hydration';\n\n/**\n * Has Lit's hydrate support patched LitElement? It then defers `defer-hydration` elements\n * itself. A bundler can evaluate Lit before `@gyral/ssr/hydrate`, so it may not have\n * (gyral-czi.41); the patch adds an own static `observedAttributes` to LitElement.\n */\nconst litDefers = (): boolean =>\n  Object.prototype.hasOwnProperty.call(LitElement, 'observedAttributes');\n\n/**\n * Compiles a Model-View-Intent spec into a custom element and registers it under `tag`.\n * See docs/design-docs/0001-mvi-parsed-intent.md, 0006-effects-and-drivers.md, 0007-props.md\n * 0008-forms.md and 0012-ssr.md.\n */\nexport function define<S, M extends Tagged, P extends object = object, O extends Tagged = never>(\n  tag: string,\n  spec: ComponentSpec<S, M, P>,\n): GyralElementClass<S, M, P, O> {\n  const propTable = (spec.props ?? {}) as PropTable;\n  const propNames = Object.keys(propTable);\n  const shadowed = onServer ? [] : shadowedBuiltins(propNames);\n  if (shadowed.length > 0) {\n    console.warn(\n      `<${tag}> declares prop(s) that shadow built-in element properties: ` +\n        `${shadowed.join(', ')}. Setting them changes platform behaviour ` +\n        `(a prop named \"hidden\" hides the element). Rename them.`,\n    );\n  }\n  const parsers = spec.intent as Readonly<Record<string, IntentParser<M> | undefined>>;\n  // Sound: #dispatch() only calls the reducer whose key equals msg._tag.\n  const reducers = spec.update as unknown as Readonly<\n    Record<string, ((state: S, msg: Tagged, ctx: Ctx<P>) => Next<S, M>) | undefined>\n  >;\n\n  class Element extends LitElement implements GyralElement<S, M> {\n    static override properties = spec.props ?? {};\n    static override styles = componentStyles(spec, tag);\n    static readonly spec = spec;\n    static readonly tagName = tag;\n\n    // Always observe `defer-hydration`, so Gyral can defer server-rendered children itself\n    // when Lit's hydrate support isn't installed (gyral-czi.41, ADR 0012).\n    static override get observedAttributes(): string[] {\n      const base = super.observedAttributes;\n      return base.includes(DEFER_HYDRATION) ? base : [...base, DEFER_HYDRATION];\n    }\n\n    drivers: DriverOverrides = {};\n    stores: StoreOverrides = {};\n    initialMessages: readonly Tagged[] = [];\n\n    /** Reads, subscriptions and writes for spec.stores (ADR 0013). */\n    #binding = new StoreBinding(\n      this,\n      tag,\n      spec.stores ?? [],\n      () => this.stores,\n      (store, state, prev) => {\n        this.#storeChanged(store, state, prev);\n      },\n    );\n    #model: { value: S } | undefined;\n    /** Props as of the last init or PropsChanged; the `prev` of the next PropsChanged. */\n    #seenProps: P | undefined;\n    #listening = false;\n    #interpreter: Interpreter<M | IntentRejected> | undefined;\n    #pending: Command<M | IntentRejected>[] = [];\n    /** init's commands on the hydration path; started in firstUpdated (ADR 0012). */\n    #afterHydration: readonly Command<M | IntentRejected>[] = [];\n    /** Resumed from server markup; reported by the Hydrated message. */\n    #serverRendered = false;\n    /** The renderRoot is a server-rendered (declarative) shadow root to hydrate in place. */\n    #ssrShadow = false;\n    /** The latest view-transition update, awaited by updateComplete. */\n    #transition: Promise<void> | undefined;\n    /** Mirrors spec.states onto CSS custom states; only attached when the spec asks. */\n    #syncStates: StateSync | undefined =\n      spec.states === undefined || onServer ? undefined : attachStates(this);\n\n    get state(): S {\n      if (this.#model === undefined) {\n        const missing = missingRequired(this, propTable);\n        if (missing.length > 0) {\n          console.warn(`<${tag}> is missing required prop(s): ${missing.join(', ')}.`);\n        }\n        this.#seenProps = this.#props();\n        this.#apply(runInit(spec, this.#seenProps));\n        for (const msg of this.initialMessages) this.#dispatch(msg, false);\n      }\n      return (this.#model as { value: S }).value;\n    }\n\n    send(msg: M): void {\n      this.#dispatch(msg);\n    }\n\n    #dispatch(msg: Tagged, render = true): void {\n      const reducer = reducers[msg._tag];\n      if (reducer === undefined) {\n        // Framework messages have optional reducers; props and stores stay readable as context.\n        if (msg._tag !== 'PropsChanged' && msg._tag !== 'StoreChanged') {\n          console.warn(`<${tag}> has no update for message \"${msg._tag}\".`);\n        }\n        return;\n      }\n      const prev = this.state;\n      this.#apply(reducer(prev, msg, this.#ctx()));\n      if (DEVTOOLS_ENABLED) devUpdate(this, tag, msg, prev, this.state);\n      if (!render) return;\n      if (spec.viewTransition?.(prev, this.state, msg) === true) {\n        // The DOM change happens inside the transition callback (ADR 0001 addendum);\n        // updateComplete waits for it, so tests and callers see the new DOM.\n        this.#transition = withViewTransition(async () => {\n          this.requestUpdate();\n          await super.getUpdateComplete();\n        }).catch((error: unknown) => {\n          console.error(`<${tag}> view transition update failed`, error);\n        });\n      } else {\n        this.requestUpdate();\n      }\n    }\n\n    protected override async getUpdateComplete(): Promise<boolean> {\n      await this.#transition;\n      return super.getUpdateComplete();\n    }\n\n    override connectedCallback(): void {\n      this.#resumeFromSeed();\n      // A component server-rendered inside another's view waits (`defer-hydration`) for its\n      // parent to hydrate first. Lit's hydrate support, when installed, defers LitElement\n      // itself; otherwise Gyral holds back Lit's connect until the attribute goes.\n      const waiting = this.hasAttribute(DEFER_HYDRATION);\n      if (!waiting || litDefers()) super.connectedCallback();\n      if (waiting) {\n        scheduleIsland(this); // lazy islands release themselves (gyral-4k7.4)\n        return;\n      }\n      this.#connect();\n    }\n\n    override attributeChangedCallback(name: string, old: string | null, value: string | null) {\n      super.attributeChangedCallback(name, old, value);\n      if (name !== DEFER_HYDRATION || value !== null || !this.isConnected) return;\n      if (!litDefers()) super.connectedCallback(); // Lit's support would have connected it\n      this.#connect();\n    }\n\n    #connect(): void {\n      // Re-resolve on every connect: the nearest <gyral-stores> may differ after a move.\n      if (this.#binding.connect()) this.requestUpdate();\n      this.#interpreter = makeInterpreter<M | IntentRejected>(\n        this.#resolve,\n        (msg) => {\n          this.#dispatch(msg);\n        },\n        DEVTOOLS_ENABLED ? devCommands(() => devOwner(this, tag)) : undefined,\n      );\n      if (DEVTOOLS_ENABLED) devConnect(this, tag, true);\n      const pending = this.#pending;\n      this.#pending = [];\n      for (const cmd of pending) this.#interpreter.run(cmd);\n      if (this.#listening) return;\n      listenForIntents(this.renderRoot, spec.events ?? [], this.#onEvent);\n      this.#listening = true;\n    }\n\n    override disconnectedCallback(): void {\n      super.disconnectedCallback();\n      this.#binding.disconnect();\n      this.#interpreter?.dispose();\n      this.#interpreter = undefined;\n      if (DEVTOOLS_ENABLED) devConnect(this, tag, false);\n    }\n\n    protected override willUpdate(changed: Map<PropertyKey, unknown>): void {\n      super.willUpdate(changed);\n      if (onServer) {\n        // Server renders run constructor, willUpdate and render only (ADR 0012).\n        // init is pure, so the client can recompute an unchanged state from the props.\n        const [initial] = splitNext(runInit(spec, this.#props()));\n        writeSeed(this, this.state, readRawProps(this, propTable), propTable, { value: initial });\n        if (isLight(spec)) markLightHost(this);\n        markIsland(this, spec.hydrate);\n        return;\n      }\n      const prev = this.#seenProps;\n      if (prev === undefined) return; // first render: init() sees the props\n      const props = this.#props();\n      if (sameProps(propNames, props, prev)) return;\n      this.#seenProps = props;\n      // Inside the update cycle, so the new state renders in this same pass.\n      this.#dispatch({ _tag: 'PropsChanged', props, prev } as Tagged, false);\n    }\n\n    // Light-DOM mode (ADR 0014): render into the element itself. A server-rendered shadow root\n    // (Declarative Shadow DOM) is reused as is and hydrated in update() (gyral-czi.41): this\n    // bypasses Lit's hydrate-support patch on purpose, so hydration is correct whether or not\n    // that patch was installed before Lit evaluated (bundlers can reorder it; ADR 0012).\n    protected override createRenderRoot(): HTMLElement | DocumentFragment {\n      if (isLight(spec)) return this;\n      if (!onServer && this.shadowRoot !== null) {\n        this.#ssrShadow = true;\n        return this.shadowRoot;\n      }\n      return super.createRenderRoot();\n    }\n\n    protected override update(changed: Map<PropertyKey, unknown>): void {\n      if (this.#ssrShadow && !this.hasUpdated) {\n        const styles = (this.constructor as typeof LitElement).elementStyles;\n        hydrateShadow(this.renderRoot as ShadowRoot, this.render(), this.renderOptions, styles);\n      }\n      if (isLight(spec) && !this.hasUpdated && this.#serverRendered) {\n        hydrateLight(this, this.render(), this.renderOptions); // ADR 0014\n      }\n      super.update(changed);\n    }\n\n    protected override render(): unknown {\n      return spec.view(this.state, intentNames as IntentNames<M>, this.#ctx());\n    }\n\n    protected override updated(changed: Map<PropertyKey, unknown>): void {\n      super.updated(changed);\n      if (spec.states !== undefined) this.#syncStates?.(spec.states(this.state));\n    }\n\n    #apply(next: Next<S, M>): void {\n      const [state, commands] = splitNext(next);\n      this.#model = { value: state };\n      if (onServer) return; // commands never run on the server; the client's init starts them\n      for (const cmd of commands) {\n        if (cmd.driver === EMIT) dispatchOutput(this, cmd.input);\n        else if (cmd.driver === STORE_SEND) this.#binding.send(cmd.input as StoreSendInput);\n        else if (cmd.driver === FOCUS) focusAfterUpdate(this, tag, cmd.input as FocusInput);\n        else if (this.#interpreter === undefined) this.#pending.push(cmd);\n        else this.#interpreter.run(cmd);\n      }\n    }\n\n    /**\n     * Hydration (ADR 0012): use the server's state and restore props that only travelled in the\n     * seed. init(props) runs again for its commands only, and they start after the hydrating\n     * render: a driver that answers synchronously must not change state before hydration.\n     */\n    #resumeFromSeed(): void {\n      if (this.#model !== undefined) return;\n      const seed = takeSeed(this);\n      if (seed === undefined) return;\n      restoreProps(this, propNames, seed.props);\n      this.#seenProps = this.#props();\n      const [initial, commands] = splitNext(runInit(spec, this.#seenProps));\n      // Sound: the seed is this component's own state, serialized by writeSeed() on the server;\n      // when absent, the server's state was exactly init(props) (seed deduplication).\n      this.#model = { value: 'state' in seed ? (seed.state as S) : initial };\n      this.#afterHydration = commands;\n      this.#serverRendered = true;\n    }\n\n    protected override firstUpdated(changed: Map<PropertyKey, unknown>): void {\n      super.firstUpdated(changed);\n      if (this.#serverRendered) fillEmptyTextParts(this.renderRoot); // gyral-4k7.12\n      if (DEVTOOLS_ENABLED) devHydrated(this, tag, this.#serverRendered);\n      const commands = this.#afterHydration;\n      const wantsHydrated = reducers['Hydrated'] !== undefined;\n      if (commands.length === 0 && !wantsHydrated) return;\n      this.#afterHydration = [];\n      // After the first (possibly hydrating) update has fully completed, so whatever these\n      // change starts a fresh update instead of diverging from the server markup.\n      void this.updateComplete.then(() => {\n        if (wantsHydrated) {\n          this.#dispatch({ _tag: 'Hydrated', serverRendered: this.#serverRendered } as Tagged);\n        }\n        if (commands.length > 0) this.#apply([this.state, commands]);\n      });\n    }\n\n    // el.drivers → nearest provider → spec.drivers → the command's own (gyral-czi.35).\n    #resolve = (driver: AnyDriver): AnyDriver =>\n      this.drivers[driver.name] ??\n      providedDriver(this, driver.name) ??\n      spec.drivers?.[driver.name] ??\n      driver;\n\n    #onEvent = (event: Event): void => {\n      handleIntent(event, this.renderRoot, parsers, tag, this.#deliver);\n    };\n\n    #deliver = (msg: Tagged | undefined): void => {\n      if (msg !== undefined && this.isConnected) this.#dispatch(msg);\n    };\n\n    #ctx(): Ctx<P> {\n      return { props: this.#props(), read: (store) => this.#binding.read(store) };\n    }\n\n    #storeChanged(store: AnyStore, state: unknown, prev: unknown): void {\n      if (reducers['StoreChanged'] === undefined) this.requestUpdate();\n      else this.#dispatch({ _tag: 'StoreChanged', store: store.name, state, prev } as Tagged);\n    }\n\n    #props(): P {\n      // Sound: propNames are exactly the declared props, P's keys.\n      return readProps(this, propTable) as P;\n    }\n  }\n\n  markGyralHost(Element);\n  if (customElements.get(tag) === undefined) customElements.define(tag, Element);\n  // Sound: the declared props are reactive properties on every instance.\n  return Element as unknown as GyralElementClass<S, M, P, O>;\n}\n"]}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/C,SAAS,SAAS,CAAC,GAAW,EAAE,IAAe;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5C,kFAAkF;IAClF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,mEAAmE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC;AAqCD,sEAAsE;AACtE,MAAM,UAAU,MAAM;IACpB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,IAA4C;IAC9E,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrB,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,0FAA0F;QAC1F,mFAAmF;QACnF,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtB,OAAO,MAAM,CAAC,MAAM,CAClB,SAAS,WAAW;YAClB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC,EACD,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CACvB,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAK,QAAwC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,gEAAgE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["// `define<S, M>()(tag, spec)` (docs/design-docs/view/05-element.md, ADR 0023): compiles a\n// Model-View-Intent spec into a custom element and registers it. Outside the browser it\n// records the spec in the server registry instead (view/06-server.md) and returns a\n// placeholder class.\nimport type { GyralElementClass } from './element-types.js';\nimport { elementClass } from './element.js';\nimport { markGyralHost } from './intent.js';\nimport { isLight } from './light-dom.js';\nimport { features } from './features.js';\nimport { recordSpec } from './server-specs.js';\nimport type { ComponentSpec, ShadowOption, Tagged } from './types.js';\nimport { DEV, message } from './view/index.js';\n\nexport type { GyralElement, GyralElementClass } from './element-types.js';\n\ninterface SpecShape {\n  readonly props?: object;\n  readonly shadow?: ShadowOption;\n  readonly styles?: unknown;\n}\n\nfunction checkSpec(tag: string, spec: SpecShape): void {\n  const names = Object.keys(spec.props ?? {});\n  // The prop builders registered the prop feature (features.ts) if there are props.\n  if (names.length > 0) features.props?.checkShadowed(tag, names);\n  if (DEV && isLight(spec) && spec.styles !== undefined) {\n    console.warn(`<${tag}> has shadow: false, so its styles are ignored; use document CSS.`);\n  }\n}\n\n/** The second call of `define()`: takes the tag and the spec, infers the intent names. */\nexport type Definer<S, M extends Tagged, P extends object, O extends Tagged> = <\n  N extends string = never,\n>(\n  tag: string,\n  spec: ComponentSpec<S, M, P, N>,\n) => GyralElementClass<S, M, P, O, N>;\n\n/**\n * Compiles a Model-View-Intent spec into a custom element and registers it under `tag`. Two\n * calls (ADR 0023): the first takes the types, the second the tag and spec, from whose\n * `intent` keys it infers the component's intent names.\n *\n *   define<State, Msg>()('x-counter', { init, intent: { Increment: … }, update, view })\n *\n * With no type arguments, `define()('x-badge', spec)` infers the state, messages, props and\n * intent names from the spec. See docs/design-docs/0001-mvi-parsed-intent.md,\n * 0006-effects-and-drivers.md, 0007-props.md, 0008-forms.md and view/05-element.md.\n */\nexport function define(): <\n  S,\n  M extends Tagged = never,\n  P extends object = object,\n  N extends string = never,\n>(\n  tag: string,\n  spec: ComponentSpec<S, M, P, N>,\n) => GyralElementClass<S, M, P, never, N>;\nexport function define<\n  S,\n  // No messages: `define<State>()` for a pure view (intent and update optional).\n  M extends Tagged = never,\n  P extends object = object,\n  O extends Tagged = never,\n>(): Definer<S, M, P, O>;\n// One function serves both call forms; the overloads type the result.\nexport function define(): (tag: string, spec: never) => unknown {\n  return defineElement;\n}\n\nfunction defineElement(tag: string, spec: ComponentSpec<unknown, Tagged, object>): unknown {\n  checkSpec(tag, spec);\n  if (typeof HTMLElement === 'undefined') {\n    // No DOM (Node, Workers): the server renderer renders the spec itself (Phase 4). Only the\n    // spec is recorded here, so the server registry code never reaches client bundles.\n    recordSpec(tag, spec);\n    return Object.assign(\n      function Placeholder(): never {\n        throw new Error(message(1, tag));\n      },\n      { spec, tagName: tag },\n    );\n  }\n  const existing = customElements.get(tag);\n  if (existing !== undefined) {\n    if (DEV && (existing as { readonly spec?: unknown }).spec !== spec) {\n      console.warn(`<${tag}> is already defined with a different spec; keeping the first.`);\n    }\n    return existing;\n  }\n  const Element = elementClass(tag, spec);\n  markGyralHost(Element);\n  customElements.define(tag, Element);\n  return Element;\n}\n"]}

package/dist/devtools-events.d.ts

@@ -35,10 +35,23 @@ export type DevEvent = {
     readonly kind: 'hydrated';
     readonly component: DevComponentRef;
     readonly serverRendered: boolean;
+} | {
+    /** The server DOM didn't match the first render (view/07-hydration.md "Mismatches"). */
+    readonly kind: 'mismatch';
+    readonly component: DevComponentRef;
+    readonly message: string;
 } | ({
     readonly kind: 'command';
     readonly owner: string;
 } & CommandTraceEvent) | {
+    /** A failure Gyral caught (ADR 0024): `component` is absent for stores and shared work. */
+    readonly kind: 'error';
+    readonly component?: DevComponentRef;
+    readonly phase: string;
+    readonly msg?: string;
+    readonly message: string;
+    readonly error: unknown;
+} | {
     readonly kind: 'store';
     readonly store: string;
     readonly msg: Tagged;

package/dist/devtools-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools-events.js","sourceRoot":"","sources":["../src/devtools-events.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC","sourcesContent":["// The devtools event stream (ADR 0017). Types and the global hook name only: the emitting code\n// lives in devtools.ts (development builds) and devtools-off.ts (production builds).\nimport type { Concurrency } from './command.js';\nimport type { Tagged } from './types.js';\n\n/** Where a listener installs itself: `globalThis.__GYRAL_DEVTOOLS__ = { emit }`. */\nexport const DEVTOOLS_GLOBAL = '__GYRAL_DEVTOOLS__';\n\n/** A live component, identified for the timeline. `element` gives the panel its state. */\nexport interface DevComponentRef {\n  readonly tag: string;\n  readonly id: number;\n  readonly element: Element;\n}\n\nexport type CommandPhase = 'issued' | 'dropped' | 'settled' | 'failed' | 'interrupted';\n\n/** What the interpreter reports about one command (ADR 0006 lanes and policies). */\nexport interface CommandTraceEvent {\n  readonly phase: CommandPhase;\n  readonly driver: string;\n  readonly lane: string;\n  readonly policy: Concurrency;\n  readonly input: unknown;\n  /** Driver output (`settled`) or error (`failed`). */\n  readonly result?: unknown;\n}\n\nexport type CommandTrace = (event: CommandTraceEvent) => void;\n\nexport type DevEvent = { readonly at: number } & (\n  | { readonly kind: 'connect' | 'disconnect'; readonly component: DevComponentRef }\n  | {\n      readonly kind: 'update';\n      readonly component: DevComponentRef;\n      readonly msg: Tagged;\n      readonly prev: unknown;\n      readonly next: unknown;\n    }\n  | {\n      readonly kind: 'hydrated';\n      readonly component: DevComponentRef;\n      readonly serverRendered: boolean;\n    }\n  | ({ readonly kind: 'command'; readonly owner: string } & CommandTraceEvent)\n  | {\n      readonly kind: 'store';\n      readonly store: string;\n      readonly msg: Tagged;\n      readonly prev: unknown;\n      readonly next: unknown;\n    }\n);\n\n/** Installed by a devtools panel (or a test) on `globalThis[DEVTOOLS_GLOBAL]`. */\nexport interface DevtoolsHook {\n  emit(event: DevEvent): void;\n}\n"]}
+{"version":3,"file":"devtools-events.js","sourceRoot":"","sources":["../src/devtools-events.ts"],"names":[],"mappings":"AAKA,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC","sourcesContent":["// The devtools event stream (ADR 0017). Types and the global hook name only: the emitting code\n// lives in devtools.ts (development builds) and devtools-off.ts (production builds).\nimport type { Concurrency } from './command.js';\nimport type { Tagged } from './types.js';\n\n/** Where a listener installs itself: `globalThis.__GYRAL_DEVTOOLS__ = { emit }`. */\nexport const DEVTOOLS_GLOBAL = '__GYRAL_DEVTOOLS__';\n\n/** A live component, identified for the timeline. `element` gives the panel its state. */\nexport interface DevComponentRef {\n  readonly tag: string;\n  readonly id: number;\n  readonly element: Element;\n}\n\nexport type CommandPhase = 'issued' | 'dropped' | 'settled' | 'failed' | 'interrupted';\n\n/** What the interpreter reports about one command (ADR 0006 lanes and policies). */\nexport interface CommandTraceEvent {\n  readonly phase: CommandPhase;\n  readonly driver: string;\n  readonly lane: string;\n  readonly policy: Concurrency;\n  readonly input: unknown;\n  /** Driver output (`settled`) or error (`failed`). */\n  readonly result?: unknown;\n}\n\nexport type CommandTrace = (event: CommandTraceEvent) => void;\n\nexport type DevEvent = { readonly at: number } & (\n  | { readonly kind: 'connect' | 'disconnect'; readonly component: DevComponentRef }\n  | {\n      readonly kind: 'update';\n      readonly component: DevComponentRef;\n      readonly msg: Tagged;\n      readonly prev: unknown;\n      readonly next: unknown;\n    }\n  | {\n      readonly kind: 'hydrated';\n      readonly component: DevComponentRef;\n      readonly serverRendered: boolean;\n    }\n  | {\n      /** The server DOM didn't match the first render (view/07-hydration.md \"Mismatches\"). */\n      readonly kind: 'mismatch';\n      readonly component: DevComponentRef;\n      readonly message: string;\n    }\n  | ({ readonly kind: 'command'; readonly owner: string } & CommandTraceEvent)\n  | {\n      /** A failure Gyral caught (ADR 0024): `component` is absent for stores and shared work. */\n      readonly kind: 'error';\n      readonly component?: DevComponentRef;\n      readonly phase: string;\n      readonly msg?: string;\n      readonly message: string;\n      readonly error: unknown;\n    }\n  | {\n      readonly kind: 'store';\n      readonly store: string;\n      readonly msg: Tagged;\n      readonly prev: unknown;\n      readonly next: unknown;\n    }\n);\n\n/** Installed by a devtools panel (or a test) on `globalThis[DEVTOOLS_GLOBAL]`. */\nexport interface DevtoolsHook {\n  emit(event: DevEvent): void;\n}\n"]}

package/dist/devtools-off.d.ts

@@ -3,7 +3,9 @@ export declare const DEVTOOLS_ENABLED: boolean;
 export declare const devConnect: typeof Dev.devConnect;
 export declare const devUpdate: typeof Dev.devUpdate;
 export declare const devHydrated: typeof Dev.devHydrated;
+export declare const devMismatch: typeof Dev.devMismatch;
 export declare const devStore: typeof Dev.devStore;
+export declare const devError: typeof Dev.devError;
 export declare const devCommands: typeof Dev.devCommands;
 export declare const devOwner: typeof Dev.devOwner;
 export declare const devLiveComponents: typeof Dev.devLiveComponents;

package/dist/devtools-off.js

@@ -3,7 +3,9 @@ const noop = () => undefined;
 export const devConnect = noop;
 export const devUpdate = noop;
 export const devHydrated = noop;
+export const devMismatch = noop;
 export const devStore = noop;
+export const devError = noop;
 export const devCommands = () => noop;
 export const devOwner = () => '';
 export const devLiveComponents = () => [];

package/dist/devtools-off.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools-off.js","sourceRoot":"","sources":["../src/devtools-off.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gBAAgB,GAAY,KAAK,CAAC;AAE/C,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAEnC,MAAM,CAAC,MAAM,UAAU,GAA0B,IAAI,CAAC;AACtD,MAAM,CAAC,MAAM,SAAS,GAAyB,IAAI,CAAC;AACpD,MAAM,CAAC,MAAM,WAAW,GAA2B,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAwB,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,WAAW,GAA2B,GAAG,EAAE,CAAC,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAwB,GAAG,EAAE,CAAC,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAiC,GAAG,EAAE,CAAC,EAAE,CAAC","sourcesContent":["// Production build of the devtools hook (ADR 0017): the same names as devtools.ts, doing\n// nothing. Call sites guard with DEVTOOLS_ENABLED, a literal `false` here, so bundlers drop\n// them entirely. The `typeof Dev.x` annotations keep both modules' signatures in sync.\nimport type * as Dev from './devtools.js';\n\nexport const DEVTOOLS_ENABLED: boolean = false;\n\nconst noop = (): void => undefined;\n\nexport const devConnect: typeof Dev.devConnect = noop;\nexport const devUpdate: typeof Dev.devUpdate = noop;\nexport const devHydrated: typeof Dev.devHydrated = noop;\nexport const devStore: typeof Dev.devStore = noop;\nexport const devCommands: typeof Dev.devCommands = () => noop;\nexport const devOwner: typeof Dev.devOwner = () => '';\nexport const devLiveComponents: typeof Dev.devLiveComponents = () => [];\n"]}
+{"version":3,"file":"devtools-off.js","sourceRoot":"","sources":["../src/devtools-off.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gBAAgB,GAAY,KAAK,CAAC;AAE/C,MAAM,IAAI,GAAG,GAAS,EAAE,CAAC,SAAS,CAAC;AAEnC,MAAM,CAAC,MAAM,UAAU,GAA0B,IAAI,CAAC;AACtD,MAAM,CAAC,MAAM,SAAS,GAAyB,IAAI,CAAC;AACpD,MAAM,CAAC,MAAM,WAAW,GAA2B,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,WAAW,GAA2B,IAAI,CAAC;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAwB,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,QAAQ,GAAwB,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,WAAW,GAA2B,GAAG,EAAE,CAAC,IAAI,CAAC;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAwB,GAAG,EAAE,CAAC,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAiC,GAAG,EAAE,CAAC,EAAE,CAAC","sourcesContent":["// Production build of the devtools hook (ADR 0017): the same names as devtools.ts, doing\n// nothing. Call sites guard with DEVTOOLS_ENABLED, a literal `false` here, so bundlers drop\n// them entirely. The `typeof Dev.x` annotations keep both modules' signatures in sync.\nimport type * as Dev from './devtools.js';\n\nexport const DEVTOOLS_ENABLED: boolean = false;\n\nconst noop = (): void => undefined;\n\nexport const devConnect: typeof Dev.devConnect = noop;\nexport const devUpdate: typeof Dev.devUpdate = noop;\nexport const devHydrated: typeof Dev.devHydrated = noop;\nexport const devMismatch: typeof Dev.devMismatch = noop;\nexport const devStore: typeof Dev.devStore = noop;\nexport const devError: typeof Dev.devError = noop;\nexport const devCommands: typeof Dev.devCommands = () => noop;\nexport const devOwner: typeof Dev.devOwner = () => '';\nexport const devLiveComponents: typeof Dev.devLiveComponents = () => [];\n"]}

package/dist/devtools.d.ts

@@ -1,4 +1,5 @@
 import { type CommandTrace, type DevComponentRef } from './devtools-events.js';
+import type { GyralError } from './errors.js';
 import type { Tagged } from './types.js';
 export declare const DEVTOOLS_ENABLED: boolean;
 /** Components connected right now, for a panel that starts after they did. */
@@ -6,7 +7,10 @@ export declare function devLiveComponents(): readonly DevComponentRef[];
 export declare function devConnect(element: Element, tag: string, connected: boolean): void;
 export declare function devUpdate(element: Element, tag: string, msg: Tagged, prev: unknown, next: unknown): void;
 export declare function devHydrated(element: Element, tag: string, serverRendered: boolean): void;
+export declare function devMismatch(element: Element, tag: string, message: string): void;
 export declare function devStore(store: string, msg: Tagged, prev: unknown, next: unknown): void;
+/** A failure `fail()` reported (ADR 0024); `element` is the failing host, if any. */
+export declare function devError(element: Element | undefined, error: GyralError): void;
 /** A command tracer for one owner (`<tag>#id` or `store:name`). */
 export declare function devCommands(owner: () => string): CommandTrace;
 /** The label the panel shows for a component's commands. */

package/dist/devtools.js

@@ -2,7 +2,6 @@
 // with the `development` condition; production builds get devtools-off.ts instead, so the
 // guarded call sites (`if (DEVTOOLS_ENABLED) …`) disappear from the bundle.
 import { DEVTOOLS_GLOBAL, } from './devtools-events.js';
-import { warnLeakingLitHtmlOnce } from './lit-html-check.js';
 export const DEVTOOLS_ENABLED = true;
 const hook = () => globalThis[DEVTOOLS_GLOBAL];
 const ids = new WeakMap();
@@ -35,7 +34,6 @@ export function devLiveComponents() {
     return [...live].map(([element, tag]) => ref(element, tag));
 }
 export function devConnect(element, tag, connected) {
-    warnLeakingLitHtmlOnce();
     if (connected)
         live.set(element, tag);
     else
@@ -52,9 +50,26 @@ export function devUpdate(element, tag, msg, prev, next) {
 export function devHydrated(element, tag, serverRendered) {
     emit(() => ({ kind: 'hydrated', component: ref(element, tag), serverRendered, at: now() }));
 }
+export function devMismatch(element, tag, message) {
+    emit(() => ({ kind: 'mismatch', component: ref(element, tag), message, at: now() }));
+}
 export function devStore(store, msg, prev, next) {
     emit(() => ({ kind: 'store', store, msg, prev, next, at: now() }));
 }
+/** A failure `fail()` reported (ADR 0024); `element` is the failing host, if any. */
+export function devError(element, error) {
+    emit(() => ({
+        kind: 'error',
+        ...(element === undefined
+            ? {}
+            : { component: ref(element, error.component ?? element.localName) }),
+        phase: error.phase,
+        ...(error.msg === undefined ? {} : { msg: error.msg }),
+        message: error.message,
+        error: error.cause,
+        at: now(),
+    }));
+}
 /** A command tracer for one owner (`<tag>#id` or `store:name`). */
 export function devCommands(owner) {
     return (event) => {

package/dist/devtools.js.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"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","sourcesContent":["// Development build of the devtools hook (ADR 0017). Resolved through the `#devtools` import\n// with the `development` condition; production builds get devtools-off.ts instead, so the\n// guarded call sites (`if (DEVTOOLS_ENABLED) …`) disappear from the bundle.\nimport {\n  DEVTOOLS_GLOBAL,\n  type CommandTrace,\n  type DevComponentRef,\n  type DevEvent,\n  type DevtoolsHook,\n} from './devtools-events.js';\nimport { warnLeakingLitHtmlOnce } from './lit-html-check.js';\nimport type { Tagged } from './types.js';\n\nexport const DEVTOOLS_ENABLED: boolean = true;\n\nconst hook = (): DevtoolsHook | undefined =>\n  (globalThis as Record<string, unknown>)[DEVTOOLS_GLOBAL] as DevtoolsHook | undefined;\n\nconst ids = new WeakMap<Element, number>();\nlet nextId = 1;\n\nfunction ref(element: Element, tag: string): DevComponentRef {\n  let id = ids.get(element);\n  if (id === undefined) {\n    id = nextId++;\n    ids.set(element, id);\n  }\n  return { tag, id, element };\n}\n\n// Builds nothing unless a listener is installed: zero cost in dev without devtools.\nfunction emit(make: () => DevEvent): void {\n  const listener = hook();\n  if (listener === undefined) return;\n  try {\n    listener.emit(make());\n  } catch (error) {\n    console.error('gyral devtools listener threw', error);\n  }\n}\n\nconst now = (): number => performance.now();\n\n/** Connected components, so a panel loaded later still lists them (dev builds only). */\nconst live = new Map<Element, string>();\n\n/** Components connected right now, for a panel that starts after they did. */\nexport function devLiveComponents(): readonly DevComponentRef[] {\n  return [...live].map(([element, tag]) => ref(element, tag));\n}\n\nexport function devConnect(element: Element, tag: string, connected: boolean): void {\n  warnLeakingLitHtmlOnce();\n  if (connected) live.set(element, tag);\n  else live.delete(element);\n  emit(() => ({\n    kind: connected ? 'connect' : 'disconnect',\n    component: ref(element, tag),\n    at: now(),\n  }));\n}\n\nexport function devUpdate(\n  element: Element,\n  tag: string,\n  msg: Tagged,\n  prev: unknown,\n  next: unknown,\n) {\n  emit(() => ({ kind: 'update', component: ref(element, tag), msg, prev, next, at: now() }));\n}\n\nexport function devHydrated(element: Element, tag: string, serverRendered: boolean): void {\n  emit(() => ({ kind: 'hydrated', component: ref(element, tag), serverRendered, at: now() }));\n}\n\nexport function devStore(store: string, msg: Tagged, prev: unknown, next: unknown): void {\n  emit(() => ({ kind: 'store', store, msg, prev, next, at: now() }));\n}\n\n/** A command tracer for one owner (`<tag>#id` or `store:name`). */\nexport function devCommands(owner: () => string): CommandTrace {\n  return (event) => {\n    emit(() => ({ kind: 'command', owner: owner(), ...event, at: now() }));\n  };\n}\n\n/** The label the panel shows for a component's commands. */\nexport function devOwner(element: Element, tag: string): string {\n  return `<${tag}>#${String(ref(element, tag).id)}`;\n}\n"]}
+{"version":3,"file":"devtools.js","sourceRoot":"","sources":["../src/devtools.ts"],"names":[],"mappings":"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","sourcesContent":["// Development build of the devtools hook (ADR 0017). Resolved through the `#devtools` import\n// with the `development` condition; production builds get devtools-off.ts instead, so the\n// guarded call sites (`if (DEVTOOLS_ENABLED) …`) disappear from the bundle.\nimport {\n  DEVTOOLS_GLOBAL,\n  type CommandTrace,\n  type DevComponentRef,\n  type DevEvent,\n  type DevtoolsHook,\n} from './devtools-events.js';\nimport type { GyralError } from './errors.js';\nimport type { Tagged } from './types.js';\n\nexport const DEVTOOLS_ENABLED: boolean = true;\n\nconst hook = (): DevtoolsHook | undefined =>\n  (globalThis as Record<string, unknown>)[DEVTOOLS_GLOBAL] as DevtoolsHook | undefined;\n\nconst ids = new WeakMap<Element, number>();\nlet nextId = 1;\n\nfunction ref(element: Element, tag: string): DevComponentRef {\n  let id = ids.get(element);\n  if (id === undefined) {\n    id = nextId++;\n    ids.set(element, id);\n  }\n  return { tag, id, element };\n}\n\n// Builds nothing unless a listener is installed: zero cost in dev without devtools.\nfunction emit(make: () => DevEvent): void {\n  const listener = hook();\n  if (listener === undefined) return;\n  try {\n    listener.emit(make());\n  } catch (error) {\n    console.error('gyral devtools listener threw', error);\n  }\n}\n\nconst now = (): number => performance.now();\n\n/** Connected components, so a panel loaded later still lists them (dev builds only). */\nconst live = new Map<Element, string>();\n\n/** Components connected right now, for a panel that starts after they did. */\nexport function devLiveComponents(): readonly DevComponentRef[] {\n  return [...live].map(([element, tag]) => ref(element, tag));\n}\n\nexport function devConnect(element: Element, tag: string, connected: boolean): void {\n  if (connected) live.set(element, tag);\n  else live.delete(element);\n  emit(() => ({\n    kind: connected ? 'connect' : 'disconnect',\n    component: ref(element, tag),\n    at: now(),\n  }));\n}\n\nexport function devUpdate(\n  element: Element,\n  tag: string,\n  msg: Tagged,\n  prev: unknown,\n  next: unknown,\n) {\n  emit(() => ({ kind: 'update', component: ref(element, tag), msg, prev, next, at: now() }));\n}\n\nexport function devHydrated(element: Element, tag: string, serverRendered: boolean): void {\n  emit(() => ({ kind: 'hydrated', component: ref(element, tag), serverRendered, at: now() }));\n}\n\nexport function devMismatch(element: Element, tag: string, message: string): void {\n  emit(() => ({ kind: 'mismatch', component: ref(element, tag), message, at: now() }));\n}\n\nexport function devStore(store: string, msg: Tagged, prev: unknown, next: unknown): void {\n  emit(() => ({ kind: 'store', store, msg, prev, next, at: now() }));\n}\n\n/** A failure `fail()` reported (ADR 0024); `element` is the failing host, if any. */\nexport function devError(element: Element | undefined, error: GyralError): void {\n  emit(() => ({\n    kind: 'error',\n    ...(element === undefined\n      ? {}\n      : { component: ref(element, error.component ?? element.localName) }),\n    phase: error.phase,\n    ...(error.msg === undefined ? {} : { msg: error.msg }),\n    message: error.message,\n    error: error.cause,\n    at: now(),\n  }));\n}\n\n/** A command tracer for one owner (`<tag>#id` or `store:name`). */\nexport function devCommands(owner: () => string): CommandTrace {\n  return (event) => {\n    emit(() => ({ kind: 'command', owner: owner(), ...event, at: now() }));\n  };\n}\n\n/** The label the panel shows for a component's commands. */\nexport function devOwner(element: Element, tag: string): string {\n  return `<${tag}>#${String(ref(element, tag).id)}`;\n}\n"]}

package/dist/drivers-scope.d.ts

@@ -10,6 +10,6 @@ export declare function provideDrivers(element: Element, drivers: DriverOverride
 /**
  * The override for `name` from the nearest provider that has one. Providers nest: an inner
  * provider without that driver lets an outer one supply it. Commands never run on the server,
- * so there is nothing to resolve there.
+ * so only the browser calls this.
  */
 export declare function providedDriver(host: Element, name: string): AnyDriver | undefined;