partforge 0.53.0 → 0.54.0

package/src/framework/viewer.js

@@ -39,13 +39,15 @@ export function srgbEncodeInPlace(data) {
 // `renderer.renderOffscreen(pose)` does the GL work (temp camera → offscreen
 // target → readback → JPEG data URL); injected so this is unit-testable without
 // a GL context. The grid is hidden for the whole synchronous pass and restored.
-export function captureViewsFromScene(viewNames, { renderer, liveCamera, grid, bounds }) {
+export function captureViewsFromScene(viewNames, { renderer, liveCamera, grid, bounds, hidden = [] }) {
   const views = (viewNames?.length ? viewNames : ["iso", "front", "top"])
     .filter((v) => CANONICAL_VIEWS.includes(v))
     .slice(0, CANONICAL_VIEWS.length);
   const before = liveCamera.position.clone();
   const gridWasVisible = grid?.visible;
   if (grid) grid.visible = false;
+  const hiddenWas = hidden.map((o) => o.visible);
+  for (const o of hidden) o.visible = false;
   try {
     return views.map((view) => ({
       view,
@@ -53,6 +55,7 @@ export function captureViewsFromScene(viewNames, { renderer, liveCamera, grid, b
     }));
   } finally {
     if (grid) grid.visible = gridWasVisible;
+    hidden.forEach((o, i) => { o.visible = hiddenWas[i]; });
     liveCamera.position.copy(before); // belt-and-suspenders: never leak camera state
   }
 }
@@ -139,6 +142,10 @@ export function createViewer(container, part) {
   };
   scene.background = new THREE.Color(THEME.dark.bg);
 
+  let currentTheme = "dark";
+  const themeListeners = new Set();
+  function onThemeChange(cb) { themeListeners.add(cb); return () => themeListeners.delete(cb); }
+
   const camera = new THREE.PerspectiveCamera(45, 1, 0.1, 1000);
   camera.position.set(18, 12, 18);
 
@@ -536,6 +543,8 @@ export function createViewer(container, part) {
     for (const m of fadeLineMats.values()) m.color.set(t.line); // clones follow the theme
     cutaway.setTheme(mode, t.line);
     reassertLiveFades(); // setTheme re-clones every section's materials and reassigns them
+    currentTheme = THEME[mode] ? mode : "dark";
+    for (const cb of [...themeListeners]) cb(currentTheme);
   }
 
   function hideAssembly() {
@@ -640,6 +649,15 @@ export function createViewer(container, part) {
     return canvas.toDataURL("image/jpeg", quality);
   }
 
+  // Objects excluded from CANONICAL captures only (agent renders must stay
+  // dimension-free); captureCurrent — the user-framed showcase capture —
+  // deliberately does NOT consult this set.
+  const canonicalCaptureHidden = new Set();
+  function registerCanonicalCaptureHidden(obj) {
+    canonicalCaptureHidden.add(obj);
+    return () => canonicalCaptureHidden.delete(obj);
+  }
+
   // Render the canonical camera angles offscreen, framed to whatever is visible,
   // without disturbing the user's live view. Returns [{ view, dataUrl }].
   function captureCanonicalViews(viewNames) {
@@ -653,6 +671,7 @@ export function createViewer(container, part) {
       renderer: { renderOffscreen },
       liveCamera: camera,
       grid,
+      hidden: [...canonicalCaptureHidden],
       bounds: { center, radius },
     });
   }
@@ -877,6 +896,8 @@ export function createViewer(container, part) {
     controls.removeEventListener("start", onControlsStart);
     cameraStartListeners.clear();
     frameListeners.clear();
+    themeListeners.clear();
+    canonicalCaptureHidden.clear();
     camTween.cancel();
     controls.dispose();
     for (const t of flashTimers) clearTimeout(t);
@@ -930,6 +951,8 @@ export function createViewer(container, part) {
     setActive,
     onContextLost,
     setTheme,
+    onThemeChange,
+    getTheme: () => currentTheme,
     getCameraState,
     setCameraState,
     onCameraEnd,
@@ -946,6 +969,7 @@ export function createViewer(container, part) {
     resetCutaway: cutaway.reset,
     isWorldPointVisible: cutaway.isPointVisible,
     registerCutawayMaterial: cutaway.registerClippableMaterial,
+    registerCanonicalCaptureHidden,
     onCutawayHandleHover: cutaway.onHandleHoverChange,
     dispose,
   };

package/types/index.d.ts

@@ -87,6 +87,7 @@ export interface MountElements {
     reframe?: HTMLElement | null;
     theme?: HTMLElement | null;
     cutaway?: HTMLElement | null;
+    measure?: HTMLElement | null;
     railToggle?: HTMLElement | null;
   };
 }
@@ -142,6 +143,19 @@ export interface CaptureViewOptions {
   angle?: CanonicalView | string;
 }
 
+/**
+ * Measurement mode runtime controls. Dimensioned captures come straight from
+ * `captureCurrent()` while the mode is enabled — in-scene dims render into
+ * the frame natively (canonical-view captures and thumbnails never include
+ * them).
+ */
+export interface MeasureRuntime {
+  isEnabled(): boolean;
+  setEnabled(on: boolean): void;
+  clearPins(): void;
+  pinCount(): number;
+}
+
 /** Where playback is: idle, swinging the camera to an intro cue, playing, or paused. */
 export type AnimationStatus = "idle" | "intro" | "playing" | "paused";
 
@@ -253,6 +267,8 @@ export interface PartRuntime {
    * active view has none, where `state().animation` reads `null`.
    */
   animation: AnimationRuntime | null;
+  /** Measurement mode's runtime-controls API — mode on/off, unit, and pin state; dimensioned captures come from `captureCurrent()` while enabled. Always present (a no-op stand-in outside `makeHandle` tests). */
+  measure: MeasureRuntime;
 }
 
 /** Mount a full parametric-part app from a `PartDefinition`. */