@faicad/faijs 0.13.0

package/dist/node-host/cli-event-sink.d.ts

@@ -0,0 +1,25 @@
+import type { EventSink } from '../cad-runtime/ports.js';
+import type { PartName } from '../identity.js';
+/**
+ * CLI environment event notification sink.
+ *
+ * Collects events (matching NodeEventSink's accumulation behaviour) while also
+ * writing each event to stderr, so CLI users can see broken-chain notifications.
+ *
+ * Each event detail keeps only `partName` (§6.7).
+ */
+export declare class CliEventSink implements EventSink {
+    /** The collected events pushed so far. */
+    readonly events: Array<{
+        event: string;
+        detail: Record<string, unknown>;
+    }>;
+    emit(event: 'part-brep-lost', detail: {
+        partName: PartName;
+        callee: string;
+        reason: string;
+    }): void;
+    /** Clear all collected events. */
+    clear(): void;
+}
+//# sourceMappingURL=cli-event-sink.d.ts.map

package/dist/node-host/cli-event-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-event-sink.d.ts","sourceRoot":"","sources":["../../src/node-host/cli-event-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C;;;;;;;GAOG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAK;IAE/E,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMnG,kCAAkC;IAClC,KAAK,IAAI,IAAI;CAGd"}

package/dist/node-host/cli-event-sink.js

@@ -0,0 +1,22 @@
+/**
+ * CLI environment event notification sink.
+ *
+ * Collects events (matching NodeEventSink's accumulation behaviour) while also
+ * writing each event to stderr, so CLI users can see broken-chain notifications.
+ *
+ * Each event detail keeps only `partName` (§6.7).
+ */
+export class CliEventSink {
+    /** The collected events pushed so far. */
+    events = [];
+    emit(event, detail) {
+        this.events.push({ event, detail: { ...detail } });
+        // 写入 stderr（不干扰 stdout 的产物输出）
+        process.stderr.write(`[faijs] ${event}: callee="${detail.callee}", partName="${detail.partName}", reason="${detail.reason}"\n`);
+    }
+    /** Clear all collected events. */
+    clear() {
+        this.events.length = 0;
+    }
+}
+//# sourceMappingURL=cli-event-sink.js.map

