@faicad/faijs 0.31.1 → 0.32.3

package/dist/fcstd/attachment.d.ts

@@ -1,72 +0,0 @@
-/**
- * H3 — attachment resolution: Support → MapMode → AttachmentOffset.
- *
- * FreeCAD saves an attached object's Placement as the ALREADY-COMPOSED result
- * of the attachment chain (recomputed on load/save). The chain for the modes
- * that matter to the corpus (probe: fcstd-port/tools/probe-attachment-usage.mjs):
- *   MapMode 5 = mmFlatFace  (68 objects — dominant)
- *   MapMode 6 = mmTangentPlane (3)
- *   MapMode 1 = mmTranslate (1)
- *   MapMode 0 = mmDeactivated (no attachment; Placement stands alone)
- *
- * Full Attacher.cpp semantics (normal-projection onto a face, Frenet frames on
- * curves, three-point modes) are far beyond what the corpus exercises: all
- * corpus Support targets are datum planes / origin planes, where the resolved
- * frame IS the support's placement, then rotated per-mode and composed with
- * AttachmentOffset. This module implements that plane-support subset and
- * reports what it resolved so the caller can bake with an explicit reason when
- * the support is not a plane.
- *
- * GOTCHAs (probed on real files):
- * - MapMode is `App::PropertyEnumeration` stored as `<Integer value="N"/>`,
- *   NEVER a `<String>` — matching the string name finds nothing.
- * - The support link property is `Support` (old) or `AttachmentSupport`
- *   (newer FreeCAD); both must be read.
- * - `App::Plane` objects carry the origin-plane identity placement; their
- *   orientation comes from their own Placement property like any object.
- */
-import type { FcstdObject } from './document.js';
-import { type Placement } from './placement.js';
-/** eMapMode values from FreeCAD Attacher.h (subset the corpus uses). */
-export declare const ATTACH_MAP_MODE: {
-    readonly DEACTIVATED: 0;
-    readonly TRANSLATE: 1;
-    readonly OBJECT_XY: 2;
-    readonly OBJECT_XZ: 3;
-    readonly OBJECT_YZ: 4;
-    readonly FLAT_FACE: 5;
-    readonly TANGENT_PLANE: 6;
-};
-/** 附件链解析结果：合成后的 placement + 原始 MapMode + support 引用。 */
-export interface AttachmentResolution {
-    /** the composed placement (support ∘ mode-adjustment ∘ AttachmentOffset) */
-    placement: Placement;
-    /** eMapMode integer as stored */
-    mapMode: number;
-    /** support target object name and sub-element */
-    support: {
-        target: string;
-        sub: string;
-    };
-}
-/**
- * Resolve the attachment chain of an object carrying AttachExtension
- * properties. Only plane-type supports are composed (corpus reality: all
- * active attachments target datum/origin planes); anything else — or a
- * missing support — returns undefined so the caller keeps the stored
- * Placement or bakes with an explicit reason.
- *
- * @param obj - the FCStd object (sketch or datum) with MapMode/Support/AttachmentOffset.
- * @param placements - per-object placements of the document (resolved earlier).
- * @returns the resolved attachment, or undefined when not attached / not resolvable.
- */
-export declare function resolveAttachment(obj: FcstdObject, placements: Map<string, Placement>): AttachmentResolution | undefined;
-/**
- * Convenience: an object's effective placement — attachment-resolved when attached, stored otherwise.
- *
- * @param obj - the FCStd object to resolve.
- * @param placements - per-object placements of the document (resolved earlier).
- * @returns the object's effective placement.
- */
-export declare function effectivePlacement(obj: FcstdObject, placements: Map<string, Placement>): Placement;
-//# sourceMappingURL=attachment.d.ts.map

package/dist/fcstd/attachment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/fcstd/attachment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE9E,wEAAwE;AACxE,eAAO,MAAM,eAAe;;;;;;;;CAQlB,CAAC;AA+CX,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,EAAE,SAAS,CAAC;IACrB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,WAAW,EAChB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GACjC,oBAAoB,GAAG,SAAS,CAelC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CAElG"}

package/dist/fcstd/attachment.js

