@laplace.live/persona-sdk 0.4.0 → 0.6.0

package/dist/types.d.ts

@@ -235,6 +235,13 @@ export interface SceneCamera {
     fov: number;
 }
 export type SceneLightType = 'directional' | 'point' | 'ambient';
+/**
+ * Per-light shadow tier. `off` is the old `castShadow: false`; the rest raise
+ * shadow-map resolution. A point light pays 6 cube faces for the same tier a
+ * directional light covers with one map, so it gets the smaller of the pair.
+ */
+export declare const SHADOW_QUALITY_LEVELS: readonly ["off", "low", "medium", "high", "extra"];
+export type ShadowQuality = (typeof SHADOW_QUALITY_LEVELS)[number];
 /**
  * One scene light. Angles are degrees. Directional lights aim with
  * azimuth/elevation and sit at x/y/z (which moves their handle and shadow
@@ -253,7 +260,7 @@ export interface SceneLight {
     z: number;
     range: number;
     /** Ambient light is directionless, so it never casts whatever this says. */
-    castShadow: boolean;
+    shadowQuality: ShadowQuality;
     /** Penumbra width in shadow-map texels — a stylistic dial; the filter widens the edge uniformly. */
     shadowRadius: number;
 }
@@ -311,17 +318,65 @@ export interface SceneDepthOfField {
     bokehScale: number;
     focusRange: number;
 }
-/** Overlay/stylization gimmicks, each independently switchable. */
-export interface SceneStylize {
-    pixelate: {
-        enabled: boolean;
-        granularity: number;
-    };
-    glitch: {
-        enabled: boolean;
-    };
+/** Broadcast-style glitch bursts: slice tears, RGB split, block corruption, analog noise. */
+export interface SceneGlitch {
+    enabled: boolean;
+    /** Overall strength (0 to 2). */
+    intensity: number;
+    /** How fast the glitch pattern mutates. 1 re-rolls the tear 24 times per second. */
+    speed: number;
+    /** Seconds between bursts. 0 keeps the glitch running constantly. */
+    interval: number;
+    /** How long each burst lasts, in seconds. */
+    duration: number;
+    /** Horizontal slices the tear snaps to. Lower is chunkier. */
+    slices: number;
+    /** How far torn slices shift sideways, in output pixels. */
+    shift: number;
+    /** Chromatic RGB split during bursts, in output pixels. */
+    rgbShift: number;
+    /** Amount of corrupted block artifacts during bursts (0 to 1). */
+    blocks: number;
+    /** Analog noise and scanline flicker during bursts (0 to 1). */
+    noise: number;
+}
+/** Mosaic over the frame. `granularity` is pixels per block. */
+export interface ScenePixelate {
+    enabled: boolean;
+    granularity: number;
 }
-/** Post-processing over the rendered 3D frame. Everything off skips the effect chain entirely. */
+/** Rain droplets running down a glass pane in front of the frame, refracting it. */
+export interface SceneDroplets {
+    enabled: boolean;
+    /** How much rain falls, from a light drizzle to a downpour (0 to 1.25). */
+    intensity: number;
+    /** Animation speed multiplier. */
+    speed: number;
+    /** Size of the droplet pattern. Higher means smaller drops. */
+    scale: number;
+    /** Width of the droplets and their trails. */
+    dropWidth: number;
+    /** How elongated the falling droplets are. */
+    dropLength: number;
+    /** How strongly droplets refract the frame behind them. */
+    refraction: number;
+    /** How fast the running drops slide down. */
+    fallSpeed: number;
+    /** Fall direction in degrees: 0 falls down, ±90 sideways, ±180 up. */
+    direction: number;
+    /** Horizontal wiggle of the running drops. */
+    wiggle: number;
+    /** Multiplier for the small static droplets. */
+    staticDrops: number;
+    /** Specular glint on drops where the frame is transparent, so rain reads over the desktop (0 to 1). */
+    glints: number;
+}
+/**
+ * Post-processing over the rendered 3D frame. Everything off skips the effect
+ * chain entirely. Deliberately flat: every toggle-plus-numbers effect sits at
+ * the top level so tooling (defaults, healing, editors) can walk the effect
+ * registry generically. Grouping is a panel concern, not a data one.
+ */
 export interface SceneEffects {
     toneMapping: SceneToneMapping;
     /** Scene brightness multiplied in before the tone curve; 1 is neutral. Works in every mode, including `none`. */
@@ -333,7 +388,9 @@ export interface SceneEffects {
     grain: SceneFilmGrain;
     lut: SceneLut;
     dof: SceneDepthOfField;
-    stylize: SceneStylize;
+    pixelate: ScenePixelate;
+    glitch: SceneGlitch;
+    droplets: SceneDroplets;
 }
 /**
  * Image-based lighting for the 3D stage: an environment map, whether to show it

package/dist/types.js

@@ -1,6 +1,12 @@
 // The API's data model: the entity shapes that requests, responses, and events
 // carry. Structural mirrors of the app's scene/settings models, minus anything
 // filesystem-shaped — model refs are sanitized to ids, never directories.
+/**
+ * Per-light shadow tier. `off` is the old `castShadow: false`; the rest raise
+ * shadow-map resolution. A point light pays 6 cube faces for the same tier a
+ * directional light covers with one map, so it gets the smaller of the pair.
+ */
+export const SHADOW_QUALITY_LEVELS = ['off', 'low', 'medium', 'high', 'extra'];
 export const EFFECTS_QUALITY_LEVELS = ['low', 'medium', 'high'];
 /**
  * Accepted values for `performance.fpsLimit`; 0 = unlimited. Anything else is snapped

package/package.json

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