@laplace.live/persona-sdk 1.20.0 → 1.22.0

package/dist/values/labels.js

@@ -1,4 +1,4 @@
-import { AUTOMATION_BOUNDARY_KINDS } from "../wire/types.js";
+import { AUTOMATION_SETUP_KINDS } from "../wire/types.js";
 import { isOneOf } from "./guards.js";
 /** Last path segment, tolerating both `/` and `\` separators. */
 export function fileBasename(path) {
@@ -28,21 +28,27 @@ export function motionSlots(files) {
 // English fallbacks; localizing clients keep their own map and use these for unknown kinds.
 const AUTOMATION_ACTION_KIND_LABELS = {
     'effect-toggle': 'Toggle Effect',
-    'effect-params': 'Effect Settings',
-    'effect-clip': 'Effect Clip',
+    'effect-params': 'Apply Effect Settings',
+    'effect-clip': 'Temporary Effect',
     'camera-pose': 'Camera Position',
-    'reset-camera': 'Reset Camera',
+    'camera-reset': 'Reset Camera',
     'layer-visibility': 'Layer Visibility',
+    'text-set': 'Set Text',
+    'lyrics-play': 'Lyrics',
     'stream-mode': 'Stream Mode',
-    'switch-scene': 'Switch Scene',
-    'toggle-expression': 'Toggle Expression',
-    'play-motion': 'Play Motion',
-    'play-audio': 'Play Audio',
+    'scene-switch': 'Switch Scene',
+    'expression-toggle': 'Toggle Expression',
+    'motion-play': 'Play Motion',
+    'audio-play': 'Play Audio',
     'audio-control': 'Control Audio',
-    'play-camera-motion': 'Play Camera Motion',
-    'stop-camera-motion': 'Stop Camera Motion',
-    'remove-all-expressions': 'Clear All Expressions',
-    'load-model': 'Swap Model',
+    'camera-motion-play': 'Play Camera Motion',
+    'camera-motion-stop': 'Stop Camera Motion',
+    'camera-follow': 'Camera Follow',
+    'camera-aim': 'Camera Aim',
+    'camera-focus': 'Camera Focus',
+    'camera-handheld': 'Handheld Movement',
+    'expression-clear': 'Clear All Expressions',
+    'model-load': 'Swap Model',
     'model-position': 'Model Position',
 };
 /** English label for one automation action kind; kinds newer than this SDK read `Action`. */
@@ -50,9 +56,11 @@ export function automationActionLabel(kind) {
     return AUTOMATION_ACTION_KIND_LABELS[kind] ?? 'Action';
 }
 /** True for an action that prepares the scene before playback. */
-export function isAutomationBoundary(kind) {
-    return isOneOf(kind, AUTOMATION_BOUNDARY_KINDS);
+export function isAutomationSetup(kind) {
+    return isOneOf(kind, AUTOMATION_SETUP_KINDS);
 }
+/** @deprecated Use `isAutomationSetup`. */
+export const isAutomationBoundary = isAutomationSetup;
 /** Join action labels without implying timing that the client summary does not carry. */
 export function joinAutomationActionLabels(labels, kinds) {
     if (labels.length !== kinds.length)

package/dist/values/limits.d.ts

@@ -1,4 +1,4 @@
-import type { AssetRef, Attach, AttachDepth, EnvironmentLook, ModelFormat, MToonTuning, ObjectContent, ObjectSpace, SceneEnvironment, SceneLight, SceneLightCameraFollowOptions, SceneLightType, ScreenPlacement, VrmPlacement } from '../wire/types.ts';
+import type { AssetRef, Attach, AttachDepth, CameraAnchor, CameraFollowDamping, CameraTrackTarget, EnvironmentLook, ModelFormat, MToonTuning, ObjectContent, ObjectSpace, SceneCameraAim, SceneCameraAimSettings, SceneCameraFocus, SceneCameraFocusSettings, SceneCameraFollow, SceneCameraFollowSettings, SceneCameraHandheld, SceneEnvironment, SceneLight, SceneLightCameraFollowOptions, SceneLightType, ScreenPlacement, VrmPlacement } from '../wire/types.ts';
 export declare function clamp(v: number, min: number, max: number): number;
 /** Clamp to the unit interval. */
 export declare function clamp01(v: number): number;
@@ -63,6 +63,66 @@ export declare const SCENE_FOV_MAX = 90;
 /** Nonsingular authored field of view in degrees, including every valid whole-degree VMD key. */
 export declare const CAMERA_FOV_MIN = 1;
 export declare const CAMERA_FOV_MAX = 179;
+/** Ceiling for each follow and aim damping, in seconds. */
+export declare const CAMERA_DAMPING_MAX = 10;
+/** Ceiling for {@link SceneCameraAim}'s lookahead time, in seconds, and its smoothing. */
+export declare const CAMERA_AIM_LOOKAHEAD_MAX = 1;
+export declare const CAMERA_AIM_SMOOTHING_MAX = 30;
+/** Ceiling for {@link SceneCameraHandheld}'s speed. */
+export declare const CAMERA_HANDHELD_SPEED_MAX = 2;
+/** Warudo's Handheld Movement defaults, switched off. */
+export declare const DEFAULT_CAMERA_HANDHELD: SceneCameraHandheld;
+/**
+ * A fresh follow's damping: Warudo's second of position lag, and half a second on each turn so a
+ * tracked head's jitter never shakes the view.
+ */
+export declare const DEFAULT_CAMERA_FOLLOW_DAMPING: CameraFollowDamping;
+/** Where a fresh follow, aim or focus tracks a model; an object is always tracked by its root. */
+export declare const DEFAULT_CAMERA_ANCHOR: CameraAnchor;
+/** A fresh follow's settings: position only. */
+export declare function defaultCameraFollowSettings(): SceneCameraFollowSettings;
+/** A fresh follow of `target`, position only. */
+export declare function defaultCameraFollow(target: CameraTrackTarget): SceneCameraFollow;
+/** A fresh aim's settings, Warudo's Composer defaults: centred, no dead zone, 0.8 soft zone. */
+export declare function defaultCameraAimSettings(): SceneCameraAimSettings;
+/** A fresh aim at `target`. */
+export declare function defaultCameraAim(target: CameraTrackTarget): SceneCameraAim;
+/** A fresh focus's settings, refocusing about as fast as Warudo's default focusing speed. */
+export declare function defaultCameraFocusSettings(): SceneCameraFocusSettings;
+/** A fresh focus on `target`. */
+export declare function defaultCameraFocus(target: CameraTrackTarget): SceneCameraFocus;
+/** A follow's, aim's or focus's settings alone, without the layer it names. */
+export declare function cameraTrackSettingsOf<T extends CameraTrackTarget>(track: T): Omit<T, 'instanceId' | 'target'>;
+/** The instance `target` tracks in a scene whose primary model is `primaryInstanceId`. */
+export declare function cameraTrackInstanceId(target: CameraTrackTarget, primaryInstanceId: string | null): string | null;
+/** How a camera can track `item`: by any anchor on a VRM model, by the root of a 3D object, or not at all. */
+export declare function cameraTrackKind(item: {
+    kind: 'model';
+    ref: {
+        kind: string;
+    };
+} | {
+    kind: 'object';
+    space: ObjectSpace;
+}): 'model' | 'object' | null;
+/** Rows for the camera's follow, aim and focus pickers, in layer order. One rule, or the console offers a layer the desktop drops. */
+export declare function cameraTrackCandidates(items: readonly ({
+    kind: 'model';
+    instanceId: string;
+    ref: {
+        kind: string;
+        name: string;
+    };
+} | {
+    kind: 'object';
+    instanceId: string;
+    name: string;
+    space: ObjectSpace;
+})[]): {
+    instanceId: string;
+    name: string;
+    model: boolean;
+}[];
 /** Manual navigation stops short of ±90°; authored camera elevations remain unrestricted. */
 export declare const ELEVATION_LIMIT: number;
 /** Manual navigation distance bounds; authored cameras retain signed, unrestricted distances. */
@@ -172,9 +232,32 @@ export declare const WEB_SIZE_MAX = 7680;
 /** Web object paint-rate bounds, frames per second. */
 export declare const WEB_FPS_MIN = 1;
 export declare const WEB_FPS_MAX = 60;
+/** Text object bounds: characters, em size in px, and the box and paint extents in px. */
+export declare const TEXT_LENGTH_MAX = 10000;
+export declare const TEXT_SIZE_MIN = 4;
+export declare const TEXT_SIZE_MAX = 1000;
+export declare const TEXT_SHEAR_MAX = 1;
+/** Letter and word spacing, em. */
+export declare const TEXT_SPACING_MIN = -0.5;
+export declare const TEXT_SPACING_MAX = 2;
+export declare const TEXT_LINE_HEIGHT_MIN = 0.5;
+export declare const TEXT_LINE_HEIGHT_MAX = 4;
+export declare const TEXT_BOX_MAX = 7680;
+export declare const TEXT_STROKE_MAX = 100;
+export declare const TEXT_SHADOW_OFFSET_MAX = 200;
+export declare const TEXT_SHADOW_BLUR_MAX = 100;
+export declare const TEXT_PLATE_PADDING_MAX = 500;
+export declare const TEXT_PLATE_RADIUS_MAX = 500;
+/** 3D text: extrusion and bevel in em, bevel segments, and emission strength. */
+export declare const TEXT_EXTRUDE_MAX = 2;
+export declare const TEXT_BEVEL_MAX = 0.2;
+export declare const TEXT_BEVEL_RESOLUTION_MAX = 8;
+export declare const TEXT_EMISSION_MAX = 4;
+/** A PostScript name: printable ASCII, at most 63 chars, minus the quote and backslash that would escape `local("…")`. */
+export declare const TEXT_POSTSCRIPT_NAME_RE: RegExp;
 /** A prop is a mesh, so it only exists in the three.js scene; every other kind renders in both. */
 export declare function objectSupportsSpace(kind: ObjectContent['kind'], space: ObjectSpace): boolean;
-/** The asset an object streams from, or null for kinds that carry their source inline (web, capture). */
+/** The asset an object streams from, or null for kinds that carry their source inline (web, capture, text). */
 export declare function contentAssetId(content: ObjectContent): string | null;
 /**
  * The one model format a space's objects can ride: the screen layer always composites
@@ -212,6 +295,19 @@ export declare function pinnableParents(models: readonly {
     name: string;
     ridesThis: boolean;
 }[];
+/**
+ * Whether pinning puts an item inside its Live2D host's ArtMesh stack, where `attach.depth` places
+ * it: a Live2D item, or a 2D object as one quad. A 3D object only ever paints in front.
+ */
+export declare function pinEntersStack(item: {
+    kind: 'model';
+    ref: {
+        kind: ModelFormat;
+    };
+} | {
+    kind: 'object';
+    space: ObjectSpace;
+}): boolean;
 /**
  * The depth control's stops, back to front: behind the model, above each of its ArtMeshes in
  * paint order, then in front of it all. One continuous run, so depth is a slider over the host's
@@ -220,9 +316,12 @@ export declare function pinnableParents(models: readonly {
 export declare function depthStops(meshes: readonly string[]): AttachDepth[];
 /** Which stop a depth sits at; an ArtMesh the host no longer has reads as the frontmost. */
 export declare function depthStopIndex(meshes: readonly string[], depth: AttachDepth): number;
-/** A fresh pin onto `parentInstanceId`: root anchor, in front of the model, no response tuning. */
-export declare function defaultAttach(parentInstanceId: string): Attach;
 export declare const DEFAULT_HEAD_ANGLE: NonNullable<Attach['headAngle']>;
+/**
+ * A fresh pin onto `parentInstanceId`: root anchor, in front of the model. A screen-space item (a
+ * Live2D model, a 2D object) follows the host's head at the default response; others take none.
+ */
+export declare function defaultAttach(parentInstanceId: string, screenSpace?: boolean): Attach;
 export declare const ATTACH_MULTIPLIER_MIN = -2;
 export declare const ATTACH_MULTIPLIER_MAX = 2;
 /** Parallax slider ceiling, symmetric: stage px at a full head turn. */
@@ -254,5 +353,7 @@ export declare const OUTLINER_DEFAULT_WIDTH = 288;
  * split must fit inside it, or no layout satisfies both floors and the group clips instead.
  */
 export declare const TWO_COLUMN_WIDTH = 672;
+/** Colors a color picker keeps saved — two rows of its swatch grid; saving more waits for a removal. */
+export declare const SAVED_COLORS_MAX = 12;
 /** 3D-stage resolution multipliers offered by both performance pickers. */
 export declare const RENDER_SCALE_PRESETS: readonly [1, 0.85, 0.75, 0.66, 0.5];

package/dist/values/limits.js

@@ -94,6 +94,78 @@ export const SCENE_FOV_MAX = 90;
 /** Nonsingular authored field of view in degrees, including every valid whole-degree VMD key. */
 export const CAMERA_FOV_MIN = 1;
 export const CAMERA_FOV_MAX = 179;
+/** Ceiling for each follow and aim damping, in seconds. */
+export const CAMERA_DAMPING_MAX = 10;
+/** Ceiling for {@link SceneCameraAim}'s lookahead time, in seconds, and its smoothing. */
+export const CAMERA_AIM_LOOKAHEAD_MAX = 1;
+export const CAMERA_AIM_SMOOTHING_MAX = 30;
+/** Ceiling for {@link SceneCameraHandheld}'s speed. */
+export const CAMERA_HANDHELD_SPEED_MAX = 2;
+/** Warudo's Handheld Movement defaults, switched off. */
+export const DEFAULT_CAMERA_HANDHELD = { enabled: false, intensity: 0.5, speed: 1 };
+/**
+ * A fresh follow's damping: Warudo's second of position lag, and half a second on each turn so a
+ * tracked head's jitter never shakes the view.
+ */
+export const DEFAULT_CAMERA_FOLLOW_DAMPING = { x: 1, y: 1, z: 1, yaw: 0.5, pitch: 0.5, roll: 0.5 };
+/** Where a fresh follow, aim or focus tracks a model; an object is always tracked by its root. */
+export const DEFAULT_CAMERA_ANCHOR = { kind: 'bone', bone: 'head' };
+/** A fresh follow's settings: position only. */
+export function defaultCameraFollowSettings() {
+    return { anchor: DEFAULT_CAMERA_ANCHOR, binding: 'world', damping: { ...DEFAULT_CAMERA_FOLLOW_DAMPING } };
+}
+/** A fresh follow of `target`, position only. */
+export function defaultCameraFollow(target) {
+    return { ...target, ...defaultCameraFollowSettings() };
+}
+/** A fresh aim's settings, Warudo's Composer defaults: centred, no dead zone, 0.8 soft zone. */
+export function defaultCameraAimSettings() {
+    return {
+        anchor: DEFAULT_CAMERA_ANCHOR,
+        screenX: 0.5,
+        screenY: 0.5,
+        deadZone: { width: 0, height: 0 },
+        softZone: { width: 0.8, height: 0.8 },
+        bias: { x: 0, y: 0 },
+        damping: { horizontal: 0.5, vertical: 0.5 },
+        lookahead: { time: 0, smoothing: 0.5, ignoreY: false },
+    };
+}
+/** A fresh aim at `target`. */
+export function defaultCameraAim(target) {
+    return { ...target, ...defaultCameraAimSettings() };
+}
+/** A fresh focus's settings, refocusing about as fast as Warudo's default focusing speed. */
+export function defaultCameraFocusSettings() {
+    return { anchor: DEFAULT_CAMERA_ANCHOR, damping: 0.2 };
+}
+/** A fresh focus on `target`. */
+export function defaultCameraFocus(target) {
+    return { ...target, ...defaultCameraFocusSettings() };
+}
+/** A follow's, aim's or focus's settings alone, without the layer it names. */
+export function cameraTrackSettingsOf(track) {
+    const { instanceId: _instanceId, target: _target, ...settings } = track;
+    return settings;
+}
+/** The instance `target` tracks in a scene whose primary model is `primaryInstanceId`. */
+export function cameraTrackInstanceId(target, primaryInstanceId) {
+    return target.target === 'primary' ? primaryInstanceId : target.instanceId;
+}
+/** How a camera can track `item`: by any anchor on a VRM model, by the root of a 3D object, or not at all. */
+export function cameraTrackKind(item) {
+    if (item.kind === 'model')
+        return item.ref.kind === 'vrm' ? 'model' : null;
+    return item.space === '3d' ? 'object' : null;
+}
+/** Rows for the camera's follow, aim and focus pickers, in layer order. One rule, or the console offers a layer the desktop drops. */
+export function cameraTrackCandidates(items) {
+    return items.flatMap(item => {
+        const kind = cameraTrackKind(item);
+        const name = item.kind === 'model' ? item.ref.name : item.name;
+        return kind ? [{ instanceId: item.instanceId, name, model: kind === 'model' }] : [];
+    });
+}
 /** Manual navigation stops short of ±90°; authored camera elevations remain unrestricted. */
 export const ELEVATION_LIMIT = (80 * Math.PI) / 180;
 /** Manual navigation distance bounds; authored cameras retain signed, unrestricted distances. */
@@ -292,11 +364,34 @@ export const WEB_SIZE_MAX = 7680;
 /** Web object paint-rate bounds, frames per second. */
 export const WEB_FPS_MIN = 1;
 export const WEB_FPS_MAX = 60;
+/** Text object bounds: characters, em size in px, and the box and paint extents in px. */
+export const TEXT_LENGTH_MAX = 10_000;
+export const TEXT_SIZE_MIN = 4;
+export const TEXT_SIZE_MAX = 1000;
+export const TEXT_SHEAR_MAX = 1;
+/** Letter and word spacing, em. */
+export const TEXT_SPACING_MIN = -0.5;
+export const TEXT_SPACING_MAX = 2;
+export const TEXT_LINE_HEIGHT_MIN = 0.5;
+export const TEXT_LINE_HEIGHT_MAX = 4;
+export const TEXT_BOX_MAX = 7680;
+export const TEXT_STROKE_MAX = 100;
+export const TEXT_SHADOW_OFFSET_MAX = 200;
+export const TEXT_SHADOW_BLUR_MAX = 100;
+export const TEXT_PLATE_PADDING_MAX = 500;
+export const TEXT_PLATE_RADIUS_MAX = 500;
+/** 3D text: extrusion and bevel in em, bevel segments, and emission strength. */
+export const TEXT_EXTRUDE_MAX = 2;
+export const TEXT_BEVEL_MAX = 0.2;
+export const TEXT_BEVEL_RESOLUTION_MAX = 8;
+export const TEXT_EMISSION_MAX = 4;
+/** A PostScript name: printable ASCII, at most 63 chars, minus the quote and backslash that would escape `local("…")`. */
+export const TEXT_POSTSCRIPT_NAME_RE = /^[\x21\x23-\x5b\x5d-\x7e]{1,63}$/;
 /** A prop is a mesh, so it only exists in the three.js scene; every other kind renders in both. */
 export function objectSupportsSpace(kind, space) {
     return kind === 'prop' ? space === '3d' : true;
 }
-/** The asset an object streams from, or null for kinds that carry their source inline (web, capture). */
+/** The asset an object streams from, or null for kinds that carry their source inline (web, capture, text). */
 export function contentAssetId(content) {
     return content.kind === 'image' || content.kind === 'video' || content.kind === 'prop' ? content.assetId : null;
 }
@@ -343,6 +438,13 @@ export function pinnableParents(models, items, instanceId) {
     }
     return out;
 }
+/**
+ * Whether pinning puts an item inside its Live2D host's ArtMesh stack, where `attach.depth` places
+ * it: a Live2D item, or a 2D object as one quad. A 3D object only ever paints in front.
+ */
+export function pinEntersStack(item) {
+    return item.kind === 'model' ? item.ref.kind === 'live2d' : item.space === '2d';
+}
 /**
  * The depth control's stops, back to front: behind the model, above each of its ArtMeshes in
  * paint order, then in front of it all. One continuous run, so depth is a slider over the host's
@@ -360,24 +462,27 @@ export function depthStopIndex(meshes, depth) {
     const at = meshes.indexOf(depth.id);
     return at < 0 ? meshes.length + 1 : at + 1;
 }
-/** A fresh pin onto `parentInstanceId`: root anchor, in front of the model, no response tuning. */
-export function defaultAttach(parentInstanceId) {
+export const DEFAULT_HEAD_ANGLE = {
+    multiplier: 1,
+    parallaxX: 0,
+    parallaxY: 0,
+    smoothing: 15,
+};
+/**
+ * A fresh pin onto `parentInstanceId`: root anchor, in front of the model. A screen-space item (a
+ * Live2D model, a 2D object) follows the host's head at the default response; others take none.
+ */
+export function defaultAttach(parentInstanceId, screenSpace = false) {
     return {
         parentInstanceId,
         anchor: { kind: 'root' },
         followRotation: true,
         depth: { kind: 'front' },
         split: null,
-        headAngle: null,
+        headAngle: screenSpace ? { ...DEFAULT_HEAD_ANGLE } : null,
         elasticity: null,
     };
 }
-export const DEFAULT_HEAD_ANGLE = {
-    multiplier: 1,
-    parallaxX: 0,
-    parallaxY: 0,
-    smoothing: 15,
-};
 export const ATTACH_MULTIPLIER_MIN = -2;
 export const ATTACH_MULTIPLIER_MAX = 2;
 /** Parallax slider ceiling, symmetric: stage px at a full head turn. */
@@ -411,5 +516,7 @@ export const OUTLINER_DEFAULT_WIDTH = 288;
  * split must fit inside it, or no layout satisfies both floors and the group clips instead.
  */
 export const TWO_COLUMN_WIDTH = 672;
+/** Colors a color picker keeps saved — two rows of its swatch grid; saving more waits for a removal. */
+export const SAVED_COLORS_MAX = 12;
 /** 3D-stage resolution multipliers offered by both performance pickers. */
 export const RENDER_SCALE_PRESETS = [1, 0.85, 0.75, 0.66, 0.5];

package/dist/values/stage-info.d.ts

@@ -19,6 +19,11 @@ export interface SceneAssetInfo {
     extensions: string[] | null;
     mediaSize: ObjectMediaSize | null;
 }
+/** One scene object's loaded metadata. */
+export interface SceneObjectInfo extends SceneAssetInfo {
+    /** A text object's transient text, null while it shows the saved one; absent on other kinds and older hosts. */
+    liveText?: string | null;
+}
 /** Metadata for the active scene, tagged so a response from a previous scene can be discarded. */
 export interface SceneInspection {
     sceneId: string;
@@ -26,5 +31,5 @@ export interface SceneInspection {
         /** The set's own bounding radius before placement scale, for `cameraDistanceLimits`; omitted by older hosts. */
         radius?: number | null;
     };
-    objects: Record<string, SceneAssetInfo>;
+    objects: Record<string, SceneObjectInfo>;
 }

package/dist/values/time.d.ts

@@ -0,0 +1,9 @@
+/** Desktop local wall-clock time, normalized over a repeating 24-hour or 12-hour cycle. */
+export declare const TIME_INPUT_RANGES: {
+    readonly Time24h: readonly [0, 1];
+    readonly Time12h: readonly [0, 1];
+};
+export type TimeInputName = keyof typeof TIME_INPUT_RANGES;
+export type TimeInputs = Readonly<Record<TimeInputName, number>>;
+export declare const TIME_INPUT_NAMES: readonly TimeInputName[];
+export declare function isTimeInputName(v: string): v is TimeInputName;

package/dist/values/time.js

@@ -0,0 +1,11 @@
+import { keysOf } from "./guards.js";
+/** Desktop local wall-clock time, normalized over a repeating 24-hour or 12-hour cycle. */
+export const TIME_INPUT_RANGES = {
+    Time24h: [0, 1],
+    Time12h: [0, 1],
+};
+export const TIME_INPUT_NAMES = keysOf(TIME_INPUT_RANGES);
+const TIME_INPUT_SET = new Set(TIME_INPUT_NAMES);
+export function isTimeInputName(v) {
+    return TIME_INPUT_SET.has(v);
+}

package/dist/wire/events.d.ts

@@ -30,6 +30,14 @@ export interface EventMap {
         instanceId: string;
         format: ModelFormat;
     };
+    /**
+     * An instance's motion or expression list changed without a reload — a recorded motion, an edited
+     * expression file, or a registered clip a VRM lists: re-run `motion.list` or `expression.list`.
+     */
+    'instance.listing': {
+        instanceId: string;
+        listing: 'motions' | 'expressions';
+    };
     /** `weights` rides along on instances with `expression-weights`; a drag is not echoed (see `expression.setWeight`). */
     'expression.changed': {
         instanceId: string;

package/dist/wire/events.js

@@ -8,6 +8,7 @@ export const EVENT_NAMES = Object.keys({
     'automation.state': true,
     'tracking.status': true,
     'instance.loaded': true,
+    'instance.listing': true,
     'expression.changed': true,
     'motion.started': true,
     'motion.ended': true,

package/dist/wire/methods.d.ts

@@ -5,7 +5,7 @@ import type { LipSyncCalibrationCommand, LipSyncConfig, LipSyncMode, LipSyncStat
 import type { ModelMovementConfig, ModelMovementEdit } from '../values/model-movement.ts';
 import type { SceneInspection } from '../values/stage-info.ts';
 import type { EventName } from './events.ts';
-import type { AnchorOption, AppCapability, AssetKind, AssetRef, Attach, AttachHeadAngle, AutomationInfo, BindingInput, Expression, ExpressionPersistence, HandTrackingMode, HotkeyConfig, HotkeyState, InjectEntry, InjectTarget, InstanceRuntime, JsonValue, LayerEffectKey, LayerEffects, LayerEffectsPatch, MediaPipeConfig, ModelInfo, ModelRef, MotionGroup, MToonTuning, ObjectContent, ObjectLightOverride, ObjectSpace, Place2D, Place3D, PlayingMotion, PoseSourceId, PoseStatus, Scene, SceneItem, SceneLight, SceneLightCameraFollowOptions, ScenePatch, SceneState, ScreenPlacement, Settings, SettingsPatch, TrackingLostBehavior, TrackingSourceConfig, TrackingSourceId, TrackingSourceKind, TrackingStatus, VrmPlacement } from './types.ts';
+import type { AnchorOption, AppCapability, AssetKind, AssetRef, Attach, AttachHeadAngle, AutomationInfo, BindingInput, Expression, ExpressionPersistence, FontFamilyInfo, HandTrackingMode, HotkeyConfig, HotkeyState, InjectEntry, InjectTarget, InstanceRuntime, JsonValue, LayerEffectKey, LayerEffects, LayerEffectsPatch, MediaPipeConfig, ModelInfo, ModelRef, MotionGroup, MToonTuning, ObjectContent, ObjectLightOverride, ObjectSpace, Place2D, Place3D, PlayingMotion, PoseSourceId, PoseStatus, Scene, SceneItem, SceneLight, SceneLightCameraFollowOptions, ScenePatch, SceneState, ScreenPlacement, Settings, SettingsPatch, TrackingLostBehavior, TrackingSourceConfig, TrackingSourceId, TrackingSourceKind, TrackingStatus, VrmPlacement } from './types.ts';
 /** Marker for methods that take no parameters; the client lets you omit the argument. */
 export type EmptyRequest = Record<never, never>;
 /** Marker for methods whose success response carries no data. */
@@ -215,6 +215,15 @@ export interface ObjectSetContentRequest {
     content: ObjectContent;
 }
 export type ObjectSetContentResponse = EmptyResponse;
+/** A `text` object's text alone, under `text-objects`. */
+export interface ObjectSetTextRequest {
+    instanceId: string;
+    /** Null drops a transient text, showing the saved one again. */
+    text: string | null;
+    /** Show it without saving: no `scenes.json` write and no undo step. */
+    transient?: boolean;
+}
+export type ObjectSetTextResponse = EmptyResponse;
 export interface ObjectSetSpaceRequest {
     instanceId: string;
     space: ObjectSpace;
@@ -361,6 +370,11 @@ export type AssetListRequest = EmptyRequest;
 export interface AssetListResponse {
     assets: AssetRef[];
 }
+export type FontsListRequest = EmptyRequest;
+/** The host machine's installed families — what a text object's `font` can name. */
+export interface FontsListResponse {
+    families: FontFamilyInfo[];
+}
 /** Register a model entry file under a user-configured plugin folder. */
 export interface ModelRegisterRequest {
     path: string;
@@ -887,6 +901,10 @@ export interface MethodMap {
         request: ObjectSetContentRequest;
         response: ObjectSetContentResponse;
     };
+    'object.setText': {
+        request: ObjectSetTextRequest;
+        response: ObjectSetTextResponse;
+    };
     'object.setSpace': {
         request: ObjectSetSpaceRequest;
         response: ObjectSetSpaceResponse;
@@ -988,6 +1006,10 @@ export interface MethodMap {
         request: AssetListRequest;
         response: AssetListResponse;
     };
+    'fonts.list': {
+        request: FontsListRequest;
+        response: FontsListResponse;
+    };
     'model.register': {
         request: ModelRegisterRequest;
         response: ModelRegisterResponse;

package/dist/wire/methods.js

@@ -35,6 +35,7 @@ export const METHOD_NAMES = Object.keys({
     'object.addMany': true,
     'object.rename': true,
     'object.setContent': true,
+    'object.setText': true,
     'object.setSpace': true,
     'object.setPlacement': true,
     'object.attach': true,
@@ -63,6 +64,7 @@ export const METHOD_NAMES = Object.keys({
     'model.getMovement': true,
     'model.setMovement': true,
     'asset.list': true,
+    'fonts.list': true,
     'asset.register': true,
     'registry.thumbnail': true,
     'settings.get': true,

package/dist/wire/schemas/requests.d.ts

@@ -234,6 +234,7 @@ export declare const requestSchemas: {
             lut: "lut";
             animation: "animation";
             cameraMotion: "cameraMotion";
+            lyrics: "lyrics";
         }>>;
     }, z.core.$strip>;
     'settings.patch': z.ZodObject<{
@@ -329,9 +330,9 @@ export declare const requestSchemas: {
         ttlMs: z.ZodOptional<z.ZodNumber>;
         transition: z.ZodOptional<z.ZodObject<{
             style: z.ZodOptional<z.ZodEnum<{
+                pop: "pop";
                 glitch: "glitch";
                 dither: "dither";
-                pop: "pop";
                 cut: "cut";
             }>>;
             inMs: z.ZodOptional<z.ZodNumber>;

package/dist/wire/schemas/settings.d.ts

@@ -180,9 +180,14 @@ export declare const SettingsSchema: z.ZodObject<{
             width: z.ZodNumber;
             height: z.ZodNumber;
         }, z.core.$strip>>;
+        stageReferenceSize: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     ui: z.ZodObject<{
         trayVisible: z.ZodBoolean;
+        streamMode: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     performance: z.ZodObject<{
         showFps: z.ZodBoolean;

package/dist/wire/schemas/settings.js

@@ -99,11 +99,15 @@ export const SettingsSchema = z.object({
     window: z
         .object({
         alwaysOnTop: z.boolean().describe('Keep the control-panel window above other windows.'),
-        stageSize: StageSizeSchema.optional().describe('Read-only stage content size; absent on older hosts.'),
+        stageSize: StageSizeSchema.optional().describe('Read-only stage window content size; absent on older hosts.'),
+        stageReferenceSize: StageSizeSchema.optional().describe('Read-only initial stage size calibrating placement units and model fit; not the output aspect.'),
     })
         .describe('Public window configuration and read-only stage dimensions.'),
     ui: z
-        .object({ trayVisible: z.boolean().describe('Show the tray or menu bar icon.') })
+        .object({
+        trayVisible: z.boolean().describe('Show the tray or menu bar icon.'),
+        streamMode: z.boolean().optional().describe('Read-only Stream Mode state; absent on older hosts.'),
+    })
         .describe('Public interface preferences.'),
     performance: PerformanceSettingsSchema.partial({ renderScale: true }).describe('Renderer settings; renderScale is absent on older hosts.'),
     tracking: TrackingSettingsSchema.describe('Network face master switch and all configured tracking sources.'),
@@ -118,6 +122,10 @@ export const SettingsPatchSchema = z.object({
         .partial()
         .optional()
         .describe('Control-panel window fields to update.'),
-    ui: SettingsSchema.shape.ui.partial().optional().describe('Public interface fields to update.'),
+    ui: SettingsSchema.shape.ui
+        .pick({ trayVisible: true })
+        .partial()
+        .optional()
+        .describe('Public interface fields to update.'),
     performance: PerformanceSettingsSchema.partial().optional().describe('Renderer fields to update.'),
 });