npm - forgecad - Versions diffs - 0.1.3 → 0.1.5 - Mend

forgecad 0.1.3 → 0.1.5

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 (16) hide show

package/README.md +11 -0
package/dist/assets/{evalWorker-1m873KWd.js → evalWorker-CbAa_9qg.js} +108 -108
package/dist/assets/{index-Dvz3nSDc.js → index-DFa4fntx.js} +335 -335
package/dist/assets/{manifold-C38sUiKu.js → manifold-BGMOVi-H.js} +1 -1
package/dist/assets/{manifold-rOWQW9fU.js → manifold-BNJTX3qf.js} +1 -1
package/dist/assets/{manifold-Dk2u-lhj.js → manifold-CL39pgcA.js} +1 -1
package/dist/assets/{reportWorker-Cj587shw.js → reportWorker-C5Ot2xSE.js} +122 -122
package/dist/index.html +1 -1
package/dist-cli/forgecad.js +117 -22
package/dist-skill/CONTEXT.md +4799 -0
package/dist-skill/docs/API/model-building/assembly.md +41 -0
package/dist-skill/docs/API/model-building/reference.md +61 -7
package/dist-skill/docs/VISION.md +2 -1
package/examples/api/import-assembly-source.forge.js +22 -0
package/examples/api/import-assembly.forge.js +26 -0
package/package.json +1 -1

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-Dvz3nSDc.js"></script>
+    <script type="module" crossorigin src="/assets/index-DFa4fntx.js"></script>
   </head>
   <body>
     <div id="root"></div>

package/dist-cli/forgecad.js CHANGED Viewed

