npm - forgecad - Versions diffs - 0.1.0 → 0.1.2 - Mend

forgecad 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (48) hide show

package/README.md +12 -1
package/dist/assets/{evalWorker-BYHXxh15.js → evalWorker-1m873KWd.js} +107 -107
package/dist/assets/{index--CYbOPKS.js → index-Dvz3nSDc.js} +356 -339
package/dist/assets/manifold-C38sUiKu.js +16 -0
package/dist/assets/manifold-C44_QbND.wasm +0 -0
package/dist/assets/manifold-Dk2u-lhj.js +16 -0
package/dist/assets/manifold-rOWQW9fU.js +16 -0
package/dist/assets/{reportWorker-B1Zdrz9l.js → reportWorker-Cj587shw.js} +129 -129
package/dist/index.html +1 -1
package/dist-cli/forgecad.js +207 -22
package/dist-skill/SKILL.md +31 -4561
package/dist-skill/docs/API/README.md +24 -0
package/dist-skill/docs/API/guides/modeling-recipes.md +246 -0
package/dist-skill/docs/API/internals/compiler.md +300 -0
package/dist-skill/docs/API/internals/manifold.md +7 -0
package/dist-skill/docs/API/model-building/README.md +31 -0
package/dist-skill/docs/API/model-building/assembly.md +205 -0
package/dist-skill/docs/API/model-building/coordinate-system.md +43 -0
package/dist-skill/docs/API/model-building/entities.md +282 -0
package/dist-skill/docs/API/model-building/geometry-conventions.md +104 -0
package/dist-skill/docs/API/model-building/positioning.md +170 -0
package/dist-skill/docs/API/model-building/reference.md +1936 -0
package/dist-skill/docs/API/model-building/sheet-metal.md +180 -0
package/dist-skill/docs/API/model-building/sketch-anchor.md +32 -0
package/dist-skill/docs/API/model-building/sketch-booleans.md +101 -0
package/dist-skill/docs/API/model-building/sketch-core.md +68 -0
package/dist-skill/docs/API/model-building/sketch-extrude.md +57 -0
package/dist-skill/docs/API/model-building/sketch-on-face.md +98 -0
package/dist-skill/docs/API/model-building/sketch-operations.md +92 -0
package/dist-skill/docs/API/model-building/sketch-path.md +70 -0
package/dist-skill/docs/API/model-building/sketch-primitives.md +104 -0
package/dist-skill/docs/API/model-building/sketch-transforms.md +60 -0
package/dist-skill/docs/API/output/bom.md +53 -0
package/dist-skill/docs/API/output/brep-export.md +82 -0
package/dist-skill/docs/API/output/dimensions.md +62 -0
package/dist-skill/docs/API/runtime/viewport.md +229 -0
package/dist-skill/docs/CLI.md +672 -0
package/dist-skill/docs/CODING.md +345 -0
package/dist-skill/docs/PROGRAM-LEAD.md +180 -0
package/dist-skill/docs/VISION.md +77 -0
package/examples/api/import-group-assembly.forge.js +34 -0
package/examples/api/import-group-source.forge.js +35 -0
package/package.json +2 -2
package/dist/assets/manifold-65fIQlgQ.js +0 -20
package/dist/assets/manifold-B85M7kop.js +0 -20
package/dist/assets/manifold-B8h_vZ5O.js +0 -16
package/dist/assets/manifold-D9yvTBHx.wasm +0 -0
package/dist/assets/manifold-d1UpyLJ8.js +0 -20

package/dist/index.html CHANGED Viewed

@@ -8,7 +8,7 @@
       * { margin: 0; padding: 0; box-sizing: border-box; }
       html, body, #root { width: 100%; height: 100%; overflow: hidden; background: var(--fc-bg); color: var(--fc-text); font-family: system-ui, -apple-system, sans-serif; }
     </style>
-    <script type="module" crossorigin src="/assets/index--CYbOPKS.js"></script>
+    <script type="module" crossorigin src="/assets/index-Dvz3nSDc.js"></script>
   </head>
   <body>
     <div id="root"></div>

package/dist-cli/forgecad.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // cli/forgecad.ts
-import { readFileSync as readFileSync15 } from "fs";
+import { readFileSync as readFileSync16 } from "fs";
 // cli/check-api-contracts.ts
 import assert from "assert/strict";
