@gyral/core 0.3.0 → 0.3.2

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. 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;

package/dist/view/trusted-html.js

@@ -0,0 +1,34 @@
+// Trusted Types (view/01-templates.md "Instantiation", gyral-ei9): a document whose CSP says
+// `require-trusted-types-for 'script'` refuses plain strings at HTML sinks such as `innerHTML`.
+// The browser parses only two kinds of HTML for Gyral: a template's HTML, which is the author's
+// own template strings (holes are markers, never values), and `raw()` markup, trusted by
+// contract (view/02 "raw(html)"). Both go through one policy named `gyral`, created on first use
+// where the browser has Trusted Types; an app allows it with `trusted-types gyral`. On first use
+// rather than at import, so a policy that refuses the name fails where HTML is parsed, not when
+// a module loads. A CSP whose `trusted-types` list leaves `gyral` out (with or without
+// enforcement) makes `createPolicy` throw: Gyral then parses plain strings, as before Trusted
+// Types, and warns in development; where Trusted Types are enforced the sink reports it.
+import { DEV } from '#view-dev';
+import { message } from './message.js';
+const passThrough = { createHTML: (input) => input };
+let policy;
+/**
+ * `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 function trustedHTML(html) {
+    policy ??= create();
+    return policy.createHTML(html);
+}
+function create() {
+    try {
+        return (globalThis.trustedTypes?.createPolicy('gyral', passThrough) ?? passThrough);
+    }
+    catch (error) {
+        if (DEV)
+            console.warn(message(72), error);
+        return passThrough;
+    }
+}
+//# sourceMappingURL=trusted-html.js.map

package/dist/view/trusted-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-html.js","sourceRoot":"","sources":["../../src/view/trusted-html.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,gGAAgG;AAChG,gGAAgG;AAChG,yFAAyF;AACzF,iGAAiG;AACjG,iGAAiG;AACjG,gGAAgG;AAChG,uFAAuF;AACvF,8FAA8F;AAC9F,yFAAyF;AACzF,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAUvC,MAAM,WAAW,GAAW,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC;AAE7D,IAAI,MAA0B,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,MAAM,EAAE,CAAC;IACpB,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,MAAM;IACb,IAAI,CAAC;QACH,OAAO,CACJ,UAA+C,CAAC,YAAY,EAAE,YAAY,CACzE,OAAO,EACP,WAAW,CACZ,IAAI,WAAW,CACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,GAAG;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1C,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["// Trusted Types (view/01-templates.md \"Instantiation\", gyral-ei9): a document whose CSP says\n// `require-trusted-types-for 'script'` refuses plain strings at HTML sinks such as `innerHTML`.\n// The browser parses only two kinds of HTML for Gyral: a template's HTML, which is the author's\n// own template strings (holes are markers, never values), and `raw()` markup, trusted by\n// contract (view/02 \"raw(html)\"). Both go through one policy named `gyral`, created on first use\n// where the browser has Trusted Types; an app allows it with `trusted-types gyral`. On first use\n// rather than at import, so a policy that refuses the name fails where HTML is parsed, not when\n// a module loads. A CSP whose `trusted-types` list leaves `gyral` out (with or without\n// enforcement) makes `createPolicy` throw: Gyral then parses plain strings, as before Trusted\n// Types, and warns in development; where Trusted Types are enforced the sink reports it.\nimport { DEV } from '#view-dev';\nimport { message } from './message.js';\n\ninterface Policy {\n  createHTML(input: string): string;\n}\n\ninterface PolicyFactory {\n  createPolicy(name: string, rules: Policy): Policy;\n}\n\nconst passThrough: Policy = { createHTML: (input) => input };\n\nlet policy: Policy | undefined;\n\n/**\n * `html` as an HTML sink accepts it: a `TrustedHTML` from the `gyral` policy where the browser\n * has Trusted Types, the string itself elsewhere. Typed as `string` because lib.dom's\n * `innerHTML` setter takes only strings; the browser stringifies a `TrustedHTML` to the same text.\n */\nexport function trustedHTML(html: string): string {\n  policy ??= create();\n  return policy.createHTML(html);\n}\n\nfunction create(): Policy {\n  try {\n    return (\n      (globalThis as { trustedTypes?: PolicyFactory }).trustedTypes?.createPolicy(\n        'gyral',\n        passThrough,\n      ) ?? passThrough\n    );\n  } catch (error) {\n    if (DEV) console.warn(message(72), error);\n    return passThrough;\n  }\n}\n"]}

package/dist/vite.d.ts

