@faicad/faijs 0.13.2 → 0.16.0

package/dist/faqts/imports.js

@@ -1,95 +0,0 @@
-/**
- * faits — import 声明解析与说明符重写（Phase D, pipeline 第 2–3 步）
- *
- * 说明：faits 复用 Phase B 的导入通道 ①② —— 即"只负责把它所依赖的
- * 裸说明符改写到宿主能解析的绝对 URL（file:/blob:/http(s):），其余
- * 保持原样"。与 faijs 的 ModuleResolver（Phase E V5.2, plan §4.1）不
- * 同，此处 **不实现** 模块仓库解析，只做确定性的语法级重写：
- *
- * - 相对说明符（`./x`、`../x`）→ 可选按 base URL 绝对化，否则保留
- * - `@faicad/faijs` 及其子路径（含 `/sdk`）→ **零替换**，由宿主 importmap 解析
- * - 其它裸说明符 → 走宿主提供的 rewrite 表（复用 B 通道 ①② 的产物）
- *
- * acorn 仅用于定位每个 import 声明在源码中的精确 span；替换用字符串
- * 手术完成，不重建整份 AST，避免丢注释/格式（保持行号定位）。
- */
-import { parse } from 'acorn';
-/** 宿主 importmap 应已覆盖的说明符前缀，重写时默认跳过。 */
-const RESERVED_BARE_PREFIXES = ['@faicad/faijs', '@faicad/faq', '@faicad/faq/sdk', '@fc/fq/'];
-/**
- * 解析模块源码（必须是已去类型的 JS），返回全部静态 import 的说明符/位置。
- *
- * 只处理顶层 import 声明（ESM 静态导入）；动态 import() 属于运行时行为，
- * 不在重写范围内——若 faits 需要动态导入，宿主 importmap 自行兜底。
- */
-/**
- * Parse module source (de-typed JS) and return the specifier and location of
- * every static top-level import declaration. Dynamic import() is runtime
- * behavior and is not part of the rewrite scope.
- * @param code - the module JavaScript source text.
- * @returns an array of import spans covering each static import declaration.
- */
-export function findImports(code) {
-    const ast = parse(code, { ecmaVersion: 'latest', sourceType: 'module' });
-    const spans = [];
-    for (const node of ast.body) {
-        if (node.type !== 'ImportDeclaration')
-            continue;
-        const src = node.source;
-        if (!src || src.start === undefined || src.end === undefined)
-            continue;
-        const spec = src.value;
-        const bare = !spec.startsWith('.') && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(spec);
-        // acorn 的 source.start/end 覆盖含引号的字符串字面量 → 收缩到不含引号的内容
-        spans.push({ specifier: spec, start: src.start + 1, end: src.end - 1, bare });
-    }
-    return spans;
-}
-function isReserved(specifier) {
-    return RESERVED_BARE_PREFIXES.some((p) => specifier === p || specifier.startsWith(p + '/'));
-}
-/**
- * 重写模块代码中的 import 说明符：按 span（start/end）对源码做替换。
- *
- * 规则（按优先级）：
- * 1. 保留前缀（`@faicad/faij` 家族）→ 不改（宿主 importmap 解析）
- * 2. rewrite 钩子返回非 `undefined` → 用之
- * 3. 相对说明符且给了 baseURL → 绝对化
- * 4. 其余 → 原样保留
- *
- * 用一次 `code` 全串替换（从后往前保证 span 位置不漂移）。
- */
-/**
- * Rewrite import specifiers in module code by splicing the source at each
- * span's start/end offsets. Priority: reserved prefixes stay unchanged, then
- * the rewrite hook's result, then relative absolute-ization, else preserved.
- * @param code - the module JavaScript source text to rewrite.
- * @param options - rewrite hook and optional base URL for relative specifiers.
- * @returns the rewritten module source text.
- */
-export function rewriteImports(code, options = {}) {
-    const spans = findImports(code);
-    let out = code;
-    for (let i = spans.length - 1; i >= 0; i--) {
-        const span = spans[i];
-        let repl;
-        if (options.rewrite) {
-            // 宿主重写钩子优先（可覆盖保留前缀，用于测试/自定义宿主将
-            // `@faicad/faq` 指向同一个模块实例，保证 Shape 身份一致）
-            repl = options.rewrite(span.specifier, { bare: span.bare });
-        }
-        if (repl === undefined && isReserved(span.specifier)) {
-            // 保留前缀：零替换，交给宿主 importmap（B 通道 ① 语义）
-            repl = undefined;
-        }
-        if (repl === undefined && span.bare === false && options.baseURL) {
-            repl = new URL(span.specifier, options.baseURL).href;
-        }
-        if (repl === undefined || repl === span.specifier)
-            continue;
-        // 替换除引号外的字符串内容
-        out = out.slice(0, span.start) + repl + out.slice(span.end);
-    }
-    return out;
-}
-//# sourceMappingURL=imports.js.map

