@laplace.live/persona-sdk 0.15.0 → 0.17.0

package/dist/values/limits.d.ts

@@ -37,6 +37,9 @@ export declare function sceneLightShadowRadiusMax(type: SceneLightType): number;
 export declare const SCENE_FOG_DENSITY_MAX = 0.5;
 /** ×4 is +2 stops — enough to rescue an AgX-dimmed avatar without turning the slider to mush. */
 export declare const SCENE_EXPOSURE_MAX = 4;
+/** Vertical field of view in degrees; the band either side of a portrait lens, before the framing distorts. */
+export declare const SCENE_FOV_MIN = 10;
+export declare const SCENE_FOV_MAX = 90;
 export declare const MTOON_NORMAL_SCALE_MAX = 2;
 export declare const MTOON_RIM_MAX = 2;
 /** ×0 flattens the Fresnel to a flood fill, ×4 tightens a default power-5 rim to a hairline. */

package/dist/values/limits.js

@@ -52,6 +52,9 @@ export function sceneLightShadowRadiusMax(type) {
 export const SCENE_FOG_DENSITY_MAX = 0.5;
 /** ×4 is +2 stops — enough to rescue an AgX-dimmed avatar without turning the slider to mush. */
 export const SCENE_EXPOSURE_MAX = 4;
+/** Vertical field of view in degrees; the band either side of a portrait lens, before the framing distorts. */
+export const SCENE_FOV_MIN = 10;
+export const SCENE_FOV_MAX = 90;
 export const MTOON_NORMAL_SCALE_MAX = 2;
 export const MTOON_RIM_MAX = 2;
 /** ×0 flattens the Fresnel to a flood fill, ×4 tightens a default power-5 rim to a hairline. */

package/dist/wire/schemas.d.ts

@@ -127,6 +127,8 @@ export declare const requestSchemas: {
             prop: "prop";
             ibl: "ibl";
             lut: "lut";
+            animation: "animation";
+            cameraMotion: "cameraMotion";
         }>>;
     }, z.core.$strip>;
     'settings.patch': z.ZodObject<{

package/dist/wire/schemas.js

@@ -1,6 +1,7 @@
 import * as z from 'zod';
 import { isRecord } from "../values/guards.js";
 import { SPEECH_URL_MAX_LENGTH, STORAGE_KEY_MAX_LENGTH, STORAGE_VALUE_MAX_LENGTH } from "../values/limits.js";
+import { ASSET_KINDS } from "./types.js";
 // Runtime validation for the request side of the wire. Schemas exist for the
 // methods whose params the app's main process consumes directly; methods without
 // one are stage-owned — the renderer validates and heals them (same rules as the
@@ -91,7 +92,9 @@ export const requestSchemas = {
     }),
     'tracking.removeSource': z.object({ id: nonEmpty }),
     'model.register': z.object({ path: nonEmpty }),
-    'asset.register': z.object({ path: nonEmpty, want: z.enum(['image', 'video', 'prop', 'ibl', 'lut']).optional() }),
+    // Straight off ASSET_KINDS: a kind added there has to reach the wire gate too, or
+    // `want` answers invalid-params for a kind the registry already knows how to take.
+    'asset.register': z.object({ path: nonEmpty, want: z.enum(ASSET_KINDS).optional() }),
     'settings.patch': z.object({ settings: SettingsPatchSchema }),
     'tracking.setEnabled': z.object({ enabled: z.boolean() }),
     'tracking.setSource': z.object({ source: z.enum(['vts-ios', 'vts-ios-native', 'ifacialmocap']) }),

package/dist/wire/types.d.ts

@@ -1,8 +1,12 @@
 export type ModelFormat = 'live2d' | 'vrm';
 /** Where an item came from: shipped with the app, or added by the user. */
 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 declare const ASSET_KINDS: readonly ["image", "video", "prop", "ibl", "lut", "animation"];
+/**
+ * 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
+ * frames a shot, `animation` for one that drives a rig.
+ */
+export declare const ASSET_KINDS: readonly ["image", "video", "prop", "ibl", "lut", "animation", "cameraMotion"];
 export type AssetKind = (typeof ASSET_KINDS)[number];
 /** Narrow a kind string to the set the asset registry owns — models and effects have their own. */
 export declare function isAssetKind(v: unknown): v is AssetKind;
