@drincs/pixi-vn 0.8.4 → 0.8.5

package/README.md

@@ -1,18 +1,18 @@
 # Pixi'VN - PixiJS Visual Novel Engine
 
-Pixi’VN is a npm package that provides various features for creating visual novels, has functions to manage story steps, saving and loading, variable storage, dialogues, character,canvas management, and much more.
+![pixi-vn-cover](https://github.com/user-attachments/assets/28c41fe1-c539-4ebb-b7d4-8cb9f79e089e)
 
-Pixi’VN + [Templates](#project-initialization) provides a complete solution and is in effect a visual novel engine.
+Pixi’VN is a very versatile and powerful visual novel/2D game engine. It is based on JavaScript/TypeScript and uses the [Pixi.js](https://pixijs.com/) library for rendering.
 
-It is designed for web developers, with basic experience in JavaScript/TypeScript, who want to create a visual novel with a modern 2D rendering engine and their favorite JavaScript framework.
+Its great versatility is due to the fact that Pixi’VN is a npm package, that provides various core features to manage story steps, dialogues, character, canvas management, variable storage, saving and loading, and much more. This means that it can be used both to create visual novels and to create other types of 2D games (such as Point and Click Adventure Games, RPGs, etc...), with your favorite JavaScript framework (React, Vue, Angular, etc...).
+
+Pixi’VN provides the ability to use [Templates](#project-initialization) to get started quickly. Less experienced developers can use these templates to create a visual novel without much knowledge of JavaScript/TypeScript.
 
 With the [PixiVNJson](https://pixi-vn.web.app/advanced/pixi-vn-json.html) implementation you have the option to use various types of narrative languages ​​(in addition to JavaScript/TypeScript). Currently you can use the following:
 
-* [Ink](https://pixi-vn.web.app/ink/ink.html)
+* [*ink*](https://pixi-vn.web.app/ink/ink.html)
 * [Ren'Py](https://pixi-vn.web.app/renpy/renpy.html)
 
-It is based on [Pixi.js](https://pixijs.com/), a rendering engine that allows you to create fast 2D graphics. It is based on WebGL and is very fast and efficient. It is used by many developers to create games, websites, and applications.
-
 Pixi’VN offers the possibility of adding an HTML Element with the same dimensions as the [PixiJS Canvas](https://pixi-vn.web.app/start/canvas.html) to add an **UI** with JavaScript frameworks.
 
 By "UI" is meant the elements that are above the canvas, such as buttons, forms, etc.
@@ -27,31 +27,36 @@ This allows the use of systems such as React, Vue, Angular, etc. to create much
 
 ## Wiki
 
-For more information, visit the [Web Page](https://pixi-vn.web.app/)
-
 * [Why Pixi’VN?](https://pixi-vn.web.app/start/why.html)
 * [Get Started](https://pixi-vn.web.app/start/getting-started.html)
 
 ### First steps
 
 * [Characters](https://pixi-vn.web.app/start/character.html)
-* [Narration (JS/TS)](https://pixi-vn.web.app/start/narration.html):
-  * [Dialogue](https://pixi-vn.web.app/start/dialogue.html)
-  * [Label and Game Step](https://pixi-vn.web.app/start/labels.html)
-  * [Choice Menus](https://pixi-vn.web.app/start/choices.html)
-  * [Input](https://pixi-vn.web.app/start/input.html)
-  * [History](https://pixi-vn.web.app/start/history.html)
-  * [Translating](https://pixi-vn.web.app/start/translate.html)
-  * [Typewriter effect](https://pixi-vn.web.app/start/typewriter.html)
-  * [Style Text (Markdown)](https://pixi-vn.web.app/start/markdown.html)
-* [Narration with Ink](https://pixi-vn.web.app/ink/ink.html):
-  * [Characters](https://pixi-vn.web.app/ink/ink-character.html)
-  * [Style Text (Markdown)](https://pixi-vn.web.app/ink/ink-markdown.html)
-  * [Input](https://pixi-vn.web.app/ink/ink-input.html)
-  * [Canvas](https://pixi-vn.web.app/ink/ink-canvas.html)
-  * [Sounds and Music](https://pixi-vn.web.app/ink/ink-sound.html)
-  * [Translating](https://pixi-vn.web.app/ink/ink-translate.html)
-* [Narration with Ren’Py](https://pixi-vn.web.app/renpy/renpy.html)
+* [Narration](https://pixi-vn.web.app/start/narration.html):
+  * [Narration with ink](https://pixi-vn.web.app/ink/ink.html):
+    * [Characters](https://pixi-vn.web.app/ink/ink-character.html)
+    * [Open a knot](https://pixi-vn.web.app/ink/ink-label.html)
+    * [Variables](https://pixi-vn.web.app/ink/ink-variables.html)
+    * [Style Text (Markdown)](https://pixi-vn.web.app/ink/ink-markdown.html)
+    * [Input](https://pixi-vn.web.app/ink/ink-input.html)
+    * [Canvas](https://pixi-vn.web.app/ink/ink-canvas.html)
+    * [Sounds and Music](https://pixi-vn.web.app/ink/ink-sound.html)
+    * [Pause](https://pixi-vn.web.app/ink/ink-pause.html)
+    * [Translating](https://pixi-vn.web.app/ink/ink-translate.html)
+    * [Text replacement](https://pixi-vn.web.app/ink/ink-replacement.html)
+    * [Custom Hashtag Script](https://pixi-vn.web.app/ink/ink-hashtag.html)
+  * [Narration with Ren’Py](https://pixi-vn.web.app/renpy/renpy.html)
+  * Narration with JS/TS:
+    * [Dialogue](https://pixi-vn.web.app/start/dialogue.html)
+    * [Label and Game Step](https://pixi-vn.web.app/start/labels.html)
+    * [Choice Menus](https://pixi-vn.web.app/start/choices.html)
+    * [Input](https://pixi-vn.web.app/start/input.html)
+    * [History](https://pixi-vn.web.app/start/history.html)
+    * [Translating](https://pixi-vn.web.app/start/translate.html)
+    * [Typewriter effect](https://pixi-vn.web.app/start/typewriter.html)
+    * [Style Text (Markdown)](https://pixi-vn.web.app/start/markdown.html)
+    * [Other features](https://pixi-vn.web.app/start/other-narrative-features.html)
 * [PixiJS Canvas](https://pixi-vn.web.app/start/canvas.html):
   * [Images](https://pixi-vn.web.app/start/images.html)
   * [Video](https://pixi-vn.web.app/start/videos.html)
@@ -73,11 +78,15 @@ For more information, visit the [Web Page](https://pixi-vn.web.app/)
 
 * [Intecept Events](https://pixi-vn.web.app/advanced/intercept-events.html)
 * [Distribution](https://pixi-vn.web.app/advanced/distribution.html)
-  * [Mobile distribution](https://pixi-vn.web.app/advanced/distribution%E2%80%90mobile.html)
-* [Pixi’VN + Json](https://pixi-vn.web.app/advanced/pixi-vn-json.html)
+  * [Website distribution](https://pixi-vn.web.app/advanced/distribution-website.html)
+  * [Desktop distribution](https://pixi-vn.web.app/advanced/distribution-desktop.html)
+  * [Mobile distribution](https://pixi-vn.web.app/advanced/distribution-mobile.html)
+* [Pixi’VN + Json](pixi-vn-json)
 
 ## Prerequisites
 
+Before starting, you must have the following tools installed:
+
 * [Node.js](https://nodejs.org/) version 18 or higher.
 * Text Editor with TypeScript support.
   * [Visual Studio Code](https://code.visualstudio.com/) is recommended.

package/dist/{chunk-WJ5SUJTD.js → chunk-7TH27DDS.js}

@@ -8,7 +8,7 @@ import {
   juliette,
   skullyImage,
   skullyName
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   CanvasImage,
   ChoiceMenuOption,
@@ -26,16 +26,18 @@ import {
   newLabel,
   removeWithDissolveTransition,
   removeWithFadeTransition,
+  shakeEffect,
   showImage,
   showWithDissolveTransition,
   showWithFadeTransition,
   zoomIn,
   zoomOut
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
+  CANVAS_APP_STAGE_ALIAS,
   Pause,
   Repeat
-} from "./chunk-FYCYVQTG.js";
+} from "./chunk-P5XNCVKG.js";
 
 // src/labels/ImagesAnimationsTestLabel.ts
 var IMAGE_ANIMAIONS_TEST_LABEL = "___pixi_vn_images_animations_test___";
@@ -69,6 +71,7 @@ var imagesAnimationsTest = newLabel(IMAGE_ANIMAIONS_TEST_LABEL, [
       new ChoiceMenuOption("Zoom", imagesZoomTest, {}),
       new ChoiceMenuOption("Move in/out", imagesMoveInOutTest, {}),
       new ChoiceMenuOption("Zoom in/out", imagesZoomInOutTest, {}),
+      new ChoiceMenuOption("Shake", shakeStageTest, {}),
       new ChoiceMenuOption("Add same alias", imagesAddSameAliasTestLabel, {}),
       new ChoiceMenuOptionClose("Cancel", { closeCurrentLabel: true })
     ];
@@ -444,6 +447,22 @@ var imagesAddSameAliasTestLabel = newLabel("___pixi_vn_images_add_same_tag_test_
   async () => await moveIn("eggHead", eggHeadImage, { speed: 100 }),
   async () => await zoomIn("eggHead", eggHeadImage)
 ]);
+var shakeStageTest = newLabel("___pixi_vn_images_shake_stage_test___", [
+  () => {
+    narration.dialogue = {
+      character: juliette,
+      text: `Ok this is a test for the shake effect. The ${eggHeadName} will shake.`
+    };
+    shakeEffect("eggHead");
+  },
+  () => {
+    narration.dialogue = {
+      character: juliette,
+      text: `Now the whole stage will shake.`
+    };
+    shakeEffect(CANVAS_APP_STAGE_ALIAS);
+  }
+]);
 
 export {
   imagesAnimationsTest

package/dist/{chunk-M6X6FHCH.js → chunk-ATJOKACB.js}

@@ -1,10 +1,10 @@
 import {
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 
 // src/labels/StepLabelTest.ts
 var STEP_LABEL_TEST_LABEL = "___pixi_vn_step_label_test___";

package/dist/{chunk-ENMHDS5Q.js → chunk-C3CICOHN.js}

@@ -2,13 +2,13 @@ import {
   bunnyImage,
   bunnyName,
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   CanvasSprite,
   canvas,
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   eventDecorator
 } from "./chunk-LEMOIFSV.js";

package/dist/{chunk-66F5CGHV.js → chunk-DPUSONJ3.js}

@@ -1,6 +1,6 @@
 import {
   createExportableElement
-} from "./chunk-D3NHF5OS.js";
+} from "./chunk-PIYIZHZL.js";
 
 // src/managers/StorageManagerStatic.ts
 var StorageManagerStatic = class _StorageManagerStatic {

package/dist/{chunk-6SZOXEOR.js → chunk-FHNQBWIZ.js}

@@ -1,6 +1,6 @@
 import {
   createExportableElement
-} from "./chunk-D3NHF5OS.js";
+} from "./chunk-PIYIZHZL.js";
 
 // src/functions/diff-utility.ts
 function restoreDeepDiffChanges(data, differences) {

package/dist/{chunk-2FSBBQFF.js → chunk-IWJD3C4Y.js}

@@ -1,7 +1,7 @@
 import {
   bunnyImage,
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   CanvasContainer,
   CanvasSprite,
@@ -10,7 +10,7 @@ import {
   canvas,
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   Assets
 } from "./chunk-2PXN34ON.js";

package/dist/{chunk-UWXYEVOE.js → chunk-LZHBFVRK.js}

@@ -1,6 +1,6 @@
 import {
   CharacterBaseModel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   saveCharacter
 } from "./chunk-WX267JP2.js";

package/dist/{chunk-T4KKYU4J.js → chunk-OBQXJNCS.js}

@@ -2,7 +2,7 @@ import {
   eggHeadImage,
   eggHeadName,
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   CanvasSprite,
   TickerBase,
@@ -10,7 +10,7 @@ import {
   canvasElementDecorator,
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   tickerDecorator
 } from "./chunk-JTQGULTR.js";

package/dist/{chunk-FYCYVQTG.js → chunk-P5XNCVKG.js}

@@ -122,11 +122,13 @@ var videoFormats = [
   "asf",
   "vob"
 ];
+var CANVAS_APP_STAGE_ALIAS = "_stage_";
 
 export {
   PIXIVN_VERSION,
   Repeat,
   Pause,
   filters,
-  videoFormats
+  videoFormats,
+  CANVAS_APP_STAGE_ALIAS
 };

package/dist/{chunk-D3NHF5OS.js → chunk-PIYIZHZL.js}

@@ -7,7 +7,7 @@ function createExportableElement(element) {
     let elementString = JSON.stringify(element);
     return JSON.parse(elementString);
   } catch (e) {
-    console.error("[Pixi\u2019VN] Error creating exportable element", e);
+    console.error("[Pixi\u2019VN] Error creating exportable element", element, e);
     throw new Error("[Pixi\u2019VN] Error creating exportable element");
   }
 }

package/dist/{chunk-7IWXRHUU.js → chunk-RAQZR6CM.js}

@@ -1,13 +1,13 @@
 import {
   juliette,
   videoLink
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   canvas,
   narration,
   newLabel,
   showWithDissolveTransition
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 
 // src/labels/VideoTestLabel.ts
 var VIDEO_TEST_LABEL = "___pixi_vn_video_test___";

package/dist/{chunk-DI77NC2O.js → chunk-REITIQ75.js}

@@ -1,15 +1,15 @@
 import {
   juliette,
   musicalAudio
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   narration,
   newLabel,
   sound
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   filters
-} from "./chunk-FYCYVQTG.js";
+} from "./chunk-P5XNCVKG.js";
 
 // src/labels/SoundTestLabel.ts
 var SOUND_TEST_LABEL = "___pixi_vn_sound_test___";

package/dist/{chunk-3FJYYZOP.js → chunk-RUYEWYEH.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-I6TNJEE3.js";
 import {
   StorageManagerStatic
-} from "./chunk-66F5CGHV.js";
+} from "./chunk-DPUSONJ3.js";
 import {
   CanvasManagerStatic
 } from "./chunk-P44J5BE2.js";
@@ -33,20 +33,21 @@ import {
 } from "./chunk-JTQGULTR.js";
 import {
   restoreDeepDiffChanges
-} from "./chunk-6SZOXEOR.js";
+} from "./chunk-FHNQBWIZ.js";
 import {
   createExportableElement
-} from "./chunk-D3NHF5OS.js";
+} from "./chunk-PIYIZHZL.js";
 import {
   getEventInstanceById,
   getEventTypeById
 } from "./chunk-LEMOIFSV.js";
 import {
+  CANVAS_APP_STAGE_ALIAS,
   PIXIVN_VERSION,
   Pause,
   Repeat,
   videoFormats
-} from "./chunk-FYCYVQTG.js";
+} from "./chunk-P5XNCVKG.js";
 import {
   Sound,
   SoundLibrary,
@@ -805,6 +806,10 @@ var CanvasManager = class {
    * ```
    */
   add(alias, canvasElement, options = {}) {
+    if (alias === CANVAS_APP_STAGE_ALIAS) {
+      console.error(`[Pixi\u2019VN] The alias ${CANVAS_APP_STAGE_ALIAS} is reserved`);
+      return;
+    }
     let ignoreOldStyle = options?.ignoreOldStyle;
     let oldCanvasElement = this.find(alias);
     if (oldCanvasElement) {
@@ -835,6 +840,10 @@ var CanvasManager = class {
    * ```
    */
   remove(alias, options = {}) {
+    if (alias === CANVAS_APP_STAGE_ALIAS) {
+      console.error(`[Pixi\u2019VN] The alias ${CANVAS_APP_STAGE_ALIAS} is reserved`);
+      return;
+    }
     let ignoreTickers = options.ignoreTickers;
     if (typeof alias === "string") {
       alias = [alias];
@@ -863,6 +872,9 @@ var CanvasManager = class {
    * ```
    */
   find(alias) {
+    if (alias === CANVAS_APP_STAGE_ALIAS) {
+      return this.app.stage;
+    }
     return CanvasManagerStatic._children[alias];
   }
   /**
@@ -973,12 +985,16 @@ var CanvasManager = class {
   pushTicker(id, tickerData, ticker) {
     CanvasManagerStatic._currentTickers[id] = tickerData;
     tickerData.fn = (t) => {
-      if (tickerData.createdByTicketSteps && this.isTickerPaused(tickerData.createdByTicketSteps.canvasElementAlias, tickerData.createdByTicketSteps.id)) {
-        return;
-      }
       let data = CanvasManagerStatic._currentTickers[id];
       if (data) {
-        let canvasElementAliases = data.canvasElementAliases.filter((alias) => !this.isTickerPaused(alias, id));
+        let canvasElementAliases = data.canvasElementAliases;
+        if (tickerData.createdByTicketSteps) {
+          if (this.isTickerPaused(tickerData.createdByTicketSteps.canvasElementAlias, tickerData.createdByTicketSteps.id)) {
+            return;
+          }
+        } else {
+          canvasElementAliases = canvasElementAliases.filter((alias) => !this.isTickerPaused(alias, id));
+        }
         ticker?.fn(t, data.args, canvasElementAliases, id);
       }
     };
@@ -1325,15 +1341,19 @@ var CanvasManager = class {
     });
     CanvasManagerStatic._tickersMustBeCompletedBeforeNextStep.stepAlias.forEach(({ alias, id }) => {
       let ticker = CanvasManagerStatic._currentTickersSteps[alias];
-      if (ticker && ticker[id] && !ticker[id].steps.includes(Repeat)) {
-        ticker[id].steps.forEach((step) => {
-          if (typeof step === "object" && "ticker" in step) {
-            let ticker2 = geTickerInstanceById(step.ticker, step.args, step.duration, step.priority);
-            if (ticker2) {
-              ticker2.onEndOfTicker([alias], id, step.args);
+      if (ticker && ticker[id]) {
+        if (ticker[id].steps.includes(Repeat)) {
+          console.error(`[Pixi\u2019VN] The ticker alias: ${alias} id: ${id} contains a RepeatType, so it can't be forced to complete`, ticker[id]);
+        } else {
+          ticker[id].steps.forEach((step) => {
+            if (typeof step === "object" && "ticker" in step) {
+              let ticker2 = geTickerInstanceById(step.ticker, step.args, step.duration, step.priority);
+              if (ticker2) {
+                ticker2.onEndOfTicker([alias], id, step.args);
+              }
             }
-          }
-        });
+          });
+        }
       }
     });
     CanvasManagerStatic._tickersMustBeCompletedBeforeNextStep = { tikersIds: [], stepAlias: [] };
@@ -1374,6 +1394,7 @@ var CanvasManager = class {
       tickers: createExportableElement(CanvasManagerStatic.currentTickersWithoutCreatedBySteps),
       tickersSteps: createExportableElement(CanvasManagerStatic._currentTickersSteps),
       elements: createExportableElement(currentElements),
+      stage: createExportableElement(getMemoryContainer(this.app.stage)),
       elementAliasesOrder: createExportableElement(CanvasManagerStatic.childrenAliasesOrder),
       tickersOnPause: createExportableElement(CanvasManagerStatic._tickersOnPause)
     };
@@ -1392,6 +1413,11 @@ var CanvasManager = class {
   import(data) {
     this.clear();
     try {
+      if (data.hasOwnProperty("stage") && data.hasOwnProperty("stage")) {
+        setMemoryContainer(this.app.stage, data["stage"]);
+      } else {
+        console.error("[Pixi\u2019VN] The data does not have the properties stage");
+      }
       let tickersOnPause = data["tickersOnPause"] || {};
       if (data.hasOwnProperty("elementAliasesOrder") && data.hasOwnProperty("elements")) {
         let currentElements = data["elements"];
@@ -1940,6 +1966,88 @@ ZoomTicker = __decorateClass([
   tickerDecorator()
 ], ZoomTicker);
 
+// src/functions/canvas/canvas-effect.ts
+async function shakeEffect(alias, props = {}, priority) {
+  let elemet = canvas.find(alias);
+  if (!elemet) {
+    console.error(`[Pixi\u2019VN] The element with the alias ${alias} does not exist. So the shake effect can't be applied.`);
+    return;
+  }
+  let position = { x: elemet.position.x, y: elemet.position.y };
+  let speed = props.speed || 20;
+  let speedProgression = props.speedProgression || void 0;
+  let startOnlyIfHaveTexture = props.startOnlyIfHaveTexture || false;
+  let type = props.type || "horizontal";
+  let maximumShockSize = props.maximumShockSize || 10;
+  let shocksNumber = (props.shocksNumber || 10) - 1;
+  if (shocksNumber < 2) {
+    console.error("[Pixi\u2019VN] The number of shocks must be at least 3.");
+    return;
+  }
+  let upshocksNumber = Math.floor(shocksNumber / 2);
+  let downshocksNumber = Math.ceil(shocksNumber / 2);
+  let moveTickers = [];
+  for (let i = 0; i < upshocksNumber; i++) {
+    let destination = { x: position.x, y: position.y };
+    let shockSize = maximumShockSize * (i + 1) / upshocksNumber;
+    if (type === "horizontal") {
+      if (i % 2 !== 0) {
+        destination.x = position.x + shockSize;
+      } else {
+        destination.x = position.x - shockSize;
+      }
+    } else {
+      if (i % 2 !== 0) {
+        destination.y = position.y + shockSize;
+      } else {
+        destination.y = position.y - shockSize;
+      }
+    }
+    moveTickers.push(new MoveTicker({
+      destination,
+      speed,
+      speedProgression,
+      startOnlyIfHaveTexture
+    }, void 0, priority));
+  }
+  let lastItemIsLeft = upshocksNumber % 2 === 0;
+  for (let i = downshocksNumber; i > 0; i--) {
+    let destination = { x: position.x, y: position.y };
+    let shockSize = maximumShockSize * (i + 1) / (downshocksNumber - 1);
+    if (type === "horizontal") {
+      if (i % 2 === 0 && !lastItemIsLeft || i % 2 !== 0 && lastItemIsLeft) {
+        destination.x = position.x - shockSize;
+      } else {
+        destination.x = position.x + shockSize;
+      }
+    } else {
+      if (i % 2 === 0 && !lastItemIsLeft || i % 2 !== 0 && lastItemIsLeft) {
+        destination.y = position.y - shockSize;
+      } else {
+        destination.y = position.y + shockSize;
+      }
+    }
+    moveTickers.push(new MoveTicker({
+      destination,
+      speed,
+      speedProgression,
+      startOnlyIfHaveTexture
+    }, void 0, priority));
+  }
+  moveTickers.push(new MoveTicker({
+    destination: position,
+    speed,
+    speedProgression,
+    startOnlyIfHaveTexture,
+    tickerAliasToResume: alias
+  }, void 0, priority));
+  let id = canvas.addTickersSteps(alias, moveTickers);
+  if (id) {
+    canvas.addTickerMustBeCompletedBeforeNextStep({ id, alias });
+    canvas.putOnPauseTicker(alias, id);
+  }
+}
+
 // src/functions/canvas/image-utility.ts
 function addImage(alias, imageUrl) {
   let image = new CanvasImage();
@@ -2519,6 +2627,7 @@ var NarrationManagerStatic = class _NarrationManagerStatic {
         canvas: {
           elementAliasesOrder: [],
           elements: {},
+          stage: {},
           tickers: {},
           tickersSteps: {},
           tickersOnPause: {}
@@ -4245,7 +4354,7 @@ var StoredClassModel = class {
     if (Object.keys(storageValue[this.id]).length === 0) {
       delete storageValue[this.id];
     }
-    storageValue.setVariable(this.categoryId, storageValue);
+    storage.setVariable(this.categoryId, storageValue);
   }
   /**
    * Get a property from the storage.
@@ -4705,6 +4814,7 @@ export {
   MoveTicker,
   RotateTicker,
   ZoomTicker,
+  shakeEffect,
   addImage,
   loadImage,
   showImage,

package/dist/{chunk-II324FA5.js → chunk-TFGPTMIQ.js}

@@ -1,42 +1,42 @@
 import {
   imagesAnimationsTest
-} from "./chunk-WJ5SUJTD.js";
+} from "./chunk-7TH27DDS.js";
 import {
   inputTestLabel
-} from "./chunk-MKN3AKFV.js";
+} from "./chunk-VIQQNPPV.js";
 import {
   markdownTest
-} from "./chunk-CUYGFKNS.js";
+} from "./chunk-XWOKK2Z4.js";
 import {
   soundTestLabel
-} from "./chunk-DI77NC2O.js";
+} from "./chunk-REITIQ75.js";
 import {
   stepLabelTestLAbel
-} from "./chunk-M6X6FHCH.js";
+} from "./chunk-ATJOKACB.js";
 import {
   videoTest
-} from "./chunk-7IWXRHUU.js";
+} from "./chunk-RAQZR6CM.js";
 import {
   baseCanvasElementTestLabel
-} from "./chunk-2FSBBQFF.js";
+} from "./chunk-IWJD3C4Y.js";
 import {
   canvasEventsTestLabel
-} from "./chunk-ENMHDS5Q.js";
+} from "./chunk-C3CICOHN.js";
 import {
   customTickerCanvasElementTestLabel
-} from "./chunk-T4KKYU4J.js";
+} from "./chunk-OBQXJNCS.js";
 import {
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   ChoiceMenuOption,
   canvas,
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 import {
   PIXIVN_VERSION
-} from "./chunk-FYCYVQTG.js";
+} from "./chunk-P5XNCVKG.js";
 
 // src/labels/StartLabel.ts
 var pixivnTestStartLabel = newLabel(

package/dist/{chunk-MKN3AKFV.js → chunk-VIQQNPPV.js}

@@ -1,10 +1,10 @@
 import {
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 
 // src/labels/InputTestLabel.ts
 var INPUT_TEST_LABEL = "___pixi_vn_input_test___";

package/dist/{chunk-CUYGFKNS.js → chunk-XWOKK2Z4.js}

@@ -1,10 +1,10 @@
 import {
   juliette
-} from "./chunk-UWXYEVOE.js";
+} from "./chunk-LZHBFVRK.js";
 import {
   narration,
   newLabel
-} from "./chunk-3FJYYZOP.js";
+} from "./chunk-RUYEWYEH.js";
 
 // src/labels/MarkdownTest.ts
 var MARKDOWN_TEST_LABEL = "___pixi_vn_markdown_test___";