softbox 4.4.2 → 4.6.0

package/dist/index.d.cts

@@ -355,9 +355,13 @@ export declare interface LoadingIndicatorOptions {
 export declare type ModelUnits = 'meters' | 'centimeters' | 'millimeters' | 'feet' | 'inches';
 
 /**
- * Progressive path tracing for photoreal stills (three-gpu-pathtracer). The
- * tracer accumulates samples whenever the camera rests and presents the
- * converged frame; it ships in a lazy chunk that loads only when enabled.
+ * Progressive path tracing for photoreal rendering (three-gpu-pathtracer).
+ * Interactive: while the camera moves you see a fast preview, and whenever it
+ * rests the tracer re-accumulates to a converged frame — orbiting after
+ * convergence starts a fresh accumulation from the new viewpoint. The tracer
+ * stays warm for the viewer's lifetime; it ships in a lazy chunk that loads
+ * only when enabled. While animations play, accumulation is suspended (the
+ * raster renderer shows the motion) and resumes on the paused pose.
  *
  * The whole object is structural in `<SimpleViewer>`: changing ANY field
  * rebuilds the viewer (and reloads the model).
@@ -529,6 +533,14 @@ export declare interface SimpleViewerOptions {
      * Ignored; will be removed in 5.0.
      */
     animationLoop?: ((time: number) => void) | null;
+    /**
+     * Replace the canvas with an `<img>` snapshot when a path-traced
+     * accumulation completes; the first click restores the live viewer by
+     * reloading the model (default `false`). A legacy from one-shot path
+     * tracing — the interactive tracer keeps the converged frame on the live
+     * canvas and re-accumulates on camera moves, so most consumers should
+     * leave this off.
+     */
     replaceWithScreenshotOnComplete?: boolean;
     /**
      * When to boot the WebGL engine and fetch the model (default `'eager'`).

package/dist/index.d.ts

@@ -355,9 +355,13 @@ export declare interface LoadingIndicatorOptions {
 export declare type ModelUnits = 'meters' | 'centimeters' | 'millimeters' | 'feet' | 'inches';
 
 /**
- * Progressive path tracing for photoreal stills (three-gpu-pathtracer). The
- * tracer accumulates samples whenever the camera rests and presents the
- * converged frame; it ships in a lazy chunk that loads only when enabled.
+ * Progressive path tracing for photoreal rendering (three-gpu-pathtracer).
+ * Interactive: while the camera moves you see a fast preview, and whenever it
+ * rests the tracer re-accumulates to a converged frame — orbiting after
+ * convergence starts a fresh accumulation from the new viewpoint. The tracer
+ * stays warm for the viewer's lifetime; it ships in a lazy chunk that loads
+ * only when enabled. While animations play, accumulation is suspended (the
+ * raster renderer shows the motion) and resumes on the paused pose.
  *
  * The whole object is structural in `<SimpleViewer>`: changing ANY field
  * rebuilds the viewer (and reloads the model).
@@ -529,6 +533,14 @@ export declare interface SimpleViewerOptions {
      * Ignored; will be removed in 5.0.
      */
     animationLoop?: ((time: number) => void) | null;
+    /**
+     * Replace the canvas with an `<img>` snapshot when a path-traced
+     * accumulation completes; the first click restores the live viewer by
+     * reloading the model (default `false`). A legacy from one-shot path
+     * tracing — the interactive tracer keeps the converged frame on the live
+     * canvas and re-accumulates on camera moves, so most consumers should
+     * leave this off.
+     */
     replaceWithScreenshotOnComplete?: boolean;
     /**
      * When to boot the WebGL engine and fetch the model (default `'eager'`).

package/dist/simple-viewer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-B_YjoRyg.cjs");exports.ControlType=e.ControlType;exports.ErrorCode=e.ErrorCode;exports.Hotspot=e.Hotspot;exports.SimpleViewer=e.SimpleViewerWrapper;exports.ThreeViewerError=e.ThreeViewerError;exports.TypedEventEmitter=e.TypedEventEmitter;exports.VIEWER_PRESETS=e.VIEWER_PRESETS;exports.defaultOptions=e.defaultOptions;exports.resolvePreset=e.resolvePreset;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BA_1qZxy.cjs");exports.ControlType=e.ControlType;exports.ErrorCode=e.ErrorCode;exports.Hotspot=e.Hotspot;exports.SimpleViewer=e.SimpleViewerWrapper;exports.ThreeViewerError=e.ThreeViewerError;exports.TypedEventEmitter=e.TypedEventEmitter;exports.VIEWER_PRESETS=e.VIEWER_PRESETS;exports.defaultOptions=e.defaultOptions;exports.resolvePreset=e.resolvePreset;

package/dist/simple-viewer.es.js

@@ -1,4 +1,4 @@
-import { f as s, E as o, H as a, i as t, e as E, T as i, V as p, j as T, r as l } from "./index-C3wD-bda.js";
+import { f as s, E as o, H as a, h as t, e as E, T as i, V as p, i as T, r as l } from "./index-DoB8YjQ9.js";
 export {
   s as ControlType,
   o as ErrorCode,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "softbox",
   "private": false,
-  "version": "4.4.2",
+  "version": "4.6.0",
   "homepage": "https://leming.github.io/softbox/",
   "type": "module",
   "description": "Batteries-included React 3D viewer — any GLB looks studio-shot in one line",