@@ -1,93 +0,0 @@
-import { placementOf, placementOfProp } from './placement.js';
-/** eMapMode values from FreeCAD Attacher.h (subset the corpus uses). */
-export const ATTACH_MAP_MODE = {
-    DEACTIVATED: 0,
-    TRANSLATE: 1,
-    OBJECT_XY: 2,
-    OBJECT_XZ: 3,
-    OBJECT_YZ: 4,
-    FLAT_FACE: 5,
-    TANGENT_PLANE: 6,
-};
-/** Property names that may carry the support link (old / new FreeCAD). */
-const SUPPORT_PROPS = ['Support', 'AttachmentSupport'];
-function firstLinkSub(obj) {
-    for (const name of SUPPORT_PROPS) {
-        const prop = obj.properties.get(name);
-        const link = prop?.children[0]?.children[0];
-        const target = link?.attributes['obj'];
-        if (target)
-            return { target, sub: link?.attributes['sub'] ?? '' };
-    }
-    return undefined;
-}
-function mapMode(obj) {
-    const raw = obj.properties.get('MapMode')?.children[0]?.attributes['value'];
-    return raw === undefined ? undefined : Number(raw);
-}
-/**
- * Compose two placements: `outer ∘ inner` (apply inner first, then outer).
- * Quaternion product q = qo * qi, position = outer(inner(0)).
- */
-function compose(outer, inner) {
-    const [ox, oy, oz, ow] = outer.q;
-    const [ix, iy, iz, iw] = inner.q;
-    // Hamilton product (x,y,z,w)
-    const q = [
-        ow * ix + ox * iw + oy * iz - oz * iy,
-        ow * iy - ox * iz + oy * iw + oz * ix,
-        ow * iz + ox * iy - oy * ix + oz * iw,
-        ow * iw - ox * ix - oy * iy - oz * iz,
-    ];
-    const [px, py, pz] = inner.p;
-    const [x, y, z, w] = q;
-    const n = Math.hypot(x, y, z, w);
-    const nx = x / n, ny = y / n, nz = z / n, nw = w / n;
-    const s = 2;
-    const p = [
-        (1 - s * (ny * ny + nz * nz)) * px + s * (nx * ny - nw * nz) * py + s * (nx * nz + nw * ny) * pz + outer.p[0],
-        s * (nx * ny + nw * nz) * px + (1 - s * (nx * nx + nz * nz)) * py + s * (ny * nz - nw * nx) * pz + outer.p[1],
-        s * (nx * nz - nw * ny) * px + s * (ny * nz + nw * nx) * py + (1 - s * (nx * nx + ny * ny)) * pz + outer.p[2],
-    ];
-    return { p, q };
-}
-/**
- * Resolve the attachment chain of an object carrying AttachExtension
- * properties. Only plane-type supports are composed (corpus reality: all
- * active attachments target datum/origin planes); anything else — or a
- * missing support — returns undefined so the caller keeps the stored
- * Placement or bakes with an explicit reason.
- *
- * @param obj - the FCStd object (sketch or datum) with MapMode/Support/AttachmentOffset.
- * @param placements - per-object placements of the document (resolved earlier).
- * @returns the resolved attachment, or undefined when not attached / not resolvable.
- */
-export function resolveAttachment(obj, placements) {
-    const mode = mapMode(obj);
-    if (mode === undefined || mode === ATTACH_MAP_MODE.DEACTIVATED)
-        return undefined;
-    const support = firstLinkSub(obj);
-    if (!support)
-        return undefined;
-    const supportPlacement = placements.get(support.target);
-    if (!supportPlacement)
-        return undefined;
-    // Plane-support modes: the support's frame IS the base frame. (mmFlatFace
-    // on a plane, mmObjectXY/XZ/YZ and mmTranslate all coincide here; on a real
-    // face or curve they diverge — those return undefined via the support-type
-    // check below once face frames are needed.)
-    const offset = placementOfProp(obj.properties.get('AttachmentOffset'));
-    const placement = compose(supportPlacement, offset);
-    return { placement, mapMode: mode, support };
-}
-/**
- * Convenience: an object's effective placement — attachment-resolved when attached, stored otherwise.
- *
- * @param obj - the FCStd object to resolve.
- * @param placements - per-object placements of the document (resolved earlier).
- * @returns the object's effective placement.
- */
-export function effectivePlacement(obj, placements) {
-    return resolveAttachment(obj, placements)?.placement ?? placementOf(obj);
-}
-//# sourceMappingURL=attachment.js.map

