@novely/core 0.29.2 → 0.30.1

package/dist/index.d.ts

@@ -1,11 +1,3 @@
-type Name<Keys extends string = string> = string | Record<Keys, string>;
-type Emotions<Keys extends string = string> = Record<Keys, string | string[]>;
-type Character<LanguageKeys extends string = string> = {
-    name: Name<LanguageKeys>;
-    color: string;
-    emotions: Emotions;
-};
-
 interface LocalStorageStorageSettings {
     key: string;
 }
@@ -237,7 +229,7 @@ type Save<S extends State = State> = [
 type Lang = string;
 type TypewriterSpeed = 'Slow' | 'Medium' | 'Fast' | 'Auto';
 type SoundVolume = number;
-type StorageMeta<L extends string = string> = [
+type StorageMeta<L extends Lang = string> = [
     lang: L,
     typewriter_speed: TypewriterSpeed,
     music_volume: SoundVolume,
@@ -245,7 +237,7 @@ type StorageMeta<L extends string = string> = [
     voice_volume: SoundVolume
 ];
 type Migration = (save: unknown) => unknown;
-type StorageData<L extends string = string, D extends Data = Data> = {
+type StorageData<L extends Lang = string, D extends Data = Data> = {
     saves: Save[];
     data: D;
     meta: StorageMeta<L>;
@@ -303,6 +295,36 @@ interface NovelyInit<$Language extends Lang, Characters extends Record<string, C
      * ```
      */
     characters: Characters;
+    /**
+     * Define default emotions for characters
+     * @example
+     * ```ts
+     * const engine = novely({
+     *  characters: {
+     *   Yuki: {
+     *    name: 'Yuki',
+     *    color: '#f595f6',
+     *    emotions: {
+     *     normal: './normal.png'
+     *    }
+     *   }
+     *  },
+     *  defaultEmotions: {
+     *   Yuki: 'normal'
+     *  }
+     * });
+     *
+     * engine.script({
+     *  start: [
+     *    // Without emotion!
+     *    engine.action.showCharacter('Yuki')
+     *  ]
+     * })
+     * ```
+     */
+    defaultEmotions?: {
+        [Character in keyof NoInfer<Characters>]?: (keyof NoInfer<Characters>[Character]['emotions'] & string);
+    };
     /**
      * An object that provides access to the game's storage system.
      * @default localStorage // at key `novely-game-storage`
@@ -440,6 +462,14 @@ type StateFunction<S extends State> = {
     (): S;
 };
 
+type Name<$Lang extends Lang> = string | Record<$Lang, string>;
+type Emotions<Emotion extends string = string> = Record<Emotion, string | string[]>;
+type Character<$Lang extends Lang = string> = {
+    name: Name<$Lang>;
+    color: string;
+    emotions: Emotions;
+};
+
 type ValidAction = ['choice', number] | ['clear', Set<keyof DefaultActionProxy>?, Set<string>?, {
     music: Set<string>;
     sounds: Set<string>;
@@ -473,6 +503,7 @@ type CustomHandlerFunctionGetFn = <I extends boolean = true>(insert?: I) => Cust
 type CustomHandlerFunctionParameters<L extends string, S extends State> = {
     get: CustomHandlerFunctionGetFn;
     state: StateFunction<S>;
+    restoring: boolean;
     goingBack: boolean;
     preview: boolean;
     lang: L;
@@ -579,7 +610,7 @@ type ActionProxy<Characters extends Record<string, Character>, Languages extends
     stopVoice: () => ValidAction;
     jump: (scene: string) => ValidAction;
     showCharacter: {
-        <C extends keyof Characters>(character: C, emotion: keyof Characters[C]['emotions'], className?: string, style?: string): ValidAction;
+        <C extends keyof Characters>(character: C, emotion?: keyof Characters[C]['emotions'], className?: string, style?: string): ValidAction;
     };
     hideCharacter: (character: keyof Characters, className?: string, style?: string, duration?: number) => ValidAction;
     animateCharacter: (character: keyof Characters, timeout: number, ...classes: string[]) => ValidAction;
@@ -598,7 +629,7 @@ type GetActionParameters<T extends Capitalize<keyof DefaultActionProxy>> = Param
 
 type ConditionParams<T> = T extends ActionProxy<Record<string, Character>, Lang, infer $State> ? Parameters<ConditionCheckFunction<$State, string | boolean>>[0] : never;
 
-declare const novely: <$Language extends string, Characters extends Record<string, Character<$Language>>, StateScheme extends State, DataScheme extends Data>({ characters, 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, StateScheme, DataScheme>) => {
+declare const novely: <$Language extends string, Characters extends Record<string, Character<$Language>>, StateScheme extends State, DataScheme extends Data>({ characters, 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, StateScheme, DataScheme>) => {
     /**
      * Function to set game script
      *

package/dist/index.global.js

@@ -699,7 +699,7 @@ var Novely = (() => {
     return { subscribe, update, set, get };
   };
 
-  // ../deepmerge/dist/index.js
+  // ../../node_modules/.pnpm/@novely+deepmerge@0.0.0/node_modules/@novely/deepmerge/dist/index.js
   var { isArray } = Array;
   var { hasOwnProperty, propertyIsEnumerable, getOwnPropertySymbols } = Object;
   var propertyIsOnObject = (object, property) => {
@@ -710,9 +710,7 @@ var Novely = (() => {
     }
   };
   var propertyIsUnsafe = (target, key) => {
-    return propertyIsOnObject(target, key) && // Properties are safe to merge if they don't exist in the target yet,
-    !(hasOwnProperty.call(target, key) && // unsafe if they exist up the prototype chain,
-    propertyIsEnumerable.call(target, key));
+    return propertyIsOnObject(target, key) && !(hasOwnProperty.call(target, key) && propertyIsEnumerable.call(target, key));
   };
   var getEnumerableOwnPropertySymbols = (target) => {
     if (!getOwnPropertySymbols)
@@ -887,6 +885,7 @@ var Novely = (() => {
   var import_p_limit = __toESM(require_p_limit(), 1);
   var novely = ({
     characters,
+    defaultEmotions = {},
     storage = localStorageStorage({ key: "novely-game-storage" }),
     storageDelay = Promise.resolve(),
     renderer: createRenderer,
@@ -1124,6 +1123,12 @@ var Novely = (() => {
     };
     let interacted = 0;
     const restore = async (save2) => {
+      if (isEmpty(story)) {
+        if (DEV) {
+          throw new Error("Story is empty. You should call an `enine.script` function [https://novely.pages.dev/guide/story.html]");
+        }
+        return;
+      }
       if (!coreData.get().dataLoaded)
         return;
       let latest = save2 || storageData.get().saves.at(-1);
@@ -1244,6 +1249,8 @@ var Novely = (() => {
       return translation[lang].internal[key];
     };
     const preview = async (save2, name) => {
+      if (isEmpty(story))
+        return;
       const [path, data2] = save2;
       const { queue } = getActionsFromPath(story, path, true);
       const ctx = renderer.getContext(name);
@@ -1396,6 +1403,12 @@ var Novely = (() => {
         push();
       },
       showCharacter({ ctx, push }, [character, emotion, className, style]) {
+        emotion ??= defaultEmotions[character];
+        if (DEV && !emotion) {
+          throw new Error(`Attemp to show character "${character}" without emotion provided.`);
+        }
+        if (!emotion)
+          return;
         if (DEV && !characters[character].emotions[emotion]) {
           throw new Error(`Attempt to show character "${character}" with unknown emotion "${emotion}"`);
         }
@@ -1533,11 +1546,7 @@ var Novely = (() => {
       end({ ctx }) {
         if (ctx.meta.preview)
           return;
-        ctx.vibrate(0);
-        ctx.clear(EMPTY_SET, EMPTY_SET, { music: EMPTY_SET, sounds: EMPTY_SET }, noop);
-        renderer.ui.showScreen("mainmenu");
-        interactivity(false);
-        times.clear();
+        exit(true);
       },
       input({ ctx, data: data2, forward }, [question, onInput, setup]) {
         ctx.input(