@gyral/core 0.1.0 → 0.3.0

package/dist/view/server/component.js

@@ -0,0 +1,42 @@
+// Rendering one Gyral component in place (view/06-server.md "Components"): the end of its start
+// tag (light mark, seed, island attributes), then its view, inside a declarative shadow root
+// with the component's CSS (08 "Server") or as light-DOM children (ADR 0014). The parent's
+// children of a shadow component follow in the parent's walk, after the `<template>`.
+import { ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE } from '../attributes.js';
+import { escapeSeed, styleSafe } from './escape.js';
+import { ROOT, Writer } from './writer.js';
+const styleTexts = new WeakMap();
+/**
+ * The text of a shadow component's `<style>` (its CSS texts joined by newlines, `</style`
+ * escaped), exactly as written, so `styleHashes()` hashes what the browser sees. `''`: none.
+ */
+export function styleText(component) {
+    let text = styleTexts.get(component);
+    if (text === undefined) {
+        text = styleSafe(component.styles.join('\n'));
+        styleTexts.set(component, text);
+    }
+    return text;
+}
+/** Writes a deferred component; nested components are deferred again. */
+export function expand({ component, input }, dev) {
+    const { view, seed } = component.render(input);
+    const w = new Writer(dev, input.scope);
+    let tail = component.light ? ` ${LIGHT_ATTRIBUTE}` : '';
+    // Single-quoted, so the JSON's double quotes stay raw (ADR 0012).
+    tail += ` ${SEED_ATTRIBUTE}='${escapeSeed(JSON.stringify(seed))}'`;
+    if (component.hydrate !== 'load') {
+        tail += ` defer-hydration ${ISLAND_ATTRIBUTE}="${component.hydrate}"`;
+    }
+    w.write(`${tail}>`);
+    if (component.light) {
+        w.child(view, undefined, ROOT);
+        return w.done();
+    }
+    const css = styleText(component);
+    w.write(`<template shadowrootmode="open">${css === '' ? '' : `<style>${css}</style>`}`);
+    w.child(view, undefined, ROOT);
+    w.write('</template>');
+    return w.done();
+}
+//# sourceMappingURL=component.js.map

package/dist/view/server/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/view/server/component.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6FAA6F;AAC7F,2FAA2F;AAC3F,sFAAsF;AACtF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAC;AAErE,MAAM,UAAU,GAAG,IAAI,OAAO,EAA2B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,SAA0B;IAClD,IAAI,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAY,EAAE,GAAY;IACjE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,kEAAkE;IAClE,IAAI,IAAI,IAAI,cAAc,KAAK,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;IACnE,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QACjC,IAAI,IAAI,oBAAoB,gBAAgB,KAAK,SAAS,CAAC,OAAO,GAAG,CAAC;IACxE,CAAC;IACD,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;IACpB,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,KAAK,CAAC,mCAAmC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC","sourcesContent":["// Rendering one Gyral component in place (view/06-server.md \"Components\"): the end of its start\n// tag (light mark, seed, island attributes), then its view, inside a declarative shadow root\n// with the component's CSS (08 \"Server\") or as light-DOM children (ADR 0014). The parent's\n// children of a shadow component follow in the parent's walk, after the `<template>`.\nimport { ISLAND_ATTRIBUTE, LIGHT_ATTRIBUTE, SEED_ATTRIBUTE } from '../attributes.js';\nimport type { ServerComponent } from '../registry.js';\nimport { escapeSeed, styleSafe } from './escape.js';\nimport { ROOT, Writer, type Deferred, type Item } from './writer.js';\n\nconst styleTexts = new WeakMap<ServerComponent, string>();\n\n/**\n * The text of a shadow component's `<style>` (its CSS texts joined by newlines, `</style`\n * escaped), exactly as written, so `styleHashes()` hashes what the browser sees. `''`: none.\n */\nexport function styleText(component: ServerComponent): string {\n  let text = styleTexts.get(component);\n  if (text === undefined) {\n    text = styleSafe(component.styles.join('\\n'));\n    styleTexts.set(component, text);\n  }\n  return text;\n}\n\n/** Writes a deferred component; nested components are deferred again. */\nexport function expand({ component, input }: Deferred, dev: boolean): Item[] {\n  const { view, seed } = component.render(input);\n  const w = new Writer(dev, input.scope);\n  let tail = component.light ? ` ${LIGHT_ATTRIBUTE}` : '';\n  // Single-quoted, so the JSON's double quotes stay raw (ADR 0012).\n  tail += ` ${SEED_ATTRIBUTE}='${escapeSeed(JSON.stringify(seed))}'`;\n  if (component.hydrate !== 'load') {\n    tail += ` defer-hydration ${ISLAND_ATTRIBUTE}=\"${component.hydrate}\"`;\n  }\n  w.write(`${tail}>`);\n  if (component.light) {\n    w.child(view, undefined, ROOT);\n    return w.done();\n  }\n  const css = styleText(component);\n  w.write(`<template shadowrootmode=\"open\">${css === '' ? '' : `<style>${css}</style>`}`);\n  w.child(view, undefined, ROOT);\n  w.write('</template>');\n  return w.done();\n}\n"]}

package/dist/view/server/escape.d.ts

@@ -0,0 +1,10 @@
+/** Text content (child holes, `<textarea>`/`<title>` content). */
+export declare function escapeText(text: string): string;
+/** A double-quoted attribute value. */
+export declare function escapeAttr(value: string): string;
+/** A single-quoted attribute value: the `data-gyral-seed` JSON. */
+export declare const escapeSeed: (json: string) => string;
+/** CSS for a `<style>` element: `</style` (any case) would end it; `<\/style` is the same CSS. */
+export declare const styleSafe: (css: string) => string;
+/** HTML whitespace (WHATWG "ASCII whitespace"): text made only of it stays in table structure. */
+export declare const onlyWhitespace: (text: string) => boolean;

