@novely/core 0.36.0 → 0.37.0-beta.0

package/dist/index.d.ts

@@ -200,6 +200,7 @@ type Renderer = {
 };
 type RendererInit<$Language extends Lang, $Characters extends Record<string, Character<$Language>>> = {
     characters: $Characters;
+    characterAssetSizes: CharacterAssetSizes<$Characters>;
     set: (save: Save<State>) => Promise<void>;
     restore: (save?: Save<State>) => Promise<void>;
     save: (type: Save<State>[2][1]) => void;
@@ -233,7 +234,6 @@ type RendererInit<$Language extends Lang, $Characters extends Record<string, Cha
 declare const getLanguage: (languages: string[]) => string;
 
 type Thenable<T> = T | Promise<T>;
-type NoInfer<T> = [T][T extends any ? 0 : never];
 type PathItem = [null, number | string] | ['jump', string] | ['choice', number] | ['choice:exit'] | ['condition', string] | ['condition:exit'] | ['exit'] | ['block', string] | ['block:exit'];
 type Path = PathItem[];
 type State = Record<string, any>;
@@ -302,6 +302,12 @@ type TranslationDescription = {
 type DefaultEmotions<$Characters extends Record<string, Character<Lang>>> = {
     [Character in keyof $Characters]?: (keyof $Characters[Character]['emotions'] & string);
 };
+type CharacterAssetSizes<$Characters extends Record<string, Character<Lang>>> = {
+    [Character in keyof $Characters]?: {
+        width: number;
+        height: number;
+    };
+};
 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.
@@ -350,6 +356,32 @@ interface NovelyInit<$Language extends Lang, $Characters extends Record<string,
      * ```
      */
     defaultEmotions?: DefaultEmotions<NoInfer<$Characters>>;
+    /**
+     * Character asset sizes. We need width-height pair to render character, but we get it only after the assets are loaded. However, using that option we can use width-height before load.
+     * @example
+     * ```
+     * import peter_the_great from './assets/peter_the_great.png?width=800&height=1200';
+     *
+     * const engine = novely({
+     *   characters: {
+     *     Peter: {
+     *       name: 'Peter',
+     *       color: '#c04931',
+     *       emotions: {
+     *         normal: peter_the_great
+     *       }
+     *     }
+     *   },
+     *   characterAssetSizes: {
+     *     Peter: {
+     *       width: 800,
+     *       height: 1200
+     *     }
+     *   }
+     * })
+     * ```
+     */
+    characterAssetSizes?: CharacterAssetSizes<NoInfer<$Characters>>;
     /**
      * An object that provides access to the game's storage system.
      * @default localStorage // at key `novely-game-storage`
@@ -735,7 +767,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, 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, saveOnUnload, startKey }: NovelyInit<$Language, $Characters, $State, $Data, $Actions>) => {
     /**
      * Function to set game script
      *

package/dist/index.global.js

@@ -1128,6 +1128,7 @@ var Novely = (() => {
   var import_p_limit = __toESM(require_p_limit(), 1);
   var novely = ({
     characters,
+    characterAssetSizes = {},
     defaultEmotions = {},
     storage = localStorageStorage({ key: "novely-game-storage" }),
     storageDelay = Promise.resolve(),
@@ -1564,6 +1565,7 @@ var Novely = (() => {
     const renderer = createRenderer({
       mainContextKey: MAIN_CONTEXT_KEY,
       characters,
+      characterAssetSizes,
       set,
       restore,
       save,