@laplace.live/persona-sdk 1.10.0 → 1.11.1

package/dist/values/limits.d.ts

@@ -33,6 +33,10 @@ export declare function sceneLightIntensityMax(type: SceneLightType): number;
 export declare function sceneLightIsAimed(type: SceneLightType): boolean;
 /** Whether a light of `type` can cast shadows; ambient and area lights never do. */
 export declare function sceneLightCastsShadows(type: SceneLightType): boolean;
+/** Whether a light of `type` can light volumetric haze; directional and ambient lights never do. */
+export declare function sceneLightCanHaze(type: SceneLightType): boolean;
+/** Whether `light` lights volumetric haze now: switched on, opted in, and of a type that can. */
+export declare function sceneLightHazes(light: Pick<SceneLight, 'type' | 'enabled' | 'volumetric'>): boolean;
 export declare const LIVE2D_SCALE_MIN = 0.1;
 export declare const LIVE2D_SCALE_MAX = 24;
 export declare const VRM_SCALE_MIN = 0.05;

package/dist/values/limits.js

@@ -55,6 +55,14 @@ export function sceneLightIsAimed(type) {
 export function sceneLightCastsShadows(type) {
     return type !== 'ambient' && type !== 'area';
 }
+/** Whether a light of `type` can light volumetric haze; directional and ambient lights never do. */
+export function sceneLightCanHaze(type) {
+    return type === 'point' || type === 'spot' || type === 'area';
+}
+/** Whether `light` lights volumetric haze now: switched on, opted in, and of a type that can. */
+export function sceneLightHazes(light) {
+    return light.enabled !== false && light.volumetric === true && sceneLightCanHaze(light.type);
+}
 // Live2D bounds are the zoom clamp (zoom.ts re-exports these); VRM scales a world-space root.
 export const LIVE2D_SCALE_MIN = 0.1;
 export const LIVE2D_SCALE_MAX = 24;
@@ -164,6 +172,8 @@ export function defaultSceneLightOf(type) {
         width: DEFAULT_AREA_LIGHT_SIZE,
         height: DEFAULT_AREA_LIGHT_SIZE,
         roll: 0,
+        // Haze is a render pass of its own; a new light joins it only when asked.
+        volumetric: false,
         // A point light shadow is six cube faces, so it stays opt-in where a
         // directional light's single depth pass can be on by default.
         shadowQuality: type === 'directional' ? 'high' : 'off',

package/dist/values/volumetric-lighting.d.ts

@@ -30,7 +30,7 @@ export declare const SCENE_VOLUMETRIC_LIGHTING_SPECS: {
         readonly digits: 2;
     };
 };
-/** Existing scenes retain clear air until volumetric lighting is enabled. */
+/** How the haze looks once a light opts in; scenes with no volumetric light keep clear air. */
 export declare function defaultSceneVolumetricLighting(): SceneVolumetricLighting;
 /** Restore saved haze settings and clamp them to the shared editor bounds. */
 export declare function healSceneVolumetricLighting(raw: unknown): SceneVolumetricLighting;

package/dist/values/volumetric-lighting.js

@@ -8,11 +8,10 @@ export const SCENE_VOLUMETRIC_LIGHTING_SPECS = {
     range: { default: 20, min: 1, max: 100, step: 1, digits: 0 },
     speed: { default: 0.2, min: 0, max: 5, step: 0.05, digits: 2 },
 };
-/** Existing scenes retain clear air until volumetric lighting is enabled. */
+/** How the haze looks once a light opts in; scenes with no volumetric light keep clear air. */
 export function defaultSceneVolumetricLighting() {
     const specs = SCENE_VOLUMETRIC_LIGHTING_SPECS;
     return {
-        enabled: false,
         density: specs.density.default,
         intensity: specs.intensity.default,
         range: specs.range.default,
@@ -27,7 +26,6 @@ export function healSceneVolumetricLighting(raw) {
         return d;
     const specs = SCENE_VOLUMETRIC_LIGHTING_SPECS;
     return {
-        enabled: typeof raw.enabled === 'boolean' ? raw.enabled : d.enabled,
         density: clamp(finiteOr(raw.density, d.density), specs.density.min, specs.density.max),
         intensity: clamp(finiteOr(raw.intensity, d.intensity), specs.intensity.min, specs.intensity.max),
         range: clamp(finiteOr(raw.range, d.range), specs.range.min, specs.range.max),

package/dist/wire/types.d.ts

@@ -396,6 +396,11 @@ export interface SceneLight {
     height?: number;
     /** Area light rotation in its rectangle's plane, in degrees; defaults to 0. */
     roll?: number;
+    /**
+     * Light illuminated haze around this light; point, spot and area lights only.
+     * Defaults to false; omitted by hosts without per-light volumetric lighting.
+     */
+    volumetric?: boolean;
     /** Ambient and area lights never cast shadows. */
     shadowQuality: ShadowQuality;
     /** PCF disk radius in shadow-map texels; retained while PCSS is selected. */
@@ -412,9 +417,11 @@ export interface SceneFog {
     /** Exponential-squared falloff; the useful band is well under 1 at avatar scale. */
     density: number;
 }
-/** Illuminated haze in the 3D stage; rendered only by perspective cameras. */
+/**
+ * How the illuminated haze looks in the 3D stage; rendered only by perspective
+ * cameras, and only while some scene light opts in through `SceneLight.volumetric`.
+ */
 export interface SceneVolumetricLighting {
-    enabled: boolean;
     density: number;
     intensity: number;
     /** Distance from the camera in scene units. */
@@ -910,6 +917,11 @@ export interface SceneEnvironment {
     volumetricLighting?: SceneVolumetricLighting;
     /** Optimize unshadowed point lights on supported renderers; omitted by older hosts. */
     clusteredLighting?: boolean;
+    /**
+     * Simulate 3D objects as rigid bodies falling onto the stage floor; omitted by older hosts.
+     * The simulated pose is never saved — switching it off restores each object's placement.
+     */
+    physics?: boolean;
     effects: SceneEffects;
     /**
      * Built-in effects added as layers, in registry order — one keeps its row and tuning while

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "1.10.0",
+  "version": "1.11.1",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",