package/dist/faqts/imports.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../src/faqts/imports.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * faits — import 声明解析与说明符重写（Phase D, pipeline 第 2–3 步）\n *\n * 说明：faits 复用 Phase B 的导入通道 ①② —— 即\"只负责把它所依赖的\n * 裸说明符改写到宿主能解析的绝对 URL（file:/blob:/http(s):），其余\n * 保持原样\"。与 faijs 的 ModuleResolver（Phase E V5.2, plan §4.1）不\n * 同，此处 **不实现** 模块仓库解析，只做确定性的语法级重写：\n *\n * - 相对说明符（`./x`、`../x`）→ 可选按 base URL 绝对化，否则保留\n * - `@faicad/faijs` 及其子路径（含 `/sdk`）→ **零替换**，由宿主 importmap 解析\n * - 其它裸说明符 → 走宿主提供的 rewrite 表（复用 B 通道 ①② 的产物）\n *\n * acorn 仅用于定位每个 import 声明在源码中的精确 span；替换用字符串\n * 手术完成，不重建整份 AST，避免丢注释/格式（保持行号定位）。\n */\n\nimport { parse } from 'acorn'\n\n/**\n * The exact location of one static import declaration within module source,\n * used to rewrite its specifier without rebuilding the AST.\n */\nexport interface FaqtsImportSpan {\n  /** import 声明的原始说明符，如 `./partner`、`@faqad/faqjs/sdk` */\n  specifier: string\n  /** 说明符字符串在源码中的起始偏移（不含引号） */\n  start: number\n  /** 说明符字符串在源码中的结束偏移（不含引号） */\n  end: number\n  /** 是否裸说明符（既非相对路径也非绝对 URL） */\n  bare: boolean\n}\n\n/**\n * A host-provided rewrite hook that maps an import specifier to the URL the\n * host can resolve. Returning `undefined` leaves the specifier unchanged.\n */\nexport type FaqtsRewriteFn = (specifier: string, ctx: { bare: boolean }) => string | undefined\n\n/** 宿主 importmap 应已覆盖的说明符前缀，重写时默认跳过。 */\nconst RESERVED_BARE_PREFIXES = ['@faicad/faijs', '@faicad/faq', '@faicad/faq/sdk', '@fc/fq/' ]\n\n/**\n * 解析模块源码（必须是已去类型的 JS），返回全部静态 import 的说明符/位置。\n *\n * 只处理顶层 import 声明（ESM 静态导入）；动态 import() 属于运行时行为，\n * 不在重写范围内——若 faits 需要动态导入，宿主 importmap 自行兜底。\n */\n/**\n * Parse module source (de-typed JS) and return the specifier and location of\n * every static top-level import declaration. Dynamic import() is runtime\n * behavior and is not part of the rewrite scope.\n * @param code - the module JavaScript source text.\n * @returns an array of import spans covering each static import declaration.\n */\nexport function findImports(code: string): FaqtsImportSpan[] {\n  const ast = parse(code, { ecmaVersion: 'latest', sourceType: 'module' })\n  const spans: FaqtsImportSpan[] = []\n  for (const node of ast.body) {\n    if (node.type !== 'ImportDeclaration') continue\n    const src = node.source as { value: string; start?: number; end?: number }\n    if (!src || src.start === undefined || src.end === undefined) continue\n    const spec = src.value\n    const bare = !spec.startsWith('.') && !/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(spec)\n    // acorn 的 source.start/end 覆盖含引号的字符串字面量 → 收缩到不含引号的内容\n    spans.push({ specifier: spec, start: src.start + 1, end: src.end - 1, bare })\n  }\n  return spans\n}\n\nfunction isReserved(specifier: string): boolean {\n  return RESERVED_BARE_PREFIXES.some((p) => specifier === p || specifier.startsWith(p + '/'))\n}\n\n/**\n * 重写模块代码中的 import 说明符：按 span（start/end）对源码做替换。\n *\n * 规则（按优先级）：\n * 1. 保留前缀（`@faicad/faij` 家族）→ 不改（宿主 importmap 解析）\n * 2. rewrite 钩子返回非 `undefined` → 用之\n * 3. 相对说明符且给了 baseURL → 绝对化\n * 4. 其余 → 原样保留\n *\n * 用一次 `code` 全串替换（从后往前保证 span 位置不漂移）。\n */\n/**\n * Rewrite import specifiers in module code by splicing the source at each\n * span's start/end offsets. Priority: reserved prefixes stay unchanged, then\n * the rewrite hook's result, then relative absolute-ization, else preserved.\n * @param code - the module JavaScript source text to rewrite.\n * @param options - rewrite hook and optional base URL for relative specifiers.\n * @returns the rewritten module source text.\n */\nexport function rewriteImports(\n  code: string,\n  options: {\n    rewrite?: FaqtsRewriteFn\n    baseURL?: string | URL\n  } = {},\n): string {\n  const spans = findImports(code)\n  let out = code\n  for (let i = spans.length - 1; i >= 0; i--) {\n    const span = spans[i]\n    let repl: string | undefined\n    if (options.rewrite) {\n      // 宿主重写钩子优先（可覆盖保留前缀，用于测试/自定义宿主将\n      // `@faicad/faq` 指向同一个模块实例，保证 Shape 身份一致）\n      repl = options.rewrite(span.specifier, { bare: span.bare })\n    }\n    if (repl === undefined && isReserved(span.specifier)) {\n      // 保留前缀：零替换，交给宿主 importmap（B 通道 ① 语义）\n      repl = undefined\n    }\n    if (repl === undefined && span.bare === false && options.baseURL) {\n      repl = new URL(span.specifier, options.baseURL).href\n    }\n    if (repl === undefined || repl === span.specifier) continue\n    // 替换除引号外的字符串内容\n    out = out.slice(0, span.start) + repl + out.slice(span.end)\n  }\n  return out\n}"]}

