@drincs/pixi-vn 0.6.3 → 0.6.5

package/dist/functions/SavesUtility.d.mts

@@ -14,10 +14,10 @@ import '../interface/IHistoryStep.mjs';
 import 'deep-diff';
 import '../classes/ChoiceMenuOption.mjs';
 import '../types/LabelIdType.mjs';
-import '../classes/Label.mjs';
-import '../types/StepHistoryDataType.mjs';
+import '../LabelProps-CmRpvUJm.mjs';
 import '../types/StepLabelType.mjs';
 import '@drincs/pixi-vn/dist/override';
+import '../types/StepHistoryDataType.mjs';
 import '../types/CloseType.mjs';
 import '../types/LabelRunModeType.mjs';
 import '../interface/IOpenedLabel.mjs';
@@ -54,7 +54,7 @@ declare function getSaveJson(): string;
  * @param data The save data
  * @param navigate The function to navigate to a path
  */
-declare function loadSaveData(data: ISaveData, navigate: (path: string) => void): void;
+declare function loadSaveData(data: ISaveData, navigate: (path: string) => void): Promise<void>;
 /**
  * Load the save data from a JSON string
  * @param dataString The save data as a JSON string
@@ -83,7 +83,7 @@ declare function loadSaveData(data: ISaveData, navigate: (path: string) => void)
  * }
  * ```
  */
-declare function loadSaveJson(dataString: string, navigate: (path: string) => void): void;
+declare function loadSaveJson(dataString: string, navigate: (path: string) => void): Promise<void>;
 /**
  * Convert a JSON string to a save data
  * @param json The JSON string

package/dist/functions/SavesUtility.d.ts

@@ -14,10 +14,10 @@ import '../interface/IHistoryStep.js';
 import 'deep-diff';
 import '../classes/ChoiceMenuOption.js';
 import '../types/LabelIdType.js';
-import '../classes/Label.js';
-import '../types/StepHistoryDataType.js';
+import '../LabelProps-CFV-zRjG.js';
 import '../types/StepLabelType.js';
 import '@drincs/pixi-vn/dist/override';
+import '../types/StepHistoryDataType.js';
 import '../types/CloseType.js';
 import '../types/LabelRunModeType.js';
 import '../interface/IOpenedLabel.js';
@@ -54,7 +54,7 @@ declare function getSaveJson(): string;
  * @param data The save data
  * @param navigate The function to navigate to a path
  */
-declare function loadSaveData(data: ISaveData, navigate: (path: string) => void): void;
+declare function loadSaveData(data: ISaveData, navigate: (path: string) => void): Promise<void>;
 /**
  * Load the save data from a JSON string
  * @param dataString The save data as a JSON string
@@ -83,7 +83,7 @@ declare function loadSaveData(data: ISaveData, navigate: (path: string) => void)
  * }
  * ```
  */
-declare function loadSaveJson(dataString: string, navigate: (path: string) => void): void;
+declare function loadSaveJson(dataString: string, navigate: (path: string) => void): Promise<void>;
 /**
  * Convert a JSON string to a save data
  * @param json The JSON string

package/dist/functions/SavesUtility.js

@@ -58,7 +58,7 @@ var __async = (__this, __arguments, generator) => {
 };
 
 // src/constants.ts
-var PIXIVN_VERSION = "0.6.3";
+var PIXIVN_VERSION = "0.6.5";
 var Repeat = "repeat";
 function getStepSha1(step) {
   let sha1String = sha1__default.default(step.toString().toLocaleLowerCase());
@@ -73,14 +73,15 @@ var Label = class {
   /**
    * @param id is the id of the label
    * @param steps is the list of steps that the label will perform
-   * @param onStepRun is a function that will be executed before any step is executed, is useful for example to make sure all images used have been cached
-   * @param choiseIndex is the index of the choice that the label will perform
+   * @param props is the properties of the label
    */
