sa2kit 1.5.1 → 1.6.1

package/dist/mmd/admin/index.d.mts

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { F as FileMetadata } from '../../types-CK4We_aI.mjs';
-import { M as MMDPlaylistConfig, a as MMDResourceItem, b as MMDPlaylistNode, c as MMDResourceOptions, d as MMDResources } from '../../types-Bc_p-zAR.mjs';
+import { M as MMDPlaylistConfig, a as MMDResourceItem, b as MMDPlaylistNode, c as MMDResourceOptions, d as MMDResources } from '../../types-CsTSddwu.mjs';
 export { M as MmdPlaylist, f as MmdPlaylistNode, j as MmdPresetItem, h as MmdResourceOption, N as NewMmdPlaylist, g as NewMmdPlaylistNode, k as NewMmdPresetItem, i as NewMmdResourceOption, a as mmdPlaylistNodes, e as mmdPlaylistNodesRelations, m as mmdPlaylists, d as mmdPlaylistsRelations, c as mmdPresetItems, b as mmdResourceOptions } from '../../drizzle-schema-BNhqj2AZ.mjs';
 import 'three';
 import 'drizzle-orm';

package/dist/mmd/admin/index.d.ts

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { F as FileMetadata } from '../../types-CK4We_aI.js';
-import { M as MMDPlaylistConfig, a as MMDResourceItem, b as MMDPlaylistNode, c as MMDResourceOptions, d as MMDResources } from '../../types-Bc_p-zAR.js';
+import { M as MMDPlaylistConfig, a as MMDResourceItem, b as MMDPlaylistNode, c as MMDResourceOptions, d as MMDResources } from '../../types-CsTSddwu.js';
 export { M as MmdPlaylist, f as MmdPlaylistNode, j as MmdPresetItem, h as MmdResourceOption, N as NewMmdPlaylist, g as NewMmdPlaylistNode, k as NewMmdPresetItem, i as NewMmdResourceOption, a as mmdPlaylistNodes, e as mmdPlaylistNodesRelations, m as mmdPlaylists, d as mmdPlaylistsRelations, c as mmdPresetItems, b as mmdResourceOptions } from '../../drizzle-schema-BNhqj2AZ.js';
 import 'three';
 import 'drizzle-orm';

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, 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 { 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-CsTSddwu.mjs';
+export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, R as ResourceOption } from '../types-CsTSddwu.mjs';
 import React__default from 'react';
 import 'three';
 
