@doki-land/live2d-core 0.0.12 → 0.0.14

package/README.md

@@ -1,3 +1,3 @@
 # @doki-land/live2d-core
 
-live2d.ts package 0.0.12.
+live2d.ts package 0.0.14.

package/dist/index.d.ts

@@ -300,6 +300,14 @@ type StageUpdateMode = "auto" | "manual";
 interface CreateLive2dStageOptions {
     updateMode?: StageUpdateMode;
 }
+interface PlayMotionActorOptions {
+    priority?: number;
+    slot?: string;
+    queue?: boolean;
+    loop?: boolean;
+    fadeInTime?: number;
+    fadeOutTime?: number;
+}
 /** Read-only actor surface exposed by the stage. */
 interface Live2dActor {
     readonly id: string;
@@ -313,6 +321,26 @@ interface Live2dActor {
     setTransform(patch: Partial<ActorTransform>): void;
     load(source: ModelSource, resolver?: AssetResolver): Promise<InternalModel>;
     setParameter(id: string, value: number): void;
+    listParameters(): ReadonlyArray<{
+        id: string;
+        min: number;
+        max: number;
+        defaultValue: number;
+        value: number;
+    }>;
+    listMotionGroups(): Record<string, readonly MotionDefinition[]>;
+    playMotion(group: string, index?: number, options?: PlayMotionActorOptions): Promise<boolean>;
+    stopMotion(opts?: {
+        fade?: boolean;
+        slot?: string;
+    }): void;
+    listPlayingMotions(): ReadonlyArray<{
+        slot: string;
+        group: string;
+        index: number;
+        time: number;
+        priority: number;
+    }>;
     lookAt(stageX: number, stageY: number): void;
     destroy(): void;
 }
@@ -321,8 +349,11 @@ interface Live2dStage {
     readonly actors: readonly Live2dActor[];
     mount(canvas: HTMLCanvasElement): Promise<void>;
     createActor(options?: CreateActorOptions): Live2dActor;
+    getActor(id: string): Live2dActor | null;
     removeActor(actor: Live2dActor | string): void;
     defineLayers(layers: readonly string[]): void;
+    /** Sync canvas backing store and renderer to CSS or explicit pixel size. */
+    resize(width?: number, height?: number): void;
     update(deltaTimeSeconds: number): void;
     render(): void;
     start(): void;
@@ -343,4 +374,4 @@ interface Live2dStage {
 
 declare const LIVE2D_CORE_VERSION: "0.0.0";
 
-export { type ActorHit, type ActorTransform, type AssetKey, type AssetResolver, type CreateActorOptions, type CreateLive2dStageOptions, DEFAULT_ACTOR_TRANSFORM, type DrawableProgram, EventEmitter, type ExpressionDefinition, FrameBlendMode, type FrameDrawable, type FrameProfile, type FrameSnapshot, type HitAreaDefinition, type InternalModel, LIVE2D_CORE_VERSION, type Live2DEventMap, type Live2DEventName, type Live2DListener, type Live2DSession, type Live2dActor, type Live2dStage, type LoadProgress, type LoadProgressStage, type ModelFormat, type ModelInstance, type ModelProgram, type ModelSettings, type ModelSource, type MotionDefinition, type ParameterProgram, type PointerTrackingMode, type PointerTrackingPolicy, type SessionPhase, type SessionState, type StagePointerEvent, type StageUpdateMode, createSessionStub, detectModelSettingsFormat, modelSourceUrl };
+export { type ActorHit, type ActorTransform, type AssetKey, type AssetResolver, type CreateActorOptions, type CreateLive2dStageOptions, DEFAULT_ACTOR_TRANSFORM, type DrawableProgram, EventEmitter, type ExpressionDefinition, FrameBlendMode, type FrameDrawable, type FrameProfile, type FrameSnapshot, type HitAreaDefinition, type InternalModel, LIVE2D_CORE_VERSION, type Live2DEventMap, type Live2DEventName, type Live2DListener, type Live2DSession, type Live2dActor, type Live2dStage, type LoadProgress, type LoadProgressStage, type ModelFormat, type ModelInstance, type ModelProgram, type ModelSettings, type ModelSource, type MotionDefinition, type ParameterProgram, type PlayMotionActorOptions, type PointerTrackingMode, type PointerTrackingPolicy, type SessionPhase, type SessionState, type StagePointerEvent, type StageUpdateMode, createSessionStub, detectModelSettingsFormat, modelSourceUrl };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/live2d-core",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Live2D types, events, and session contracts",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -50,6 +50,7 @@ export type {
     CreateLive2dStageOptions,
     Live2dActor,
     Live2dStage,
+    PlayMotionActorOptions,
     PointerTrackingMode,
     PointerTrackingPolicy,
     StagePointerEvent,

package/src/stage.ts

@@ -1,4 +1,4 @@
-import type { InternalModel } from "./model.js";
+import type { InternalModel, MotionDefinition } from "./model.js";
 
 /** Normalized stage placement for one actor (0,0) top-left → (1,1) bottom-right. */
 export interface ActorTransform {
@@ -77,6 +77,15 @@ export interface CreateLive2dStageOptions {
     updateMode?: StageUpdateMode;
 }
 
+export interface PlayMotionActorOptions {
+    priority?: number;
+    slot?: string;
+    queue?: boolean;
+    loop?: boolean;
+    fadeInTime?: number;
+    fadeOutTime?: number;
+}
+
 /** Read-only actor surface exposed by the stage. */
 export interface Live2dActor {
     readonly id: string;
@@ -98,6 +107,32 @@ export interface Live2dActor {
 
     setParameter(id: string, value: number): void;
 
+    listParameters(): ReadonlyArray<{
+        id: string;
+        min: number;
+        max: number;
+        defaultValue: number;
+        value: number;
+    }>;
+
+    listMotionGroups(): Record<string, readonly MotionDefinition[]>;
+
+    playMotion(
+        group: string,
+        index?: number,
+        options?: PlayMotionActorOptions,
+    ): Promise<boolean>;
+
+    stopMotion(opts?: { fade?: boolean; slot?: string }): void;
+
+    listPlayingMotions(): ReadonlyArray<{
+        slot: string;
+        group: string;
+        index: number;
+        time: number;
+        priority: number;
+    }>;
+
     lookAt(stageX: number, stageY: number): void;
 
     destroy(): void;
@@ -111,10 +146,15 @@ export interface Live2dStage {
 
     createActor(options?: CreateActorOptions): Live2dActor;
 
+    getActor(id: string): Live2dActor | null;
+
     removeActor(actor: Live2dActor | string): void;
 
     defineLayers(layers: readonly string[]): void;
 
+    /** Sync canvas backing store and renderer to CSS or explicit pixel size. */
+    resize(width?: number, height?: number): void;
+
     update(deltaTimeSeconds: number): void;
 
     render(): void;