partforge 0.169.1 → 0.170.0

package/README.md

@@ -204,7 +204,9 @@ and projection and keep the file's own framing; a carried render mode and
 environment still apply) and `renderMode: "cad" | "realistic"` (the opening
 mode, over any carried one; it can change afterwards), and `autostart: false`
 (0.169.0+: the animation or turntable waits at its first frame until
-`handle.motion.start()`). An unknown option key
+`handle.motion.start()`), and `edgeWidth` / `edgeOpacity` (0.170.0+: the CAD
+edge lines' width in CSS pixels, default 1, and opacity, default 1 — a small
+card reads the default lines as heavy). An unknown option key
 throws. A baked animation always plays as authored — it
 loops, or plays once and holds its end pose. Every handle carries `drawn`, which
 resolves after the first frame showing the meshes, so a host can cross-fade from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "partforge",
-  "version": "0.169.1",
+  "version": "0.170.0",
   "description": "Turn a declarative part definition into a parametric-CAD web app (three.js + Manifold/Replicad). Requires a Vite-based consumer.",
   "type": "module",
   "license": "MIT",

package/src/framework/mount-preview.js

@@ -81,6 +81,10 @@
 //    `drawn` resolves on a frame showing exactly that pose, so a host can
 //    cross-fade from a still of it and then say go. A waiting animation's play
 //    button reads Play.
+//  - `edgeWidth` (0.170.0; CSS px, 0 < w <= 8, default 1) and `edgeOpacity`
+//    (0.170.0; 0 < o <= 1, default 1) — the CAD feature edge lines' thickness
+//    and strength. A small preview card reads the default 1 px lines as heavy;
+//    0.5 px is one device pixel on a 2x screen. Fixed for the mount.
 //  Any other key throws (an option this version does not know is a host bug).
 //
 // `handle.motion` (0.169.0; null before ready and once disposed, present for
