sa2kit 1.6.0 → 1.6.1

package/dist/mmd/index.d.mts

@@ -87,15 +87,31 @@ 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;
+    /** 跳转到的节点索引（可选，若不填则继续当前剧情） */
+    nextNodeIndex?: number;
     /** 跳转到的对话索引（可选，默认 0） */
     nextDialogueIndex?: number;
+    /** 设置变量（可选，用于后续剧情判定） */
+    setVariable?: {
+        key: string;
+        value: string | number | boolean;
+    };
     /** 选项点击后的回调（可选） */
     onSelect?: () => void;
 }
@@ -111,8 +127,10 @@ interface VisualNovelNode {
     dialogues: DialogueLine[];
     /** 节点特定的舞台配置（可选，覆盖全局配置） */
     stage?: MMDStage;
-    /** 节点结束时的分支选项（可选，若有则显示选项，不自动跳转） */
+    /** 节点结束时的分支选项（可选，已废弃，建议使用 DialogueLine.choices） */
     choices?: DialogueChoice[];
+    /** 节点结束时的分支判定逻辑（可选，根据变量跳转不同节点） */
+    nextCondition?: BranchCondition;
     /** 节点开始时播放的背景音乐（可选） */
     bgmPath?: string;
     /** 背景音乐音量 0-1（默认 0.5） */
@@ -240,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;
     /** 跳过当前打字动画 */
@@ -344,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 {
     /** 唯一标识 */
@@ -459,4 +488,4 @@ interface TrackInfoProps {
 }
 declare const TrackInfo: React__default.FC<TrackInfoProps>;
 
-export { 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 };
+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

@@ -87,15 +87,31 @@ 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;
+    /** 跳转到的节点索引（可选，若不填则继续当前剧情） */
+    nextNodeIndex?: number;
     /** 跳转到的对话索引（可选，默认 0） */
     nextDialogueIndex?: number;
+    /** 设置变量（可选，用于后续剧情判定） */
+    setVariable?: {
+        key: string;
+        value: string | number | boolean;
+    };
     /** 选项点击后的回调（可选） */
     onSelect?: () => void;
 }
@@ -111,8 +127,10 @@ interface VisualNovelNode {
     dialogues: DialogueLine[];
     /** 节点特定的舞台配置（可选，覆盖全局配置） */
     stage?: MMDStage;
-    /** 节点结束时的分支选项（可选，若有则显示选项，不自动跳转） */
+    /** 节点结束时的分支选项（可选，已废弃，建议使用 DialogueLine.choices） */
     choices?: DialogueChoice[];
+    /** 节点结束时的分支判定逻辑（可选，根据变量跳转不同节点） */
+    nextCondition?: BranchCondition;
     /** 节点开始时播放的背景音乐（可选） */
     bgmPath?: string;
     /** 背景音乐音量 0-1（默认 0.5） */
@@ -240,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;
     /** 跳过当前打字动画 */
@@ -344,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 {
     /** 唯一标识 */
@@ -459,4 +488,4 @@ interface TrackInfoProps {
 }
 declare const TrackInfo: React__default.FC<TrackInfoProps>;
 
-export { 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 };
+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.js

@@ -2852,6 +2852,7 @@ var MMDVisualNovel = React6.forwardRef(
     const [pendingNodeIndex, setPendingNodeIndex] = React6.useState(null);
     const [showChoices, setShowChoices] = React6.useState(false);
     const [isCameraManual, setIsCameraManual] = React6.useState(false);
+    const [variables, setVariables] = React6.useState({});
     const playerRef = React6.useRef(null);
     const containerRef = React6.useRef(null);
     const autoTimerRef = React6.useRef(null);
@@ -2873,32 +2874,6 @@ var MMDVisualNovel = React6.forwardRef(
         }
       ]);
     }, []);
-    const goToNextDialogue = React6.useCallback(() => {
-      if (!currentNode) return;
-      if (autoTimerRef.current) {
-        clearTimeout(autoTimerRef.current);
-        autoTimerRef.current = null;
-      }
-      const nextDialogueIndex = currentDialogueIndex + 1;
-      if (nextDialogueIndex < currentNode.dialogues.length && currentNode?.dialogues[nextDialogueIndex] !== void 0) {
-        const nextDialogue = currentNode.dialogues[nextDialogueIndex];
-        setCurrentDialogueIndex(nextDialogueIndex);
-        addToHistory(nextDialogue, currentNodeIndex, nextDialogueIndex);
-        onDialogueChange?.(nextDialogue, nextDialogueIndex, currentNodeIndex);
-        typingCompleteRef.current = false;
-      } else if (currentNode.choices && currentNode.choices.length > 0) {
-        setShowChoices(true);
-      } else {
-        const nextNodeIndex = currentNodeIndex + 1;
-        if (nextNodeIndex < nodes.length) {
-          goToNode(nextNodeIndex);
-        } else if (loop) {
-          goToNode(0);
-        } else {
-          onScriptComplete?.();
-        }
-      }
-    }, [currentNode, currentDialogueIndex, currentNodeIndex, nodes.length, loop, addToHistory, onDialogueChange, onScriptComplete]);
     const goToNode = React6.useCallback(
       (nodeIndex, force = false) => {
         if (nodeIndex < 0 || nodeIndex >= nodes.length) return;
@@ -2937,8 +2912,52 @@ var MMDVisualNovel = React6.forwardRef(
           }, 100);
         }, 300);
       },
