@gyral/core 0.2.0 → 0.3.1

package/dist/vite.js

@@ -1,37 +1,329 @@
-// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md).
-// Plain data, no imports: safe to load from vite.config.ts and vitest.config.ts.
-/** Every Lit package: resolve exactly one copy, even when Gyral is linked from elsewhere. */
-export const LIT_PACKAGES = [
-    'lit',
-    'lit-html',
-    'lit-element',
-    '@lit/reactive-element',
-    '@lit-labs/ssr',
-    '@lit-labs/ssr-client',
-];
-/**
- * Lit modules that Gyral imports or re-exports. Pre-bundling them up front stops Vite from
- * discovering them mid-run, which reloads the page and fails the first browser test run.
- */
-export const LIT_PREBUNDLE = [
-    'lit',
-    'lit/directive.js',
-    'lit/static-html.js',
-    'lit/directives/class-map.js',
-    'lit/directives/keyed.js',
-    'lit/directives/live.js',
-    'lit/directives/repeat.js',
-    'lit/directives/style-map.js',
-];
+// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md):
+// the template compiler (view/01-templates.md "Compiled") and, in serve mode, development
+// output from the dev server's SSR (view/06-server.md "Development markers"). Only Node
+// built-ins are imported up front, so it loads from vite.config.ts and vitest.config.ts in any
+// way: bundled with the config, by Node from source (type stripping), or by a Vite module
+// 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(). 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). */
+const DEFAULT_TEMPLATE_SOURCES = ['@gyral/core'];
+/** The resolve condition that maps core's `#prepare` to its stub (ADR 0017's mechanism). */
+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). */
+const CLIENT_CONDITIONS = ['module', 'browser', 'development|production'];
+const SERVER_CONDITIONS = ['module', 'node', 'development|production'];
+/**
+ * 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, 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(condition)) {
+        config.resolve = { ...config.resolve, conditions: [...current, condition] };
+    }
+}
+/** 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
+            : typeof options.parse5 === 'string'
+                ? 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/${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/${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;
+}
+/** 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). */
+function gyralTemplateCompiler(options = {}) {
+    let hooks;
+    const ready = () => {
+        if (hooks === undefined)
+            throw new Error('gyral: the template compiler is not loaded yet');
+        return hooks;
+    };
+    return {
+        name: 'gyral:template-compiler',
+        enforce: 'pre',
+        apply: 'build',
+        configEnvironment: addCondition,
+        async configResolved(config) {
+            hooks = await loadHooks(options);
+            await hooks.configResolved.call(this, config);
+        },
+        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: {
+            // 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);
+            },
+        },
+        generateBundle(output, bundle, isWrite) {
+            return ready().generateBundle.call(this, output, bundle, isWrite);
+        },
+    };
+}
+/**
+ * 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',
+        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'));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The installed manifest of `name`, looked up from `root` the way Node does (no exports map). */
+function installed(root, name) {
+    for (let dir = root;; dir = dirname(dir)) {
+        const found = manifest(join(dir, 'node_modules', name, 'package.json'));
+        if (found !== undefined || dirname(dir) === dir)
+            return found;
+    }
+}
+/**
+ * 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.
+ */
+function gyralDependents(root) {
+    const app = manifest(join(root, 'package.json'));
+    const names = Object.keys({ ...app?.dependencies, ...app?.devDependencies });
+    return names.filter((name) => {
+        if (GYRAL_PACKAGES.test(name))
+            return false;
+        const dep = installed(root, name);
+        return Object.keys({ ...dep?.dependencies, ...dep?.peerDependencies }).some((d) => GYRAL_PACKAGES.test(d));
+    });
+}
+/**
+ * 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.
+ */
+function gyralDevSsr() {
+    let root = process.cwd();
+    return {
+        name: 'gyral:dev-server',
+        apply: 'serve',
+        config(config) {
+            root = resolve(config.root ?? process.cwd());
+        },
+        configEnvironment(name, config) {
+            const consumer = config.consumer ?? (name === 'client' ? 'client' : 'server');
+            if (consumer === 'client')
+                return undefined;
+            return { resolve: { noExternal: [GYRAL_PACKAGES, ...gyralDependents(root)] } };
+        },
+    };
+}
+/**
+ * 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:
  *
  *   export default defineConfig({ ...gyralVitePreset(), build: { … } });
+ *
+ * With plugins of your own, list both: `plugins: [...preset.plugins, mine()]`.
  */
 export function gyralVitePreset(options = {}) {
     return {
-        resolve: { dedupe: [...LIT_PACKAGES] },
-        optimizeDeps: { include: [...new Set([...LIT_PREBUNDLE, ...(options.optimize ?? [])])] },
+        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":"AAAA,+FAA+F;AAC/F,iFAAiF;AAEjF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,KAAK;IACL,UAAU;IACV,aAAa;IACb,uBAAuB;IACvB,eAAe;IACf,sBAAsB;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,KAAK;IACL,kBAAkB;IAClB,oBAAoB;IACpB,6BAA6B;IAC7B,yBAAyB;IACzB,wBAAwB;IACxB,0BAA0B;IAC1B,6BAA6B;CAC9B,CAAC;AAYF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,UAA4B,EAAE;IAC5D,OAAO;QACL,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE;QACtC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;KACzF,CAAC;AACJ,CAAC","sourcesContent":["// Vite / Vitest settings every Gyral app needs (gyral-a7r, docs/references/consumer-setup.md).\n// Plain data, no imports: safe to load from vite.config.ts and vitest.config.ts.\n\n/** Every Lit package: resolve exactly one copy, even when Gyral is linked from elsewhere. */\nexport const LIT_PACKAGES: readonly string[] = [\n  'lit',\n  'lit-html',\n  'lit-element',\n  '@lit/reactive-element',\n  '@lit-labs/ssr',\n  '@lit-labs/ssr-client',\n];\n\n/**\n * Lit modules that Gyral imports or re-exports. Pre-bundling them up front stops Vite from\n * discovering them mid-run, which reloads the page and fails the first browser test run.\n */\nexport const LIT_PREBUNDLE: readonly string[] = [\n  'lit',\n  'lit/directive.js',\n  'lit/static-html.js',\n  'lit/directives/class-map.js',\n  'lit/directives/keyed.js',\n  'lit/directives/live.js',\n  'lit/directives/repeat.js',\n  'lit/directives/style-map.js',\n];\n\nexport interface GyralViteOptions {\n  /** More modules to pre-bundle (e.g. 'lit/directives/unsafe-html.js'). */\n  readonly optimize?: readonly string[];\n}\n\nexport interface GyralViteConfig {\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 */\nexport function gyralVitePreset(options: GyralViteOptions = {}): GyralViteConfig {\n  return {\n    resolve: { dedupe: [...LIT_PACKAGES] },\n    optimizeDeps: { include: [...new Set([...LIT_PREBUNDLE, ...(options.optimize ?? [])])] },\n  };\n}\n"]}
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,0FAA0F;AAC1F,wFAAwF;AACxF,+FAA+F;AAC/F,0FAA0F;AAC1F,8FAA8F;AAC9F,4FAA4F;AAC5F,6FAA6F;AAC7F,uFAAuF;AACvF,6FAA6F;AAC7F,2CAA2C;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAsBzC,uFAAuF;AACvF,MAAM,wBAAwB,GAAsB,CAAC,aAAa,CAAC,CAAC;AAEpE,4FAA4F;AAC5F,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAC5C,2FAA2F;AAC3F,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAClD,oGAAoG;AACpG,MAAM,iBAAiB,GAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,wBAAwB,CAAC,CAAC;AAC7F,MAAM,iBAAiB,GAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAE1F;;;;GAIG;AACH,SAAS,YAAY,CACnB,IAAY,EACZ,MAA0B,EAC1B,GAAmD,EACnD,SAAS,GAAG,kBAAkB,EAC9B,UAAU,GAAG,KAAK;IAElB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,oBAAoB,KAAK,IAAI,CAAC;IAC1E,IAAI,UAAU,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/F,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,GAAG,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,YAAY,GAAG,aAAa,CAChC,IAAI,GAAG,CACL,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,EAC7E,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CACF,CAAC;AAEF,4EAA4E;AAC5E,SAAS,UAAU,CAAC,OAAgC;IAClD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,wBAAwB;QACpD,MAAM,EACJ,OAAO,CAAC,MAAM,KAAK,KAAK;YACtB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;gBAClC,CAAC,CAAC,OAAO,CAAC,MAAM;gBAChB,CAAC,CAAC,QAAQ;KACjB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAI,IAAY;IACzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,cAAc,IAAI,KAAK,CAAM,CAAC;IACnF,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,MAAM,CAA0B,CAAC;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,mDAAmD;IAC5F,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CACnC,aAAa,CAAC,IAAI,GAAG,CAAC,cAAc,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAChE,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAC1C,CAAC;IACF,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;;QACrD,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2CAA2C;AAC3C,KAAK,UAAU,SAAS,CAAC,OAAgC;IACvD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAuC,OAAO,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,qEAAqE;AACrE,SAAS,qBAAqB,CAAC,UAAmC,EAAE;IAClE,IAAI,KAAgC,CAAC;IACrC,MAAM,KAAK,GAAG,GAAkB,EAAE;QAChC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC3F,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO;QACd,iBAAiB,EAAE,YAAY;QAC/B,KAAK,CAAC,cAAc,CAAC,MAAM;YACzB,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,UAAU,CAAC,KAAK;YACd,OAAO,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QACD,4EAA4E;QAC5E,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI;YAC9B,OAAO,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,EAAE,EAAE,IAAI;YACX,OAAO,KAAK,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,SAAS,EAAE;YACT,uFAAuF;YACvF,uEAAuE;YACvE,MAAM,EAAE;gBACN,EAAE,EAAE,iBAAiB;gBACrB,IAAI,EAAE,wFAAwF;aAC/F;YACD,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI;gBACpB,OAAO,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YACtD,CAAC;SACF;QACD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO;YACpC,OAAO,KAAK,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,UAAmC,EAAE;IACnE,IAAI,KAA+B,CAAC;IACpC,MAAM,KAAK,GAAG,GAAiB,EAAE;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC1F,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO;QACd,KAAK,CAAC,cAAc,CAAC,MAAM;YACzB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAwC,QAAQ,CAAC,CAAC;YACnF,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,SAAS,EAAE;YACT,yEAAyE;YACzE,MAAM,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,EAAE;YACnD,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI;gBACpB,OAAO,KAAK,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YACtD,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,cAAc,GAAG,WAAW,CAAC;AAInC,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,KAAK,IAAI,GAAG,GAAG,IAAI,GAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG;YAAE,OAAO,KAAK,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,GAAG,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAChF,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CACvB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,WAAW;IAClB,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,OAAO;QACd,MAAM,CAAC,MAAM;YACX,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,iBAAiB,CAAC,IAAI,EAAE,MAAM;YAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC9E,IAAI,QAAQ,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAC5C,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,cAAc,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,eAAe;IACtB,IAAI,KAA+B,CAAC;IACpC,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,KAAK;QACd,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;YACjC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,MAAM;YACzB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YACnB,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;gBAAE,OAAO;YACvC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAA0C,UAAU,CAAC,CAAC;YACzF,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,CAAC,UAAU;YACd,MAAM,KAAK,EAAE,UAAU,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;QACtF,CAAC;QACD,SAAS,CAAC,MAAM;YACd,OAAO,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,EAAE;YACL,OAAO,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;QACjC,CAAC;QACD,SAAS,EAAE;YACT,4EAA4E;YAC5E,MAAM,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,2CAA2C,EAAE;YACpF,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;gBACpB,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC;gBACtF,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE;oBAC3C,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;oBACjD,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC;iBAC9D,CAAC,CAAC;gBACH,iFAAiF;gBACjF,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YACrE,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAUD;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,OAA4B;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC5C,CAAC,CAAC,uBAAuB;QACzB,CAAC,CAAC,uBAAuB,CAAC;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAA2C,CAAC;IAChG,OAAO,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AA2CD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAA4B,EAAE;IAC5D,OAAO;QACL,OAAO,EAAE;YACP,yFAAyF;YACzF,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC;YACvC,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxC,WAAW,EAAE;YACb,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK;gBAClE,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;YAC7E,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;SAC7E;QACD,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE;KAChE,CAAC;AACJ,CAAC;AAID;;;GAGG;AACH,SAAS,eAAe,CAAC,OAA0B;IACjD,IAAI,IAAwB,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,IAAkB,EAAE,EAAE,CACjC,UAAyB,GAAG,IAAe;QACzC,MAAM,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAqB,CAAC;QAC9C,OAAO,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC,CAAC;IACJ,MAAM,IAAI,GAAG,CAAyB,IAAO,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAA2B,CAAC;IACtF,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,GAAG,EAAE;YACH,IAAI,EAAE,GAAgC,EAAE,CACrC,IAAI,EAAE,GAAgE,EAAE,IAAI,EAAE,EAAE;gBACjF,IAAI,GAAG,EAAE;SACZ;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;YAClB,MAAM,UAAU,GACd,MAAM,YAAY,CAA4C,YAAY,CAAC,CAAC;YAC9E,IAAI,GAAG,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAc,CAAC;QACtD,CAAC;QACD,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACtC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC;QAC9B,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC;QACxC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;KACvC,CAAC;AACJ,CAAC","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    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 (gyral-1zd.25). */\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()`, view/07-hydration.md \"Client-only builds\"). 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"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gyral/core",
-  "version": "0.2.0",
-  "description": "Gyral core: Model-View-Intent web components on Lit and the web platform. Inspired by Cycle.js.",
+  "version": "0.3.1",
+  "description": "Gyral core: Model-View-Intent web components on the web platform, with their own view layer.",
   "license": "MIT",
   "author": "Mike Zupper",
   "homepage": "https://github.com/gyraljs/gyral/tree/main/packages/core#readme",
@@ -14,21 +14,72 @@
     "url": "https://github.com/gyraljs/gyral/issues"
   },
   "type": "module",
+  "bin": {
+    "gyral-types": "./dist/cli/gyral-types.js"
+  },
   "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./internal/server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    },
     "./vite": {
       "types": "./dist/vite.d.ts",
       "default": "./dist/vite.js"
+    },
+    "./compiled": {
+      "types": "./dist/view/compiled.d.ts",
+      "default": "./dist/view/compiled.js"
+    },
+    "./eslint": {
+      "types": "./dist/eslint/index.d.ts",
+      "default": "./dist/eslint/index.js"
+    },
+    "./errors.json": "./dist/errors.json",
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "default": "./dist/storage.js"
+    },
+    "./indexeddb": {
+      "types": "./dist/indexeddb.d.ts",
+      "default": "./dist/indexeddb.js"
     }
   },
   "imports": {
     "#devtools": {
       "development": "./dist/devtools.js",
       "default": "./dist/devtools-off.js"
+    },
+    "#prepare": {
+      "gyral-compiled": "./dist/view/prepare-stub.js",
+      "default": "./dist/view/prepare.js"
+    },
+    "#view-dev": {
+      "development": "./dist/view/dev.js",
+      "default": "./dist/view/dev-off.js"
+    },
+    "#hydration-loader": {
+      "gyral-client-only": "./dist/hydration-off.js",
+      "default": "./dist/hydration-loader.js"
+    },
+    "#invoker-fallback": {
+      "gyral-client-only": {
+        "development": "./dist/invoker-fallback.js",
+        "default": "./dist/invoker-fallback-used.js"
+      },
+      "default": "./dist/invoker-fallback.js"
+    },
+    "#spec-features": {
+      "gyral-compiled": "./dist/spec-features-used.js",
+      "default": "./dist/spec-features.js"
     }
   },
   "files": [
@@ -42,10 +93,25 @@
     "@standard-schema/spec": "1.1.0"
   },
   "peerDependencies": {
-    "lit": "^3.3.0"
+    "eslint": "^9.0.0 || ^10.0.0",
+    "parse5": "^7.0.0 || ^8.0.0",
+    "vite": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    },
+    "parse5": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "lit": "3.3.3"
+    "eslint": "10.12.0",
+    "parse5": "8.0.1",
+    "vite": "8.3.2"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"

package/dist/accessible-name.d.ts

@@ -1,19 +0,0 @@
-import { ElementDirective } from './element-directive.js';
-/** The element with `id`, searched from `from`'s own root outward to the document. */
-export declare function findInScope(from: Element, id: string): Element | null;
-/**
- * Names the element after the element with `id`, even outside this component's shadow root:
- *
- *   <form aria-label=${props.label} ${labelledBy('page-title')}>
- *
- * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name
- * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the
- * target's text. Element directives don't run on the server, so render a plain `aria-label` too
- * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.
- */
-declare class LabelledBy extends ElementDirective<[id: string, fallback?: string]> {
-    #private;
-    apply(el: Element, [id, fallback]: [id: string, fallback?: string]): void;
-}
-export declare const labelledBy: (id: string, fallback?: string | undefined) => import("lit/directive.js").DirectiveResult<typeof LabelledBy>;
-export {};

package/dist/accessible-name.js

@@ -1,56 +0,0 @@
-// Accessible names across shadow boundaries (gyral-czi.26). `aria-labelledby="page-title"` inside
-// a shadow root can't see an id in the page, so a form or landmark in a component would be
-// nameless. `labelledBy(id)` resolves the id outward through the shadow-including ancestors.
-import { directive } from 'lit/directive.js';
-import { ElementDirective } from './element-directive.js';
-/** ARIA element reflection: newly available Baseline, so feature-detected (ADR 0003). */
-const reflects = (el) => 'ariaLabelledByElements' in el;
-/** The element with `id`, searched from `from`'s own root outward to the document. */
-export function findInScope(from, id) {
-    for (let root = from.getRootNode();;) {
-        const found = 'getElementById' in root ? root.getElementById(id) : null;
-        if (found !== null && found !== from)
-            return found;
-        if (!(root instanceof ShadowRoot))
-            return null;
-        root = root.host.getRootNode();
-    }
-}
-/**
- * Names the element after the element with `id`, even outside this component's shadow root:
- *
- *   <form aria-label=${props.label} ${labelledBy('page-title')}>
- *
- * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name
- * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the
- * target's text. Element directives don't run on the server, so render a plain `aria-label` too
- * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.
- */
-class LabelledBy extends ElementDirective {
-    #applied = '';
-    apply(el, [id, fallback]) {
-        const key = `${id}\u0000${fallback ?? ''}`;
-        if (key === this.#applied)
-            return;
-        this.#applied = key;
-        // The labelling element may render after this one (a later sibling); try again once.
-        if (!this.#name(el, id, fallback)) {
-            queueMicrotask(() => {
-                this.#name(el, id, fallback);
-            });
-        }
-    }
-    #name(el, id, fallback) {
-        const target = findInScope(el, id);
-        if (target !== null && reflects(el)) {
-            el.ariaLabelledByElements = [target];
-            return true;
-        }
-        const text = fallback ?? target?.textContent.trim() ?? '';
-        if (text !== '')
-            el.setAttribute('aria-label', text);
-        return target !== null;
-    }
-}
-export const labelledBy = directive(LabelledBy);
-//# sourceMappingURL=accessible-name.js.map

package/dist/accessible-name.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"accessible-name.js","sourceRoot":"","sources":["../src/accessible-name.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,2FAA2F;AAC3F,6FAA6F;AAC7F,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM1D,yFAAyF;AACzF,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAoB,EAAE,CAAC,wBAAwB,IAAI,EAAE,CAAC;AAEnF,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,EAAU;IACnD,KAAK,IAAI,IAAI,GAAS,IAAI,CAAC,WAAW,EAAE,IAAK,CAAC;QAC5C,MAAM,KAAK,GAAG,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAE,IAAyB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACnD,IAAI,CAAC,CAAC,IAAI,YAAY,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;AACH,CAAC;AAID;;;;;;;;;GASG;AACH,MAAM,UAAW,SAAQ,gBAAiD;IACxE,QAAQ,GAAG,EAAE,CAAC;IAEd,KAAK,CAAC,EAAW,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAkC;QAChE,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,GAAG,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAClC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,qFAAqF;QACrF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC;YAClC,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,EAAW,EAAE,EAAU,EAAE,QAA4B;QACzD,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,EAAE,CAAC,sBAAsB,GAAG,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,IAAI,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAC1D,IAAI,IAAI,KAAK,EAAE;YAAE,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,MAAM,KAAK,IAAI,CAAC;IACzB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC","sourcesContent":["// Accessible names across shadow boundaries (gyral-czi.26). `aria-labelledby=\"page-title\"` inside\n// a shadow root can't see an id in the page, so a form or landmark in a component would be\n// nameless. `labelledBy(id)` resolves the id outward through the shadow-including ancestors.\nimport { directive } from 'lit/directive.js';\nimport { ElementDirective } from './element-directive.js';\n\ninterface Reflecting extends Element {\n  ariaLabelledByElements: readonly Element[] | null;\n}\n\n/** ARIA element reflection: newly available Baseline, so feature-detected (ADR 0003). */\nconst reflects = (el: Element): el is Reflecting => 'ariaLabelledByElements' in el;\n\n/** The element with `id`, searched from `from`'s own root outward to the document. */\nexport function findInScope(from: Element, id: string): Element | null {\n  for (let root: Node = from.getRootNode(); ;) {\n    const found = 'getElementById' in root ? (root as DocumentOrShadow).getElementById(id) : null;\n    if (found !== null && found !== from) return found;\n    if (!(root instanceof ShadowRoot)) return null;\n    root = root.host.getRootNode();\n  }\n}\n\ntype DocumentOrShadow = Document | ShadowRoot;\n\n/**\n * Names the element after the element with `id`, even outside this component's shadow root:\n *\n *   <form aria-label=${props.label} ${labelledBy('page-title')}>\n *\n * Uses `ariaLabelledByElements` (ARIA element reflection) where the browser has it, so the name\n * stays in sync with the heading. Elsewhere it sets `aria-label` from `fallback`, or from the\n * target's text. Element directives don't run on the server, so render a plain `aria-label` too\n * (from a `label` prop) for the no-JS page: `aria-labelledby` wins over it once set.\n */\nclass LabelledBy extends ElementDirective<[id: string, fallback?: string]> {\n  #applied = '';\n\n  apply(el: Element, [id, fallback]: [id: string, fallback?: string]): void {\n    const key = `${id}\\u0000${fallback ?? ''}`;\n    if (key === this.#applied) return;\n    this.#applied = key;\n    // The labelling element may render after this one (a later sibling); try again once.\n    if (!this.#name(el, id, fallback)) {\n      queueMicrotask(() => {\n        this.#name(el, id, fallback);\n      });\n    }\n  }\n\n  #name(el: Element, id: string, fallback: string | undefined): boolean {\n    const target = findInScope(el, id);\n    if (target !== null && reflects(el)) {\n      el.ariaLabelledByElements = [target];\n      return true;\n    }\n    const text = fallback ?? target?.textContent.trim() ?? '';\n    if (text !== '') el.setAttribute('aria-label', text);\n    return target !== null;\n  }\n}\n\nexport const labelledBy = directive(LabelledBy);\n"]}