forgecad 0.9.6 → 0.9.7

package/examples/api/clevis-pin-joint.forge.js

@@ -0,0 +1,13 @@
+const clevis = lib.clevisPinJointAssembly({
+  pinDiameter: 4,
+  linkThickness: 6,
+  linkArmLength: 38,
+  earThickness: 4,
+});
+
+verify.equal('clevis joint has three retained parts', clevis.parts.length, 3);
+verify.greaterThan('link eye has material around pin bore', clevis.dims.eyeOuterRadius - clevis.dims.boreDiameter / 2, 4);
+verify.greaterThan('clevis gap clears the link eye', clevis.dims.clevisGap, clevis.dims.linkThickness);
+verify.minClearance('link eye clears clevis yoke', clevis.link, clevis.clevis, 0.05);
+
+return clevis.parts;

package/examples/api/datum-enclosure.forge.js

@@ -0,0 +1,16 @@
+const enclosure = lib.datumEnclosureAssembly({
+  width: 96,
+  depth: 64,
+  height: 18,
+  screwSize: 'M3',
+});
+
+verify.equal('datum enclosure has base gasket cover and four screws', enclosure.parts.length, 7);
+verify.greaterThan('internal cavity keeps usable width', enclosure.dims.innerWidth, 80);
+verify.greaterThan('standoff wall remains around screw envelope', enclosure.dims.standoffDiameter - enclosure.dims.threadEnvelopeDia, 4);
+verify.greaterThan('service port leaves top wall material', enclosure.dims.height - enclosure.dims.baseThickness - enclosure.dims.portHeight, 6);
+verify.notColliding('cover clears seated gasket', enclosure.cover, enclosure.gasket);
+verify.notColliding('first screw clears standoff thread envelope', enclosure.screws[0], enclosure.base);
+verify.inRange('cover stack has small seating clearance', enclosure.dims.faceClearance, 0.01, 0.08);
+
+return enclosure.parts;

package/examples/api/hose-barb-port.forge.js

@@ -0,0 +1,14 @@
+const hosePort = lib.hoseBarbPortAssembly({
+  hoseInnerDiameter: 6,
+  hoseOuterDiameter: 10,
+  barbCount: 3,
+});
+
+verify.equal('hose barb port has receiver fitting hose and clamp', hosePort.parts.length, 4);
+verify.greaterThan('barb peaks retain nominal hose ID', hosePort.dims.barbPeakDiameter, hosePort.dims.hoseInnerDiameter);
+verify.greaterThan('hose has wall around installed barb envelope', hosePort.dims.hoseOuterDiameter - hosePort.dims.installedHoseBoreDiameter, 1.2);
+verify.notColliding('hose clears barb peaks', hosePort.hose, hosePort.fitting);
+verify.notColliding('clamp clears hose outside', hosePort.clamp, hosePort.hose);
+verify.inRange('fitting shoulder seats near boss face', hosePort.dims.faceClearance, 0.01, 0.08);
+
+return hosePort.parts;

package/examples/api/intentional-overlap-overmold.forge.js

@@ -0,0 +1,16 @@
+// Intentional overlap: an overmolded grip shares volume with its rigid handle core.
+const handleCore = box(64, 12, 8).color('#64748b');
+const rubberGrip = box(42, 18, 10).translate(6, 0, 0).color('#111827');
+
+verify.intentionalOverlap(
+  'rubber grip is overmolded on handle core',
+  rubberGrip,
+  handleCore,
+  'overmolded bonded grip around rigid insert',
+);
+verify.greaterThan('rubber grip wraps beyond core width', rubberGrip.boundingBox().max[1], handleCore.boundingBox().max[1]);
+
+return [
+  { name: 'Rigid handle core', shape: handleCore },
+  { name: 'Overmolded rubber grip', shape: rubberGrip },
+];

package/examples/api/knuckled-hinge-assembly.forge.js

