@faicad/faijs 0.13.0

package/dist/faqts/exec-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-node.js","sourceRoot":"","sources":["../../src/faqts/exec-node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,MAAc;IAC3D,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAA4B,CAAA;IAC/F,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,CAAC;AACH,CAAC","sourcesContent":["/**\n * faits — Node 执行器（整段 import() 一次执行）\n *\n * Node 侧 import() 从 data:/blob: URL 开始无法解析其中的相对说明符\n * （vitest/实验已验证），因此落到唯一临时 `.mjs` 文件，经 file: URL\n * import 一次。文件位于系统 tmp，执行后立即清理。\n */\n\nimport { writeFileSync, mkdtempSync, rmSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { tmpdir } from 'node:os'\nimport { pathToFileURL } from 'node:url'\n\n/**\n * Write module code to a unique temporary .mjs file and import it once,\n * returning the ES module namespace snapshot.\n * @param jsCode - the compiled, de-typed JavaScript module source to execute.\n * @returns the ES module namespace snapshot of the imported module.\n */\nexport async function executeFaqtsModuleInNode(jsCode: string): Promise<Record<string, unknown>> {\n  const dir = mkdtempSync(join(tmpdir(), 'faqts-'))\n  const file = join(dir, 'mod.mjs')\n  writeFileSync(file, jsCode, 'utf-8')\n  try {\n    return (await import(/* @vite-ignore */ pathToFileURL(file).href)) as Record<string, unknown>\n  } finally {\n    rmSync(dir, { recursive: true, force: true })\n  }\n}"]}

package/dist/faqts/imports.d.ts

@@ -0,0 +1,74 @@
+/**
+ * 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，避免丢注释/格式（保持行号定位）。
+ */
+/**
+ * The exact location of one static import declaration within module source,
+ * used to rewrite its specifier without rebuilding the AST.
+ */
+export interface FaqtsImportSpan {
+    /** import 声明的原始说明符，如 `./partner`、`@faqad/faqjs/sdk` */
+    specifier: string;
+    /** 说明符字符串在源码中的起始偏移（不含引号） */
+    start: number;
+    /** 说明符字符串在源码中的结束偏移（不含引号） */
+    end: number;
+    /** 是否裸说明符（既非相对路径也非绝对 URL） */
+    bare: boolean;
+}
+/**
+ * A host-provided rewrite hook that maps an import specifier to the URL the
+ * host can resolve. Returning `undefined` leaves the specifier unchanged.
+ */
+export type FaqtsRewriteFn = (specifier: string, ctx: {
+    bare: boolean;
+}) => string | undefined;
+/**
+ * 解析模块源码（必须是已去类型的 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 declare function findImports(code: string): FaqtsImportSpan[];
+/**
+ * 重写模块代码中的 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 declare function rewriteImports(code: string, options?: {
+    rewrite?: FaqtsRewriteFn;
+    baseURL?: string | URL;
+}): string;
+//# sourceMappingURL=imports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../src/faqts/imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,6BAA6B;IAC7B,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,MAAM,GAAG,SAAS,CAAA;AAK9F;;;;;GAKG;AACH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAa3D;AAMD;;;;;;;;;;GAUG;AACH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;CAClB,GACL,MAAM,CAuBR"}

package/dist/faqts/imports.js

@@ -0,0 +1,95 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,22 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,23 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,23 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,62 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,62 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,43 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,35 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/fcstd/build-fai-zip.d.ts

@@ -0,0 +1,29 @@
+/**
+ * M2.2/M2.3/M2.4 — .fai.zip builder.
+ *
+ * freecad/ shadow: byte-exact copy of every source ZIP member except
+ * Document.xml / GuiDocument.xml (kept too — nothing is dropped), verified by
+ * sha256 equality (V1). Baked geometry comes from the ZIP's .brp members
+ * directly (M2.3 — no FreeCAD runtime involved). Unit normalization (D7/M2.4):
+ * FCStd internal storage is mm, matching faijs; the units field records this.
+ */
+import { strToU8 } from 'fflate';
+import type { FcstdArchive } from './unpack.js';
+import { type FaiMapping } from './container.js';
+export interface FaiZipResult {
+    zip: Uint8Array;
+    manifest: unknown;
+    mapping: FaiMapping;
+    /** sha256 verification table for the freecad/ shadow (V1) */
+    shadowHashes: Record<string, {
+        source: string;
+        shadow: string;
+    }>;
+}
+export declare function buildFaiZip(source: FcstdArchive, sourceFileName: string): {
+    result?: FaiZipResult;
+    error?: string;
+};
+/** Re-export strToU8 for callers that need to embed text members. */
+export { strToU8 };
+//# sourceMappingURL=build-fai-zip.d.ts.map

package/dist/fcstd/build-fai-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-fai-zip.d.ts","sourceRoot":"","sources":["../../src/fcstd/build-fai-zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAW,OAAO,EAAE,MAAM,QAAQ,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAQD,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,GACrB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA6D3C;AAkBD,qEAAqE;AACrE,OAAO,EAAE,OAAO,EAAE,CAAC"}