@gyral/core 0.3.0 → 0.3.1

package/dist/view/index.js.map

@@ -1 +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,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC;AAClG,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,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAoD,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EACL,GAAG,EACH,aAAa,EACb,SAAS,EACT,UAAU,GAIX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,cAAc,GAKf,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 { html, compiled, isTemplateResult, templateOf, type TemplateResult } 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 { 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 type { HookAttributes, HookResult, HookSpec } 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 { ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE } from './attributes.js';\nexport {\n  registerServerComponent,\n  registerServerProvider,\n  serverComponent,\n  serverComponents,\n  serverProvider,\n  type ServerComponent,\n  type ServerProvider,\n  type ServerRenderInput,\n  type ServerRendering,\n} from './registry.js';\n"]}
+{"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

@@ -16,5 +16,8 @@ export interface TemplateIssue {
      */
     readonly from: At | undefined;
 }
-/** The template's first rule violation, or undefined when `normalize` would accept it. */
-export declare function checkTemplate(strings: readonly string[]): TemplateIssue | 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

@@ -60,11 +60,14 @@ class Tracker {
         this.after();
     }
 }
-/** The template's first rule violation, or undefined when `normalize` would accept it. */
-export function checkTemplate(strings) {
+/**
+ * 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));
+    const tracker = new Tracker(src, new TreeBuilder(src, svg));
     try {
         tokenize(src, tracker);
     }

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

@@ -1 +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/** The template's first rule violation, or undefined when `normalize` would accept it. */\nexport function checkTemplate(strings: readonly string[]): TemplateIssue | undefined {\n  const normalized = minifyStrings(strings);\n  const src = new Source(normalized, undefined);\n  const tracker = new Tracker(src, new TreeBuilder(src));\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"]}
+{"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

@@ -5,6 +5,8 @@ export interface Emitted {
     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

package/dist/view/normalize/emit.js

@@ -1,3 +1,8 @@
+// Emits the template object's markup from the normalizer's tree (view/01-templates.md steps 3
+// and 4): the client HTML (bound attributes and static `style` attributes removed, anchors
+// added by view/02-bindings.md's anchor rule), the server segments (types.ts), the part table
+// with child-index paths, and the shape of the DOM the browser must build (prepare.ts).
+import { SVG_HTML_POINT } from './svg.js';
 import { ATTR_PART, BOOL_PART, CHILD_BEFORE, CHILD_END, CHILD_SOLE, HOOK_PART, MULTI_PART, PROP_PART, TEXT_PART, } from './types.js';
 const ANCHOR = '<!---->';
 class Emitter {
@@ -7,12 +12,17 @@ class Emitter {
         this.html = '';
         this.parts = [];
         this.segments = [];
+        this.staticStyles = [];
     }
     /** Static markup: appended to the HTML and to the last string segment. */
     out(text) {
+        this.html += text;
+        this.serverOut(text);
+    }
+    /** Static markup only the server writes: appended to the last string segment. */
+    serverOut(text) {
         if (text === '')
             return;
-        this.html += text;
         const last = this.segments.length - 1;
         const prev = this.segments[last];
         if (typeof prev === 'string')
@@ -23,7 +33,7 @@ class Emitter {
     op(segment) {
         this.segments.push(segment);
     }
-    /** `parent`: the parent element's name; undefined at the template root. */
+    /** `parent`: the parent element; undefined at the template root. */
     children(nodes, path, parent) {
         const shape = [];
         nodes.forEach((node, k) => {
@@ -57,7 +67,13 @@ class Emitter {
     /** A child hole: inserts before the next static element or comment, the end, or an anchor. */
     child(nodes, k, path, shape, parent) {
         const next = nodes[k + 1];
-        this.op(parent === undefined ? { k: 'child' } : { k: 'child', in: parent });
+        if (parent === undefined)
+            this.op({ k: 'child' });
+        else if (parent.ns === 'svg' && !SVG_HTML_POINT.test(parent.name)) {
+            this.op({ k: 'child', in: parent.name, svg: true });
+        }
+        else
+            this.op({ k: 'child', in: parent.name });
         if (next === undefined) {
             this.parts.push([nodes.length === 1 ? CHILD_SOLE : CHILD_END, path]);
             return;
@@ -69,17 +85,29 @@ class Emitter {
         shape.push('#comment');
     }
     element(el, path) {
+        // `open` is the server's start tag; `client` leaves a static style to a part (below).
         let open = `<${el.raw}`;
+        let client = open;
         for (const a of el.attrs) {
-            if (a.kind === 'static')
-                open += a.value === null ? ` ${a.name}` : ` ${a.name}=${a.value}`;
+            if (a.kind !== 'static')
+                continue;
+            const attr = a.value === null ? ` ${a.name}` : ` ${a.name}=${a.value}`;
+            open += attr;
+            if (a.css !== undefined && a.css !== '' && !this.staticStyles.includes(a.css)) {
+                this.staticStyles.push(a.css);
+            }
+            // The CSSOM applies it under a strict CSP, where Firefox blocks the attribute in a
+            // <template>'s HTML: a multi-attribute with no holes (attr-parts.ts writes it once).
+            if (a.css !== undefined && !this.server)
+                this.parts.push([MULTI_PART, path, 'style', [a.css]]);
+            else
+                client += attr;
         }
-        if (el.props !== undefined) {
-            this.html += open;
+        this.html += client;
+        if (el.props !== undefined)
             this.op({ k: 'open', tag: el.name, html: open, attrs: el.props });
-        }
         else
-            this.out(open);
+            this.serverOut(open);
         for (const a of el.attrs) {
             if (a.kind === 'static')
                 continue;
@@ -114,7 +142,7 @@ class Emitter {
             (first?.type === 'hole' || (first?.type === 'text' && first.raw.startsWith('\n')))) {
             this.out('\n');
         }
-        const shape = this.children(el.children, path, el.name);
+        const shape = this.children(el.children, path, el);
         if (el.props !== undefined) {
             this.html += `</${el.raw}>`;
             this.op({ k: 'close', tag: el.name });
@@ -131,6 +159,7 @@ class Emitter {
 export function emit(root, server) {
     const e = new Emitter(server);
     const shape = e.children(root, []);
-    return { html: e.html, parts: e.parts, segments: e.segments, shape };
+    const { html, parts, segments, staticStyles } = e;
+    return { html, parts, segments, shape, staticStyles };
 }
 //# sourceMappingURL=emit.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/view/normalize/emit.ts"],"names":[],"mappings":"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","sourcesContent":["// Emits the template object's markup from the normalizer's tree (view/01-templates.md steps 3\n// and 4): the client HTML (bound attributes removed, anchors added by view/02-bindings.md's\n// anchor rule), the server segments (types.ts), the part table with child-index paths, and the\n// shape of the DOM the browser must build (checked by prepare.ts).\nimport type { ElementNode, TreeNode } from './tree.js';\nimport {\n  ATTR_PART,\n  BOOL_PART,\n  CHILD_BEFORE,\n  CHILD_END,\n  CHILD_SOLE,\n  HOOK_PART,\n  MULTI_PART,\n  PROP_PART,\n  TEXT_PART,\n  type PartSpec,\n  type Path,\n  type Segment,\n  type Shape,\n  type ShapeNode,\n} from './types.js';\n\nconst ANCHOR = '<!---->';\n\nexport interface Emitted {\n  readonly html: string;\n  readonly parts: PartSpec[];\n  readonly segments: Segment[];\n  readonly shape: Shape;\n}\n\nclass Emitter {\n  /** A page shell (`server`): never hydrated, so it needs no anchors (06). */\n  constructor(private readonly server: boolean) {}\n\n  html = '';\n  readonly parts: PartSpec[] = [];\n  readonly segments: Segment[] = [];\n\n  /** Static markup: appended to the HTML and to the last string segment. */\n  out(text: string): void {\n    if (text === '') return;\n    this.html += text;\n    const last = this.segments.length - 1;\n    const prev = this.segments[last];\n    if (typeof prev === 'string') this.segments[last] = prev + text;\n    else this.segments.push(text);\n  }\n\n  op(segment: Segment): void {\n    this.segments.push(segment);\n  }\n\n  /** `parent`: the parent element's name; undefined at the template root. */\n  children(nodes: readonly TreeNode[], path: Path, parent?: string): Shape {\n    const shape: ShapeNode[] = [];\n    nodes.forEach((node, k) => {\n      switch (node.type) {\n        case 'text':\n          this.out(node.raw);\n          shape.push('#text');\n          return;\n        case 'comment':\n          this.out(node.raw);\n          shape.push('#comment');\n          return;\n        case 'doctype':\n          // Server templates only; the browser drops a doctype inside a fragment.\n          this.out(node.raw);\n          return;\n        case 'el':\n          shape.push(this.element(node, [...path, shape.length]));\n          return;\n        case 'hole':\n          if (node.kind === 'text') {\n            this.parts.push([TEXT_PART, path]);\n            this.op({ k: 'text' });\n            return;\n          }\n          this.child(nodes, k, path, shape, parent);\n      }\n    });\n    return shape;\n  }\n\n  /** A child hole: inserts before the next static element or comment, the end, or an anchor. */\n  private child(\n    nodes: readonly TreeNode[],\n    k: number,\n    path: Path,\n    shape: ShapeNode[],\n    parent: string | undefined,\n  ): void {\n    const next = nodes[k + 1];\n    this.op(parent === undefined ? { k: 'child' } : { k: 'child', in: parent });\n    if (next === undefined) {\n      this.parts.push([nodes.length === 1 ? CHILD_SOLE : CHILD_END, path]);\n      return;\n    }\n    this.parts.push([CHILD_BEFORE, path, shape.length]);\n    if (next.type === 'el' || next.type === 'comment' || this.server) return;\n    this.out(ANCHOR);\n    shape.push('#comment');\n  }\n\n  private element(el: ElementNode, path: Path): ShapeNode {\n    let open = `<${el.raw}`;\n    for (const a of el.attrs) {\n      if (a.kind === 'static') open += a.value === null ? ` ${a.name}` : ` ${a.name}=${a.value}`;\n    }\n    if (el.props !== undefined) {\n      this.html += open;\n      this.op({ k: 'open', tag: el.name, html: open, attrs: el.props });\n    } else this.out(open);\n    for (const a of el.attrs) {\n      if (a.kind === 'static') continue;\n      if (a.kind === 'hook') {\n        this.parts.push([HOOK_PART, path]);\n        this.op({ k: 'hook' });\n      } else if (a.kind === 'attr' && a.strings !== undefined) {\n        this.parts.push([MULTI_PART, path, a.name, a.strings]);\n        this.op({ k: 'attr', name: a.name, strings: a.strings });\n      } else {\n        const kind = a.kind === 'attr' ? ATTR_PART : a.kind === 'bool' ? BOOL_PART : PROP_PART;\n        this.parts.push([kind, path, a.name]);\n        this.op({ k: a.kind, name: a.name });\n      }\n    }\n    const end = el.empty && el.ns !== 'html' ? '/>' : '>';\n    if (el.props !== undefined) {\n      this.html += end;\n      this.op({ k: 'openEnd' });\n    } else this.out(end);\n    if (el.empty) return [el.name, []];\n    // The parser drops a newline right after <pre>, <listing> and <textarea>: give it one to\n    // drop, so a hole or text starting with a newline keeps its own.\n    const first = el.children[0];\n    const newline = el.ns === 'html' && /^(pre|listing|textarea)$/.test(el.name);\n    if (\n      newline &&\n      (first?.type === 'hole' || (first?.type === 'text' && first.raw.startsWith('\\n')))\n    ) {\n      this.out('\\n');\n    }\n    const shape = this.children(el.children, path, el.name);\n    if (el.props !== undefined) {\n      this.html += `</${el.raw}>`;\n      this.op({ k: 'close', tag: el.name });\n    } else this.out(`</${el.raw}>`);\n    return [el.name, shape];\n  }\n}\n\n/**\n * Emits the HTML, part table, segments and shape for a template's tree. A `server` template\n * (a page shell) gets no anchors: hydration never walks it, and the browser never renders it.\n */\nexport function emit(root: readonly TreeNode[], server: boolean): Emitted {\n  const e = new Emitter(server);\n  const shape = e.children(root, []);\n  return { html: e.html, parts: e.parts, segments: e.segments, shape };\n}\n"]}
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../src/view/normalize/emit.ts"],"names":[],"mappings":"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","sourcesContent":["// Emits the template object's markup from the normalizer's tree (view/01-templates.md steps 3\n// and 4): the client HTML (bound attributes and static `style` attributes removed, anchors\n// added by view/02-bindings.md's anchor rule), the server segments (types.ts), the part table\n// with child-index paths, and the shape of the DOM the browser must build (prepare.ts).\nimport { SVG_HTML_POINT } from './svg.js';\nimport type { ElementNode, TreeNode } from './tree.js';\nimport {\n  ATTR_PART,\n  BOOL_PART,\n  CHILD_BEFORE,\n  CHILD_END,\n  CHILD_SOLE,\n  HOOK_PART,\n  MULTI_PART,\n  PROP_PART,\n  TEXT_PART,\n  type PartSpec,\n  type Path,\n  type Segment,\n  type Shape,\n  type ShapeNode,\n} from './types.js';\n\nconst ANCHOR = '<!---->';\n\nexport interface Emitted {\n  readonly html: string;\n  readonly parts: PartSpec[];\n  readonly segments: Segment[];\n  readonly shape: Shape;\n  /** The decoded values of the template's non-empty static `style` attributes (types.ts). */\n  readonly staticStyles: string[];\n}\n\nclass Emitter {\n  /** A page shell (`server`): never hydrated, so it needs no anchors (06). */\n  constructor(private readonly server: boolean) {}\n\n  html = '';\n  readonly parts: PartSpec[] = [];\n  readonly segments: Segment[] = [];\n  readonly staticStyles: string[] = [];\n\n  /** Static markup: appended to the HTML and to the last string segment. */\n  out(text: string): void {\n    this.html += text;\n    this.serverOut(text);\n  }\n\n  /** Static markup only the server writes: appended to the last string segment. */\n  serverOut(text: string): void {\n    if (text === '') return;\n    const last = this.segments.length - 1;\n    const prev = this.segments[last];\n    if (typeof prev === 'string') this.segments[last] = prev + text;\n    else this.segments.push(text);\n  }\n\n  op(segment: Segment): void {\n    this.segments.push(segment);\n  }\n\n  /** `parent`: the parent element; undefined at the template root. */\n  children(nodes: readonly TreeNode[], path: Path, parent?: ElementNode): Shape {\n    const shape: ShapeNode[] = [];\n    nodes.forEach((node, k) => {\n      switch (node.type) {\n        case 'text':\n          this.out(node.raw);\n          shape.push('#text');\n          return;\n        case 'comment':\n          this.out(node.raw);\n          shape.push('#comment');\n          return;\n        case 'doctype':\n          // Server templates only; the browser drops a doctype inside a fragment.\n          this.out(node.raw);\n          return;\n        case 'el':\n          shape.push(this.element(node, [...path, shape.length]));\n          return;\n        case 'hole':\n          if (node.kind === 'text') {\n            this.parts.push([TEXT_PART, path]);\n            this.op({ k: 'text' });\n            return;\n          }\n          this.child(nodes, k, path, shape, parent);\n      }\n    });\n    return shape;\n  }\n\n  /** A child hole: inserts before the next static element or comment, the end, or an anchor. */\n  private child(\n    nodes: readonly TreeNode[],\n    k: number,\n    path: Path,\n    shape: ShapeNode[],\n    parent: ElementNode | undefined,\n  ): void {\n    const next = nodes[k + 1];\n    if (parent === undefined) this.op({ k: 'child' });\n    else if (parent.ns === 'svg' && !SVG_HTML_POINT.test(parent.name)) {\n      this.op({ k: 'child', in: parent.name, svg: true });\n    } else this.op({ k: 'child', in: parent.name });\n    if (next === undefined) {\n      this.parts.push([nodes.length === 1 ? CHILD_SOLE : CHILD_END, path]);\n      return;\n    }\n    this.parts.push([CHILD_BEFORE, path, shape.length]);\n    if (next.type === 'el' || next.type === 'comment' || this.server) return;\n    this.out(ANCHOR);\n    shape.push('#comment');\n  }\n\n  private element(el: ElementNode, path: Path): ShapeNode {\n    // `open` is the server's start tag; `client` leaves a static style to a part (below).\n    let open = `<${el.raw}`;\n    let client = open;\n    for (const a of el.attrs) {\n      if (a.kind !== 'static') continue;\n      const attr = a.value === null ? ` ${a.name}` : ` ${a.name}=${a.value}`;\n      open += attr;\n      if (a.css !== undefined && a.css !== '' && !this.staticStyles.includes(a.css)) {\n        this.staticStyles.push(a.css);\n      }\n      // The CSSOM applies it under a strict CSP, where Firefox blocks the attribute in a\n      // <template>'s HTML: a multi-attribute with no holes (attr-parts.ts writes it once).\n      if (a.css !== undefined && !this.server)\n        this.parts.push([MULTI_PART, path, 'style', [a.css]]);\n      else client += attr;\n    }\n    this.html += client;\n    if (el.props !== undefined) this.op({ k: 'open', tag: el.name, html: open, attrs: el.props });\n    else this.serverOut(open);\n    for (const a of el.attrs) {\n      if (a.kind === 'static') continue;\n      if (a.kind === 'hook') {\n        this.parts.push([HOOK_PART, path]);\n        this.op({ k: 'hook' });\n      } else if (a.kind === 'attr' && a.strings !== undefined) {\n        this.parts.push([MULTI_PART, path, a.name, a.strings]);\n        this.op({ k: 'attr', name: a.name, strings: a.strings });\n      } else {\n        const kind = a.kind === 'attr' ? ATTR_PART : a.kind === 'bool' ? BOOL_PART : PROP_PART;\n        this.parts.push([kind, path, a.name]);\n        this.op({ k: a.kind, name: a.name });\n      }\n    }\n    const end = el.empty && el.ns !== 'html' ? '/>' : '>';\n    if (el.props !== undefined) {\n      this.html += end;\n      this.op({ k: 'openEnd' });\n    } else this.out(end);\n    if (el.empty) return [el.name, []];\n    // The parser drops a newline right after <pre>, <listing> and <textarea>: give it one to\n    // drop, so a hole or text starting with a newline keeps its own.\n    const first = el.children[0];\n    const newline = el.ns === 'html' && /^(pre|listing|textarea)$/.test(el.name);\n    if (\n      newline &&\n      (first?.type === 'hole' || (first?.type === 'text' && first.raw.startsWith('\\n')))\n    ) {\n      this.out('\\n');\n    }\n    const shape = this.children(el.children, path, el);\n    if (el.props !== undefined) {\n      this.html += `</${el.raw}>`;\n      this.op({ k: 'close', tag: el.name });\n    } else this.out(`</${el.raw}>`);\n    return [el.name, shape];\n  }\n}\n\n/**\n * Emits the HTML, part table, segments and shape for a template's tree. A `server` template\n * (a page shell) gets no anchors: hydration never walks it, and the browser never renders it.\n */\nexport function emit(root: readonly TreeNode[], server: boolean): Emitted {\n  const e = new Emitter(server);\n  const shape = e.children(root, []);\n  const { html, parts, segments, staticStyles } = e;\n  return { html, parts, segments, shape, staticStyles };\n}\n"]}

package/dist/view/normalize/errors.js

@@ -3,7 +3,7 @@
 export const RULES_DOC = 'docs/design-docs/view/09-template-rules.md';
 /** Rule 11's message, here so the client's template cache needn't load the rule messages. */
 export const SERVER_ONLY = 'This template has document-level tags (<!doctype>, <html>, <head> or <body>): it is a page ' +
-    'shell, and only the server renders those. Render it with @gyral/core/server, and render ' +
+    'shell, and only the server renders those. Render it with @gyral/ssr (renderPage, renderToString), and render ' +
     'components (not the page) in the browser.';
 /** A template breaks rule `rule` of view/09-template-rules.md. */
 export class TemplateError extends Error {

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/view/normalize/errors.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,mFAAmF;AAEnF,MAAM,CAAC,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAEtE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GACtB,6FAA6F;IAC7F,0FAA0F;IAC1F,2CAA2C,CAAC;AAE9C,kEAAkE;AAClE,MAAM,OAAO,aAAc,SAAQ,KAAK;IAItC,YAAY,IAAY,EAAE,OAAe,EAAE,GAAY,EAAE,IAAa;QACpE,MAAM,GAAG,GAAG,KAAK,SAAS,UAAU,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACpD,MAAM,OAAO,GACX,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/F,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,GAAG,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF","sourcesContent":["// TemplateError: what the template rules (view/09-template-rules.md) throw. Kept apart from the\n// rule checks so code that only needs the class (template-element.ts) stays small.\n\nexport const RULES_DOC = 'docs/design-docs/view/09-template-rules.md';\n\n/** Rule 11's message, here so the client's template cache needn't load the rule messages. */\nexport const SERVER_ONLY =\n  'This template has document-level tags (<!doctype>, <html>, <head> or <body>): it is a page ' +\n  'shell, and only the server renders those. Render it with @gyral/core/server, and render ' +\n  'components (not the page) in the browser.';\n\n/** A template breaks rule `rule` of view/09-template-rules.md. */\nexport class TemplateError extends Error {\n  readonly rule: number;\n  readonly loc: string | undefined;\n\n  constructor(rule: number, message: string, loc?: string, near?: string) {\n    const doc = ` (${RULES_DOC}, rule ${String(rule)})`;\n    const context =\n      (near === undefined ? '' : `\\n  near: ${near}`) + (loc === undefined ? '' : `\\n  at ${loc}`);\n    super(`[gyral template rule ${String(rule)}] ${message}${doc}${context}`);\n    this.name = 'TemplateError';\n    this.rule = rule;\n    this.loc = loc;\n  }\n}\n"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/view/normalize/errors.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,mFAAmF;AAEnF,MAAM,CAAC,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAEtE,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GACtB,6FAA6F;IAC7F,+GAA+G;IAC/G,2CAA2C,CAAC;AAE9C,kEAAkE;AAClE,MAAM,OAAO,aAAc,SAAQ,KAAK;IAItC,YAAY,IAAY,EAAE,OAAe,EAAE,GAAY,EAAE,IAAa;QACpE,MAAM,GAAG,GAAG,KAAK,SAAS,UAAU,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QACpD,MAAM,OAAO,GACX,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/F,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,KAAK,OAAO,GAAG,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF","sourcesContent":["// TemplateError: what the template rules (view/09-template-rules.md) throw. Kept apart from the\n// rule checks so code that only needs the class (template-element.ts) stays small.\n\nexport const RULES_DOC = 'docs/design-docs/view/09-template-rules.md';\n\n/** Rule 11's message, here so the client's template cache needn't load the rule messages. */\nexport const SERVER_ONLY =\n  'This template has document-level tags (<!doctype>, <html>, <head> or <body>): it is a page ' +\n  'shell, and only the server renders those. Render it with @gyral/ssr (renderPage, renderToString), and render ' +\n  'components (not the page) in the browser.';\n\n/** A template breaks rule `rule` of view/09-template-rules.md. */\nexport class TemplateError extends Error {\n  readonly rule: number;\n  readonly loc: string | undefined;\n\n  constructor(rule: number, message: string, loc?: string, near?: string) {\n    const doc = ` (${RULES_DOC}, rule ${String(rule)})`;\n    const context =\n      (near === undefined ? '' : `\\n  near: ${near}`) + (loc === undefined ? '' : `\\n  at ${loc}`);\n    super(`[gyral template rule ${String(rule)}] ${message}${doc}${context}`);\n    this.name = 'TemplateError';\n    this.rule = rule;\n    this.loc = loc;\n  }\n}\n"]}

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

@@ -1,5 +1,8 @@
-/** The id of a template's normalized strings. */
-export declare function templateId(strings: readonly string[]): string;
+/**
+ * The id of a template's normalized strings. `svg`: an svg template's (01 "svg templates"),
+ * whose DOM differs from an html template's with the same strings, so its id does too.
+ */
+export declare function templateId(strings: readonly string[], svg?: boolean): string;
 /**
  * Development: records `id` → strings and warns once when two different normalized templates
  * share an id (the compiler fails the build instead).

package/dist/view/normalize/id.js

@@ -11,10 +11,17 @@ function avalanche(h, a, b) {
     x = Math.imul(x ^ (x >>> 13), b);
     return x ^ (x >>> 16);
 }
-/** The id of a template's normalized strings. */
-export function templateId(strings) {
+/**
+ * The id of a template's normalized strings. `svg`: an svg template's (01 "svg templates"),
+ * whose DOM differs from an html template's with the same strings, so its id does too.
+ */
+export function templateId(strings, svg = false) {
     let h1 = 0x9e3779b9 ^ strings.length;
     let h2 = 0x85ebca6b ^ strings.length;
+    if (svg) {
+        h1 = mix(h1, 0x737667, 0x2d51);
+        h2 = mix(h2, 0x737667, 0x1b873593);
+    }
     for (const s of strings) {
         h1 = mix(h1, s.length, 0x2d51);
         h2 = mix(h2, s.length, 0x1b873593);