@novely/core 0.31.2 → 0.32.0

package/dist/index.d.ts

@@ -483,7 +483,7 @@ type Character<$Lang extends Lang = string> = {
 type ValidAction = ['choice', number] | ['clear', Set<keyof DefaultActionProxy>?, Set<string>?, {
     music: Set<string>;
     sounds: Set<string>;
-}?] | ['condition', (state: State) => boolean, Record<string, ValidAction[]>] | ['dialog', string | undefined, TextContent<string, State>, string | undefined] | ['say', string, TextContent<string, State>] | ['end'] | ['showBackground', string | NonEmptyRecord<BackgroundImage>] | ['playMusic', string] | ['stopMusic', string] | ['pauseMusic', string] | ['playSound', audio: string, loop?: boolean] | ['pauseSound', string] | ['stopSound', string] | ['voice', string] | ['stopVoice'] | ['jump', string] | ['showCharacter', string, keyof Character['emotions'], string?, string?] | ['hideCharacter', string, string?, string?, number?] | ['animateCharacter', string, number, ...string[]] | ['wait', (number | ((state: State) => number))] | ['function', FunctionAction<string, State>] | ['input', string, (meta: ActionInputOnInputMeta<string, State>) => void, ActionInputSetup?] | ['custom', CustomHandler<string, State>] | ['vibrate', ...number[]] | ['next'] | ['text', ...TextContent<string, State>[]] | ['exit'] | ['preload', string] | ['block', string] | ValidAction[];
+}?] | ['condition', (state: State) => boolean, Record<string, ValidAction[]>] | ['dialog', string | undefined, TextContent<string, State>, string | undefined] | ['say', string, TextContent<string, State>] | ['end'] | ['showBackground', string | NonEmptyRecord<BackgroundImage>] | ['playMusic', string] | ['stopMusic', string] | ['pauseMusic', string] | ['playSound', audio: string, loop?: boolean] | ['pauseSound', string] | ['stopSound', string] | ['voice', string | Record<string, string>] | ['stopVoice'] | ['jump', string] | ['showCharacter', string, keyof Character['emotions'], string?, string?] | ['hideCharacter', string, string?, string?, number?] | ['animateCharacter', string, number, ...string[]] | ['wait', (number | ((state: State) => number))] | ['function', FunctionAction<string, State>] | ['input', string, (meta: ActionInputOnInputMeta<string, State>) => void, ActionInputSetup?] | ['custom', CustomHandler<string, State>] | ['vibrate', ...number[]] | ['next'] | ['text', ...TextContent<string, State>[]] | ['exit'] | ['preload', string] | ['block', string] | ValidAction[];
 type Story = Record<string, ValidAction[]>;
 type TextContent<L extends string, S extends State> = string | ((state: S) => string) | Record<L, string | ((state: S) => string)>;
 type FunctionableValue<T> = T | (() => T);
@@ -587,6 +587,7 @@ type ConditionCheckFunction<S extends State, R extends string | true | false> =
 type FunctionAction<L extends string, S extends State> = (props: FunctionActionProps<L, S>) => Thenable<void>;
 type ActionInputSetup = (input: HTMLInputElement, cleanup: (cb: () => void) => void) => void;
 type BackgroundImage = Partial<Record<'portrait' | 'landscape' | 'all', string>> & Record<string, string>;
