@drincs/nqtr 0.1.18 → 0.1.20

package/dist/index.mjs

@@ -389,15 +389,6 @@ var ActivityModel = class {
     };
   }
 };
-
-// src/enums/ExecutionTypeEnum.ts
-var ExecutionTypeEnum = /* @__PURE__ */ ((ExecutionTypeEnum2) => {
-  ExecutionTypeEnum2["AUTOMATIC"] = "automatic";
-  ExecutionTypeEnum2["INTERACTION"] = "interaction";
-  return ExecutionTypeEnum2;
-})(ExecutionTypeEnum || {});
-
-// src/classes/Commitment.ts
 var COMMITMENT_CATEGORY = "__nqtr-commitment__";
 var CommitmentBaseModel = class extends StoredClassModel {
   /**
@@ -416,11 +407,12 @@ var CommitmentBaseModel = class extends StoredClassModel {
     this.defaultFromDay = props.fromDay;
     this.defaultToDay = props.toDay;
     this._renderImage = props.renderImage;
-    this._executionType = props.executionType || "interaction" /* INTERACTION */;
+    this._executionType = props.executionType || "interaction";
     this._onRun = props.onRun;
     this.defaultDisabled = props.disabled || false;
     this.defaultHidden = props.hidden || false;
     this._renderIcon = props.renderIcon;
+    this.defaultPriority = props.priority || 0;
   }
   /**
    * The character or characters that are in the commitment and so in the room.
@@ -562,6 +554,16 @@ var CommitmentBaseModel = class extends StoredClassModel {
   set hidden(value) {
     this.setStorageProperty("hidden", value);
   }
+  /**
+   * The priority. The higher the number, the higher the priority.
+   * To ensure that a character is not in 2 places at the same time, if there are 2 or more valid commits at the same time and with the same character, the one with the highest priority will be chosen.
+   */
+  get priority() {
+    return this.getStorageProperty("priority") || this.defaultPriority || 0;
+  }
+  set priority(value) {
+    this.setStorageProperty("priority", value);
+  }
   /**
    * Whether the commitment is expired.
    * @returns Whether the commitment is expired.
@@ -573,6 +575,199 @@ var CommitmentBaseModel = class extends StoredClassModel {
     return false;
   }
 };
+var ActivityStoredAbstract = class {
+  /**
+   * @param onRun The function that is called when the activity is runned. Have 2 parameters: the runned activity and the yourParams object, that is an object with the parameters that you want to pass to the onRun function.
+   * @param props The activity properties.
+   */
+  constructor(onRun, props) {
+    this.defaultName = props.name;
+    this.defaultFromHour = props.fromHour;
+    this.defaultToHour = props.toHour;
+    this.defaultFromDay = props.fromDay;
+    this.defaultToDay = props.toDay;
+    this.defaultDisabled = props.disabled || false;
+    this.defaultHidden = props.hidden || false;
+    this._renderIcon = props.renderIcon;
+    this._onRun = onRun;
+  }
+  /**
+   * The name
+   */
+  get name() {
+    return this.getStorageProperty("name") || this.defaultName || "";
+  }
+  set name(value) {
+    this.setStorageProperty("name", value);
+  }
+  /**
+   * The hour when the activity starts. If the activity is not started yet, it will be hidden.
+   */
+  get fromHour() {
+    return this.getStorageProperty("fromHour") || this.defaultFromHour || TimeManager.minDayHours;
+  }
+  set fromHour(value) {
+    this.setStorageProperty("fromHour", value);
+  }
+  /**
+   * The hour when the activity ends. If the activity is ended yet, it will be hidden.
+   */
+  get toHour() {
+    return this.getStorageProperty("toHour") || this.defaultToHour || TimeManager.maxDayHours + 1;
+  }
+  set toHour(value) {
+    this.setStorageProperty("toHour", value);
+  }
+  /**
+   * The day when the activity starts. If the activity is not started yet, it will be hidden.
+   */
+  get fromDay() {
+    return this.getStorageProperty("fromDay") || this.defaultFromDay;
+  }
+  set fromDay(value) {
+    this.setStorageProperty("fromDay", value);
+  }
+  /**
+   * The day when the activity ends. If the activity is ended yet, it will be deleted or hidden.
+   */
+  get toDay() {
+    return this.getStorageProperty("toDay") || this.defaultToDay;
+  }
+  set toDay(value) {
+    this.setStorageProperty("toDay", value);
+  }
+  /**
+   * Whether is disabled.
+   */
+  get disabled() {
+    let value = this.getStorageProperty("disabled") || this.defaultDisabled;
+    if (typeof value === "string") {
+      return getFlag(value);
+    }
+    return value;
+  }
+  set disabled(value) {
+    this.setStorageProperty("disabled", value);
+  }
+  /**
+   * Whether is hidden. If the activity is not started yet, it will be hidden.
+   */
+  get hidden() {
+    if (this.fromDay && this.fromDay > TimeManager.currentDay) {
+      return true;
+    }
+    if (!TimeManager.nowIsBetween(this.fromHour, this.toHour)) {
+      return true;
+    }
+    if (!this.isExpired) {
+      return true;
+    }
+    let value = this.getStorageProperty("hidden") || this.defaultHidden;
+    if (typeof value === "string") {
+      return getFlag(value);
+    }
+    return value;
+  }
+  set hidden(value) {
+    this.setStorageProperty("hidden", value);
+  }
+  /**
+   * The function for rendering the icon of the activity.
+   */
+  get renderIcon() {
+    let render = this._renderIcon;
+    if (render === void 0) {
+      return void 0;
+    }
+    if (typeof render === "function") {
+      return (props) => {
+        return render(this, props);
+      };
+    }
+    return (props) => render;
+  }
+  /**
+   * The function that is called when the activity is runned.
+   */
+  get onRun() {
+    return (props) => {
+      return this._onRun(this, props);
+    };
+  }
+  /**
+   * Whether the activity is a deadline.
+   * @returns Whether the activity is a deadline.
+   */
+  isExpired() {
+    if (this.toDay && this.toDay <= TimeManager.currentDay) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Export the activity properties.
+   * @returns The activity properties.
+   */
+  export() {
+    return {
+      name: this.getStorageProperty("name") || this.defaultName,
+      fromHour: this.getStorageProperty("fromHour") || this.defaultFromHour,
+      toHour: this.getStorageProperty("toHour") || this.defaultToHour,
+      fromDay: this.getStorageProperty("fromDay") || this.defaultFromDay,
+      toDay: this.getStorageProperty("toDay") || this.defaultToDay,
+      disabled: this.getStorageProperty("disabled") || this.defaultDisabled,
+      hidden: this.getStorageProperty("hidden") || this.defaultHidden,
+      renderIcon: this._renderIcon
+    };
+  }
+};
+
+// src/classes/navigation/ActivityRoom.ts
+var ActivityRoom = class extends ActivityStoredAbstract {
+  constructor(id, room, onRun, props) {
+    super(onRun, props);
+    this._id = id;
+    this._room = room;
+  }
+  setStorageProperty(_, __) {
+    this._room.setActivity(this);
+  }
+  getStorageProperty(propertyName) {
+    let activity = this._room.getActivityMemory(this.id);
+    if (!activity || !activity.hasOwnProperty(propertyName)) {
+      return void 0;
+    }
+    return activity[propertyName];
+  }
+  get id() {
+    return this._id;
+  }
+  get room() {
+    return this._room;
+  }
+  export() {
+    let result = {};
+    if (this.name !== void 0) {
+      result["name"] = this.name;
+    }
+    if (this.fromHour !== void 0) {
+      result["fromHour"] = this.fromHour;
+    }
+    if (this.toHour !== void 0) {
+      result["toHour"] = this.toHour;
+    }
+    if (this.fromDay !== void 0) {
+      result["fromDay"] = this.fromDay;
+    }
+    if (this.toDay !== void 0) {
+      result["toDay"] = this.toDay;
+    }
+    if (this.disabled !== void 0) {
+      result["disabled"] = this.disabled;
+    }
+    return result;
+  }
+};
 
 // src/decorators/RoomDecorator.ts
 var registeredRooms = {};
