@laplace.live/persona-sdk 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './client/client.ts';
 export * from './values/custom-effect.ts';
 export * from './values/effect-schema.ts';
 export * from './values/guards.ts';
+export * from './values/hotkeys.ts';
 export * from './values/labels.ts';
 export * from './values/limits.ts';
 export * from './values/locale.ts';

package/dist/index.js

@@ -5,6 +5,7 @@ export * from "./client/client.js";
 export * from "./values/custom-effect.js";
 export * from "./values/effect-schema.js";
 export * from "./values/guards.js";
+export * from "./values/hotkeys.js";
 export * from "./values/labels.js";
 export * from "./values/limits.js";
 export * from "./values/locale.js";

package/dist/values/hotkeys.d.ts

@@ -0,0 +1,2 @@
+/** True when the combo carries a command modifier and so may be registered globally. */
+export declare function hasCommandModifier(accelerator: string | null): boolean;

package/dist/values/hotkeys.js

@@ -0,0 +1,11 @@
+// Hotkey rules every consumer must agree on: main decides OS registration by them, and a
+// client reading `Hotkey.global` off the wire needs the same rule to know the flag can apply.
+// Shift is deliberately absent: Shift+letter is how text is typed, and a global
+// registration consumes the combo system-wide (VTS can allow it because it observes).
+const COMMAND_MODIFIERS = ['Control', 'Alt', 'Super'];
+/** True when the combo carries a command modifier and so may be registered globally. */
+export function hasCommandModifier(accelerator) {
+    if (accelerator === null)
+        return false;
+    return accelerator.split('+').some(t => COMMAND_MODIFIERS.includes(t));
+}

package/dist/wire/events.d.ts

@@ -25,9 +25,11 @@ export interface EventMap {
         instanceId: string;
         format: ModelFormat;
     };
+    /** `weights` rides along on instances with `expression-weights`; a drag is not echoed (see `expression.setWeight`). */
     'expression.changed': {
         instanceId: string;
         active: string[];
+        weights?: Record<string, number>;
     };
     'motion.started': {
         instanceId: string;

package/dist/wire/methods.d.ts

@@ -190,6 +190,17 @@ export interface ExpressionToggleRequest {
 export interface ExpressionToggleResponse {
     active: string[];
 }
+/** Reweight an expression that is already active — a weight on an inactive one would be invisible. */
+export interface ExpressionSetWeightRequest {
+    instanceId?: string;
+    name: string;
+    /** 0..1. */
+    weight: number;
+}
+export interface ExpressionSetWeightResponse {
+    /** Every active expression's weight, in activation order. */
+    weights: Record<string, number>;
+}
 export interface ExpressionGetPersistenceRequest {
     modelId?: string;
 }
@@ -580,6 +591,10 @@ export interface MethodMap {
         request: ExpressionToggleRequest;
         response: ExpressionToggleResponse;
     };
+    'expression.setWeight': {
+        request: ExpressionSetWeightRequest;
+        response: ExpressionSetWeightResponse;
+    };
     'expression.getPersistence': {
         request: ExpressionGetPersistenceRequest;
         response: ExpressionGetPersistenceResponse;

package/dist/wire/types.d.ts

@@ -706,8 +706,16 @@ 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`. */
 export type InstanceCapability = 'motions' | 'expressions' | 'placement-2d' | 'placement-3d' | 'mtoon' | 'idle-clips' | 'pose' | 'live2d-params'
+/** `expression.setWeight`; Cubism expressions carry no user-settable weight, so Live2D lacks it. */
+ | 'expression-weights'
 /** `speech.play` lip-sync; engine-dependent, so gate on the runtime, not the format. */
- | 'speech';
+ | 'speech'
+/**
+ * Draws through the 3D post chain, so the scene's look rows (tone mapping, exposure, LUT)
+ * reach it. Always on VRM; on Live2D only under the `three` renderer, so read it off the
+ * runtime rather than the format.
+ */
+ | 'post-fx';
 export interface InstanceRuntime {
     instanceId: string;
     kind: 'model' | 'object';
@@ -724,6 +732,14 @@ export interface Expression {
     name: string;
     file: string | null;
     active: boolean;
+    /**
+     * A wardrobe piece (`LAPLACE_outfit`), not a face. Group these apart: "Jacket Off"
+     * listed between `blinkLeft` and `happy` reads as an expression when it is not one.
+     * Absent on formats with no wardrobe.
+     */
+    outfit?: boolean;
+    /** Blend weight (0..1) while active; absent unless the instance has `expression-weights`. */
+    weight?: number;
 }
 export interface PlayingMotion {
     group: string;

package/package.json

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