@gyral/core 0.2.0 → 0.3.1

package/dist/view/render/adopt.js

@@ -0,0 +1,286 @@
+// The parallel walk (view/07-hydration.md "The parallel walk"): visits a template's static
+// structure (its parsed content) and the server DOM together, and builds the same parts the
+// client renderer would, with this render's values as committed values. It writes nothing,
+// except splitting merged text at known lengths (`splitText`), creating the empty Text node of
+// an `''` value, joining text the parser split, removing development markers, and writing a
+// `style` attribute a strict CSP blocked through the CSSOM. Nested templates, lists (rows one
+// after another, no markers), arrays and `raw()` are walked in turn. Nested Gyral hosts: a
+// shadow host's light children are the parent's content (slotted) and are walked; its shadow
+// root never is; a light host (`data-gyral-light`) is opaque.
+// Development checks every node, text and bound attribute, and the `<!--gyral:ID-->` markers
+// when present; production checks node types, local names and text lengths.
+import { DEV } from '#view-dev';
+import { LIGHT_ATTRIBUTE } from '../attributes.js';
+import { CHILD_BEFORE } from '../normalize/types.js';
+import { isTemplateResult, sourceOf, templateOf } from '../template.js';
+import { adoptionOf } from './adopt-plan.js';
+import { adoptAttr, checkAttr } from './adopt-attr.js';
+import { attrPart, TEXTAREA, TITLE } from './attr-parts.js';
+import { ChildPart, INSTANCE, ITEMS, LIST, RAW, TEXT } from './child-part.js';
+import { checkKeys } from './dev-check.js';
+import { Instance } from './instance.js';
+import { mismatch } from './mismatch.js';
+import { ROOT, SOLE } from './plan.js';
+import { parse, RawRange } from './raw.js';
+import { report } from './seen.js';
+import { List } from './rows.js';
+import { isList, rawHtml } from './values.js';
+/** The walk's position: the next DOM node; null at the end of `parent`'s children. */
+let cur = null;
+let parent;
+/** For mismatch messages: the host's root, the component, the template being walked. */
+let top;
+let host = '';
+let current;
+const fail = (expected, found = cur, at = parent) => mismatch(expected, found, at, top, host, current?.loc);
+/** Adopts the server DOM in `root` (a host's root) as `part`'s content for `value`. */
+export function adopt(part, value, root, label) {
+    top = parent = root;
+    cur = root.firstChild;
+    host = label;
+    current = undefined;
+    content(part, value);
+    if (cur !== null)
+        fail('the end of the view');
+}
+/** A child value at the walk's position (view/02-bindings.md "Child values"). */
+function content(part, v) {
+    switch (typeof v) {
+        case 'string':
+        case 'number': {
+            const data = typeof v === 'string' ? v : String(v);
+            part.kind = TEXT;
+            part.value = v;
+            if (data !== '')
+                part.content = text(data);
+            else
+                parent.insertBefore((part.content = document.createTextNode('')), cur);
+            return;
+        }
+        case 'object':
+            if (v === null)
+                return;
+            if (isTemplateResult(v)) {
+                part.kind = INSTANCE;
+                part.content = instance(v, part);
+            }
+            else if (isList(v))
+                rows(part, v.items, v);
+            else if (Array.isArray(v))
+                rows(part, v, undefined);
+            else {
+                const markup = rawHtml(v);
+                if (markup !== undefined)
+                    raw(part, markup);
+                else if (DEV)
+                    part.commit(v);
+            }
+            return;
+        default:
+            // Development: a value no hole renders throws (or warns, for `true`) as on the client.
+            // Called through the part, so this chunk imports no development-only function.
+            if (DEV)
+                part.commit(v);
+    }
+}
+/** Static text or a text value: exactly `want`'s length, split off a longer Text node. */
+function text(want) {
+    // The parser turns CR and CRLF into LF.
+    const data = want.includes('\r') ? want.replace(/\r\n?/g, '\n') : want;
+    const t = cur;
+    if (t !== null && t.nodeType === 3) {
+        // Join text the parser split (very long runs).
+        for (let n = t.nextSibling; t.length < data.length && n !== null && n.nodeType === 3;) {
+            t.appendData(n.data);
+            n.remove();
+            n = t.nextSibling;
+        }
+        if (t.length >= data.length && (!DEV || t.data.startsWith(data))) {
+            if (t.length > data.length)
+                t.splitText(data.length);
+            cur = t.nextSibling;
+            return t;
+        }
+    }
+    return fail(`text ${JSON.stringify(data.slice(0, 40))}`);
+}
+function instance(result, holder) {
+    const template = templateOf(result);
+    if (DEV && template.svg && !svgContent(parent)) {
+        fail(`an svg template inside SVG content (view/01-templates.md "svg templates")`, parent);
+    }
+    const a = adoptionOf(template);
+    // A development server's marker: checked when present (a production server writes none),
+    // against the id when the template has one (production client objects don't, 01).
+    const marker = cur;
+    if (marker !== null && marker.nodeType === 8 && marker.data.startsWith('gyral:')) {
+        const id = template.id;
+        if (DEV && id !== undefined && marker.data !== `gyral:${id}`)
+            fail(`<!--gyral:${id}-->`);
+        cur = marker.nextSibling;
+        marker.remove();
+    }
+    const outer = current;
+    current = template;
+    const inst = new Instance(template, sourceOf(result), holder, true);
+    children(a.plan.content, a, inst, result.values);
+    current = outer;
+    return inst;
+}
+/** The children of template node `t`, with the child holes between them. */
+function children(t, a, inst, values) {
+    const holes = a.holes.get(t);
+    const root = t === a.plan.content;
+    let h = 0;
+    for (let n = t.firstChild, j = 0;; n = n.nextSibling, j++) {
+        if (holes !== undefined && h < holes.length) {
+            const i = holes[h];
+            const spec = a.specs[i];
+            const ref = spec[0] === CHILD_BEFORE ? spec[2] : null;
+            if (n === null ? ref === null : ref === j) {
+                hole(i, ref, a, inst, values);
+                h++;
+            }
+        }
+        if (n === null)
+            return;
+        const dom = node(n, a, inst, values);
+        if (root) {
+            if (j === 0)
+                inst.start = dom;
+            inst.end = dom;
+        }
+    }
+}
+/** A child hole: its content, then its reference node (the DOM node the walk reached). */
+function hole(i, ref, a, inst, values) {
+    const kind = a.plan.kinds[i];
+    const at = a.plan.at[i];
+    const part = kind === ROOT
+        ? new ChildPart(null, null, null, 0, false, at)
+        : new ChildPart(parent, null, null, 0, kind === SOLE, at);
+    inst.parts[i] = part;
+    content(part, values[at]);
+    if (ref !== null) {
+        part.ref = cur;
+        if (kind === ROOT && ref === 0)
+            inst.head = part;
+    }
+    else if (kind === ROOT) {
+        part.owner = inst;
+        inst.tail = part;
+    }
+}
+function node(t, a, inst, values) {
+    if (t.nodeType === 3)
+        return text(t.data);
+    if (t.nodeType !== 8)
+        return element(t, a, inst, values);
+    const c = cur;
+    if (c === null || c.nodeType !== 8 || (DEV && c.data !== t.data)) {
+        return fail(`<!--${t.data}-->`);
+    }
+    cur = c.nextSibling;
+    return c;
+}
+const WHITESPACE_ONLY = /^[\t\n\f\r ]*$/;
+/**
+ * Development: where an svg template may be (warn.ts `checkSvgParent`, checked here so the lazy
+ * chunk imports no development-only function: production bundles drop this).
+ */
+const svgContent = (el) => el.namespaceURI === 'http://www.w3.org/2000/svg' &&
+    !/^(foreignObject|desc|title)$/.test(el.localName);
+function element(t, a, inst, values) {
+    const el = cur;
+    if (el === null || el.localName !== t.localName)
+        return fail(`<${t.localName}>`);
+    cur = el.nextSibling;
+    let whole = false;
+    for (const i of a.attrs.get(t) ?? []) {
+        const kind = a.plan.kinds[i];
+        const part = attrPart(el, kind, a.specs[i], a.plan.at[i]);
+        inst.parts[i] = part;
+        adoptAttr(part, values);
+        if (DEV)
+            checkAttr(part, fail);
+        // A server-written style a strict CSP blocked has no declarations: write the adopted value
+        // through the CSSOM, which the CSP allows (08 "Style attributes under a strict CSP").
+        // After the development check, which compares the attribute as the server wrote it.
+        const v = part.value;
+        if (part.name === 'style' && typeof v === 'string' && !el.style.length) {
+            part.write(v);
+        }
+        if (kind === TEXTAREA || kind === TITLE)
+            whole = true; // the part owns the content
+    }
+    let holes = a.holes.has(t);
+    if (whole)
+        return el;
+    if (el.hasAttribute(LIGHT_ATTRIBUTE)) {
+        // A light host owns its children (ADR 0014): its parent writes none (06 "Components").
+        for (let c = t.firstChild; c !== null; c = c.nextSibling) {
+            if (c.nodeType !== 3 || !WHITESPACE_ONLY.test(c.data))
+                holes = true;
+        }
+        if (holes)
+            fail(`no children from the parent in light host <${t.localName}>`, el, el);
+        return el;
+    }
+    // A custom element without children in the template: what it holds is its own.
+    if (!holes && t.firstChild === null && t.localName.includes('-'))
+        return el;
+    const outer = cur;
+    const outerParent = parent;
+    parent = el;
+    cur = el.firstChild;
+    children(t, a, inst, values);
+    if (cur !== null)
+        fail(`the end of <${t.localName}>`);
+    cur = outer;
+    parent = outerParent;
+    return el;
+}
+/** Rows of `each` (keyed) or items of an array (`l` undefined), one after another. */
+function rows(part, values, l) {
+    const list = new List(part);
+    part.kind = l === undefined ? ITEMS : LIST;
+    part.content = list;
+    if (DEV && l !== undefined)
+        checkKeys(values, l.key);
+    for (let i = 0; i < values.length; i++) {
+        const row = new ChildPart(null, null, list, i, false, -1);
+        list.rows.push(row);
+        if (l === undefined) {
+            content(row, values[i]);
+            continue;
+        }
+        const item = values[i];
+        row.key = l.key(item);
+        row.item = item;
+        row.picked = l.pick === undefined ? undefined : l.pick(item);
+        content(row, l.row(item, row.picked));
+    }
+}
+/** `raw()`: its start anchor, then the nodes its markup parses to (texts by length). */
+function raw(part, markup) {
+    report({ html: markup });
+    const start = cur;
+    if (start === null || start.nodeType !== 8)
+        return fail('the raw() start anchor <!---->');
+    cur = start.nextSibling;
+    let end = start;
+    for (let n = parse(markup).firstChild; n !== null; n = n.nextSibling) {
+        if (n.nodeType === 3)
+            end = text(n.data);
+        else {
+            const dom = cur;
+            if (dom === null || dom.nodeName !== n.nodeName)
+                return fail(`raw() markup's ${n.nodeName}`);
+            end = dom;
+            cur = dom.nextSibling;
+        }
+    }
+    part.kind = RAW;
+    part.content = new RawRange(start, end, markup);
+}
+//# sourceMappingURL=adopt.js.map