@@ -136,10 +140,16 @@ function flag(name, value, fallback) {
 const KNOWN_OPTIONS = new Set([
   "glb", "elements", "viewerState", "animate",
   "chrome", "background", "contactShadow", "zoom", "pan", "turntable", "fill", "camera", "renderMode",
-  "autostart",
+  "autostart", "edgeWidth", "edgeOpacity",
 ]);
 
-function presentation({ chrome, background, contactShadow, zoom, pan, turntable, fill, camera, renderMode, autostart }) {
+function presentation({ chrome, background, contactShadow, zoom, pan, turntable, fill, camera, renderMode, autostart, edgeWidth, edgeOpacity }) {
+  if (edgeWidth !== undefined && !(typeof edgeWidth === "number" && edgeWidth > 0 && edgeWidth <= 8)) {
+    throw new TypeError("mountPreview: edgeWidth must be a number of CSS pixels above 0 and at most 8");
+  }
+  if (edgeOpacity !== undefined && !(typeof edgeOpacity === "number" && edgeOpacity > 0 && edgeOpacity <= 1)) {
+    throw new TypeError("mountPreview: edgeOpacity must be a number above 0 and at most 1");
+  }
   if (fill !== undefined && !(typeof fill === "number" && fill > 0 && fill <= 1)) {
     throw new TypeError("mountPreview: fill must be a number above 0 and at most 1");
   }
@@ -157,6 +167,8 @@ function presentation({ chrome, background, contactShadow, zoom, pan, turntable,
     defaultCamera: oneOf("camera", camera, ["carry", "default"], "carry") === "default",
     renderMode: oneOf("renderMode", renderMode, ["cad", "realistic"], null),
     autostart: flag("autostart", autostart, true),
+    edgeWidth: edgeWidth ?? 1,
+    edgeOpacity: edgeOpacity ?? 1,
   };
 }
 
@@ -280,6 +292,7 @@ export function mountPreview(container, options = {}) {
       transparent: opts.transparent, contactShadow: opts.contactShadow, zoom: opts.zoom, pan: opts.pan,
       // A turning model is framed swept a full turn, so no angle of it clips.
       frameFill: opts.fill, frameSwept: sweeps,
+      edgeWidth: opts.edgeWidth, edgeOpacity: opts.edgeOpacity,
     });
     cleanups.push(() => viewer.dispose());
     let tooltip = null, toolbar = null, viewStyle = null;

package/src/framework/viewer.js

@@ -176,8 +176,12 @@ export function captureCurrentFromScene(
 // vertical instead (a turntable never clips).
 // Unset keeps the fixed r·2.6 + 6 distance. mountPreview's presentation
 // options are the caller.
+// `edgeWidth` (CSS px, default 1) and `edgeOpacity` (0 < o <= 1, default 1)
+// style the CAD feature edge lines; a small preview reads them as heavy at the
+// default. Fades multiply into the opacity rather than replacing it.
 export function createViewer(container, part, {
   transparent = false, contactShadow = false, zoom = true, pan = true, frameFill = null, frameSwept = false,
+  edgeWidth = 1, edgeOpacity = 1,
 } = {}) {
   const names = Object.keys(part.parts);
   // Membership for host-supplied names. subMesh, cadMats and part.parts are
@@ -328,7 +332,9 @@ export function createViewer(container, part, {
 
   // CAD-style feature edge lines (anti-aliased "fat" lines), one per sub-part.
   const EDGE_ANGLE = 35; // deg — last-ditch threshold for payloads with no kernel edge data
-  const lineMaterial = new LineMaterial({ color: THEME.dark.line, linewidth: 1.0 }); // ~10% lighter, 1 px
+  const lineMaterial = new LineMaterial({ // ~10% lighter, 1 px by default
+    color: THEME.dark.line, linewidth: edgeWidth, transparent: edgeOpacity < 1, opacity: edgeOpacity,
+  });
   lineMaterial.resolution.set(1, 1); // real size set by resize() below
   const subLines = Object.fromEntries(
     names.map((n) => [n, new LineSegments2(new LineSegmentsGeometry(), lineMaterial)])
@@ -466,7 +472,7 @@ export function createViewer(container, part, {
       mesh.material = fm;
       const flm = fadeLineMatFor(name);
       const so = effectiveDisplayOf(name).opacity ?? 1;
-      flm.opacity = so > 0 ? fade / so : 0; // lines fade by the multiplier alone
+      flm.opacity = so > 0 ? (fade / so) * edgeOpacity : 0; // lines fade by the multiplier alone
       lines.material = flm;
     }
     mesh.visible = meshVisible;
@@ -2560,7 +2566,7 @@ export function createViewer(container, part, {
             if (lines.material === fadeLineMats.get(n)) lines.material = lineMaterial;
           } else {
             const f = fadeMatFor(n); f.opacity = fade; mesh.material = f;
-            const fl = fadeLineMatFor(n); fl.opacity = staticOpacity > 0 ? fade / staticOpacity : 0; lines.material = fl;
+            const fl = fadeLineMatFor(n); fl.opacity = staticOpacity > 0 ? (fade / staticOpacity) * edgeOpacity : 0; lines.material = fl;
           }
           mesh.visible = meshVisible; lines.visible = linesVisible && meshVisible;
         },

package/types/index.d.ts

@@ -830,6 +830,13 @@ export interface MountPreviewOptions {
    * angle 0) until `motion.start()`. `drawn` resolves on a frame showing that pose.
    */
   autostart?: boolean;
+  /**
+   * 0.170.0+: the CAD feature edge lines' width in CSS pixels, 0 < w <= 8 (default 1).
+   * A small preview card reads the default as heavy; 0.5 is one device pixel at 2x.
+   */
+  edgeWidth?: number;
+  /** 0.170.0+: the CAD feature edge lines' opacity, 0 < o <= 1 (default 1). */
+  edgeOpacity?: number;
   /**
    * 0 < fill <= 1 (0.168.0+): the opening framing (and the viewer's reframe) puts the
    * camera, along the opening view direction, so the model's bounding box as projected