@@ -865,9 +1060,9 @@ function getCommitmentById(id) {
     return;
   }
 }
-function setFixedCommitments(commitments) {
+function setFixedRoutine(commitments) {
   if (Array.isArray(commitments)) {
-    commitments.forEach((c) => setFixedCommitments(c));
+    commitments.forEach((c) => setFixedRoutine(c));
     return;
   }
   if (fixedCommitments[commitments.id]) {
@@ -875,7 +1070,7 @@ function setFixedCommitments(commitments) {
   }
   fixedCommitments[commitments.id] = commitments;
 }
-function addTemporaryCommitment(commitment) {
+function addCommitment(commitment) {
   if (!Array.isArray(commitment)) {
     commitment = [commitment];
   }
@@ -889,7 +1084,7 @@ function addTemporaryCommitment(commitment) {
   }).filter((id) => id !== void 0);
   GameStorageManager.setVariable(TEMPORARY_COMMITMENT_CATEGORY_MEMORY_KEY, [commitmentsIds]);
 }
-function getFixedCommitments() {
+function getFixedRoutine() {
   return Object.values(fixedCommitments);
 }
 function getTemporaryCommitments() {
@@ -901,6 +1096,32 @@ function getTemporaryCommitments() {
   return commitments;
 }
 
+// src/decorators/QuestDecorator.ts
+var registeredQuests = {};
+function saveQuest(quest) {
+  if (Array.isArray(quest)) {
+    quest.forEach((c) => saveQuest(c));
+    return;
+  }
+  if (registeredQuests[quest.id]) {
+    console.warn(`[NQTR] Quest id ${quest.id} already exists, it will be overwritten`);
+  }
+  registeredQuests[quest.id] = quest;
+}
+function getQuestById(id) {
+  try {
+    let quest = registeredQuests[id];
+    if (!quest) {
+      console.error(`[NQTR] Quest ${id} not found`);
+      return;
+    }
+    return quest;
+  } catch (e) {
+    console.error(`[NQTR] Error while getting Quest ${id}`, e);
+    return;
+  }
+}
+
 // src/functions/RoutineFunctions.ts
 function clearExpiredRoutine() {
   Object.entries(registeredCommitments).forEach(([_, commitment]) => {
@@ -909,271 +1130,78 @@ function clearExpiredRoutine() {
     }
   });
 }
-function getCurrentCommitments() {
+function getCurrentRoutine() {
   let character_commitments = {};
-  let oltherCommitments = [];
   getTemporaryCommitments().reverse().forEach((c) => {
     if (!c.hidden) {
-      if (c.characters.length > 1) {
-        let allAvailable = c.characters.every((ch) => !character_commitments[ch.id]);
+      if (c.characters.length > 0) {
+        let allAvailable = c.characters.every((ch) => !character_commitments[ch.id] || c.priority > character_commitments[ch.id].priority);
         if (allAvailable) {
           c.characters.forEach((ch) => {
             character_commitments[ch.id] = c;
           });
         }
       } else {
-        oltherCommitments.push(c);
+        console.error(`[NQTR] The commitment ${c.id} has no characters assigned`);
       }
     }
   });
-  getFixedCommitments().reverse().forEach((c) => {
+  getFixedRoutine().reverse().forEach((c) => {
     if (!c.hidden) {
-      if (c.characters.length > 1) {
-        c.characters.forEach((ch) => {
-          if (!character_commitments[ch.id]) {
+      if (c.characters.length > 0) {
+        let allAvailable = c.characters.every((ch) => !character_commitments[ch.id] || c.priority > character_commitments[ch.id].priority);
+        if (allAvailable) {
+          c.characters.forEach((ch) => {
             character_commitments[ch.id] = c;
-          }
-        });
+          });
+        }
       } else {
-        oltherCommitments.push(c);
+        console.error(`[NQTR] The commitment ${c.id} has no characters assigned`);
       }
     }
   });
-  return Object.values(character_commitments).concat(oltherCommitments);
+  return Object.values(character_commitments);
 }
 function getCommitmentByCharacter(character) {
-  getCurrentCommitments().forEach((c) => {
+  getCurrentRoutine().forEach((c) => {
     if (c.characters.map((ch) => ch.id).includes(character.id)) {
       return c;
     }
   });
   return void 0;
 }
-var ActivityStoredAbstract = class {
+
+// src/classes/navigation/Room.ts
+var ROOM_CATEGORY = "__nqtr-room__";
+var RoomBaseModel = class extends StoredClassModel {
   /**
-   * @param onRun The function that is called when the activity is runned. Have 2 parameters: the runned activity and the yourParams object, that is an object with the parameters that you want to pass to the onRun function.
-   * @param props The activity properties.
+   * @param id The id of the room, it must be unique.
+   * @param location The location where the room is.
+   * @param props The properties of the room.
    */
-  constructor(onRun, props) {
-    this.defaultName = props.name;
-    this.defaultFromHour = props.fromHour;
-    this.defaultToHour = props.toHour;
-    this.defaultFromDay = props.fromDay;
-    this.defaultToDay = props.toDay;
+  constructor(id, location, props = {}) {
+    var _a;
+    super(ROOM_CATEGORY, id);
+    this._location = location;
+    this.defaultName = props.name || "";
+    this._renderImage = props.renderImage;
+    this.defaultActivityIds = ((_a = props.defaultActivities) == null ? void 0 : _a.map((activity) => activity.id)) || [];
     this.defaultDisabled = props.disabled || false;
     this.defaultHidden = props.hidden || false;
     this._renderIcon = props.renderIcon;
-    this._onRun = onRun;
+    this._isEntrance = props.isEntrance;
   }
   /**
-   * The name
+   * The location where the room is.
    */
-  get name() {
-    return this.getStorageProperty("name") || this.defaultName || "";
-  }
-  set name(value) {
-    this.setStorageProperty("name", value);
+  get location() {
+    return this._location;
   }
   /**
-   * The hour when the activity starts. If the activity is not started yet, it will be hidden.
+   * Whether is an entrance room, so when the player enters in the location, it will be the first room to be shown.
    */
-  get fromHour() {
-    return this.getStorageProperty("fromHour") || this.defaultFromHour || TimeManager.minDayHours;
-  }
-  set fromHour(value) {
-    this.setStorageProperty("fromHour", value);
-  }
-  /**
-   * The hour when the activity ends. If the activity is ended yet, it will be hidden.
-   */
-  get toHour() {
-    return this.getStorageProperty("toHour") || this.defaultToHour || TimeManager.maxDayHours + 1;
-  }
-  set toHour(value) {
-    this.setStorageProperty("toHour", value);
-  }
-  /**
-   * The day when the activity starts. If the activity is not started yet, it will be hidden.
-   */
-  get fromDay() {
-    return this.getStorageProperty("fromDay") || this.defaultFromDay;
-  }
-  set fromDay(value) {
-    this.setStorageProperty("fromDay", value);
-  }
-  /**
-   * The day when the activity ends. If the activity is ended yet, it will be deleted or hidden.
-   */
-  get toDay() {
-    return this.getStorageProperty("toDay") || this.defaultToDay;
-  }
-  set toDay(value) {
-    this.setStorageProperty("toDay", value);
-  }
-  /**
-   * Whether is disabled.
-   */
-  get disabled() {
-    let value = this.getStorageProperty("disabled") || this.defaultDisabled;
-    if (typeof value === "string") {
-      return getFlag(value);
-    }
-    return value;
-  }
-  set disabled(value) {
-    this.setStorageProperty("disabled", value);
-  }
-  /**
-   * Whether is hidden. If the activity is not started yet, it will be hidden.
-   */
-  get hidden() {
-    if (this.fromDay && this.fromDay > TimeManager.currentDay) {
-      return true;
-    }
-    if (!TimeManager.nowIsBetween(this.fromHour, this.toHour)) {
-      return true;
-    }
-    if (!this.isExpired) {
-      return true;
-    }
-    let value = this.getStorageProperty("hidden") || this.defaultHidden;
-    if (typeof value === "string") {
-      return getFlag(value);
-    }
-    return value;
-  }
-  set hidden(value) {
-    this.setStorageProperty("hidden", value);
-  }
-  /**
-   * The function for rendering the icon of the activity.
-   */
-  get renderIcon() {
-    let render = this._renderIcon;
-    if (render === void 0) {
-      return void 0;
-    }
-    if (typeof render === "function") {
-      return (props) => {
-        return render(this, props);
-      };
-    }
-    return (props) => render;
-  }
-  /**
-   * The function that is called when the activity is runned.
-   */
-  get onRun() {
-    return (props) => {
-      return this._onRun(this, props);
-    };
-  }
-  /**
-   * Whether the activity is a deadline.
-   * @returns Whether the activity is a deadline.
-   */
-  isExpired() {
-    if (this.toDay && this.toDay <= TimeManager.currentDay) {
-      return true;
-    }
-    return false;
-  }
-  /**
-   * Export the activity properties.
-   * @returns The activity properties.
-   */
-  export() {
-    return {
-      name: this.getStorageProperty("name") || this.defaultName,
-      fromHour: this.getStorageProperty("fromHour") || this.defaultFromHour,
-      toHour: this.getStorageProperty("toHour") || this.defaultToHour,
-      fromDay: this.getStorageProperty("fromDay") || this.defaultFromDay,
-      toDay: this.getStorageProperty("toDay") || this.defaultToDay,
-      disabled: this.getStorageProperty("disabled") || this.defaultDisabled,
-      hidden: this.getStorageProperty("hidden") || this.defaultHidden,
-      renderIcon: this._renderIcon
-    };
-  }
-};
-
-// src/classes/navigation/ActivityRoom.ts
-var ActivityRoom = class extends ActivityStoredAbstract {
-  constructor(id, room, onRun, props) {
-    super(onRun, props);
-    this._id = id;
-    this._room = room;
-  }
-  setStorageProperty(_, __) {
-    this._room.setActivity(this);
-  }
-  getStorageProperty(propertyName) {
-    let activity = this._room.getActivityMemory(this.id);
-    if (!activity || !activity.hasOwnProperty(propertyName)) {
-      return void 0;
-    }
-    return activity[propertyName];
-  }
-  get id() {
-    return this._id;
-  }
-  get room() {
-    return this._room;
-  }
-  export() {
-    let result = {};
-    if (this.name !== void 0) {
-      result["name"] = this.name;
-    }
-    if (this.fromHour !== void 0) {
-      result["fromHour"] = this.fromHour;
-    }
-    if (this.toHour !== void 0) {
-      result["toHour"] = this.toHour;
-    }
-    if (this.fromDay !== void 0) {
-      result["fromDay"] = this.fromDay;
-    }
-    if (this.toDay !== void 0) {
-      result["toDay"] = this.toDay;
-    }
-    if (this.disabled !== void 0) {
-      result["disabled"] = this.disabled;
-    }
-    return result;
-  }
-};
-
-// src/classes/navigation/Room.ts
-var ROOM_CATEGORY = "__nqtr-room__";
-var RoomBaseModel = class extends StoredClassModel {
-  /**
-   * @param id The id of the room, it must be unique.
-   * @param location The location where the room is.
-   * @param props The properties of the room.
-   */
-  constructor(id, location, props = {}) {
-    var _a;
-    super(ROOM_CATEGORY, id);
-    this._location = location;
-    this.defaultName = props.name || "";
-    this._renderImage = props.renderImage;
-    this.defaultActivityIds = ((_a = props.defaultActivities) == null ? void 0 : _a.map((activity) => activity.id)) || [];
-    this.defaultDisabled = props.disabled || false;
-    this.defaultHidden = props.hidden || false;
-    this._renderIcon = props.renderIcon;
-    this._isEntrance = props.isEntrance;
-  }
-  /**
-   * The location where the room is.
-   */
-  get location() {
-    return this._location;
-  }
-  /**
-   * Whether is an entrance room, so when the player enters in the location, it will be the first room to be shown.
-   */
-  get isEntrance() {
-    return this._isEntrance || false;
+  get isEntrance() {
+    return this._isEntrance || false;
   }
   /**
    * The name.
@@ -1375,51 +1403,82 @@ var RoomBaseModel = class extends StoredClassModel {
    * @returns The character commitments of the room.
    */
   getRoutine() {
-    let commitments = getCurrentCommitments();
+    let commitments = getCurrentRoutine();
     return commitments.filter((c) => c.room.id === this.id);
   }
 };
-
-// src/classes/quest/Goal.ts
-var Goal = class {
-  constructor(props) {
+var GOAL_CATEGORY = "__nqtr-goal__";
+var Goal = class extends StoredClassModel {
+  constructor(id, props) {
+    super(GOAL_CATEGORY, id);
     this._description = props.description;
-    this.need = props.need || 1;
-    this.have = props.have || 0;
+    this._need = props.need || 1;
+    this._defaultHave = props.have || 0;
   }
+  /**
+   * The description of the goal.
+   */
   get description() {
     return this._description;
   }
-  get isComplete() {
+  get need() {
+    return this._need;
+  }
+  get defaultHave() {
+    return this._defaultHave;
+  }
+};
+var GoalStage = class extends Goal {
+  constructor(id, stageId, props) {
+    super(id, props);
+    this._stageId = stageId;
+  }
+  get stageId() {
+    return this._stageId;
+  }
+  set stageId(value) {
+    this._stageId = value;
+  }
+  get have() {
+    return this.getStorageProperty("have-" + this._stageId) || this.defaultHave;
+  }
+  set have(value) {
+    if (!this._stageId) {
+      console.error(`[NQTR] The stage id is not set for the goal ${this.id}, so the have value can't be set.`);
+      return;
+    }
+    this.setStorageProperty("have-" + this._stageId, value);
+  }
+  get completed() {
     return this.have >= this.need;
   }
-  setComplete() {
-    this.have = this.need;
+  set completed(value) {
+    if (value) {
+      this.have = this.need;
+    } else {
+      console.warn(`[NQTR] The goal can't be set as not completed. You must edit the have value manually.`);
+    }
   }
   find() {
     this.have++;
   }
-  get export() {
-    return {
-      description: this.description,
-      need: this.need,
-      have: this.have
-    };
-  }
 };
-var QUEST_CATEGORY = "__nqtr-quest__";
-var QuestBaseModel = class extends StoredClassModel {
-  constructor(id, stages, props) {
-    super(QUEST_CATEGORY, id);
-    this._stages = stages;
+var STAGE_CATEGORY = "__nqtr-stage__";
+var Stage = class extends StoredClassModel {
+  constructor(id, props) {
+    super(STAGE_CATEGORY, id);
     this._name = props.name || "";
+    this._defaultGoals = props.goals || [];
+    this._flags = props.flags || [];
     this._description = props.description || "";
-    this._icon = props.icon || "";
-    this._image = props.image || "";
-    this._isInDevelopment = props.isInDevelopment || false;
-  }
-  get stages() {
-    return this._stages;
+    this._adviceDescription = props.adviceDescription || "";
+    this._renderImage = props.renderImage;
+    this._daysRequiredToStart = props.daysRequiredToStart;
+    this._flagsRequiredToStart = props.flagsRequired || [];
+    this._questsRequiredToStart = props.questsRequired || [];
+    this._requestDescriptionToStart = props.requestDescription || "";
+    this._onStart = props.onStart;
+    this._onEnd = props.onEnd;
   }
   get name() {
     return this._name;
@@ -1427,50 +1486,138 @@ var QuestBaseModel = class extends StoredClassModel {
   get description() {
     return this._description;
   }
-  get icon() {
-    return this._icon;
+  get adviceDescription() {
+    return this._adviceDescription;
   }
-  get image() {
-    return this._image;
+  /**
+   * The function for rendering the image of the stage.
+   */
+  get renderImage() {
+    let render = this._renderImage;
+    if (render === void 0) {
+      return void 0;
+    }
+    if (typeof render === "function") {
+      return (props) => {
+        return render(this, props);
+      };
+    }
+    return (props) => render;
   }
-  get isInDevelopment() {
-    return this._isInDevelopment;
+  get defaultGoals() {
+    return this._defaultGoals;
+  }
+  /**
+   * The list of flags that the player must complete to finish the stage.
+   */
+  get flags() {
+    return this._flags;
+  }
+  get daysRequiredToStart() {
+    return this._daysRequiredToStart || 0;
+  }
+  get flagsRequiredToStart() {
+    return this._flagsRequiredToStart;
+  }
+  get questsRequiredToStart() {
+    return this._questsRequiredToStart || [];
+  }
+  get requestDescriptionToStart() {
+    return this._requestDescriptionToStart;
+  }
+  get onStart() {
+    return this._onStart;
+  }
+  get onEnd() {
+    return this._onEnd;
   }
 };
-var STAGE_CATEGORY = "__nqtr-stage__";
-var StageBaseModel = class extends StoredClassModel {
+var StageQuest = class extends Stage {
   constructor(id, props) {
-    super(STAGE_CATEGORY, id);
-    this._completed = false;
-    this._active = false;
-    this.defaultGoals = [];
-    this._name = props.name || "";
-    this._description = props.description || "";
-    this._adviceDescription = props.adviceDescription || "";
-    this._image = props.image || "";
-    this._daysRequiredToStart = props.daysRequiredToStart;
-    this._flagsRequired = props.flagsRequired;
-    this._questsRequired = props.questsRequired;
-    this._requestDescription = props.requestDescription || "";
-    this._onStart = props.onStart;
-    this._onEnd = props.onEnd;
+    super(id, props);
   }
   get completed() {
-    return this._completed;
+    let storedCompleted = this.getStorageProperty("completed");
+    if (storedCompleted) {
+      return storedCompleted;
+    }
+    if (!this.flags.every((flag) => getFlag(flag.flag))) {
+      return false;
+    }
+    if (!this.goals.every((goal) => goal.completed)) {
+      return false;
+    }
+    return true;
   }
-  get active() {
-    return this._active;
+  set completed(value) {
+    this.setStorageProperty("completed", value);
   }
+  /**
+   * The list of goals that the player needs to complete to finish the stage.
+   */
   get goals() {
-    let list = this.getStorageProperty("goals");
-    if (!list) {
-      return this.defaultGoals;
+    return this.defaultGoals.map((goal) => {
+      return new GoalStage(goal.id, this.id, goal);
+    });
+  }
+  get prevStageEndDay() {
+    return this.getStorageProperty("prevStageEndDay");
+  }
+  set prevStageEndDay(value) {
+    this.setStorageProperty("prevStageEndDay", value);
+  }
+  get startDay() {
+    let prevStageEndDay = this.prevStageEndDay;
+    if (prevStageEndDay === void 0) {
+      return void 0;
     }
-    return list.map((goal) => new Goal(goal));
+    return prevStageEndDay + this.daysRequiredToStart;
   }
-  set goals(value) {
-    let list = value.map((goal) => goal.export);
-    this.setStorageProperty("goals", list);
+  get canStart() {
+    let daysRequired = this.daysRequiredToStart;
+    if (daysRequired > 0) {
+      let prevStageEndDay = this.prevStageEndDay;
+      if (prevStageEndDay === void 0) {
+        return false;
+      }
+      if (prevStageEndDay + daysRequired > TimeManager.currentDay) {
+        return false;
+      }
+    }
+    if (this.flagsRequiredToStart.length > 0 && !this.flagsRequiredToStart.every((flag) => getFlag(flag.flag))) {
+      return false;
+    }
+    if (this.questsRequiredToStart.length > 0 && !this.questsRequiredToStart.every(
+      (q) => q.quest.currentStageIndex && q.quest.currentStageIndex >= q.stageNumber
+    )) {
+      return false;
+    }
+    return true;
+  }
+  get onStart() {
+    if (this.daysRequiredToStart > 0) {
+      this.prevStageEndDay = TimeManager.currentDay;
+    }
+    return super.onStart;
+  }
+};
+
+// src/classes/quest/Quest.ts
+var QUEST_CATEGORY = "__nqtr-quest__";
+var Quest = class extends StoredClassModel {
+  constructor(id, stages, props) {
+    super(QUEST_CATEGORY, id);
+    this._stages = stages;
+    this._name = props.name || "";
+    this._description = props.description || "";
+    this._renderIcon = props.renderIcon;
+    this._renderImage = props.renderImage;
+    this._isInDevelopment = props.isInDevelopment || false;
+  }
+  get stages() {
+    return this._stages.map((stage, index) => {
+      return new StageQuest(stage.id, stage);
+    });
   }
   get name() {
     return this._name;
@@ -1478,29 +1625,99 @@ var StageBaseModel = class extends StoredClassModel {
   get description() {
     return this._description;
   }
-  get adviceDescription() {
-    return this._adviceDescription;
+  /**
+   * The function for rendering the icon of the quest.
+   */
+  get renderIcon() {
+    let render = this._renderIcon;
+    if (render === void 0) {
+      return void 0;
+    }
+    if (typeof render === "function") {
+      return (props) => {
+        return render(this, props);
+      };
+    }
+    return (props) => render;
+  }
+  /**
+   * The function for rendering the image of the quest.
+   */
+  get renderImage() {
+    let render = this._renderImage;
+    if (render === void 0) {
+      return void 0;
+    }
+    if (typeof render === "function") {
+      return (props) => {
+        return render(this, props);
+      };
+    }
+    return (props) => render;
   }
-  get image() {
-    return this._image;
+  get isInDevelopment() {
+    return this._isInDevelopment;
   }
-  get daysRequiredToStart() {
-    return this._daysRequiredToStart;
+  get currentStageIndex() {
+    return this.getStorageProperty("currentStageIndex");
+  }
+  set currentStageIndex(value) {
+    this.setStorageProperty("currentStageIndex", value);
   }
-  get flagsRequired() {
-    return this._flagsRequired;
+  get currentStage() {
+    let index = this.currentStageIndex;
+    if (index === void 0 || index >= this.stages.length) {
+      return void 0;
+    }
+    return this.stages[index];
   }
-  get questsRequired() {
-    return this._questsRequired;
+  get started() {
+    return this.currentStageIndex !== void 0;
   }
-  get requestDescription() {
-    return this._requestDescription;
+  get completed() {
+    return this.currentStageIndex === this.stages.length;
   }
-  get onStart() {
-    return this._onStart;
+  start() {
+    if (this.started) {
+      console.warn(`[NQTR] Quest ${this.id} is already started`);
+      return;
+    }
+    if (this.stages.length === 0) {
+      console.error(`[NQTR] Quest ${this.id} has no stages`);
+      return;
+    }
+    this.currentStageIndex = 0;
+    let currentStage = this.currentStage;
+    if (currentStage && currentStage.onStart) {
+      return currentStage.onStart();
+    } else {
+      console.error(`[NQTR] Quest ${this.id} has no start stage`);
+    }
   }
-  get onEnd() {
-    return this._onEnd;
+  tryToGoNextStage() {
+    if (!this.started) {
+      return;
+    }
+    if (this.completed) {
+      return;
+    }
+    let currentStage = this.currentStage;
+    let currentStageIndex = this.currentStageIndex;
+    if (!currentStage || currentStageIndex === void 0) {
+      console.error(`[NQTR] Quest ${this.id} has no current stage`);
+      return;
+    }
+    if (currentStage.completed) {
+      let nextStageIndex = currentStageIndex + 1;
+      currentStageIndex = nextStageIndex;
+      let nextStage = this.currentStage;
+      if (currentStage && currentStage.onEnd) {
+        currentStage.onEnd();
+      }
+      if (nextStage && nextStage.onStart) {
+        return nextStage.onStart();
+      }
+    }
   }
 };
 var CURRENT_ROOM_MEMORY_KEY = "___nqtr-current_room_memory___";
@@ -1563,6 +1780,6 @@ function currentActivities() {
   return currentRoom.activities.filter((activity) => !activity.hidden);
 }
 
-export { ActivityModel, CommitmentBaseModel, ExecutionTypeEnum, Goal, LocationBaseModel, MapBaseModel, QuestBaseModel, RoomBaseModel, StageBaseModel, TimeManager, addTemporaryCommitment, clearExpiredActivities, clearExpiredRoutine, currentActivities, getActivityById, getAllLocations, getAllMaps, getCommitmentByCharacter, getCommitmentById, getCueerntMap, getCurrenrLocation, getCurrentCommitments, getCurrentRoom, getFixedCommitments, getRoomById, getTemporaryCommitments, saveActivity, saveCommitment, saveRoom, setCurrentRoom, setFixedCommitments };
+export { ActivityModel, ActivityRoom, CommitmentBaseModel, Goal, LocationBaseModel, MapBaseModel, Quest, RoomBaseModel, Stage, TimeManager, addCommitment, clearExpiredActivities, clearExpiredRoutine, currentActivities, getActivityById, getAllLocations, getAllMaps, getCommitmentByCharacter, getCommitmentById, getCueerntMap, getCurrenrLocation, getCurrentRoom, getCurrentRoutine, getQuestById, getRoomById, saveActivity, saveCommitment, saveQuest, saveRoom, setCurrentRoom, setFixedRoutine };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map