package/dist/view/render/adopt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt.js","sourceRoot":"","sources":["../../../src/view/render/adopt.ts"],"names":[],"mappings":"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","sourcesContent":["// The parallel walk (view/07-hydration.md \"The parallel walk\"): visits a template's static\n// structure (its parsed content) and the server DOM together, and builds the same parts the\n// client renderer would, with this render's values as committed values. It writes nothing,\n// except splitting merged text at known lengths (`splitText`), creating the empty Text node of\n// an `''` value, joining text the parser split, removing development markers, and writing a\n// `style` attribute a strict CSP blocked through the CSSOM. Nested templates, lists (rows one\n// after another, no markers), arrays and `raw()` are walked in turn. Nested Gyral hosts: a\n// shadow host's light children are the parent's content (slotted) and are walked; its shadow\n// root never is; a light host (`data-gyral-light`) is opaque.\n// Development checks every node, text and bound attribute, and the `<!--gyral:ID-->` markers\n// when present; production checks node types, local names and text lengths.\nimport { DEV } from '#view-dev';\nimport { LIGHT_ATTRIBUTE } from '../attributes.js';\nimport { CHILD_BEFORE, type PartSpec, type TemplateObject } from '../normalize/types.js';\nimport { isTemplateResult, sourceOf, templateOf, type TemplateResult } from '../template.js';\nimport { adoptionOf, type Adoption } from './adopt-plan.js';\nimport { adoptAttr, checkAttr } from './adopt-attr.js';\nimport { attrPart, TEXTAREA, TITLE } from './attr-parts.js';\nimport { ChildPart, INSTANCE, ITEMS, LIST, RAW, TEXT } from './child-part.js';\nimport { checkKeys } from './dev-check.js';\nimport { Instance } from './instance.js';\nimport { mismatch } from './mismatch.js';\nimport { ROOT, SOLE } from './plan.js';\nimport { parse, RawRange } from './raw.js';\nimport { report } from './seen.js';\nimport { List } from './rows.js';\nimport { isList, rawHtml, type ListResult } from './values.js';\n\n/** The walk's position: the next DOM node; null at the end of `parent`'s children. */\nlet cur: Node | null = null;\nlet parent: Node;\n/** For mismatch messages: the host's root, the component, the template being walked. */\nlet top: Node;\nlet host = '';\nlet current: TemplateObject | undefined;\n\nconst fail = (expected: string, found: Node | string | null = cur, at: Node = parent): never =>\n  mismatch(expected, found, at, top, host, current?.loc);\n\n/** Adopts the server DOM in `root` (a host's root) as `part`'s content for `value`. */\nexport function adopt(part: ChildPart, value: unknown, root: Node, label: string): void {\n  top = parent = root;\n  cur = root.firstChild;\n  host = label;\n  current = undefined;\n  content(part, value);\n  if (cur !== null) fail('the end of the view');\n}\n\n/** A child value at the walk's position (view/02-bindings.md \"Child values\"). */\nfunction content(part: ChildPart, v: unknown): void {\n  switch (typeof v) {\n    case 'string':\n    case 'number': {\n      const data = typeof v === 'string' ? v : String(v);\n      part.kind = TEXT;\n      part.value = v;\n      if (data !== '') part.content = text(data);\n      else parent.insertBefore((part.content = document.createTextNode('')), cur);\n      return;\n    }\n    case 'object':\n      if (v === null) return;\n      if (isTemplateResult(v)) {\n        part.kind = INSTANCE;\n        part.content = instance(v, part);\n      } else if (isList(v)) rows(part, v.items, v);\n      else if (Array.isArray(v)) rows(part, v, undefined);\n      else {\n        const markup = rawHtml(v);\n        if (markup !== undefined) raw(part, markup);\n        else if (DEV) part.commit(v);\n      }\n      return;\n    default:\n      // Development: a value no hole renders throws (or warns, for `true`) as on the client.\n      // Called through the part, so this chunk imports no development-only function.\n      if (DEV) part.commit(v);\n  }\n}\n\n/** Static text or a text value: exactly `want`'s length, split off a longer Text node. */\nfunction text(want: string): Text {\n  // The parser turns CR and CRLF into LF.\n  const data = want.includes('\\r') ? want.replace(/\\r\\n?/g, '\\n') : want;\n  const t = cur as Text | null;\n  if (t !== null && t.nodeType === 3) {\n    // Join text the parser split (very long runs).\n    for (let n = t.nextSibling; t.length < data.length && n !== null && n.nodeType === 3;) {\n      t.appendData((n as Text).data);\n      (n as Text).remove();\n      n = t.nextSibling;\n    }\n    if (t.length >= data.length && (!DEV || t.data.startsWith(data))) {\n      if (t.length > data.length) t.splitText(data.length);\n      cur = t.nextSibling;\n      return t;\n    }\n  }\n  return fail(`text ${JSON.stringify(data.slice(0, 40))}`);\n}\n\nfunction instance(result: TemplateResult, holder: ChildPart): Instance {\n  const template = templateOf(result);\n  if (DEV && template.svg && !svgContent(parent)) {\n    fail(`an svg template inside SVG content (view/01-templates.md \"svg templates\")`, parent);\n  }\n  const a = adoptionOf(template);\n  // A development server's marker: checked when present (a production server writes none),\n  // against the id when the template has one (production client objects don't, 01).\n  const marker = cur as Comment | null;\n  if (marker !== null && marker.nodeType === 8 && marker.data.startsWith('gyral:')) {\n    const id = template.id;\n    if (DEV && id !== undefined && marker.data !== `gyral:${id}`) fail(`<!--gyral:${id}-->`);\n    cur = marker.nextSibling;\n    marker.remove();\n  }\n  const outer = current;\n  current = template;\n  const inst = new Instance(template, sourceOf(result), holder, true);\n  children(a.plan.content, a, inst, result.values);\n  current = outer;\n  return inst;\n}\n\n/** The children of template node `t`, with the child holes between them. */\nfunction children(t: Node, a: Adoption, inst: Instance, values: readonly unknown[]): void {\n  const holes = a.holes.get(t);\n  const root = t === a.plan.content;\n  let h = 0;\n  for (let n = t.firstChild, j = 0; ; n = n.nextSibling, j++) {\n    if (holes !== undefined && h < holes.length) {\n      const i = holes[h] as number;\n      const spec = a.specs[i] as PartSpec;\n      const ref = spec[0] === CHILD_BEFORE ? spec[2] : null;\n      if (n === null ? ref === null : ref === j) {\n        hole(i, ref, a, inst, values);\n        h++;\n      }\n    }\n    if (n === null) return;\n    const dom = node(n, a, inst, values);\n    if (root) {\n      if (j === 0) inst.start = dom;\n      inst.end = dom;\n    }\n  }\n}\n\n/** A child hole: its content, then its reference node (the DOM node the walk reached). */\nfunction hole(\n  i: number,\n  ref: number | null,\n  a: Adoption,\n  inst: Instance,\n  values: readonly unknown[],\n): void {\n  const kind = a.plan.kinds[i] as number;\n  const at = a.plan.at[i] as number;\n  const part =\n    kind === ROOT\n      ? new ChildPart(null, null, null, 0, false, at)\n      : new ChildPart(parent, null, null, 0, kind === SOLE, at);\n  inst.parts[i] = part;\n  content(part, values[at]);\n  if (ref !== null) {\n    part.ref = cur;\n    if (kind === ROOT && ref === 0) inst.head = part;\n  } else if (kind === ROOT) {\n    part.owner = inst;\n    inst.tail = part;\n  }\n}\n\nfunction node(t: Node, a: Adoption, inst: Instance, values: readonly unknown[]): Node {\n  if (t.nodeType === 3) return text((t as Text).data);\n  if (t.nodeType !== 8) return element(t as Element, a, inst, values);\n  const c = cur as Comment | null;\n  if (c === null || c.nodeType !== 8 || (DEV && c.data !== (t as Comment).data)) {\n    return fail(`<!--${(t as Comment).data}-->`);\n  }\n  cur = c.nextSibling;\n  return c;\n}\n\nconst WHITESPACE_ONLY = /^[\\t\\n\\f\\r ]*$/;\n\n/**\n * Development: where an svg template may be (warn.ts `checkSvgParent`, checked here so the lazy\n * chunk imports no development-only function: production bundles drop this).\n */\nconst svgContent = (el: Node): boolean =>\n  (el as Element).namespaceURI === 'http://www.w3.org/2000/svg' &&\n  !/^(foreignObject|desc|title)$/.test((el as Element).localName);\n\nfunction element(t: Element, a: Adoption, inst: Instance, values: readonly unknown[]): Element {\n  const el = cur as Element | null;\n  if (el === null || el.localName !== t.localName) return fail(`<${t.localName}>`);\n  cur = el.nextSibling;\n  let whole = false;\n  for (const i of a.attrs.get(t) ?? []) {\n    const kind = a.plan.kinds[i] as number;\n    const part = attrPart(el, kind, a.specs[i] as PartSpec, a.plan.at[i] as number);\n    inst.parts[i] = part;\n    adoptAttr(part, values);\n    if (DEV) checkAttr(part, fail);\n    // A server-written style a strict CSP blocked has no declarations: write the adopted value\n    // through the CSSOM, which the CSP allows (08 \"Style attributes under a strict CSP\").\n    // After the development check, which compares the attribute as the server wrote it.\n    const v = part.value;\n    if (part.name === 'style' && typeof v === 'string' && !(el as HTMLElement).style.length) {\n      part.write(v);\n    }\n    if (kind === TEXTAREA || kind === TITLE) whole = true; // the part owns the content\n  }\n  let holes = a.holes.has(t);\n  if (whole) return el;\n  if (el.hasAttribute(LIGHT_ATTRIBUTE)) {\n    // A light host owns its children (ADR 0014): its parent writes none (06 \"Components\").\n    for (let c = t.firstChild; c !== null; c = c.nextSibling) {\n      if (c.nodeType !== 3 || !WHITESPACE_ONLY.test((c as Text).data)) holes = true;\n    }\n    if (holes) fail(`no children from the parent in light host <${t.localName}>`, el, el);\n    return el;\n  }\n  // A custom element without children in the template: what it holds is its own.\n  if (!holes && t.firstChild === null && t.localName.includes('-')) return el;\n  const outer = cur;\n  const outerParent = parent;\n  parent = el;\n  cur = el.firstChild;\n  children(t, a, inst, values);\n  if (cur !== null) fail(`the end of <${t.localName}>`);\n  cur = outer;\n  parent = outerParent;\n  return el;\n}\n\n/** Rows of `each` (keyed) or items of an array (`l` undefined), one after another. */\nfunction rows(part: ChildPart, values: readonly unknown[], l: ListResult | undefined): void {\n  const list = new List(part);\n  part.kind = l === undefined ? ITEMS : LIST;\n  part.content = list;\n  if (DEV && l !== undefined) checkKeys(values, l.key);\n  for (let i = 0; i < values.length; i++) {\n    const row = new ChildPart(null, null, list, i, false, -1);\n    list.rows.push(row);\n    if (l === undefined) {\n      content(row, values[i]);\n      continue;\n    }\n    const item = values[i];\n    row.key = l.key(item);\n    row.item = item;\n    row.picked = l.pick === undefined ? undefined : l.pick(item);\n    content(row, l.row(item, row.picked));\n  }\n}\n\n/** `raw()`: its start anchor, then the nodes its markup parses to (texts by length). */\nfunction raw(part: ChildPart, markup: string): void {\n  report({ html: markup });\n  const start = cur as Comment | null;\n  if (start === null || start.nodeType !== 8) return fail('the raw() start anchor <!---->');\n  cur = start.nextSibling;\n  let end: Node = start;\n  for (let n = parse(markup).firstChild; n !== null; n = n.nextSibling) {\n    if (n.nodeType === 3) end = text((n as Text).data);\n    else {\n      const dom = cur;\n      if (dom === null || dom.nodeName !== n.nodeName) return fail(`raw() markup's ${n.nodeName}`);\n      end = dom;\n      cur = dom.nextSibling;\n    }\n  }\n  part.kind = RAW;\n  part.content = new RawRange(start, end, markup);\n}\n"]}

