@drincs/nqtr 0.2.0 → 0.2.1

package/dist/index.mjs

@@ -1082,7 +1082,7 @@ function addCommitment(commitment) {
     }
     return commitment2.id;
   }).filter((id) => id !== void 0);
-  GameStorageManager.setVariable(TEMPORARY_COMMITMENT_CATEGORY_MEMORY_KEY, [commitmentsIds]);
+  GameStorageManager.setVariable(TEMPORARY_COMMITMENT_CATEGORY_MEMORY_KEY, commitmentsIds);
 }
 function removeCommitment(commitment) {
   if (!Array.isArray(commitment)) {
@@ -1123,9 +1123,15 @@ var Goal = class extends StoredClassModel {
   get description() {
     return this._description;
   }
+  /**
+   * The number of times the goal must be completed.
+   */
   get need() {
     return this._need;
   }
+  /**
+   * The default number of times the goal has been completed.
+   */
   get defaultHave() {
     return this._defaultHave;
   }
@@ -1135,12 +1141,18 @@ var GoalStage = class extends Goal {
     super(id, props);
     this._stageId = stageId;
   }
+  /**
+   * The id of the stage that the goal belongs to.
+   */
   get stageId() {
     return this._stageId;
   }
   set stageId(value) {
     this._stageId = value;
   }
+  /**
+   * The number of times the goal has been completed.
+   */
   get have() {
     return this.getStorageProperty("have-" + this._stageId) || this.defaultHave;
   }
@@ -1151,6 +1163,9 @@ var GoalStage = class extends Goal {
     }
     this.setStorageProperty("have-" + this._stageId, value);
   }
+  /**
+   * If the goal is completed.
+   */
   get completed() {
     return this.have >= this.need;
   }
@@ -1161,6 +1176,9 @@ var GoalStage = class extends Goal {
       console.warn(`[NQTR] The goal can't be set as not completed. You must edit the have value manually.`);
     }
   }
+  /**
+   * Find the goal. It will increment the have value.
+   */
   find() {
     this.have++;
   }
@@ -1184,12 +1202,21 @@ var Stage = class extends StoredClassModel {
     this._onStart = props.onStart;
     this._onEnd = props.onEnd;
   }
+  /**
+   * The name of the stage.
+   */
   get name() {
     return this._name;
   }
+  /**
+   * The description of the stage.
+   */
   get description() {
     return this._description;
   }
+  /**
+   * The advice description of the stage.
+   */
   get adviceDescription() {
     return this._adviceDescription;
   }
@@ -1208,6 +1235,10 @@ var Stage = class extends StoredClassModel {
     }
     return (props) => render;
   }
+  /**
+   * The list of goals that the player needs to complete to finish the stage.
+   * This is the list set by the developer. if you want to get the current goals, use the goals property.
+   */
   get defaultGoals() {
     return this._defaultGoals;
   }