@@ -87,6 +87,33 @@ interface DialogueLine {
     expression?: string;
     /** 对话时播放的音效（可选） */
     voicePath?: string;
+    /** 对话中插入的分支选项（可选，若有则显示选项） */
+    choices?: DialogueChoice[];
+}
+/** 分支判定逻辑 */
+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;
 }
 /** 视觉小说播放节点 */
 interface VisualNovelNode {
@@ -98,6 +125,12 @@ interface VisualNovelNode {
     resources: MMDResources;
     /** 该节点的对话数组（按顺序播放） */
     dialogues: DialogueLine[];
+    /** 节点特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
+    /** 节点结束时的分支选项（可选，已废弃，建议使用 DialogueLine.choices） */
+    choices?: DialogueChoice[];
+    /** 节点结束时的分支判定逻辑（可选，根据变量跳转不同节点） */
+    nextCondition?: BranchCondition;
     /** 节点开始时播放的背景音乐（可选） */
     bgmPath?: string;
     /** 背景音乐音量 0-1（默认 0.5） */
@@ -190,6 +223,10 @@ interface DialogueBoxProps {
     onOpenHistory?: () => void;
     /** 快进 */
     onSkip?: () => void;
+    /** 重置相机 */
+    onResetCamera?: () => void;
+    /** 相机是否处于手动调整状态 */
+    isCameraManual?: boolean;
     /** 是否显示控制按钮 */
     showControls?: boolean;
     /** 是否显示快进按钮 */
@@ -221,6 +258,10 @@ interface MMDVisualNovelRef {
     getCurrentDialogueIndex: () => number;
     /** 获取对话历史 */
     getHistory: () => DialogueHistoryItem[];
+    /** 获取当前剧情变量 */
+    getVariables: () => Record<string, string | number | boolean>;
+    /** 设置剧情变量 */
+    setVariable: (key: string, value: string | number | boolean) => void;
     /** 设置自动播放模式 */
     setAutoMode: (enabled: boolean) => void;
     /** 跳过当前打字动画 */
@@ -325,6 +366,13 @@ interface StartScreenProps {
  */
 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 {
     /** 唯一标识 */
@@ -337,6 +385,8 @@ interface MusicTrack {
     coverUrl?: string;
     /** MMD 资源（模型、动作、音频等） */
     resources: MMDResources;
+    /** 曲目特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
     /** 预计时长（秒） */
     duration?: number;
 }
@@ -410,12 +460,14 @@ interface MusicControlsProps {
     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>;
@@ -436,4 +488,4 @@ interface TrackInfoProps {
 }
 declare const TrackInfo: React__default.FC<TrackInfoProps>;
 
-export { DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, 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, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, TrackInfo, type TrackInfoProps, type VisualNovelNode, type VisualNovelScript, loadAmmo };
+export { type BranchCondition, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, 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, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, TrackInfo, type TrackInfoProps, 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, 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 { 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-CsTSddwu.js';
+export { M as MMDPlaylistConfig, a as MMDResourceItem, c as MMDResourceOptions, R as ResourceOption } from '../types-CsTSddwu.js';
 import React__default from 'react';
 import 'three';
 
@@ -87,6 +87,33 @@ interface DialogueLine {
     expression?: string;
     /** 对话时播放的音效（可选） */
     voicePath?: string;
+    /** 对话中插入的分支选项（可选，若有则显示选项） */
+    choices?: DialogueChoice[];
+}
+/** 分支判定逻辑 */
+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;
 }
 /** 视觉小说播放节点 */
 interface VisualNovelNode {
@@ -98,6 +125,12 @@ interface VisualNovelNode {
     resources: MMDResources;
     /** 该节点的对话数组（按顺序播放） */
     dialogues: DialogueLine[];
+    /** 节点特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
+    /** 节点结束时的分支选项（可选，已废弃，建议使用 DialogueLine.choices） */
+    choices?: DialogueChoice[];
+    /** 节点结束时的分支判定逻辑（可选，根据变量跳转不同节点） */
+    nextCondition?: BranchCondition;
     /** 节点开始时播放的背景音乐（可选） */
     bgmPath?: string;
     /** 背景音乐音量 0-1（默认 0.5） */
@@ -190,6 +223,10 @@ interface DialogueBoxProps {
     onOpenHistory?: () => void;
     /** 快进 */
     onSkip?: () => void;
+    /** 重置相机 */
+    onResetCamera?: () => void;
+    /** 相机是否处于手动调整状态 */
+    isCameraManual?: boolean;
     /** 是否显示控制按钮 */
     showControls?: boolean;
     /** 是否显示快进按钮 */
@@ -221,6 +258,10 @@ interface MMDVisualNovelRef {
     getCurrentDialogueIndex: () => number;
     /** 获取对话历史 */
     getHistory: () => DialogueHistoryItem[];
+    /** 获取当前剧情变量 */
+    getVariables: () => Record<string, string | number | boolean>;
+    /** 设置剧情变量 */
+    setVariable: (key: string, value: string | number | boolean) => void;
     /** 设置自动播放模式 */
     setAutoMode: (enabled: boolean) => void;
     /** 跳过当前打字动画 */
@@ -325,6 +366,13 @@ interface StartScreenProps {
  */
 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 {
     /** 唯一标识 */
@@ -337,6 +385,8 @@ interface MusicTrack {
     coverUrl?: string;
     /** MMD 资源（模型、动作、音频等） */
     resources: MMDResources;
+    /** 曲目特定的舞台配置（可选，覆盖全局配置） */
+    stage?: MMDStage;
     /** 预计时长（秒） */
     duration?: number;
 }
@@ -410,12 +460,14 @@ interface MusicControlsProps {
     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>;
@@ -436,4 +488,4 @@ interface TrackInfoProps {
 }
 declare const TrackInfo: React__default.FC<TrackInfoProps>;
 
-export { DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, 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, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, TrackInfo, type TrackInfoProps, type VisualNovelNode, type VisualNovelScript, loadAmmo };
+export { type BranchCondition, ChoiceMenu, type ChoiceMenuProps, DialogueBox, type DialogueBoxProps, type DialogueBoxTheme, type DialogueChoice, type DialogueHistoryItem, type DialogueLine, HistoryPanel, LoadingOverlay, type LoadingOverlayProps, LoadingScreen, type LoadingScreenProps, 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, MusicControls, type MusicControlsProps, type MusicTrack, PlaylistPanel, type PlaylistPanelProps, StartScreen, type StartScreenProps, TrackInfo, type TrackInfoProps, type VisualNovelNode, type VisualNovelScript, loadAmmo };