sa2kit 3.1.0 → 3.2.0

package/dist/types-HorDyIRv.d.mts

@@ -1,303 +0,0 @@
-import { Vector3 } from 'three';
-
-/** MMD 资源配置 */
-interface MMDResources {
-    /** 模型文件路径 (.pmx/.pmd) */
-    modelPath: string;
-    /** 动作文件路径 (.vmd) - 可选 */
-    motionPath?: string;
-    /** 相机动画路径 (.vmd) - 可选 */
-    cameraPath?: string;
-    /** 音频文件路径 - 可选 */
-    audioPath?: string;
-    /** 舞台/场景模型路径 (.pmx/.x) - 可选 */
-    stageModelPath?: string | string[];
-    /** 舞台/场景动作路径 (.vmd) - 可选 */
-    stageMotionPath?: string;
-    /** 附加动作文件 - 可选 */
-    additionalMotions?: string[];
-}
-/** 资源列表项 - 用于预设切换 */
-interface MMDResourceItem {
-    id: string;
-    name: string;
-    resources: MMDResources;
-    thumbnail?: string;
-    description?: string;
-}
-/** 资源选项 - 用于自由组合 */
-interface ResourceOption {
-    id: string;
-    name: string;
-    path: string;
-    thumbnail?: string;
-}
-interface MMDResourceOptions {
-    models: ResourceOption[];
-    motions: ResourceOption[];
-    cameras?: ResourceOption[];
-    audios?: ResourceOption[];
-    stages?: ResourceOption[];
-}
-/** 舞台/场景配置 */
-interface MMDStage {
-    /** 背景颜色 */
-    backgroundColor?: string;
-    /** 背景图片 URL */
-    backgroundImage?: string;
-    /** 是否启用物理模拟 (默认 true) */
-    enablePhysics?: boolean;
-    /** 物理引擎路径 (ammo.wasm.js 的路径) */
-    physicsPath?: string;
-    /** 是否启用阴影 (默认 true) */
-    enableShadow?: boolean;
-    /** 环境光强度 (默认 0.5) */
-    ambientLightIntensity?: number;
-    /** 方向光强度 (默认 0.8) */
-    directionalLightIntensity?: number;
-    /** 方向光位置 (默认 { x: 0, y: 10, z: 0 }) */
-    directionalLightPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 半球光强度 (默认关闭，设置值以启用) */
-    hemisphereLightIntensity?: number;
-    /** 半球光天空颜色 (默认 0xffffff) */
-    hemisphereLightSkyColor?: string | number;
-    /** 半球光地面颜色 (默认 0x444444) */
-    hemisphereLightGroundColor?: string | number;
-    /** 侧面补光强度 (默认关闭，设置值以启用) */
-    sideLightIntensity?: number;
-    /** 侧面补光位置 (默认 { x: -3, y: 8, z: 8 }) */
-    sideLightPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 色调映射类型 (默认 'ACESFilmic') */
-    toneMapping?: 'None' | 'Linear' | 'Reinhard' | 'Cineon' | 'ACESFilmic';
-    /** 色调映射曝光度 (默认 1.0) */
-    toneMappingExposure?: number;
-    /** 相机初始位置 */
-    cameraPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 相机目标点 */
-    cameraTarget?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 渲染特效模式 (默认 'default') */
-    renderEffect?: 'default' | 'outline';
-    /** 描边效果配置 */
-    outlineOptions?: OutlineOptions;
-    /** 材质自发光强度 (默认 0) */
-    emissiveIntensity?: number;
-    /** 颜色亮度系数 (默认 1.0) */
-    colorBrightness?: number;
-    /** 颜色饱和度系数 (默认 1.0) */
-    colorSaturation?: number;
-    /** 高光强度 Shininess (默认 30) */
-    shininess?: number;
-    /** 高光颜色强度 (默认 0.5) */
-    specularIntensity?: number;
-    /** 反射率 (默认 0.5) */
-    reflectivity?: number;
-    /** 金属度 PBR (默认 0) */
-    metalness?: number;
-    /** 粗糙度 PBR (默认 0.8) */
-    roughness?: number;
-    /** 环境光遮蔽强度 (默认 1.0) */
-    aoMapIntensity?: number;
-    /** 边缘光强度 (默认 0) */
-    rimLightIntensity?: number;
-    /** 边缘光颜色 (默认 '#ffffff') */
-    rimLightColor?: string;
-    /** 模型是否接收阴影 (默认 true) */
-    modelReceiveShadow?: boolean;
-    /** 阴影偏移 (默认 -0.0001) */
-    shadowBias?: number;
-    /**
-     * FX效果文件路径 (.fx文件，MME格式)
-     * 注意：
-     * - .fx 文件用于模型级效果（应用到人物模型）
-     * - .x 文件用于场景级渲染（渲染整个环境，包括模型）
-     * 如需同时使用多个效果，请使用 fxConfigs
-     */
-    fxPath?: string;
-    /** FX纹理基础路径 */
-    fxTexturePath?: string;
-    /**
-     * 多个FX效果配置（高级用法）
-     * 支持同时应用多个.fx和.x文件
-     */
-    fxConfigs?: Array<{
-        path: string;
-        texturePath?: string;
-        type?: 'fx' | 'x' | 'auto';
-        priority?: number;
-        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
-        description?: string;
-    }>;
-}
-/** 移动端优化配置 */
-interface MobileOptimization {
-    /** 是否启用优化 (默认 true) */
-    enabled: boolean;
-    /** 像素比 (默认 1.0, 桌面端通常为 window.devicePixelRatio) */
-    pixelRatio?: number;
-    /** 是否强制关闭物理引擎 (默认 false) */
-    disablePhysics?: boolean;
-    /** 是否降低阴影质量 (默认 true) */
-    reduceShadowQuality?: boolean;
-}
-/** 描边效果配置 */
-interface OutlineOptions {
-    /** 是否启用描边 (默认 false) */
-    enabled?: boolean;
-    /** 描边粗细 (默认 0.003) */
-    thickness?: number;
-    /** 描边颜色 (默认 '#000000') */
-    color?: string;
-}
-/** MMDPlayerBase Ref 接口 */
-interface MMDPlayerBaseRef {
-    /** 开始播放 */
-    play: () => void;
-    /** 暂停播放 */
-    pause: () => void;
-    /** 停止播放 (重置到开头) */
-    stop: () => void;
-    /** 跳转到指定时间 (秒) */
-    seek: (time: number) => void;
-    /** 获取当前播放时间 */
-    getCurrentTime: () => number;
-    /** 获取总时长 */
-    getDuration: () => number;
-    /** 获取播放状态 */
-    isPlaying: () => boolean;
-    /** 截图并返回 Base64 字符串 */
-    snapshot: () => string;
-    /** 重置相机到初始位置 */
-    resetCamera: () => void;
-}
-/** 基础播放器属性 */
-interface MMDPlayerBaseProps {
-    /** 资源配置 */
-    resources: MMDResources;
-    /** 舞台配置 */
-    stage?: MMDStage;
-    /** 移动端优化配置 */
-    mobileOptimization?: MobileOptimization;
-    /** 播放控制 */
-    autoPlay?: boolean;
-    loop?: boolean;
-    volume?: number;
-    muted?: boolean;
-    /** 调试与辅助 */
-    showAxes?: boolean;
-    /** 渲染特效配置 */
-    renderEffect?: 'default' | 'outline';
-    /** 描边效果配置 */
-    outlineOptions?: OutlineOptions;
-    /** FX效果文件路径 */
-    fxPath?: string;
-    /** FX纹理基础路径 */
-    fxTexturePath?: string;
-    /** 多个FX效果配置（高级用法） */
-    fxConfigs?: Array<{
-        path: string;
-        texturePath?: string;
-        type?: 'fx' | 'x' | 'auto';
-        priority?: number;
-        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
-        description?: string;
-    }>;
-    /** 事件回调 */
-    onLoad?: () => void;
-    onLoadProgress?: (progress: number, item: string) => void;
-    onError?: (error: Error) => void;
-    onPlay?: () => void;
-    onPause?: () => void;
-    onEnded?: () => void;
-    onTimeUpdate?: (time: number) => void;
-    onCameraChange?: (isManual: boolean) => void;
-    /** 样式 */
-    className?: string;
-    style?: React.CSSProperties;
-}
-/** 增强播放器属性 */
-interface MMDPlayerEnhancedProps extends Omit<MMDPlayerBaseProps, 'resources'> {
-    /** 单一资源模式 */
-    resources?: MMDResources;
-    /** 列表模式资源 */
-    resourcesList?: MMDResourceItem[];
-    /** 自由组合模式选项 */
-    resourceOptions?: MMDResourceOptions;
-    /** 列表模式下的默认 ID */
-    defaultResourceId?: string;
-    /** 自由组合模式下的默认选择 */
-    defaultSelection?: {
-        modelId?: string;
-        motionId?: string;
-        cameraId?: string;
-        audioId?: string;
-        stageId?: string;
-    };
-    /** 是否显示调试信息面板 */
-    showDebugInfo?: boolean;
-}
-/** 播放列表节点 */
-interface MMDPlaylistNode {
-    id: string;
-    name: string;
-    resources: MMDResources;
-    /** 节点特定的舞台配置（可选，覆盖全局配置） */
-    stage?: MMDStage;
-    /** 该节点是否循环播放 */
-    loop?: boolean;
-    /** 预计时长（秒）- 用于进度计算 */
-    duration?: number;
-    /** 缩略图 */
-    thumbnail?: string;
-}
-/** 播放列表配置 */
-interface MMDPlaylistConfig {
-    id: string;
-    name: string;
-    nodes: MMDPlaylistNode[];
-    /** 整个播放列表是否循环 */
-    loop?: boolean;
-    /** 预加载策略
-     * - 'none': 不预加载 (默认)
-     * - 'next': 预加载下一个节点
-     * - 'all': 预加载所有节点
-     */
-    preload?: 'none' | 'next' | 'all';
-    /** 是否自动播放 */
-    autoPlay?: boolean;
-}
-/** 播放列表组件属性 */
-interface MMDPlaylistProps {
-    /** 播放列表配置 */
-    playlist: MMDPlaylistConfig;
-    /** 舞台配置 */
-    stage?: MMDStage;
-    /** 移动端优化配置 */
-    mobileOptimization?: MobileOptimization;
-    /** 事件回调 */
-    onNodeChange?: (node: MMDPlaylistNode, index: number) => void;
-    onPlaylistComplete?: () => void;
-    onError?: (error: Error) => void;
-    /** 是否显示调试信息面板 */
-    showDebugInfo?: boolean;
-    /** 样式 */
-    className?: string;
-    style?: React.CSSProperties;
-}
-
-export type { MMDPlaylistConfig as M, OutlineOptions as O, ResourceOption as R, MMDResourceItem as a, MMDPlaylistNode as b, MMDResourceOptions as c, MMDResources as d, MMDPlayerBaseProps as e, MMDPlayerBaseRef as f, MMDPlayerEnhancedProps as g, MMDPlaylistProps as h, MMDStage as i, MobileOptimization as j };