@@ -0,0 +1,15 @@
+const hinge = lib.knuckledHingeAssembly({
+  length: 70,
+  leafLength: 28,
+  leafThickness: 1.8,
+  barrelOuterRadius: 3.2,
+  pinDiameter: 2,
+  openAngleDeg: 42,
+});
+
+verify.equal('hinge has two leaves and one retained pin', hinge.parts.length, 3);
+verify.greaterThan('barrel wall remains around pin bore', hinge.dims.barrelOuterRadius - hinge.dims.boreDiameter / 2, 1.5);
+verify.greaterThan('hinge has meaningful knuckle length', hinge.dims.knuckleLength, hinge.dims.pinDiameter * 2);
+verify.minClearance('moving leaf clears fixed leaf', hinge.movingLeaf, hinge.fixedLeaf, 0.05);
+
+return hinge.parts;

package/examples/api/living-hinge-cover.forge.js

@@ -0,0 +1,14 @@
+const livingCover = lib.livingHingeCoverAssembly({
+  width: 64,
+  coverDepth: 42,
+  fixedLeafDepth: 18,
+});
+
+verify.equal('living hinge cover is one molded part', livingCover.parts.length, 1);
+verify.equal('one-piece living hinge cover has one body', livingCover.cover.numBodies(), 1);
+verify.greaterThan('living hinge web is much thinner than rigid leaves', livingCover.dims.flexRatio, 3.5);
+verify.greaterThan('hinge web spans the full cover width', livingCover.dims.width, 60);
+verify.greaterThan('snap barb has positive retention height', livingCover.dims.snapBarbHeight, 1);
+verify.greaterThan('catch land is present on fixed leaf', livingCover.dims.catchLandDepth, 2);
+
+return livingCover.parts;

package/examples/api/pcb-terminal-block.forge.js

@@ -0,0 +1,22 @@
+const terminalStack = lib.pcbTerminalBlockAssembly({
+  terminalCount: 5,
+  terminalPitch: 5.08,
+  screwSize: 'M3',
+});
+
+verify.equal('terminal block exposes one pin per terminal', terminalStack.pinPositions.length, terminalStack.dims.terminalCount);
+verify.greaterThan(
+  'PCB leaves mounting margin around terminal block',
+  terminalStack.dims.boardWidth - terminalStack.dims.terminalBlockWidth,
+  20,
+);
+verify.notColliding('terminal pins clear PCB holes', terminalStack.terminalBlock, terminalStack.pcb);
+verify.notColliding('mounting screws clear PCB and standoff holes', union(...terminalStack.screws), union(terminalStack.pcb, terminalStack.backplate));
+verify.greaterThan(
+  'standoffs retain wall around screw envelopes',
+  terminalStack.dims.standoffDiameter - terminalStack.dims.standoffThreadEnvelopeDiameter,
+  3,
+);
+verify.greaterThan('pin holes leave PCB web between terminals', terminalStack.dims.terminalPitch - terminalStack.dims.pinHoleDiameter, 3);
+
+return terminalStack.parts;

package/examples/api/pinned-lever-pivot-stack.forge.js

@@ -0,0 +1,14 @@
+const lever = lib.pinnedLeverAssembly({
+  armLength: 56,
+  armWidth: 10,
+  leverThickness: 5,
+  pinDiameter: 5,
+  supportThickness: 8,
+});
+
+verify.equal('pinned lever stack has five retained parts', lever.parts.length, 5);
+verify.greaterThan('thrust washers have real thickness', lever.dims.washerThickness, 0);
+verify.greaterThan('pivot hub has material around the bore', lever.dims.hubRadius - lever.dims.boreDiameter / 2, 3);
+verify.notColliding('lower washer does not collide with support', lever.washers.lower, lever.support);
+
+return lever.parts;

package/examples/api/retained-shaft-knob-stack.forge.js

@@ -0,0 +1,15 @@
+const trunnion = lib.retainedShaftAssembly({
+  supportSpacing: 96,
+  shaftDiameter: 8,
+  supportThickness: 6,
+  supportHeight: 42,
+  knobDiameter: 24,
+  knobThickness: 8,
+});
+
+verify.equal('retained shaft stack has seven parts', trunnion.parts.length, 7);
+verify.greaterThan('support cheeks leave material around bore', trunnion.dims.supportHeight - trunnion.dims.boreDiameter, 20);
+verify.greaterThan('shaft is long enough to retain knobs', trunnion.dims.shaftLength, trunnion.dims.supportSpacing);
+verify.notColliding('left washer does not collide with support cheek', trunnion.washers.left, trunnion.supports.left);
+
+return trunnion.parts;

package/examples/api/routed-tube-clip.forge.js

