softbox 4.18.0 → 4.19.0

package/dist/index.d.cts

@@ -225,6 +225,7 @@ export declare enum ErrorCode {
     INVALID_STATE = "INVALID_STATE",
     INVALID_PARAMETER = "INVALID_PARAMETER",
     OPERATION_FAILED = "OPERATION_FAILED",
+    POST_PROCESSING_FAILED = "POST_PROCESSING_FAILED",
     UNKNOWN = "UNKNOWN"
 }
 
@@ -418,6 +419,13 @@ export declare interface PathTracingOptions {
 export declare interface RendererOptions {
     antialias?: boolean;
     alpha?: boolean;
+    premultipliedAlpha?: boolean;
+    /**
+     * Note: the viewer forces this ON regardless — a completed path-traced
+     * frame must survive on the canvas for captureStill to read back.
+     */
+    preserveDrawingBuffer?: boolean;
+    powerPreference?: 'high-performance' | 'low-power' | 'default';
     shadowMapEnabled?: boolean;
     pixelRatio?: number;
     /** A `THREE.ShadowMapType` constant (e.g. `THREE.PCFShadowMap` === 1). */
@@ -532,6 +540,11 @@ export declare interface SimpleViewerHandle {
     /**
      * Replace the environment map (reflections + background) at runtime with the
      * equirectangular HDRI/LDR image at `url`. Cached by URL, so re-applying is cheap.
+     *
+     * Like the capture APIs, the environment APIs throw (async ones reject) with
+     * INVALID_STATE when the viewer was disposed — including a dispose that lands
+     * while the map is still loading. Fire-and-forget callers should attach a
+     * `.catch` if unmount races are possible (e.g. React StrictMode in dev).
      */
     setEnvironmentMap: (url: string) => Promise<void>;
     /** Restore the built-in studio environment and clean gradient background. */

package/dist/index.d.ts

@@ -225,6 +225,7 @@ export declare enum ErrorCode {
     INVALID_STATE = "INVALID_STATE",
     INVALID_PARAMETER = "INVALID_PARAMETER",
     OPERATION_FAILED = "OPERATION_FAILED",
+    POST_PROCESSING_FAILED = "POST_PROCESSING_FAILED",
     UNKNOWN = "UNKNOWN"
 }
 
@@ -418,6 +419,13 @@ export declare interface PathTracingOptions {
 export declare interface RendererOptions {
     antialias?: boolean;
     alpha?: boolean;
+    premultipliedAlpha?: boolean;
+    /**
+     * Note: the viewer forces this ON regardless — a completed path-traced
+     * frame must survive on the canvas for captureStill to read back.
+     */
+    preserveDrawingBuffer?: boolean;
+    powerPreference?: 'high-performance' | 'low-power' | 'default';
     shadowMapEnabled?: boolean;
     pixelRatio?: number;
     /** A `THREE.ShadowMapType` constant (e.g. `THREE.PCFShadowMap` === 1). */
@@ -532,6 +540,11 @@ export declare interface SimpleViewerHandle {
     /**
      * Replace the environment map (reflections + background) at runtime with the
      * equirectangular HDRI/LDR image at `url`. Cached by URL, so re-applying is cheap.
+     *
+     * Like the capture APIs, the environment APIs throw (async ones reject) with
+     * INVALID_STATE when the viewer was disposed — including a dispose that lands
+     * while the map is still loading. Fire-and-forget callers should attach a
+     * `.catch` if unmount races are possible (e.g. React StrictMode in dev).
      */
     setEnvironmentMap: (url: string) => Promise<void>;
     /** Restore the built-in studio environment and clean gradient background. */