@gyral/core 0.3.0 → 0.3.1

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

@@ -1 +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"]}
+{"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/**\n * A render's `style` attribute values for a CSP (ADR 0020): each distinct value as the DOM sees\n * it (decoded), mapped to where it was first written (the template's `loc` or id; `''` when\n * neither is known).\n */\nexport type StyleValues = Map<string, string>;\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  /** The template being written, for `styles` (its `loc` or id). */\n  protected where = '';\n\n  /**\n   * `dev`: development markers and checks. `scope`: the nearest provider's scope, passed to\n   * components (undefined: the request's). `styles`: collects every `style` value written.\n   */\n  constructor(\n    protected readonly dev: boolean,\n    protected scope: unknown,\n    protected readonly styles?: StyleValues,\n  ) {}\n\n  /** Records a `style` value the DOM will see (empty values declare nothing). */\n  protected style(value: string): void {\n    if (value !== '' && this.styles !== undefined && !this.styles.has(value)) {\n      this.styles.set(value, this.where);\n    }\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 (name === 'style') this.style(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

@@ -10,6 +10,8 @@ export declare function multiText(values: readonly unknown[], from: number, stri
 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;
+/** An svg template written outside SVG content (`parent`: its parent's name, if known). */
+export declare function svgPlacementError(parent: string | undefined): 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. */

package/dist/view/server/values.js

@@ -70,6 +70,14 @@ export function fosterError(text, parent) {
         'the page would differ from what the client renders. Put text inside a <td>, <th> or ' +
         `<caption> (${SPEC}/09-template-rules.md, rule 7).`);
 }
+/** An svg template written outside SVG content (`parent`: its parent's name, if known). */
+export function svgPlacementError(parent) {
+    throw new Error(`gyral: an svg template is written ${parent === undefined ? 'at the root of a view' : `inside <${parent}>`}, ` +
+        "which isn't SVG content, so the parser would not create SVG elements and the page " +
+        'would differ from what the client renders. Render svg`…` fragments inside an <svg> (or ' +
+        'another SVG element, not <foreignObject>) of an html template, or write the whole ' +
+        `graphic with html (${SPEC}/01-templates.md "svg templates").`);
+}
 /** 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 ` +

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

@@ -1 +1 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/view/server/values.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,yFAAyF;AACzF,4FAA4F;AAC5F,4FAA4F;AAC5F,8EAA8E;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAErC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,CAAC;AAC9F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAe,EAAE,CAC3C,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,UAAU,CAAC;AAEnE,2FAA2F;AAC3F,MAAM,IAAI,GAAG,MAAoC,CAAC;AAElD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAW,EAAE,CACxC,OAAQ,CAAiC,CAAC,IAAI,KAAK,UAAU,CAAC;AAEhE,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,KAAa;IACnD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO;IAC3B,MAAM,IAAI,SAAS,CACjB,UAAU,KAAK,wEAAwE;QACrF,qFAAqF;QACrF,gBAAgB,IAAI,uBAAuB,CAC9C,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,SAAS,OAAO,CAAC,CAAU,EAAE,EAAU,EAAE,IAAY,EAAE,GAAY;IACjE,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,YAAY,CAAC,CAAC,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,CAAU,EAAE,EAAU,EAAE,IAAY,EAAE,GAAY;IACzE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CACvB,MAA0B,EAC1B,IAAY,EACZ,OAA0B,EAC1B,EAAU,EACV,IAAY,EACZ,GAAY;IAEZ,IAAI,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM;YACJ,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,GAAI,OAAO,CAAC,CAAC,CAAY,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,EAAU,EAAE,GAAY;IAC9D,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,YAAY,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACpC,IAAI,GAAG;YAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,8BAA8B;QAChF,IAAI,MAAM,8EAA8E;QACxF,sFAAsF;QACtF,cAAc,IAAI,iCAAiC,CACtD,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,KAAK,CACb,WAAW,GAAG,2EAA2E;QACvF,uFAAuF;QACvF,6BAA6B,IAAI,wCAAwC,CAC5E,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IACzC,MAAM,IAAI,SAAS,CACjB,oEAAoE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;QAC1F,uCAAuC,IAAI,mCAAmC,CACjF,CAAC;AACJ,CAAC","sourcesContent":["// Value rules for attribute and text-content holes on the server (view/02-bindings.md\n// \"Attribute values\", \"Live form state\"; view/06-server.md \"Writing a template result\"),\n// identical to the client's (render/attr-parts.ts) so both sides write the same attributes.\n// And the server-only errors: a Promise anywhere (renders are synchronous), text the parser\n// would move out of table structure, children given to a light-DOM component.\nimport { nothing } from '../render/values.js';\nimport { warnTrue, warnValue } from '../render/warn.js';\n\nconst SPEC = 'docs/design-docs/view';\n\nexport const absent = (v: unknown): boolean => v === null || v === undefined || v === nothing;\nexport const truthy = (v: unknown): boolean => v !== nothing && !!v;\n\nconst isObject = (v: unknown): v is object =>\n  (typeof v === 'object' && v !== null) || typeof v === 'function';\n\n/** `String(v)`: objects and functions as the client writes them (render/attr-parts.ts). */\nconst text = String as (value: unknown) => string;\n\nconst isThenable = (v: object): boolean =>\n  typeof (v as { readonly then?: unknown }).then === 'function';\n\n/** A Promise in any hole: server renders are synchronous (06 \"API\"). Always an error. */\nexport function checkPromise(v: object, where: string): void {\n  if (!isThenable(v)) return;\n  throw new TypeError(\n    `gyral: ${where} got a Promise. Server renders are synchronous: state is known before ` +\n      'rendering, so load the data first (in the route handler or a form action) and pass ' +\n      `it as props (${SPEC}/06-server.md \"API\").`,\n  );\n}\n\n/** `String(v)` for an attribute value, with the development warning for objects. */\nfunction written(v: unknown, at: object, name: string, dev: boolean): string {\n  if (typeof v === 'string') return v;\n  if (isObject(v)) {\n    checkPromise(v, `the attribute ${name}`);\n    if (dev) warnValue(at, v, `the attribute ${name}`);\n  }\n  return text(v);\n}\n\n/** `name=${v}`: the value to write, or null to leave the attribute out. */\nexport function attrText(v: unknown, at: object, name: string, dev: boolean): string | null {\n  return absent(v) ? null : written(v, at, name, dev);\n}\n\n/** `name=\"a ${x} b\"`: pieces joined; `nothing` in any piece leaves the attribute out. */\nexport function multiText(\n  values: readonly unknown[],\n  from: number,\n  strings: readonly string[],\n  at: object,\n  name: string,\n  dev: boolean,\n): string | null {\n  let joined = strings[0] ?? '';\n  for (let i = 1; i < strings.length; i++) {\n    const v = values[from + i - 1];\n    if (v === nothing) return null;\n    joined +=\n      (v === null || v === undefined ? '' : written(v, at, name, dev)) + (strings[i] as string);\n  }\n  return joined;\n}\n\n/** `<textarea>`/`<title>` content: child-hole rules flattened to a string, as on the client. */\nexport function textContent(v: unknown, at: object, dev: boolean): string {\n  if (typeof v === 'string') return v;\n  if (typeof v === 'number') return String(v);\n  if (isObject(v)) {\n    checkPromise(v, 'the text content');\n    if (dev) warnValue(at, v, 'the text content');\n    return text(v);\n  }\n  if (dev && v === true) warnTrue(at);\n  return '';\n}\n\n/** Text written directly in table structure would be foster-parented (rule 7). */\nexport function fosterError(text: string, parent: string): never {\n  throw new Error(\n    `gyral: the text ${JSON.stringify(text.slice(0, 40))} is written directly inside ` +\n      `<${parent}>. The HTML parser moves text out of table structure (foster parenting), so ` +\n      'the page would differ from what the client renders. Put text inside a <td>, <th> or ' +\n      `<caption> (${SPEC}/09-template-rules.md, rule 7).`,\n  );\n}\n\n/** A light-DOM component owns its children (ADR 0014). */\nexport function lightChildrenError(tag: string): never {\n  throw new Error(\n    `gyral: <${tag}> renders in light DOM (shadow: false), so it owns its children, but its ` +\n      'parent wrote children inside it. Pass the data as props instead, or make it a shadow ' +\n      `component and use <slot> (${SPEC}/06-server.md \"Components\", ADR 0014).`,\n  );\n}\n\n/** An attribute name from a hook's server half must not break the start tag. */\nexport function checkAttrName(name: string): void {\n  if (/^[^\\s\"'>/=\\0]+$/.test(name)) return;\n  throw new TypeError(\n    `gyral: an element hook's server half returned the attribute name ${JSON.stringify(name)}, ` +\n      `which isn't a valid attribute name (${SPEC}/02-bindings.md \"Element hooks\").`,\n  );\n}\n"]}
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/view/server/values.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,yFAAyF;AACzF,4FAA4F;AAC5F,4FAA4F;AAC5F,8EAA8E;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,IAAI,GAAG,uBAAuB,CAAC;AAErC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,OAAO,CAAC;AAC9F,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAU,EAAW,EAAE,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAe,EAAE,CAC3C,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,UAAU,CAAC;AAEnE,2FAA2F;AAC3F,MAAM,IAAI,GAAG,MAAoC,CAAC;AAElD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAW,EAAE,CACxC,OAAQ,CAAiC,CAAC,IAAI,KAAK,UAAU,CAAC;AAEhE,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,CAAS,EAAE,KAAa;IACnD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO;IAC3B,MAAM,IAAI,SAAS,CACjB,UAAU,KAAK,wEAAwE;QACrF,qFAAqF;QACrF,gBAAgB,IAAI,uBAAuB,CAC9C,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,SAAS,OAAO,CAAC,CAAU,EAAE,EAAU,EAAE,IAAY,EAAE,GAAY;IACjE,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,YAAY,CAAC,CAAC,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,GAAG;YAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,CAAU,EAAE,EAAU,EAAE,IAAY,EAAE,GAAY;IACzE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CACvB,MAA0B,EAC1B,IAAY,EACZ,OAA0B,EAC1B,EAAU,EACV,IAAY,EACZ,GAAY;IAEZ,IAAI,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,MAAM;YACJ,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,GAAI,OAAO,CAAC,CAAC,CAAY,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,EAAU,EAAE,GAAY;IAC9D,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,YAAY,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACpC,IAAI,GAAG;YAAE,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc;IACtD,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,8BAA8B;QAChF,IAAI,MAAM,8EAA8E;QACxF,sFAAsF;QACtF,cAAc,IAAI,iCAAiC,CACtD,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,IAAI;QAC5G,oFAAoF;QACpF,yFAAyF;QACzF,oFAAoF;QACpF,sBAAsB,IAAI,oCAAoC,CACjE,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,IAAI,KAAK,CACb,WAAW,GAAG,2EAA2E;QACvF,uFAAuF;QACvF,6BAA6B,IAAI,wCAAwC,CAC5E,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO;IACzC,MAAM,IAAI,SAAS,CACjB,oEAAoE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;QAC1F,uCAAuC,IAAI,mCAAmC,CACjF,CAAC;AACJ,CAAC","sourcesContent":["// Value rules for attribute and text-content holes on the server (view/02-bindings.md\n// \"Attribute values\", \"Live form state\"; view/06-server.md \"Writing a template result\"),\n// identical to the client's (render/attr-parts.ts) so both sides write the same attributes.\n// And the server-only errors: a Promise anywhere (renders are synchronous), text the parser\n// would move out of table structure, children given to a light-DOM component.\nimport { nothing } from '../render/values.js';\nimport { warnTrue, warnValue } from '../render/warn.js';\n\nconst SPEC = 'docs/design-docs/view';\n\nexport const absent = (v: unknown): boolean => v === null || v === undefined || v === nothing;\nexport const truthy = (v: unknown): boolean => v !== nothing && !!v;\n\nconst isObject = (v: unknown): v is object =>\n  (typeof v === 'object' && v !== null) || typeof v === 'function';\n\n/** `String(v)`: objects and functions as the client writes them (render/attr-parts.ts). */\nconst text = String as (value: unknown) => string;\n\nconst isThenable = (v: object): boolean =>\n  typeof (v as { readonly then?: unknown }).then === 'function';\n\n/** A Promise in any hole: server renders are synchronous (06 \"API\"). Always an error. */\nexport function checkPromise(v: object, where: string): void {\n  if (!isThenable(v)) return;\n  throw new TypeError(\n    `gyral: ${where} got a Promise. Server renders are synchronous: state is known before ` +\n      'rendering, so load the data first (in the route handler or a form action) and pass ' +\n      `it as props (${SPEC}/06-server.md \"API\").`,\n  );\n}\n\n/** `String(v)` for an attribute value, with the development warning for objects. */\nfunction written(v: unknown, at: object, name: string, dev: boolean): string {\n  if (typeof v === 'string') return v;\n  if (isObject(v)) {\n    checkPromise(v, `the attribute ${name}`);\n    if (dev) warnValue(at, v, `the attribute ${name}`);\n  }\n  return text(v);\n}\n\n/** `name=${v}`: the value to write, or null to leave the attribute out. */\nexport function attrText(v: unknown, at: object, name: string, dev: boolean): string | null {\n  return absent(v) ? null : written(v, at, name, dev);\n}\n\n/** `name=\"a ${x} b\"`: pieces joined; `nothing` in any piece leaves the attribute out. */\nexport function multiText(\n  values: readonly unknown[],\n  from: number,\n  strings: readonly string[],\n  at: object,\n  name: string,\n  dev: boolean,\n): string | null {\n  let joined = strings[0] ?? '';\n  for (let i = 1; i < strings.length; i++) {\n    const v = values[from + i - 1];\n    if (v === nothing) return null;\n    joined +=\n      (v === null || v === undefined ? '' : written(v, at, name, dev)) + (strings[i] as string);\n  }\n  return joined;\n}\n\n/** `<textarea>`/`<title>` content: child-hole rules flattened to a string, as on the client. */\nexport function textContent(v: unknown, at: object, dev: boolean): string {\n  if (typeof v === 'string') return v;\n  if (typeof v === 'number') return String(v);\n  if (isObject(v)) {\n    checkPromise(v, 'the text content');\n    if (dev) warnValue(at, v, 'the text content');\n    return text(v);\n  }\n  if (dev && v === true) warnTrue(at);\n  return '';\n}\n\n/** Text written directly in table structure would be foster-parented (rule 7). */\nexport function fosterError(text: string, parent: string): never {\n  throw new Error(\n    `gyral: the text ${JSON.stringify(text.slice(0, 40))} is written directly inside ` +\n      `<${parent}>. The HTML parser moves text out of table structure (foster parenting), so ` +\n      'the page would differ from what the client renders. Put text inside a <td>, <th> or ' +\n      `<caption> (${SPEC}/09-template-rules.md, rule 7).`,\n  );\n}\n\n/** An svg template written outside SVG content (`parent`: its parent's name, if known). */\nexport function svgPlacementError(parent: string | undefined): never {\n  throw new Error(\n    `gyral: an svg template is written ${parent === undefined ? 'at the root of a view' : `inside <${parent}>`}, ` +\n      \"which isn't SVG content, so the parser would not create SVG elements and the page \" +\n      'would differ from what the client renders. Render svg`…` fragments inside an <svg> (or ' +\n      'another SVG element, not <foreignObject>) of an html template, or write the whole ' +\n      `graphic with html (${SPEC}/01-templates.md \"svg templates\").`,\n  );\n}\n\n/** A light-DOM component owns its children (ADR 0014). */\nexport function lightChildrenError(tag: string): never {\n  throw new Error(\n    `gyral: <${tag}> renders in light DOM (shadow: false), so it owns its children, but its ` +\n      'parent wrote children inside it. Pass the data as props instead, or make it a shadow ' +\n      `component and use <slot> (${SPEC}/06-server.md \"Components\", ADR 0014).`,\n  );\n}\n\n/** An attribute name from a hook's server half must not break the start tag. */\nexport function checkAttrName(name: string): void {\n  if (/^[^\\s\"'>/=\\0]+$/.test(name)) return;\n  throw new TypeError(\n    `gyral: an element hook's server half returned the attribute name ${JSON.stringify(name)}, ` +\n      `which isn't a valid attribute name (${SPEC}/02-bindings.md \"Element hooks\").`,\n  );\n}\n"]}

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

@@ -1,16 +1,21 @@
 import { type TemplateResult } from '../template.js';
 import { Markup } from './tags.js';
-export type { Deferred, Item } from './tags.js';
+export type { Deferred, Item, StyleValues } from './tags.js';
+/**
+ * What a child hole's parent means for its value (the development checks): a table tag (text
+ * would be foster-parented), SVG content (where svg templates may render), or nothing.
+ */
+type Ctx = string | undefined;
 /** Warning key for values outside any template (the render root, a component's view). */
 export declare const ROOT: object;
 export declare class Writer extends Markup {
     /** Writing a page shell's holes (a `server` template): never hydrated, so no anchors (06). */
     private shell;
-    /** A child value (02 "Child values"). `table`: the parent, when it is table structure. */
-    child(v: unknown, table: string | undefined, at: object): void;
+    /** A child value (02 "Child values"). `ctx`: what its parent is (`Ctx`). */
+    child(v: unknown, ctx: Ctx, at: object): void;
     private object;
     /** `each(…)`: rows one after another, no markers (03). Keys are checked in development. */
     private list;
     /** One template instance: its segments with this render's values. */
-    template(result: TemplateResult, table: string | undefined): void;
+    template(result: TemplateResult, ctx: Ctx): void;
 }

package/dist/view/server/writer.js

@@ -7,10 +7,13 @@ import { badChild, badKey, warnTrue } from '../render/warn.js';
 import { isTemplateResult, templateOf } from '../template.js';
 import { escapeText, onlyWhitespace } from './escape.js';
 import { Markup, PLAIN } from './tags.js';
-import { checkPromise, fosterError, textContent, truthy } from './values.js';
+import { checkPromise, fosterError, svgPlacementError, textContent, truthy } from './values.js';
 /** Parents in which the parser moves non-whitespace text out (foster parenting). */
 const TABLE = new Set(['table', 'tbody', 'thead', 'tfoot', 'tr']);
-const tableTag = (parent) => (TABLE.has(parent) ? parent : undefined);
+const SVG = '#svg';
+const isTable = (ctx) => ctx !== undefined && TABLE.has(ctx);
+/** A child op's context: its parent's, or the enclosing one at the template root. */
+const ctxOf = (s, outer) => s.svg ? SVG : s.in === undefined ? outer : s.in;
 /** Warning key for values outside any template (the render root, a component's view). */
 export const ROOT = {};
 export class Writer extends Markup {
@@ -19,24 +22,24 @@ export class Writer extends Markup {
         /** Writing a page shell's holes (a `server` template): never hydrated, so no anchors (06). */
         this.shell = false;
     }
-    /** A child value (02 "Child values"). `table`: the parent, when it is table structure. */
-    child(v, table, at) {
+    /** A child value (02 "Child values"). `ctx`: what its parent is (`Ctx`). */
+    child(v, ctx, at) {
         switch (typeof v) {
             case 'string':
                 if (v === '')
                     return;
-                if (table !== undefined && this.dev && !onlyWhitespace(v))
-                    fosterError(v, table);
+                if (this.dev && isTable(ctx) && !onlyWhitespace(v))
+                    fosterError(v, ctx);
                 this.buf += escapeText(v);
                 return;
             case 'number':
-                if (table !== undefined && this.dev)
-                    fosterError(String(v), table);
+                if (this.dev && isTable(ctx))
+                    fosterError(String(v), ctx);
                 this.buf += String(v);
                 return;
             case 'object':
                 if (v !== null)
-                    this.object(v, table, at);
+                    this.object(v, ctx, at);
                 return;
             case 'boolean':
                 if (v && this.dev)
@@ -49,18 +52,18 @@ export class Writer extends Markup {
                     badChild(v);
         }
     }
-    object(v, table, at) {
+    object(v, ctx, at) {
         if (isTemplateResult(v)) {
-            this.template(v, table);
+            this.template(v, ctx);
             return;
         }
         if (isList(v)) {
-            this.list(v, table, at);
+            this.list(v, ctx, at);
             return;
         }
         if (Array.isArray(v)) {
             for (const item of v)
-                this.child(item, table, at);
+                this.child(item, ctx, at);
             return;
         }
         const raw = rawHtml(v);
@@ -74,7 +77,7 @@ export class Writer extends Markup {
             badChild(v);
     }
     /** `each(…)`: rows one after another, no markers (03). Keys are checked in development. */
-    list(v, table, at) {
+    list(v, ctx, at) {
         const { items, key, row, pick } = v;
         const seen = this.dev ? new Set() : undefined;
         for (let i = 0; i < items.length; i++) {
@@ -86,11 +89,11 @@ export class Writer extends Markup {
                     badKey(k, i, dup);
                 seen.add(k);
             }
-            this.child(row(item, pick === undefined ? undefined : pick(item)), table, at);
+            this.child(row(item, pick === undefined ? undefined : pick(item)), ctx, at);
         }
     }
     /** One template instance: its segments with this render's values. */
-    template(result, table) {
+    template(result, ctx) {
         const template = templateOf(result);
         const segments = template.segments;
         if (segments === undefined) {
@@ -99,13 +102,22 @@ export class Writer extends Markup {
                 '(or the runtime normalizer), which keeps them ' +
                 '(docs/design-docs/view/01-templates.md "Compiled").');
         }
+        // An svg template is SVG content: the parser creates SVG elements only inside SVG (01).
+        if (this.dev && template.svg && ctx !== SVG)
+            svgPlacementError(ctx);
         // Development marker: hydration checks the id before each instance (07). Page shells are
         // never hydrated.
         if (this.dev && !template.server)
             this.buf += `<!--gyral:${template.id ?? ''}-->`;
         const values = result.values;
         const outer = this.shell;
+        const outerWhere = this.where;
         this.shell = template.server === true;
+        if (this.styles !== undefined) {
+            this.where = template.loc ?? template.id ?? '';
+            for (const css of template.staticStyles ?? [])
+                this.style(css);
+        }
         let at = 0;
         let opening;
         let frames;
@@ -116,7 +128,7 @@ export class Writer extends Markup {
             }
             switch (s.k) {
                 case 'child':
-                    this.child(values[at++], s.in === undefined ? table : tableTag(s.in), s);
+                    this.child(values[at++], ctxOf(s, ctx), s);
                     break;
                 case 'text':
                     this.buf += escapeText(textContent(values[at++], s, this.dev));
@@ -126,8 +138,10 @@ export class Writer extends Markup {
                     break;
                 case 'bool':
                     // `?indeterminate` has no attribute: it is the property only (02 "Live form state").
-                    if (truthy(values[at]) && s.name !== 'indeterminate')
+                    // `?modal`/`?popover-open` neither: the browser opens them after hydration (02).
+                    if (truthy(values[at]) && !/^(indeterminate|modal|popover-open)$/.test(s.name)) {
                         this.bare(s.name, opening);
+                    }
                     at++;
                     break;
                 case 'prop':
@@ -150,6 +164,7 @@ export class Writer extends Markup {
             }
         }
         this.shell = outer;
+        this.where = outerWhere;
     }
 }
 //# sourceMappingURL=writer.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/view/server/writer.ts"],"names":[],"mappings":"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","sourcesContent":["// The server renderer's walk (view/06-server.md \"Writing a template result\"): writes a child\n// value by walking template objects' `segments` (01), never tokenizing or building a DOM. Each\n// string segment is written verbatim; each hole op takes its value(s). Start tags and custom\n// elements are tags.ts.\nimport { isList, nothing, rawHtml, type ListResult } from '../render/values.js';\nimport { badChild, badKey, warnTrue } from '../render/warn.js';\nimport { isTemplateResult, templateOf, type TemplateResult } from '../template.js';\nimport { escapeText, onlyWhitespace } from './escape.js';\nimport { Markup, PLAIN, type Frame, type Opening } from './tags.js';\nimport { checkPromise, fosterError, textContent, truthy } from './values.js';\n\nexport type { Deferred, Item } from './tags.js';\n\n/** Parents in which the parser moves non-whitespace text out (foster parenting). */\nconst TABLE = new Set(['table', 'tbody', 'thead', 'tfoot', 'tr']);\n\nconst tableTag = (parent: string): string | undefined => (TABLE.has(parent) ? parent : undefined);\n\n/** Warning key for values outside any template (the render root, a component's view). */\nexport const ROOT: object = {};\n\nexport class Writer extends Markup {\n  /** Writing a page shell's holes (a `server` template): never hydrated, so no anchors (06). */\n  private shell = false;\n\n  /** A child value (02 \"Child values\"). `table`: the parent, when it is table structure. */\n  child(v: unknown, table: string | undefined, at: object): void {\n    switch (typeof v) {\n      case 'string':\n        if (v === '') return;\n        if (table !== undefined && this.dev && !onlyWhitespace(v)) fosterError(v, table);\n        this.buf += escapeText(v);\n        return;\n      case 'number':\n        if (table !== undefined && this.dev) fosterError(String(v), table);\n        this.buf += String(v);\n        return;\n      case 'object':\n        if (v !== null) this.object(v, table, at);\n        return;\n      case 'boolean':\n        if (v && this.dev) warnTrue(at);\n        return;\n      case 'undefined':\n        return;\n      default:\n        if (v !== nothing && this.dev) badChild(v);\n    }\n  }\n\n  private object(v: object, table: string | undefined, at: object): void {\n    if (isTemplateResult(v)) {\n      this.template(v, table);\n      return;\n    }\n    if (isList(v)) {\n      this.list(v, table, at);\n      return;\n    }\n    if (Array.isArray(v)) {\n      for (const item of v as readonly unknown[]) this.child(item, table, at);\n      return;\n    }\n    const raw = rawHtml(v);\n    if (raw !== undefined) {\n      // The start anchor hydration finds (02 \"raw(html)\"); a page shell is never hydrated.\n      this.buf += this.shell ? raw : `<!---->${raw}`;\n      return;\n    }\n    checkPromise(v, 'a child hole');\n    if (this.dev) badChild(v);\n  }\n\n  /** `each(…)`: rows one after another, no markers (03). Keys are checked in development. */\n  private list(v: ListResult, table: string | undefined, at: object): void {\n    const { items, key, row, pick } = v;\n    const seen = this.dev ? new Set<unknown>() : undefined;\n    for (let i = 0; i < items.length; i++) {\n      const item = items[i];\n      if (seen !== undefined) {\n        const k = key(item);\n        const dup = seen.has(k);\n        if (dup || (typeof k !== 'string' && typeof k !== 'number')) badKey(k, i, dup);\n        seen.add(k);\n      }\n      this.child(row(item, pick === undefined ? undefined : pick(item)), table, at);\n    }\n  }\n\n  /** One template instance: its segments with this render's values. */\n  template(result: TemplateResult, table: string | undefined): void {\n    const template = templateOf(result);\n    const segments = template.segments;\n    if (segments === undefined) {\n      throw new Error(\n        `gyral: template ${JSON.stringify(template.html.slice(0, 40))} has no server ` +\n          'segments: it was compiled for the client. Render on the server with an SSR build ' +\n          '(or the runtime normalizer), which keeps them ' +\n          '(docs/design-docs/view/01-templates.md \"Compiled\").',\n      );\n    }\n    // Development marker: hydration checks the id before each instance (07). Page shells are\n    // never hydrated.\n    if (this.dev && !template.server) this.buf += `<!--gyral:${template.id ?? ''}-->`;\n    const values = result.values;\n    const outer = this.shell;\n    this.shell = template.server === true;\n    let at = 0;\n    let opening: Opening | undefined;\n    let frames: Frame[] | undefined;\n    for (const s of segments) {\n      if (typeof s === 'string') {\n        this.buf += s;\n        continue;\n      }\n      switch (s.k) {\n        case 'child':\n          this.child(values[at++], s.in === undefined ? table : tableTag(s.in), s);\n          break;\n        case 'text':\n          this.buf += escapeText(textContent(values[at++], s, this.dev));\n          break;\n        case 'attr':\n          at = this.attr(s, values, at, opening);\n          break;\n        case 'bool':\n          // `?indeterminate` has no attribute: it is the property only (02 \"Live form state\").\n          if (truthy(values[at]) && s.name !== 'indeterminate') this.bare(s.name, opening);\n          at++;\n          break;\n        case 'prop':\n          if (opening !== undefined) opening.properties[s.name] = values[at];\n          at++;\n          break;\n        case 'hook':\n          this.hook(values[at++], opening);\n          break;\n        case 'open':\n          opening = this.open(s.tag, s.html, s.attrs);\n          break;\n        case 'openEnd':\n          (frames ??= []).push(this.openEnd(opening));\n          opening = undefined;\n          break;\n        case 'close':\n          this.close(frames?.pop() ?? PLAIN, s.tag);\n      }\n    }\n    this.shell = outer;\n  }\n}\n"]}
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/view/server/writer.ts"],"names":[],"mappings":"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","sourcesContent":["// The server renderer's walk (view/06-server.md \"Writing a template result\"): writes a child\n// value by walking template objects' `segments` (01), never tokenizing or building a DOM. Each\n// string segment is written verbatim; each hole op takes its value(s). Start tags and custom\n// elements are tags.ts.\nimport { isList, nothing, rawHtml, type ListResult } from '../render/values.js';\nimport { badChild, badKey, warnTrue } from '../render/warn.js';\nimport { isTemplateResult, templateOf, type TemplateResult } from '../template.js';\nimport { escapeText, onlyWhitespace } from './escape.js';\nimport { Markup, PLAIN, type Frame, type Opening } from './tags.js';\nimport { checkPromise, fosterError, svgPlacementError, textContent, truthy } from './values.js';\n\nexport type { Deferred, Item, StyleValues } from './tags.js';\n\n/** Parents in which the parser moves non-whitespace text out (foster parenting). */\nconst TABLE = new Set(['table', 'tbody', 'thead', 'tfoot', 'tr']);\n\n/**\n * What a child hole's parent means for its value (the development checks): a table tag (text\n * would be foster-parented), SVG content (where svg templates may render), or nothing.\n */\ntype Ctx = string | undefined;\nconst SVG: Ctx = '#svg';\n\nconst isTable = (ctx: Ctx): ctx is string => ctx !== undefined && TABLE.has(ctx);\n\n/** A child op's context: its parent's, or the enclosing one at the template root. */\nconst ctxOf = (s: { readonly in?: string; readonly svg?: true }, outer: Ctx): Ctx =>\n  s.svg ? SVG : s.in === undefined ? outer : s.in;\n\n/** Warning key for values outside any template (the render root, a component's view). */\nexport const ROOT: object = {};\n\nexport class Writer extends Markup {\n  /** Writing a page shell's holes (a `server` template): never hydrated, so no anchors (06). */\n  private shell = false;\n\n  /** A child value (02 \"Child values\"). `ctx`: what its parent is (`Ctx`). */\n  child(v: unknown, ctx: Ctx, at: object): void {\n    switch (typeof v) {\n      case 'string':\n        if (v === '') return;\n        if (this.dev && isTable(ctx) && !onlyWhitespace(v)) fosterError(v, ctx);\n        this.buf += escapeText(v);\n        return;\n      case 'number':\n        if (this.dev && isTable(ctx)) fosterError(String(v), ctx);\n        this.buf += String(v);\n        return;\n      case 'object':\n        if (v !== null) this.object(v, ctx, at);\n        return;\n      case 'boolean':\n        if (v && this.dev) warnTrue(at);\n        return;\n      case 'undefined':\n        return;\n      default:\n        if (v !== nothing && this.dev) badChild(v);\n    }\n  }\n\n  private object(v: object, ctx: Ctx, at: object): void {\n    if (isTemplateResult(v)) {\n      this.template(v, ctx);\n      return;\n    }\n    if (isList(v)) {\n      this.list(v, ctx, at);\n      return;\n    }\n    if (Array.isArray(v)) {\n      for (const item of v as readonly unknown[]) this.child(item, ctx, at);\n      return;\n    }\n    const raw = rawHtml(v);\n    if (raw !== undefined) {\n      // The start anchor hydration finds (02 \"raw(html)\"); a page shell is never hydrated.\n      this.buf += this.shell ? raw : `<!---->${raw}`;\n      return;\n    }\n    checkPromise(v, 'a child hole');\n    if (this.dev) badChild(v);\n  }\n\n  /** `each(…)`: rows one after another, no markers (03). Keys are checked in development. */\n  private list(v: ListResult, ctx: Ctx, at: object): void {\n    const { items, key, row, pick } = v;\n    const seen = this.dev ? new Set<unknown>() : undefined;\n    for (let i = 0; i < items.length; i++) {\n      const item = items[i];\n      if (seen !== undefined) {\n        const k = key(item);\n        const dup = seen.has(k);\n        if (dup || (typeof k !== 'string' && typeof k !== 'number')) badKey(k, i, dup);\n        seen.add(k);\n      }\n      this.child(row(item, pick === undefined ? undefined : pick(item)), ctx, at);\n    }\n  }\n\n  /** One template instance: its segments with this render's values. */\n  template(result: TemplateResult, ctx: Ctx): void {\n    const template = templateOf(result);\n    const segments = template.segments;\n    if (segments === undefined) {\n      throw new Error(\n        `gyral: template ${JSON.stringify(template.html.slice(0, 40))} has no server ` +\n          'segments: it was compiled for the client. Render on the server with an SSR build ' +\n          '(or the runtime normalizer), which keeps them ' +\n          '(docs/design-docs/view/01-templates.md \"Compiled\").',\n      );\n    }\n    // An svg template is SVG content: the parser creates SVG elements only inside SVG (01).\n    if (this.dev && template.svg && ctx !== SVG) svgPlacementError(ctx);\n    // Development marker: hydration checks the id before each instance (07). Page shells are\n    // never hydrated.\n    if (this.dev && !template.server) this.buf += `<!--gyral:${template.id ?? ''}-->`;\n    const values = result.values;\n    const outer = this.shell;\n    const outerWhere = this.where;\n    this.shell = template.server === true;\n    if (this.styles !== undefined) {\n      this.where = template.loc ?? template.id ?? '';\n      for (const css of template.staticStyles ?? []) this.style(css);\n    }\n    let at = 0;\n    let opening: Opening | undefined;\n    let frames: Frame[] | undefined;\n    for (const s of segments) {\n      if (typeof s === 'string') {\n        this.buf += s;\n        continue;\n      }\n      switch (s.k) {\n        case 'child':\n          this.child(values[at++], ctxOf(s, ctx), s);\n          break;\n        case 'text':\n          this.buf += escapeText(textContent(values[at++], s, this.dev));\n          break;\n        case 'attr':\n          at = this.attr(s, values, at, opening);\n          break;\n        case 'bool':\n          // `?indeterminate` has no attribute: it is the property only (02 \"Live form state\").\n          // `?modal`/`?popover-open` neither: the browser opens them after hydration (02).\n          if (truthy(values[at]) && !/^(indeterminate|modal|popover-open)$/.test(s.name)) {\n            this.bare(s.name, opening);\n          }\n          at++;\n          break;\n        case 'prop':\n          if (opening !== undefined) opening.properties[s.name] = values[at];\n          at++;\n          break;\n        case 'hook':\n          this.hook(values[at++], opening);\n          break;\n        case 'open':\n          opening = this.open(s.tag, s.html, s.attrs);\n          break;\n        case 'openEnd':\n          (frames ??= []).push(this.openEnd(opening));\n          opening = undefined;\n          break;\n        case 'close':\n          this.close(frames?.pop() ?? PLAIN, s.tag);\n      }\n    }\n    this.shell = outer;\n    this.where = outerWhere;\n  }\n}\n"]}

package/dist/view/template-element.d.ts

@@ -1,3 +1,10 @@
 import type { TemplateObject } from './normalize/types.js';
 /** The cached <template> element for `template`, parsed (and checked) on first use. */
 export declare function templateElement(template: TemplateObject): HTMLTemplateElement;
+/**
+ * Prepares an svg template's <template> element (01 "svg templates"): its HTML is parsed inside
+ * an <svg>, so the parser creates SVG elements (camelCase names and attributes, namespaced
+ * static attributes), and that <svg>'s children become the content. Called with every svg
+ * result, before anything renders it; outside a document (the server) there is nothing to do.
+ */
+export declare function svgTemplate(template: TemplateObject): void;

package/dist/view/template-element.js

@@ -1,9 +1,14 @@
 // One <template> element per template object, created on first use (view/01-templates.md
 // "Instantiation"). The browser's own parser builds it from the template HTML; the runtime
-// preparer then checks the parse (rule 7). Server templates never get one (rule 11).
+// preparer then checks the parse (rule 7). Server templates never get one (rule 11). An svg
+// template's is prepared by `svgTemplate` when its first result is made (template.ts `svg`), so
+// apps without svg templates don't carry that code. Both parse through the `gyral` Trusted Types
+// policy (trusted-html.ts).
 import { verify } from '#prepare';
 import { DEV } from '#view-dev';
+import { message } from './message.js';
 import { SERVER_ONLY, TemplateError } from './normalize/errors.js';
+import { trustedHTML } from './trusted-html.js';
 const elements = new WeakMap();
 /** The cached <template> element for `template`, parsed (and checked) on first use. */
 export function templateElement(template) {
@@ -12,14 +17,29 @@ export function templateElement(template) {
         return cached;
     if (template.server) {
         // Production keeps a short message: the class and its explanation stay out of the bundle.
-        throw DEV
-            ? new TemplateError(11, SERVER_ONLY, template.loc)
-            : new Error('gyral: template rule 11: a page shell rendered in the browser.');
+        throw DEV ? new TemplateError(11, SERVER_ONLY, template.loc) : new Error(message(71));
     }
     const el = document.createElement('template');
-    el.innerHTML = template.html;
+    el.innerHTML = trustedHTML(template.html);
     verify(template, el);
     elements.set(template, el);
     return el;
 }
+/**
+ * Prepares an svg template's <template> element (01 "svg templates"): its HTML is parsed inside
+ * an <svg>, so the parser creates SVG elements (camelCase names and attributes, namespaced
+ * static attributes), and that <svg>'s children become the content. Called with every svg
+ * result, before anything renders it; outside a document (the server) there is nothing to do.
+ */
+export function svgTemplate(template) {
+    if (elements.has(template) || typeof document === 'undefined')
+        return;
+    const el = document.createElement('template');
+    el.innerHTML = trustedHTML(`<svg>${template.html}</svg>`);
+    const content = el.content;
+    // Anything the parser moved out of the <svg> is dropped here, and the check reports it.
+    content.replaceChildren(...content.firstChild.childNodes);
+    verify(template, el);
+    elements.set(template, el);
+}
 //# sourceMappingURL=template-element.js.map

package/dist/view/template-element.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-element.js","sourceRoot":"","sources":["../../src/view/template-element.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,2FAA2F;AAC3F,qFAAqF;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGnE,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuC,CAAC;AAEpE,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,0FAA0F;QAC1F,MAAM,GAAG;YACP,CAAC,CAAC,IAAI,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["// One <template> element per template object, created on first use (view/01-templates.md\n// \"Instantiation\"). The browser's own parser builds it from the template HTML; the runtime\n// preparer then checks the parse (rule 7). Server templates never get one (rule 11).\nimport { verify } from '#prepare';\nimport { DEV } from '#view-dev';\nimport { SERVER_ONLY, TemplateError } from './normalize/errors.js';\nimport type { TemplateObject } from './normalize/types.js';\n\nconst elements = new WeakMap<TemplateObject, HTMLTemplateElement>();\n\n/** The cached <template> element for `template`, parsed (and checked) on first use. */\nexport function templateElement(template: TemplateObject): HTMLTemplateElement {\n  const cached = elements.get(template);\n  if (cached !== undefined) return cached;\n  if (template.server) {\n    // Production keeps a short message: the class and its explanation stay out of the bundle.\n    throw DEV\n      ? new TemplateError(11, SERVER_ONLY, template.loc)\n      : new Error('gyral: template rule 11: a page shell rendered in the browser.');\n  }\n  const el = document.createElement('template');\n  el.innerHTML = template.html;\n  verify(template, el);\n  elements.set(template, el);\n  return el;\n}\n"]}
+{"version":3,"file":"template-element.js","sourceRoot":"","sources":["../../src/view/template-element.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,2FAA2F;AAC3F,4FAA4F;AAC5F,gGAAgG;AAChG,iGAAiG;AACjG,4BAA4B;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuC,CAAC;AAEpE,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,QAAwB;IACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,0FAA0F;QAC1F,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAwB;IAClD,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IACtE,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,EAAE,CAAC,SAAS,GAAG,WAAW,CAAC,QAAQ,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;IAC3B,wFAAwF;IACxF,OAAO,CAAC,eAAe,CAAC,GAAI,OAAO,CAAC,UAAsB,CAAC,UAAU,CAAC,CAAC;IACvE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["// One <template> element per template object, created on first use (view/01-templates.md\n// \"Instantiation\"). The browser's own parser builds it from the template HTML; the runtime\n// preparer then checks the parse (rule 7). Server templates never get one (rule 11). An svg\n// template's is prepared by `svgTemplate` when its first result is made (template.ts `svg`), so\n// apps without svg templates don't carry that code. Both parse through the `gyral` Trusted Types\n// policy (trusted-html.ts).\nimport { verify } from '#prepare';\nimport { DEV } from '#view-dev';\nimport { message } from './message.js';\nimport { SERVER_ONLY, TemplateError } from './normalize/errors.js';\nimport type { TemplateObject } from './normalize/types.js';\nimport { trustedHTML } from './trusted-html.js';\n\nconst elements = new WeakMap<TemplateObject, HTMLTemplateElement>();\n\n/** The cached <template> element for `template`, parsed (and checked) on first use. */\nexport function templateElement(template: TemplateObject): HTMLTemplateElement {\n  const cached = elements.get(template);\n  if (cached !== undefined) return cached;\n  if (template.server) {\n    // Production keeps a short message: the class and its explanation stay out of the bundle.\n    throw DEV ? new TemplateError(11, SERVER_ONLY, template.loc) : new Error(message(71));\n  }\n  const el = document.createElement('template');\n  el.innerHTML = trustedHTML(template.html);\n  verify(template, el);\n  elements.set(template, el);\n  return el;\n}\n\n/**\n * Prepares an svg template's <template> element (01 \"svg templates\"): its HTML is parsed inside\n * an <svg>, so the parser creates SVG elements (camelCase names and attributes, namespaced\n * static attributes), and that <svg>'s children become the content. Called with every svg\n * result, before anything renders it; outside a document (the server) there is nothing to do.\n */\nexport function svgTemplate(template: TemplateObject): void {\n  if (elements.has(template) || typeof document === 'undefined') return;\n  const el = document.createElement('template');\n  el.innerHTML = trustedHTML(`<svg>${template.html}</svg>`);\n  const content = el.content;\n  // Anything the parser moved out of the <svg> is dropped here, and the check reports it.\n  content.replaceChildren(...(content.firstChild as Element).childNodes);\n  verify(template, el);\n  elements.set(template, el);\n}\n"]}

package/dist/view/template.d.ts

@@ -6,9 +6,17 @@ export interface TemplateResult {
     readonly values: readonly unknown[];
 }
 /** The template tag: `` html`<p>${s.text}</p>` ``. */
-export declare function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult;
-/** Internal: what the template compiler (Phase 6) rewrites `html` calls into. */
+export declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => TemplateResult;
+/**
+ * The SVG fragment tag: `` svg`<path d=${s.d} />` ``. Its top level is SVG content, so it
+ * renders only inside an `<svg>` (or another SVG element) of an html template
+ * (view/01-templates.md "svg templates"). A whole `<svg>` graphic is written with html.
+ */
+export declare const svg: (strings: TemplateStringsArray, ...values: unknown[]) => TemplateResult;
+/** Internal: what the template compiler (`@gyral/core/vite`) rewrites `html` calls into. */
 export declare function compiled(template: TemplateObject, values: readonly unknown[]): TemplateResult;
+/** Internal: what the template compiler rewrites `svg` calls into. */
+export declare function compiledSvg(template: TemplateObject, values: readonly unknown[]): TemplateResult;
 export declare function isTemplateResult(value: unknown): value is TemplateResult;
 /** Internal: a result's source, compared by identity to skip `templateOf` on updates. */
 export declare const sourceOf: (result: TemplateResult) => readonly string[] | TemplateObject;

package/dist/view/template.js

@@ -1,18 +1,72 @@
-// Template results and the `html` tag (view/01-templates.md "Authoring", "Template results").
-// A result is a template source (the call site's strings, or a compiled template object) plus
-// this call's values, recognised by a module-private symbol so data from JSON can never pass
-// for one. `templateOf` turns the source into the template object: compiled results carry it,
-// runtime results are normalized once per strings array through `#prepare` (prepare.ts).
+// Template results and the `html` and `svg` tags (view/01-templates.md "Authoring", "Template
+// results", "svg templates"). A result is a template source (the call site's strings, or a
+// template object) plus this call's values, recognised by a module-private symbol so data from
+// JSON can never pass for one. `templateOf` turns the source into the template object: compiled
+// and svg results carry it, html results are normalized once per strings array through
+// `#prepare` (prepare.ts). Development records each call site's source location (loc.ts) for
+// error messages.
 import { prepare } from '#prepare';
+import { DEV } from '#view-dev';
+import { callSite, locOf, setLoc } from './loc.js';
+import { svgTemplate } from './template-element.js';
 const SOURCE = Symbol('gyral.template');
-/** The template tag: `` html`<p>${s.text}</p>` ``. */
-export function html(strings, ...values) {
+/** The template tag, as `html` is in production. */
+function tag(strings, ...values) {
+    // Development: the call site, from the stack, the first time (unless `html.at` gave it).
+    if (DEV && locOf(strings) === undefined)
+        setLoc(strings, callSite(new Error().stack));
     return { [SOURCE]: strings, values };
 }
-/** Internal: what the template compiler (Phase 6) rewrites `html` calls into. */
+/** The svg tag, as `svg` is in production: svg results carry their (prepared) template. */
+function svgTag(strings, ...values) {
+    // Development: the call site, from the stack, the first time (unless `svg.at` gave it), so
+    // the normalizer's rule errors name it.
+    if (DEV && locOf(strings) === undefined)
+        setLoc(strings, callSite(new Error().stack));
+    return compiledSvg(prepare(strings, true), values);
+}
+/**
+ * Development: `html.at(loc)` (and `svg.at(loc)`) is the tag with a known call site. The Vite
+ * preset's dev transform (compiler/locate.ts) writes it at every call site, since stack
+ * positions in transformed modules aren't the author's lines. Attached here, not by a statement
+ * that mentions the tag, so production builds don't keep it alive (the compiler checks that).
+ */
+function withAt(html) {
+    const tags = new Map();
+    const at = (loc) => {
+        let located = tags.get(loc);
+        if (located === undefined) {
+            located = (strings, ...values) => {
+                setLoc(strings, loc);
+                return html(strings, ...values);
+            };
+            tags.set(loc, located);
+        }
+        return located;
+    };
+    return Object.assign(html, { at });
+}
+/** The template tag: `` html`<p>${s.text}</p>` ``. */
+export const html = DEV
+    ? withAt(tag)
+    : tag;
+/**
+ * The SVG fragment tag: `` svg`<path d=${s.d} />` ``. Its top level is SVG content, so it
+ * renders only inside an `<svg>` (or another SVG element) of an html template
+ * (view/01-templates.md "svg templates"). A whole `<svg>` graphic is written with html.
+ */
+export const svg = DEV
+    ? withAt(svgTag)
+    : svgTag;
+/** Internal: what the template compiler (`@gyral/core/vite`) rewrites `html` calls into. */
 export function compiled(template, values) {
     return { [SOURCE]: template, values };
 }
+/** Internal: what the template compiler rewrites `svg` calls into. */
+export function compiledSvg(template, values) {
+    svgTemplate(template);
+    return { [SOURCE]: template, values };
+}
 export function isTemplateResult(value) {
     return typeof value === 'object' && value !== null && SOURCE in value;
 }

package/dist/view/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/view/template.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,8FAA8F;AAC9F,6FAA6F;AAC7F,8FAA8F;AAC9F,yFAAyF;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC,MAAM,MAAM,GAAkB,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAQvD,sDAAsD;AACtD,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACtE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,QAAwB,EAAE,MAA0B;IAC3E,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,CAAC;AACxE,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAsB,EAAsC,EAAE,CACrF,MAAM,CAAC,MAAM,CAAC,CAAC;AAEjB;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAsB;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAyB,CAAC;AAC9E,CAAC","sourcesContent":["// Template results and the `html` tag (view/01-templates.md \"Authoring\", \"Template results\").\n// A result is a template source (the call site's strings, or a compiled template object) plus\n// this call's values, recognised by a module-private symbol so data from JSON can never pass\n// for one. `templateOf` turns the source into the template object: compiled results carry it,\n// runtime results are normalized once per strings array through `#prepare` (prepare.ts).\nimport { prepare } from '#prepare';\nimport type { TemplateObject } from './normalize/types.js';\n\nconst SOURCE: unique symbol = Symbol('gyral.template');\n\n/** What `html` returns: a template plus this render's values. */\nexport interface TemplateResult {\n  readonly [SOURCE]: readonly string[] | TemplateObject;\n  readonly values: readonly unknown[];\n}\n\n/** The template tag: `` html`<p>${s.text}</p>` ``. */\nexport function html(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult {\n  return { [SOURCE]: strings, values };\n}\n\n/** Internal: what the template compiler (Phase 6) rewrites `html` calls into. */\nexport function compiled(template: TemplateObject, values: readonly unknown[]): TemplateResult {\n  return { [SOURCE]: template, values };\n}\n\nexport function isTemplateResult(value: unknown): value is TemplateResult {\n  return typeof value === 'object' && value !== null && SOURCE in value;\n}\n\n/** Internal: a result's source, compared by identity to skip `templateOf` on updates. */\nexport const sourceOf = (result: TemplateResult): readonly string[] | TemplateObject =>\n  result[SOURCE];\n\n/**\n * The template object of a result: compiled results carry it; a runtime result's call site is\n * normalized once by `#prepare` (cached there, so compiled builds carry neither the preparer\n * nor its cache).\n */\nexport function templateOf(result: TemplateResult): TemplateObject {\n  const source = result[SOURCE];\n  return Array.isArray(source) ? prepare(source) : (source as TemplateObject);\n}\n"]}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/view/template.ts"],"names":[],"mappings":"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","sourcesContent":["// Template results and the `html` and `svg` tags (view/01-templates.md \"Authoring\", \"Template\n// results\", \"svg templates\"). A result is a template source (the call site's strings, or a\n// template object) plus this call's values, recognised by a module-private symbol so data from\n// JSON can never pass for one. `templateOf` turns the source into the template object: compiled\n// and svg results carry it, html results are normalized once per strings array through\n// `#prepare` (prepare.ts). Development records each call site's source location (loc.ts) for\n// error messages.\nimport { prepare } from '#prepare';\nimport { DEV } from '#view-dev';\nimport { callSite, locOf, setLoc } from './loc.js';\nimport type { TemplateObject } from './normalize/types.js';\nimport { svgTemplate } from './template-element.js';\n\nconst SOURCE: unique symbol = Symbol('gyral.template');\n\n/** What `html` returns: a template plus this render's values. */\nexport interface TemplateResult {\n  readonly [SOURCE]: readonly string[] | TemplateObject;\n  readonly values: readonly unknown[];\n}\n\n/** The template tag, as `html` is in production. */\nfunction tag(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult {\n  // Development: the call site, from the stack, the first time (unless `html.at` gave it).\n  if (DEV && locOf(strings) === undefined) setLoc(strings, callSite(new Error().stack));\n  return { [SOURCE]: strings, values };\n}\n\n/** The svg tag, as `svg` is in production: svg results carry their (prepared) template. */\nfunction svgTag(strings: TemplateStringsArray, ...values: unknown[]): TemplateResult {\n  // Development: the call site, from the stack, the first time (unless `svg.at` gave it), so\n  // the normalizer's rule errors name it.\n  if (DEV && locOf(strings) === undefined) setLoc(strings, callSite(new Error().stack));\n  return compiledSvg(prepare(strings, true), values);\n}\n\ntype Tag = typeof tag;\n\n/**\n * Development: `html.at(loc)` (and `svg.at(loc)`) is the tag with a known call site. The Vite\n * preset's dev transform (compiler/locate.ts) writes it at every call site, since stack\n * positions in transformed modules aren't the author's lines. Attached here, not by a statement\n * that mentions the tag, so production builds don't keep it alive (the compiler checks that).\n */\nfunction withAt(html: Tag): Tag {\n  const tags = new Map<string, Tag>();\n  const at = (loc: string): Tag => {\n    let located = tags.get(loc);\n    if (located === undefined) {\n      located = (strings, ...values) => {\n        setLoc(strings, loc);\n        return html(strings, ...values);\n      };\n      tags.set(loc, located);\n    }\n    return located;\n  };\n  return Object.assign(html, { at });\n}\n\n/** The template tag: `` html`<p>${s.text}</p>` ``. */\nexport const html: (strings: TemplateStringsArray, ...values: unknown[]) => TemplateResult = DEV\n  ? withAt(tag)\n  : tag;\n\n/**\n * The SVG fragment tag: `` svg`<path d=${s.d} />` ``. Its top level is SVG content, so it\n * renders only inside an `<svg>` (or another SVG element) of an html template\n * (view/01-templates.md \"svg templates\"). A whole `<svg>` graphic is written with html.\n */\nexport const svg: (strings: TemplateStringsArray, ...values: unknown[]) => TemplateResult = DEV\n  ? withAt(svgTag)\n  : svgTag;\n\n/** Internal: what the template compiler (`@gyral/core/vite`) rewrites `html` calls into. */\nexport function compiled(template: TemplateObject, values: readonly unknown[]): TemplateResult {\n  return { [SOURCE]: template, values };\n}\n\n/** Internal: what the template compiler rewrites `svg` calls into. */\nexport function compiledSvg(template: TemplateObject, values: readonly unknown[]): TemplateResult {\n  svgTemplate(template);\n  return { [SOURCE]: template, values };\n}\n\nexport function isTemplateResult(value: unknown): value is TemplateResult {\n  return typeof value === 'object' && value !== null && SOURCE in value;\n}\n\n/** Internal: a result's source, compared by identity to skip `templateOf` on updates. */\nexport const sourceOf = (result: TemplateResult): readonly string[] | TemplateObject =>\n  result[SOURCE];\n\n/**\n * The template object of a result: compiled results carry it; a runtime result's call site is\n * normalized once by `#prepare` (cached there, so compiled builds carry neither the preparer\n * nor its cache).\n */\nexport function templateOf(result: TemplateResult): TemplateObject {\n  const source = result[SOURCE];\n  return Array.isArray(source) ? prepare(source) : (source as TemplateObject);\n}\n"]}

package/dist/view/trusted-html.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `html` as an HTML sink accepts it: a `TrustedHTML` from the `gyral` policy where the browser
+ * has Trusted Types, the string itself elsewhere. Typed as `string` because lib.dom's
+ * `innerHTML` setter takes only strings; the browser stringifies a `TrustedHTML` to the same text.
+ */
+export declare function trustedHTML(html: string): string;