package/dist/view/render/attr-parts.d.ts

@@ -0,0 +1,72 @@
+import type { PartSpec } from '../normalize/types.js';
+import { type HookSpec } from './hooks.js';
+/** What every part of an instance implements: commit its value(s) from this render's values. */
+export interface Part {
+    set(values: readonly unknown[]): void;
+}
+/** `name=${v}`; `value=${v}` on a non-text input becomes this after its first commit. */
+export declare const ATTR = 0;
+/** `name="a ${x} b"`. */
+export declare const MULTI = 1;
+/** `?name=${v}`. */
+export declare const BOOL = 2;
+/** `.name=${v}`. */
+export declare const PROP = 3;
+/** `value=${v}` on `<input>`: live `.value`. */
+export declare const VALUE = 4;
+/** `?checked` on `<input>`, `?selected` on `<option>`: attribute first, then the live property. */
+export declare const CHECKED = 5;
+/** `?indeterminate` on `<input>`: the property only. */
+export declare const STATE = 6;
+/** `?open` on `<details>`/`<dialog>`: the attribute, compared with its live presence. */
+export declare const OPEN = 7;
+/** `<title>${v}</title>`: text content. */
+export declare const TITLE = 8;
+/** `<textarea>${v}</textarea>`: text content first, then the live `.value`. */
+export declare const TEXTAREA = 9;
+/** `${hook(…)}` in a start tag. */
+export declare const HOOK = 10;
+/** `?modal` on `<dialog>`, `?popover-open` on `[popover]`: opened and closed (toggles.ts). */
+export declare const TOGGLE = 11;
+/** Input types whose `value` is a submitted value, not state the user edits. */
+export declare const PLAIN: RegExp;
+export declare const absent: (v: unknown) => boolean;
+export declare const truthy: (v: unknown) => boolean;
+/** The text of a `<textarea>`/`<title>` value: child-hole rules, as one string. */
+export declare function textOf(part: object, v: unknown): string;
+/** The kind of a bound attribute (`?name` when `bool`) on `el`. */
+export declare function attrKind(el: Element, name: string, bool: boolean): number;
+/** The element part for part table entry `spec`: `[kind, path, name?, strings?]` (01). */
+export declare function attrPart(el: Element, kind: number, spec: PartSpec, at: number): AttrPart;
+export declare class AttrPart implements Part {
+    readonly el: Element;
+    kind: number;
+    readonly name: string;
+    readonly at: number;
+    /** The committed value: raw (ATTR, PROP, VALUE), boolean, string (MULTI, text), or UNSET. */
+    value: unknown;
+    /** MULTI: the static strings and the committed pieces. */
+    readonly strings: readonly string[] | undefined;
+    readonly pieces: unknown[] | undefined;
+    /** HOOK: the hook, its committed arguments and the ones before. */
+    spec: HookSpec<readonly unknown[]> | null;
+    args: readonly unknown[] | undefined;
+    prev: readonly unknown[] | undefined;
+    constructor(el: Element, kind: number, name: string, at: number, strings?: readonly string[]);
+    set(values: readonly unknown[]): void;
+    /**
+     * Writes the attribute; `style` through the CSSOM (`.style.cssText`), which a strict CSP
+     * (`style-src` without `'unsafe-inline'`) allows where `setAttribute('style', …)` is blocked.
+     * HTML, SVG and MathML elements all have `.style`.
+     */
+    write(s: string): void;
+    /**
+     * MULTI: pieces joined with the static strings; `nothing` in any piece removes. With no
+     * pieces it is a static `style` attribute (01 "Normalization"): written once, at creation.
+     */
+    private multi;
+    /** The joined value of `pieces`, or null when one is `nothing`. */
+    join(pieces: readonly unknown[]): string | null;
+    /** HOOK: the result commits itself (hook-part.ts); an absent value forgets the hook. */
+    hook(v: unknown): void;
+}

