@doki-land/live2d-core 0.0.22 → 0.0.24

package/dist/index.d.ts

@@ -66,7 +66,7 @@ interface FrameProfile {
     readonly indexCount: number;
 }
 /** Minimal event bus used by sessions and loaders. */
-type Live2DEventMap = {
+type Live2dEventMap = {
     ready: {
         modelId: string;
     };
@@ -96,13 +96,19 @@ type Live2DEventMap = {
         generation: number;
     };
 };
-type Live2DEventName = keyof Live2DEventMap;
-type Live2DListener<K extends Live2DEventName> = (payload: Live2DEventMap[K]) => void;
+type Live2dEventName = keyof Live2dEventMap;
+type Live2dListener<K extends Live2dEventName> = (payload: Live2dEventMap[K]) => void;
+/** @deprecated Use `Live2dEventMap`. */
+type Live2DEventMap = Live2dEventMap;
+/** @deprecated Use `Live2dEventName`. */
+type Live2DEventName = Live2dEventName;
+/** @deprecated Use `Live2dListener`. */
+type Live2DListener<K extends Live2dEventName> = Live2dListener<K>;
 declare class EventEmitter {
     #private;
-    on<K extends Live2DEventName>(event: K, listener: Live2DListener<K>): () => void;
-    off<K extends Live2DEventName>(event: K, listener: Live2DListener<K>): void;
-    emit<K extends Live2DEventName>(event: K, payload: Live2DEventMap[K]): void;
+    on<K extends Live2dEventName>(event: K, listener: Live2dListener<K>): () => void;
+    off<K extends Live2dEventName>(event: K, listener: Live2dListener<K>): void;
+    emit<K extends Live2dEventName>(event: K, payload: Live2dEventMap[K]): void;
     clear(): void;
 }
 
@@ -248,19 +254,23 @@ interface ModelInstance {
 }
 
 /** High-level runtime session for one mounted surface. */
-interface Live2DSession {
+interface Live2dSession {
     readonly events: EventEmitter;
     readonly model: InternalModel | null;
     readonly state: SessionState;
     mount(canvas: HTMLCanvasElement): void;
-    loadModel(source: ModelSource, resolver?: AssetResolver): Promise<InternalModel>;
+    loadModel(source: ModelSource, resolver?: AssetResolver, options?: {
+        signal?: AbortSignal;
+    }): Promise<InternalModel>;
     /** Latest CPU frame after update, or null if no model. */
     captureFrame(): FrameSnapshot | null;
     update(deltaTimeSeconds: number): void;
     hitTest(x: number, y: number): string | null;
     destroy(): void;
 }
-declare function createSessionStub(): Live2DSession;
+/** @deprecated Use `Live2dSession`. */
+type Live2DSession = Live2dSession;
+declare function createSessionStub(): Live2dSession;
 
 /** Normalized stage placement for one actor (0,0) top-left → (1,1) bottom-right. */
 interface ActorTransform {
@@ -371,6 +381,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 +401,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;
@@ -412,4 +427,4 @@ interface Live2dStage {
 
 declare const LIVE2D_CORE_VERSION: "0.0.0";
 
-export { type ActorHit, type ActorInstance, 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 Live2dStageAssets, type LoadProgress, type LoadProgressStage, type ModelAsset, 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 };
+export { type ActorHit, type ActorInstance, 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 Live2dEventMap, type Live2dEventName, type Live2dListener, type Live2dSession, type Live2dStage, type Live2dStageAssets, type LoadProgress, type LoadProgressStage, type ModelAsset, 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.22",
+  "version": "0.0.24",
   "description": "Shared TypeScript contracts for live2d.ts — ModelSource, Live2dStage/Actor, ModelAsset, events (no DOM/GPU).",
   "type": "module",
   "license": "MIT",

package/src/events.ts

@@ -37,7 +37,7 @@ export interface FrameProfile {
 }
 
 /** Minimal event bus used by sessions and loaders. */
-export type Live2DEventMap = {
+export type Live2dEventMap = {
     ready: { modelId: string };
     error: { error: unknown };
     progress: LoadProgress;
@@ -49,18 +49,25 @@ export type Live2DEventMap = {
     phase: { phase: string; generation: number };
 };
 
-export type Live2DEventName = keyof Live2DEventMap;
+export type Live2dEventName = keyof Live2dEventMap;
 
-export type Live2DListener<K extends Live2DEventName> = (
-    payload: Live2DEventMap[K],
+export type Live2dListener<K extends Live2dEventName> = (
+    payload: Live2dEventMap[K],
 ) => void;
 
+/** @deprecated Use `Live2dEventMap`. */
+export type Live2DEventMap = Live2dEventMap;
+/** @deprecated Use `Live2dEventName`. */
+export type Live2DEventName = Live2dEventName;
+/** @deprecated Use `Live2dListener`. */
+export type Live2DListener<K extends Live2dEventName> = Live2dListener<K>;
+
 export class EventEmitter {
     #listeners = new Map<string, Set<(payload: unknown) => void>>();
 
-    on<K extends Live2DEventName>(
+    on<K extends Live2dEventName>(
         event: K,
-        listener: Live2DListener<K>,
+        listener: Live2dListener<K>,
     ): () => void {
         const set = this.#listeners.get(event) ?? new Set();
         set.add(listener as (payload: unknown) => void);
@@ -68,18 +75,18 @@ export class EventEmitter {
         return () => this.off(event, listener);
     }
 
-    off<K extends Live2DEventName>(
+    off<K extends Live2dEventName>(
         event: K,
-        listener: Live2DListener<K>,
+        listener: Live2dListener<K>,
     ): void {
         this.#listeners
             .get(event)
             ?.delete(listener as (payload: unknown) => void);
     }
 
-    emit<K extends Live2DEventName>(
+    emit<K extends Live2dEventName>(
         event: K,
-        payload: Live2DEventMap[K],
+        payload: Live2dEventMap[K],
     ): void {
         for (const listener of this.#listeners.get(event) ?? []) {
             listener(payload);

package/src/index.ts

@@ -19,11 +19,17 @@ export { modelSourceUrl } from "./contracts.js";
 export {
     EventEmitter,
     type FrameProfile,
+    type Live2dEventMap,
+    type Live2dEventName,
+    type Live2dListener,
+    type LoadProgress,
+    type LoadProgressStage,
+    /** @deprecated Use `Live2dEventMap`. */
     type Live2DEventMap,
+    /** @deprecated Use `Live2dEventName`. */
     type Live2DEventName,
+    /** @deprecated Use `Live2dListener`. */
     type Live2DListener,
-    type LoadProgress,
-    type LoadProgressStage,
 } from "./events.js";
 export { detectModelSettingsFormat } from "./format/detect-format.js";
 export {
@@ -52,6 +58,8 @@ export type {
 } from "./program.js";
 export {
     createSessionStub,
+    type Live2dSession,
+    /** @deprecated Use `Live2dSession`. */
     type Live2DSession,
 } from "./session.js";
 export type {

package/src/session.ts

@@ -4,7 +4,7 @@ import type { FrameSnapshot } from "./frame.js";
 import type { InternalModel } from "./model/model.js";
 
 /** High-level runtime session for one mounted surface. */
-export interface Live2DSession {
+export interface Live2dSession {
     readonly events: EventEmitter;
     readonly model: InternalModel | null;
     readonly state: SessionState;
@@ -14,6 +14,7 @@ export interface Live2DSession {
     loadModel(
         source: ModelSource,
         resolver?: AssetResolver,
+        options?: { signal?: AbortSignal },
     ): Promise<InternalModel>;
 
     /** Latest CPU frame after update, or null if no model. */
@@ -26,7 +27,10 @@ export interface Live2DSession {
     destroy(): void;
 }
 
-export function createSessionStub(): Live2DSession {
+/** @deprecated Use `Live2dSession`. */
+export type Live2DSession = Live2dSession;
+
+export function createSessionStub(): Live2dSession {
     let canvas: HTMLCanvasElement | null = null;
     let model: InternalModel | null = null;
     const events = new EventEmitter();

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;