@drincs/pixi-vn 0.6.0 → 0.6.1

package/dist/functions/index.mjs

@@ -27,8 +27,7 @@ var __decorateClass = (decorators, target, key, kind) => {
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
     if (decorator = decorators[i])
       result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result)
-    __defProp(target, key, result);
+  if (kind && result) __defProp(target, key, result);
   return result;
 };
 var __async = (__this, __arguments, generator) => {
@@ -284,8 +283,8 @@ var GameStorageManager = _GameStorageManager;
 var TickerBase = class {
   /**
    * @param args The arguments that you want to pass to the ticker.
-   * @param duration The duration of the ticker. If is undefined, the ticker will be called every frame.
-   * @param priority The priority of the ticker. If is undefined, the priority will be UPDATE_PRIORITY.NORMAL.
+   * @param duration The duration of the ticker in seconds. If is undefined, the step will end only when the animation is finished (if the animation doesn't have a goal to reach then it won't finish). @default undefined
+   * @param priority The priority of the ticker. @default UPDATE_PRIORITY.NORMAL
    */
   constructor(args, duration, priority) {
     this.args = args;
@@ -295,15 +294,26 @@ var TickerBase = class {
   /**
    * The method that will be called every frame.
    * This method should be overridden and you can use GameWindowManager.addCanvasElement() to get the canvas element of the canvas, and edit them.
-   * @param t The ticker that is calling this method
-   * @param args The arguments that you passed when you added the ticker
-   * @param tags The tags of the canvas elements that are connected to this ticker
+   * @param _ticker The ticker that is calling this method
+   * @param _args The arguments that you passed when you added the ticker
+   * @param _tags The tags of the canvas elements that are connected to this ticker
+   * @param _tickerId The id of the ticker. You can use this to get the ticker from the {@link GameWindowManager.currentTickers}
    */
-  fn(_t, _args, _tags) {
+  fn(_ticker, _args, _tags, _tickerId) {
     throw new Error("[Pixi'VN] The method TickerBase.fn() must be overridden");
   }
 };
 
+// src/constants.ts
+var PIXIVN_VERSION = "0.6.1";
+var Repeat = "repeat";
+function Pause(duration) {
+  return {
+    type: "pause",
+    duration
+  };
+}
+
 // src/decorators/TickerDecorator.ts
 var registeredTickers = {};
 function tickerDecorator(name) {
@@ -312,7 +322,7 @@ function tickerDecorator(name) {
       name = target.name;
     }
     if (registeredTickers[name]) {
-      console.warn(`[Pixi'VN] Ticker ${name} already exists, it will be overwritten`);
+      console.info(`[Pixi'VN] Ticker ${name} already exists, it will be overwritten`);
     }
     registeredTickers[name] = target;
   };
@@ -803,11 +813,8 @@ function asciiArtLog() {
     `);
 }
 
-// src/types/PauseType.ts
-var PauseValueType = "pause";
-
-// src/types/RepeatType.ts
-var Repeat = "repeat";
+// src/types/ticker/TagToRemoveAfterType.ts
+var tagToRemoveAfter = "tagToRemoveAfter";
 
 // src/managers/WindowManager.ts
 var _GameWindowManager = class _GameWindowManager {
@@ -991,25 +998,25 @@ var _GameWindowManager = class _GameWindowManager {
   /**
    * Remove a canvas element from the canvas.
    * And remove all tickers that are not connected to any canvas element.
-   * @param tag The tag of the canvas element to be removed.
+   * @param tags The tag of the canvas element to be removed.
    * @returns 
    * @example
    * ```typescript
    * GameWindowManager.removeCanvasElement("bunny");
    * ```
    */
-  static removeCanvasElement(tag) {
-    if (typeof tag === "string") {
-      tag = [tag];
+  static removeCanvasElement(tags) {
+    if (typeof tags === "string") {
+      tags = [tags];
     }
-    tag.forEach((t) => {
-      if (_GameWindowManager._children[t]) {
-        _GameWindowManager.app.stage.removeChild(_GameWindowManager._children[t]);
-        delete _GameWindowManager._children[t];
+    tags.forEach((tag) => {
+      if (_GameWindowManager._children[tag]) {
+        _GameWindowManager.app.stage.removeChild(_GameWindowManager._children[tag]);
+        delete _GameWindowManager._children[tag];
+        _GameWindowManager.removeTickerByCanvasElement(tag);
       }
     });
-    _GameWindowManager.removeTickersWithoutAssociatedCanvasElement();
-    _GameWindowManager.childrenTagsOrder = _GameWindowManager.childrenTagsOrder.filter((t) => !tag.includes(t));
+    _GameWindowManager.childrenTagsOrder = _GameWindowManager.childrenTagsOrder.filter((t) => !tags.includes(t));
   }
   /**
    * Get a canvas element by the tag.
@@ -1039,18 +1046,43 @@ var _GameWindowManager = class _GameWindowManager {
     _GameWindowManager.app.stage.removeChildren();
     _GameWindowManager._children = {};
     _GameWindowManager.childrenTagsOrder = [];
-    _GameWindowManager.removeTickers();
+    _GameWindowManager.removeAllTickers();
   }
   /**
    * Edit the tag of a canvas element.
    * @param oldTag The old tag of the canvas element.
    * @param newTag The new tag of the canvas element.
    */
-  static editTagCanvasElement(oldTag, newTag) {
+  static editCanvasElementTag(oldTag, newTag) {
     if (_GameWindowManager._children[oldTag]) {
       _GameWindowManager._children[newTag] = _GameWindowManager._children[oldTag];
       delete _GameWindowManager._children[oldTag];
     }
+    if (_GameWindowManager._currentTickersSteps[oldTag]) {
+      _GameWindowManager._currentTickersSteps[newTag] = _GameWindowManager._currentTickersSteps[oldTag];
+      delete _GameWindowManager._currentTickersSteps[oldTag];
+    }
+    for (let id in _GameWindowManager._currentTickers) {
+      let ticker = _GameWindowManager._currentTickers[id];
+      if (ticker.canvasElementTags.includes(oldTag)) {
+        ticker.canvasElementTags = ticker.canvasElementTags.map((t) => t === oldTag ? newTag : t);
+        if (ticker.args.hasOwnProperty(tagToRemoveAfter)) {
+          let tagToRemoveAfter2 = ticker.args.tagToRemoveAfter;
+          if (typeof tagToRemoveAfter2 === "string") {
+            tagToRemoveAfter2 = [tagToRemoveAfter2];
+          }
+          if (Array.isArray(tagToRemoveAfter2)) {
+            ticker.args.tagToRemoveAfter = tagToRemoveAfter2.map((t) => t === oldTag ? newTag : t);
+          }
+        }
+      }
+    }
+    for (let timeout in _GameWindowManager._currentTickersTimeouts) {
+      let TickerTimeout = _GameWindowManager._currentTickersTimeouts[timeout];
+      if (TickerTimeout.tags.includes(oldTag)) {
+        TickerTimeout.tags = TickerTimeout.tags.map((t) => t === oldTag ? newTag : t);
+      }
+    }
   }
   /** Edit Tickers Methods */
   /**
@@ -1059,23 +1091,38 @@ var _GameWindowManager = class _GameWindowManager {
   static get currentTickers() {
     return _GameWindowManager._currentTickers;
   }
+  static get currentTickersList() {
+    return Object.values(_GameWindowManager._currentTickers);
+  }
+  static get currentTickersWithoutCreatedBySteps() {
+    return Object.fromEntries(Object.entries(_GameWindowManager._currentTickers).filter(([_, ticker]) => !ticker.createdByTicketStepsId));
+  }
   /**
    * The steps of the tickers
    */
   static get currentTickersSteps() {
     return _GameWindowManager._currentTickersSteps;
   }
+  static generateTickerId(tickerData) {
+    try {
+      return sha1(JSON.stringify(tickerData)).toString() + "_" + Math.random().toString(36).substring(7);
+    } catch (e) {
+      throw new Error(`[Pixi'VN] Error to generate ticker id: ${e}`);
+    }
+  }
   /**
-   * Run a ticker.
+   * Run a ticker. You can run multiple addTicker with the same tag and different tickerClasses.
+   * If you run a ticker with the same tag and tickerClass, the old ticker will be removed.
+   * If already exists a sequence of tickers with the same tag, it will be removed.
    * @param canvasEslementTag The tag of the canvas element that will use the ticker.
    * @param ticker The ticker class to be run.
    * @param args The arguments to be used in the ticker.
-   * @param duration The time to be used in the ticker. This number is in milliseconds. If it is undefined, the ticker will run forever.
+   * @param duration The time to be used in the ticker. This number is in seconds. If it is undefined, the ticker will run forever.
    * @param priority The priority to be used in the ticker.
    * @returns 
    * @example
    * ```typescript
-   * GameWindowManager.addTicker("alien", new TickerRotate({ speed: 0.2 }))
+   * GameWindowManager.addTicker("alien", new RotateTicker({ speed: 0.2 }))
    * ```
    */
   static addTicker(canvasElementTag, ticker) {
@@ -1083,82 +1130,88 @@ var _GameWindowManager = class _GameWindowManager {
     if (typeof canvasElementTag === "string") {
       canvasElementTag = [canvasElementTag];
     }
-    let t = geTickerInstanceByClassName(tickerName, ticker.args, ticker.duration, ticker.priority);
-    if (!t) {
+    if (!geTickerInstanceByClassName(tickerName, ticker.args, ticker.duration, ticker.priority)) {
       console.error(`[Pixi'VN] Ticker ${tickerName} not found`);
       return;
     }
-    _GameWindowManager.removeAssociationBetweenTickerCanvasElement(canvasElementTag, ticker);
     let tickerHistory = {
       fn: () => {
       },
       className: tickerName,
-      args: ticker.args,
+      args: createExportableElement(ticker.args),
       canvasElementTags: canvasElementTag,
       priority: ticker.priority,
       duration: ticker.duration
     };
-    _GameWindowManager.pushTicker(tickerHistory, t);
-    _GameWindowManager.removeTickersWithoutAssociatedCanvasElement();
+    let id = _GameWindowManager.generateTickerId(tickerHistory);
+    _GameWindowManager.pushTicker(id, tickerHistory, ticker);
     if (ticker.duration) {
       let timeout = setTimeout(() => {
         _GameWindowManager.removeTickerTimeoutInfo(timeout);
-        _GameWindowManager.nextTickerStep(canvasElementTag);
-      }, ticker.duration);
-      _GameWindowManager.addTickerTimeoutInfo(canvasElementTag, tickerName, timeout.toString());
+        let tickerTimeoutInfo = _GameWindowManager._currentTickersTimeouts[timeout.toString()];
+        if (tickerTimeoutInfo) {
+          _GameWindowManager.removeTicker(id);
+        }
+      }, ticker.duration * 1e3);
+      _GameWindowManager.addTickerTimeoutInfo(canvasElementTag, tickerName, timeout.toString(), true);
     }
   }
-  static pushTicker(tickerData, ticker) {
+  static pushTicker(id, tickerData, ticker) {
     _GameWindowManager.removeAssociationBetweenTickerCanvasElement(tickerData.canvasElementTags, tickerData);
-    _GameWindowManager._currentTickers.push(tickerData);
+    _GameWindowManager._currentTickers[id] = tickerData;
     tickerData.fn = (t) => {
-      ticker == null ? void 0 : ticker.fn(t, tickerData.args, tickerData.canvasElementTags);
+      let data = _GameWindowManager._currentTickers[id];
+      if (data) {
+        ticker == null ? void 0 : ticker.fn(t, data.args, data.canvasElementTags, id);
+      }
     };
     _GameWindowManager.app.ticker.add(tickerData.fn, void 0, tickerData.priority);
   }
   /**
-   * Run a sequence of tickers.
+   * Run a sequence of tickers. If exists a ticker steps with the same tag, it will be removed.
    * @param tag The tag of canvas element that will use the tickers.
    * @param steps The steps of the tickers.
+   * @param currentStepNumber The current step number. It is used to continue the sequence of tickers.
    * @returns
    * @example
    * ```typescript
    * GameWindowManager.addTickersSteps("alien", [
-   *     new TickerRotate({ speed: 0.1, clockwise: true }, 2000),
-   *     Pause(500),
-   *     new TickerRotate({ speed: 0.2, clockwise: false }, 2000),
+   *     new RotateTicker({ speed: 0.1, clockwise: true }, 2), // 2 seconds
+   *     Pause(1), // 1 second
+   *     new RotateTicker({ speed: 0.2, clockwise: false }, 2),
    *     Repeat,
    * ])
    * ```
    */
-  static addTickersSteps(tag, steps) {
+  static addTickersSteps(tag, steps, currentStepNumber = 0) {
     if (steps.length == 0) {
       console.warn("[Pixi'VN] The steps of the tickers is empty");
       return;
     }
-    let alredyExists = _GameWindowManager._currentTickersSteps[tag] !== void 0;
+    _GameWindowManager.removeTickerStepByCanvasElement(tag);
     _GameWindowManager._currentTickersSteps[tag] = {
-      currentStepNumber: 0,
-      steps: steps.map((s) => {
-        if (s === Repeat) {
-          return s;
+      currentStepNumber,
+      steps: steps.map((step) => {
+        if (step === Repeat) {
+          return step;
         }
-        if (!s.duration) {
-          console.warn("[Pixi'VN] Duration is not defined, so it will be set to 1000");
-          s.duration = 1e3;
+        if (step.hasOwnProperty("type") && step.type === "pause") {
+          return step;
         }
-        if (s.hasOwnProperty("type") && s.type === PauseValueType) {
-          return s;
-        }
-        let tickerName = s.constructor.name;
+        let tickerName = step.constructor.name;
         return {
           ticker: tickerName,
-          args: s.args,
-          duration: s.duration
+          args: createExportableElement(step.args),
+          duration: step.duration
         };
       })
     };
-    if (!alredyExists) {
+    _GameWindowManager.runTickersSteps(tag);
+  }
+  static restoneTickersSteps(data) {
+    for (let tag in data) {
+      let steps = data[tag];
+      _GameWindowManager._currentTickersSteps[tag] = steps;
       _GameWindowManager.runTickersSteps(tag);
     }
   }
@@ -1172,12 +1225,17 @@ var _GameWindowManager = class _GameWindowManager {
         return;
       }
     }
-    if (step.hasOwnProperty("type") && step.type === PauseValueType) {
+    if (step.hasOwnProperty("type") && step.type === "pause") {
       let timeout = setTimeout(() => {
+        let tickerTimeoutInfo = _GameWindowManager._currentTickersTimeouts[timeout.toString()];
+        if (tickerTimeoutInfo) {
+          tickerTimeoutInfo.tags.forEach((tag2) => {
+            _GameWindowManager.nextTickerStep(tag2);
+          });
+        }
         _GameWindowManager.removeTickerTimeoutInfo(timeout);
-        _GameWindowManager.nextTickerStep(tag);
-      }, step.duration);
-      _GameWindowManager.addTickerTimeoutInfo(tag, "steps", timeout.toString());
+      }, step.duration * 1e3);
+      _GameWindowManager.addTickerTimeoutInfo(tag, "steps", timeout.toString(), false);
       return;
     }
     let ticker = geTickerInstanceByClassName(step.ticker, step.args, step.duration, step.priority);
@@ -1185,57 +1243,88 @@ var _GameWindowManager = class _GameWindowManager {
       console.error(`[Pixi'VN] Ticker ${step.ticker} not found`);
       return;
     }
-    _GameWindowManager.addTicker(tag, ticker);
+    let tickerName = ticker.constructor.name;
+    let tickerHistory = {
+      fn: () => {
+      },
+      className: tickerName,
+      args: createExportableElement(ticker.args),
+      canvasElementTags: [tag],
+      priority: ticker.priority,
+      duration: ticker.duration,
+      createdByTicketStepsId: tag
+    };
+    let id = _GameWindowManager.generateTickerId(tickerHistory);
+    _GameWindowManager.pushTicker(id, tickerHistory, ticker);
+    if (ticker.duration) {
+      let timeout = setTimeout(() => {
+        let tickerTimeoutInfo = _GameWindowManager._currentTickersTimeouts[timeout.toString()];
+        if (tickerTimeoutInfo) {
+          _GameWindowManager.removeTicker(id);
+          tickerTimeoutInfo.tags.forEach((tag2) => {
+            _GameWindowManager.nextTickerStep(tag2);
+          });
+        }
+        _GameWindowManager.removeTickerTimeoutInfo(timeout);
+      }, ticker.duration * 1e3);
+      _GameWindowManager.addTickerTimeoutInfo(tag, tickerName, timeout.toString(), false);
+    }
   }
   static nextTickerStep(tag) {
-    if (typeof tag === "string") {
-      tag = [tag];
+    if (_GameWindowManager._currentTickersSteps[tag]) {
+      let steps = _GameWindowManager._currentTickersSteps[tag];
+      if (steps.currentStepNumber + 1 < steps.steps.length) {
+        steps.currentStepNumber++;
+        _GameWindowManager._currentTickersSteps[tag] = steps;
+        _GameWindowManager.runTickersSteps(tag);
+      } else {
+        _GameWindowManager.removeTickerStepByCanvasElement(tag);
+      }
     }
-    tag.forEach((tag2) => {
-      if (_GameWindowManager._currentTickersSteps[tag2]) {
-        let steps = _GameWindowManager._currentTickersSteps[tag2];
-        if (steps.currentStepNumber + 1 < steps.steps.length) {
-          steps.currentStepNumber++;
-          _GameWindowManager._currentTickersSteps[tag2] = steps;
-          _GameWindowManager.runTickersSteps(tag2);
-        } else {
-          delete _GameWindowManager._currentTickersSteps[tag2];
-        }
+  }
+  static onEndOfTicker(canvasElementTags, ticker, canvasElementTagsToDelete, tickerId) {
+    let tickerData = _GameWindowManager._currentTickers[tickerId];
+    _GameWindowManager.removeAssociationBetweenTickerCanvasElement(canvasElementTags, ticker);
+    _GameWindowManager.removeCanvasElement(canvasElementTagsToDelete);
+    if (tickerData) {
+      _GameWindowManager.removeTicker(tickerId);
+      if (tickerData.duration == void 0 && tickerData.createdByTicketStepsId) {
+        _GameWindowManager.nextTickerStep(tickerData.createdByTicketStepsId);
       }
-    });
+    }
   }
   /**
    * Remove a connection between a canvas element and a ticker.
    * And remove the ticker if there is no canvas element connected to it.
-   * @param tag The tag of the canvas element that will use the ticker.
+   * @param tags The tag of the canvas element that will use the ticker.
    * @param ticker The ticker class to be removed.
    * @example
    * ```typescript
-   * GameWindowManager.removeAssociationBetweenTickerCanvasElement("alien", TickerRotate)
+   * GameWindowManager.removeAssociationBetweenTickerCanvasElement("alien", RotateTicker)
    * ```
    */
-  static removeAssociationBetweenTickerCanvasElement(tag, ticker) {
+  static removeAssociationBetweenTickerCanvasElement(tags, ticker) {
     let tickerName;
-    if (ticker instanceof TickerBase) {
+    if (typeof ticker === "string") {
+      tickerName = ticker;
+    } else if (ticker instanceof TickerBase) {
       tickerName = ticker.constructor.name;
     } else {
       tickerName = ticker.name;
     }
-    if (typeof tag === "string") {
-      tag = [tag];
+    if (typeof tags === "string") {
+      tags = [tags];
     }
-    _GameWindowManager._currentTickers = _GameWindowManager._currentTickers.map((t) => {
-      if (t.className === tickerName) {
-        t.canvasElementTags = t.canvasElementTags.filter((e) => !tag.includes(e));
+    for (let id in _GameWindowManager._currentTickers) {
+      let ticker2 = _GameWindowManager._currentTickers[id];
+      if (ticker2.className === tickerName) {
+        _GameWindowManager._currentTickers[id].canvasElementTags = ticker2.canvasElementTags.filter((e) => !tags.includes(e));
       }
-      return t;
-    });
-    for (let timeout in _GameWindowManager.currentTickersTimeouts) {
-      let t = _GameWindowManager.currentTickersTimeouts[timeout].tags.filter((e) => !tag.includes(e));
-      if (t.length == 0) {
-        _GameWindowManager.removeTickerTimeoutInfo(timeout);
-      } else {
-        _GameWindowManager.currentTickersTimeouts[timeout].tags = t;
+    }
+    for (let timeout in _GameWindowManager._currentTickersTimeouts) {
+      let TickerTimeout = _GameWindowManager._currentTickersTimeouts[timeout];
+      if (TickerTimeout.ticker === tickerName && TickerTimeout.canBeDeletedBeforeEnd) {
+        _GameWindowManager._currentTickersTimeouts[timeout].tags = TickerTimeout.tags.filter((t) => !tags.includes(t));
       }
     }
     _GameWindowManager.removeTickersWithoutAssociatedCanvasElement();
@@ -1244,49 +1333,117 @@ var _GameWindowManager = class _GameWindowManager {
    * Remove all tickers that are not connected to any existing canvas element.
    */
   static removeTickersWithoutAssociatedCanvasElement() {
-    let currentTickers = _GameWindowManager._currentTickers.map((t) => {
-      t.canvasElementTags = t.canvasElementTags.filter((e) => _GameWindowManager._children[e]);
-      return t;
-    });
-    currentTickers.filter((t) => t.canvasElementTags.length === 0).forEach((t) => {
-      _GameWindowManager.app.ticker.remove(t.fn);
-    });
-    currentTickers = currentTickers.filter((t) => t.canvasElementTags.length > 0);
-    _GameWindowManager._currentTickers = currentTickers;
+    for (let id in _GameWindowManager._currentTickers) {
+      let ticker = _GameWindowManager._currentTickers[id];
+      ticker.canvasElementTags = ticker.canvasElementTags.filter((e) => _GameWindowManager._children[e]);
+      if (ticker.canvasElementTags.length === 0) {
+        _GameWindowManager.removeTicker(id);
+      }
+    }
     for (let tag in _GameWindowManager._currentTickersSteps) {
       if (_GameWindowManager._children[tag] === void 0) {
         delete _GameWindowManager._currentTickersSteps[tag];
       }
     }
+    Object.entries(_GameWindowManager._currentTickersTimeouts).forEach(([timeout, { tags }]) => {
+      if (tags.length === 0) {
+        _GameWindowManager.removeTickerTimeout(timeout);
+      }
+    });
   }
-  static addTickerTimeoutInfo(tags, ticker, timeout) {
+  static addTickerTimeoutInfo(tags, ticker, timeout, canBeDeletedBeforeEnd) {
     if (typeof tags === "string") {
       tags = [tags];
     }
-    _GameWindowManager.currentTickersTimeouts[timeout] = {
+    _GameWindowManager._currentTickersTimeouts[timeout] = {
       tags,
-      ticker
+      ticker,
+      canBeDeletedBeforeEnd
     };
   }
   static removeTickerTimeoutInfo(timeout) {
     if (typeof timeout !== "string") {
       timeout = timeout.toString();
     }
-    if (_GameWindowManager.currentTickersTimeouts[timeout]) {
-      delete _GameWindowManager.currentTickersTimeouts[timeout];
+    if (_GameWindowManager._currentTickersTimeouts[timeout]) {
+      delete _GameWindowManager._currentTickersTimeouts[timeout];
+    }
+  }
+  static removeTickerTimeout(timeout) {
+    if (typeof timeout !== "string") {
+      timeout = timeout.toString();
+    }
+    clearTimeout(Number(timeout));
+    _GameWindowManager.removeTickerTimeoutInfo(timeout);
+  }
+  static removeTickerTimeoutsByTag(tag, checkCanBeDeletedBeforeEnd) {
+    for (let timeout in _GameWindowManager._currentTickersTimeouts) {
+      let tagsWithoutTagToRemove = _GameWindowManager._currentTickersTimeouts[timeout].tags.filter((t) => t !== tag);
+      if (tagsWithoutTagToRemove.length === 0) {
+        let canBeDeletedBeforeEnd = _GameWindowManager._currentTickersTimeouts[timeout].canBeDeletedBeforeEnd;
+        if (!checkCanBeDeletedBeforeEnd || canBeDeletedBeforeEnd) {
+          _GameWindowManager.removeTickerTimeout(timeout);
+        }
+      } else {
+        _GameWindowManager._currentTickersTimeouts[timeout].tags = tagsWithoutTagToRemove;
+      }
     }
   }
   /**
    * Remove all tickers from the canvas.
    */
-  static removeTickers() {
+  static removeAllTickers() {
     _GameWindowManager._currentTickersSteps = {};
-    _GameWindowManager._currentTickers.forEach((t) => {
-      _GameWindowManager.app.ticker.remove(t.fn);
+    Object.keys(_GameWindowManager._currentTickers).forEach((id) => {
+      _GameWindowManager.removeTicker(id);
+    });
+    _GameWindowManager._currentTickers = {};
+    for (let timeout in _GameWindowManager._currentTickersTimeouts) {
+      _GameWindowManager.removeTickerTimeout(timeout);
+    }
+  }
+  /**
+   * Remove all tickers from a canvas element.
+   * @param tag The tag of the canvas element that will use the ticker.
+   */
+  static removeTickerByCanvasElement(tag) {
+    if (typeof tag === "string") {
+      tag = [tag];
+    }
+    tag.forEach((tag2) => {
+      for (let id in _GameWindowManager._currentTickers) {
+        let ticker = _GameWindowManager._currentTickers[id];
+        if (ticker.canvasElementTags.includes(tag2)) {
+          _GameWindowManager.removeTicker(id);
+        }
+      }
+      if (_GameWindowManager._currentTickersSteps[tag2]) {
+        delete _GameWindowManager._currentTickersSteps[tag2];
+      }
+      _GameWindowManager.removeTickerTimeoutsByTag(tag2, false);
+      delete _GameWindowManager._currentTickersSteps[tag2];
     });
-    _GameWindowManager._currentTickers = [];
-    for (let timeout in _GameWindowManager.currentTickersTimeouts) {
-      _GameWindowManager.removeTickerTimeoutInfo(timeout);
+  }
+  static removeTickerStepByCanvasElement(tag) {
+    if (_GameWindowManager._currentTickersSteps[tag]) {
+      delete _GameWindowManager._currentTickersSteps[tag];
+    }
+    for (let id in _GameWindowManager._currentTickers) {
+      let ticker = _GameWindowManager._currentTickers[id];
+      if (ticker.createdByTicketStepsId === tag) {
+        _GameWindowManager.removeTicker(id);
+      }
+    }
+  }
+  static removeTicker(tickerId) {
+    let ticker = _GameWindowManager._currentTickers[tickerId];
+    if (ticker) {
+      if (ticker.args.hasOwnProperty(tagToRemoveAfter)) {
+        let tagToRemoveAfter2 = ticker.args.tagToRemoveAfter;
+        _GameWindowManager.removeCanvasElement(tagToRemoveAfter2);
+      }
+      _GameWindowManager.app.ticker.remove(ticker.fn);
+      delete _GameWindowManager._currentTickers[tickerId];
     }
   }
   /**
@@ -1313,7 +1470,8 @@ var _GameWindowManager = class _GameWindowManager {
       currentElements[tag] = exportCanvasElement(_GameWindowManager._children[tag]);
     }
     return {
-      currentTickers: createExportableElement(_GameWindowManager._currentTickers),
+      currentTickers: createExportableElement(_GameWindowManager.currentTickersWithoutCreatedBySteps),
+      currentTickersSteps: createExportableElement(_GameWindowManager._currentTickersSteps),
       currentElements: createExportableElement(currentElements),
       childrenTagsOrder: createExportableElement(_GameWindowManager.childrenTagsOrder)
     };
@@ -1348,7 +1506,8 @@ var _GameWindowManager = class _GameWindowManager {
       }
       if (data.hasOwnProperty("currentTickers")) {
         let currentTickers = data["currentTickers"];
-        currentTickers.forEach((t) => {
+        for (let id in currentTickers) {
+          let t = currentTickers[id];
           let tags = t.canvasElementTags;
           let ticker = geTickerInstanceByClassName(t.className, t.args, t.duration, t.priority);
           if (ticker) {
@@ -1356,7 +1515,11 @@ var _GameWindowManager = class _GameWindowManager {
           } else {
             console.error(`[Pixi'VN] Ticker ${t.className} not found`);
           }
-        });
+        }
+      }
+      if (data.hasOwnProperty("currentTickersSteps")) {
+        let currentTickersSteps = data["currentTickersSteps"];
+        _GameWindowManager.restoneTickersSteps(currentTickersSteps);
       }
     } catch (e) {
       console.error("[Pixi'VN] Error importing data", e);
@@ -1370,9 +1533,9 @@ _GameWindowManager._children = {};
  * The order of the children tags.
  */
 _GameWindowManager.childrenTagsOrder = [];
-_GameWindowManager._currentTickers = [];
+_GameWindowManager._currentTickers = {};
 _GameWindowManager._currentTickersSteps = {};
-_GameWindowManager.currentTickersTimeouts = {};
+_GameWindowManager._currentTickersTimeouts = {};
 var GameWindowManager = _GameWindowManager;
 
 // src/managers/StepManager.ts
@@ -1439,7 +1602,8 @@ var _GameStepManager = class _GameStepManager {
         canvas: {
           childrenTagsOrder: [],
           currentElements: {},
-          currentTickers: []
+          currentTickers: {},
+          currentTickersSteps: {}
         },
         labelIndex: -1,
         openedLabels: []
@@ -1650,8 +1814,15 @@ var _GameStepManager = class _GameStepManager {
       }
       try {
         if (labelId === CLOSE_LABEL_ID) {
-          let closeLabel = newCloseLabel(choiseMade);
-          return _GameStepManager.closeChoiceMenu(closeLabel, props);
+          let closeCurrentLabel = newCloseLabel(choiseMade);
+          let choice = {
+            label: closeCurrentLabel,
+            text: "",
+            closeCurrentLabel: false,
+            type: "close",
+            props: {}
+          };
+          return _GameStepManager.closeChoiceMenu(choice, props);
         }
         let tempLabel = getLabelById(labelId);
         if (!tempLabel) {
@@ -1701,8 +1872,15 @@ var _GameStepManager = class _GameStepManager {
       }
       try {
         if (labelId === CLOSE_LABEL_ID) {
-          let closeLabel = newCloseLabel(choiseMade);
-          return _GameStepManager.closeChoiceMenu(closeLabel, props);
+          let closeCurrentLabel = newCloseLabel(choiseMade);
+          let choice = {
+            label: closeCurrentLabel,
+            text: "",
+            closeCurrentLabel: false,
+            type: "close",
+            props: {}
+          };
+          return _GameStepManager.closeChoiceMenu(choice, props);
         }
         let tempLabel = getLabelById(labelId);
         if (!tempLabel) {
@@ -1718,7 +1896,8 @@ var _GameStepManager = class _GameStepManager {
   }
   /**
    * When the player is in a choice menu, can use this function to exit to the choice menu.
-   * @param props The props to pass to the step.
+   * @param choice
+   * @param props
    * @returns StepLabelResultType or undefined.
    * @example
    * ```typescript
@@ -1729,12 +1908,16 @@ var _GameStepManager = class _GameStepManager {
    * })
    * ```
    */
-  static closeChoiceMenu(label, props) {
+  static closeChoiceMenu(choice, props) {
     return __async(this, null, function* () {
+      let label = choice.label;
       let choiseMade = void 0;
       if (typeof label.choiseIndex === "number") {
         choiseMade = label.choiseIndex;
       }
+      if (choice.closeCurrentLabel) {
+        _GameStepManager.closeCurrentLabel();
+      }
       return _GameStepManager.runNextStep(props, choiseMade);
     });
   }
@@ -1937,8 +2120,9 @@ var Close = "close";
 var ChoiceMenuOptionClose = class {
   /**
    * @param text Text to be displayed in the menu
+   * @param closeCurrentLabel If true, the current label will be closed. @default false
    */
-  constructor(text) {
+  constructor(text, closeCurrentLabel = false) {
     /**
      * Label to be opened when the option is selected
      */
@@ -1952,6 +2136,7 @@ var ChoiceMenuOptionClose = class {
      */
     this.props = {};
     this.text = text;
+    this.closeCurrentLabel = closeCurrentLabel;
   }
 };
 
@@ -2036,7 +2221,8 @@ function setChoiceMenuOptions(options) {
     if (option instanceof ChoiceMenuOptionClose) {
       return {
         text: option.text,
-        type: Close
+        type: Close,
+        closeCurrentLabel: option.closeCurrentLabel
       };
     }
     return __spreadProps(__spreadValues({}, option), {
@@ -2057,6 +2243,7 @@ function getChoiceMenuOptions() {
           text: option.text,
           label: itemLabel,
           type: Close,
+          closeCurrentLabel: option.closeCurrentLabel,
           props: {}
         });
         return;
@@ -2138,20 +2325,15 @@ function clearAllGameDatas() {
   GameWindowManager.clear();
   GameStepManager.clear();
 }
-var TickerFadeAlpha = class extends TickerBase {
-  /**
-   * The method that will be called every frame to fade the alpha of the canvas element of the canvas.
-   * @param delta The delta time
-   * @param args The arguments that are passed to the ticker
-   * @param tags The tags of the canvas element that are connected to this ticker
-   */
-  fn(t, args, tags) {
+var FadeAlphaTicker = class extends TickerBase {
+  fn(ticker, args, tags, tickerId) {
     let type = args.type === void 0 ? "hide" : args.type;
-    let speed = args.speed === void 0 ? 0.1 : args.speed;
+    let duration = args.duration === void 0 ? 1 : args.duration;
+    let speed = 1 / (duration * 60);
     let limit = args.limit === void 0 ? type === "hide" ? 0 : 1 : args.limit;
-    let removeElementAfter = args.tagToRemoveAfter || [];
-    if (typeof removeElementAfter === "string") {
-      removeElementAfter = [removeElementAfter];
+    let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
+    if (typeof tagToRemoveAfter2 === "string") {
+      tagToRemoveAfter2 = [tagToRemoveAfter2];
     }
     if (type === "hide" && limit < 0) {
       limit = 0;
@@ -2172,61 +2354,88 @@ var TickerFadeAlpha = class extends TickerBase {
       let element = GameWindowManager.getCanvasElement(tag);
       if (element && element instanceof Container) {
         if (type === "show" && element.alpha < limit) {
-          element.alpha += speed * t.deltaTime;
+          element.alpha += speed * ticker.deltaTime;
         } else if (type === "hide" && element.alpha > limit) {
-          element.alpha -= speed * t.deltaTime;
-        } else {
+          element.alpha -= speed * ticker.deltaTime;
+        }
+        if (type === "show" && element.alpha >= limit) {
           element.alpha = limit;
-          GameWindowManager.removeAssociationBetweenTickerCanvasElement(tag, this);
-          GameWindowManager.removeCanvasElement(removeElementAfter);
+          GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+        } else if (type === "hide" && element.alpha <= limit) {
+          element.alpha = limit;
+          GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
         }
       }
     });
   }
 };
-TickerFadeAlpha = __decorateClass([
+FadeAlphaTicker = __decorateClass([
   tickerDecorator()
-], TickerFadeAlpha);
+], FadeAlphaTicker);
 
 // src/functions/TickerUtility.ts
 function updateTickerProgression(args, propertyName, progression) {
-  if (args.hasOwnProperty(propertyName) && typeof args[propertyName] !== "number") {
+  if (args[propertyName] === void 0 || !progression || args[propertyName] === progression.limit) {
     return;
   }
-  if (args[propertyName] !== void 0 && progression && args[propertyName] !== progression.limit) {
+  if (typeof args[propertyName] === "number") {
     if (progression.type === "linear") {
-      args[propertyName] += progression.amt;
-      if (progression.limit !== void 0) {
-        if (args[propertyName] > progression.limit && progression.amt > 0) {
-          args[propertyName] = progression.limit;
-        } else if (args[propertyName] < progression.limit && progression.amt < 0) {
-          args[propertyName] = progression.limit;
-        }
-      }
+      args[propertyName] = getLinearProgression(args[propertyName], progression);
     } else if (progression.type === "exponential") {
-      args[propertyName] += args[propertyName] * progression.percentage;
-      if (progression.limit !== void 0) {
-        if (args[propertyName] > progression.limit && progression.percentage > 0) {
-          args[propertyName] = progression.limit;
-        } else if (args[propertyName] < progression.limit && progression.percentage < 0) {
-          args[propertyName] = progression.limit;
-        }
-      }
+      args[propertyName] = getExponentialProgression(args[propertyName], progression);
+    }
+  } else if (args[propertyName] !== void 0 && typeof args[propertyName] === "object" && args[propertyName].haveOwnProperty("x") && args[propertyName].haveOwnProperty("y") && typeof args[propertyName].x === "number" && typeof args[propertyName].y === "number") {
+    if (progression.type === "linear") {
+      args[propertyName].x = getLinearProgression(args[propertyName].x, progression);
+      args[propertyName].y = getLinearProgression(args[propertyName].y, progression);
+    } else if (progression.type === "exponential") {
+      args[propertyName].x = getExponentialProgression(args[propertyName].x, progression);
+      args[propertyName].y = getExponentialProgression(args[propertyName].y, progression);
     }
   }
 }
+function getLinearProgression(number, progression) {
+  if (progression.limit !== void 0) {
+    if (number > progression.limit && progression.amt > 0) {
+      return progression.limit;
+    } else if (number < progression.limit && progression.amt < 0) {
+      return progression.limit;
+    }
+  }
+  return number + progression.amt / 60;
+}
+function getExponentialProgression(number, progression) {
+  if (progression.limit !== void 0) {
+    if (number > progression.limit && progression.percentage > 0) {
+      return progression.limit;
+    } else if (number < progression.limit && progression.percentage < 0) {
+      return progression.limit;
+    }
+  }
+  return number + number * progression.percentage;
+}
 
-// src/classes/ticker/TickerMove.ts
-var TickerMove = class extends TickerBase {
-  /**
-   * The method that will be called every frame to move the canvas element of the canvas.
-   * @param t The ticker that is calling this method
-   * @param args The arguments that are passed to the ticker
-   * @param tags The tags of the canvas element that are connected to this ticker
-   */
-  fn(t, args, tags) {
-    let speed = args.speed === void 0 ? 0.1 : args.speed;
+// src/classes/ticker/MoveTicker.ts
+var MoveTicker = class extends TickerBase {
+  fn(ticker, args, tags, tickerId) {
+    let xSpeed = 1;
+    let ySpeed = 1;
+    if (args.speed) {
+      if (typeof args.speed === "number") {
+        xSpeed = args.speed;
+        ySpeed = args.speed;
+      } else {
+        xSpeed = args.speed.x;
+        ySpeed = args.speed.y;
+      }
+    }
+    xSpeed /= 60;
+    ySpeed /= 60;
     let destination = args.destination;
+    let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
+    if (typeof tagToRemoveAfter2 === "string") {
+      tagToRemoveAfter2 = [tagToRemoveAfter2];
+    }
     tags.filter((tag) => {
       var _a;
       let element = GameWindowManager.getCanvasElement(tag);
@@ -2239,41 +2448,42 @@ var TickerMove = class extends TickerBase {
     }).forEach((tag) => {
       let element = GameWindowManager.getCanvasElement(tag);
       if (element && element instanceof Container) {
-        let xDistance = destination.x - element.x;
+        let xDistance = destination.x - element.x > 0 ? 1 : -1;
         if (xDistance != 0) {
-          element.x += xDistance / speed * t.deltaTime;
+          element.x += xDistance * xSpeed * ticker.deltaTime;
           let newDistance = destination.x - element.x;
           if (xDistance < 0 && newDistance > 0 || xDistance > 0 && newDistance < 0) {
             element.x = destination.x;
           }
         }
-        let yDistance = destination.y - element.y;
+        let yDistance = destination.y - element.y > 0 ? 1 : -1;
         if (yDistance != 0) {
-          element.y += yDistance / speed * t.deltaTime;
+          element.y += yDistance * ySpeed * ticker.deltaTime;
           let newDistance = destination.y - element.y;
           if (yDistance < 0 && newDistance > 0 || yDistance > 0 && newDistance < 0) {
             element.y = destination.y;
           }
         }
+        if (element.x == destination.x && element.y == destination.y) {
+          GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+        }
       }
     });
     if (args.speedProgression)
       updateTickerProgression(args, "speed", args.speedProgression);
   }
 };
-TickerMove = __decorateClass([
+MoveTicker = __decorateClass([
   tickerDecorator()
-], TickerMove);
-var TickerRotate = class extends TickerBase {
-  /**
-   * The method that will be called every frame to rotate the canvas element of the canvas.
-   * @param delta The delta time
-   * @param args The arguments that are passed to the ticker
-   * @param tags The tags of the canvas element that are connected to this ticker
-   */
-  fn(t, args, tags) {
-    let speed = args.speed === void 0 ? 0.1 : args.speed;
+], MoveTicker);
+var RotateTicker = class extends TickerBase {
+  fn(ticker, args, tags, tickerId) {
+    let speed = (args.speed === void 0 ? 1 : args.speed) / 60;
     let clockwise = args.clockwise === void 0 ? true : args.clockwise;
+    let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
+    if (typeof tagToRemoveAfter2 === "string") {
+      tagToRemoveAfter2 = [tagToRemoveAfter2];
+    }
     tags.filter((tag) => {
       var _a;
       let element = GameWindowManager.getCanvasElement(tag);
@@ -2287,18 +2497,108 @@ var TickerRotate = class extends TickerBase {
       let element = GameWindowManager.getCanvasElement(tag);
       if (element && element instanceof Container) {
         if (clockwise)
-          element.rotation += speed * t.deltaTime;
+          element.rotation += speed * ticker.deltaTime;
         else
-          element.rotation -= speed * t.deltaTime;
+          element.rotation -= speed * ticker.deltaTime;
+        if (speed < 1e-5 && !(args.speedProgression && args.speedProgression.type == "linear" && args.speedProgression.amt != 0)) {
+          GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+        }
+      }
+    });
+    if (args.speedProgression)
+      updateTickerProgression(args, "speed", args.speedProgression);
+  }
+};
+RotateTicker = __decorateClass([
+  tickerDecorator()
+], RotateTicker);
+var ZoomTicker = class extends TickerBase {
+  fn(ticker, args, tags, tickerId) {
+    let xSpeed = 0.1;
+    let ySpeed = 0.1;
+    if (args.speed) {
+      if (typeof args.speed === "number") {
+        xSpeed = args.speed;
+        ySpeed = args.speed;
+      } else {
+        xSpeed = args.speed.x;
+        ySpeed = args.speed.y;
+      }
+    }
+    xSpeed /= 60;
+    ySpeed /= 60;
+    let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
+    if (typeof tagToRemoveAfter2 === "string") {
+      tagToRemoveAfter2 = [tagToRemoveAfter2];
+    }
+    let type = args.type || "zoom";
+    let xLimit = Infinity;
+    let yLimit = Infinity;
+    if (args.limit) {
+      if (typeof args.limit === "number") {
+        xLimit = args.limit;
+        yLimit = args.limit;
+      } else {
+        xLimit = args.limit.x;
+        yLimit = args.limit.y;
+      }
+    }
+    tags.filter((tag) => {
+      var _a;
+      let element = GameWindowManager.getCanvasElement(tag);
+      if (args.startOnlyIfHaveTexture) {
+        if (element && element instanceof Sprite && ((_a = element.texture) == null ? void 0 : _a.label) == "EMPTY") {
+          return false;
+        }
+      }
+      return true;
+    }).forEach((tag) => {
+      let element = GameWindowManager.getCanvasElement(tag);
+      if (element && element instanceof Container) {
+        if (type === "zoom" && (element.scale.x < xLimit || element.scale.y < yLimit)) {
+          element.scale.x += xSpeed * ticker.deltaTime;
+          element.scale.y += ySpeed * ticker.deltaTime;
+        } else if (type === "unzoom" && (element.scale.x > xLimit || element.scale.y > yLimit)) {
+          element.scale.x -= xSpeed * ticker.deltaTime;
+          element.scale.y -= ySpeed * ticker.deltaTime;
+        }
+        if (type === "zoom") {
+          if (element.scale.x > xLimit) {
+            element.scale.x = xLimit;
+          }
+          if (element.scale.y > yLimit) {
+            element.scale.y = yLimit;
+          }
+          if (element.scale.x >= xLimit && element.scale.y >= yLimit) {
+            element.scale.x = xLimit;
+            element.scale.y = yLimit;
+            GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+          }
+        } else if (type === "unzoom") {
+          if (element.scale.x < xLimit) {
+            element.scale.x = xLimit;
+          }
+          if (element.scale.y < yLimit) {
+            element.scale.y = yLimit;
+          }
+          if (element.scale.x <= xLimit && element.scale.y <= yLimit) {
+            element.scale.x = xLimit;
+            element.scale.y = yLimit;
+            GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+          }
+        }
+        if (xSpeed < 1e-5 && ySpeed < 1e-5 && !(args.speedProgression && args.speedProgression.type == "linear" && args.speedProgression.amt != 0)) {
+          GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
+        }
       }
     });
     if (args.speedProgression)
       updateTickerProgression(args, "speed", args.speedProgression);
   }
 };
-TickerRotate = __decorateClass([
+ZoomTicker = __decorateClass([
   tickerDecorator()
-], TickerRotate);
+], ZoomTicker);
 
 // src/functions/ImageUtility.ts
 function addImage(tag, imageUrl) {
@@ -2307,7 +2607,7 @@ function addImage(tag, imageUrl) {
   GameWindowManager.addCanvasElement(tag, image);
   return image;
 }
-function loadImages(canvasImages) {
+function loadImage(canvasImages) {
   return __async(this, null, function* () {
     if (!Array.isArray(canvasImages)) {
       return [canvasImages];
@@ -2328,39 +2628,92 @@ function loadImages(canvasImages) {
     });
   });
 }
+function showImage(tag, imageUrl) {
+  return __async(this, null, function* () {
+    let image = addImage(tag, imageUrl);
+    yield image.load();
+    return image;
+  });
+}
 function removeCanvasElement(tag) {
   GameWindowManager.removeCanvasElement(tag);
 }
-function showWithDissolveTransition(tag, image, speed, priority) {
-  return __async(this, null, function* () {
-    let specialTag = void 0;
+function showWithDissolveTransition(_0, _1) {
+  return __async(this, arguments, function* (tag, image, props = {}, priority) {
+    var _a;
+    let oldCanvasTag = void 0;
     if (GameWindowManager.getCanvasElement(tag)) {
-      specialTag = tag + "_temp_disolve";
-      GameWindowManager.editTagCanvasElement(tag, specialTag);
+      oldCanvasTag = tag + "_temp_disolve";
+      GameWindowManager.editCanvasElementTag(tag, oldCanvasTag);
     }
     let canvasElement;
     if (typeof image === "string") {
       canvasElement = addImage(tag, image);
     } else {
       canvasElement = image;
+      GameWindowManager.addCanvasElement(tag, canvasElement);
+    }
+    if (canvasElement instanceof CanvasImage && ((_a = canvasElement.texture) == null ? void 0 : _a.label) == "EMPTY") {
+      yield canvasElement.load();
     }
     canvasElement.alpha = 0;
-    let effect = new TickerFadeAlpha({
-      speed,
+    let effect = new FadeAlphaTicker(__spreadProps(__spreadValues({}, props), {
       type: "show",
-      tagToRemoveAfter: specialTag,
+      tagToRemoveAfter: oldCanvasTag,
       startOnlyIfHaveTexture: true
-    }, 1e4, priority);
+    }), 10, priority);
     GameWindowManager.addTicker(tag, effect);
-    if (canvasElement instanceof CanvasImage) {
-      return canvasElement.load();
-    }
     return;
   });
 }
-
-// src/constants.ts
-var PIXIVN_VERSION = "0.6.0";
+function removeWithDissolveTransition(tag, props = {}, priority) {
+  if (typeof tag === "string") {
+    tag = [tag];
+  }
+  let effect = new FadeAlphaTicker(__spreadProps(__spreadValues({}, props), {
+    type: "hide",
+    tagToRemoveAfter: tag,
+    startOnlyIfHaveTexture: true
+  }), 10, priority);
+  GameWindowManager.addTicker(tag, effect);
+}
+function showWithFadeTransition(_0, _1) {
+  return __async(this, arguments, function* (tag, image, props = {}, priority) {
+    var _a;
+    if (!GameWindowManager.getCanvasElement(tag)) {
+      return showWithDissolveTransition(tag, image, props, priority);
+    }
+    let oldCanvasTag = tag + "_temp_fade";
+    GameWindowManager.editCanvasElementTag(tag, oldCanvasTag);
+    let canvasElement;
+    if (typeof image === "string") {
+      canvasElement = addImage(tag, image);
+    } else {
+      canvasElement = image;
+      GameWindowManager.addCanvasElement(tag, canvasElement);
+    }
+    if (canvasElement instanceof CanvasImage && ((_a = canvasElement.texture) == null ? void 0 : _a.label) == "EMPTY") {
+      yield canvasElement.load();
+    }
+    canvasElement.alpha = 0;
+    GameWindowManager.addTickersSteps(oldCanvasTag, [
+      new FadeAlphaTicker(__spreadProps(__spreadValues({}, props), {
+        type: "hide",
+        startOnlyIfHaveTexture: true
+      }))
+    ]);
+    GameWindowManager.addTickersSteps(tag, [
+      Pause(props.duration || 1),
+      new FadeAlphaTicker(__spreadProps(__spreadValues({}, props), {
+        type: "show",
+        startOnlyIfHaveTexture: true
+      }))
+    ]);
+  });
+}
+function removeWithFadeTransition(tag, props = {}, priority) {
+  return removeWithDissolveTransition(tag, props, priority);
+}
 
 // src/functions/SavesUtility.ts
 function getSaveData() {
@@ -2389,6 +2742,6 @@ function jsonToSaveData(json) {
   return JSON.parse(json);
 }
 
-export { addImage, clearAllGameDatas, clearChoiceMenuOptions, clearDialogue, getChoiceMenuOptions, getDialogue, getDialogueHistory, getFlag, getSaveData, getSaveJson, getTexture, loadImages, loadSaveData, loadSaveJson, removeCanvasElement, setChoiceMenuOptions, setDialogue, setFlag, showWithDissolveTransition };
+export { addImage, clearAllGameDatas, clearChoiceMenuOptions, clearDialogue, getChoiceMenuOptions, getDialogue, getDialogueHistory, getFlag, getSaveData, getSaveJson, getTexture, loadImage, loadSaveData, loadSaveJson, removeCanvasElement, removeWithDissolveTransition, removeWithFadeTransition, setChoiceMenuOptions, setDialogue, setFlag, showImage, showWithDissolveTransition, showWithFadeTransition };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map