@gyral/core 0.1.0 → 0.3.0

package/dist/compiler/scan.js

@@ -0,0 +1,152 @@
+// Finds a module's `html` call sites for the template compiler (view/01-templates.md
+// "Compiled"). Two steps, because matching an import against the configured sources may need
+// module resolution (async, in the plugin): `htmlImports` lists the candidate imports, and
+// `findUses` walks the module, scope-aware, for every reference to the matching bindings:
+//   - html`…` (or ns.html`…` for `import * as ns`) is a call site;
+//   - any other reference (`const h = html`, `html(strings)`, `ns[x]`, `{ html } = ns`) is a
+//     leftover the compiler can't follow: an error, since it would reach the runtime preparer;
+//   - `export { html }` re-exports it: a warning here, an error in generateBundle when an
+//     uncompiled `html` survives in the bundle.
+import { children, nodeAt, nodesAt, scopeNames } from './ast.js';
+const nameOf = (node) => node === undefined
+    ? undefined
+    : node.type === 'Identifier'
+        ? node['name']
+        : node.type === 'Literal' && typeof node['value'] === 'string'
+            ? node['value']
+            : undefined;
+const specifierOf = (node) => nameOf(nodeAt(node, 'source'));
+const isValue = (node) => node['importKind'] !== 'type' && node['exportKind'] !== 'type';
+/** Imports of `html` (named) and namespace imports, plus `export { html } from` re-exports. */
+export function htmlImports(program) {
+    const imports = [];
+    const reexports = [];
+    for (const statement of nodesAt(program, 'body')) {
+        const specifier = specifierOf(statement);
+        if (specifier === undefined || !isValue(statement))
+            continue;
+        if (statement.type === 'ImportDeclaration') {
+            for (const s of nodesAt(statement, 'specifiers')) {
+                const local = nameOf(nodeAt(s, 'local'));
+                if (local === undefined || !isValue(s))
+                    continue;
+                if (s.type === 'ImportNamespaceSpecifier') {
+                    imports.push({ local, namespace: true, specifier });
+                }
+                else if (s.type === 'ImportSpecifier' && nameOf(nodeAt(s, 'imported')) === 'html') {
+                    imports.push({ local, namespace: false, specifier });
+                }
+            }
+        }
+        else if (statement.type === 'ExportNamedDeclaration') {
+            const html = nodesAt(statement, 'specifiers').find((s) => isValue(s) && nameOf(nodeAt(s, 'local')) === 'html');
+            if (html !== undefined)
+                reexports.push({ node: html, specifier });
+        }
+    }
+    return { imports, reexports };
+}
+const unparen = (node) => node?.type === 'ParenthesizedExpression' ? unparen(nodeAt(node, 'expression')) : node;
+/** Every use of `bindings` in `program`, skipping names that a nested scope redeclares. */
+export function findUses(program, bindings) {
+    const byName = new Map(bindings.map((b) => [b.local, b]));
+    const sites = [];
+    const leftovers = [];
+    const scopes = [];
+    const binding = (node) => {
+        const name = node?.type === 'Identifier' ? node['name'] : undefined;
+        if (name === undefined || scopes.some((s) => s.has(name)))
+            return undefined;
+        return byName.get(name);
+    };
+    /** The binding a tag refers to: `html` itself, or `ns.html`. */
+    const tagBinding = (tag) => {
+        if (tag?.type === 'Identifier') {
+            const b = binding(tag);
+            return b?.namespace === false ? b : undefined;
+        }
+        if (tag?.type !== 'MemberExpression' || tag['computed'] === true)
+            return undefined;
+        const b = binding(nodeAt(tag, 'object'));
+        return b?.namespace === true && nameOf(nodeAt(tag, 'property')) === 'html' ? b : undefined;
+    };
+    const walkAll = (nodes) => {
+        for (const n of nodes)
+            walk(n);
+    };
+    function visit(node) {
+        switch (node.type) {
+            case 'ImportDeclaration':
+            case 'ExportAllDeclaration':
+            case 'MetaProperty':
+            case 'BreakStatement':
+            case 'ContinueStatement':
+                return;
+            case 'ExportNamedDeclaration':
+                if (nodeAt(node, 'source') === undefined) {
+                    for (const s of nodesAt(node, 'specifiers')) {
+                        if (binding(nodeAt(s, 'local')) !== undefined)
+                            leftovers.push({ node: s, exported: true });
+                    }
+                }
+                walkAll(nodesAt(node, 'declaration'));
+                return;
+            case 'TaggedTemplateExpression': {
+                const tag = unparen(nodeAt(node, 'tag'));
+                const b = tagBinding(tag);
+                if (b === undefined)
+                    break;
+                sites.push({ node, binding: b });
+                walkAll(nodesAt(nodeAt(node, 'quasi') ?? node, 'expressions'));
+                return;
+            }
+            case 'MemberExpression': {
+                const object = nodeAt(node, 'object');
+                const b = binding(object);
+                const computed = node['computed'] === true;
+                if (b !== undefined) {
+                    // ns.other is fine; ns.html outside a tag, or ns[expr], can't be followed.
+                    if (!b.namespace || computed || nameOf(nodeAt(node, 'property')) === 'html') {
+                        leftovers.push({ node, exported: false });
+                    }
+                }
+                else
+                    walkAll(nodesAt(node, 'object'));
+                if (computed)
+                    walkAll(nodesAt(node, 'property'));
+                return;
+            }
+            case 'Property':
+            case 'MethodDefinition':
+            case 'PropertyDefinition':
+            case 'AccessorProperty':
+                if (node['computed'] === true)
+                    walkAll(nodesAt(node, 'key'));
+                walkAll(nodesAt(node, 'decorators'));
+                walkAll(nodesAt(node, 'value'));
+                return;
+            case 'LabeledStatement':
+                walkAll(nodesAt(node, 'body'));
+                return;
+            case 'Identifier':
+                if (binding(node) !== undefined)
+                    leftovers.push({ node, exported: false });
+                return;
+        }
+        walkAll(children(node));
+    }
+    function walk(node) {
+        const declared = scopeNames(node)?.filter((name) => byName.has(name));
+        if (declared === undefined || declared.length === 0) {
+            visit(node);
+            return;
+        }
+        scopes.push(new Set(declared));
+        visit(node);
+        scopes.pop();
+    }
+    if (byName.size > 0)
+        walkAll(nodesAt(program, 'body'));
+    return { sites, leftovers };
+}
+//# sourceMappingURL=scan.js.map