package/dist/faqts/index.d.ts

@@ -1,22 +0,0 @@
-/**
- * faits（faqts）— `.ts` 源码整段执行（Phase D）
- *
- * 入口：@faicad/faijs/faqts
- *   Node 用：@faicad/faijs/faqts/node
- *   浏览器用：@faicad/faijs/faqts/browser
- *
- * 与 faijs 执行管道（extractMetadata → DirectExecutor → 逐语句执行）平行的第二条执行路径：
- * - `.ts` 整段一次执行（不建 IR、不逐语句、不接入 timeline）
- * - 输出由作者显式 export 声明（无 DAG 自动推导）
- * - 共享同一套 `cad` API 与 Shape 契约（与 faq 侧互通）
- *
- * 本入口导出纯逻辑：transform / imports / run（run 需要注入 execute 执行器）。
- * 环境特定执行器见 exec-node.ts（Node 临时 .mjs）与 exec-blob.ts（Blob URL）。
- */
-export { transformFaqts } from './transform.js';
-export type { FaqtsTransformOptions, FaqtsTransformResult } from './transform.js';
-export { findImports, rewriteImports } from './imports.js';
-export type { FaqtsImportSpan, FaqtsRewriteFn } from './imports.js';
-export { runFaqts } from './run.js';
-export type { FaqtsRunOptions, FaqtsRunResult, FaqtsModuleExecutor } from './run.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/faqts/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/faqts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAA"}

package/dist/faqts/index.js

@@ -1,21 +0,0 @@
-/**
- * faits（faqts）— `.ts` 源码整段执行（Phase D）
- *
- * 入口：@faicad/faijs/faqts
- *   Node 用：@faicad/faijs/faqts/node
- *   浏览器用：@faicad/faijs/faqts/browser
- *
- * 与 faijs 执行管道（extractMetadata → DirectExecutor → 逐语句执行）平行的第二条执行路径：
- * - `.ts` 整段一次执行（不建 IR、不逐语句、不接入 timeline）
- * - 输出由作者显式 export 声明（无 DAG 自动推导）
- * - 共享同一套 `cad` API 与 Shape 契约（与 faq 侧互通）
- *
- * 本入口导出纯逻辑：transform / imports / run（run 需要注入 execute 执行器）。
- * 环境特定执行器见 exec-node.ts（Node 临时 .mjs）与 exec-blob.ts（Blob URL）。
- */
-export { transformFaqts } from './transform.js';
-export { findImports, rewriteImports } from './imports.js';
-export { runFaqts } from './run.js';
-// 纯逻辑入口不挂执行器：Node/Browser 执行器见 ./node 与 ./browser 子路径，
-// 避免浏览器侧静态引入 node:fs / node:os。
-//# sourceMappingURL=index.js.map

package/dist/faqts/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/faqts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,uDAAuD;AACvD,gCAAgC","sourcesContent":["/**\n * faits（faqts）— `.ts` 源码整段执行（Phase D）\n *\n * 入口：@faicad/faijs/faqts\n *   Node 用：@faicad/faijs/faqts/node\n *   浏览器用：@faicad/faijs/faqts/browser\n *\n * 与 faijs 执行管道（extractMetadata → DirectExecutor → 逐语句执行）平行的第二条执行路径：\n * - `.ts` 整段一次执行（不建 IR、不逐语句、不接入 timeline）\n * - 输出由作者显式 export 声明（无 DAG 自动推导）\n * - 共享同一套 `cad` API 与 Shape 契约（与 faq 侧互通）\n *\n * 本入口导出纯逻辑：transform / imports / run（run 需要注入 execute 执行器）。\n * 环境特定执行器见 exec-node.ts（Node 临时 .mjs）与 exec-blob.ts（Blob URL）。\n */\n\nexport { transformFaqts } from './transform'\nexport type { FaqtsTransformOptions, FaqtsTransformResult } from './transform'\nexport { findImports, rewriteImports } from './imports'\nexport type { FaqtsImportSpan, FaqtsRewriteFn } from './imports'\nexport { runFaqts } from './run'\nexport type { FaqtsRunOptions, FaqtsRunResult, FaqtsModuleExecutor } from './run'\n// 纯逻辑入口不挂执行器：Node/Browser 执行器见 ./node 与 ./browser 子路径，\n// 避免浏览器侧静态引入 node:fs / node:os。"]}

package/dist/faqts/node.d.ts