-  constructor(id, steps, onStepRun, choiseIndex) {
+  constructor(id, steps, props) {
     this._id = id;
     this._steps = steps;
-    this._onStepRun = onStepRun;
-    this._choiseIndex = choiseIndex;
+    this._onStepStart = props == null ? void 0 : props.onStepStart;
+    this._onLoadStep = props == null ? void 0 : props.onLoadStep;
+    this._onStepEnd = props == null ? void 0 : props.onStepEnd;
+    this._choiseIndex = props == null ? void 0 : props.choiseIndex;
   }
   /**
    * Get the id of the label. This variable is used in the system to get the label by id, {@link getLabelById}
@@ -117,18 +118,32 @@ var Label = class {
     return res;
   }
   /**
-   * Get the function that will be executed before any step is executed, is useful for example to make sure all images used have been cached
+   * Is a function that will be executed in {@link Label#onStepStart} and when the user goes back to it or when the user laods a save file.
+   * @returns Promise<void> or void
+   */
+  get onStepStart() {
+    return (stepIndex, label) => __async(this, null, function* () {
+      if (this._onLoadStep) {
+        yield this._onLoadStep(stepIndex, label);
+      }
+      if (this._onStepStart) {
+        return yield this._onStepStart(stepIndex, label);
+      }
+    });
+  }
+  /**
+   * Get the function that will be executed a old step is reloaded. A step is reloaded when the user goes back to it or when the user laods a save file.
    * @returns Promise<void> or void
-   * @example
-   * ```typescript
-   * newLabel("id", [], () => {
-   *     Assets.load('path/to/image1.png')
-   *     Assets.load('path/to/image2.png')
-   * })
-   * ```
    */
-  get onStepRun() {
-    return this._onStepRun;
+  get onLoadStep() {
+    return this._onLoadStep;
+  }
+  /**
+   * Is a function that will be executed when the step ends.
+   * @returns Promise<void> or void
+   */
+  get onStepEnd() {
+    return this._onStepEnd;
   }
   get choiseIndex() {
     return this._choiseIndex;
@@ -138,7 +153,9 @@ var Label = class {
 // src/classes/CloseLabel.ts
 var CLOSE_LABEL_ID = "__close-label-id__";
 function newCloseLabel(choiseIndex) {
-  return new Label(CLOSE_LABEL_ID, [], void 0, choiseIndex);
+  return new Label(CLOSE_LABEL_ID, [], {
+    choiseIndex
+  });
 }
 
 // src/functions/CanvasUtility.ts
@@ -217,8 +234,6 @@ function getMemoryContainer(element) {
   };
 }
 function setMemoryContainer(element, memory) {
-  memory.width && (element.width = memory.width);
-  memory.height && (element.height = memory.height);
   memory.isRenderGroup && (element.isRenderGroup = memory.isRenderGroup);
   memory.blendMode && (element.blendMode = memory.blendMode);
   memory.tint && (element.tint = memory.tint);
@@ -251,6 +266,8 @@ function setMemoryContainer(element, memory) {
   memory.interactive && (element.interactive = memory.interactive);
   memory.interactiveChildren && (element.interactiveChildren = memory.interactiveChildren);
   memory.hitArea && (element.hitArea = memory.hitArea);
+  memory.width && (element.width = memory.width);
+  memory.height && (element.height = memory.height);
 }
 function getTexture(imageUrl) {
   return __async(this, null, function* () {
@@ -687,7 +704,10 @@ function getChoiceMenuOptions() {
       }
       let label = getLabelById(option.label);
       if (label) {
-        let itemLabel = new Label(label.id, label.steps, label.onStepRun, index);
+        let itemLabel = new Label(label.id, label.steps, {
+          onStepStart: label.onStepStart,
+          choiseIndex: index
+        });
         options.push(__spreadProps(__spreadValues({}, option), {
           label: itemLabel
         }));
@@ -778,8 +798,9 @@ FadeAlphaTicker = __decorateClass([
 ], FadeAlphaTicker);
 
 // src/functions/TickerUtility.ts
-function updateTickerProgression(args, propertyName, progression) {
-  if (args[propertyName] === void 0 || !progression || args[propertyName] === progression.limit) {
+function updateTickerProgression(args, propertyName, progression, valueConvert) {
+  let limit = valueConvert && progression.limit ? valueConvert(progression.limit) : progression.limit;
+  if (args[propertyName] === void 0 || !progression || args[propertyName] === limit) {
     return;
   }
   if (typeof args[propertyName] === "number") {
@@ -798,22 +819,25 @@ function updateTickerProgression(args, propertyName, 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;
+function getLinearProgression(number, progression, valueConvert) {
+  let limit = valueConvert && progression.limit ? valueConvert(progression.limit) : progression.limit;
+  let amt = valueConvert ? valueConvert(progression.amt) : progression.amt;
+  if (limit !== void 0) {
+    if (number > limit && amt > 0) {
+      return limit;
+    } else if (number < limit && amt < 0) {
+      return limit;
     }
   }
-  return number + progression.amt / 60;
+  return number + amt;
 }
-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;
+function getExponentialProgression(number, progression, valueConvert) {
+  let limit = valueConvert && progression.limit ? valueConvert(progression.limit) : progression.limit;
+  if (limit !== void 0) {
+    if (number > limit && progression.percentage > 0) {
+      return limit;
+    } else if (number < limit && progression.percentage < 0) {
+      return limit;
     }
   }
   return number + number * progression.percentage;
@@ -826,15 +850,13 @@ var MoveTicker = class extends TickerBase {
     let ySpeed = 1;
     if (args.speed) {
       if (typeof args.speed === "number") {
-        xSpeed = args.speed;
-        ySpeed = args.speed;
+        xSpeed = this.speedConvert(args.speed);
+        ySpeed = this.speedConvert(args.speed);
       } else {
-        xSpeed = args.speed.x;
-        ySpeed = args.speed.y;
+        xSpeed = this.speedConvert(args.speed.x);
+        ySpeed = this.speedConvert(args.speed.y);
       }
     }
-    xSpeed /= 60;
-    ySpeed /= 60;
     let destination = args.destination;
     let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
     if (typeof tagToRemoveAfter2 === "string") {
@@ -874,7 +896,10 @@ var MoveTicker = class extends TickerBase {
       }
     });
     if (args.speedProgression)
-      updateTickerProgression(args, "speed", args.speedProgression);
+      updateTickerProgression(args, "speed", args.speedProgression, this.speedConvert);
+  }
+  speedConvert(speed) {
+    return speed / 6;
   }
 };
 MoveTicker = __decorateClass([
@@ -882,7 +907,7 @@ MoveTicker = __decorateClass([
 ], MoveTicker);
 var RotateTicker = class extends TickerBase {
   fn(ticker, args, tags, tickerId) {
-    let speed = (args.speed === void 0 ? 1 : args.speed) / 60;
+    let speed = this.speedConvert(args.speed === void 0 ? 1 : args.speed);
     let clockwise = args.clockwise === void 0 ? true : args.clockwise;
     let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
     if (typeof tagToRemoveAfter2 === "string") {
@@ -910,7 +935,10 @@ var RotateTicker = class extends TickerBase {
       }
     });
     if (args.speedProgression)
-      updateTickerProgression(args, "speed", args.speedProgression);
+      updateTickerProgression(args, "speed", args.speedProgression, this.speedConvert);
+  }
+  speedConvert(speed) {
+    return speed / 60;
   }
 };
 RotateTicker = __decorateClass([
@@ -922,15 +950,13 @@ var ZoomTicker = class extends TickerBase {
     let ySpeed = 0.1;
     if (args.speed) {
       if (typeof args.speed === "number") {
-        xSpeed = args.speed;
-        ySpeed = args.speed;
+        xSpeed = this.speedConvert(args.speed);
+        ySpeed = this.speedConvert(args.speed);
       } else {
-        xSpeed = args.speed.x;
-        ySpeed = args.speed.y;
+        xSpeed = this.speedConvert(args.speed.x);
+        ySpeed = this.speedConvert(args.speed.y);
       }
     }
-    xSpeed /= 60;
-    ySpeed /= 60;
     let tagToRemoveAfter2 = args.tagToRemoveAfter || [];
     if (typeof tagToRemoveAfter2 === "string") {
       tagToRemoveAfter2 = [tagToRemoveAfter2];
@@ -997,7 +1023,10 @@ var ZoomTicker = class extends TickerBase {
       }
     });
     if (args.speedProgression)
-      updateTickerProgression(args, "speed", args.speedProgression);
+      updateTickerProgression(args, "speed", args.speedProgression, this.speedConvert);
+  }
+  speedConvert(speed) {
+    return speed / 60;
   }
   onEndOfTicker(tag, tickerId, _element, tagToRemoveAfter2) {
     GameWindowManager.onEndOfTicker(tag, this, tagToRemoveAfter2, tickerId);
@@ -1956,6 +1985,16 @@ var _GameStepManager = class _GameStepManager {
   static set originalStepData(value) {
     _GameStepManager._originalStepData = createExportableElement(value);
   }
+  static get currentStepData() {
+    let currentStepData = {
+      path: window.location.pathname,
+      storage: GameStorageManager.export(),
+      canvas: GameWindowManager.export(),
+      labelIndex: _GameStepManager.currentLabelStepIndex || 0,
+      openedLabels: createExportableElement(_GameStepManager._openedLabels)
+    };
+    return currentStepData;
+  }
   /* Edit History Methods */
   /**
    * Add a label to the history.
@@ -1963,19 +2002,13 @@ var _GameStepManager = class _GameStepManager {
    */
   static addStepHistory(step, choiseMade) {
     let stepHistory = getStepSha1(step);
-    let historyStep = {
-      path: window.location.pathname,
-      storage: GameStorageManager.export(),
-      canvas: GameWindowManager.export(),
-      labelIndex: _GameStepManager.currentLabelStepIndex || 0,
-      openedLabels: createExportableElement(_GameStepManager._openedLabels)
-    };
+    let currentStepData = _GameStepManager.currentStepData;
     if (_GameStepManager.originalStepData) {
-      if (_GameStepManager.originalStepData.openedLabels.length === historyStep.openedLabels.length) {
+      if (_GameStepManager.originalStepData.openedLabels.length === currentStepData.openedLabels.length) {
         try {
           let lastStepDataOpenedLabelsString = JSON.stringify(_GameStepManager.originalStepData.openedLabels);
-          let historyStepOpenedLabelsString = JSON.stringify(historyStep.openedLabels);
-          if (lastStepDataOpenedLabelsString === historyStepOpenedLabelsString && _GameStepManager.originalStepData.path === historyStep.path && _GameStepManager.originalStepData.labelIndex === historyStep.labelIndex) {
+          let historyStepOpenedLabelsString = JSON.stringify(currentStepData.openedLabels);
+          if (lastStepDataOpenedLabelsString === historyStepOpenedLabelsString && _GameStepManager.originalStepData.path === currentStepData.path && _GameStepManager.originalStepData.labelIndex === currentStepData.labelIndex) {
             return;
           }
         } catch (e) {
@@ -1983,7 +2016,7 @@ var _GameStepManager = class _GameStepManager {
         }
       }
     }
-    let data = deepDiff.diff(_GameStepManager.originalStepData, historyStep);
+    let data = deepDiff.diff(_GameStepManager.originalStepData, currentStepData);
     if (data) {
       let dialoge = void 0;
       let requiredChoices = void 0;
@@ -2002,7 +2035,7 @@ var _GameStepManager = class _GameStepManager {
         index: _GameStepManager.lastStepIndex,
         choiceIndexMade: choiseMade
       });
-      _GameStepManager.originalStepData = historyStep;
+      _GameStepManager.originalStepData = currentStepData;
     }
     _GameStepManager.increaseLastStepIndex();
   }
@@ -2093,6 +2126,9 @@ var _GameStepManager = class _GameStepManager {
         console.warn("[Pixi'VN] The player must make a choice");
         return;
       }
+      if (_GameStepManager.currentLabel && _GameStepManager.currentLabel.onStepEnd) {
+        yield _GameStepManager.currentLabel.onStepEnd(_GameStepManager.currentLabelStepIndex || 0, _GameStepManager.currentLabel);
+      }
       _GameStepManager.increaseCurrentStepIndex();
       return yield _GameStepManager.runCurrentStep(props, choiseMade);
     });
@@ -2117,6 +2153,10 @@ var _GameStepManager = class _GameStepManager {
           return;
         }
         if (currentLabel.steps.length > currentLabelStepIndex) {
+          let onStepRun = currentLabel.onStepStart;
+          if (onStepRun) {
+            yield onStepRun(currentLabelStepIndex, currentLabel);
+          }
           let step = currentLabel.steps[currentLabelStepIndex];
           let result = yield step(props);
           _GameStepManager.addStepHistory(step, choiseMade);
@@ -2181,6 +2221,9 @@ var _GameStepManager = class _GameStepManager {
         if (!tempLabel) {
           throw new Error(`[Pixi'VN] Label ${labelId} not found`);
         }
+        if (_GameStepManager.currentLabel && _GameStepManager.currentLabel.onStepEnd) {
+          yield _GameStepManager.currentLabel.onStepEnd(_GameStepManager.currentLabelStepIndex || 0, _GameStepManager.currentLabel);
+        }
         _GameStepManager.pushNewLabel(tempLabel.id);
       } catch (e) {
         console.error("[Pixi'VN] Error calling label", e);
@@ -2239,6 +2282,9 @@ var _GameStepManager = class _GameStepManager {
         if (!tempLabel) {
           throw new Error(`[Pixi'VN] Label ${labelId} not found`);
         }
+        if (_GameStepManager.currentLabel && _GameStepManager.currentLabel.onStepEnd) {
+          yield _GameStepManager.currentLabel.onStepEnd(_GameStepManager.currentLabelStepIndex || 0, _GameStepManager.currentLabel);
+        }
         _GameStepManager.pushNewLabel(tempLabel.id);
       } catch (e) {
         console.error("[Pixi'VN] Error jumping label", e);
@@ -2344,24 +2390,29 @@ var _GameStepManager = class _GameStepManager {
    * ```
    */
   static goBack(navigate, steps = 1) {
-    if (steps <= 0) {
-      console.warn("[Pixi'VN] Steps must be greater than 0");
-      return;
-    }
-    if (_GameStepManager._stepsHistory.length <= 1) {
-      console.warn("[Pixi'VN] No steps to go back");
-      return;
-    }
-    let restoredStep = _GameStepManager.goBackInternal(steps, _GameStepManager.originalStepData);
-    if (restoredStep) {
-      _GameStepManager._originalStepData = restoredStep;
-      _GameStepManager._openedLabels = createExportableElement(restoredStep.openedLabels);
-      GameStorageManager.import(createExportableElement(restoredStep.storage));
-      GameWindowManager.import(createExportableElement(restoredStep.canvas));
-      navigate(restoredStep.path);
-    } else {
-      console.error("[Pixi'VN] Error going back");
-    }
+    return __async(this, null, function* () {
+      if (steps <= 0) {
+        console.warn("[Pixi'VN] Steps must be greater than 0");
+        return;
+      }
+      if (_GameStepManager._stepsHistory.length <= 1) {
+        console.warn("[Pixi'VN] No steps to go back");
+        return;
+      }
+      let restoredStep = _GameStepManager.goBackInternal(steps, _GameStepManager.originalStepData);
+      if (restoredStep) {
+        _GameStepManager._originalStepData = restoredStep;
+        _GameStepManager._openedLabels = createExportableElement(restoredStep.openedLabels);
+        if (_GameStepManager.currentLabel && _GameStepManager.currentLabel.onLoadStep) {
+          yield _GameStepManager.currentLabel.onLoadStep(_GameStepManager.currentLabelStepIndex || 0, _GameStepManager.currentLabel);
+        }
+        GameStorageManager.import(createExportableElement(restoredStep.storage));
+        GameWindowManager.import(createExportableElement(restoredStep.canvas));
+        navigate(restoredStep.path);
+      } else {
+        console.error("[Pixi'VN] Error going back");
+      }
+    });
   }
   static goBackInternal(steps, restoredStep) {
     if (steps <= 0) {
@@ -2423,38 +2474,45 @@ var _GameStepManager = class _GameStepManager {
    * @param dataString The history in a JSON string.
    */
   static importJson(dataString) {
-    _GameStepManager.import(JSON.parse(dataString));
+    return __async(this, null, function* () {
+      yield _GameStepManager.import(JSON.parse(dataString));
+    });
   }
   /**
    * Import the history from an object.
    * @param data The history in an object.
    */
   static import(data) {
-    _GameStepManager.clear();
-    try {
-      if (data.hasOwnProperty("stepsHistory")) {
-        _GameStepManager._stepsHistory = data["stepsHistory"];
-      } else {
-        console.warn("[Pixi'VN] Could not import stepsHistory data, so will be ignored");
-      }
-      if (data.hasOwnProperty("openedLabels")) {
-        _GameStepManager._openedLabels = data["openedLabels"];
-      } else {
-        console.warn("[Pixi'VN] Could not import openedLabels data, so will be ignored");
-      }
-      if (data.hasOwnProperty("lastStepIndex")) {
-        _GameStepManager._lastStepIndex = data["lastStepIndex"];
-      } else {
-        console.warn("[Pixi'VN] Could not import lastStepIndex data, so will be ignored");
-      }
-      if (data.hasOwnProperty("originalStepData")) {
-        _GameStepManager._originalStepData = data["originalStepData"];
-      } else {
-        console.warn("[Pixi'VN] Could not import originalStepData data, so will be ignored");
+    return __async(this, null, function* () {
+      _GameStepManager.clear();
+      try {
+        if (data.hasOwnProperty("stepsHistory")) {
+          _GameStepManager._stepsHistory = data["stepsHistory"];
+        } else {
+          console.warn("[Pixi'VN] Could not import stepsHistory data, so will be ignored");
+        }
+        if (data.hasOwnProperty("openedLabels")) {
+          _GameStepManager._openedLabels = data["openedLabels"];
+        } else {
+          console.warn("[Pixi'VN] Could not import openedLabels data, so will be ignored");
+        }
+        if (data.hasOwnProperty("lastStepIndex")) {
+          _GameStepManager._lastStepIndex = data["lastStepIndex"];
+        } else {
+          console.warn("[Pixi'VN] Could not import lastStepIndex data, so will be ignored");
+        }
+        if (data.hasOwnProperty("originalStepData")) {
+          _GameStepManager._originalStepData = data["originalStepData"];
+        } else {
+          console.warn("[Pixi'VN] Could not import originalStepData data, so will be ignored");
+        }
+        if (_GameStepManager.currentLabel && _GameStepManager.currentLabel.onLoadStep) {
+          yield _GameStepManager.currentLabel.onLoadStep(_GameStepManager.currentLabelStepIndex || 0, _GameStepManager.currentLabel);
+        }
+      } catch (e) {
+        console.error("[Pixi'VN] Error importing data", e);
       }
-    } catch (e) {
-      console.error("[Pixi'VN] Error importing data", e);
-    }
+    });
   }
 };
 /**
@@ -2481,13 +2539,17 @@ function getSaveJson() {
   return JSON.stringify(saveData);
 }
 function loadSaveData(data, navigate) {
-  GameStepManager.import(data.stepData);
-  GameStorageManager.import(data.storageData);
-  GameWindowManager.import(data.canvasData);
-  navigate(data.path);
+  return __async(this, null, function* () {
+    yield GameStepManager.import(data.stepData);
+    GameStorageManager.import(data.storageData);
+    GameWindowManager.import(data.canvasData);
+    navigate(data.path);
+  });
 }
 function loadSaveJson(dataString, navigate) {
-  loadSaveData(jsonToSaveData(dataString), navigate);
+  return __async(this, null, function* () {
+    yield loadSaveData(jsonToSaveData(dataString), navigate);
+  });
 }
 function jsonToSaveData(json) {
   return JSON.parse(json);