package/dist/view/server/escape.js

@@ -0,0 +1,34 @@
+// Escaping for the server renderer (view/06-server.md "Escaping"). Text escapes `&`, `<` and
+// `>`; double-quoted attribute values escape `&`, `"`, `<` and `>`; the single-quoted seed
+// attribute escapes `&`, `'`, `<` and `>` (so its JSON's double quotes stay raw). Only `&` and
+// the quote can end a quoted value; `<` and `>` are escaped too (as newer revisions of WHATWG
+// HTML's "Serializing HTML fragments" do), so no markup appears raw in an attribute, whatever
+// later reads the page (raw-text contexts, naive tooling, filters).
+const TEXT = /[&<>]/g;
+const ATTR = /[&"<>]/g;
+const SEED = /[&'<>]/g;
+const ENTITY = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+const entity = (c) => ENTITY[c] ?? c;
+/** Text content (child holes, `<textarea>`/`<title>` content). */
+export function escapeText(text) {
+    TEXT.lastIndex = 0;
+    return TEXT.test(text) ? text.replace(TEXT, entity) : text;
+}
+/** A double-quoted attribute value. */
+export function escapeAttr(value) {
+    ATTR.lastIndex = 0;
+    return ATTR.test(value) ? value.replace(ATTR, entity) : value;
+}
+/** A single-quoted attribute value: the `data-gyral-seed` JSON. */
+export const escapeSeed = (json) => json.replace(SEED, entity);
+/** CSS for a `<style>` element: `</style` (any case) would end it; `<\/style` is the same CSS. */
+export const styleSafe = (css) => css.replace(/<\/(style)/gi, '<\\/$1');
+/** HTML whitespace (WHATWG "ASCII whitespace"): text made only of it stays in table structure. */
+export const onlyWhitespace = (text) => !/[^\t\n\f\r ]/.test(text);
+//# sourceMappingURL=escape.js.map

package/dist/view/server/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/view/server/escape.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,2FAA2F;AAC3F,+FAA+F;AAC/F,8FAA8F;AAC9F,8FAA8F;AAC9F,oEAAoE;AAEpE,MAAM,IAAI,GAAG,QAAQ,CAAC;AACtB,MAAM,IAAI,GAAG,SAAS,CAAC;AACvB,MAAM,IAAI,GAAG,SAAS,CAAC;AAEvB,MAAM,MAAM,GAAqC;IAC/C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAErD,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACnB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAE/E,kGAAkG;AAClG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAExF,kGAAkG;AAClG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["// Escaping for the server renderer (view/06-server.md \"Escaping\"). Text escapes `&`, `<` and\n// `>`; double-quoted attribute values escape `&`, `\"`, `<` and `>`; the single-quoted seed\n// attribute escapes `&`, `'`, `<` and `>` (so its JSON's double quotes stay raw). Only `&` and\n// the quote can end a quoted value; `<` and `>` are escaped too (as newer revisions of WHATWG\n// HTML's \"Serializing HTML fragments\" do), so no markup appears raw in an attribute, whatever\n// later reads the page (raw-text contexts, naive tooling, filters).\n\nconst TEXT = /[&<>]/g;\nconst ATTR = /[&\"<>]/g;\nconst SEED = /[&'<>]/g;\n\nconst ENTITY: Readonly<Record<string, string>> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&#39;',\n};\n\nconst entity = (c: string): string => ENTITY[c] ?? c;\n\n/** Text content (child holes, `<textarea>`/`<title>` content). */\nexport function escapeText(text: string): string {\n  TEXT.lastIndex = 0;\n  return TEXT.test(text) ? text.replace(TEXT, entity) : text;\n}\n\n/** A double-quoted attribute value. */\nexport function escapeAttr(value: string): string {\n  ATTR.lastIndex = 0;\n  return ATTR.test(value) ? value.replace(ATTR, entity) : value;\n}\n\n/** A single-quoted attribute value: the `data-gyral-seed` JSON. */\nexport const escapeSeed = (json: string): string => json.replace(SEED, entity);\n\n/** CSS for a `<style>` element: `</style` (any case) would end it; `<\\/style` is the same CSS. */\nexport const styleSafe = (css: string): string => css.replace(/<\\/(style)/gi, '<\\\\/$1');\n\n/** HTML whitespace (WHATWG \"ASCII whitespace\"): text made only of it stays in table structure. */\nexport const onlyWhitespace = (text: string): boolean => !/[^\\t\\n\\f\\r ]/.test(text);\n"]}

package/dist/view/server/index.d.ts

@@ -0,0 +1,28 @@
+import type { ChildValue } from '../render/values.js';
+export interface ServerRenderOptions {
+    /**
+     * Development markers (`<!--gyral:ID-->` before each template instance, for hydration's
+     * checks, 07) and development checks. Default: on in development builds (the `development`
+     * export condition, as for the client), off otherwise.
+     */
+    readonly dev?: boolean;
+}
+/**
+ * Renders `value` to HTML chunks, lazily: each step writes up to the next component boundary.
+ * Every component's `init` and view run in the step that writes it, so a caller can wrap each
+ * step in a per-request scope (ADR 0013).
+ */
+export declare function render(value: ChildValue, options?: ServerRenderOptions): Iterable<string>;
+/** Renders `value` to one string. */
+export declare function renderToString(value: ChildValue, options?: ServerRenderOptions): string;
+/**
+ * `'sha256-…'` of a `<style>` element's text, for a CSP `style-src` (cached per text).
+ * Synchronous (sha256.ts), so a page can build its policy while it renders.
+ */
+export declare function styleHashSync(text: string): string;
+/** `styleHashSync`, as a promise (the API before it existed). */
+export declare const styleHash: (text: string) => Promise<string>;
+/** Tag → `<style>` text of every registered shadow component with CSS (08 "Server"). */
+export declare function componentStyles(): ReadonlyMap<string, string>;
+/** The hashes of every registered shadow component's `<style>` (08 "Server"), deduplicated. */
+export declare function styleHashes(): Promise<readonly string[]>;

package/dist/view/server/index.js

@@ -0,0 +1,72 @@
+// The server renderer (view/06-server.md "API"): synchronous, chunked, runtime-agnostic (no
+// DOM, no Node-only APIs: a JavaScript SHA-256 for the style hashes). `@gyral/core/server` wraps these,
+// registering recorded specs first; code outside view/ may import only this module of view/server/.
+import { DEV } from '../flags.js';
+import { serverComponents } from '../registry.js';
+import { expand, styleText } from './component.js';
+import { sha256 } from './sha256.js';
+import { ROOT, Writer } from './writer.js';
+function push(stack, items) {
+    for (let i = items.length - 1; i >= 0; i--)
+        stack.push(items[i]);
+}
+/**
+ * Renders `value` to HTML chunks, lazily: each step writes up to the next component boundary.
+ * Every component's `init` and view run in the step that writes it, so a caller can wrap each
+ * step in a per-request scope (ADR 0013).
+ */
+export function* render(value, options = {}) {
+    const dev = options.dev ?? DEV;
+    const root = new Writer(dev, undefined);
+    root.child(value, undefined, ROOT);
+    const stack = [];
+    push(stack, root.done());
+    for (let item = stack.pop(); item !== undefined; item = stack.pop()) {
+        if (typeof item === 'string')
+            yield item;
+        else
+            push(stack, expand(item, dev));
+    }
+}
+/** Renders `value` to one string. */
+export function renderToString(value, options) {
+    let html = '';
+    for (const chunk of render(value, options))
+        html += chunk;
+    return html;
+}
+const hashes = new Map();
+/**
+ * `'sha256-…'` of a `<style>` element's text, for a CSP `style-src` (cached per text).
+ * Synchronous (sha256.ts), so a page can build its policy while it renders.
+ */
+export function styleHashSync(text) {
+    let hash = hashes.get(text);
+    if (hash === undefined) {
+        // The parser turns CR and CRLF into LF before the browser hashes the element's text.
+        const digest = sha256(new TextEncoder().encode(text.replace(/\r\n?/g, '\n')));
+        let binary = '';
+        for (const byte of digest)
+            binary += String.fromCharCode(byte);
+        hash = `'sha256-${btoa(binary)}'`;
+        hashes.set(text, hash);
+    }
+    return hash;
+}
+/** `styleHashSync`, as a promise (the API before it existed). */
+export const styleHash = (text) => Promise.resolve(styleHashSync(text));
+/** Tag → `<style>` text of every registered shadow component with CSS (08 "Server"). */
+export function componentStyles() {
+    const styles = new Map();
+    for (const component of serverComponents()) {
+        const text = styleText(component);
+        if (text !== '')
+            styles.set(component.tag, text);
+    }
+    return styles;
+}
+/** The hashes of every registered shadow component's `<style>` (08 "Server"), deduplicated. */
+export function styleHashes() {
+    return Promise.resolve([...new Set([...componentStyles().values()].map(styleHashSync))]);
+}
+//# sourceMappingURL=index.js.map

package/dist/view/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/view/server/index.ts"],"names":[],"mappings":"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","sourcesContent":["// The server renderer (view/06-server.md \"API\"): synchronous, chunked, runtime-agnostic (no\n// DOM, no Node-only APIs: a JavaScript SHA-256 for the style hashes). `@gyral/core/server` wraps these,\n// registering recorded specs first; code outside view/ may import only this module of view/server/.\nimport { DEV } from '../flags.js';\nimport { serverComponents } from '../registry.js';\nimport type { ChildValue } from '../render/values.js';\nimport { expand, styleText } from './component.js';\nimport { sha256 } from './sha256.js';\nimport { ROOT, Writer, type Item } from './writer.js';\n\nexport interface ServerRenderOptions {\n  /**\n   * Development markers (`<!--gyral:ID-->` before each template instance, for hydration's\n   * checks, 07) and development checks. Default: on in development builds (the `development`\n   * export condition, as for the client), off otherwise.\n   */\n  readonly dev?: boolean;\n}\n\nfunction push(stack: Item[], items: readonly Item[]): void {\n  for (let i = items.length - 1; i >= 0; i--) stack.push(items[i] as Item);\n}\n\n/**\n * Renders `value` to HTML chunks, lazily: each step writes up to the next component boundary.\n * Every component's `init` and view run in the step that writes it, so a caller can wrap each\n * step in a per-request scope (ADR 0013).\n */\nexport function* render(value: ChildValue, options: ServerRenderOptions = {}): Iterable<string> {\n  const dev = options.dev ?? DEV;\n  const root = new Writer(dev, undefined);\n  root.child(value, undefined, ROOT);\n  const stack: Item[] = [];\n  push(stack, root.done());\n  for (let item = stack.pop(); item !== undefined; item = stack.pop()) {\n    if (typeof item === 'string') yield item;\n    else push(stack, expand(item, dev));\n  }\n}\n\n/** Renders `value` to one string. */\nexport function renderToString(value: ChildValue, options?: ServerRenderOptions): string {\n  let html = '';\n  for (const chunk of render(value, options)) html += chunk;\n  return html;\n}\n\nconst hashes = new Map<string, string>();\n\n/**\n * `'sha256-…'` of a `<style>` element's text, for a CSP `style-src` (cached per text).\n * Synchronous (sha256.ts), so a page can build its policy while it renders.\n */\nexport function styleHashSync(text: string): string {\n  let hash = hashes.get(text);\n  if (hash === undefined) {\n    // The parser turns CR and CRLF into LF before the browser hashes the element's text.\n    const digest = sha256(new TextEncoder().encode(text.replace(/\\r\\n?/g, '\\n')));\n    let binary = '';\n    for (const byte of digest) binary += String.fromCharCode(byte);\n    hash = `'sha256-${btoa(binary)}'`;\n    hashes.set(text, hash);\n  }\n  return hash;\n}\n\n/** `styleHashSync`, as a promise (the API before it existed). */\nexport const styleHash = (text: string): Promise<string> => Promise.resolve(styleHashSync(text));\n\n/** Tag → `<style>` text of every registered shadow component with CSS (08 \"Server\"). */\nexport function componentStyles(): ReadonlyMap<string, string> {\n  const styles = new Map<string, string>();\n  for (const component of serverComponents()) {\n    const text = styleText(component);\n    if (text !== '') styles.set(component.tag, text);\n  }\n  return styles;\n}\n\n/** The hashes of every registered shadow component's `<style>` (08 \"Server\"), deduplicated. */\nexport function styleHashes(): Promise<readonly string[]> {\n  return Promise.resolve([...new Set([...componentStyles().values()].map(styleHashSync))]);\n}\n"]}

package/dist/view/server/sha256.d.ts

@@ -0,0 +1,2 @@
+/** The SHA-256 digest of `bytes` (32 bytes). */
+export declare function sha256(bytes: Uint8Array): Uint8Array;

package/dist/view/server/sha256.js

@@ -0,0 +1,75 @@
+// SHA-256 (FIPS 180-4) in plain JavaScript, for CSP style hashes (view/06-server.md "CSP").
+// Synchronous, unlike WebCrypto's `digest`, so `@gyral/ssr`'s `renderPage` can build the
+// policy at render time, after the page's components are registered, and still return its
+// Response synchronously. Runtime-agnostic (no `node:crypto`); server-only, never in client
+// bundles. Checked against `node:crypto` (sha256.node.test.ts).
+/** Round constants: the first 32 bits of the fractional parts of the cube roots of the first 64 primes. */
+const K = new Uint32Array([
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
+    0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
+    0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+    0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
+    0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+    0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
+    0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,
+]);
+/** Initial hash: the first 32 bits of the fractional parts of the square roots of the first 8 primes. */
+const H0 = [
+    0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,
+];
+const rotr = (x, n) => (x >>> n) | (x << (32 - n));
+/** The SHA-256 digest of `bytes` (32 bytes). */
+export function sha256(bytes) {
+    // Padding: 0x80, zeros, then the bit length as a 64-bit big-endian number.
+    const blocks = (bytes.length + 9 + 63) >> 6;
+    const m = new Uint8Array(blocks * 64);
+    m.set(bytes);
+    m[bytes.length] = 0x80;
+    const view = new DataView(m.buffer);
+    const bits = bytes.length * 8;
+    view.setUint32(m.length - 8, Math.floor(bits / 0x100000000));
+    view.setUint32(m.length - 4, bits >>> 0);
+    const h = new Uint32Array(H0);
+    const w = new Uint32Array(64);
+    for (let off = 0; off < m.length; off += 64) {
+        for (let t = 0; t < 16; t++)
+            w[t] = view.getUint32(off + t * 4);
+        for (let t = 16; t < 64; t++) {
+            const x = w[t - 15];
+            const y = w[t - 2];
+            const s0 = rotr(x, 7) ^ rotr(x, 18) ^ (x >>> 3);
+            const s1 = rotr(y, 17) ^ rotr(y, 19) ^ (y >>> 10);
+            w[t] = w[t - 16] + s0 + w[t - 7] + s1;
+        }
+        let [a, b, c, d, e, f, g, k] = Array.from(h);
+        for (let t = 0; t < 64; t++) {
+            const s1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);
+            const t1 = (k + s1 + ((e & f) ^ (~e & g)) + K[t] + w[t]) | 0;
+            const s0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);
+            const t2 = (s0 + ((a & b) ^ (a & c) ^ (b & c))) | 0;
+            k = g;
+            g = f;
+            f = e;
+            e = (d + t1) | 0;
+            d = c;
+            c = b;
+            b = a;
+            a = (t1 + t2) | 0;
+        }
+        h[0] = h[0] + a;
+        h[1] = h[1] + b;
+        h[2] = h[2] + c;
+        h[3] = h[3] + d;
+        h[4] = h[4] + e;
+        h[5] = h[5] + f;
+        h[6] = h[6] + g;
+        h[7] = h[7] + k;
+    }
+    const out = new Uint8Array(32);
+    const outView = new DataView(out.buffer);
+    for (let i = 0; i < 8; i++)
+        outView.setUint32(i * 4, h[i]);
+    return out;
+}
+//# sourceMappingURL=sha256.js.map