package/dist/view/render/attr-parts.js

@@ -0,0 +1,262 @@
+// Element parts (view/02-bindings.md "Attribute values", "Boolean attributes", "Properties",
+// "Live form state", "Element hooks"): every hole on or inside one element that isn't a child
+// hole, as one class with a kind, so an instance's update loop sees only two part shapes.
+// Every part compares with its committed value and writes only on change. Live form state
+// sets the attribute too on first creation (the default, so `form.reset()` returns to the
+// model's first value); when the model's value changes it compares with the element's live
+// state and writes only on a difference, so the change lands even over a user's edit, and an
+// unchanged model never touches the control. Constructors only record nodes; hydration
+// (view/07-hydration.md) builds the same parts over server DOM and adopts this render's values
+// as committed (adopt-attr.ts), so edits made before scripts ran stay by the same rule.
+// `style` is written through the CSSOM, never `setAttribute`, so a strict CSP allows it.
+import { DEV } from '#view-dev';
+import { COMMIT_HOOK, isHook } from './hooks.js';
+import { toggle } from './toggles.js';
+import { nothing, UNSET } from './values.js';
+import { badHook, warnFunctionProp, warnToggle, warnTrue, warnValue } from './warn.js';
+/** `name=${v}`; `value=${v}` on a non-text input becomes this after its first commit. */
+export const ATTR = 0;
+/** `name="a ${x} b"`. */
+export const MULTI = 1;
+/** `?name=${v}`. */
+export const BOOL = 2;
+/** `.name=${v}`. */
+export const PROP = 3;
+/** `value=${v}` on `<input>`: live `.value`. */
+export const VALUE = 4;
+/** `?checked` on `<input>`, `?selected` on `<option>`: attribute first, then the live property. */
+export const CHECKED = 5;
+/** `?indeterminate` on `<input>`: the property only. */
+export const STATE = 6;
+/** `?open` on `<details>`/`<dialog>`: the attribute, compared with its live presence. */
+export const OPEN = 7;
+/** `<title>${v}</title>`: text content. */
+export const TITLE = 8;
+/** `<textarea>${v}</textarea>`: text content first, then the live `.value`. */
+export const TEXTAREA = 9;
+/** `${hook(…)}` in a start tag. */
+export const HOOK = 10;
+/** `?modal` on `<dialog>`, `?popover-open` on `[popover]`: opened and closed (toggles.ts). */
+export const TOGGLE = 11;
+/** Input types whose `value` is a submitted value, not state the user edits. */
+export const PLAIN = /^(checkbox|radio|hidden|button|submit|reset|image|file)$/;
+/** `String(v)`: numbers and booleans as text (objects warn in development first). */
+const text = String;
+export const absent = (v) => v === null || v === undefined || v === nothing;
+export const truthy = (v) => v !== nothing && !!v;
+const isObject = (v) => (typeof v === 'object' && v !== null) || typeof v === 'function';
+/** The text of a `<textarea>`/`<title>` value: child-hole rules, as one string. */
+export function textOf(part, v) {
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'number')
+        return String(v);
+    if (DEV) {
+        if (v === true)
+            warnTrue(part);
+        else if (isObject(v))
+            warnValue(part, v, 'the text content');
+    }
+    return absent(v) || typeof v === 'boolean' ? '' : text(v);
+}
+/** The kind of a bound attribute (`?name` when `bool`) on `el`. */
+export function attrKind(el, name, bool) {
+    const tag = el.localName;
+    if (!bool)
+        return name === 'value' && tag === 'input' ? VALUE : ATTR;
+    if (tag === 'input')
+        return name === 'checked' ? CHECKED : name === 'indeterminate' ? STATE : BOOL;
+    if (tag === 'option' && name === 'selected')
+        return CHECKED;
+    if (name === 'modal' || name === 'popover-open')
+        return TOGGLE;
+    return name === 'open' && (tag === 'details' || tag === 'dialog') ? OPEN : BOOL;
+}
+/** The element part for part table entry `spec`: `[kind, path, name?, strings?]` (01). */
+export function attrPart(el, kind, spec, at) {
+    const s = spec;
+    return new AttrPart(el, kind, s[2] ?? '', at, s[3]);
+}
+export class AttrPart {
+    constructor(el, kind, name, at, strings) {
+        this.el = el;
+        this.kind = kind;
+        this.name = name;
+        this.at = at;
+        this.value = UNSET;
+        this.strings = strings;
+        this.pieces =
+            strings === undefined ? undefined : new Array(strings.length - 1).fill(UNSET);
+        this.spec = null;
+        this.args = undefined;
+        this.prev = undefined;
+    }
+    set(values) {
+        const v = values[this.at];
+        const el = this.el;
+        const live = el;
+        switch (this.kind) {
+            case ATTR:
+                if (v === this.value)
+                    return;
+                this.value = v;
+                if (absent(v))
+                    el.removeAttribute(this.name);
+                else {
+                    if (DEV && isObject(v))
+                        warnValue(this, v, `the attribute ${this.name}`);
+                    this.write(typeof v === 'string' ? v : text(v));
+                }
+                return;
+            case MULTI:
+                this.multi(values);
+                return;
+            case BOOL: {
+                const on = truthy(v);
+                if (on === this.value)
+                    return;
+                this.value = on;
+                el.toggleAttribute(this.name, on);
+                return;
+            }
+            case PROP:
+                if (Object.is(v, this.value))
+                    return;
+                if (DEV && typeof v === 'function')
+                    warnFunctionProp(this, el, this.name);
+                this.value = v;
+                live[this.name] = v;
+                return;
+            case VALUE: {
+                if (v === this.value)
+                    return;
+                const s = absent(v) ? '' : text(v);
+                if (this.value === UNSET) {
+                    // First creation: the attribute (the default), then the live value.
+                    if (absent(v))
+                        el.removeAttribute('value');
+                    else
+                        el.setAttribute('value', s);
+                    if (PLAIN.test(el.type))
+                        this.kind = ATTR;
+                }
+                this.value = v;
+                if (this.kind === VALUE && live.value !== s)
+                    live.value = s;
+                return;
+            }
+            case CHECKED:
+            case STATE: {
+                const on = truthy(v);
+                if (on === this.value)
+                    return;
+                if (this.kind === CHECKED && this.value === UNSET)
+                    el.toggleAttribute(this.name, on);
+                this.value = on;
+                if (live[this.name] !== on)
+                    live[this.name] = on;
+                return;
+            }
+            case OPEN: {
+                const on = truthy(v);
+                if (on === this.value)
+                    return;
+                this.value = on;
+                if (el.hasAttribute('open') !== on)
+                    el.toggleAttribute('open', on);
+                return;
+            }
+            case TOGGLE: {
+                const on = truthy(v);
+                if (on === this.value)
+                    return;
+                this.value = on;
+                if (toggle !== undefined)
+                    toggle(this, this.name, on);
+                else if (DEV)
+                    warnToggle(el, this.name);
+                return;
+            }
+            case TITLE:
+            case TEXTAREA: {
+                const s = textOf(this, v);
+                if (s === this.value)
+                    return;
+                if (this.kind === TEXTAREA && this.value !== UNSET) {
+                    if (live.value !== s)
+                        live.value = s;
+                }
+                else
+                    el.textContent = s;
+                this.value = s;
+                return;
+            }
+            default:
+                this.hook(v);
+        }
+    }
+    /**
+     * Writes the attribute; `style` through the CSSOM (`.style.cssText`), which a strict CSP
+     * (`style-src` without `'unsafe-inline'`) allows where `setAttribute('style', …)` is blocked.
+     * HTML, SVG and MathML elements all have `.style`.
+     */
+    write(s) {
+        if (this.name === 'style')
+            this.el.style.cssText = s;
+        else
+            this.el.setAttribute(this.name, s);
+    }
+    /**
+     * MULTI: pieces joined with the static strings; `nothing` in any piece removes. With no
+     * pieces it is a static `style` attribute (01 "Normalization"): written once, at creation.
+     */
+    multi(values) {
+        const pieces = this.pieces;
+        let changed = false;
+        for (let i = 0; i < pieces.length; i++) {
+            const v = values[this.at + i];
+            if (v !== pieces[i]) {
+                pieces[i] = v;
+                changed = true;
+            }
+        }
+        if (!changed && this.value !== UNSET)
+            return;
+        const joined = this.join(pieces);
+        if (joined === this.value)
+            return;
+        this.value = joined;
+        if (joined === null)
+            this.el.removeAttribute(this.name);
+        else
+            this.write(joined);
+    }
+    /** The joined value of `pieces`, or null when one is `nothing`. */
+    join(pieces) {
+        const strings = this.strings;
+        let joined = strings[0];
+        for (let i = 0; i < pieces.length; i++) {
+            const v = pieces[i];
+            if (v === nothing)
+                return null;
+            if (DEV && isObject(v))
+                warnValue(this, v, `the attribute ${this.name}`);
+            joined += (v === null || v === undefined ? '' : text(v)) + strings[i + 1];
+        }
+        return joined;
+    }
+    /** HOOK: the result commits itself (hook-part.ts); an absent value forgets the hook. */
+    hook(v) {
+        if (absent(v)) {
+            this.spec = null;
+            this.args = undefined;
+            return;
+        }
+        const commit = isHook(v) ? v[COMMIT_HOOK] : undefined;
+        if (commit !== undefined)
+            commit(this, v);
+        else if (DEV)
+            badHook(v);
+    }
+}
+//# sourceMappingURL=attr-parts.js.map