@laplace.live/persona-sdk 1.20.0 → 1.22.0

package/dist/wire/types.d.ts

@@ -8,6 +8,7 @@ import { type BaseControllerInputName, type ControllerInputName, type Controller
 import { type HandInputName } from '../values/hands.ts';
 import { type LipSyncMode, type VoiceInputName } from '../values/lipsync.ts';
 import { type MouseInputName } from '../values/mouse.ts';
+import { type TimeInputName } from '../values/time.ts';
 export type ModelFormat = 'live2d' | 'vrm';
 /** Where an item came from: shipped with the app, or added by the user. */
 export type ContentOrigin = 'bundled' | 'user';
@@ -16,7 +17,7 @@ export type ContentOrigin = 'bundled' | 'user';
  * 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", "audio", "prop", "ibl", "lut", "animation", "cameraMotion"];
+export declare const ASSET_KINDS: readonly ["image", "video", "audio", "prop", "ibl", "lut", "animation", "cameraMotion", "lyrics"];
 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;
@@ -47,6 +48,13 @@ export interface ContentRef {
 /** A model as the registry lists it. */
 export interface ModelRef extends ContentRef {
     kind: ModelFormat;
+    /** Entry file basename (`.model3.json`, `.vrm`), with no directory. Absent on older hosts. */
+    entryFile?: string;
+    /**
+     * `.vtube.json` basename, the name a VTS model-load hotkey stores (see `modelMatchesFile`); null
+     * without one. Only `model.list` fills it: absent on scene item refs, `model.register`'s answer, and older hosts.
+     */
+    vtubeFile?: string | null;
 }
 /** A registered object-source file. `exists` is false once the file is gone from disk. */
 export interface AssetRef extends ContentRef {
@@ -80,7 +88,7 @@ export interface CatalogItem extends Omit<ContentRef, 'origin'> {
     /** Creator or content homepage (https). */
     url?: string;
 }
-/** Screen-space placement: pixels from the stage centre, rotation in radians. */
+/** Screen-space placement: calibrated stage units from the viewport centre, rotation in radians. */
 export interface ScreenPlacement {
     x: number;
     y: number;
@@ -207,9 +215,30 @@ export interface SceneModelItem {
 }
 export declare const OBJECT_SPACES: readonly ["2d", "3d"];
 export type ObjectSpace = (typeof OBJECT_SPACES)[number];
-/** Where a webpage overlay renders relative to the stage. */
-export type WebLayer = 'behind' | 'front';
 export type CaptureKind = 'display' | 'window';
+export declare const TEXT_ALIGNS: readonly ["left", "center", "right", "justify"];
+export type TextAlign = (typeof TEXT_ALIGNS)[number];
+/** `baseline` is the first line's baseline — Blender's Top Base-Line. */
+export declare const TEXT_VERTICAL_ALIGNS: readonly ["top", "middle", "baseline", "bottom"];
+export type TextVerticalAlign = (typeof TEXT_VERTICAL_ALIGNS)[number];
+/** Blender's text-box overflow: spill past the box, shrink to fit it, or drop the lines that don't fit. */
+export declare const TEXT_OVERFLOWS: readonly ["overflow", "scale", "truncate"];
+export type TextOverflow = (typeof TEXT_OVERFLOWS)[number];
+export declare const TEXT_STROKE_JOINS: readonly ["round", "miter", "bevel"];
+export type TextStrokeJoin = (typeof TEXT_STROKE_JOINS)[number];
+/**
+ * A system font face, named exactly: its PostScript name is the identity, since a family's
+ * nearest weight is not the face the user picked. The rest lets a machine without that face
+ * fall back to the closest one in the same family.
+ */
+export interface TextFont {
+    postscriptName: string;
+    family: string;
+    weight: number;
+    italic: boolean;
+    /** CSS `font-stretch` percent; 100 is normal. */
+    stretch: number;
+}
 /** What an object renders. Mirrors VTube Studio's items and Warudo's screen/prop assets. */
 export type ObjectContent = {
     kind: 'image';
@@ -220,6 +249,8 @@ export type ObjectContent = {
     loop: boolean;
     muted: boolean;
     volume: number;
+    /** Held rather than played while shown, through a restart too; the playback position is not saved. */
+    paused: boolean;
 } | {
     kind: 'prop';
     assetId: string;
@@ -236,8 +267,6 @@ export type ObjectContent = {
     transparent: boolean;
     /** Stylesheet injected into every page the object loads; empty for none. */
     css: string;
-    /** 2D only: composited behind or in front of the whole stage, not interleaved with other layers. */
-    layer: WebLayer;
     /** Close the page while the object is hidden and reload it on show, as an OBS browser source can. */
     shutdownWhenHidden: boolean;
 } | {
@@ -245,11 +274,95 @@ export type ObjectContent = {
     source: CaptureKind;
     sourceId: string;
     label: string;
+} | {
+    kind: 'text';
+    text: string;
+    /** null draws in the platform's default sans-serif. */
+    font: TextFont | null;
+    /** Em size, px; 3D reads px at the image quads' 1000 px per metre. */
+    size: number;
+    color: string;
+    /** Blender's shear: the slant as a fraction of height, -1..1. */
+    shear: number;
+    /** Em fractions added between characters and to each space. */
+    letterSpacing: number;
+    wordSpacing: number;
+    /** Line box as a multiple of `size`. */
+    lineHeight: number;
+    align: TextAlign;
+    verticalAlign: TextVerticalAlign;
+    /** Text box, px; 0 sizes that side to the text, and a set width wraps. */
+    boxWidth: number;
+    boxHeight: number;
+    overflow: TextOverflow;
+    /** Outside the glyphs, px; width 0 draws none. */
+    stroke: {
+        width: number;
+        color: string;
+        join: TextStrokeJoin;
+    };
+    /** px; opacity 0 draws none. */
+    shadow: {
+        color: string;
+        opacity: number;
+        offsetX: number;
+        offsetY: number;
+        blur: number;
+    };
+    /** A backing box around the text, px; opacity 0 draws none. */
+    plate: {
+        color: string;
+        opacity: number;
+        padding: number;
+        radius: number;
+    };
+    /** Karaoke: a lyrics clip paints what is sung in `color`, outlined in `strokeColor` (2D only). */
+    sung: {
+        color: string;
+        strokeColor: string;
+    };
+    /** 3D: extrusion depth and bevel as fractions of `size`; bevel segments. */
+    extrude: number;
+    bevel: number;
+    bevelResolution: number;
+    /** 3D surface: PBR roughness and metalness 0..1, and how strongly the text glows in its own colour. */
+    roughness: number;
+    metalness: number;
+    emission: number;
+    /** 3D: turn the text to face the camera every frame, ignoring the placement's rotation. */
+    faceCamera: boolean;
 };
+/** The video variant of {@link ObjectContent}. */
+export type VideoContent = Extract<ObjectContent, {
+    kind: 'video';
+}>;
 /** The webpage variant of {@link ObjectContent}. */
 export type WebContent = Extract<ObjectContent, {
     kind: 'web';
 }>;
+/** The text variant of {@link ObjectContent}. */
+export type TextContent = Extract<ObjectContent, {
+    kind: 'text';
+}>;
+/** One face of a {@link FontFamilyInfo}. */
+export interface FontFaceInfo {
+    postscriptName: string;
+    /** The subfamily as the font names it: `Semibold`, `W6`, `Bold Italic`. */
+    style: string;
+    weight: number;
+    italic: boolean;
+    /** CSS `font-stretch` percent. */
+    stretch: number;
+    /** A variable font's named instance. */
+    variable: boolean;
+}
+/** An installed font family and its faces. File paths never cross the wire. */
+export interface FontFamilyInfo {
+    family: string;
+    /** Every name the family goes by, localized ones included, canonical first. */
+    names: string[];
+    faces: FontFaceInfo[];
+}
 /** Where on a parent model an object rides. `root` is the model's own transform. */
 export type AttachAnchor = {
     kind: 'root';
@@ -368,6 +481,108 @@ export interface OrbitTransform {
     targetY: number;
     targetZ: number;
 }
+/**
+ * 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 declare const CAMERA_FOLLOW_BINDINGS: readonly ["world", "yaw", "yaw-pitch", "full", "lazy"];
+export type CameraFollowBinding = (typeof CAMERA_FOLLOW_BINDINGS)[number];
+/** Seconds a following camera takes to settle, 0 locking it: position along the view's own axes, then each turn. */
+export interface CameraFollowDamping {
+    x: number;
+    y: number;
+    z: number;
+    yaw: number;
+    pitch: number;
+    roll: number;
+}
+/** The point a camera follows or aims at on a model: a humanoid bone, or its root. An object is tracked by its own origin. */
+export type CameraAnchor = Extract<AttachAnchor, {
+    kind: 'root' | 'bone';
+}>;
+/**
+ * The layer a scene camera follows, aims at or focuses on: a VRM model or 3D object by id, or whichever model
+ * is primary as the scene changes. An id naming anything else heals to no tracking; a primary model that
+ * cannot be tracked holds the view.
+ */
+export type CameraTrackTarget = {
+    target: 'primary';
+    instanceId?: never;
+} | {
+    target?: never;
+    instanceId: string;
+};
+/** How a following camera tracks its layer, whichever layer that is. */
+export interface SceneCameraFollowSettings {
+    /** Always the root on an object. */
+    anchor: CameraAnchor;
+    binding: CameraFollowBinding;
+    damping: CameraFollowDamping;
+}
+/**
+ * A scene camera following a layer. While set, `orbit` frames the layer as if its anchor rested at the stage
+ * origin, and the view moves with the anchor — placement, motion and tracking alike — without writing
+ * `orbit` back.
+ */
+export type SceneCameraFollow = CameraTrackTarget & SceneCameraFollowSettings;
+/**
+ * A scene camera turning to keep a layer at a spot on screen — Warudo's Composer. Screen values are
+ * fractions of the view: x from the left, y from the top.
+ */
+export interface SceneCameraAimSettings {
+    /** Always the root on an object. */
+    anchor: CameraAnchor;
+    /** Where the anchor sits on screen, 0–1; 0.5 centres it. */
+    screenX: number;
+    screenY: number;
+    /** The camera holds still while the anchor stays inside this zone around its spot. */
+    deadZone: {
+        width: number;
+        height: number;
+    };
+    /** Past the dead zone the camera turns gradually; past this zone, at once. Never narrower than the dead zone. */
+    softZone: {
+        width: number;
+        height: number;
+    };
+    /** Shifts the soft zone off the spot, −0.5–0.5 of the slack between the zones. */
+    bias: {
+        x: number;
+        y: number;
+    };
+    /** Seconds to turn the anchor back into the dead zone, 0 turning at once. */
+    damping: {
+        horizontal: number;
+        vertical: number;
+    };
+    /**
+     * Aims `time` seconds (0–1, 0 off) ahead of a moving anchor, its velocity smoothed over `smoothing` (0–30);
+     * `ignoreY` leaves vertical motion out.
+     */
+    lookahead: {
+        time: number;
+        smoothing: number;
+        ignoreY: boolean;
+    };
+}
+export type SceneCameraAim = CameraTrackTarget & SceneCameraAimSettings;
+/** A scene camera keeping a layer sharp under Depth of Field — Warudo's Focus Character. */
+export interface SceneCameraFocusSettings {
+    /** Always the root on an object. */
+    anchor: CameraAnchor;
+    /** Seconds for the focus plane to catch up with the anchor, 0 at once. */
+    damping: number;
+}
+export type SceneCameraFocus = CameraTrackTarget & SceneCameraFocusSettings;
+/** Noise-driven sway over the scene camera's own framing — Warudo's Handheld Movement. */
+export interface SceneCameraHandheld {
+    enabled: boolean;
+    /** 0–1; the default 0.5 is a mild handheld. */
+    intensity: number;
+    /** 0–2; 1 sways at the authored pace. */
+    speed: number;
+}
 /** Scene-level VRM camera. `orbit: null` = never framed — the first VRM load frames it from model height. */
 export interface SceneCamera {
     orbit: OrbitTransform | null;
@@ -382,6 +597,14 @@ export interface SceneCamera {
      * is set it overrides the framing every frame without writing it back.
      */
     clipAssetId: string | null;
+    /** The layer the view follows, or null. A camera motion overrides it. Absent on older hosts; gate on `camera-follow`. */
+    follow?: SceneCameraFollow | null;
+    /** The layer the view turns to keep on screen, or null. A camera motion overrides it. Absent on older hosts; gate on `camera-aim`. */
+    aim?: SceneCameraAim | null;
+    /** The layer Depth of Field keeps sharp, or null for the look-at point. Absent on older hosts; gate on `camera-focus`. */
+    focus?: SceneCameraFocus | null;
+    /** Handheld sway; a camera motion overrides it. Absent on older hosts; gate on `camera-handheld`. */
+    handheld?: SceneCameraHandheld;
 }
 /**
  * The slice of {@link SceneCamera} a saved pose snapshots and applies — a framing, never
@@ -661,6 +884,28 @@ export interface EffectBlur {
     mode: 'gaussian' | 'bokeh';
     highQuality: boolean;
 }
+/**
+ * Pencil sketch on paper (Jaume Sanchez's NPR sketch shader): graphite grain shades the darker
+ * tones and pencil lines trace color and coverage edges, over a procedural paper grain.
+ */
+export interface EffectSketch {
+    enabled: boolean;
+    /** Paper tint (hex) under the drawing. */
+    paperColor: string;
+    /** Scene only: paper also fills transparent pixels. Layers always keep their coverage. */
+    paperBackground: boolean;
+    /** Pencil-line darkness, 0–2. */
+    lines: number;
+    /** Pencil-line width in CSS pixels, 0.5–4, so it holds across display densities. */
+    lineWidth: number;
+    /** Graphite grain in the darker tones, 0–2: 0 leaves only the lines, 1 is the source's density. */
+    shading: number;
+    /** How strongly a wide blur of the surrounding tones lightens the shading, 0–1. */
+    softness: number;
+    /** 0 draws in graphite, 1 keeps the image's colors at the same lightness. */
+    saturation: number;
+    opacity: number;
+}
 /** Lens fringing that grows toward frame edges (Unity PPv2's curve, the one VTube Studio wraps). */
 export interface SceneChromaticAberration {
     enabled: boolean;
@@ -877,6 +1122,7 @@ export interface EffectValues {
     gradient: EffectGradient;
     flare: SceneFlare;
     blur: EffectBlur;
+    sketch: EffectSketch;
     chromaticAberration: SceneChromaticAberration;
     grain: SceneFilmGrain;
     dof: SceneDepthOfField;
@@ -1041,7 +1287,7 @@ export interface ScenePatch {
  * App-level features a client gates on (never version-sniff): `hello` and
  * `app.info` report them — the per-app mirror of {@link InstanceRuntime.capabilities}.
  */
-export declare const APP_CAPABILITIES: readonly ["storage", "speech", "automations", "controllers", "model-editing", "asset-inspection", "layer-effects", "scene-transitions", "area-lights", "spot-lights", "camera-follow-lights", "shadow-filters", "environment-map-model", "spawn", "tracking-lost", "motion-stop", "stage-capture", "model-movement"];
+export declare const APP_CAPABILITIES: readonly ["storage", "speech", "automations", "controllers", "model-editing", "asset-inspection", "layer-effects", "scene-transitions", "area-lights", "spot-lights", "camera-follow-lights", "shadow-filters", "environment-map-model", "spawn", "tracking-lost", "motion-stop", "stage-capture", "model-movement", "object-pin-depth", "text-objects", "camera-follow", "camera-aim", "camera-focus", "camera-handheld", "video-sound"];
 export type AppCapability = (typeof APP_CAPABILITIES)[number];
 export declare function isAppCapability(v: unknown): v is AppCapability;
 /** What a loaded model instance can do; absent capabilities answer `unsupported-for-format`. */
@@ -1110,7 +1356,7 @@ export interface Hotkey {
     name: string;
     /** The VTS `Action` string verbatim; `action` is null when Persona cannot run it. */
     vtsAction: string;
-    action: 'toggle-expression' | 'play-motion' | 'remove-all-expressions' | 'load-model' | null;
+    action: 'expression-toggle' | 'motion-play' | 'expression-clear' | 'model-load' | null;
     file: string;
     accelerator: string | null;
     global: boolean;
@@ -1133,11 +1379,22 @@ export interface HotkeyState extends HotkeyConfig {
     registered: string[];
 }
 /** Action kinds an app automation can carry today; servers may send kinds newer than this list. */
-export declare const AUTOMATION_ACTION_KINDS: readonly ["effect-toggle", "effect-params", "effect-clip", "camera-pose", "reset-camera", "play-camera-motion", "stop-camera-motion", "layer-visibility", "stream-mode", "switch-scene", "toggle-expression", "play-motion", "play-audio", "audio-control", "remove-all-expressions", "load-model", "model-position"];
+export declare const AUTOMATION_ACTION_KINDS: readonly ["effect-toggle", "effect-params", "effect-clip", "camera-pose", "camera-reset", "camera-motion-play", "camera-motion-stop", "camera-follow", "camera-aim", "camera-focus", "camera-handheld", "layer-visibility", "text-set", "lyrics-play", "stream-mode", "scene-switch", "expression-toggle", "motion-play", "audio-play", "audio-control", "expression-clear", "model-load", "model-position"];
 export type AutomationActionKind = (typeof AUTOMATION_ACTION_KINDS)[number];
+/**
+ * Deprecated action kind names, each mapped to its category-first replacement. Older hosts send them in
+ * `actionKinds` and `Hotkey.action`, and older files store them; the client renames them on receipt.
+ */
+export declare const LEGACY_AUTOMATION_ACTION_KINDS: ReadonlyMap<string, AutomationActionKind>;
+/** The current name of an action kind; kinds that were never renamed, known or not, pass through. */
+export declare function canonicalActionKind(kind: string): string;
 /** Setup kinds that finish loading before the sequence clock starts. */
-export declare const AUTOMATION_BOUNDARY_KINDS: readonly ["switch-scene", "load-model"];
-export type AutomationBoundaryKind = (typeof AUTOMATION_BOUNDARY_KINDS)[number];
+export declare const AUTOMATION_SETUP_KINDS: readonly ["scene-switch", "model-load"];
+export type AutomationSetupKind = (typeof AUTOMATION_SETUP_KINDS)[number];
+/** @deprecated Use `AUTOMATION_SETUP_KINDS`. */
+export declare const AUTOMATION_BOUNDARY_KINDS: readonly ["scene-switch", "model-load"];
+/** @deprecated Use `AutomationSetupKind`. */
+export type AutomationBoundaryKind = AutomationSetupKind;
 /**
  * One app automation as clients see it. Action kinds and scene targets drive derived
  * labels; other action payloads stay app-side.
@@ -1302,12 +1559,12 @@ declare const VTS_INPUT_RANGES: {
 };
 type VtsInputName = keyof typeof VTS_INPUT_RANGES;
 /**
- * Default input vocabulary: face, hand and cursor inputs, raw ARKit channels and controller
+ * Default input vocabulary: face, hand, cursor and time inputs, raw ARKit channels and controller
  * profile 1. Additional controller profile ids are accepted by isInputName without appearing
  * in this list.
  */
-export declare const INPUT_NAMES: readonly (VtsInputName | HandInputName | VoiceInputName | MouseInputName | ArkitInputName | BaseControllerInputName)[];
-export type InputName = VtsInputName | HandInputName | VoiceInputName | MouseInputName | ArkitInputName | ControllerInputName;
+export declare const INPUT_NAMES: readonly (VtsInputName | HandInputName | VoiceInputName | MouseInputName | TimeInputName | ArkitInputName | BaseControllerInputName)[];
+export type InputName = VtsInputName | HandInputName | VoiceInputName | MouseInputName | TimeInputName | ArkitInputName | ControllerInputName;
 /** Whether an untrusted string names a tracking input — the guard every wire boundary needs. */
 export declare function isInputName(v: string): v is InputName;
 /**
@@ -1335,7 +1592,7 @@ export declare function arkitTwinOf(input: InputName): BindingInput;
  * Default inputs' natural spans. Use getInputRange for a dynamically numbered controller input.
  * Head angles are degrees; the rest are unitless.
  */
-export declare const INPUT_RANGES: Record<VtsInputName | HandInputName | VoiceInputName | MouseInputName | ArkitInputName | BaseControllerInputName, readonly [number, number]>;
+export declare const INPUT_RANGES: Record<VtsInputName | HandInputName | VoiceInputName | MouseInputName | TimeInputName | ArkitInputName | BaseControllerInputName, readonly [number, number]>;
 /** Natural span of any valid input, including dynamically numbered controller profiles. */
 export declare function getInputRange(name: InputName): readonly [number, number];
 /**

package/dist/wire/types.js

@@ -7,18 +7,41 @@ import { isOneOf, keysOf } from "../values/guards.js";
 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";
 /**
  * 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', 'audio', 'prop', 'ibl', 'lut', 'animation', 'cameraMotion'];
+export const ASSET_KINDS = [
+    'image',
+    'video',
+    'audio',
+    'prop',
+    'ibl',
+    'lut',
+    'animation',
+    'cameraMotion',
+    'lyrics',
+];
 /** Narrow a kind string to the set the asset registry owns — models and effects have their own. */
 export function isAssetKind(v) {
     return isOneOf(v, ASSET_KINDS);
 }
 // ---- Objects -------------------------------------------------------------------
 export const OBJECT_SPACES = ['2d', '3d'];
+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'];
+/**
+ * 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 SCENE_LIGHT_TYPES = ['directional', 'point', 'ambient', 'area', 'spot'];
 /**
  * Per-light shadow tier. `off` is the old `castShadow: false`; the rest raise
@@ -55,6 +78,23 @@ export const APP_CAPABILITIES = [
     'stage-capture',
     /** `model.getMovement` / `model.setMovement` and the `model.movement` event. */
     'model-movement',
+    /**
+     * 2D images, videos and webpages all paint in the stage's layer stack (a webpage has no `layer`), and
+     * one pinned to a Live2D model takes `attach.depth` in that model's stack, as a Live2D item does.
+     */
+    'object-pin-depth',
+    /** `text` object content and `fonts.list`. */
+    'text-objects',
+    /** `SceneCamera.follow`. */
+    'camera-follow',
+    /** `SceneCamera.aim`. */
+    'camera-aim',
+    /** `SceneCamera.focus`. */
+    'camera-focus',
+    /** `SceneCamera.handheld`. */
+    'camera-handheld',
+    /** `object.setContent` edits a video's `loop`, `muted` and `volume` in place; its sound follows the output device. */
+    'video-sound',
 ];
 export function isAppCapability(v) {
     return isOneOf(v, APP_CAPABILITIES);
@@ -66,25 +106,51 @@ export const AUTOMATION_ACTION_KINDS = [
     'effect-params',
     'effect-clip',
     'camera-pose',
-    'reset-camera',
-    'play-camera-motion',
-    'stop-camera-motion',
+    'camera-reset',
+    'camera-motion-play',
+    'camera-motion-stop',
+    'camera-follow',
+    'camera-aim',
+    'camera-focus',
+    'camera-handheld',
     'layer-visibility',
+    'text-set',
+    'lyrics-play',
     'stream-mode',
-    'switch-scene',
-    'toggle-expression',
-    'play-motion',
-    'play-audio',
+    'scene-switch',
+    'expression-toggle',
+    'motion-play',
+    'audio-play',
     'audio-control',
-    'remove-all-expressions',
-    'load-model',
+    'expression-clear',
+    'model-load',
     'model-position',
 ];
+/**
+ * Deprecated action kind names, each mapped to its category-first replacement. Older hosts send them in
+ * `actionKinds` and `Hotkey.action`, and older files store them; the client renames them on receipt.
+ */
+export const LEGACY_AUTOMATION_ACTION_KINDS = new Map([
+    ['reset-camera', 'camera-reset'],
+    ['play-camera-motion', 'camera-motion-play'],
+    ['stop-camera-motion', 'camera-motion-stop'],
+    ['set-text', 'text-set'],
+    ['lyrics', 'lyrics-play'],
+    ['switch-scene', 'scene-switch'],
+    ['toggle-expression', 'expression-toggle'],
+    ['play-motion', 'motion-play'],
+    ['play-audio', 'audio-play'],
+    ['remove-all-expressions', 'expression-clear'],
+    ['load-model', 'model-load'],
+]);
+/** The current name of an action kind; kinds that were never renamed, known or not, pass through. */
+export function canonicalActionKind(kind) {
+    return LEGACY_AUTOMATION_ACTION_KINDS.get(kind) ?? kind;
+}
 /** Setup kinds that finish loading before the sequence clock starts. */
-export const AUTOMATION_BOUNDARY_KINDS = [
-    'switch-scene',
-    'load-model',
-];
+export const AUTOMATION_SETUP_KINDS = ['scene-switch', 'model-load'];
+/** @deprecated Use `AUTOMATION_SETUP_KINDS`. */
+export const AUTOMATION_BOUNDARY_KINDS = AUTOMATION_SETUP_KINDS;
 // ---- Settings ------------------------------------------------------------------
 export const TRACKING_SOURCE_IDS = ['persona-ios', 'ifacialmocap', 'vts-ios'];
 /** Body-pose protocols. Every one so far is UDP with a configurable port. */
@@ -195,7 +261,7 @@ const VTS_INPUT_RANGES = {
 /** VTS's input vocabulary, plus `JawOpen` — the derived half of {@link INPUT_NAMES}. */
 const VTS_INPUT_NAMES = keysOf(VTS_INPUT_RANGES);
 /**
- * Default input vocabulary: face, hand and cursor inputs, raw ARKit channels and controller
+ * Default input vocabulary: face, hand, cursor and time inputs, raw ARKit channels and controller
  * profile 1. Additional controller profile ids are accepted by isInputName without appearing
  * in this list.
  */
@@ -204,6 +270,7 @@ export const INPUT_NAMES = [
     ...VOICE_INPUT_NAMES,
     ...HAND_INPUT_NAMES,
     ...MOUSE_INPUT_NAMES,
+    ...TIME_INPUT_NAMES,
     ...ARKIT_INPUT_NAMES,
     ...BASE_CONTROLLER_INPUT_NAMES,
 ];
@@ -244,6 +311,7 @@ export const INPUT_RANGES = {
     ...VOICE_INPUT_RANGES,
     ...HAND_INPUT_RANGES,
     ...MOUSE_INPUT_RANGES,
+    ...TIME_INPUT_RANGES,
     ...BASE_CONTROLLER_INPUT_RANGES,
     // `fromEntries` widens the key type back to `string`; the annotation above is what keeps
     // this exhaustive, and it fails to typecheck if a name ever lacks a range.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laplace.live/persona-sdk",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "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.1"
+    "vitest": "^5.0.2"
   },
   "engines": {
     "node": ">=24"