-      [nodes, isTransitioning, addToHistory, onNodeChange, onDialogueChange, currentNodeIndex, isVmdFinished]
+      [nodes, isTransitioning, addToHistory, onNodeChange, onDialogueChange, currentNodeIndex]
     );
+    const triggerNodeTransition = React6.useCallback(() => {
+      if (!currentNode) return;
+      let nextNodeIndex = currentNodeIndex + 1;
+      if (currentNode.nextCondition) {
+        const { key, map, defaultIndex } = currentNode.nextCondition;
+        const val = variables[key];
+        if (val !== void 0 && map[val] !== void 0) {
+          nextNodeIndex = map[val];
+          console.log(`[MMDVisualNovel] Branching: ${key}=${val} -> node ${nextNodeIndex}`);
+        } else {
+          nextNodeIndex = defaultIndex;
+        }
+      }
+      if (nextNodeIndex < nodes.length && nextNodeIndex >= 0) {
+        goToNode(nextNodeIndex);
+      } else if (loop) {
+        goToNode(0);
+      } else {
+        onScriptComplete?.();
+      }
+    }, [currentNode, currentNodeIndex, nodes.length, loop, variables, goToNode, onScriptComplete]);
+    const goToNextDialogue = React6.useCallback(() => {
+      if (!currentNode) return;
+      if (currentDialogue?.choices && currentDialogue.choices.length > 0 && !showChoices) {
+        setShowChoices(true);
+        return;
+      }
+      if (autoTimerRef.current) {
+        clearTimeout(autoTimerRef.current);
+        autoTimerRef.current = null;
+      }
+      const nextDialogueIndex = currentDialogueIndex + 1;
+      if (nextDialogueIndex < currentNode.dialogues.length && currentNode?.dialogues[nextDialogueIndex] !== void 0) {
+        const nextDialogue = currentNode.dialogues[nextDialogueIndex];
+        setCurrentDialogueIndex(nextDialogueIndex);
+        addToHistory(nextDialogue, currentNodeIndex, nextDialogueIndex);
+        onDialogueChange?.(nextDialogue, nextDialogueIndex, currentNodeIndex);
+        typingCompleteRef.current = false;
+      } else if (currentNode.choices && currentNode.choices.length > 0) {
+        setShowChoices(true);
+      } else {
+        triggerNodeTransition();
+      }
+    }, [currentNode, currentDialogue, currentDialogueIndex, currentNodeIndex, nodes.length, loop, addToHistory, onDialogueChange, onScriptComplete, showChoices, variables, goToNode, triggerNodeTransition]);
     const goToDialogue = React6.useCallback(
       (dialogueIndex) => {
         if (!currentNode) return;
@@ -3017,6 +3036,10 @@ var MMDVisualNovel = React6.forwardRef(
         getCurrentNodeIndex: () => currentNodeIndex,
         getCurrentDialogueIndex: () => currentDialogueIndex,
         getHistory: () => history,
+        getVariables: () => variables,
+        setVariable: (key, value) => {
+          setVariables((prev) => ({ ...prev, [key]: value }));
+        },
         setAutoMode: setIsAutoMode,
         skipTyping: () => {
           typingCompleteRef.current = true;
@@ -3177,18 +3200,38 @@ var MMDVisualNovel = React6.forwardRef(
           }
         }
       ),
-      showChoices && currentNode.choices && /* @__PURE__ */ React6__default.default.createElement(
+      showChoices && (currentDialogue?.choices || currentNode.choices) && /* @__PURE__ */ React6__default.default.createElement(
         ChoiceMenu,
         {
-          choices: currentNode.choices,
+          choices: currentDialogue?.choices || currentNode.choices,
           theme: dialogueTheme,
           onSelect: (choice) => {
+            if (choice.setVariable) {
+              const { key, value } = choice.setVariable;
+              setVariables((prev) => ({ ...prev, [key]: value }));
+              console.log(`[MMDVisualNovel] Variable set: ${key} = ${value}`);
+            }
             choice.onSelect?.();
-            if (choice.nextNodeIndex === currentNodeIndex) {
-              goToDialogue(choice.nextDialogueIndex || 0);
-              setShowChoices(false);
-            } else {
-              goToNode(choice.nextNodeIndex, true);
+            setShowChoices(false);
+            if (choice.nextNodeIndex !== void 0) {
+              if (choice.nextNodeIndex === currentNodeIndex) {
+                goToDialogue(choice.nextDialogueIndex || 0);
+              } else {
+                goToNode(choice.nextNodeIndex, true);
+              }
+            } else if (currentDialogue?.choices) {
+              const nextIdx = currentDialogueIndex + 1;
+              if (currentNode && nextIdx < currentNode.dialogues.length) {
+                const nextDialogue = currentNode.dialogues[nextIdx];
+                if (nextDialogue) {
+                  setCurrentDialogueIndex(nextIdx);
+                  addToHistory(nextDialogue, currentNodeIndex, nextIdx);
+                  onDialogueChange?.(nextDialogue, nextIdx, currentNodeIndex);
+                  typingCompleteRef.current = false;
+                }
+              } else {
+                triggerNodeTransition();
+              }
             }
           }
         }
@@ -3607,6 +3650,7 @@ var MMDMusicPlayer = React6.forwardRef(
 );
 MMDMusicPlayer.displayName = "MMDMusicPlayer";
 
+exports.ChoiceMenu = ChoiceMenu;
 exports.DialogueBox = DialogueBox;
 exports.HistoryPanel = HistoryPanel;
 exports.LoadingOverlay = LoadingOverlay;