@faicad/faijs-fcstd 0.17.0

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC9C,IAAI,OAAO,CAAC,EAAE,IAAI,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACxC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AACD,6EAA6E;AAC7E,yEAAyE;AACzE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AACzC,KAAK,IAAI,CAAC;AACV,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * fcstd CLI — batch driver entry: .FCStd → .fai.zip with a machine contract.\n *\n * Exit codes (plan §5.2):\n *   0 = converted; mapping final check passed (only translated /\n *       python-baked / preserved-only dispositions)\n *   2 = translation gaps (non-Python baked) — NO zip written\n *   1 = internal error (read/unpack/parse/codegen/container failure)\n *\n * stdout: exactly one JSON line (the summary). Human chatter is forbidden on\n * stdout; diagnostics go to stderr (which must stay empty on success).\n *\n * Run (published):  faijs-fcstd-convert <in.FCStd> [out.fai.zip]\n * Run (in-repo):    npm run fcstd:convert -w @faicad/faijs -- <in.FCStd> [out.fai.zip]\n * With no <out>, acts as a dry audit (no file written).\n */\nimport { writeFileSync } from 'node:fs';\nimport { convertFcstdFile } from './convert.js';\n\nconst [input, output] = process.argv.slice(2);\nif (!input) {\n  console.error('usage: faijs-fcstd-convert <in.FCStd> [out.fai.zip]');\n  process.exit(1);\n}\n\nconst summary = await convertFcstdFile(input);\nif (summary.ok && output && summary.zip) {\n  writeFileSync(output, summary.zip);\n}\n// stdout contract: ONE json line, no binary payload — zip bytes are stripped\n// before serialization (they are written to <out> above, never printed).\nconst { zip: _zip, ...report } = summary;\nvoid _zip;\nconsole.log(JSON.stringify(report));\n\nif (!summary.ok) {\n  process.exit(summary.gaps.length > 0 ? 2 : 1);\n}\n"]}

package/dist/codegen.d.ts

@@ -0,0 +1,83 @@
+/**
+ * M5 — code generation: object graph + M4 call plans → model/*.fai.js.
+ *
+ * M5.1 topological order: Body.Group order wins where present; otherwise
+ * PropertyLink dependency order. Cycles / missing deps → baked (no fallback
+ * heuristics — explicit downgrade per plan §12).
+ * M5.2 lowering: params → JS constants; calls → `const partN = await cad.x(...)`;
+ * statement ids sN. Sketch contours enter as blueprint literals.
+ *
+ * 本文件为 Placement 发射平台 `cad.place`（旋转四元数 + 平移，单点）、为产物聚合发射
+ * 平台 `cad.compound`（几何复合体，内核 `makeCompound`，持 OCCT 句柄）。这两个是 faijs
+ * 平台几何 op（H11，方案 §4），不再借用 `../3d_editor` 的 `cad.group` /
+ * `cad.translate` / `cad.rotate_euler`（编辑器交互 op，JSDoc 已 @deprecated）。
+ */
+import type { FcstdDocument } from './document.js';
+import type { CadCall } from './feature-translate.js';
+import type { FilletEdgeEntry } from './fillet-edges.js';
+import type { Contour } from './contour.js';
+import { type Placement } from './placement.js';
+/** Per-object codegen outcome: what was emitted for one FCStd object. */
+export interface GenObjectResult {
+    /** FCStd object name */
+    name: string;
+    /** FCStd type id */
+    type: string;
+    /** variable name bound in generated code (partN) or undefined when baked */
+    variable?: string;
+    calls: CadCall[];
+    disposition: 'translated' | 'baked' | 'preserved-only';
+    reason?: string;
+    /** M3 sketch verdict when the object is a sketch */
+    sketch?: {
+        level: 'L0' | 'L1' | 'L2';
+        reason?: string;
+        loopCount?: number;
+    };
+}
+/** Full codegen output: lowered calls, per-object ledger and generated script(s). */
+export interface GenResult {
+    /** ordered translated calls (dependency order) */
+    calls: CadCall[];
+    objects: GenObjectResult[];
+    /** generated .fai.js source (single-file mode or the main/aggregate script) */
+    code: string;
+    /** M10.3: multi-file mode — one script per Body with translated geometry.
+     * Empty in single-file mode. Paths are container-relative (model/<Name>.fai.js). */
+    files: {
+        path: string;
+        code: string;
+        body: string;
+    }[];
+    /** M10.3: variable in main.fai.js holding the grouped result (multi-file mode) */
+    rootVar?: string;
+}
+/**
+ * M5.1/M5.2 — translate every object in dependency order and lower to JS.
+ * `sketchVerdict` supplies the M3 outcome per sketch object name; sketches
+ * whose contour feeds a Pad/Pocket appear as inputs.
+ *
+ * @param doc parsed FCStd object graph to translate
+ * @param sketchVerdict per-sketch M3 verdict keyed by object name
+ * @param sketchContours solved contours per L0 sketch, keyed by object name
+ * @param baseName source base name used in generated file headers/labels
+ * @param placements per-object Placement used to re-orient placed geometry; missing → identity
+ * @param shapeCarriers objects whose Shape is a ZIP .brp member (pure-Shape carriers → shape-asset)
+ * @param brokenShapeAssets objects whose Shape `file` attribute points at a missing/empty member (explicit gap)
+ * @param filletEdgesData parsed PropertyFilletEdges binaries keyed by object name (Part::Chamfer/Fillet)
+ * @returns the lowered call plan, per-object dispositions and generated code
+ */
+export declare function generateModel(doc: FcstdDocument, sketchVerdict: Map<string, {
+    level: 'L0' | 'L1' | 'L2';
+    reason?: string;
+    loopCount?: number;
+}>, sketchContours: Map<string, Contour[]>, baseName: string, 
+/** M8.3: per-object Placement (sketches + features); missing → identity */
+placements?: Map<string, Placement>, 
+/** H7: objects whose Shape is a ZIP .brp member (pure-Shape carriers → shape-asset). */
+shapeCarriers?: ReadonlySet<string>, 
+/** E4: objects whose Shape `file` attribute points at a missing/empty member (explicit gap). */
+brokenShapeAssets?: ReadonlySet<string>, 
+/** P8: parsed PropertyFilletEdges binaries keyed by object name (Part::Chamfer/Fillet). */
+filletEdgesData?: ReadonlyMap<string, FilletEdgeEntry[]>): GenResult;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,wBAAwB,CAAC;AAExE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,KAAK,SAAS,EAA6C,MAAM,gBAAgB,CAAC;AAG3F,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,EAAE,YAAY,GAAG,OAAO,GAAG,gBAAgB,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb;wFACoF;IACpF,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACtD,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9F,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EACtC,QAAQ,EAAE,MAAM;AAChB,2EAA2E;AAC3E,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;AACnC,wFAAwF;AACxF,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AACnC,gGAAgG;AAChG,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AACvC,2FAA2F;AAC3F,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GACvD,SAAS,CAyaX"}