sa2kit 1.6.9 → 1.6.11

package/dist/mmd/index.d.mts

@@ -0,0 +1,1412 @@
+import { e as MMDPlayerBaseProps, f as MMDPlayerBaseRef, g as MMDPlayerEnhancedProps, h as MMDPlaylistProps, b as MMDPlaylistNode, d as MMDResources, i as MMDStage, j as MobileOptimization } from '../types-BB-7_WtE.mjs';
+export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, O as OutlineOptions, R as ResourceOption } from '../types-BB-7_WtE.mjs';
+import React__default from 'react';
+import * as THREE from 'three';
+
+declare const MMDPlayerBase: React__default.ForwardRefExoticComponent<MMDPlayerBaseProps & React__default.RefAttributes<MMDPlayerBaseRef>>;
+
+declare const MMDPlayerEnhanced: React__default.FC<MMDPlayerEnhancedProps>;
+
+/**
+ * MMDPlaylist - 播放列表管理器
+ *
+ * 核心功能：
+ * - 管理多个播放节点
+ * - 实现无缝切换（通过 key 变化触发组件重新挂载）
+ * - 预加载策略 (none / next / all)
+ * - 智能内存回收
+ * - 播放列表 UI
+ */
+declare const MMDPlaylist: React__default.FC<MMDPlaylistProps>;
+
+interface MMDPlayerEnhancedDebugInfoProps {
+    isPlaying: boolean;
+    isLooping: boolean;
+    isFullscreen: boolean;
+    showAxes: boolean;
+    isLoading: boolean;
+    currentResourceId?: string;
+    currentResourceName?: string;
+    mode: 'single' | 'list' | 'options';
+    totalResources: number;
+}
+declare const MMDPlayerEnhancedDebugInfo: React__default.FC<MMDPlayerEnhancedDebugInfoProps>;
+
+interface MMDPlaylistDebugInfoProps {
+    playlistName: string;
+    currentIndex: number;
+    currentNode: MMDPlaylistNode;
+    totalNodes: number;
+    isPlaying: boolean;
+    isListLooping: boolean;
+    isNodeLooping: boolean;
+    preloadStrategy: 'none' | 'next' | 'all';
+    isLoading: boolean;
+    isFullscreen: boolean;
+    showAxes: boolean;
+    preloadedNodes: number[];
+}
+declare const MMDPlaylistDebugInfo: React__default.FC<MMDPlaylistDebugInfoProps>;
+
+/**
+ * Ammo.js 加载器
+ * 用于异步加载 Ammo.js 物理引擎 (WASM 版本)
+ */
+declare global {
+    interface Window {
+        Ammo: any;
+    }
+}
+/**
+ * 加载 Ammo.js
+ * @param path Ammo.js (WASM wrapper) 的路径，默认为 '/libs/ammo.wasm.js'
+ */
+declare const loadAmmo: (path?: string) => Promise<any>;
+
+/**
+ * MMD Visual Novel (Galgame 风格) 类型定义
+ */
+
+/** 单条对话/文案 */
+interface DialogueLine {
+    /** 唯一标识 */
+    id: string;
+    /** 说话者名称（可选，不填则不显示名称栏） */
+    speaker?: string;
+    /** 说话者名称颜色 */
+    speakerColor?: string;
+    /** 对话文本内容 */
+    text: string;
+    /** 文字显示速度（毫秒/字符），默认 50 */
+    typeSpeed?: number;
+    /** 是否等待用户点击才显示下一条（默认 true） */
+    waitForClick?: boolean;
+    /** 自动等待时间（毫秒），仅在 waitForClick 为 false 时生效 */
+    autoDelay?: number;
+    /** 对话时的表情/动作切换（可选） */
+    expression?: string;
+    /** 对话时播放的音效（可选） */
+    voicePath?: string;
+    /** 对话中插入的分支选项（可选，若有则显示选项） */
+    choices?: DialogueChoice[];
+    /** 视觉特效（可选） */
+    effect?: VisualEffect;
+}
+/** 视觉特效配置 */
+interface VisualEffect {
+    /** 特效类型 */
+    type: 'flash' | 'gif' | 'shake';
+    /** 闪屏颜色，如 'white', 'red' */
+    color?: string;
+    /** 持续时间（毫秒） */
+    duration?: number;
+    /** GIF 动画地址 */
+    url?: string;
+    /** GIF 显示位置 */
+    position?: 'center' | 'full';
+}
+/** 分支判定逻辑 */
+interface BranchCondition {
+    /** 变量名 */
+    key: string;
+    /** 变量值与节点索引的映射 */
+    map: Record<string | number, number>;
+    /** 默认跳转的节点索引 */
+    defaultIndex: number;
+}
+/** 对话分支选项 */
+interface DialogueChoice {
+    /** 选项文字 */
+    text: string;
+    /** 跳转到的节点索引（可选，若不填则继续当前剧情） */
+    nextNodeIndex?: number;
+    /** 跳转到的对话索引（可选，默认 0） */
+    nextDialogueIndex?: number;
+    /** 设置变量（可选，用于后续剧情判定） */
+    setVariable?: {
+        key: string;
+        value: string | number | boolean;
+    };
+    /** 选项点击后的回调（可选） */
+    onSelect?: () => void;
+    /** 点击选项后触发的特效（可选） */
+    effect?: VisualEffect;
+}
+/** 视觉小说播放节点 */
+interface VisualNovelNode {
+    /** 唯一标识 */
+    id: string;
+    /** 节点名称（用于调试） */
+    name?: string;
+    /** MMD 资源配置（模型、动作等） */
+    resources: MMDResources;
+    /** 该节点的对话数组（按顺序播放） */
+    dialogues: DialogueLine[];
+    /** 节点特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
+    /** 节点结束时的分支选项（可选，已废弃，建议使用 DialogueLine.choices） */
+    choices?: DialogueChoice[];
+    /** 节点结束时的分支判定逻辑（可选，根据变量跳转不同节点） */
+    nextCondition?: BranchCondition;
+    /** 节点开始时播放的背景音乐（可选） */
+    bgmPath?: string;
+    /** 背景音乐音量 0-1（默认 0.5） */
+    bgmVolume?: number;
+    /** 节点是否循环 MMD 动画（对话期间循环，默认 true） */
+    loopAnimation?: boolean;
+}
+/** 视觉小说剧本配置 */
+interface VisualNovelScript {
+    /** 剧本唯一标识 */
+    id: string;
+    /** 剧本名称 */
+    name: string;
+    /** 播放节点列表 */
+    nodes: VisualNovelNode[];
+    /** 是否在剧本结束后循环（默认 false） */
+    loop?: boolean;
+}
+/** 对话框主题配置 */
+interface DialogueBoxTheme {
+    /** 对话框背景颜色 */
+    backgroundColor?: string;
+    /** 对话框边框颜色 */
+    borderColor?: string;
+    /** 对话框文字颜色 */
+    textColor?: string;
+    /** 说话者名称背景颜色 */
+    speakerBgColor?: string;
+    /** 说话者名称文字颜色 */
+    speakerTextColor?: string;
+    /** 对话框透明度 0-1（默认 0.85） */
+    opacity?: number;
+    /** 对话框模糊度（backdrop-blur，默认 8px） */
+    blur?: string;
+    /** 点击继续提示文字 */
+    continueHint?: string;
+    /** 是否显示点击继续提示（默认 true） */
+    showContinueHint?: boolean;
+}
+/** 视觉小说组件属性 */
+interface MMDVisualNovelProps {
+    /** 剧本配置 */
+    script: VisualNovelScript;
+    /** 舞台配置 */
+    stage?: MMDStage;
+    /** 移动端优化配置 */
+    mobileOptimization?: MobileOptimization;
+    /** 对话框主题 */
+    dialogueTheme?: DialogueBoxTheme;
+    /** 是否自动开始（默认 true） */
+    autoStart?: boolean;
+    /** 开始按钮文本 */
+    startText?: string;
+    /** 设置按钮文本 */
+    settingsText?: string;
+    /** 关于按钮文本 */
+    aboutText?: string;
+    /** 初始节点索引（默认 0） */
+    initialNodeIndex?: number;
+    /** 初始对话索引（默认 0） */
+    initialDialogueIndex?: number;
+    /** 事件回调 */
+    onNodeChange?: (node: VisualNovelNode, index: number) => void;
+    onDialogueChange?: (dialogue: DialogueLine, index: number, nodeIndex: number) => void;
+    onScriptComplete?: () => void;
+    onError?: (error: Error) => void;
+    /** 是否显示调试信息 */
+    showDebugInfo?: boolean;
+    /** 是否显示快进按钮 */
+    showSkipButton?: boolean;
+    /** 是否显示自动播放按钮 */
+    showAutoButton?: boolean;
+    /** 是否显示历史记录按钮 */
+    showHistoryButton?: boolean;
+    /** 样式 */
+    className?: string;
+    style?: React.CSSProperties;
+}
+/** 对话框组件属性 */
+interface DialogueBoxProps {
+    /** 当前对话 */
+    dialogue: DialogueLine | null;
+    /** 主题配置 */
+    theme?: DialogueBoxTheme;
+    /** 是否正在打字中 */
+    isTyping?: boolean;
+    /** 是否自动播放模式 */
+    isAutoMode?: boolean;
+    /** 点击事件 */
+    onClick?: () => void;
+    /** 跳过打字动画 */
+    onSkipTyping?: () => void;
+    /** 切换自动模式 */
+    onToggleAuto?: () => void;
+    /** 打开历史记录 */
+    onOpenHistory?: () => void;
+    /** 快进 */
+    onSkip?: () => void;
+    /** 重置相机 */
+    onResetCamera?: () => void;
+    /** 相机是否处于手动调整状态 */
+    isCameraManual?: boolean;
+    /** 是否显示控制按钮 */
+    showControls?: boolean;
+    /** 是否显示快进按钮 */
+    showSkipButton?: boolean;
+    /** 是否显示自动按钮 */
+    showAutoButton?: boolean;
+    /** 是否显示历史按钮 */
+    showHistoryButton?: boolean;
+    /** 样式 */
+    className?: string;
+}
+/** 历史记录项 */
+interface DialogueHistoryItem {
+    nodeIndex: number;
+    dialogueIndex: number;
+    speaker?: string;
+    text: string;
+    timestamp: number;
+}
+/** 视觉小说组件 Ref 接口 */
+interface MMDVisualNovelRef {
+    /** 跳转到指定节点 */
+    goToNode: (nodeIndex: number, force?: boolean) => void;
+    /** 跳转到指定对话 */
+    goToDialogue: (dialogueIndex: number) => void;
+    /** 获取当前节点索引 */
+    getCurrentNodeIndex: () => number;
+    /** 获取当前对话索引 */
+    getCurrentDialogueIndex: () => number;
+    /** 获取对话历史 */
+    getHistory: () => DialogueHistoryItem[];
+    /** 获取当前剧情变量 */
+    getVariables: () => Record<string, string | number | boolean>;
+    /** 设置剧情变量 */
+    setVariable: (key: string, value: string | number | boolean) => void;
+    /** 设置自动播放模式 */
+    setAutoMode: (enabled: boolean) => void;
+    /** 跳过当前打字动画 */
+    skipTyping: () => void;
+}
+
+/**
+ * MMDVisualNovel - Galgame 风格视觉小说组件
+ *
+ * 核心功能：
+ * - 将 MMDPlaylist 封装为 Galgame 风格
+ * - 每个节点包含：模型、动作、对话数组
+ * - 用户阅读完对话后自动切换节点
+ * - 打字机效果显示文本
+ * - 支持自动播放、快进、历史记录
+ */
+declare const MMDVisualNovel: React__default.ForwardRefExoticComponent<MMDVisualNovelProps & React__default.RefAttributes<MMDVisualNovelRef>>;
+
+/**
+ * DialogueBox - Galgame 风格对话框组件
+ *
+ * 功能：
+ * - 打字机效果显示文本
+ * - 说话者名称栏
+ * - 点击继续提示
+ * - 控制按钮（自动、快进、历史）
+ */
+declare const DialogueBox: React__default.FC<DialogueBoxProps>;
+
+interface HistoryPanelProps {
+    /** 历史记录列表 */
+    history: DialogueHistoryItem[];
+    /** 主题配置 */
+    theme?: DialogueBoxTheme;
+    /** 关闭面板 */
+    onClose: () => void;
+    /** 样式 */
+    className?: string;
+}
+/**
+ * HistoryPanel - 对话历史记录面板
+ *
+ * 显示玩家已经阅读过的所有对话
+ */
+declare const HistoryPanel: React__default.FC<HistoryPanelProps>;
+
+interface LoadingOverlayProps {
+    /** 是否显示加载状态 */
+    isLoading?: boolean;
+    /** 是否显示开始界面 */
+    showStartScreen?: boolean;
+    /** 脚本名称（用于开始界面） */
+    scriptName?: string;
+    /** 加载文本 */
+    loadingText?: string;
+    /** 开始按钮文本 */
+    startText?: string;
+    /** 设置按钮文本 */
+    settingsText?: string;
+    /** 关于按钮文本 */
+    aboutText?: string;
+    /** 点击开始回调 */
+    onStart?: () => void;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * LoadingOverlay - 加载遮罩和开始界面组件容器
+ *
+ * 用于 MMD Visual Novel 的加载状态和开始界面显示
+ * 组合了 LoadingScreen 和 StartScreen 两个独立组件
+ */
+declare const LoadingOverlay: React__default.FC<LoadingOverlayProps>;
+
+interface LoadingScreenProps {
+    /** 是否显示加载状态 */
+    isLoading?: boolean;
+    /** 加载文本 */
+    loadingText?: string;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * LoadingScreen - 加载界面组件
+ *
+ * 用于 MMD Visual Novel 的加载状态显示
+ */
+declare const LoadingScreen: React__default.FC<LoadingScreenProps>;
+
+interface StartScreenProps {
+    /** 是否显示开始界面 */
+    showStartScreen?: boolean;
+    /** 脚本名称 */
+    scriptName?: string;
+    /** 开始按钮文本 */
+    startText?: string;
+    /** 设置按钮文本 */
+    settingsText?: string;
+    /** 关于按钮文本 */
+    aboutText?: string;
+    /** 点击开始回调 */
+    onStart?: () => void;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * StartScreen - 开始界面组件
+ *
+ * 用于 MMD Visual Novel 的开始界面显示
+ */
+declare const StartScreen: React__default.FC<StartScreenProps>;
+
+interface ChoiceMenuProps {
+    choices: DialogueChoice[];
+    onSelect: (choice: DialogueChoice) => void;
+    theme?: DialogueBoxTheme;
+}
+declare const ChoiceMenu: React__default.FC<ChoiceMenuProps>;
+
+/** 音乐曲目配置 */
+interface MusicTrack {
+    /** 唯一标识 */
+    id: string;
+    /** 歌曲名称 */
+    title: string;
+    /** 艺术家/歌手 */
+    artist?: string;
+    /** 封面图 URL */
+    coverUrl?: string;
+    /** MMD 资源（模型、动作、音频等） */
+    resources: MMDResources;
+    /** 曲目特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
+    /** 预计时长（秒） */
+    duration?: number;
+}
+/** 音乐播放器配置 */
+interface MMDMusicPlayerConfig {
+    /** 播放列表名称 */
+    name: string;
+    /** 曲目列表 */
+    tracks: MusicTrack[];
+    /** 是否自动播放 */
+    autoPlay?: boolean;
+    /** 默认循环模式 */
+    defaultLoopMode?: 'list' | 'single' | 'shuffle';
+}
+/** 音乐播放器组件属性 */
+interface MMDMusicPlayerProps {
+    /** 播放配置 */
+    config: MMDMusicPlayerConfig;
+    /** 舞台配置 */
+    stage?: MMDStage;
+    /** 移动端优化配置 */
+    mobileOptimization?: MobileOptimization;
+    /** 初始曲目索引 */
+    initialTrackIndex?: number;
+    /**
+     * 固定资源配置
+     * 如果提供，所有曲目将使用这些指定的模型和动作，仅切换音频
+     */
+    fixedResources?: {
+        modelPath: string;
+        motionPath?: string;
+        stageModelPath?: string | string[];
+        cameraPath?: string;
+    };
+    /** 是否开启 Miku 搜索模式 */
+    mikuMode?: boolean;
+    /** 事件回调 */
+    onTrackChange?: (track: MusicTrack, index: number) => void;
+    onPlayPause?: (isPlaying: boolean) => void;
+    onProgress?: (currentTime: number, duration: number) => void;
+    onError?: (error: Error) => void;
+    /** 样式 */
+    className?: string;
+    style?: React.CSSProperties;
+}
+/** 音乐播放器 Ref 接口 */
+interface MMDMusicPlayerRef {
+    /** 播放 */
+    play: () => void;
+    /** 暂停 */
+    pause: () => void;
+    /** 跳转到下一曲 */
+    next: () => void;
+    /** 跳转到上一曲 */
+    previous: () => void;
+    /** 跳转到指定曲目 */
+    goToTrack: (index: number) => void;
+    /** 设置循环模式 */
+    setLoopMode: (mode: 'list' | 'single' | 'shuffle') => void;
+    /** 获取当前状态 */
+    getState: () => {
+        currentIndex: number;
+        isPlaying: boolean;
+        currentTime: number;
+        duration: number;
+        loopMode: 'list' | 'single' | 'shuffle';
+    };
+}
+
+/**
+ * MMDMusicPlayer - MMD 音乐播放器组件 (Study with Miku 风格)
+ *
+ * 核心功能：
+ * - 多曲目无缝切换
+ * - 完整的媒体控制 (播放/暂停/进度/音量)
+ * - 沉浸式 3D 舞台
+ * - 自动清理内存与物理引擎
+ */
+declare const MMDMusicPlayer: React__default.ForwardRefExoticComponent<MMDMusicPlayerProps & React__default.RefAttributes<MMDMusicPlayerRef>>;
+
+interface MusicControlsProps {
+    isPlaying: boolean;
+    currentTime: number;
+    duration: number;
+    loopMode: 'list' | 'single' | 'shuffle';
+    isCameraManual?: boolean;
+    onPlayPause: () => void;
+    onNext: () => void;
+    onPrevious: () => void;
+    onSeek: (time: number) => void;
+    onToggleLoop: () => void;
+    onTogglePlaylist: () => void;
+    onResetCamera?: () => void;
+    className?: string;
+}
+declare const MusicControls: React__default.FC<MusicControlsProps>;
+
+interface PlaylistPanelProps {
+    tracks: MusicTrack[];
+    currentIndex: number;
+    isOpen: boolean;
+    onClose: () => void;
+    onSelectTrack: (index: number) => void;
+    className?: string;
+    mikuMode?: boolean;
+    onSearch?: (keyword: string) => void;
+    isSearching?: boolean;
+}
+declare const PlaylistPanel: React__default.FC<PlaylistPanelProps>;
+
+interface TrackInfoProps {
+    track: MusicTrack;
+    className?: string;
+}
+declare const TrackInfo: React__default.FC<TrackInfoProps>;
+
+interface MMDARPlayerProps {
+    /** MMD 资源配置 */
+    resources: MMDResources;
+    /** 舞台配置 */
+    stage?: MMDStage;
+    /** 移动端优化配置 */
+    mobileOptimization?: MobileOptimization;
+    /** 摄像头配置 */
+    cameraConfig?: {
+        /** 偏好使用的摄像头 ('user' 为前置, 'environment' 为后置) */
+        facingMode?: 'user' | 'environment';
+        /** 视频分辨率 */
+        width?: number | {
+            min?: number;
+            ideal?: number;
+            max?: number;
+        };
+        height?: number | {
+            min?: number;
+            ideal?: number;
+            max?: number;
+        };
+    };
+    /** 是否开启镜像显示 (通常前置摄像头需要开启) */
+    mirrored?: boolean;
+    /** 是否显示设置按钮 (允许手动输入模型和动作路径) */
+    showSettings?: boolean;
+    /** 播放控制 */
+    autoPlay?: boolean;
+    loop?: boolean;
+    /** 事件回调 */
+    onCameraReady?: (stream: MediaStream) => void;
+    onCameraError?: (error: Error) => void;
+    onResourcesChange?: (resources: MMDResources) => void;
+    onLoad?: () => void;
+    onError?: (error: Error) => void;
+    /** 样式 */
+    className?: string;
+    style?: React.CSSProperties;
+}
+interface MMDARPlayerRef {
+    /** 开启摄像头 */
+    startCamera: () => Promise<void>;
+    /** 关闭摄像头 */
+    stopCamera: () => void;
+    /** 切换摄像头 */
+    switchCamera: () => Promise<void>;
+    /** 截图 (包含视频背景和模型) */
+    snapshot: () => Promise<string>;
+}
+
+/**
+ * MMDARPlayer - 基于实时摄像头的 MMD 增强现实播放器
+ *
+ * 功能：
+ * - 调用设备摄像头作为背景
+ * - 叠加透明背景的 MMD 模型渲染
+ * - 支持前后摄像头切换
+ * - 针对 AR 场景优化模型光照与定位
+ */
+declare const MMDARPlayer: React__default.ForwardRefExoticComponent<MMDARPlayerProps & React__default.RefAttributes<MMDARPlayerRef>>;
+
+/**
+ * FX文件解析器类型定义
+ * 用于解析MME (MikuMikuEffect) 的.fx效果文件
+ */
+/**
+ * FX文件解析结果
+ */
+interface FXEffect {
+    /** 文件名 */
+    fileName: string;
+    /** 原始内容 */
+    rawContent: string;
+    /** 宏定义 */
+    defines: FXDefine[];
+    /** 参数声明 */
+    parameters: FXParameter[];
+    /** 静态变量 */
+    staticVariables: FXStaticVariable[];
+    /** 纹理引用 */
+    textures: FXTexture[];
+    /** 控制器引用 */
+    controllers: FXController[];
+    /** 包含文件 */
+    includes: string[];
+    /** Technique定义 */
+    techniques: FXTechnique[];
+    /** 着色器函数 */
+    shaderFunctions: FXShaderFunction[];
+    /** 注释块 */
+    comments: FXComment[];
+    /** 转换后的GLSL shaders（可选） */
+    glslShaders?: GLSLShaders;
+}
+/**
+ * 宏定义
+ */
+interface FXDefine {
+    /** 宏名称 */
+    name: string;
+    /** 宏值 */
+    value?: string;
+    /** 是否被注释掉 */
+    isCommented: boolean;
+    /** 行号 */
+    lineNumber: number;
+    /** 注释说明 */
+    comment?: string;
+}
+/**
+ * 参数声明
+ */
+interface FXParameter {
+    /** 参数类型 (float, float2, float3, float4, texture, etc.) */
+    type: string;
+    /** 参数名称 */
+    name: string;
+    /** 语义 (POSITION, TEXCOORD, DIFFUSE, etc.) */
+    semantic?: string;
+    /** 默认值 */
+    defaultValue?: string;
+    /** 注解 (annotations) */
+    annotations?: Record<string, any>;
+    /** 行号 */
+    lineNumber: number;
+    /** 注释说明 */
+    comment?: string;
+}
+/**
+ * 静态变量
+ */
+interface FXStaticVariable {
+    /** 变量类型 */
+    type: string;
+    /** 变量名称 */
+    name: string;
+    /** 初始化表达式 */
+    expression: string;
+    /** 行号 */
+    lineNumber: number;
+}
+/**
+ * 纹理引用
+ */
+interface FXTexture {
+    /** 纹理名称 */
+    name: string;
+    /** 纹理路径 */
+    path: string;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+    /** 纹理用途 (diffuse, normal, shadow, etc.) */
+    purpose?: string;
+}
+/**
+ * 控制器引用
+ */
+interface FXController {
+    /** 控制器名称 */
+    name: string;
+    /** 控制器对象 */
+    objectName: string;
+    /** 控制项 */
+    itemName: string;
+    /** 绑定到的参数 */
+    boundParameter: string;
+}
+/**
+ * Technique定义
+ */
+interface FXTechnique {
+    /** Technique名称 */
+    name: string;
+    /** Pass列表 */
+    passes: FXPass[];
+    /** 行号 */
+    lineNumber: number;
+}
+/**
+ * Pass定义
+ */
+interface FXPass {
+    /** Pass名称 */
+    name?: string;
+    /** 顶点着色器 */
+    vertexShader?: {
+        profile: string;
+        function: string;
+    };
+    /** 像素着色器 */
+    pixelShader?: {
+        profile: string;
+        function: string;
+    };
+    /** 渲染状态 */
+    renderStates: Record<string, any>;
+}
+/**
+ * 着色器函数
+ */
+interface FXShaderFunction {
+    /** 函数名 */
+    name: string;
+    /** 返回类型 */
+    returnType: string;
+    /** 参数列表 */
+    parameters: string;
+    /** 函数体 */
+    body: string;
+    /** 输出语义 */
+    outputSemantic?: string;
+    /** 行号 */
+    lineNumber: number;
+}
+/**
+ * 注释块
+ */
+interface FXComment {
+    /** 注释内容 */
+    content: string;
+    /** 注释类型 (line: 单行注释 //, block: 块注释) */
+    type: 'line' | 'block';
+    /** 行号 */
+    lineNumber: number;
+}
+/**
+ * 转换后的GLSL shaders
+ */
+interface GLSLShaders {
+    /** 顶点着色器 */
+    vertexShader?: GLSLShader;
+    /** 片段着色器 */
+    fragmentShader?: GLSLShader;
+    /** 转换警告 */
+    warnings: string[];
+}
+/**
+ * GLSL shader信息
+ */
+interface GLSLShader {
+    /** 转换后的GLSL代码 */
+    code: string;
+    /** Uniforms */
+    uniforms: Map<string, {
+        type: string;
+        glslType: string;
+        semantic?: string;
+    }>;
+    /** Attributes（仅顶点着色器） */
+    attributes: Map<string, {
+        type: string;
+        glslType: string;
+        semantic: string;
+    }>;
+    /** Varyings */
+    varyings: Map<string, {
+        type: string;
+        glslType: string;
+    }>;
+}
+/**
+ * FX解析配置
+ */
+interface FXParserOptions {
+    /** 是否保留注释 */
+    keepComments?: boolean;
+    /** 是否解析Technique */
+    parseTechniques?: boolean;
+    /** 是否解析着色器函数 */
+    parseShaderFunctions?: boolean;
+    /** 是否解析纹理引用 */
+    parseTextures?: boolean;
+    /** 是否解析控制器引用 */
+    parseControllers?: boolean;
+    /** 是否转换HLSL到GLSL */
+    convertToGLSL?: boolean;
+    /** 顶点着色器函数名（用于GLSL转换） */
+    vertexShaderFunction?: string;
+    /** 片段着色器函数名（用于GLSL转换） */
+    fragmentShaderFunction?: string;
+}
+/**
+ * FX文件摘要信息（用于快速预览）
+ */
+interface FXSummary {
+    fileName: string;
+    defineCount: number;
+    parameterCount: number;
+    textureCount: number;
+    techniqueCount: number;
+    hasLocalShadow: boolean;
+    hasExcellentShadow: boolean;
+    hasHgShadow: boolean;
+    enabledDefines: string[];
+    disabledDefines: string[];
+}
+
+/**
+ * FX文件解析器
+ * 用于解析MME (MikuMikuEffect) 的.fx效果文件
+ */
+
+declare class FXParser {
+    private options;
+    private hlslConverter;
+    constructor(options?: FXParserOptions);
+    /**
+     * 从URL加载并解析FX文件
+     */
+    loadAndParse(url: string): Promise<FXEffect>;
+    /**
+     * 解析FX文件内容
+     */
+    parse(content: string, fileName?: string): FXEffect;
+    /**
+     * 转换shader到GLSL
+     */
+    private convertShadersToGLSL;
+    /**
+     * 解析宏定义 (#define)
+     */
+    private parseDefines;
+    /**
+     * 解析参数声明
+     */
+    private parseParameters;
+    /**
+     * 解析注解 (annotations)
+     */
+    private parseAnnotations;
+    /**
+     * 解析静态变量
+     */
+    private parseStaticVariables;
+    /**
+     * 解析纹理引用
+     */
+    private parseTextures;
+    /**
+     * 解析控制器引用 (CONTROLOBJECT)
+     */
+    private parseControllers;
+    /**
+     * 解析include指令
+     */
+    private parseIncludes;
+    /**
+     * 解析Technique定义
+     */
+    private parseTechniques;
+    /**
+     * 解析Pass定义
+     */
+    private parsePasses;
+    /**
+     * 解析着色器函数
+     */
+    private parseShaderFunctions;
+    /**
+     * 解析注释
+     */
+    private parseComments;
+    /**
+     * 生成FX文件摘要
+     */
+    generateSummary(effect: FXEffect): FXSummary;
+    /**
+     * 提取特定着色器函数的代码
+     */
+    extractShaderFunction(effect: FXEffect, functionName: string): string | null;
+    /**
+     * 获取所有启用的功能标志
+     */
+    getEnabledFeatures(effect: FXEffect): string[];
+    /**
+     * 获取配置参数
+     */
+    getConfigParameters(effect: FXEffect): FXParameter[];
+}
+
+/**
+ * FX到Three.js适配器
+ * 将解析的FX文件参数应用到Three.js渲染中
+ */
+
+/**
+ * Three.js材质配置
+ */
+interface ThreeMaterialConfig {
+    /** 基础颜色 */
+    color?: THREE.Color;
+    /** 发光颜色 */
+    emissive?: THREE.Color;
+    /** 高光颜色 */
+    specular?: THREE.Color;
+    /** 光泽度 */
+    shininess?: number;
+    /** 透明度 */
+    opacity?: number;
+    /** 是否透明 */
+    transparent?: boolean;
+    /** 纹理贴图 */
+    map?: THREE.Texture | null;
+    /** 法线贴图 */
+    normalMap?: THREE.Texture | null;
+    /** 环境贴图 */
+    envMap?: THREE.Texture | null;
+    /** 自定义uniforms */
+    uniforms?: Record<string, {
+        value: any;
+    }>;
+}
+/**
+ * Three.js渲染配置
+ */
+interface ThreeRenderConfig {
+    /** 是否启用阴影 */
+    enableShadow?: boolean;
+    /** 阴影贴图尺寸 */
+    shadowMapSize?: number;
+    /** 环境光强度 */
+    ambientLightIntensity?: number;
+    /** 方向光强度 */
+    directionalLightIntensity?: number;
+    /** 方向光方向 */
+    lightDirection?: THREE.Vector3;
+    /** 色调映射 */
+    toneMapping?: THREE.ToneMapping;
+    /** 曝光度 */
+    toneMappingExposure?: number;
+}
+/**
+ * FX到Three.js适配器
+ */
+declare class FXToThreeAdapter {
+    private effect;
+    private textureLoader;
+    private loadedTextures;
+    private basePath;
+    constructor(effect: FXEffect, basePath?: string);
+    /**
+     * 创建ShaderMaterial（如果有GLSL shader）
+     */
+    createShaderMaterial(): THREE.ShaderMaterial | null;
+    /**
+     * 获取uniform的默认值
+     */
+    private getDefaultUniformValue;
+    /**
+     * 提取材质配置
+     */
+    extractMaterialConfig(): ThreeMaterialConfig;
+    /**
+     * 提取渲染配置
+     */
+    extractRenderConfig(): ThreeRenderConfig;
+    /**
+     * 加载纹理
+     */
+    loadTextures(): Promise<Map<string, THREE.Texture>>;
+    /**
+     * 加载单个纹理
+     */
+    private loadTexture;
+    /**
+     * 创建Three.js材质
+     */
+    createMaterial(): THREE.MeshPhongMaterial;
+    /**
+     * 配置Three.js场景
+     * 仅应用渲染器配置，不添加光源
+     */
+    configureScene(scene: THREE.Scene, renderer: THREE.WebGLRenderer): void;
+    /**
+     * 获取指定用途的纹理
+     */
+    private getTextureByPurpose;
+    /**
+     * 解析float3值
+     */
+    private parseFloat3;
+    /**
+     * 解析float值
+     */
+    private parseFloat;
+    /**
+     * 解析参数值
+     */
+    private parseParameterValue;
+    /**
+     * 获取所有自定义uniforms
+     */
+    getUniforms(): Record<string, {
+        value: any;
+    }>;
+    /**
+     * 生成配置摘要
+     */
+    getSummary(): {
+        materialParams: string[];
+        textures: string[];
+        renderFeatures: string[];
+    };
+}
+
+/**
+ * HLSL到GLSL转换器
+ * 将MME的HLSL shader代码转换为Three.js可用的GLSL代码
+ */
+interface ConversionResult {
+    /** 转换后的GLSL代码 */
+    glslCode: string;
+    /** 检测到的uniforms */
+    uniforms: Map<string, UniformInfo>;
+    /** 检测到的attributes */
+    attributes: Map<string, AttributeInfo>;
+    /** 检测到的varyings */
+    varyings: Map<string, VaryingInfo>;
+    /** 转换警告 */
+    warnings: string[];
+}
+interface UniformInfo {
+    type: string;
+    glslType: string;
+    semantic?: string;
+}
+interface AttributeInfo {
+    type: string;
+    glslType: string;
+    semantic: string;
+}
+interface VaryingInfo {
+    type: string;
+    glslType: string;
+}
+declare class HLSLToGLSLConverter {
+    private warnings;
+    private uniforms;
+    private attributes;
+    private varyings;
+    /**
+     * HLSL类型到GLSL类型的映射
+     */
+    private typeMap;
+    /**
+     * HLSL函数到GLSL函数的映射
+     */
+    private functionMap;
+    /**
+     * HLSL语义到GLSL的映射
+     */
+    private semanticMap;
+    /**
+     * 转换HLSL shader代码为GLSL
+     */
+    convert(hlslCode: string, shaderType: 'vertex' | 'fragment'): ConversionResult;
+    /**
+     * 预处理代码
+     */
+    private preprocessCode;
+    /**
+     * 转换类型声明
+     */
+    private convertTypes;
+    /**
+     * 转换函数调用
+     */
+    private convertFunctions;
+    /**
+     * 转换mul()函数
+     * HLSL: mul(matrix, vector) 或 mul(vector, matrix)
+     * GLSL: matrix * vector 或 vector * matrix
+     */
+    private convertMulFunction;
+    /**
+     * 转换语义
+     */
+    private convertSemantics;
+    /**
+     * 转换输入/输出结构
+     */
+    private convertIOStructs;
+    /**
+     * 解析结构体成员
+     */
+    private parseStructMembers;
+    /**
+     * 添加GLSL头部和辅助函数
+     */
+    private addGLSLHeader;
+    /**
+     * 修复语法差异
+     */
+    private fixSyntaxDifferences;
+    /**
+     * 从FX效果中提取并转换shader
+     */
+    convertFromFXEffect(effect: any, vertexShaderName: string, fragmentShaderName: string): {
+        vertexShader: ConversionResult;
+        fragmentShader: ConversionResult;
+    } | null;
+}
+
+/**
+ * 多FX文件适配器
+ * 支持同时应用多个FX效果文件
+ */
+
+/**
+ * 效果文件类型
+ */
+type EffectFileType = 'fx' | 'x' | 'auto';
+/**
+ * FX文件配置
+ */
+interface FXFileConfig {
+    /** FX/X文件路径 */
+    path: string;
+    /** 纹理基础路径 */
+    texturePath?: string;
+    /** 文件类型 */
+    type?: EffectFileType;
+    /**
+     * 优先级 (数字越大优先级越高，默认0)
+     * - .x文件建议设置为低优先级（如-10），作为基础效果
+     * - .fx文件建议设置为高优先级（如10），作为细节效果
+     */
+    priority?: number;
+    /**
+     * 应用目标
+     * - 'all': 应用到所有对象
+     * - 'model': 仅应用到模型
+     * - 'stage': 仅应用到舞台
+     * - 'scene': 仅应用场景配置（光照、阴影等）
+     * - string[]: 应用到指定名称的对象
+     */
+    target?: 'all' | 'model' | 'stage' | 'scene' | string[];
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 描述（用于调试） */
+    description?: string;
+    /** 是否转换为GLSL并使用ShaderMaterial */
+    useShaderMaterial?: boolean;
+    /** 顶点着色器函数名（用于GLSL转换） */
+    vertexShaderFunction?: string;
+    /** 片段着色器函数名（用于GLSL转换） */
+    fragmentShaderFunction?: string;
+}
+/**
+ * 多FX合并策略
+ */
+type FXMergeStrategy = 'override' | 'merge' | 'additive';
+/**
+ * 多FX适配器配置
+ */
+interface MultiFXAdapterOptions {
+    /** 合并策略 */
+    mergeStrategy?: FXMergeStrategy;
+    /** 是否自动加载纹理 */
+    autoLoadTextures?: boolean;
+}
+/**
+ * 多FX文件适配器
+ * 支持同时加载和应用多个FX效果文件
+ */
+declare class MultiFXAdapter {
+    private effects;
+    private adapters;
+    private configs;
+    private options;
+    private parser;
+    constructor(options?: MultiFXAdapterOptions);
+    /**
+     * 识别文件类型
+     */
+    private detectFileType;
+    /**
+     * 添加效果文件（支持.fx和.x）
+     */
+    addFX(config: FXFileConfig): Promise<void>;
+    /**
+     * 批量添加FX文件
+     */
+    addMultipleFX(configs: FXFileConfig[]): Promise<void>;
+    /**
+     * 移除FX文件
+     */
+    removeFX(path: string): void;
+    /**
+     * 清空所有FX
+     */
+    clear(): void;
+    /**
+     * 合并材质配置
+     */
+    extractMergedMaterialConfig(target?: string): ThreeMaterialConfig;
+    /**
+     * 合并渲染配置
+     */
+    extractMergedRenderConfig(): ThreeRenderConfig;
+    /**
+     * 应用到Three.js材质
+     * 支持MeshPhongMaterial和MeshToonMaterial（MMD常用）
+     */
+    applyToMaterial(material: THREE.Material, target?: string): void;
+    /**
+     * 创建ShaderMaterial（如果配置了useShaderMaterial）
+     * 返回第一个匹配target的ShaderMaterial，如果没有则返回null
+     */
+    createShaderMaterial(target?: string): THREE.ShaderMaterial | null;
+    /**
+     * 应用到Three.js场景
+     */
+    applyToScene(scene: THREE.Scene, renderer: THREE.WebGLRenderer): void;
+    /**
+     * 获取所有已加载的FX效果
+     */
+    getLoadedEffects(): FXEffect[];
+    /**
+     * 获取配置摘要
+     */
+    getSummary(): {
+        totalFX: number;
+        enabledFX: number;
+        xFiles: number;
+        fxFiles: number;
+        configs: Array<{
+            path: string;
+            type: EffectFileType;
+            priority: number;
+            target: string | string[];
+            features: string[];
+            description?: string;
+        }>;
+    };
+    /**
+     * 获取指定类型的配置
+     */
+    getConfigsByType(type: EffectFileType): FXFileConfig[];
+    /**
+     * 获取场景级效果（.x文件）
+     */
+    getSceneEffects(): FXFileConfig[];
+    /**
+     * 获取模型级效果（.fx文件）
+     */
+    getModelEffects(): FXFileConfig[];
+    /**
+     * 获取合并后的Uniforms
+     */
+    getMergedUniforms(target?: string): Record<string, {
+        value: any;
+    }>;
+    /**
+     * 分层应用到场景对象
+     * @param scene Three.js场景
+     * @param renderer Three.js渲染器
+     * @param modelMeshes 模型网格数组（可选，用于精确控制）
+     * @param stageMeshes 舞台网格数组（可选，用于精确控制）
+     */
+    applyLayered(scene: THREE.Scene, renderer: THREE.WebGLRenderer, modelMeshes?: THREE.Object3D[], stageMeshes?: THREE.Object3D[]): void;
+    /**
+     * 打印当前配置（调试用）
+     */
+    printConfig(): void;
+}
+
+/**
+ * FX解析器工具函数
+ */
+
+/**
+ * 将FX效果导出为JSON
+ */
+declare function exportFXToJSON(effect: FXEffect): string;
+/**
+ * 将FX效果导出为Markdown文档
+ */
+declare function exportFXToMarkdown(effect: FXEffect): string;
+/**
+ * 比较两个FX文件的差异
+ */
+declare function compareFXEffects(effect1: FXEffect, effect2: FXEffect): {
+    addedDefines: string[];
+    removedDefines: string[];
+    changedDefines: {
+        name: string;
+        oldValue?: string;
+        newValue?: string;
+    }[];
+    addedTextures: string[];
+    removedTextures: string[];
+    addedParameters: string[];
+    removedParameters: string[];
+};
+/**
+ * 过滤特定类型的宏定义
+ */
+declare function filterDefinesByPrefix(defines: FXDefine[], prefix: string): FXDefine[];
+/**
+ * 获取所有纹理宏定义
+ */
+declare function getTextureDefines(defines: FXDefine[]): FXDefine[];
+/**
+ * 获取所有功能标志
+ */
+declare function getFeatureFlags(defines: FXDefine[]): FXDefine[];
+/**
+ * 获取所有颜色相关的参数
+ */
+declare function getColorParameters(parameters: FXParameter[]): FXParameter[];
+/**
+ * 检查是否包含特定功能
+ */
+declare function hasFeature(effect: FXEffect, featureName: string): boolean;
+/**
+ * 获取配置摘要文本
+ */
+declare function getConfigSummaryText(effect: FXEffect): string;
+/**
+ * 提取纹理文件路径列表（用于预加载）
+ */
+declare function extractTexturePaths(effect: FXEffect): string[];
+/**
+ * 验证FX文件的完整性
+ */
+declare function validateFXEffect(effect: FXEffect): {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+
+/**
+ * FX文件查看器组件
+ * 用于可视化展示FX文件的解析结果
+ */
+
+interface FXViewerProps {
+    /** FX文件URL或内容 */
+    source: string;
+    /** 是否是文件内容（true）还是URL（false） */
+    isContent?: boolean;
+    /** 文件名 */
+    fileName?: string;
+    /** 解析完成回调 */
+    onParsed?: (effect: FXEffect) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+    /** 自定义样式 */
+    className?: string;
+}
+declare const FXViewer: React__default.FC<FXViewerProps>;
+
+/**
+ * FX效果Three.js预览组件
+ * 展示如何将FX解析结果应用到Three.js渲染中
+ */
+
+interface FXThreePreviewProps {
+    /** FX效果 */
+    effect: FXEffect;
+    /** 纹理基础路径 */
+    texturePath?: string;
+    /** 预览对象类型 */
+    objectType?: 'sphere' | 'box' | 'torus' | 'plane';
+    /** 自定义样式 */
+    className?: string;
+    /** 是否显示信息面板 */
+    showInfo?: boolean;
+}
+declare const FXThreePreview: React__default.FC<FXThreePreviewProps>;
+
+export { type BranchCondition, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, type EffectFileType, type FXComment, type FXController, type FXDefine, type FXEffect, type FXFileConfig, type FXMergeStrategy, type FXParameter, FXParser, type FXParserOptions, type FXPass, type FXShaderFunction, type FXStaticVariable, type FXSummary, type FXTechnique, type FXTexture, FXThreePreview, type FXThreePreviewProps, FXToThreeAdapter, FXViewer, type FXViewerProps, type GLSLShader, type GLSLShaders, HLSLToGLSLConverter, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, MMDARPlayer, type MMDARPlayerProps, type MMDARPlayerRef, MMDMusicPlayer, type MMDMusicPlayerConfig, type MMDMusicPlayerProps, type MMDMusicPlayerRef, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, MultiFXAdapter, type MultiFXAdapterOptions, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, type ThreeMaterialConfig, type ThreeRenderConfig, TrackInfo, type TrackInfoProps, type VisualEffect, type VisualNovelNode, type VisualNovelScript, compareFXEffects, exportFXToJSON, exportFXToMarkdown, extractTexturePaths, filterDefinesByPrefix, getColorParameters, getConfigSummaryText, getFeatureFlags, getTextureDefines, hasFeature, loadAmmo, validateFXEffect };