package/dist/view/server/sha256.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.js","sourceRoot":"","sources":["../../../src/view/server/sha256.ts"],"names":[],"mappings":"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","sourcesContent":["// SHA-256 (FIPS 180-4) in plain JavaScript, for CSP style hashes (view/06-server.md \"CSP\").\n// Synchronous, unlike WebCrypto's `digest`, so `@gyral/ssr`'s `renderPage` can build the\n// policy at render time, after the page's components are registered, and still return its\n// Response synchronously. Runtime-agnostic (no `node:crypto`); server-only, never in client\n// bundles. Checked against `node:crypto` (sha256.node.test.ts).\n\n/** Round constants: the first 32 bits of the fractional parts of the cube roots of the first 64 primes. */\nconst K = new Uint32Array([\n  0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,\n  0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,\n  0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,\n  0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,\n  0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,\n  0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,\n  0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,\n  0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2,\n]);\n\n/** Initial hash: the first 32 bits of the fractional parts of the square roots of the first 8 primes. */\nconst H0 = [\n  0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19,\n];\n\n/** The eight working variables. */\ntype Words = [number, number, number, number, number, number, number, number];\n\nconst rotr = (x: number, n: number): number => (x >>> n) | (x << (32 - n));\n\n/** The SHA-256 digest of `bytes` (32 bytes). */\nexport function sha256(bytes: Uint8Array): Uint8Array {\n  // Padding: 0x80, zeros, then the bit length as a 64-bit big-endian number.\n  const blocks = (bytes.length + 9 + 63) >> 6;\n  const m = new Uint8Array(blocks * 64);\n  m.set(bytes);\n  m[bytes.length] = 0x80;\n  const view = new DataView(m.buffer);\n  const bits = bytes.length * 8;\n  view.setUint32(m.length - 8, Math.floor(bits / 0x100000000));\n  view.setUint32(m.length - 4, bits >>> 0);\n  const h = new Uint32Array(H0);\n  const w = new Uint32Array(64);\n  for (let off = 0; off < m.length; off += 64) {\n    for (let t = 0; t < 16; t++) w[t] = view.getUint32(off + t * 4);\n    for (let t = 16; t < 64; t++) {\n      const x = w[t - 15] as number;\n      const y = w[t - 2] as number;\n      const s0 = rotr(x, 7) ^ rotr(x, 18) ^ (x >>> 3);\n      const s1 = rotr(y, 17) ^ rotr(y, 19) ^ (y >>> 10);\n      w[t] = (w[t - 16] as number) + s0 + (w[t - 7] as number) + s1;\n    }\n    let [a, b, c, d, e, f, g, k] = Array.from(h) as Words;\n    for (let t = 0; t < 64; t++) {\n      const s1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);\n      const t1 = (k + s1 + ((e & f) ^ (~e & g)) + (K[t] as number) + (w[t] as number)) | 0;\n      const s0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);\n      const t2 = (s0 + ((a & b) ^ (a & c) ^ (b & c))) | 0;\n      k = g;\n      g = f;\n      f = e;\n      e = (d + t1) | 0;\n      d = c;\n      c = b;\n      b = a;\n      a = (t1 + t2) | 0;\n    }\n    h[0] = (h[0] as number) + a;\n    h[1] = (h[1] as number) + b;\n    h[2] = (h[2] as number) + c;\n    h[3] = (h[3] as number) + d;\n    h[4] = (h[4] as number) + e;\n    h[5] = (h[5] as number) + f;\n    h[6] = (h[6] as number) + g;\n    h[7] = (h[7] as number) + k;\n  }\n  const out = new Uint8Array(32);\n  const outView = new DataView(out.buffer);\n  for (let i = 0; i < 8; i++) outView.setUint32(i * 4, h[i] as number);\n  return out;\n}\n"]}

