@laplace.live/persona-sdk 1.24.0 → 1.25.1

package/dist/wire/types.js

@@ -8,6 +8,8 @@ import { HAND_INPUT_NAMES, HAND_INPUT_RANGES } from "../values/hands.js";
 import { VOICE_INPUT_NAMES, VOICE_INPUT_RANGES } from "../values/lipsync.js";
 import { MOUSE_INPUT_NAMES, MOUSE_INPUT_RANGES } from "../values/mouse.js";
 import { TIME_INPUT_NAMES, TIME_INPUT_RANGES } from "../values/time.js";
+export const MODEL_FORMATS = ['live2d', 'vrm'];
+export const CONTENT_ORIGINS = ['bundled', 'user'];
 /**
  * How a registered file is labelled. Wider than an object's content kinds: `.hdr` is only
  * ever an environment map, and a `.vmd` splits by content — `cameraMotion` for one that
@@ -30,18 +32,22 @@ export function isAssetKind(v) {
 }
 // ---- Objects -------------------------------------------------------------------
 export const OBJECT_SPACES = ['2d', '3d'];
+export const CAPTURE_KINDS = ['display', 'window'];
 export const TEXT_ALIGNS = ['left', 'center', 'right', 'justify'];
 /** `baseline` is the first line's baseline — Blender's Top Base-Line. */
 export const TEXT_VERTICAL_ALIGNS = ['top', 'middle', 'baseline', 'bottom'];
 /** Blender's text-box overflow: spill past the box, shrink to fit it, or drop the lines that don't fit. */
 export const TEXT_OVERFLOWS = ['overflow', 'scale', 'truncate'];
 export const TEXT_STROKE_JOINS = ['round', 'miter', 'bevel'];
+// ---- Scene sections ------------------------------------------------------------
+export const BACKGROUND_MODES = ['transparent', 'color', 'image'];
 /**
  * How a following camera turns with its anchor — Warudo's Transposer binding modes. `world` follows
  * position only; `yaw`, `yaw-pitch` and `full` also turn with it (Lock To Target With World Up, No Roll,
  * and Lock To Target); `lazy` trails it, turning only as it passes (Simple Follow With World Up).
  */
 export const CAMERA_FOLLOW_BINDINGS = ['world', 'yaw', 'yaw-pitch', 'full', 'lazy'];
+export const CAMERA_PROJECTIONS = ['perspective', 'orthographic'];
 export const SCENE_LIGHT_TYPES = ['directional', 'point', 'ambient', 'area', 'spot'];
 /**
  * Per-light shadow tier. `off` is the old `castShadow: false`; the rest raise
@@ -50,10 +56,13 @@ export const SCENE_LIGHT_TYPES = ['directional', 'point', 'ambient', 'area', 'sp
  */
 export const SHADOW_QUALITY_LEVELS = ['off', 'low', 'medium', 'high', 'ultra'];
 export const SHADOW_FILTERS = ['pcf', 'pcss'];
