@gyral/core 0.3.0 → 0.3.1

package/dist/compiler/hooks.js

@@ -3,23 +3,39 @@
 // `vite build` hook, so the preset stays loadable from any vite.config.ts:
 //   - `transform` (the shell is enforce: 'pre', so positions are the author's own source,
 //     TypeScript included, parsed by Rolldown's `this.parse`): rewrites each `html` call site
-//     of the configured sources into `compiled(<hoisted template object>, [values…])`,
-//     dependencies in node_modules included. Template rule violations, and references it
-//     can't follow, fail the build with a code frame.
-//   - `generateBundle`: fails when an uncompiled `html` survived in a chunk anyway (re-exports
-//     across modules, dynamic imports): the guarantee that the `#prepare` stub is never hit.
+//     of the configured sources into `compiled(<hoisted template object>, [values…])` (and
+//     each `svg` one into `compiledSvg(…)`), dependencies in node_modules included. Template
+//     rule violations, and references it can't follow, fail the build with a code frame.
+//   - `generateBundle`: fails when an uncompiled `html` or `svg` survived in a chunk anyway
+//     (re-exports across modules, dynamic imports): the guarantee that the `#prepare` stub is
+//     never hit.
+//   - In client environments, `transform` also adds the registration of view transitions, the
+//     frame lane and custom states to every module that names their spec field, among the
+//     modules that can affect Gyral components (the app's own, and packages that reach a Gyral
+//     package), so the `gyral-compiled` condition can leave them out otherwise (features.ts,
+//     gyral-c5d.12); `resolveId` and `load` serve those registration modules.
 import { join, relative } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { langOf } from './ast.js';
 import { CompileError, compileModule } from './compile.js';
+import { createFeatures } from './features.js';
+import { stripPropSchemas } from './prop-schemas.js';
 import { loadParse5 } from './parse5-check.js';
+import { VIEW } from './locate.js';
 import { findUses, htmlImports } from './scan.js';