package/dist/view/server/tags.d.ts

@@ -0,0 +1,57 @@
+import type { Segment } from '../normalize/types.js';
+import { type ServerComponent, type ServerProvider, type ServerRenderInput } from '../registry.js';
+/** A component whose content is written later, in its own render step. */
+export interface Deferred {
+    readonly component: ServerComponent;
+    readonly input: ServerRenderInput;
+}
+/** What a walk produces: markup, with deferred components in document order. */
+export type Item = string | Deferred;
+/** A custom element's start tag while its attribute holes are written. */
+export interface Opening {
+    readonly tag: string;
+    readonly component: ServerComponent | undefined;
+    readonly provider: ServerProvider | undefined;
+    readonly attributes: Record<string, string>;
+    readonly properties: Record<string, unknown>;
+}
+/** An open custom element until its end tag: plain, a provider, or a light component. */
+export type Frame = {
+    readonly k: 'plain';
+} | {
+    readonly k: 'provider';
+    readonly outer: unknown;
+} | {
+    readonly k: 'light';
+    readonly tag: string;
+    readonly items: number;
+};
+export declare const PLAIN: Frame;
+export declare class Markup {
+    protected readonly dev: boolean;
+    protected scope: unknown;
+    protected buf: string;
+    protected readonly items: Item[];
+    /**
+     * `dev`: development markers and checks. `scope`: the nearest provider's scope, passed to
+     * components (undefined: the request's).
+     */
+    constructor(dev: boolean, scope: unknown);
+    write(markup: string): void;
+    /** The markup and deferred components written so far. */
+    done(): Item[];
+    private flush;
+    /** `name=${v}` or `name="a ${v} b"`; returns the index of the next value. */
+    protected attr(s: Extract<Segment, {
+        k: 'attr';
+    }>, values: readonly unknown[], at: number, opening: Opening | undefined): number;
+    private valued;
+    /** A present boolean attribute (`?name`, or `true` from a hook's server half). */
+    protected bare(name: string, opening: Opening | undefined): void;
+    /** An element hook: its server half's attributes (02 "Element hooks"). */
+    protected hook(v: unknown, opening: Opening | undefined): void;
+    /** A custom element's start tag: a Gyral component, a provider, or a plain element. */
+    protected open(tag: string, html: string, attrs: readonly (readonly [string, string])[]): Opening | undefined;
+    protected openEnd(opening: Opening | undefined): Frame;
+    protected close(frame: Frame, tag: string): void;
+}

