@novely/core 0.40.2 → 0.41.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-interface LocalStorageStorageSettings {
+type LocalStorageStorageSettings = {
     key: string;
-}
-interface Storage {
+};
+type NovelyStorage = {
     get: () => Promise<StorageData>;
     set: (data: StorageData) => Promise<void>;
-}
-declare const localStorageStorage: (options: LocalStorageStorageSettings) => Storage;
+};
+declare const localStorageStorage: (options: LocalStorageStorageSettings) => NovelyStorage;
 
 type PluralType = Intl.LDMLPluralRule;
 type Pluralization = Partial<Record<PluralType, string>>;
@@ -328,6 +328,7 @@ type CharactersData<$Characters extends Record<string, Character<Lang>>> = {
     };
 };
 type AssetsPreloading = 'lazy' | 'blocking' | 'automatic';
+type CloneFN = <T>(value: T) => T;
 interface NovelyInit<$Language extends Lang, $Characters extends Record<string, Character<NoInfer<$Language>>>, $State extends State, $Data extends Data, $Actions extends Record<string, (...args: any[]) => ValidAction>> {
     /**
      * An object containing the characters in the game.
@@ -406,7 +407,7 @@ interface NovelyInit<$Language extends Lang, $Characters extends Record<string,
      * An object that provides access to the game's storage system.
      * @default localStorage // at key `novely-game-storage`
      */
-    storage?: Storage;
+    storage?: NovelyStorage;
     /**
      * Delay loading data until Promise is resolved
      */
@@ -509,6 +510,10 @@ interface NovelyInit<$Language extends Lang, $Characters extends Record<string,
      * Fetching function
      */
     fetch?: typeof fetch;
+    /**
+     * Function for clonning operations
+     */
+    cloneFunction?: CloneFN;
     /**
      * When page is going to be unloaded will call `storage.set` method
      * If 'prod' is passed enable only in production env.
@@ -796,7 +801,7 @@ type ChoiceParams<T> = T extends TypeEssentials<infer $Lang, infer $State, any,
 type FunctionParams<T> = T extends TypeEssentials<infer $Lang, infer $State, any, any> ? FunctionActionProps<$Lang, $State> : never;
 type InputHandler<T> = T extends TypeEssentials<infer $Lang, infer $State, any, any> ? ActionInputOnInputMeta<$Lang, $State> : never;
 
-declare const novely: <$Language extends string, $Characters extends Record<string, Character<$Language>>, $State extends State, $Data extends Data, $Actions extends Record<string, (...args: any[]) => ValidAction>>({ characters, characterAssetSizes, defaultEmotions, storage, storageDelay, renderer: createRenderer, initialScreen, translation, state: defaultState, data: defaultData, autosaves, migrations, throttleTimeout, getLanguage, overrideLanguage, askBeforeExit, preloadAssets, parallelAssetsDownloadLimit, fetch: request, saveOnUnload, startKey }: NovelyInit<$Language, $Characters, $State, $Data, $Actions>) => {
+declare const novely: <$Language extends string, $Characters extends Record<string, Character<$Language>>, $State extends State, $Data extends Data, $Actions extends Record<string, (...args: any[]) => ValidAction>>({ characters, characterAssetSizes, defaultEmotions, storage, storageDelay, renderer: createRenderer, initialScreen, translation, state: defaultState, data: defaultData, autosaves, migrations, throttleTimeout, getLanguage, overrideLanguage, askBeforeExit, preloadAssets, parallelAssetsDownloadLimit, fetch: request, cloneFunction: clone, saveOnUnload, startKey, }: NovelyInit<$Language, $Characters, $State, $Data, $Actions>) => {
     /**
      * Function to set game script
      *
@@ -858,7 +863,7 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
      */
     typeEssentials: TypeEssentials<$Language, $State, $Data, $Characters>;
     /**
-     * Replaces content inside {{braces}} with using global data
+     * Replaces content inside {{braces}} using global data
      * @example
      * ```ts
      * data({ name: 'Alexei' })
@@ -870,6 +875,10 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
      * ```
      */
     templateReplace(content: TextContent<$Language, $Data>): string;
+    /**
+     * Same as `templateReplace` but uses state and requires explicitly providing it
+     */
+    templateReplaceState(content: TextContent<$Language, $State>, state: State): string;
     /**
      * Cancel data loading, hide UI, ignore page change events
      * Data updates still will work in case Novely already was loaded
@@ -944,4 +953,4 @@ declare const extendAction: <Part0 extends Record<string, (...args: any[]) => Va
  */
 declare const asset: (...variants: string[]) => NovelyAsset;
 
-export { type ActionInputOnInputMeta, type ActionInputSetup, type ActionInputSetupCleanup, type ActionProxy, type AllowedContent, type AudioHandle, type BackgroundImage, type BaseTranslationStrings, type Character, type CharacterAssetSizes, type CharacterHandle, type CharactersData, type ChoiceParams, type ConditionParams, type Context, type CoreData, type CustomActionHandle, type CustomHandler, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionParams, type FunctionableValue, type GetActionParameters, type InputHandler, JP, KK, type Lang, type NovelyInit, type NovelyScreen, type Path, type PluralType, type Pluralization, RU, type Renderer, type RendererInit, type RendererInitPreviewReturn, 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 TypeEssentials, type TypewriterSpeed, type ValidAction, asset, extendAction, localStorageStorage, novely };
+export { type ActionInputOnInputMeta, type ActionInputSetup, type ActionInputSetupCleanup, type ActionProxy, type AllowedContent, type AudioHandle, type BackgroundImage, type BaseTranslationStrings, type Character, type CharacterAssetSizes, type CharacterHandle, type CharactersData, type ChoiceParams, type ConditionParams, type Context, type CoreData, type CustomActionHandle, type CustomHandler, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionParams, type FunctionableValue, type GetActionParameters, type InputHandler, JP, KK, type Lang, type NovelyInit, type NovelyScreen, type NovelyStorage, type Path, type PluralType, type Pluralization, RU, type Renderer, type RendererInit, type RendererInitPreviewReturn, type Save, type Stack, type StackHolder, type State, type StateFunction, type StorageData, type StorageMeta, type Stored, type Story, type TextContent, type Thenable, type TranslationActions, type TypeEssentials, type TypewriterSpeed, type ValidAction, asset, extendAction, localStorageStorage, novely };

package/dist/index.global.js

@@ -87,33 +87,6 @@ var Novely = (() => {
   // ../../node_modules/.pnpm/esm-env@1.0.0/node_modules/esm-env/prod-ssr.js
   var DEV = false;
 
-  // ../../node_modules/.pnpm/klona@2.0.6/node_modules/klona/json/index.mjs
-  function klona(val) {
-    var k, out, tmp;
-    if (Array.isArray(val)) {
-      out = Array(k = val.length);
-      while (k--) out[k] = (tmp = val[k]) && typeof tmp === "object" ? klona(tmp) : tmp;
-      return out;
-    }
-    if (Object.prototype.toString.call(val) === "[object Object]") {
-      out = {};
-      for (k in val) {
-        if (k === "__proto__") {
-          Object.defineProperty(out, k, {
-            value: klona(val[k]),
-            configurable: true,
-            enumerable: true,
-            writable: true
-          });
-        } else {
-          out[k] = (tmp = val[k]) && typeof tmp === "object" ? klona(tmp) : tmp;
-        }
-      }
-      return out;
-    }
-    return val;
-  }
-
   // ../../node_modules/.pnpm/es-toolkit@1.16.0/node_modules/es-toolkit/dist/function/once.mjs
   function once(func) {
     let called = false;
@@ -630,8 +603,8 @@ var Novely = (() => {
     };
     return useStack;
   };
-  var mapSet = (set, fn) => {
-    return [...set].map(fn);
+  var mapSet = (set2, fn) => {
+    return [...set2].map(fn);
   };
   var isImageAsset = (asset2) => {
     return isString(asset2) && isCSSImage(asset2);
@@ -783,7 +756,7 @@ var Novely = (() => {
   var isBlockingAction = (action) => {
     return isUserRequiredAction(action) || isSkippedDuringRestore(action[0]) && action[0] !== "vibrate";
   };
-  var collectActionsBeforeBlockingAction = ({ path, refer }) => {
+  var collectActionsBeforeBlockingAction = ({ path, refer, clone }) => {
     const collection = [];
     let action = refer(path);
     while (true) {
@@ -806,11 +779,12 @@ var Novely = (() => {
           for (let i = 0; i < choiceProps.length; i++) {
             const branchContent = choiceProps[i];
             if (!Array.isArray(branchContent)) continue;
-            const virtualPath = klona(path);
+            const virtualPath = clone(path);
             virtualPath.push(["choice", i], [null, 0]);
             const innerActions = collectActionsBeforeBlockingAction({
               path: virtualPath,
-              refer
+              refer,
+              clone
             });
             collection.push(...innerActions);
           }
@@ -818,11 +792,12 @@ var Novely = (() => {
           const conditionProps = props;
           const conditions = Object.keys(conditionProps[1]);
           for (const condition of conditions) {
-            const virtualPath = klona(path);
+            const virtualPath = clone(path);
             virtualPath.push(["condition", condition], [null, 0]);
             const innerActions = collectActionsBeforeBlockingAction({
               path: virtualPath,
-              refer
+              refer,
+              clone
             });
             collection.push(...innerActions);
           }
@@ -939,15 +914,62 @@ var Novely = (() => {
     const update = (fn) => {
       push(current = fn(current));
     };
-    const set = (val) => {
+    const set2 = (val) => {
       update(() => val);
     };
     const get = () => {
       return current;
     };
-    return { subscribe, update, set, get };
+    return { subscribe, update, set: set2, get };
   };
 
+  // ../../node_modules/.pnpm/klona@2.0.6/node_modules/klona/full/index.mjs
+  function set(obj, key, val) {
+    if (typeof val.value === "object") val.value = klona(val.value);
+    if (!val.enumerable || val.get || val.set || !val.configurable || !val.writable || key === "__proto__") {
+      Object.defineProperty(obj, key, val);
+    } else obj[key] = val.value;
+  }
+  function klona(x) {
+    if (typeof x !== "object") return x;
+    var i = 0, k, list, tmp, str2 = Object.prototype.toString.call(x);
+    if (str2 === "[object Object]") {
+      tmp = Object.create(x.__proto__ || null);
+    } else if (str2 === "[object Array]") {
+      tmp = Array(x.length);
+    } else if (str2 === "[object Set]") {
+      tmp = /* @__PURE__ */ new Set();
+      x.forEach(function(val) {
+        tmp.add(klona(val));
+      });
+    } else if (str2 === "[object Map]") {
+      tmp = /* @__PURE__ */ new Map();
+      x.forEach(function(val, key) {
+        tmp.set(klona(key), klona(val));
+      });
+    } else if (str2 === "[object Date]") {
+      tmp = /* @__PURE__ */ new Date(+x);
+    } else if (str2 === "[object RegExp]") {
+      tmp = new RegExp(x.source, x.flags);
+    } else if (str2 === "[object DataView]") {
+      tmp = new x.constructor(klona(x.buffer));
+    } else if (str2 === "[object ArrayBuffer]") {
+      tmp = x.slice(0);
+    } else if (str2.slice(-6) === "Array]") {
+      tmp = new x.constructor(x);
+    }
+    if (tmp) {
+      for (list = Object.getOwnPropertySymbols(x); i < list.length; i++) {
+        set(tmp, list[i], Object.getOwnPropertyDescriptor(x, list[i]));
+      }
+      for (i = 0, list = Object.getOwnPropertyNames(x); i < list.length; i++) {
+        if (Object.hasOwnProperty.call(tmp, k = list[i]) && tmp[k] === x[k]) continue;
+        set(tmp, k, Object.getOwnPropertyDescriptor(x, k));
+      }
+    }
+    return tmp || x;
+  }
+
   // src/translation.ts
   var RGX = /{{(.*?)}}/g;
   var split = (input, delimeters) => {
@@ -1347,6 +1369,7 @@ var Novely = (() => {
     preloadAssets = "lazy",
     parallelAssetsDownloadLimit = 15,
     fetch: request = fetch,
+    cloneFunction: clone = klona,
     saveOnUnload = true,
     startKey = "start"
   }) => {
@@ -1414,7 +1437,7 @@ var Novely = (() => {
         };
       }
     });
-    const getDefaultSave = (state = {}) => {
+    const getDefaultSave = (state) => {
       return [
         [
           ["jump", startKey],
@@ -1436,7 +1459,7 @@ var Novely = (() => {
     };
     const initialData = {
       saves: [],
-      data: klona(defaultData),
+      data: clone(defaultData),
       meta: [getLanguageWithoutParameters(), DEFAULT_TYPEWRITER_SPEED, 1, 1, 1]
     };
     const storageData = store(initialData);
@@ -1486,7 +1509,7 @@ var Novely = (() => {
       storageData.set(stored);
     };
     storageDelay.then(getStoredData);
-    const initial = getDefaultSave(klona(defaultState));
+    const initial = getDefaultSave(clone(defaultState));
     const unsubscribeFromBrowserVisibilityChange = setupBrowserVisibilityChangeListeners({
       onChange: throttledEmergencyOnStorageDataChange
     });
@@ -1494,7 +1517,7 @@ var Novely = (() => {
       if (!coreData.get().dataLoaded) return;
       if (!autosaves && type === "auto") return;
       const stack = useStack(MAIN_CONTEXT_KEY);
-      const current = klona(stack.value);
+      const current = clone(stack.value);
       storageData.update((prev) => {
         const replace2 = () => {
           prev.saves[prev.saves.length - 1] = current;
@@ -1524,7 +1547,7 @@ var Novely = (() => {
     };
     const newGame = () => {
       if (!coreData.get().dataLoaded) return;
-      const save2 = getDefaultSave(klona(defaultState));
+      const save2 = getDefaultSave(clone(defaultState));
       if (autosaves) {
         storageData.update((prev) => {
           return prev.saves.push(save2), prev;
@@ -1537,7 +1560,7 @@ var Novely = (() => {
       renderer.ui.showScreen("game");
       render(context);
     };
-    const set = (save2, ctx) => {
+    const set2 = (save2, ctx) => {
       const stack = useStack(ctx || MAIN_CONTEXT_KEY);
       stack.value = save2;
       return restore(save2);
@@ -1553,7 +1576,7 @@ var Novely = (() => {
       if (!coreData.get().dataLoaded) return;
       let latest = save2 || storageData.get().saves.at(-1);
       if (!latest) {
-        latest = klona(initial);
+        latest = clone(initial);
         storageData.update((prev) => {
           prev.saves.push(latest);
           return prev;
@@ -1665,7 +1688,7 @@ var Novely = (() => {
       const processor = createQueueProcessor(queue, {
         skip: EMPTY_SET
       });
-      useStack(ctx).push(klona(save2));
+      useStack(ctx).push(clone(save2));
       const assets = [];
       await processor.run(([action2, ...props]) => {
         if (isAudioAction(action2)) return;
@@ -1735,7 +1758,7 @@ var Novely = (() => {
       mainContextKey: MAIN_CONTEXT_KEY,
       characters: getCharactersData(characters),
       characterAssetSizes,
-      set,
+      set: set2,
       restore,
       save,
       newGame,
@@ -1760,7 +1783,7 @@ var Novely = (() => {
     const enmemory = (ctx) => {
       if (ctx.meta.restoring) return;
       const stack = useStack(ctx);
-      const current = klona(stack.value);
+      const current = clone(stack.value);
       current[2][1] = "auto";
       stack.push(current);
       save("auto");
@@ -1788,8 +1811,9 @@ var Novely = (() => {
         if (!isBlockingAction([action2, ...props])) return;
         try {
           const collection = collectActionsBeforeBlockingAction({
-            path: nextPath(klona(useStack(ctx).value[0])),
-            refer
+            path: nextPath(clone(useStack(ctx).value[0])),
+            refer,
+            clone
           });
           for (const [action3, ...props2] of collection) {
             huntAssets({
@@ -2171,7 +2195,7 @@ var Novely = (() => {
       c: null
     };
     const getCurrentStorageData = () => {
-      return coreData.get().dataLoaded ? klona(storageData.get()) : null;
+      return coreData.get().dataLoaded ? clone(storageData.get()) : null;
     };
     const setStorageData = (data2) => {
       if (destroyed) {
@@ -2244,7 +2268,7 @@ var Novely = (() => {
        */
       typeEssentials,
       /**
-       * Replaces content inside {{braces}} with using global data
+       * Replaces content inside {{braces}} using global data
        * @example
        * ```ts
        * data({ name: 'Alexei' })
@@ -2258,6 +2282,12 @@ var Novely = (() => {
       templateReplace(content) {
         return templateReplace(content);
       },
+      /**
+       * Same as `templateReplace` but uses state and requires explicitly providing it
+       */
+      templateReplaceState(content, state) {
+        return templateReplace(content, state);
+      },
       /**
        * Cancel data loading, hide UI, ignore page change events
        * Data updates still will work in case Novely already was loaded