forgecad 0.9.4 → 0.9.6

package/examples/api/guided-loft-olive-oil-bottle.forge.js

@@ -0,0 +1,135 @@
+/**
+ * Guided loft vs ProductSkin: olive oil bottle.
+ *
+ * Left: the new namespaced Loft.withGuideRails(...) primitive. Right: the
+ * equivalent Product.skin(...) authoring style for comparison.
+ */
+
+Product.scenePreset('product');
+
+viewConfig({
+  camera: { position: [190, -250, 150], target: [8, 0, 88], fov: 34 },
+});
+
+const darkOlive = {
+  color: '#34462f',
+  material: {
+    opacity: 0.58,
+    roughness: 0.14,
+    metalness: 0,
+    clearcoat: 1,
+    clearcoatRoughness: 0.04,
+    transmission: 0.28,
+    thickness: 4,
+  },
+};
+const labelStock = Product.materials.mattePlastic('#eee8d8');
+const blackCap = Product.materials.softRubber({ color: '#171a15' });
+
+const guidedStations = [
+  Loft.station(roundedRect(52, 34, 8), 0),
+  Loft.station(roundedRect(60, 38, 11), 78),
+  Loft.station(roundedRect(42, 27, 10), 128),
+  Loft.station(circle2d(12, 64), 166),
+  Loft.station(circle2d(14, 64), 184),
+];
+
+const leftSilhouette = path()
+  .moveTo(-26, 0)
+  .bezierTo(-31, 30, -33, 55, -31, 72)
+  .bezierTo(-30, 90, -27, 107, -25, 118)
+  .bezierTo(-20, 142, -12, 152, -12, 166)
+  .lineTo(-14, 184);
+
+const rightSilhouette = path()
+  .moveTo(26, 0)
+  .bezierTo(31, 30, 33, 55, 31, 72)
+  .bezierTo(30, 90, 27, 107, 25, 118)
+  .bezierTo(20, 142, 12, 152, 12, 166)
+  .lineTo(14, 184);
+
+const backCrown = path()
+  .moveTo(-17, 0)
+  .bezierTo(-21, 30, -22, 56, -20, 72)
+  .bezierTo(-19, 92, -17, 108, -16, 118)
+  .bezierTo(-13, 142, -10, 154, -10, 166)
+  .lineTo(-12, 184);
+
+const frontCrown = path()
+  .moveTo(17, 0)
+  .bezierTo(22, 30, 24, 56, 22, 72)
+  .bezierTo(21, 92, 19, 108, 18, 118)
+  .bezierTo(14, 142, 10, 154, 10, 166)
+  .lineTo(12, 184);
+
+const leftRail = Loft.pathOnXz(leftSilhouette);
+const rightRail = Loft.pathOnXz(rightSilhouette);
+const backRail = Loft.pathOnYz(backCrown);
+const frontRail = Loft.pathOnYz(frontCrown);
+
+const guidedBottle = Loft.withGuideRails(
+  guidedStations,
+  [
+    Loft.leftRail(leftRail),
+    Loft.rightRail(rightRail),
+    Loft.backRail(backRail),
+    Loft.frontRail(frontRail),
+  ],
+  { samples: 19, edgeLength: 1.3 },
+)
+  .as('guided-loft-olive-glass')
+  .material(darkOlive.material)
+  .color(darkOlive.color);
+
+const guidedLabel = Product.applyMaterial(
+  roundedRect(34, 58, 4)
+    .extrude(0.8)
+    .rotateX(90)
+    .translate(0, 22.5, 76)
+    .as('guided-loft-cream-label'),
+  labelStock,
+);
+
+const guidedCap = Product.applyMaterial(cylinder(18, 12, 12, 64).translate(0, 0, 184).as('guided-loft-black-cap'), blackCap);
+
+const guided = group(
+  { name: 'body', shape: guidedBottle },
+  { name: 'label', shape: guidedLabel },
+  { name: 'cap', shape: guidedCap },
+).translate(-52, 0, 0);
+
+const productBottle = Product.skin('product-skin-olive-glass')
+  .axis('Z')
+  .stations([
+    Product.station('base').z(0).roundedRect(52, 34, 8),
+    Product.station('body').z(78).roundedRect(60, 38, 11),
+    Product.station('shoulder').z(128).roundedRect(42, 27, 10),
+    Product.station('neck').z(166).circle(24),
+    Product.station('lip').z(184).circle(28),
+  ])
+  .rails({
+    leftSilhouette: Product.rail.polyline(leftRail),
+    frontCrown: Product.rail.polyline(frontRail),
+  })
+  .material(darkOlive)
+  .edgeLength(1.3)
+  .build();
+
+const productLabel = Product.applyMaterial(
+  roundedRect(34, 58, 4)
+    .extrude(0.8)
+    .rotateX(90)
+    .translate(0, 22.5, 76)
+    .as('product-skin-cream-label'),
+  labelStock,
+);
+
+const productCap = Product.applyMaterial(cylinder(18, 12, 12, 64).translate(0, 0, 184).as('product-skin-black-cap'), blackCap);
+
+const productSkinComparison = group(
+  { name: 'body', shape: productBottle.toShape() },
+  { name: 'label', shape: productLabel },
+  { name: 'cap', shape: productCap },
+).translate(52, 0, 0);
+
+return [guided, productSkinComparison];