@@ -13856,6 +13856,58 @@ function joint(name, shape, pivot, opts = {}) {
 }
 // src/forge/group.ts
+var _groupPlacementRefs = /* @__PURE__ */ new WeakMap();
+function getGroupRefs(g) {
+  return _groupPlacementRefs.get(g) ?? createPlacementReferences();
+}
+function setGroupRefs(g, refs) {
+  if (hasPlacementReferences(refs)) {
+    _groupPlacementRefs.set(g, clonePlacementReferences(refs));
+  } else {
+    _groupPlacementRefs.delete(g);
+  }
+  return g;
+}
+function copyGroupRefs(source, dest) {
+  return setGroupRefs(dest, getGroupRefs(source));
+}
+function transformGroupRefs(source, dest, matrix) {
+  const refs = getGroupRefs(source);
+  if (hasPlacementReferences(refs)) {
+    setGroupRefs(dest, transformPlacementReferences(refs, matrix));
+  }
+  return dest;
+}
+function eulerRotationMatrix(xDeg, yDeg, zDeg) {
+  return Transform.identity().rotateAxis([1, 0, 0], xDeg).rotateAxis([0, 1, 0], yDeg).rotateAxis([0, 0, 1], zDeg).toArray();
+}
+function mirrorPlaneMatrix(normal) {
+  const [nx0, ny0, nz0] = normal;
+  const len2 = Math.hypot(nx0, ny0, nz0);
+  if (len2 < 1e-12) return Transform.identity().toArray();
+  const nx = nx0 / len2, ny = ny0 / len2, nz = nz0 / len2;
+  const m00 = 1 - 2 * nx * nx, m01 = -2 * nx * ny, m02 = -2 * nx * nz;
+  const m10 = -2 * ny * nx, m11 = 1 - 2 * ny * ny, m12 = -2 * ny * nz;
+  const m20 = -2 * nz * nx, m21 = -2 * nz * ny, m22 = 1 - 2 * nz * nz;
+  return [
+    m00,
+    m10,
+    m20,
+    0,
+    m01,
+    m11,
+    m21,
+    0,
+    m02,
+    m12,
+    m22,
+    0,
+    0,
+    0,
+    0,
+    1
+  ];
+}
 function normalizeChildName(name) {
   if (typeof name !== "string") return void 0;
   const trimmed = name.trim();
@@ -13917,10 +13969,29 @@ var ShapeGroup = class _ShapeGroup {
   childName(index) {
     return this.childNames[index];
   }
+  /**
+   * Return the named child by name. Throws if not found.
+   * Useful when importing a multipart group and working on components individually.
+   */
+  child(name) {
+    const idx = this.childNames.indexOf(name);
+    if (idx === -1) {
+      const available = this.childNames.filter(Boolean).join(", ") || "none";
+      throw new Error(`ShapeGroup has no child named "${name}". Available: ${available}`);
+    }
+    return this.children[idx];
+  }
+  /** Apply fn to all children, producing a new ShapeGroup that also copies placement refs. */
   mapChildren(fn) {
-    return new _ShapeGroup(this.children.map(fn), this.childNames);
+    const next = new _ShapeGroup(this.children.map(fn), this.childNames);
+    return copyGroupRefs(this, next);
+  }
+  /** Apply fn to all children and also transform placement refs by the given matrix. */
+  mapChildrenTransform(fn, matrix) {
+    const next = new _ShapeGroup(this.children.map(fn), this.childNames);
+    return transformGroupRefs(this, next, matrix);
   }
-  /** Return a deep-cloned ShapeGroup tree. */
+  /** Return a deep-cloned ShapeGroup tree (refs copied). */
   clone() {
     return this.mapChildren((c) => {
       if (c instanceof _ShapeGroup) return c.clone();
@@ -13934,12 +14005,13 @@ var ShapeGroup = class _ShapeGroup {
     return this.clone();
   }
   translate(x, y, z) {
-    return this.mapChildren((c) => {
+    const matrix = Transform.translation(x, y, z).toArray();
+    return this.mapChildrenTransform((c) => {
       if (c instanceof _ShapeGroup) return c.translate(x, y, z);
       if (c instanceof TrackedShape) return c.translate(x, y, z);
       if (c instanceof Shape) return c.translate(x, y, z);
       return c.translate(x, y);
-    });
+    }, matrix);
   }
   /** Compute combined bounding box of all 3D children */
   _bbox() {
@@ -14001,7 +14073,18 @@ var ShapeGroup = class _ShapeGroup {
       return { min: b.min, max: b.max };
     })();
     const sbb = this._bbox();
-    const tp = target instanceof _ShapeGroup || isAnchor3D(targetAnchor) ? resolveAnchor3D(tbb.min, tbb.max, targetAnchor) : target instanceof TrackedShape ? target.referencePoint(targetAnchor) : target.referencePoint(targetAnchor);
+    let tp;
+    if (isAnchor3D(targetAnchor)) {
+      tp = resolveAnchor3D(tbb.min, tbb.max, targetAnchor);
+    } else if ("referencePoint" in target && typeof target.referencePoint === "function") {
+      tp = target.referencePoint(targetAnchor);
+    } else {
+      const normalized = normalizeAnchor3D(targetAnchor);
+      if (!normalized) {
+        throw new Error(`Unknown anchor "${targetAnchor}" on target`);
+      }
+      tp = resolveAnchor3D(tbb.min, tbb.max, normalized);
+    }
     const sp = resolveAnchor3D(sbb.min, sbb.max, selfAnchor);
     let dx = tp[0] - sp[0], dy = tp[1] - sp[1], dz = tp[2] - sp[2];
     if (offset) {
@@ -14029,12 +14112,13 @@ var ShapeGroup = class _ShapeGroup {
     return this.attachTo(parent, face, opp[face], uvMap[face](u, v, p));
   }
   rotate(x, y, z) {
-    return this.mapChildren((c) => {
+    const matrix = eulerRotationMatrix(x, y, z);
+    return this.mapChildrenTransform((c) => {
       if (c instanceof _ShapeGroup) return c.rotate(x, y, z);
       if (c instanceof TrackedShape) return c.rotate(x, y, z);
       if (c instanceof Shape) return c.rotate(x, y, z);
       return c.rotate(x);
-    });
+    }, matrix);
   }
   /**
    * Rotate around an arbitrary axis through a pivot point.
@@ -14076,28 +14160,32 @@ var ShapeGroup = class _ShapeGroup {
   }
   /** Apply a 4x4 transform matrix or Transform object to all 3D children. */
   transform(m) {
-    return new _ShapeGroup(this.children.map((c) => {
+    const matrix = m instanceof Transform ? m.toArray() : m;
+    const next = new _ShapeGroup(this.children.map((c) => {
       if (c instanceof _ShapeGroup) return c.transform(m);
       if (c instanceof TrackedShape) return c.transform(m);
       if (c instanceof Shape) return c.transform(m);
       throw new Error("ShapeGroup.transform only supports 3D children (Shape/TrackedShape/ShapeGroup). For Sketch children, use 2D transforms (translate/rotate/scale/mirror).");
     }), this.childNames);
+    return transformGroupRefs(this, next, matrix);
   }
   scale(v) {
-    return this.mapChildren((c) => {
+    const matrix = Transform.scale(v).toArray();
+    return this.mapChildrenTransform((c) => {
       if (c instanceof _ShapeGroup) return c.scale(v);
       if (c instanceof TrackedShape) return c.scale(v);
       if (c instanceof Shape) return c.scale(v);
       return c.scale(typeof v === "number" ? v : [v[0], v[1]]);
-    });
+    }, matrix);
   }
   mirror(normal) {
-    return this.mapChildren((c) => {
+    const matrix = mirrorPlaneMatrix(normal);
+    return this.mapChildrenTransform((c) => {
       if (c instanceof _ShapeGroup) return c.mirror(normal);
       if (c instanceof TrackedShape) return c.mirror(normal);
       if (c instanceof Shape) return c.mirror(normal);
       return c.mirror([normal[0], normal[1]]);
-    });
+    }, matrix);
   }
   color(hex) {
     return this.mapChildren((c) => {
@@ -14107,6 +14195,70 @@ var ShapeGroup = class _ShapeGroup {
       return c.color(hex);
     });
   }
+  // --- Placement References ---
+  /**
+   * Attach named placement references to this group.
+   * References survive normal transforms (translate/rotate/scale/mirror/transform).
+   *
+   * ```javascript
+   * const bracket = group(
+   *   { name: 'Left', shape: leftShape },
+   *   { name: 'Right', shape: rightShape },
+   * ).withReferences({
+   *   points: { mountCenter: [0, 0, 0] },
+   * });
+   * ```
+   */
+  withReferences(refs) {
+    const next = new _ShapeGroup(this.children, this.childNames);
+    const merged = applyPlacementReferenceInput(getGroupRefs(this), refs);
+    return setGroupRefs(next, merged);
+  }
+  /** List named placement references carried by this group. */
+  referenceNames(kind) {
+    return placementReferenceNames(getGroupRefs(this), kind);
+  }
+  /**
+   * Resolve a named placement reference or built-in Anchor3D to a 3D point.
+   * Named refs take priority over built-in anchors.
+   */
+  referencePoint(ref) {
+    const refs = getGroupRefs(this);
+    if (!isAnchor3D(ref)) {
+      const point2 = resolvePlacementReferencePoint(refs, ref);
+      if (point2) return point2;
+      const normalized = normalizeAnchor3D(ref);
+      if (normalized) {
+        const bb2 = this._bbox();
+        return resolveAnchor3D(bb2.min, bb2.max, normalized);
+      }
+      throw new Error(
+        `Unknown placement reference "${ref}". Available: ${placementReferenceNames(refs).join(", ") || "none"}`
+      );
+    }
+    const bb = this._bbox();
+    return resolveAnchor3D(bb.min, bb.max, ref);
+  }
+  /**
+   * Translate the group so the given reference lands on the target coordinate.
+   *
+   * ```javascript
+   * const placed = importGroup('bracket-assembly.forge.js')
+   *   .placeReference('mountCenter', [0, 0, 50]);
+   * ```
+   */
+  placeReference(ref, target, offset) {
+    const sourcePoint = this.referencePoint(ref);
+    let dx = target[0] - sourcePoint[0];
+    let dy = target[1] - sourcePoint[1];
+    let dz = target[2] - sourcePoint[2];
+    if (offset) {
+      dx += offset[0];
+      dy += offset[1];
+      dz += offset[2];
+    }
+    return this.translate(dx, dy, dz);
+  }
 };
 function group(...items) {
   const normalized = normalizeGroupInputs(items);
@@ -18116,6 +18268,26 @@ function executeFile(code, fileName, allFiles, visited, scope = {}, options, exe
       logImportTrace(fileName, scope, options, "importPart", resolvedPath, "error", { requested: name, got });
       throw new Error(`"${resolvedPath}" did not return a Shape (got ${got})`);
     };
+    const importGroup = (name, paramOverrides) => {
+      const { source: src, lookupKey, resolvedPath } = resolveImportSource(fileName, name, allFiles, options);
+      const localOverrides = parseImportParamArgs("importGroup", name, paramOverrides);
+      const childScope = { namePrefix: makeChildScopePrefix(resolvedPath), localOverrides };
+      logImportTrace(fileName, scope, options, "importGroup", resolvedPath, "start", { requested: name, overrides: localOverrides });
+      let result;
+      try {
+        result = executeFile(src, lookupKey, allFiles, visited, childScope, options);
+      } catch (error) {
+        logImportTrace(fileName, scope, options, "importGroup", resolvedPath, "error", { requested: name, error: formatLogError(error) });
+        throw error;
+      }
+      if (result instanceof ShapeGroup) {
+        logImportTrace(fileName, scope, options, "importGroup", resolvedPath, "success", { requested: name, got: "ShapeGroup" });
+        return result;
+      }
+      const got = describeScriptResultType(result);
+      logImportTrace(fileName, scope, options, "importGroup", resolvedPath, "error", { requested: name, got });
+      throw new Error(`"${resolvedPath}" did not return a ShapeGroup (got ${got}). Use group(...) as the return value, or use importPart() for single-shape files.`);
+    };
     const unwrap2 = (s) => s instanceof TrackedShape ? s.toShape() : s;
     const wrappedUnion = (...shapes) => union(...shapes.map(unwrap2));
     const wrappedDifference = (...shapes) => difference(...shapes.map(unwrap2));
@@ -18202,6 +18374,7 @@ function executeFile(code, fileName, allFiles, visited, scope = {}, options, exe
       projectToPlane,
       importSketch,
       importPart,
+      importGroup,
       importSvgSketch,
       dim,
       dimLine,
@@ -35805,12 +35978,14 @@ var API_EXACT_PART_PATHS = [
   "examples/api/colors-union-vs-array.forge.js",
   "examples/api/coordinate-system.forge.js",
   "examples/api/dimensioned-bracket.forge.js",
+  "examples/api/face-transformation-history.forge.js",
   "examples/api/feature-created-faces.forge.js",
   "examples/api/folded-service-panel-cover.forge.js",
   "examples/api/group-vs-union.forge.js",
   "examples/api/import-args-unit.forge.js",
   "examples/api/import-args.forge.js",
   "examples/api/import-dimensions-follow.forge.js",
+  "examples/api/import-group-source.forge.js",
   "examples/api/import-placement-references.forge.js",
   "examples/api/import-placement-widget-source.forge.js",
   "examples/api/import-relative-paths.forge.js",
@@ -35970,6 +36145,11 @@ var RUNTIME_SCENE_ENTRIES = [
     note: "This example is judged by runtime scene behavior rather than by exact part-lowering parity.",
     expect: { minUniqueGroups: 3 }
   },
+  {
+    path: "examples/api/import-group-assembly.forge.js",
+    note: "Multipart importGroup() demo: validates group import, child access, and param overrides at runtime.",
+    expect: { minUniqueGroups: 1 }
+  },
   {
     path: "examples/api/section-plane-visualization.forge.js",
     note: "This example is judged by runtime scene behavior rather than by exact part-lowering parity.",
@@ -41554,7 +41734,7 @@ import { mkdirSync as mkdirSync3, readFileSync as readFileSync10, writeFileSync
 import { dirname as dirname8, extname as extname3, resolve as resolve15 } from "path";
 // src/forge/exportMesh.ts
-import { Export3MF } from "manifold-3d/lib/export-3mf.js";
+import { toArrayBuffer as export3mfToArrayBuffer } from "manifold-3d/lib/export-3mf.js";
 import {
   GLTFNode,
   GLTFNodesToGLTFDoc,
@@ -43678,23 +43858,28 @@ Dimension list${showAll ? "" : " (first 20)"}:`);
 }
 // cli/forge-skill.ts
-import { copyFileSync, existsSync as existsSync6, mkdirSync as mkdirSync4 } from "fs";
+import { cpSync, existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync15, writeFileSync as writeFileSync8 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join7 } from "path";
 async function runSkillInstallCli(_argv = []) {
-  const src = resolvePackagePath(import.meta.url, "dist-skill", "SKILL.md");
-  if (!existsSync6(src)) {
+  const srcSkill = resolvePackagePath(import.meta.url, "dist-skill", "SKILL.md");
+  const srcDocs = resolvePackagePath(import.meta.url, "dist-skill", "docs");
+  if (!existsSync6(srcSkill)) {
     throw new Error(
-      `Built skill file not found at ${src}.
+      `Built skill file not found at ${srcSkill}.
 If you are running from a source checkout, run: npm run build:skill:forgecad`
     );
   }
   const destDir = join7(homedir2(), ".agents", "skills", "forgecad");
   const dest = join7(destDir, "SKILL.md");
   mkdirSync4(destDir, { recursive: true });
-  copyFileSync(src, dest);
+  const skillContent = readFileSync15(srcSkill, "utf-8").replaceAll("{{SKILL_DIR}}", destDir);
+  writeFileSync8(dest, skillContent);
+  if (existsSync6(srcDocs)) {
+    cpSync(srcDocs, join7(destDir, "docs"), { recursive: true });
+  }
   console.log(`ForgeCAD skill installed to ${dest}`);
-  console.log(`Reload Claude Code to activate.`);
+  console.log(`Reload your agent (Claude Code, Codex, OpenCode, \u2026) to activate.`);
 }
 // cli/forgecad.ts
@@ -43850,7 +44035,7 @@ var commands = [
   {
     group: "Shell",
     path: ["skill", "install"],
-    summary: "Install the ForgeCAD Claude Code skill to ~/.agents/skills/forgecad/SKILL.md.",
+    summary: "Install the ForgeCAD agent skill to ~/.agents/skills/forgecad/SKILL.md (Claude Code, Codex, OpenCode, \u2026).",
     usage: ["forgecad skill install"],
     examples: ["forgecad skill install"],
     run: runSkillInstallCli
@@ -44316,7 +44501,7 @@ var commands = [
 ];
 function readVersion() {
   try {
-    const pkg = JSON.parse(readFileSync15(resolvePackagePath(import.meta.url, "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync16(resolvePackagePath(import.meta.url, "package.json"), "utf-8"));
     return pkg.version || "0.0.0";
   } catch {
     return "0.0.0";