partforge 0.61.0 → 0.62.0

package/src/framework/mount.js

@@ -404,7 +404,7 @@ export function mount(part, { createWorker, elements = {}, onBuild, onPick, onDo
     // regen-loop.js; this send callback is the one place a build job is dispatched.
     // Routing is per SUB-part: the missing set splits by backend and each group goes
     // to its own worker in parallel, so a mixed part previews its plain sub-parts at
-    // Manifold speed while only the filleted ones wait on OCCT. The return value is
+    // Manifold speed while only the OCCT-routed ones wait. The return value is
     // the job count — the loop holds the cycle open until every group has replied.
     const loop = createRegenLoop({
       missingParts,
@@ -577,7 +577,7 @@ export function mount(part, { createWorker, elements = {}, onBuild, onPick, onDo
           // sub-parts on OCCT (an export reply has no subparts and latches the
           // whole part). The latch is per params snapshot, so changing params
           // re-consults the probe and sub-parts drop back to Manifold when the
-          // OCCT-only feature goes away.
+          // unsupported edge class or other runtime-only requirement goes away.
           backendPolicy.noteNeedsOcct(params, data.subparts);
           loop.buildDone();
           loop.kick();

package/src/parts/filleted-box.js

@@ -1,5 +1,6 @@
-// Example part exercising native CAD ops — it auto-routes to the OCCT backend
-// because it uses fillet (and chamfer when enabled). Vertical edges are rounded
+// Example part exercising the CAD dress-up ops. Since contract v3 fillet and
+// chamfer build natively on the fast Manifold backend (mesh-fillet.js); STEP
+// export still uses OCCT's exact B-rep blends. Vertical edges are rounded
 // and an optional bore drilled; the base chamfer is off by default (turn it up to
 // try chamfering, kept off in defaults so the gating build uses only the fillet).
 export default {

package/src/parts/mixed-smoke.js

@@ -1,8 +1,10 @@
 // CI fixture for per-sub-part backend routing (the mixed-backend twin of
-// text-smoke.js): one filleted sub-part that routes to OCCT next to a plain one
+// text-smoke.js): one shelled sub-part that routes to OCCT next to a plain one
 // that stays on Manifold, so the smoke check exercises a split generate — two
-// workers answering one regen cycle — in a real browser. Dial "Edge fillet" to 0
-// and the whole part drops back to Manifold (zero magnitude is the identity).
+// workers answering one regen cycle — in a real browser. Dial "Wall" to 0 and
+// the whole part drops back to Manifold (the build skips the shell branch).
+// Shell is the routing exemplar since contract v3 — fillet/chamfer build
+// natively on the mesh backend and no longer route.
 export default {
   meta: { title: "Mixed smoke", units: "mm" },
   parameters: [
@@ -11,18 +13,23 @@ export default {
       title: "Body",
       advanced: [
         { key: "w", label: "Width", unit: "mm", min: 10, max: 60, step: 1 },
-        { key: "r", label: "Edge fillet", unit: "mm", min: 0, max: 5, step: 0.5 },
+        { key: "t", label: "Wall", unit: "mm", min: 0, max: 5, step: 0.5 },
       ],
     },
   ],
-  defaults: { w: 30, r: 2 },
+  defaults: { w: 30, t: 2 },
   parts: {
     body: {
       label: "Body",
       views: ["assembly"],
       export: { name: "body" },
-      // Unguarded on purpose: fillet(0) is the identity, so r drives the routing.
-      build: (k, p) => k.box({ min: [0, 0, 0], max: [p.w, p.w, 10] }).fillet({ r: p.r, edges: { dir: "Z" } }),
+      // The t > 0 branch is what drives the routing: the probe re-runs with live
+      // params, so the shell call is only seen (and OCCT only engaged) when the
+      // wall is dialed on.
+      build: (k, p) => {
+        const box = k.box({ min: [0, 0, 0], max: [p.w, p.w, 10] });
+        return p.t > 0 ? box.shell({ t: p.t, open: { dir: "Z" } }) : box;
+      },
     },
     lid: {
       label: "Lid",

package/types/kernel.d.ts

@@ -128,7 +128,7 @@ export type CornerSelector =
 /** A mirror line for `Shape2D.mirror`. */
 export type MirrorAxis2 = "x" | "y" | { point: Point2; dir: Point2 };
 
-// --- edge / face selectors (OCCT-only ops) ---------------------------------
+// --- edge / face selectors --------------------------------------------------
 
 /**
  * Which edges a `fillet`/`chamfer` applies to. Omit for every edge. The object
@@ -254,12 +254,15 @@ export interface Solid {
   toSTL(opts?: { quality?: MeshQuality }): Promise<ArrayBuffer>;
   toIndexedMesh(): IndexedMesh;
   /**
-   * Round edges — OCCT only (Manifold throws `KernelCapabilityError`, and the
-   * probe routes a part that calls this to OCCT). Legacy `(r, selector)` is
-   * accepted until contract v2.
+   * Round edges. Manifold handles straight and circular chains natively and
+   * triggers an automatic OCCT fallback for unsupported edge classes. Legacy
+   * `(r, selector)` is accepted until contract v2.
    */
   fillet(r: number | { r: number; edges?: EdgeSelector }): Solid;
-  /** Bevel edges — OCCT only. Legacy `(d, selector)` accepted until contract v2. */
+  /**
+   * Bevel edges, with the same mesh-native coverage and OCCT fallback as
+   * `fillet`. Legacy `(d, selector)` is accepted until contract v2.
+   */
   chamfer(d: number | { d: number; edges?: EdgeSelector }): Solid;
   /**
    * Hollow inward, wall `t`, opening the faces `open` selects — OCCT only.
@@ -454,7 +457,7 @@ export interface GeometryKernel {
   /** Rim round-overs via one lathe revolve; curve-exact in STEP. */
   roundedCylinder(o: RoundedCylinderOptions): Solid;
   torus(o: TorusOptions): Solid;
-  /** Selective edge rounding. Stays on Manifold (unlike `Solid.fillet`). */
+  /** Selective edge rounding built directly as one Manifold mesh. */
   roundedBox(o: RoundedBoxOptions): Solid;
   /** N-ary boolean union. */
   union(solids: Solid[]): Solid;