@luna-editor/engine 0.5.4 → 0.5.5

package/dist/Player.js

@@ -781,6 +781,19 @@ export const Player = ({ scenario: scenarioProp, settings, plugins = EMPTY_PLUGI
         scenario.id,
         scenario.name,
     ]);
+    // プラグインからAUTO再生を制御するためのコールバック
+    const toggleAutoPlay = useCallback(() => {
+        _togglePlay();
+    }, [_togglePlay]);
+    const setAutoPlay = useCallback((enabled) => {
+        if (enabled !== state.isPlaying) {
+            _togglePlay();
+        }
+    }, [state.isPlaying, _togglePlay]);
+    // プラグインから次のブロックへ進むためのコールバック
+    const skipToNext = useCallback(() => {
+        handleNext("click");
+    }, [handleNext]);
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const _handlePrevious = useCallback(() => {
         if (state.currentBlockIndex > 0) {
@@ -811,6 +824,7 @@ export const Player = ({ scenario: scenarioProp, settings, plugins = EMPTY_PLUGI
                 displayText: displayTextElement,
                 isTyping,
                 displayedCharacters,
+                isAutoPlaying: state.isPlaying,
             },
             backlog: {
                 entries: backlog.logs,
@@ -869,6 +883,7 @@ export const Player = ({ scenario: scenarioProp, settings, plugins = EMPTY_PLUGI
         mergedSettings.selectedUIFontFamily,
         currentBackground,
         fontsLoaded,
+        state.isPlaying,
     ]);
     // DataContextの参照を更新（プラグインがapi.data.get()を呼び出せるようにする）
     useEffect(() => {
@@ -939,7 +954,7 @@ export const Player = ({ scenario: scenarioProp, settings, plugins = EMPTY_PLUGI
                                     aspectRatio: getAspectRatio(),
                                     width: `min(100vw, calc(100vh * ${getAspectRatioValue()}))`,
                                     height: `min(100vh, calc(100vw / ${getAspectRatioValue()}))`,
-                                }, children: _jsx(DataProvider, { data: dataContext, onSettingsUpdate: handleSettingsUpdate, onEmotionEffectUpdate: handleEmotionEffectUpdate, onCancelScenario: cancelScenario, children: _jsx(AudioProvider, { settings: {
+                                }, children: _jsx(DataProvider, { data: dataContext, onSettingsUpdate: handleSettingsUpdate, onEmotionEffectUpdate: handleEmotionEffectUpdate, onCancelScenario: cancelScenario, onToggleAutoPlay: toggleAutoPlay, onSetAutoPlay: setAutoPlay, onSkipToNext: skipToNext, children: _jsx(AudioProvider, { settings: {
                                         bgmVolume: mergedSettings.bgmVolume,
                                         seVolume: mergedSettings.seVolume,
                                         voiceVolume: mergedSettings.voiceVolume,

package/dist/contexts/DataContext.d.ts

@@ -3,6 +3,9 @@ import type { DataAPI, DataContext, EmotionEffectState, PlayerSettingsData } fro
 type SettingsUpdater = (settings: Partial<PlayerSettingsData>) => void;
 type EmotionEffectUpdater = (state: EmotionEffectState | null) => void;
 type ScenarioCanceller = () => void;
+type AutoPlayToggler = () => void;
+type AutoPlaySetter = (enabled: boolean) => void;
+type SkipToNextHandler = () => void;
 /**
  * データプロバイダー
  * プラグインがシナリオ情報にリアクティブにアクセスするためのProvider
@@ -21,6 +24,9 @@ export declare const DataProvider: React.FC<{
     onSettingsUpdate?: SettingsUpdater;
     onEmotionEffectUpdate?: EmotionEffectUpdater;
     onCancelScenario?: ScenarioCanceller;
+    onToggleAutoPlay?: AutoPlayToggler;
+    onSetAutoPlay?: AutoPlaySetter;
+    onSkipToNext?: SkipToNextHandler;
     children: ReactNode;
 }>;
 /**

package/dist/contexts/DataContext.js

@@ -7,6 +7,9 @@ const SubscribersContext = createContext(null);
 const SettingsUpdaterContext = createContext(null);
 const EmotionEffectUpdaterContext = createContext(null);
 const ScenarioCancellerContext = createContext(null);
+const AutoPlayTogglerContext = createContext(null);
+const AutoPlaySetterContext = createContext(null);
+const SkipToNextContext = createContext(null);
 /**
  * データプロバイダー
  * プラグインがシナリオ情報にリアクティブにアクセスするためのProvider
@@ -20,7 +23,7 @@ const ScenarioCancellerContext = createContext(null);
  * </DataProvider>
  * ```
  */
-export const DataProvider = ({ data, onSettingsUpdate, onEmotionEffectUpdate, onCancelScenario, children }) => {
+export const DataProvider = ({ data, onSettingsUpdate, onEmotionEffectUpdate, onCancelScenario, onToggleAutoPlay, onSetAutoPlay, onSkipToNext, children }) => {
     const subscribers = useMemo(() => new Map(), []);
     const previousDataRef = useRef(data);
     // 安定したデータ参照ホルダー（Context valueとして提供）
@@ -62,7 +65,7 @@ export const DataProvider = ({ data, onSettingsUpdate, onEmotionEffectUpdate, on
         }
         previousDataRef.current = data;
     }, [data, subscribers]);
-    return (_jsx(SubscribersContext.Provider, { value: subscribers, children: _jsx(SettingsUpdaterContext.Provider, { value: onSettingsUpdate !== null && onSettingsUpdate !== void 0 ? onSettingsUpdate : null, children: _jsx(EmotionEffectUpdaterContext.Provider, { value: onEmotionEffectUpdate !== null && onEmotionEffectUpdate !== void 0 ? onEmotionEffectUpdate : null, children: _jsx(ScenarioCancellerContext.Provider, { value: onCancelScenario !== null && onCancelScenario !== void 0 ? onCancelScenario : null, children: _jsx(DataRefContext.Provider, { value: dataRefHolder, children: _jsx(DataContextInstance.Provider, { value: data, children: children }) }) }) }) }) }));
+    return (_jsx(SubscribersContext.Provider, { value: subscribers, children: _jsx(SettingsUpdaterContext.Provider, { value: onSettingsUpdate !== null && onSettingsUpdate !== void 0 ? onSettingsUpdate : null, children: _jsx(EmotionEffectUpdaterContext.Provider, { value: onEmotionEffectUpdate !== null && onEmotionEffectUpdate !== void 0 ? onEmotionEffectUpdate : null, children: _jsx(ScenarioCancellerContext.Provider, { value: onCancelScenario !== null && onCancelScenario !== void 0 ? onCancelScenario : null, children: _jsx(AutoPlayTogglerContext.Provider, { value: onToggleAutoPlay !== null && onToggleAutoPlay !== void 0 ? onToggleAutoPlay : null, children: _jsx(AutoPlaySetterContext.Provider, { value: onSetAutoPlay !== null && onSetAutoPlay !== void 0 ? onSetAutoPlay : null, children: _jsx(SkipToNextContext.Provider, { value: onSkipToNext !== null && onSkipToNext !== void 0 ? onSkipToNext : null, children: _jsx(DataRefContext.Provider, { value: dataRefHolder, children: _jsx(DataContextInstance.Provider, { value: data, children: children }) }) }) }) }) }) }) }) }));
 };
 /**
  * DataAPI実装を提供するフック
@@ -77,6 +80,9 @@ export function useDataAPI() {
     const settingsUpdater = useContext(SettingsUpdaterContext);
     const emotionEffectUpdater = useContext(EmotionEffectUpdaterContext);
     const scenarioCanceller = useContext(ScenarioCancellerContext);
+    const autoPlayToggler = useContext(AutoPlayTogglerContext);
+    const autoPlaySetter = useContext(AutoPlaySetterContext);
+    const skipToNextHandler = useContext(SkipToNextContext);
     // 注意: usePlaybackTextOptional()をここで呼ぶと、PlaybackTextContextの更新で
     // useDataAPIを使う全コンポーネントが再レンダリングされてしまう
     // 代わりに、displayTextが必要なコンポーネントはusePlaybackText()を直接使う
@@ -183,6 +189,30 @@ export function useDataAPI() {
             console.warn("cancelScenario called but no scenario canceller provided");
         }
     }, [scenarioCanceller]);
+    const toggleAutoPlay = useCallback(() => {
+        if (autoPlayToggler) {
+            autoPlayToggler();
+        }
+        else {
+            console.warn("toggleAutoPlay called but no auto play toggler provided");
+        }
+    }, [autoPlayToggler]);
+    const setAutoPlay = useCallback((enabled) => {
+        if (autoPlaySetter) {
+            autoPlaySetter(enabled);
+        }
+        else {
+            console.warn("setAutoPlay called but no auto play setter provided");
+        }
+    }, [autoPlaySetter]);
+    const skipToNext = useCallback(() => {
+        if (skipToNextHandler) {
+            skipToNextHandler();
+        }
+        else {
+            console.warn("skipToNext called but no skip handler provided");
+        }
+    }, [skipToNextHandler]);
     return useMemo(() => ({
         get,
         subscribe,
@@ -195,6 +225,9 @@ export function useDataAPI() {
         getBlockOption,
         updateEmotionEffect,
         cancelScenario,
+        toggleAutoPlay,
+        setAutoPlay,
+        skipToNext,
     }), [
         get,
         subscribe,
@@ -207,5 +240,8 @@ export function useDataAPI() {
         getBlockOption,
         updateEmotionEffect,
         cancelScenario,
+        toggleAutoPlay,
+        setAutoPlay,
+        skipToNext,
     ]);
 }

package/dist/data-api-types.d.ts

@@ -21,6 +21,8 @@ export interface ScenarioPlaybackData {
     isTyping?: boolean;
     /** 表示中のキャラクター */
     displayedCharacters?: DisplayedCharacter[];
+    /** AUTO再生中かどうか */
+    isAutoPlaying?: boolean;
 }
 /**
  * バックログデータ
@@ -254,4 +256,20 @@ export interface DataAPI {
      * Player の onScenarioCancelled コールバックが発火される。
      */
     cancelScenario(): void;
+    /**
+     * AUTO再生のON/OFFを切り替える
+     * isPlaying を反転させる。シナリオ終了時は無視される。
+     */
+    toggleAutoPlay(): void;
+    /**
+     * AUTO再生の状態を設定する
+     * @param enabled - trueでAUTO ON、falseでOFF
+     */
+    setAutoPlay(enabled: boolean): void;
+    /**
+     * 次のブロックへ進む（スキップ）
+     * テキストアニメーション中はアニメーションを完了させ、
+     * 完了済みの場合は次のブロックに遷移する。
+     */
+    skipToNext(): void;
 }

package/dist/plugin/PluginManager.js

@@ -873,6 +873,15 @@ export class PluginManager {
                 cancelScenario: () => {
                     throw new Error("DataAPI.cancelScenario() can only be called from within DataProvider context");
                 },
+                toggleAutoPlay: () => {
+                    throw new Error("DataAPI.toggleAutoPlay() can only be called from within DataProvider context");
+                },
+                setAutoPlay: () => {
+                    throw new Error("DataAPI.setAutoPlay() can only be called from within DataProvider context");
+                },
+                skipToNext: () => {
+                    throw new Error("DataAPI.skipToNext() can only be called from within DataProvider context");
+                },
             },
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luna-editor/engine",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Luna Editor scenario playback engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",