@gyral/core 0.2.0 → 0.3.1

package/dist/use-transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-transitions.js","sourceRoot":"","sources":["../src/use-transitions.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,4FAA4F;AAC5F,sBAAsB;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,kBAAkB,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC","sourcesContent":["// Registers startTransition in a compiled build (gyral-c5d.12). Only the module the build adds for a\n// module that names the spec field imports it (compiler/features.ts), so other builds leave\n// transitions.ts out.\nimport { useViewTransitions } from '#spec-features';\nimport { startTransition } from './transitions.js';\n\n/** Called once by the added module, before any module that names the field runs. */\nexport function register(): void {\n  useViewTransitions(startTransition);\n}\n"]}

package/dist/view/attributes.d.ts

@@ -0,0 +1,11 @@
+/** Host attribute holding a component's JSON seed (ADR 0012); the client removes it. */
+export declare const SEED_ATTRIBUTE = "data-gyral-seed";
+/** Marks a server-rendered light-DOM host (ADR 0014), so hydration knows its own content. */
+export declare const LIGHT_ATTRIBUTE = "data-gyral-light";
+/** A deferred island's strategy (07 "Islands"), next to `defer-hydration`. */
+export declare const ISLAND_ATTRIBUTE = "data-gyral-hydrate";
+/**
+ * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view
+ * (or nothing) and no seed, and the client starts it fresh instead of hydrating.
+ */
+export declare const ERROR_ATTRIBUTE = "data-gyral-error";

package/dist/view/attributes.js

@@ -0,0 +1,15 @@
+// Host attributes the server renderer writes (view/06-server.md "Components") and the client
+// reads (07). Core's hydration.ts, light-dom.ts and islands.ts declare the same names for the
+// client; server-components.node.test.ts checks that they match.
+/** Host attribute holding a component's JSON seed (ADR 0012); the client removes it. */
+export const SEED_ATTRIBUTE = 'data-gyral-seed';
+/** Marks a server-rendered light-DOM host (ADR 0014), so hydration knows its own content. */
+export const LIGHT_ATTRIBUTE = 'data-gyral-light';
+/** A deferred island's strategy (07 "Islands"), next to `defer-hydration`. */
+export const ISLAND_ATTRIBUTE = 'data-gyral-hydrate';
+/**
+ * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view
+ * (or nothing) and no seed, and the client starts it fresh instead of hydrating.
+ */
+export const ERROR_ATTRIBUTE = 'data-gyral-error';
+//# sourceMappingURL=attributes.js.map

package/dist/view/attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attributes.js","sourceRoot":"","sources":["../../src/view/attributes.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,iEAAiE;AACjE,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;AAClD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC","sourcesContent":["// Host attributes the server renderer writes (view/06-server.md \"Components\") and the client\n// reads (07). Core's hydration.ts, light-dom.ts and islands.ts declare the same names for the\n// client; server-components.node.test.ts checks that they match.\n/** Host attribute holding a component's JSON seed (ADR 0012); the client removes it. */\nexport const SEED_ATTRIBUTE = 'data-gyral-seed';\n/** Marks a server-rendered light-DOM host (ADR 0014), so hydration knows its own content. */\nexport const LIGHT_ATTRIBUTE = 'data-gyral-light';\n/** A deferred island's strategy (07 \"Islands\"), next to `defer-hydration`. */\nexport const ISLAND_ATTRIBUTE = 'data-gyral-hydrate';\n/**\n * Marks a host whose `init` or view threw on the server (ADR 0024): it carries its error view\n * (or nothing) and no seed, and the client starts it fresh instead of hydrating.\n */\nexport const ERROR_ATTRIBUTE = 'data-gyral-error';\n"]}

package/dist/view/compiled.d.ts

@@ -0,0 +1 @@
+export { compiled, compiledSvg } from './template.js';

package/dist/view/compiled.js

@@ -0,0 +1,6 @@
+// `@gyral/core/compiled`: the entry the Vite template compiler's output imports `compiled`
+// from (view/01-templates.md "Compiled"). Internal: apps never import it themselves, and it is
+// not documented as API. A subpath of its own, so the main entry's API stays as documented
+// and compiled code still shares the one template module with `html` (same package copy).
+export { compiled, compiledSvg } from './template.js';
+//# sourceMappingURL=compiled.js.map

package/dist/view/compiled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled.js","sourceRoot":"","sources":["../../src/view/compiled.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,+FAA+F;AAC/F,2FAA2F;AAC3F,0FAA0F;AAC1F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// `@gyral/core/compiled`: the entry the Vite template compiler's output imports `compiled`\n// from (view/01-templates.md \"Compiled\"). Internal: apps never import it themselves, and it is\n// not documented as API. A subpath of its own, so the main entry's API stays as documented\n// and compiled code still shares the one template module with `html` (same package copy).\nexport { compiled, compiledSvg } from './template.js';\n"]}

package/dist/view/dev-off.d.ts

@@ -0,0 +1 @@
+export declare const DEV: boolean;

package/dist/view/dev-off.js

@@ -0,0 +1,4 @@
+// Production build of the view layer's flag (`#view-dev` without the `development` condition):
+// a literal `false`, so bundlers drop every `if (DEV)` check and warning. See dev.ts.
+export const DEV = false;
+//# sourceMappingURL=dev-off.js.map

package/dist/view/dev-off.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-off.js","sourceRoot":"","sources":["../../src/view/dev-off.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,sFAAsF;AACtF,MAAM,CAAC,MAAM,GAAG,GAAY,KAAK,CAAC","sourcesContent":["// Production build of the view layer's flag (`#view-dev` without the `development` condition):\n// a literal `false`, so bundlers drop every `if (DEV)` check and warning. See dev.ts.\nexport const DEV: boolean = false;\n"]}

package/dist/view/dev.d.ts

@@ -0,0 +1 @@
+export declare const DEV: boolean;

package/dist/view/dev.js

@@ -0,0 +1,5 @@
+// Development build of the view layer's flag, resolved through core's `#view-dev` import with
+// the `development` condition (view/09-template-rules.md "One rule set, three places"). Checks
+// and warnings are guarded with `if (DEV)`; production builds get dev-off.ts, so they vanish.
+export const DEV = true;
+//# sourceMappingURL=dev.js.map

package/dist/view/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/view/dev.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,8FAA8F;AAC9F,MAAM,CAAC,MAAM,GAAG,GAAY,IAAI,CAAC","sourcesContent":["// Development build of the view layer's flag, resolved through core's `#view-dev` import with\n// the `development` condition (view/09-template-rules.md \"One rule set, three places\"). Checks\n// and warnings are guarded with `if (DEV)`; production builds get dev-off.ts, so they vanish.\nexport const DEV: boolean = true;\n"]}