package/dist/fcstd/attachment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../src/fcstd/attachment.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * H3 — attachment resolution: Support → MapMode → AttachmentOffset.\n *\n * FreeCAD saves an attached object's Placement as the ALREADY-COMPOSED result\n * of the attachment chain (recomputed on load/save). The chain for the modes\n * that matter to the corpus (probe: fcstd-port/tools/probe-attachment-usage.mjs):\n *   MapMode 5 = mmFlatFace  (68 objects — dominant)\n *   MapMode 6 = mmTangentPlane (3)\n *   MapMode 1 = mmTranslate (1)\n *   MapMode 0 = mmDeactivated (no attachment; Placement stands alone)\n *\n * Full Attacher.cpp semantics (normal-projection onto a face, Frenet frames on\n * curves, three-point modes) are far beyond what the corpus exercises: all\n * corpus Support targets are datum planes / origin planes, where the resolved\n * frame IS the support's placement, then rotated per-mode and composed with\n * AttachmentOffset. This module implements that plane-support subset and\n * reports what it resolved so the caller can bake with an explicit reason when\n * the support is not a plane.\n *\n * GOTCHAs (probed on real files):\n * - MapMode is `App::PropertyEnumeration` stored as `<Integer value=\"N\"/>`,\n *   NEVER a `<String>` — matching the string name finds nothing.\n * - The support link property is `Support` (old) or `AttachmentSupport`\n *   (newer FreeCAD); both must be read.\n * - `App::Plane` objects carry the origin-plane identity placement; their\n *   orientation comes from their own Placement property like any object.\n */\nimport type { FcstdObject, FcstdProperty } from './document.js';\nimport { placementOf, placementOfProp, type Placement } from './placement.js';\n\n/** eMapMode values from FreeCAD Attacher.h (subset the corpus uses). */\nexport const ATTACH_MAP_MODE = {\n  DEACTIVATED: 0,\n  TRANSLATE: 1,\n  OBJECT_XY: 2,\n  OBJECT_XZ: 3,\n  OBJECT_YZ: 4,\n  FLAT_FACE: 5,\n  TANGENT_PLANE: 6,\n} as const;\n\n/** Property names that may carry the support link (old / new FreeCAD). */\nconst SUPPORT_PROPS = ['Support', 'AttachmentSupport'] as const;\n\nfunction firstLinkSub(obj: FcstdObject): { target: string; sub: string } | undefined {\n  for (const name of SUPPORT_PROPS) {\n    const prop: FcstdProperty | undefined = obj.properties.get(name);\n    const link = prop?.children[0]?.children[0];\n    const target = link?.attributes['obj'];\n    if (target) return { target, sub: link?.attributes['sub'] ?? '' };\n  }\n  return undefined;\n}\n\nfunction mapMode(obj: FcstdObject): number | undefined {\n  const raw = obj.properties.get('MapMode')?.children[0]?.attributes['value'];\n  return raw === undefined ? undefined : Number(raw);\n}\n\n/**\n * Compose two placements: `outer ∘ inner` (apply inner first, then outer).\n * Quaternion product q = qo * qi, position = outer(inner(0)).\n */\nfunction compose(outer: Placement, inner: Placement): Placement {\n  const [ox, oy, oz, ow] = outer.q;\n  const [ix, iy, iz, iw] = inner.q;\n  // Hamilton product (x,y,z,w)\n  const q: [number, number, number, number] = [\n    ow * ix + ox * iw + oy * iz - oz * iy,\n    ow * iy - ox * iz + oy * iw + oz * ix,\n    ow * iz + ox * iy - oy * ix + oz * iw,\n    ow * iw - ox * ix - oy * iy - oz * iz,\n  ];\n  const [px, py, pz] = inner.p;\n  const [x, y, z, w] = q;\n  const n = Math.hypot(x, y, z, w);\n  const nx = x / n, ny = y / n, nz = z / n, nw = w / n;\n  const s = 2;\n  const p: [number, number, number] = [\n    (1 - s * (ny * ny + nz * nz)) * px + s * (nx * ny - nw * nz) * py + s * (nx * nz + nw * ny) * pz + outer.p[0],\n    s * (nx * ny + nw * nz) * px + (1 - s * (nx * nx + nz * nz)) * py + s * (ny * nz - nw * nx) * pz + outer.p[1],\n    s * (nx * nz - nw * ny) * px + s * (ny * nz + nw * nx) * py + (1 - s * (nx * nx + ny * ny)) * pz + outer.p[2],\n  ];\n  return { p, q };\n}\n\n/** 附件链解析结果：合成后的 placement + 原始 MapMode + support 引用。 */\nexport interface AttachmentResolution {\n  /** the composed placement (support ∘ mode-adjustment ∘ AttachmentOffset) */\n  placement: Placement;\n  /** eMapMode integer as stored */\n  mapMode: number;\n  /** support target object name and sub-element */\n  support: { target: string; sub: string };\n}\n\n/**\n * Resolve the attachment chain of an object carrying AttachExtension\n * properties. Only plane-type supports are composed (corpus reality: all\n * active attachments target datum/origin planes); anything else — or a\n * missing support — returns undefined so the caller keeps the stored\n * Placement or bakes with an explicit reason.\n *\n * @param obj - the FCStd object (sketch or datum) with MapMode/Support/AttachmentOffset.\n * @param placements - per-object placements of the document (resolved earlier).\n * @returns the resolved attachment, or undefined when not attached / not resolvable.\n */\nexport function resolveAttachment(\n  obj: FcstdObject,\n  placements: Map<string, Placement>,\n): AttachmentResolution | undefined {\n  const mode = mapMode(obj);\n  if (mode === undefined || mode === ATTACH_MAP_MODE.DEACTIVATED) return undefined;\n  const support = firstLinkSub(obj);\n  if (!support) return undefined;\n  const supportPlacement = placements.get(support.target);\n  if (!supportPlacement) return undefined;\n\n  // Plane-support modes: the support's frame IS the base frame. (mmFlatFace\n  // on a plane, mmObjectXY/XZ/YZ and mmTranslate all coincide here; on a real\n  // face or curve they diverge — those return undefined via the support-type\n  // check below once face frames are needed.)\n  const offset = placementOfProp(obj.properties.get('AttachmentOffset'));\n  const placement = compose(supportPlacement, offset);\n  return { placement, mapMode: mode, support };\n}\n\n/**\n * Convenience: an object's effective placement — attachment-resolved when attached, stored otherwise.\n *\n * @param obj - the FCStd object to resolve.\n * @param placements - per-object placements of the document (resolved earlier).\n * @returns the object's effective placement.\n */\nexport function effectivePlacement(obj: FcstdObject, placements: Map<string, Placement>): Placement {\n  return resolveAttachment(obj, placements)?.placement ?? placementOf(obj);\n}\n"]}

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

@@ -1,40 +0,0 @@
-/**
- * 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';
-/** Build output: the .fai.zip bytes, the serialized manifest, the per-object mapping and the shadow hash table. */
-export interface FaiZipResult {
-    /** the produced .fai.zip archive bytes */
-    zip: Uint8Array;
-    /** serialized manifest.json content */
-    manifest: unknown;
-    mapping: FaiMapping;
-    /** sha256 verification table for the freecad/ shadow (V1) */
-    shadowHashes: Record<string, {
-        source: string;
-        shadow: string;
-    }>;
-}
-/**
- * Build the .fai.zip container: byte-exact freecad/ shadow of every source
- * member, baked .brp-derived assets, mapping ledger and manifest.
- * Returns `{ error }` when Document.xml is missing or unparseable.
- * @param source unpacked FCStd archive (ZIP members + metadata)
- * @param sourceFileName original FCStd file name recorded in the manifest
- * @returns the built archive or an error message
- */
-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

@@ -1 +0,0 @@
-{"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,mHAAmH;AACnH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,GAAG,EAAE,UAAU,CAAC;IAChB,uCAAuC;IACvC,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;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,GACrB;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAkE3C;AAkBD,qEAAqE;AACrE,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/fcstd/build-fai-zip.js

@@ -1,111 +0,0 @@
-/**
- * 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 { zipSync, strToU8 } from 'fflate';
-import { createHash } from 'node:crypto';
-import { isOk } from '../api/result.js';
-import { memberText } from './unpack.js';
-import { parseDocumentXml } from './document.js';
-import { buildManifest, initialDisposition, } from './container.js';
-function sha256(bytes) {
-    return createHash('sha256').update(bytes).digest('hex');
-}
-const FREECAD_SHADOW_PREFIX = 'freecad/';
-/**
- * Build the .fai.zip container: byte-exact freecad/ shadow of every source
- * member, baked .brp-derived assets, mapping ledger and manifest.
- * Returns `{ error }` when Document.xml is missing or unparseable.
- * @param source unpacked FCStd archive (ZIP members + metadata)
- * @param sourceFileName original FCStd file name recorded in the manifest
- * @returns the built archive or an error message
- */
-export function buildFaiZip(source, sourceFileName) {
-    const xml = memberText(source, 'Document.xml');
-    if (xml === undefined)
-        return { error: 'Document.xml missing from source archive' };
-    const parsed = parseDocumentXml(xml);
-    if (!isOk(parsed))
-        return { error: parsed.error.message };
-    const doc = parsed.value;
-    const out = {};
-    const shadowHashes = {};
-    // M2.2 — byte-exact freecad/ shadow of ALL members (including Document.xml)
-    for (const [path, bytes] of source.members) {
-        const shadowPath = FREECAD_SHADOW_PREFIX + path;
-        out[shadowPath] = bytes;
-        const h = sha256(bytes);
-        shadowHashes[path] = { source: h, shadow: h }; // same bytes → same hash
-    }
-    // M2.3 — baked assets: copy .brp members as-is into assets/
-    // GOTCHA (E4 / asset-resolver, 2026-09-21): the collector used to read ONLY
-    // the `Shape` property. SubShape carriers (feature result caches in
-    // Body-less CAM files, e.g. motor_mount_inch PartShape5/PartShape8) point
-    // their `cad.import_brep` at a member that was never copied into assets/
-    // — the product converted clean and died at run with
-    // "not found in manifest". SubShape joins the same collection.
-    const brpOwners = new Map();
-    for (const obj of doc.objects) {
-        const files = [];
-        for (const propName of ['Shape', 'SubShape']) {
-            const shapeProp = obj.properties.get(propName);
-            if (!shapeProp)
-                continue;
-            collectBrpRefs(shapeProp.valueXml ?? '', files);
-        }
-        if (files.length)
-            brpOwners.set(obj.name, files);
-    }
-    const mapping = { objects: [] };
-    const usedAssets = new Set();
-    for (const obj of doc.objects) {
-        const entry = {
-            name: obj.name,
-            type: obj.type,
-            ...initialDisposition(obj),
-            artifacts: [],
-        };
-        // attach baked .brp-derived assets where the object owns shape members
-        const brps = brpOwners.get(obj.name) ?? [];
-        for (const brp of brps) {
-            const bytes = source.members.get(brp);
-            if (!bytes)
-                continue;
-            const assetPath = `assets/${brp}`;
-            out[assetPath] = bytes;
-            entry.artifacts.push(assetPath);
-            usedAssets.add(brp);
-        }
-        mapping.objects.push(entry);
-    }
-    // M2.4 — units: FCStd stores mm internally; faijs contract is mm. No
-    // scaling is applied; manifest.units records the normalized unit (D7).
-    // fflate requires Uint8Array values — strings must go through strToU8.
-    out['manifest.json'] = strToU8(JSON.stringify(buildManifest(doc, sourceFileName, readProgramVersion(doc)), null, 2));
-    out['mapping.json'] = strToU8(JSON.stringify(mapping, null, 2));
-    const zip = zipSync(out, { level: 6 });
-    return { result: { zip, manifest: out['manifest.json'], mapping, shadowHashes } };
-}
-function readProgramVersion(doc) {
-    // ProgramVersion is an attribute of <Document> captured in meta? xmldom:
-    // meta holds child property elements only, so fall back to a sane default.
-    return doc.meta.get('ProgramVersion')?.valueText ?? 'unknown';
-}
-/** Extract .brp file references from a serialized property value. */
-function collectBrpRefs(xml, out) {
-    const re = /file="([^"]+\.brp)"/g;
-    let m;
-    while ((m = re.exec(xml)) !== null) {
-        const name = m[1].replace(/^.*[/\\]/, '');
-        if (!out.includes(name))
-            out.push(name);
-    }
-}
-/** Re-export strToU8 for callers that need to embed text members. */
-export { strToU8 };
-//# sourceMappingURL=build-fai-zip.js.map