@@ -1,23 +0,0 @@
-/**
- * faqts — Node 入口：@faicad/faijs/faqts/node
- *
- * 绑定 Node 执行器（临时 .mjs）。浏览器消费方务必从 .../faqts/browser 导入，
- * 避免静态引入 node:fs。
- */
-import type { FaqtsRunOptions, FaqtsRunResult } from './run.js';
-export { transformFaqts } from './transform.js';
-export type { FaqtsTransformOptions, FaqtsTransformResult } from './transform.js';
-export { findImports, rewriteImports } from './imports.js';
-export type { FaqtsImportSpan, FaqtsRewriteFn } from './imports.js';
-export { runFaqts } from './run.js';
-export type { FaqtsRunOptions, FaqtsRunResult } from './run.js';
-export { executeFaqtsModuleInNode } from './exec-node.js';
-/**
- * Convenience entry point that runs `.ts` source end-to-end in a Node
- * environment, binding the Node module executor (temporary .mjs file).
- * @param source - the complete TypeScript source to execute as a module.
- * @param options - run options; the `execute` executor is supplied automatically.
- * @returns the run result containing the module namespace and explicit outputs.
- */
-export declare function runFaqtsInNode(source: string, options?: Omit<FaqtsRunOptions, 'execute'>): Promise<FaqtsRunResult>;
-//# sourceMappingURL=node.d.ts.map

package/dist/faqts/node.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/faqts/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AACvD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAM,GAC7C,OAAO,CAAC,cAAc,CAAC,CAEzB"}

package/dist/faqts/node.js

@@ -1,23 +0,0 @@
-/**
- * faqts — Node 入口：@faicad/faijs/faqts/node
- *
- * 绑定 Node 执行器（临时 .mjs）。浏览器消费方务必从 .../faqts/browser 导入，
- * 避免静态引入 node:fs。
- */
-import { runFaqts } from './run.js';
-import { executeFaqtsModuleInNode } from './exec-node.js';
-export { transformFaqts } from './transform.js';
-export { findImports, rewriteImports } from './imports.js';
-export { runFaqts } from './run.js';
-export { executeFaqtsModuleInNode } from './exec-node.js';
-/**
- * Convenience entry point that runs `.ts` source end-to-end in a Node
- * environment, binding the Node module executor (temporary .mjs file).
- * @param source - the complete TypeScript source to execute as a module.
- * @param options - run options; the `execute` executor is supplied automatically.
- * @returns the run result containing the module namespace and explicit outputs.
- */
-export async function runFaqtsInNode(source, options = {}) {
-    return runFaqts(source, { ...options, execute: executeFaqtsModuleInNode });
-}
-//# sourceMappingURL=node.js.map

package/dist/faqts/node.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/faqts/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,UAA4C,EAAE;IAE9C,OAAO,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAA;AAC5E,CAAC","sourcesContent":["/**\n * faqts — Node 入口：@faicad/faijs/faqts/node\n *\n * 绑定 Node 执行器（临时 .mjs）。浏览器消费方务必从 .../faqts/browser 导入，\n * 避免静态引入 node:fs。\n */\n\nimport { runFaqts } from './run'\nimport { executeFaqtsModuleInNode } from './exec-node'\nimport type { FaqtsRunOptions, FaqtsRunResult } from './run'\n\nexport { transformFaqts } from './transform'\nexport type { FaqtsTransformOptions, FaqtsTransformResult } from './transform'\nexport { findImports, rewriteImports } from './imports'\nexport type { FaqtsImportSpan, FaqtsRewriteFn } from './imports'\nexport { runFaqts } from './run'\nexport type { FaqtsRunOptions, FaqtsRunResult } from './run'\nexport { executeFaqtsModuleInNode } from './exec-node'\n\n/**\n * Convenience entry point that runs `.ts` source end-to-end in a Node\n * environment, binding the Node module executor (temporary .mjs file).\n * @param source - the complete TypeScript source to execute as a module.\n * @param options - run options; the `execute` executor is supplied automatically.\n * @returns the run result containing the module namespace and explicit outputs.\n */\nexport async function runFaqtsInNode(\n  source: string,\n  options: Omit<FaqtsRunOptions, 'execute'> = {},\n): Promise<FaqtsRunResult> {\n  return runFaqts(source, { ...options, execute: executeFaqtsModuleInNode })\n}"]}

package/dist/faqts/run.d.ts

