@gyral/core 0.1.0 → 0.3.0

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

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

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

@@ -0,0 +1,16 @@
+import { type TemplateResult } from '../template.js';
+import { Markup } from './tags.js';
+export type { Deferred, Item } from './tags.js';
+/** 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;
+    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;
+}

package/dist/view/server/writer.js

@@ -0,0 +1,155 @@
+// The server renderer's walk (view/06-server.md "Writing a template result"): writes a child
+// value by walking template objects' `segments` (01), never tokenizing or building a DOM. Each
+// string segment is written verbatim; each hole op takes its value(s). Start tags and custom
+// elements are tags.ts.
+import { isList, nothing, rawHtml } from '../render/values.js';
+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';
+/** 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);
+/** Warning key for values outside any template (the render root, a component's view). */
+export const ROOT = {};
+export class Writer extends Markup {
+    constructor() {
+        super(...arguments);
+        /** 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) {
+        switch (typeof v) {
+            case 'string':
+                if (v === '')
+                    return;
+                if (table !== undefined && this.dev && !onlyWhitespace(v))
+                    fosterError(v, table);
+                this.buf += escapeText(v);
+                return;
+            case 'number':
+                if (table !== undefined && this.dev)
+                    fosterError(String(v), table);
+                this.buf += String(v);
+                return;
+            case 'object':
+                if (v !== null)
+                    this.object(v, table, at);
+                return;
+            case 'boolean':
+                if (v && this.dev)
+                    warnTrue(at);
+                return;
+            case 'undefined':
+                return;
+            default:
+                if (v !== nothing && this.dev)
+                    badChild(v);
+        }
+    }
+    object(v, table, at) {
+        if (isTemplateResult(v)) {
+            this.template(v, table);
+            return;
+        }
+        if (isList(v)) {
+            this.list(v, table, at);
+            return;
+        }
+        if (Array.isArray(v)) {
+            for (const item of v)
+                this.child(item, table, at);
+            return;
+        }
+        const raw = rawHtml(v);
+        if (raw !== undefined) {
+            // The start anchor hydration finds (02 "raw(html)"); a page shell is never hydrated.
+            this.buf += this.shell ? raw : `<!---->${raw}`;
+            return;
+        }
+        checkPromise(v, 'a child hole');
+        if (this.dev)
+            badChild(v);
+    }
+    /** `each(…)`: rows one after another, no markers (03). Keys are checked in development. */
+    list(v, table, at) {
+        const { items, key, row, pick } = v;
+        const seen = this.dev ? new Set() : undefined;
+        for (let i = 0; i < items.length; i++) {
+            const item = items[i];
+            if (seen !== undefined) {
+                const k = key(item);
+                const dup = seen.has(k);
+                if (dup || (typeof k !== 'string' && typeof k !== 'number'))
+                    badKey(k, i, dup);
+                seen.add(k);
+            }
+            this.child(row(item, pick === undefined ? undefined : pick(item)), table, at);
+        }
+    }
+    /** One template instance: its segments with this render's values. */
+    template(result, table) {
+        const template = templateOf(result);
+        const segments = template.segments;
+        if (segments === undefined) {
+            throw new Error(`gyral: template ${JSON.stringify(template.html.slice(0, 40))} has no server ` +
+                'segments: it was compiled for the client. Render on the server with an SSR build ' +
+                '(or the runtime normalizer), which keeps them ' +
+                '(docs/design-docs/view/01-templates.md "Compiled").');
+        }
+        // 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;
+        this.shell = template.server === true;
+        let at = 0;
+        let opening;
+        let frames;
+        for (const s of segments) {
+            if (typeof s === 'string') {
+                this.buf += s;
+                continue;
+            }
+            switch (s.k) {
+                case 'child':
+                    this.child(values[at++], s.in === undefined ? table : tableTag(s.in), s);
+                    break;
+                case 'text':
+                    this.buf += escapeText(textContent(values[at++], s, this.dev));
+                    break;
+                case 'attr':
+                    at = this.attr(s, values, at, opening);
+                    break;
+                case 'bool':
+                    // `?indeterminate` has no attribute: it is the property only (02 "Live form state").
+                    if (truthy(values[at]) && s.name !== 'indeterminate')
+                        this.bare(s.name, opening);
+                    at++;
+                    break;
+                case 'prop':
+                    if (opening !== undefined)
+                        opening.properties[s.name] = values[at];
+                    at++;
+                    break;
+                case 'hook':
+                    this.hook(values[at++], opening);
+                    break;
+                case 'open':
+                    opening = this.open(s.tag, s.html, s.attrs);
+                    break;
+                case 'openEnd':
+                    (frames ??= []).push(this.openEnd(opening));
+                    opening = undefined;
+                    break;
+                case 'close':
+                    this.close(frames?.pop() ?? PLAIN, s.tag);
+            }
+        }
+        this.shell = outer;
+    }
+}
+//# sourceMappingURL=writer.js.map

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

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

package/dist/view/styles.d.ts

@@ -0,0 +1,25 @@
+declare const STYLE: unique symbol;
+/** What `css` returns: CSS text, mapped to one shared `CSSStyleSheet` in the browser. */
+export interface StyleSource {
+    readonly [STYLE]: true;
+    readonly text: string;
+}
+/**
+ * What `spec.styles` accepts: `css` values, plain CSS strings (e.g.
+ * `import base from './base.css?inline'`) and arrays of them, nested freely. CSS is trusted
+ * author code: never interpolate user input.
+ */
+export type Styles = StyleSource | string | readonly Styles[];
+/** A `css` interpolation: inserted as written (another `css` value inserts its text). */
+export type CssValue = string | number | StyleSource;
+export declare const isStyleSource: (value: unknown) => value is StyleSource;
+/**
+ * Component CSS: `` css`p { margin-block: ${GAP}px; }` ``. Strings and numbers are inserted as
+ * written, so values from your own constants need no wrapper.
+ */
+export declare function css(strings: TemplateStringsArray, ...values: readonly CssValue[]): StyleSource;
+/** The CSS texts of `styles`, flattened in order (the server writes them, 06). */
+export declare function styleTexts(styles: Styles | undefined): string[];
+/** One shared sheet per style source (or per distinct string), created on first use. */
+export declare function sheetsFor(styles: Styles | undefined): CSSStyleSheet[];
+export {};

package/dist/view/styles.js

@@ -0,0 +1,58 @@
+// Component styles (view/08-styles.md "Authoring", "Browser"): the `css` tag and the shared
+// sheets. A style source is CSS text plus a cache slot for its one `CSSStyleSheet`, created on
+// first use with `replaceSync`; components that share a source share the sheet. Plain strings
+// are style sources too (cached by text). The server reads the text (06), never the sheet.
+const STYLE = Symbol('gyral.css');
+export const isStyleSource = (value) => typeof value === 'object' && value !== null && STYLE in value;
+/**
+ * Component CSS: `` css`p { margin-block: ${GAP}px; }` ``. Strings and numbers are inserted as
+ * written, so values from your own constants need no wrapper.
+ */
+export function css(strings, ...values) {
+    let text = strings[0] ?? '';
+    for (let i = 0; i < values.length; i++) {
+        const v = values[i];
+        text += (isStyleSource(v) ? v.text : String(v)) + (strings[i + 1] ?? '');
+    }
+    return { [STYLE]: true, text };
+}
+/** The CSS texts of `styles`, flattened in order (the server writes them, 06). */
+export function styleTexts(styles) {
+    if (styles === undefined)
+        return [];
+    if (typeof styles === 'string')
+        return [styles];
+    if (isStyleSource(styles))
+        return [styles.text];
+    return styles.flatMap(styleTexts);
+}
+const bySource = new WeakMap();
+const byText = new Map();
+function sheetOf(text) {
+    const sheet = new CSSStyleSheet();
+    sheet.replaceSync(text);
+    return sheet;
+}
+/** One shared sheet per style source (or per distinct string), created on first use. */
+export function sheetsFor(styles) {
+    if (styles === undefined)
+        return [];
+    if (typeof styles === 'string') {
+        let sheet = byText.get(styles);
+        if (sheet === undefined) {
+            sheet = sheetOf(styles);
+            byText.set(styles, sheet);
+        }
+        return [sheet];
+    }
+    if (isStyleSource(styles)) {
+        let sheet = bySource.get(styles);
+        if (sheet === undefined) {
+            sheet = sheetOf(styles.text);
+            bySource.set(styles, sheet);
+        }
+        return [sheet];
+    }
+    return styles.flatMap(sheetsFor);
+}
+//# sourceMappingURL=styles.js.map

package/dist/view/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/view/styles.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,+FAA+F;AAC/F,8FAA8F;AAC9F,2FAA2F;AAE3F,MAAM,KAAK,GAAkB,MAAM,CAAC,WAAW,CAAC,CAAC;AAkBjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC;AAEhE;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,OAA6B,EAAE,GAAG,MAA2B;IAC/E,IAAI,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,MAA0B;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA8B,CAAC;AAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEhD,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,MAA0B;IAClD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC","sourcesContent":["// Component styles (view/08-styles.md \"Authoring\", \"Browser\"): the `css` tag and the shared\n// sheets. A style source is CSS text plus a cache slot for its one `CSSStyleSheet`, created on\n// first use with `replaceSync`; components that share a source share the sheet. Plain strings\n// are style sources too (cached by text). The server reads the text (06), never the sheet.\n\nconst STYLE: unique symbol = Symbol('gyral.css');\n\n/** What `css` returns: CSS text, mapped to one shared `CSSStyleSheet` in the browser. */\nexport interface StyleSource {\n  readonly [STYLE]: true;\n  readonly text: string;\n}\n\n/**\n * What `spec.styles` accepts: `css` values, plain CSS strings (e.g.\n * `import base from './base.css?inline'`) and arrays of them, nested freely. CSS is trusted\n * author code: never interpolate user input.\n */\nexport type Styles = StyleSource | string | readonly Styles[];\n\n/** A `css` interpolation: inserted as written (another `css` value inserts its text). */\nexport type CssValue = string | number | StyleSource;\n\nexport const isStyleSource = (value: unknown): value is StyleSource =>\n  typeof value === 'object' && value !== null && STYLE in value;\n\n/**\n * Component CSS: `` css`p { margin-block: ${GAP}px; }` ``. Strings and numbers are inserted as\n * written, so values from your own constants need no wrapper.\n */\nexport function css(strings: TemplateStringsArray, ...values: readonly CssValue[]): StyleSource {\n  let text = strings[0] ?? '';\n  for (let i = 0; i < values.length; i++) {\n    const v = values[i];\n    text += (isStyleSource(v) ? v.text : String(v)) + (strings[i + 1] ?? '');\n  }\n  return { [STYLE]: true, text };\n}\n\n/** The CSS texts of `styles`, flattened in order (the server writes them, 06). */\nexport function styleTexts(styles: Styles | undefined): string[] {\n  if (styles === undefined) return [];\n  if (typeof styles === 'string') return [styles];\n  if (isStyleSource(styles)) return [styles.text];\n  return styles.flatMap(styleTexts);\n}\n\nconst bySource = new WeakMap<StyleSource, CSSStyleSheet>();\nconst byText = new Map<string, CSSStyleSheet>();\n\nfunction sheetOf(text: string): CSSStyleSheet {\n  const sheet = new CSSStyleSheet();\n  sheet.replaceSync(text);\n  return sheet;\n}\n\n/** One shared sheet per style source (or per distinct string), created on first use. */\nexport function sheetsFor(styles: Styles | undefined): CSSStyleSheet[] {\n  if (styles === undefined) return [];\n  if (typeof styles === 'string') {\n    let sheet = byText.get(styles);\n    if (sheet === undefined) {\n      sheet = sheetOf(styles);\n      byText.set(styles, sheet);\n    }\n    return [sheet];\n  }\n  if (isStyleSource(styles)) {\n    let sheet = bySource.get(styles);\n    if (sheet === undefined) {\n      sheet = sheetOf(styles.text);\n      bySource.set(styles, sheet);\n    }\n    return [sheet];\n  }\n  return styles.flatMap(sheetsFor);\n}\n"]}

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

@@ -0,0 +1,3 @@
+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;

package/dist/view/template-element.js

@@ -0,0 +1,25 @@
+// 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).
+import { verify } from '#prepare';
+import { DEV } from '#view-dev';
+import { SERVER_ONLY, TemplateError } from './normalize/errors.js';
+const elements = new WeakMap();
+/** The cached <template> element for `template`, parsed (and checked) on first use. */
+export function templateElement(template) {
+    const cached = elements.get(template);
+    if (cached !== undefined)
+        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.');
+    }
+    const el = document.createElement('template');
+    el.innerHTML = template.html;
+    verify(template, el);
+    elements.set(template, el);
+    return el;
+}
+//# sourceMappingURL=template-element.js.map

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

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

