@wayward/types 2.14.0 → 2.14.1-beta.dev.20241215.1

package/definitions/game/game/entity/creature/zone/zones/iceCap/IceCapTileReplacements.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeTileReplacements;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/volcanic/VolcanicCreatures.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeCreatureZoneTiers;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/volcanic/VolcanicDoodadReplacements.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeDoodadReplacements;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/volcanic/VolcanicGuardians.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeGuardianZoneTiers;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/volcanic/VolcanicTileReplacements.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeTileReplacements;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/wetlands/WetlandsCreatures.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeCreatureZoneTiers;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/wetlands/WetlandsDoodadReplacements.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeDoodadReplacements;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/wetlands/WetlandsGuardians.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeGuardianZoneTiers;
+export default _default;

package/definitions/game/game/entity/creature/zone/zones/wetlands/WetlandsTileReplacements.d.ts

@@ -0,0 +1,12 @@
+/*!
+ * Copyright 2011-2024 Unlok
+ * https://www.unlok.ca
+ *
+ * Credits & Thanks:
+ * https://www.unlok.ca/credits-thanks/
+ *
+ * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
+ * https://github.com/WaywardGame/types/wiki
+ */
+declare const _default: import("@wayward/game/game/entity/creature/zone/ICreatureZone").IBiomeTileReplacements;
+export default _default;

package/definitions/game/game/entity/flowfield/FlowFieldManager.d.ts

