@novely/core 0.49.0 → 0.50.0

package/dist/index.d.ts

@@ -45,14 +45,6 @@ declare const RU: {
 };
 type BaseTranslationStrings = keyof typeof RU;
 declare const EN: Record<BaseTranslationStrings, string>;
-/**
- * Translated automatically
- */
-declare const KK: Record<BaseTranslationStrings, string>;
-/**
- * Translated automatically
- */
-declare const JP: Record<BaseTranslationStrings, string>;
 
 type CharacterHandle = {
     emotion: (emotion: string, render: boolean) => void;
@@ -256,7 +248,7 @@ type NovelyAsset = {
     readonly type: 'audio' | 'image';
 };
 type Thenable<T> = T | Promise<T>;
-type PathItem = [null, number | string] | ['jump', string] | ['choice', number] | ['choice:exit'] | ['condition', string] | ['condition:exit'] | ['exit'] | ['block', string] | ['block:exit'];
+type PathItem = [null, number] | ['jump', 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>;
@@ -332,7 +324,7 @@ type CharactersData<$Characters extends Record<string, Character<Lang>>> = {
         emotions: Array<keyof $Characters[Character]['emotions']>;
     };
 };
-type AssetsPreloading = 'lazy' | 'blocking' | 'automatic';
+type AssetsPreloading = 'lazy' | 'automatic';
 type CloneFN = <T>(value: T) => T;
 type StoryOptionsStatic = {
     /**
@@ -552,7 +544,11 @@ interface NovelyInit<$Language extends Lang, $Characters extends Record<string,
      */
     askBeforeExit?: boolean;
     /**
-     * @default "lazy"
+     * "automatic" will try to preload assets when possible
+     *
+     * "lazy" will load assets only when they are shown
+     *
+     * @default "automatic"
      */
     preloadAssets?: AssetsPreloading;
     /**
@@ -602,12 +598,21 @@ type StateFunction<S extends State> = {
     (value: DeepPartial<S> | ((prev: S) => S)): void;
     (): S;
 };
+/**
+ * @deprecated `EngineTypes` should be used instead
+ */
 type TypeEssentials<$Lang extends Lang, $State extends State, $Data extends Data, $Characters extends Record<string, Character<$Lang>>> = {
     readonly l: $Lang | null;
     readonly s: $State | null;
     readonly d: $Data | null;
     readonly c: $Characters | null;
 };
+type EngineTypes<$Lang extends Lang = Lang, $State extends State = State, $Data extends Data = Data, $Characters extends Record<string, Character<$Lang>> = Record<string, Character<$Lang>>> = {
+    readonly l: $Lang;
+    readonly s: $State;
+    readonly d: $Data;
+    readonly c: $Characters;
+};
 type DialogOverviewEntry = {
     /**
      * Link to character voice
@@ -635,7 +640,7 @@ type Character<$Lang extends Lang = string> = {
 type ValidAction = ['choice', string | undefined, ...[string, unknown[], (() => boolean)?, (() => boolean)?, string?][]] | ['clear', Set<keyof DefaultActionProxy>?, Set<string>?, {
     music: Set<string>;
     sounds: Set<string>;
-}?] | ['condition', (state: State) => boolean, Record<string, ValidAction[]>] | ['dialog', string | undefined, TextContent<string, State>, string | undefined] | ['end'] | ['showBackground', string | NovelyAsset | BackgroundImage] | ['playMusic', string | NovelyAsset] | ['stopMusic', string | NovelyAsset] | ['pauseMusic', string | NovelyAsset] | ['playSound', audio: string | NovelyAsset, loop?: boolean] | ['pauseSound', string | NovelyAsset] | ['stopSound', string | NovelyAsset] | ['voice', string | NovelyAsset | Record<string, string | NovelyAsset>] | ['stopVoice'] | ['jump', string] | ['showCharacter', string, keyof Character['emotions'], string?, string?] | ['hideCharacter', string, string?, string?, number?] | ['animateCharacter', string, number, ...string[]] | ['wait', number | ((state: State) => number)] | ['function', FunctionAction<string, State>] | ['input', string, (meta: ActionInputOnInputMeta<string, State>) => void, ActionInputSetup?] | ['custom', CustomHandler<string, State>] | ['vibrate', ...number[]] | ['next'] | ['text', ...TextContent<string, State>[]] | ['exit'] | ['preload', string] | ['block', string] | ValidAction[];
+}?] | ['condition', (state: State) => boolean, Record<string, ValidAction[]>] | ['dialog', string | undefined, TextContent<string, State>, string | undefined] | ['end'] | ['showBackground', string | NovelyAsset | BackgroundImage] | ['playMusic', string | NovelyAsset] | ['stopMusic', string | NovelyAsset] | ['pauseMusic', string | NovelyAsset] | ['playSound', audio: string | NovelyAsset, loop?: boolean] | ['pauseSound', string | NovelyAsset] | ['stopSound', string | NovelyAsset] | ['voice', string | NovelyAsset | Record<string, string | NovelyAsset>] | ['stopVoice'] | ['jump', string] | ['showCharacter', string, keyof Character['emotions'], string?, string?] | ['hideCharacter', string, string?, string?, number?] | ['animateCharacter', string, number, ...string[]] | ['wait', number | ((state: State) => number)] | ['function', FunctionAction<string, State>] | ['input', string, (meta: ActionInputOnInputMeta<string, State>) => void, ActionInputSetup?] | ['custom', CustomHandler<string, State>] | ['vibrate', ...number[]] | ['next'] | ['text', ...TextContent<string, State>[]] | ['exit'] | ['preload', string | NovelyAsset] | ['block', string] | ValidAction[];
 type Story = Record<string, ValidAction[]>;
 type TextContent<L extends string, S extends State> = string | ((state: S) => string) | Record<L, string | ((state: S) => string)>;
 type FunctionableValue<T> = T | (() => T);
@@ -892,7 +897,7 @@ type ActionProxy<Characters extends Record<string, Character>, Languages extends
     vibrate: (...pattern: number[]) => ValidAction;
     next: () => ValidAction;
     text: (...text: TextContent<Languages, S>[]) => ValidAction;
-    preload: (source: string) => ValidAction;
+    preload: (source: string | NovelyAsset) => ValidAction;
     block: (scene: string) => ValidAction;
 };
 type DefaultActionProxy = ActionProxy<Record<string, Character>, Lang, State>;
@@ -902,10 +907,19 @@ type VirtualActions<$Characters extends Record<string, Character>, $Lang extends
     say: (character: keyof $Characters, content: TextContent<$Lang, $State>) => ValidAction;
 };
 
-type ConditionParams<T> = T extends TypeEssentials<any, infer $State, any, any> ? $State : never;
-type ChoiceParams<T> = T extends TypeEssentials<infer $Lang, infer $State, any, any> ? ChoiceCheckFunctionProps<$Lang, $State> : never;
-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;
+type ConditionParams<T> = T extends EngineTypes<any, infer $State, any, any> ? $State : never;
+type ChoiceParams<T> = T extends EngineTypes<infer $Lang, infer $State, any, any> ? ChoiceCheckFunctionProps<$Lang, $State> : never;
+type FunctionParams<T> = T extends EngineTypes<infer $Lang, infer $State, any, any> ? FunctionActionProps<$Lang, $State> : never;
+type InputHandler<T> = T extends EngineTypes<infer $Lang, infer $State, any, any> ? ActionInputOnInputMeta<$Lang, $State> : never;
+/**
+ * @example
+ * ```ts
+ * type Types = TypesFromEngine<typeof engine>;
+ * ```
+ */
+type TypesFromEngine<T> = T extends {
+    types: EngineTypes<infer $Lang, infer $State, infer $Data, infer $Characters> | null;
+} ? EngineTypes<$Lang, $State, $Data, $Characters> : 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, cloneFunction: clone, saveOnUnload, startKey, defaultTypewriterSpeed, storyOptions, }: NovelyInit<$Language, $Characters, $State, $Data, $Actions>) => {
     /**
@@ -958,7 +972,7 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
     data: StateFunction<$Data>;
     /**
      * Used in combination with type utilities
-     *
+     * @deprecated Use `engine.types` instead
      * @example
      * ```ts
      * import type { ConditionParams, StateFunction } from '@novely/core';
@@ -969,6 +983,20 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
      * ```
      */
     typeEssentials: TypeEssentials<$Language, $State, $Data, $Characters>;
+    /**
+     * Used in combination with type utilities
+     * @example
+     * ```ts
+     * import type { TypesFromEngine, ConditionParams, StateFunction } from '@novely/core';
+     *
+     * type Types = TypesFromEngine<typeof engine>;
+     *
+     * const conditionCheck = (state: StateFunction<ConditionParams<Types>>) => {
+     *   return state.age >= 18;
+     * }
+     * ```
+     */
+    types: EngineTypes<$Language, $State, $Data, $Characters> | null;
     /**
      * Replaces content inside {{braces}} using global data
      * @example
@@ -1065,4 +1093,4 @@ declare const asset: {
     audio(source: string): NovelyAsset;
 };
 
-export { type ActionChoiceChoice, type ActionChoiceChoiceObject, 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 ChoiceCheckFunction, type ChoiceCheckFunctionProps, type ChoiceOnSelectFunction, type ChoiceOnSelectFunctionProps, type ChoiceParams, type ConditionCheckFunction, type ConditionParams, type Context, type CoreData, type CustomActionHandle, type CustomHandler, type CustomHandlerFunction, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type CustomHandlerInfo, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionParams, type FunctionableValue, type GetActionParameters, type InputHandler, JP, KK, type Lang, type NovelyAsset, 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 };
+export { type ActionChoiceChoice, type ActionChoiceChoiceObject, 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 ChoiceCheckFunction, type ChoiceCheckFunctionProps, type ChoiceOnSelectFunction, type ChoiceOnSelectFunctionProps, type ChoiceParams, type ConditionCheckFunction, type ConditionParams, type Context, type CoreData, type CustomActionHandle, type CustomHandler, type CustomHandlerFunction, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type CustomHandlerInfo, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type EngineTypes, type FunctionParams, type FunctionableValue, type GetActionParameters, type InputHandler, type Lang, type NovelyAsset, type NovelyInit, type NovelyScreen, type NovelyStorage, type Path, type PathItem, 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 TypesFromEngine, type TypewriterSpeed, type ValidAction, asset, extendAction, localStorageStorage, novely };