package/dist/compiler/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/compiler/scan.ts"],"names":[],"mappings":"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","sourcesContent":["// Finds a module's `html` call sites for the template compiler (view/01-templates.md\n// \"Compiled\"). Two steps, because matching an import against the configured sources may need\n// module resolution (async, in the plugin): `htmlImports` lists the candidate imports, and\n// `findUses` walks the module, scope-aware, for every reference to the matching bindings:\n//   - html`…` (or ns.html`…` for `import * as ns`) is a call site;\n//   - any other reference (`const h = html`, `html(strings)`, `ns[x]`, `{ html } = ns`) is a\n//     leftover the compiler can't follow: an error, since it would reach the runtime preparer;\n//   - `export { html }` re-exports it: a warning here, an error in generateBundle when an\n//     uncompiled `html` survives in the bundle.\nimport { children, nodeAt, nodesAt, scopeNames, type Node } from './ast.js';\n\n/** `import { html as local } from 'specifier'`, or `import * as local from 'specifier'`. */\nexport interface HtmlImport {\n  readonly local: string;\n  readonly namespace: boolean;\n  readonly specifier: string;\n}\n\nexport interface Imports {\n  readonly imports: readonly HtmlImport[];\n  /** `export { html } from 'specifier'` (its node, for a code frame). */\n  readonly reexports: readonly { readonly node: Node; readonly specifier: string }[];\n}\n\nexport interface Uses {\n  /** TaggedTemplateExpression nodes whose tag is a matching binding. */\n  readonly sites: readonly { readonly node: Node; readonly binding: HtmlImport }[];\n  /** Other references; `exported`: an `export { html }` specifier. */\n  readonly leftovers: readonly { readonly node: Node; readonly exported: boolean }[];\n}\n\nconst nameOf = (node: Node | undefined): string | undefined =>\n  node === undefined\n    ? undefined\n    : node.type === 'Identifier'\n      ? (node['name'] as string)\n      : node.type === 'Literal' && typeof node['value'] === 'string'\n        ? node['value']\n        : undefined;\n\nconst specifierOf = (node: Node): string | undefined => nameOf(nodeAt(node, 'source'));\n\nconst isValue = (node: Node): boolean =>\n  node['importKind'] !== 'type' && node['exportKind'] !== 'type';\n\n/** Imports of `html` (named) and namespace imports, plus `export { html } from` re-exports. */\nexport function htmlImports(program: Node): Imports {\n  const imports: HtmlImport[] = [];\n  const reexports: { node: Node; specifier: string }[] = [];\n  for (const statement of nodesAt(program, 'body')) {\n    const specifier = specifierOf(statement);\n    if (specifier === undefined || !isValue(statement)) continue;\n    if (statement.type === 'ImportDeclaration') {\n      for (const s of nodesAt(statement, 'specifiers')) {\n        const local = nameOf(nodeAt(s, 'local'));\n        if (local === undefined || !isValue(s)) continue;\n        if (s.type === 'ImportNamespaceSpecifier') {\n          imports.push({ local, namespace: true, specifier });\n        } else if (s.type === 'ImportSpecifier' && nameOf(nodeAt(s, 'imported')) === 'html') {\n          imports.push({ local, namespace: false, specifier });\n        }\n      }\n    } else if (statement.type === 'ExportNamedDeclaration') {\n      const html = nodesAt(statement, 'specifiers').find(\n        (s) => isValue(s) && nameOf(nodeAt(s, 'local')) === 'html',\n      );\n      if (html !== undefined) reexports.push({ node: html, specifier });\n    }\n  }\n  return { imports, reexports };\n}\n\nconst unparen = (node: Node | undefined): Node | undefined =>\n  node?.type === 'ParenthesizedExpression' ? unparen(nodeAt(node, 'expression')) : node;\n\n/** Every use of `bindings` in `program`, skipping names that a nested scope redeclares. */\nexport function findUses(program: Node, bindings: readonly HtmlImport[]): Uses {\n  const byName = new Map(bindings.map((b) => [b.local, b]));\n  const sites: { node: Node; binding: HtmlImport }[] = [];\n  const leftovers: { node: Node; exported: boolean }[] = [];\n  const scopes: Set<string>[] = [];\n\n  const binding = (node: Node | undefined): HtmlImport | undefined => {\n    const name = node?.type === 'Identifier' ? (node['name'] as string) : undefined;\n    if (name === undefined || scopes.some((s) => s.has(name))) return undefined;\n    return byName.get(name);\n  };\n\n  /** The binding a tag refers to: `html` itself, or `ns.html`. */\n  const tagBinding = (tag: Node | undefined): HtmlImport | undefined => {\n    if (tag?.type === 'Identifier') {\n      const b = binding(tag);\n      return b?.namespace === false ? b : undefined;\n    }\n    if (tag?.type !== 'MemberExpression' || tag['computed'] === true) return undefined;\n    const b = binding(nodeAt(tag, 'object'));\n    return b?.namespace === true && nameOf(nodeAt(tag, 'property')) === 'html' ? b : undefined;\n  };\n\n  const walkAll = (nodes: readonly Node[]): void => {\n    for (const n of nodes) walk(n);\n  };\n\n  function visit(node: Node): void {\n    switch (node.type) {\n      case 'ImportDeclaration':\n      case 'ExportAllDeclaration':\n      case 'MetaProperty':\n      case 'BreakStatement':\n      case 'ContinueStatement':\n        return;\n      case 'ExportNamedDeclaration':\n        if (nodeAt(node, 'source') === undefined) {\n          for (const s of nodesAt(node, 'specifiers')) {\n            if (binding(nodeAt(s, 'local')) !== undefined)\n              leftovers.push({ node: s, exported: true });\n          }\n        }\n        walkAll(nodesAt(node, 'declaration'));\n        return;\n      case 'TaggedTemplateExpression': {\n        const tag = unparen(nodeAt(node, 'tag'));\n        const b = tagBinding(tag);\n        if (b === undefined) break;\n        sites.push({ node, binding: b });\n        walkAll(nodesAt(nodeAt(node, 'quasi') ?? node, 'expressions'));\n        return;\n      }\n      case 'MemberExpression': {\n        const object = nodeAt(node, 'object');\n        const b = binding(object);\n        const computed = node['computed'] === true;\n        if (b !== undefined) {\n          // ns.other is fine; ns.html outside a tag, or ns[expr], can't be followed.\n          if (!b.namespace || computed || nameOf(nodeAt(node, 'property')) === 'html') {\n            leftovers.push({ node, exported: false });\n          }\n        } else walkAll(nodesAt(node, 'object'));\n        if (computed) walkAll(nodesAt(node, 'property'));\n        return;\n      }\n      case 'Property':\n      case 'MethodDefinition':\n      case 'PropertyDefinition':\n      case 'AccessorProperty':\n        if (node['computed'] === true) walkAll(nodesAt(node, 'key'));\n        walkAll(nodesAt(node, 'decorators'));\n        walkAll(nodesAt(node, 'value'));\n        return;\n      case 'LabeledStatement':\n        walkAll(nodesAt(node, 'body'));\n        return;\n      case 'Identifier':\n        if (binding(node) !== undefined) leftovers.push({ node, exported: false });\n        return;\n    }\n    walkAll(children(node));\n  }\n\n  function walk(node: Node): void {\n    const declared = scopeNames(node)?.filter((name) => byName.has(name));\n    if (declared === undefined || declared.length === 0) {\n      visit(node);\n      return;\n    }\n    scopes.push(new Set(declared));\n    visit(node);\n    scopes.pop();\n  }\n\n  if (byName.size > 0) walkAll(nodesAt(program, 'body'));\n  return { sites, leftovers };\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/define.d.ts

@@ -3,7 +3,7 @@ import type { ComponentSpec, Tagged } from './types.js';
 export type { GyralElement, GyralElementClass } from './element-types.js';
 /**
  * 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.
+ * 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>;