package/examples/api/sdf-circular-array-knurling.forge.js

@@ -0,0 +1,19 @@
+// SDF circular array — fogleman-style folded-domain knurling.
+// circularArray evaluates the source groove twice no matter how many copies it creates.
+
+const body = sdf.cylinder(42, 11);
+
+const rightHandGroove = sdf.box(2.4, 1.2, 48)
+  .rotateZ(45)
+  .circularArray(32, 11.6)
+  .twist(2.2);
+
+const leftHandGroove = sdf.box(2.4, 1.2, 48)
+  .rotateZ(-45)
+  .circularArray(32, 11.6)
+  .twist(-2.2);
+
+return body
+  .subtract(rightHandGroove, leftHandGroove)
+  .color('#8da2ad')
+  .material({ roughness: 0.38, metalness: 0.18 });

package/examples/api/sdf-pattern2d-ceramic-ripple-set.forge.js

@@ -0,0 +1,83 @@
+// Native Pattern2D relief on ceramic forms: flutes, bands, and woven bowl texture.
+
+scene({
+  background: { top: '#fff8f1', bottom: '#d8e4ea' },
+  camera: { position: [90, -126, 66], target: [0, 0, 8], fov: 34 },
+  environment: { preset: 'studio', intensity: 1.28 },
+  lights: [
+    { type: 'ambient', color: '#ffffff', intensity: 0.28 },
+    { type: 'point', position: [54, -72, 90], color: '#fff1d0', intensity: 2.2, distance: 280, decay: 1.12 },
+    { type: 'point', position: [-76, 48, 62], color: '#84d8ff', intensity: 1.15, distance: 240, decay: 1.18 },
+    { type: 'directional', position: [30, -56, 150], color: '#ffffff', intensity: 0.58 },
+  ],
+  postProcessing: {
+    toneMappingExposure: 1.12,
+    bloom: { intensity: 0.08, threshold: 0.84, radius: 0.38 },
+    vignette: { darkness: 0.12, offset: 0.62 },
+  },
+});
+
+const ceramic = (shape, color) =>
+  shape.color(color).material({
+    roughness: 0.46,
+    metalness: 0,
+    clearcoat: 0.72,
+    clearcoatRoughness: 0.18,
+  });
+
+const p = sdf.pattern2d();
+
+const flutedPorcelain = p
+  .sineWave({ direction: [1, 0], wavelength: 4.6, amplitude: 0.28 })
+  .add(p.sineWave({ direction: [0, 1], wavelength: 18, amplitude: 0.08 }))
+  .clamp(-0.34, 0.34);
+
+const carvedBands = p
+  .stripes({ direction: [0, 1], spacing: 7.5, width: 0.9, depth: 0.2 })
+  .add(p.sineWave({ direction: [1, 1], wavelength: 9, amplitude: 0.08 }))
+  .clamp(-0.27, 0.07);
+
+const wovenGlaze = p
+  .overUnderWeave({ spacing: 2.45, threadWidth: 1.08, depth: 0.34 })
+  .add(p.sineWave({ direction: [1, -1], wavelength: 13, amplitude: 0.055 }))
+  .clamp(-0.42, 0.06);
+
+const tallVase = ceramic(
+  sdf.cylinder(58, 11)
+    .shell(1.35)
+    .surfaceDisplace(flutedPorcelain, { uv: 'cylinder' })
+    .subtract(sdf.cylinder(66, 8.2))
+    .translate(-35, 0, 3),
+  '#f2efe2',
+);
+
+const bandedCup = ceramic(
+  sdf.cylinder(38, 14)
+    .shell(1.25)
+    .surfaceDisplace(carvedBands, { uv: 'cylinder' })
+    .subtract(sdf.cylinder(46, 10.6))
+    .translate(0, 0, -7),
+  '#8fb7c7',
+);
+
+const lowBowl = ceramic(
+  sdf.sphere(22)
+    .shell(1.4)
+    .surfaceDisplace(wovenGlaze)
+    .subtract(sdf.box(68, 68, 40).translate(0, 0, 17))
+    .translate(37, 0, -8),
+  '#c97462',
+);
+
+const footRings = ceramic(
+  sdf
+    .torus(10.5, 0.75)
+    .translate(-35, 0, -27)
+    .union(
+      sdf.torus(12.5, 0.72).translate(0, 0, -26),
+      sdf.torus(14.5, 0.72).translate(37, 0, -25),
+    ),
+  '#d8c59f',
+);
+
+return { tallVase, bandedCup, lowBowl, footRings };