package/dist/types-HorDyIRv.d.ts

@@ -1,303 +0,0 @@
-import { Vector3 } from 'three';
-
-/** MMD 资源配置 */
-interface MMDResources {
-    /** 模型文件路径 (.pmx/.pmd) */
-    modelPath: string;
-    /** 动作文件路径 (.vmd) - 可选 */
-    motionPath?: string;
-    /** 相机动画路径 (.vmd) - 可选 */
-    cameraPath?: string;
-    /** 音频文件路径 - 可选 */
-    audioPath?: string;
-    /** 舞台/场景模型路径 (.pmx/.x) - 可选 */
-    stageModelPath?: string | string[];
-    /** 舞台/场景动作路径 (.vmd) - 可选 */
-    stageMotionPath?: string;
-    /** 附加动作文件 - 可选 */
-    additionalMotions?: string[];
-}
-/** 资源列表项 - 用于预设切换 */
-interface MMDResourceItem {
-    id: string;
-    name: string;
-    resources: MMDResources;
-    thumbnail?: string;
-    description?: string;
-}
-/** 资源选项 - 用于自由组合 */
-interface ResourceOption {
-    id: string;
-    name: string;
-    path: string;
-    thumbnail?: string;
-}
-interface MMDResourceOptions {
-    models: ResourceOption[];
-    motions: ResourceOption[];
-    cameras?: ResourceOption[];
-    audios?: ResourceOption[];
-    stages?: ResourceOption[];
-}
-/** 舞台/场景配置 */
-interface MMDStage {
-    /** 背景颜色 */
-    backgroundColor?: string;
-    /** 背景图片 URL */
-    backgroundImage?: string;
-    /** 是否启用物理模拟 (默认 true) */
-    enablePhysics?: boolean;
-    /** 物理引擎路径 (ammo.wasm.js 的路径) */
-    physicsPath?: string;
-    /** 是否启用阴影 (默认 true) */
-    enableShadow?: boolean;
-    /** 环境光强度 (默认 0.5) */
-    ambientLightIntensity?: number;
-    /** 方向光强度 (默认 0.8) */
-    directionalLightIntensity?: number;
-    /** 方向光位置 (默认 { x: 0, y: 10, z: 0 }) */
-    directionalLightPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 半球光强度 (默认关闭，设置值以启用) */
-    hemisphereLightIntensity?: number;
-    /** 半球光天空颜色 (默认 0xffffff) */
-    hemisphereLightSkyColor?: string | number;
-    /** 半球光地面颜色 (默认 0x444444) */
-    hemisphereLightGroundColor?: string | number;
-    /** 侧面补光强度 (默认关闭，设置值以启用) */
-    sideLightIntensity?: number;
-    /** 侧面补光位置 (默认 { x: -3, y: 8, z: 8 }) */
-    sideLightPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 色调映射类型 (默认 'ACESFilmic') */
-    toneMapping?: 'None' | 'Linear' | 'Reinhard' | 'Cineon' | 'ACESFilmic';
-    /** 色调映射曝光度 (默认 1.0) */
-    toneMappingExposure?: number;
-    /** 相机初始位置 */
-    cameraPosition?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 相机目标点 */
-    cameraTarget?: {
-        x: number;
-        y: number;
-        z: number;
-    } | Vector3;
-    /** 渲染特效模式 (默认 'default') */
-    renderEffect?: 'default' | 'outline';
-    /** 描边效果配置 */
-    outlineOptions?: OutlineOptions;
-    /** 材质自发光强度 (默认 0) */
-    emissiveIntensity?: number;
-    /** 颜色亮度系数 (默认 1.0) */
-    colorBrightness?: number;
-    /** 颜色饱和度系数 (默认 1.0) */
-    colorSaturation?: number;
-    /** 高光强度 Shininess (默认 30) */
-    shininess?: number;
-    /** 高光颜色强度 (默认 0.5) */
-    specularIntensity?: number;
-    /** 反射率 (默认 0.5) */
-    reflectivity?: number;
-    /** 金属度 PBR (默认 0) */
-    metalness?: number;
-    /** 粗糙度 PBR (默认 0.8) */
-    roughness?: number;
-    /** 环境光遮蔽强度 (默认 1.0) */
-    aoMapIntensity?: number;
-    /** 边缘光强度 (默认 0) */
-    rimLightIntensity?: number;
-    /** 边缘光颜色 (默认 '#ffffff') */
-    rimLightColor?: string;
-    /** 模型是否接收阴影 (默认 true) */
-    modelReceiveShadow?: boolean;
-    /** 阴影偏移 (默认 -0.0001) */
-    shadowBias?: number;
-    /**
-     * FX效果文件路径 (.fx文件，MME格式)
-     * 注意：
-     * - .fx 文件用于模型级效果（应用到人物模型）
-     * - .x 文件用于场景级渲染（渲染整个环境，包括模型）
-     * 如需同时使用多个效果，请使用 fxConfigs
-     */
-    fxPath?: string;
-    /** FX纹理基础路径 */
-    fxTexturePath?: string;
-    /**
-     * 多个FX效果配置（高级用法）
-     * 支持同时应用多个.fx和.x文件
-     */
-    fxConfigs?: Array<{
-        path: string;
-        texturePath?: string;
-        type?: 'fx' | 'x' | 'auto';
-        priority?: number;
-        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
-        description?: string;
-    }>;
-}
-/** 移动端优化配置 */
-interface MobileOptimization {
-    /** 是否启用优化 (默认 true) */
-    enabled: boolean;
-    /** 像素比 (默认 1.0, 桌面端通常为 window.devicePixelRatio) */
-    pixelRatio?: number;
-    /** 是否强制关闭物理引擎 (默认 false) */
-    disablePhysics?: boolean;
-    /** 是否降低阴影质量 (默认 true) */
-    reduceShadowQuality?: boolean;
-}
-/** 描边效果配置 */
-interface OutlineOptions {
-    /** 是否启用描边 (默认 false) */
-    enabled?: boolean;
-    /** 描边粗细 (默认 0.003) */
-    thickness?: number;
-    /** 描边颜色 (默认 '#000000') */
-    color?: string;
-}
-/** MMDPlayerBase Ref 接口 */
-interface MMDPlayerBaseRef {
-    /** 开始播放 */
-    play: () => void;
-    /** 暂停播放 */
-    pause: () => void;
-    /** 停止播放 (重置到开头) */
-    stop: () => void;
-    /** 跳转到指定时间 (秒) */
-    seek: (time: number) => void;
-    /** 获取当前播放时间 */
-    getCurrentTime: () => number;
-    /** 获取总时长 */
-    getDuration: () => number;
-    /** 获取播放状态 */
-    isPlaying: () => boolean;
-    /** 截图并返回 Base64 字符串 */
-    snapshot: () => string;
-    /** 重置相机到初始位置 */
-    resetCamera: () => void;
-}
-/** 基础播放器属性 */
-interface MMDPlayerBaseProps {
-    /** 资源配置 */
-    resources: MMDResources;
-    /** 舞台配置 */
-    stage?: MMDStage;
-    /** 移动端优化配置 */
-    mobileOptimization?: MobileOptimization;
-    /** 播放控制 */
-    autoPlay?: boolean;
-    loop?: boolean;
-    volume?: number;
-    muted?: boolean;
-    /** 调试与辅助 */
-    showAxes?: boolean;
-    /** 渲染特效配置 */
-    renderEffect?: 'default' | 'outline';
-    /** 描边效果配置 */
-    outlineOptions?: OutlineOptions;
-    /** FX效果文件路径 */
-    fxPath?: string;
-    /** FX纹理基础路径 */
-    fxTexturePath?: string;
-    /** 多个FX效果配置（高级用法） */
-    fxConfigs?: Array<{
-        path: string;
-        texturePath?: string;
-        type?: 'fx' | 'x' | 'auto';
-        priority?: number;
-        target?: 'all' | 'model' | 'stage' | 'scene' | string[];
-        description?: string;
-    }>;
-    /** 事件回调 */
-    onLoad?: () => void;
-    onLoadProgress?: (progress: number, item: string) => void;
-    onError?: (error: Error) => void;
-    onPlay?: () => void;
-    onPause?: () => void;
-    onEnded?: () => void;
-    onTimeUpdate?: (time: number) => void;
-    onCameraChange?: (isManual: boolean) => void;
-    /** 样式 */
-    className?: string;
-    style?: React.CSSProperties;
-}
-/** 增强播放器属性 */
-interface MMDPlayerEnhancedProps extends Omit<MMDPlayerBaseProps, 'resources'> {
-    /** 单一资源模式 */
-    resources?: MMDResources;
-    /** 列表模式资源 */
-    resourcesList?: MMDResourceItem[];
-    /** 自由组合模式选项 */
-    resourceOptions?: MMDResourceOptions;
-    /** 列表模式下的默认 ID */
-    defaultResourceId?: string;
-    /** 自由组合模式下的默认选择 */
-    defaultSelection?: {
-        modelId?: string;
-        motionId?: string;
-        cameraId?: string;
-        audioId?: string;
-        stageId?: string;
-    };
-    /** 是否显示调试信息面板 */
-    showDebugInfo?: boolean;
-}
-/** 播放列表节点 */
-interface MMDPlaylistNode {
-    id: string;
-    name: string;
-    resources: MMDResources;
-    /** 节点特定的舞台配置（可选，覆盖全局配置） */
-    stage?: MMDStage;
-    /** 该节点是否循环播放 */
-    loop?: boolean;
-    /** 预计时长（秒）- 用于进度计算 */
-    duration?: number;
-    /** 缩略图 */
-    thumbnail?: string;
-}
-/** 播放列表配置 */
-interface MMDPlaylistConfig {
-    id: string;
-    name: string;
-    nodes: MMDPlaylistNode[];
-    /** 整个播放列表是否循环 */
-    loop?: boolean;
-    /** 预加载策略
-     * - 'none': 不预加载 (默认)
-     * - 'next': 预加载下一个节点
-     * - 'all': 预加载所有节点
-     */
-    preload?: 'none' | 'next' | 'all';
-    /** 是否自动播放 */
-    autoPlay?: boolean;
-}
-/** 播放列表组件属性 */
-interface MMDPlaylistProps {
-    /** 播放列表配置 */
-    playlist: MMDPlaylistConfig;
-    /** 舞台配置 */
-    stage?: MMDStage;
-    /** 移动端优化配置 */
-    mobileOptimization?: MobileOptimization;
-    /** 事件回调 */
-    onNodeChange?: (node: MMDPlaylistNode, index: number) => void;
-    onPlaylistComplete?: () => void;
-    onError?: (error: Error) => void;
-    /** 是否显示调试信息面板 */
-    showDebugInfo?: boolean;
-    /** 样式 */
-    className?: string;
-    style?: React.CSSProperties;
-}
-
-export type { MMDPlaylistConfig as M, OutlineOptions as O, ResourceOption as R, MMDResourceItem as a, MMDPlaylistNode as b, MMDResourceOptions as c, MMDResources as d, MMDPlayerBaseProps as e, MMDPlayerBaseRef as f, MMDPlayerEnhancedProps as g, MMDPlaylistProps as h, MMDStage as i, MobileOptimization as j };