@novely/core 0.31.3 → 0.33.0-beta.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
      */

package/dist/index.global.js

@@ -642,6 +642,90 @@ var Novely = (() => {
       return lang;
     }
   };
+  var createReferFunction = (story) => {
+    const refer = (path) => {
+      let current = story;
+      let precurrent = story;
+      const blocks = [];
+      for (const [type, val] of path) {
+        if (type === "jump") {
+          precurrent = story;
+          current = current[val];
+        } else if (type === null) {
+          precurrent = current;
+          current = current[val];
+        } else if (type === "choice") {
+          blocks.push(precurrent);
+          current = current[val + 1][1];
+        } else if (type === "condition") {
+          blocks.push(precurrent);
+          current = current[2][val];
+        } else if (type === "block") {
+          blocks.push(precurrent);
+          current = story[val];
+        } else if (type === "block:exit" || type === "choice:exit" || type === "condition:exit") {
+          current = blocks.pop();
+        }
+      }
+      return current;
+    };
+    return refer;
+  };
+  var exitPath = ({ path, refer, onExitImpossible }) => {
+    const last = path.at(-1);
+    const ignore = [];
+    let wasExitImpossible = false;
+    if (!isAction(refer(path))) {
+      if (last && isNull(last[0]) && isNumber(last[1])) {
+        last[1]--;
+      } else {
+        path.pop();
+      }
+    }
+    if (isExitImpossible(path)) {
+      const referred = refer(path);
+      if (isAction(referred) && isSkippedDuringRestore(referred[0])) {
+        onExitImpossible();
+      }
+      wasExitImpossible = true;
+      return {
+        exitImpossible: wasExitImpossible
+      };
+    }
+    for (let i = path.length - 1; i > 0; i--) {
+      const [name] = path[i];
+      if (isBlockExitStatement(name)) {
+        ignore.push(name);
+      }
+      if (!isBlockStatement(name))
+        continue;
+      if (ignore.at(-1)?.startsWith(name)) {
+        ignore.pop();
+        continue;
+      }
+      path.push([`${name}:exit`]);
+      const prev = findLastPathItemBeforeItemOfType(path.slice(0, i + 1), name);
+      if (prev)
+        path.push([null, prev[1] + 1]);
+      if (!isAction(refer(path))) {
+        path.pop();
+        continue;
+      }
+      break;
+    }
+    return {
+      exitImpossible: wasExitImpossible
+    };
+  };
+  var nextPath = (path) => {
+    const last = path.at(-1);
+    if (last && (isNull(last[0]) || last[0] === "jump") && isNumber(last[1])) {
+      last[1]++;
+    } else {
+      path.push([null, 0]);
+    }
+    return path;
+  };
 
   // ../../node_modules/.pnpm/dequal@2.0.3/node_modules/dequal/lite/index.mjs
   var has = Object.prototype.hasOwnProperty;
@@ -1169,10 +1253,12 @@ var Novely = (() => {
           }
         }
       }
-      match("clear", [keep, characters2, audio], {
-        ctx: context,
-        data: latest[1]
-      });
+      if (context.meta.goingBack) {
+        match("clear", [keep, characters2, audio], {
+          ctx: context,
+          data: latest[1]
+        });
+      }
       const lastQueueItem = queue.at(-1) || [];
       const lastQueueItemRequiresUserAction = isSkippedDuringRestore(lastQueueItem[0]) || isUserRequiredAction(lastQueueItem);
       await run((item) => {
@@ -1190,32 +1276,7 @@ var Novely = (() => {
       context.meta.restoring = context.meta.goingBack = false;
       render(context);
     };
-    const refer = (path) => {
-      let current = story;
-      let precurrent = story;
-      const blocks = [];
-      for (const [type, val] of path) {
-        if (type === "jump") {
-          precurrent = story;
-          current = current[val];
-        } else if (type === null) {
-          precurrent = current;
-          current = current[val];
-        } else if (type === "choice") {
-          blocks.push(precurrent);
-          current = current[val + 1][1];
-        } else if (type === "condition") {
-          blocks.push(precurrent);
-          current = current[2][val];
-        } else if (type === "block") {
-          blocks.push(precurrent);
-          current = story[val];
-        } else if (type === "block:exit" || type === "choice:exit" || type === "condition:exit") {
-          current = blocks.pop();
-        }
-      }
-      return current;
-    };
+    const refer = createReferFunction(story);
     const exit = (force = false, saving = true) => {
       const ctx = renderer.getContext(MAIN_CONTEXT_KEY);
       const stack = useStack(ctx);
@@ -1340,15 +1401,6 @@ var Novely = (() => {
       stack.push(current);
       save("auto");
     };
-    const nextPath = (path) => {
-      const last = path.at(-1);
-      if (last && (isNull(last[0]) || last[0] === "jump") && isNumber(last[1])) {
-        last[1]++;
-      } else {
-        path.push([null, 0]);
-      }
-      return path;
-    };
     const next = (ctx) => {
       const stack = useStack(ctx);
       const path = stack.value[0];
@@ -1405,7 +1457,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 }) {
@@ -1607,49 +1665,19 @@ var Novely = (() => {
       exit({ ctx, data: data2 }) {
         if (ctx.meta.restoring)
           return;
-        const stack = useStack(ctx);
-        const path = stack.value[0];
-        const last = path.at(-1);
-        const ignore = [];
-        if (!isAction(refer(path))) {
-          if (last && isNull(last[0]) && isNumber(last[1])) {
-            last[1]--;
-          } else {
-            path.pop();
-          }
-        }
-        if (isExitImpossible(path)) {
-          const referred = refer(path);
-          if (isAction(referred) && isSkippedDuringRestore(referred[0])) {
+        const { exitImpossible } = exitPath({
+          path: useStack(ctx).value[0],
+          refer,
+          onExitImpossible: () => {
             match("end", [], {
               ctx,
               data: data2
             });
           }
-          return;
-        }
-        for (let i = path.length - 1; i > 0; i--) {
-          const [name] = path[i];
-          if (isBlockExitStatement(name)) {
-            ignore.push(name);
-          }
-          if (!isBlockStatement(name))
-            continue;
-          if (ignore.at(-1)?.startsWith(name)) {
-            ignore.pop();
-            continue;
-          }
-          path.push([`${name}:exit`]);
-          const prev = findLastPathItemBeforeItemOfType(path.slice(0, i + 1), name);
-          if (prev)
-            path.push([null, prev[1] + 1]);
-          if (!isAction(refer(path))) {
-            path.pop();
-            continue;
-          }
-          break;
+        });
+        if (!exitImpossible) {
+          render(ctx);
         }
-        render(ctx);
       },
       preload({ ctx, push }, [source]) {
         if (!ctx.meta.goingBack && !ctx.meta.restoring && !PRELOADED_ASSETS.has(source)) {