@@ -1,62 +0,0 @@
-/**
- * faits — 整段执行 Runner（Phase D, pipeline 第 4–5 步）
- *
- *   已去类型 + 说明符重写的模块代码
- *   → 执行器（浏览器 Blob URL / Node 临时 .mjs）import()
- *   → 收集显式声明的输出（export default / 具名 export）
- *
- * faq 与 faits 差异（plan §7.5 行 720–725）：
- *   faq → 逐语句 append/update/plan、DAG 自动推导、一行一 timeline
- *   faits → 整段一次执行、**显式声明输出**（无 DAG 自动推导）、不参与 timeline
- *
- * 输出约定：作者通过 `export default {part0: …, part1: …}` 或具名 export
- * 显式声明哪些产物是输出（由于无 IR，引擎不会猜测终端集）。本 runner 返回
- * 模块命名空间，并把 export default（若为对象）平铺为命名输出。
- *
- * 本文件无任何 Node 专属依赖：执行器（execute）由浏览器 Blob / Node 临时
- * 文件实现注入，见 exec-blob.ts / exec-node.ts。
- */
-import type { FaqtsRewriteFn } from './imports.js';
-/** 将"已转译 + 已重写"的模块代码执行一次，返回 ES 模块命名空间快照。 */
-export type FaqtsModuleExecutor = (jsCode: string) => Promise<Record<string, unknown>>;
-/**
- * Options controlling one full-module run through `runFaqts`.
- */
-export interface FaqtsRunOptions {
-    /** 导入重写钩子（裸说明符 → 宿主可解析的 URL）；默认保留。 */
-    rewrite?: FaqtsRewriteFn;
-    /** 相对说明符绝对化的基准 URL（默认取 process.cwd() + '/'） */
-    baseURL?: string | URL;
-    /** 转译选项透传（jsx 等） */
-    transform?: {
-        jsx?: boolean;
-    };
-    /** 模块执行器；默认未注入，由入口（browser/node）提供 */
-    execute?: FaqtsModuleExecutor;
-}
-/**
- * The outcome of executing one module: the full namespace plus the outputs the
- * author explicitly declared via `export default { ... }` and named exports.
- */
-export interface FaqtsRunResult {
-    /** 已执行的 ES 模块命名空间 */
-    namespace: Record<string, unknown>;
-    /** 显式输出：export default 为对象 → 展开；否则作为 default；具名 export 并入 */
-    outputs: Record<string, unknown>;
-}
-/**
- * 将完整的 `.ts` 源码作为单个 ES 模块执行一次。
- *
- * - 不建 IR、不逐语句执行、不接入 timeline
- * - 每次调用执行一份全新模块实例（执行器唯一 blob/temp 路径）
- */
-/**
- * Execute the complete `.ts` source as a single ES module once. No IR is
- * built, statements are not executed one by one, and no timeline is involved;
- * each call runs a fresh module instance.
- * @param source - the complete TypeScript source to execute.
- * @param options - run options including the mandatory `execute` executor.
- * @returns the run result with the module namespace and explicit outputs.
- */
-export declare function runFaqts(source: string, options?: FaqtsRunOptions): Promise<FaqtsRunResult>;
-//# sourceMappingURL=run.d.ts.map

package/dist/faqts/run.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/faqts/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;IACtB,oBAAoB;IACpB,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IAC7B,sCAAsC;IACtC,OAAO,CAAC,EAAE,mBAAmB,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CASrG"}

package/dist/faqts/run.js

@@ -1,62 +0,0 @@
-/**
- * faits — 整段执行 Runner（Phase D, pipeline 第 4–5 步）
- *
- *   已去类型 + 说明符重写的模块代码
- *   → 执行器（浏览器 Blob URL / Node 临时 .mjs）import()
- *   → 收集显式声明的输出（export default / 具名 export）
- *
- * faq 与 faits 差异（plan §7.5 行 720–725）：
- *   faq → 逐语句 append/update/plan、DAG 自动推导、一行一 timeline
- *   faits → 整段一次执行、**显式声明输出**（无 DAG 自动推导）、不参与 timeline
- *
- * 输出约定：作者通过 `export default {part0: …, part1: …}` 或具名 export
- * 显式声明哪些产物是输出（由于无 IR，引擎不会猜测终端集）。本 runner 返回
- * 模块命名空间，并把 export default（若为对象）平铺为命名输出。
- *
- * 本文件无任何 Node 专属依赖：执行器（execute）由浏览器 Blob / Node 临时
- * 文件实现注入，见 exec-blob.ts / exec-node.ts。
- */
-import { transformFaqts } from './transform.js';
-import { rewriteImports } from './imports.js';
-/**
- * 将完整的 `.ts` 源码作为单个 ES 模块执行一次。
- *
- * - 不建 IR、不逐语句执行、不接入 timeline
- * - 每次调用执行一份全新模块实例（执行器唯一 blob/temp 路径）
- */
-/**
- * Execute the complete `.ts` source as a single ES module once. No IR is
- * built, statements are not executed one by one, and no timeline is involved;
- * each call runs a fresh module instance.
- * @param source - the complete TypeScript source to execute.
- * @param options - run options including the mandatory `execute` executor.
- * @returns the run result with the module namespace and explicit outputs.
- */
-export async function runFaqts(source, options = {}) {
-    if (typeof options.execute !== 'function') {
-        throw new Error('runFaqts: 缺少 execute 执行器（浏览器用 exec-blob，Node 用 exec-node）');
-    }
-    const js = transformFaqts(source, options.transform).code;
-    const base = options.baseURL ?? (typeof process !== 'undefined' ? process.cwd() + '/' : undefined);
-    const code = rewriteImports(js, { rewrite: options.rewrite, baseURL: base });
-    const namespace = await options.execute(code);
-    return { namespace, outputs: collectOutputs(namespace) };
-}
-/** 显式输出收集：export default 是对象 → 展开为具名输出；否则作为 default。 */
-function collectOutputs(ns) {
-    const outputs = {};
-    const def = ns['default'];
-    if (def !== undefined && def !== null && typeof def === 'object' && !Array.isArray(def)) {
-        Object.assign(outputs, def);
-    }
-    else if (def !== undefined) {
-        outputs.default = def;
-    }
-    for (const key of Object.keys(ns)) {
-        if (key === 'default')
-            continue;
-        outputs[key] = ns[key];
-    }
-    return outputs;
-}
-//# sourceMappingURL=run.js.map