@@ -14746,6 +14746,42 @@ var Assembly = class {
 function assembly(name) {
   return new Assembly(name);
 }
+var ImportedAssembly = class {
+  constructor(_assembly) {
+    this._assembly = _assembly;
+  }
+  /** The underlying Assembly — use for sweepJoint, addPart into parent, etc. */
+  get assembly() {
+    return this._assembly;
+  }
+  /** Solve the assembly at the given joint state (defaults to each joint's default value). */
+  solve(state) {
+    return this._assembly.solve(state);
+  }
+  /**
+   * Return a specific named part positioned at the given joint state.
+   * Result type mirrors SolvedAssembly.getPart(): Shape, TrackedShape, or ShapeGroup.
+   */
+  part(name, state) {
+    return this._assembly.solve(state).getPart(name);
+  }
+  /**
+   * Convert all assembly parts to a ShapeGroup with named children.
+   * Child names match the part names used in the assembly.
+   * Useful for embedding a solved sub-assembly in a parent group or assembly.
+   */
+  toGroup(state) {
+    const solved = this._assembly.solve(state);
+    const def = this._assembly.describe();
+    const children = [];
+    const childNames = [];
+    for (const p of def.parts) {
+      children.push(solved.getPart(p.name));
+      childNames.push(p.name);
+    }
+    return new ShapeGroup(children, childNames);
+  }
+};
 // src/forge/robotExport.ts
 var _collectedRobotExport = null;
@@ -17869,6 +17905,8 @@ function describeScriptResultType(value) {
   if (value instanceof Sketch) return "Sketch";
   if (value instanceof TrackedShape) return "TrackedShape";
   if (value instanceof ShapeGroup) return "ShapeGroup";
+  if (value instanceof Assembly) return "Assembly";
+  if (value instanceof ImportedAssembly) return "ImportedAssembly";
   if (Array.isArray(value)) return "Array";
   if (typeof value === "object" && typeof value.toShape === "function") {
     try {
@@ -18288,6 +18326,26 @@ function executeFile(code, fileName, allFiles, visited, scope = {}, options, exe
       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 importAssembly = (name, paramOverrides) => {
+      const { source: src, lookupKey, resolvedPath } = resolveImportSource(fileName, name, allFiles, options);
+      const localOverrides = parseImportParamArgs("importAssembly", name, paramOverrides);
+      const childScope = { namePrefix: makeChildScopePrefix(resolvedPath), localOverrides };
+      logImportTrace(fileName, scope, options, "importAssembly", resolvedPath, "start", { requested: name, overrides: localOverrides });
+      let result;
+      try {
+        result = executeFile(src, lookupKey, allFiles, visited, childScope, options);
+      } catch (error) {
+        logImportTrace(fileName, scope, options, "importAssembly", resolvedPath, "error", { requested: name, error: formatLogError(error) });
+        throw error;
+      }
+      if (result instanceof Assembly) {
+        logImportTrace(fileName, scope, options, "importAssembly", resolvedPath, "success", { requested: name, got: "Assembly" });
+        return new ImportedAssembly(result);
+      }
+      const got = describeScriptResultType(result);
+      logImportTrace(fileName, scope, options, "importAssembly", resolvedPath, "error", { requested: name, got });
+      throw new Error(`"${resolvedPath}" did not return an Assembly (got ${got}). Return the assembly() instance directly (before calling .solve()).`);
+    };
     const unwrap2 = (s) => s instanceof TrackedShape ? s.toShape() : s;
     const wrappedUnion = (...shapes) => union(...shapes.map(unwrap2));
     const wrappedDifference = (...shapes) => difference(...shapes.map(unwrap2));
@@ -18375,6 +18433,7 @@ function executeFile(code, fileName, allFiles, visited, scope = {}, options, exe
       importSketch,
       importPart,
       importGroup,
+      importAssembly,
       importSvgSketch,
       dim,
       dimLine,
@@ -29242,8 +29301,8 @@ var Loader = class {
    */
   loadAsync(url, onProgress) {
     const scope = this;
-    return new Promise(function(resolve22, reject) {
-      scope.load(url, resolve22, onProgress, reject);
+    return new Promise(function(resolve23, reject) {
+      scope.load(url, resolve23, onProgress, reject);
     });
   }
   /**
@@ -40514,7 +40573,7 @@ async function waitForRenderHtml(port, timeoutMs) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await fetchRenderHtml(port)) return true;
-    await new Promise((resolve22) => setTimeout(resolve22, 250));
+    await new Promise((resolve23) => setTimeout(resolve23, 250));
   }
   return false;
 }
@@ -40564,7 +40623,7 @@ ${detail}` : `Timed out waiting for Vite on port ${port}.`
 async function stopDevServer(proc) {
   if (!proc || proc.killed) return;
   proc.kill("SIGTERM");
-  await new Promise((resolve22) => setTimeout(resolve22, 150));
+  await new Promise((resolve23) => setTimeout(resolve23, 150));
   if (!proc.killed) {
     proc.kill("SIGKILL");
   }
@@ -41160,13 +41219,13 @@ function parseCli2(argv) {
   };
 }
 function readStdin() {
-  return new Promise((resolve22, reject) => {
+  return new Promise((resolve23, reject) => {
     let data = "";
     input.setEncoding("utf8");
     input.on("data", (chunk) => {
       data += chunk;
     });
-    input.on("end", () => resolve22(data));
+    input.on("end", () => resolve23(data));
     input.on("error", reject);
   });
 }
@@ -41594,12 +41653,12 @@ function findProjectRoot2(sp) {
   return root;
 }
 async function isPortOpen(port) {
-  return new Promise((resolve22) => {
+  return new Promise((resolve23) => {
     const server = createServer3();
-    server.once("error", () => resolve22(false));
+    server.once("error", () => resolve23(false));
     server.once("listening", () => {
       server.close();
-      resolve22(true);
+      resolve23(true);
     });
     server.listen(port, "127.0.0.1");
   });
@@ -41614,12 +41673,12 @@ async function ensureDevServer2(port) {
     stdio: "pipe",
     detached: false
   });
-  await new Promise((resolve22, reject) => {
+  await new Promise((resolve23, reject) => {
     const timeout = setTimeout(() => reject(new Error("Vite startup timeout")), 15e3);
     viteProcess.stdout.on("data", (data) => {
       if (data.toString().includes("ready")) {
         clearTimeout(timeout);
-        resolve22();
+        resolve23();
       }
     });
     viteProcess.on("error", (e) => {
@@ -42777,14 +42836,14 @@ function sendJson(res, status, payload) {
   res.end(JSON.stringify(payload));
 }
 function readJsonBody(req) {
-  return new Promise((resolve22, reject) => {
+  return new Promise((resolve23, reject) => {
     let body = "";
     req.on("data", (chunk) => {
       body += chunk;
     });
     req.on("end", () => {
       try {
-        resolve22(body ? JSON.parse(body) : {});
+        resolve23(body ? JSON.parse(body) : {});
       } catch (e) {
         reject(e);
       }
@@ -42897,10 +42956,10 @@ function serveStatic(distDir, req, res) {
   return true;
 }
 function isPortAvailable(port, host) {
-  return new Promise((resolve22) => {
+  return new Promise((resolve23) => {
     const s = http.createServer();
-    s.listen(port, host, () => s.close(() => resolve22(true)));
-    s.on("error", () => resolve22(false));
+    s.listen(port, host, () => s.close(() => resolve23(true)));
+    s.on("error", () => resolve23(false));
   });
 }
 async function pickPort(preferred, host, strict) {
@@ -43034,11 +43093,11 @@ data: ${JSON.stringify(entries)}
       res.end("Not found");
     }
   });
-  await new Promise((resolve22) => server.listen(port, host, resolve22));
+  await new Promise((resolve23) => server.listen(port, host, resolve23));
   const displayHost = host === "0.0.0.0" ? "localhost" : host;
   const url = `http://${displayHost}:${port}`;
   if (open) openBrowser(url);
-  const close4 = () => new Promise((resolve22) => {
+  const close4 = () => new Promise((resolve23) => {
     watcher?.close();
     sseClients.forEach((c) => {
       try {
@@ -43047,7 +43106,7 @@ data: ${JSON.stringify(entries)}
       }
     });
     sseClients.clear();
-    server.close(() => resolve22());
+    server.close(() => resolve23());
   });
   return { url, close: close4 };
 }
@@ -43130,9 +43189,9 @@ function toViteArgs(options) {
   return args;
 }
 function waitForExit(child) {
-  return new Promise((resolve22, reject) => {
+  return new Promise((resolve23, reject) => {
     child.once("error", reject);
-    child.once("exit", (code) => resolve22(code ?? 0));
+    child.once("exit", (code) => resolve23(code ?? 0));
   });
 }
 async function runStudioCli(argv = process.argv.slice(2)) {
@@ -43860,7 +43919,7 @@ Dimension list${showAll ? "" : " (first 20)"}:`);
 // cli/forge-skill.ts
 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";
+import { join as join7, resolve as resolve22 } from "path";
 async function runSkillInstallCli(_argv = []) {
   const srcSkill = resolvePackagePath(import.meta.url, "dist-skill", "SKILL.md");
   const srcDocs = resolvePackagePath(import.meta.url, "dist-skill", "docs");
@@ -43881,6 +43940,26 @@ If you are running from a source checkout, run: npm run build:skill:forgecad`
   console.log(`ForgeCAD skill installed to ${dest}`);
   console.log(`Reload your agent (Claude Code, Codex, OpenCode, \u2026) to activate.`);
 }
+async function runSkillOneFileCli(argv = []) {
+  const outputArg = argv.find((a) => !a.startsWith("-"));
+  if (!outputArg) {
+    throw new Error(
+      `Usage: forgecad skill one-file <output-path>
+Example: forgecad skill one-file ~/Desktop/forgecad-context.md`
+    );
+  }
+  const src = resolvePackagePath(import.meta.url, "dist-skill", "CONTEXT.md");
+  if (!existsSync6(src)) {
+    throw new Error(
+      `Built context file not found at ${src}.
+If you are running from a source checkout, run: npm run build:skill:forgecad`
+    );
+  }
+  const dest = resolve22(outputArg);
+  writeFileSync8(dest, readFileSync15(src));
+  console.log(`ForgeCAD context written to ${dest}`);
+  console.log(`Paste the contents into any AI chat UI (Claude.ai, ChatGPT, Gemini, \u2026) to get full ForgeCAD API knowledge.`);
+}
 // cli/forgecad.ts
 var SHELL_VALUES = [
@@ -44040,6 +44119,22 @@ var commands = [
     examples: ["forgecad skill install"],
     run: runSkillInstallCli
   },
+  {
+    group: "Shell",
+    path: ["skill", "one-file"],
+    summary: "Write a single self-contained context file with all ForgeCAD docs for pasting into a chat UI (Claude.ai, ChatGPT, \u2026).",
+    usage: ["forgecad skill one-file <output-path>"],
+    examples: [
+      "forgecad skill one-file ~/Desktop/forgecad-context.md",
+      "forgecad skill one-file ./forgecad-context.md"
+    ],
+    completion: {
+      positionals: [
+        { description: "output path for the context file", valueKind: "path" }
+      ]
+    },
+    run: runSkillOneFileCli
+  },
   {
     group: "Shell",
     path: ["__complete"],