@novely/core 0.33.0-beta.0 → 0.33.0-beta.2

package/dist/index.d.ts

@@ -95,6 +95,11 @@ type Context = {
     }, resolve: () => void) => void;
     custom: (fn: CustomHandler<Lang, State>, push: () => void) => Thenable<void>;
     clearCustom: (fn: CustomHandler<Lang, State>) => void;
+    /**
+     * Clears all mentioned actions except for preserved one
+     * @param preserve Action to preserve
+     */
+    clearAction: (preserve: 'dialog' | 'choice' | 'input' | 'text') => void;
     text: (str: string, resolve: () => void) => void;
     vibrate: (pattern: VibratePattern) => void;
     audio: {
@@ -256,6 +261,10 @@ type NovelyScreen = 'mainmenu' | 'game' | 'saves' | 'settings';
 type DeepPartial<T> = unknown extends T ? T : T extends object ? {
     [P in keyof T]?: T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : DeepPartial<T[P]>;
 } : T;
+/**
+ *
+ */
+type Assign<A extends object, B extends object> = Pick<A, Exclude<keyof A, keyof B>> & B;
 type NonEmptyRecord<T extends Record<PropertyKey, unknown>> = keyof T extends never ? never : T;
 type CoreData = {
     dataLoaded: boolean;
@@ -740,4 +749,19 @@ declare const novely: <$Language extends string, $Characters extends Record<stri
     getCurrentStorageData: () => StorageData<$Language, $Data> | null;
 };
 
-export { type ActionInputOnInputMeta, type ActionInputSetup, type ActionProxy, type AllowedContent, type AudioHandle, type BackgroundImage, type BaseTranslationStrings, type Character, type CharacterHandle, type ConditionParams, type Context, type CoreData, type CustomHandler, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionableValue, type GetActionParameters, JP, KK, type Lang, type NovelyInit, type NovelyScreen, type Path, type PluralType, type Pluralization, RU, type Renderer, type RendererInit, 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 TypewriterSpeed, type ValidAction, localStorageStorage, novely };
+/**
+ * Extens core action with custom actions
+ * @param base Actions object you will extend, `engine.action`
+ * @param extension Actions object you will extend with
+ * @example
+ * ```ts
+ * const action = extendAction(engine.action, {
+ *   particles: (options: Parameters<typeof particles>[0]) => {
+ *     return ['custom', particles(options)]
+ *   }
+ * })
+ * ```
+ */
+declare const extendAction: <Part0 extends Record<string, (...args: any[]) => ValidAction>, Part1 extends Record<string, (...args: any[]) => ValidAction>>(base: Part0, extension: Part1) => Readonly<Assign<Part0, Part1>>;
+
+export { type ActionInputOnInputMeta, type ActionInputSetup, type ActionProxy, type AllowedContent, type AudioHandle, type BackgroundImage, type BaseTranslationStrings, type Character, type CharacterHandle, type ConditionParams, type Context, type CoreData, type CustomHandler, type CustomHandlerFunctionGetFn, type CustomHandlerFunctionParameters, type CustomHandlerGetResult, type CustomHandlerGetResultDataFunction, type Data, type DeepPartial, type DefaultActionProxy, EN, type Emotions, type FunctionableValue, type GetActionParameters, JP, KK, type Lang, type NovelyInit, type NovelyScreen, type Path, type PluralType, type Pluralization, RU, type Renderer, type RendererInit, 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 TypewriterSpeed, type ValidAction, extendAction, localStorageStorage, novely };

package/dist/index.global.js

@@ -156,6 +156,7 @@ var Novely = (() => {
     JP: () => JP,
     KK: () => KK,
     RU: () => RU,
+    extendAction: () => extendAction,
     localStorageStorage: () => localStorageStorage,
     novely: () => novely
   });
@@ -214,6 +215,34 @@ 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;
+  }
+
   // src/utils.ts
   var matchAction = ({ getContext, push, forward }, values) => {
     return (action, props, { ctx, data }) => {
@@ -685,7 +714,7 @@ var Novely = (() => {
     if (isExitImpossible(path)) {
       const referred = refer(path);
       if (isAction(referred) && isSkippedDuringRestore(referred[0])) {
-        onExitImpossible();
+        onExitImpossible?.();
       }
       wasExitImpossible = true;
       return {
@@ -857,34 +886,6 @@ var Novely = (() => {
     }
   };
 
-  // ../../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;
-  }
-
   // src/translation.ts
   var RGX = /{{(.*?)}}/g;
   var split = (input, delimeters) => {
@@ -1406,7 +1407,7 @@ var Novely = (() => {
       const path = stack.value[0];
       nextPath(path);
     };
-    const matchActionInit = {
+    const matchActionOptions = {
       getContext: renderer.getContext,
       push(ctx) {
         if (ctx.meta.restoring)
@@ -1417,12 +1418,12 @@ var Novely = (() => {
       forward(ctx) {
         if (!ctx.meta.preview)
           enmemory(ctx);
-        matchActionInit.push(ctx);
+        matchActionOptions.push(ctx);
         if (!ctx.meta.preview)
           interactivity(true);
       }
     };
-    const match = matchAction(matchActionInit, {
+    const match = matchAction(matchActionOptions, {
       wait({ ctx, push }, [time]) {
         if (ctx.meta.restoring)
           return;
@@ -1504,6 +1505,7 @@ var Novely = (() => {
           }
           return c || "";
         })();
+        ctx.clearAction("dialog");
         ctx.dialog(
           templateReplace(content, data2),
           templateReplace(name, data2),
@@ -1554,6 +1556,7 @@ var Novely = (() => {
         if (DEV && 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.clearAction("choice");
         ctx.choices(templateReplace(question, data2), transformedChoices, (selected) => {
           if (!ctx.meta.preview) {
             enmemory(ctx);
@@ -1617,6 +1620,7 @@ var Novely = (() => {
         exit(true, false);
       },
       input({ ctx, data: data2, forward }, [question, onInput, setup]) {
+        ctx.clearAction("input");
         ctx.input(
           templateReplace(question, data2),
           onInput,
@@ -1660,6 +1664,7 @@ var Novely = (() => {
         if (DEV && string.length === 0) {
           throw new Error(`Action Text was called with empty string or array`);
         }
+        ctx.clearAction("text");
         ctx.text(string, forward);
       },
       exit({ ctx, data: data2 }) {
@@ -1857,6 +1862,15 @@ var Novely = (() => {
     };
   };
 
+  // src/extend-actions.ts
+  var extendAction = (base, extension) => {
+    return new Proxy({}, {
+      get(_, key, receiver) {
+        return Reflect.get(key in extension ? extension : base, key, receiver);
+      }
+    });
+  };
+
   // src/translations.ts
   var RU = {
     NewGame: "\u041D\u043E\u0432\u0430\u044F \u0438\u0433\u0440\u0430",