@@ -22,7 +22,7 @@ interface IFlowFieldHuman {
 export default class FlowFieldManager {
     private readonly island;
     private readonly size;
-    flowFields: Map<"-1-0" | "-1-1" | "-1-2" | "-1-4" | "-1-8" | "-1-16" | "-1-32" | "-1-64" | "-1-128" | "-1-256" | "-1-512" | "-1-1024" | "-1-2048" | "-1-15" | "0-0" | "0-1" | "0-2" | "0-4" | "0-8" | "0-16" | "0-32" | "0-64" | "0-128" | "0-256" | "0-512" | "0-1024" | "0-2048" | "0-15" | "1-0" | "1-1" | "1-2" | "1-4" | "1-8" | "1-16" | "1-32" | "1-64" | "1-128" | "1-256" | "1-512" | "1-1024" | "1-2048" | "1-15", FlowField>;
+    flowFields: Map<"-1-0" | "-1-1" | "-1-2" | "-1-4" | "-1-8" | "-1-16" | "-1-32" | "-1-64" | "-1-128" | "-1-256" | "-1-512" | "-1-1024" | "-1-2048" | "-1-4096" | "-1-15" | "0-0" | "0-1" | "0-2" | "0-4" | "0-8" | "0-16" | "0-32" | "0-64" | "0-128" | "0-256" | "0-512" | "0-1024" | "0-2048" | "0-4096" | "0-15" | "1-0" | "1-1" | "1-2" | "1-4" | "1-8" | "1-16" | "1-32" | "1-64" | "1-128" | "1-256" | "1-512" | "1-1024" | "1-2048" | "1-4096" | "1-15", FlowField>;
     humans: IFlowFieldHuman[];
     private _flowFieldHumans;
     constructor(island: Island, size: number);

package/definitions/game/game/entity/player/IPlayer.d.ts

@@ -120,13 +120,12 @@ export interface IPlayerEvents extends Events<Human> {
 }
 export declare enum TurnTypeFlag {
     CheckUnderPlayer = 1,
-    DontEnterCaves = 2,
-    Idle = 4,
+    Idle = 2,
     /**
      * Indicates the turn is passing due to a movement
      */
-    Movement = 8,
-    DontTickAnim = 16
+    Movement = 4,
+    DontTickAnim = 8
 }
 export interface IAttackHand {
     mainHand: number;

package/definitions/game/game/entity/player/quest/quest/Quest.d.ts

@@ -67,4 +67,5 @@ export declare class RequirementInstance extends EventEmitter.Host<IQuestRequire
     getCompletionAmount(): number;
     getRelations(): HighlightSelector[];
     setVisible(): this;
+    private get description();
 }

package/definitions/game/game/entity/status/IStatus.d.ts

@@ -39,6 +39,9 @@ export interface IStatusDescription {
     highlight?: SupplierOr<IHighlight | undefined, [IStatusContext]>;
     icon?: SupplierOr<IStatusIconDescription | undefined, [IStatusContext]>;
     particles?: SupplierOr<StatusParticle | undefined, [IStatusContext, StatusParticleEvent?]>;
+    /** A list of `StatusRenderer`s that could be returned by a supplier in the `renderer` property */
+    renderers?: StatusRenderer[];
+    /** Note that if you use a supplier, the renderer *must* also be in the `renderers` property so that it can be correctly preloaded */
     renderer?: SupplierOr<StatusRenderer | undefined, [IStatusContext]>;
     /** This function is not used automatically by Status, and must be implemented via a custom `onTick` handler */
     getDamageRange?(status: IStatusContext): IRange | undefined;

package/definitions/game/game/inspection/InfoProvider.d.ts

@@ -76,6 +76,7 @@ export interface ISerializedIcon extends IIcon {
     path: string | ISerializedImagePath;
 }
 export declare abstract class InfoProvider extends EventEmitter.Host<IInfoProviderEvents> implements IRefreshable {
+    private static bus?;
     static multiTextParagraph: string;
     static create(...translations: TranslationGenerator[]): SimpleInfoProvider;
     static dynamic<T>(observer: BaseObserver<T>, supplier: (value: T) => InfoProvider | undefined): SimpleInfoProvider;
@@ -106,6 +107,7 @@ export declare abstract class InfoProvider extends EventEmitter.Host<IInfoProvid
     hasContent(_context: InfoProviderContext): boolean;
     init(): void;
     readonly subscribeRefreshOn: BaseObserver.IRegistrar<this>;
+    private dirty;
     /**
      * Call when this info provider should be refreshed.
      */
@@ -123,6 +125,7 @@ export declare abstract class InfoProvider extends EventEmitter.Host<IInfoProvid
      */
     remove(): this;
     onStoppingPlay(): void;
+    onPreMoveToIsland(): void;
     private _shouldDisplayWhenEmpty;
     protected shouldDisplayWhenEmpty(): boolean;
     setShouldDisplayWhenEmpty(shouldDisplayWhenEmpty?: boolean): this;

package/definitions/game/game/inspection/Inspection.d.ts

@@ -31,6 +31,7 @@ export declare enum InspectionClasses {
     $Subtitle = "subtitle",
     ColorContext = "inspection-color-context",
     $ColorContext = "color-context",
+    $ColorContext_Optional = "color-context--optional",
     Icon = "inspection-icon",
     $Icon = "icon"
 }

package/definitions/game/game/inspection/infoProviders/item/use/ItemConsumeInfo.d.ts

@@ -9,14 +9,13 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
-import { SkillType } from "@wayward/game/game/entity/IHuman";
 import type { Stat } from "@wayward/game/game/entity/IStats";
 import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
 import type Tooltip from "@wayward/game/ui/tooltip/Tooltip";
 declare const _default: UseInfo<{
     onConsume: [Stat, number][];
-    skill: SkillType;
+    skill: import("../../../../entity/IHuman").SkillType | undefined;
     entityType: import("../../../../entity/IEntity").EntityType.Item;
     value?: Item | undefined;
     type: import("@wayward/game/game/item/IItem").ItemType;

package/definitions/game/game/inspection/infoProviders/item/use/ItemEquipInfo.d.ts

@@ -9,7 +9,6 @@
  * https://github.com/WaywardGame/types/wiki
  */
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
-import LabelledValue from "@wayward/game/game/inspection/infoProviders/LabelledValue";
 import UseInfo from "@wayward/game/game/inspection/infoProviders/UseInfo";
 import type Item from "@wayward/game/game/item/Item";
 import { MagicalPropertyEntry } from "@wayward/game/game/magic/MagicalPropertyManager";
@@ -37,16 +36,14 @@ declare const _default: UseInfo<{
 } & {
     getAttack: () => import("@wayward/game/game/inspection/InfoProvider").SimpleInfoProvider | undefined;
 } & {
-    getDefense: () => (import("../../../../../language/impl/TranslationImpl").default | import("@wayward/game/game/inspection/InfoProvider").SimpleInfoProvider)[];
+    getDefense: () => import("../../../../../language/impl/TranslationImpl").default[];
 } & {
-    formatInsulation: (insulation?: number | undefined, type?: TempType | undefined) => LabelledValue;
+    formatInsulation: (insulation?: number | undefined, type?: TempType | undefined) => import("../../../../../language/impl/TranslationImpl").default;
 } & {
-    getInsulationOfType: (type: TempType) => LabelledValue | undefined;
+    getInsulation: () => (import("../../../../../language/impl/TranslationImpl").default | undefined)[];
 } & {
-    getInsulation: () => (LabelledValue | undefined)[];
+    getMagicEffect: (magic: MagicalPropertyEntry) => import("../../../../../language/impl/TranslationImpl").default;
 } & {
-    getMagicEffect: (magic: MagicalPropertyEntry) => LabelledValue;
-} & {
-    getMagic: () => LabelledValue[];
+    getMagic: () => import("../../../../../language/impl/TranslationImpl").default[];
 }, Item>;
 export default _default;

package/definitions/game/game/island/IIsland.d.ts

@@ -225,7 +225,7 @@ export interface IIslandTickOptions {
     ticks: number;
     tickFlags?: TickFlag;
     playingHumans?: Human[];
-    dueToAction?: boolean;
+    dueToAction?: Human;
 }
 export interface IIslandTickAsyncOptions extends IIslandTickOptions {
     onProgress?: (progess: number) => Promise<void>;

package/definitions/game/game/island/Island.d.ts

@@ -113,7 +113,7 @@ export default class Island extends EventEmitter.Host<IIslandEvents> implements
     /**
      * Entity move types in fov on this island
      */
-    readonly moveTypesInFov: Map<"-1-0" | "-1-1" | "-1-2" | "-1-4" | "-1-8" | "-1-16" | "-1-32" | "-1-64" | "-1-128" | "-1-256" | "-1-512" | "-1-1024" | "-1-2048" | "-1-15" | "0-0" | "0-1" | "0-2" | "0-4" | "0-8" | "0-16" | "0-32" | "0-64" | "0-128" | "0-256" | "0-512" | "0-1024" | "0-2048" | "0-15" | "1-0" | "1-1" | "1-2" | "1-4" | "1-8" | "1-16" | "1-32" | "1-64" | "1-128" | "1-256" | "1-512" | "1-1024" | "1-2048" | "1-15", Set<Human<unknown, number, import("@wayward/game/game/reference/IReferenceManager").ReferenceType.NPC | import("@wayward/game/game/reference/IReferenceManager").ReferenceType.Player>>>;
+    readonly moveTypesInFov: Map<"-1-0" | "-1-1" | "-1-2" | "-1-4" | "-1-8" | "-1-16" | "-1-32" | "-1-64" | "-1-128" | "-1-256" | "-1-512" | "-1-1024" | "-1-2048" | "-1-4096" | "-1-15" | "0-0" | "0-1" | "0-2" | "0-4" | "0-8" | "0-16" | "0-32" | "0-64" | "0-128" | "0-256" | "0-512" | "0-1024" | "0-2048" | "0-4096" | "0-15" | "1-0" | "1-1" | "1-2" | "1-4" | "1-8" | "1-16" | "1-32" | "1-64" | "1-128" | "1-256" | "1-512" | "1-1024" | "1-2048" | "1-4096" | "1-15", Set<Human<unknown, number, import("@wayward/game/game/reference/IReferenceManager").ReferenceType.NPC | import("@wayward/game/game/reference/IReferenceManager").ReferenceType.Player>>>;
     /**
      * Helps instruct when to tick when in simulated turn mode
      */

package/definitions/game/game/island/automation/Automation.d.ts

@@ -10,16 +10,25 @@
  */
 import type Human from "@wayward/game/game/entity/Human";
 import type { AutomationStep } from "@wayward/game/game/island/automation/AutomationStep";
-import type { IAutomationInitialState } from "@wayward/game/game/island/automation/IAutomation";
+import type { IAutomationSetup, IAutomationSetupResult } from "@wayward/game/game/island/automation/IAutomation";
 export declare class Automation {
     private running;
     private repeat;
     private repeatDelay;
-    private initialState;
+    private setup;
+    private startDelay;
     private readonly steps;
     private readonly resetSteps;
+    /**
+     * Applys the setup to the player.
+     * Called during automation & tests.
+     * @param human Human to apply the setup too
+     * @param setup The setup
+     */
+    static applySetup(human: Human, setup: Readonly<IAutomationSetup>): IAutomationSetupResult;
     setRepeat(repeat: boolean, delay?: number): this;
-    setInitialState(initialState: IAutomationInitialState): this;
+    setStartDelay(delay: number): this;
+    setSetup(setup: IAutomationSetup): this;
     addStep(step: AutomationStep): this;
     start(human: Human): Promise<void>;
     stop(): void;

package/definitions/game/game/island/automation/AutomationStep.d.ts

@@ -11,4 +11,5 @@
 import type { IAutomationContextState } from "@wayward/game/game/island/automation/IAutomation";
 export declare abstract class AutomationStep {
     abstract execute(context: IAutomationContextState): Promise<void>;
+    protected waitForNoDelay(context: IAutomationContextState): Promise<void>;
 }

package/definitions/game/game/island/automation/IAutomation.d.ts

@@ -8,17 +8,23 @@
  * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
  * https://github.com/WaywardGame/types/wiki
  */
+import type { DoodadType, GrowingStage } from "@wayward/game/game/doodad/IDoodad";
+import type { ActionType } from "@wayward/game/game/entity/action/IAction";
+import type { CreatureType } from "@wayward/game/game/entity/creature/ICreature";
 import type Human from "@wayward/game/game/entity/Human";
+import type { EquipType } from "@wayward/game/game/entity/IHuman";
+import type { StatusType } from "@wayward/game/game/entity/status/IStatus";
+import type { Quality } from "@wayward/game/game/IObject";
 import type { IslandId } from "@wayward/game/game/island/IIsland";
-import type { ItemType, ItemTypeGroup } from "@wayward/game/game/item/IItem";
+import type { ContainerSort, ItemType, ItemTypeGroup } from "@wayward/game/game/item/IItem";
 import type Item from "@wayward/game/game/item/Item";
-export interface IAutomationInitialState {
-    items?: Array<ItemType | ItemTypeGroup>;
-    /**
-     * Delay before executing steps
-     */
-    delay?: number;
-}
+import type { TerrainType } from "@wayward/game/game/tile/ITerrain";
+import type { IOptions } from "@wayward/game/save/data/ISaveDataGlobal";
+import type { SortDirection } from "@wayward/game/save/ISaveManager";
+import type { DialogId } from "@wayward/game/ui/screen/screens/game/Dialogs";
+import type { Direction } from "@wayward/game/utilities/math/Direction";
+import type { IVector3 } from "@wayward/game/utilities/math/IVector";
+import type WorldZ from "@wayward/utilities/game/WorldZ";
 export interface IAutomationContextState {
     human: Human;
     islandId: IslandId;
@@ -27,3 +33,92 @@ export interface IAutomationContextState {
      */
     items: Item[];
 }
+export interface IAutomationSetup {
+    options?: Partial<IOptions>;
+    ui?: IAutomationSetupUi;
+    world?: IAutomationSetupWorld;
+    player?: IAutomationSetupPlayer;
+}
+export interface IAutomationSetupResult {
+    player?: {
+        items?: Item[];
+    };
+}
+export interface IAutomationSetupUi {
+    dialogs?: PartialRecord<DialogId, boolean>;
+    actionSlots?: Array<{
+        itemType?: ItemType;
+        actionType?: ActionType;
+        autoUse?: boolean;
+    }>;
+}
+export interface IAutomationSetupWorld {
+    /**
+     * The world resets by default (entities are cleared)
+     * Set to true to disable that.
+     */
+    disableReset?: true;
+    /**
+     * When set, all tiles will be set to this terrain type
+     */
+    defaultTerrain?: TerrainType;
+    tiles?: Array<{
+        type?: TerrainType;
+        /**
+         * Offset from the humans position
+         */
+        x?: number;
+        /**
+         * Offset from the humans position
+         */
+        y?: number;
+        z?: WorldZ;
+        items?: IAutomationSetupItem[];
+        tilled?: boolean;
+        fishAvailable?: number;
+    }>;
+    doodads?: Array<{
+        type: DoodadType;
+        growingStage?: GrowingStage;
+        decay?: number;
+        x?: number;
+        y?: number;
+        z?: number;
+        inventory?: IAutomationSetupItemContainer;
+    }>;
+    creatures?: Array<{
+        type: CreatureType;
+        x?: number;
+        y?: number;
+        z?: number;
+        tamed?: true;
+        /** Defaults to a massive number */
+        happiness?: number;
+        aberrant?: true;
+    }>;
+    corpses?: Array<{
+        type: CreatureType;
+        x?: number;
+        y?: number;
+        z?: number;
+        aberrant?: true;
+    }>;
+}
+export interface IAutomationSetupPlayer {
+    alwaysPassSkillChecks?: boolean;
+    position?: Partial<IVector3>;
+    direction?: Direction.Cardinal;
+    inventory?: IAutomationSetupItemContainer;
+    status?: StatusType[];
+}
+export interface IAutomationSetupItemContainer {
+    sort?: ContainerSort;
+    sortDirection?: SortDirection;
+    stacks?: ItemType[];
+    items?: IAutomationSetupItem[];
+}
+export interface IAutomationSetupItem {
+    type: ItemType | ItemTypeGroup;
+    equip?: EquipType;
+    quality?: Quality;
+}

package/definitions/game/game/island/automation/steps/ExecuteAction.d.ts

@@ -8,7 +8,7 @@
  * Wayward is a copyrighted and licensed work. Modification and/or distribution of any source files is prohibited. If you wish to modify the game in any way, please refer to the modding guide:
  * https://github.com/WaywardGame/types/wiki
  */
-import type { ActionArgumentsOf, AnyActionDescription } from "@wayward/game/game/entity/action/IAction";
+import { type ActionArgumentsOf, type AnyActionDescription } from "@wayward/game/game/entity/action/IAction";
 import { AutomationStep } from "@wayward/game/game/island/automation/AutomationStep";
 import type { IAutomationContextState } from "@wayward/game/game/island/automation/IAutomation";
 export type GetActionArguments<T extends AnyActionDescription, AV = ActionArgumentsOf<T>> = AV | ((context: IAutomationContextState) => Promise<AV>);

package/definitions/game/game/item/IItem.d.ts

@@ -17,7 +17,8 @@ import type { RuneChance } from "@wayward/game/game/deity/IDeities";
 import type { DoodadType, DoodadTypeGroup } from "@wayward/game/game/doodad/IDoodad";
 import type Human from "@wayward/game/game/entity/Human";
 import type { DamageType, Defense, EntityType, ICastable, MoveType } from "@wayward/game/game/entity/IEntity";
-import { SkillType, type Delay, type EquipType } from "@wayward/game/game/entity/IHuman";
+import type { SkillType } from "@wayward/game/game/entity/IHuman";
+import { type Delay, type EquipType } from "@wayward/game/game/entity/IHuman";
 import { Stat } from "@wayward/game/game/entity/IStats";
 import type { IActionApi } from "@wayward/game/game/entity/action/IAction";
 import { ActionType } from "@wayward/game/game/entity/action/IAction";
@@ -42,6 +43,7 @@ import type Message from "@wayward/game/language/dictionary/Message";
 import type { IModdable } from "@wayward/game/mod/ModRegistry";
 import type { ItemNotifierType } from "@wayward/game/renderer/notifier/INotifier";
 import type { SortDirection } from "@wayward/game/save/ISaveManager";
+import type { DialogId } from "@wayward/game/ui/screen/screens/game/Dialogs";
 import type { IVector3 } from "@wayward/game/utilities/math/IVector";
 import type Vector2 from "@wayward/game/utilities/math/Vector2";
 import type { IRGB } from "@wayward/utilities/Color";
@@ -193,6 +195,7 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
     use?: ActionType[];
     ranged?: IRangedDescription;
     recipe?: IRecipe;
+    containerDialog?: DialogId;
     /**
      * A list of groups the item should belong too.
      */
@@ -335,9 +338,15 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
      */
     magicInert?: true;
     /**
-     * Whether magical enhancement should be disabled
+     * A list of ActionTypes that should be disabled on this item.
+     * Note that support for this property must be added to each action's `canUse` individually. See the usage in `Enhance.ts`.
      */
-    noEnhance?: true;
+    disabledActions?: ActionType[];
+    /**
+     * A list of ActionTypes that should not gain skill according to the item's associated skill.
+     * Note that support for this property must be added to each action's `canUse` individually. See the usage in `Refine.ts`.
+     */
+    disabledActionSkillGain?: ActionType[];
     /**
      * The item name to display instead of the item's default translation
      */
@@ -377,6 +386,14 @@ export interface IItemDescription extends IObjectDescription, IModdable, ITemper
      * When this item (or as a doodad) is melted, item types that match in this array against the disassembly object will be left behind.
      */
     dropDissassemblyItemsOnMelt?: Array<ItemType | ItemTypeGroup>;
+    /**
+     * When set to true, the item will provide no consumption bonuses when used based on its quality
+     */
+    qualityProvidesNoConsumeBonus?: boolean;
+}
+export declare namespace IItemDescription {
+    function actionDisabled(description: IItemDescription | undefined, action: ActionType): boolean;
+    function actionSkillGainDisabled(description: IItemDescription | undefined, action: ActionType): boolean;
 }
 export interface IConsumeItemStat {
     stat: Stat;
@@ -774,6 +791,9 @@ export interface INPCInventoryContainerReference extends IBaseContainerReference
     id: number;
 }
 export type ContainerReference = IInvalidContainerReference | IWorldContainerReference | IPlayerInventoryContainerReference | ITileContainerReference | IDoodadContainerReference | IItemContainerReference | INPCInventoryContainerReference;
+export declare namespace ContainerReference {
+    function equals(a?: ContainerReference, b?: ContainerReference): boolean;
+}
 export declare enum CraftResult {
     Fail = 0,
     Success = 1,
@@ -1682,7 +1702,8 @@ export type DisplayableItemType = ItemType | ItemTypeExtra;
 export declare enum ItemTag {
     None = 0,
     ShipperBoat = 1,
-    Rune = 2
+    Rune = 2,
+    VersatileApplied = 3
 }
 export declare enum ItemTypeGroup {
     Invalid = -9999,

package/definitions/game/game/item/IItemManager.d.ts

@@ -65,13 +65,13 @@ export interface IGetItemOptions {
      */
     filterText?: string;
 }
-export interface IGetItemsOptions extends IGetItemOptions {
+export interface IGetItemsOptions extends Pick<IGetItemOptions, "excludeProtectedItems" | "includeProtectedItemsThatWillNotBreak"> {
     /**
      * Include sub containers in the search
      */
     includeSubContainers: true;
 }
-export interface IGetBestItemsOptions extends IGetItemsOptions {
+export interface IGetBestItemsOptions extends IGetItemOptions, IGetItemsOptions {
     action: ActionType;
     actionWith: Item | (() => Item | undefined);
     sort(itemA: Item, itemB: Item, options: Partial<IGetBestItemsOptions>): number | undefined;
@@ -79,6 +79,8 @@ export interface IGetBestItemsOptions extends IGetItemsOptions {
     filterQuality: ArrayOr<Quality>;
     filterGroup: ItemTypeGroup;
     filterConsumable: true;
+    filterContainer: IContainer;
+    filterStacked: boolean;
     targetCreature: Creature;
     filter(item: Item): any;
 }
@@ -135,6 +137,7 @@ export interface IMoveItemOptions {
     isTrading?: boolean;
     revertFromDoodad?: boolean;
     skipDrop?: true;
+    skipClearSort?: true;
     context?: ActionContext;
 }
 export interface IPlaceOnTileOptions {
@@ -159,7 +162,8 @@ export declare enum ContainerReferenceSource {
     WriteContainer = 12,
     GetContainerName = 13,
     Upgrade = 14,
-    MoveItemOfTypeArgument = 15
+    MoveItemOfTypeArgument = 15,
+    ActionBarUsingContainer = 16
 }
 export interface ICraftResultChances {
     success: number;

package/definitions/game/game/item/Item.d.ts

@@ -159,6 +159,7 @@ export default class Item extends EntityMovable<IItemDescription, ItemType, Refe
     set durabilityMax(value: number);
     getDisplayItem(): DisplayableItemType;
     isContainer(): this is Item & IContainer;
+    isWithin(container?: IContainer): boolean;
     get builtDescription(): IDoodadDescription | undefined;
     countTradesWith(human?: Human): number;
     /**

package/definitions/game/game/item/ItemFinder.d.ts

@@ -36,6 +36,7 @@ declare class ItemFinder extends EventEmitter.Host<IItemFinderEvents> {
     private trackedItems?;
     private foundItemIds?;
     private foundItemBest?;
+    private disposed?;
     get human(): Human | undefined;
     get container(): IContainer | undefined;
     readonly observe: Observer.IRegistrar<this>;

package/definitions/game/game/item/ItemManager.d.ts

@@ -162,7 +162,7 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
      * @returns Tile or undefined
      */
     getTile(itemOrContainer?: Item | IContainer): Tile | undefined;
-    resolveContainer(container?: IContainer): Tile | Player | Item | Doodad | NPC | IContainer | undefined;
+    resolveContainer(container?: IContainer | ContainerReference): Tile | Player | Item | Doodad | NPC | IContainer | undefined;
     getContainerReference(containable: IContainable | undefined, source: ContainerReferenceSource | undefined): ContainerReference;
     derefenceContainerReference(containerReference: ContainerReference, showWarnings?: boolean): IContainable | undefined;
     hashContainer(containable: IContainable, containerReferenceSource?: ContainerReferenceSource): string;
@@ -195,12 +195,12 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
      * @param options Item move options
      * @returns Result that tells you what moved
      */
-    moveItemsToContainer(human: Human | undefined, items: Item[], toContainer: IContainer, options?: IMoveItemOptions): IAddToContainerResult;
+    moveItemsToContainer(human: Human | undefined, items: readonly Item[], toContainer: IContainer, options?: IMoveItemOptions): IAddToContainerResult;
     setStacked(human: Human, container: IContainer, itemType: ItemType, stacked?: boolean, atIndex?: number): void;
     ensureContainerSorted(container?: IContainer, sorter?: ISorter<Item | undefined> | undefined): boolean;
     private ensureStacksStacked;
     createSorter(container?: IContainer): ISorter<Item | undefined> | undefined;
-    tryMoveItemsToContainer(human: Human | undefined, items: Item[], toContainer: IContainer, options?: IMoveItemOptions): IAddToContainerResult | IActionNotUsable;
+    tryMoveItemsToContainer(human: Human | undefined, items: readonly Item[], toContainer: IContainer, options?: IMoveItemOptions): IAddToContainerResult | IActionNotUsable;
     /**
      * Return `number` to insert the item at a specific index. Return `undefined` to push the item to the end.
      * Defaults to `0` or `undefined` if sort is `ContainerSort.Recent`, or polling the sorting algorithm otherwise
@@ -241,7 +241,7 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
      * Drop items in a 3x3 square around the location.
      * This will ensure all items in the container are removed
      */
-    placeItemsAroundTile(container: IContainer, tile: Tile, skipMessage?: boolean): void;
+    placeItemsAroundTile(container: IContainer, tile: Tile, skipMessage?: boolean, skipCurrentTile?: boolean): void;
     /**
      * Returns the "processed" weight of the given item.
      * - If the item is a "raw" item — ie, it was not created from other items, this is the `weightFraction` lerping the item's min & max weight.
@@ -341,9 +341,9 @@ export default class ItemManager extends EntityManager<Item, IItemRemoveOptions>
     isTileContainer(container: IContainable | undefined): container is Tile & ITileContainer;
     /**
      * Returns ordered items for the containers
-     * Note: It ~~may~~ (will always) return the real containedItems array!
+     * Note: If not filtered, it will return the real containedItems array!
      */
-    getOrderedContainerItems(container: IUncastableContainer, options?: Partial<IGetItemOptions>): Item[];
+    getOrderedContainerItems(container: IUncastableContainer, options?: Partial<IGetItemsOptions>): readonly Item[];
     capWeightOfItems(createdItems: Item[], itemWeight: number): void;
     getItemTypeTranslation(itemType: ItemType | ItemTypeGroup): Translation;
     getItemTypeTranslation(itemType: ItemType | ItemTypeGroup, count: number): Translation;