@luna-editor/engine 0.5.6 → 0.5.7

package/dist/Player.js

@@ -794,6 +794,18 @@ export const Player = ({ scenario: scenarioProp, settings, plugins = EMPTY_PLUGI
     const skipToNext = useCallback(() => {
         handleNext("click");
     }, [handleNext]);
+    // プラグインからシナリオを最後までスキップして正常終了するためのコールバック
+    const skipScenario = useCallback(() => {
+        if (!hasStarted || state.isEnded)
+            return;
+        setState((prev) => (Object.assign(Object.assign({}, prev), { isEnded: true, isPlaying: false })));
+        pluginManager.callHook("onScenarioEnd", {
+            scenarioId: scenario.id,
+            scenarioName: scenario.name || "scenario",
+        });
+        onScenarioEnd === null || onScenarioEnd === void 0 ? void 0 : onScenarioEnd();
+        onEnd === null || onEnd === void 0 ? void 0 : onEnd();
+    }, [hasStarted, state.isEnded, pluginManager, scenario.id, scenario.name, onScenarioEnd, onEnd]);
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const _handlePrevious = useCallback(() => {
         if (state.currentBlockIndex > 0) {
@@ -982,7 +994,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, onToggleAutoPlay: toggleAutoPlay, onSetAutoPlay: setAutoPlay, onSkipToNext: skipToNext, children: _jsx(AudioProvider, { settings: {
+                                }, children: _jsx(DataProvider, { data: dataContext, onSettingsUpdate: handleSettingsUpdate, onEmotionEffectUpdate: handleEmotionEffectUpdate, onCancelScenario: cancelScenario, onToggleAutoPlay: toggleAutoPlay, onSetAutoPlay: setAutoPlay, onSkipToNext: skipToNext, onSkipScenario: skipScenario, children: _jsx(AudioProvider, { settings: {
                                         bgmVolume: mergedSettings.bgmVolume,
                                         seVolume: mergedSettings.seVolume,
                                         voiceVolume: mergedSettings.voiceVolume,

package/dist/contexts/DataContext.d.ts

@@ -6,6 +6,7 @@ type ScenarioCanceller = () => void;
 type AutoPlayToggler = () => void;
 type AutoPlaySetter = (enabled: boolean) => void;
 type SkipToNextHandler = () => void;
+type SkipScenarioHandler = () => void;
 /**
  * データプロバイダー
  * プラグインがシナリオ情報にリアクティブにアクセスするためのProvider
@@ -27,6 +28,7 @@ export declare const DataProvider: React.FC<{
     onToggleAutoPlay?: AutoPlayToggler;
     onSetAutoPlay?: AutoPlaySetter;
     onSkipToNext?: SkipToNextHandler;
+    onSkipScenario?: SkipScenarioHandler;
     children: ReactNode;
 }>;
 /**

package/dist/contexts/DataContext.js

@@ -10,6 +10,7 @@ const ScenarioCancellerContext = createContext(null);
 const AutoPlayTogglerContext = createContext(null);
 const AutoPlaySetterContext = createContext(null);
 const SkipToNextContext = createContext(null);
+const SkipScenarioContext = createContext(null);
 /**
  * データプロバイダー
  * プラグインがシナリオ情報にリアクティブにアクセスするためのProvider
@@ -23,7 +24,7 @@ const SkipToNextContext = createContext(null);
  * </DataProvider>
  * ```
  */
-export const DataProvider = ({ data, onSettingsUpdate, onEmotionEffectUpdate, onCancelScenario, onToggleAutoPlay, onSetAutoPlay, onSkipToNext, children }) => {
+export const DataProvider = ({ data, onSettingsUpdate, onEmotionEffectUpdate, onCancelScenario, onToggleAutoPlay, onSetAutoPlay, onSkipToNext, onSkipScenario, children }) => {
     const subscribers = useMemo(() => new Map(), []);
     const previousDataRef = useRef(data);
     // 安定したデータ参照ホルダー（Context valueとして提供）
@@ -65,7 +66,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(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 }) }) }) }) }) }) }) }) }));
+    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(SkipScenarioContext.Provider, { value: onSkipScenario !== null && onSkipScenario !== void 0 ? onSkipScenario : null, children: _jsx(DataRefContext.Provider, { value: dataRefHolder, children: _jsx(DataContextInstance.Provider, { value: data, children: children }) }) }) }) }) }) }) }) }) }));
 };
 /**
  * DataAPI実装を提供するフック
@@ -83,6 +84,7 @@ export function useDataAPI() {
     const autoPlayToggler = useContext(AutoPlayTogglerContext);
     const autoPlaySetter = useContext(AutoPlaySetterContext);
     const skipToNextHandler = useContext(SkipToNextContext);
+    const skipScenarioHandler = useContext(SkipScenarioContext);
     // 注意: usePlaybackTextOptional()をここで呼ぶと、PlaybackTextContextの更新で
     // useDataAPIを使う全コンポーネントが再レンダリングされてしまう
     // 代わりに、displayTextが必要なコンポーネントはusePlaybackText()を直接使う
@@ -213,6 +215,14 @@ export function useDataAPI() {
             console.warn("skipToNext called but no skip handler provided");
         }
     }, [skipToNextHandler]);
+    const skipScenario = useCallback(() => {
+        if (skipScenarioHandler) {
+            skipScenarioHandler();
+        }
+        else {
+            console.warn("skipScenario called but no skip scenario handler provided");
+        }
+    }, [skipScenarioHandler]);
     return useMemo(() => ({
         get,
         subscribe,
@@ -228,6 +238,7 @@ export function useDataAPI() {
         toggleAutoPlay,
         setAutoPlay,
         skipToNext,
+        skipScenario,
     }), [
         get,
         subscribe,
@@ -243,5 +254,6 @@ export function useDataAPI() {
         toggleAutoPlay,
         setAutoPlay,
         skipToNext,
+        skipScenario,
     ]);
 }

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

@@ -272,4 +272,10 @@ export interface DataAPI {
      * 完了済みの場合は次のブロックに遷移する。
      */
     skipToNext(): void;
+    /**
+     * シナリオを最後までスキップして終了する
+     * onEnd / onScenarioEnd コールバックが発火される。
+     * cancelScenario と異なり、正常終了扱い。
+     */
+    skipScenario(): void;
 }

package/dist/plugin/PluginManager.js

@@ -882,6 +882,9 @@ export class PluginManager {
                 skipToNext: () => {
                     throw new Error("DataAPI.skipToNext() can only be called from within DataProvider context");
                 },
+                skipScenario: () => {
+                    throw new Error("DataAPI.skipScenario() can only be called from within DataProvider context");
+                },
             },
         };
     }

package/package.json

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