@@ -1217,21 +1248,39 @@ var Stage = class extends StoredClassModel {
   get flags() {
     return this._flags;
   }
+  /**
+   * The number of days required to start the stage.
+   */
   get daysRequiredToStart() {
     return this._daysRequiredToStart || 0;
   }
+  /**
+   * The list of flags required to start the stage.
+   */
   get flagsRequiredToStart() {
     return this._flagsRequiredToStart;
   }
+  /**
+   * The list of quests required to start the stage.
+   */
   get questsRequiredToStart() {
     return this._questsRequiredToStart || [];
   }
+  /**
+   * The description of the request to start the stage.
+   */
   get requestDescriptionToStart() {
     return this._requestDescriptionToStart;
   }
+  /**
+   * The function that will be called when the stage starts.
+   */
   get onStart() {
     return this._onStart;
   }
+  /**
+   * The function that will be called when the stage ends.
+   */
   get onEnd() {
     return this._onEnd;
   }
@@ -1240,6 +1289,10 @@ var StageQuest = class extends Stage {
   constructor(id, props) {
     super(id, props);
   }
+  /**
+   * Check if the flag and goals are completed.
+   * You can force the completion of the stage by setting the completed property to true.
+   */
   get completed() {
     let storedCompleted = this.getStorageProperty("completed");
     if (storedCompleted) {
@@ -1270,6 +1323,9 @@ var StageQuest = class extends Stage {
   set prevStageEndDay(value) {
     this.setStorageProperty("prevStageEndDay", value);
   }
+  /**
+   * The day when the stage starts.
+   */
   get startDay() {
     let prevStageEndDay = this.prevStageEndDay;
     if (prevStageEndDay === void 0) {
@@ -1277,6 +1333,9 @@ var StageQuest = class extends Stage {
     }
     return prevStageEndDay + this.daysRequiredToStart;
   }
+  /**
+   * Check if the stage can start.
+   */
   get canStart() {
     let daysRequired = this.daysRequiredToStart;
     if (daysRequired > 0) {
@@ -1298,6 +1357,9 @@ var StageQuest = class extends Stage {
     }
     return true;
   }
+  /**
+   * The function that will be called when the stage starts.
+   */
   get onStart() {
     if (this.daysRequiredToStart > 0) {
       this.prevStageEndDay = TimeManager.currentDay;
@@ -1318,14 +1380,23 @@ var Quest = class extends StoredClassModel {
     this._renderImage = props.renderImage;
     this._isInDevelopment = props.isInDevelopment || false;
   }
+  /**
+   * The stages of the quest.
+   */
   get stages() {
     return this._stages.map((stage, index) => {
       return new StageQuest(stage.id, stage);
     });
   }
+  /**
+   * The name of the quest.
+   */
   get name() {
     return this._name;
   }
+  /**
+   * The description of the quest.
+   */
   get description() {
     return this._description;
   }
@@ -1359,15 +1430,24 @@ var Quest = class extends StoredClassModel {
     }
     return (props) => render;
   }
+  /**
+   * If the quest is in development.
+   */
   get isInDevelopment() {
     return this._isInDevelopment;
   }
+  /**
+   * The index of the current stage.
+   */
   get currentStageIndex() {
     return this.getStorageProperty("currentStageIndex");
   }
   set currentStageIndex(value) {
     this.setStorageProperty("currentStageIndex", value);
   }
+  /**
+   * The current stage.
+   */
   get currentStage() {
     let index = this.currentStageIndex;
     if (index === void 0 || index >= this.stages.length) {
@@ -1375,12 +1455,23 @@ var Quest = class extends StoredClassModel {
     }
     return this.stages[index];
   }
+  /**
+   * If the quest is started.
+   */
   get started() {
     return this.currentStageIndex !== void 0;
   }
+  /**
+   * If the quest is completed.
+   */
   get completed() {
     return this.currentStageIndex === this.stages.length;
   }
+  /**
+   * Start the quest.
+   * @param props The properties for the start stage. If you not want to pass any property, you can pass an {}.
+   * @returns 
+   */
   start(props) {
     if (this.started) {
       console.warn(`[NQTR] Quest ${this.id} is already started`);
@@ -1398,18 +1489,24 @@ var Quest = class extends StoredClassModel {
       console.error(`[NQTR] Quest ${this.id} has no start stage`);
     }
   }
+  /**
+   * Try to go to the next stage.
+   * @param startProps The properties for the start stage. If you not want to pass any property, you can pass an {}.
+   * @param endProps The properties for the end stage. If you not want to pass any property, you can pass an {}.
+   * @returns true if the stage was changed, false otherwise.
+   */
   tryToGoNextStage(startProps, endProps) {
     if (!this.started) {
-      return;
+      return false;
     }
     if (this.completed) {
-      return;
+      return false;
     }
     let currentStage = this.currentStage;
     let currentStageIndex = this.currentStageIndex;
     if (!currentStage || currentStageIndex === void 0) {
       console.error(`[NQTR] Quest ${this.id} has no current stage`);
-      return;
+      return false;
     }
     if (currentStage.completed) {
       let nextStageIndex = currentStageIndex + 1;
@@ -1419,9 +1516,11 @@ var Quest = class extends StoredClassModel {
         currentStage.onEnd(endProps);
       }
       if (nextStage && nextStage.onStart) {
-        return nextStage.onStart(startProps);
+        nextStage.onStart(startProps);
       }
+      return true;
     }
+    return false;
   }
 };