@doki-land/live2d-core 0.0.22 → 0.0.23

package/dist/index.d.ts

@@ -371,6 +371,9 @@ interface Live2dActor {
         time: number;
         priority: number;
     }>;
+    listExpressions(): readonly ExpressionDefinition[];
+    /** Apply an expression by settings name; pass `null` to clear. */
+    setExpression(name: string | null): Promise<boolean>;
     lookAt(stageX: number, stageY: number): void;
     destroy(): void;
 }
@@ -388,6 +391,8 @@ interface Live2dStage {
     resize(width?: number, height?: number): void;
     update(deltaTimeSeconds: number): void;
     render(): void;
+    /** Subscribe to the stage-owned frame loop (before `update`). Returns unsubscribe. */
+    onFrame(listener: (deltaTimeSeconds: number) => void): () => void;
     start(): void;
     pause(): void;
     resume(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/live2d-core",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "description": "Shared TypeScript contracts for live2d.ts — ModelSource, Live2dStage/Actor, ModelAsset, events (no DOM/GPU).",
   "type": "module",
   "license": "MIT",

package/src/stage/stage.ts

@@ -1,5 +1,9 @@
 import type { AssetResolver, ModelSource } from "../contracts.js";
-import type { InternalModel, MotionDefinition } from "../model/model.js";
+import type {
+    ExpressionDefinition,
+    InternalModel,
+    MotionDefinition,
+} from "../model/model.js";
 import type { ModelAsset } from "../model/model-asset.js";
 
 /** Normalized stage placement for one actor (0,0) top-left → (1,1) bottom-right. */
@@ -150,6 +154,11 @@ export interface Live2dActor {
         priority: number;
     }>;
 
+    listExpressions(): readonly ExpressionDefinition[];
+
+    /** Apply an expression by settings name; pass `null` to clear. */
+    setExpression(name: string | null): Promise<boolean>;
+
     lookAt(stageX: number, stageY: number): void;
 
     destroy(): void;
@@ -179,6 +188,9 @@ export interface Live2dStage {
 
     render(): void;
 
+    /** Subscribe to the stage-owned frame loop (before `update`). Returns unsubscribe. */
+    onFrame(listener: (deltaTimeSeconds: number) => void): () => void;
+
     start(): void;
 
     pause(): void;