@novely/core 0.10.0 → 0.11.0

package/dist/index.d.ts

@@ -14,7 +14,7 @@ type Character<LanguageKeys extends string = string> = {
 };
 
 type Thenable<T> = T | Promise<T>;
-type PathItem = [null, number | string] | ['choice' & Record<never, never>, number] | ['condition' & Record<never, never>, string] | ['exit' & Record<never, never>];
+type PathItem = [null, number | string] | ['choice', number] | ['choice:exit'] | ['condition', string] | ['condition:exit'] | ['exit'] | ['block', string] | ['block:exit'];
 type Path = PathItem[];
 type State = Record<string, any>;
 type Data = Record<string, any>;
@@ -44,8 +44,9 @@ type NovelyScreen = 'mainmenu' | 'game' | 'saves' | 'settings';
 type DeepPartial<T> = unknown extends T ? T : T extends object ? {
     [P in keyof T]?: T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : DeepPartial<T[P]>;
 } : T;
+type NonEmptyRecord<T extends Record<PropertyKey, unknown>> = keyof T extends never ? never : T;
 
-type ValidAction = ['choice', [number]] | ['clear', [Set<keyof DefaultActionProxyProvider>?, Set<string>?]] | ['condition', [() => boolean, Record<string, ValidAction[]>]] | ['dialog', [string | undefined, Unwrappable, string | undefined]] | ['end', []] | ['showBackground', [string]] | ['playMusic', [string]] | ['stopMusic', [string]] | ['jump', [string]] | ['showCharacter', [string, keyof Character['emotions'], string?, string?]] | ['hideCharacter', [string, string?, string?, number?]] | ['animateCharacter', [string, number, ...string[]]] | ['wait', [FunctionableValue<number>]] | ['function', [() => Thenable<void>]] | ['input', [string, (meta: ActionInputOnInputMeta) => void, ActionInputSetup?]] | ['custom', [CustomHandler]] | ['vibrate', [...number[]]] | ['next', []] | ['text', [...string[]]] | ['exit'] | ['preload', [string]] | ValidAction[];
+type ValidAction = ['choice', [number]] | ['clear', [Set<keyof DefaultActionProxyProvider>?, Set<string>?]] | ['condition', [() => boolean, Record<string, ValidAction[]>]] | ['dialog', [string | undefined, Unwrappable, string | undefined]] | ['end', []] | ['showBackground', [string | NonEmptyRecord<BackgroundImage>]] | ['playMusic', [string]] | ['stopMusic', [string]] | ['jump', [string]] | ['showCharacter', [string, keyof Character['emotions'], string?, string?]] | ['hideCharacter', [string, string?, string?, number?]] | ['animateCharacter', [string, number, ...string[]]] | ['wait', [FunctionableValue<number>]] | ['function', [() => Thenable<void>]] | ['input', [string, (meta: ActionInputOnInputMeta) => void, ActionInputSetup?]] | ['custom', [CustomHandler]] | ['vibrate', [...number[]]] | ['next', []] | ['text', [...string[]]] | ['exit', []] | ['preload', [string]] | ['block', [string]] | ValidAction[];
 type Story = Record<string, ValidAction[]>;
 type Unwrappable = string | ((lang: string, obj: Record<string, unknown>) => string) | Record<string, string | (() => string)>;
 type FunctionableValue<T> = T | (() => T);
@@ -100,6 +101,7 @@ interface ActionInputOnInputMeta {
     value: string;
 }
 type ActionInputSetup = (input: HTMLInputElement, cleanup: (cb: () => void) => void) => void;