package/dist/view/server/tags.js

@@ -0,0 +1,121 @@
+import { serverComponent, serverProvider, } from '../registry.js';
+import { hookSpec } from '../render/hooks.js';
+import { badHook } from '../render/warn.js';
+import { escapeAttr, onlyWhitespace } from './escape.js';
+import { absent, attrText, checkAttrName, lightChildrenError, multiText } from './values.js';
+export const PLAIN = { k: 'plain' };
+export class Markup {
+    /**
+     * `dev`: development markers and checks. `scope`: the nearest provider's scope, passed to
+     * components (undefined: the request's).
+     */
+    constructor(dev, scope) {
+        this.dev = dev;
+        this.scope = scope;
+        this.buf = '';
+        this.items = [];
+    }
+    write(markup) {
+        this.buf += markup;
+    }
+    /** The markup and deferred components written so far. */
+    done() {
+        this.flush();
+        return this.items;
+    }
+    flush() {
+        if (this.buf !== '')
+            this.items.push(this.buf);
+        this.buf = '';
+    }
+    /** `name=${v}` or `name="a ${v} b"`; returns the index of the next value. */
+    attr(s, values, at, opening) {
+        const { name, strings } = s;
+        const value = strings === undefined
+            ? attrText(values[at], s, name, this.dev)
+            : multiText(values, at, strings, s, name, this.dev);
+        if (value !== null)
+            this.valued(name, value, opening);
+        return at + (strings === undefined ? 1 : strings.length - 1);
+    }
+    valued(name, value, opening) {
+        this.buf += ` ${name}="${escapeAttr(value)}"`;
+        if (opening !== undefined)
+            opening.attributes[name] = value;
+    }
+    /** A present boolean attribute (`?name`, or `true` from a hook's server half). */
+    bare(name, opening) {
+        this.buf += ` ${name}`;
+        if (opening !== undefined)
+            opening.attributes[name] = '';
+    }
+    /** An element hook: its server half's attributes (02 "Element hooks"). */
+    hook(v, opening) {
+        if (absent(v))
+            return;
+        const spec = hookSpec(v);
+        if (spec === undefined) {
+            if (this.dev)
+                badHook(v);
+            return;
+        }
+        const attributes = spec.server?.(v.args) ?? {};
+        for (const [name, value] of Object.entries(attributes)) {
+            checkAttrName(name);
+            if (value === true)
+                this.bare(name, opening);
+            else
+                this.valued(name, value, opening);
+        }
+    }
+    /** A custom element's start tag: a Gyral component, a provider, or a plain element. */
+    open(tag, html, attrs) {
+        this.buf += html;
+        const component = serverComponent(tag);
+        const provider = component === undefined ? serverProvider(tag) : undefined;
+        if (component === undefined && provider === undefined)
+            return undefined;
+        return { tag, component, provider, attributes: Object.fromEntries(attrs), properties: {} };
+    }
+    openEnd(opening) {
+        if (opening === undefined) {
+            this.buf += '>';
+            return PLAIN;
+        }
+        const { attributes, properties } = opening;
+        const messages = properties['initialMessages'];
+        const input = {
+            attributes,
+            properties,
+            initialMessages: Array.isArray(messages) ? messages : undefined,
+            scope: this.scope,
+        };
+        if (opening.provider !== undefined) {
+            const provided = opening.provider.open(input);
+            for (const [name, value] of Object.entries(provided.attributes)) {
+                this.buf += ` ${name}="${escapeAttr(value)}"`;
+            }
+            this.buf += '>';
+            const frame = { k: 'provider', outer: this.scope };
+            this.scope = provided.scope;
+            return frame;
+        }
+        const component = opening.component; // Sound: open() set one of the two.
+        this.flush();
+        this.items.push({ component, input });
+        return component.light ? { k: 'light', tag: opening.tag, items: this.items.length } : PLAIN;
+    }
+    close(frame, tag) {
+        if (frame.k === 'provider')
+            this.scope = frame.outer;
+        else if (frame.k === 'light') {
+            // Whitespace-only children are dropped; anything else is an error (ADR 0014).
+            if (this.items.length !== frame.items || !onlyWhitespace(this.buf)) {
+                lightChildrenError(frame.tag);
+            }
+            this.buf = '';
+        }
+        this.buf += `</${tag}>`;
+    }
+}
+//# sourceMappingURL=tags.js.map

