@gyral/core 0.1.0 → 0.3.0

package/dist/view/normalize/check.js

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

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

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

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

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

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;