@@ -0,0 +1,15 @@
+const route = lib.routedTubeClipAssembly({
+  tubeDiameter: 6,
+  tubeLength: 130,
+  clipCount: 3,
+  screwSize: 'M3',
+});
+
+verify.equal('tube route has three retaining clips', route.clips.length, 3);
+verify.equal('each retaining clip has two installed screws', route.screws.length, route.clips.length * 2);
+verify.notColliding('tube clears saddle clip bores', route.tube, union(...route.clips));
+verify.notColliding('clip screws clear panel and clip holes', union(...route.screws), union(route.panel, ...route.clips));
+verify.greaterThan('clip wall leaves material around tube bore', route.dims.clipWallThickness, route.dims.screwHeadDiameter);
+verify.greaterThan('tube bore clears tube outside diameter', route.dims.tubeBoreDiameter - route.dims.tubeDiameter, 0.3);
+
+return route.parts;

package/examples/api/seated-bearing-stack.forge.js

@@ -0,0 +1,30 @@
+const bearingStack = lib.seatedBearingAssembly({
+  bearingOuterDiameter: 22,
+  bearingInnerDiameter: 8,
+  bearingWidth: 7,
+  shaftDiameter: 7.4,
+  housingWidth: 54,
+  housingDepth: 42,
+  housingThickness: 10,
+});
+
+verify.equal('seated bearing stack has three retained parts', bearingStack.parts.length, 3);
+verify.greaterThan(
+  'housing boss leaves material around bearing pocket',
+  bearingStack.dims.bossOuterDiameter - bearingStack.dims.pocketDiameter,
+  5,
+);
+verify.greaterThan(
+  'bearing bore clears the shaft',
+  bearingStack.dims.bearingInnerDiameter,
+  bearingStack.dims.shaftDiameter + bearingStack.dims.runningClearance,
+);
+verify.clearanceBetween(
+  'bearing is seated in counterbore',
+  bearingStack.bearing,
+  bearingStack.housing,
+  -0.01,
+  bearingStack.dims.runningClearance + 0.1,
+);
+
+return bearingStack.parts;

package/examples/api/snap-latch-cover.forge.js

@@ -0,0 +1,14 @@
+const snapCover = lib.snapLatchCoverAssembly({
+  width: 72,
+  depth: 44,
+  ledgeWidth: 8,
+  parentThickness: 6,
+});
+
+verify.equal('snap latch cover has receiver and cover parts', snapCover.parts.length, 2);
+verify.greaterThan('snap hooks tuck under catch land', snapCover.dims.hookThrow, snapCover.dims.latchThickness);
+verify.greaterThan('receiver leaves a usable service opening', snapCover.dims.openingWidth, 48);
+verify.notColliding('snap hooks clear receiver windows', snapCover.cover, snapCover.parent);
+verify.inRange('snap cover has small seating clearance', snapCover.dims.faceClearance, 0.01, 0.08);
+
+return snapCover.parts;

package/examples/api/static-assembly-connectors.forge.js

@@ -14,7 +14,7 @@ const railThickness = 12;
 const legSize = 14;
 const slatThickness = 10;
 const slatWidth = 18;
