@seayoo-web/pixi-live2d 0.0.1

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@seayoo-web/pixi-live2d",
+  "description": "pixi-live2d viewer",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "source": "./index.ts",
+  "types": "./types/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "types",
+    "docs",
+    "README.md"
+  ],
+  "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",
+    "@pixi/display": "6.5.2",
+    "@pixi/extensions": "6.5.2",
+    "@pixi/loaders": "6.5.2",
+    "@pixi/math": "6.5.2",
+    "@pixi/runner": "6.5.2",
+    "@pixi/settings": "6.5.2",
+    "@pixi/sprite": "6.5.2",
+    "@pixi/ticker": "6.5.2",
+    "@pixi/utils": "6.5.2",
+    "pixi-live2d-display": "^0.4.0",
+    "pixi.js": "6.5.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "@seayoo-web/tsconfig": "^1.0.6",
+    "@seayoo-web/utils": "^4.4.1"
+  },
+  "scripts": {
+    "build": "vite build && tsc --build --force --emitDeclarationOnly",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint ./**/*.ts",
+    "lint:fix": "eslint ./**/*.ts --fix",
+    "prepublish": "pnpm lint:fix && pnpm build",
+    "test": "vitest --dom",
+    "coverage": "vitest run --coverage"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,85 @@
+import { InternalModel, Live2DModel } from "pixi-live2d-display/cubism4";
+import * as PIXI from "pixi.js";
+declare global {
+    interface Window {
+        PIXI?: typeof PIXI;
+    }
+}
+/** Live2D 查看器配置项 */
+export interface Live2DViewerOptions {
+    /** 模型配置文件 (.json) 的路径 */
+    modelPath: string;
+    /** 是否监听窗口 resize 事件并自动调整模型大小，默认为 true */
+    autoResize?: boolean;
+    /** 模型初始缩放比例 */
+    scale?: number;
+    /** 模型初始 X 轴偏移 */
+    x?: number;
+    /** 模型初始 Y 轴偏移 */
+    y?: number;
+    /** 设计稿宽度，用于适配计算（默认 1920） */
+    designWidth?: number;
+    /** 设计稿高度，用于适配计算（默认 1080） */
+    designHeight?: number;
+    /** Cubism Core 库的加载 URL */
+    cubismCoreUrl?: string;
+    /** 模型加载完成后的回调函数 */
+    onModelLoaded?: (model: Live2DModel<InternalModel>) => void;
+    /** 模型加载失败的回调函数 */
+    onModelError?: (error: Error) => void;
+}
+export declare class Live2DViewer {
+    /** 引擎加载状态 Promise，用于确保全局只加载一次 Core 库 */
+    private static coreLoadingPromise;
+    /**
+     * 加载 Live2D Cubism Core 引擎
+     * @param url - Core 库的 URL 地址
+     */
+    static loadCubismCore(url?: string): Promise<void>;
+    /** PIXI 应用实例 */
+    app: PIXI.Application;
+    /** Live2D 模型实例 */
+    model: Live2DModel<InternalModel> | null;
+    /** 配置项副本 */
+    private options;
+    /**
+     * 创建 Live2D 查看器实例
+     * @param canvas - 用于渲染的 Canvas 元素或其 ID
+     * @param options - 配置项
+     */
+    constructor(canvas: HTMLCanvasElement | string, options: Live2DViewerOptions);
+    /** 初始化模型 */
+    private init;
+    /** 设置点击交互 */
+    private setupInteraction;
+    /** 窗口大小改变的处理函数 */
+    private handleResize;
+    /** 重新计算布局和缩放 */
+    resize(): void;
+    /**
+     * 设置模型缩放比例并刷新布局
+     * @param scale - 缩放比例
+     */
+    setScale(scale: number): void;
+    /**
+     * 设置模型坐标并刷新布局
+     * @param x - X 轴偏移
+     * @param y - Y 轴偏移
+     */
+    setXY(x: number, y: number): void;
+    /**
+     * 播放指定分组的动作
+     * @param group - 动作分组名称
+     * @param no - 动作编号
+     */
+    startMotion(group: string, no: number): Promise<boolean> | undefined;
+    /**
+     * 播放指定表情
+     * @param name - 表情名称或索引
+     */
+    expression(name: string | number): Promise<boolean> | undefined;
+    /** 等待当前动作播放结束 */
+    waitForMotionFinish(): Promise<boolean>;
+    /** 销毁实例，清理资源和监听器 */
+    destroy(): void;
+}