@gyral/core 0.0.0 → 0.2.0

package/dist/define.js

@@ -0,0 +1,338 @@
+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.`);
+    }
+    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);
+        }
+    }
+    markGyralHost(Element);
+    if (customElements.get(tag) === undefined)
+        customElements.define(tag, Element);
+    // Sound: the declared props are reactive properties on every instance.
+    return Element;
+}
+//# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,SAAS,GAKV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,OAAO,EACP,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAoB,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EACL,eAAe,EACf,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,UAAU,EAA2D,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAYtD,6FAA6F;AAC7F,MAAM,QAAQ,GAAY,QAAQ,CAAC;AAEnC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,SAAS,GAAG,GAAY,EAAE,CAC9B,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,MAAM,CACpB,GAAW,EACX,IAA4B;IAE5B,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAc,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,IAAI,CACV,IAAI,GAAG,8DAA8D;YACnE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,4CAA4C;YAClE,yDAAyD,CAC5D,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAA+D,CAAC;IACrF,uEAAuE;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAErB,CAAC;IAEF,MAAM,OAAQ,SAAQ,UAAU;QAAhC;;YAaE,YAAO,GAAoB,EAAE,CAAC;YAC9B,WAAM,GAAmB,EAAE,CAAC;YAC5B,oBAAe,GAAsB,EAAE,CAAC;YAExC,kEAAkE;YAClE,aAAQ,GAAG,IAAI,YAAY,CACzB,IAAI,EACJ,GAAG,EACH,IAAI,CAAC,MAAM,IAAI,EAAE,EACjB,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EACjB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACrB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC,CACF,CAAC;YAIF,eAAU,GAAG,KAAK,CAAC;YAEnB,aAAQ,GAAkC,EAAE,CAAC;YAC7C,iFAAiF;YACjF,oBAAe,GAA2C,EAAE,CAAC;YAC7D,oEAAoE;YACpE,oBAAe,GAAG,KAAK,CAAC;YACxB,yFAAyF;YACzF,eAAU,GAAG,KAAK,CAAC;YAGnB,oFAAoF;YACpF,gBAAW,GACT,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YA0MzE,mFAAmF;YACnF,aAAQ,GAAG,CAAC,MAAiB,EAAa,EAAE,CAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBACzB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;gBACjC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3B,MAAM,CAAC;YAET,aAAQ,GAAG,CAAC,KAAY,EAAQ,EAAE;gBAChC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpE,CAAC,CAAC;YAEF,aAAQ,GAAG,CAAC,GAAuB,EAAQ,EAAE;gBAC3C,IAAI,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW;oBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACjE,CAAC,CAAC;QAeJ,CAAC;iBAhRiB,eAAU,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,AAAnB,CAAoB;iBAC9B,WAAM,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,AAA7B,CAA8B;iBACpC,SAAI,GAAG,IAAI,AAAP,CAAQ;iBACZ,YAAO,GAAG,GAAG,AAAN,CAAO;QAE9B,uFAAuF;QACvF,uEAAuE;QACvE,MAAM,KAAc,kBAAkB;YACpC,MAAM,IAAI,GAAG,KAAK,CAAC,kBAAkB,CAAC;YACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,eAAe,CAAC,CAAC;QAC5E,CAAC;QAMD,kEAAkE;QAClE,QAAQ,CAQN;QACF,MAAM,CAA2B;QACjC,sFAAsF;QACtF,UAAU,CAAgB;QAC1B,UAAU,CAAS;QACnB,YAAY,CAA8C;QAC1D,QAAQ,CAAqC;QAC7C,iFAAiF;QACjF,eAAe,CAA8C;QAC7D,oEAAoE;QACpE,eAAe,CAAS;QACxB,yFAAyF;QACzF,UAAU,CAAS;QACnB,oEAAoE;QACpE,WAAW,CAA4B;QACvC,oFAAoF;QACpF,WAAW,CAC8D;QAEzE,IAAI,KAAK;YACP,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACjD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,kCAAkC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC/E,CAAC;gBACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBAC5C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,eAAe;oBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrE,CAAC;YACD,OAAQ,IAAI,CAAC,MAAuB,CAAC,KAAK,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,GAAM;YACT,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,SAAS,CAAC,GAAW,EAAE,MAAM,GAAG,IAAI;YAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,wFAAwF;gBACxF,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAC/D,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,gCAAgC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7C,IAAI,gBAAgB;gBAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,6EAA6E;gBAC7E,qEAAqE;gBACrE,IAAI,CAAC,WAAW,GAAG,kBAAkB,CAAC,KAAK,IAAI,EAAE;oBAC/C,IAAI,CAAC,aAAa,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC,iBAAiB,EAAE,CAAC;gBAClC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;oBAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,iCAAiC,EAAE,KAAK,CAAC,CAAC;gBACjE,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QAEkB,KAAK,CAAC,iBAAiB;YACxC,MAAM,IAAI,CAAC,WAAW,CAAC;YACvB,OAAO,KAAK,CAAC,iBAAiB,EAAE,CAAC;QACnC,CAAC;QAEQ,iBAAiB;YACxB,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,sFAAsF;YACtF,oFAAoF;YACpF,6EAA6E;YAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;YACnD,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE;gBAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,gDAAgD;gBACtE,OAAO;YACT,CAAC;YACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAEQ,wBAAwB,CAAC,IAAY,EAAE,GAAkB,EAAE,KAAoB;YACtF,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,IAAI,KAAK,eAAe,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW;gBAAE,OAAO;YAC5E,IAAI,CAAC,SAAS,EAAE;gBAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,wCAAwC;YACrF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,QAAQ;YACN,mFAAmF;YACnF,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;gBAAE,IAAI,CAAC,aAAa,EAAE,CAAC;YAClD,IAAI,CAAC,YAAY,GAAG,eAAe,CACjC,IAAI,CAAC,QAAQ,EACb,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC,EACD,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CACtE,CAAC;YACF,IAAI,gBAAgB;gBAAE,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC5B,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QAEQ,oBAAoB;YAC3B,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,gBAAgB;gBAAE,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;QAEkB,UAAU,CAAC,OAAkC;YAC9D,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,QAAQ,EAAE,CAAC;gBACb,yEAAyE;gBACzE,+EAA+E;gBAC/E,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC1D,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC1F,IAAI,OAAO,CAAC,IAAI,CAAC;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC;gBACvC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;YAC7B,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,CAAC,sCAAsC;YACtE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC;gBAAE,OAAO;YAC9C,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,uEAAuE;YACvE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAY,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;QAED,2FAA2F;QAC3F,yFAAyF;QACzF,0FAA0F;QAC1F,qFAAqF;QAClE,gBAAgB;YACjC,IAAI,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/B,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBACvB,OAAO,IAAI,CAAC,UAAU,CAAC;YACzB,CAAC;YACD,OAAO,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAClC,CAAC;QAEkB,MAAM,CAAC,OAAkC;YAC1D,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,MAAM,MAAM,GAAI,IAAI,CAAC,WAAiC,CAAC,aAAa,CAAC;gBACrE,aAAa,CAAC,IAAI,CAAC,UAAwB,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC1F,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC9D,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW;YACpE,CAAC;YACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAEkB,MAAM;YACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,WAA6B,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAEkB,OAAO,CAAC,OAAkC;YAC3D,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,CAAC,IAAgB;YACrB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAC/B,IAAI,QAAQ;gBAAE,OAAO,CAAC,kEAAkE;YACxF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;oBAAE,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;qBACpD,IAAI,GAAG,CAAC,MAAM,KAAK,UAAU;oBAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAuB,CAAC,CAAC;qBAC/E,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;oBAAE,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,KAAmB,CAAC,CAAC;qBAC/E,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;oBAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;oBAC7D,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED;;;;WAIG;QACH,eAAe;YACb,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO;YACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC/B,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YACtE,0FAA0F;YAC1F,gFAAgF;YAChF,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACvE,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;YAChC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;QAEkB,YAAY,CAAC,OAAkC;YAChE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,IAAI,CAAC,eAAe;gBAAE,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe;YAC9E,IAAI,gBAAgB;gBAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC;YACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,SAAS,CAAC;YACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa;gBAAE,OAAO;YACpD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;YAC1B,qFAAqF;YACrF,4EAA4E;YAC5E,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjC,IAAI,aAAa,EAAE,CAAC;oBAClB,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,eAAe,EAAY,CAAC,CAAC;gBACvF,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC;QAED,mFAAmF;QACnF,QAAQ,CAIC;QAET,QAAQ,CAEN;QAEF,QAAQ,CAEN;QAEF,IAAI;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9E,CAAC;QAED,aAAa,CAAC,KAAe,EAAE,KAAc,EAAE,IAAa;YAC1D,IAAI,QAAQ,CAAC,cAAc,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,aAAa,EAAE,CAAC;;gBAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAY,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM;YACJ,6DAA6D;YAC7D,OAAO,SAAS,CAAC,IAAI,EAAE,SAAS,CAAM,CAAC;QACzC,CAAC;;IAGH,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/E,uEAAuE;IACvE,OAAO,OAAmD,CAAC;AAC7D,CAAC","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"]}

package/dist/devtools-events.d.ts

@@ -0,0 +1,51 @@
+import type { Concurrency } from './command.js';
+import type { Tagged } from './types.js';
+/** Where a listener installs itself: `globalThis.__GYRAL_DEVTOOLS__ = { emit }`. */
+export declare const DEVTOOLS_GLOBAL = "__GYRAL_DEVTOOLS__";
+/** A live component, identified for the timeline. `element` gives the panel its state. */
+export interface DevComponentRef {
+    readonly tag: string;
+    readonly id: number;
+    readonly element: Element;
+}
+export type CommandPhase = 'issued' | 'dropped' | 'settled' | 'failed' | 'interrupted';
+/** What the interpreter reports about one command (ADR 0006 lanes and policies). */
+export interface CommandTraceEvent {
+    readonly phase: CommandPhase;
+    readonly driver: string;
+    readonly lane: string;
+    readonly policy: Concurrency;
+    readonly input: unknown;
+    /** Driver output (`settled`) or error (`failed`). */
+    readonly result?: unknown;
+}
+export type CommandTrace = (event: CommandTraceEvent) => void;
+export type DevEvent = {
+    readonly at: number;
+} & ({
+    readonly kind: 'connect' | 'disconnect';
+    readonly component: DevComponentRef;
+} | {
+    readonly kind: 'update';
+    readonly component: DevComponentRef;
+    readonly msg: Tagged;
+    readonly prev: unknown;
+    readonly next: unknown;
+} | {
+    readonly kind: 'hydrated';
+    readonly component: DevComponentRef;
+    readonly serverRendered: boolean;
+} | ({
+    readonly kind: 'command';
+    readonly owner: string;
+} & CommandTraceEvent) | {
+    readonly kind: 'store';
+    readonly store: string;
+    readonly msg: Tagged;
+    readonly prev: unknown;
+    readonly next: unknown;
+});
+/** Installed by a devtools panel (or a test) on `globalThis[DEVTOOLS_GLOBAL]`. */
+export interface DevtoolsHook {
+    emit(event: DevEvent): void;
+}

package/dist/devtools-events.js

@@ -0,0 +1,3 @@
+/** Where a listener installs itself: `globalThis.__GYRAL_DEVTOOLS__ = { emit }`. */
+export const DEVTOOLS_GLOBAL = '__GYRAL_DEVTOOLS__';
+//# sourceMappingURL=devtools-events.js.map

package/dist/devtools-events.js.map

@@ -0,0 +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"]}

package/dist/devtools-off.d.ts

@@ -0,0 +1,9 @@
+import type * as Dev from './devtools.js';
+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 devStore: typeof Dev.devStore;
+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

@@ -0,0 +1,10 @@
+export const DEVTOOLS_ENABLED = false;
+const noop = () => undefined;
+export const devConnect = noop;
+export const devUpdate = noop;
+export const devHydrated = noop;
+export const devStore = noop;
+export const devCommands = () => noop;
+export const devOwner = () => '';
+export const devLiveComponents = () => [];
+//# sourceMappingURL=devtools-off.js.map

package/dist/devtools-off.js.map

@@ -0,0 +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"]}

package/dist/devtools.d.ts

@@ -0,0 +1,13 @@
+import { type CommandTrace, type DevComponentRef } from './devtools-events.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. */
+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 devStore(store: string, msg: Tagged, prev: unknown, next: unknown): 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. */
+export declare function devOwner(element: Element, tag: string): string;

package/dist/devtools.js

@@ -0,0 +1,68 @@
+// Development build of the devtools hook (ADR 0017). Resolved through the `#devtools` import
+// 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();
+let nextId = 1;
+function ref(element, tag) {
+    let id = ids.get(element);
+    if (id === undefined) {
+        id = nextId++;
+        ids.set(element, id);
+    }
+    return { tag, id, element };
+}
+// Builds nothing unless a listener is installed: zero cost in dev without devtools.
+function emit(make) {
+    const listener = hook();
+    if (listener === undefined)
+        return;
+    try {
+        listener.emit(make());
+    }
+    catch (error) {
+        console.error('gyral devtools listener threw', error);
+    }
+}
+const now = () => performance.now();
+/** Connected components, so a panel loaded later still lists them (dev builds only). */
+const live = new Map();
+/** Components connected right now, for a panel that starts after they did. */
+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
+        live.delete(element);
+    emit(() => ({
+        kind: connected ? 'connect' : 'disconnect',
+        component: ref(element, tag),
+        at: now(),
+    }));
+}
+export function devUpdate(element, tag, msg, prev, next) {
+    emit(() => ({ kind: 'update', component: ref(element, tag), msg, prev, next, at: now() }));
+}
+export function devHydrated(element, tag, serverRendered) {
+    emit(() => ({ kind: 'hydrated', component: ref(element, tag), serverRendered, at: now() }));
+}
+export function devStore(store, msg, prev, next) {
+    emit(() => ({ kind: 'store', store, msg, prev, next, at: now() }));
+}
+/** A command tracer for one owner (`<tag>#id` or `store:name`). */
+export function devCommands(owner) {
+    return (event) => {
+        emit(() => ({ kind: 'command', owner: owner(), ...event, at: now() }));
+    };
+}
+/** The label the panel shows for a component's commands. */
+export function devOwner(element, tag) {
+    return `<${tag}>#${String(ref(element, tag).id)}`;
+}
+//# sourceMappingURL=devtools.js.map

package/dist/devtools.js.map

@@ -0,0 +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"]}

package/dist/drivers-scope.d.ts

@@ -0,0 +1,15 @@
+import type { AnyDriver, DriverOverrides } from './command.js';
+/** Provider element name: `<gyral-drivers .drivers=${{ http: fake }}>…</gyral-drivers>`. */
+export declare const DRIVERS_ELEMENT = "gyral-drivers";
+/**
+ * Makes `element` a driver provider for every Gyral component below it (including inside
+ * shadow roots). Returns a function that removes the overrides. Use it on a test container
+ * or an app root; a `<gyral-drivers>` element with a `.drivers` property works the same way.
+ */
+export declare function provideDrivers(element: Element, drivers: DriverOverrides): () => void;
+/**
+ * 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.
+ */
+export declare function providedDriver(host: Element, name: string): AnyDriver | undefined;