@gyral/core 0.2.0 → 0.3.0

package/dist/view/normalize/emit.js

@@ -0,0 +1,136 @@
+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 {
+    /** A page shell (`server`): never hydrated, so it needs no anchors (06). */
+    constructor(server) {
+        this.server = server;
+        this.html = '';
+        this.parts = [];
+        this.segments = [];
+    }
+    /** Static markup: appended to the HTML and to the last string segment. */
+    out(text) {
+        if (text === '')
+            return;
+        this.html += text;
+        const last = this.segments.length - 1;
+        const prev = this.segments[last];
+        if (typeof prev === 'string')
+            this.segments[last] = prev + text;
+        else
+            this.segments.push(text);
+    }
+    op(segment) {
+        this.segments.push(segment);
+    }
+    /** `parent`: the parent element's name; undefined at the template root. */
+    children(nodes, path, parent) {
+        const shape = [];
+        nodes.forEach((node, k) => {
+            switch (node.type) {
+                case 'text':
+                    this.out(node.raw);
+                    shape.push('#text');
+                    return;
+                case 'comment':
+                    this.out(node.raw);
+                    shape.push('#comment');
+                    return;
+                case 'doctype':
+                    // Server templates only; the browser drops a doctype inside a fragment.
+                    this.out(node.raw);
+                    return;
+                case 'el':
+                    shape.push(this.element(node, [...path, shape.length]));
+                    return;
+                case 'hole':
+                    if (node.kind === 'text') {
+                        this.parts.push([TEXT_PART, path]);
+                        this.op({ k: 'text' });
+                        return;
+                    }
+                    this.child(nodes, k, path, shape, parent);
+            }
+        });
+        return shape;
+    }
+    /** 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 (next === undefined) {
+            this.parts.push([nodes.length === 1 ? CHILD_SOLE : CHILD_END, path]);
+            return;
+        }
+        this.parts.push([CHILD_BEFORE, path, shape.length]);
+        if (next.type === 'el' || next.type === 'comment' || this.server)
+            return;
+        this.out(ANCHOR);
+        shape.push('#comment');
+    }
+    element(el, path) {
+        let open = `<${el.raw}`;
+        for (const a of el.attrs) {
+            if (a.kind === 'static')
+                open += a.value === null ? ` ${a.name}` : ` ${a.name}=${a.value}`;
+        }
+        if (el.props !== undefined) {
+            this.html += open;
+            this.op({ k: 'open', tag: el.name, html: open, attrs: el.props });
+        }
+        else
+            this.out(open);
+        for (const a of el.attrs) {
+            if (a.kind === 'static')
+                continue;
+            if (a.kind === 'hook') {
+                this.parts.push([HOOK_PART, path]);
+                this.op({ k: 'hook' });
+            }
+            else if (a.kind === 'attr' && a.strings !== undefined) {
+                this.parts.push([MULTI_PART, path, a.name, a.strings]);
+                this.op({ k: 'attr', name: a.name, strings: a.strings });
+            }
+            else {
+                const kind = a.kind === 'attr' ? ATTR_PART : a.kind === 'bool' ? BOOL_PART : PROP_PART;
+                this.parts.push([kind, path, a.name]);
+                this.op({ k: a.kind, name: a.name });
+            }
+        }
+        const end = el.empty && el.ns !== 'html' ? '/>' : '>';
+        if (el.props !== undefined) {
+            this.html += end;
+            this.op({ k: 'openEnd' });
+        }
+        else
+            this.out(end);
+        if (el.empty)
+            return [el.name, []];
+        // The parser drops a newline right after <pre>, <listing> and <textarea>: give it one to
+        // drop, so a hole or text starting with a newline keeps its own.
+        const first = el.children[0];
+        const newline = el.ns === 'html' && /^(pre|listing|textarea)$/.test(el.name);
+        if (newline &&
+            (first?.type === 'hole' || (first?.type === 'text' && first.raw.startsWith('\n')))) {
+            this.out('\n');
+        }
+        const shape = this.children(el.children, path, el.name);
+        if (el.props !== undefined) {
+            this.html += `</${el.raw}>`;
+            this.op({ k: 'close', tag: el.name });
+        }
+        else
+            this.out(`</${el.raw}>`);
+        return [el.name, shape];
+    }
+}
+/**
+ * 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 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 };
+}
+//# sourceMappingURL=emit.js.map

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

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

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

@@ -0,0 +1,4 @@
+/** Decodes `raw`; `unknown(name)` is called (and must throw) for an unsupported name. */
+export declare function decodeRefs(raw: string, unknown: (name: string) => never): string;
+/** The value of a static attribute as written (`"a"`, `'a'`, `a`), without its quotes. */
+export declare function unquote(value: string): string;

package/dist/view/normalize/entities.js

@@ -0,0 +1,38 @@
+// Character references in attribute text the client sets itself: the static pieces of a
+// multi-attribute and a custom element's static attributes (its props on the server). The
+// WHATWG named-reference table has over 2,000 entries, so only numeric references and the
+// common names are decoded; any other `&name;` is rule 13 (proposed). Text and plain static
+// attributes are never decoded here: they stay in the template HTML for the browser to parse.
+const NAMED = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+};
+const REF = /&(#[0-9]+|#[xX][0-9a-fA-F]+|[A-Za-z][A-Za-z0-9]*);/g;
+function codePoint(n) {
+    const invalid = n === 0 || n > 0x10ffff || (n >= 0xd800 && n <= 0xdfff);
+    return String.fromCodePoint(invalid ? 0xfffd : n);
+}
+/** Decodes `raw`; `unknown(name)` is called (and must throw) for an unsupported name. */
+export function decodeRefs(raw, unknown) {
+    if (!raw.includes('&'))
+        return raw;
+    return raw.replace(REF, (_, ref) => {
+        if (ref.startsWith('#x') || ref.startsWith('#X'))
+            return codePoint(parseInt(ref.slice(2), 16));
+        if (ref.startsWith('#'))
+            return codePoint(parseInt(ref.slice(1), 10));
+        return NAMED[ref] ?? unknown(ref);
+    });
+}
+/** The value of a static attribute as written (`"a"`, `'a'`, `a`), without its quotes. */
+export function unquote(value) {
+    const q = value.charAt(0);
+    return (q === '"' || q === "'") && value.endsWith(q) && value.length >= 2
+        ? value.slice(1, -1)
+        : value;
+}
+//# sourceMappingURL=entities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/view/normalize/entities.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,0FAA0F;AAC1F,0FAA0F;AAC1F,4FAA4F;AAC5F,8FAA8F;AAE9F,MAAM,KAAK,GAAuC;IAChD,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;CACV,CAAC;AAEF,MAAM,GAAG,GAAG,qDAAqD,CAAC;AAElE,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,OAAgC;IACtE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACzC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/F,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QACvE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC","sourcesContent":["// Character references in attribute text the client sets itself: the static pieces of a\n// multi-attribute and a custom element's static attributes (its props on the server). The\n// WHATWG named-reference table has over 2,000 entries, so only numeric references and the\n// common names are decoded; any other `&name;` is rule 13 (proposed). Text and plain static\n// attributes are never decoded here: they stay in the template HTML for the browser to parse.\n\nconst NAMED: Record<string, string | undefined> = {\n  amp: '&',\n  lt: '<',\n  gt: '>',\n  quot: '\"',\n  apos: \"'\",\n  nbsp: ' ',\n};\n\nconst REF = /&(#[0-9]+|#[xX][0-9a-fA-F]+|[A-Za-z][A-Za-z0-9]*);/g;\n\nfunction codePoint(n: number): string {\n  const invalid = n === 0 || n > 0x10ffff || (n >= 0xd800 && n <= 0xdfff);\n  return String.fromCodePoint(invalid ? 0xfffd : n);\n}\n\n/** Decodes `raw`; `unknown(name)` is called (and must throw) for an unsupported name. */\nexport function decodeRefs(raw: string, unknown: (name: string) => never): string {\n  if (!raw.includes('&')) return raw;\n  return raw.replace(REF, (_, ref: string) => {\n    if (ref.startsWith('#x') || ref.startsWith('#X')) return codePoint(parseInt(ref.slice(2), 16));\n    if (ref.startsWith('#')) return codePoint(parseInt(ref.slice(1), 10));\n    return NAMED[ref] ?? unknown(ref);\n  });\n}\n\n/** The value of a static attribute as written (`\"a\"`, `'a'`, `a`), without its quotes. */\nexport function unquote(value: string): string {\n  const q = value.charAt(0);\n  return (q === '\"' || q === \"'\") && value.endsWith(q) && value.length >= 2\n    ? value.slice(1, -1)\n    : value;\n}\n"]}

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

@@ -0,0 +1,9 @@
+export declare 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 declare const SERVER_ONLY: string;
+/** A template breaks rule `rule` of view/09-template-rules.md. */
+export declare class TemplateError extends Error {
+    readonly rule: number;
+    readonly loc: string | undefined;
+    constructor(rule: number, message: string, loc?: string, near?: string);
+}

package/dist/view/normalize/errors.js

@@ -0,0 +1,19 @@
+// TemplateError: what the template rules (view/09-template-rules.md) throw. Kept apart from the
+// rule checks so code that only needs the class (template-element.ts) stays small.
+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 ' +
+    'components (not the page) in the browser.';
+/** A template breaks rule `rule` of view/09-template-rules.md. */
+export class TemplateError extends Error {
+    constructor(rule, message, loc, near) {
+        const doc = ` (${RULES_DOC}, rule ${String(rule)})`;
+        const context = (near === undefined ? '' : `\n  near: ${near}`) + (loc === undefined ? '' : `\n  at ${loc}`);
+        super(`[gyral template rule ${String(rule)}] ${message}${doc}${context}`);
+        this.name = 'TemplateError';
+        this.rule = rule;
+        this.loc = loc;
+    }
+}
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,7 @@
+/** The id of a template's normalized strings. */
+export declare function templateId(strings: readonly string[]): string;
+/**
+ * Development: records `id` → strings and warns once when two different normalized templates
+ * share an id (the compiler fails the build instead).
+ */
+export declare function recordTemplateId(id: string, strings: readonly string[]): void;

package/dist/view/normalize/id.js

@@ -0,0 +1,48 @@
+// Template ids (view/01-templates.md "Template ids"): a deterministic 53-bit hash of the
+// normalized strings, printed in base 36. Two independent 32-bit multiply-xorshift lanes over
+// the UTF-16 code units, with each string's length mixed in first so ["a", "b"] and ["ab"]
+// differ; a final avalanche, then 21 bits of one lane and 32 of the other. Only Math.imul and
+// integer ops: the same result in Node, browsers and the compiler.
+function mix(h, k, m) {
+    return Math.imul(h ^ k, m);
+}
+function avalanche(h, a, b) {
+    let x = Math.imul(h ^ (h >>> 16), a);
+    x = Math.imul(x ^ (x >>> 13), b);
+    return x ^ (x >>> 16);
+}
+/** The id of a template's normalized strings. */
+export function templateId(strings) {
+    let h1 = 0x9e3779b9 ^ strings.length;
+    let h2 = 0x85ebca6b ^ strings.length;
+    for (const s of strings) {
+        h1 = mix(h1, s.length, 0x2d51);
+        h2 = mix(h2, s.length, 0x1b873593);
+        for (let k = 0; k < s.length; k++) {
+            const c = s.charCodeAt(k);
+            h1 = mix(h1, c, 0x9e3779b1);
+            h2 = mix(h2, c, 0x5bd1e995);
+        }
+    }
+    const lo = avalanche(h1 ^ Math.imul(h2, 0x27d4eb2f), 0x85ebca6b, 0xc2b2ae35) >>> 0;
+    const hi = avalanche(h2 ^ lo, 0x2c1b3c6d, 0x297a2d39) & 0x1fffff;
+    return (hi * 0x100000000 + lo).toString(36);
+}
+const seen = new Map();
+/**
+ * Development: records `id` → strings and warns once when two different normalized templates
+ * share an id (the compiler fails the build instead).
+ */
+export function recordTemplateId(id, strings) {
+    const key = JSON.stringify(strings);
+    const known = seen.get(id);
+    if (known === undefined)
+        seen.set(id, key);
+    else if (known !== key) {
+        console.warn(`gyral: two different templates share the id ${id}; server output and hydration may ` +
+            `confuse them. Change one template slightly (e.g. add a class) and report this ` +
+            `collision.\n  ${known}\n  ${key}`);
+        seen.set(id, key);
+    }
+}
+//# sourceMappingURL=id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../src/view/normalize/id.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,8FAA8F;AAC9F,2FAA2F;AAC3F,8FAA8F;AAC9F,mEAAmE;AAEnE,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAChD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,IAAI,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC1B,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;YAC5B,EAAE,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACnF,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC;IACjE,OAAO,CAAC,EAAE,GAAG,WAAW,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAU,EAAE,OAA0B;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;SACtC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CACV,+CAA+C,EAAE,oCAAoC;YACnF,gFAAgF;YAChF,iBAAiB,KAAK,OAAO,GAAG,EAAE,CACrC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACpB,CAAC;AACH,CAAC","sourcesContent":["// Template ids (view/01-templates.md \"Template ids\"): a deterministic 53-bit hash of the\n// normalized strings, printed in base 36. Two independent 32-bit multiply-xorshift lanes over\n// the UTF-16 code units, with each string's length mixed in first so [\"a\", \"b\"] and [\"ab\"]\n// differ; a final avalanche, then 21 bits of one lane and 32 of the other. Only Math.imul and\n// integer ops: the same result in Node, browsers and the compiler.\n\nfunction mix(h: number, k: number, m: number): number {\n  return Math.imul(h ^ k, m);\n}\n\nfunction avalanche(h: number, a: number, b: number): number {\n  let x = Math.imul(h ^ (h >>> 16), a);\n  x = Math.imul(x ^ (x >>> 13), b);\n  return x ^ (x >>> 16);\n}\n\n/** The id of a template's normalized strings. */\nexport function templateId(strings: readonly string[]): string {\n  let h1 = 0x9e3779b9 ^ strings.length;\n  let h2 = 0x85ebca6b ^ strings.length;\n  for (const s of strings) {\n    h1 = mix(h1, s.length, 0x2d51);\n    h2 = mix(h2, s.length, 0x1b873593);\n    for (let k = 0; k < s.length; k++) {\n      const c = s.charCodeAt(k);\n      h1 = mix(h1, c, 0x9e3779b1);\n      h2 = mix(h2, c, 0x5bd1e995);\n    }\n  }\n  const lo = avalanche(h1 ^ Math.imul(h2, 0x27d4eb2f), 0x85ebca6b, 0xc2b2ae35) >>> 0;\n  const hi = avalanche(h2 ^ lo, 0x2c1b3c6d, 0x297a2d39) & 0x1fffff;\n  return (hi * 0x100000000 + lo).toString(36);\n}\n\nconst seen = new Map<string, string>();\n\n/**\n * Development: records `id` → strings and warns once when two different normalized templates\n * share an id (the compiler fails the build instead).\n */\nexport function recordTemplateId(id: string, strings: readonly string[]): void {\n  const key = JSON.stringify(strings);\n  const known = seen.get(id);\n  if (known === undefined) seen.set(id, key);\n  else if (known !== key) {\n    console.warn(\n      `gyral: two different templates share the id ${id}; server output and hydration may ` +\n        `confuse them. Change one template slightly (e.g. add a class) and report this ` +\n        `collision.\\n  ${known}\\n  ${key}`,\n    );\n    seen.set(id, key);\n  }\n}\n"]}

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

@@ -0,0 +1,15 @@
+import type { NormalizedTemplate, Shape } from './types.js';
+export interface Analysis {
+    readonly template: NormalizedTemplate;
+    /** The whitespace-normalized strings the id was computed from. */
+    readonly strings: readonly string[];
+    /** The DOM the browser must build from `template.html` (checked by the runtime preparer). */
+    readonly shape: Shape;
+}
+/** The template object plus what the runtime preparer checks it against. */
+export declare function analyze(strings: readonly string[], loc?: string): Analysis;
+/**
+ * Normalizes a template's static strings into its template object (JSON data). Throws a
+ * TemplateError for markup that breaks a template rule.
+ */
+export declare function normalize(strings: readonly string[], loc?: string): NormalizedTemplate;

package/dist/view/normalize/normalize.js

@@ -0,0 +1,36 @@
+// The normalizer (view/01-templates.md "Normalization"): one pure function from a call site's
+// static strings to its template object, shared by the Vite compiler, the browser's runtime
+// preparer and the server renderer. Steps: minify whitespace (holes never move), tokenize and
+// build the tree (rules of view/09-template-rules.md), emit HTML, segments and parts, and hash
+// the normalized strings into the id. No DOM: it runs in Node and in the browser.
+import { emit } from './emit.js';
+import { templateId } from './id.js';
+import { Source } from './source.js';
+import { tokenize } from './tokenizer.js';
+import { TreeBuilder } from './tree.js';
+import { minifyStrings } from './whitespace.js';
+/** The template object plus what the runtime preparer checks it against. */
+export function analyze(strings, loc) {
+    const normalized = minifyStrings(strings);
+    const src = new Source(normalized, loc);
+    const tree = new TreeBuilder(src);
+    tokenize(src, tree);
+    const { html, parts, segments, shape } = emit(tree.root, tree.server);
+    const template = {
+        id: templateId(normalized),
+        html,
+        parts,
+        ...(tree.server ? { server: true } : {}),
+        segments,
+        ...(loc === undefined ? {} : { loc }),
+    };
+    return { template, strings: normalized, shape };
+}
+/**
+ * Normalizes a template's static strings into its template object (JSON data). Throws a
+ * TemplateError for markup that breaks a template rule.
+ */
+export function normalize(strings, loc) {
+    return analyze(strings, loc).template;
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/view/normalize/normalize.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,8FAA8F;AAC9F,+FAA+F;AAC/F,kFAAkF;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUhD,4EAA4E;AAC5E,MAAM,UAAU,OAAO,CAAC,OAA0B,EAAE,GAAY;IAC9D,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAuB;QACnC,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;QAC1B,IAAI;QACJ,KAAK;QACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,QAAQ;QACR,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;KACtC,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B,EAAE,GAAY;IAChE,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;AACxC,CAAC","sourcesContent":["// The normalizer (view/01-templates.md \"Normalization\"): one pure function from a call site's\n// static strings to its template object, shared by the Vite compiler, the browser's runtime\n// preparer and the server renderer. Steps: minify whitespace (holes never move), tokenize and\n// build the tree (rules of view/09-template-rules.md), emit HTML, segments and parts, and hash\n// the normalized strings into the id. No DOM: it runs in Node and in the browser.\nimport { emit } from './emit.js';\nimport { templateId } from './id.js';\nimport { Source } from './source.js';\nimport { tokenize } from './tokenizer.js';\nimport { TreeBuilder } from './tree.js';\nimport type { NormalizedTemplate, Shape } from './types.js';\nimport { minifyStrings } from './whitespace.js';\n\nexport interface Analysis {\n  readonly template: NormalizedTemplate;\n  /** The whitespace-normalized strings the id was computed from. */\n  readonly strings: readonly string[];\n  /** The DOM the browser must build from `template.html` (checked by the runtime preparer). */\n  readonly shape: Shape;\n}\n\n/** The template object plus what the runtime preparer checks it against. */\nexport function analyze(strings: readonly string[], loc?: string): Analysis {\n  const normalized = minifyStrings(strings);\n  const src = new Source(normalized, loc);\n  const tree = new TreeBuilder(src);\n  tokenize(src, tree);\n  const { html, parts, segments, shape } = emit(tree.root, tree.server);\n  const template: NormalizedTemplate = {\n    id: templateId(normalized),\n    html,\n    parts,\n    ...(tree.server ? { server: true as const } : {}),\n    segments,\n    ...(loc === undefined ? {} : { loc }),\n  };\n  return { template, strings: normalized, shape };\n}\n\n/**\n * Normalizes a template's static strings into its template object (JSON data). Throws a\n * TemplateError for markup that breaks a template rule.\n */\nexport function normalize(strings: readonly string[], loc?: string): NormalizedTemplate {\n  return analyze(strings, loc).template;\n}\n"]}

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

@@ -0,0 +1,24 @@
+export type Ns = 'html' | 'svg' | 'math';
+export interface OpenElement {
+    readonly name: string;
+    readonly ns: Ns;
+}
+/** How the tree builder treats content of a container (its insertion mode, roughly). */
+export type Context = 'body' | 'table' | 'tbody' | 'tr' | 'colgroup';
+/** The context an element's children are parsed in. */
+export declare function contextOf(name: string): Context;
+/**
+ * The context of a template root or <template> content: decided by its first start tag
+ * (the "in template" insertion mode).
+ */
+export declare function rootContext(firstTag: string): Context;
+/**
+ * Rule 7 for a start tag in the HTML namespace. `atRoot`: the container is the template root
+ * or a <template>'s content, where content the parser would foster-parent stays in place.
+ * Returns the error message, or undefined when the parser keeps the tag where it is written.
+ */
+export declare function startRepair(name: string, ctx: Context, atRoot: boolean, stack: readonly OpenElement[], hiddenInput: boolean): string | undefined;
+/** Rule 7 for static text: non-whitespace text in table structure is moved out of it. */
+export declare function textRepair(raw: string, ctx: Context, atRoot: boolean): string | undefined;
+/** Rule 7 in SVG/MathML: HTML tags that end the foreign element. */
+export declare function breaksOutOfForeign(name: string, hasFontAttr: boolean): boolean;

package/dist/view/normalize/repairs.js

@@ -0,0 +1,166 @@
+// Rule 7 by structure (view/09-template-rules.md "How rule 7 is checked"): start tags and text
+// that the WHATWG HTML tree builder would move, drop or implicitly close something for, checked
+// against the open-element stack. Only real repairs are flagged; the browser's own parse
+// (prepare.ts) and the compiler's parse5 check catch anything this misses.
+import { msg } from './rules.js';
+const set = (names) => new Set(names.split(' '));
+const TABLE_PARTS = set('caption col colgroup tbody td tfoot th thead tr');
+const ALLOWED = {
+    table: set('caption colgroup thead tbody tfoot script style template'),
+    tbody: set('tr script style template'),
+    tr: set('td th script style template'),
+    colgroup: set('col template'),
+};
+const CLOSES_P = set('address article aside blockquote center details dialog dir div dl fieldset figcaption ' +
+    'figure footer header hgroup main menu nav ol p search section summary ul h1 h2 h3 h4 h5 h6 ' +
+    'pre listing form plaintext table hr xmp li dd dt');
+const HEADINGS = set('h1 h2 h3 h4 h5 h6');
+const SCOPE = {
+    html: set('applet caption html table td th marquee object template'),
+    math: set('mi mo mn ms mtext annotation-xml'),
+    svg: set('foreignobject desc title'),
+};
+const SPECIAL = set('address applet area article aside base basefont bgsound blockquote body br button caption ' +
+    'center col colgroup dd details dir div dl dt embed fieldset figcaption figure footer form ' +
+    'frame frameset h1 h2 h3 h4 h5 h6 head header hgroup hr html iframe img input keygen li link ' +
+    'listing main marquee menu meta nav noembed noframes noscript object ol p param plaintext ' +
+    'pre script search section select source style summary table tbody td template textarea ' +
+    'tfoot th thead title tr track ul wbr xmp');
+const LI = set('li');
+const DD_DT = set('dd dt');
+const FORM = set('form');
+const TEMPLATE = set('template');
+const OPTION = set('option');
+const FORMATTING_MARKERS = set('applet marquee object template td th caption');
+const BREAKOUT = set('b big blockquote body br center code dd div dl dt em embed h1 h2 h3 h4 h5 h6 head hr i img ' +
+    'li listing menu meta nobr ol p pre ruby s small span strong strike sub sup table tt u ul var');
+/** The context an element's children are parsed in. */
+export function contextOf(name) {
+    if (name === 'table')
+        return 'table';
+    if (name === 'tbody' || name === 'thead' || name === 'tfoot')
+        return 'tbody';
+    if (name === 'tr' || name === 'colgroup')
+        return name;
+    return 'body';
+}
+/**
+ * The context of a template root or <template> content: decided by its first start tag
+ * (the "in template" insertion mode).
+ */
+export function rootContext(firstTag) {
+    if (firstTag === 'tr')
+        return 'tbody';
+    if (firstTag === 'td' || firstTag === 'th')
+        return 'tr';
+    if (firstTag === 'col')
+        return 'colgroup';
+    return TABLE_PARTS.has(firstTag) ? 'table' : 'body';
+}
+const isHtml = (el, names) => el !== undefined && el.ns === 'html' && names.has(el.name);
+function inScope(stack, name, extra) {
+    for (let k = stack.length - 1; k >= 0; k--) {
+        const el = stack[k];
+        if (el === undefined)
+            break;
+        if (el.ns === 'html' && el.name === name)
+            return true;
+        if (SCOPE[el.ns].has(el.name) || (el.ns === 'html' && el.name === extra))
+            return false;
+    }
+    return false;
+}
+/** An open <li> (or <dd>/<dt>) that a new one would close: the "in body" list-item walk. */
+function listItemOpen(stack, names) {
+    for (let k = stack.length - 1; k >= 0; k--) {
+        const el = stack[k];
+        if (el === undefined)
+            break;
+        if (isHtml(el, names))
+            return true;
+        const special = el.ns === 'html' ? SPECIAL.has(el.name) : SCOPE[el.ns].has(el.name);
+        if (special && !(el.ns === 'html' && /^(address|div|p)$/.test(el.name)))
+            return false;
+    }
+    return false;
+}
+function formattingOpen(stack, name) {
+    for (let k = stack.length - 1; k >= 0; k--) {
+        const el = stack[k];
+        if (el === undefined || isHtml(el, FORMATTING_MARKERS))
+            return false;
+        if (el.ns === 'html' && el.name === name)
+            return true;
+    }
+    return false;
+}
+function inTableMessage(name, ctx) {
+    const where = ctx === 'tbody' ? '<tbody>' : `<${ctx}>`;
+    if (name === 'tr' || ((name === 'td' || name === 'th') && ctx === 'table')) {
+        return msg.repaired(`<${name}> directly inside ${where}`, 'Wrap rows in <tbody>: <table><tbody><tr><td>…</td></tr></tbody></table>.');
+    }
+    if (name === 'td' || name === 'th') {
+        return msg.repaired(`<${name}> directly inside ${where}`, 'Wrap cells in <tr>.');
+    }
+    if (name === 'col')
+        return msg.repaired(`<col> directly inside ${where}`, 'Wrap it in <colgroup>.');
+    if (ctx === 'colgroup')
+        return msg.repaired(`<${name}> inside <colgroup>`, 'Only <col> goes there.');
+    return msg.repaired(`<${name}> directly inside ${where}`, 'The parser moves it out of the table. Put it inside a <td>, <th> or <caption>.');
+}
+/**
+ * Rule 7 for a start tag in the HTML namespace. `atRoot`: the container is the template root
+ * or a <template>'s content, where content the parser would foster-parent stays in place.
+ * Returns the error message, or undefined when the parser keeps the tag where it is written.
+ */
+export function startRepair(name, ctx, atRoot, stack, hiddenInput) {
+    if (ctx !== 'body') {
+        if (ALLOWED[ctx].has(name) || (ctx === 'table' && name === 'input' && hiddenInput))
+            return;
+        if (atRoot && ctx !== 'colgroup' && !TABLE_PARTS.has(name))
+            return;
+        return inTableMessage(name, ctx);
+    }
+    const top = stack.at(-1);
+    if (TABLE_PARTS.has(name)) {
+        return msg.repaired(`<${name}> outside its table structure is dropped by the parser`, `Put it where it belongs: <table><tbody><tr><td>…</td></tr></tbody></table>.`);
+    }
+    if (CLOSES_P.has(name) && inScope(stack, 'p', 'button')) {
+        return msg.repaired(`<${name}> inside <p>: a paragraph holds only phrasing content, so the parser closes it`, `Close </p> before <${name}>, or use a <div> instead of the <p>.`);
+    }
+    if (name === 'li' && listItemOpen(stack, LI)) {
+        return msg.repaired('<li> inside another <li> closes the first one', 'Close </li> first, or nest a list: <li>…<ul><li>…</li></ul></li>.');
+    }
+    if ((name === 'dd' || name === 'dt') && listItemOpen(stack, DD_DT)) {
+        return msg.repaired(`<${name}> inside <dd> or <dt> closes it`, 'Close it first.');
+    }
+    if (name === 'a' && formattingOpen(stack, 'a')) {
+        return msg.repaired("<a> inside <a>: links can't nest", 'Close the first </a> before the next <a>.');
+    }
+    if (name === 'form' &&
+        stack.some((el) => isHtml(el, FORM)) &&
+        !stack.some((el) => isHtml(el, TEMPLATE))) {
+        return msg.repaired('<form> inside <form> is dropped by the parser', 'Forms can\'t nest: close the first form, and point controls at a form with form="id".');
+    }
+    if (HEADINGS.has(name) && isHtml(top, HEADINGS)) {
+        return msg.repaired(`<${name}> inside a heading closes it`, 'Close the first heading first.');
+    }
+    if (name === 'button' && inScope(stack, 'button')) {
+        return msg.repaired('<button> inside <button> closes the first one', "Buttons can't nest.");
+    }
+    if ((name === 'option' || name === 'optgroup') && isHtml(top, OPTION)) {
+        return msg.repaired(`<${name}> inside <option> closes it`, 'Close </option> first.');
+    }
+    return undefined;
+}
+/** Rule 7 for static text: non-whitespace text in table structure is moved out of it. */
+export function textRepair(raw, ctx, atRoot) {
+    if (ctx === 'body' || !/[^\t\n\f\r ]/.test(raw) || (atRoot && ctx !== 'colgroup'))
+        return;
+    return msg.repaired('Text directly inside table structure', 'The parser moves it out of the table. Put text inside a <td>, <th> or <caption>.');
+}
+/** Rule 7 in SVG/MathML: HTML tags that end the foreign element. */
+export function breaksOutOfForeign(name, hasFontAttr) {
+    return BREAKOUT.has(name) || (name === 'font' && hasFontAttr);
+}
+//# sourceMappingURL=repairs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repairs.js","sourceRoot":"","sources":["../../../src/view/normalize/repairs.ts"],"names":[],"mappings":"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","sourcesContent":["// Rule 7 by structure (view/09-template-rules.md \"How rule 7 is checked\"): start tags and text\n// that the WHATWG HTML tree builder would move, drop or implicitly close something for, checked\n// against the open-element stack. Only real repairs are flagged; the browser's own parse\n// (prepare.ts) and the compiler's parse5 check catch anything this misses.\nimport { msg } from './rules.js';\n\nexport type Ns = 'html' | 'svg' | 'math';\n\nexport interface OpenElement {\n  readonly name: string;\n  readonly ns: Ns;\n}\n\n/** How the tree builder treats content of a container (its insertion mode, roughly). */\nexport type Context = 'body' | 'table' | 'tbody' | 'tr' | 'colgroup';\n\nconst set = (names: string): ReadonlySet<string> => new Set(names.split(' '));\n\nconst TABLE_PARTS = set('caption col colgroup tbody td tfoot th thead tr');\nconst ALLOWED: Record<Exclude<Context, 'body'>, ReadonlySet<string>> = {\n  table: set('caption colgroup thead tbody tfoot script style template'),\n  tbody: set('tr script style template'),\n  tr: set('td th script style template'),\n  colgroup: set('col template'),\n};\nconst CLOSES_P = set(\n  'address article aside blockquote center details dialog dir div dl fieldset figcaption ' +\n    'figure footer header hgroup main menu nav ol p search section summary ul h1 h2 h3 h4 h5 h6 ' +\n    'pre listing form plaintext table hr xmp li dd dt',\n);\nconst HEADINGS = set('h1 h2 h3 h4 h5 h6');\nconst SCOPE: Record<Ns, ReadonlySet<string>> = {\n  html: set('applet caption html table td th marquee object template'),\n  math: set('mi mo mn ms mtext annotation-xml'),\n  svg: set('foreignobject desc title'),\n};\nconst SPECIAL = set(\n  'address applet area article aside base basefont bgsound blockquote body br button caption ' +\n    'center col colgroup dd details dir div dl dt embed fieldset figcaption figure footer form ' +\n    'frame frameset h1 h2 h3 h4 h5 h6 head header hgroup hr html iframe img input keygen li link ' +\n    'listing main marquee menu meta nav noembed noframes noscript object ol p param plaintext ' +\n    'pre script search section select source style summary table tbody td template textarea ' +\n    'tfoot th thead title tr track ul wbr xmp',\n);\nconst LI = set('li');\nconst DD_DT = set('dd dt');\nconst FORM = set('form');\nconst TEMPLATE = set('template');\nconst OPTION = set('option');\nconst FORMATTING_MARKERS = set('applet marquee object template td th caption');\nconst BREAKOUT = set(\n  'b big blockquote body br center code dd div dl dt em embed h1 h2 h3 h4 h5 h6 head hr i img ' +\n    'li listing menu meta nobr ol p pre ruby s small span strong strike sub sup table tt u ul var',\n);\n\n/** The context an element's children are parsed in. */\nexport function contextOf(name: string): Context {\n  if (name === 'table') return 'table';\n  if (name === 'tbody' || name === 'thead' || name === 'tfoot') return 'tbody';\n  if (name === 'tr' || name === 'colgroup') return name;\n  return 'body';\n}\n\n/**\n * The context of a template root or <template> content: decided by its first start tag\n * (the \"in template\" insertion mode).\n */\nexport function rootContext(firstTag: string): Context {\n  if (firstTag === 'tr') return 'tbody';\n  if (firstTag === 'td' || firstTag === 'th') return 'tr';\n  if (firstTag === 'col') return 'colgroup';\n  return TABLE_PARTS.has(firstTag) ? 'table' : 'body';\n}\n\nconst isHtml = (el: OpenElement | undefined, names: ReadonlySet<string>): boolean =>\n  el !== undefined && el.ns === 'html' && names.has(el.name);\n\nfunction inScope(stack: readonly OpenElement[], name: string, extra?: string): boolean {\n  for (let k = stack.length - 1; k >= 0; k--) {\n    const el = stack[k];\n    if (el === undefined) break;\n    if (el.ns === 'html' && el.name === name) return true;\n    if (SCOPE[el.ns].has(el.name) || (el.ns === 'html' && el.name === extra)) return false;\n  }\n  return false;\n}\n\n/** An open <li> (or <dd>/<dt>) that a new one would close: the \"in body\" list-item walk. */\nfunction listItemOpen(stack: readonly OpenElement[], names: ReadonlySet<string>): boolean {\n  for (let k = stack.length - 1; k >= 0; k--) {\n    const el = stack[k];\n    if (el === undefined) break;\n    if (isHtml(el, names)) return true;\n    const special = el.ns === 'html' ? SPECIAL.has(el.name) : SCOPE[el.ns].has(el.name);\n    if (special && !(el.ns === 'html' && /^(address|div|p)$/.test(el.name))) return false;\n  }\n  return false;\n}\n\nfunction formattingOpen(stack: readonly OpenElement[], name: string): boolean {\n  for (let k = stack.length - 1; k >= 0; k--) {\n    const el = stack[k];\n    if (el === undefined || isHtml(el, FORMATTING_MARKERS)) return false;\n    if (el.ns === 'html' && el.name === name) return true;\n  }\n  return false;\n}\n\nfunction inTableMessage(name: string, ctx: Exclude<Context, 'body'>): string {\n  const where = ctx === 'tbody' ? '<tbody>' : `<${ctx}>`;\n  if (name === 'tr' || ((name === 'td' || name === 'th') && ctx === 'table')) {\n    return msg.repaired(\n      `<${name}> directly inside ${where}`,\n      'Wrap rows in <tbody>: <table><tbody><tr><td>…</td></tr></tbody></table>.',\n    );\n  }\n  if (name === 'td' || name === 'th') {\n    return msg.repaired(`<${name}> directly inside ${where}`, 'Wrap cells in <tr>.');\n  }\n  if (name === 'col')\n    return msg.repaired(`<col> directly inside ${where}`, 'Wrap it in <colgroup>.');\n  if (ctx === 'colgroup')\n    return msg.repaired(`<${name}> inside <colgroup>`, 'Only <col> goes there.');\n  return msg.repaired(\n    `<${name}> directly inside ${where}`,\n    'The parser moves it out of the table. Put it inside a <td>, <th> or <caption>.',\n  );\n}\n\n/**\n * Rule 7 for a start tag in the HTML namespace. `atRoot`: the container is the template root\n * or a <template>'s content, where content the parser would foster-parent stays in place.\n * Returns the error message, or undefined when the parser keeps the tag where it is written.\n */\nexport function startRepair(\n  name: string,\n  ctx: Context,\n  atRoot: boolean,\n  stack: readonly OpenElement[],\n  hiddenInput: boolean,\n): string | undefined {\n  if (ctx !== 'body') {\n    if (ALLOWED[ctx].has(name) || (ctx === 'table' && name === 'input' && hiddenInput)) return;\n    if (atRoot && ctx !== 'colgroup' && !TABLE_PARTS.has(name)) return;\n    return inTableMessage(name, ctx);\n  }\n  const top = stack.at(-1);\n  if (TABLE_PARTS.has(name)) {\n    return msg.repaired(\n      `<${name}> outside its table structure is dropped by the parser`,\n      `Put it where it belongs: <table><tbody><tr><td>…</td></tr></tbody></table>.`,\n    );\n  }\n  if (CLOSES_P.has(name) && inScope(stack, 'p', 'button')) {\n    return msg.repaired(\n      `<${name}> inside <p>: a paragraph holds only phrasing content, so the parser closes it`,\n      `Close </p> before <${name}>, or use a <div> instead of the <p>.`,\n    );\n  }\n  if (name === 'li' && listItemOpen(stack, LI)) {\n    return msg.repaired(\n      '<li> inside another <li> closes the first one',\n      'Close </li> first, or nest a list: <li>…<ul><li>…</li></ul></li>.',\n    );\n  }\n  if ((name === 'dd' || name === 'dt') && listItemOpen(stack, DD_DT)) {\n    return msg.repaired(`<${name}> inside <dd> or <dt> closes it`, 'Close it first.');\n  }\n  if (name === 'a' && formattingOpen(stack, 'a')) {\n    return msg.repaired(\n      \"<a> inside <a>: links can't nest\",\n      'Close the first </a> before the next <a>.',\n    );\n  }\n  if (\n    name === 'form' &&\n    stack.some((el) => isHtml(el, FORM)) &&\n    !stack.some((el) => isHtml(el, TEMPLATE))\n  ) {\n    return msg.repaired(\n      '<form> inside <form> is dropped by the parser',\n      'Forms can\\'t nest: close the first form, and point controls at a form with form=\"id\".',\n    );\n  }\n  if (HEADINGS.has(name) && isHtml(top, HEADINGS)) {\n    return msg.repaired(`<${name}> inside a heading closes it`, 'Close the first heading first.');\n  }\n  if (name === 'button' && inScope(stack, 'button')) {\n    return msg.repaired('<button> inside <button> closes the first one', \"Buttons can't nest.\");\n  }\n  if ((name === 'option' || name === 'optgroup') && isHtml(top, OPTION)) {\n    return msg.repaired(`<${name}> inside <option> closes it`, 'Close </option> first.');\n  }\n  return undefined;\n}\n\n/** Rule 7 for static text: non-whitespace text in table structure is moved out of it. */\nexport function textRepair(raw: string, ctx: Context, atRoot: boolean): string | undefined {\n  if (ctx === 'body' || !/[^\\t\\n\\f\\r ]/.test(raw) || (atRoot && ctx !== 'colgroup')) return;\n  return msg.repaired(\n    'Text directly inside table structure',\n    'The parser moves it out of the table. Put text inside a <td>, <th> or <caption>.',\n  );\n}\n\n/** Rule 7 in SVG/MathML: HTML tags that end the foreign element. */\nexport function breaksOutOfForeign(name: string, hasFontAttr: boolean): boolean {\n  return BREAKOUT.has(name) || (name === 'font' && hasFontAttr);\n}\n"]}