package/dist/faqts/run.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/faqts/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AA+B1C;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,UAA2B,EAAE;IAC1E,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IACD,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAA;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAClG,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IAC5E,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,EAAE,CAAA;AAC1D,CAAC;AAED,wDAAwD;AACxD,SAAS,cAAc,CAAC,EAA2B;IACjD,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IACzB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC7B,CAAC;SAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAA;IACvB,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC","sourcesContent":["/**\n * faits — 整段执行 Runner（Phase D, pipeline 第 4–5 步）\n *\n *   已去类型 + 说明符重写的模块代码\n *   → 执行器（浏览器 Blob URL / Node 临时 .mjs）import()\n *   → 收集显式声明的输出（export default / 具名 export）\n *\n * faq 与 faits 差异（plan §7.5 行 720–725）：\n *   faq → 逐语句 append/update/plan、DAG 自动推导、一行一 timeline\n *   faits → 整段一次执行、**显式声明输出**（无 DAG 自动推导）、不参与 timeline\n *\n * 输出约定：作者通过 `export default {part0: …, part1: …}` 或具名 export\n * 显式声明哪些产物是输出（由于无 IR，引擎不会猜测终端集）。本 runner 返回\n * 模块命名空间，并把 export default（若为对象）平铺为命名输出。\n *\n * 本文件无任何 Node 专属依赖：执行器（execute）由浏览器 Blob / Node 临时\n * 文件实现注入，见 exec-blob.ts / exec-node.ts。\n */\n\nimport { transformFaqts } from './transform'\nimport { rewriteImports } from './imports'\nimport type { FaqtsRewriteFn } from './imports'\n\n/** 将\"已转译 + 已重写\"的模块代码执行一次，返回 ES 模块命名空间快照。 */\nexport type FaqtsModuleExecutor = (jsCode: string) => Promise<Record<string, unknown>>\n\n/**\n * Options controlling one full-module run through `runFaqts`.\n */\nexport interface FaqtsRunOptions {\n  /** 导入重写钩子（裸说明符 → 宿主可解析的 URL）；默认保留。 */\n  rewrite?: FaqtsRewriteFn\n  /** 相对说明符绝对化的基准 URL（默认取 process.cwd() + '/'） */\n  baseURL?: string | URL\n  /** 转译选项透传（jsx 等） */\n  transform?: { jsx?: boolean }\n  /** 模块执行器；默认未注入，由入口（browser/node）提供 */\n  execute?: FaqtsModuleExecutor\n}\n\n/**\n * The outcome of executing one module: the full namespace plus the outputs the\n * author explicitly declared via `export default { ... }` and named exports.\n */\nexport interface FaqtsRunResult {\n  /** 已执行的 ES 模块命名空间 */\n  namespace: Record<string, unknown>\n  /** 显式输出：export default 为对象 → 展开；否则作为 default；具名 export 并入 */\n  outputs: Record<string, unknown>\n}\n\n/**\n * 将完整的 `.ts` 源码作为单个 ES 模块执行一次。\n *\n * - 不建 IR、不逐语句执行、不接入 timeline\n * - 每次调用执行一份全新模块实例（执行器唯一 blob/temp 路径）\n */\n/**\n * Execute the complete `.ts` source as a single ES module once. No IR is\n * built, statements are not executed one by one, and no timeline is involved;\n * each call runs a fresh module instance.\n * @param source - the complete TypeScript source to execute.\n * @param options - run options including the mandatory `execute` executor.\n * @returns the run result with the module namespace and explicit outputs.\n */\nexport async function runFaqts(source: string, options: FaqtsRunOptions = {}): Promise<FaqtsRunResult> {\n  if (typeof options.execute !== 'function') {\n    throw new Error('runFaqts: 缺少 execute 执行器（浏览器用 exec-blob，Node 用 exec-node）')\n  }\n  const js = transformFaqts(source, options.transform).code\n  const base = options.baseURL ?? (typeof process !== 'undefined' ? process.cwd() + '/' : undefined)\n  const code = rewriteImports(js, { rewrite: options.rewrite, baseURL: base })\n  const namespace = await options.execute(code)\n  return { namespace, outputs: collectOutputs(namespace) }\n}\n\n/** 显式输出收集：export default 是对象 → 展开为具名输出；否则作为 default。 */\nfunction collectOutputs(ns: Record<string, unknown>): Record<string, unknown> {\n  const outputs: Record<string, unknown> = {}\n  const def = ns['default']\n  if (def !== undefined && def !== null && typeof def === 'object' && !Array.isArray(def)) {\n    Object.assign(outputs, def)\n  } else if (def !== undefined) {\n    outputs.default = def\n  }\n  for (const key of Object.keys(ns)) {\n    if (key === 'default') continue\n    outputs[key] = ns[key]\n  }\n  return outputs\n}"]}