package/dist/view/server/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags.js","sourceRoot":"","sources":["../../../src/view/server/tags.ts"],"names":[],"mappings":"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","sourcesContent":["// Start tags and custom elements for the server renderer (view/06-server.md \"Writing a template\n// result\", \"Components\"): attribute, boolean and hook holes, and what a custom element's\n// `open`/`openEnd`/`close` segments do. A Gyral component's start tag is written here, but\n// its content (seed, shadow root, view) is deferred: the walk returns strings with the\n// deferred components between them, and `render` (index.ts) expands each one in its own step,\n// so every component boundary is a chunk boundary. A provider (`<gyral-stores>`) is a plain\n// element that gives its subtree a scope until its end tag.\nimport type { Segment } from '../normalize/types.js';\nimport {\n  serverComponent,\n  serverProvider,\n  type ServerComponent,\n  type ServerProvider,\n  type ServerRenderInput,\n} from '../registry.js';\nimport { hookSpec, type HookResult } from '../render/hooks.js';\nimport { badHook } from '../render/warn.js';\nimport { escapeAttr, onlyWhitespace } from './escape.js';\nimport { absent, attrText, checkAttrName, lightChildrenError, multiText } from './values.js';\n\n/** A component whose content is written later, in its own render step. */\nexport interface Deferred {\n  readonly component: ServerComponent;\n  readonly input: ServerRenderInput;\n}\n\n/** What a walk produces: markup, with deferred components in document order. */\nexport type Item = string | Deferred;\n\n/** A custom element's start tag while its attribute holes are written. */\nexport interface Opening {\n  readonly tag: string;\n  readonly component: ServerComponent | undefined;\n  readonly provider: ServerProvider | undefined;\n  readonly attributes: Record<string, string>;\n  readonly properties: Record<string, unknown>;\n}\n\n/** An open custom element until its end tag: plain, a provider, or a light component. */\nexport type Frame =\n  | { readonly k: 'plain' }\n  | { readonly k: 'provider'; readonly outer: unknown }\n  | { readonly k: 'light'; readonly tag: string; readonly items: number };\n\nexport const PLAIN: Frame = { k: 'plain' };\n\nexport class Markup {\n  protected buf = '';\n  protected readonly items: Item[] = [];\n\n  /**\n   * `dev`: development markers and checks. `scope`: the nearest provider's scope, passed to\n   * components (undefined: the request's).\n   */\n  constructor(\n    protected readonly dev: boolean,\n    protected scope: unknown,\n  ) {}\n\n  write(markup: string): void {\n    this.buf += markup;\n  }\n\n  /** The markup and deferred components written so far. */\n  done(): Item[] {\n    this.flush();\n    return this.items;\n  }\n\n  private flush(): void {\n    if (this.buf !== '') this.items.push(this.buf);\n    this.buf = '';\n  }\n\n  /** `name=${v}` or `name=\"a ${v} b\"`; returns the index of the next value. */\n  protected attr(\n    s: Extract<Segment, { k: 'attr' }>,\n    values: readonly unknown[],\n    at: number,\n    opening: Opening | undefined,\n  ): number {\n    const { name, strings } = s;\n    const value =\n      strings === undefined\n        ? attrText(values[at], s, name, this.dev)\n        : multiText(values, at, strings, s, name, this.dev);\n    if (value !== null) this.valued(name, value, opening);\n    return at + (strings === undefined ? 1 : strings.length - 1);\n  }\n\n  private valued(name: string, value: string, opening: Opening | undefined): void {\n    this.buf += ` ${name}=\"${escapeAttr(value)}\"`;\n    if (opening !== undefined) opening.attributes[name] = value;\n  }\n\n  /** A present boolean attribute (`?name`, or `true` from a hook's server half). */\n  protected bare(name: string, opening: Opening | undefined): void {\n    this.buf += ` ${name}`;\n    if (opening !== undefined) opening.attributes[name] = '';\n  }\n\n  /** An element hook: its server half's attributes (02 \"Element hooks\"). */\n  protected hook(v: unknown, opening: Opening | undefined): void {\n    if (absent(v)) return;\n    const spec = hookSpec(v);\n    if (spec === undefined) {\n      if (this.dev) badHook(v);\n      return;\n    }\n    const attributes = spec.server?.((v as HookResult).args) ?? {};\n    for (const [name, value] of Object.entries(attributes)) {\n      checkAttrName(name);\n      if (value === true) this.bare(name, opening);\n      else this.valued(name, value, opening);\n    }\n  }\n\n  /** A custom element's start tag: a Gyral component, a provider, or a plain element. */\n  protected open(\n    tag: string,\n    html: string,\n    attrs: readonly (readonly [string, string])[],\n  ): Opening | undefined {\n    this.buf += html;\n    const component = serverComponent(tag);\n    const provider = component === undefined ? serverProvider(tag) : undefined;\n    if (component === undefined && provider === undefined) return undefined;\n    return { tag, component, provider, attributes: Object.fromEntries(attrs), properties: {} };\n  }\n\n  protected openEnd(opening: Opening | undefined): Frame {\n    if (opening === undefined) {\n      this.buf += '>';\n      return PLAIN;\n    }\n    const { attributes, properties } = opening;\n    const messages = properties['initialMessages'];\n    const input: ServerRenderInput = {\n      attributes,\n      properties,\n      initialMessages: Array.isArray(messages) ? (messages as readonly unknown[]) : undefined,\n      scope: this.scope,\n    };\n    if (opening.provider !== undefined) {\n      const provided = opening.provider.open(input);\n      for (const [name, value] of Object.entries(provided.attributes)) {\n        this.buf += ` ${name}=\"${escapeAttr(value)}\"`;\n      }\n      this.buf += '>';\n      const frame: Frame = { k: 'provider', outer: this.scope };\n      this.scope = provided.scope;\n      return frame;\n    }\n    const component = opening.component as ServerComponent; // Sound: open() set one of the two.\n    this.flush();\n    this.items.push({ component, input });\n    return component.light ? { k: 'light', tag: opening.tag, items: this.items.length } : PLAIN;\n  }\n\n  protected close(frame: Frame, tag: string): void {\n    if (frame.k === 'provider') this.scope = frame.outer;\n    else if (frame.k === 'light') {\n      // Whitespace-only children are dropped; anything else is an error (ADR 0014).\n      if (this.items.length !== frame.items || !onlyWhitespace(this.buf)) {\n        lightChildrenError(frame.tag);\n      }\n      this.buf = '';\n    }\n    this.buf += `</${tag}>`;\n  }\n}\n"]}

