@gyral/core 0.2.0 → 0.3.1

package/dist/compiler/scope.js

@@ -0,0 +1,116 @@
+// Which modules the build-time feature scan reads (features.ts, view/05-element.md "Features
+// register themselves"): only those that can affect Gyral components. A module outside
+// node_modules (the app's own source, a workspace or `link:` package) always can. An installed
+// package can only if it is a Gyral package or depends on one, directly or through its own
+// dependencies (a design system, a component library): a package that never reaches
+// `@gyral/*` can't import `define`, `html` or `raw`, so it can't define a component, render a
+// template or set a spec field (effect, three and the like). The manifests are read from disk
+// the way Node finds packages (no exports map), once per build.
+import { readFileSync, realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Gyral's packages (vite.ts has the same pattern for the dev server's dependents). */
+const GYRAL_PACKAGES = /^@gyral\//;
+/** The last `node_modules` directory in a path, and what follows it. */
+const IN_NODE_MODULES = /^(.*[\\/]node_modules[\\/])((?:@[^\\/]+[\\/])?[^\\/]+)[\\/]/;
+function read(file) {
+    try {
+        const value = JSON.parse(readFileSync(file, 'utf8'));
+        return typeof value === 'object' && value !== null ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The installed package `name` as seen from `dir` (Node's lookup), as a real path. */
+function locate(dir, name) {
+    for (let d = dir;; d = dirname(d)) {
+        const candidate = join(d, 'node_modules', name);
+        if (read(join(candidate, 'package.json')) !== undefined) {
+            try {
+                return realpathSync(candidate);
+            }
+            catch {
+                return candidate;
+            }
+        }
+        if (dirname(d) === d)
+            return undefined;
+    }
+}
+const dependencyNames = (m) => Object.keys({ ...m.dependencies, ...m.peerDependencies, ...m.optionalDependencies });
+/** A scope for one build: manifests and answers are cached per package directory. */
+export function createScope() {
+    const reaches = new Map();
+    const names = new Map();
+    /** Whether the package in `dir`, or any package it depends on, is a Gyral package. */
+    function reachesGyral(dir) {
+        const known = reaches.get(dir);
+        if (known !== undefined)
+            return known;
+        // A walk of the dependency graph from `dir` (cycles are fine: each package is read once).
+        const seen = new Set([dir]);
+        const queue = [dir];
+        let found = false;
+        for (let next = queue.pop(); next !== undefined && !found; next = queue.pop()) {
+            const m = read(join(next, 'package.json'));
+            if (m === undefined) {
+                found = next === dir; // the module's own package can't be read: scan it
+                continue;
+            }
+            const deps = dependencyNames(m);
+            if ((typeof m.name === 'string' && GYRAL_PACKAGES.test(m.name)) ||
+                deps.some((d) => GYRAL_PACKAGES.test(d))) {
+                found = true;
+                break;
+            }
+            for (const d of deps) {
+                const at = locate(next, d);
+                if (at === undefined || seen.has(at))
+                    continue;
+                if (reaches.get(at) === true) {
+                    found = true;
+                    break;
+                }
+                seen.add(at);
+                queue.push(at);
+            }
+        }
+        // Not found: the whole graph from `dir` was read, and no package in it reaches Gyral.
+        if (!found)
+            for (const s of seen)
+                reaches.set(s, false);
+        reaches.set(dir, found);
+        return found;
+    }
+    /** The `name` of the nearest package.json above `file` that has one. */
+    function nameAbove(file) {
+        const dir = dirname(file);
+        if (names.has(dir))
+            return names.get(dir);
+        const name = read(join(dir, 'package.json'))?.name;
+        const result = typeof name === 'string' ? name : dirname(dir) === dir ? undefined : nameAbove(dir);
+        names.set(dir, result);
+        return result;
+    }
+    return {
+        inScope(id) {
+            const installed = IN_NODE_MODULES.exec(id);
+            if (installed === null)
+                return true;
+            const dir = (installed[1] ?? '') + (installed[2] ?? '');
+            let real = dir;
+            try {
+                real = realpathSync(dir);
+            }
+            catch {
+                // keep the path as given
+            }
+            return reachesGyral(real);
+        },
+        packageOf(id) {
+            const installed = IN_NODE_MODULES.exec(id);
+            return installed === null ? nameAbove(id) : installed[2]?.replace(/\\/g, '/');
+        },
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/compiler/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/compiler/scope.ts"],"names":[],"mappings":"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","sourcesContent":["// Which modules the build-time feature scan reads (features.ts, view/05-element.md \"Features\n// register themselves\"): only those that can affect Gyral components. A module outside\n// node_modules (the app's own source, a workspace or `link:` package) always can. An installed\n// package can only if it is a Gyral package or depends on one, directly or through its own\n// dependencies (a design system, a component library): a package that never reaches\n// `@gyral/*` can't import `define`, `html` or `raw`, so it can't define a component, render a\n// template or set a spec field (effect, three and the like). The manifests are read from disk\n// the way Node finds packages (no exports map), once per build.\nimport { readFileSync, realpathSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\n/** Gyral's packages (vite.ts has the same pattern for the dev server's dependents). */\nconst GYRAL_PACKAGES = /^@gyral\\//;\n/** The last `node_modules` directory in a path, and what follows it. */\nconst IN_NODE_MODULES = /^(.*[\\\\/]node_modules[\\\\/])((?:@[^\\\\/]+[\\\\/])?[^\\\\/]+)[\\\\/]/;\n\ninterface Manifest {\n  readonly name?: unknown;\n  readonly dependencies?: object;\n  readonly peerDependencies?: object;\n  readonly optionalDependencies?: object;\n}\n\nfunction read(file: string): Manifest | undefined {\n  try {\n    const value: unknown = JSON.parse(readFileSync(file, 'utf8'));\n    return typeof value === 'object' && value !== null ? value : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** The installed package `name` as seen from `dir` (Node's lookup), as a real path. */\nfunction locate(dir: string, name: string): string | undefined {\n  for (let d = dir; ; d = dirname(d)) {\n    const candidate = join(d, 'node_modules', name);\n    if (read(join(candidate, 'package.json')) !== undefined) {\n      try {\n        return realpathSync(candidate);\n      } catch {\n        return candidate;\n      }\n    }\n    if (dirname(d) === d) return undefined;\n  }\n}\n\nconst dependencyNames = (m: Manifest): string[] =>\n  Object.keys({ ...m.dependencies, ...m.peerDependencies, ...m.optionalDependencies });\n\nexport interface Scope {\n  /** Whether module `id` can affect Gyral components, so the scan must read it. */\n  inScope(id: string): boolean;\n  /** The name of the package module `id` belongs to (`@gyral/core` is where `raw` comes from). */\n  packageOf(id: string): string | undefined;\n}\n\n/** A scope for one build: manifests and answers are cached per package directory. */\nexport function createScope(): Scope {\n  const reaches = new Map<string, boolean>();\n  const names = new Map<string, string | undefined>();\n\n  /** Whether the package in `dir`, or any package it depends on, is a Gyral package. */\n  function reachesGyral(dir: string): boolean {\n    const known = reaches.get(dir);\n    if (known !== undefined) return known;\n    // A walk of the dependency graph from `dir` (cycles are fine: each package is read once).\n    const seen = new Set([dir]);\n    const queue = [dir];\n    let found = false;\n    for (let next = queue.pop(); next !== undefined && !found; next = queue.pop()) {\n      const m = read(join(next, 'package.json'));\n      if (m === undefined) {\n        found = next === dir; // the module's own package can't be read: scan it\n        continue;\n      }\n      const deps = dependencyNames(m);\n      if (\n        (typeof m.name === 'string' && GYRAL_PACKAGES.test(m.name)) ||\n        deps.some((d) => GYRAL_PACKAGES.test(d))\n      ) {\n        found = true;\n        break;\n      }\n      for (const d of deps) {\n        const at = locate(next, d);\n        if (at === undefined || seen.has(at)) continue;\n        if (reaches.get(at) === true) {\n          found = true;\n          break;\n        }\n        seen.add(at);\n        queue.push(at);\n      }\n    }\n    // Not found: the whole graph from `dir` was read, and no package in it reaches Gyral.\n    if (!found) for (const s of seen) reaches.set(s, false);\n    reaches.set(dir, found);\n    return found;\n  }\n\n  /** The `name` of the nearest package.json above `file` that has one. */\n  function nameAbove(file: string): string | undefined {\n    const dir = dirname(file);\n    if (names.has(dir)) return names.get(dir);\n    const name = read(join(dir, 'package.json'))?.name;\n    const result =\n      typeof name === 'string' ? name : dirname(dir) === dir ? undefined : nameAbove(dir);\n    names.set(dir, result);\n    return result;\n  }\n\n  return {\n    inScope(id) {\n      const installed = IN_NODE_MODULES.exec(id);\n      if (installed === null) return true;\n      const dir = (installed[1] ?? '') + (installed[2] ?? '');\n      let real = dir;\n      try {\n        real = realpathSync(dir);\n      } catch {\n        // keep the path as given\n      }\n      return reachesGyral(real);\n    },\n    packageOf(id) {\n      const installed = IN_NODE_MODULES.exec(id);\n      return installed === null ? nameAbove(id) : installed[2]?.replace(/\\\\/g, '/');\n    },\n  };\n}\n"]}

package/dist/compiler/source.d.ts

@@ -0,0 +1,34 @@
+export interface Position {
+    /** 1-based. */
+    readonly line: number;
+    /** 0-based. */
+    readonly column: number;
+}
+export declare class Lines {
+    readonly code: string;
+    private readonly starts;
+    constructor(code: string);
+    position(offset: number): Position;
+    /** Two lines of context around `offset`, with a caret under it (Vite prints it). */
+    frame(offset: number, end?: number): string;
+}
+export interface Edit {
+    readonly start: number;
+    readonly end: number;
+    readonly text: string;
+}
+export interface SourceMap {
+    readonly version: 3;
+    readonly sources: string[];
+    readonly names: string[];
+    readonly mappings: string;
+}
+/**
+ * Applies non-overlapping `edits` to `lines.code` and maps the result back to it: a segment at
+ * the start of every output line and at every edit boundary (line-level precision, like
+ * magic-string without `hires`).
+ */
+export declare function splice(lines: Lines, edits: readonly Edit[], file: string): {
+    code: string;
+    map: SourceMap;
+};

package/dist/compiler/source.js

@@ -0,0 +1,114 @@
+// Module text helpers for the template compiler: offsets to line/column, code frames for build
+// errors, and string splicing with a source map (no magic-string: @gyral/core has no runtime
+// dependencies, and Vite doesn't expose one to plugins).
+export class Lines {
+    constructor(code) {
+        this.code = code;
+        this.starts = [0];
+        for (let k = code.indexOf('\n'); k !== -1; k = code.indexOf('\n', k + 1)) {
+            this.starts.push(k + 1);
+        }
+    }
+    position(offset) {
+        let lo = 0;
+        let hi = this.starts.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if ((this.starts[mid] ?? 0) <= offset)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return { line: lo + 1, column: offset - (this.starts[lo] ?? 0) };
+    }
+    /** Two lines of context around `offset`, with a caret under it (Vite prints it). */
+    frame(offset, end = offset + 1) {
+        const { line, column } = this.position(offset);
+        const lines = this.code.split('\n');
+        const first = Math.max(1, line - 2);
+        const last = Math.min(lines.length, line + 2);
+        const width = String(last).length;
+        const out = [];
+        for (let n = first; n <= last; n++) {
+            const text = lines[n - 1] ?? '';
+            out.push(`${n === line ? '>' : ' '} ${String(n).padStart(width)} | ${text}`);
+            if (n === line) {
+                const span = Math.max(1, Math.min(end - offset, text.length - column));
+                out.push(`  ${' '.repeat(width)} | ${' '.repeat(column)}${'^'.repeat(span)}`);
+            }
+        }
+        return out.join('\n');
+    }
+}
+const B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+function vlq(value) {
+    let v = value < 0 ? (-value << 1) | 1 : value << 1;
+    let out = '';
+    do {
+        let digit = v & 31;
+        v >>>= 5;
+        if (v > 0)
+            digit |= 32;
+        out += B64[digit] ?? '';
+    } while (v > 0);
+    return out;
+}
+/**
+ * Applies non-overlapping `edits` to `lines.code` and maps the result back to it: a segment at
+ * the start of every output line and at every edit boundary (line-level precision, like
+ * magic-string without `hires`).
+ */
+export function splice(lines, edits, file) {
+    const { code } = lines;
+    const sorted = [...edits].sort((a, b) => a.start - b.start);
+    let out = '';
+    const mapLines = [[]];
+    let genCol = 0;
+    let prev = { line: 0, column: 0 };
+    let prevGenCol = 0;
+    const mark = (offset) => {
+        const { line, column } = lines.position(offset);
+        const at = { line: line - 1, column };
+        const row = mapLines.at(-1);
+        if (row === undefined)
+            return;
+        if (row.length === 0)
+            prevGenCol = 0;
+        row.push(vlq(genCol - prevGenCol) + 'A' + vlq(at.line - prev.line) + vlq(at.column - prev.column));
+        prevGenCol = genCol;
+        prev = at;
+    };
+    const write = (text, origin, original) => {
+        let from = 0;
+        mark(origin);
+        for (let nl = text.indexOf('\n'); nl !== -1; nl = text.indexOf('\n', from)) {
+            out += text.slice(from, nl + 1);
+            from = nl + 1;
+            mapLines.push([]);
+            genCol = 0;
+            mark(original ? origin + from : origin);
+        }
+        out += text.slice(from);
+        genCol += text.length - from;
+    };
+    let pos = 0;
+    for (const edit of sorted) {
+        if (edit.start > pos)
+            write(code.slice(pos, edit.start), pos, true);
+        if (edit.text !== '')
+            write(edit.text, edit.start, false);
+        pos = Math.max(pos, edit.end);
+    }
+    if (pos < code.length)
+        write(code.slice(pos), pos, true);
+    return {
+        code: out,
+        map: {
+            version: 3,
+            sources: [file],
+            names: [],
+            mappings: mapLines.map((r) => r.join(',')).join(';'),
+        },
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/compiler/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/compiler/source.ts"],"names":[],"mappings":"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","sourcesContent":["// Module text helpers for the template compiler: offsets to line/column, code frames for build\n// errors, and string splicing with a source map (no magic-string: @gyral/core has no runtime\n// dependencies, and Vite doesn't expose one to plugins).\n\nexport interface Position {\n  /** 1-based. */\n  readonly line: number;\n  /** 0-based. */\n  readonly column: number;\n}\n\nexport class Lines {\n  private readonly starts: number[] = [0];\n\n  constructor(readonly code: string) {\n    for (let k = code.indexOf('\\n'); k !== -1; k = code.indexOf('\\n', k + 1)) {\n      this.starts.push(k + 1);\n    }\n  }\n\n  position(offset: number): Position {\n    let lo = 0;\n    let hi = this.starts.length - 1;\n    while (lo < hi) {\n      const mid = (lo + hi + 1) >> 1;\n      if ((this.starts[mid] ?? 0) <= offset) lo = mid;\n      else hi = mid - 1;\n    }\n    return { line: lo + 1, column: offset - (this.starts[lo] ?? 0) };\n  }\n\n  /** Two lines of context around `offset`, with a caret under it (Vite prints it). */\n  frame(offset: number, end = offset + 1): string {\n    const { line, column } = this.position(offset);\n    const lines = this.code.split('\\n');\n    const first = Math.max(1, line - 2);\n    const last = Math.min(lines.length, line + 2);\n    const width = String(last).length;\n    const out: string[] = [];\n    for (let n = first; n <= last; n++) {\n      const text = lines[n - 1] ?? '';\n      out.push(`${n === line ? '>' : ' '} ${String(n).padStart(width)} | ${text}`);\n      if (n === line) {\n        const span = Math.max(1, Math.min(end - offset, text.length - column));\n        out.push(`  ${' '.repeat(width)} | ${' '.repeat(column)}${'^'.repeat(span)}`);\n      }\n    }\n    return out.join('\\n');\n  }\n}\n\nexport interface Edit {\n  readonly start: number;\n  readonly end: number;\n  readonly text: string;\n}\n\nexport interface SourceMap {\n  readonly version: 3;\n  readonly sources: string[];\n  readonly names: string[];\n  readonly mappings: string;\n}\n\nconst B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\nfunction vlq(value: number): string {\n  let v = value < 0 ? (-value << 1) | 1 : value << 1;\n  let out = '';\n  do {\n    let digit = v & 31;\n    v >>>= 5;\n    if (v > 0) digit |= 32;\n    out += B64[digit] ?? '';\n  } while (v > 0);\n  return out;\n}\n\n/**\n * Applies non-overlapping `edits` to `lines.code` and maps the result back to it: a segment at\n * the start of every output line and at every edit boundary (line-level precision, like\n * magic-string without `hires`).\n */\nexport function splice(\n  lines: Lines,\n  edits: readonly Edit[],\n  file: string,\n): { code: string; map: SourceMap } {\n  const { code } = lines;\n  const sorted = [...edits].sort((a, b) => a.start - b.start);\n  let out = '';\n  const mapLines: string[][] = [[]];\n  let genCol = 0;\n  let prev = { line: 0, column: 0 };\n  let prevGenCol = 0;\n\n  const mark = (offset: number): void => {\n    const { line, column } = lines.position(offset);\n    const at = { line: line - 1, column };\n    const row = mapLines.at(-1);\n    if (row === undefined) return;\n    if (row.length === 0) prevGenCol = 0;\n    row.push(\n      vlq(genCol - prevGenCol) + 'A' + vlq(at.line - prev.line) + vlq(at.column - prev.column),\n    );\n    prevGenCol = genCol;\n    prev = at;\n  };\n\n  const write = (text: string, origin: number, original: boolean): void => {\n    let from = 0;\n    mark(origin);\n    for (let nl = text.indexOf('\\n'); nl !== -1; nl = text.indexOf('\\n', from)) {\n      out += text.slice(from, nl + 1);\n      from = nl + 1;\n      mapLines.push([]);\n      genCol = 0;\n      mark(original ? origin + from : origin);\n    }\n    out += text.slice(from);\n    genCol += text.length - from;\n  };\n\n  let pos = 0;\n  for (const edit of sorted) {\n    if (edit.start > pos) write(code.slice(pos, edit.start), pos, true);\n    if (edit.text !== '') write(edit.text, edit.start, false);\n    pos = Math.max(pos, edit.end);\n  }\n  if (pos < code.length) write(code.slice(pos), pos, true);\n  return {\n    code: out,\n    map: {\n      version: 3,\n      sources: [file],\n      names: [],\n      mappings: mapLines.map((r) => r.join(',')).join(';'),\n    },\n  };\n}\n"]}

package/dist/compiler/tag-map.d.ts

@@ -0,0 +1,41 @@
+import type { Plugin } from 'vite';
+import type { ElementTypesOptions } from '../vite.js';
+export interface TagMapOptions {
+    /** Project root; `dirs` and `out` are relative to it. */
+    readonly root: string;
+    /** Source directories to scan, recursively. Default `['src']`. */
+    readonly dirs?: readonly string[];
+    /** The declaration file to write. Default `.gyral/elements.d.ts`. */
+    readonly out?: string;
+}
+export interface TagEntry {
+    readonly tag: string;
+    readonly file: string;
+    readonly name: string;
+}
+/** One `define()`d component: its tag, the file defining it and, if exported, its binding. */
+export interface Discovered {
+    readonly tag: string;
+    /** Absolute path of the defining module. */
+    readonly file: string;
+    /** `X` in `export const X = define…`; undefined for a component that isn't exported. */
+    readonly name: string | undefined;
+}
+/** The components defined in one module's source text. */
+export declare function componentsIn(code: string, file: string): Discovered[];
+/** Every component under `dirs` (relative to `root`), in file then source order. */
+export declare function discoverComponents(root: string, dirs: readonly string[]): Discovered[];
+/** Every exported component under `dirs` (default `['src']`), sorted by tag. */
+export declare function scanTags(options: TagMapOptions): TagEntry[];
+/** The declaration file's text for `entries`, written to `outFile`. */
+export declare function tagMapSource(entries: readonly TagEntry[], outFile: string): string;
+/**
+ * Scans the sources and writes the declaration file when its content changed. Returns the
+ * entries and whether the file was written.
+ */
+export declare function writeTagMap(options: TagMapOptions): {
+    entries: TagEntry[];
+    written: boolean;
+};
+/** The preset's `gyral:element-types` plugin (`gyralVitePreset({ types })`). */
+export declare function elementTypesPlugin(options: ElementTypesOptions): Plugin;

package/dist/compiler/tag-map.js

@@ -0,0 +1,126 @@
+// Component discovery and generated element typings (gyral-1zd.22, gyral-1zd.25). One scan of
+// an app's sources for two-call `define<…>()('tag', …)` calls, read from the source text (not a
+// type check), shared by automatic component loading (./components.ts) and the typings: every
+// exported component becomes an `HTMLElementTagNameMap` entry, so apps stop hand-writing
+// `declare global { interface HTMLElementTagNameMap { … } }` blocks. Node built-ins only, so
+// ../vite.ts loads it with Node's require, from TypeScript source too.
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+/**
+ * A two-call `define<…>()('tag'`, optionally as `export const Name = …`: the generics (lazy,
+ * so nested `<…>` extend it), the empty call, then a string tag with a hyphen.
+ * `customElements.define(` doesn't match.
+ */
+const DEFINE_TAG = /(?:export\s+const\s+([A-Za-z_$][\w$]*)\s*(?::[^=;]+)?=\s*)?(?<![.\w$])define\s*(?:<[\s\S]*?>)?\s*\(\s*\)\s*\(\s*(['"`])([a-z][a-z0-9._-]*-[a-z0-9._-]*)\2/g;
+const SOURCE_FILE = /\.[cm]?[jt]sx?$/;
+const SKIPPED = /\.(?:test|spec|d)\.[cm]?[jt]sx?$/;
+/** The components defined in one module's source text. */
+export function componentsIn(code, file) {
+    if (!code.includes('define'))
+        return [];
+    const out = [];
+    for (const m of code.matchAll(DEFINE_TAG)) {
+        out.push({ tag: m[3], file, name: m[1] });
+    }
+    return out;
+}
+/** Every component under `dirs` (relative to `root`), in file then source order. */
+export function discoverComponents(root, dirs) {
+    const found = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const path = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name !== 'node_modules' && !entry.name.startsWith('.'))
+                    walk(path);
+                continue;
+            }
+            if (!SOURCE_FILE.test(entry.name) || SKIPPED.test(entry.name))
+                continue;
+            found.push(...componentsIn(readFileSync(path, 'utf8'), path));
+        }
+    };
+    for (const dir of dirs)
+        walk(resolve(root, dir));
+    return found;
+}
+/** Every exported component under `dirs` (default `['src']`), sorted by tag. */
+export function scanTags(options) {
+    const entries = discoverComponents(options.root, options.dirs ?? ['src']).flatMap((c) => c.name === undefined ? [] : [{ tag: c.tag, file: c.file, name: c.name }]);
+    return entries.sort((x, y) => (x.tag < y.tag ? -1 : x.tag > y.tag ? 1 : 0));
+}
+/** The import specifier for `file` from `outFile`: relative, `.js` for TypeScript sources. */
+function specifier(outFile, file) {
+    const path = relative(dirname(outFile), file).split(sep).join('/');
+    const js = path.replace(/\.tsx?$/, '.js').replace(/\.mts$/, '.mjs');
+    return js.startsWith('.') ? js : `./${js}`;
+}
+/** The declaration file's text for `entries`, written to `outFile`. */
+export function tagMapSource(entries, outFile) {
+    const lines = entries.map((e) => `    ${JSON.stringify(e.tag)}: InstanceType<typeof import(${JSON.stringify(specifier(outFile, e.file))}).${e.name}>;`);
+    return ('/* eslint-disable */\n' +
+        '// Generated by @gyral/core (gyralVitePreset / gyral-types) from the define() calls in your\n' +
+        '// sources. Do not edit; gitignore .gyral/ and add ".gyral/elements.d.ts" to tsconfig "include".\n' +
+        'export {};\n\n' +
+        'declare global {\n' +
+        '  interface HTMLElementTagNameMap {\n' +
+        (lines.length === 0 ? '' : `${lines.join('\n')}\n`) +
+        '  }\n' +
+        '}\n');
+}
+/**
+ * Scans the sources and writes the declaration file when its content changed. Returns the
+ * entries and whether the file was written.
+ */
+export function writeTagMap(options) {
+    const outFile = join(options.root, options.out ?? '.gyral/elements.d.ts');
+    const entries = scanTags(options);
+    const text = tagMapSource(entries, outFile);
+    if (existsSync(outFile) && readFileSync(outFile, 'utf8') === text)
+        return { entries, written: false };
+    mkdirSync(dirname(outFile), { recursive: true });
+    writeFileSync(outFile, text);
+    return { entries, written: true };
+}
+/** The preset's `gyral:element-types` plugin (`gyralVitePreset({ types })`). */
+export function elementTypesPlugin(options) {
+    let root = process.cwd();
+    const regenerate = () => {
+        const settings = { root, ...options };
+        const out = join(root, options.out ?? '.gyral/elements.d.ts');
+        // A project without components gets no file.
+        if (scanTags(settings).length === 0 && !existsSync(out))
+            return;
+        writeTagMap(settings);
+    };
+    const isSource = (file) => /\.(?:ts|tsx|mts)$/.test(file) &&
+        (options.dirs ?? ['src']).some((dir) => file.startsWith(join(root, dir)));
+    return {
+        name: 'gyral:element-types',
+        configResolved(config) {
+            root = config.root;
+        },
+        buildStart() {
+            regenerate();
+        },
+        watchChange(id) {
+            if (isSource(id))
+                regenerate();
+        },
+        configureServer(server) {
+            const changed = (file) => {
+                if (isSource(file))
+                    regenerate();
+            };
+            server.watcher.on('add', changed).on('change', changed).on('unlink', changed);
+        },
+    };
+}
+//# sourceMappingURL=tag-map.js.map

package/dist/compiler/tag-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-map.js","sourceRoot":"","sources":["../../src/compiler/tag-map.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,gGAAgG;AAChG,8FAA8F;AAC9F,yFAAyF;AACzF,6FAA6F;AAC7F,uEAAuE;AACvE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AA4BlE;;;;GAIG;AACH,MAAM,UAAU,GACd,4JAA4J,CAAC;AAC/J,MAAM,WAAW,GAAG,iBAAiB,CAAC;AACtC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAEnD,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,IAAuB;IACtE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7E,SAAS;YACX,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACxE,KAAK,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,QAAQ,CAAC,OAAsB;IAC7C,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACtF,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CACzE,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,8FAA8F;AAC9F,SAAS,SAAS,CAAC,OAAe,EAAE,IAAY;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE,OAAe;IACxE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CACxH,CAAC;IACF,OAAO,CACL,wBAAwB;QACxB,+FAA+F;QAC/F,oGAAoG;QACpG,gBAAgB;QAChB,oBAAoB;QACpB,uCAAuC;QACvC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,OAAO;QACP,KAAK,CACN,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,sBAAsB,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI;QAC/D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAI,sBAAsB,CAAC,CAAC;QAC9D,6CAA6C;QAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO;QAChE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAW,EAAE,CACzC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,cAAc,CAAC,MAAM;YACnB,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;QACD,UAAU;YACR,UAAU,EAAE,CAAC;QACf,CAAC;QACD,WAAW,CAAC,EAAE;YACZ,IAAI,QAAQ,CAAC,EAAE,CAAC;gBAAE,UAAU,EAAE,CAAC;QACjC,CAAC;QACD,eAAe,CAAC,MAAM;YACpB,MAAM,OAAO,GAAG,CAAC,IAAY,EAAQ,EAAE;gBACrC,IAAI,QAAQ,CAAC,IAAI,CAAC;oBAAE,UAAU,EAAE,CAAC;YACnC,CAAC,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// Component discovery and generated element typings (gyral-1zd.22, gyral-1zd.25). One scan of\n// an app's sources for two-call `define<…>()('tag', …)` calls, read from the source text (not a\n// type check), shared by automatic component loading (./components.ts) and the typings: every\n// exported component becomes an `HTMLElementTagNameMap` entry, so apps stop hand-writing\n// `declare global { interface HTMLElementTagNameMap { … } }` blocks. Node built-ins only, so\n// ../vite.ts loads it with Node's require, from TypeScript source too.\nimport { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\nimport type { Plugin } from 'vite';\nimport type { ElementTypesOptions } from '../vite.js';\n\nexport interface TagMapOptions {\n  /** Project root; `dirs` and `out` are relative to it. */\n  readonly root: string;\n  /** Source directories to scan, recursively. Default `['src']`. */\n  readonly dirs?: readonly string[];\n  /** The declaration file to write. Default `.gyral/elements.d.ts`. */\n  readonly out?: string;\n}\n\nexport interface TagEntry {\n  readonly tag: string;\n  readonly file: string;\n  readonly name: string;\n}\n\n/** One `define()`d component: its tag, the file defining it and, if exported, its binding. */\nexport interface Discovered {\n  readonly tag: string;\n  /** Absolute path of the defining module. */\n  readonly file: string;\n  /** `X` in `export const X = define…`; undefined for a component that isn't exported. */\n  readonly name: string | undefined;\n}\n\n/**\n * A two-call `define<…>()('tag'`, optionally as `export const Name = …`: the generics (lazy,\n * so nested `<…>` extend it), the empty call, then a string tag with a hyphen.\n * `customElements.define(` doesn't match.\n */\nconst DEFINE_TAG =\n  /(?:export\\s+const\\s+([A-Za-z_$][\\w$]*)\\s*(?::[^=;]+)?=\\s*)?(?<![.\\w$])define\\s*(?:<[\\s\\S]*?>)?\\s*\\(\\s*\\)\\s*\\(\\s*(['\"`])([a-z][a-z0-9._-]*-[a-z0-9._-]*)\\2/g;\nconst SOURCE_FILE = /\\.[cm]?[jt]sx?$/;\nconst SKIPPED = /\\.(?:test|spec|d)\\.[cm]?[jt]sx?$/;\n\n/** The components defined in one module's source text. */\nexport function componentsIn(code: string, file: string): Discovered[] {\n  if (!code.includes('define')) return [];\n  const out: Discovered[] = [];\n  for (const m of code.matchAll(DEFINE_TAG)) {\n    out.push({ tag: m[3] as string, file, name: m[1] });\n  }\n  return out;\n}\n\n/** Every component under `dirs` (relative to `root`), in file then source order. */\nexport function discoverComponents(root: string, dirs: readonly string[]): Discovered[] {\n  const found: Discovered[] = [];\n  const walk = (dir: string): void => {\n    let entries;\n    try {\n      entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n    for (const entry of entries) {\n      const path = join(dir, entry.name);\n      if (entry.isDirectory()) {\n        if (entry.name !== 'node_modules' && !entry.name.startsWith('.')) walk(path);\n        continue;\n      }\n      if (!SOURCE_FILE.test(entry.name) || SKIPPED.test(entry.name)) continue;\n      found.push(...componentsIn(readFileSync(path, 'utf8'), path));\n    }\n  };\n  for (const dir of dirs) walk(resolve(root, dir));\n  return found;\n}\n\n/** Every exported component under `dirs` (default `['src']`), sorted by tag. */\nexport function scanTags(options: TagMapOptions): TagEntry[] {\n  const entries = discoverComponents(options.root, options.dirs ?? ['src']).flatMap((c) =>\n    c.name === undefined ? [] : [{ tag: c.tag, file: c.file, name: c.name }],\n  );\n  return entries.sort((x, y) => (x.tag < y.tag ? -1 : x.tag > y.tag ? 1 : 0));\n}\n\n/** The import specifier for `file` from `outFile`: relative, `.js` for TypeScript sources. */\nfunction specifier(outFile: string, file: string): string {\n  const path = relative(dirname(outFile), file).split(sep).join('/');\n  const js = path.replace(/\\.tsx?$/, '.js').replace(/\\.mts$/, '.mjs');\n  return js.startsWith('.') ? js : `./${js}`;\n}\n\n/** The declaration file's text for `entries`, written to `outFile`. */\nexport function tagMapSource(entries: readonly TagEntry[], outFile: string): string {\n  const lines = entries.map(\n    (e) =>\n      `    ${JSON.stringify(e.tag)}: InstanceType<typeof import(${JSON.stringify(specifier(outFile, e.file))}).${e.name}>;`,\n  );\n  return (\n    '/* eslint-disable */\\n' +\n    '// Generated by @gyral/core (gyralVitePreset / gyral-types) from the define() calls in your\\n' +\n    '// sources. Do not edit; gitignore .gyral/ and add \".gyral/elements.d.ts\" to tsconfig \"include\".\\n' +\n    'export {};\\n\\n' +\n    'declare global {\\n' +\n    '  interface HTMLElementTagNameMap {\\n' +\n    (lines.length === 0 ? '' : `${lines.join('\\n')}\\n`) +\n    '  }\\n' +\n    '}\\n'\n  );\n}\n\n/**\n * Scans the sources and writes the declaration file when its content changed. Returns the\n * entries and whether the file was written.\n */\nexport function writeTagMap(options: TagMapOptions): { entries: TagEntry[]; written: boolean } {\n  const outFile = join(options.root, options.out ?? '.gyral/elements.d.ts');\n  const entries = scanTags(options);\n  const text = tagMapSource(entries, outFile);\n  if (existsSync(outFile) && readFileSync(outFile, 'utf8') === text)\n    return { entries, written: false };\n  mkdirSync(dirname(outFile), { recursive: true });\n  writeFileSync(outFile, text);\n  return { entries, written: true };\n}\n\n/** The preset's `gyral:element-types` plugin (`gyralVitePreset({ types })`). */\nexport function elementTypesPlugin(options: ElementTypesOptions): Plugin {\n  let root = process.cwd();\n  const regenerate = (): void => {\n    const settings = { root, ...options };\n    const out = join(root, options.out ?? '.gyral/elements.d.ts');\n    // A project without components gets no file.\n    if (scanTags(settings).length === 0 && !existsSync(out)) return;\n    writeTagMap(settings);\n  };\n  const isSource = (file: string): boolean =>\n    /\\.(?:ts|tsx|mts)$/.test(file) &&\n    (options.dirs ?? ['src']).some((dir) => file.startsWith(join(root, dir)));\n  return {\n    name: 'gyral:element-types',\n    configResolved(config) {\n      root = config.root;\n    },\n    buildStart() {\n      regenerate();\n    },\n    watchChange(id) {\n      if (isSource(id)) regenerate();\n    },\n    configureServer(server) {\n      const changed = (file: string): void => {\n        if (isSource(file)) regenerate();\n      };\n      server.watcher.on('add', changed).on('change', changed).on('unlink', changed);\n    },\n  };\n}\n"]}

package/dist/components-ready.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolves once every rendered tag the component loader knows (in the document and in the
+ * shadow roots of components it defined) is defined, and the page has settled. Await it in
+ * browser tests and page scripts after the loader has run (page scripts placed after it; in
+ * tests, import `virtual:gyral/components` first).
+ */
+export declare function componentsReady(): Promise<void>;

package/dist/components-ready.js

@@ -0,0 +1,19 @@
+// `componentsReady()` (ADR 0016 "Automatic components"): wait until the components the page
+// renders are defined and have rendered. The loader that gyralVitePreset({ components: true })
+// generates registers itself under a well-known symbol; without it (no automatic components,
+// or a server render) this is just `settled()`.
+import { settled } from './settled.js';
+const KEY = Symbol.for('gyral.components');
+/**
+ * Resolves once every rendered tag the component loader knows (in the document and in the
+ * shadow roots of components it defined) is defined, and the page has settled. Await it in
+ * browser tests and page scripts after the loader has run (page scripts placed after it; in
+ * tests, import `virtual:gyral/components` first).
+ */
+export async function componentsReady() {
+    const loader = globalThis[KEY];
+    if (loader !== undefined)
+        await loader.ready();
+    await settled();
+}
+//# sourceMappingURL=components-ready.js.map

package/dist/components-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components-ready.js","sourceRoot":"","sources":["../src/components-ready.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,+FAA+F;AAC/F,6FAA6F;AAC7F,gDAAgD;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAMvC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,MAAM,GAAI,UAA0C,CAAC,GAAG,CAAC,CAAC;IAChE,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/C,MAAM,OAAO,EAAE,CAAC;AAClB,CAAC","sourcesContent":["// `componentsReady()` (ADR 0016 \"Automatic components\"): wait until the components the page\n// renders are defined and have rendered. The loader that gyralVitePreset({ components: true })\n// generates registers itself under a well-known symbol; without it (no automatic components,\n// or a server render) this is just `settled()`.\nimport { settled } from './settled.js';\n\ninterface ComponentLoader {\n  readonly ready: () => Promise<void>;\n}\n\nconst KEY = Symbol.for('gyral.components');\n\n/**\n * Resolves once every rendered tag the component loader knows (in the document and in the\n * shadow roots of components it defined) is defined, and the page has settled. Await it in\n * browser tests and page scripts after the loader has run (page scripts placed after it; in\n * tests, import `virtual:gyral/components` first).\n */\nexport async function componentsReady(): Promise<void> {\n  const loader = (globalThis as { [KEY]?: ComponentLoader })[KEY];\n  if (loader !== undefined) await loader.ready();\n  await settled();\n}\n"]}

package/dist/define.d.ts

@@ -1,9 +1,18 @@
 import type { GyralElementClass } from './element-types.js';
 import type { ComponentSpec, Tagged } from './types.js';
 export type { GyralElement, GyralElementClass } from './element-types.js';
+/** The second call of `define()`: takes the tag and the spec, infers the intent names. */
+export type Definer<S, M extends Tagged, P extends object, O extends Tagged> = <N extends string = never>(tag: string, spec: ComponentSpec<S, M, P, N>) => GyralElementClass<S, M, P, O, N>;
 /**
- * Compiles a Model-View-Intent spec into a custom element and registers it under `tag`.
- * See docs/design-docs/0001-mvi-parsed-intent.md, 0006-effects-and-drivers.md, 0007-props.md
- * 0008-forms.md and 0012-ssr.md.
+ * Compiles a Model-View-Intent spec into a custom element and registers it under `tag`. Two
+ * calls (ADR 0023): the first takes the types, the second the tag and spec, from whose
+ * `intent` keys it infers the component's intent names.
+ *
+ *   define<State, Msg>()('x-counter', { init, intent: { Increment: … }, update, view })
+ *
+ * With no type arguments, `define()('x-badge', spec)` infers the state, messages, props and
+ * intent names from the spec. See docs/design-docs/0001-mvi-parsed-intent.md,
+ * 0006-effects-and-drivers.md, 0007-props.md, 0008-forms.md and view/05-element.md.
  */
-export declare function define<S, M extends Tagged, P extends object = object, O extends Tagged = never>(tag: string, spec: ComponentSpec<S, M, P>): GyralElementClass<S, M, P, O>;
+export declare function define(): <S, M extends Tagged = never, P extends object = object, N extends string = never>(tag: string, spec: ComponentSpec<S, M, P, N>) => GyralElementClass<S, M, P, never, N>;
+export declare function define<S, M extends Tagged = never, P extends object = object, O extends Tagged = never>(): Definer<S, M, P, O>;