@@ -1,10 +1,11 @@
 import type { Plugin } from 'vite';
 export interface TemplateCompilerOptions {
     /**
-     * Module specifiers whose `html` export is the view layer's tag (default
+     * Module specifiers whose `html` (and `svg`) exports are the view layer's tags (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`.
+     * source other than '@gyral/core' must also export `compiled` (and `compiledSvg` when it
+     * exports `svg`).
      */
     readonly sources?: readonly string[];
     /**
@@ -13,43 +14,49 @@ export interface TemplateCompilerOptions {
      */
     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[];
-/**
- * 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 function gyralDevServer(): Plugin;
+/** Where the preset looks for components and writes their typings. */
+export interface ElementTypesOptions {
+    /** Source directories to scan, relative to the Vite root. Default `['src']`. */
+    readonly dirs?: readonly string[];
+    /** The declaration file to write, relative to the Vite root. Default `.gyral/elements.d.ts`. */
+    readonly out?: string;
+}
 export interface GyralViteOptions {
+    /**
+     * Generated element typings (`.gyral/elements.d.ts`, see `ElementTypesOptions`), or `false`
+     * to write none. Default: on, scanning `src`.
+     */
+    readonly types?: ElementTypesOptions | false;
     /** 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;
+    /**
+     * The app is never server-rendered: leave the hydration code out of the browser bundle
+     * (`gyralClientOnly()`). Default false.
+     */
+    readonly clientOnly?: boolean;
+    /**
+     * Automatic component loading (ADR 0016 addendum): every component defined under `include`
+     * gets a client module the build splits out, and a loader (`virtual:gyral/components`, added
+     * to the client build's input) imports a tag's module once that tag is in the page.
+     * `renderPage({ components })` then links exactly the components a page rendered, so pages
+     * need no client entry of their own and no side-effect imports. Default off.
+     */
+    readonly components?: boolean | ComponentsOptions;
+}
+export interface ComponentsOptions {
+    /** Directories (relative to Vite's root) whose modules' `define()` tags are found. Default `['src']`. */
+    readonly include?: readonly string[];
+    /**
+     * Tag → module (relative to Vite's root) for components the scan can't find: those defined
+     * through a wrapper such as `defineMemberForm({ tag: 'member-form' })`, which calls
+     * `define()` itself. Listed entries win over scanned ones.
+     */
+    readonly modules?: Readonly<Record<string, string>>;
 }
 export interface GyralViteConfig {
     readonly plugins: Plugin[];
-    readonly resolve: {
-        readonly dedupe: string[];
-    };
     readonly optimizeDeps: {
         readonly include: string[];
     };

package/dist/vite.js

@@ -6,37 +6,42 @@
 // runner. The compiler is a plugin applied in `vite build` only, so dev servers and test runs
 // keep the runtime template path; its implementation (./compiler/) loads on the first build
 // hook, with `require` (Node loads ES modules with it too): a module runner that loaded this
-// file may be closed by then, and would reject a dynamic import().
+// file may be closed by then, and would reject a dynamic import(). Public: the preset,
+// gyralTemplateCompiler and gyralClientOnly (docs/references/public-api-0.3.1.md); the other
+// plugins and constants here are internal.
 import { readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 /** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */
-export const DEFAULT_TEMPLATE_SOURCES = ['@gyral/core'];
+const DEFAULT_TEMPLATE_SOURCES = ['@gyral/core'];
 /** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */
-export const COMPILED_CONDITION = 'gyral-compiled';
+const COMPILED_CONDITION = 'gyral-compiled';
+/** The client's resolve condition in client-only builds (view/07 "Client-only builds"). */
+const CLIENT_ONLY_CONDITION = 'gyral-client-only';
 /** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */
-export const CLIENT_CONDITIONS = ['module', 'browser', 'development|production'];
-export const SERVER_CONDITIONS = ['module', 'node', 'development|production'];
+const CLIENT_CONDITIONS = ['module', 'browser', 'development|production'];
+const SERVER_CONDITIONS = ['module', 'node', 'development|production'];
 /**
- * Adds the `gyral-compiled` condition to an environment, on top of the app's conditions or
- * Vite's defaults: Vite replaces the defaults when a config names any condition.
+ * Adds `condition` (default `gyral-compiled`) to an environment, on top of the app's
+ * conditions or Vite's defaults: Vite replaces the defaults when a config names any condition.
+ * `clientOnly`: only to environments that build for the browser.
  */
-function addCondition(name, config, env) {
+function addCondition(name, config, env, condition = COMPILED_CONDITION, clientOnly = false) {
     const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');
     const client = consumer === 'client' || env.isSsrTargetWebworker === true;
+    if (clientOnly && consumer !== 'client')
+        return;
     const current = config.resolve?.conditions ?? (client ? CLIENT_CONDITIONS : SERVER_CONDITIONS);
-    if (!current.includes(COMPILED_CONDITION)) {
-        config.resolve = { ...config.resolve, conditions: [...current, COMPILED_CONDITION] };
+    if (!current.includes(condition)) {
+        config.resolve = { ...config.resolve, conditions: [...current, condition] };
     }
 }
-/**
- * The compiler's hooks. From core's TypeScript source (this workspace, `link:` checkouts) they
- * load through Vite's module runner, as a vite.config.ts would; from the published package,
- * with require.
- */
-async function loadHooks(options) {
-    const settings = {
+/** The compiled entry of this copy of core, next to this module. */
+const OWN_COMPILED = fileURLToPath(new URL(import.meta.url.endsWith('.ts') ? './view/compiled.ts' : './view/compiled.js', import.meta.url));
+/** The settings both plugins pass to their lazily loaded implementation. */
+function settingsOf(options) {
+    return {
         sources: options.sources ?? DEFAULT_TEMPLATE_SOURCES,
         parse5: options.parse5 === false
             ? undefined
@@ -44,21 +49,32 @@ async function loadHooks(options) {
                 ? options.parse5
                 : 'parse5',
     };
+}
+/**
+ * A module of ./compiler/. From core's TypeScript source (this workspace, `link:` checkouts) it
+ * loads through Vite's module runner, as a vite.config.ts would; from the published package,
+ * with require.
+ */
+async function loadCompiler(name) {
     const require = createRequire(import.meta.url);
-    if (!import.meta.url.endsWith('.ts')) {
-        return require('./compiler/hooks.js').createCompiler(settings);
-    }
+    if (!import.meta.url.endsWith('.ts'))
+        return require(`./compiler/${name}.js`);
     const { runnerImport } = require('vite');
     const nodeEnv = process.env['NODE_ENV']; // the runner sets it when unset; the build owns it
-    const { module } = await runnerImport(fileURLToPath(new URL('./compiler/hooks.ts', import.meta.url)), { configFile: false, logLevel: 'silent' });
+    const { module } = await runnerImport(fileURLToPath(new URL(`./compiler/${name}.ts`, import.meta.url)), { configFile: false, logLevel: 'silent' });
     if (nodeEnv === undefined)
         delete process.env['NODE_ENV'];
     else
         process.env['NODE_ENV'] = nodeEnv;
-    return module.createCompiler(settings);
+    return module;
+}
+/** The compiler's hooks (`vite build`). */
+async function loadHooks(options) {
+    const hooks = await loadCompiler('hooks');
+    return hooks.createCompiler({ ...settingsOf(options), ownEntry: OWN_COMPILED });
 }
 /** The template compiler alone (`gyralVitePreset()` includes it). */
-export function gyralTemplateCompiler(options = {}) {
+function gyralTemplateCompiler(options = {}) {
     let hooks;
     const ready = () => {
         if (hooks === undefined)
@@ -77,8 +93,20 @@ export function gyralTemplateCompiler(options = {}) {
         buildStart(input) {
             return ready().buildStart.call(this, input);
         },
+        // The registration modules of spec-field features (./compiler/features.ts).
+        resolveId(source, importer, opts) {
+            return ready().resolveId.call(this, source, importer, opts);
+        },
+        load(id, opts) {
+            return ready().load.call(this, id, opts);
+        },
         transform: {
-            filter: { id: /\.[cm]?[jt]sx?$/, code: 'html' },
+            // Modules naming a template tag (html or svg; core's template module names both), or a
+            // spec field whose machinery the build adds only when named (view/05).
+            filter: {
+                id: /\.[cm]?[jt]sx?$/,
+                code: /html|svg|viewTransition|renderOnFrame|states|formAssociated|subscriptions|\.value\s*\(/,
+            },
             handler(code, id, opts) {
                 return ready().transform.call(this, code, id, opts);
             },
@@ -88,8 +116,51 @@ export function gyralTemplateCompiler(options = {}) {
         },
     };
 }
-/** Gyral's packages: the dev server runs them through Vite, never Node (view/06). */
-export const GYRAL_PACKAGES = /^@gyral\//;
+/**
+ * Development source locations (view/01-templates.md "Source locations"): in `vite serve` (the
+ * dev server, Vitest) each html`…` and svg`…` call site of the template sources tells the
+ * runtime where it was written, so template rule errors and hydration mismatches name
+ * `file:line:col` (./compiler/locate.ts, loaded on the first hook). `vite build` compiles
+ * templates instead.
+ */
+function gyralTemplateLocations(options = {}) {
+    let hooks;
+    const ready = () => {
+        if (hooks === undefined)
+            throw new Error('gyral: the template locator is not loaded yet');
+        return hooks;
+    };
+    return {
+        name: 'gyral:template-locations',
+        enforce: 'pre',
+        apply: 'serve',
+        resolveId(source) {
+            return source === 'virtual:gyral/template-locations' ? '\0gyral:template-locations' : null;
+        },
+        load(id) {
+            return id === '\0gyral:template-locations'
+                ? 'export const locate = (tag, loc) => tag.at?.(loc) ?? tag;'
+                : null;
+        },
+        async configResolved(config) {
+            const locate = await loadCompiler('locate');
+            hooks = locate.createLocator(settingsOf(options).sources);
+            await hooks.configResolved.call(this, config);
+        },
+        transform: {
+            // Modules naming a template tag (html or svg), as the compiler's filter.
+            filter: { id: /\.[cm]?[jt]sx?$/, code: /html|svg/ },
+            handler(code, id, opts) {
+                return ready().transform.call(this, code, id, opts);
+            },
+        },
+    };
+}
+/**
+ * Gyral's packages: the dev server runs them through Vite, never Node (view/06). The feature
+ * scan's scope (./compiler/scope.ts) uses the same pattern.
+ */
+const GYRAL_PACKAGES = /^@gyral\//;
 function manifest(file) {
     try {
         return JSON.parse(readFileSync(file, 'utf8'));
@@ -108,9 +179,9 @@ function installed(root, name) {
 }
 /**
  * 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.
+ * import `@gyral/core`, so they must share the copy the dev server runs.
  */
-export function gyralDependents(root) {
+function gyralDependents(root) {
     const app = manifest(join(root, 'package.json'));
     const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });
     return names.filter((name) => {
@@ -129,7 +200,7 @@ export function gyralDependents(root) {
  * 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 function gyralDevServer() {
+function gyralDevSsr() {
     let root = process.cwd();
     return {
         name: 'gyral:dev-server',
@@ -145,6 +216,71 @@ export function gyralDevServer() {
         },
     };
 }
+/**
+ * Client-only builds (view/07-hydration.md "Client-only builds", gyral-c5d.11), for apps no
+ * server renders: the browser environment resolves core with the `gyral-client-only`
+ * condition, so the bundle carries no hydration code (no seed reading, no hydration chunk and
+ * its import()), and in `vite build` the invoker-command fallback only when a module that can
+ * affect Gyral components (the app's own, or a package that reaches a Gyral package) may use
+ * command intents (./compiler/features.ts). With no other import(), Vite's preload helper goes
+ * too. Server-rendered markup met anyway renders fresh (development warns). Dev servers and
+ * test runs get the condition too, and always keep the invoker fallback.
+ */
+function gyralClientOnly() {
+    let hooks;
+    let root = process.cwd();
+    return {
+        name: 'gyral:client-only',
+        enforce: 'pre',
+        configEnvironment(name, config, env) {
+            addCondition(name, config, env, CLIENT_ONLY_CONDITION, true);
+        },
+        async configResolved(config) {
+            root = config.root;
+            if (config.command !== 'build')
+                return;
+            const features = await loadCompiler('features');
+            hooks = features.createFeatures(['invokers'], OWN_COMPILED);
+        },
+        async buildStart() {
+            await hooks?.buildStart((source, importer) => this.resolve(source, importer), root);
+        },
+        resolveId(source) {
+            return hooks?.resolveId(source) ?? null;
+        },
+        load(id) {
+            return hooks?.load(id) ?? null;
+        },
+        transform: {
+            // features.ts FEATURE_HINTS.invokers: any import or export may reach `raw`.
+            filter: { id: /\.[cm]?[jt]sx?$/, code: /data-intent-on|command|raw|import|export/i },
+            async handler(code, id) {
+                if (hooks === undefined || this.environment.config.consumer !== 'client')
+                    return null;
+                const imports = await hooks.inject(code, id, {
+                    parse: (text, lang) => this.parse(text, { lang }),
+                    resolve: (source, importer) => this.resolve(source, importer),
+                });
+                // Appended after the last line: no code moves, so the incoming source map holds.
+                return imports === '' ? null : { code: code + imports, map: null };
+            },
+        },
+    };
+}
+/**
+ * Writes `HTMLElementTagNameMap` entries for every exported `define()` component (a
+ * `.gyral/elements.d.ts` to gitignore and include in tsconfig) at the start of a build, dev
+ * server or test run, and again when a source file changes. ./compiler/tag-map imports Node
+ * built-ins only, so Node's require loads it, from TypeScript source too: no module runner,
+ * which may be closed by the time a build starts (see loadCompiler).
+ */
+function gyralElementTypes(options) {
+    const source = import.meta.url.endsWith('.ts')
+        ? './compiler/tag-map.ts'
+        : './compiler/tag-map.js';
+    const tagMap = createRequire(import.meta.url)(source);
+    return tagMap.elementTypesPlugin(options);
+}
 /**
  * Spread into a Vite config, or into each Vitest project:
  *
@@ -154,9 +290,48 @@ export function gyralDevServer() {
  */
 export function gyralVitePreset(options = {}) {
     return {
-        plugins: [gyralTemplateCompiler(options.compiler), gyralDevServer()],
-        resolve: { dedupe: [] },
+        plugins: [
+            // Before the compiler: its feature scan reads the author's templates, not compiled ones.
+            ...(options.clientOnly === true ? [gyralClientOnly()] : []),
+            gyralTemplateCompiler(options.compiler),
+            gyralTemplateLocations(options.compiler),
+            gyralDevSsr(),
+            ...(options.components === undefined || options.components === false
+                ? []
+                : [gyralComponents(options.components === true ? {} : options.components)]),
+            ...(options.types === false ? [] : [gyralElementTypes(options.types ?? {})]),
+        ],
         optimizeDeps: { include: [...new Set(options.optimize ?? [])] },
     };
 }
+/**
+ * Automatic component loading (`gyralVitePreset({ components })`): a shell whose hooks run
+ * ./compiler/components.ts, loaded on the first hook (`config`) like the compiler.
+ */
+function gyralComponents(options) {
+    let impl;
+    const run = (name) => function (...args) {
+        const hook = impl?.[name];
+        return hook?.call(this, ...args) ?? null;
+    };
+    const hook = (name) => run(name);
+    return {
+        name: 'gyral:components',
+        api: {
+            tags: () => impl?.api?.tags?.() ??
+                new Map(),
+        },
+        async config(...args) {
+            const components = await loadCompiler('components');
+            impl = components.createComponents(options);
+            return run('config').apply(this, args);
+        },
+        configResolved: hook('configResolved'),
+        buildStart: hook('buildStart'),
+        resolveId: hook('resolveId'),
+        load: hook('load'),
+        configureServer: hook('configureServer'),
+        generateBundle: hook('generateBundle'),
+    };
+}
 //# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md):\n// the template compiler (view/01-templates.md \"Compiled\") and, in serve mode, development\n// output from the dev server's SSR (view/06-server.md \"Development markers\"). Only Node\n// built-ins are imported up front, so it loads from vite.config.ts and vitest.config.ts in any\n// way: bundled with the config, by Node from source (type stripping), or by a Vite module\n// runner. The compiler is a plugin applied in `vite build` only, so dev servers and test runs\n// keep the runtime template path; its implementation (./compiler/) loads on the first build\n// hook, with `require` (Node loads ES modules with it too): a module runner that loaded this\n// file may be closed by then, and would reject a dynamic import().\nimport { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ConfigEnv, EnvironmentOptions, Plugin } from 'vite';\nimport type { CompilerHooks } from './compiler/hooks.js';\n\nexport interface TemplateCompilerOptions {\n  /**\n   * Module specifiers whose `html` export is the view layer's tag (default\n   * `DEFAULT_TEMPLATE_SOURCES`). An import matches when its specifier is listed, or when it\n   * resolves to the same module as a listed one; core's own view modules always match. A\n   * source other than '@gyral/core' must also export `compiled`.\n   */\n  readonly sources?: readonly string[];\n  /**\n   * Rule 7's extra check with parse5 (an optional peer dependency): `true` (default) uses\n   * 'parse5' when it is installed, a string names the module to load, `false` skips it.\n   */\n  readonly parse5?: boolean | string;\n}\n\n/** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */\nexport const DEFAULT_TEMPLATE_SOURCES: readonly string[] = ['@gyral/core'];\n\n/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */\nexport const COMPILED_CONDITION = 'gyral-compiled';\n/** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */\nexport const CLIENT_CONDITIONS: readonly string[] = ['module', 'browser', 'development|production'];\nexport const SERVER_CONDITIONS: readonly string[] = ['module', 'node', 'development|production'];\n\n/**\n * Adds the `gyral-compiled` condition to an environment, on top of the app's conditions or\n * Vite's defaults: Vite replaces the defaults when a config names any condition.\n */\nfunction addCondition(\n  name: string,\n  config: EnvironmentOptions,\n  env: ConfigEnv & { isSsrTargetWebworker?: boolean },\n): void {\n  const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n  const client = consumer === 'client' || env.isSsrTargetWebworker === true;\n  const current = config.resolve?.conditions ?? (client ? CLIENT_CONDITIONS : SERVER_CONDITIONS);\n  if (!current.includes(COMPILED_CONDITION)) {\n    config.resolve = { ...config.resolve, conditions: [...current, COMPILED_CONDITION] };\n  }\n}\n\n/**\n * The compiler's hooks. From core's TypeScript source (this workspace, `link:` checkouts) they\n * load through Vite's module runner, as a vite.config.ts would; from the published package,\n * with require.\n */\nasync function loadHooks(options: TemplateCompilerOptions): Promise<CompilerHooks> {\n  const settings = {\n    sources: options.sources ?? DEFAULT_TEMPLATE_SOURCES,\n    parse5:\n      options.parse5 === false\n        ? undefined\n        : typeof options.parse5 === 'string'\n          ? options.parse5\n          : 'parse5',\n  };\n  const require = createRequire(import.meta.url);\n  if (!import.meta.url.endsWith('.ts')) {\n    return (require('./compiler/hooks.js') as typeof import('./compiler/hooks.js')).createCompiler(\n      settings,\n    );\n  }\n  const { runnerImport } = require('vite') as typeof import('vite');\n  const nodeEnv = process.env['NODE_ENV']; // the runner sets it when unset; the build owns it\n  const { module } = await runnerImport<typeof import('./compiler/hooks.js')>(\n    fileURLToPath(new URL('./compiler/hooks.ts', import.meta.url)),\n    { configFile: false, logLevel: 'silent' },\n  );\n  if (nodeEnv === undefined) delete process.env['NODE_ENV'];\n  else process.env['NODE_ENV'] = nodeEnv;\n  return module.createCompiler(settings);\n}\n\n/** The template compiler alone (`gyralVitePreset()` includes it). */\nexport function gyralTemplateCompiler(options: TemplateCompilerOptions = {}): Plugin {\n  let hooks: CompilerHooks | undefined;\n  const ready = (): CompilerHooks => {\n    if (hooks === undefined) throw new Error('gyral: the template compiler is not loaded yet');\n    return hooks;\n  };\n  return {\n    name: 'gyral:template-compiler',\n    enforce: 'pre',\n    apply: 'build',\n    configEnvironment: addCondition,\n    async configResolved(config) {\n      hooks = await loadHooks(options);\n      await hooks.configResolved.call(this, config);\n    },\n    buildStart(input) {\n      return ready().buildStart.call(this, input);\n    },\n    transform: {\n      filter: { id: /\\.[cm]?[jt]sx?$/, code: 'html' },\n      handler(code, id, opts) {\n        return ready().transform.call(this, code, id, opts);\n      },\n    },\n    generateBundle(output, bundle, isWrite) {\n      return ready().generateBundle.call(this, output, bundle, isWrite);\n    },\n  };\n}\n\n/** Gyral's packages: the dev server runs them through Vite, never Node (view/06). */\nexport const GYRAL_PACKAGES = /^@gyral\\//;\n\ntype Manifest = Partial<Record<'dependencies' | 'devDependencies' | 'peerDependencies', object>>;\n\nfunction manifest(file: string): Manifest | undefined {\n  try {\n    return JSON.parse(readFileSync(file, 'utf8')) as Manifest;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The installed manifest of `name`, looked up from `root` the way Node does (no exports map). */\nfunction installed(root: string, name: string): Manifest | undefined {\n  for (let dir = root; ; dir = dirname(dir)) {\n    const found = manifest(join(dir, 'node_modules', name, 'package.json'));\n    if (found !== undefined || dirname(dir) === dir) return found;\n  }\n}\n\n/**\n * The app's direct dependencies that depend on a Gyral package (a design system, say). They\n * import @gyral/core, so they must share the copy the dev server runs.\n */\nexport function gyralDependents(root: string): string[] {\n  const app = manifest(join(root, 'package.json'));\n  const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });\n  return names.filter((name) => {\n    if (GYRAL_PACKAGES.test(name)) return false;\n    const dep = installed(root, name);\n    return Object.keys({ ...dep?.dependencies, ...dep?.peerDependencies }).some((d) =>\n      GYRAL_PACKAGES.test(d),\n    );\n  });\n}\n\n/**\n * Development output from the dev server's SSR (`ssrLoadModule`, view/06 \"Development\n * markers\"). Vite externalizes installed packages there and Node imports them itself, resolving\n * core's `#view-dev` without the `development` condition (Vite's `externalConditions` only pick\n * the entry file, not the package's own imports), so the server rendered production output.\n * In serve mode this plugin keeps Gyral's packages, and the app's dependencies that use them,\n * out of externalization in server environments: Vite resolves them with its conditions\n * (`development` in dev), and they all share one copy of core. `vite build` is unaffected.\n */\nexport function gyralDevServer(): Plugin {\n  let root = process.cwd();\n  return {\n    name: 'gyral:dev-server',\n    apply: 'serve',\n    config(config) {\n      root = resolve(config.root ?? process.cwd());\n    },\n    configEnvironment(name, config) {\n      const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n      if (consumer === 'client') return undefined;\n      return { resolve: { noExternal: [GYRAL_PACKAGES, ...gyralDependents(root)] } };\n    },\n  };\n}\n\nexport interface GyralViteOptions {\n  /** Modules to pre-bundle in dev, so Vite doesn't discover them mid-run and reload. */\n  readonly optimize?: readonly string[];\n  /** Template compiler options (`vite build` only). */\n  readonly compiler?: TemplateCompilerOptions;\n}\n\nexport interface GyralViteConfig {\n  readonly plugins: Plugin[];\n  readonly resolve: { readonly dedupe: string[] };\n  readonly optimizeDeps: { readonly include: string[] };\n}\n\n/**\n * Spread into a Vite config, or into each Vitest project:\n *\n *   export default defineConfig({ ...gyralVitePreset(), build: { … } });\n *\n * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.\n */\nexport function gyralVitePreset(options: GyralViteOptions = {}): GyralViteConfig {\n  return {\n    plugins: [gyralTemplateCompiler(options.compiler), gyralDevServer()],\n    resolve: { dedupe: [] },\n    optimizeDeps: { include: [...new Set(options.optimize ?? [])] },\n  };\n}\n"]}
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"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","sourcesContent":["// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md):\n// the template compiler (view/01-templates.md \"Compiled\") and, in serve mode, development\n// output from the dev server's SSR (view/06-server.md \"Development markers\"). Only Node\n// built-ins are imported up front, so it loads from vite.config.ts and vitest.config.ts in any\n// way: bundled with the config, by Node from source (type stripping), or by a Vite module\n// runner. The compiler is a plugin applied in `vite build` only, so dev servers and test runs\n// keep the runtime template path; its implementation (./compiler/) loads on the first build\n// hook, with `require` (Node loads ES modules with it too): a module runner that loaded this\n// file may be closed by then, and would reject a dynamic import(). Public: the preset,\n// gyralTemplateCompiler and gyralClientOnly (docs/references/public-api-0.3.1.md); the other\n// plugins and constants here are internal.\nimport { readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { ConfigEnv, EnvironmentOptions, Plugin } from 'vite';\nimport type { FeatureHooks } from './compiler/features.js';\nimport type { CompilerHooks } from './compiler/hooks.js';\nimport type { LocatorHooks } from './compiler/locate.js';\n\nexport interface TemplateCompilerOptions {\n  /**\n   * Module specifiers whose `html` (and `svg`) exports are the view layer's tags (default\n   * `DEFAULT_TEMPLATE_SOURCES`). An import matches when its specifier is listed, or when it\n   * resolves to the same module as a listed one; core's own view modules always match. A\n   * source other than '@gyral/core' must also export `compiled` (and `compiledSvg` when it\n   * exports `svg`).\n   */\n  readonly sources?: readonly string[];\n  /**\n   * Rule 7's extra check with parse5 (an optional peer dependency): `true` (default) uses\n   * 'parse5' when it is installed, a string names the module to load, `false` skips it.\n   */\n  readonly parse5?: boolean | string;\n}\n\n/** Where the view layer's `html` comes from: core's main entry (ADR 0018, Phase 3). */\nconst DEFAULT_TEMPLATE_SOURCES: readonly string[] = ['@gyral/core'];\n\n/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */\nconst COMPILED_CONDITION = 'gyral-compiled';\n/** The client's resolve condition in client-only builds (view/07 \"Client-only builds\"). */\nconst CLIENT_ONLY_CONDITION = 'gyral-client-only';\n/** Vite 8's default resolve conditions (`defaultClientConditions`, server ones without browser). */\nconst CLIENT_CONDITIONS: readonly string[] = ['module', 'browser', 'development|production'];\nconst SERVER_CONDITIONS: readonly string[] = ['module', 'node', 'development|production'];\n\n/**\n * Adds `condition` (default `gyral-compiled`) to an environment, on top of the app's\n * conditions or Vite's defaults: Vite replaces the defaults when a config names any condition.\n * `clientOnly`: only to environments that build for the browser.\n */\nfunction addCondition(\n  name: string,\n  config: EnvironmentOptions,\n  env: ConfigEnv & { isSsrTargetWebworker?: boolean },\n  condition = COMPILED_CONDITION,\n  clientOnly = false,\n): void {\n  const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n  const client = consumer === 'client' || env.isSsrTargetWebworker === true;\n  if (clientOnly && consumer !== 'client') return;\n  const current = config.resolve?.conditions ?? (client ? CLIENT_CONDITIONS : SERVER_CONDITIONS);\n  if (!current.includes(condition)) {\n    config.resolve = { ...config.resolve, conditions: [...current, condition] };\n  }\n}\n\n/** The compiled entry of this copy of core, next to this module. */\nconst OWN_COMPILED = fileURLToPath(\n  new URL(\n    import.meta.url.endsWith('.ts') ? './view/compiled.ts' : './view/compiled.js',\n    import.meta.url,\n  ),\n);\n\n/** The settings both plugins pass to their lazily loaded implementation. */\nfunction settingsOf(options: TemplateCompilerOptions) {\n  return {\n    sources: options.sources ?? DEFAULT_TEMPLATE_SOURCES,\n    parse5:\n      options.parse5 === false\n        ? undefined\n        : typeof options.parse5 === 'string'\n          ? options.parse5\n          : 'parse5',\n  };\n}\n\n/**\n * A module of ./compiler/. From core's TypeScript source (this workspace, `link:` checkouts) it\n * loads through Vite's module runner, as a vite.config.ts would; from the published package,\n * with require.\n */\nasync function loadCompiler<M>(name: string): Promise<M> {\n  const require = createRequire(import.meta.url);\n  if (!import.meta.url.endsWith('.ts')) return require(`./compiler/${name}.js`) as M;\n  const { runnerImport } = require('vite') as typeof import('vite');\n  const nodeEnv = process.env['NODE_ENV']; // the runner sets it when unset; the build owns it\n  const { module } = await runnerImport<M>(\n    fileURLToPath(new URL(`./compiler/${name}.ts`, import.meta.url)),\n    { configFile: false, logLevel: 'silent' },\n  );\n  if (nodeEnv === undefined) delete process.env['NODE_ENV'];\n  else process.env['NODE_ENV'] = nodeEnv;\n  return module;\n}\n\n/** The compiler's hooks (`vite build`). */\nasync function loadHooks(options: TemplateCompilerOptions): Promise<CompilerHooks> {\n  const hooks = await loadCompiler<typeof import('./compiler/hooks.js')>('hooks');\n  return hooks.createCompiler({ ...settingsOf(options), ownEntry: OWN_COMPILED });\n}\n\n/** The template compiler alone (`gyralVitePreset()` includes it). */\nfunction gyralTemplateCompiler(options: TemplateCompilerOptions = {}): Plugin {\n  let hooks: CompilerHooks | undefined;\n  const ready = (): CompilerHooks => {\n    if (hooks === undefined) throw new Error('gyral: the template compiler is not loaded yet');\n    return hooks;\n  };\n  return {\n    name: 'gyral:template-compiler',\n    enforce: 'pre',\n    apply: 'build',\n    configEnvironment: addCondition,\n    async configResolved(config) {\n      hooks = await loadHooks(options);\n      await hooks.configResolved.call(this, config);\n    },\n    buildStart(input) {\n      return ready().buildStart.call(this, input);\n    },\n    // The registration modules of spec-field features (./compiler/features.ts).\n    resolveId(source, importer, opts) {\n      return ready().resolveId.call(this, source, importer, opts);\n    },\n    load(id, opts) {\n      return ready().load.call(this, id, opts);\n    },\n    transform: {\n      // Modules naming a template tag (html or svg; core's template module names both), or a\n      // spec field whose machinery the build adds only when named (view/05).\n      filter: {\n        id: /\\.[cm]?[jt]sx?$/,\n        code: /html|svg|viewTransition|renderOnFrame|states|formAssociated|subscriptions|\\.value\\s*\\(/,\n      },\n      handler(code, id, opts) {\n        return ready().transform.call(this, code, id, opts);\n      },\n    },\n    generateBundle(output, bundle, isWrite) {\n      return ready().generateBundle.call(this, output, bundle, isWrite);\n    },\n  };\n}\n\n/**\n * Development source locations (view/01-templates.md \"Source locations\"): in `vite serve` (the\n * dev server, Vitest) each html`…` and svg`…` call site of the template sources tells the\n * runtime where it was written, so template rule errors and hydration mismatches name\n * `file:line:col` (./compiler/locate.ts, loaded on the first hook). `vite build` compiles\n * templates instead.\n */\nfunction gyralTemplateLocations(options: TemplateCompilerOptions = {}): Plugin {\n  let hooks: LocatorHooks | undefined;\n  const ready = (): LocatorHooks => {\n    if (hooks === undefined) throw new Error('gyral: the template locator is not loaded yet');\n    return hooks;\n  };\n  return {\n    name: 'gyral:template-locations',\n    enforce: 'pre',\n    apply: 'serve',\n    resolveId(source) {\n      return source === 'virtual:gyral/template-locations' ? '\\0gyral:template-locations' : null;\n    },\n    load(id) {\n      return id === '\\0gyral:template-locations'\n        ? 'export const locate = (tag, loc) => tag.at?.(loc) ?? tag;'\n        : null;\n    },\n    async configResolved(config) {\n      const locate = await loadCompiler<typeof import('./compiler/locate.js')>('locate');\n      hooks = locate.createLocator(settingsOf(options).sources);\n      await hooks.configResolved.call(this, config);\n    },\n    transform: {\n      // Modules naming a template tag (html or svg), as the compiler's filter.\n      filter: { id: /\\.[cm]?[jt]sx?$/, code: /html|svg/ },\n      handler(code, id, opts) {\n        return ready().transform.call(this, code, id, opts);\n      },\n    },\n  };\n}\n\n/**\n * Gyral's packages: the dev server runs them through Vite, never Node (view/06). The feature\n * scan's scope (./compiler/scope.ts) uses the same pattern.\n */\nconst GYRAL_PACKAGES = /^@gyral\\//;\n\ntype Manifest = Partial<Record<'dependencies' | 'devDependencies' | 'peerDependencies', object>>;\n\nfunction manifest(file: string): Manifest | undefined {\n  try {\n    return JSON.parse(readFileSync(file, 'utf8')) as Manifest;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The installed manifest of `name`, looked up from `root` the way Node does (no exports map). */\nfunction installed(root: string, name: string): Manifest | undefined {\n  for (let dir = root; ; dir = dirname(dir)) {\n    const found = manifest(join(dir, 'node_modules', name, 'package.json'));\n    if (found !== undefined || dirname(dir) === dir) return found;\n  }\n}\n\n/**\n * The app's direct dependencies that depend on a Gyral package (a design system, say). They\n * import `@gyral/core`, so they must share the copy the dev server runs.\n */\nfunction gyralDependents(root: string): string[] {\n  const app = manifest(join(root, 'package.json'));\n  const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });\n  return names.filter((name) => {\n    if (GYRAL_PACKAGES.test(name)) return false;\n    const dep = installed(root, name);\n    return Object.keys({ ...dep?.dependencies, ...dep?.peerDependencies }).some((d) =>\n      GYRAL_PACKAGES.test(d),\n    );\n  });\n}\n\n/**\n * Development output from the dev server's SSR (`ssrLoadModule`, view/06 \"Development\n * markers\"). Vite externalizes installed packages there and Node imports them itself, resolving\n * core's `#view-dev` without the `development` condition (Vite's `externalConditions` only pick\n * the entry file, not the package's own imports), so the server rendered production output.\n * In serve mode this plugin keeps Gyral's packages, and the app's dependencies that use them,\n * out of externalization in server environments: Vite resolves them with its conditions\n * (`development` in dev), and they all share one copy of core. `vite build` is unaffected.\n */\nfunction gyralDevSsr(): Plugin {\n  let root = process.cwd();\n  return {\n    name: 'gyral:dev-server',\n    apply: 'serve',\n    config(config) {\n      root = resolve(config.root ?? process.cwd());\n    },\n    configEnvironment(name, config) {\n      const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');\n      if (consumer === 'client') return undefined;\n      return { resolve: { noExternal: [GYRAL_PACKAGES, ...gyralDependents(root)] } };\n    },\n  };\n}\n\n/**\n * Client-only builds (view/07-hydration.md \"Client-only builds\", gyral-c5d.11), for apps no\n * server renders: the browser environment resolves core with the `gyral-client-only`\n * condition, so the bundle carries no hydration code (no seed reading, no hydration chunk and\n * its import()), and in `vite build` the invoker-command fallback only when a module that can\n * affect Gyral components (the app's own, or a package that reaches a Gyral package) may use\n * command intents (./compiler/features.ts). With no other import(), Vite's preload helper goes\n * too. Server-rendered markup met anyway renders fresh (development warns). Dev servers and\n * test runs get the condition too, and always keep the invoker fallback.\n */\nfunction gyralClientOnly(): Plugin {\n  let hooks: FeatureHooks | undefined;\n  let root = process.cwd();\n  return {\n    name: 'gyral:client-only',\n    enforce: 'pre',\n    configEnvironment(name, config, env) {\n      addCondition(name, config, env, CLIENT_ONLY_CONDITION, true);\n    },\n    async configResolved(config) {\n      root = config.root;\n      if (config.command !== 'build') return;\n      const features = await loadCompiler<typeof import('./compiler/features.js')>('features');\n      hooks = features.createFeatures(['invokers'], OWN_COMPILED);\n    },\n    async buildStart() {\n      await hooks?.buildStart((source, importer) => this.resolve(source, importer), root);\n    },\n    resolveId(source) {\n      return hooks?.resolveId(source) ?? null;\n    },\n    load(id) {\n      return hooks?.load(id) ?? null;\n    },\n    transform: {\n      // features.ts FEATURE_HINTS.invokers: any import or export may reach `raw`.\n      filter: { id: /\\.[cm]?[jt]sx?$/, code: /data-intent-on|command|raw|import|export/i },\n      async handler(code, id) {\n        if (hooks === undefined || this.environment.config.consumer !== 'client') return null;\n        const imports = await hooks.inject(code, id, {\n          parse: (text, lang) => this.parse(text, { lang }),\n          resolve: (source, importer) => this.resolve(source, importer),\n        });\n        // Appended after the last line: no code moves, so the incoming source map holds.\n        return imports === '' ? null : { code: code + imports, map: null };\n      },\n    },\n  };\n}\n\n/** Where the preset looks for components and writes their typings. */\nexport interface ElementTypesOptions {\n  /** Source directories to scan, relative to the Vite root. Default `['src']`. */\n  readonly dirs?: readonly string[];\n  /** The declaration file to write, relative to the Vite root. Default `.gyral/elements.d.ts`. */\n  readonly out?: string;\n}\n\n/**\n * Writes `HTMLElementTagNameMap` entries for every exported `define()` component (a\n * `.gyral/elements.d.ts` to gitignore and include in tsconfig) at the start of a build, dev\n * server or test run, and again when a source file changes. ./compiler/tag-map imports Node\n * built-ins only, so Node's require loads it, from TypeScript source too: no module runner,\n * which may be closed by the time a build starts (see loadCompiler).\n */\nfunction gyralElementTypes(options: ElementTypesOptions): Plugin {\n  const source = import.meta.url.endsWith('.ts')\n    ? './compiler/tag-map.ts'\n    : './compiler/tag-map.js';\n  const tagMap = createRequire(import.meta.url)(source) as typeof import('./compiler/tag-map.js');\n  return tagMap.elementTypesPlugin(options);\n}\n\nexport interface GyralViteOptions {\n  /**\n   * Generated element typings (`.gyral/elements.d.ts`, see `ElementTypesOptions`), or `false`\n   * to write none. Default: on, scanning `src`.\n   */\n  readonly types?: ElementTypesOptions | false;\n  /** Modules to pre-bundle in dev, so Vite doesn't discover them mid-run and reload. */\n  readonly optimize?: readonly string[];\n  /** Template compiler options (`vite build` only). */\n  readonly compiler?: TemplateCompilerOptions;\n  /**\n   * The app is never server-rendered: leave the hydration code out of the browser bundle\n   * (`gyralClientOnly()`). Default false.\n   */\n  readonly clientOnly?: boolean;\n  /**\n   * Automatic component loading (ADR 0016 addendum): every component defined under `include`\n   * gets a client module the build splits out, and a loader (`virtual:gyral/components`, added\n   * to the client build's input) imports a tag's module once that tag is in the page.\n   * `renderPage({ components })` then links exactly the components a page rendered, so pages\n   * need no client entry of their own and no side-effect imports. Default off.\n   */\n  readonly components?: boolean | ComponentsOptions;\n}\n\nexport interface ComponentsOptions {\n  /** Directories (relative to Vite's root) whose modules' `define()` tags are found. Default `['src']`. */\n  readonly include?: readonly string[];\n  /**\n   * Tag → module (relative to Vite's root) for components the scan can't find: those defined\n   * through a wrapper such as `defineMemberForm({ tag: 'member-form' })`, which calls\n   * `define()` itself. Listed entries win over scanned ones.\n   */\n  readonly modules?: Readonly<Record<string, string>>;\n}\n\nexport interface GyralViteConfig {\n  readonly plugins: Plugin[];\n  readonly optimizeDeps: { readonly include: string[] };\n}\n\n/**\n * Spread into a Vite config, or into each Vitest project:\n *\n *   export default defineConfig({ ...gyralVitePreset(), build: { … } });\n *\n * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.\n */\nexport function gyralVitePreset(options: GyralViteOptions = {}): GyralViteConfig {\n  return {\n    plugins: [\n      // Before the compiler: its feature scan reads the author's templates, not compiled ones.\n      ...(options.clientOnly === true ? [gyralClientOnly()] : []),\n      gyralTemplateCompiler(options.compiler),\n      gyralTemplateLocations(options.compiler),\n      gyralDevSsr(),\n      ...(options.components === undefined || options.components === false\n        ? []\n        : [gyralComponents(options.components === true ? {} : options.components)]),\n      ...(options.types === false ? [] : [gyralElementTypes(options.types ?? {})]),\n    ],\n    optimizeDeps: { include: [...new Set(options.optimize ?? [])] },\n  };\n}\n\ntype Hook = (this: unknown, ...args: unknown[]) => unknown;\n\n/**\n * Automatic component loading (`gyralVitePreset({ components })`): a shell whose hooks run\n * ./compiler/components.ts, loaded on the first hook (`config`) like the compiler.\n */\nfunction gyralComponents(options: ComponentsOptions): Plugin {\n  let impl: Plugin | undefined;\n  const run = (name: keyof Plugin) =>\n    function (this: unknown, ...args: unknown[]): unknown {\n      const hook = impl?.[name] as Hook | undefined;\n      return hook?.call(this, ...args) ?? null;\n    };\n  const hook = <K extends keyof Plugin>(name: K) => run(name) as NonNullable<Plugin[K]>;\n  return {\n    name: 'gyral:components',\n    api: {\n      tags: (): ReadonlyMap<string, string> =>\n        (impl?.api as { tags?: () => ReadonlyMap<string, string> } | undefined)?.tags?.() ??\n        new Map(),\n    },\n    async config(...args) {\n      const components =\n        await loadCompiler<typeof import('./compiler/components.js')>('components');\n      impl = components.createComponents(options);\n      return run('config').apply(this, args) as undefined;\n    },\n    configResolved: hook('configResolved'),\n    buildStart: hook('buildStart'),\n    resolveId: hook('resolveId'),\n    load: hook('load'),\n    configureServer: hook('configureServer'),\n    generateBundle: hook('generateBundle'),\n  };\n}\n"]}