farming-weight 0.10.8 → 0.11.0

package/dist/player/player.d.ts

@@ -1,5 +1,6 @@
 import { Crop } from '../constants/crops.js';
-import { type FortuneUpgrade } from '../constants/upgrades.js';
+import { Stat } from '../constants/stats.js';
+import { type FortuneUpgrade, type UpgradeTreeNode } from '../constants/upgrades.js';
 import { FarmingAccessory } from '../fortune/farmingaccessory.js';
 import { ArmorSet, FarmingArmor } from '../fortune/farmingarmor.js';
 import { FarmingEquipment } from '../fortune/farmingequipment.js';
@@ -27,24 +28,64 @@ export declare class FarmingPlayer {
     selectedPet?: FarmingPet;
     get attributes(): Record<string, number>;
     constructor(options: PlayerOptions);
+    setOptions(options: PlayerOptions): void;
+    populatePets(): void;
+    populateTools(): void;
+    populateArmor(): void;
+    populateEquipment(): void;
+    populateActiveAccessories(): void;
     changeArmor(armor: FarmingArmor[]): void;
     selectTool(tool: FarmingTool): void;
     selectPet(pet: FarmingPet): void;
     setStrength(strength: number): void;
-    getProgress(): import("../constants/upgrades.js").FortuneSourceProgress[];
-    getUpgrades(): FortuneUpgrade[];
+    getProgress(stats?: Stat[]): import("../constants/upgrades.js").FortuneSourceProgress[];
+    getUpgrades(options?: {
+        stat?: Stat;
+    }): FortuneUpgrade[];
     getCropUpgrades(crop?: Crop, tool?: FarmingTool): FortuneUpgrade[];
     getGeneralFortune(): number;
+    getStat(stat: Stat): number;
+    getStatBreakdown(stat: Stat): {
+        value: number;
+        breakdown: Record<string, number>;
+    };
     getTempFortune(): number;
     getCropFortune(crop: Crop, tool?: FarmingTool | undefined): {
         fortune: number;
         breakdown: Record<string, number>;
     };
-    getCropProgress(crop: Crop): import("../constants/upgrades.js").FortuneSourceProgress[];
+    getCropProgress(crop: Crop, stats?: Stat[]): import("../constants/upgrades.js").FortuneSourceProgress[];
     getRates(crop: Crop, blocksBroken: number): ReturnType<typeof calculateDetailedDrops>;
     getWeightCalc(info?: FarmingWeightInfo): ReturnType<typeof createFarmingWeightCalculator>;
     getBestTool(crop: Crop): FarmingTool | undefined;
     getSelectedCropTool(crop: Crop): FarmingTool | undefined;
+    applyUpgrade(upgrade: FortuneUpgrade): void;
+    /**
+     * Creates a deep clone of this FarmingPlayer that can be modified without affecting the original.
+     */
+    clone(): FarmingPlayer;
+    /**
+     * Expands an upgrade into a tree of follow-up upgrades.
+     * This applies the upgrade on a cloned player and recursively finds upgrades
+     * for the same target item.
+     *
+     * @param upgrade - The upgrade to expand
+     * @param options.maxDepth - Maximum recursion depth (default: 10)
+     * @param options.crop - Crop for crop-specific fortune calculations
+     * @param options.stats - Stats to track (default: [Stat.FarmingFortune])
+     * @param options.includeAllTierUpgradeChildren - If true, first-level children of tier upgrades include ALL available upgrades for the new item (default: false)
+     */
+    expandUpgrade(upgrade: FortuneUpgrade, options?: {
+        maxDepth?: number;
+        crop?: Crop;
+        stats?: Stat[];
+        includeAllTierUpgradeChildren?: boolean;
+    }): UpgradeTreeNode;
+    private buildUpgradeTree;
+    private getAllStats;
+    private computeStatsDiff;
+    private getUpgradeKey;
+    private getFollowUpUpgrades;
 }
 export interface JacobFarmingContest {
     crop: Crop;