@gyral/core 0.3.0 → 0.3.2

package/dist/script-json.js

@@ -0,0 +1,13 @@
+// JSON safe to inline in a <script> element. Its own module: head.ts (the head model) and the
+// store seeds both use it, and keeping it out of store-scope.ts stops a bundler from turning
+// the store registry into a shared chunk every page loads (gyral-dyn.35).
+/** JSON for an inline `<script type="application/json">`: `</script>` and friends escaped. */
+export function scriptSafeJson(value) {
+    return JSON.stringify(value)
+        .replaceAll('<', '\\u003c')
+        .replaceAll('>', '\\u003e')
+        .replaceAll('&', '\\u0026')
+        .replaceAll('
', '\\u2028')
+        .replaceAll('
', '\\u2029');
+}
+//# sourceMappingURL=script-json.js.map

package/dist/script-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-json.js","sourceRoot":"","sources":["../src/script-json.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6FAA6F;AAC7F,0EAA0E;AAE1E,8FAA8F;AAC9F,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC;SAC1B,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC;SAC1B,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC;SAC1B,UAAU,CAAC;CACf,EAAE,SAAS,CAAC;SACR,UAAU,CAAC;CACf,EAAE,SAAS,CAAC,CAAC;AACd,CAAC","sourcesContent":["// JSON safe to inline in a <script> element. Its own module: head.ts (the head model) and the\n// store seeds both use it, and keeping it out of store-scope.ts stops a bundler from turning\n// the store registry into a shared chunk every page loads (gyral-dyn.35).\n\n/** JSON for an inline `<script type=\"application/json\">`: `</script>` and friends escaped. */\nexport function scriptSafeJson(value: unknown): string {\n  return JSON.stringify(value)\n    .replaceAll('<', '\\\\u003c')\n    .replaceAll('>', '\\\\u003e')\n    .replaceAll('&', '\\\\u0026')\n    .replaceAll('
', '\\\\u2028')\n    .replaceAll('
', '\\\\u2029');\n}\n"]}

package/dist/server-component.d.ts

@@ -4,7 +4,7 @@ import { type ServerComponent } from './view/index.js';
 export declare function serverComponent<S, M extends Tagged, P>(tag: string, spec: ComponentSpec<S, M, P>): ServerComponent;
 /**
  * Registers every spec define() recorded outside the browser (and not registered yet) in
- * view/'s server registry. `@gyral/core/server` calls it before each render; client code never
+ * view/'s server registry. `@gyral/core/internal/server` calls it before each render; client code never
  * imports this module.
  */
 export declare function registerRecordedSpecs(): void;

package/dist/server-component.js

@@ -1,11 +1,12 @@
 // A spec as the server renderer sees it (view/05-element.md "Registration", view/06-server.md
 // "Components"). Outside the browser `define()` records the spec (server-specs.ts) and
-// `@gyral/core/server` registers one of these per spec in view/'s server registry. Rendering is
+// `@gyral/core/internal/server` registers one of these per spec in view/'s server registry. Rendering is
 // `view(init(props))`: props parsed from the start tag's attributes (always validated) and
 // property holes (validated in development), `init`'s commands dropped (the client's `init`
 // starts them after hydration, ADR 0012), then `initialMessages` through their reducers.
 // `ctx.read` uses the nearest `<gyral-stores>` provider's registry, else the request's.
 import { splitNext } from './command.js';
+import { GyralError } from './errors.js';
 import { makeSeed } from './hydration.js';
 import { runInit } from './init.js';
 import { intentNames } from './intent.js';
@@ -13,7 +14,7 @@ import { isLight } from './light-dom.js';
 import { attributeOf, checkValue, missingRequired, parseAttribute, readProps, reportInvalid, } from './props.js';
 import { recordedSpecs } from './server-specs.js';
 import { serverScopeFor, StoreRegistry } from './store-scope.js';
-import { DEV, registerServerComponent, serverComponent as registered, styleTexts, } from './view/index.js';
+import { DEV, message, nothing, registerServerComponent, serverComponent as registered, styleTexts, } from './view/index.js';
 /** Resolves props from a start tag: attributes always validated, properties in development. */
 function propsFrom(tag, table, input) {
     const values = {};
@@ -49,7 +50,7 @@ function propsFrom(tag, table, input) {
 /** The server registry entry for `spec`. */
 export function serverComponent(tag, spec) {
     const table = (spec.props ?? {});
-    const reducers = spec.update;
+    const reducers = (spec.update ?? {});
     const declared = new Set((spec.stores ?? []).map((store) => store.name));
     const reader = (scope) => (store) => {
         if (!declared.has(store.name)) {
@@ -59,9 +60,26 @@ export function serverComponent(tag, spec) {
         const registry = scope instanceof StoreRegistry ? scope : serverScopeFor(tag, any);
         return registry.get(any).state; // Sound: the ref carries this store's state type.
     };
+    /**
+     * The rendering of a component that threw (ADR 0024): its error view (or nothing, also when
+     * the error view throws), no seed, and the GyralError the renderer reports.
+     */
+    const failed = (phase, cause, state) => {
+        const error = new GyralError(phase, message(78, tag), cause, tag);
+        let view = nothing;
+        try {
+            if (spec.error !== undefined)
+                view = spec.error(error, state);
+        }
+        catch {
+            view = nothing; // the error view failed too: the host stays empty
+        }
+        return { view, seed: { props: {} }, failed: error };
+    };
     return {
         tag,
         light: isLight(spec),
+        delegatesFocus: typeof spec.shadow === 'object' && spec.shadow.delegatesFocus === true,
         styles: isLight(spec) ? [] : styleTexts(spec.styles),
         hydrate: spec.hydrate ?? 'load',
         render(input) {
@@ -72,23 +90,36 @@ export function serverComponent(tag, spec) {
             }
             const props = readProps(values, table); // Sound: exactly the declared props.
             const ctx = { props, read: reader(input.scope) };
-            const [initial] = splitNext(runInit(spec, props));
-            let state = initial;
-            for (const msg of (input.initialMessages ?? [])) {
-                const reducer = reducers[msg._tag];
-                if (reducer !== undefined)
-                    [state] = splitNext(reducer(state, msg, ctx));
+            let initial;
+            let state;
+            try {
+                [initial] = splitNext(runInit(spec, props));
+                state = initial;
+                for (const msg of (input.initialMessages ?? [])) {
+                    const reducer = reducers[msg._tag];
+                    if (reducer !== undefined)
+                        [state] = splitNext(reducer(state, msg, ctx));
+                }
+            }
+            catch (cause) {
+                return failed('init', cause, undefined);
+            }
+            try {
+                return {
+                    view: spec.view(state, intentNames, ctx),
+                    seed: makeSeed(tag, state, initial, carried),
+                };
+            }
+            catch (cause) {
+                return failed('view', cause, state);
             }
-            return {
-                view: spec.view(state, intentNames, ctx),
-                seed: makeSeed(tag, state, initial, carried),
-            };
         },
+        fallback: (cause) => failed('view', cause, undefined),
     };
 }
 /**
  * Registers every spec define() recorded outside the browser (and not registered yet) in
- * view/'s server registry. `@gyral/core/server` calls it before each render; client code never
+ * view/'s server registry. `@gyral/core/internal/server` calls it before each render; client code never
  * imports this module.
  */
 export function registerRecordedSpecs() {

package/dist/server-component.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-component.js","sourceRoot":"","sources":["../src/server-component.ts"],"names":[],"mappings":"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","sourcesContent":["// A spec as the server renderer sees it (view/05-element.md \"Registration\", view/06-server.md\n// \"Components\"). Outside the browser `define()` records the spec (server-specs.ts) and\n// `@gyral/core/server` registers one of these per spec in view/'s server registry. Rendering is\n// `view(init(props))`: props parsed from the start tag's attributes (always validated) and\n// property holes (validated in development), `init`'s commands dropped (the client's `init`\n// starts them after hydration, ADR 0012), then `initialMessages` through their reducers.\n// `ctx.read` uses the nearest `<gyral-stores>` provider's registry, else the request's.\nimport { splitNext, type Next } from './command.js';\nimport { makeSeed } from './hydration.js';\nimport { runInit } from './init.js';\nimport { intentNames } from './intent.js';\nimport { isLight } from './light-dom.js';\nimport {\n  attributeOf,\n  checkValue,\n  missingRequired,\n  parseAttribute,\n  readProps,\n  reportInvalid,\n  type PropTable,\n} from './props.js';\nimport { recordedSpecs } from './server-specs.js';\nimport { serverScopeFor, StoreRegistry } from './store-scope.js';\nimport type { AnyStore, StoreRef } from './store.js';\nimport type { ComponentSpec, Ctx, IntentNames, Tagged } from './types.js';\nimport {\n  DEV,\n  registerServerComponent,\n  serverComponent as registered,\n  styleTexts,\n  type ServerComponent,\n  type ServerRenderInput,\n  type ServerRendering,\n} from './view/index.js';\n\ntype Reducers<S> = Readonly<\n  Record<string, ((s: S, m: Tagged, ctx: Ctx<object>) => Next<S, Tagged>) | undefined>\n>;\n\n/** Resolves props from a start tag: attributes always validated, properties in development. */\nfunction propsFrom(tag: string, table: PropTable, input: ServerRenderInput) {\n  const values: Record<string, unknown> = {};\n  const carried: Record<string, unknown> = {};\n  for (const [name, def] of Object.entries(table)) {\n    if (name in input.properties) {\n      const value = input.properties[name];\n      if (value === undefined) continue;\n      const checked = DEV ? checkValue(tag, name, def, value) : { ok: true as const, value };\n      if (checked.ok) values[name] = value;\n      else reportInvalid(tag, name, 'a property', checked.issues);\n      carried[name] = value; // no attribute carries it: the seed does\n      continue;\n    }\n    const attr = attributeOf(name, def);\n    if (attr === undefined) continue;\n    const raw = input.attributes[attr];\n    const parsed = parseAttribute(def, raw ?? null);\n    if (parsed === undefined) continue;\n    const checked = parsed.ok ? checkValue(tag, name, def, parsed.value) : parsed;\n    if (checked.ok) values[name] = checked.value;\n    else reportInvalid(tag, name, `the attribute ${attr}`, checked.issues);\n  }\n  return { values, carried };\n}\n\n/** The server registry entry for `spec`. */\nexport function serverComponent<S, M extends Tagged, P>(\n  tag: string,\n  spec: ComponentSpec<S, M, P>,\n): ServerComponent {\n  const table = (spec.props ?? {}) as PropTable;\n  const reducers = spec.update as unknown as Reducers<S>;\n  const declared = new Set((spec.stores ?? []).map((store: AnyStore) => store.name));\n  const reader =\n    (scope: unknown) =>\n    <T>(store: StoreRef<T>): T => {\n      if (!declared.has(store.name)) {\n        throw new Error(`<${tag}> uses store \"${store.name}\" without declaring it in spec.stores.`);\n      }\n      const any = store as unknown as AnyStore;\n      const registry = scope instanceof StoreRegistry ? scope : serverScopeFor(tag, any);\n      return registry.get(any).state as T; // Sound: the ref carries this store's state type.\n    };\n  return {\n    tag,\n    light: isLight(spec),\n    styles: isLight(spec) ? [] : styleTexts(spec.styles),\n    hydrate: spec.hydrate ?? 'load',\n    render(input): ServerRendering {\n      const { values, carried } = propsFrom(tag, table, input);\n      const missing = missingRequired(values, table);\n      if (missing.length > 0) {\n        console.warn(`<${tag}> is missing required prop(s): ${missing.join(', ')}.`);\n      }\n      const props = readProps(values, table) as P; // Sound: exactly the declared props.\n      const ctx = { props, read: reader(input.scope) } as Ctx<object>;\n      const [initial] = splitNext(runInit(spec, props));\n      let state = initial;\n      for (const msg of (input.initialMessages ?? []) as Tagged[]) {\n        const reducer = reducers[msg._tag];\n        if (reducer !== undefined) [state] = splitNext(reducer(state, msg, ctx));\n      }\n      return {\n        view: spec.view(state, intentNames as IntentNames<M>, ctx as Ctx<P>),\n        seed: makeSeed(tag, state, initial, carried),\n      };\n    },\n  };\n}\n\n/**\n * Registers every spec define() recorded outside the browser (and not registered yet) in\n * view/'s server registry. `@gyral/core/server` calls it before each render; client code never\n * imports this module.\n */\nexport function registerRecordedSpecs(): void {\n  for (const [tag, spec] of recordedSpecs()) {\n    if (registered(tag) !== undefined) continue;\n    // Sound: define() recorded exactly this tag's ComponentSpec.\n    registerServerComponent(serverComponent(tag, spec as ComponentSpec<unknown, Tagged, object>));\n  }\n}\n"]}
+{"version":3,"file":"server-component.js","sourceRoot":"","sources":["../src/server-component.ts"],"names":[],"mappings":"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","sourcesContent":["// A spec as the server renderer sees it (view/05-element.md \"Registration\", view/06-server.md\n// \"Components\"). Outside the browser `define()` records the spec (server-specs.ts) and\n// `@gyral/core/internal/server` registers one of these per spec in view/'s server registry. Rendering is\n// `view(init(props))`: props parsed from the start tag's attributes (always validated) and\n// property holes (validated in development), `init`'s commands dropped (the client's `init`\n// starts them after hydration, ADR 0012), then `initialMessages` through their reducers.\n// `ctx.read` uses the nearest `<gyral-stores>` provider's registry, else the request's.\nimport { splitNext, type Next } from './command.js';\nimport { GyralError, type ErrorPhase } from './errors.js';\nimport { makeSeed } from './hydration.js';\nimport { runInit } from './init.js';\nimport { intentNames } from './intent.js';\nimport { isLight } from './light-dom.js';\nimport {\n  attributeOf,\n  checkValue,\n  missingRequired,\n  parseAttribute,\n  readProps,\n  reportInvalid,\n  type PropTable,\n} from './props.js';\nimport { recordedSpecs } from './server-specs.js';\nimport { serverScopeFor, StoreRegistry } from './store-scope.js';\nimport type { AnyStore, StoreRef } from './store.js';\nimport type { ComponentSpec, Ctx, IntentNames, Tagged } from './types.js';\nimport {\n  DEV,\n  message,\n  nothing,\n  registerServerComponent,\n  serverComponent as registered,\n  styleTexts,\n  type ServerComponent,\n  type ServerRenderInput,\n  type ServerRendering,\n} from './view/index.js';\n\ntype Reducers<S> = Readonly<\n  Record<string, ((s: S, m: Tagged, ctx: Ctx<object>) => Next<S, Tagged>) | undefined>\n>;\n\n/** Resolves props from a start tag: attributes always validated, properties in development. */\nfunction propsFrom(tag: string, table: PropTable, input: ServerRenderInput) {\n  const values: Record<string, unknown> = {};\n  const carried: Record<string, unknown> = {};\n  for (const [name, def] of Object.entries(table)) {\n    if (name in input.properties) {\n      const value = input.properties[name];\n      if (value === undefined) continue;\n      const checked = DEV ? checkValue(tag, name, def, value) : { ok: true as const, value };\n      if (checked.ok) values[name] = value;\n      else reportInvalid(tag, name, 'a property', checked.issues);\n      carried[name] = value; // no attribute carries it: the seed does\n      continue;\n    }\n    const attr = attributeOf(name, def);\n    if (attr === undefined) continue;\n    const raw = input.attributes[attr];\n    const parsed = parseAttribute(def, raw ?? null);\n    if (parsed === undefined) continue;\n    const checked = parsed.ok ? checkValue(tag, name, def, parsed.value) : parsed;\n    if (checked.ok) values[name] = checked.value;\n    else reportInvalid(tag, name, `the attribute ${attr}`, checked.issues);\n  }\n  return { values, carried };\n}\n\n/** The server registry entry for `spec`. */\nexport function serverComponent<S, M extends Tagged, P>(\n  tag: string,\n  spec: ComponentSpec<S, M, P>,\n): ServerComponent {\n  const table = (spec.props ?? {}) as PropTable;\n  const reducers = (spec.update ?? {}) as unknown as Reducers<S>;\n  const declared = new Set((spec.stores ?? []).map((store: AnyStore) => store.name));\n  const reader =\n    (scope: unknown) =>\n    <T>(store: StoreRef<T>): T => {\n      if (!declared.has(store.name)) {\n        throw new Error(`<${tag}> uses store \"${store.name}\" without declaring it in spec.stores.`);\n      }\n      const any = store as unknown as AnyStore;\n      const registry = scope instanceof StoreRegistry ? scope : serverScopeFor(tag, any);\n      return registry.get(any).state as T; // Sound: the ref carries this store's state type.\n    };\n  /**\n   * The rendering of a component that threw (ADR 0024): its error view (or nothing, also when\n   * the error view throws), no seed, and the GyralError the renderer reports.\n   */\n  const failed = (phase: ErrorPhase, cause: unknown, state: S | undefined): ServerRendering => {\n    const error = new GyralError(phase, message(78, tag), cause, tag);\n    let view: ServerRendering['view'] = nothing;\n    try {\n      if (spec.error !== undefined) view = spec.error(error, state);\n    } catch {\n      view = nothing; // the error view failed too: the host stays empty\n    }\n    return { view, seed: { props: {} }, failed: error };\n  };\n  return {\n    tag,\n    light: isLight(spec),\n    delegatesFocus: typeof spec.shadow === 'object' && spec.shadow.delegatesFocus === true,\n    styles: isLight(spec) ? [] : styleTexts(spec.styles),\n    hydrate: spec.hydrate ?? 'load',\n    render(input): ServerRendering {\n      const { values, carried } = propsFrom(tag, table, input);\n      const missing = missingRequired(values, table);\n      if (missing.length > 0) {\n        console.warn(`<${tag}> is missing required prop(s): ${missing.join(', ')}.`);\n      }\n      const props = readProps(values, table) as P; // Sound: exactly the declared props.\n      const ctx = { props, read: reader(input.scope) } as Ctx<object>;\n      let initial: S;\n      let state: S;\n      try {\n        [initial] = splitNext(runInit(spec, props));\n        state = initial;\n        for (const msg of (input.initialMessages ?? []) as Tagged[]) {\n          const reducer = reducers[msg._tag];\n          if (reducer !== undefined) [state] = splitNext(reducer(state, msg, ctx));\n        }\n      } catch (cause) {\n        return failed('init', cause, undefined);\n      }\n      try {\n        return {\n          view: spec.view(state, intentNames as IntentNames<string>, ctx as Ctx<P>),\n          seed: makeSeed(tag, state, initial, carried),\n        };\n      } catch (cause) {\n        return failed('view', cause, state);\n      }\n    },\n    fallback: (cause) => failed('view', cause, undefined),\n  };\n}\n\n/**\n * Registers every spec define() recorded outside the browser (and not registered yet) in\n * view/'s server registry. `@gyral/core/internal/server` calls it before each render; client code never\n * imports this module.\n */\nexport function registerRecordedSpecs(): void {\n  for (const [tag, spec] of recordedSpecs()) {\n    if (registered(tag) !== undefined) continue;\n    // Sound: define() recorded exactly this tag's ComponentSpec.\n    registerServerComponent(serverComponent(tag, spec as ComponentSpec<unknown, Tagged, object>));\n  }\n}\n"]}

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { type ChildValue } from './view/index.js';
-import { styleHash, styleHashSync, type ServerRenderOptions } from './view/server/index.js';
-export type { ServerRenderOptions };
+import { styleHash, styleHashSync, type ServerRenderOptions, type StyleValues } from './view/server/index.js';
+export type { ServerRenderOptions, StyleValues };
 export { styleHash, styleHashSync };
 /**
  * Whether `@gyral/core` resolved with the `development` condition (Vite's dev server and its
@@ -18,7 +18,7 @@ export declare function render(value: ChildValue, options?: ServerRenderOptions)
 export declare function renderToString(value: ChildValue, options?: ServerRenderOptions): string;
 /**
  * `'sha256-…'` hashes of every registered shadow component's declarative-shadow-root `<style>`,
- * for a `Content-Security-Policy` `style-src` (view/08-styles.md "Server").
+ * for a `Content-Security-Policy` `style-src`.
  */
 export declare function styleHashes(): Promise<readonly string[]>;
 /**
@@ -26,3 +26,9 @@ export declare function styleHashes(): Promise<readonly string[]>;
  * (recorded specs registered first), for checking or building a CSP at render time.
  */
 export declare function componentStyles(): ReadonlyMap<string, string>;
+/**
+ * A number that changes whenever a component registers with the server renderer (recorded
+ * specs registered first), so its CSS, and the `<style>` hashes a CSP lists, may have changed.
+ * Caches built from `componentStyles()` key on it.
+ */
+export declare function registryVersion(): number;

package/dist/server.js

@@ -1,10 +1,10 @@
-// `@gyral/core/server` (docs/design-docs/view/06-server.md): renders template results and Gyral
+// `@gyral/core/internal/server` (docs/design-docs/view/06-server.md): renders template results and Gyral
 // components to HTML without a DOM. Server-only: never import it from client code. Every
 // render first registers the specs define() recorded outside the browser, and the
 // `<gyral-stores>` provider.
 import { registerRecordedSpecs } from './server-component.js';
 import { storesProvider } from './stores-provider.js';
-import { DEV, registerServerProvider } from './view/index.js';
+import { DEV, registerServerProvider, serverRegistryVersion, } from './view/index.js';
 import { componentStyles as styles, render as renderChunks, renderToString as renderString, styleHash, styleHashes as hashes, styleHashSync, } from './view/server/index.js';
 export { styleHash, styleHashSync };
 /**
@@ -33,7 +33,7 @@ export function renderToString(value, options) {
 }
 /**
  * `'sha256-…'` hashes of every registered shadow component's declarative-shadow-root `<style>`,
- * for a `Content-Security-Policy` `style-src` (view/08-styles.md "Server").
+ * for a `Content-Security-Policy` `style-src`.
  */
 export function styleHashes() {
     prepare();
@@ -47,4 +47,13 @@ export function componentStyles() {
     prepare();
     return styles();
 }
+/**
+ * A number that changes whenever a component registers with the server renderer (recorded
+ * specs registered first), so its CSS, and the `<style>` hashes a CSP lists, may have changed.
+ * Caches built from `componentStyles()` key on it.
+ */
+export function registryVersion() {
+    prepare();
+    return serverRegistryVersion();
+}
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,yFAAyF;AACzF,kFAAkF;AAClF,6BAA6B;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,sBAAsB,EAAmB,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EACL,eAAe,IAAI,MAAM,EACzB,MAAM,IAAI,YAAY,EACtB,cAAc,IAAI,YAAY,EAC9B,SAAS,EACT,WAAW,IAAI,MAAM,EACrB,aAAa,GAEd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAY,GAAG,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,SAAS,OAAO;IACd,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACvC,qBAAqB,EAAE,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAiB,EAAE,OAA6B;IACrE,OAAO,EAAE,CAAC;IACV,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,OAA6B;IAC7E,OAAO,EAAE,CAAC;IACV,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,CAAC;IACV,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,CAAC;IACV,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC","sourcesContent":["// `@gyral/core/server` (docs/design-docs/view/06-server.md): renders template results and Gyral\n// components to HTML without a DOM. Server-only: never import it from client code. Every\n// render first registers the specs define() recorded outside the browser, and the\n// `<gyral-stores>` provider.\nimport { registerRecordedSpecs } from './server-component.js';\nimport { storesProvider } from './stores-provider.js';\nimport { DEV, registerServerProvider, type ChildValue } from './view/index.js';\nimport {\n  componentStyles as styles,\n  render as renderChunks,\n  renderToString as renderString,\n  styleHash,\n  styleHashes as hashes,\n  styleHashSync,\n  type ServerRenderOptions,\n} from './view/server/index.js';\n\nexport type { ServerRenderOptions };\nexport { styleHash, styleHashSync };\n\n/**\n * Whether `@gyral/core` resolved with the `development` condition (Vite's dev server and its\n * SSR, Vitest): the default of `render`'s `dev` option (view/06-server.md \"Development markers\").\n */\nexport const development: boolean = DEV;\nexport { StoreRegistry, withStoreScope } from './store-scope.js';\n\nfunction prepare(): void {\n  registerServerProvider(storesProvider);\n  registerRecordedSpecs();\n}\n\n/**\n * Renders `value` to HTML chunks, synchronously and lazily: each step of the iterator writes up\n * to the next component boundary, running that component's `init` and view. Wrap each step in\n * `withStoreScope(registry, …)` to give components the request's stores (ADR 0013).\n */\nexport function render(value: ChildValue, options?: ServerRenderOptions): Iterable<string> {\n  prepare();\n  return renderChunks(value, options);\n}\n\n/** Renders `value` to one HTML string. */\nexport function renderToString(value: ChildValue, options?: ServerRenderOptions): string {\n  prepare();\n  return renderString(value, options);\n}\n\n/**\n * `'sha256-…'` hashes of every registered shadow component's declarative-shadow-root `<style>`,\n * for a `Content-Security-Policy` `style-src` (view/08-styles.md \"Server\").\n */\nexport function styleHashes(): Promise<readonly string[]> {\n  prepare();\n  return hashes();\n}\n\n/**\n * Tag → declarative-shadow-root `<style>` text of every registered shadow component with CSS\n * (recorded specs registered first), for checking or building a CSP at render time.\n */\nexport function componentStyles(): ReadonlyMap<string, string> {\n  prepare();\n  return styles();\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,yFAAyF;AACzF,kFAAkF;AAClF,6BAA6B;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,GAAG,EACH,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,IAAI,MAAM,EACzB,MAAM,IAAI,YAAY,EACtB,cAAc,IAAI,YAAY,EAC9B,SAAS,EACT,WAAW,IAAI,MAAM,EACrB,aAAa,GAGd,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEpC;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAY,GAAG,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjE,SAAS,OAAO;IACd,sBAAsB,CAAC,cAAc,CAAC,CAAC;IACvC,qBAAqB,EAAE,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,KAAiB,EAAE,OAA6B;IACrE,OAAO,EAAE,CAAC;IACV,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,OAA6B;IAC7E,OAAO,EAAE,CAAC;IACV,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,CAAC;IACV,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,CAAC;IACV,OAAO,MAAM,EAAE,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,CAAC;IACV,OAAO,qBAAqB,EAAE,CAAC;AACjC,CAAC","sourcesContent":["// `@gyral/core/internal/server` (docs/design-docs/view/06-server.md): renders template results and Gyral\n// components to HTML without a DOM. Server-only: never import it from client code. Every\n// render first registers the specs define() recorded outside the browser, and the\n// `<gyral-stores>` provider.\nimport { registerRecordedSpecs } from './server-component.js';\nimport { storesProvider } from './stores-provider.js';\nimport {\n  DEV,\n  registerServerProvider,\n  serverRegistryVersion,\n  type ChildValue,\n} from './view/index.js';\nimport {\n  componentStyles as styles,\n  render as renderChunks,\n  renderToString as renderString,\n  styleHash,\n  styleHashes as hashes,\n  styleHashSync,\n  type ServerRenderOptions,\n  type StyleValues,\n} from './view/server/index.js';\n\nexport type { ServerRenderOptions, StyleValues };\nexport { styleHash, styleHashSync };\n\n/**\n * Whether `@gyral/core` resolved with the `development` condition (Vite's dev server and its\n * SSR, Vitest): the default of `render`'s `dev` option (view/06-server.md \"Development markers\").\n */\nexport const development: boolean = DEV;\nexport { StoreRegistry, withStoreScope } from './store-scope.js';\n\nfunction prepare(): void {\n  registerServerProvider(storesProvider);\n  registerRecordedSpecs();\n}\n\n/**\n * Renders `value` to HTML chunks, synchronously and lazily: each step of the iterator writes up\n * to the next component boundary, running that component's `init` and view. Wrap each step in\n * `withStoreScope(registry, …)` to give components the request's stores (ADR 0013).\n */\nexport function render(value: ChildValue, options?: ServerRenderOptions): Iterable<string> {\n  prepare();\n  return renderChunks(value, options);\n}\n\n/** Renders `value` to one HTML string. */\nexport function renderToString(value: ChildValue, options?: ServerRenderOptions): string {\n  prepare();\n  return renderString(value, options);\n}\n\n/**\n * `'sha256-…'` hashes of every registered shadow component's declarative-shadow-root `<style>`,\n * for a `Content-Security-Policy` `style-src`.\n */\nexport function styleHashes(): Promise<readonly string[]> {\n  prepare();\n  return hashes();\n}\n\n/**\n * Tag → declarative-shadow-root `<style>` text of every registered shadow component with CSS\n * (recorded specs registered first), for checking or building a CSP at render time.\n */\nexport function componentStyles(): ReadonlyMap<string, string> {\n  prepare();\n  return styles();\n}\n\n/**\n * A number that changes whenever a component registers with the server renderer (recorded\n * specs registered first), so its CSS, and the `<style>` hashes a CSP lists, may have changed.\n * Caches built from `componentStyles()` key on it.\n */\nexport function registryVersion(): number {\n  prepare();\n  return serverRegistryVersion();\n}\n"]}

package/dist/settled.d.ts

@@ -1,7 +1,8 @@
 /**
- * Resolves once rendering is quiet: every connected Gyral host has rendered its latest state,
- * view-transition updates have run, and focus commands and outputs have been delivered (an
- * output that makes a parent render is waited for too). Rejects with the loop guard's error
+ * Resolves once the page is quiet: every connected Gyral host has rendered its latest state,
+ * view-transition updates have run, focus commands and outputs have been delivered, and
+ * messages have stopped arriving (a stream's next value, already on its way in a microtask, is
+ * waited for; long-lived commands themselves are not). Rejects with the loop guard's error
  * when rendering never settles in development (components feeding each other).
  *
  *   el.send({ _tag: 'Increment' });

package/dist/settled.js

@@ -1,40 +1,62 @@
-// `settled()` (docs/design-docs/view/04-scheduler.md "`settled()`"): wait until rendering is
+// `settled()` (docs/design-docs/view/04-scheduler.md "`settled()`"): wait until the page is
 // quiet. Implemented on the global scheduler: no host is dirty, no flush is scheduled, no
-// view-transition update is pending, the post-render queue has run, and outputs sent to
-// parents have been delivered. It covers rendering only: driver work (HTTP, timers) is outside
-// it. Tests use it instead of the 0.2 `el.updateComplete`.
-import { isQuiet, whenQuiet } from './scheduler.js';
-/** Rounds of "wait for the next quiet flush" before settled() gives up: a cycle. */
-const MAX_ROUNDS = 100;
+// view-transition update is pending, the post-render queue has run, outputs sent to parents
+// have been delivered, and no message has reached a host or a store for QUIET_TURNS microtask
+// turns in a row. Commands that are still running (streams that never end, requests waiting
+// for a server) don't count: only the messages they deliver do. Timers are never advanced or
+// waited for. Tests await it before asserting on the DOM.
+import { activityCount, isQuiet, whenQuiet } from './scheduler.js';
+import { message } from './view/index.js';
 /**
- * Microtask turns first, so follow-ups that are already resolving (a driver that answered at
- * once, an output on its way to a parent) reach the scheduler before quiet is judged.
+ * Flushes and busy turns settled() waits through before it gives up. High enough for a finite
+ * burst (a progress stream, an async iterable over a list: a few hundred messages in a row),
+ * low enough that a stream that never stops, or components feeding each other, still fails
+ * fast instead of hanging a test.
  */
-const DRAIN_TURNS = 4;
-async function drain() {
-    for (let turn = 0; turn < DRAIN_TURNS; turn += 1)
-        await Promise.resolve();
-}
+const MAX_ROUNDS = 10_000;
 /**
- * Resolves once rendering is quiet: every connected Gyral host has rendered its latest state,
- * view-transition updates have run, and focus commands and outputs have been delivered (an
- * output that makes a parent render is waited for too). Rejects with the loop guard's error
+ * Consecutive microtask turns with no message and nothing to render before the page counts as
+ * quiet, so follow-ups that are already resolving (a driver that answered at once, a store
+ * notifying its subscribers in a microtask, a stream re-arming in one) reach a host first.
+ */
+const QUIET_TURNS = 8;
+const cycle = () => new Error(message(34, MAX_ROUNDS));
+/**
+ * Resolves once the page is quiet: every connected Gyral host has rendered its latest state,
+ * view-transition updates have run, focus commands and outputs have been delivered, and
+ * messages have stopped arriving (a stream's next value, already on its way in a microtask, is
+ * waited for; long-lived commands themselves are not). Rejects with the loop guard's error
  * when rendering never settles in development (components feeding each other).
  *
  *   el.send({ _tag: 'Increment' });
  *   await settled();
  */
 export async function settled() {
-    for (let round = 0; round < MAX_ROUNDS; round += 1) {
-        // Wait for a pending flush before draining, so its outcome (a loop-guard error) reaches us.
-        const pending = isQuiet() ? undefined : whenQuiet();
-        await drain();
-        if (pending !== undefined)
-            await pending;
-        else if (isQuiet())
+    let rounds = 0;
+    let quietTurns = 0;
+    let seen = activityCount();
+    for (;;) {
+        if (!isQuiet()) {
+            // Ask for the flush's promise before it runs, so its outcome (a loop-guard error) reaches us.
+            if (++rounds > MAX_ROUNDS)
+                throw cycle();
+            await whenQuiet();
+            quietTurns = 0;
+            seen = activityCount();
+            continue;
+        }
+        await Promise.resolve();
+        const now = activityCount();
+        if (now !== seen) {
+            // A message arrived (its host may already have rendered): start the quiet window again.
+            if (++rounds > MAX_ROUNDS)
+                throw cycle();
+            seen = now;
+            quietTurns = 0;
+        }
+        else if (isQuiet() && ++quietTurns >= QUIET_TURNS) {
             return;
+        }
     }
-    throw new Error(`settled(): rendering did not settle after ${String(MAX_ROUNDS)} flushes. ` +
-        'Components are probably feeding each other props or messages in a cycle.');
 }
 //# sourceMappingURL=settled.js.map

package/dist/settled.js.map

@@ -1 +1 @@
-{"version":3,"file":"settled.js","sourceRoot":"","sources":["../src/settled.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,0FAA0F;AAC1F,wFAAwF;AACxF,+FAA+F;AAC/F,2DAA2D;AAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpD,oFAAoF;AACpF,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,KAAK,UAAU,KAAK;IAClB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,WAAW,EAAE,IAAI,IAAI,CAAC;QAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,4FAA4F;QAC5F,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QACpD,MAAM,KAAK,EAAE,CAAC;QACd,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,OAAO,CAAC;aACpC,IAAI,OAAO,EAAE;YAAE,OAAO;IAC7B,CAAC;IACD,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,UAAU,CAAC,YAAY;QACzE,0EAA0E,CAC7E,CAAC;AACJ,CAAC","sourcesContent":["// `settled()` (docs/design-docs/view/04-scheduler.md \"`settled()`\"): wait until rendering is\n// quiet. Implemented on the global scheduler: no host is dirty, no flush is scheduled, no\n// view-transition update is pending, the post-render queue has run, and outputs sent to\n// parents have been delivered. It covers rendering only: driver work (HTTP, timers) is outside\n// it. Tests use it instead of the 0.2 `el.updateComplete`.\nimport { isQuiet, whenQuiet } from './scheduler.js';\n\n/** Rounds of \"wait for the next quiet flush\" before settled() gives up: a cycle. */\nconst MAX_ROUNDS = 100;\n\n/**\n * Microtask turns first, so follow-ups that are already resolving (a driver that answered at\n * once, an output on its way to a parent) reach the scheduler before quiet is judged.\n */\nconst DRAIN_TURNS = 4;\n\nasync function drain(): Promise<void> {\n  for (let turn = 0; turn < DRAIN_TURNS; turn += 1) await Promise.resolve();\n}\n\n/**\n * Resolves once rendering is quiet: every connected Gyral host has rendered its latest state,\n * view-transition updates have run, and focus commands and outputs have been delivered (an\n * output that makes a parent render is waited for too). Rejects with the loop guard's error\n * when rendering never settles in development (components feeding each other).\n *\n *   el.send({ _tag: 'Increment' });\n *   await settled();\n */\nexport async function settled(): Promise<void> {\n  for (let round = 0; round < MAX_ROUNDS; round += 1) {\n    // Wait for a pending flush before draining, so its outcome (a loop-guard error) reaches us.\n    const pending = isQuiet() ? undefined : whenQuiet();\n    await drain();\n    if (pending !== undefined) await pending;\n    else if (isQuiet()) return;\n  }\n  throw new Error(\n    `settled(): rendering did not settle after ${String(MAX_ROUNDS)} flushes. ` +\n      'Components are probably feeding each other props or messages in a cycle.',\n  );\n}\n"]}
+{"version":3,"file":"settled.js","sourceRoot":"","sources":["../src/settled.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,0FAA0F;AAC1F,4FAA4F;AAC5F,8FAA8F;AAC9F,4FAA4F;AAC5F,6FAA6F;AAC7F,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAM,KAAK,GAAG,GAAU,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,IAAI,GAAG,aAAa,EAAE,CAAC;IAC3B,SAAS,CAAC;QACR,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACf,8FAA8F;YAC9F,IAAI,EAAE,MAAM,GAAG,UAAU;gBAAE,MAAM,KAAK,EAAE,CAAC;YACzC,MAAM,SAAS,EAAE,CAAC;YAClB,UAAU,GAAG,CAAC,CAAC;YACf,IAAI,GAAG,aAAa,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,wFAAwF;YACxF,IAAI,EAAE,MAAM,GAAG,UAAU;gBAAE,MAAM,KAAK,EAAE,CAAC;YACzC,IAAI,GAAG,GAAG,CAAC;YACX,UAAU,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,OAAO,EAAE,IAAI,EAAE,UAAU,IAAI,WAAW,EAAE,CAAC;YACpD,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["// `settled()` (docs/design-docs/view/04-scheduler.md \"`settled()`\"): wait until the page is\n// quiet. Implemented on the global scheduler: no host is dirty, no flush is scheduled, no\n// view-transition update is pending, the post-render queue has run, outputs sent to parents\n// have been delivered, and no message has reached a host or a store for QUIET_TURNS microtask\n// turns in a row. Commands that are still running (streams that never end, requests waiting\n// for a server) don't count: only the messages they deliver do. Timers are never advanced or\n// waited for. Tests await it before asserting on the DOM.\nimport { activityCount, isQuiet, whenQuiet } from './scheduler.js';\nimport { message } from './view/index.js';\n\n/**\n * Flushes and busy turns settled() waits through before it gives up. High enough for a finite\n * burst (a progress stream, an async iterable over a list: a few hundred messages in a row),\n * low enough that a stream that never stops, or components feeding each other, still fails\n * fast instead of hanging a test.\n */\nconst MAX_ROUNDS = 10_000;\n\n/**\n * Consecutive microtask turns with no message and nothing to render before the page counts as\n * quiet, so follow-ups that are already resolving (a driver that answered at once, a store\n * notifying its subscribers in a microtask, a stream re-arming in one) reach a host first.\n */\nconst QUIET_TURNS = 8;\n\nconst cycle = (): Error => new Error(message(34, MAX_ROUNDS));\n\n/**\n * Resolves once the page is quiet: every connected Gyral host has rendered its latest state,\n * view-transition updates have run, focus commands and outputs have been delivered, and\n * messages have stopped arriving (a stream's next value, already on its way in a microtask, is\n * waited for; long-lived commands themselves are not). Rejects with the loop guard's error\n * when rendering never settles in development (components feeding each other).\n *\n *   el.send({ _tag: 'Increment' });\n *   await settled();\n */\nexport async function settled(): Promise<void> {\n  let rounds = 0;\n  let quietTurns = 0;\n  let seen = activityCount();\n  for (;;) {\n    if (!isQuiet()) {\n      // Ask for the flush's promise before it runs, so its outcome (a loop-guard error) reaches us.\n      if (++rounds > MAX_ROUNDS) throw cycle();\n      await whenQuiet();\n      quietTurns = 0;\n      seen = activityCount();\n      continue;\n    }\n    await Promise.resolve();\n    const now = activityCount();\n    if (now !== seen) {\n      // A message arrived (its host may already have rendered): start the quiet window again.\n      if (++rounds > MAX_ROUNDS) throw cycle();\n      seen = now;\n      quietTurns = 0;\n    } else if (isQuiet() && ++quietTurns >= QUIET_TURNS) {\n      return;\n    }\n  }\n}\n"]}

package/dist/spec-features-used.d.ts

@@ -0,0 +1,21 @@
+import type * as Full from './spec-features.js';
+export declare let viewTransitions: typeof Full.viewTransitions;
+export declare let frameLane: typeof Full.frameLane;
+export declare let customStates: typeof Full.customStates;
+export declare let formAssociation: typeof Full.formAssociation;
+export declare let subscriptions: typeof Full.subscriptions;
+export declare let errorView: typeof Full.errorView;
+export declare let errored: typeof Full.errored;
+export declare const useViewTransitions: (run: Full.ViewTransitions) => void;
+export declare const useFrameLane: (lane: import("./frame-lane.js").FrameLane) => void;
+export declare const useCustomStates: (sync: Full.CustomStates) => void;
+export declare const useFormAssociation: (make: {
+    create<S, P>(host: HTMLElement, model: Pick<import("./host-model.js").HostModel<unknown, unknown>, "hasReducer" | "dispatch">, projection: import("./form-associated.js").FormAssociation<S, P> | undefined): void;
+    sync(host: HTMLElement, state: unknown, ctx: import("./types.js").Ctx<unknown>, root: ParentNode): void;
+    install: (Element: CustomElementConstructor, enabled: boolean) => void;
+}) => void;
+export declare const useSubscriptions: (make: typeof import("./subscriptions.js").subscriptionSet) => void;
+export declare const useErrorView: (view: typeof import("./error-view.js").renderErrorView) => void;
+export declare const useErrored: (send: typeof import("./error-view.js").sendErrored) => void;
+/** Development: a spec field whose machinery the build left out (define(), element.ts). */
+export declare const checkSpecFeatures: (tag: string, spec: object) => void;

package/dist/spec-features-used.js

@@ -0,0 +1,50 @@
+import { DEV } from './view/index.js';
+export let viewTransitions;
+export let frameLane;
+export let customStates;
+export let formAssociation;
+export let subscriptions;
+export let errorView;
+export let errored;
+export const useViewTransitions = ((run) => {
+    viewTransitions = run;
+});
+export const useFrameLane = ((lane) => {
+    frameLane = lane;
+});
+export const useCustomStates = ((sync) => {
+    customStates = sync;
+});
+export const useFormAssociation = ((make) => {
+    formAssociation = make;
+});
+export const useSubscriptions = ((make) => {
+    subscriptions = make;
+});
+export const useErrorView = ((view) => {
+    errorView = view;
+});
+export const useErrored = ((send) => {
+    errored = send;
+});
+/** Development: a spec field whose machinery the build left out (define(), element.ts). */
+export const checkSpecFeatures = ((tag, spec) => {
+    if (!DEV)
+        return;
+    const slots = {
+        viewTransition: viewTransitions,
+        renderOnFrame: frameLane,
+        states: customStates,
+        formAssociated: formAssociation,
+        subscriptions,
+        error: errorView,
+    };
+    for (const [field, slot] of Object.entries(slots)) {
+        if (!(field in spec) || slot !== undefined)
+            continue;
+        console.warn(`gyral: <${tag}> declares ${field}, but the build found no module naming it, so its ` +
+            `code was left out and the component renders without it. Write the field name in your ` +
+            `source (view/05-element.md "Features register themselves").`);
+    }
+});
+//# sourceMappingURL=spec-features-used.js.map

package/dist/spec-features-used.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-features-used.js","sourceRoot":"","sources":["../src/spec-features-used.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,MAAM,CAAC,IAAI,eAA4C,CAAC;AACxD,MAAM,CAAC,IAAI,SAAgC,CAAC;AAC5C,MAAM,CAAC,IAAI,YAAsC,CAAC;AAClD,MAAM,CAAC,IAAI,eAA4C,CAAC;AACxD,MAAM,CAAC,IAAI,aAAwC,CAAC;AACpD,MAAM,CAAC,IAAI,SAAgC,CAAC;AAC5C,MAAM,CAAC,IAAI,OAA4B,CAAC;AAExC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;IACzC,eAAe,GAAG,GAAG,CAAC;AACxB,CAAC,CAA0C,CAAC;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACpC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC,CAAoC,CAAC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACvC,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC,CAAuC,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IAC1C,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC,CAA0C,CAAC;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACxC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC,CAAwC,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACpC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC,CAAoC,CAAC;AACtC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IAClC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC,CAAkC,CAAC;AAEpC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,GAAW,EAAE,IAAY,EAAQ,EAAE;IACpE,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,KAAK,GAA4B;QACrC,cAAc,EAAE,eAAe;QAC/B,aAAa,EAAE,SAAS;QACxB,MAAM,EAAE,YAAY;QACpB,cAAc,EAAE,eAAe;QAC/B,aAAa;QACb,KAAK,EAAE,SAAS;KACjB,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACrD,OAAO,CAAC,IAAI,CACV,WAAW,GAAG,cAAc,KAAK,oDAAoD;YACnF,uFAAuF;YACvF,6DAA6D,CAChE,CAAC;IACJ,CAAC;AACH,CAAC,CAAyC,CAAC","sourcesContent":["// `#spec-features` in builds with the Vite preset (the `gyral-compiled` condition, gyral-c5d.12):\n// the same exports as spec-features.ts, as slots. The build fills a slot (use-*.ts) when some\n// module it transforms names the spec field (compiler/features.ts), so apps without view\n// transitions, the frame lane or custom states don't bundle them. An unfilled slot degrades as\n// the platform would (ADR 0003 tier 1): no transition, the microtask lane, no custom states.\n// That happens only when a field's name is built at run time; development builds warn.\nimport type * as Full from './spec-features.js';\nimport { DEV } from './view/index.js';\n\nexport let viewTransitions: typeof Full.viewTransitions;\nexport let frameLane: typeof Full.frameLane;\nexport let customStates: typeof Full.customStates;\nexport let formAssociation: typeof Full.formAssociation;\nexport let subscriptions: typeof Full.subscriptions;\nexport let errorView: typeof Full.errorView;\nexport let errored: typeof Full.errored;\n\nexport const useViewTransitions = ((run) => {\n  viewTransitions = run;\n}) satisfies typeof Full.useViewTransitions;\nexport const useFrameLane = ((lane) => {\n  frameLane = lane;\n}) satisfies typeof Full.useFrameLane;\nexport const useCustomStates = ((sync) => {\n  customStates = sync;\n}) satisfies typeof Full.useCustomStates;\nexport const useFormAssociation = ((make) => {\n  formAssociation = make;\n}) satisfies typeof Full.useFormAssociation;\nexport const useSubscriptions = ((make) => {\n  subscriptions = make;\n}) satisfies typeof Full.useSubscriptions;\nexport const useErrorView = ((view) => {\n  errorView = view;\n}) satisfies typeof Full.useErrorView;\nexport const useErrored = ((send) => {\n  errored = send;\n}) satisfies typeof Full.useErrored;\n\n/** Development: a spec field whose machinery the build left out (define(), element.ts). */\nexport const checkSpecFeatures = ((tag: string, spec: object): void => {\n  if (!DEV) return;\n  const slots: Record<string, unknown> = {\n    viewTransition: viewTransitions,\n    renderOnFrame: frameLane,\n    states: customStates,\n    formAssociated: formAssociation,\n    subscriptions,\n    error: errorView,\n  };\n  for (const [field, slot] of Object.entries(slots)) {\n    if (!(field in spec) || slot !== undefined) continue;\n    console.warn(\n      `gyral: <${tag}> declares ${field}, but the build found no module naming it, so its ` +\n        `code was left out and the component renders without it. Write the field name in your ` +\n        `source (view/05-element.md \"Features register themselves\").`,\n    );\n  }\n}) satisfies typeof Full.checkSpecFeatures;\n"]}

package/dist/spec-features.d.ts

@@ -0,0 +1,28 @@
+import { type FrameLane } from './frame-lane.js';
+import { formFeature } from './form-associated.js';
+import { renderErrorView, sendErrored } from './error-view.js';
+import { subscriptionSet } from './subscriptions.js';
+/** Runs a flush inside a view transition (true), or declines (false: run it plainly). */
+export type ViewTransitions = (update: () => void) => boolean;
+/** Writes a host's boolean states to its CustomStateSet. */
+export type CustomStates = (el: HTMLElement, states: Readonly<Record<string, boolean>>) => void;
+export declare const viewTransitions: ViewTransitions | undefined;
+export declare const frameLane: FrameLane | undefined;
+export declare const customStates: CustomStates | undefined;
+export declare const formAssociation: typeof formFeature | undefined;
+/** Makes a host's subscription set (`subscriptions`, ADR 0025). */
+export declare const subscriptions: typeof subscriptionSet | undefined;
+/** Renders a component's `error` view (ADR 0024). */
+export declare const errorView: typeof renderErrorView | undefined;
+/** Sends `Errored` to a component that handles it (ADR 0024). */
+export declare const errored: typeof sendErrored | undefined;
+/** Registrations (use-*.ts) are for compiled builds; here everything is present. */
+export declare const useViewTransitions: (run: ViewTransitions) => void;
+export declare const useFrameLane: (lane: FrameLane) => void;
+export declare const useCustomStates: (sync: CustomStates) => void;
+export declare const useFormAssociation: (make: typeof formFeature) => void;
+export declare const useSubscriptions: (make: typeof subscriptionSet) => void;
+export declare const useErrorView: (view: typeof renderErrorView) => void;
+export declare const useErrored: (send: typeof sendErrored) => void;
+/** Development check for compiled builds (spec-features-used.ts); nothing to check here. */
+export declare const checkSpecFeatures: (tag: string, spec: object) => void;

package/dist/spec-features.js

@@ -0,0 +1,42 @@
+// Optional machinery that apps reach through spec fields rather than an API call (view/05
+// "Features register themselves", gyral-c5d.12): view transitions (`viewTransition`), the frame
+// lane (`renderOnFrame`), custom states (`states`), subscriptions (`subscriptions`) and the error
+// fallback (`error`, and the `Errored` message); and
+// through markup: the dialog and popover bindings (`?modal`, `?popover-open`); and through a
+// hook spec key: hook disposal (`dispose`). Core's
+// `#spec-features` resolves here by
+// default (the runtime path: no build step), so everything is present. Builds with the Vite
+// preset (the `gyral-compiled` condition) resolve spec-features-used.ts instead, whose slots
+// the build fills only for the fields some module names (use-*.ts, compiler/features.ts).
+import { frameLane as lane } from './frame-lane.js';
+import { syncStates } from './states.js';
+import { formFeature } from './form-associated.js';
+import { renderErrorView, sendErrored } from './error-view.js';
+import { subscriptionSet } from './subscriptions.js';
+import { startTransition } from './transitions.js';
+import { applyToggle, commitTracked, useDisposableHooks, useToggles } from './view/index.js';
+// `?modal`/`?popover-open` (view/02 "Dialogs and popovers"): present without a build step.
+useToggles(applyToggle);
+// Hooks with `dispose` (view/02 "Widgets with a lifecycle"): present without a build step.
+useDisposableHooks(commitTracked);
+export const viewTransitions = startTransition;
+export const frameLane = lane;
+export const customStates = syncStates;
+export const formAssociation = formFeature;
+/** Makes a host's subscription set (`subscriptions`, ADR 0025). */
+export const subscriptions = subscriptionSet;
+/** Renders a component's `error` view (ADR 0024). */
+export const errorView = renderErrorView;
+/** Sends `Errored` to a component that handles it (ADR 0024). */
+export const errored = sendErrored;
+/** Registrations (use-*.ts) are for compiled builds; here everything is present. */
+export const useViewTransitions = () => undefined;
+export const useFrameLane = () => undefined;
+export const useCustomStates = () => undefined;
+export const useFormAssociation = () => undefined;
+export const useSubscriptions = () => undefined;
+export const useErrorView = () => undefined;
+export const useErrored = () => undefined;
+/** Development check for compiled builds (spec-features-used.ts); nothing to check here. */
+export const checkSpecFeatures = () => undefined;
+//# sourceMappingURL=spec-features.js.map

package/dist/spec-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-features.js","sourceRoot":"","sources":["../src/spec-features.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,gGAAgG;AAChG,kGAAkG;AAClG,qDAAqD;AACrD,6FAA6F;AAC7F,mDAAmD;AACnD,oCAAoC;AACpC,4FAA4F;AAC5F,6FAA6F;AAC7F,0FAA0F;AAC1F,OAAO,EAAE,SAAS,IAAI,IAAI,EAAkB,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7F,2FAA2F;AAC3F,UAAU,CAAC,WAAW,CAAC,CAAC;AACxB,2FAA2F;AAC3F,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAOlC,MAAM,CAAC,MAAM,eAAe,GAAgC,eAAe,CAAC;AAC5E,MAAM,CAAC,MAAM,SAAS,GAA0B,IAAI,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAA6B,UAAU,CAAC;AACjE,MAAM,CAAC,MAAM,eAAe,GAAmC,WAAW,CAAC;AAC3E,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAuC,eAAe,CAAC;AACjF,qDAAqD;AACrD,MAAM,CAAC,MAAM,SAAS,GAAuC,eAAe,CAAC;AAC7E,iEAAiE;AACjE,MAAM,CAAC,MAAM,OAAO,GAAmC,WAAW,CAAC;AAEnE,oFAAoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAmC,GAAG,EAAE,CAAC,SAAS,CAAC;AAClF,MAAM,CAAC,MAAM,YAAY,GAA8B,GAAG,EAAE,CAAC,SAAS,CAAC;AACvE,MAAM,CAAC,MAAM,eAAe,GAAiC,GAAG,EAAE,CAAC,SAAS,CAAC;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAuC,GAAG,EAAE,CAAC,SAAS,CAAC;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAA2C,GAAG,EAAE,CAAC,SAAS,CAAC;AACxF,MAAM,CAAC,MAAM,YAAY,GAA2C,GAAG,EAAE,CAAC,SAAS,CAAC;AACpF,MAAM,CAAC,MAAM,UAAU,GAAuC,GAAG,EAAE,CAAC,SAAS,CAAC;AAE9E,4FAA4F;AAC5F,MAAM,CAAC,MAAM,iBAAiB,GAAwC,GAAG,EAAE,CAAC,SAAS,CAAC","sourcesContent":["// Optional machinery that apps reach through spec fields rather than an API call (view/05\n// \"Features register themselves\", gyral-c5d.12): view transitions (`viewTransition`), the frame\n// lane (`renderOnFrame`), custom states (`states`), subscriptions (`subscriptions`) and the error\n// fallback (`error`, and the `Errored` message); and\n// through markup: the dialog and popover bindings (`?modal`, `?popover-open`); and through a\n// hook spec key: hook disposal (`dispose`). Core's\n// `#spec-features` resolves here by\n// default (the runtime path: no build step), so everything is present. Builds with the Vite\n// preset (the `gyral-compiled` condition) resolve spec-features-used.ts instead, whose slots\n// the build fills only for the fields some module names (use-*.ts, compiler/features.ts).\nimport { frameLane as lane, type FrameLane } from './frame-lane.js';\nimport { syncStates } from './states.js';\nimport { formFeature } from './form-associated.js';\nimport { renderErrorView, sendErrored } from './error-view.js';\nimport { subscriptionSet } from './subscriptions.js';\nimport { startTransition } from './transitions.js';\nimport { applyToggle, commitTracked, useDisposableHooks, useToggles } from './view/index.js';\n\n// `?modal`/`?popover-open` (view/02 \"Dialogs and popovers\"): present without a build step.\nuseToggles(applyToggle);\n// Hooks with `dispose` (view/02 \"Widgets with a lifecycle\"): present without a build step.\nuseDisposableHooks(commitTracked);\n\n/** Runs a flush inside a view transition (true), or declines (false: run it plainly). */\nexport type ViewTransitions = (update: () => void) => boolean;\n/** Writes a host's boolean states to its CustomStateSet. */\nexport type CustomStates = (el: HTMLElement, states: Readonly<Record<string, boolean>>) => void;\n\nexport const viewTransitions: ViewTransitions | undefined = startTransition;\nexport const frameLane: FrameLane | undefined = lane;\nexport const customStates: CustomStates | undefined = syncStates;\nexport const formAssociation: typeof formFeature | undefined = formFeature;\n/** Makes a host's subscription set (`subscriptions`, ADR 0025). */\nexport const subscriptions: typeof subscriptionSet | undefined = subscriptionSet;\n/** Renders a component's `error` view (ADR 0024). */\nexport const errorView: typeof renderErrorView | undefined = renderErrorView;\n/** Sends `Errored` to a component that handles it (ADR 0024). */\nexport const errored: typeof sendErrored | undefined = sendErrored;\n\n/** Registrations (use-*.ts) are for compiled builds; here everything is present. */\nexport const useViewTransitions: (run: ViewTransitions) => void = () => undefined;\nexport const useFrameLane: (lane: FrameLane) => void = () => undefined;\nexport const useCustomStates: (sync: CustomStates) => void = () => undefined;\nexport const useFormAssociation: (make: typeof formFeature) => void = () => undefined;\nexport const useSubscriptions: (make: typeof subscriptionSet) => void = () => undefined;\nexport const useErrorView: (view: typeof renderErrorView) => void = () => undefined;\nexport const useErrored: (send: typeof sendErrored) => void = () => undefined;\n\n/** Development check for compiled builds (spec-features-used.ts); nothing to check here. */\nexport const checkSpecFeatures: (tag: string, spec: object) => void = () => undefined;\n"]}

package/dist/states.d.ts

@@ -1,7 +1,5 @@
-/** Writes a component's boolean states to its CustomStateSet. */
-export type StateSync = (states: Readonly<Record<string, boolean>>) => void;
 /**
- * A function that mirrors boolean states onto `internals.states`, or `false` when the platform
- * lacks custom states.
+ * Mirrors a component's boolean states onto its CustomStateSet. ElementInternals is attached
+ * lazily, once per element, by the first sync (view/05-element.md "ElementInternals").
  */
-export declare function stateSync(internals: ElementInternals): StateSync | false;
+export declare function syncStates(el: HTMLElement, states: Readonly<Record<string, boolean>>): void;