+/** Display transform applied after the scene renders. `none` keeps colors exactly as authored. */
+export const SCENE_TONE_MAPPINGS = ['none', 'neutral', 'aces', 'agx'];
 // ---- Runtime state -------------------------------------------------------------
 /**
  * App-level features a client gates on (never version-sniff): `hello` and
  * `app.info` report them — the per-app mirror of {@link InstanceRuntime.capabilities}.
+ * Each name leads with what it extends (`light-spot`, `object-text`), as action kinds do.
  */
 export const APP_CAPABILITIES = [
     'storage',
@@ -64,14 +73,14 @@ export const APP_CAPABILITIES = [
     'asset-inspection',
     'layer-effects',
     'scene-transitions',
-    'area-lights',
-    'spot-lights',
-    'camera-follow-lights',
-    'shadow-filters',
+    'light-area',
+    'light-spot',
+    'light-camera-follow',
+    'light-shadow-filter',
     'environment-map-model',
-    'spawn',
+    'stage-spawn',
     /** `instance.setIdle` takes `trackingLostBehavior`, `trackingLostMotion` and `trackingLostDelay`. */
-    'tracking-lost',
+    'idle-tracking-lost',
     /** `motion.stop`; `motion.playing` and `motion.started` carry `oneShot`. */
     'motion-stop',
     /** `stage.capture`. */
@@ -84,7 +93,7 @@ export const APP_CAPABILITIES = [
      */
     'object-pin-depth',
     /** `text` object content and `fonts.list`. */
-    'text-objects',
+    'object-text',
     /** `SceneCamera.follow`. */
     'camera-follow',
     /** `SceneCamera.aim`. */
@@ -94,13 +103,63 @@ export const APP_CAPABILITIES = [
     /** `SceneCamera.handheld`. */
     'camera-handheld',
     /** `object.setContent` edits a video's `loop`, `muted` and `volume` in place; its sound follows the output device. */
-    'video-sound',
+    'object-video-sound',
     /** Image, video and webpage content takes `chromaKey`, which `object.setContent` edits in place. */
     'object-chroma-key',
+    /** `ModelMovementConfig.pivot`, which `model.setMovement` edits. */
+    'model-movement-pivot',
+    /** `instance.setEffects` takes objects in `2d` space too; older hosts answer `unsupported-for-format`. */
+    'layer-effects-2d',
 ];
 export function isAppCapability(v) {
     return isOneOf(v, APP_CAPABILITIES);
 }
+/**
+ * Old app capability names, each mapped to its category-first replacement. Hosts still list them for
+ * clients from before the rename; the SDK client folds them into the new names on receipt.
+ */
+export const LEGACY_APP_CAPABILITIES = new Map([
+    ['area-lights', 'light-area'],
+    ['spot-lights', 'light-spot'],
+    ['camera-follow-lights', 'light-camera-follow'],
+    ['shadow-filters', 'light-shadow-filter'],
+    ['spawn', 'stage-spawn'],
+    ['tracking-lost', 'idle-tracking-lost'],
+    ['text-objects', 'object-text'],
+    ['video-sound', 'object-video-sound'],
+]);
+/** The current name of an app capability; names that were never renamed, known or not, pass through. */
+export function canonicalAppCapability(name) {
+    return LEGACY_APP_CAPABILITIES.get(name) ?? name;
+}
+/** What a loaded model instance can do; absent capabilities answer `unsupported-for-format`. */
+export const INSTANCE_CAPABILITIES = [
+    'motions',
+    'expressions',
+    'placement-2d',
+    'placement-3d',
+    'mtoon',
+    'idle-clips',
+    /** `instance.setIdle` with `idleMotion`: one of the model's motions loops as its idle. Live2D only. */
+    'idle-motions',
+    'pose',
+    'live2d-params',
+    /** `instance.setBreath`; the idle breathing loop is Cubism's, so VRM lacks it. */
+    'breath',
+    /** `expression.setWeight`; Cubism expressions carry no user-settable weight, so Live2D lacks it. */
+    'expression-weights',
+    /**
+     * `speech.play` lip-sync. Loaded Live2D models only; 0.53 and earlier hosts also omit it under
+     * the Pixi engine, so gate on the runtime, not the format.
+     */
+    'speech',
+    /**
+     * Draws through the 3D post chain, so the scene's look rows (tone mapping, exposure, LUT)
+     * reach it. Every model; 0.53 and earlier hosts omit it on Pixi-engine Live2D, so read it off
+     * the runtime rather than the format.
+     */
+    'post-fx',
+];
 // ---- App automations --------------------------------------------------------------
 /** Action kinds an app automation can carry today; servers may send kinds newer than this list. */
 export const AUTOMATION_ACTION_KINDS = [
@@ -220,7 +279,7 @@ export function sourceChannelEnabled(source, channel, masters) {
 export function trackingPortTaken(sources, kind, port, excludeId) {
     return sources.some(s => s.id !== excludeId && s.port === port && !(s.kind === 'ifacialmocap' && kind === 'ifacialmocap'));
 }
-export const EFFECTS_QUALITY_LEVELS = ['low', 'medium', 'high'];
+export { EFFECTS_QUALITY_LEVELS } from "../values/effect-schema.js";
 /**
  * Accepted values for `performance.fpsLimit`; 0 = unlimited. Anything else is snapped
  * to the nearest preset by the app, so a picker offering other values would lie.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "1.24.0",
+  "version": "1.25.1",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",
@@ -28,7 +28,7 @@
   "devDependencies": {
     "rimraf": "^6.1.3",
     "typescript": "~6.0.3",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.3"
   },
   "engines": {
     "node": ">=24"

package/dist/client/legacy-kinds.d.ts

@@ -1,2 +0,0 @@
-/** A method result or event payload with the action kinds an older host still sends renamed to current ones. */
-export declare function renameLegacyKinds(name: string, data: unknown): unknown;