@luna-editor/engine 0.2.0 → 0.3.0

package/dist/hooks/usePlayerLogic.js

@@ -22,6 +22,8 @@ const calculateDisplayedCharacters = (blocks, currentIndex) => {
                                 scale: char.scale,
                                 object: char.object,
                                 entityState: char.entityState,
+                                // レイヤー機能用
+                                baseBodyState: char.baseBodyState,
                             }));
                             characters = [
                                 ...characters.filter((existing) => !newCharacters.some((newChar) => newChar.objectId === existing.objectId)),
@@ -29,20 +31,70 @@ const calculateDisplayedCharacters = (blocks, currentIndex) => {
                             ];
                         }
                         break;
-                    case "character_exit":
-                        // character_exitに到達したら、キャラクター表示範囲外
-                        return [];
                     case "dialogue":
                         if (processBlock.speakerId && processBlock.speakerStateId) {
                             characters = characters.map((char) => {
-                                var _a, _b, _c, _d;
+                                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
                                 return char.objectId === processBlock.speakerId
                                     ? Object.assign(Object.assign({}, char), { entityStateId: processBlock.speakerStateId || "", entityState: {
                                             id: (_a = processBlock.speakerStateId) !== null && _a !== void 0 ? _a : "",
                                             name: ((_b = processBlock.speakerState) === null || _b === void 0 ? void 0 : _b.name) || "",
                                             imageUrl: ((_c = processBlock.speakerState) === null || _c === void 0 ? void 0 : _c.imageUrl) || null,
                                             cropArea: ((_d = processBlock.speakerState) === null || _d === void 0 ? void 0 : _d.cropArea) || null,
-                                        } }) : char;
+                                            scale: (_e = processBlock.speakerState) === null || _e === void 0 ? void 0 : _e.scale,
+                                            translateX: (_f = processBlock.speakerState) === null || _f === void 0 ? void 0 : _f.translateX,
+                                            translateY: (_g = processBlock.speakerState) === null || _g === void 0 ? void 0 : _g.translateY,
+                                            isDefault: (_h = processBlock.speakerState) === null || _h === void 0 ? void 0 : _h.isDefault,
+                                            // speakerStateにレイヤー情報があればそれを使用、なければ既存を保持
+                                            layers: (_k = (_j = processBlock.speakerState) === null || _j === void 0 ? void 0 : _j.layers) !== null && _k !== void 0 ? _k : char.entityState.layers,
+                                        }, 
+                                        // baseBodyStateを保持
+                                        baseBodyState: char.baseBodyState }) : char;
+                            });
+                        }
+                        break;
+                    case "character_state_change":
+                        // 状態変更ブロック: 登場済みキャラクターの状態のみを変更（位置は維持）
+                        // characters配列がある場合はそれを使用（複数キャラクター対応）
+                        if (processBlock.characters && processBlock.characters.length > 0) {
+                            for (const stateChange of processBlock.characters) {
+                                characters = characters.map((char) => {
+                                    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+                                    return char.objectId === stateChange.objectId
+                                        ? Object.assign(Object.assign({}, char), { entityStateId: stateChange.entityStateId, entityState: {
+                                                id: stateChange.entityStateId,
+                                                name: ((_a = stateChange.entityState) === null || _a === void 0 ? void 0 : _a.name) || "",
+                                                imageUrl: ((_b = stateChange.entityState) === null || _b === void 0 ? void 0 : _b.imageUrl) || null,
+                                                cropArea: ((_c = stateChange.entityState) === null || _c === void 0 ? void 0 : _c.cropArea) || null,
+                                                scale: (_d = stateChange.entityState) === null || _d === void 0 ? void 0 : _d.scale,
+                                                translateX: (_e = stateChange.entityState) === null || _e === void 0 ? void 0 : _e.translateX,
+                                                translateY: (_f = stateChange.entityState) === null || _f === void 0 ? void 0 : _f.translateY,
+                                                isDefault: (_g = stateChange.entityState) === null || _g === void 0 ? void 0 : _g.isDefault,
+                                                layers: (_j = (_h = stateChange.entityState) === null || _h === void 0 ? void 0 : _h.layers) !== null && _j !== void 0 ? _j : char.entityState.layers,
+                                            }, 
+                                            // baseBodyStateと位置情報を保持
+                                            baseBodyState: char.baseBodyState }) : char;
+                                });
+                            }
+                        }
+                        else if (processBlock.speakerId && processBlock.speakerStateId) {
+                            // speakerId/speakerStateIdを使用した単一キャラクター状態変更（インラインエディタ形式）
+                            characters = characters.map((char) => {
+                                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+                                return char.objectId === processBlock.speakerId
+                                    ? Object.assign(Object.assign({}, char), { entityStateId: processBlock.speakerStateId || "", entityState: {
+                                            id: (_a = processBlock.speakerStateId) !== null && _a !== void 0 ? _a : "",
+                                            name: ((_b = processBlock.speakerState) === null || _b === void 0 ? void 0 : _b.name) || "",
+                                            imageUrl: ((_c = processBlock.speakerState) === null || _c === void 0 ? void 0 : _c.imageUrl) || null,
+                                            cropArea: ((_d = processBlock.speakerState) === null || _d === void 0 ? void 0 : _d.cropArea) || null,
+                                            scale: (_e = processBlock.speakerState) === null || _e === void 0 ? void 0 : _e.scale,
+                                            translateX: (_f = processBlock.speakerState) === null || _f === void 0 ? void 0 : _f.translateX,
+                                            translateY: (_g = processBlock.speakerState) === null || _g === void 0 ? void 0 : _g.translateY,
+                                            isDefault: (_h = processBlock.speakerState) === null || _h === void 0 ? void 0 : _h.isDefault,
+                                            layers: (_k = (_j = processBlock.speakerState) === null || _j === void 0 ? void 0 : _j.layers) !== null && _k !== void 0 ? _k : char.entityState.layers,
+                                        }, 
+                                        // baseBodyStateと位置情報を保持
+                                        baseBodyState: char.baseBodyState }) : char;
                             });
                         }
                         break;
