softbox 4.11.0 → 4.13.0

package/dist/index.d.cts

@@ -2,6 +2,19 @@ import { default as default_2 } from 'react';
 import * as React_2 from 'react';
 import * as THREE from 'three';
 
+/**
+ * A soft, shadowless directional light used for the fill and rim/back roles of
+ * a studio three-point rig. Same direction semantics as the key, but it never
+ * casts shadows (only the key does — see `findDirectionalLight`, which resolves
+ * the first directional as the shadow/contact-shadow source).
+ */
+export declare interface AccentLightOptions {
+    color?: string | number;
+    intensity?: number;
+    /** Direction is position → origin; distance does not attenuate. */
+    position?: Vec3Like | [number, number, number];
+}
+
 /** Uniform fill from every direction; lifts shadows, adds no shading. */
 export declare interface AmbientLightOptions {
     color?: string | number;
@@ -286,13 +299,20 @@ export declare interface HotspotProps {
 }
 
 /**
- * The three-light studio rig. Every light is optional; the defaults are a
- * balanced product-shot setup (see `defaultOptions.lighting`).
+ * The studio rig. Every light is optional; the defaults are a balanced
+ * product-shot three-point setup (see `defaultOptions.lighting`): a shadow-
+ * casting key, a soft opposite-side fill that opens the shadow, and a rim/back
+ * light behind the subject that separates its silhouette from the background.
+ * Ambient + hemisphere add a gentle omnidirectional base.
  */
 export declare interface LightingOptions {
     ambientLight?: AmbientLightOptions;
     hemisphereLight?: HemisphereLightOptions;
     directionalLight?: DirectionalLightOptions;
+    /** Soft opposite-side fill; opens the shadow side without a second shadow. */
+    fillLight?: AccentLightOptions;
+    /** Rim/back light behind the subject; separates the silhouette from the backdrop. */
+    rimLight?: AccentLightOptions;
 }
 
 /**
@@ -530,6 +550,14 @@ export declare interface SimpleViewerOptions {
      */
     floorAlignment?: boolean;
     backgroundColor?: string | number;
+    /**
+     * Optional darker edge colour for a RADIAL backdrop vignette. When set,
+     * `backgroundColor` is painted as the centre (behind the subject) and this as
+     * the corners/bottom, floating the model in a soft cove instead of a flat
+     * fill. Omit for a flat background. Runtime-tunable (applies on a live preset
+     * switch without a rebuild), same as `backgroundColor`.
+     */
+    backgroundColorEdge?: string | number;
     staticScene?: boolean;
     /** GLTF animation playback (autoplay, speed). */
     animations?: AnimationOptions;
@@ -702,10 +730,11 @@ declare interface Vec3Like {
 /**
  * Visual presets: cohesive deltas layered over the defaults (deep-merged) so a
  * model looks intentional on first paint. Each preset only sets **runtime** look
- * fields — background color, tone-mapping exposure and environment intensity —
- * so switching presets is applied live (no viewer rebuild, no model reload) and
- * everything else (camera auto-framing, lighting rig, controls, grid) is
- * inherited from the defaults. Explicit user options always win.
+ * fields — background color (plus an optional radial-vignette edge colour),
+ * tone-mapping exposure and environment intensity — so switching presets is
+ * applied live (no viewer rebuild, no model reload) and everything else (camera
+ * auto-framing, lighting rig, controls, grid) is inherited from the defaults.
+ * Explicit user options always win.
  */
 export declare const VIEWER_PRESETS: Record<ViewerPreset, Partial<SimpleViewerOptions>>;
 

package/dist/index.d.ts

@@ -2,6 +2,19 @@ import { default as default_2 } from 'react';
 import * as React_2 from 'react';
 import * as THREE from 'three';
 
+/**
+ * A soft, shadowless directional light used for the fill and rim/back roles of
+ * a studio three-point rig. Same direction semantics as the key, but it never
+ * casts shadows (only the key does — see `findDirectionalLight`, which resolves
+ * the first directional as the shadow/contact-shadow source).
+ */
+export declare interface AccentLightOptions {
+    color?: string | number;
+    intensity?: number;
+    /** Direction is position → origin; distance does not attenuate. */
+    position?: Vec3Like | [number, number, number];
+}
+
 /** Uniform fill from every direction; lifts shadows, adds no shading. */
 export declare interface AmbientLightOptions {
     color?: string | number;
@@ -286,13 +299,20 @@ export declare interface HotspotProps {
 }
 
 /**
- * The three-light studio rig. Every light is optional; the defaults are a
- * balanced product-shot setup (see `defaultOptions.lighting`).
+ * The studio rig. Every light is optional; the defaults are a balanced
+ * product-shot three-point setup (see `defaultOptions.lighting`): a shadow-
+ * casting key, a soft opposite-side fill that opens the shadow, and a rim/back
+ * light behind the subject that separates its silhouette from the background.
+ * Ambient + hemisphere add a gentle omnidirectional base.
  */
 export declare interface LightingOptions {
     ambientLight?: AmbientLightOptions;
     hemisphereLight?: HemisphereLightOptions;
     directionalLight?: DirectionalLightOptions;
+    /** Soft opposite-side fill; opens the shadow side without a second shadow. */
+    fillLight?: AccentLightOptions;
+    /** Rim/back light behind the subject; separates the silhouette from the backdrop. */
+    rimLight?: AccentLightOptions;
 }
 
 /**
@@ -530,6 +550,14 @@ export declare interface SimpleViewerOptions {
      */
     floorAlignment?: boolean;
     backgroundColor?: string | number;
+    /**
+     * Optional darker edge colour for a RADIAL backdrop vignette. When set,
+     * `backgroundColor` is painted as the centre (behind the subject) and this as
+     * the corners/bottom, floating the model in a soft cove instead of a flat
+     * fill. Omit for a flat background. Runtime-tunable (applies on a live preset
+     * switch without a rebuild), same as `backgroundColor`.
+     */
+    backgroundColorEdge?: string | number;
     staticScene?: boolean;
     /** GLTF animation playback (autoplay, speed). */
     animations?: AnimationOptions;
@@ -702,10 +730,11 @@ declare interface Vec3Like {
 /**
  * Visual presets: cohesive deltas layered over the defaults (deep-merged) so a
  * model looks intentional on first paint. Each preset only sets **runtime** look
- * fields — background color, tone-mapping exposure and environment intensity —
- * so switching presets is applied live (no viewer rebuild, no model reload) and
- * everything else (camera auto-framing, lighting rig, controls, grid) is
- * inherited from the defaults. Explicit user options always win.
+ * fields — background color (plus an optional radial-vignette edge colour),
+ * tone-mapping exposure and environment intensity — so switching presets is
+ * applied live (no viewer rebuild, no model reload) and everything else (camera
+ * auto-framing, lighting rig, controls, grid) is inherited from the defaults.
+ * Explicit user options always win.
  */
 export declare const VIEWER_PRESETS: Record<ViewerPreset, Partial<SimpleViewerOptions>>;
 

package/dist/simple-viewer.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BtZrTFUk.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-Boctv1Ta.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, h as t, e as E, T as i, V as p, i as T, r as l } from "./index-Df3usb4t.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-CWhSg5nm.js";
 export {
   s as ControlType,
   o as ErrorCode,

package/package.json

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