@laplace.live/persona-sdk 0.10.0 → 0.11.0

package/dist/values/effect-schema.d.ts

@@ -1,4 +1,4 @@
-import type { SceneEffects } from '../wire/types.ts';
+import type { SceneEffects, ToggleEffectKey } from '../wire/types.ts';
 /** Slider + healing metadata for one numeric effect parameter. */
 export interface EffectParamSpec {
     default: number;
@@ -14,12 +14,6 @@ export interface EffectParamSpec {
 export interface EffectColorSpec {
     default: string;
 }
-/** Keys of {@link SceneEffects} that follow the `{ enabled } + params` pattern. */
-export type ToggleEffectKey = {
-    [K in keyof SceneEffects]: SceneEffects[K] extends {
-        enabled: boolean;
-    } ? K : never;
-}[keyof SceneEffects];
 export declare const EFFECT_SPECS: Record<ToggleEffectKey, Readonly<Record<string, EffectParamSpec>>>;
 /**
  * Hex-color params, keyed like {@link EFFECT_SPECS} — generic walkers (healing,
@@ -36,5 +30,12 @@ export declare const TOGGLE_EFFECT_KEYS: readonly ToggleEffectKey[];
 export declare const SCENE_SPACE_EFFECT_KEYS: readonly ToggleEffectKey[];
 /** Registry effects the post chain composes — {@link TOGGLE_EFFECT_KEYS} minus the scene-space ones. */
 export declare const POST_EFFECT_KEYS: readonly ToggleEffectKey[];
+/** The canonical `effectLayers`: registry order, junk dropped, every switched-on effect included. */
+export declare function effectLayerKeys(listed: readonly unknown[], effects: Pick<SceneEffects, ToggleEffectKey>): ToggleEffectKey[];
+/**
+ * Composition order, bottom to top, with user-authored effects as one `'custom'` group.
+ * Display-only: the desktop chain's `rebuild()` is the order that runs — a stage moved there moves here too.
+ */
+export declare const EFFECT_STACK_ORDER: readonly (ToggleEffectKey | 'custom')[];
 /** Every registry effect at its defaults — the derived half of a fresh {@link SceneEffects}. */
 export declare function defaultToggleEffects(): Pick<SceneEffects, ToggleEffectKey>;

package/dist/values/effect-schema.js

@@ -177,6 +177,32 @@ export const TOGGLE_EFFECT_KEYS = Object.keys(EFFECT_SPECS);
 export const SCENE_SPACE_EFFECT_KEYS = ['rain', 'snow'];
 /** Registry effects the post chain composes — {@link TOGGLE_EFFECT_KEYS} minus the scene-space ones. */
 export const POST_EFFECT_KEYS = TOGGLE_EFFECT_KEYS.filter(key => !SCENE_SPACE_EFFECT_KEYS.includes(key));
+/** The canonical `effectLayers`: registry order, junk dropped, every switched-on effect included. */
+export function effectLayerKeys(listed, effects) {
+    return TOGGLE_EFFECT_KEYS.filter(key => listed.includes(key) || effects[key].enabled);
+}
+/**
+ * Composition order, bottom to top, with user-authored effects as one `'custom'` group.
+ * Display-only: the desktop chain's `rebuild()` is the order that runs — a stage moved there moves here too.
+ */
+export const EFFECT_STACK_ORDER = [
+    'rain',
+    'snow',
+    'dof',
+    'rim',
+    'outline',
+    'dropShadow',
+    'chromaticAberration',
+    'bloom',
+    'diffusion',
+    'color',
+    'pixelate',
+    'glitch',
+    'droplets',
+    'custom',
+    'grain',
+    'vignette',
+];
 /** Every registry effect at its defaults — the derived half of a fresh {@link SceneEffects}. */
 export function defaultToggleEffects() {
     const out = {};

package/dist/wire/types.d.ts

@@ -3,8 +3,11 @@ export type ModelFormat = 'live2d' | 'vrm';
 export type ContentOrigin = 'bundled' | 'user';
 /** How a registered file is labelled. Wider than an object's content kinds: `.hdr` is only ever an environment map. */
 export type AssetKind = 'image' | 'video' | 'prop' | 'ibl' | 'lut' | 'animation';
-/** Every content kind the Inventory can list. `pngtuber` is schema-ready before any producer exists. */
-export type InventoryKind = ModelFormat | 'pngtuber' | AssetKind;
+/**
+ * Every content kind the Inventory can list. `pngtuber` is schema-ready before any
+ * producer exists; `effect` rows are post-processing effects (built-in or installed), not files.
+ */
+export type InventoryKind = ModelFormat | 'pngtuber' | AssetKind | 'effect';
 /**
  * What every registry entry carries, model or asset alike. `kind` is always *what
  * the thing is* and `origin` always *where it came from* — the two were once
@@ -539,6 +542,12 @@ export interface SceneEffects {
     rain: SceneRain;
     snow: SceneSnow;
 }
+/** Keys of {@link SceneEffects} that follow the `{ enabled } + params` pattern. */
+export type ToggleEffectKey = {
+    [K in keyof SceneEffects]: SceneEffects[K] extends {
+        enabled: boolean;
+    } ? K : never;
+}[keyof SceneEffects];
 /**
  * One user-authored effect's placement in a scene. Deliberately a sibling of
  * {@link SceneEffects} rather than a key inside it: `ToggleEffectKey` is derived
@@ -568,6 +577,11 @@ export interface SceneEnvironment {
     showSkybox: boolean;
     fog: SceneFog;
     effects: SceneEffects;
+    /**
+     * Built-in effects added as layers, in registry order — one keeps its row and tuning while
+     * switched off. Healing lists every switched-on effect, so a patch that switches one on adds its layer.
+     */
+    effectLayers: ToggleEffectKey[];
     /**
      * User-authored effects, in the order they compose. They run as a group at one
      * fixed point in the post chain — after grading and the screen-space warps,

package/package.json

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