package/examples/api/sdf-pattern2d-grip-tread.forge.js

@@ -0,0 +1,72 @@
+// Native Pattern2D relief for a tactile grip: diamond tread, metal collars, no JS callbacks.
+
+scene({
+  background: { top: '#eef4f7', bottom: '#ccd8df' },
+  camera: { position: [82, -118, 54], target: [0, 0, 0], fov: 32 },
+  environment: { preset: 'studio', intensity: 1.35 },
+  lights: [
+    { type: 'ambient', color: '#ffffff', intensity: 0.24 },
+    { type: 'point', position: [56, -78, 78], color: '#ffffff', intensity: 2.1, distance: 260, decay: 1.12 },
+    { type: 'point', position: [-62, 48, 46], color: '#73d8ff', intensity: 1.25, distance: 230, decay: 1.2 },
+    { type: 'directional', position: [36, -52, 130], color: '#fff0cf', intensity: 0.62 },
+  ],
+  postProcessing: {
+    toneMappingExposure: 1.08,
+    bloom: { intensity: 0.1, threshold: 0.82, radius: 0.36 },
+    vignette: { darkness: 0.13, offset: 0.58 },
+  },
+});
+
+const p = sdf.pattern2d();
+
+const diamondTread = p
+  .stripes({ direction: [1, 1], spacing: 5.2, width: 1.05, depth: 0.42 })
+  .max(p.stripes({ direction: [1, -1], spacing: 5.2, width: 1.05, depth: 0.42 }))
+  .add(p.sineWave({ direction: [0, 1], wavelength: 19, amplitude: 0.06 }))
+  .clamp(-0.54, 0.04);
+
+const collarGrooves = p
+  .stripes({ direction: [0, 1], spacing: 2.4, width: 0.45, depth: 0.09 })
+  .add(p.sineWave({ direction: [1, 0], wavelength: 8, amplitude: 0.018 }))
+  .clamp(-0.12, 0.02);
+
+const rubber = (shape) =>
+  shape.color('#1f2227').material({
+    roughness: 0.86,
+    metalness: 0.02,
+    clearcoat: 0.08,
+    clearcoatRoughness: 0.72,
+  });
+
+const satinMetal = (shape) =>
+  shape.color('#c3cbd4').material({
+    roughness: 0.34,
+    metalness: 0.78,
+    clearcoat: 0.42,
+    clearcoatRoughness: 0.18,
+  });
+
+const grip = rubber(
+  sdf.cylinder(78, 13)
+    .shell(1.7)
+    .surfaceDisplace(diamondTread, { uv: 'cylinder' })
+    .subtract(sdf.cylinder(88, 9.0)),
+);
+
+const core = satinMetal(sdf.cylinder(86, 6.8));
+const leftCollar = satinMetal(
+  sdf.torus(13.2, 1.45).surfaceDisplace(collarGrooves, { uv: 'torus' }).translate(0, 0, -39),
+);
+const rightCollar = satinMetal(
+  sdf.torus(13.2, 1.45).surfaceDisplace(collarGrooves, { uv: 'torus' }).translate(0, 0, 39),
+);
+const endLips = satinMetal(sdf.box(1.1, 1.1, 5.0).circularArray(44, 15.2));
+
+return {
+  core,
+  grip,
+  leftCollar,
+  rightCollar,
+  leftEndKnurl: endLips.translate(0, 0, -41.5),
+  rightEndKnurl: endLips.translate(0, 0, 41.5),
+};