@@ -266,6 +270,11 @@ export interface OrbitTransform {
 export interface SceneCamera {
     orbit: OrbitTransform | null;
     fov: number;
+    /**
+     * A `cameraMotion` asset driving the camera, or null for the user's own orbit. While one
+     * is set it overrides `orbit` and `fov` every frame; neither field is written back.
+     */
+    clipAssetId: string | null;
 }
 export type SceneLightType = 'directional' | 'point' | 'ambient';
 /**
@@ -848,6 +857,7 @@ export type EffectsQuality = (typeof EFFECTS_QUALITY_LEVELS)[number];
 export declare const FPS_LIMIT_PRESETS: readonly [0, 15, 30, 60, 90];
 /** The curated settings surface the API exposes — never the raw store shape. */
 export interface Settings {
+    /** `alwaysOnTop` floats the control-panel window, never the stage. */
     window: {
         alwaysOnTop: boolean;
     };
@@ -887,8 +897,8 @@ export interface SettingsPatch {
         effectsQuality?: EffectsQuality;
     };
 }
-/** VTS's input vocabulary — the valid `id`s for `input` inject targets (and the names a model's `.vtube.json` references). */
-export declare const INPUT_NAMES: readonly ["FaceAngleX", "FaceAngleY", "FaceAngleZ", "FacePositionX", "FacePositionY", "FacePositionZ", "EyeOpenLeft", "EyeOpenRight", "EyeLeftX", "EyeLeftY", "EyeRightX", "EyeRightY", "Brows", "BrowLeftY", "BrowRightY", "MouthSmile", "MouthOpen", "MouthX", "CheekPuff", "JawOpen", "TongueOut", "MouthPucker", "MouthFunnel", "MouthShrug", "MouthPress"];
+/** VTS's input vocabulary plus the VBridger-standard extras — the valid `id`s for `input` inject targets (and the names a model's `.vtube.json` references). */
+export declare const INPUT_NAMES: readonly ["FaceAngleX", "FaceAngleY", "FaceAngleZ", "FacePositionX", "FacePositionY", "FacePositionZ", "EyeOpenLeft", "EyeOpenRight", "EyeLeftX", "EyeLeftY", "EyeRightX", "EyeRightY", "Brows", "BrowLeftY", "BrowRightY", "MouthSmile", "MouthOpen", "MouthX", "CheekPuff", "JawOpen", "JawX", "TongueOut", "MouthPucker", "MouthFunnel", "MouthShrug", "MouthPress", "MouthPressLipOpen"];
 export type InputName = (typeof INPUT_NAMES)[number];
 /**
  * What an injected value drives:

package/dist/wire/types.js

@@ -1,8 +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.
-/** How a registered file is labelled. Wider than an object's content kinds: `.hdr` is only ever an environment map. */
-export const ASSET_KINDS = ['image', 'video', 'prop', 'ibl', 'lut', 'animation'];
+/**
+ * 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
+ * frames a shot, `animation` for one that drives a rig.
+ */
+export const ASSET_KINDS = ['image', 'video', 'prop', 'ibl', 'lut', 'animation', 'cameraMotion'];
 /** Narrow a kind string to the set the asset registry owns — models and effects have their own. */
 export function isAssetKind(v) {
     return typeof v === 'string' && ASSET_KINDS.includes(v);
@@ -42,7 +46,7 @@ export const EFFECTS_QUALITY_LEVELS = ['low', 'medium', 'high'];
  */
 export const FPS_LIMIT_PRESETS = [0, 15, 30, 60, 90];
 // ---- Injection -----------------------------------------------------------------
-/** VTS's input vocabulary — the valid `id`s for `input` inject targets (and the names a model's `.vtube.json` references). */
+/** VTS's input vocabulary plus the VBridger-standard extras — the valid `id`s for `input` inject targets (and the names a model's `.vtube.json` references). */
 export const INPUT_NAMES = [
     'FaceAngleX',
     'FaceAngleY',
@@ -64,9 +68,11 @@ export const INPUT_NAMES = [
     'MouthX',
     'CheekPuff',
     'JawOpen',
+    'JawX',
     'TongueOut',
     'MouthPucker',
     'MouthFunnel',
     'MouthShrug',
     'MouthPress',
+    'MouthPressLipOpen',
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "TypeScript SDK and wire schema for the LAPLACE Persona plugin API",
   "license": "MIT",
   "type": "module",
@@ -48,7 +48,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "zod": "^4.4.3"
+    "zod": "^4.5.2"
   },
   "scripts": {
     "build": "rimraf dist && tsc -p tsconfig.build.json",