@drincs/nqtr 0.8.1 → 1.0.0

package/dist/registries.cjs

@@ -1 +1 @@
-'use strict';var pixiVn=require('@drincs/pixi-vn');var t;(n=>(n.log=(e,...r)=>console.log(`[NQTR] ${e}`,...r),n.warn=(e,...r)=>console.warn(`[NQTR] ${e}`,...r),n.error=(e,...r)=>console.error(`[NQTR] ${e}`,...r),n.info=(e,...r)=>console.info(`[NQTR] ${e}`,...r)))(t||(t={}));var s=new pixiVn.CachedMap({cacheSize:20}),g;(n=>{function o(e){if(Array.isArray(e)){e.forEach(r=>n.add(r));return}s.set(e.id,e);}n.add=o;function a(e){try{let r=s.get(e);if(!r){console.warn(`[NQTR] Activity ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Activity ${e}`,r);return}}n.get=a;function i(){return Array.from(s.values())}n.values=i;function f(e){return s.has(e)}n.has=f;})(g||(g={}));var M=g;var c=new pixiVn.CachedMap({cacheSize:20}),$=new pixiVn.CachedMap({cacheSize:20}),l;(n=>{function o(e){if(Array.isArray(e)){e.forEach(r=>n.add(r));return}c.set(e.id,e);}n.add=o;function a(e){try{let r=c.get(e);if(!r){console.warn(`[NQTR] Commitment ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Commitment ${e}`,r);return}}n.get=a;function i(){return Array.from(c.values())}n.values=i;function f(e){return c.has(e)}n.has=f;})(l||(l={}));var E=l;var u=new pixiVn.CachedMap({cacheSize:20}),y;(n=>{function o(e){if(Array.isArray(e)){e.forEach(r=>o(r));return}u.set(e.id,e);}n.add=o;function a(e){try{let r=u.get(e);if(!r){console.warn(`[NQTR] Location ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Location ${e}`,r);return}}n.get=a;function i(){return Array.from(u.values())}n.values=i;function f(e){return u.has(e)}n.has=f;})(y||(y={}));var h=y;var m=new pixiVn.CachedMap({cacheSize:20}),x;(n=>{function o(e){if(Array.isArray(e)){e.forEach(r=>o(r));return}m.set(e.id,e);}n.add=o;function a(e){try{let r=m.get(e);if(!r){console.warn(`[NQTR] Map ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Map ${e}`,r);return}}n.get=a;function i(){return Array.from(m.values())}n.values=i;function f(e){return m.has(e)}n.has=f;})(x||(x={}));var I=x;var p=new pixiVn.CachedMap({cacheSize:5}),A;(n=>{function o(e){if(Array.isArray(e)){e.forEach(r=>n.add(r));return}p.set(e.id,e);}n.add=o;function a(e){try{let r=p.get(e);if(!r){console.warn(`[NQTR] Quest ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Quest ${e}`,r);return}}n.get=a;function i(){return Array.from(p.values())}n.values=i;function f(e){return p.has(e)}n.has=f;})(A||(A={}));var z=A;var d=new pixiVn.CachedMap({cacheSize:20}),w;(n=>{function o(e){if(Array.isArray(e)){e.forEach(C=>o(C));return}d.set(e.id,e);let r=e.location;h.add(r);let R=r?.map;R&&I.add(R);}n.add=o;function a(e){try{let r=d.get(e);if(!r){console.warn(`[NQTR] Room ${e} not found, you should register it first`);return}return r}catch(r){t.error(`Error while getting Room ${e}`,r);return}}n.get=a;function i(){return Array.from(d.values())}n.values=i;function f(e){return d.has(e)}n.has=f;})(w||(w={}));var b=w;exports.RegisteredActivities=M;exports.RegisteredCommitments=E;exports.RegisteredLocations=h;exports.RegisteredMaps=I;exports.RegisteredQuests=z;exports.RegisteredRooms=b;exports.fixedCommitments=$;exports.registeredCommitments=c;
+'use strict';var pixiVn=require('@drincs/pixi-vn');var o;(i=>(i.log=(r,...t)=>console.log(`[NQTR] ${r}`,...t),i.warn=(r,...t)=>console.warn(`[NQTR] ${r}`,...t),i.error=(r,...t)=>console.error(`[NQTR] ${r}`,...t),i.info=(r,...t)=>console.info(`[NQTR] ${r}`,...t)))(o||={});var f=new pixiVn.CachedMap({cacheSize:20}),h;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);continue}f.set(e.id,e);}}r.add=n;function a(t){try{let e=f.get(t);if(!e){console.warn(`[NQTR] Activity ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Activity ${t}`,e);return}}r.get=a;function c(){return Array.from(f.values())}r.values=c;function s(t){return f.has(t)}r.has=s;function i(){f.clear();}r.clear=i;})(h||={});var T=h;var m=new pixiVn.CachedMap({cacheSize:20}),A=new pixiVn.CachedMap({cacheSize:20}),R;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);return}m.set(e.id,e);}}r.add=n;function a(t){try{let e=m.get(t);if(!e){console.warn(`[NQTR] Commitment ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Commitment ${t}`,e);return}}r.get=a;function c(){return Array.from(m.values())}r.values=c;function s(t){return m.has(t)}r.has=s;function i(){m.clear(),A.clear();}r.clear=i;})(R||={});var $=R;var u=new pixiVn.CachedMap({cacheSize:20}),Q;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);return}u.set(e.id,e);}}r.add=n;function a(t){try{let e=u.get(t);if(!e){console.warn(`[NQTR] Location ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Location ${t}`,e);return}}r.get=a;function c(){return Array.from(u.values())}r.values=c;function s(t){return u.has(t)}r.has=s;function i(){u.clear();}r.clear=i;})(Q||={});var l=Q;var p=new pixiVn.CachedMap({cacheSize:20}),w;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);return}p.set(e.id,e);}}r.add=n;function a(t){try{let e=p.get(t);if(!e){console.warn(`[NQTR] Map ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Map ${t}`,e);return}}r.get=a;function c(){return Array.from(p.values())}r.values=c;function s(t){return p.has(t)}r.has=s;function i(){p.clear();}r.clear=i;})(w||={});var y=w;var d=new pixiVn.CachedMap({cacheSize:5}),C;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);return}d.set(e.id,e);}}r.add=n;function a(t){try{let e=d.get(t);if(!e){console.warn(`[NQTR] Quest ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Quest ${t}`,e);return}}r.get=a;function c(){return Array.from(d.values())}r.values=c;function s(t){return d.has(t)}r.has=s;function i(){d.clear();}r.clear=i;})(C||={});var S=C;var g=new pixiVn.CachedMap({cacheSize:20}),M;(r=>{function n(...t){for(let e of t){if(Array.isArray(e)){n(...e);return}g.set(e.id,e);let x=e.location;l.add(x);let I=x?.map;I&&y.add(I);}}r.add=n;function a(t){try{let e=g.get(t);if(!e){console.warn(`[NQTR] Room ${t} not found, you should register it first`);return}return e}catch(e){o.error(`Error while getting Room ${t}`,e);return}}r.get=a;function c(){return Array.from(g.values())}r.values=c;function s(t){return g.has(t)}r.has=s;function i(){g.clear();}r.clear=i;})(M||={});var E=M;exports.RegisteredActivities=T;exports.RegisteredCommitments=$;exports.RegisteredLocations=l;exports.RegisteredMaps=y;exports.RegisteredQuests=S;exports.RegisteredRooms=E;exports.fixedCommitments=A;exports.registeredActivities=f;exports.registeredCommitments=m;exports.registeredLocations=u;exports.registeredMaps=p;exports.registeredQuests=d;exports.registeredRooms=g;