package/dist/node-host/cli-event-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-event-sink.js","sourceRoot":"","sources":["../../src/node-host/cli-event-sink.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACvB,0CAA0C;IACjC,MAAM,GAA8D,EAAE,CAAA;IAE/E,IAAI,CAAC,KAAuB,EAAE,MAA8D;QAC1F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAA;QAClD,8BAA8B;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,aAAa,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,MAAM,KAAK,CAAC,CAAA;IACjI,CAAC;IAED,kCAAkC;IAClC,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IACxB,CAAC;CACF","sourcesContent":["import type { EventSink } from '../cad-runtime/ports'\nimport type { PartName } from '../identity'\n\n/**\n * CLI environment event notification sink.\n *\n * Collects events (matching NodeEventSink's accumulation behaviour) while also\n * writing each event to stderr, so CLI users can see broken-chain notifications.\n *\n * Each event detail keeps only `partName` (§6.7).\n */\nexport class CliEventSink implements EventSink {\n  /** The collected events pushed so far. */\n  readonly events: Array<{ event: string; detail: Record<string, unknown> }> = []\n\n  emit(event: 'part-brep-lost', detail: { partName: PartName; callee: string; reason: string }): void {\n    this.events.push({ event, detail: { ...detail } })\n    // 写入 stderr（不干扰 stdout 的产物输出）\n    process.stderr.write(`[faijs] ${event}: callee=\"${detail.callee}\", partName=\"${detail.partName}\", reason=\"${detail.reason}\"\\n`)\n  }\n\n  /** Clear all collected events. */\n  clear(): void {\n    this.events.length = 0\n  }\n}"]}

package/dist/node-host/cli.d.ts

@@ -0,0 +1,168 @@
+/**
+ * faijs-cli — CLI 逻辑（可导入、可测试）。第三方调用入口：packages/core/scripts/faijs-cli.ts。
+ * （仓库自用 doc/ci/开发脚本在根 scripts/ 与 packages/core/scripts/gen-*，见 scripts/README.md。）
+ *
+ *
+ * 命令：
+ *   check <file.fai.js>                 — dryRun：parse + schema + 引用预检
+ *   run <file.fai.js> --out <file>      — 执行并导出 STL/STEP
+ *   view <file.fai.js> --out <x.svg>    — 执行并投影输出视图 SVG（三视图/等轴测）
+ *
+ * 选项：
+ *   --mode <auto|brep|mesh>             — 执行模式（默认 auto；view 需要 BREP 路径）
+ *   --assets <dir>                      — 资产目录
+ *   --fonts <dir>                       — 额外字体目录
+ *   --part <name>                       — (view) 指定投影的 shape 变量名；缺省按终端自动选择
+ *   --view <front|back|top|bottom|left|right|iso|"x,y,z">
+ *                                       — (view) 单视图方向（默认 front）
+ *   --sheet <front,top,right,iso>       — (view) 多视图图纸（projectSheet；与 --view 互斥）
+ */
+import type { StdlibNamespace } from '../runtime-state.js';
+import type { ExecutionMode } from '../cad-runtime/ports.js';
+import type { ViewSpec } from '../api/view/view-camera.js';
+/** Options accepted by the `check` command. */
+export interface CliCheckOptions {
+    /** Asset directory used by the node ports. */
+    assetsDir?: string;
+    /** Extra fonts directory used by the node ports. */
+    fontsDir?: string;
+}
+/** Options accepted by the `run` command. */
+export interface CliRunOptions {
+    /** Execution mode ('auto' | 'brep' | 'mesh'). */
+    mode?: ExecutionMode;
+    /** Asset directory used by the node ports. */
+    assetsDir?: string;
+    /** Extra fonts directory used by the node ports. */
+    fontsDir?: string;
+    /** Default font path used by the node ports. */
+    defaultFontPath?: string;
+    /** Host-injected library namespace (includes cad — the CLI entry faijs-cli.ts passes createInternalStdlib; core does not assemble it by default). */
+    libs?: Record<string, StdlibNamespace>;
+    /**
+     * 项目根（多文件 §4.5）：相对 import 的解析基准，moduleKey = 相对它的路径。
+     * 缺省由入口文件向上找最近的 package.json。
+     */
+    projectRoot?: string;
+}
+/** Result of the `check` (dry-run validation) command. */
+export interface CliCheckResult {
+    /** Whether the validation passed. */
+    ok: boolean;
+    /** Validation errors found, one per stage. */
+    errors: Array<{
+        stage: string;
+        message: string;
+        line?: number;
+        stmtId?: string;
+    }>;
+    /** Non-fatal warnings reported during validation. */
+    warnings: string[];
+    /** Script-level summary when the script parsed successfully. */
+    script?: {
+        statements: number;
+        callees: string[];
+    };
+}
+/** Result of the `run` (execute and export) command. */
+export interface CliRunResult {
+    /** Whether execution and export succeeded. */
+    ok: boolean;
+    /** The written output file path. */
+    outputFile?: string;
+    /** The written output format ('stl' | 'step'). */
+    outputFormat?: string;
+    /** A human-readable error message when the command failed. */
+    error?: string;
+    /** Informational messages collected during execution. */
+    infos?: string[];
+}
+/** Options accepted by the `view` command. */
+export interface CliViewOptions {
+    /** Execution mode ('auto' | 'brep' | 'mesh'). view 需要 BREP 路径（mesh-only 无投影）。 */
+    mode?: ExecutionMode;
+    /** Asset directory used by the node ports. */
+    assetsDir?: string;
+    /** Extra fonts directory used by the node ports. */
+    fontsDir?: string;
+    /** Default font path used by the node ports. */
+    defaultFontPath?: string;
+    /** Host-injected library namespace (includes cad). */
+    libs?: Record<string, StdlibNamespace>;
+    /** Project root for relative .fai.js imports. */
+    projectRoot?: string;
+    /** Shape variable name to project; default resolves terminals like `run`. */
+    part?: string;
+    /** Single view direction (default 'front'); mutually exclusive with sheet. */
+    view?: ViewSpec;
+    /** Multi-view sheet list (projectSheet); mutually exclusive with view. */
+    sheet?: ViewSpec[];
+}
+/** Result of the `view` (execute and project SVG) command. */
+export interface CliViewResult {
+    /** Whether execution and projection succeeded. */
+    ok: boolean;
+    /** The written SVG file path(s). */
+    outputFiles?: string[];
+    /** A human-readable error message when the command failed. */
+    error?: string;
+    /** Informational messages collected during execution. */
+    infos?: string[];
+}
+/**
+ * Execute the `check` command: dry-run validate a .fai.js file.
+ *
+ * @param filePath - path to the .fai.js file to validate
+ * @param _opts - optional CLI check options (assets and fonts directories)
+ * @returns the check result with any validation errors
+ */
+export declare function cliCheck(filePath: string, _opts?: CliCheckOptions): CliCheckResult;
+/**
+ * Execute the `run` command: execute a .fai.js file and export STL/STEP.
+ *
+ * @param filePath - path to the .fai.js file to execute
+ * @param outPath - output file path for the exported result (extension determines format)
+ * @param opts - optional run options (mode, assets/fonts directories, injected libs)
+ * @returns the run result describing success or failure
+ */
+export declare function cliRun(filePath: string, outPath: string, opts?: CliRunOptions): Promise<CliRunResult>;
+/**
+ * Execute the `view` command: execute a .fai.js file and write view SVG(s).
+ *
+ * 投影在宿主侧进行：脚本只需建模（shape 变量或终端），CLI 调 projectView（--view，
+ * 缺省 front）或 projectSheet（--sheet）把 SVG 字符串写盘。view 需要 BREP 路径——
+ * mesh-only 的 shape 无 brep 槽，projectView 抛 E_BREP_ONLY_INPUT（提示 --mode brep/auto）。
+ *
+ * @param filePath - path to the .fai.js file to execute
+ * @param outPath - output SVG path (multiple shapes get `<out>_<i>_<name>.svg` suffixes)
+ * @param opts - optional view options (mode, part, view/sheet, assets/fonts dirs, libs)
+ * @returns the view result describing success or failure
+ */
+export declare function cliView(filePath: string, outPath: string, opts?: CliViewOptions): Promise<CliViewResult>;
+/**
+ * Parse command-line arguments.
+ *
+ * @param argv - the raw process argument list (index 0 = node, 1 = script)
+ * @returns the parsed command, file, and option values (command is null when unusable)
+ */
+export declare function parseArgs(argv: string[]): {
+    command: 'check' | 'run' | 'view' | null;
+    file?: string;
+    out?: string;
+    mode?: ExecutionMode;
+    assetsDir?: string;
+    fontsDir?: string;
+    projectRoot?: string;
+    view?: string;
+    sheet?: string;
+    part?: string;
+};
+/**
+ * CLI main entry point (called by scripts/faijs-cli.ts).
+ *
+ * @param argv - the raw process argument list
+ * @param libs - host-injected library namespace (includes cad — faijs-cli.ts passes createInternalStdlib; core does not assemble it by default)
+ * @returns the process exit code (0 on success, non-zero on failure)
+ */
+export declare function cliMain(argv: string[], libs?: Record<string, StdlibNamespace>): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/node-host/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/node-host/cli.ts"],"names":[],"mappings":"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"}