package/dist/view/flags.d.ts

@@ -0,0 +1 @@
+export { DEV } from '#view-dev';

package/dist/view/flags.js

@@ -0,0 +1,4 @@
+// The development flag for view/ modules that may not use `#` imports themselves (view/server/,
+// ADR 0018 "Where it lives"): core's `#view-dev`, resolved by the `development` condition.
+export { DEV } from '#view-dev';
+//# sourceMappingURL=flags.js.map

package/dist/view/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../src/view/flags.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,2FAA2F;AAC3F,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC","sourcesContent":["// The development flag for view/ modules that may not use `#` imports themselves (view/server/,\n// ADR 0018 \"Where it lives\"): core's `#view-dev`, resolved by the `development` condition.\nexport { DEV } from '#view-dev';\n"]}

package/dist/view/index.d.ts

@@ -0,0 +1,26 @@
+export { DEV } from '#view-dev';
+export { codeName, docsLink, message, type MessageCode } from './message.js';
+export { html, svg, compiled, compiledSvg, isTemplateResult, templateOf, type TemplateResult, } from './template.js';
+export { templateElement } from './template-element.js';
+export { normalize, analyze, type Analysis } from './normalize/normalize.js';
+export { checkTemplate, type TemplateIssue } from './normalize/check.js';
+export { templateId } from './normalize/id.js';
+export { TemplateError } from './normalize/errors.js';
+export { shapeMismatch, repairError } from './normalize/shape.js';
+export type { NormalizedTemplate, PartSpec, Path, Segment, Shape, ShapeNode, TemplateObject, } from './normalize/types.js';
+export { hydrate } from './render/hydrate.js';
+export { render, renderBatch } from './render/render.js';
+export type { Markup, SeenMarkup } from './render/seen.js';
+export { HydrationMismatch } from './render/mismatch.js';
+export { each } from './render/list.js';
+export { keyed } from './render/keyed.js';
+export { raw } from './render/raw.js';
+export { nothing, type ChildValue, type ListResult, type RawResult } from './render/values.js';
+export { defineHook } from './render/hook-part.js';
+export { useToggles } from './render/toggles.js';
+export { applyToggle } from './render/modal.js';
+export { commitTracked } from './render/dispose.js';
+export { flushHooks, onHookFailure, suspendHooks, useDisposableHooks, type HookAttributes, type HookResult, type HookSpec, } from './render/hooks.js';
+export { css, isStyleSource, sheetsFor, styleTexts, type CssValue, type StyleSource, type Styles, } from './styles.js';
+export { ERROR_ATTRIBUTE, ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE, } from './attributes.js';
+export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, serverRegistryVersion, type ServerComponent, type ServerProvider, type ServerRenderInput, type ServerRendering, } from './registry.js';

package/dist/view/index.js