@@ -50,36 +102,57 @@ const calculateDisplayedCharacters = (blocks, currentIndex) => {
             }
             break; // 最初のcharacter_entranceを見つけたら終了
         }
-        if (block.blockType === "character_exit") {
-            // character_exitを見つけたら、キャラクター表示範囲外
-            return [];
-        }
     }
     return characters;
 };
-export const usePlayerLogic = ({ state, setState, scenario, isTyping, currentBlock, skipTyping, onEnd, onScenarioEnd, autoplay, }) => {
+export const usePlayerLogic = ({ state, setState, scenario, isTyping, currentBlock, skipTyping, onEnd, onScenarioEnd, autoplay, branchState, branchNavigator: _branchNavigator, customRestart, variableManager, disableKeyboardNavigation = false, }) => {
     const isLastBlock = state.currentBlockIndex === scenario.blocks.length - 1;
     // 現在のインデックスに基づいて表示すべきキャラクターを計算
     const displayedCharacters = useMemo(() => calculateDisplayedCharacters(scenario.blocks, state.currentBlockIndex), [scenario.blocks, state.currentBlockIndex]);
     const handleNext = useCallback(() => {
-        var _a;
+        var _a, _b;
         // タイピング中の場合はスキップ
         if (isTyping && currentBlock) {
-            skipTyping(currentBlock.content || "");
+            skipTyping();
             return;
         }
+        // 分岐ブロックでの進行制御
+        if ((currentBlock === null || currentBlock === void 0 ? void 0 : currentBlock.blockType) === "conversation_branch") {
+            // エラー時は次のブロックに進む
+            if (branchState === null || branchState === void 0 ? void 0 : branchState.errorState) {
+                // 進行を許可
+            }
+            else if (!(branchState === null || branchState === void 0 ? void 0 : branchState.selectedChoiceId)) {
+                // ローディング中または選択肢未選択の場合は停止
+                return;
+            }
+        }
         if (isLastBlock) {
             setState((prev) => (Object.assign(Object.assign({}, prev), { isEnded: true, isPlaying: false })));
             onEnd === null || onEnd === void 0 ? void 0 : onEnd();
             onScenarioEnd === null || onScenarioEnd === void 0 ? void 0 : onScenarioEnd();
-            // iframe向けのイベント発火
             if (typeof window !== "undefined") {
                 window.postMessage({ type: "scenario-end" }, "*");
                 (_a = window.parent) === null || _a === void 0 ? void 0 : _a.postMessage({ type: "scenario-end" }, "*");
             }
         }
         else {
-            setState((prev) => (Object.assign(Object.assign({}, prev), { currentBlockIndex: prev.currentBlockIndex + 1 })));
+            const nextIndex = state.currentBlockIndex + 1;
+            const nextBlock = scenario.blocks[nextIndex];
+            if ((nextBlock === null || nextBlock === void 0 ? void 0 : nextBlock.blockType) === "variable_operation" && variableManager) {
+                const operation = (_b = scenario.variableOperations) === null || _b === void 0 ? void 0 : _b.find((op) => op.blockId === nextBlock.id);
+                if (operation) {
+                    variableManager.executeOperation(operation);
+                    setState((prev) => (Object.assign(Object.assign({}, prev), { currentBlockIndex: nextIndex, variables: variableManager.getVariablesMap() })));
+                }
+                else {
+                    console.error("変数操作ブロックに対応する操作が見つかりません:", nextBlock.id);
+                    setState((prev) => (Object.assign(Object.assign({}, prev), { currentBlockIndex: nextIndex })));
+                }
+            }
+            else {
+                setState((prev) => (Object.assign(Object.assign({}, prev), { currentBlockIndex: nextIndex })));
+            }
         }
     }, [
         isLastBlock,
@@ -89,6 +162,11 @@ export const usePlayerLogic = ({ state, setState, scenario, isTyping, currentBlo
         currentBlock,
         skipTyping,
         setState,
+        branchState,
+        state.currentBlockIndex,
+        scenario.blocks,
+        scenario.variableOperations,
+        variableManager,
     ]);
     const handlePrevious = useCallback(() => {
         if (state.currentBlockIndex > 0) {
@@ -101,15 +179,22 @@ export const usePlayerLogic = ({ state, setState, scenario, isTyping, currentBlo
         setState((prev) => (Object.assign(Object.assign({}, prev), { isPlaying: !prev.isPlaying })));
     }, [state.isEnded, setState]);
     const restart = useCallback(() => {
-        console.log("restart");
+        if (variableManager) {
+            variableManager.reset();
+        }
         setState({
             currentBlockIndex: 0,
             isPlaying: autoplay,
             isEnded: false,
+            variables: variableManager === null || variableManager === void 0 ? void 0 : variableManager.getVariablesMap(),
         });
-    }, [autoplay, setState]);
+    }, [autoplay, setState, variableManager]);
     // キーボードナビゲーション
     useEffect(() => {
+        // プレビューモードなど、キーボードナビゲーションを無効化する場合はリスナーを追加しない
+        if (disableKeyboardNavigation) {
+            return;
+        }
         const handleKeyDown = (event) => {
             switch (event.key) {
                 case "ArrowRight":
@@ -127,13 +212,25 @@ export const usePlayerLogic = ({ state, setState, scenario, isTyping, currentBlo
                     break;
                 case "Escape":
                     event.preventDefault();
-                    restart();
+                    if (customRestart) {
+                        customRestart();
+                    }
+                    else {
+                        restart();
+                    }
                     break;
             }
         };
         window.addEventListener("keydown", handleKeyDown);
         return () => window.removeEventListener("keydown", handleKeyDown);
-    }, [handleNext, handlePrevious, togglePlay, restart]);
+    }, [
+        handleNext,
+        handlePrevious,
+        togglePlay,
+        restart,
+        customRestart,
+        disableKeyboardNavigation,
+    ]);
     return {
         handleNext,
         handlePrevious,

package/dist/hooks/usePluginEvents.d.ts

@@ -1,4 +1,5 @@
 import type { PluginManager } from "../plugin/PluginManager";
+import type { TransitionSource } from "../sdk";
 import type { DisplayedCharacter, ScenarioBlock } from "../types";
 interface UsePluginEventsProps {
     pluginManager: PluginManager;
@@ -9,6 +10,8 @@ interface UsePluginEventsProps {
     allBlocks: ScenarioBlock[];
     realBlockIndex: number;
     pluginsLoaded: boolean;
+    /** 遷移の種類（クリック、自動、時間待ち） */
+    transitionSource?: TransitionSource;
 }
-export declare const usePluginEvents: ({ pluginManager, currentBlock, displayedCharacters, blockIndex, isFirstRenderComplete, allBlocks, realBlockIndex, pluginsLoaded, }: UsePluginEventsProps) => void;
+export declare const usePluginEvents: ({ pluginManager, currentBlock, displayedCharacters, blockIndex, isFirstRenderComplete, allBlocks, realBlockIndex, pluginsLoaded, transitionSource, }: UsePluginEventsProps) => void;
 export {};

package/dist/hooks/usePluginEvents.js

@@ -1,7 +1,7 @@
 import { useEffect, useRef } from "react";
 import { normalizeAttributes } from "../utils/attributeNormalizer";
 import { calculateFacePosition } from "../utils/facePositionCalculator";
-export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacters, blockIndex, isFirstRenderComplete, allBlocks, realBlockIndex, pluginsLoaded, }) => {
+export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacters, blockIndex, isFirstRenderComplete, allBlocks, realBlockIndex, pluginsLoaded, transitionSource = "click", }) => {
     const previousSpeakerRef = useRef({});
     const previousRealBlockIndexRef = useRef(-1);
     const scenarioReadyCalledRef = useRef(false);
@@ -45,26 +45,22 @@ export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacte
             const startIndex = previousIndex === -1 ? 0 : previousIndex + 1;
             for (let i = startIndex; i <= currentIndex; i++) {
                 const block = allBlocks[i];
-                console.log("block", block);
                 if ((block === null || block === void 0 ? void 0 : block.blockType) === "action_node" && block.actionNode) {
-                    // Normalize attributes from database format
                     const normalizedAttributes = normalizeAttributes(block);
-                    console.log("Normalized attributes:", normalizedAttributes);
                     // Try multiple ways to find the ActionNode type - prioritize displayName matching
                     const possibleTypes = [
                         block.actionNode.nodeType,
                         block.actionNode.name, // This will be "背景" from database
                     ].filter(Boolean);
                     let actionNodeDef;
-                    let foundActionNodeType;
+                    let _foundActionNodeType;
                     // First try direct type matching
                     for (const actionNodeType of possibleTypes) {
                         if (actionNodeType) {
                             actionNodeDef =
                                 pluginManager.getActionNodeDefinition(actionNodeType);
                             if (actionNodeDef) {
-                                foundActionNodeType = actionNodeType;
-                                console.log(`Found ActionNode definition with type: ${actionNodeType}`);
+                                _foundActionNodeType = actionNodeType;
                                 break;
                             }
                         }
@@ -73,8 +69,7 @@ export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacte
                     if (!actionNodeDef && block.actionNode.name) {
                         actionNodeDef = pluginManager.getActionNodeDefinition(block.actionNode.name);
                         if (actionNodeDef) {
-                            foundActionNodeType = block.actionNode.name;
-                            console.log(`Found ActionNode definition with displayName: ${block.actionNode.name}`);
+                            _foundActionNodeType = block.actionNode.name;
                         }
                     }
                     if (actionNodeDef === null || actionNodeDef === void 0 ? void 0 : actionNodeDef.execute) {
@@ -88,7 +83,6 @@ export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacte
                                 displayedCharacters,
                                 api: pluginManager,
                             });
-                            console.log(`Successfully executed ActionNode: ${foundActionNodeType}`);
                         }
                         catch (error) {
                             console.error("Error executing ActionNode:", error);
@@ -117,21 +111,32 @@ export const usePluginEvents = ({ pluginManager, currentBlock, displayedCharacte
         isFirstRenderComplete,
         pluginsLoaded,
     ]);
-    // ブロック変更イベント
+    // ブロック変更イベント + ビルトインクリック音
     useEffect(() => {
         if (!isFirstRenderComplete || !currentBlock || !pluginsLoaded) {
             return;
         }
+        // まずプラグインのオーバーライドフラグをリセット
+        pluginManager.resetClickSoundOverride();
+        // プラグインのonBlockChangeフックを呼び出す
+        // プラグインはここでoverrideClickSound()を呼び出してビルトインクリック音を抑制できる
         pluginManager.callHook("onBlockChange", {
             currentBlock,
             blockIndex,
+            transitionSource,
         });
+        // 時間待ちからの自動遷移でない場合のみ、ビルトインクリック音を再生
+        // プラグインがoverrideClickSound()を呼び出した場合は再生されない
+        if (transitionSource !== "time_wait" && transitionSource !== "auto") {
+            pluginManager.playClickSound();
+        }
     }, [
         pluginManager,
         currentBlock,
         blockIndex,
         isFirstRenderComplete,
         pluginsLoaded,
+        transitionSource,
     ]);
     // キャラクター発話イベント
     useEffect(() => {

package/dist/hooks/usePreloadImages.js

@@ -1,6 +1,8 @@
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 export const usePreloadImages = (scenario) => {
     const [isLoaded, setIsLoaded] = useState(false);
+    // プリロード済みの画像URLセットを追跡（シナリオ変更で再プリロードを避ける）
+    const preloadedUrlsRef = useRef(new Set());
     useEffect(() => {
         const imageUrls = new Set();
         // シナリオ全体から画像URLを収集
@@ -24,12 +26,23 @@ export const usePreloadImages = (scenario) => {
             setIsLoaded(true);
             return;
         }
+        // 未プリロードの画像のみをフィルタリング
+        const newImageUrls = Array.from(imageUrls).filter((url) => !preloadedUrlsRef.current.has(url));
+        // すべてプリロード済みの場合は即座に完了
+        if (newImageUrls.length === 0) {
+            setIsLoaded(true);
+            return;
+        }
+        // 新しい画像がある場合はローディング状態にリセット
+        setIsLoaded(false);
         let loadedCount = 0;
-        const totalCount = imageUrls.size;
+        const totalCount = newImageUrls.length;
+        const cleanupFunctions = [];
         // 各画像を事前読み込み
-        imageUrls.forEach((url) => {
+        for (const url of newImageUrls) {
             const img = new Image();
             const handleLoad = () => {
+                preloadedUrlsRef.current.add(url);
                 loadedCount++;
                 if (loadedCount === totalCount) {
                     setIsLoaded(true);
@@ -37,6 +50,7 @@ export const usePreloadImages = (scenario) => {
             };
             const handleError = () => {
                 console.error(`Failed to preload image: ${url}`);
+                preloadedUrlsRef.current.add(url); // エラーでもプリロード済みとしてマーク
                 loadedCount++;
                 if (loadedCount === totalCount) {
                     setIsLoaded(true);
@@ -45,12 +59,18 @@ export const usePreloadImages = (scenario) => {
             img.addEventListener("load", handleLoad);
             img.addEventListener("error", handleError);
             img.src = url;
-            // クリーンアップ関数で画像を破棄
-            return () => {
+            // クリーンアップ関数を配列に追加
+            cleanupFunctions.push(() => {
                 img.removeEventListener("load", handleLoad);
                 img.removeEventListener("error", handleError);
-            };
-        });
+            });
+        }
+        // クリーンアップ時にすべてのイベントリスナーを解除
+        return () => {
+            for (const cleanup of cleanupFunctions) {
+                cleanup();
+            }
+        };
     }, [scenario]);
     return isLoaded;
 };

package/dist/hooks/useSoundPlayer.d.ts

@@ -0,0 +1,15 @@
+import type { ScenarioBlock } from "../types";
+interface UseSoundPlayerProps {
+    soundBlocks: ScenarioBlock[];
+    isFirstRenderComplete: boolean;
+    /** 音声をミュートするかどうか */
+    muteAudio?: boolean;
+}
+export declare const useSoundPlayer: ({ soundBlocks, isFirstRenderComplete, muteAudio, }: UseSoundPlayerProps) => {
+    playSound: (block: ScenarioBlock) => void;
+    stopBGM: () => void;
+    stopSE: (soundId: string) => void;
+    stopAllSE: () => void;
+    stopAll: () => void;
+};
+export {};

package/dist/hooks/useSoundPlayer.js

@@ -0,0 +1,209 @@
+import { useCallback, useEffect, useRef } from "react";
+import { useAudioSettings } from "../contexts/AudioContext";
+export const useSoundPlayer = ({ soundBlocks, isFirstRenderComplete, muteAudio = false, }) => {
+    const audioSettings = useAudioSettings();
+    // 現在再生中のBGM
+    const bgmRef = useRef(null);
+    // 現在再生中のSE（複数同時再生可能）
+    const seInstancesRef = useRef(new Map());
+    // 前回処理したブロックIDセット（重複処理防止）
+    const processedBlockIdsRef = useRef(new Set());
+    // BGMかどうかを判定（SoundTypeのcategoryで判断）
+    const isBGM = useCallback((block) => {
+        var _a;
+        if (!((_a = block.sound) === null || _a === void 0 ? void 0 : _a.soundType))
+            return false;
+        return block.sound.soundType.category === "bgm";
+    }, []);
+    // Voiceかどうかを判定
+    const isVoice = useCallback((block) => {
+        var _a;
+        if (!((_a = block.sound) === null || _a === void 0 ? void 0 : _a.soundType))
+            return false;
+        return block.sound.soundType.category === "voice";
+    }, []);
+    // 音量を適用
+    const applyVolume = useCallback((audio, block) => {
+        if (isBGM(block)) {
+            audio.volume = audioSettings.bgmVolume;
+        }
+        else if (isVoice(block)) {
+            audio.volume = audioSettings.voiceVolume;
+        }
+        else {
+            audio.volume = audioSettings.seVolume;
+        }
+    }, [
+        audioSettings.bgmVolume,
+        audioSettings.seVolume,
+        audioSettings.voiceVolume,
+        isBGM,
+        isVoice,
+    ]);
+    // BGMを停止
+    const stopBGM = useCallback(() => {
+        if (bgmRef.current) {
+            bgmRef.current.audio.pause();
+            bgmRef.current.audio.currentTime = 0;
+            bgmRef.current = null;
+        }
+    }, []);
+    // 特定のSEを停止
+    const stopSE = useCallback((soundId) => {
+        const instance = seInstancesRef.current.get(soundId);
+        if (instance) {
+            instance.audio.pause();
+            instance.audio.currentTime = 0;
+            seInstancesRef.current.delete(soundId);
+        }
+    }, []);
+    // 全てのSEを停止
+    const stopAllSE = useCallback(() => {
+        for (const instance of seInstancesRef.current.values()) {
+            instance.audio.pause();
+            instance.audio.currentTime = 0;
+        }
+        seInstancesRef.current.clear();
+    }, []);
+    // 全ての音を停止
+    const stopAll = useCallback(() => {
+        stopBGM();
+        stopAllSE();
+    }, [stopBGM, stopAllSE]);
+    // サウンドを再生
+    const playSound = useCallback((block) => {
+        if (!block.sound)
+            return;
+        // ミュート中は再生しない（propsまたはaudioSettings）
+        if (muteAudio || audioSettings.muteAudio)
+            return;
+        const { sound } = block;
+        const isBGMSound = isBGM(block);
+        // BGMの場合、既存のBGMを停止
+        if (isBGMSound) {
+            stopBGM();
+        }
+        const audio = new Audio(sound.url);
+        audio.loop = sound.loop;
+        applyVolume(audio, block);
+        const category = block.sound.soundType.category;
+        // エラーハンドリング（イベントリスナーを保持してクリーンアップ可能にする）
+        const handleError = () => {
+            var _a;
+            console.warn(`Sound load failed: ${sound.name} (${sound.url})`);
+            // 失敗したインスタンスをクリーンアップ
+            if (isBGMSound && ((_a = bgmRef.current) === null || _a === void 0 ? void 0 : _a.soundId) === sound.id) {
+                bgmRef.current = null;
+            }
+            else {
+                seInstancesRef.current.delete(sound.id);
+            }
+            // イベントリスナーを削除
+            audio.removeEventListener("error", handleError);
+        };
+        audio.addEventListener("error", handleError);
+        const instance = {
+            audio,
+            soundId: sound.id,
+            category,
+        };
+        if (isBGMSound) {
+            bgmRef.current = instance;
+        }
+        else {
+            // SE/Voiceは既に同じIDのものがあれば停止して再生
+            // 注意: 同一サウンドの重複再生は意図的に防止している
+            // 連打などによる音の重複を避けるため
+            stopSE(sound.id);
+            seInstancesRef.current.set(sound.id, instance);
+            // SE終了時にMapから削除（イベントリスナーも削除）
+            const handleEnded = () => {
+                seInstancesRef.current.delete(sound.id);
+                audio.removeEventListener("ended", handleEnded);
+            };
+            audio.addEventListener("ended", handleEnded);
+        }
+        audio.play().catch((error) => {
+            // ネット作品エラーやソース不対応時のエラーをより詳細にログ
+            if (error.name === "NotSupportedError") {
+                console.warn(`Sound source not available: ${sound.name}`);
+            }
+            else {
+                console.error("Sound playback error:", error);
+            }
+        });
+    }, [isBGM, stopBGM, stopSE, applyVolume, muteAudio, audioSettings.muteAudio]);
+    // soundBlocksが変更された時にprocessedBlockIdsをクリア（シナリオリセット対応）
+    useEffect(() => {
+        // soundBlocksが空になったらprocessedBlockIdsをクリア
+        if (soundBlocks.length === 0) {
+            processedBlockIdsRef.current.clear();
+        }
+    }, [soundBlocks]);
+    // 複数のサウンドブロックを順番に処理
+    useEffect(() => {
+        if (!isFirstRenderComplete)
+            return;
+        for (const block of soundBlocks) {
+            // 既に処理済みのブロックはスキップ
+            if (processedBlockIdsRef.current.has(block.id))
+                continue;
+            // 処理済みとしてマーク
+            processedBlockIdsRef.current.add(block.id);
+            switch (block.blockType) {
+                case "bgm_play":
+                case "se_play":
+                    if (block.sound) {
+                        playSound(block);
+                    }
+                    break;
+                case "bgm_stop":
+                    // bgm_stopブロックはBGMを停止する
+                    stopBGM();
+                    break;
+            }
+        }
+    }, [soundBlocks, isFirstRenderComplete, playSound, stopBGM]);
+    // 音量設定の変更を反映
+    useEffect(() => {
+        if (bgmRef.current) {
+            bgmRef.current.audio.volume = audioSettings.bgmVolume;
+        }
+        for (const instance of seInstancesRef.current.values()) {
+            if (instance.category === "voice") {
+                instance.audio.volume = audioSettings.voiceVolume;
+            }
+            else {
+                instance.audio.volume = audioSettings.seVolume;
+            }
+        }
+    }, [
+        audioSettings.bgmVolume,
+        audioSettings.seVolume,
+        audioSettings.voiceVolume,
+    ]);
+    // クリーンアップ（直接refにアクセスして依存配列の問題を回避）
+    useEffect(() => {
+        return () => {
+            // BGMを停止
+            if (bgmRef.current) {
+                bgmRef.current.audio.pause();
+                bgmRef.current.audio.currentTime = 0;
+                bgmRef.current = null;
+            }
+            // 全てのSEを停止
+            for (const instance of seInstancesRef.current.values()) {
+                instance.audio.pause();
+                instance.audio.currentTime = 0;
+            }
+            seInstancesRef.current.clear();
+        };
+    }, []);
+    return {
+        playSound,
+        stopBGM,
+        stopSE,
+        stopAllSE,
+        stopAll,
+    };
+};

package/dist/hooks/useTypewriter.d.ts

@@ -1,3 +1,5 @@
+/** 連続モード: false = 連続しない, "continue" = 連続（改行なし）, "continueWithNewline" = 連続（改行あり） */
+export type ContinueMode = false | "continue" | "continueWithNewline";
 export interface UseTypewriterOptions {
     speed?: number;
     onComplete?: () => void;
@@ -5,7 +7,9 @@ export interface UseTypewriterOptions {
 export declare const useTypewriter: (options?: UseTypewriterOptions) => {
     displayText: string;
     isTyping: boolean;
-    startTyping: (text: string) => void;
-    skipTyping: (text: string) => void;
+    startTyping: (text: string, continueMode?: ContinueMode) => void;
+    skipTyping: () => void;
     reset: () => void;
+    resetAccumulated: () => void;
+    accumulatedText: string;
 };