@novely/core 0.38.2 → 0.39.0

package/dist/index.js

@@ -49,10 +49,10 @@ var MAIN_CONTEXT_KEY = "$MAIN";
 var STACK_MAP = /* @__PURE__ */ new Map();
 var CUSTOM_ACTION_MAP = /* @__PURE__ */ new Map();
 var PRELOADED_ASSETS = /* @__PURE__ */ new Set();
-var RESOURCE_TYPE_CACHE = /* @__PURE__ */ new Map();
+var ASSETS_TO_PRELOAD = /* @__PURE__ */ new Set();
 
 // src/utils.ts
-import { DEV } from "esm-env";
+import { DEV as DEV2 } from "esm-env";
 
 // ../../node_modules/.pnpm/klona@2.0.6/node_modules/klona/json/index.mjs
 function klona(val) {
@@ -81,6 +81,127 @@ function klona(val) {
   return val;
 }
 
+// src/utils.ts
+import { default as memoize2 } from "micro-memoize";
+
+// src/asset.ts
+import { DEV } from "esm-env";
+
+// src/audio-codecs.ts
+var cut = (str2) => str2.replace(/^no$/, "");
+var audio = new Audio();
+var canPlay = (type) => !!cut(audio.canPlayType(type));
+var canPlayMultiple = (...types) => types.some((type) => canPlay(type));
+var supportsMap = {
+  mp3: canPlayMultiple("audio/mpeg;", "audio/mp3;"),
+  mpeg: canPlay("audio/mpeg;"),
+  opus: canPlay('audio/ogg; codecs="opus"'),
+  ogg: canPlay('audio/ogg; codecs="vorbis"'),
+  oga: canPlay('audio/ogg; codecs="vorbis"'),
+  wav: canPlayMultiple('audio/wav; codecs="1"', "audio/wav;"),
+  aac: canPlay("audio/aac;"),
+  caf: canPlay("audio/x-caf;"),
+  m4a: canPlayMultiple("audio/x-m4a;", "audio/m4a;", "audio/aac;"),
+  m4b: canPlayMultiple("audio/x-m4b;", "audio/m4b;", "audio/aac;"),
+  mp4: canPlayMultiple("audio/x-mp4;", "audio/mp4;", "audio/aac;"),
+  weba: canPlay('audio/webm; codecs="vorbis"'),
+  webm: canPlay('audio/webm; codecs="vorbis"'),
+  dolby: canPlay('audio/mp4; codecs="ec-3"'),
+  flac: canPlayMultiple("audio/x-flac;", "audio/flac;")
+};
+
+// src/image-formats.ts
+var avif = "data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAAB0AAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAIAAAACAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQ0MAAAAABNjb2xybmNseAACAAIAAYAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAACVtZGF0EgAKCBgANogQEAwgMg8f8D///8WfhwB8+ErK42A=";
+var jxl = "data:image/jxl;base64,/woIAAAMABKIAgC4AF3lEgAAFSqjjBu8nOv58kOHxbSN6wxttW1hSaLIODZJJ3BIEkkaoCUzGM6qJAE=";
+var webp = "data:image/webp;base64,UklGRjoAAABXRUJQVlA4IC4AAACyAgCdASoCAAIALmk0mk0iIiIiIgBoSygABc6WWgAA/veff/0PP8bA//LwYAAA";
+var supportsFormat = (source) => {
+  const { promise, resolve } = Promise.withResolvers();
+  const img = Object.assign(document.createElement("img"), {
+    src: source
+  });
+  img.onload = img.onerror = () => {
+    resolve(img.height === 2);
+  };
+  return promise;
+};
+var supportsMap2 = {
+  avif: false,
+  jxl: false,
+  webp: false
+};
+var formatsMap = {
+  avif,
+  jxl,
+  webp
+};
+var loadImageFormatsSupport = async () => {
+  const promises = [];
+  for (const [format, source] of Object.entries(formatsMap)) {
+    const promise = supportsFormat(source).then((supported) => {
+      supportsMap2[format] = supported;
+    });
+    promises.push(promise);
+  }
+  await Promise.all(promises);
+};
+loadImageFormatsSupport();
+
+// src/asset.ts
+import { default as memoize } from "micro-memoize";
+var getType = memoize((extensions) => {
+  if (extensions.every((extension) => HOWLER_SUPPORTED_FILE_FORMATS.has(extension))) {
+    return "audio";
+  }
+  if (extensions.every((extension) => SUPPORTED_IMAGE_FILE_FORMATS.has(extension))) {
+    return "image";
+  }
+  throw extensions;
+});
+var SUPPORT_MAPS = {
+  "image": supportsMap2,
+  "audio": supportsMap
+};
+var asset = memoize((...variants) => {
+  if (DEV && variants.length === 0) {
+    throw new Error(`Attempt to use "asset" function without arguments`);
+  }
+  const map = {};
+  const extensions = [];
+  for (const v of variants) {
+    const e = getUrlFileExtension(v);
+    map[e] = v;
+    extensions.push(e);
+  }
+  const type = getType(extensions);
+  const getSource = memoize(() => {
+    const support = SUPPORT_MAPS[type];
+    for (const extension of extensions) {
+      if (extension in support) {
+        if (support[extension]) {
+          return map[extension];
+        }
+      } else {
+        return map[extension];
+      }
+    }
+    if (DEV) {
+      throw new Error(`No matching asset was found for ${variants.map((v) => `"${v}"`).join(", ")}`);
+    }
+    return "";
+  });
+  return {
+    get source() {
+      return getSource();
+    },
+    get type() {
+      return type;
+    }
+  };
+});
+var isAsset = (suspect) => {
+  return suspect !== null && typeof suspect === "object" && "source" in suspect && "type" in suspect;
+};
+
 // src/utils.ts
 var matchAction = ({ getContext, onBeforeActionCall, push, forward }, values) => {
   return (action, props, { ctx, data }) => {
@@ -325,7 +446,7 @@ var createQueueProcessor = (queue, options) => {
   const processedQueue = [];
   const keep = /* @__PURE__ */ new Set();
   const characters = /* @__PURE__ */ new Set();
-  const audio = {
+  const audio2 = {
     music: /* @__PURE__ */ new Set(),
     sound: /* @__PURE__ */ new Set()
   };
@@ -350,14 +471,9 @@ var createQueueProcessor = (queue, options) => {
           });
           if (notLatest) continue;
         } else if ("skipOnRestore" in fn && fn.skipOnRestore) {
-          let getNext = () => {
-            const nextActions = next(i);
-            getNext = () => {
-              return nextActions;
-            };
-            return nextActions;
-          };
-          if (fn.skipOnRestore(getNext)) continue;
+          if (fn.skipOnRestore(() => next(i))) {
+            continue;
+          }
         }
       }
       processedQueue.push(item);
@@ -375,9 +491,9 @@ var createQueueProcessor = (queue, options) => {
       if (action === "showCharacter") {
         characters.add(params[0]);
       } else if (action === "playMusic") {
-        audio.music.add(params[0]);
+        audio2.music.add(unwrapAsset(params[0]));
       } else if (action === "playSound") {
-        audio.sound.add(params[0]);
+        audio2.sound.add(unwrapAsset(params[0]));
       }
       processedQueue.push(item);
     } else if (action === "showBackground" || action === "preload") {
@@ -414,7 +530,7 @@ var createQueueProcessor = (queue, options) => {
     keep: {
       keep,
       characters,
-      audio
+      audio: audio2
     }
   };
 };
@@ -461,15 +577,15 @@ var createUseStackFunction = (renderer) => {
 var mapSet = (set, fn) => {
   return [...set].map(fn);
 };
-var isImageAsset = (asset) => {
-  return isString(asset) && isCSSImage(asset);
+var isImageAsset = (asset2) => {
+  return isString(asset2) && isCSSImage(asset2);
 };
 var getUrlFileExtension = (address) => {
   try {
     const { pathname } = new URL(address, location.href);
     return pathname.split(".").at(-1).split("!")[0].split(":")[0];
   } catch (error) {
-    if (DEV) {
+    if (DEV2) {
       console.error(new Error(`Could not construct URL "${address}".`, { cause: error }));
     }
     return "";
@@ -482,43 +598,41 @@ var fetchContentType = async (request, url) => {
     });
     return response.headers.get("Content-Type") || "";
   } catch (error) {
-    if (DEV) {
+    if (DEV2) {
       console.error(new Error(`Failed to fetch file at "${url}"`, { cause: error }));
     }
     return "";
   }
 };
-var getResourseType = async (request, url) => {
-  if (RESOURCE_TYPE_CACHE.has(url)) {
-    return RESOURCE_TYPE_CACHE.get(url);
-  }
-  const encache = (value) => {
-    RESOURCE_TYPE_CACHE.set(url, value);
-    return value;
-  };
-  if (!isCSSImage(url)) {
-    return encache("other");
-  }
-  const extension = getUrlFileExtension(url);
-  if (HOWLER_SUPPORTED_FILE_FORMATS.has(extension)) {
-    return encache("audio");
-  }
-  if (SUPPORTED_IMAGE_FILE_FORMATS.has(extension)) {
-    return encache("image");
-  }
-  const contentType = await fetchContentType(request, url);
-  if (contentType.includes("audio")) {
-    return encache("audio");
-  }
-  if (contentType.includes("image")) {
-    return encache("image");
+var getResourseType = memoize2(
+  async (request, url) => {
+    if (!isCSSImage(url)) {
+      return "other";
+    }
+    const extension = getUrlFileExtension(url);
+    if (HOWLER_SUPPORTED_FILE_FORMATS.has(extension)) {
+      return "audio";
+    }
+    if (SUPPORTED_IMAGE_FILE_FORMATS.has(extension)) {
+      return "image";
+    }
+    const contentType = await fetchContentType(request, url);
+    if (contentType.includes("audio")) {
+      return "audio";
+    }
+    if (contentType.includes("image")) {
+      return "image";
+    }
+    return "other";
+  },
+  {
+    isPromise: true
   }
-  return encache("other");
-};
+);
 var capitalize = (str2) => {
   return str2[0].toUpperCase() + str2.slice(1);
 };
-var getIntlLanguageDisplayName = (lang) => {
+var getIntlLanguageDisplayName = memoize2((lang) => {
   try {
     const intl = new Intl.DisplayNames([lang], {
       type: "language"
@@ -527,7 +641,7 @@ var getIntlLanguageDisplayName = (lang) => {
   } catch {
     return lang;
   }
-};
+});
 var createReferFunction = (story) => {
   const refer = (path) => {
     let current = story;
@@ -671,6 +785,29 @@ var collectActionsBeforeBlockingAction = ({ path, refer }) => {
   }
   return collection;
 };
+var unwrapAsset = (asset2) => {
+  return isAsset(asset2) ? asset2.source : asset2;
+};
+var handleAudioAsset = (asset2) => {
+  if (DEV2 && isAsset(asset2) && asset2.type !== "audio") {
+    throw new Error("Attempt to use non-audio asset in audio action", { cause: asset2 });
+  }
+  return unwrapAsset(asset2);
+};
+var handleImageAsset = (asset2) => {
+  if (DEV2 && isAsset(asset2) && asset2.type !== "image") {
+    throw new Error("Attempt to use non-image asset in action that requires image assets", { cause: asset2 });
+  }
+  return unwrapAsset(asset2);
+};
+var getCharactersData = (characters) => {
+  const entries = Object.entries(characters);
+  const mapped = entries.map(([key, value]) => [key, { name: value.name, emotions: Object.keys(value.emotions) }]);
+  return Object.fromEntries(mapped);
+};
+var toArray = (target) => {
+  return Array.isArray(target) ? target : [target];
+};
 
 // src/novely.ts
 import { dequal } from "dequal/lite";
@@ -921,7 +1058,69 @@ var setupBrowserVisibilityChangeListeners = ({ onChange }) => {
 
 // src/novely.ts
 import pLimit from "p-limit";
-import { DEV as DEV2 } from "esm-env";
+import { DEV as DEV3 } from "esm-env";
+
+// src/preloading.ts
+var enqueueAssetForPreloading = (asset2) => {
+  if (!PRELOADED_ASSETS.has(asset2)) {
+    ASSETS_TO_PRELOAD.add(asset2);
+  }
+};
+var handleAssetsPreloading = async ({ request, limiter, preloadAudioBlocking, preloadImageBlocking }) => {
+  const list = mapSet(ASSETS_TO_PRELOAD, (asset2) => {
+    return limiter(async () => {
+      const type = await getResourseType(request, asset2);
+      switch (type) {
+        case "audio": {
+          await preloadAudioBlocking(asset2);
+          break;
+        }
+        case "image": {
+          await preloadImageBlocking(asset2);
+          break;
+        }
+      }
+      ASSETS_TO_PRELOAD.delete(asset2);
+      PRELOADED_ASSETS.add(asset2);
+    });
+  });
+  await Promise.allSettled(list);
+  ASSETS_TO_PRELOAD.clear();
+};
+var huntAssets = ({ characters, action, props, handle }) => {
+  if (action === "showBackground") {
+    if (isString(props[0])) {
+      handle(handleAudioAsset(props[0]));
+    }
+    if (props[0] && typeof props[0] === "object") {
+      for (const value of Object.values(props[0])) {
+        if (isImageAsset(value)) {
+          handle(value);
+        }
+      }
+    }
+    return;
+  }
+  if (isAudioAction(action) && isString(props[0])) {
+    handle(handleAudioAsset(props[0]));
+    return;
+  }
+  if (action === "showCharacter" && isString(props[0]) && isString(props[1])) {
+    const images = toArray(characters[props[0]].emotions[props[1]]);
+    for (const asset2 of images) {
+      handle(handleImageAsset(asset2));
+    }
+    return;
+  }
+  if (action === "custom" && props[0].assets && props[0].assets.length > 0) {
+    for (const asset2 of props[0].assets) {
+      handle(asset2);
+    }
+    return;
+  }
+};
+
+// src/novely.ts
 var novely = ({
   characters,
   characterAssetSizes = {},
@@ -950,38 +1149,12 @@ var novely = ({
   const limitAssetsDownload = pLimit(parallelAssetsDownloadLimit);
   const story = {};
   const times = /* @__PURE__ */ new Set();
-  const ASSETS_TO_PRELOAD = /* @__PURE__ */ new Set();
   const dataLoaded = createControlledPromise();
   let initialScreenWasShown = false;
   let destroyed = false;
   const intime = (value) => {
     return times.add(value), value;
   };
-  const handleAssetsPreloading = async () => {
-    const { preloadAudioBlocking, preloadImageBlocking } = renderer.misc;
-    const list = mapSet(ASSETS_TO_PRELOAD, (asset) => {
-      return limitAssetsDownload(async () => {
-        const type = await getResourseType(request, asset);
-        switch (type) {
-          case "audio": {
-            await preloadAudioBlocking(asset);
-            break;
-          }
-          case "image": {
-            await preloadImageBlocking(asset);
-            break;
-          }
-        }
-      });
-    });
-    await Promise.allSettled(list);
-    ASSETS_TO_PRELOAD.clear();
-  };
-  const assetsToPreloadAdd = (asset) => {
-    if (!PRELOADED_ASSETS.has(asset)) {
-      ASSETS_TO_PRELOAD.add(asset);
-    }
-  };
   const scriptBase = async (part) => {
     if (destroyed) return;
     Object.assign(story, flattenStory(part));
@@ -994,7 +1167,11 @@ var novely = ({
       if (!loadingIsShown) {
         renderer.ui.showLoading();
       }
-      await handleAssetsPreloading();
+      await handleAssetsPreloading({
+        ...renderer.misc,
+        limiter: limitAssetsDownload,
+        request
+      });
     }
     await dataLoaded.promise;
     renderer.ui.hideLoading();
@@ -1010,40 +1187,6 @@ var novely = ({
   const script = (part) => {
     return limitScript(() => scriptBase(part));
   };
-  const assetPreloadingCheck = (action2, props, doAction = assetsToPreloadAdd) => {
-    if (action2 === "showBackground") {
-      if (isImageAsset(props[0])) {
-        doAction(props[0]);
-      }
-      if (props[0] && typeof props[0] === "object") {
-        for (const value of Object.values(props[0])) {
-          if (!isImageAsset(value)) continue;
-          doAction(value);
-        }
-      }
-      return;
-    }
-    if (isAudioAction(action2) && isString(props[0])) {
-      doAction(props[0]);
-      return;
-    }
-    if (action2 === "showCharacter" && isString(props[0]) && isString(props[1])) {
-      const images = characters[props[0]].emotions[props[1]];
-      if (Array.isArray(images)) {
-        for (const asset of images) {
-          doAction(asset);
-        }
-      } else {
-        doAction(images);
-      }
-      return;
-    }
-    if (action2 === "custom" && props[0].assets && props[0].assets.length > 0) {
-      for (const asset of props[0].assets) {
-        doAction(asset);
-      }
-    }
-  };
   const action = new Proxy({}, {
     get(_, action2) {
       if (action2 in renderer.actions) {
@@ -1051,7 +1194,7 @@ var novely = ({
       }
       return (...props) => {
         if (preloadAssets === "blocking") {
-          assetPreloadingCheck(action2, props);
+          huntAssets({ characters, action: action2, props, handle: enqueueAssetForPreloading });
         }
         return [action2, ...props];
       };
@@ -1072,7 +1215,7 @@ var novely = ({
     if (languages.includes(language)) {
       return language;
     }
-    if (DEV2) {
+    if (DEV3) {
       throw new Error(`Attempt to use unsupported language "${language}". Supported languages: ${languages.join(", ")}.`);
     }
     throw 0;
@@ -1102,7 +1245,7 @@ var novely = ({
   };
   const throttledOnStorageDataChange = throttle(onStorageDataChange, throttleTimeout);
   const throttledEmergencyOnStorageDataChange = throttle(() => {
-    if (saveOnUnload === true || saveOnUnload === "prod" && !DEV2) {
+    if (saveOnUnload === true || saveOnUnload === "prod" && !DEV3) {
       onStorageDataChange(storageData.get());
     }
   }, 10);
@@ -1111,7 +1254,7 @@ var novely = ({
     let stored = await storage.get();
     for (const migration of migrations) {
       stored = migration(stored);
-      if (DEV2 && !stored) {
+      if (DEV3 && !stored) {
         throw new Error("Migrations should return a value.");
       }
     }
@@ -1188,7 +1331,7 @@ var novely = ({
   let interacted = 0;
   const restore = async (save2) => {
     if (isEmpty(story)) {
-      if (DEV2) {
+      if (DEV3) {
         throw new Error("Story is empty. You should call an `enine.script` function [https://novely.pages.dev/guide/story.html]");
       }
       return;
@@ -1209,7 +1352,7 @@ var novely = ({
     const [path] = stack.value = latest;
     renderer.ui.showScreen("game");
     const { queue, skip, skipPreserve } = getActionsFromPath(story, path, false);
-    const { run, keep: { keep, characters: characters2, audio } } = createQueueProcessor(queue, {
+    const { run, keep: { keep, characters: characters2, audio: audio2 } } = createQueueProcessor(queue, {
       skip,
       skipPreserve
     });
@@ -1227,7 +1370,7 @@ var novely = ({
       }
     }
     if (context.meta.goingBack) {
-      match("clear", [keep, characters2, audio], {
+      match("clear", [keep, characters2, audio2], {
         ctx: context,
         data: latest[1]
       });
@@ -1314,7 +1457,7 @@ var novely = ({
       if (isAudioAction(action2)) return;
       if (action2 === "vibrate") return;
       if (action2 === "end") return;
-      assetPreloadingCheck(action2, props, assets.push.bind(assets));
+      huntAssets({ characters, action: action2, props, handle: assets.push.bind(assets) });
       return match(action2, props, {
         ctx,
         data: data2
@@ -1346,7 +1489,7 @@ var novely = ({
   };
   const getLanguageDisplayName = (lang) => {
     const language = translation[lang];
-    if (DEV2 && !language) {
+    if (DEV3 && !language) {
       throw new Error(`Attempt to use unsupported language "${language}". Supported languages: ${languages.join(", ")}.`);
     }
     return capitalize(language.nameOverride || getIntlLanguageDisplayName(lang));
@@ -1357,9 +1500,15 @@ var novely = ({
   const getResourseTypeForRenderer = (url) => {
     return getResourseType(request, url);
   };
+  const getCharacterColor = (c) => {
+    return c in characters ? characters[c].color : "#000000";
+  };
+  const getCharacterAssets = (character, emotion) => {
+    return toArray(characters[character].emotions[emotion]).map(handleImageAsset);
+  };
   const renderer = createRenderer({
     mainContextKey: MAIN_CONTEXT_KEY,
-    characters,
+    characters: getCharactersData(characters),
     characterAssetSizes,
     set,
     restore,
@@ -1376,6 +1525,8 @@ var novely = ({
     storageData,
     coreData,
     getLanguageDisplayName,
+    getCharacterColor,
+    getCharacterAssets,
     getResourseType: getResourseTypeForRenderer
   });
   const useStack = createUseStackFunction(renderer);
@@ -1416,26 +1567,12 @@ var novely = ({
           refer
         });
         for (const [action3, ...props2] of collection) {
-          assetPreloadingCheck(action3, props2);
+          huntAssets({ characters, action: action3, props: props2, handle: enqueueAssetForPreloading });
         }
-        const { preloadAudioBlocking, preloadImageBlocking } = renderer.misc;
-        ASSETS_TO_PRELOAD.forEach(async (asset) => {
-          ASSETS_TO_PRELOAD.delete(asset);
-          const type = await getResourseType(request, asset);
-          switch (type) {
-            case "audio": {
-              preloadAudioBlocking(asset).then(() => {
-                PRELOADED_ASSETS.add(asset);
-              });
-              break;
-            }
-            case "image": {
-              preloadImageBlocking(asset).then(() => {
-                PRELOADED_ASSETS.add(asset);
-              });
-              break;
-            }
-          }
+        handleAssetsPreloading({
+          ...renderer.misc,
+          request,
+          limiter: limitAssetsDownload
         });
       } catch (cause) {
         console.error(cause);
@@ -1448,41 +1585,47 @@ var novely = ({
       setTimeout(push, isFunction(time) ? time(getStateAtCtx(ctx)) : time);
     },
     showBackground({ ctx, push }, [background]) {
-      ctx.background(background);
+      if (isString(background) || isAsset(background)) {
+        ctx.background({
+          "all": handleImageAsset(background)
+        });
+      } else {
+        ctx.background(Object.fromEntries(Object.entries(background).map(([media, asset2]) => [media, handleImageAsset(asset2)])));
+      }
       push();
     },
     playMusic({ ctx, push }, [source]) {
-      ctx.audio.music(source, "music").play(true);
+      ctx.audio.music(handleAudioAsset(source), "music").play(true);
       push();
     },
     pauseMusic({ ctx, push }, [source]) {
-      ctx.audio.music(source, "music").pause();
+      ctx.audio.music(handleAudioAsset(source), "music").pause();
       push();
     },
     stopMusic({ ctx, push }, [source]) {
-      ctx.audio.music(source, "music").stop();
+      ctx.audio.music(handleAudioAsset(source), "music").stop();
       push();
     },
     playSound({ ctx, push }, [source, loop]) {
-      ctx.audio.music(source, "sound").play(loop || false);
+      ctx.audio.music(handleAudioAsset(source), "sound").play(loop || false);
       push();
     },
     pauseSound({ ctx, push }, [source]) {
-      ctx.audio.music(source, "sound").pause();
+      ctx.audio.music(handleAudioAsset(source), "sound").pause();
       push();
     },
     stopSound({ ctx, push }, [source]) {
-      ctx.audio.music(source, "sound").stop();
+      ctx.audio.music(handleAudioAsset(source), "sound").stop();
       push();
     },
     voice({ ctx, push }, [source]) {
       const [lang] = storageData.get().meta;
-      const audioSource = isString(source) ? source : source[lang];
+      const audioSource = isString(source) ? source : isAsset(source) ? source : source[lang];
       if (!audioSource) {
         push();
         return;
       }
-      ctx.audio.voice(audioSource);
+      ctx.audio.voice(handleAudioAsset(audioSource));
       push();
     },
     stopVoice({ ctx, push }) {
@@ -1491,11 +1634,11 @@ var novely = ({
     },
     showCharacter({ ctx, push }, [character, emotion, className, style]) {
       emotion ??= defaultEmotions[character];
-      if (DEV2 && !emotion) {
+      if (DEV3 && !emotion) {
         throw new Error(`Attemp to show character "${character}" without emotion provided.`);
       }
       if (!emotion) return;
-      if (DEV2 && !characters[character].emotions[emotion]) {
+      if (DEV3 && !characters[character].emotions[emotion]) {
         throw new Error(`Attempt to show character "${character}" with unknown emotion "${emotion}"`);
       }
       const handle = ctx.character(character);
@@ -1532,7 +1675,7 @@ var novely = ({
       );
     },
     say({ ctx, data: data2 }, [character, content]) {
-      if (DEV2 && !characters[character]) {
+      if (DEV3 && !characters[character]) {
         throw new Error(`Attempt to call Say action with unknown character "${character}"`);
       }
       match("dialog", [character, content], {
@@ -1565,12 +1708,12 @@ var novely = ({
           lang: storageData.get().meta[0],
           state: getStateAtCtx(ctx)
         });
-        if (DEV2 && action2.length === 0 && !shown) {
+        if (DEV3 && action2.length === 0 && !shown) {
           console.warn(`Choice children should not be empty, either add content there or make item not selectable`);
         }
         return [templateReplace(content, data2), shown];
       });
-      if (DEV2 && transformedChoices.length === 0) {
+      if (DEV3 && transformedChoices.length === 0) {
         throw new Error(`Running choice without variants to choose from, look at how to use Choice action properly [https://novely.pages.dev/guide/actions/choice#usage]`);
       }
       ctx.clearBlockingActions("choice");
@@ -1580,7 +1723,7 @@ var novely = ({
         }
         const stack = useStack(ctx);
         const offset = isWithoutQuestion ? 0 : 1;
-        if (DEV2 && !transformedChoices[selected]) {
+        if (DEV3 && !transformedChoices[selected]) {
           throw new Error("Choice children is empty, either add content there or make item not selectable");
         }
         stack.value[0].push(["choice", selected + offset], [null, 0]);
@@ -1589,10 +1732,10 @@ var novely = ({
       });
     },
     jump({ ctx, data: data2 }, [scene]) {
-      if (DEV2 && !story[scene]) {
+      if (DEV3 && !story[scene]) {
         throw new Error(`Attempt to jump to unknown scene "${scene}"`);
       }
-      if (DEV2 && story[scene].length === 0) {
+      if (DEV3 && story[scene].length === 0) {
         throw new Error(`Attempt to jump to empty scene "${scene}"`);
       }
       const stack = useStack(ctx);
@@ -1605,25 +1748,25 @@ var novely = ({
         data: data2
       });
     },
-    clear({ ctx, push }, [keep, characters2, audio]) {
+    clear({ ctx, push }, [keep, characters2, audio2]) {
       ctx.vibrate(0);
       ctx.clear(
         keep || EMPTY_SET,
         characters2 || EMPTY_SET,
-        audio || { music: EMPTY_SET, sounds: EMPTY_SET },
+        audio2 || { music: EMPTY_SET, sounds: EMPTY_SET },
         push
       );
     },
     condition({ ctx }, [condition, variants]) {
-      if (DEV2 && Object.values(variants).length === 0) {
+      if (DEV3 && Object.values(variants).length === 0) {
         throw new Error(`Attempt to use Condition action with empty variants object`);
       }
       if (!ctx.meta.restoring) {
         const val = String(condition(getStateAtCtx(ctx)));
-        if (DEV2 && !variants[val]) {
+        if (DEV3 && !variants[val]) {
           throw new Error(`Attempt to go to unknown variant "${val}"`);
         }
-        if (DEV2 && variants[val].length === 0) {
+        if (DEV3 && variants[val].length === 0) {
           throw new Error(`Attempt to go to empty variant "${val}"`);
         }
         const stack = useStack(MAIN_CONTEXT_KEY);
@@ -1680,7 +1823,7 @@ var novely = ({
     },
     animateCharacter({ ctx, push }, [character, className]) {
       const classes = className.split(" ");
-      if (DEV2 && classes.length === 0) {
+      if (DEV3 && classes.length === 0) {
         throw new Error("Attempt to use AnimateCharacter without classes. Classes should be provided [https://novely.pages.dev/guide/actions/animateCharacter.html]");
       }
       if (ctx.meta.preview) return;
@@ -1689,7 +1832,7 @@ var novely = ({
     },
     text({ ctx, data: data2, forward }, text) {
       const string = text.map((content) => templateReplace(content, data2)).join(" ");
-      if (DEV2 && string.length === 0) {
+      if (DEV3 && string.length === 0) {
         throw new Error(`Action Text was called with empty string or array`);
       }
       ctx.clearBlockingActions("text");
@@ -1714,7 +1857,7 @@ var novely = ({
       render(ctx);
     },
     preload({ ctx, push }, [source]) {
-      if (DEV2 && preloadAssets !== "lazy") {
+      if (DEV3 && preloadAssets !== "lazy") {
         console.error(`You do not need a preload action becase "preloadAssets" strategy was set to "${preloadAssets}"`);
       }
       if (!ctx.meta.goingBack && !ctx.meta.restoring && !PRELOADED_ASSETS.has(source)) {
@@ -1723,10 +1866,10 @@ var novely = ({
       push();
     },
     block({ ctx }, [scene]) {
-      if (DEV2 && !story[scene]) {
+      if (DEV3 && !story[scene]) {
         throw new Error(`Attempt to call Block action with unknown scene "${scene}"`);
       }
-      if (DEV2 && story[scene].length === 0) {
+      if (DEV3 && story[scene].length === 0) {
         throw new Error(`Attempt to call Block action with empty scene "${scene}"`);
       }
       if (!ctx.meta.restoring) {
@@ -1798,8 +1941,8 @@ var novely = ({
   };
   const setStorageData = (data2) => {
     if (destroyed) {
-      if (DEV2) {
-        throw new Error(`function \`setStorageData\` was called after novely instance was destroyed.`);
+      if (DEV3) {
+        throw new Error(`function \`setStorageData\` was called after novely instance was destroyed. Data is not updater nor synced after destroy.`);
       }
       return;
     }
@@ -2079,6 +2222,7 @@ export {
   JP,
   KK,
   RU,
+  asset,
   extendAction,
   localStorageStorage,
   novely