-import { Lines } from './source.js';
-/** Core's own view modules: always sources (core-internal templates, tests). */
-const VIEW = ['index', 'template'].flatMap((name) => ['.ts', '.js'].map((ext) => fileURLToPath(new URL(`../view/${name}${ext}`, import.meta.url))));
-/** template.ts's symbol description: the module defining `html`, in any copy of core. */
+import { Lines, splice } from './source.js';
+/** Appends `imports` after the module's last line: no code moves, so source maps hold. */
+const appended = (result, code, imports) => imports === ''
+    ? result
+    : result === null
+        ? { code: code + imports, map: null }
+        : { ...result, code: result.code + imports };
+/** Modules naming a template tag, or calling `.value(`: only those can need compiling. */
+const NAMES_TAG = /html|svg|\.value\s*\(/;
+/** A `prop.value(…)` call may be in the module (prop-schemas.ts). */
+const PROP_VALUE = /\.value\s*\(/;
+/** template.ts's symbol description: the module defining `html` and `svg`, in any copy of core. */
 const DEFINES_HTML = /Symbol\(['"]gyral\.template['"]\)/;
 const SCRIPT = /\.[cm]?[jt]sx?$/;
-const langOf = (id) => /\.[cm]?tsx$/.test(id) ? 'tsx' : /\.[cm]?ts$/.test(id) ? 'ts' : id.endsWith('x') ? 'jsx' : 'js';
 /**
  * Whether an environment resolves core's `#view-dev` to its development module: the
  * `development` condition is listed, or Vite's `development|production` placeholder is and
@@ -31,12 +47,24 @@ function developmentBuild(config) {
         (!config.isProduction && conditions.includes('development|production')));
 }
 const CANT_FOLLOW = `This use of html can't be compiled: the template compiler rewrites only html\`…\` tagged ` +
-    `templates whose tag is the imported html itself (or ns.html for import * as ns). ` +
+    `templates whose tag is the imported html itself (or ns.html for import * as ns; the same ` +
+    `for svg). ` +
     `Aliasing it, passing it around or calling it as a function would reach the runtime ` +
     `template preparer, which builds made with the Gyral preset leave out. Write html\`…\` at ` +
     `the call site (view/01-templates.md "Compiled").`;
 export function createCompiler(settings) {
     const { sources } = settings;
+    const features = createFeatures([
+        'transitions',
+        'frame',
+        'states',
+        'forms',
+        'subscriptions',
+        'dialogs',
+        'disposal',
+        'errorView',
+        'errored',
+    ], settings.ownEntry);
     /** Per environment (client, ssr, …): Vite may build them with one plugin instance. */
     const states = new WeakMap();
     const global = {};
@@ -68,6 +96,89 @@ export function createCompiler(settings) {
         }
         return parse5.module;
     }
+    /** Compiles the module's template call sites (the transform proper). */
+    async function compile(code, id, opts) {
+        if (id.startsWith('\0') || !SCRIPT.test(id))
+            return null;
+        const env = this.environment;
+        const state = stateOf(env);
+        if (DEFINES_HTML.test(code))
+            state.definers.add(id);
+        if (state.sourceIds.has(id))
+            return null;
+        let program;
+        try {
+            program = this.parse(code, { lang: langOf(id) });
+        }
+        catch {
+            return null; // not ours to report: the bundler fails on it with a better message
+        }
+        const lines = new Lines(code);
+        const file = relative(root, id);
+        // Production client builds: property-only prop checks can't run (prop-schemas.ts).
+        const client = opts?.ssr !== true && env.config.consumer === 'client';
+        const extra = client && !developmentBuild(env.config) && PROP_VALUE.test(code)
+            ? stripPropSchemas(program, code)
+            : [];
+        const unchanged = () => (extra.length === 0 ? null : splice(lines, extra, id));
+        const { imports, reexports } = htmlImports(program);
+        if (imports.length === 0 && reexports.length === 0)
+            return unchanged();
+        const isSource = async (specifier) => {
+            if (sources.includes(specifier))
+                return true;
+            const resolved = await this.resolve(specifier, id);
+            return resolved !== null && state.sourceIds.has(resolved.id);
+        };
+        const where = (node) => `${file}:${String(lines.position(node.start).line)}`;
+        for (const r of reexports) {
+            if (!(await isSource(r.specifier)))
+                continue;
+            this.warn(`${where(r.node)}: re-exporting html or svg. The template compiler only follows the ` +
+                `tags imported straight from ${r.specifier}: templates written with this re-export ` +
+                `stay uncompiled and fail the build. Import them from ${r.specifier} instead.`);
+        }
+        const matched = [];
+        for (const binding of imports)
+            if (await isSource(binding.specifier))
+                matched.push(binding);
+        if (matched.length === 0)
+            return unchanged();
+        const fail = (start, end, message) => this.error({
+            message,
+            id,
+            loc: { file: id, ...lines.position(start) },
+            frame: lines.frame(start, end),
+        });
+        const { sites, leftovers } = findUses(program, matched);
+        for (const l of leftovers) {
+            if (l.exported)
+                this.warn(`${where(l.node)}: re-exporting a template tag; its users stay uncompiled.`);
+            else
+                fail(l.node.start, l.node.end, CANT_FOLLOW);
+        }
+        if (sites.length === 0)
+            return unchanged();
+        const ssr = opts?.ssr === true || env.config.consumer === 'server';
+        try {
+            return compileModule({
+                lines,
+                id,
+                file,
+                sites,
+                ssr,
+                ids: ssr || developmentBuild(env.config),
+                parse5: loadOnce(),
+                extra,
+                seen: state.seen,
+            });
+        }
+        catch (error) {
+            if (error instanceof CompileError)
+                return fail(error.start, error.end, error.message);
+            throw error;
+        }
+    }
     return {
         configResolved(config) {
             root = config.root;
@@ -84,82 +195,25 @@ export function createCompiler(settings) {
                 if (resolved !== null)
                     state.sourceIds.add(resolved.id);
             }
+            await features.buildStart((source, importer) => this.resolve(source, importer), root);
             loadOnce();
         },
+        resolveId(source) {
+            return features.resolveId(source);
+        },
+        load(id) {
+            return features.load(id);
+        },
         async transform(code, id, opts) {
-            if (id.startsWith('\0') || !SCRIPT.test(id))
-                return null;
-            const env = this.environment;
-            const state = stateOf(env);
-            if (DEFINES_HTML.test(code))
-                state.definers.add(id);
-            if (state.sourceIds.has(id))
-                return null;
-            let program;
-            try {
-                program = this.parse(code, { lang: langOf(id) });
-            }
-            catch {
-                return null; // not ours to report: the bundler fails on it with a better message
-            }
-            const { imports, reexports } = htmlImports(program);
-            if (imports.length === 0 && reexports.length === 0)
-                return null;
-            const isSource = async (specifier) => {
-                if (sources.includes(specifier))
-                    return true;
-                const resolved = await this.resolve(specifier, id);
-                return resolved !== null && state.sourceIds.has(resolved.id);
-            };
-            const lines = new Lines(code);
-            const file = relative(root, id);
-            const where = (node) => `${file}:${String(lines.position(node.start).line)}`;
-            for (const r of reexports) {
-                if (!(await isSource(r.specifier)))
-                    continue;
-                this.warn(`${where(r.node)}: re-exporting html. The template compiler only follows html ` +
-                    `imported straight from ${r.specifier}: templates written with this re-export stay ` +
-                    `uncompiled and fail the build. Import html from ${r.specifier} instead.`);
-            }
-            const matched = [];
-            for (const binding of imports)
-                if (await isSource(binding.specifier))
-                    matched.push(binding);
-            if (matched.length === 0)
-                return null;
-            const fail = (start, end, message) => this.error({
-                message,
-                id,
-                loc: { file: id, ...lines.position(start) },
-                frame: lines.frame(start, end),
-            });
-            const { sites, leftovers } = findUses(program, matched);
-            for (const l of leftovers) {
-                if (l.exported)
-                    this.warn(`${where(l.node)}: re-exporting html; its users stay uncompiled.`);
-                else
-                    fail(l.node.start, l.node.end, CANT_FOLLOW);
-            }
-            if (sites.length === 0)
-                return null;
-            const ssr = opts?.ssr === true || env.config.consumer === 'server';
-            try {
-                return compileModule({
-                    lines,
-                    id,
-                    file,
-                    sites,
-                    ssr,
-                    ids: ssr || developmentBuild(env.config),
-                    parse5: loadOnce(),
-                    seen: state.seen,
-                });
-            }
-            catch (error) {
-                if (error instanceof CompileError)
-                    return fail(error.start, error.end, error.message);
-                throw error;
-            }
+            const client = opts?.ssr !== true && this.environment.config.consumer === 'client';
+            const imports = client
+                ? await features.inject(code, id, {
+                    parse: (text, lang) => this.parse(text, { lang }),
+                    resolve: (source, importer) => this.resolve(source, importer),
+                })
+                : '';
+            const compiled = NAMES_TAG.test(code) ? await compile.call(this, code, id, opts) : null;
+            return appended(compiled, code, imports);
         },
         generateBundle(_, bundle) {
             const state = stateOf(this.environment);
@@ -170,13 +224,14 @@ export function createCompiler(settings) {
                 if (chunk.type !== 'chunk')
                     continue;
                 for (const [id, module] of Object.entries(chunk.modules)) {
-                    if (!state.definers.has(id) || !module.renderedExports.includes('html'))
+                    const tag = ['html', 'svg'].find((name) => module.renderedExports.includes(name));
+                    if (!state.definers.has(id) || tag === undefined)
                         continue;
-                    this.error(`gyral: an uncompiled html template remains in ${chunk.fileName}: something uses ` +
-                        `html from ${relative(root, id)} in a way the template compiler can't see (a ` +
+                    this.error(`gyral: an uncompiled ${tag} template remains in ${chunk.fileName}: something uses ` +
+                        `${tag} from ${relative(root, id)} in a way the template compiler can't see (a ` +
                         `re-export, a dynamic import, or a module it doesn't process). With the ` +
                         `gyral-compiled condition the runtime preparer is left out, so that template ` +
-                        `would throw. Import html straight from '@gyral/core' where you write templates ` +
+                        `would throw. Import ${tag} straight from '@gyral/core' where you write templates ` +
                         `(view/01-templates.md "Compiled").`);
                 }
             }

package/dist/compiler/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/compiler/hooks.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,2FAA2F;AAC3F,2EAA2E;AAC3E,0FAA0F;AAC1F,8FAA8F;AAC9F,uFAAuF;AACvF,yFAAyF;AACzF,sDAAsD;AACtD,+FAA+F;AAC/F,6FAA6F;AAC7F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAe,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAkBpC,gFAAgF;AAChF,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAClD,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAC9F,CAAC;AACF,yFAAyF;AACzF,MAAM,YAAY,GAAG,mCAAmC,CAAC;AACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAQjC,MAAM,MAAM,GAAG,CAAC,EAAU,EAA+B,EAAE,CACzD,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAElG;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,MAGzB;IACC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IACtC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GACf,2FAA2F;IAC3F,mFAAmF;IACnF,qFAAqF;IACrF,2FAA2F;IAC3F,kDAAkD,CAAC;AAErD,MAAM,UAAU,cAAc,CAAC,QAA0B;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC7B,sFAAsF;IACtF,MAAM,MAAM,GAAG,IAAI,OAAO,EAAsB,CAAC;IACjD,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,IAAI,GAA8B,GAAG,EAAE,CAAC,SAAS,CAAC;IACtD,IAAI,MAA2D,CAAC;IAEhE,SAAS,OAAO,CAAC,GAAuB;QACtC,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;QAC1B,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,KAAK,GAAG,EAAE,SAAS,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,SAAS,QAAQ;QACf,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC9C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;YACjD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CACF,UAAU,SAAS,8DAA8D;oBAC/E,+EAA+E;oBAC/E,qCAAqC,CACxC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO;QACL,cAAc,CAAC,MAAM;YACnB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,KAAK,KAAK,CAAC;YAC7D,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE;gBACjB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,UAAU;YACd,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;gBACtE,IAAI,QAAQ,KAAK,IAAI;oBAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1D,CAAC;YACD,QAAQ,EAAE,CAAC;QACb,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI;YAC5B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,IAAI,OAAa,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAoB,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC,CAAC,oEAAoE;YACnF,CAAC;YACD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACpD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAiB,EAAoB,EAAE;gBAC7D,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;oBAAE,OAAO,IAAI,CAAC;gBAC7C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACnD,OAAO,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/D,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,MAAM,KAAK,GAAG,CAAC,IAAU,EAAU,EAAE,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3F,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBAAE,SAAS;gBAC7C,IAAI,CAAC,IAAI,CACP,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,+DAA+D;oBAC7E,0BAA0B,CAAC,CAAC,SAAS,+CAA+C;oBACpF,mDAAmD,CAAC,CAAC,SAAS,WAAW,CAC5E,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,OAAO,IAAI,OAAO;gBAAE,IAAI,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,OAAe,EAAS,EAAE,CAClE,IAAI,CAAC,KAAK,CAAC;gBACT,OAAO;gBACP,EAAE;gBACF,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;gBAC3C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;aAC/B,CAAC,CAAC;YACL,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,CAAC,QAAQ;oBACZ,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;;oBAC1E,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACnD,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpC,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;YACnE,IAAI,CAAC;gBACH,OAAO,aAAa,CAAC;oBACnB,KAAK;oBACL,EAAE;oBACF,IAAI;oBACJ,KAAK;oBACL,GAAG;oBACH,GAAG,EAAE,GAAG,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC;oBACxC,MAAM,EAAE,QAAQ,EAAE;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,YAAY;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtF,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,cAAc,CAAC,CAAC,EAAE,MAAM;YACtB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,8DAA8D;YAC9D,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO;YACpD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAAE,SAAS;gBACrC,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAAE,SAAS;oBAClF,IAAI,CAAC,KAAK,CACR,iDAAiD,KAAK,CAAC,QAAQ,mBAAmB;wBAChF,aAAa,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,+CAA+C;wBAC9E,yEAAyE;wBACzE,8EAA8E;wBAC9E,iFAAiF;wBACjF,oCAAoC,CACvC,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// The template compiler's build hooks (view/01-templates.md \"Compiled\",\n// view/09-template-rules.md), loaded lazily by the plugin shell in ../vite.ts on the first\n// `vite build` hook, so the preset stays loadable from any vite.config.ts:\n//   - `transform` (the shell is enforce: 'pre', so positions are the author's own source,\n//     TypeScript included, parsed by Rolldown's `this.parse`): rewrites each `html` call site\n//     of the configured sources into `compiled(<hoisted template object>, [values…])`,\n//     dependencies in node_modules included. Template rule violations, and references it\n//     can't follow, fail the build with a code frame.\n//   - `generateBundle`: fails when an uncompiled `html` survived in a chunk anyway (re-exports\n//     across modules, dynamic imports): the guarantee that the `#prepare` stub is never hit.\nimport { join, relative } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Plugin } from 'vite';\nimport type { Node } from './ast.js';\nimport { CompileError, compileModule } from './compile.js';\nimport { loadParse5, type Parse5 } from './parse5-check.js';\nimport { findUses, htmlImports } from './scan.js';\nimport { Lines } from './source.js';\n\ntype Fn<H> = H extends { handler: infer F } ? F : H;\ntype HookFn<K extends keyof Plugin> = Fn<NonNullable<Plugin[K]>>;\n\nexport interface CompilerHooks {\n  readonly configResolved: HookFn<'configResolved'>;\n  readonly buildStart: HookFn<'buildStart'>;\n  readonly transform: HookFn<'transform'>;\n  readonly generateBundle: HookFn<'generateBundle'>;\n}\n\nexport interface CompilerSettings {\n  readonly sources: readonly string[];\n  /** The module to load parse5 from; undefined skips the parse5 check. */\n  readonly parse5: string | undefined;\n}\n\n/** Core's own view modules: always sources (core-internal templates, tests). */\nconst VIEW = ['index', 'template'].flatMap((name) =>\n  ['.ts', '.js'].map((ext) => fileURLToPath(new URL(`../view/${name}${ext}`, import.meta.url))),\n);\n/** template.ts's symbol description: the module defining `html`, in any copy of core. */\nconst DEFINES_HTML = /Symbol\\(['\"]gyral\\.template['\"]\\)/;\nconst SCRIPT = /\\.[cm]?[jt]sx?$/;\n\ninterface BuildState {\n  readonly sourceIds: Set<string>;\n  readonly definers: Set<string>;\n  readonly seen: Map<string, { readonly strings: string; readonly loc: string }>;\n}\n\nconst langOf = (id: string): 'js' | 'jsx' | 'ts' | 'tsx' =>\n  /\\.[cm]?tsx$/.test(id) ? 'tsx' : /\\.[cm]?ts$/.test(id) ? 'ts' : id.endsWith('x') ? 'jsx' : 'js';\n\n/**\n * Whether an environment resolves core's `#view-dev` to its development module: the\n * `development` condition is listed, or Vite's `development|production` placeholder is and\n * the build isn't a production one. Exactly then the client keeps template ids (01).\n */\nfunction developmentBuild(config: {\n  readonly isProduction: boolean;\n  readonly resolve: { readonly conditions: readonly string[] };\n}): boolean {\n  const { conditions } = config.resolve;\n  return (\n    conditions.includes('development') ||\n    (!config.isProduction && conditions.includes('development|production'))\n  );\n}\n\nconst CANT_FOLLOW =\n  `This use of html can't be compiled: the template compiler rewrites only html\\`…\\` tagged ` +\n  `templates whose tag is the imported html itself (or ns.html for import * as ns). ` +\n  `Aliasing it, passing it around or calling it as a function would reach the runtime ` +\n  `template preparer, which builds made with the Gyral preset leave out. Write html\\`…\\` at ` +\n  `the call site (view/01-templates.md \"Compiled\").`;\n\nexport function createCompiler(settings: CompilerSettings): CompilerHooks {\n  const { sources } = settings;\n  /** Per environment (client, ssr, …): Vite may build them with one plugin instance. */\n  const states = new WeakMap<object, BuildState>();\n  const global = {};\n  let root = '';\n  let treeshake = true;\n  let info: (message: string) => void = () => undefined;\n  let parse5: { readonly module: Parse5 | undefined } | undefined;\n\n  function stateOf(env: object | undefined): BuildState {\n    const key = env ?? global;\n    let state = states.get(key);\n    if (state === undefined) {\n      state = { sourceIds: new Set(VIEW), definers: new Set(), seen: new Map() };\n      states.set(key, state);\n    }\n    return state;\n  }\n\n  /** parse5, loaded once; the notice when it is missing is printed once too. */\n  function loadOnce(): Parse5 | undefined {\n    const specifier = settings.parse5;\n    if (specifier === undefined) return undefined;\n    if (parse5 === undefined) {\n      parse5 = { module: loadParse5(specifier, root) };\n      if (parse5.module === undefined) {\n        info(\n          `gyral: ${specifier} is not installed, so the template compiler skips its extra ` +\n            `rule 7 check (the normalizer's own check still runs). To get it: pnpm add -D ` +\n            `parse5 (view/09-template-rules.md).`,\n        );\n      }\n    }\n    return parse5.module;\n  }\n\n  return {\n    configResolved(config) {\n      root = config.root;\n      treeshake = config.build.rolldownOptions.treeshake !== false;\n      info = (message) => {\n        config.logger.info(message);\n      };\n    },\n\n    async buildStart() {\n      states.delete(this.environment);\n      const state = stateOf(this.environment);\n      for (const source of sources) {\n        const resolved = await this.resolve(source, join(root, 'index.html'));\n        if (resolved !== null) state.sourceIds.add(resolved.id);\n      }\n      loadOnce();\n    },\n\n    async transform(code, id, opts) {\n      if (id.startsWith('\\0') || !SCRIPT.test(id)) return null;\n      const env = this.environment;\n      const state = stateOf(env);\n      if (DEFINES_HTML.test(code)) state.definers.add(id);\n      if (state.sourceIds.has(id)) return null;\n      let program: Node;\n      try {\n        program = this.parse(code, { lang: langOf(id) }) as unknown as Node;\n      } catch {\n        return null; // not ours to report: the bundler fails on it with a better message\n      }\n      const { imports, reexports } = htmlImports(program);\n      if (imports.length === 0 && reexports.length === 0) return null;\n      const isSource = async (specifier: string): Promise<boolean> => {\n        if (sources.includes(specifier)) return true;\n        const resolved = await this.resolve(specifier, id);\n        return resolved !== null && state.sourceIds.has(resolved.id);\n      };\n      const lines = new Lines(code);\n      const file = relative(root, id);\n      const where = (node: Node): string => `${file}:${String(lines.position(node.start).line)}`;\n      for (const r of reexports) {\n        if (!(await isSource(r.specifier))) continue;\n        this.warn(\n          `${where(r.node)}: re-exporting html. The template compiler only follows html ` +\n            `imported straight from ${r.specifier}: templates written with this re-export stay ` +\n            `uncompiled and fail the build. Import html from ${r.specifier} instead.`,\n        );\n      }\n      const matched = [];\n      for (const binding of imports) if (await isSource(binding.specifier)) matched.push(binding);\n      if (matched.length === 0) return null;\n      const fail = (start: number, end: number, message: string): never =>\n        this.error({\n          message,\n          id,\n          loc: { file: id, ...lines.position(start) },\n          frame: lines.frame(start, end),\n        });\n      const { sites, leftovers } = findUses(program, matched);\n      for (const l of leftovers) {\n        if (l.exported)\n          this.warn(`${where(l.node)}: re-exporting html; its users stay uncompiled.`);\n        else fail(l.node.start, l.node.end, CANT_FOLLOW);\n      }\n      if (sites.length === 0) return null;\n      const ssr = opts?.ssr === true || env.config.consumer === 'server';\n      try {\n        return compileModule({\n          lines,\n          id,\n          file,\n          sites,\n          ssr,\n          ids: ssr || developmentBuild(env.config),\n          parse5: loadOnce(),\n          seen: state.seen,\n        });\n      } catch (error) {\n        if (error instanceof CompileError) return fail(error.start, error.end, error.message);\n        throw error;\n      }\n    },\n\n    generateBundle(_, bundle) {\n      const state = stateOf(this.environment);\n      // Without tree-shaking every export is rendered, used or not.\n      if (state.definers.size === 0 || !treeshake) return;\n      for (const chunk of Object.values(bundle)) {\n        if (chunk.type !== 'chunk') continue;\n        for (const [id, module] of Object.entries(chunk.modules)) {\n          if (!state.definers.has(id) || !module.renderedExports.includes('html')) continue;\n          this.error(\n            `gyral: an uncompiled html template remains in ${chunk.fileName}: something uses ` +\n              `html from ${relative(root, id)} in a way the template compiler can't see (a ` +\n              `re-export, a dynamic import, or a module it doesn't process). With the ` +\n              `gyral-compiled condition the runtime preparer is left out, so that template ` +\n              `would throw. Import html straight from '@gyral/core' where you write templates ` +\n              `(view/01-templates.md \"Compiled\").`,\n          );\n        }\n      }\n    },\n  };\n}\n"]}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/compiler/hooks.ts"],"names":[],"mappings":"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","sourcesContent":["// The template compiler's build hooks (view/01-templates.md \"Compiled\",\n// view/09-template-rules.md), loaded lazily by the plugin shell in ../vite.ts on the first\n// `vite build` hook, so the preset stays loadable from any vite.config.ts:\n//   - `transform` (the shell is enforce: 'pre', so positions are the author's own source,\n//     TypeScript included, parsed by Rolldown's `this.parse`): rewrites each `html` call site\n//     of the configured sources into `compiled(<hoisted template object>, [values…])` (and\n//     each `svg` one into `compiledSvg(…)`), dependencies in node_modules included. Template\n//     rule violations, and references it can't follow, fail the build with a code frame.\n//   - `generateBundle`: fails when an uncompiled `html` or `svg` survived in a chunk anyway\n//     (re-exports across modules, dynamic imports): the guarantee that the `#prepare` stub is\n//     never hit.\n//   - In client environments, `transform` also adds the registration of view transitions, the\n//     frame lane and custom states to every module that names their spec field, among the\n//     modules that can affect Gyral components (the app's own, and packages that reach a Gyral\n//     package), so the `gyral-compiled` condition can leave them out otherwise (features.ts,\n//     gyral-c5d.12); `resolveId` and `load` serve those registration modules.\nimport { join, relative } from 'node:path';\nimport type { Plugin } from 'vite';\nimport { langOf, type Node } from './ast.js';\nimport { CompileError, compileModule } from './compile.js';\nimport { createFeatures } from './features.js';\nimport { stripPropSchemas } from './prop-schemas.js';\nimport { loadParse5, type Parse5 } from './parse5-check.js';\nimport { VIEW } from './locate.js';\nimport { findUses, htmlImports } from './scan.js';\nimport { Lines, splice, type SourceMap } from './source.js';\n\ntype Fn<H> = H extends { handler: infer F } ? F : H;\ntype HookFn<K extends keyof Plugin> = Fn<NonNullable<Plugin[K]>>;\n\nexport interface CompilerHooks {\n  readonly configResolved: HookFn<'configResolved'>;\n  readonly buildStart: HookFn<'buildStart'>;\n  readonly resolveId: HookFn<'resolveId'>;\n  readonly load: HookFn<'load'>;\n  readonly transform: HookFn<'transform'>;\n  readonly generateBundle: HookFn<'generateBundle'>;\n}\n\nexport interface CompilerSettings {\n  readonly sources: readonly string[];\n  /** The module to load parse5 from; undefined skips the parse5 check. */\n  readonly parse5: string | undefined;\n  /** The compiled entry of the core copy running the plugin (features.ts). */\n  readonly ownEntry: string;\n}\n\ntype TransformContext = ThisParameterType<HookFn<'transform'>>;\ntype TransformOptions = Parameters<HookFn<'transform'>>[2];\n/** What `compile` returns: the rewritten module, or null when nothing changed. */\ntype Transformed = { readonly code: string; readonly map: SourceMap | null } | null;\n\n/** Appends `imports` after the module's last line: no code moves, so source maps hold. */\nconst appended = (result: Transformed, code: string, imports: string): Transformed =>\n  imports === ''\n    ? result\n    : result === null\n      ? { code: code + imports, map: null }\n      : { ...result, code: result.code + imports };\n\n/** Modules naming a template tag, or calling `.value(`: only those can need compiling. */\nconst NAMES_TAG = /html|svg|\\.value\\s*\\(/;\n/** A `prop.value(…)` call may be in the module (prop-schemas.ts). */\nconst PROP_VALUE = /\\.value\\s*\\(/;\n\n/** template.ts's symbol description: the module defining `html` and `svg`, in any copy of core. */\nconst DEFINES_HTML = /Symbol\\(['\"]gyral\\.template['\"]\\)/;\nconst SCRIPT = /\\.[cm]?[jt]sx?$/;\n\ninterface BuildState {\n  readonly sourceIds: Set<string>;\n  readonly definers: Set<string>;\n  readonly seen: Map<string, { readonly strings: string; readonly loc: string }>;\n}\n\n/**\n * Whether an environment resolves core's `#view-dev` to its development module: the\n * `development` condition is listed, or Vite's `development|production` placeholder is and\n * the build isn't a production one. Exactly then the client keeps template ids (01).\n */\nfunction developmentBuild(config: {\n  readonly isProduction: boolean;\n  readonly resolve: { readonly conditions: readonly string[] };\n}): boolean {\n  const { conditions } = config.resolve;\n  return (\n    conditions.includes('development') ||\n    (!config.isProduction && conditions.includes('development|production'))\n  );\n}\n\nconst CANT_FOLLOW =\n  `This use of html can't be compiled: the template compiler rewrites only html\\`…\\` tagged ` +\n  `templates whose tag is the imported html itself (or ns.html for import * as ns; the same ` +\n  `for svg). ` +\n  `Aliasing it, passing it around or calling it as a function would reach the runtime ` +\n  `template preparer, which builds made with the Gyral preset leave out. Write html\\`…\\` at ` +\n  `the call site (view/01-templates.md \"Compiled\").`;\n\nexport function createCompiler(settings: CompilerSettings): CompilerHooks {\n  const { sources } = settings;\n  const features = createFeatures(\n    [\n      'transitions',\n      'frame',\n      'states',\n      'forms',\n      'subscriptions',\n      'dialogs',\n      'disposal',\n      'errorView',\n      'errored',\n    ],\n    settings.ownEntry,\n  );\n  /** Per environment (client, ssr, …): Vite may build them with one plugin instance. */\n  const states = new WeakMap<object, BuildState>();\n  const global = {};\n  let root = '';\n  let treeshake = true;\n  let info: (message: string) => void = () => undefined;\n  let parse5: { readonly module: Parse5 | undefined } | undefined;\n\n  function stateOf(env: object | undefined): BuildState {\n    const key = env ?? global;\n    let state = states.get(key);\n    if (state === undefined) {\n      state = { sourceIds: new Set(VIEW), definers: new Set(), seen: new Map() };\n      states.set(key, state);\n    }\n    return state;\n  }\n\n  /** parse5, loaded once; the notice when it is missing is printed once too. */\n  function loadOnce(): Parse5 | undefined {\n    const specifier = settings.parse5;\n    if (specifier === undefined) return undefined;\n    if (parse5 === undefined) {\n      parse5 = { module: loadParse5(specifier, root) };\n      if (parse5.module === undefined) {\n        info(\n          `gyral: ${specifier} is not installed, so the template compiler skips its extra ` +\n            `rule 7 check (the normalizer's own check still runs). To get it: pnpm add -D ` +\n            `parse5 (view/09-template-rules.md).`,\n        );\n      }\n    }\n    return parse5.module;\n  }\n\n  /** Compiles the module's template call sites (the transform proper). */\n  async function compile(\n    this: TransformContext,\n    code: string,\n    id: string,\n    opts: TransformOptions,\n  ): Promise<Transformed> {\n    if (id.startsWith('\\0') || !SCRIPT.test(id)) return null;\n    const env = this.environment;\n    const state = stateOf(env);\n    if (DEFINES_HTML.test(code)) state.definers.add(id);\n    if (state.sourceIds.has(id)) return null;\n    let program: Node;\n    try {\n      program = this.parse(code, { lang: langOf(id) }) as unknown as Node;\n    } catch {\n      return null; // not ours to report: the bundler fails on it with a better message\n    }\n    const lines = new Lines(code);\n    const file = relative(root, id);\n    // Production client builds: property-only prop checks can't run (prop-schemas.ts).\n    const client = opts?.ssr !== true && env.config.consumer === 'client';\n    const extra =\n      client && !developmentBuild(env.config) && PROP_VALUE.test(code)\n        ? stripPropSchemas(program, code)\n        : [];\n    const unchanged = (): Transformed => (extra.length === 0 ? null : splice(lines, extra, id));\n    const { imports, reexports } = htmlImports(program);\n    if (imports.length === 0 && reexports.length === 0) return unchanged();\n    const isSource = async (specifier: string): Promise<boolean> => {\n      if (sources.includes(specifier)) return true;\n      const resolved = await this.resolve(specifier, id);\n      return resolved !== null && state.sourceIds.has(resolved.id);\n    };\n    const where = (node: Node): string => `${file}:${String(lines.position(node.start).line)}`;\n    for (const r of reexports) {\n      if (!(await isSource(r.specifier))) continue;\n      this.warn(\n        `${where(r.node)}: re-exporting html or svg. The template compiler only follows the ` +\n          `tags imported straight from ${r.specifier}: templates written with this re-export ` +\n          `stay uncompiled and fail the build. Import them from ${r.specifier} instead.`,\n      );\n    }\n    const matched = [];\n    for (const binding of imports) if (await isSource(binding.specifier)) matched.push(binding);\n    if (matched.length === 0) return unchanged();\n    const fail = (start: number, end: number, message: string): never =>\n      this.error({\n        message,\n        id,\n        loc: { file: id, ...lines.position(start) },\n        frame: lines.frame(start, end),\n      });\n    const { sites, leftovers } = findUses(program, matched);\n    for (const l of leftovers) {\n      if (l.exported)\n        this.warn(`${where(l.node)}: re-exporting a template tag; its users stay uncompiled.`);\n      else fail(l.node.start, l.node.end, CANT_FOLLOW);\n    }\n    if (sites.length === 0) return unchanged();\n    const ssr = opts?.ssr === true || env.config.consumer === 'server';\n    try {\n      return compileModule({\n        lines,\n        id,\n        file,\n        sites,\n        ssr,\n        ids: ssr || developmentBuild(env.config),\n        parse5: loadOnce(),\n        extra,\n        seen: state.seen,\n      });\n    } catch (error) {\n      if (error instanceof CompileError) return fail(error.start, error.end, error.message);\n      throw error;\n    }\n  }\n\n  return {\n    configResolved(config) {\n      root = config.root;\n      treeshake = config.build.rolldownOptions.treeshake !== false;\n      info = (message) => {\n        config.logger.info(message);\n      };\n    },\n\n    async buildStart() {\n      states.delete(this.environment);\n      const state = stateOf(this.environment);\n      for (const source of sources) {\n        const resolved = await this.resolve(source, join(root, 'index.html'));\n        if (resolved !== null) state.sourceIds.add(resolved.id);\n      }\n      await features.buildStart((source, importer) => this.resolve(source, importer), root);\n      loadOnce();\n    },\n\n    resolveId(source) {\n      return features.resolveId(source);\n    },\n\n    load(id) {\n      return features.load(id);\n    },\n\n    async transform(code, id, opts) {\n      const client = opts?.ssr !== true && this.environment.config.consumer === 'client';\n      const imports = client\n        ? await features.inject(code, id, {\n            parse: (text, lang) => this.parse(text, { lang }),\n            resolve: (source, importer) => this.resolve(source, importer),\n          })\n        : '';\n      const compiled = NAMES_TAG.test(code) ? await compile.call(this, code, id, opts) : null;\n      return appended(compiled, code, imports);\n    },\n\n    generateBundle(_, bundle) {\n      const state = stateOf(this.environment);\n      // Without tree-shaking every export is rendered, used or not.\n      if (state.definers.size === 0 || !treeshake) return;\n      for (const chunk of Object.values(bundle)) {\n        if (chunk.type !== 'chunk') continue;\n        for (const [id, module] of Object.entries(chunk.modules)) {\n          const tag = ['html', 'svg'].find((name) => module.renderedExports.includes(name));\n          if (!state.definers.has(id) || tag === undefined) continue;\n          this.error(\n            `gyral: an uncompiled ${tag} template remains in ${chunk.fileName}: something uses ` +\n              `${tag} from ${relative(root, id)} in a way the template compiler can't see (a ` +\n              `re-export, a dynamic import, or a module it doesn't process). With the ` +\n              `gyral-compiled condition the runtime preparer is left out, so that template ` +\n              `would throw. Import ${tag} straight from '@gyral/core' where you write templates ` +\n              `(view/01-templates.md \"Compiled\").`,\n          );\n        }\n      }\n    },\n  };\n}\n"]}

package/dist/compiler/loader-source.d.ts

@@ -0,0 +1,14 @@
+/** How a production build writes the loader (./components.ts). */
+export interface LoaderOptions {
+    /** Tags the app's entry defines: wait for registration and watch their shadow roots. */
+    readonly known?: readonly string[];
+}
+/**
+ * The loader: imports a tag's module the first time that tag is rendered, in the document or in
+ * the shadow root of a component it defined (now, or after a mutation, checked once per
+ * microtask), then forgets it. It registers itself on `globalThis[Symbol.for('gyral.components')]`
+ * so `componentsReady()` (core) can wait until every rendered tag it knows is defined.
+ * Shadow roots are observed by the one shared MutationObserver; a removed host's root is
+ * dropped from the scan and its registration is collected with it.
+ */
+export declare function loaderSource(tags: ReadonlyMap<string, string>, options?: LoaderOptions): string;

package/dist/compiler/loader-source.js

@@ -0,0 +1,86 @@
+// The component loader's source (./components.ts): a module that imports a tag's module the
+// first time that tag is in the document. No Node imports, so tests can run it in a browser.
+/**
+ * The loader: imports a tag's module the first time that tag is rendered, in the document or in
+ * the shadow root of a component it defined (now, or after a mutation, checked once per
+ * microtask), then forgets it. It registers itself on `globalThis[Symbol.for('gyral.components')]`
+ * so `componentsReady()` (core) can wait until every rendered tag it knows is defined.
+ * Shadow roots are observed by the one shared MutationObserver; a removed host's root is
+ * dropped from the scan and its registration is collected with it.
+ */
+export function loaderSource(tags, options = {}) {
+    const entries = [
+        ...[...tags].map(([tag, url]) => `  [${JSON.stringify(tag)}, () => import(${JSON.stringify(url)})],`),
+        ...(options.known ?? [])
+            .filter((tag) => !tags.has(tag))
+            .map((tag) => `  [${JSON.stringify(tag)}, () => Promise.resolve()],`),
+    ].join('\n');
+    const watched = [...new Set([...tags.keys(), ...(options.known ?? [])])].join(',');
+    return `// Generated by gyralVitePreset({ components: true }).
+const pending = new Map([
+${entries}
+]);
+const known = ${JSON.stringify(watched)};
+const roots = new Set();
+const inflight = new Set();
+let queued = false;
+const observer = new MutationObserver(() => {
+  if (!queued) {
+    queued = true;
+    queueMicrotask(scan);
+  }
+});
+function watch(root) {
+  for (const host of root.querySelectorAll(known)) {
+    const shadow = host.shadowRoot;
+    if (shadow !== null && !roots.has(shadow)) {
+      roots.add(shadow);
+      observer.observe(shadow, { childList: true, subtree: true });
+      watch(shadow);
+    }
+  }
+}
+function scan() {
+  queued = false;
+  for (const root of roots) if (!root.host.isConnected) roots.delete(root);
+  if (known !== '') {
+    watch(document);
+    for (const root of [...roots]) watch(root);
+  }
+  for (const [tag, load] of pending) {
+    if (customElements.get(tag) !== undefined) {
+      pending.delete(tag);
+      continue;
+    }
+    let found = document.querySelector(tag) !== null;
+    for (const root of roots) if (!found && root.querySelector(tag) !== null) found = true;
+    if (!found) continue;
+    pending.delete(tag);
+    const done = load()
+      .then(() => customElements.whenDefined(tag))
+      .then(() => {
+        // The upgraded host renders into its shadow root next: look there too.
+        if (!queued) {
+          queued = true;
+          queueMicrotask(scan);
+        }
+      })
+      .finally(() => inflight.delete(done));
+    inflight.add(done);
+  }
+  if (pending.size === 0) observer.disconnect();
+}
+async function ready() {
+  for (;;) {
+    scan();
+    if (inflight.size === 0) return;
+    await Promise.allSettled([...inflight]);
+    await new Promise((resolve) => setTimeout(resolve));
+  }
+}
+globalThis[Symbol.for('gyral.components')] = { ready };
+observer.observe(document.documentElement, { childList: true, subtree: true });
+scan();
+`;
+}
+//# sourceMappingURL=loader-source.js.map

package/dist/compiler/loader-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-source.js","sourceRoot":"","sources":["../../src/compiler/loader-source.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,6FAA6F;AAQ7F;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAiC,EACjC,UAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG;QACd,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CACd,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CACpF;QACD,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;aACrB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aAC/B,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,6BAA6B,CAAC;KACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnF,OAAO;;EAEP,OAAO;;gBAEO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DtC,CAAC;AACF,CAAC","sourcesContent":["// The component loader's source (./components.ts): a module that imports a tag's module the\n// first time that tag is in the document. No Node imports, so tests can run it in a browser.\n\n/** How a production build writes the loader (./components.ts). */\nexport interface LoaderOptions {\n  /** Tags the app's entry defines: wait for registration and watch their shadow roots. */\n  readonly known?: readonly string[];\n}\n\n/**\n * The loader: imports a tag's module the first time that tag is rendered, in the document or in\n * the shadow root of a component it defined (now, or after a mutation, checked once per\n * microtask), then forgets it. It registers itself on `globalThis[Symbol.for('gyral.components')]`\n * so `componentsReady()` (core) can wait until every rendered tag it knows is defined.\n * Shadow roots are observed by the one shared MutationObserver; a removed host's root is\n * dropped from the scan and its registration is collected with it.\n */\nexport function loaderSource(\n  tags: ReadonlyMap<string, string>,\n  options: LoaderOptions = {},\n): string {\n  const entries = [\n    ...[...tags].map(\n      ([tag, url]) => `  [${JSON.stringify(tag)}, () => import(${JSON.stringify(url)})],`,\n    ),\n    ...(options.known ?? [])\n      .filter((tag) => !tags.has(tag))\n      .map((tag) => `  [${JSON.stringify(tag)}, () => Promise.resolve()],`),\n  ].join('\\n');\n  const watched = [...new Set([...tags.keys(), ...(options.known ?? [])])].join(',');\n  return `// Generated by gyralVitePreset({ components: true }).\nconst pending = new Map([\n${entries}\n]);\nconst known = ${JSON.stringify(watched)};\nconst roots = new Set();\nconst inflight = new Set();\nlet queued = false;\nconst observer = new MutationObserver(() => {\n  if (!queued) {\n    queued = true;\n    queueMicrotask(scan);\n  }\n});\nfunction watch(root) {\n  for (const host of root.querySelectorAll(known)) {\n    const shadow = host.shadowRoot;\n    if (shadow !== null && !roots.has(shadow)) {\n      roots.add(shadow);\n      observer.observe(shadow, { childList: true, subtree: true });\n      watch(shadow);\n    }\n  }\n}\nfunction scan() {\n  queued = false;\n  for (const root of roots) if (!root.host.isConnected) roots.delete(root);\n  if (known !== '') {\n    watch(document);\n    for (const root of [...roots]) watch(root);\n  }\n  for (const [tag, load] of pending) {\n    if (customElements.get(tag) !== undefined) {\n      pending.delete(tag);\n      continue;\n    }\n    let found = document.querySelector(tag) !== null;\n    for (const root of roots) if (!found && root.querySelector(tag) !== null) found = true;\n    if (!found) continue;\n    pending.delete(tag);\n    const done = load()\n      .then(() => customElements.whenDefined(tag))\n      .then(() => {\n        // The upgraded host renders into its shadow root next: look there too.\n        if (!queued) {\n          queued = true;\n          queueMicrotask(scan);\n        }\n      })\n      .finally(() => inflight.delete(done));\n    inflight.add(done);\n  }\n  if (pending.size === 0) observer.disconnect();\n}\nasync function ready() {\n  for (;;) {\n    scan();\n    if (inflight.size === 0) return;\n    await Promise.allSettled([...inflight]);\n    await new Promise((resolve) => setTimeout(resolve));\n  }\n}\nglobalThis[Symbol.for('gyral.components')] = { ready };\nobserver.observe(document.documentElement, { childList: true, subtree: true });\nscan();\n`;\n}\n"]}

package/dist/compiler/locate.d.ts

@@ -0,0 +1,14 @@
+import type { Plugin } from 'vite';
+type Fn<H> = H extends {
+    handler: infer F;
+} ? F : H;
+type HookFn<K extends keyof Plugin> = Fn<NonNullable<Plugin[K]>>;
+export interface LocatorHooks {
+    readonly configResolved: HookFn<'configResolved'>;
+    readonly transform: HookFn<'transform'>;
+}
+/** Core's own view modules: always sources (core-internal templates, tests). */
+export declare const VIEW: string[];
+/** `sources`: as the compiler's (module specifiers whose `html` and `svg` are the view layer's tags). */
+export declare function createLocator(sources: readonly string[]): LocatorHooks;
+export {};

package/dist/compiler/locate.js

@@ -0,0 +1,78 @@
+// Development source locations for runtime templates (view/01-templates.md "Source locations",
+// gyral-g1r.24). `vite serve` (the dev server and Vitest) doesn't compile templates, and stack
+// traces point into Vite's transformed modules, whose lines aren't the author's. So the preset's
+// `gyral:template-locations` plugin (serve only, enforce: 'pre', loaded lazily like the
+// compiler) rewrites each html`…` call site of the configured sources into
+//   (html.at?.("src/app.ts:12:5") ?? html)`…`
+// (svg`…` call sites the same way, with svg.at) and the development runtime records that
+// position for the template (view/loc.ts). Nothing else changes and no line moves. Uses the
+// compiler can't follow (an aliased html) stay as they are: the runtime falls back to the stack
+// trace there.
+import { relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { langOf, nodeAt } from './ast.js';
+import { findUses, htmlImports } from './scan.js';
+import { Lines, splice } from './source.js';
+/** Core's own view modules: always sources (core-internal templates, tests). */
+export const VIEW = ['index', 'template'].flatMap((name) => ['.ts', '.js'].map((ext) => fileURLToPath(new URL(`../view/${name}${ext}`, import.meta.url))));
+const SCRIPT = /\.[cm]?[jt]sx?$/;
+/** `sources`: as the compiler's (module specifiers whose `html` and `svg` are the view layer's tags). */
+export function createLocator(sources) {
+    let root = '';
+    /** Resolved ids of the sources, per environment (resolution may differ between them). */
+    const resolved = new WeakMap();
+    return {
+        configResolved(config) {
+            root = config.root;
+        },
+        async transform(code, id) {
+            if (id.startsWith('\0') || !SCRIPT.test(id) || id.includes('/node_modules/'))
+                return null;
+            let program;
+            try {
+                program = this.parse(code, { lang: langOf(id) });
+            }
+            catch {
+                return null; // not ours to report
+            }
+            const { imports } = htmlImports(program);
+            if (imports.length === 0)
+                return null;
+            let ids = resolved.get(this.environment);
+            if (ids === undefined) {
+                ids = Promise.all(sources.map((s) => this.resolve(s, id))).then((rs) => new Set([...VIEW, ...rs.flatMap((r) => (r === null ? [] : [r.id]))]));
+                resolved.set(this.environment, ids);
+            }
+            const sourceIds = await ids;
+            const matched = [];
+            for (const binding of imports) {
+                const r = sources.includes(binding.specifier)
+                    ? null
+                    : await this.resolve(binding.specifier, id);
+                if (sources.includes(binding.specifier) || (r !== null && sourceIds.has(r.id))) {
+                    matched.push(binding);
+                }
+            }
+            if (matched.length === 0)
+                return null;
+            const { sites } = findUses(program, matched);
+            if (sites.length === 0)
+                return null;
+            const lines = new Lines(code);
+            const file = relative(root, id);
+            const edits = [];
+            for (const { node } of sites) {
+                const tag = nodeAt(node, 'tag');
+                if (tag === undefined)
+                    continue;
+                const { line, column } = lines.position(node.start);
+                const loc = JSON.stringify(`${file}:${String(line)}:${String(column + 1)}`);
+                const name = code.slice(tag.start, tag.end);
+                edits.push({ start: tag.start, end: tag.start, text: '(' });
+                edits.push({ start: tag.end, end: tag.end, text: `.at?.(${loc}) ?? ${name})` });
+            }
+            return splice(lines, edits, id);
+        },
+    };
+}
+//# sourceMappingURL=locate.js.map

package/dist/compiler/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/compiler/locate.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,iGAAiG;AACjG,wFAAwF;AACxF,2EAA2E;AAC3E,8CAA8C;AAC9C,yFAAyF;AACzF,4FAA4F;AAC5F,gGAAgG;AAChG,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAa,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAa,MAAM,aAAa,CAAC;AAUvD,gFAAgF;AAChF,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACzD,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAC9F,CAAC;AAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC;AAEjC,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,yFAAyF;IACzF,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAgC,CAAC;IAE7D,OAAO;QACL,cAAc,CAAC,MAAM;YACnB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE;YACtB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1F,IAAI,OAAa,CAAC;YAClB,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAoB,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC,CAAC,qBAAqB;YACpC,CAAC;YACD,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACtC,IAAI,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7D,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAC7E,CAAC;gBACF,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;YACtC,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC;YAC5B,MAAM,OAAO,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;gBAC9B,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;oBAC3C,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC/E,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,MAAM,KAAK,GAAW,EAAE,CAAC;YACzB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAChC,IAAI,GAAG,KAAK,SAAS;oBAAE,SAAS;gBAChC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,IAAI,GAAG,EAAE,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Development source locations for runtime templates (view/01-templates.md \"Source locations\",\n// gyral-g1r.24). `vite serve` (the dev server and Vitest) doesn't compile templates, and stack\n// traces point into Vite's transformed modules, whose lines aren't the author's. So the preset's\n// `gyral:template-locations` plugin (serve only, enforce: 'pre', loaded lazily like the\n// compiler) rewrites each html`…` call site of the configured sources into\n//   (html.at?.(\"src/app.ts:12:5\") ?? html)`…`\n// (svg`…` call sites the same way, with svg.at) and the development runtime records that\n// position for the template (view/loc.ts). Nothing else changes and no line moves. Uses the\n// compiler can't follow (an aliased html) stay as they are: the runtime falls back to the stack\n// trace there.\nimport { relative } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Plugin } from 'vite';\nimport { langOf, nodeAt, type Node } from './ast.js';\nimport { findUses, htmlImports } from './scan.js';\nimport { Lines, splice, type Edit } from './source.js';\n\ntype Fn<H> = H extends { handler: infer F } ? F : H;\ntype HookFn<K extends keyof Plugin> = Fn<NonNullable<Plugin[K]>>;\n\nexport interface LocatorHooks {\n  readonly configResolved: HookFn<'configResolved'>;\n  readonly transform: HookFn<'transform'>;\n}\n\n/** Core's own view modules: always sources (core-internal templates, tests). */\nexport const VIEW = ['index', 'template'].flatMap((name) =>\n  ['.ts', '.js'].map((ext) => fileURLToPath(new URL(`../view/${name}${ext}`, import.meta.url))),\n);\n\nconst SCRIPT = /\\.[cm]?[jt]sx?$/;\n\n/** `sources`: as the compiler's (module specifiers whose `html` and `svg` are the view layer's tags). */\nexport function createLocator(sources: readonly string[]): LocatorHooks {\n  let root = '';\n  /** Resolved ids of the sources, per environment (resolution may differ between them). */\n  const resolved = new WeakMap<object, Promise<Set<string>>>();\n\n  return {\n    configResolved(config) {\n      root = config.root;\n    },\n\n    async transform(code, id) {\n      if (id.startsWith('\\0') || !SCRIPT.test(id) || id.includes('/node_modules/')) return null;\n      let program: Node;\n      try {\n        program = this.parse(code, { lang: langOf(id) }) as unknown as Node;\n      } catch {\n        return null; // not ours to report\n      }\n      const { imports } = htmlImports(program);\n      if (imports.length === 0) return null;\n      let ids = resolved.get(this.environment);\n      if (ids === undefined) {\n        ids = Promise.all(sources.map((s) => this.resolve(s, id))).then(\n          (rs) => new Set([...VIEW, ...rs.flatMap((r) => (r === null ? [] : [r.id]))]),\n        );\n        resolved.set(this.environment, ids);\n      }\n      const sourceIds = await ids;\n      const matched = [];\n      for (const binding of imports) {\n        const r = sources.includes(binding.specifier)\n          ? null\n          : await this.resolve(binding.specifier, id);\n        if (sources.includes(binding.specifier) || (r !== null && sourceIds.has(r.id))) {\n          matched.push(binding);\n        }\n      }\n      if (matched.length === 0) return null;\n      const { sites } = findUses(program, matched);\n      if (sites.length === 0) return null;\n      const lines = new Lines(code);\n      const file = relative(root, id);\n      const edits: Edit[] = [];\n      for (const { node } of sites) {\n        const tag = nodeAt(node, 'tag');\n        if (tag === undefined) continue;\n        const { line, column } = lines.position(node.start);\n        const loc = JSON.stringify(`${file}:${String(line)}:${String(column + 1)}`);\n        const name = code.slice(tag.start, tag.end);\n        edits.push({ start: tag.start, end: tag.start, text: '(' });\n        edits.push({ start: tag.end, end: tag.end, text: `.at?.(${loc}) ?? ${name})` });\n      }\n      return splice(lines, edits, id);\n    },\n  };\n}\n"]}

package/dist/compiler/parse5-check.d.ts

@@ -10,7 +10,7 @@ interface Parse5Node {
     readonly content?: Parse5Node;
 }
 /**
- * Loads parse5 (`specifier`) as resolved from @gyral/core, else from the app's `root`;
+ * Loads parse5 (`specifier`) as resolved from `@gyral/core`, else from the app's `root`;
  * undefined when neither has it. `require` (Node loads ES modules with it too) rather than
  * `import()`: when core runs from source, this module is loaded by a Vite module runner that
  * is closed by the time the build starts.