package/dist/faqts/transform.d.ts

@@ -1,43 +0,0 @@
-/**
- * faits — TypeScript 源码转译（Phase D, pipeline 第 1 步）
- *
- * 管线（plans/2026-08-29-faijs-module-runtime-plan.md §7.5）：
- *   .ts（faits 脚本） → 本模块：sucrase 去类型（保留行号）
- *   → acorn 解析 import → 说明符重写 → Blob → import() 整段执行
- *
- * 与 faijs 录制的 `.fai.js` 不同，faits 不建 IR、逐语句执行，而是
- * 整段一次性 import() 执行；DAG 活跃性不自动推导，输出由作者显式
- * export 声明（§7.5 行 723–724）。
- *
- * 此处只做"转译"，不含任何执行/几何依赖，Node 与浏览器通用。
- */
-/**
- * Options controlling the TypeScript-to-JavaScript transform.
- */
-export interface FaqtsTransformOptions {
-    /** 是否启用 JSX 转译（默认 false：纯 TS） */
-    jsx?: boolean;
-}
-/**
- * The result of transforming TypeScript source to plain JavaScript module code.
- */
-export interface FaqtsTransformResult {
-    /** 去类型后的纯 JS 模块代码（行号与源文件保持一致） */
-    code: string;
-}
-/**
- * 去除 TypeScript 类型（保留行号），返回可在浏览器/Node 运行的模块代码。
- *
- * - 不生成 source map（行号保留，错误定位足够）
- * - 仅 `transforms: ['typescript']`；若脚本含 JSX 需显式开启 `jsx`
- */
-/**
- * Strip TypeScript types (preserving line numbers) and return module code that
- * can run in the browser or Node. No source map is generated; only the
- * `typescript` transform runs unless `jsx` is explicitly enabled.
- * @param source - the TypeScript source text to transform.
- * @param options - transform options such as JSX enablement.
- * @returns the de-typed JavaScript module code.
- */
-export declare function transformFaqts(source: string, options?: FaqtsTransformOptions): FaqtsTransformResult;
-//# sourceMappingURL=transform.d.ts.map

package/dist/faqts/transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/faqts/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,oBAAoB,CAKxG"}

package/dist/faqts/transform.js

@@ -1,35 +0,0 @@
-/**
- * faits — TypeScript 源码转译（Phase D, pipeline 第 1 步）
- *
- * 管线（plans/2026-08-29-faijs-module-runtime-plan.md §7.5）：
- *   .ts（faits 脚本） → 本模块：sucrase 去类型（保留行号）
- *   → acorn 解析 import → 说明符重写 → Blob → import() 整段执行
- *
- * 与 faijs 录制的 `.fai.js` 不同，faits 不建 IR、逐语句执行，而是
- * 整段一次性 import() 执行；DAG 活跃性不自动推导，输出由作者显式
- * export 声明（§7.5 行 723–724）。
- *
- * 此处只做"转译"，不含任何执行/几何依赖，Node 与浏览器通用。
- */
-import { transform } from 'sucrase';
-/**
- * 去除 TypeScript 类型（保留行号），返回可在浏览器/Node 运行的模块代码。
- *
- * - 不生成 source map（行号保留，错误定位足够）
- * - 仅 `transforms: ['typescript']`；若脚本含 JSX 需显式开启 `jsx`
- */
-/**
- * Strip TypeScript types (preserving line numbers) and return module code that
- * can run in the browser or Node. No source map is generated; only the
- * `typescript` transform runs unless `jsx` is explicitly enabled.
- * @param source - the TypeScript source text to transform.
- * @param options - transform options such as JSX enablement.
- * @returns the de-typed JavaScript module code.
- */
-export function transformFaqts(source, options = {}) {
-    const js = transform(source, {
-        transforms: options.jsx ? ['typescript', 'jsx'] : ['typescript'],
-    }).code;
-    return { code: js };
-}
-//# sourceMappingURL=transform.js.map