package/examples/api/sdf-pattern2d-orbital-jewelry.forge.js

@@ -0,0 +1,62 @@
+// Native Pattern2D relief plus folded circular array accents for an ornamental SDF piece.
+
+scene({
+  background: { top: '#101420', bottom: '#223242' },
+  camera: { position: [74, -104, 58], target: [0, 0, 4], fov: 31 },
+  environment: { preset: 'night', intensity: 1.18 },
+  lights: [
+    { type: 'ambient', color: '#172030', intensity: 0.18 },
+    { type: 'point', position: [48, -66, 72], color: '#ffd36f', intensity: 2.35, distance: 250, decay: 1.08 },
+    { type: 'point', position: [-52, 48, 58], color: '#58e5ff', intensity: 1.85, distance: 230, decay: 1.14 },
+    { type: 'point', position: [0, 36, 76], color: '#ff7ab8', intensity: 1.15, distance: 220, decay: 1.2 },
+    { type: 'directional', position: [28, -48, 138], color: '#ffffff', intensity: 0.58 },
+  ],
+  fog: { color: '#101420', near: 130, far: 330 },
+  postProcessing: {
+    toneMappingExposure: 1.32,
+    bloom: { intensity: 0.44, threshold: 0.56, radius: 0.56 },
+    vignette: { darkness: 0.42, offset: 0.44 },
+  },
+});
+
+const p = sdf.pattern2d();
+
+const braidedGold = p
+  .overUnderWeave({ spacing: 1.6, threadWidth: 0.72, depth: 0.18 })
+  .add(p.sineWave({ direction: [1, 0], wavelength: 7.2, amplitude: 0.035 }))
+  .clamp(-0.23, 0.04);
+
+const opalSkin = p
+  .sineWave({ direction: [1, 0], wavelength: 6, amplitude: 0.18 })
+  .add(p.sineWave({ direction: [0, 1], wavelength: 4.2, amplitude: 0.12 }))
+  .add(p.stripes({ direction: [1, 1], spacing: 5.5, width: 0.7, depth: 0.08 }))
+  .clamp(-0.2, 0.22);
+
+const gold = (shape) =>
+  shape.color('#e8b95f').material({
+    roughness: 0.25,
+    metalness: 0.92,
+    clearcoat: 0.45,
+    clearcoatRoughness: 0.08,
+    reflectivity: 0.72,
+  });
+
+const opal = (shape) =>
+  shape.color('#9be9dd').material({
+    roughness: 0.12,
+    metalness: 0,
+    clearcoat: 1,
+    clearcoatRoughness: 0.03,
+    opacity: 0.86,
+    transmission: 0.22,
+    reflectivity: 0.84,
+    ior: 1.42,
+  });
+
+const braidedBand = gold(sdf.torus(24, 2.9).surfaceDisplace(braidedGold, { uv: 'torus' }));
+const centerStone = opal(sdf.sphere(8.8).surfaceDisplace(opalSkin).translate(0, 0, 0.8));
+const beadHalo = gold(sdf.sphere(1.8).circularArray(32, 31).translate(0, 0, 0.8));
+const northStar = opal(sdf.sphere(3.3).surfaceDisplace(opalSkin).translate(0, 31, 1.1));
+const southStar = opal(sdf.sphere(3.3).surfaceDisplace(opalSkin).translate(0, -31, 1.1));
+
+return { braidedBand, centerStone, beadHalo, northStar, southStar };