package/dist/view/template.d.ts

@@ -0,0 +1,21 @@
+import type { TemplateObject } from './normalize/types.js';
+declare const SOURCE: unique symbol;
+/** What `html` returns: a template plus this render's values. */
+export interface TemplateResult {
+    readonly [SOURCE]: readonly string[] | TemplateObject;
+    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 function compiled(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;
+/**
+ * The template object of a result: compiled results carry it; a runtime result's call site is
+ * normalized once by `#prepare` (cached there, so compiled builds carry neither the preparer
+ * nor its cache).
+ */
+export declare function templateOf(result: TemplateResult): TemplateObject;
+export {};

package/dist/view/template.js

@@ -0,0 +1,30 @@
+// 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).
+import { prepare } from '#prepare';
+const SOURCE = Symbol('gyral.template');
+/** The template tag: `` html`<p>${s.text}</p>` ``. */
+export function html(strings, ...values) {
+    return { [SOURCE]: strings, values };
+}
+/** Internal: what the template compiler (Phase 6) rewrites `html` calls into. */
+export function compiled(template, values) {
+    return { [SOURCE]: template, values };
+}
+export function isTemplateResult(value) {
+    return typeof value === 'object' && value !== null && SOURCE in value;
+}
+/** Internal: a result's source, compared by identity to skip `templateOf` on updates. */
+export const sourceOf = (result) => result[SOURCE];
+/**
+ * The template object of a result: compiled results carry it; a runtime result's call site is
+ * normalized once by `#prepare` (cached there, so compiled builds carry neither the preparer
+ * nor its cache).
+ */
+export function templateOf(result) {
+    const source = result[SOURCE];
+    return Array.isArray(source) ? prepare(source) : source;
+}
+//# sourceMappingURL=template.js.map

package/dist/view/template.js.map

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

package/dist/vite.d.ts

@@ -1,15 +1,52 @@
-/** Every Lit package: resolve exactly one copy, even when Gyral is linked from elsewhere. */
-export declare const LIT_PACKAGES: readonly string[];
+import type { Plugin } from 'vite';
+export interface TemplateCompilerOptions {
+    /**
+     * Module specifiers whose `html` export is the view layer's tag (default
+     * `DEFAULT_TEMPLATE_SOURCES`). An import matches when its specifier is listed, or when it
+     * resolves to the same module as a listed one; core's own view modules always match. A
+     * source other than '@gyral/core' must also export `compiled`.
+     */
+    readonly sources?: readonly string[];
+    /**
+     * Rule 7's extra check with parse5 (an optional peer dependency): `true` (default) uses
+     * 'parse5' when it is installed, a string names the module to load, `false` skips it.
+     */
+    readonly parse5?: boolean | string;
+}
+/** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */
+export declare const DEFAULT_TEMPLATE_SOURCES: readonly string[];
+/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */
+export declare const COMPILED_CONDITION = "gyral-compiled";
+/** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */
+export declare const CLIENT_CONDITIONS: readonly string[];
+export declare const SERVER_CONDITIONS: readonly string[];
+/** The template compiler alone (`gyralVitePreset()` includes it). */
+export declare function gyralTemplateCompiler(options?: TemplateCompilerOptions): Plugin;
+/** Gyral's packages: the dev server runs them through Vite, never Node (view/06). */
+export declare const GYRAL_PACKAGES: RegExp;
+/**
+ * The app's direct dependencies that depend on a Gyral package (a design system, say). They
+ * import @gyral/core, so they must share the copy the dev server runs.
+ */
+export declare function gyralDependents(root: string): string[];
 /**
- * Lit modules that Gyral imports or re-exports. Pre-bundling them up front stops Vite from
- * discovering them mid-run, which reloads the page and fails the first browser test run.
+ * Development output from the dev server's SSR (`ssrLoadModule`, view/06 "Development
+ * markers"). Vite externalizes installed packages there and Node imports them itself, resolving
+ * core's `#view-dev` without the `development` condition (Vite's `externalConditions` only pick
+ * the entry file, not the package's own imports), so the server rendered production output.
+ * In serve mode this plugin keeps Gyral's packages, and the app's dependencies that use them,
+ * out of externalization in server environments: Vite resolves them with its conditions
+ * (`development` in dev), and they all share one copy of core. `vite build` is unaffected.
  */
-export declare const LIT_PREBUNDLE: readonly string[];
+export declare function gyralDevServer(): Plugin;
 export interface GyralViteOptions {
-    /** More modules to pre-bundle (e.g. 'lit/directives/unsafe-html.js'). */
+    /** Modules to pre-bundle in dev, so Vite doesn't discover them mid-run and reload. */
     readonly optimize?: readonly string[];
+    /** Template compiler options (`vite build` only). */
+    readonly compiler?: TemplateCompilerOptions;
 }
 export interface GyralViteConfig {
+    readonly plugins: Plugin[];
     readonly resolve: {
         readonly dedupe: string[];
     };
@@ -21,5 +58,7 @@ export interface GyralViteConfig {
  * Spread into a Vite config, or into each Vitest project:
  *
  *   export default defineConfig({ ...gyralVitePreset(), build: { … } });
+ *
+ * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.
  */
 export declare function gyralVitePreset(options?: GyralViteOptions): GyralViteConfig;