package/dist/view/server/values.d.ts

@@ -0,0 +1,16 @@
+export declare const absent: (v: unknown) => boolean;
+export declare const truthy: (v: unknown) => boolean;
+/** A Promise in any hole: server renders are synchronous (06 "API"). Always an error. */
+export declare function checkPromise(v: object, where: string): void;
+/** `name=${v}`: the value to write, or null to leave the attribute out. */
+export declare function attrText(v: unknown, at: object, name: string, dev: boolean): string | null;
+/** `name="a ${x} b"`: pieces joined; `nothing` in any piece leaves the attribute out. */
+export declare function multiText(values: readonly unknown[], from: number, strings: readonly string[], at: object, name: string, dev: boolean): string | null;
+/** `<textarea>`/`<title>` content: child-hole rules flattened to a string, as on the client. */
+export declare function textContent(v: unknown, at: object, dev: boolean): string;
+/** Text written directly in table structure would be foster-parented (rule 7). */
+export declare function fosterError(text: string, parent: string): never;
+/** A light-DOM component owns its children (ADR 0014). */
+export declare function lightChildrenError(tag: string): never;
+/** An attribute name from a hook's server half must not break the start tag. */
+export declare function checkAttrName(name: string): void;

package/dist/view/server/values.js

@@ -0,0 +1,86 @@
+// Value rules for attribute and text-content holes on the server (view/02-bindings.md
+// "Attribute values", "Live form state"; view/06-server.md "Writing a template result"),
+// identical to the client's (render/attr-parts.ts) so both sides write the same attributes.
+// And the server-only errors: a Promise anywhere (renders are synchronous), text the parser
+// would move out of table structure, children given to a light-DOM component.
+import { nothing } from '../render/values.js';
+import { warnTrue, warnValue } from '../render/warn.js';
+const SPEC = 'docs/design-docs/view';
+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';
+/** `String(v)`: objects and functions as the client writes them (render/attr-parts.ts). */
+const text = String;
+const isThenable = (v) => typeof v.then === 'function';
+/** A Promise in any hole: server renders are synchronous (06 "API"). Always an error. */
+export function checkPromise(v, where) {
+    if (!isThenable(v))
+        return;
+    throw new TypeError(`gyral: ${where} got a Promise. Server renders are synchronous: state is known before ` +
+        'rendering, so load the data first (in the route handler or a form action) and pass ' +
+        `it as props (${SPEC}/06-server.md "API").`);
+}
+/** `String(v)` for an attribute value, with the development warning for objects. */
+function written(v, at, name, dev) {
+    if (typeof v === 'string')
+        return v;
+    if (isObject(v)) {
+        checkPromise(v, `the attribute ${name}`);
+        if (dev)
+            warnValue(at, v, `the attribute ${name}`);
+    }
+    return text(v);
+}
+/** `name=${v}`: the value to write, or null to leave the attribute out. */
+export function attrText(v, at, name, dev) {
+    return absent(v) ? null : written(v, at, name, dev);
+}
+/** `name="a ${x} b"`: pieces joined; `nothing` in any piece leaves the attribute out. */
+export function multiText(values, from, strings, at, name, dev) {
+    let joined = strings[0] ?? '';
+    for (let i = 1; i < strings.length; i++) {
+        const v = values[from + i - 1];
+        if (v === nothing)
+            return null;
+        joined +=
+            (v === null || v === undefined ? '' : written(v, at, name, dev)) + strings[i];
+    }
+    return joined;
+}
+/** `<textarea>`/`<title>` content: child-hole rules flattened to a string, as on the client. */
+export function textContent(v, at, dev) {
+    if (typeof v === 'string')
+        return v;
+    if (typeof v === 'number')
+        return String(v);
+    if (isObject(v)) {
+        checkPromise(v, 'the text content');
+        if (dev)
+            warnValue(at, v, 'the text content');
+        return text(v);
+    }
+    if (dev && v === true)
+        warnTrue(at);
+    return '';
+}
+/** Text written directly in table structure would be foster-parented (rule 7). */
+export function fosterError(text, parent) {
+    throw new Error(`gyral: the text ${JSON.stringify(text.slice(0, 40))} is written directly inside ` +
+        `<${parent}>. The HTML parser moves text out of table structure (foster parenting), so ` +
+        'the page would differ from what the client renders. Put text inside a <td>, <th> or ' +
+        `<caption> (${SPEC}/09-template-rules.md, rule 7).`);
+}
+/** A light-DOM component owns its children (ADR 0014). */
+export function lightChildrenError(tag) {
+    throw new Error(`gyral: <${tag}> renders in light DOM (shadow: false), so it owns its children, but its ` +
+        'parent wrote children inside it. Pass the data as props instead, or make it a shadow ' +
+        `component and use <slot> (${SPEC}/06-server.md "Components", ADR 0014).`);
+}
+/** An attribute name from a hook's server half must not break the start tag. */
+export function checkAttrName(name) {
+    if (/^[^\s"'>/=\0]+$/.test(name))
+        return;
+    throw new TypeError(`gyral: an element hook's server half returned the attribute name ${JSON.stringify(name)}, ` +
+        `which isn't a valid attribute name (${SPEC}/02-bindings.md "Element hooks").`);
+}
+//# sourceMappingURL=values.js.map