+type BackgroundImage = Partial<Record<"portrait" | "landscape" | "all", string>> & Record<(string), string>;
 type ActionProxyProvider<Characters extends Record<string, Character>> = {
     choice: {
         (...choices: ([Unwrappable, ValidAction[]] | [Unwrappable, ValidAction[], () => boolean])[]): ValidAction;
@@ -114,19 +116,15 @@ type ActionProxyProvider<Characters extends Record<string, Character>> = {
         (person: string, content: Unwrappable, emotion?: undefined): ValidAction;
     };
     end: () => ValidAction;
-    showBackground: (background: string) => ValidAction;
+    showBackground: <T extends string | BackgroundImage>(background: T extends string ? T : T extends Record<PropertyKey, unknown> ? NonEmptyRecord<T> : never) => ValidAction;
     playMusic: (audio: string) => ValidAction;
     stopMusic: (audio: string) => ValidAction;
     jump: (scene: string) => ValidAction;
     showCharacter: {
         <C extends keyof Characters>(character: C, emotion: keyof Characters[C]['emotions'], className?: string, style?: string): ValidAction;
     };
-    hideCharacter: {
-        <C extends keyof Characters>(character: C, className?: string, style?: string, duration?: number): ValidAction;
-    };
-    animateCharacter: {
-        <C extends keyof Characters>(character: C, timeout: number, ...classes: string[]): ValidAction;
-    };
+    hideCharacter: (character: keyof Characters, className?: string, style?: string, duration?: number) => ValidAction;
+    animateCharacter: (character: keyof Characters, timeout: number, ...classes: string[]) => ValidAction;
     wait: (time: FunctionableValue<number>) => ValidAction;
     function: (fn: (restoring: boolean, goingBack: boolean) => Thenable<void>) => ValidAction;
     input: (question: Unwrappable, onInput: (meta: ActionInputOnInputMeta) => void, setup?: ActionInputSetup) => ValidAction;
@@ -135,6 +133,7 @@ type ActionProxyProvider<Characters extends Record<string, Character>> = {
     next: () => ValidAction;
     text: (...text: Unwrappable[]) => ValidAction;
     preload: (source: string) => ValidAction;
+    block: (scene: string) => ValidAction;
 };
 type DefaultActionProxyProvider = ActionProxyProvider<Record<string, Character>>;
 type GetActionParameters<T extends Capitalize<keyof DefaultActionProxyProvider>> = Parameters<DefaultActionProxyProvider[Uncapitalize<T>]>;
@@ -165,7 +164,7 @@ interface RendererStore {
 }
 type Renderer = {
     character: (character: string) => CharacterHandle;
-    background: (background: string) => void;
+    background: (background: string | BackgroundImage) => void;
     dialog: (content: string, name: string, character?: string, emotion?: string) => (resolve: () => void, goingBack: boolean) => void;
     choices: (question: string, choices: ([string, ValidAction[]] | [string, ValidAction[], () => boolean])[]) => (resolve: (selected: number) => void) => void;
     input: (question: string, onInput: Parameters<DefaultActionProxyProvider['input']>[1], setup?: Parameters<DefaultActionProxyProvider['input']>[2]) => (resolve: () => void) => void;

package/dist/index.global.js

@@ -141,6 +141,13 @@ var Novely = (() => {
     novely: () => novely
   });
 
+  // src/constants.ts
+  var SKIPPED_DURING_RESTORE = /* @__PURE__ */ new Set(["dialog", "choice", "input", "vibrate", "text"]);
+  var BLOCK_EXIT_STATEMENTS = /* @__PURE__ */ new Set(["choice:exit", "condition:exit", "block:exit"]);
+  var BLOCK_STATEMENTS = /* @__PURE__ */ new Set(["choice", "condition", "block"]);
+  var EMPTY_SET = /* @__PURE__ */ new Set();
+  var DEFAULT_TYPEWRITER_SPEED = "Medium";
+
   // src/utils.ts
   var matchAction = (values) => {
     return (action, props) => {
@@ -213,8 +220,8 @@ var Novely = (() => {
     }
   };
   var findLastIndex = (array, fn) => {
-    for (let i = array.length - 1; i > 0; i--) {
-      if (fn(array[i])) {
+    for (let i = array.length - 1; i >= 0; i--) {
+      if (fn(array[i], array[i + 1])) {
         return i;
       }
     }
@@ -242,6 +249,24 @@ var Novely = (() => {
     });
     return { resolve, reject, promise };
   };
+  var findLastPathItemBeforeItemOfType = (path, name) => {
+    const index = findLastIndex(path, ([_name, _value], next) => {
+      return isNull(_name) && isNumber(_value) && next != null && next[0] === name;
+    });
+    return path[index];
+  };
+  var isBlockStatement = (statement) => {
+    return BLOCK_STATEMENTS.has(statement);
+  };
+  var isBlockExitStatement = (statement) => {
+    return BLOCK_EXIT_STATEMENTS.has(statement);
+  };
+  var isSkippedDurigRestore = (item) => {
+    return SKIPPED_DURING_RESTORE.has(item);
+  };
+  var isAction = (element) => {
+    return Array.isArray(element) && isString(element[0]);
+  };
 
   // src/global.ts
   var PRELOADED_ASSETS = /* @__PURE__ */ new Set();
@@ -298,11 +323,6 @@ var Novely = (() => {
     return val;
   }
 
-  // src/constants.ts
-  var SKIPPED_DURING_RESTORE = /* @__PURE__ */ new Set(["dialog", "choice", "input", "vibrate", "text"]);
-  var EMPTY_SET = /* @__PURE__ */ new Set();
-  var DEFAULT_TYPEWRITER_SPEED = "Medium";
-
   // ../t9n/dist/index.js
   var g = (e, r) => {
     let o = [];
@@ -534,31 +554,46 @@ var Novely = (() => {
         latest = klona(initial);
       }
       restoring = true, stack.value = latest;
+      const path = stack.value[0];
       let current = story;
+      let precurrent;
+      let ignoreNested = false;
       let index = 0;
       const max = stack.value[0].reduce((acc, [type, val]) => {
-        if (isNull(type) && isNumber(val))
+        if (isNull(type) && isNumber(val)) {
           return acc + 1;
+        }
         return acc;
       }, 0);
       const queue = [];
       const keep = /* @__PURE__ */ new Set();
       const characters2 = /* @__PURE__ */ new Set();
-      for (const [type, val] of stack.value[0]) {
+      const blocks = [];
+      for (const [type, val] of path) {
         if (type === null) {
-          if (isString(val)) {
-            current = current[val];
-          } else if (isNumber(val)) {
+          precurrent = current;
+          if (isNumber(val)) {
             index++;
-            for (let i = 0; i <= val; i++) {
-              const [action2, ...meta] = current[i];
+            let startIndex = 0;
+            if (ignoreNested) {
+              const prev = findLastPathItemBeforeItemOfType(path.slice(0, index), "block");
+              if (prev) {
+                startIndex = prev[1];
+                ignoreNested = false;
+              }
+            }
+            for (let i = startIndex; i <= val; i++) {
+              const item = current[i];
+              if (!isAction(item))
+                continue;
+              const [action2, ...meta] = item;
               const push2 = () => {
                 keep.add(action2);
                 queue.push([action2, meta]);
               };
               if (action2 === "showCharacter")
                 characters2.add(meta[0]);
-              if (SKIPPED_DURING_RESTORE.has(action2) || isUserRequiredAction(action2, meta)) {
+              if (isSkippedDurigRestore(action2) || isUserRequiredAction(action2, meta)) {
                 if (index === max && i === val) {
                   push2();
                 } else {
@@ -567,12 +602,20 @@ var Novely = (() => {
               }
               push2();
             }
-            current = current[val];
           }
+          current = current[val];
         } else if (type === "choice") {
+          blocks.push(precurrent = current);
           current = current[val + 1][1];
         } else if (type === "condition") {
+          blocks.push(precurrent = current);
           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();
+          ignoreNested = true;
         }
       }
       renderer.ui.showScreen("game");
@@ -587,7 +630,8 @@ var Novely = (() => {
               const c0 = _meta[0];
               const c1 = meta[0];
               const isIdenticalID = c0.id && c1.id && c0.id === c1.id;
-              return isIdenticalID || str(c0) === str(c1);
+              const isIdenticalByReference = c0 === c1;
+              return isIdenticalID || isIdenticalByReference || str(c0) === str(c1);
             });
             if (notLatest)
               continue;
@@ -618,15 +662,25 @@ var Novely = (() => {
       }
       restoring = goingBack = false, render();
     };
-    const refer = () => {
+    const refer = (path = stack.value[0]) => {
       let current = story;
-      for (const [type, val] of stack.value[0]) {
+      let precurrent = story;
+      const blocks = [];
+      for (const [type, val] of path) {
         if (type === null) {
+          precurrent = current;
           current = current[val];
         } else if (type === "choice") {
+          blocks.push(precurrent = current);
           current = current[val + 1][1];
         } else if (type === "condition") {
+          blocks.push(precurrent = current);
           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;
@@ -749,9 +803,13 @@ var Novely = (() => {
         renderer.clear(goingBack, keep || EMPTY_SET, characters2 || EMPTY_SET)(push);
       },
       condition([condition]) {
-        const value = condition();
-        if (!restoring)
-          stack.value[0].push(["condition", String(value)], [null, 0]), render();
+        if (!restoring) {
+          stack.value[0].push(
+            ["condition", String(condition())],
+            [null, 0]
+          );
+          render();
+        }
       },
       end() {
         match("clear", []);
@@ -803,24 +861,55 @@ var Novely = (() => {
         renderer.text(text.map((content) => unwrap(content)).join(" "), forward, goingBack);
       },
       exit() {
+        if (restoring)
+          return;
         const path = stack.value[0];
-        let exited = false;
+        const last = path.at(-1);
+        const ignore = [];
+        if (!isAction(refer(path))) {
+          if (last && isNull(last[0]) && isNumber(last[1])) {
+            last[1]--;
+          } else {
+            path.pop();
+          }
+        }
         for (let i = path.length - 1; i > 0; i--) {
-          if (path[i][0] !== "choice" && path[i][0] !== "condition")
+          const [name] = path[i];
+          if (isBlockExitStatement(name)) {
+            ignore.push(name);
+          }
+          if (!isBlockStatement(name))
             continue;
-          exited = true;
-          stack.value[0] = path.slice(0, i);
-          next();
+          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 (exited)
-          render();
+        render();
       },
       preload([source]) {
         if (!PRELOADED_ASSETS.has(source) && !goingBack && !restoring) {
           PRELOADED_ASSETS.add(document.createElement("img").src = source);
         }
         push();
+      },
+      block([scene]) {
+        if (!restoring) {
+          stack.value[0].push(
+            ["block", scene],
+            [null, 0]
+          );
+          render();
+        }
       }
     });
     const enmemory = () => {
@@ -834,13 +923,11 @@ var Novely = (() => {
     const next = () => {
       const path = stack.value[0];
       const last = path.at(-1);
-      if (!last)
-        return;
-      if (isNull(last[0]) && isNumber(last[1])) {
-        last[1] = last[1] + 1;
-        return;
+      if (last && isNull(last[0]) && isNumber(last[1])) {
+        last[1]++;
+      } else {
+        path.push([null, 0]);
       }
-      path.push([null, 0]);
     };
     const render = () => {
       const referred = refer();