@seayoo-web/pixi-live2d 0.0.10 → 0.1.1

package/package.json

@@ -1,30 +1,27 @@
 {
   "name": "@seayoo-web/pixi-live2d",
+  "version": "0.1.1",
   "description": "pixi-live2d viewer",
-  "version": "0.0.10",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
+  "keywords": [
+    "pixi-live2d"
+  ],
+  "license": "MIT",
+  "author": "web@seayoo.com",
   "source": "./index.ts",
-  "types": "./types/index.d.ts",
-  "sideEffects": false,
   "files": [
     "dist",
     "types",
     "docs",
     "README.md"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./types/index.d.ts",
   "publishConfig": {
     "access": "public"
   },
-  "engines": {
-    "node": ">=22"
-  },
-  "keywords": [
-    "pixi-live2d"
-  ],
-  "author": "web@seayoo.com",
-  "license": "MIT",
   "dependencies": {
     "@pixi/constants": "6.5.2",
     "@pixi/core": "6.5.2",
@@ -43,13 +40,16 @@
   "devDependencies": {
     "@types/node": "^22.13.1",
     "@seayoo-web/tsconfig": "^1.0.6",
-    "@seayoo-web/utils": "^4.4.1"
+    "@seayoo-web/utils": "^4.5.2"
+  },
+  "engines": {
+    "node": ">=22"
   },
   "scripts": {
     "build": "vite build && tsc --build --force --emitDeclarationOnly",
     "type-check": "tsc --noEmit",
-    "lint": "eslint ./**/*.ts",
-    "lint:fix": "eslint ./**/*.ts --fix",
+    "lint": "oxlint -c ../../oxlint.config.mjs",
+    "lint:fix": "oxlint -c ../../oxlint.config.mjs --fix",
     "prepublish": "pnpm lint:fix && pnpm build",
     "test": "vitest --dom",
     "coverage": "vitest run --coverage"

package/types/index.d.ts

@@ -1,5 +1,8 @@
-import { InternalModel, Live2DModel, MotionPriority } from "pixi-live2d-display/cubism4";
 import * as PIXI from "pixi.js";
+declare const coreLoadPromise: Promise<boolean>;
+export { coreLoadPromise };
+import type { InternalModel as InternalModelType, Live2DModel as Live2DModelType } from "pixi-live2d-display/cubism4";
+export type { MotionPriority } from "pixi-live2d-display/cubism4";
 declare global {
     interface Window {
         PIXI?: typeof PIXI;
@@ -28,13 +31,13 @@ export interface Live2DViewerOptions {
     /** 是否响应点击事件触发 TapBody 动作，默认为 true */
     enableTapBody?: boolean;
     /** 模型加载完成后的回调函数 */
-    onModelLoaded?: (model: Live2DModel<InternalModel>) => void;
+    onModelLoaded?: (model: Live2DModelType<InternalModelType>) => void;
     /** 模型加载失败的回调函数 */
     onModelError?: (error: Error) => void;
 }
-export { MotionPriority } from "pixi-live2d-display/cubism4";
-export { Live2DModel } from "pixi-live2d-display/cubism4";
 export declare class Live2DViewer {
+    /** 单例 PIXI 应用 */
+    static sharedApp: PIXI.Application | null;
     /** 引擎加载状态 Promise，用于确保全局只加载一次 Core 库 */
     private static coreLoadingPromise;
     /**
@@ -42,10 +45,14 @@ export declare class Live2DViewer {
      * @param url - Core 库的 URL 地址
      */
     static loadCubismCore(url?: string): Promise<void>;
+    /** 最新发起的加载任务 token，防频繁加载的竞态泄漏 */
+    private static loadingToken;
+    /** 整个页面生命周期内 Cubism 渲染管线是否已完成首次预热 */
+    private static hasWarmedUp;
     /** PIXI 应用实例 */
     app: PIXI.Application;
     /** Live2D 模型实例 */
-    model: Live2DModel<InternalModel> | null;
+    model: Live2DModelType<InternalModelType> | null;
     /** 配置项副本 */
     private options;
     /**
@@ -86,7 +93,7 @@ export declare class Live2DViewer {
      * @param startTime - 动作开始时间（秒），默认值为 0
      * @returns Promise，动作开始播放后 resolve
      */
-    startMotion(group: string, no: number, priority?: MotionPriority, startTime?: number): Promise<boolean>;
+    startMotion(group: string, no: number, priority?: number, startTime?: number): Promise<boolean>;
     /**
      * 播放指定表情
      * @param name - 表情名称或索引
@@ -94,13 +101,6 @@ export declare class Live2DViewer {
     expression(name: string | number): Promise<boolean> | undefined;
     /** 等待当前动作播放结束 */
     waitForMotionFinish(): Promise<boolean>;
-    /**
-     * 启用动作循环播放模式
-     * 从第 startTime 秒开始循环播放，直到动画结束
-     * @param startTime - 循环开始时间（秒），默认为 2 秒
-     * @returns 停止循环的函数
-     */
-    loop(startTime?: number): () => void;
     /** 销毁实例，清理资源和监听器 */
     destroy(): void;
 }