package/examples/api/sdf-surface-basket-weave.forge.js

@@ -0,0 +1,67 @@
+// Native SDF surface relief — user-composed Pattern2D IR lowers to shader + CPU.
+// These raw SDF leaves raymarch directly; call .toShape() only for export.
+
+scene({
+  background: { top: '#f6fbff', bottom: '#dfe9f3' },
+  camera: { position: [92, -128, 72], target: [0, 0, 3], fov: 34 },
+  environment: { preset: 'studio', intensity: 1.2 },
+  lights: [
+    { type: 'ambient', color: '#ffffff', intensity: 0.22 },
+    { type: 'point', position: [56, -72, 86], color: '#fff0cf', intensity: 2.0, distance: 260, decay: 1.15 },
+    { type: 'point', position: [-70, 52, 64], color: '#79d9ff', intensity: 1.45, distance: 240, decay: 1.2 },
+    { type: 'directional', position: [36, -68, 150], color: '#ffffff', intensity: 0.7 },
+  ],
+  postProcessing: {
+    toneMappingExposure: 1.12,
+    bloom: { intensity: 0.18, threshold: 0.74, radius: 0.42 },
+    vignette: { darkness: 0.18, offset: 0.58 },
+  },
+});
+
+const textile = (shape, color) =>
+  shape.color(color).material({
+    roughness: 0.72,
+    metalness: 0,
+    clearcoat: 0.22,
+    clearcoatRoughness: 0.58,
+  });
+
+const p = sdf.pattern2d();
+const weave = p.overUnderWeave({ spacing: 2.8, threadWidth: 1.2, depth: 0.55 });
+const diagonalRipple = p.sineWave({ direction: [1, 1], wavelength: 11, amplitude: 0.08 });
+const bowlPattern = weave.add(diagonalRipple).clamp(-0.68, 0.08);
+
+const bowl = textile(
+  sdf.sphere(24)
+    .shell(1.8)
+    .surfaceDisplace(bowlPattern)
+    .subtract(sdf.box(70, 70, 36).translate(0, 0, 20))
+    .translate(-46, 0, 0),
+  '#d9826b',
+);
+
+const sleevePattern = p
+  .overUnderWeave({ spacing: 2.15, threadWidth: 0.95, depth: 0.45 })
+  .add(p.stripes({ direction: [1, 0], spacing: 7, width: 0.7, depth: 0.18 }));
+
+const sleeve = textile(
+  sdf.cylinder(38, 13)
+    .shell(1.4)
+    .surfaceDisplace(sleevePattern, { uv: 'cylinder' })
+    .subtract(sdf.cylinder(46, 9.8))
+    .translate(0, 0, 0),
+  '#6fa6a3',
+);
+
+const ringPattern = p
+  .overUnderWeave({ spacing: 1.75, threadWidth: 0.78, depth: 0.28 })
+  .add(p.sineWave({ direction: [0, 1], wavelength: 5.4, amplitude: 0.05 }));
+
+const ring = textile(
+  sdf.torus(18, 3.4)
+    .surfaceDisplace(ringPattern, { uv: 'torus' })
+    .translate(46, 0, 0),
+  '#c6a15b',
+);
+
+return { bowl, sleeve, ring };

