@drincs/nqtr 0.2.13 → 0.3.0

package/dist/Commitment-DFYAApxl.d.ts

@@ -1,586 +0,0 @@
-import { GraphicItemType, OnRenderGraphicItemProps, NeighboringMapsInterface, OnRunProps } from '@drincs/nqtr/dist/override';
-import { CharacterInterface, StoredClassModel } from '@drincs/pixi-vn';
-import { a as ActivityStoredAbstract, A as ActivityProps } from './ActivityProps-LWY7Zucl.js';
-import { OnRunActivityEvent } from './types/OnRunActivityEvent.js';
-import ActivityModel from './classes/Activity.js';
-import ExecutionType from './types/ExecutionType.js';
-import { OnRunCommitmentEvent } from './types/OnRunCommitmentEvent.js';
-
-interface CommitmentProps<TCharacter extends CharacterInterface = CharacterInterface, TRoom extends RoomBaseModel = RoomBaseModel> {
-    /**
-     * The name
-     * @default ""
-     */
-    name?: string;
-    /**
-     * The hour when the commitment starts. If the commitment is not started yet, it will be hidden.
-     * If you set 3, the commitment will be hidden into hours 1 and 2, and will be shown from hour 3.
-     * @default timeTracker.minDayHours
-     */
-    fromHour?: number;
-    /**
-     * The hour when the commitment ends. If the commitment is ended yet, it will be hidden.
-     * If you set 3, the commitment will be shown into hours 1 and 2 and will be hidden from hour 3.
-     * @default timeTracker.maxDayHours + 1
-     */
-    toHour?: number;
-    /**
-     * The day when the commitment starts. If the commitment is not started yet, it will be hidden.
-     * If you set 3, the commitment will be hidden into days 1 and 2, and will be shown from day 3.
-     * @default undefined
-     */
-    fromDay?: number;
-    /**
-     * The day when the commitment ends. If the commitment is ended yet, it will be deleted or hidden.
-     * If you set 3, the commitment will be shown into days 1 and 2 and will be deleted or hidden from day 3.
-     * @default undefined
-     */
-    toDay?: number;
-    /**
-     * The image. It can be a string, an Element or a Pixi'VN Canvas Item.
-     * Or an object to manage multiple image types. For example to have a image based on time.
-     * @example
-     * ```ts
-     * {
-     *    "morning": "morning-background.jpg",
-     *    "afternoon": "afternoon-background.jpg",
-     *    "evening": "evening-background.jpg",
-     *    "night": "night-background.jpg"
-     * }
-     * ```
-     * @default undefined
-     */
-    renderImage?: GraphicItemType | ((commitment: CommitmentBaseModel<TCharacter, TRoom>, props: OnRenderGraphicItemProps) => GraphicItemType);
-    /**
-     * 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.
-     * @default "interaction"
-     */
-    executionType?: ExecutionType;
-    /**
-     * Is a function that is called when the player interacts with the character.
-     * @param commitment
-     * @returns
-     * @default undefined
-     */
-    onRun?: OnRunCommitmentEvent<CommitmentBaseModel>;
-    /**
-     * Whether is disabled. You can also pass a Pixi'VN flag name.
-     * If it is disabled this commitment will not be taken into consideration. So the characters will not be in the room, but will be busy with other commitments.
-     * @default false
-     */
-    disabled?: boolean | string;
-    /**
-     * Whether is hidden. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    hidden?: boolean | string;
-    /**
-     * The icon element. Can be a string or an Element or a Pixi'VN CanvasItem
-     * @default undefined
-     */
-    renderIcon?: GraphicItemType | ((commitment: CommitmentBaseModel, props: OnRenderGraphicItemProps) => GraphicItemType);
-    /**
-     * 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.
-     * @default 0
-     */
-    priority?: number;
-}
-
-interface LocationProps<TMap extends MapBaseModel = MapBaseModel> {
-    /**
-     * The name
-     * @default ""
-     */
-    name?: string;
-    /**
-     * Whether is disabled. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    disabled?: boolean | string;
-    /**
-     * Whether is hidden. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    hidden?: boolean | string;
-    /**
-     * The icon element. Can be a string or an Element or a Pixi'VN CanvasItem
-     * @default undefined
-     */
-    renderIcon?: GraphicItemType | ((location: LocationBaseModel<TMap>, props: OnRenderGraphicItemProps) => GraphicItemType);
-}
-
-interface MapProps {
-    /**
-     * The name
-     * @default ""
-     */
-    name?: string;
-    /**
-     * The image. It can be a string, an Element or a Pixi'VN Canvas Item.
-     * Or an object to manage multiple image types. For example to have a image based on time.
-     * @example
-     * ```ts
-     * {
-     *    "morning": "morning-background.jpg",
-     *    "afternoon": "afternoon-background.jpg",
-     *    "evening": "evening-background.jpg",
-     *    "night": "night-background.jpg"
-     * }
-     * ```
-     * @default undefined
-     */
-    renderImage?: GraphicItemType | ((map: MapBaseModel, props: OnRenderGraphicItemProps) => GraphicItemType);
-    /**
-     * The neighboring maps that are available in this map.
-     * @example
-     * ```ts
-     * {
-     *    "north": "atlanta_map_id",
-     *    "south": "miami_map_id",
-     *    "east": "new_york_map_id",
-     *    "west": "los_angeles_map_id"
-     * }
-     * ```
-     * @default {}
-     */
-    neighboringMaps?: NeighboringMapsInterface;
-    /**
-     * Whether is disabled. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    disabled?: boolean | string;
-    /**
-     * Whether is hidden. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    hidden?: boolean | string;
-}
-
-interface RoomProps<TLocation extends LocationBaseModel = LocationBaseModel> {
-    /**
-     * The name
-     * @default ""
-     */
-    name?: string;
-    /**
-     * The image. It can be a string, an Element or a Pixi'VN Canvas Item.
-     * Or an object to manage multiple image types. For example to have a image based on time.
-     * @example
-     * ```ts
-     * {
-     *    "morning": "morning-background.jpg",
-     *    "afternoon": "afternoon-background.jpg",
-     *    "evening": "evening-background.jpg",
-     *    "night": "night-background.jpg"
-     * }
-     * ```
-     * @default undefined
-     */
-    renderImage?: GraphicItemType | ((room: RoomBaseModel<TLocation>, props: OnRenderGraphicItemProps) => GraphicItemType);
-    /**
-     * The activities that are available in this room.
-     * @default []
-     */
-    defaultActivities?: ActivityModel[];
-    /**
-     * Whether is disabled. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    disabled?: boolean | string;
-    /**
-     * Whether is hidden. You can also pass a Pixi'VN flag name.
-     * @default false
-     */
-    hidden?: boolean | string;
-    /**
-     * The icon element. Can be a string or an Element or a Pixi'VN CanvasItem
-     * @default undefined
-     */
-    renderIcon?: GraphicItemType | ((room: RoomBaseModel<TLocation>, props: OnRenderGraphicItemProps) => GraphicItemType);
-    /**
-     * Whether is an entrance room, so when the player enters in the location, it will be the first room to be shown.
-     * @default false
-     */
-    isEntrance?: boolean;
-}
-
-/**
- * The activity generated by the room.
- */
-declare class ActivityRoom<TRoom extends RoomBaseModel = RoomBaseModel> extends ActivityStoredAbstract {
-    constructor(id: string, room: TRoom, onRun: OnRunActivityEvent<ActivityStoredAbstract>, props: ActivityProps);
-    setStorageProperty<T>(_: string, __: T | undefined): void;
-    getStorageProperty<T>(propertyName: string): T | undefined;
-    private _id;
-    get id(): string;
-    private _room;
-    /**
-     * The room where the activity is.
-     */
-    get room(): TRoom;
-    export(): object;
-}
-
-/**
- * The base model of a map. I suggest you extend this class to create your own map model.
- * @example
- * ```typescript
- * export const mainMap = new MapBaseModel('main_map', {
- *     name: 'Main Map',
- *     image: "https://image.jpg",
- *     neighboringMaps: {
- *         "north": "atlanta_map_id",
- *         "south": "miami_map_id",
- *         "east": "new_york_map_id",
- *         "west": "los_angeles_map_id"
- *     }
- * });
- * ```
- */
-declare class MapBaseModel extends StoredClassModel {
-    /**
-     * @param id The id of the map, it must be unique.
-     * @param props The properties of the map.
-     */
-    constructor(id: string, props?: MapProps);
-    private defaultName;
-    /**
-     * The name of the map.
-     * If you set undefined, it will return the initial value of name.
-     */
-    get name(): string;
-    set name(value: string | undefined);
-    private _renderImage?;
-    /**
-     * The function for rendering the image of the map.
-     */
-    get renderImage(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    private defaultDisabled;
-    /**
-     * Whether is disabled. If it is a string, it is a Pixi'VN flag name.
-     */
-    get disabled(): boolean;
-    set disabled(value: boolean | string);
-    private defaultHidden;
-    /**
-     * Whether is hidden. If it is a string, it is a Pixi'VN flag name.
-     */
-    get hidden(): boolean;
-    set hidden(value: boolean | string);
-    private _neighboringMaps?;
-    /**
-     * The neighboring maps that are available in this map.
-     * @example
-     * ```ts
-     * {
-     *     "north": "atlanta_map_id",
-     *     "south": "miami_map_id",
-     *     "east": "new_york_map_id",
-     *     "west": "los_angeles_map_id"
-     * }
-     * ```
-     */
-    get neighboringMaps(): NeighboringMapsInterface;
-    set neighboringMaps(value: NeighboringMapsInterface | undefined);
-    /**
-     * Get all locations in the map.
-     * @returns The locations in the map.
-     */
-    getLocations<TLocation extends LocationBaseModel = LocationBaseModel>(): TLocation[];
-}
-
-/**
- * The base model of a location. I suggest you extend this class to create your own location model.
- * @example
- * ```typescript
- * export const mcHome = new LocationBaseModel('mc_home', mainMap, {
- *     name: 'MC Home',
- *     icon: "https://icon.jpg",
- * });
- * ```
- */
-declare class LocationBaseModel<TMap extends MapBaseModel = MapBaseModel> extends StoredClassModel {
-    /**
-     * @param id The id of the location, it must be unique.
-     * @param map The map where the location is.
-     * @param props The properties of the location.
-     */
-    constructor(id: string, map: TMap, props?: LocationProps<TMap>);
-    private defaultName;
-    /**
-     * The name of the location.
-     * If you set undefined, it will return the initial value of name.
-     */
-    get name(): string;
-    set name(value: string | undefined);
-    private defaultDisabled;
-    /**
-     * Whether is disabled. If it is a string, it is a Pixi'VN flag name.
-     */
-    get disabled(): boolean;
-    set disabled(value: boolean | string);
-    private defaultHidden;
-    /**
-     * Whether is hidden. If it is a string, it is a Pixi'VN flag name.
-     */
-    get hidden(): boolean;
-    set hidden(value: boolean | string);
-    private _renderIcon?;
-    /**
-     * The function for rendering the icon of the location.
-     */
-    get renderIcon(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    private _map;
-    /**
-     * The map where the location is.
-     */
-    get map(): TMap;
-    /**
-     * Get the entrance room of the location.
-     * You can cast the room to a specific type that extends RoomBaseModel.
-     * @returns The entrance room or the first room if there is no entrance.
-     * @example
-     * ```typescript
-     * const entranceHome = new RoomBaseModel("entrance-home", home, { isEntrance: true })
-     * saveRoom(entranceHome)
-     * const home = new LocationBaseModel("home", map, { name: "Home" })
-     *
-     * const entrance = home.getEntrance() // entrance === entranceHome
-     * ```
-     */
-    getEntrance<TRoom extends RoomBaseModel = RoomBaseModel>(): TRoom | undefined;
-    /**
-     * Get all rooms in the location.
-     * You can cast the rooms to a specific type that extends RoomBaseModel.
-     * @returns The rooms in the location.
-     */
-    getRooms<TRoom extends RoomBaseModel = RoomBaseModel>(): TRoom[];
-}
-
-declare const ROOM_CATEGORY = "__nqtr-room__";
-/**
- * The base model of a room. I suggest you extend this class to create your own room model.
- * **You must use the {@link saveRoom} function to save the room in the registered rooms.**
- * @example
- * ```ts
- * export const mcRoom = new RoomBaseModel('mc_room', mcHome, {
- *     name: "MC Room",
- *     icon: "https://icon.jpg",
- *     image: "https://image.jpg",
- *     isEntrance: false,
- * })
- * saveRoom(mcRoom)
- * ```
- */
-declare class RoomBaseModel<TLocation extends LocationBaseModel = LocationBaseModel> 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: string, location: TLocation, props?: RoomProps<TLocation>);
-    private _location;
-    /**
-     * The location where the room is.
-     */
-    get location(): TLocation;
-    private _isEntrance?;
-    /**
-     * Whether is an entrance room, so when the player enters in the location, it will be the first room to be shown.
-     */
-    get isEntrance(): boolean;
-    private defaultName;
-    /**
-     * The name.
-     * If you set undefined, it will return the initial value of name.
-     */
-    get name(): string;
-    set name(value: string | undefined);
-    private _renderImage?;
-    /**
-     * The function for rendering the image of the room.
-     */
-    get renderImage(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    private defaultActivityIds;
-    /**
-     * The activities that are available in this room.
-     */
-    get defaultActivities(): ActivityRoom<this>[];
-    private get activityIds();
-    /**
-     * The activities that are available in this room.
-     */
-    get activities(): ActivityRoom<this>[];
-    /**
-     * Get the memory of an activity. This function can be used into olther libraries to get the memory of the activity.
-     * @param id The id of the activity.
-     * @returns The memory of the activity.
-     */
-    getActivityMemory(id: string): object | undefined;
-    /**
-     * Get the activity by id.
-     * @param id The id of the activity.
-     * @returns The room activity.
-     */
-    getActivity(id: string): ActivityRoom<this> | undefined;
-    /**
-     * Set the memory of an activity. This function can be used into olther libraries to set the memory of the activity.
-     * @param id The id of the activity.
-     * @param memory The memory of the activity.
-     */
-    setActivity(activity: ActivityRoom): void;
-    /**
-     * Add an activity to the room.
-     * @param activity The activity to add.
-     */
-    addActivity(activity: ActivityModel): void;
-    /**
-     * Remove an activity from the room.
-     * @param activity The activity to remove.
-     */
-    removeActivity(activity: ActivityModel | string): void;
-    /**
-     * Clear all expired activities.
-     */
-    clearExpiredActivities(): void;
-    private defaultDisabled;
-    /**
-     * Whether is disabled. If it is a string, it is a Pixi'VN flag name.
-     */
-    get disabled(): boolean;
-    set disabled(value: boolean | string);
-    private defaultHidden;
-    /**
-     * Whether is hidden. If it is a string, it is a Pixi'VN flag name.
-     */
-    get hidden(): boolean;
-    set hidden(value: boolean | string);
-    private _renderIcon?;
-    /**
-     * The function for rendering the icon of the room.
-     */
-    get renderIcon(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    /**
-     * Get the character commitments of the room.
-     * @returns The character commitments of the room.
-     */
-    getRoutine<TCommitment extends CommitmentBaseModel = CommitmentBaseModel>(): TCommitment[];
-}
-
-/**
- * The base model of a commitment. I suggest you extend this class to create your own commitment model.
- * You must use the saveRoom function to save the commitment in the registered commitments.
- * @example
- * ```ts
- * export const mcRoom = new CommitmentBaseModel("test", character, room, {
- *     name: "Test",
- *     image: "https://image.jpg",
- *     executionType: ExecutionTypeEnum.INTERACTION,
- *     onRun: (commitment) => {
- *         // Do something
- *     }
- * })
- * saveCommitment(mcRoom)
- * ```
- */
-declare class CommitmentBaseModel<TCharacter extends CharacterInterface = CharacterInterface, TRoom extends RoomBaseModel = RoomBaseModel> extends StoredClassModel {
-    /**
-     * @param id The id of the commitment, it must be unique.
-     * @param character The character or characters that are in the commitment and so in the room.
-     * @param room The room where the commitment is.
-     * @param props The properties of the commitment.
-     */
-    constructor(id: string, character: TCharacter | TCharacter[] | undefined, room: TRoom, props: CommitmentProps<TCharacter, TRoom>);
-    private _characters;
-    /**
-     * The character or characters that are in the commitment and so in the room.
-     */
-    get characters(): TCharacter[];
-    private _room;
-    /**
-     * The room where the commitment is.
-     */
-    get room(): TRoom;
-    private _name;
-    /**
-     * The name
-     */
-    get name(): string;
-    private defaultFromHour?;
-    /**
-     * The hour when the commitment starts. If the commitment is not started yet, it will be hidden.
-     * If you set undefined, it will return the initial value of fromHour.
-     */
-    get fromHour(): number;
-    set fromHour(value: number | undefined);
-    private defaultToHour?;
-    /**
-     * The hour when the commitment ends. If the commitment is ended yet, it will be hidden.
-     * If you set undefined, it will return the initial value of toHour.
-     */
-    get toHour(): number;
-    set toHour(value: number | undefined);
-    private defaultFromDay?;
-    /**
-     * The day when the commitment starts. If the commitment is not started yet, it will be hidden.
-     * If you set undefined, it will return the initial value of fromDay.
-     */
-    get fromDay(): number | undefined;
-    set fromDay(value: number | undefined);
-    private defaultToDay?;
-    /**
-     * The day when the commitment ends. If the commitment is ended yet, it will be deleted or hidden.
-     * If you set undefined, it will return the initial value of toDay.
-     */
-    get toDay(): number | undefined;
-    set toDay(value: number | undefined);
-    private _renderImage?;
-    /**
-     * The function for rendering the image of the room.
-     */
-    get renderImage(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    private _executionType;
-    /**
-     * 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.
-     */
-    get executionType(): ExecutionType;
-    private _renderIcon?;
-    /**
-     * The function for rendering the icon of the commitment.
-     */
-    get renderIcon(): ((props: OnRenderGraphicItemProps) => GraphicItemType) | undefined;
-    private _onRun?;
-    /**
-     * Is a function that is called when the player interacts with the character.
-     */
-    get run(): undefined | ((props: OnRunProps) => void);
-    private defaultDisabled;
-    /**
-     * Whether is disabled. You can also pass a Pixi'VN flag name.
-     */
-    get disabled(): boolean;
-    set disabled(value: boolean | string);
-    private defaultHidden;
-    /**
-     * Whether is hidden. You can also pass a Pixi'VN flag name.
-     */
-    get hidden(): boolean;
-    set hidden(value: boolean | string);
-    private defaultPriority;
-    /**
-     * 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(): number;
-    set priority(value: number);
-    /**
-     * Whether the commitment is expired.
-     * @returns Whether the commitment is expired.
-     */
-    isExpired(): boolean;
-}
-
-export { ActivityRoom as A, type CommitmentProps as C, type LocationProps as L, type MapProps as M, type RoomProps as R, CommitmentBaseModel as a, LocationBaseModel as b, MapBaseModel as c, RoomBaseModel as d, ROOM_CATEGORY as e };