@gyral/core 0.0.0 → 0.2.0

package/dist/store.js

@@ -0,0 +1,129 @@
+import { isServer } from 'lit';
+import { DEVTOOLS_ENABLED, devCommands, devStore } from '#devtools';
+import { splitNext, } from './command.js';
+import { makeInterpreter } from './internal/interpreter.js';
+const onServer = isServer;
+/** Defines a store. `name` keys it in registries, seeds and overrides, so keep it unique. */
+export function defineStore(name, spec) {
+    const store = {
+        name,
+        spec,
+        instance: (initial) => createInstance(store, initial),
+        checkSeed: (seed) => checkSeed(spec.schema, seed),
+    };
+    return store;
+}
+const issuePath = (issue) => (issue.path ?? []).map((s) => String(typeof s === 'object' ? s.key : s)).join('.');
+function checkSeed(schema, seed) {
+    // Sound without a schema: the seed is this store's state, serialized by the server.
+    if (schema === undefined)
+        return { ok: true, state: seed };
+    const result = schema['~standard'].validate(seed);
+    if (result instanceof Promise) {
+        return { ok: false, issues: ['the store schema is async; seeds need a synchronous schema'] };
+    }
+    if (result.issues === undefined)
+        return { ok: true, state: result.value };
+    return {
+        ok: false,
+        issues: result.issues.map((i) => `${issuePath(i) || '(root)'}: ${i.message}`),
+    };
+}
+function createInstance(store, initial) {
+    // Sound: send() only calls the reducer whose key equals msg._tag.
+    const reducers = store.spec.update;
+    const listeners = new Set();
+    let interpreter;
+    let disposed = false;
+    const [initState, initCommands] = splitNext(store.spec.init());
+    let state = initial === undefined ? initState : initial;
+    const resolve = (driver) => instance.drivers[driver.name] ?? store.spec.drivers?.[driver.name] ?? driver;
+    let scope;
+    // Store-to-store writes: delivered synchronously to the other store's instance in scope.
+    const deliver = ({ store: target, msg }) => {
+        if (scope === undefined) {
+            console.warn(`store "${store.name}" sends to "${target.name}" but is not held by a store scope ` +
+                '(a registry, <gyral-stores> or the page default), so the message is dropped.');
+            return;
+        }
+        scope(target).send(msg);
+    };
+    const run = (commands) => {
+        if (onServer || disposed || commands.length === 0)
+            return; // never on the server (ADR 0012)
+        for (const cmd of commands) {
+            if (cmd.driver === STORE_SEND) {
+                deliver(cmd.input);
+                continue;
+            }
+            interpreter ??= makeInterpreter(resolve, (msg) => {
+                // Stores have no IntentRejected reducer; only their own messages apply.
+                if (msg._tag !== 'IntentRejected')
+                    instance.send(msg);
+            }, DEVTOOLS_ENABLED ? devCommands(() => `store:${store.name}`) : undefined);
+            interpreter.run(cmd);
+        }
+    };
+    const instance = {
+        store,
+        get state() {
+            return state;
+        },
+        drivers: {},
+        send(msg) {
+            const reducer = reducers[msg._tag];
+            if (reducer === undefined) {
+                console.warn(`store "${store.name}" has no update for message "${msg._tag}".`);
+                return;
+            }
+            const prev = state;
+            const [next, commands] = splitNext(reducer(prev, msg));
+            state = next;
+            if (DEVTOOLS_ENABLED)
+                devStore(store.name, msg, prev, next);
+            if (!Object.is(next, prev))
+                for (const listener of [...listeners])
+                    listener(next, prev);
+            run(commands);
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        dispose() {
+            disposed = true;
+            interpreter?.dispose();
+            listeners.clear();
+        },
+        bindScope(resolver) {
+            scope = resolver;
+        },
+    };
+    // A seeded instance (hydration) starts init's commands after the hydrating renders flushed,
+    // so a fast driver can't change state under them (same reason as ADR 0012 for components).
+    if (initial === undefined)
+        run(initCommands);
+    else if (initCommands.length > 0)
+        setTimeout(() => {
+            run(initCommands);
+        }, 0);
+    return instance;
+}
+/** Marker driver for `send()`: `define()` delivers these to the resolved store instance. */
+export const STORE_SEND = {
+    name: '@gyral/store-send',
+    run: () => undefined,
+};
+/** A command that sends `msg` to the component's instance of `store`. Writes are commands. */
+// NoInfer: the store decides the message type, so a literal (`{ _tag: 'Track', … }`) is checked
+// against it instead of widening `_tag` to string (store-to-store sends have no other context).
+export function send(store, msg) {
+    const input = { store, msg };
+    return { driver: STORE_SEND, input, onSuccess: () => undefined };
+}
+/** Narrows a `StoreChanged` message to one store's typed state, or `undefined`. */
+export function changed(store, msg) {
+    // Sound: the message was built from this store's instance (matched by unique name).
+    return msg.store === store.name ? { state: msg.state, prev: msg.prev } : undefined;
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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","sourcesContent":["// Shared state: stores as \"props from the side\" (docs/design-docs/0013-shared-state.md).\n// A store is MVI without a view: init + pure update, commands run by its own interpreter.\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { isServer } from 'lit';\nimport { DEVTOOLS_ENABLED, devCommands, devStore } from '#devtools';\nimport {\n  splitNext,\n  type AnyDriver,\n  type Command,\n  type DriverOverrides,\n  type Next,\n} from './command.js';\nimport { makeInterpreter, type Interpreter } from './internal/interpreter.js';\nimport type { IntentRejected, Tagged } from './types.js';\n\nconst onServer: boolean = isServer;\n\ntype Variant<M extends Tagged, K extends M['_tag']> = Extract<M, { readonly _tag: K }>;\n\n/** One pure reducer per message tag, like a component's `update` but without context. */\nexport type StoreUpdate<S, M extends Tagged> = {\n  readonly [K in M['_tag']]: (state: S, msg: Variant<M, K>) => Next<S, M>;\n};\n\nexport interface StoreSpec<S, M extends Tagged> {\n  /** Initial state (and optional commands, e.g. load a saved cart). */\n  readonly init: () => Next<S, M>;\n  readonly update: StoreUpdate<S, M>;\n  /** Driver substitutions by name for this store's commands. */\n  readonly drivers?: DriverOverrides;\n  /**\n   * Validates the server's page seed before the client uses it (any synchronous Standard\n   * Schema). An invalid seed is reported with console.error and the store starts from `init`.\n   */\n  readonly schema?: StandardSchemaV1<unknown, S>;\n}\n\n/** The result of checking a seed against a store's schema. */\nexport type SeedCheck<S> =\n  | { readonly ok: true; readonly state: S }\n  | { readonly ok: false; readonly issues: readonly string[] };\n\n/** What `ctx.read()` accepts: anything that names a store and carries its state type. */\nexport interface StoreRef<S> {\n  readonly name: string;\n  /** Type-only marker for the state type. Never set at runtime. */\n  readonly stateType?: (state: S) => S;\n}\n\n/** A live store: one per page on the client, one per request on the server, one per test. */\nexport interface StoreInstance<S, M extends Tagged> {\n  readonly store: Store<S, M>;\n  readonly state: S;\n  /** Feeds a message through the store's `update` and notifies subscribers on change. */\n  send(msg: M): void;\n  /** Called after every state change. Returns an unsubscribe function. */\n  subscribe(listener: (state: S, prev: S) => void): () => void;\n  /** Per-instance driver substitutions (test fakes). Checked before the spec's. */\n  drivers: DriverOverrides;\n  /** Stops running commands and drops subscribers. */\n  dispose(): void;\n  /** Set by the registry that holds the instance (store-to-store `send`). */\n  bindScope(resolve: StoreResolver): void;\n}\n\nexport interface Store<S, M extends Tagged> extends StoreRef<S> {\n  readonly spec: StoreSpec<S, M>;\n  /**\n   * A fresh, independent instance. `initial` skips `init`'s state (a server seed, a test\n   * fixture); `init`'s commands still run on the client.\n   */\n  instance(initial?: S): StoreInstance<S, M>;\n  /** Checks a seed with `spec.schema` (ok as-is without one). */\n  checkSeed(seed: unknown): SeedCheck<S>;\n  /** Type-only marker for the message type. Never set at runtime. */\n  readonly messageType?: (msg: M) => M;\n}\n\n/** Any store, with its types erased (for declarations and registries). */\nexport interface AnyStore {\n  readonly name: string;\n  instance(initial?: never): AnyStoreInstance;\n  checkSeed(seed: unknown): SeedCheck<unknown>;\n}\n\n/** Any store instance, with its types erased. */\nexport interface AnyStoreInstance {\n  readonly store: AnyStore;\n  readonly state: unknown;\n  send(msg: never): void;\n  subscribe(listener: (state: unknown, prev: unknown) => void): () => void;\n  dispose(): void;\n  /**\n   * Called by the registry that holds this instance, so the store's `send(other, msg)`\n   * commands reach `other`'s instance in the same scope (gyral-czi.20).\n   */\n  bindScope?(resolve: StoreResolver): void;\n}\n\n/** Finds a store's instance in a scope (a registry). */\nexport type StoreResolver = (store: AnyStore) => AnyStoreInstance;\n\n/** Store instances substituted by store name (tests, islands). */\nexport type StoreOverrides = Readonly<Record<string, AnyStoreInstance>>;\n\n/** Defines a store. `name` keys it in registries, seeds and overrides, so keep it unique. */\nexport function defineStore<S, M extends Tagged>(name: string, spec: StoreSpec<S, M>): Store<S, M> {\n  const store: Store<S, M> = {\n    name,\n    spec,\n    instance: (initial?: S) => createInstance(store, initial),\n    checkSeed: (seed) => checkSeed(spec.schema, seed),\n  };\n  return store;\n}\n\nconst issuePath = (issue: StandardSchemaV1.Issue): string =>\n  (issue.path ?? []).map((s) => String(typeof s === 'object' ? s.key : s)).join('.');\n\nfunction checkSeed<S>(\n  schema: StandardSchemaV1<unknown, S> | undefined,\n  seed: unknown,\n): SeedCheck<S> {\n  // Sound without a schema: the seed is this store's state, serialized by the server.\n  if (schema === undefined) return { ok: true, state: seed as S };\n  const result = schema['~standard'].validate(seed);\n  if (result instanceof Promise) {\n    return { ok: false, issues: ['the store schema is async; seeds need a synchronous schema'] };\n  }\n  if (result.issues === undefined) return { ok: true, state: result.value };\n  return {\n    ok: false,\n    issues: result.issues.map((i) => `${issuePath(i) || '(root)'}: ${i.message}`),\n  };\n}\n\nfunction createInstance<S, M extends Tagged>(\n  store: Store<S, M>,\n  initial: S | undefined,\n): StoreInstance<S, M> {\n  // Sound: send() only calls the reducer whose key equals msg._tag.\n  const reducers = store.spec.update as unknown as Readonly<\n    Record<string, ((state: S, msg: M) => Next<S, M>) | undefined>\n  >;\n  const listeners = new Set<(state: S, prev: S) => void>();\n  let interpreter: Interpreter<M | IntentRejected> | undefined;\n  let disposed = false;\n\n  const [initState, initCommands] = splitNext(store.spec.init());\n  let state = initial === undefined ? initState : initial;\n\n  const resolve = (driver: AnyDriver): AnyDriver =>\n    instance.drivers[driver.name] ?? store.spec.drivers?.[driver.name] ?? driver;\n\n  let scope: StoreResolver | undefined;\n\n  // Store-to-store writes: delivered synchronously to the other store's instance in scope.\n  const deliver = ({ store: target, msg }: StoreSendInput): void => {\n    if (scope === undefined) {\n      console.warn(\n        `store \"${store.name}\" sends to \"${target.name}\" but is not held by a store scope ` +\n          '(a registry, <gyral-stores> or the page default), so the message is dropped.',\n      );\n      return;\n    }\n    (scope(target) as { send(msg: unknown): void }).send(msg);\n  };\n\n  const run = (commands: ReadonlyArray<Command<M | IntentRejected>>): void => {\n    if (onServer || disposed || commands.length === 0) return; // never on the server (ADR 0012)\n    for (const cmd of commands) {\n      if (cmd.driver === STORE_SEND) {\n        deliver(cmd.input as StoreSendInput);\n        continue;\n      }\n      interpreter ??= makeInterpreter<M | IntentRejected>(\n        resolve,\n        (msg) => {\n          // Stores have no IntentRejected reducer; only their own messages apply.\n          if (msg._tag !== 'IntentRejected') instance.send(msg as M);\n        },\n        DEVTOOLS_ENABLED ? devCommands(() => `store:${store.name}`) : undefined,\n      );\n      interpreter.run(cmd);\n    }\n  };\n\n  const instance: StoreInstance<S, M> = {\n    store,\n    get state() {\n      return state;\n    },\n    drivers: {},\n    send(msg) {\n      const reducer = reducers[msg._tag];\n      if (reducer === undefined) {\n        console.warn(`store \"${store.name}\" has no update for message \"${msg._tag}\".`);\n        return;\n      }\n      const prev = state;\n      const [next, commands] = splitNext(reducer(prev, msg));\n      state = next;\n      if (DEVTOOLS_ENABLED) devStore(store.name, msg, prev, next);\n      if (!Object.is(next, prev)) for (const listener of [...listeners]) listener(next, prev);\n      run(commands);\n    },\n    subscribe(listener) {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    dispose() {\n      disposed = true;\n      interpreter?.dispose();\n      listeners.clear();\n    },\n    bindScope(resolver) {\n      scope = resolver;\n    },\n  };\n\n  // A seeded instance (hydration) starts init's commands after the hydrating renders flushed,\n  // so a fast driver can't change state under them (same reason as ADR 0012 for components).\n  if (initial === undefined) run(initCommands);\n  else if (initCommands.length > 0)\n    setTimeout(() => {\n      run(initCommands);\n    }, 0);\n  return instance;\n}\n\n/** Marker driver for `send()`: `define()` delivers these to the resolved store instance. */\nexport const STORE_SEND = {\n  name: '@gyral/store-send',\n  run: () => undefined,\n} as const;\n\n/** The input of a `send()` command. */\nexport interface StoreSendInput {\n  readonly store: AnyStore;\n  readonly msg: Tagged;\n}\n\n/** A command that sends `msg` to the component's instance of `store`. Writes are commands. */\n// NoInfer: the store decides the message type, so a literal (`{ _tag: 'Track', … }`) is checked\n// against it instead of widening `_tag` to string (store-to-store sends have no other context).\nexport function send<S, M extends Tagged>(store: Store<S, M>, msg: NoInfer<M>): Command<never> {\n  const input: StoreSendInput = { store, msg };\n  return { driver: STORE_SEND, input, onSuccess: () => undefined };\n}\n\n/** Framework message: a store this component reads changed (ADR 0013). Optional reducer. */\nexport interface StoreChanged {\n  readonly _tag: 'StoreChanged';\n  /** The store's name. Narrow with `changed(store, msg)`. */\n  readonly store: string;\n  readonly state: unknown;\n  readonly prev: unknown;\n}\n\n/** Narrows a `StoreChanged` message to one store's typed state, or `undefined`. */\nexport function changed<S>(\n  store: StoreRef<S>,\n  msg: StoreChanged,\n): { readonly state: S; readonly prev: S } | undefined {\n  // Sound: the message was built from this store's instance (matched by unique name).\n  return msg.store === store.name ? { state: msg.state as S, prev: msg.prev as S } : undefined;\n}\n"]}

package/dist/stores-provider.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Registers `<gyral-stores>` for server renders; `@gyral/ssr` calls it. A no-op in the browser,
+ * where a plain `<gyral-stores>` element already scopes stores and the server's shadow root
+ * (a `<slot>`) needs no JavaScript. Idempotent.
+ */
+export declare function defineStoresProvider(): void;

package/dist/stores-provider.js

@@ -0,0 +1,57 @@
+// `<gyral-stores>` as a real element for server rendering (gyral-czi.20, ADR 0013 addendum).
+// On the client a provider is a plain element (scopeFor walks the DOM). On the server it must
+// be a registered element: components find it through Lit's SSR event path, and its instances'
+// states are written to `data-gyral-stores` for the client to restore.
+import { css, html, isServer, LitElement } from 'lit';
+import { warnJsonHazard } from './json-safety.js';
+import { providerScope, STORE_SEED_ATTRIBUTE, STORES_ELEMENT, STORES_REQUEST, } from './store-scope.js';
+const onServer = isServer;
+/** Server-only element: renders `<slot>` in Declarative Shadow DOM, so children show as-is. */
+class GyralStores extends LitElement {
+    static { this.styles = css `
+    :host {
+      display: contents;
+    }
+  `; }
+    #instances;
+    /** This subtree's store instances; stores not listed start from their seed or `init`. */
+    get instances() {
+        return this.#instances;
+    }
+    set instances(value) {
+        this.#instances = value;
+        // Written before the attributes render; the client restores it (providerScope()).
+        if (value !== undefined && value.length > 0) {
+            const seed = Object.fromEntries(value.map((i) => [i.store.name, i.state]));
+            for (const [name, state] of Object.entries(seed)) {
+                warnJsonHazard(`store "${name}" in <${STORES_ELEMENT}>`, state, 'state');
+            }
+            this.setAttribute(STORE_SEED_ATTRIBUTE, JSON.stringify(seed));
+        }
+    }
+    constructor() {
+        super();
+        // Lit's SSR routes a slotted child's events slot → getRootNode() → host, and the root is
+        // only this element's shadow root if one exists; the renderer never calls connectedCallback
+        // (which would create it), so attach it here.
+        this.attachShadow({ mode: 'open' });
+        this.addEventListener(STORES_REQUEST, (event) => {
+            event.stopPropagation();
+            event.detail.registry = providerScope(this);
+        });
+    }
+    render() {
+        return html `<slot></slot>`;
+    }
+}
+/**
+ * Registers `<gyral-stores>` for server renders; `@gyral/ssr` calls it. A no-op in the browser,
+ * where a plain `<gyral-stores>` element already scopes stores and the server's shadow root
+ * (a `<slot>`) needs no JavaScript. Idempotent.
+ */
+export function defineStoresProvider() {
+    if (onServer && customElements.get(STORES_ELEMENT) === undefined) {
+        customElements.define(STORES_ELEMENT, GyralStores);
+    }
+}
+//# sourceMappingURL=stores-provider.js.map

package/dist/stores-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores-provider.js","sourceRoot":"","sources":["../src/stores-provider.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,+FAA+F;AAC/F,uEAAuE;AACvE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,QAAQ,GAAY,QAAQ,CAAC;AAEnC,+FAA+F;AAC/F,MAAM,WAAY,SAAQ,UAAU;aAClB,WAAM,GAAG,GAAG,CAAA;;;;GAI3B,CAAC;IAEF,UAAU,CAA0C;IAEpD,yFAAyF;IACzF,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,IAAI,SAAS,CAAC,KAA8C;QAC1D,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,kFAAkF;QAClF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3E,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,cAAc,CAAC,UAAU,IAAI,SAAS,cAAc,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;QACE,KAAK,EAAE,CAAC;QACR,yFAAyF;QACzF,4FAA4F;QAC5F,8CAA8C;QAC9C,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;YAC9C,KAAK,CAAC,eAAe,EAAE,CAAC;YACvB,KAAoC,CAAC,MAAM,CAAC,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC;IAEkB,MAAM;QACvB,OAAO,IAAI,CAAA,eAAe,CAAC;IAC7B,CAAC;;AAGH;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,SAAS,EAAE,CAAC;QACjE,cAAc,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACrD,CAAC;AACH,CAAC","sourcesContent":["// `<gyral-stores>` as a real element for server rendering (gyral-czi.20, ADR 0013 addendum).\n// On the client a provider is a plain element (scopeFor walks the DOM). On the server it must\n// be a registered element: components find it through Lit's SSR event path, and its instances'\n// states are written to `data-gyral-stores` for the client to restore.\nimport { css, html, isServer, LitElement } from 'lit';\nimport { warnJsonHazard } from './json-safety.js';\nimport type { AnyStoreInstance } from './store.js';\nimport {\n  providerScope,\n  STORE_SEED_ATTRIBUTE,\n  STORES_ELEMENT,\n  STORES_REQUEST,\n  type StoresRequest,\n} from './store-scope.js';\n\nconst onServer: boolean = isServer;\n\n/** Server-only element: renders `<slot>` in Declarative Shadow DOM, so children show as-is. */\nclass GyralStores extends LitElement {\n  static override styles = css`\n    :host {\n      display: contents;\n    }\n  `;\n\n  #instances: readonly AnyStoreInstance[] | undefined;\n\n  /** This subtree's store instances; stores not listed start from their seed or `init`. */\n  get instances(): readonly AnyStoreInstance[] | undefined {\n    return this.#instances;\n  }\n\n  set instances(value: readonly AnyStoreInstance[] | undefined) {\n    this.#instances = value;\n    // Written before the attributes render; the client restores it (providerScope()).\n    if (value !== undefined && value.length > 0) {\n      const seed = Object.fromEntries(value.map((i) => [i.store.name, i.state]));\n      for (const [name, state] of Object.entries(seed)) {\n        warnJsonHazard(`store \"${name}\" in <${STORES_ELEMENT}>`, state, 'state');\n      }\n      this.setAttribute(STORE_SEED_ATTRIBUTE, JSON.stringify(seed));\n    }\n  }\n\n  constructor() {\n    super();\n    // Lit's SSR routes a slotted child's events slot → getRootNode() → host, and the root is\n    // only this element's shadow root if one exists; the renderer never calls connectedCallback\n    // (which would create it), so attach it here.\n    this.attachShadow({ mode: 'open' });\n    this.addEventListener(STORES_REQUEST, (event) => {\n      event.stopPropagation();\n      (event as CustomEvent<StoresRequest>).detail.registry = providerScope(this);\n    });\n  }\n\n  protected override render(): unknown {\n    return html`<slot></slot>`;\n  }\n}\n\n/**\n * Registers `<gyral-stores>` for server renders; `@gyral/ssr` calls it. A no-op in the browser,\n * where a plain `<gyral-stores>` element already scopes stores and the server's shadow root\n * (a `<slot>`) needs no JavaScript. Idempotent.\n */\nexport function defineStoresProvider(): void {\n  if (onServer && customElements.get(STORES_ELEMENT) === undefined) {\n    customElements.define(STORES_ELEMENT, GyralStores);\n  }\n}\n"]}

package/dist/styles.d.ts

@@ -0,0 +1,12 @@
+import { type CSSResultGroup, type CSSResultOrNative } from 'lit';
+/**
+ * What `spec.styles` accepts:
+ * - `css` tagged templates (Lit's `CSSResult`);
+ * - plain strings, e.g. a stylesheet module shared with the document (`import base from
+ *   './base.css?raw'`). Strings are trusted CSS from your own code, never user input;
+ * - `CSSStyleSheet` instances (constructable stylesheets, shared across components);
+ * - arrays of any of these, nested freely.
+ */
+export type Styles = CSSResultOrNative | string | readonly Styles[];
+/** Normalizes `Styles` into what Lit's `static styles` expects. */
+export declare function toCssResultGroup(styles: Styles): CSSResultGroup;

package/dist/styles.js

@@ -0,0 +1,11 @@
+// Component styles (gyral-czi.24): `css` templates, plain strings or constructed sheets.
+import { unsafeCSS } from 'lit';
+/** Normalizes `Styles` into what Lit's `static styles` expects. */
+export function toCssResultGroup(styles) {
+    if (typeof styles === 'string')
+        return unsafeCSS(styles);
+    if (Array.isArray(styles))
+        return styles.map(toCssResultGroup);
+    return styles;
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,OAAO,EAAE,SAAS,EAA+C,MAAM,KAAK,CAAC;AAY7E,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAQ,MAA4B,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtF,OAAO,MAA2B,CAAC;AACrC,CAAC","sourcesContent":["// Component styles (gyral-czi.24): `css` templates, plain strings or constructed sheets.\nimport { unsafeCSS, type CSSResultGroup, type CSSResultOrNative } from 'lit';\n\n/**\n * What `spec.styles` accepts:\n * - `css` tagged templates (Lit's `CSSResult`);\n * - plain strings, e.g. a stylesheet module shared with the document (`import base from\n *   './base.css?raw'`). Strings are trusted CSS from your own code, never user input;\n * - `CSSStyleSheet` instances (constructable stylesheets, shared across components);\n * - arrays of any of these, nested freely.\n */\nexport type Styles = CSSResultOrNative | string | readonly Styles[];\n\n/** Normalizes `Styles` into what Lit's `static styles` expects. */\nexport function toCssResultGroup(styles: Styles): CSSResultGroup {\n  if (typeof styles === 'string') return unsafeCSS(styles);\n  if (Array.isArray(styles)) return (styles as readonly Styles[]).map(toCssResultGroup);\n  return styles as CSSResultOrNative;\n}\n"]}

package/dist/template-whitespace.d.ts

@@ -0,0 +1,7 @@
+/** Minified copy of template strings (same length, bindings unmoved). Idempotent. */
+export declare function minifyStrings(strings: readonly string[]): string[];
+/**
+ * The minified TemplateStringsArray for a call site. Cached by identity, so Lit's own template
+ * cache (keyed by the strings array) still hits once per call site.
+ */
+export declare function minifyTemplate(strings: TemplateStringsArray): TemplateStringsArray;

package/dist/template-whitespace.js

@@ -0,0 +1,192 @@
+// Template whitespace minification (gyral-9rf, ADR 0016 addendum).
+//
+// lit-html keeps every newline and indent between tags as a DOM text node; compilers (Svelte,
+// Solid, JSX) drop them. In a benchmark table row that is 12 extra nodes out of 25, and removing
+// them made create/replace/clear 11-24% faster (gyral-1kq). Gyral's `html` and `svg` tags run the
+// template strings through `minifyTemplate()` once per call site (cached by strings identity),
+// so the server and the browser always build the same template: hydration digests match in any
+// toolchain (Vite, tsx, plain Node), with no build step.
+//
+// Rules (the same text everywhere, documented in docs/references/consumer-setup.md):
+// - Whitespace-only text that contains a newline is removed when it sits next to a template
+//   edge, a block-level tag, or the inside edge of a <button>/<select> (CSS never renders it
+//   there). Between two inline neighbours (phrasing elements, custom elements, bindings,
+//   comments) it collapses to one space.
+// - Other runs of whitespace in text collapse to one space; a leading or trailing run with a
+//   newline next to one of those edges is removed.
+// - <pre>, <textarea>, <script>, <style> and <title> contents, tags and attribute values,
+//   and comments are copied unchanged. Binding positions never move: the result has the same
+//   number of strings, so Lit parts and SSR hydration markers line up.
+// The function is idempotent: minifying minified strings changes nothing.
+/** Elements whose box is block-level (or never laid out inline) by default. */
+const BLOCK = new Set(('address article aside blockquote body caption col colgroup datalist dd details dialog div ' +
+    'dl dt fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 head header hgroup hr html ' +
+    'legend li main menu nav ol optgroup option p pre search section select summary table tbody ' +
+    'td tfoot th thead tr ul ' +
+    // SVG containers and shapes: whitespace between them is never rendered.
+    'circle clippath defs ellipse g line lineargradient marker mask path pattern polygon ' +
+    'polyline radialgradient rect stop symbol use').split(' '));
+/** Elements whose text content is copied verbatim (whitespace is meaningful or raw text). */
+const RAW_TEXT = new Set(['script', 'style', 'textarea', 'title']);
+const PRESERVE = 'pre';
+/**
+ * Inline-block controls: they sit inline among their neighbours, but whitespace at the start or
+ * end of their own content is never rendered (it is at the edge of their own line box).
+ */
+const INLINE_BOX = new Set(['button', 'select']);
+/**
+ * The edge a tag makes for the text next to it. `inside` is true when the text is inside the
+ * element (after its start tag, or before its end tag).
+ */
+function edgeOfTag(name, inside) {
+    const lower = name.toLowerCase();
+    if (BLOCK.has(lower))
+        return 'block';
+    return inside && INLINE_BOX.has(lower) ? 'block' : 'inline';
+}
+const WS = /^[ \t\n\r\f]*$/;
+const RUN = /[ \t\n\r\f]+/g;
+function minifyChunk(text, left, right) {
+    if (text === '')
+        return text;
+    if (WS.test(text)) {
+        const removable = /[\n\r]/.test(text) &&
+            (left === 'template' || right === 'template' || left === 'block' || right === 'block');
+        return removable ? '' : ' ';
+    }
+    // Mixed text: a leading or trailing run with a newline next to a removable edge goes too.
+    const dropStart = left !== 'inline' && /^[ \t\f]*[\n\r]/.test(text);
+    const dropEnd = right !== 'inline' && /[\n\r][ \t\n\r\f]*$/.test(text);
+    let body = text.replace(RUN, ' ');
+    if (dropStart)
+        body = body.replace(/^ /, '');
+    if (dropEnd)
+        body = body.replace(/ $/, '');
+    return body;
+}
+const Mode = { Text: 0, Tag: 1, Comment: 2, RawText: 3 };
+const TAG_START = /^<(\/?)([A-Za-z!?][^\s/>]*)/;
+/** Minify one segment, carrying the HTML scan state across bindings. */
+function minifySegment(segment, state, last) {
+    let out = '';
+    let chunk = '';
+    const flushText = (right) => {
+        out += state.preDepth > 0 ? chunk : minifyChunk(chunk, state.left, right);
+        chunk = '';
+    };
+    let i = 0;
+    while (i < segment.length) {
+        const ch = segment.charAt(i);
+        if (state.mode === Mode.Comment) {
+            if (segment.startsWith('-->', i)) {
+                out += '-->';
+                i += 3;
+                state.mode = Mode.Text;
+                state.left = 'inline';
+            }
+            else {
+                out += ch;
+                i += 1;
+            }
+            continue;
+        }
+        if (state.mode === Mode.RawText) {
+            const close = `</${state.rawName}`;
+            if (segment.slice(i, i + close.length).toLowerCase() === close) {
+                state.mode = Mode.Text;
+                state.left = 'inline';
+                continue; // the closing tag is read in Text mode
+            }
+            out += ch;
+            i += 1;
+            continue;
+        }
+        if (state.mode === Mode.Tag) {
+            out += ch;
+            i += 1;
+            if (state.quote !== '') {
+                if (ch === state.quote)
+                    state.quote = '';
+            }
+            else if (ch === '"' || ch === "'") {
+                state.quote = ch;
+            }
+            else if (ch === '>') {
+                endTag(state, out.endsWith('/>'));
+            }
+            continue;
+        }
+        // Text mode.
+        if (ch === '<' && segment.startsWith('<!--', i)) {
+            flushText('inline');
+            state.mode = Mode.Comment;
+            out += '<!--';
+            i += 4;
+            continue;
+        }
+        const tag = ch === '<' ? TAG_START.exec(segment.slice(i)) : null;
+        if (tag !== null) {
+            const name = (tag[2] ?? '').toLowerCase();
+            const closing = tag[1] === '/';
+            flushText(edgeOfTag(name, closing));
+            state.closing = closing;
+            state.tagName = name;
+            state.mode = Mode.Tag;
+            out += tag[0];
+            i += tag[0].length;
+            continue;
+        }
+        chunk += ch;
+        i += 1;
+    }
+    if (state.mode === Mode.Text) {
+        flushText(last ? 'template' : 'inline');
+        state.left = 'inline'; // the next segment starts after a binding
+    }
+    return out;
+}
+function endTag(state, selfClosing) {
+    const name = state.tagName;
+    state.mode = Mode.Text;
+    state.left = edgeOfTag(name, !state.closing && !selfClosing);
+    if (name === PRESERVE) {
+        if (state.closing)
+            state.preDepth = Math.max(0, state.preDepth - 1);
+        else if (!selfClosing)
+            state.preDepth += 1;
+    }
+    if (!state.closing && !selfClosing && RAW_TEXT.has(name)) {
+        state.mode = Mode.RawText;
+        state.rawName = name;
+    }
+}
+/** Minified copy of template strings (same length, bindings unmoved). Idempotent. */
+export function minifyStrings(strings) {
+    const state = {
+        mode: Mode.Text,
+        quote: '',
+        tagName: '',
+        closing: false,
+        rawName: '',
+        preDepth: 0,
+        left: 'template',
+    };
+    return strings.map((segment, index) => minifySegment(segment, state, index === strings.length - 1));
+}
+const cache = new WeakMap();
+/**
+ * The minified TemplateStringsArray for a call site. Cached by identity, so Lit's own template
+ * cache (keyed by the strings array) still hits once per call site.
+ */
+export function minifyTemplate(strings) {
+    const cached = cache.get(strings);
+    if (cached !== undefined)
+        return cached;
+    const minified = minifyStrings(strings);
+    // Lit accepts only arrays with an own `raw` field (its anti-spoofing check), as lit/static-html
+    // builds them. Cooked strings are what Lit reads; `raw` mirrors them.
+    const result = Object.freeze(Object.assign(minified, { raw: Object.freeze([...minified]) }));
+    cache.set(strings, result);
+    return result;
+}
+//# sourceMappingURL=template-whitespace.js.map

package/dist/template-whitespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-whitespace.js","sourceRoot":"","sources":["../src/template-whitespace.ts"],"names":[],"mappings":"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","sourcesContent":["// Template whitespace minification (gyral-9rf, ADR 0016 addendum).\n//\n// lit-html keeps every newline and indent between tags as a DOM text node; compilers (Svelte,\n// Solid, JSX) drop them. In a benchmark table row that is 12 extra nodes out of 25, and removing\n// them made create/replace/clear 11-24% faster (gyral-1kq). Gyral's `html` and `svg` tags run the\n// template strings through `minifyTemplate()` once per call site (cached by strings identity),\n// so the server and the browser always build the same template: hydration digests match in any\n// toolchain (Vite, tsx, plain Node), with no build step.\n//\n// Rules (the same text everywhere, documented in docs/references/consumer-setup.md):\n// - Whitespace-only text that contains a newline is removed when it sits next to a template\n//   edge, a block-level tag, or the inside edge of a <button>/<select> (CSS never renders it\n//   there). Between two inline neighbours (phrasing elements, custom elements, bindings,\n//   comments) it collapses to one space.\n// - Other runs of whitespace in text collapse to one space; a leading or trailing run with a\n//   newline next to one of those edges is removed.\n// - <pre>, <textarea>, <script>, <style> and <title> contents, tags and attribute values,\n//   and comments are copied unchanged. Binding positions never move: the result has the same\n//   number of strings, so Lit parts and SSR hydration markers line up.\n// The function is idempotent: minifying minified strings changes nothing.\n\n/** Elements whose box is block-level (or never laid out inline) by default. */\nconst BLOCK = new Set(\n  (\n    'address article aside blockquote body caption col colgroup datalist dd details dialog div ' +\n    'dl dt fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 head header hgroup hr html ' +\n    'legend li main menu nav ol optgroup option p pre search section select summary table tbody ' +\n    'td tfoot th thead tr ul ' +\n    // SVG containers and shapes: whitespace between them is never rendered.\n    'circle clippath defs ellipse g line lineargradient marker mask path pattern polygon ' +\n    'polyline radialgradient rect stop symbol use'\n  ).split(' '),\n);\n\n/** Elements whose text content is copied verbatim (whitespace is meaningful or raw text). */\nconst RAW_TEXT = new Set(['script', 'style', 'textarea', 'title']);\nconst PRESERVE = 'pre';\n\n/** What sits on one side of a text chunk. */\ntype Edge = 'template' | 'inline' | 'block';\n\n/**\n * Inline-block controls: they sit inline among their neighbours, but whitespace at the start or\n * end of their own content is never rendered (it is at the edge of their own line box).\n */\nconst INLINE_BOX = new Set(['button', 'select']);\n\n/**\n * The edge a tag makes for the text next to it. `inside` is true when the text is inside the\n * element (after its start tag, or before its end tag).\n */\nfunction edgeOfTag(name: string, inside: boolean): Edge {\n  const lower = name.toLowerCase();\n  if (BLOCK.has(lower)) return 'block';\n  return inside && INLINE_BOX.has(lower) ? 'block' : 'inline';\n}\n\nconst WS = /^[ \\t\\n\\r\\f]*$/;\nconst RUN = /[ \\t\\n\\r\\f]+/g;\n\nfunction minifyChunk(text: string, left: Edge, right: Edge): string {\n  if (text === '') return text;\n  if (WS.test(text)) {\n    const removable =\n      /[\\n\\r]/.test(text) &&\n      (left === 'template' || right === 'template' || left === 'block' || right === 'block');\n    return removable ? '' : ' ';\n  }\n  // Mixed text: a leading or trailing run with a newline next to a removable edge goes too.\n  const dropStart = left !== 'inline' && /^[ \\t\\f]*[\\n\\r]/.test(text);\n  const dropEnd = right !== 'inline' && /[\\n\\r][ \\t\\n\\r\\f]*$/.test(text);\n  let body = text.replace(RUN, ' ');\n  if (dropStart) body = body.replace(/^ /, '');\n  if (dropEnd) body = body.replace(/ $/, '');\n  return body;\n}\n\nconst Mode = { Text: 0, Tag: 1, Comment: 2, RawText: 3 } as const;\ntype Mode = (typeof Mode)[keyof typeof Mode];\n\ninterface Scan {\n  mode: Mode;\n  /** Quote char while inside an attribute value in a tag, else ''. */\n  quote: string;\n  /** Name of the tag being read (lower case), and whether it is a closing tag. */\n  tagName: string;\n  closing: boolean;\n  /** Raw-text element we are inside (its contents are copied verbatim). */\n  rawName: string;\n  /** Depth of open <pre> elements: text is copied verbatim while > 0. */\n  preDepth: number;\n  /** Edge type of the boundary before the current text chunk. */\n  left: Edge;\n}\n\nconst TAG_START = /^<(\\/?)([A-Za-z!?][^\\s/>]*)/;\n\n/** Minify one segment, carrying the HTML scan state across bindings. */\nfunction minifySegment(segment: string, state: Scan, last: boolean): string {\n  let out = '';\n  let chunk = '';\n  const flushText = (right: Edge): void => {\n    out += state.preDepth > 0 ? chunk : minifyChunk(chunk, state.left, right);\n    chunk = '';\n  };\n  let i = 0;\n  while (i < segment.length) {\n    const ch = segment.charAt(i);\n    if (state.mode === Mode.Comment) {\n      if (segment.startsWith('-->', i)) {\n        out += '-->';\n        i += 3;\n        state.mode = Mode.Text;\n        state.left = 'inline';\n      } else {\n        out += ch;\n        i += 1;\n      }\n      continue;\n    }\n    if (state.mode === Mode.RawText) {\n      const close = `</${state.rawName}`;\n      if (segment.slice(i, i + close.length).toLowerCase() === close) {\n        state.mode = Mode.Text;\n        state.left = 'inline';\n        continue; // the closing tag is read in Text mode\n      }\n      out += ch;\n      i += 1;\n      continue;\n    }\n    if (state.mode === Mode.Tag) {\n      out += ch;\n      i += 1;\n      if (state.quote !== '') {\n        if (ch === state.quote) state.quote = '';\n      } else if (ch === '\"' || ch === \"'\") {\n        state.quote = ch;\n      } else if (ch === '>') {\n        endTag(state, out.endsWith('/>'));\n      }\n      continue;\n    }\n    // Text mode.\n    if (ch === '<' && segment.startsWith('<!--', i)) {\n      flushText('inline');\n      state.mode = Mode.Comment;\n      out += '<!--';\n      i += 4;\n      continue;\n    }\n    const tag = ch === '<' ? TAG_START.exec(segment.slice(i)) : null;\n    if (tag !== null) {\n      const name = (tag[2] ?? '').toLowerCase();\n      const closing = tag[1] === '/';\n      flushText(edgeOfTag(name, closing));\n      state.closing = closing;\n      state.tagName = name;\n      state.mode = Mode.Tag;\n      out += tag[0];\n      i += tag[0].length;\n      continue;\n    }\n    chunk += ch;\n    i += 1;\n  }\n  if (state.mode === Mode.Text) {\n    flushText(last ? 'template' : 'inline');\n    state.left = 'inline'; // the next segment starts after a binding\n  }\n  return out;\n}\n\nfunction endTag(state: Scan, selfClosing: boolean): void {\n  const name = state.tagName;\n  state.mode = Mode.Text;\n  state.left = edgeOfTag(name, !state.closing && !selfClosing);\n  if (name === PRESERVE) {\n    if (state.closing) state.preDepth = Math.max(0, state.preDepth - 1);\n    else if (!selfClosing) state.preDepth += 1;\n  }\n  if (!state.closing && !selfClosing && RAW_TEXT.has(name)) {\n    state.mode = Mode.RawText;\n    state.rawName = name;\n  }\n}\n\n/** Minified copy of template strings (same length, bindings unmoved). Idempotent. */\nexport function minifyStrings(strings: readonly string[]): string[] {\n  const state: Scan = {\n    mode: Mode.Text,\n    quote: '',\n    tagName: '',\n    closing: false,\n    rawName: '',\n    preDepth: 0,\n    left: 'template',\n  };\n  return strings.map((segment, index) =>\n    minifySegment(segment, state, index === strings.length - 1),\n  );\n}\n\nconst cache = new WeakMap<TemplateStringsArray, TemplateStringsArray>();\n\n/**\n * The minified TemplateStringsArray for a call site. Cached by identity, so Lit's own template\n * cache (keyed by the strings array) still hits once per call site.\n */\nexport function minifyTemplate(strings: TemplateStringsArray): TemplateStringsArray {\n  const cached = cache.get(strings);\n  if (cached !== undefined) return cached;\n  const minified = minifyStrings(strings);\n  // Lit accepts only arrays with an own `raw` field (its anti-spoofing check), as lit/static-html\n  // builds them. Cooked strings are what Lit reads; `raw` mirrors them.\n  const result = Object.freeze(\n    Object.assign(minified, { raw: Object.freeze([...minified]) }),\n  ) as unknown as TemplateStringsArray;\n  cache.set(strings, result);\n  return result;\n}\n"]}

package/dist/templates.d.ts

@@ -0,0 +1,5 @@
+import { type TemplateResult } from 'lit';
+/** Lit's `html`, with indentation whitespace between tags removed. */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult<1>;
+/** Lit's `svg`, with indentation whitespace between elements removed. */
+export declare function svg(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult<2>;

package/dist/templates.js

@@ -0,0 +1,15 @@
+// Gyral's `html` and `svg` template tags: Lit's, with template whitespace minified once per call
+// site (template-whitespace.ts, gyral-9rf). Server and browser run the same code, so the
+// templates (and their hydration digests) are identical in every toolchain. For exact
+// whitespace outside <pre>/<textarea>, import `html` from 'lit' instead.
+import { html as litHtml, svg as litSvg } from 'lit';
+import { minifyTemplate } from './template-whitespace.js';
+/** Lit's `html`, with indentation whitespace between tags removed. */
+export function html(strings, ...values) {
+    return litHtml(minifyTemplate(strings), ...values);
+}
+/** Lit's `svg`, with indentation whitespace between elements removed. */
+export function svg(strings, ...values) {
+    return litSvg(minifyTemplate(strings), ...values);
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,yFAAyF;AACzF,sFAAsF;AACtF,yEAAyE;AACzE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,GAAG,IAAI,MAAM,EAAuB,MAAM,KAAK,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,sEAAsE;AACtE,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACtE,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,GAAG,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACrE,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;AACpD,CAAC","sourcesContent":["// Gyral's `html` and `svg` template tags: Lit's, with template whitespace minified once per call\n// site (template-whitespace.ts, gyral-9rf). Server and browser run the same code, so the\n// templates (and their hydration digests) are identical in every toolchain. For exact\n// whitespace outside <pre>/<textarea>, import `html` from 'lit' instead.\nimport { html as litHtml, svg as litSvg, type TemplateResult } from 'lit';\nimport { minifyTemplate } from './template-whitespace.js';\n\n/** Lit's `html`, with indentation whitespace between tags removed. */\nexport function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult<1> {\n  return litHtml(minifyTemplate(strings), ...values);\n}\n\n/** Lit's `svg`, with indentation whitespace between elements removed. */\nexport function svg(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult<2> {\n  return litSvg(minifyTemplate(strings), ...values);\n}\n"]}

package/dist/textarea.d.ts

@@ -0,0 +1,26 @@
+import { Directive, type ChildPart, type PartInfo } from 'lit/directive.js';
+export type TextareaAttribute = string | number | boolean | null | undefined;
+export interface TextareaOptions {
+    /** The model's value. Applied to the live element only when the model changes. */
+    readonly value: string;
+    /** Attributes such as name, id, rows, required, maxlength, data-intent, aria-invalid. */
+    readonly attrs?: Readonly<Record<string, TextareaAttribute>>;
+}
+/** The markup the server writes, and the client's first render: escaped, no bindings inside. */
+export declare function textareaMarkup({ value, attrs }: TextareaOptions): string;
+declare class TextareaDirective extends Directive {
+    #private;
+    constructor(info: PartInfo);
+    render(options: TextareaOptions): unknown;
+    update(part: ChildPart, [options]: [TextareaOptions]): unknown;
+}
+/**
+ * A `<textarea>` whose content comes from the model, safe for SSR and hydration:
+ *
+ *   ${textarea({ value: s.message, attrs: { name: 'message', rows: 5, required: true,
+ *                                            'data-intent': i.Message } })}
+ *
+ * Text typed before or after hydration is kept until the model's value changes.
+ */
+export declare const textarea: (options: TextareaOptions) => import("lit/directive.js").DirectiveResult<typeof TextareaDirective>;
+export {};