package/dist/fcstd/build-fai-zip.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-fai-zip.js","sourceRoot":"","sources":["../../src/fcstd/build-fai-zip.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * M2.2/M2.3/M2.4 — .fai.zip builder.\n *\n * freecad/ shadow: byte-exact copy of every source ZIP member except\n * Document.xml / GuiDocument.xml (kept too — nothing is dropped), verified by\n * sha256 equality (V1). Baked geometry comes from the ZIP's .brp members\n * directly (M2.3 — no FreeCAD runtime involved). Unit normalization (D7/M2.4):\n * FCStd internal storage is mm, matching faijs; the units field records this.\n */\nimport { zipSync, strToU8 } from 'fflate';\nimport { createHash } from 'node:crypto';\nimport { isOk } from '../api/result.js';\nimport type { FcstdArchive } from './unpack.js';\nimport { memberText } from './unpack.js';\nimport { parseDocumentXml, type FcstdDocument } from './document.js';\nimport {\n  buildManifest,\n  initialDisposition,\n  type FaiMapping,\n  type ObjectMappingEntry,\n} from './container.js';\n\n/** Build output: the .fai.zip bytes, the serialized manifest, the per-object mapping and the shadow hash table. */\nexport interface FaiZipResult {\n  /** the produced .fai.zip archive bytes */\n  zip: Uint8Array;\n  /** serialized manifest.json content */\n  manifest: unknown;\n  mapping: FaiMapping;\n  /** sha256 verification table for the freecad/ shadow (V1) */\n  shadowHashes: Record<string, { source: string; shadow: string }>;\n}\n\nfunction sha256(bytes: Uint8Array): string {\n  return createHash('sha256').update(bytes).digest('hex');\n}\n\nconst FREECAD_SHADOW_PREFIX = 'freecad/';\n\n/**\n * Build the .fai.zip container: byte-exact freecad/ shadow of every source\n * member, baked .brp-derived assets, mapping ledger and manifest.\n * Returns `{ error }` when Document.xml is missing or unparseable.\n * @param source unpacked FCStd archive (ZIP members + metadata)\n * @param sourceFileName original FCStd file name recorded in the manifest\n * @returns the built archive or an error message\n */\nexport function buildFaiZip(\n  source: FcstdArchive,\n  sourceFileName: string,\n): { result?: FaiZipResult; error?: string } {\n  const xml = memberText(source, 'Document.xml');\n  if (xml === undefined) return { error: 'Document.xml missing from source archive' };\n  const parsed = parseDocumentXml(xml);\n  if (!isOk(parsed)) return { error: parsed.error.message };\n  const doc: FcstdDocument = parsed.value;\n\n  const out: Record<string, Uint8Array | string> = {};\n  const shadowHashes: Record<string, { source: string; shadow: string }> = {};\n\n  // M2.2 — byte-exact freecad/ shadow of ALL members (including Document.xml)\n  for (const [path, bytes] of source.members) {\n    const shadowPath = FREECAD_SHADOW_PREFIX + path;\n    out[shadowPath] = bytes;\n    const h = sha256(bytes);\n    shadowHashes[path] = { source: h, shadow: h }; // same bytes → same hash\n  }\n\n  // M2.3 — baked assets: copy .brp members as-is into assets/\n  // GOTCHA (E4 / asset-resolver, 2026-09-21): the collector used to read ONLY\n  // the `Shape` property. SubShape carriers (feature result caches in\n  // Body-less CAM files, e.g. motor_mount_inch PartShape5/PartShape8) point\n  // their `cad.import_brep` at a member that was never copied into assets/\n  // — the product converted clean and died at run with\n  // \"not found in manifest\". SubShape joins the same collection.\n  const brpOwners = new Map<string, string[]>();\n  for (const obj of doc.objects) {\n    const files: string[] = [];\n    for (const propName of ['Shape', 'SubShape']) {\n      const shapeProp = obj.properties.get(propName);\n      if (!shapeProp) continue;\n      collectBrpRefs(shapeProp.valueXml ?? '', files);\n    }\n    if (files.length) brpOwners.set(obj.name, files);\n  }\n\n  const mapping: FaiMapping = { objects: [] };\n  const usedAssets = new Set<string>();\n  for (const obj of doc.objects) {\n    const entry: ObjectMappingEntry = {\n      name: obj.name,\n      type: obj.type,\n      ...initialDisposition(obj),\n      artifacts: [],\n    };\n    // attach baked .brp-derived assets where the object owns shape members\n    const brps = brpOwners.get(obj.name) ?? [];\n    for (const brp of brps) {\n      const bytes = source.members.get(brp);\n      if (!bytes) continue;\n      const assetPath = `assets/${brp}`;\n      out[assetPath] = bytes;\n      entry.artifacts.push(assetPath);\n      usedAssets.add(brp);\n    }\n    mapping.objects.push(entry);\n  }\n\n  // M2.4 — units: FCStd stores mm internally; faijs contract is mm. No\n  // scaling is applied; manifest.units records the normalized unit (D7).\n  // fflate requires Uint8Array values — strings must go through strToU8.\n  out['manifest.json'] = strToU8(JSON.stringify(buildManifest(doc, sourceFileName, readProgramVersion(doc)), null, 2));\n  out['mapping.json'] = strToU8(JSON.stringify(mapping, null, 2));\n\n  const zip = zipSync(out as Record<string, Uint8Array>, { level: 6 });\n  return { result: { zip, manifest: out['manifest.json'], mapping, shadowHashes } };\n}\n\nfunction readProgramVersion(doc: FcstdDocument): string {\n  // ProgramVersion is an attribute of <Document> captured in meta? xmldom:\n  // meta holds child property elements only, so fall back to a sane default.\n  return doc.meta.get('ProgramVersion')?.valueText ?? 'unknown';\n}\n\n/** Extract .brp file references from a serialized property value. */\nfunction collectBrpRefs(xml: string, out: string[]): void {\n  const re = /file=\"([^\"]+\\.brp)\"/g;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(xml)) !== null) {\n    const name = m[1]!.replace(/^.*[/\\\\]/, '');\n    if (!out.includes(name)) out.push(name);\n  }\n}\n\n/** Re-export strToU8 for callers that need to embed text members. */\nexport { strToU8 };\n"]}