@@ -0,0 +1,27 @@
+// The view layer's entry point for the rest of core (ADR 0018 "Where it lives"): code outside
+// view/ imports only this module. @gyral/core's index re-exports the public part of it.
+export { DEV } from '#view-dev';
+export { codeName, docsLink, message } from './message.js';
+export { html, svg, compiled, compiledSvg, isTemplateResult, templateOf, } from './template.js';
+export { templateElement } from './template-element.js';
+export { normalize, analyze } from './normalize/normalize.js';
+export { checkTemplate } from './normalize/check.js';
+export { templateId } from './normalize/id.js';
+export { TemplateError } from './normalize/errors.js';
+export { shapeMismatch, repairError } from './normalize/shape.js';
+export { hydrate } from './render/hydrate.js';
+export { render, renderBatch } from './render/render.js';
+export { HydrationMismatch } from './render/mismatch.js';
+export { each } from './render/list.js';
+export { keyed } from './render/keyed.js';
+export { raw } from './render/raw.js';
+export { nothing } from './render/values.js';
+export { defineHook } from './render/hook-part.js';
+export { useToggles } from './render/toggles.js';
+export { applyToggle } from './render/modal.js';
+export { commitTracked } from './render/dispose.js';
+export { flushHooks, onHookFailure, suspendHooks, useDisposableHooks, } from './render/hooks.js';
+export { css, isStyleSource, sheetsFor, styleTexts, } from './styles.js';
+export { ERROR_ATTRIBUTE, ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE, } from './attributes.js';
+export { registerServerComponent, registerServerProvider, serverComponent, serverComponents, serverProvider, serverRegistryVersion, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/view/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wFAAwF;AACxF,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAoB,MAAM,cAAc,CAAC;AAC7E,OAAO,EACL,IAAI,EACJ,GAAG,EACH,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,UAAU,GAEX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAiB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAWlE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAoD,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,GAInB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,GAAG,EACH,aAAa,EACb,SAAS,EACT,UAAU,GAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,GAKtB,MAAM,eAAe,CAAC","sourcesContent":["// The view layer's entry point for the rest of core (ADR 0018 \"Where it lives\"): code outside\n// view/ imports only this module. @gyral/core's index re-exports the public part of it.\nexport { DEV } from '#view-dev';\nexport { codeName, docsLink, message, type MessageCode } from './message.js';\nexport {\n  html,\n  svg,\n  compiled,\n  compiledSvg,\n  isTemplateResult,\n  templateOf,\n  type TemplateResult,\n} from './template.js';\nexport { templateElement } from './template-element.js';\nexport { normalize, analyze, type Analysis } from './normalize/normalize.js';\nexport { checkTemplate, type TemplateIssue } from './normalize/check.js';\nexport { templateId } from './normalize/id.js';\nexport { TemplateError } from './normalize/errors.js';\nexport { shapeMismatch, repairError } from './normalize/shape.js';\nexport type {\n  NormalizedTemplate,\n  PartSpec,\n  Path,\n  Segment,\n  Shape,\n  ShapeNode,\n  TemplateObject,\n} from './normalize/types.js';\n\nexport { hydrate } from './render/hydrate.js';\nexport { render, renderBatch } from './render/render.js';\nexport type { Markup, SeenMarkup } from './render/seen.js';\nexport { HydrationMismatch } from './render/mismatch.js';\nexport { each } from './render/list.js';\nexport { keyed } from './render/keyed.js';\nexport { raw } from './render/raw.js';\nexport { nothing, type ChildValue, type ListResult, type RawResult } from './render/values.js';\nexport { defineHook } from './render/hook-part.js';\nexport { useToggles } from './render/toggles.js';\nexport { applyToggle } from './render/modal.js';\nexport { commitTracked } from './render/dispose.js';\nexport {\n  flushHooks,\n  onHookFailure,\n  suspendHooks,\n  useDisposableHooks,\n  type HookAttributes,\n  type HookResult,\n  type HookSpec,\n} from './render/hooks.js';\nexport {\n  css,\n  isStyleSource,\n  sheetsFor,\n  styleTexts,\n  type CssValue,\n  type StyleSource,\n  type Styles,\n} from './styles.js';\nexport {\n  ERROR_ATTRIBUTE,\n  ISLAND_ATTRIBUTE,\n  LIGHT_ATTRIBUTE,\n  SEED_ATTRIBUTE,\n} from './attributes.js';\nexport {\n  registerServerComponent,\n  registerServerProvider,\n  serverComponent,\n  serverComponents,\n  serverProvider,\n  serverRegistryVersion,\n  type ServerComponent,\n  type ServerProvider,\n  type ServerRenderInput,\n  type ServerRendering,\n} from './registry.js';\n"]}

package/dist/view/loc.d.ts

@@ -0,0 +1,9 @@
+/** The call site recorded for a template's strings. */
+export declare const locOf: (strings: readonly string[]) => string | undefined;
+/** Records `loc` for `strings` unless one is known. */
+export declare function setLoc(strings: readonly string[], loc: string | undefined): void;
+/**
+ * `path:line:col` of the frame that called the function which created `stack` (the second
+ * frame: the first is that function itself), or undefined when the stack has none.
+ */
+export declare function callSite(stack: string | undefined): string | undefined;

package/dist/view/loc.js

@@ -0,0 +1,50 @@
+// Development: where each runtime template was written (view/01-templates.md "Source
+// locations", gyral-g1r.24), so TemplateError and HydrationMismatch can name `file:line:col`.
+// Recorded once per call site (strings array): by the Vite preset's development transform
+// (`html.at(loc)`, exact source positions), or else from a stack trace at the first `html`
+// call. Stack positions are those of the code the browser runs: exact without a build step,
+// shifted by any transform that doesn't keep lines. Only reached from `if (DEV)` code, so
+// production bundles leave this module out.
+const locs = new WeakMap();
+/** The call site recorded for a template's strings. */
+export const locOf = (strings) => locs.get(strings);
+/** Records `loc` for `strings` unless one is known. */
+export function setLoc(strings, loc) {
+    if (loc !== undefined && !locs.has(strings))
+        locs.set(strings, loc);
+}
+/** A frame's position: `url:line:col`. */
+const POSITION = /^(.+):(\d+):(\d+)$/;
+/** The `url:line:col` of a stack line: V8 `at f (…)` / `at …`, Firefox and Safari `f@…`. */
+function frameOf(line) {
+    const text = line.trim();
+    if (text.startsWith('at ')) {
+        const rest = text.slice(3);
+        const open = rest.lastIndexOf('(');
+        return rest.endsWith(')') && open !== -1 ? rest.slice(open + 1, -1) : rest;
+    }
+    const at = text.indexOf('@');
+    return at === -1 ? undefined : text.slice(at + 1);
+}
+/** A frame's URL as a path: no scheme and host, query, hash, or Vite's `/@fs` prefix. */
+const pathOf = (url) => url
+    .replace(/[?#].*$/, '')
+    .replace(/^[a-z][\w+.-]*:\/\/[^/]*/i, '')
+    .replace(/^\/@fs\//, '/');
+/**
+ * `path:line:col` of the frame that called the function which created `stack` (the second
+ * frame: the first is that function itself), or undefined when the stack has none.
+ */
+export function callSite(stack) {
+    let seen = 0;
+    for (const line of (stack ?? '').split('\n')) {
+        const m = POSITION.exec(frameOf(line) ?? '');
+        if (m === null)
+            continue;
+        if (seen++ === 0)
+            continue;
+        return `${pathOf(m[1] ?? '')}:${m[2] ?? ''}:${m[3] ?? ''}`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=loc.js.map

package/dist/view/loc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loc.js","sourceRoot":"","sources":["../../src/view/loc.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,8FAA8F;AAC9F,0FAA0F;AAC1F,2FAA2F;AAC3F,4FAA4F;AAC5F,0FAA0F;AAC1F,4CAA4C;AAE5C,MAAM,IAAI,GAAG,IAAI,OAAO,EAA6B,CAAC;AAEtD,uDAAuD;AACvD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAA0B,EAAsB,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAE3F,uDAAuD;AACvD,MAAM,UAAU,MAAM,CAAC,OAA0B,EAAE,GAAuB;IACxE,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACtE,CAAC;AAED,0CAA0C;AAC1C,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAEtC,4FAA4F;AAC5F,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,yFAAyF;AACzF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE,CACrC,GAAG;KACA,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;KACtB,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;KACxC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAE9B;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAyB;IAChD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QACzB,IAAI,IAAI,EAAE,KAAK,CAAC;YAAE,SAAS;QAC3B,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["// Development: where each runtime template was written (view/01-templates.md \"Source\n// locations\", gyral-g1r.24), so TemplateError and HydrationMismatch can name `file:line:col`.\n// Recorded once per call site (strings array): by the Vite preset's development transform\n// (`html.at(loc)`, exact source positions), or else from a stack trace at the first `html`\n// call. Stack positions are those of the code the browser runs: exact without a build step,\n// shifted by any transform that doesn't keep lines. Only reached from `if (DEV)` code, so\n// production bundles leave this module out.\n\nconst locs = new WeakMap<readonly string[], string>();\n\n/** The call site recorded for a template's strings. */\nexport const locOf = (strings: readonly string[]): string | undefined => locs.get(strings);\n\n/** Records `loc` for `strings` unless one is known. */\nexport function setLoc(strings: readonly string[], loc: string | undefined): void {\n  if (loc !== undefined && !locs.has(strings)) locs.set(strings, loc);\n}\n\n/** A frame's position: `url:line:col`. */\nconst POSITION = /^(.+):(\\d+):(\\d+)$/;\n\n/** The `url:line:col` of a stack line: V8 `at f (…)` / `at …`, Firefox and Safari `f@…`. */\nfunction frameOf(line: string): string | undefined {\n  const text = line.trim();\n  if (text.startsWith('at ')) {\n    const rest = text.slice(3);\n    const open = rest.lastIndexOf('(');\n    return rest.endsWith(')') && open !== -1 ? rest.slice(open + 1, -1) : rest;\n  }\n  const at = text.indexOf('@');\n  return at === -1 ? undefined : text.slice(at + 1);\n}\n\n/** A frame's URL as a path: no scheme and host, query, hash, or Vite's `/@fs` prefix. */\nconst pathOf = (url: string): string =>\n  url\n    .replace(/[?#].*$/, '')\n    .replace(/^[a-z][\\w+.-]*:\\/\\/[^/]*/i, '')\n    .replace(/^\\/@fs\\//, '/');\n\n/**\n * `path:line:col` of the frame that called the function which created `stack` (the second\n * frame: the first is that function itself), or undefined when the stack has none.\n */\nexport function callSite(stack: string | undefined): string | undefined {\n  let seen = 0;\n  for (const line of (stack ?? '').split('\\n')) {\n    const m = POSITION.exec(frameOf(line) ?? '');\n    if (m === null) continue;\n    if (seen++ === 0) continue;\n    return `${pathOf(m[1] ?? '')}:${m[2] ?? ''}:${m[3] ?? ''}`;\n  }\n  return undefined;\n}\n"]}

package/dist/view/message.d.ts

@@ -0,0 +1,17 @@
+import { MESSAGES } from './messages.js';
+/** A diagnostic's code (messages.ts). */
+export type MessageCode = keyof typeof MESSAGES;
+/** Where production messages point: the docs page generated from messages.ts. */
+export declare const ERRORS_URL = "https://gyral.dev/errors/#";
+/** `G0010` for code 10. */
+export declare const codeName: (code: number) => string;
+/**
+ * `Gyral G0062 https://gyral.dev/errors/#G0062`, for a message that keeps a sentence of its own
+ * in production (a hydration mismatch names the node in words) and points to the docs there.
+ */
+export declare const docsLink: (code: MessageCode) => string;
+/**
+ * The text of diagnostic `code` with its arguments: in development the full message, in
+ * production `Gyral G0010 <args…> https://gyral.dev/errors/#G0010`.
+ */
+export declare function message(code: MessageCode, ...args: readonly unknown[]): string;

package/dist/view/message.js

@@ -0,0 +1,40 @@
+// Diagnostic text (gyral-c5d.13): the full message in development, a code and the docs URL in
+// production, so production bundles carry no message table. Every error and warning core can
+// raise in production goes through `message()` (or, for a hydration mismatch, which keeps its
+// sentence, `docsLink()`); development-only checks keep their own text behind `DEV`. The codes
+// and texts are in messages.ts.
+import { DEV } from '#view-dev';
+import { MESSAGES } from './messages.js';
+/** Where production messages point: the docs page generated from messages.ts. */
+export const ERRORS_URL = 'https://gyral.dev/errors/#';
+/** `G0010` for code 10. */
+export const codeName = (code) => `G${String(code).padStart(4, '0')}`;
+/** Development: the table's text with `args` in its placeholders. */
+function fullText(code, args) {
+    const names = [];
+    return MESSAGES[code].replace(/\{(\w+)\}/g, (_, name) => {
+        let at = names.indexOf(name);
+        if (at < 0)
+            at = names.push(name) - 1;
+        return String(args[at]);
+    });
+}
+/**
+ * `Gyral G0062 https://gyral.dev/errors/#G0062`, for a message that keeps a sentence of its own
+ * in production (a hydration mismatch names the node in words) and points to the docs there.
+ */
+export const docsLink = (code) => {
+    const id = codeName(code);
+    return `Gyral ${id} ${ERRORS_URL}${id}`;
+};
+/**
+ * The text of diagnostic `code` with its arguments: in development the full message, in
+ * production `Gyral G0010 <args…> https://gyral.dev/errors/#G0010`.
+ */
+export function message(code, ...args) {
+    if (DEV)
+        return fullText(code, args);
+    const id = codeName(code);
+    return [`Gyral ${id}`, ...args, ERRORS_URL + id].join(' ');
+}
+//# sourceMappingURL=message.js.map

package/dist/view/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/view/message.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,6FAA6F;AAC7F,8FAA8F;AAC9F,+FAA+F;AAC/F,gCAAgC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEvD,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAEtF,qEAAqE;AACrE,SAAS,QAAQ,CAAC,IAAiB,EAAE,IAAwB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QAC9D,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,EAAE,GAAG,CAAC;YAAE,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAiB,EAAU,EAAE;IACpD,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,SAAS,EAAE,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;AAC1C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAiB,EAAE,GAAG,IAAwB;IACpE,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["// Diagnostic text (gyral-c5d.13): the full message in development, a code and the docs URL in\n// production, so production bundles carry no message table. Every error and warning core can\n// raise in production goes through `message()` (or, for a hydration mismatch, which keeps its\n// sentence, `docsLink()`); development-only checks keep their own text behind `DEV`. The codes\n// and texts are in messages.ts.\nimport { DEV } from '#view-dev';\nimport { MESSAGES } from './messages.js';\n\n/** A diagnostic's code (messages.ts). */\nexport type MessageCode = keyof typeof MESSAGES;\n\n/** Where production messages point: the docs page generated from messages.ts. */\nexport const ERRORS_URL = 'https://gyral.dev/errors/#';\n\n/** `G0010` for code 10. */\nexport const codeName = (code: number): string => `G${String(code).padStart(4, '0')}`;\n\n/** Development: the table's text with `args` in its placeholders. */\nfunction fullText(code: MessageCode, args: readonly unknown[]): string {\n  const names: string[] = [];\n  return MESSAGES[code].replace(/\\{(\\w+)\\}/g, (_, name: string) => {\n    let at = names.indexOf(name);\n    if (at < 0) at = names.push(name) - 1;\n    return String(args[at]);\n  });\n}\n\n/**\n * `Gyral G0062 https://gyral.dev/errors/#G0062`, for a message that keeps a sentence of its own\n * in production (a hydration mismatch names the node in words) and points to the docs there.\n */\nexport const docsLink = (code: MessageCode): string => {\n  const id = codeName(code);\n  return `Gyral ${id} ${ERRORS_URL}${id}`;\n};\n\n/**\n * The text of diagnostic `code` with its arguments: in development the full message, in\n * production `Gyral G0010 <args…> https://gyral.dev/errors/#G0010`.\n */\nexport function message(code: MessageCode, ...args: readonly unknown[]): string {\n  if (DEV) return fullText(code, args);\n  const id = codeName(code);\n  return [`Gyral ${id}`, ...args, ERRORS_URL + id].join(' ');\n}\n"]}

package/dist/view/messages.d.ts

@@ -0,0 +1,43 @@
+export declare const MESSAGES: {
+    readonly 1: "<{tag}> is a browser element (render it on the server with @gyral/ssr).";
+    readonly 10: "<{tag}> has no update for message \"{message}\".";
+    readonly 11: "<{tag}> has no intent parser for data-intent=\"{intent}\".";
+    readonly 12: "<{tag}> intent parser for \"{intent}\" failed";
+    readonly 13: "<{tag}> focus(\"{selector}\") matched no focusable element.";
+    readonly 20: "<{tag}> prop \"{prop}\" has an asynchronous schema; it must be synchronous.";
+    readonly 21: "<{tag}> prop \"{prop}\" got an invalid value from {source}, so it is treated as missing: {issues}";
+    readonly 22: "<{tag}> is missing required prop(s): {props}.";
+    readonly 23: string;
+    readonly 30: "gyral: a deferred callback failed";
+    readonly 31: "<{tag}> view failed; it shows its error view, or its previous DOM stays.";
+    readonly 32: "gyral: post-render work failed";
+    readonly 33: string;
+    readonly 34: string;
+    readonly 40: "{owner}: the onSuccess or onFailure mapper for driver \"{driver}\" threw; no message was sent.";
+    readonly 41: "{owner}: driver \"{driver}\" failed and the command has no onFailure.";
+    readonly 42: "gyral: subscription \"{name}\" failed to unsubscribe";
+    readonly 43: string;
+    readonly 50: string;
+    readonly 51: "store \"{store}\": the server's seed failed its schema, so it starts from init. Issues: {issues}";
+    readonly 52: "unreadable {attribute} seed on {where}";
+    readonly 53: string;
+    readonly 54: string;
+    readonly 55: "store \"{store}\" has no update for message \"{message}\".";
+    readonly 60: "<{tag}> has an unreadable {attribute}";
+    readonly 61: "gyral: hydration code failed to load; rendering fresh";
+    readonly 62: string;
+    readonly 63: "<{tag}> was rendered fresh after a hydration mismatch:";
+    readonly 70: string;
+    readonly 71: "gyral: template rule 11: a page shell rendered in the browser.";
+    readonly 72: string;
+    readonly 73: "<{tag}> update for \"{message}\" failed; the state is unchanged.";
+    readonly 74: "<{tag}> init failed; it shows its error view, or stays empty.";
+    readonly 75: "<{tag}> element hook failed; the other hooks still ran.";
+    readonly 76: "store \"{store}\": update for \"{message}\" failed; the state is unchanged.";
+    readonly 77: "store \"{store}\": a subscriber failed; the other subscribers were still notified.";
+    readonly 78: string;
+    readonly 79: string;
+    readonly 80: string;
+    readonly 85: "<{tag}> call(\"{selector}\", \"{method}\") failed";
+    readonly 86: "call(\"{selector}\", \"{method}\"): arguments must be plain data.";
+};

package/dist/view/messages.js

@@ -0,0 +1,84 @@
+// Core's diagnostics, by code (gyral-c5d.13, docs/references/errors.md). Development
+// builds print the full text, production builds `Gyral G0010 <arguments…> <docs URL>`
+// (message.ts), so this table stays out of production bundles. `{name}` placeholders take the
+// call's arguments in order of first appearance; a name used twice repeats its argument.
+// docs/references/errors.md and errors.json are generated from this table (`node
+// scripts/errors.mjs`); `pnpm invariants` checks that they are current, that codes are unique
+// and that every `message(code, …)` call names a code here with as many arguments as its text
+// has placeholders (`docsLink(code)` marks a message that keeps its own sentence in
+// production). Codes are never reused: a retired message keeps its code out of use.
+// Plain data, no TypeScript beyond `as const`, so Node scripts import it as is.
+export const MESSAGES = {
+    // Components
+    1: '<{tag}> is a browser element (render it on the server with @gyral/ssr).',
+    10: '<{tag}> has no update for message "{message}".',
+    11: '<{tag}> has no intent parser for data-intent="{intent}".',
+    12: '<{tag}> intent parser for "{intent}" failed',
+    13: '<{tag}> focus("{selector}") matched no focusable element.',
+    // Props
+    20: '<{tag}> prop "{prop}" has an asynchronous schema; it must be synchronous.',
+    21: '<{tag}> prop "{prop}" got an invalid value from {source}, so it is treated as missing: {issues}',
+    22: '<{tag}> is missing required prop(s): {props}.',
+    23: '<{tag}> declares prop(s) that shadow built-in element properties: {props}. Setting them ' +
+        'changes platform behaviour (a prop named "hidden" hides the element). Rename them ' +
+        '(view/05-element.md).',
+    // Scheduling
+    30: 'gyral: a deferred callback failed',
+    31: '<{tag}> view failed; it shows its error view, or its previous DOM stays.',
+    32: 'gyral: post-render work failed',
+    33: 'gyral: rendering did not settle in one flush (a cycle between {tags}). Components are ' +
+        'probably feeding each other props or messages; break the cycle with a condition in update ' +
+        '(docs/design-docs/view/04-scheduler.md "Loop guard").',
+    34: 'settled(): the page did not settle after {rounds} flushes or busy turns. A stream is ' +
+        'emitting without pause, or components (or drivers) are feeding each other messages in a ' +
+        'cycle.',
+    // Commands
+    40: '{owner}: the onSuccess or onFailure mapper for driver "{driver}" threw; no message was sent.',
+    41: '{owner}: driver "{driver}" failed and the command has no onFailure.',
+    42: 'gyral: subscription "{name}" failed to unsubscribe',
+    43: '{owner}: no driver provides "{driver}". It is a driver token: provide an implementation ' +
+        'by name with provideDrivers(root, { {driver}: … }) or el.drivers (ADR 0006 "Driver tokens").',
+    // Stores
+    50: '<{tag}> uses store "{store}" without declaring it. Add it to the spec: stores: [{store}] ' +
+        '(ADR 0013), so the component subscribes to its changes.',
+    51: 'store "{store}": the server\'s seed failed its schema, so it starts from init. Issues: {issues}',
+    52: 'unreadable {attribute} seed on {where}',
+    53: '<{tag}> reads store "{store}" during a server render without a store scope. Pass the ' +
+        "request's store instances to renderPage({ stores }) or renderToString(value, { stores }).",
+    54: 'store "{store}" sends to "{target}" but is not held by a store scope (a registry, ' +
+        '<gyral-stores> or the page default), so the message is dropped.',
+    55: 'store "{store}" has no update for message "{message}".',
+    // Hydration
+    60: '<{tag}> has an unreadable {attribute}',
+    61: 'gyral: hydration code failed to load; rendering fresh',
+    62: "gyral: hydration mismatch in {host} at {path}: expected {expected}, found {found}. The server's " +
+        "HTML differs from the first client render: a view that isn't deterministic (Date.now(), " +
+        'locale), a third party that changed the DOM before scripts ran, or a stale cached page ' +
+        '(docs/design-docs/view/07-hydration.md "Mismatches").',
+    63: '<{tag}> was rendered fresh after a hydration mismatch:',
+    // Templates
+    70: 'gyral: an html template was not compiled: `{start}`. Under the gyral-compiled condition ' +
+        'every html`…` must be compiled by the Gyral Vite preset (view/01-templates.md).',
+    71: 'gyral: template rule 11: a page shell rendered in the browser.',
+    72: 'gyral: this page\'s Trusted Types policy list does not allow the policy "gyral", so ' +
+        'templates are parsed from plain strings, which works only while Trusted Types are not ' +
+        'enforced. Add `trusted-types gyral` to the Content-Security-Policy.',
+    // Errors (ADR 0024)
+    73: '<{tag}> update for "{message}" failed; the state is unchanged.',
+    74: '<{tag}> init failed; it shows its error view, or stays empty.',
+    75: '<{tag}> element hook failed; the other hooks still ran.',
+    76: 'store "{store}": update for "{message}" failed; the state is unchanged.',
+    77: 'store "{store}": a subscriber failed; the other subscribers were still notified.',
+    78: '<{tag}> failed to render on the server; it renders its error view (or nothing) and ' +
+        'starts fresh in the browser.',
+    // Subscriptions (ADR 0025)
+    79: '<{tag}> subscriptions returned two commands for lane "{lane}"; only the first runs. ' +
+        'Give each its own `key`.',
+    80: "<{tag}> subscriptions kept restarting: a subscription's input data changes with every " +
+        'message it sends (for example a timestamp or a counter in the input). Keep inputs to what ' +
+        'should restart it; functions are ignored, so to restart on a new selector, change the key.',
+    // Element calls (gyral-1zd.27)
+    85: '<{tag}> call("{selector}", "{method}") failed',
+    86: 'call("{selector}", "{method}"): arguments must be plain data.',
+};
+//# sourceMappingURL=messages.js.map

package/dist/view/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/view/messages.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,sFAAsF;AACtF,8FAA8F;AAC9F,yFAAyF;AACzF,iFAAiF;AACjF,8FAA8F;AAC9F,8FAA8F;AAC9F,oFAAoF;AACpF,oFAAoF;AACpF,gFAAgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,aAAa;IACb,CAAC,EAAE,yEAAyE;IAC5E,EAAE,EAAE,gDAAgD;IACpD,EAAE,EAAE,0DAA0D;IAC9D,EAAE,EAAE,6CAA6C;IACjD,EAAE,EAAE,2DAA2D;IAC/D,QAAQ;IACR,EAAE,EAAE,2EAA2E;IAC/E,EAAE,EAAE,iGAAiG;IACrG,EAAE,EAAE,+CAA+C;IACnD,EAAE,EACA,0FAA0F;QAC1F,oFAAoF;QACpF,uBAAuB;IACzB,aAAa;IACb,EAAE,EAAE,mCAAmC;IACvC,EAAE,EAAE,0EAA0E;IAC9E,EAAE,EAAE,gCAAgC;IACpC,EAAE,EACA,wFAAwF;QACxF,4FAA4F;QAC5F,uDAAuD;IACzD,EAAE,EACA,uFAAuF;QACvF,0FAA0F;QAC1F,QAAQ;IACV,WAAW;IACX,EAAE,EAAE,8FAA8F;IAClG,EAAE,EAAE,qEAAqE;IACzE,EAAE,EAAE,oDAAoD;IACxD,EAAE,EACA,0FAA0F;QAC1F,8FAA8F;IAChG,SAAS;IACT,EAAE,EACA,2FAA2F;QAC3F,yDAAyD;IAC3D,EAAE,EAAE,iGAAiG;IACrG,EAAE,EAAE,wCAAwC;IAC5C,EAAE,EACA,uFAAuF;QACvF,2FAA2F;IAC7F,EAAE,EACA,oFAAoF;QACpF,iEAAiE;IACnE,EAAE,EAAE,wDAAwD;IAC5D,YAAY;IACZ,EAAE,EAAE,uCAAuC;IAC3C,EAAE,EAAE,uDAAuD;IAC3D,EAAE,EACA,kGAAkG;QAClG,0FAA0F;QAC1F,yFAAyF;QACzF,uDAAuD;IACzD,EAAE,EAAE,wDAAwD;IAC5D,YAAY;IACZ,EAAE,EACA,0FAA0F;QAC1F,iFAAiF;IACnF,EAAE,EAAE,gEAAgE;IACpE,EAAE,EACA,sFAAsF;QACtF,wFAAwF;QACxF,qEAAqE;IACvE,oBAAoB;IACpB,EAAE,EAAE,gEAAgE;IACpE,EAAE,EAAE,+DAA+D;IACnE,EAAE,EAAE,yDAAyD;IAC7D,EAAE,EAAE,yEAAyE;IAC7E,EAAE,EAAE,kFAAkF;IACtF,EAAE,EACA,qFAAqF;QACrF,8BAA8B;IAChC,2BAA2B;IAC3B,EAAE,EACA,sFAAsF;QACtF,0BAA0B;IAC5B,EAAE,EACA,wFAAwF;QACxF,4FAA4F;QAC5F,4FAA4F;IAC9F,+BAA+B;IAC/B,EAAE,EAAE,+CAA+C;IACnD,EAAE,EAAE,+DAA+D;CAC3D,CAAC","sourcesContent":["// Core's diagnostics, by code (gyral-c5d.13, docs/references/errors.md). Development\n// builds print the full text, production builds `Gyral G0010 <arguments…> <docs URL>`\n// (message.ts), so this table stays out of production bundles. `{name}` placeholders take the\n// call's arguments in order of first appearance; a name used twice repeats its argument.\n// docs/references/errors.md and errors.json are generated from this table (`node\n// scripts/errors.mjs`); `pnpm invariants` checks that they are current, that codes are unique\n// and that every `message(code, …)` call names a code here with as many arguments as its text\n// has placeholders (`docsLink(code)` marks a message that keeps its own sentence in\n// production). Codes are never reused: a retired message keeps its code out of use.\n// Plain data, no TypeScript beyond `as const`, so Node scripts import it as is.\nexport const MESSAGES = {\n  // Components\n  1: '<{tag}> is a browser element (render it on the server with @gyral/ssr).',\n  10: '<{tag}> has no update for message \"{message}\".',\n  11: '<{tag}> has no intent parser for data-intent=\"{intent}\".',\n  12: '<{tag}> intent parser for \"{intent}\" failed',\n  13: '<{tag}> focus(\"{selector}\") matched no focusable element.',\n  // Props\n  20: '<{tag}> prop \"{prop}\" has an asynchronous schema; it must be synchronous.',\n  21: '<{tag}> prop \"{prop}\" got an invalid value from {source}, so it is treated as missing: {issues}',\n  22: '<{tag}> is missing required prop(s): {props}.',\n  23:\n    '<{tag}> declares prop(s) that shadow built-in element properties: {props}. Setting them ' +\n    'changes platform behaviour (a prop named \"hidden\" hides the element). Rename them ' +\n    '(view/05-element.md).',\n  // Scheduling\n  30: 'gyral: a deferred callback failed',\n  31: '<{tag}> view failed; it shows its error view, or its previous DOM stays.',\n  32: 'gyral: post-render work failed',\n  33:\n    'gyral: rendering did not settle in one flush (a cycle between {tags}). Components are ' +\n    'probably feeding each other props or messages; break the cycle with a condition in update ' +\n    '(docs/design-docs/view/04-scheduler.md \"Loop guard\").',\n  34:\n    'settled(): the page did not settle after {rounds} flushes or busy turns. A stream is ' +\n    'emitting without pause, or components (or drivers) are feeding each other messages in a ' +\n    'cycle.',\n  // Commands\n  40: '{owner}: the onSuccess or onFailure mapper for driver \"{driver}\" threw; no message was sent.',\n  41: '{owner}: driver \"{driver}\" failed and the command has no onFailure.',\n  42: 'gyral: subscription \"{name}\" failed to unsubscribe',\n  43:\n    '{owner}: no driver provides \"{driver}\". It is a driver token: provide an implementation ' +\n    'by name with provideDrivers(root, { {driver}: … }) or el.drivers (ADR 0006 \"Driver tokens\").',\n  // Stores\n  50:\n    '<{tag}> uses store \"{store}\" without declaring it. Add it to the spec: stores: [{store}] ' +\n    '(ADR 0013), so the component subscribes to its changes.',\n  51: 'store \"{store}\": the server\\'s seed failed its schema, so it starts from init. Issues: {issues}',\n  52: 'unreadable {attribute} seed on {where}',\n  53:\n    '<{tag}> reads store \"{store}\" during a server render without a store scope. Pass the ' +\n    \"request's store instances to renderPage({ stores }) or renderToString(value, { stores }).\",\n  54:\n    'store \"{store}\" sends to \"{target}\" but is not held by a store scope (a registry, ' +\n    '<gyral-stores> or the page default), so the message is dropped.',\n  55: 'store \"{store}\" has no update for message \"{message}\".',\n  // Hydration\n  60: '<{tag}> has an unreadable {attribute}',\n  61: 'gyral: hydration code failed to load; rendering fresh',\n  62:\n    \"gyral: hydration mismatch in {host} at {path}: expected {expected}, found {found}. The server's \" +\n    \"HTML differs from the first client render: a view that isn't deterministic (Date.now(), \" +\n    'locale), a third party that changed the DOM before scripts ran, or a stale cached page ' +\n    '(docs/design-docs/view/07-hydration.md \"Mismatches\").',\n  63: '<{tag}> was rendered fresh after a hydration mismatch:',\n  // Templates\n  70:\n    'gyral: an html template was not compiled: `{start}`. Under the gyral-compiled condition ' +\n    'every html`…` must be compiled by the Gyral Vite preset (view/01-templates.md).',\n  71: 'gyral: template rule 11: a page shell rendered in the browser.',\n  72:\n    'gyral: this page\\'s Trusted Types policy list does not allow the policy \"gyral\", so ' +\n    'templates are parsed from plain strings, which works only while Trusted Types are not ' +\n    'enforced. Add `trusted-types gyral` to the Content-Security-Policy.',\n  // Errors (ADR 0024)\n  73: '<{tag}> update for \"{message}\" failed; the state is unchanged.',\n  74: '<{tag}> init failed; it shows its error view, or stays empty.',\n  75: '<{tag}> element hook failed; the other hooks still ran.',\n  76: 'store \"{store}\": update for \"{message}\" failed; the state is unchanged.',\n  77: 'store \"{store}\": a subscriber failed; the other subscribers were still notified.',\n  78:\n    '<{tag}> failed to render on the server; it renders its error view (or nothing) and ' +\n    'starts fresh in the browser.',\n  // Subscriptions (ADR 0025)\n  79:\n    '<{tag}> subscriptions returned two commands for lane \"{lane}\"; only the first runs. ' +\n    'Give each its own `key`.',\n  80:\n    \"<{tag}> subscriptions kept restarting: a subscription's input data changes with every \" +\n    'message it sends (for example a timestamp or a counter in the input). Keep inputs to what ' +\n    'should restart it; functions are ignored, so to restart on a new selector, change the key.',\n  // Element calls (gyral-1zd.27)\n  85: '<{tag}> call(\"{selector}\", \"{method}\") failed',\n  86: 'call(\"{selector}\", \"{method}\"): arguments must be plain data.',\n} as const;\n"]}

package/dist/view/normalize/check.d.ts

@@ -0,0 +1,23 @@
+import { TemplateError } from './errors.js';
+/** A position in the minified strings: string index, offset in that string. */
+export type At = readonly [index: number, offset: number];
+/** A template's first rule violation, and where the normalizer was when it found it. */
+export interface TemplateIssue {
+    /** The same error `normalize(strings)` throws. */
+    readonly error: TemplateError;
+    /** The whitespace-minified strings the rules read (as many as the input). */
+    readonly strings: readonly string[];
+    /** Where reading stopped. */
+    readonly at: At;
+    /**
+     * Where the token the error is about starts, when the tree builder found it in a tag, an end
+     * tag or a run of text (the token ends at `at`). Undefined when the tokenizer found it at
+     * `at` itself, or at a child hole (then `at` is the end of the string before the hole).
+     */
+    readonly from: At | undefined;
+}
+/**
+ * The template's first rule violation, or undefined when `normalize` would accept it. `svg`: an
+ * svg template's strings (`` svg`…` ``).
+ */
+export declare function checkTemplate(strings: readonly string[], svg?: boolean): TemplateIssue | undefined;

package/dist/view/normalize/check.js

@@ -0,0 +1,81 @@
+// The template rules (view/09-template-rules.md) as a check that reports where it stopped, for
+// tools that point at the markup (the ESLint plugin, @gyral/core/eslint). It runs the same
+// steps as `analyze` (normalize.ts) up to the last one that can fail: minify whitespace, then
+// tokenize and build the tree (emit and the id never throw). Like the compiler and the runtime,
+// it stops at a template's first error: the tokenizer can't recover from one.
+import { TemplateError } from './errors.js';
+import { Source } from './source.js';
+import { tokenize } from './tokenizer.js';
+import { TreeBuilder } from './tree.js';
+import { minifyStrings } from './whitespace.js';
+/** Forwards tokens to the tree builder, remembering where the current token started. */
+class Tracker {
+    constructor(src, tree) {
+        this.src = src;
+        this.tree = tree;
+        this.mark = [0, 0];
+    }
+    /** A token starts at `mark`; an error before `after` is about it (a child hole: the hole). */
+    before(about = true) {
+        this.from = about ? this.mark : undefined;
+    }
+    after() {
+        this.from = undefined;
+        this.mark = [this.src.i, this.src.pos];
+    }
+    text(raw) {
+        this.before();
+        this.tree.text(raw);
+        this.after();
+    }
+    comment(raw) {
+        this.before();
+        this.tree.comment(raw);
+        this.after();
+    }
+    doctype(raw) {
+        this.before();
+        this.tree.doctype(raw);
+        this.after();
+    }
+    start(tag) {
+        this.before();
+        const mode = this.tree.start(tag);
+        this.after();
+        return mode;
+    }
+    end(name) {
+        this.before();
+        this.tree.end(name);
+        this.after();
+    }
+    hole(kind) {
+        this.before(false);
+        this.tree.hole(kind);
+        this.after();
+    }
+    finish() {
+        this.before();
+        this.tree.finish();
+        this.after();
+    }
+}
+/**
+ * The template's first rule violation, or undefined when `normalize` would accept it. `svg`: an
+ * svg template's strings (`` svg`…` ``).
+ */
+export function checkTemplate(strings, svg = false) {
+    const normalized = minifyStrings(strings);
+    const src = new Source(normalized, undefined);
+    const tracker = new Tracker(src, new TreeBuilder(src, svg));
+    try {
+        tokenize(src, tracker);
+    }
+    catch (error) {
+        if (!(error instanceof TemplateError))
+            throw error;
+        return { error, strings: normalized, at: [src.i, src.pos], from: tracker.from };
+    }
+    return undefined;
+}
+//# sourceMappingURL=check.js.map

package/dist/view/normalize/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/view/normalize/check.ts"],"names":[],"mappings":"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","sourcesContent":["// The template rules (view/09-template-rules.md) as a check that reports where it stopped, for\n// tools that point at the markup (the ESLint plugin, @gyral/core/eslint). It runs the same\n// steps as `analyze` (normalize.ts) up to the last one that can fail: minify whitespace, then\n// tokenize and build the tree (emit and the id never throw). Like the compiler and the runtime,\n// it stops at a template's first error: the tokenizer can't recover from one.\nimport { TemplateError } from './errors.js';\nimport { Source } from './source.js';\nimport { tokenize, type ContentMode, type Sink, type StartTag } from './tokenizer.js';\nimport { TreeBuilder } from './tree.js';\nimport { minifyStrings } from './whitespace.js';\n\n/** A position in the minified strings: string index, offset in that string. */\nexport type At = readonly [index: number, offset: number];\n\n/** A template's first rule violation, and where the normalizer was when it found it. */\nexport interface TemplateIssue {\n  /** The same error `normalize(strings)` throws. */\n  readonly error: TemplateError;\n  /** The whitespace-minified strings the rules read (as many as the input). */\n  readonly strings: readonly string[];\n  /** Where reading stopped. */\n  readonly at: At;\n  /**\n   * Where the token the error is about starts, when the tree builder found it in a tag, an end\n   * tag or a run of text (the token ends at `at`). Undefined when the tokenizer found it at\n   * `at` itself, or at a child hole (then `at` is the end of the string before the hole).\n   */\n  readonly from: At | undefined;\n}\n\n/** Forwards tokens to the tree builder, remembering where the current token started. */\nclass Tracker implements Sink {\n  mark: At = [0, 0];\n  from: At | undefined;\n\n  constructor(\n    private readonly src: Source,\n    private readonly tree: TreeBuilder,\n  ) {}\n\n  /** A token starts at `mark`; an error before `after` is about it (a child hole: the hole). */\n  private before(about = true): void {\n    this.from = about ? this.mark : undefined;\n  }\n\n  private after(): void {\n    this.from = undefined;\n    this.mark = [this.src.i, this.src.pos];\n  }\n\n  text(raw: string): void {\n    this.before();\n    this.tree.text(raw);\n    this.after();\n  }\n  comment(raw: string): void {\n    this.before();\n    this.tree.comment(raw);\n    this.after();\n  }\n  doctype(raw: string): void {\n    this.before();\n    this.tree.doctype(raw);\n    this.after();\n  }\n  start(tag: StartTag): ContentMode {\n    this.before();\n    const mode = this.tree.start(tag);\n    this.after();\n    return mode;\n  }\n  end(name: string): void {\n    this.before();\n    this.tree.end(name);\n    this.after();\n  }\n  hole(kind: 'child' | 'text'): void {\n    this.before(false);\n    this.tree.hole(kind);\n    this.after();\n  }\n  finish(): void {\n    this.before();\n    this.tree.finish();\n    this.after();\n  }\n}\n\n/**\n * The template's first rule violation, or undefined when `normalize` would accept it. `svg`: an\n * svg template's strings (`` svg`…` ``).\n */\nexport function checkTemplate(strings: readonly string[], svg = false): TemplateIssue | undefined {\n  const normalized = minifyStrings(strings);\n  const src = new Source(normalized, undefined);\n  const tracker = new Tracker(src, new TreeBuilder(src, svg));\n  try {\n    tokenize(src, tracker);\n  } catch (error) {\n    if (!(error instanceof TemplateError)) throw error;\n    return { error, strings: normalized, at: [src.i, src.pos], from: tracker.from };\n  }\n  return undefined;\n}\n"]}

package/dist/view/normalize/emit.d.ts

@@ -0,0 +1,15 @@
+import type { TreeNode } from './tree.js';
+import { type PartSpec, type Segment, type Shape } from './types.js';
+export interface Emitted {
+    readonly html: string;
+    readonly parts: PartSpec[];
+    readonly segments: Segment[];
+    readonly shape: Shape;
+    /** The decoded values of the template's non-empty static `style` attributes (types.ts). */
+    readonly staticStyles: string[];
+}
+/**
+ * Emits the HTML, part table, segments and shape for a template's tree. A `server` template
+ * (a page shell) gets no anchors: hydration never walks it, and the browser never renders it.
+ */
+export declare function emit(root: readonly TreeNode[], server: boolean): Emitted;