sa2kit 1.3.0 → 1.4.1

package/dist/mmd/index.d.mts

@@ -1,5 +1,5 @@
-import { e as MMDPlayerBaseProps, f as MMDPlayerBaseRef, g as MMDPlayerEnhancedProps, h as MMDPlaylistProps, b as MMDPlaylistNode } from '../types-Bc_p-zAR.mjs';
-export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, d as MMDResources, i as MMDStage, j as MobileOptimization, R as ResourceOption } from '../types-Bc_p-zAR.mjs';
+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-Bc_p-zAR.mjs';
+export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, R as ResourceOption } from '../types-Bc_p-zAR.mjs';
 import React__default from 'react';
 import 'three';
 
@@ -63,4 +63,266 @@ declare global {
  */
 declare const loadAmmo: (path?: string) => Promise<any>;
 
-export { MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, loadAmmo };
+/**
+ * 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;
+}
+/** 视觉小说播放节点 */
+interface VisualNovelNode {
+    /** 唯一标识 */
+    id: string;
+    /** 节点名称（用于调试） */
+    name?: string;
+    /** MMD 资源配置（模型、动作等） */
+    resources: MMDResources;
+    /** 该节点的对话数组（按顺序播放） */
+    dialogues: DialogueLine[];
+    /** 节点开始时播放的背景音乐（可选） */
+    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;
+    /** 初始节点索引（默认 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;
+    /** 是否显示控制按钮 */
+    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) => void;
+    /** 跳转到指定对话 */
+    goToDialogue: (dialogueIndex: number) => void;
+    /** 获取当前节点索引 */
+    getCurrentNodeIndex: () => number;
+    /** 获取当前对话索引 */
+    getCurrentDialogueIndex: () => number;
+    /** 获取对话历史 */
+    getHistory: () => DialogueHistoryItem[];
+    /** 设置自动播放模式 */
+    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;
+    /** 点击开始回调 */
+    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;
+    /** 点击开始回调 */
+    onStart?: () => void;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * StartScreen - 开始界面组件
+ *
+ * 用于 MMD Visual Novel 的开始界面显示
+ */
+declare const StartScreen: React__default.FC<StartScreenProps>;
+
+export { DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, StartScreen, type StartScreenProps, type VisualNovelNode, type VisualNovelScript, loadAmmo };

package/dist/mmd/index.d.ts

@@ -1,5 +1,5 @@
-import { e as MMDPlayerBaseProps, f as MMDPlayerBaseRef, g as MMDPlayerEnhancedProps, h as MMDPlaylistProps, b as MMDPlaylistNode } from '../types-Bc_p-zAR.js';
-export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, d as MMDResources, i as MMDStage, j as MobileOptimization, R as ResourceOption } from '../types-Bc_p-zAR.js';
+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-Bc_p-zAR.js';
+export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, R as ResourceOption } from '../types-Bc_p-zAR.js';
 import React__default from 'react';
 import 'three';
 
@@ -63,4 +63,266 @@ declare global {
  */
 declare const loadAmmo: (path?: string) => Promise<any>;
 
-export { MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, loadAmmo };
+/**
+ * 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;
+}
+/** 视觉小说播放节点 */
+interface VisualNovelNode {
+    /** 唯一标识 */
+    id: string;
+    /** 节点名称（用于调试） */
+    name?: string;
+    /** MMD 资源配置（模型、动作等） */
+    resources: MMDResources;
+    /** 该节点的对话数组（按顺序播放） */
+    dialogues: DialogueLine[];
+    /** 节点开始时播放的背景音乐（可选） */
+    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;
+    /** 初始节点索引（默认 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;
+    /** 是否显示控制按钮 */
+    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) => void;
+    /** 跳转到指定对话 */
+    goToDialogue: (dialogueIndex: number) => void;
+    /** 获取当前节点索引 */
+    getCurrentNodeIndex: () => number;
+    /** 获取当前对话索引 */
+    getCurrentDialogueIndex: () => number;
+    /** 获取对话历史 */
+    getHistory: () => DialogueHistoryItem[];
+    /** 设置自动播放模式 */
+    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;
+    /** 点击开始回调 */
+    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;
+    /** 点击开始回调 */
+    onStart?: () => void;
+    /** 自定义类名 */
+    className?: string;
+}
+/**
+ * StartScreen - 开始界面组件
+ *
+ * 用于 MMD Visual Novel 的开始界面显示
+ */
+declare const StartScreen: React__default.FC<StartScreenProps>;
+
+export { DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, MMDPlayerBase, MMDPlayerBaseProps, MMDPlayerBaseRef, MMDPlayerEnhanced, MMDPlayerEnhancedDebugInfo, MMDPlayerEnhancedProps, MMDPlaylist, MMDPlaylistDebugInfo, MMDPlaylistNode, MMDPlaylistProps, MMDResources, MMDStage, MMDVisualNovel, type MMDVisualNovelProps, type MMDVisualNovelRef, MobileOptimization, StartScreen, type StartScreenProps, type VisualNovelNode, type VisualNovelScript, loadAmmo };