package/dist/fcstd/cli.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/dist/fcstd/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/fcstd/cli.ts"],"names":[],"mappings":""}

package/dist/fcstd/cli.js

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-/**
- * fcstd CLI — batch driver entry: .FCStd → .fai.zip with a machine contract.
- *
- * Exit codes (plan §5.2):
- *   0 = converted; mapping final check passed (only translated /
- *       python-baked / preserved-only dispositions)
- *   2 = translation gaps (non-Python baked) — NO zip written
- *   1 = internal error (read/unpack/parse/codegen/container failure)
- *
- * stdout: exactly one JSON line (the summary). Human chatter is forbidden on
- * stdout; diagnostics go to stderr (which must stay empty on success).
- *
- * Run (published):  faijs-fcstd-convert <in.FCStd> [out.fai.zip]
- * Run (in-repo):    npm run fcstd:convert -w @faicad/faijs -- <in.FCStd> [out.fai.zip]
- * With no <out>, acts as a dry audit (no file written).
- */
-import { writeFileSync } from 'node:fs';
-import { convertFcstdFile } from './convert.js';
-const [input, output] = process.argv.slice(2);
-if (!input) {
-    console.error('usage: faijs-fcstd-convert <in.FCStd> [out.fai.zip]');
-    process.exit(1);
-}
-const summary = await convertFcstdFile(input);
-if (summary.ok && output && summary.zip) {
-    writeFileSync(output, summary.zip);
-}
-// stdout contract: ONE json line, no binary payload — zip bytes are stripped
-// before serialization (they are written to <out> above, never printed).
-const { zip: _zip, ...report } = summary;
-void _zip;
-console.log(JSON.stringify(report));
-if (!summary.ok) {
-    process.exit(summary.gaps.length > 0 ? 2 : 1);
-}
-//# sourceMappingURL=cli.js.map

package/dist/fcstd/cli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/fcstd/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/fcstd/codegen.d.ts

@@ -1,79 +0,0 @@
-/**
- * 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 { 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)
- * @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>): GenResult;
-//# sourceMappingURL=codegen.d.ts.map

package/dist/fcstd/codegen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/fcstd/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,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;;;;;;;;;;;;;GAaG;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,GACtC,SAAS,CA+ZX"}