package/dist/registries.d.mts

@@ -1,366 +1,97 @@
-import { OnRunProps as OnRunProps$1, ActivityInterface as ActivityInterface$1, CommitmentInterface as CommitmentInterface$1, LocationInterface as LocationInterface$1, MapInterface as MapInterface$1, RoomInterface as RoomInterface$1, QuestInterface as QuestInterface$1, StageInterface as StageInterface$1 } from '@drincs/nqtr';
-import { CharacterInterface, CachedMap } from '@drincs/pixi-vn';
-import { StoredClassModel } from '@drincs/pixi-vn/storage';
+import { A as ActivityInterface, C as CommitmentInterface, h as LocationInterface, M as MapInterface, Q as QuestInterface, R as RoomInterface } from './StageInterface-BN_O8nDA.mjs';
+import { CachedMap } from '@drincs/pixi-vn';
+import '@drincs/pixi-vn/storage';
+import '@drincs/nqtr/registries';
 
-interface DateSchedulingInterface {
-    /**
-     * The start date. If the item hasn't started yet, it will be hidden.
-     * If you set it to 3, the item will be hidden on dates 1 and 2 and will be shown starting on date 3.
-     */
-    from: number;
-    /**
-     * The date when the item ends. If the item is ended yet, it will be deleted or hidden.
-     * If you set { from: 0, to: 3 }, the item will be shown into dates 1 and 2 and will be deleted or hidden from date 3.
-     * @default undefined
-     */
-    to?: number;
-}
-
-interface TimeSchedulingInterface {
-    /**
-     * The time when the item starts. If the item is not started yet, it will be hidden.
-     * If you set 3, the item will be hidden into times 1 and 2, and will be shown from time 3.
-     */
-    from: number;
-    /**
-     * The time when the item ends. If the item is ended yet, it will be hidden.
-     * If you set 3, the item will be shown into times 1 and 2 and will be hidden from time 3.
-     * @default timeTracker.dayEndTime + 1
-     */
-    to?: number;
-}
-
-interface ActiveScheduling {
-    /**
-     * Time slot in which activity/commitment will be active.
-     */
-    readonly timeSlot?: TimeSchedulingInterface[] | TimeSchedulingInterface;
-    /**
-     * Used to schedule what date it will be added and removed.
-     */
-    readonly dateScheduling?: DateSchedulingInterface;
-}
-
-type ExecutionType = "automatic" | "interaction";
-
-type OnRunProps = OnRunProps$1;
-/**
- * The function that is called when the class is runned.
- */
-type OnRunEvent<T> = (item: T, props: OnRunProps) => any | Promise<any>;
-type OnRunAsyncFunction = (props: OnRunProps) => Promise<any>;
-
-type QuestsRequiredType = {
-    quest: QuestInterface;
-    stageNumber: number;
-};
-
-interface ActivityInterface extends ActivityBaseInternalInterface, ActivityInterface$1 {
-}
-interface ActivityBaseInternalInterface extends ActiveScheduling {
-    /**
-     * The id of the activity/commitment.
-     */
-    readonly id: string;
-    /**
-     * The function that is called when the activity/commitment is runned.
-     */
-    readonly run: OnRunAsyncFunction;
-    /**
-     * Whether the activity/commitment is a deadline, so it will then be removed or hidden.
-     *
-     * It **depends only on the date**, not the time. So if you set { dateScheduling: { from: 0, to: 3 }, timeSlot { from: 10, to: 20 } } the activity/commitment hidden or deleted on date 3 at 0.
-     */
-    readonly expired: boolean;
-    /**
-     * Whether the activity/commitment is active, so it will be shown in the routine and can be runned.
-     * @param options The options to check if the activity/commitment is active.
-     */
-    isActive(options?: ActiveScheduling): boolean;
-}
-
-interface CommitmentInterface extends CommitmentBaseInternalInterface, CommitmentInterface$1 {
-}
-interface CommitmentBaseInternalInterface extends ActivityBaseInternalInterface {
-    /**
-     * The character or characters that are in the commitment and so in the room.
-     */
-    readonly characters: CharacterInterface[];
-    /**
-     * Execution type. If is "automatic" the onRun() runned automatically when the palayer is in the room. If is "interaction" the player must interact with the character to run the onRun() function.
-     * If you set "automatic" remember to remove the commitment when it is no longer needed, because otherwise it repeats itself every time.
-     */
-    executionType: ExecutionType;
-    /**
-     * 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.
-     */
-    priority: number;
-}
-
-interface NavigationAbstractInterface extends StoredClassModel {
-    /**
-     * Connects the activity to the class.
-     * @param activity The activity to connect to the class.
-     * @param options
-     * @returns
-     */
-    addActivity(activity: ActivityInterface, options?: ActiveScheduling): void;
-    /**
-     * Disconnects the activity from the class.
-     * @param activity The activity to disconnect from the class.
-     * @param options
-     */
-    removeActivity(activity: ActivityInterface | string): void;
-    /**
-     * Removes the useless activities.
-     */
-    clearExpiredActivities(): void;
-    /**
-     * All the ids of the activities associated with this class. Compared to {@link activities}, they are not filtered based on their scheduling.
-     */
-    readonly activitiesIds: string[];
-    /**
-     * The activities associated with this class, filtered based on their scheduling.
-     */
-    activities: ActivityInterface[];
-}
-
-interface LocationInterface extends LocationInternalInterface, LocationInterface$1 {
-}
-interface LocationInternalInterface extends NavigationAbstractInterface {
-    /**
-     * The id of the location.
-     */
-    readonly id: string;
-    /**
-     * The map where the location is.
-     */
-    readonly map: MapInterface;
-    /**
-     * Get all rooms in the location.
-     * @returns The rooms in the location.
-     */
-    readonly rooms: RoomInterface[];
-}
-
-interface MapInterface extends MapBaseInternalInterface, MapInterface$1 {
-}
-interface MapBaseInternalInterface extends NavigationAbstractInterface {
-    /**
-     * The id of the map.
-     */
-    readonly id: string;
-    /**
-     * Get all locations in the map.
-     * @returns The locations in the map.
-     */
-    readonly locations: LocationInterface[];
-}
-
-interface RoomInterface extends RoomBaseInternalInterface, RoomInterface$1 {
+interface NqtrActivityIds {
 }
-interface RoomBaseInternalInterface extends NavigationAbstractInterface {
-    /**
-     * The id of the room.
-     */
-    readonly id: string;
-    /**
-     * The location where the room is.
-     */
-    readonly location: LocationInterface;
-    /**
-     * Connects the commitment to the class.
-     * @param commitment The commitment to connect to the class.
-     * @param options
-     * @returns
-     */
-    addCommitment(commitment: CommitmentInterface, options?: ActiveScheduling): void;
-    /**
-     * Disconnects the commitment from the class.
-     * @param commitment The commitment to disconnect from the class.
-     * @param options
-     */
-    removeCommitment(commitment: CommitmentInterface | string): void;
-    /**
-     * Get the character commitments of the room.
-     */
-    readonly routine: CommitmentInterface[];
-    /**
-     * Get the characters in the room.
-     */
-    readonly characters: CharacterInterface[];
-    /**
-     * Get the functions that will be executed when the room is visited.
-     */
-    readonly automaticFunctions: OnRunAsyncFunction[];
+interface NqtrCommitmentIds {
 }
-
-interface QuestInterface extends QuestBaseInternalInterface, QuestInterface$1 {
+interface NqtrLocationIds {
 }
-interface QuestBaseInternalInterface {
-    /**
-     * The id of the quest.
-     */
-    readonly id: string;
-    /**
-     * The stages of the quest.
-     */
-    readonly stages: StageInterface[];
-    /**
-     * The index of the current stage.
-     */
-    currentStageIndex?: number;
-    /**
-     * The current stage.
-     */
-    readonly currentStage?: StageInterface;
-    /**
-     * If the quest is started.
-     */
-    readonly started: boolean;
-    /**
-     * If the quest is started and not completed and not failed.
-     */
-    readonly inProgress: boolean;
-    /**
-     * If the quest is completed.
-     */
-    readonly completed: boolean;
-    /**
-     * If the quest is failed.
-     */
-    readonly failed: boolean;
-    /**
-     * The function that will be called when the quest starts.
-     */
-    readonly onStart?: OnRunEvent<QuestInterface>;
-    /**
-     * The function that will be called when the quest goes to the next stage.
-     */
-    readonly onNextStage?: OnRunEvent<QuestInterface>;
-    /**
-     * 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: OnRunProps$1): Promise<void>;
-    /**
-     * Go to the next stage if the current stage is completed.
-     * If you want to force the change of stage, use {@link advanceUnconditionally}.
-     * @param props The properties. If you not want to pass any property, you can pass an {}.
-     * @returns true if the stage was changed, false otherwise.
-     */
-    advanceIfCompleted(props: OnRunProps$1): Promise<boolean>;
-    /**
-     * Complete the current stage and go to the next stage with {@link advanceUnconditionally}.
-     * If you want to go to the next stage only if the current stage is completed, use {@link advanceIfCompleted}.
-     * @param props The properties. If you not want to pass any property, you can pass an {}.
-     * @returns true if the stage was changed, false otherwise.
-     */
-    continue(props: OnRunProps$1): Promise<boolean>;
-    /**
-     * Ignore the completed state of the current stage and go to the next stage without checking if the current stage is completed.
-     * If you want to go to the next stage only if the current stage is completed, use {@link advanceIfCompleted}.
-     * @param props The properties. If you not want to pass any property, you can pass an {}.
-     * @returns returns true if the stage was changed, false otherwise.
-     */
-    advanceUnconditionally(props: OnRunProps$1): Promise<boolean>;
-    /**
-     * If the current stage must start. It is true if the current stage is not started, can start and not completed.
-     */
-    readonly currentStageMustStart: boolean;
-    /**
-     * Start the current stage. This is a system function, do not use it directly.
-     * @param props The properties for the start stage. If you not want to pass any property, you can pass an {}.
-     */
-    startCurrentStage(props: OnRunProps$1): Promise<void>;
+interface NqtrMapIds {
 }
-
-interface StageInterface extends StageBaseInternalInterface, StageInterface$1 {
+interface NqtrQuestIds {
 }
-interface StageBaseInternalInterface {
-    /**
-     * The id of the stage.
-     */
-    readonly id: string;
-    /**
-     * The function that will be called when the stage starts.
-     */
-    readonly onStart?: OnRunEvent<StageInterface>;
-    /**
-     * The function that will be called when the stage ends.
-     */
-    readonly onEnd?: OnRunEvent<StageInterface>;
-    /**
-     * Check if the flag and goals are completed.
-     * You can force the completion of the stage by setting the completed property to true.
-     * @example
-     * ```ts
-     * export default class Stage extends StageStoredClass {
-     * 	override get completed(): boolean {
-     * 		if (super.completed) {
-     * 			return true;
-     * 		}
-     * 		if (this.flags.length > 0) {
-     * 			if (!this.flags.every((flag) => storage.getFlag(flag.flag))) {
-     * 				return false;
-     * 			}
-     * 			return true;
-     * 		}
-     * 		return false;
-     * 	}
-     * 	override set completed(value: boolean) {
-     * 		super.completed = value;
-     * 	}
-     * }
-     * ```
-     */
-    completed: boolean;
-    /**
-     * If the stage is started.
-     */
-    started: boolean;
-    /**
-     * The date when the stage starts.
-     */
-    readonly startDate?: number;
-    /**
-     * Check if the stage can start.
-     * @example
-     * ```ts
-     * export default class Stage extends StageStoredClass {
-     * 	override get canStart(): boolean {
-     * 		if (this.flagsRequired.length > 0 && !this.flagsRequired.every((flag) => storage.getFlag(flag.flag))) {
-     * 			return false;
-     * 		}
-     * 		return super.canStart;
-     * 	}
-     * }
-     * ```
-     */
-    readonly canStart: boolean;
-    /**
-     * The function that will be called when the stage starts.
-     */
-    start(props: OnRunProps$1): Promise<void>;
-    /**
-     * The number of day/date required to start the stage.
-     */
-    readonly deltaDateRequired: number;
-    /**
-     * The list of quests required to start the stage.
-     */
-    readonly questsRequired: QuestsRequiredType[];
+interface NqtrRoomIds {
 }
+/**
+ * The type used wherever an activity ID is expected.
+ *
+ * - **Default** — resolves to `string` so that existing code compiles without changes.
+ * - **Augmented** — when {@link NqtrActivityIds} has been extended via
+ *   `declare module "@drincs/nqtr/registries"`, resolves to the union of known activity IDs.
+ *
+ * @example
+ * ```ts
+ * // nqtr.gen.d.ts (auto-generated by vitePluginNqtr)
+ * declare module "@drincs/nqtr/registries" {
+ *     interface NqtrActivityIds { "study": never; "cook": never; }
+ * }
+ * ```
+ */
+type ActivityIdType = [keyof NqtrActivityIds] extends [never] ? string : keyof NqtrActivityIds;
+/**
+ * The type used wherever a commitment ID is expected.
+ *
+ * - **Default** — resolves to `string`.
+ * - **Augmented** — resolves to the union of known commitment IDs once
+ *   {@link NqtrCommitmentIds} has been extended.
+ */
+type CommitmentIdType = [keyof NqtrCommitmentIds] extends [never] ? string : keyof NqtrCommitmentIds;
+/**
+ * The type used wherever a location ID is expected.
+ *
+ * - **Default** — resolves to `string`.
+ * - **Augmented** — resolves to the union of known location IDs once
+ *   {@link NqtrLocationIds} has been extended.
+ */
+type LocationIdType = [keyof NqtrLocationIds] extends [never] ? string : keyof NqtrLocationIds;
+/**
+ * The type used wherever a map ID is expected.
+ *
+ * - **Default** — resolves to `string`.
+ * - **Augmented** — resolves to the union of known map IDs once
+ *   {@link NqtrMapIds} has been extended.
+ */
+type MapIdType = [keyof NqtrMapIds] extends [never] ? string : keyof NqtrMapIds;
+/**
+ * The type used wherever a quest ID is expected.
+ *
+ * - **Default** — resolves to `string`.
+ * - **Augmented** — resolves to the union of known quest IDs once
+ *   {@link NqtrQuestIds} has been extended.
+ */
+type QuestIdType = [keyof NqtrQuestIds] extends [never] ? string : keyof NqtrQuestIds;
+/**
+ * The type used wherever a room ID is expected.
+ *
+ * - **Default** — resolves to `string`.
+ * - **Augmented** — resolves to the union of known room IDs once
+ *   {@link NqtrRoomIds} has been extended.
+ *
+ * @example
+ * ```ts
+ * import type { RoomIdType } from "@drincs/nqtr/registries";
+ *
+ * function navigateTo(roomId: RoomIdType) { ... }
+ * navigateTo("bedroom"); // ✅ compile error if "bedroom" is not a known room
+ * ```
+ */
+type RoomIdType = [keyof NqtrRoomIds] extends [never] ? string : keyof NqtrRoomIds;
 
+/**
+ * A Map that contains all activities registered and available to be used.
+ * The key is the id of the activity and the value is the activity itself.
+ */
+declare const registeredActivities: CachedMap<string, ActivityInterface>;
 declare namespace RegisteredActivities {
     /**
      * Save an activity in the registered activities. If the activity already exists, it will be overwritten.
-     * @param activity The activity to save.
+     * @param activities The activity to save.
      * @returns
      */
-    function add(activities: ActivityInterface | ActivityInterface[]): void;
+    function add(...activities: (ActivityInterface | ActivityInterface[])[]): void;
     /**
      * Get an activity by its id.
      * @param id The id of the activity.
@@ -378,6 +109,11 @@ declare namespace RegisteredActivities {
      * @returns True if the activity is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered activities.
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
 /**
@@ -385,14 +121,14 @@ declare namespace RegisteredActivities {
  * The key is the id of the commitment and the value is the commitment itself.
  */
 declare const registeredCommitments: CachedMap<string, CommitmentInterface>;
-declare const fixedCommitments: CachedMap<string, [CommitmentInterface, string]>;
+declare const fixedCommitments: CachedMap<string, string>;
 declare namespace RegisteredCommitments {
     /**
      * Save a commitment in the registered commitments. If the commitment already exists, it will be overwritten.
-     * @param commitment The commitment to save.
+     * @param commitments The commitment to save.
      * @returns
      */
-    function add(commitments: CommitmentInterface | CommitmentInterface[]): void;
+    function add(...commitments: (CommitmentInterface | CommitmentInterface[])[]): void;
     /**
      * Get a commitment by its id.
      * @param id The id of the commitment.
@@ -410,15 +146,25 @@ declare namespace RegisteredCommitments {
      * @returns True if the commitment is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered commitments (both scheduled and fixed).
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
+/**
+ * A Map that contains all locations registered and available to be used.
+ * The key is the id of the location and the value is the location itself.
+ */
+declare const registeredLocations: CachedMap<string, LocationInterface>;
 declare namespace RegisteredLocations {
     /**
      * Save a location in the registered locations. If the location already exists, it will be overwritten.
-     * @param location The location to save.
+     * @param locations The location to save.
      * @returns
      */
-    function add(location: LocationInterface | LocationInterface[]): void;
+    function add(...locations: (LocationInterface | LocationInterface[])[]): void;
     /**
      * Get a location by its id.
      * @param id The id of the location.
@@ -436,15 +182,25 @@ declare namespace RegisteredLocations {
      * @returns True if the location is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered locations.
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
+/**
+ * A Map that contains all maps registered and available to be used.
+ * The key is the id of the map and the value is the map itself.
+ */
+declare const registeredMaps: CachedMap<string, MapInterface>;
 declare namespace RegisteredMaps {
     /**
      * Save a map in the registered maps. If the map already exists, it will be overwritten.
-     * @param map The map to save.
+     * @param maps The map to save.
      * @returns
      */
-    function add(map: MapInterface | MapInterface[]): void;
+    function add(...maps: (MapInterface | MapInterface[])[]): void;
     /**
      * Get a map by its id.
      * @param id The id of the map.
@@ -462,15 +218,25 @@ declare namespace RegisteredMaps {
      * @returns True if the map is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered maps.
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
+/**
+ * A Map that contains all quests registered and available to be used.
+ * The key is the id of the quest and the value is the quest itself.
+ */
+declare const registeredQuests: CachedMap<string, QuestInterface>;
 declare namespace RegisteredQuest {
     /**
      * Save a quest in the registered quests. If the quest already exists, it will be overwritten.
-     * @param quest The quest to save.
+     * @param quests The quest to save.
      * @returns
      */
-    function add(quests: QuestInterface | QuestInterface[]): void;
+    function add(...quests: (QuestInterface | QuestInterface[])[]): void;
     /**
      * Get a quest by its id.
      * @param id The id of the quest.
@@ -488,16 +254,26 @@ declare namespace RegisteredQuest {
      * @returns True if the quest is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered quests.
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
+/**
+ * A Map that contains all rooms registered and available to be used.
+ * The key is the id of the room and the value is the room itself.
+ */
+declare const registeredRooms: CachedMap<string, RoomInterface>;
 declare namespace RegisteredRooms {
     /**
      * Save a room in the registered rooms, and their location and map if they are not already registered.
      * If the room already exists, it will be overwritten.
-     * @param room The room to save.
+     * @param rooms The room to save.
      * @returns
      */
-    function add(room: RoomInterface | RoomInterface[]): void;
+    function add(...rooms: (RoomInterface | RoomInterface[])[]): void;
     /**
      * Get a room by its id.
      * @param id The id of the room.
@@ -515,6 +291,11 @@ declare namespace RegisteredRooms {
      * @returns True if the room is registered, false otherwise.
      */
     function has(id: string): boolean;
+    /**
+     * Remove all registered rooms.
+     * Primarily used by the Vite plugin to reset state between hot-module reloads.
+     */
+    function clear(): void;
 }
 
-export { RegisteredActivities, RegisteredCommitments, RegisteredLocations, RegisteredMaps, RegisteredQuest as RegisteredQuests, RegisteredRooms, fixedCommitments, registeredCommitments };
+export { type ActivityIdType, type CommitmentIdType, type LocationIdType, type MapIdType, type NqtrActivityIds, type NqtrCommitmentIds, type NqtrLocationIds, type NqtrMapIds, type NqtrQuestIds, type NqtrRoomIds, type QuestIdType, RegisteredActivities, RegisteredCommitments, RegisteredLocations, RegisteredMaps, RegisteredQuest as RegisteredQuests, RegisteredRooms, type RoomIdType, fixedCommitments, registeredActivities, registeredCommitments, registeredLocations, registeredMaps, registeredQuests, registeredRooms };