package/examples/api/sector-gear-body.forge.js

@@ -0,0 +1,34 @@
+// Sector gear demo: partial tooth window composed with a visual/structural body.
+
+const moduleSize = Param.number("Module", 1.2, { min: 0.8, max: 2.5, step: 0.05, unit: "mm" });
+const teethOnFullCircle = Param.number("Pitch Teeth", 36, { min: 24, max: 72, integer: true });
+const toothCount = Param.number("Active Teeth", 11, { min: 2, max: 24, integer: true });
+const firstTooth = Param.number("First Tooth", 2, { min: 0, max: 35, integer: true });
+const faceWidth = Param.number("Face Width", 8, { min: 4, max: 16, unit: "mm" });
+
+const pitchRadius = (moduleSize * teethOnFullCircle) / 2;
+const rootRadius = pitchRadius - moduleSize * 1.25;
+const rimWidth = Math.max(2.4, moduleSize * 2);
+const hubDiameter = Math.max(8, moduleSize * 8);
+
+const body = lib.gearBodies.spoked({
+  outerRadius: rootRadius,
+  rimWidth,
+  hubDiameter,
+  boreDiameter: 5,
+  spokeCount: 5,
+  spokeWidth: Math.max(2, moduleSize * 1.8),
+  faceWidth,
+});
+
+const sector = lib.sectorGear({
+  module: moduleSize,
+  teethOnFullCircle,
+  firstTooth: Math.min(firstTooth, teethOnFullCircle - 1),
+  toothCount: Math.min(toothCount, teethOnFullCircle),
+  pressureAngleDeg: 20,
+  faceWidth,
+  body,
+});
+
+return [{ name: "Sector Gear", shape: sector.color("#d5a15f") }];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecad",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Code-first parametric CAD for JavaScript/TypeScript, in the browser and CLI.",
   "license": "BUSL-1.1",
   "type": "module",
@@ -101,7 +101,25 @@
     "beta:shell": "bash scripts/beta.sh shell",
     "beta:db": "bash scripts/beta.sh db",
     "beta:refresh": "bash scripts/beta.sh refresh",
-    "beta:local": "bash scripts/beta-local.sh",
+    "beta:local": "bash scripts/beta.sh local",
+    "beta:help": "bash scripts/beta.sh help",
+    "prod:setup": "bash scripts/prod.sh setup",
+    "prod:deploy": "bash scripts/prod.sh deploy",
+    "prod:smoke": "bash scripts/prod.sh smoke",
+    "prod:deploy:backend": "bash scripts/prod.sh deploy-backend",
+    "prod:deploy:all": "bash scripts/prod.sh deploy-all",
+    "prod:rollback": "bash scripts/prod.sh rollback",
+    "prod:rollback:backend": "bash scripts/prod.sh rollback-backend",
+    "prod:logs": "bash scripts/prod.sh logs",
+    "prod:logs:backend": "bash scripts/prod.sh logs-backend",
+    "prod:open": "bash scripts/prod.sh open",
+    "prod:shell": "bash scripts/prod.sh shell",
+    "prod:shell:backend": "bash scripts/prod.sh shell-backend",
+    "prod:db": "bash scripts/prod.sh db",
+    "prod:health": "bash scripts/prod/health.sh",
+    "prod:errors": "bash scripts/prod/errors.sh",
+    "prod:promote-beta": "fish scripts/promote-beta-to-prod.fish",
+    "prod:help": "bash scripts/prod.sh help",
     "gen:types": "node scripts/gen-forge-types.mjs",
     "gen:docs": "node scripts/gen-api-docs.mjs",
     "gen:cli-docs": "node scripts/gen-cli-docs.mjs",