-const railY = benchWidth / 2 - railThickness / 2;
+const railCenterSpan = benchWidth - railThickness;
 const legInset = 26;
 const supportXs = Array.from({ length: slatCount }, (_, i) =>
   slatCount === 1
@@ -22,15 +22,14 @@ const supportXs = Array.from({ length: slatCount }, (_, i) =>
     : -benchLength / 2 + legInset + ((benchLength - legInset * 2) * i) / (slatCount - 1)
 );
 
-function makeRail(sign) {
+function makeRail() {
   return box(benchLength, railThickness, railHeight)
-    .translate(0, sign * railY, 0)
     .withConnectors(
       Object.fromEntries(
         supportXs.map((x, i) => [
           `leg_${i}`,
           connector.female("leg-seat", {
-            origin: [x, sign * railY, 0],
+            origin: [x, 0, 0],
             axis: [0, 0, -1],
             up: [1, 0, 0],
           }),
@@ -42,7 +41,7 @@ function makeRail(sign) {
         supportXs.map((x, i) => [
           `slat_${i}`,
           connector.female("slat-seat", {
-            origin: [x, sign * railY, railHeight],
+            origin: [x, 0, railHeight],
             axis: [0, 0, 1],
             up: [1, 0, 0],
           }),
@@ -64,30 +63,29 @@ function makeLeg() {
 function makeSlat() {
   return box(slatWidth, benchWidth, slatThickness).withConnectors({
     left_seat: connector.male("slat-seat", {
-      origin: [0, -railY, 0],
+      origin: [0, -railCenterSpan / 2, 0],
       axis: [0, 0, -1],
       up: [1, 0, 0],
     }),
     right_seat: connector.male("slat-seat", {
-      origin: [0, railY, 0],
+      origin: [0, railCenterSpan / 2, 0],
       axis: [0, 0, -1],
       up: [1, 0, 0],
     }),
   });
 }
 
-const leftRail = makeRail(-1).color("#8b5a2b");
-const rightRail = makeRail(1).color("#8b5a2b");
-
+const leftRail = makeRail().color("#8b5a2b");
 const leftLegs = supportXs.map((_, i) =>
   makeLeg().matchTo(leftRail, "head", `leg_${i}`).color("#b57f45")
 );
-const rightLegs = supportXs.map((_, i) =>
-  makeLeg().matchTo(rightRail, "head", `leg_${i}`).color("#b57f45")
-);
 const slats = supportXs.map((_, i) =>
   makeSlat().matchTo(leftRail, "left_seat", `slat_${i}`).color(i % 2 === 0 ? "#d9b07a" : "#c99b63")
 );
+const rightRail = makeRail().matchTo(slats[0], "slat_0", "right_seat").color("#8b5a2b");
+const rightLegs = supportXs.map((_, i) =>
+  makeLeg().matchTo(rightRail, "head", `leg_${i}`).color("#b57f45")
+);
 
 const bench = group(
   { name: "LeftRail", shape: leftRail },
@@ -97,9 +95,9 @@ const bench = group(
   ...slats.map((shape, i) => ({ name: `Slat${i}`, shape })),
 );
 
-verify.equal("First left leg is seated", bench.connectorDistance("LeftRail.leg_0", "LeftLeg0.head"), 0, 0.01);
-verify.equal("First slat is seated on left rail", bench.connectorDistance("LeftRail.slat_0", "Slat0.left_seat"), 0, 0.01);
-verify.equal("First slat also reaches the right rail", bench.connectorDistance("RightRail.slat_0", "Slat0.right_seat"), 0, 0.01);
+verify.connectorDistance("First left leg is seated", bench, "LeftRail.leg_0", "LeftLeg0.head", 0, 0.01);
+verify.connectorDistance("First slat is seated on left rail", bench, "LeftRail.slat_0", "Slat0.left_seat", 0, 0.01);
+verify.connectorDistance("First slat also reaches the right rail", bench, "RightRail.slat_0", "Slat0.right_seat", 0, 0.01);
 
 scene({
   background: { top: "#dce7f5", bottom: "#f7fbff" },

package/examples/api/thumb-screw-clamp.forge.js

@@ -0,0 +1,15 @@
+// Thumb-screw clamp with a real threaded boss, captive pressure pad, and clamped workpiece.
+const clamp = lib.thumbScrewClampAssembly({
+  screwSize: 'M6',
+  workpieceThickness: 20,
+  workpieceDepth: 50,
+});
+
+verify.equal('thumb screw clamp has frame workpiece and screw', clamp.parts.length, 3);
+verify.notColliding('thumb screw clears threaded boss bore', clamp.clampScrew, clamp.frame);
+verify.clearanceBetween('pressure pad is seated on workpiece', clamp.clampScrew, clamp.workpiece, -0.01, 0.05);
+verify.clearanceBetween('fixed anvil is seated on workpiece', clamp.frame, clamp.workpiece, -0.01, 0.05);
+verify.greaterThan('threaded boss leaves wall around screw envelope', clamp.dims.bossDiameter - clamp.dims.threadEnvelopeDiameter, 4);
+verify.greaterThan('frame depth captures the workpiece and pads', clamp.dims.frameDepth, clamp.dims.workpieceDepth);
+
+return clamp.parts;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecad",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "Code-first parametric CAD for JavaScript/TypeScript, in the browser and CLI.",
   "license": "BUSL-1.1",
   "type": "module",