+type VoiceAction<L extends Lang> = (params: string | Partial<Record<L, string>>) => ValidAction;
 type ActionProxy<Characters extends Record<string, Character>, Languages extends Lang, S extends State> = {
     choice: {
         (...choices: [name: TextContent<Languages, S>, actions: ValidAction[], active?: ChoiceCheckFunction<Languages, S>][]): ValidAction;
@@ -614,8 +615,18 @@ type ActionProxy<Characters extends Record<string, Character>, Languages extends
     stopSound: (audio: string) => ValidAction;
     /**
      * Plays voice
+     *
+     * @example
+     * ```
+     * engine.script({
+     *   start: [
+     *     engine.action.voice('./rick-astley-never-gonna-give-you-up.mp3'),
+     *     engine.action.say('Rick', 'Never gonna give you up'),
+     *   ]
+     * })
+     * ```
      */
-    voice: (voice: string) => ValidAction;
+    voice: VoiceAction<Languages>;
     /**
      * Stops currently playing voice
      */
@@ -718,6 +729,15 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
      * Data updates still will work in case Novely already was loaded
      */
     destroy(): void;
+    /**
+     * Funtion to get current storage data
+     *
+     * @example
+     * ```ts
+     * const currentStorageData = engine.getCurrentStorageData();
+     * ```
+     */
+    getCurrentStorageData: () => StorageData<$Language, $Data> | null;
 };
 
 export { type ActionInputOnInputMeta, type ActionInputSetup, type ActionProxy, type AllowedContent, type AudioHandle, type BackgroundImage, type BaseTranslationStrings, type Character, type CharacterHandle, type ConditionParams, type Context, type CoreData, type CustomHandler, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionableValue, type GetActionParameters, JP, KK, type Lang, type NovelyInit, type NovelyScreen, type Path, type PluralType, type Pluralization, RU, type Renderer, type RendererInit, type Save, type Stack, type StackHolder, type State, type StateFunction, type Storage, type StorageData, type StorageMeta, type Stored, type Story, type TextContent, type Thenable, type TranslationActions, type TypewriterSpeed, type ValidAction, localStorageStorage, novely };

package/dist/index.global.js

@@ -1054,6 +1054,9 @@ var Novely = (() => {
       let stored = await storage.get();
       for (const migration of migrations) {
         stored = migration(stored);
+        if (DEV && !stored) {
+          throw new Error("Migrations should return a value.");
+        }
       }
       if (overrideLanguage || !stored.meta[0]) {
         stored.meta[0] = getLanguageWithoutParameters();
@@ -1214,16 +1217,21 @@ var Novely = (() => {
       return current;
     };
     const exit = (force = false, saving = true) => {
-      if (interacted > 1 && !force && askBeforeExit) {
+      const ctx = renderer.getContext(MAIN_CONTEXT_KEY);
+      const stack = useStack(ctx);
+      const current = stack.value;
+      const isSaved = () => {
+        const { saves } = storageData.get();
+        const [currentPath, currentData] = stack.value;
+        return saves.some(([path, data2, [date, type2]]) => type2 === "manual" && times.has(date) && dequal(path, currentPath) && dequal(data2, currentData));
+      };
+      if (interacted > 1 && !force && askBeforeExit && !isSaved()) {
         renderer.ui.showExitPrompt();
         return;
       }
-      const ctx = renderer.getContext(MAIN_CONTEXT_KEY);
       if (interacted > 0 && saving) {
         save("auto");
       }
-      const stack = useStack(ctx);
-      const current = stack.value;
       stack.clear();
       ctx.clear(EMPTY_SET, EMPTY_SET, { music: EMPTY_SET, sounds: EMPTY_SET }, noop);
       renderer.ui.showScreen("mainmenu");
@@ -1397,7 +1405,13 @@ var Novely = (() => {
         push();
       },
       voice({ ctx, push }, [source]) {
-        ctx.audio.voice(source);
+        const [lang] = storageData.get().meta;
+        const audioSource = isString(source) ? source : source[lang];
+        if (!audioSource) {
+          push();
+          return;
+        }
+        ctx.audio.voice(audioSource);
         push();
       },
       stopVoice({ ctx, push }) {
@@ -1721,6 +1735,9 @@ var Novely = (() => {
       d: null,
       c: null
     };
+    const getCurrentStorageData = () => {
+      return coreData.get().dataLoaded ? klona(storageData.get()) : null;
+    };
     return {
       /**
        * Function to set game script
@@ -1805,7 +1822,16 @@ var Novely = (() => {
         dataLoaded.cancel();
         UIInstance.unmount();
         unsubscribeFromBrowserVisibilityChange();
-      }
+      },
+      /**
+       * Funtion to get current storage data
+       *
+       * @example
+       * ```ts
+       * const currentStorageData = engine.getCurrentStorageData();
+       * ```
+       */
+      getCurrentStorageData
     };
   };