package/dist/faqts/transform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/faqts/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAkBnC;;;;;GAKG;AACH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,UAAiC,EAAE;IAChF,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QAC3B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;KACjE,CAAC,CAAC,IAAI,CAAA;IACP,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;AACrB,CAAC","sourcesContent":["/**\n * faits — TypeScript 源码转译（Phase D, pipeline 第 1 步）\n *\n * 管线（plans/2026-08-29-faijs-module-runtime-plan.md §7.5）：\n *   .ts（faits 脚本） → 本模块：sucrase 去类型（保留行号）\n *   → acorn 解析 import → 说明符重写 → Blob → import() 整段执行\n *\n * 与 faijs 录制的 `.fai.js` 不同，faits 不建 IR、逐语句执行，而是\n * 整段一次性 import() 执行；DAG 活跃性不自动推导，输出由作者显式\n * export 声明（§7.5 行 723–724）。\n *\n * 此处只做\"转译\"，不含任何执行/几何依赖，Node 与浏览器通用。\n */\n\nimport { transform } from 'sucrase'\n\n/**\n * Options controlling the TypeScript-to-JavaScript transform.\n */\nexport interface FaqtsTransformOptions {\n  /** 是否启用 JSX 转译（默认 false：纯 TS） */\n  jsx?: boolean\n}\n\n/**\n * The result of transforming TypeScript source to plain JavaScript module code.\n */\nexport interface FaqtsTransformResult {\n  /** 去类型后的纯 JS 模块代码（行号与源文件保持一致） */\n  code: string\n}\n\n/**\n * 去除 TypeScript 类型（保留行号），返回可在浏览器/Node 运行的模块代码。\n *\n * - 不生成 source map（行号保留，错误定位足够）\n * - 仅 `transforms: ['typescript']`；若脚本含 JSX 需显式开启 `jsx`\n */\n/**\n * Strip TypeScript types (preserving line numbers) and return module code that\n * can run in the browser or Node. No source map is generated; only the\n * `typescript` transform runs unless `jsx` is explicitly enabled.\n * @param source - the TypeScript source text to transform.\n * @param options - transform options such as JSX enablement.\n * @returns the de-typed JavaScript module code.\n */\nexport function transformFaqts(source: string, options: FaqtsTransformOptions = {}): FaqtsTransformResult {\n  const js = transform(source, {\n    transforms: options.jsx ? ['typescript', 'jsx'] : ['typescript'],\n  }).code\n  return { code: js }\n}"]}

package/dist/lang/compile.d.ts

@@ -1,50 +0,0 @@
-/**
- * compile — ScriptIR → 零 import ESM 模块（VM 执行方案 Phase 1）
- *
- *
- * `compileToModule(script)` 把校验过的 ScriptIR IR 编译为**不含任何 import 语句**的
- * ESM 文本（`export const statements = [...]`）。产物零 import 是关键决策——Node 的
- * `data:` URL 与浏览器的 Blob URL 动态 import 都无法解析裸说明符，零 import 使模块在
- * 两个平台都能直接 `import()`，无需 import map / 打包器 / 文件系统。
- *
- * 编译规则：
- * - 每条语句一个 `{ id, deps, fn }`：`id` 是独立 StmtId（参数语句占 s1..sK，语句 s(K+1)..s(K+N)）；
- *   `deps` 由 parser 收集的 `stmt.refs`（inputs + $param + $geom.of + members）翻译为定义语句的 id；
- *   `fn` 是 `async (ctx, ns) => {...}`（ns = 命名空间集合，无隐式参数）。
- * - 参数即变量：`const r = 20` 编译为普通语句 `ctx.r = 20`。
- * - 变量引用编译为 `ctx.x`（持久变量容器，跨增量执行存活）。
- * - $param → `ctx.<name>`；$geom → `ns.cad.<feature>(ctx.<of>, ...)`；$asset → `await ns.cad.asset(key)`。
- * - 编译输入只有 IR，用户原文不进 VM（先解析后执行红线）。
- */
-import type { ScriptIR } from './types.js';
-import { type StmtId } from '../identity.js';
-/** 编译后单条语句的元数据（与模块文本中的 `{ id, deps, fn }` 并行）。 */
-export interface CompiledStatementMeta {
-    /** 独立 StmtId（模块语句 id） */
-    id: StmtId;
-    /** 依赖语句 id（定义被引用变量的语句） */
-    deps: StmtId[];
-    /** 本语句写入 ctx 的键（变量名）：普通语句 [id]、split 双输出、参数 [paramName]、add_constraint/do_assemble 空 */
-    writes: string[];
-    /** 在 script.statements 中的下标（参数语句为 undefined） */
-    sourceIndex?: number;
-}
-/** compileToModule 的返回：模块文本 + 并行元数据（供 ModuleExecutor 建 sourceById / reconcileCtx）。 */
-export interface CompiledModule {
-    code: string;
-    statements: CompiledStatementMeta[];
-}
-/**
- * 把 ScriptIR 编译为零 import ESM 模块文本 + 语句元数据。
- *
- * 同一份 ScriptIR 编译结果确定（StmtId 按语句顺序稳定分配）。
- */
-/**
- * Compile a validated ScriptIR into a zero-import ESM module text plus parallel
- * statement metadata. The output of compiling the same ScriptIR is
- * deterministic (StmtIds are assigned stably in statement order).
- * @param script - the validated ScriptIR to compile.
- * @returns the compiled module code and its statement metadata.
- */
-export declare function compileToModule(script: ScriptIR): CompiledModule;
-//# sourceMappingURL=compile.d.ts.map

package/dist/lang/compile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/lang/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAKV,QAAQ,EAIT,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AAInD,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,wFAAwF;IACxF,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,qBAAqB,EAAE,CAAA;CACpC;AAiQD;;;;GAIG;AACH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,cAAc,CAiFhE"}