farming-weight 0.14.3 → 0.15.0

package/dist/effects/resolver.js

@@ -0,0 +1,239 @@
+import { isGlobalOverbloomScope, matchesScopeForDrop, matchesScopeForStat } from './matcher.js';
+import { DEFAULT_PHASE_FOR_OP, } from './types.js';
+/** Resolve an effect's phase, defaulting from its op when omitted. */
+export function effectPhase(effect) {
+    return effect.phase ?? DEFAULT_PHASE_FOR_OP[effect.op];
+}
+/** Resolve the numeric `value` of an effect at a given context. */
+function resolveValue(effect, ctx) {
+    const { value } = effect;
+    if (typeof value === 'function')
+        return value(ctx);
+    return typeof value === 'number' ? value : 0;
+}
+/**
+ * Throw if a multiplicative effect carries an invalid value. Catches the
+ * Cropeetle/Deep-Fried delta-vs-factor mismatch class of bugs at the source.
+ */
+export function assertValidEffect(effect) {
+    if (effect.op === 'mul-rare' || effect.op === 'mul-drop') {
+        const v = effect.value;
+        const numeric = typeof v === 'number' ? v : null;
+        if (numeric !== null && numeric < 0) {
+            throw new Error(`Invalid ${effect.op} effect from "${effect.source}": value must be >= 0 (got ${numeric}). ` +
+                'Multiplicative ops carry a factor (1.2 = x1.2), not a delta.');
+        }
+    }
+    if (effect.op === 'add-stat' && !effect.stat) {
+        throw new Error(`Invalid add-stat effect from "${effect.source}": missing 'stat' field.`);
+    }
+    if (effect.op === 'add-drop' && !effect.drop) {
+        throw new Error(`Invalid add-drop effect from "${effect.source}": missing 'drop' field.`);
+    }
+}
+/**
+ * Sum `add-stat` effects matching a stat query and a `StatContext`.
+ *
+ * Drop-only scoped effects are rejected by the matcher.
+ */
+export function resolveStatTotal(effects, stat, ctx) {
+    let total = 0;
+    for (const effect of effects) {
+        if (effect.op !== 'add-stat')
+            continue;
+        if (effect.stat !== stat)
+            continue;
+        if (!matchesScopeForStat(effect.scope, ctx))
+            continue;
+        total += resolveValue(effect, ctx);
+    }
+    return total;
+}
+/**
+ * Per-stat breakdown of `add-stat` contributions matching a `StatContext`.
+ * Returns `{ source: amount }` aggregated by source name.
+ */
+export function resolveStatBreakdown(effects, stat, ctx) {
+    const out = {};
+    for (const effect of effects) {
+        if (effect.op !== 'add-stat')
+            continue;
+        if (effect.stat !== stat)
+            continue;
+        if (!matchesScopeForStat(effect.scope, ctx))
+            continue;
+        const v = resolveValue(effect, ctx);
+        if (!v)
+            continue;
+        out[effect.source] = (out[effect.source] ?? 0) + v;
+    }
+    return out;
+}
+/**
+ * Compute the virtual scalar for `Stat.Overbloom`.
+ *
+ * Sums `value` from `add-rare-pct` effects whose `relatedStats` includes
+ * `Stat.Overbloom` and whose scope is global Overbloom-shaped. Scoped Overbloom-
+ * flavored effects are excluded by design - see the architecture plan.
+ */
+export function resolveOverbloomScalar(effects, ctx, overbloomStat) {
+    let total = 0;
+    for (const effect of effects) {
+        if (effect.op !== 'add-rare-pct')
+            continue;
+        if (!effect.relatedStats?.includes(overbloomStat))
+            continue;
+        if (!isGlobalOverbloomScope(effect.scope))
+            continue;
+        // Env-level requirements still apply to the scalar (e.g. Harvest Feast-only flat Overbloom would only
+        // contribute when the feast is active). `requiresInSeason` requires a crop in the StatContext.
+        if (effect.scope?.requiresHarvestFeast && !ctx.env.harvestFeast)
+            continue;
+        if (effect.scope?.requiresInSeason && (!ctx.crop || !ctx.env.inSeason))
+            continue;
+        total += resolveValue(effect, ctx);
+    }
+    return total;
+}
+/**
+ * Per-source breakdown of the global Overbloom scalar.
+ */
+export function resolveOverbloomBreakdown(effects, ctx, overbloomStat) {
+    const out = {};
+    for (const effect of effects) {
+        if (effect.op !== 'add-rare-pct')
+            continue;
+        if (!effect.relatedStats?.includes(overbloomStat))
+            continue;
+        if (!isGlobalOverbloomScope(effect.scope))
+            continue;
+        if (effect.scope?.requiresHarvestFeast && !ctx.env.harvestFeast)
+            continue;
+        if (effect.scope?.requiresInSeason && (!ctx.crop || !ctx.env.inSeason))
+            continue;
+        const v = resolveValue(effect, ctx);
+        if (!v)
+            continue;
+        out[effect.source] = (out[effect.source] ?? 0) + v;
+    }
+    return out;
+}
+/**
+ * Collect drops emitted by `add-drop` effects whose env-level scope matches.
+ *
+ * Real per-drop scope filtering (tags, items, etc.) happens later when the
+ * calculator builds a `DropContext` for each candidate.
+ */
+export function produceAddedDrops(effects, env) {
+    const out = [];
+    for (const effect of effects) {
+        if (effect.op !== 'add-drop')
+            continue;
+        if (!effect.drop)
+            continue;
+        const scope = effect.scope;
+        if (scope) {
+            if (scope.crops) {
+                if (!env.crop)
+                    continue;
+                if (!scope.crops.includes(env.crop))
+                    continue;
+            }
+            if (scope.requiresHarvestFeast && !env.harvestFeast)
+                continue;
+            if (scope.requiresInSeason && !env.inSeason)
+                continue;
+        }
+        out.push({ source: effect.source, payload: effect.drop });
+    }
+    return out;
+}
+/**
+ * Resolve `add-rare-pct`, `mul-rare`, and `mul-drop` effects for a single drop.
+ *
+ * The calculator is expected to combine the parts as:
+ *   `final = base * (1 + addRarePct/100) * mulRare * mulDrop`
+ *
+ * `applied` records every effect that touched this drop, with phase and
+ * resolved amount, for breakdown UIs.
+ */
+export function resolveDropEffects(effects, ctx) {
+    let addRarePct = 0;
+    let mulRare = 1;
+    let mulDrop = 1;
+    const applied = [];
+    // Phase: add-rare
+    for (const effect of effects) {
+        if (effect.op !== 'add-rare-pct')
+            continue;
+        if (!matchesScopeForDrop(effect.scope, ctx))
+            continue;
+        const v = resolveValue(effect, ctx);
+        if (!v)
+            continue;
+        addRarePct += v;
+        applied.push({
+            source: effect.source,
+            op: effect.op,
+            phase: 'add-rare',
+            amount: v,
+            relatedStats: effect.relatedStats,
+            scope: effect.scope,
+            description: effect.meta?.description,
+            valueDisplay: effect.meta?.valueDisplay,
+            valueStat: effect.meta?.valueStat,
+        });
+    }
+    // Phase: mul-rare
+    for (const effect of effects) {
+        if (effect.op !== 'mul-rare')
+            continue;
+        if (!matchesScopeForDrop(effect.scope, ctx))
+            continue;
+        const v = resolveValue(effect, ctx);
+        if (v < 0) {
+            throw new Error(`Invalid mul-rare value ${v} from "${effect.source}" (must be >= 0; factor semantics).`);
+        }
+        if (v === 1)
+            continue;
+        mulRare *= v;
+        applied.push({
+            source: effect.source,
+            op: effect.op,
+            phase: 'mul-rare',
+            amount: v,
+            relatedStats: effect.relatedStats,
+            scope: effect.scope,
+            description: effect.meta?.description,
+            valueDisplay: effect.meta?.valueDisplay,
+            valueStat: effect.meta?.valueStat,
+        });
+    }
+    // Phase: mul-drop
+    for (const effect of effects) {
+        if (effect.op !== 'mul-drop')
+            continue;
+        if (!matchesScopeForDrop(effect.scope, ctx))
+            continue;
+        const v = resolveValue(effect, ctx);
+        if (v < 0) {
+            throw new Error(`Invalid mul-drop value ${v} from "${effect.source}" (must be >= 0; factor semantics).`);
+        }
+        if (v === 1)
+            continue;
+        mulDrop *= v;
+        applied.push({
+            source: effect.source,
+            op: effect.op,
+            phase: 'mul-drop',
+            amount: v,
+            relatedStats: effect.relatedStats,
+            scope: effect.scope,
+            description: effect.meta?.description,
+            valueDisplay: effect.meta?.valueDisplay,
+            valueStat: effect.meta?.valueStat,
+        });
+    }
+    return { addRarePct, mulRare, mulDrop, applied };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/effects/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/effects/resolver.ts"],"names":[],"mappings":"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"}

package/dist/effects/summary.d.ts

@@ -0,0 +1,5 @@
+import type { Stat } from '../constants/stats.js';
+import type { EffectSummary } from '../constants/upgrades.js';
+import type { Effect } from './types.js';
+export declare function effectToSummary(effect: Effect): EffectSummary | undefined;
+export declare function effectsToSummaries(effects: readonly Effect[], stats?: readonly Stat[]): EffectSummary[];

package/dist/effects/summary.js

@@ -0,0 +1,21 @@
+export function effectToSummary(effect) {
+    if (!effect.relatedStats || effect.relatedStats.length === 0)
+        return undefined;
+    return {
+        source: effect.source,
+        op: effect.op,
+        description: effect.meta?.description,
+        relatedStats: effect.relatedStats,
+        scope: effect.scope,
+        value: typeof effect.value === 'number' ? effect.value : undefined,
+        valueDisplay: effect.meta?.valueDisplay,
+        valueStat: effect.meta?.valueStat,
+    };
+}
+export function effectsToSummaries(effects, stats) {
+    const summaries = effects.map(effectToSummary).filter((summary) => summary !== undefined);
+    if (!stats || stats.length === 0)
+        return summaries;
+    return summaries.filter((summary) => summary.relatedStats?.some((stat) => stats.includes(stat)));
+}
+//# sourceMappingURL=summary.js.map

package/dist/effects/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/effects/summary.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,eAAe,CAAC,MAAc;IAC7C,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/E,OAAO;QACN,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW;QACrC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAClE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY;QACvC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS;KACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA0B,EAAE,KAAuB;IACrF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IAC1F,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/effects/types.d.ts

@@ -0,0 +1,147 @@
+import type { Crop } from '../constants/crops.js';
+import type { SpecialCrop } from '../constants/specialcrops.js';
+import type { Stat } from '../constants/stats.js';
+/**
+ * Built-in well-known drop tags. Sources can use any string, but built-ins are
+ * the auditable set used by the package's own drop entries and effects.
+ *
+ * - `overbloom`: drop is buffed by Overbloom-class effects (`add-rare-pct` + `mul-rare`).
+ * - `rare-crop`: drop is part of the SkyBlock "Rare Crop" pool conceptually.
+ * - `special-crop`: drop is a Special Crop (Cropie/Squash/Fermento/Helianthus).
+ * - `seasoning`: Harvest Feast Seasoning category.
+ * - `feast`: any Harvest Feast drop (seasoning + per-crop materials).
+ * - `pest`: drop comes from a pest, not a regular crop break.
+ */
+export type DropTagBuiltin = 'overbloom' | 'rare-crop' | 'special-crop' | 'seasoning' | 'feast' | 'pest';
+export type DropTag = DropTagBuiltin | (string & {});
+/**
+ * Minimal player/world environment data needed to collect effects. Constructed
+ * exclusively by `buildEffectEnvironment(player, crop?)`.
+ */
+export interface EffectEnvironment {
+    /** Active crop for the rate calc, if any. `undefined` for crop-agnostic stat queries. */
+    crop?: Crop;
+    /** Harvest Feast active in the world. */
+    harvestFeast: boolean;
+    /** True only when `crop` is provided AND it is in-season under an active Harvest Feast. */
+    inSeason: boolean;
+    /** Player is currently on an infested plot (probability > 0). */
+    infestedPlot: boolean;
+    /** Selected crop from the player's options (used by some shards' force-active rules). */
+    selectedCrop?: Crop;
+}
+/**
+ * Drop kinds carried on every candidate drop. Used by `Scope.dropKinds` and
+ * for resolver phase routing.
+ */
+export type DropKind = 'rare' | 'rng' | 'special-crop' | 'pest' | 'crop';
+/**
+ * Per-drop context built by the resolver during `produce-drops`/`add-rare`/etc.
+ * Sources never construct one of these directly.
+ */
+export interface DropContext {
+    env: EffectEnvironment;
+    crop: Crop;
+    dropKind: DropKind;
+    /** Item id of the drop being evaluated, e.g. `'CROPIE'`, `'SEASONING'`, `'WARTY'`. */
+    itemId: string;
+    specialCropType?: SpecialCrop;
+    tags: ReadonlySet<DropTag>;
+    /** True iff this drop was produced by an `add-drop` effect this run. */
+    fromAddDrop?: boolean;
+}
+/**
+ * Context for stat-shaped queries (`getStat`). Carries no drop fields by design.
+ * The stat matcher rejects any scope that uses drop-only fields.
+ */
+export interface StatContext {
+    env: EffectEnvironment;
+    /** Optional crop scoping for crop-specific fortunes. */
+    crop?: Crop;
+}
+/**
+ * Declarative scope for an effect. Empty scope = global match.
+ *
+ * Drop-only fields (`items`, `dropKinds`, `specialCropTypes`, `tags`, `match`)
+ * cause the stat matcher to reject the effect outright.
+ */
+export interface Scope {
+    crops?: readonly Crop[];
+    dropKinds?: readonly DropKind[];
+    items?: readonly string[];
+    specialCropTypes?: readonly SpecialCrop[];
+    /** Match if every listed tag is present on the drop. */
+    tags?: readonly DropTag[];
+    /** Effect only applies when a Harvest Feast is active in the env. */
+    requiresHarvestFeast?: boolean;
+    /** Effect only applies when the drop's crop is in-season. */
+    requiresInSeason?: boolean;
+    /**
+     * If `false`, the effect won't match drops produced by an `add-drop` effect.
+     * Default `true`.
+     */
+    appliesToAddedDrops?: boolean;
+    /** Predicate escape hatch. Drop-only; never invoked during stat resolution. */
+    match?: (ctx: DropContext) => boolean;
+}
+export type EffectOp = 'add-stat' | 'add-rare-pct' | 'mul-rare' | 'add-drop' | 'mul-drop';
+export type EffectPhase = 'scalar' | 'produce-drops' | 'add-rare' | 'mul-rare' | 'mul-drop';
+/** Default phase for each op. Effects rarely override. */
+export declare const DEFAULT_PHASE_FOR_OP: Record<EffectOp, EffectPhase>;
+export interface EffectAddDropPayload {
+    itemId: string;
+    /** Output bucket for the produced drop. Defaults to `rng`. */
+    output?: 'rng' | 'collection' | 'currency';
+    /** Optional flat amount per block broken (alternative to `chance`). */
+    baseAmount?: number;
+    /** Optional 0..1 chance per block broken. */
+    chance?: number;
+    specialCropType?: SpecialCrop;
+    /** Tags assigned to the produced drop. Defaults to `['rare-crop','overbloom']`. */
+    tags?: readonly DropTag[];
+    /** Drop kind for the produced drop. Defaults to `'rare'`. */
+    dropKind?: DropKind;
+}
+/**
+ * Numeric semantics by op (no mixing of factor vs delta within an op):
+ *  - `add-stat`:     additive scalar contribution to `stat` (e.g. 5 = +5 Fortune).
+ *  - `add-rare-pct`: additive percentage points (e.g. 50 = +50% on rare drops).
+ *  - `mul-rare`:     multiplicative factor (e.g. 1.2 = x1.2). Must be >= 0.
+ *  - `mul-drop`:     multiplicative factor (e.g. 1.25 = x1.25). Must be >= 0.
+ *  - `add-drop`:     `value` is unused; `drop` carries the payload.
+ */
+export interface Effect {
+    source: string;
+    op: EffectOp;
+    phase?: EffectPhase;
+    scope?: Scope;
+    stat?: Stat;
+    value?: number | ((ctx: DropContext | StatContext) => number);
+    drop?: EffectAddDropPayload;
+    relatedStats?: readonly Stat[];
+    meta?: {
+        description?: string;
+        valueDisplay?: 'stat' | 'percent' | 'factor';
+        valueStat?: Stat;
+    };
+}
+/**
+ * Per-drop record of an applied effect, surfaced via `DetailedDropsResult`.
+ */
+export interface AppliedEffect {
+    source: string;
+    op: EffectOp;
+    phase: EffectPhase;
+    /** Resolved numeric contribution at this drop. */
+    amount: number;
+    relatedStats?: readonly Stat[];
+    scope?: Scope;
+    description?: string;
+    valueDisplay?: 'stat' | 'percent' | 'factor';
+    valueStat?: Stat;
+}
+/**
+ * Aggregate per-source totals across the whole rate calc.
+ * Replaces today's `rareItemBonusBreakdown`.
+ */
+export type EffectsBreakdown = Record<string, number>;

package/dist/effects/types.js

@@ -0,0 +1,9 @@
+/** Default phase for each op. Effects rarely override. */
+export const DEFAULT_PHASE_FOR_OP = {
+    'add-stat': 'scalar',
+    'add-rare-pct': 'add-rare',
+    'mul-rare': 'mul-rare',
+    'add-drop': 'produce-drops',
+    'mul-drop': 'mul-drop',
+};
+//# sourceMappingURL=types.js.map

package/dist/effects/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/effects/types.ts"],"names":[],"mappings":"AAkGA,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IAClE,UAAU,EAAE,QAAQ;IACpB,cAAc,EAAE,UAAU;IAC1B,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,UAAU;CACtB,CAAC"}

package/dist/fortune/farmingaccessory.d.ts

@@ -1,6 +1,7 @@
 import type { Rarity } from '../constants/reforges.js';
 import { Stat } from '../constants/stats.js';
 import type { FortuneSourceProgress } from '../constants/upgrades.js';
+import type { Effect, EffectEnvironment } from '../effects/types.js';
 import { type FarmingAccessoryInfo } from '../items/accessories.js';
 import type { PlayerOptions } from '../player/playeroptions.js';
 import type { EliteItemDto } from './item.js';
@@ -16,9 +17,16 @@ export declare class FarmingAccessory extends UpgradeableBase {
     options?: PlayerOptions;
     constructor(item: EliteItemDto, options?: PlayerOptions);
     getProgress(stats?: Stat[], zeroed?: boolean): FortuneSourceProgress[];
+    setOptions(options: PlayerOptions): void;
     getStat(stat: Stat): number;
+    /**
+     * Returns the declarative `Effect[]` representation of every contribution
+     * this accessory makes. Base stats, computed stats, and (halved) gem
+     * stats.
+     */
+    getEffects(_env: EffectEnvironment): Effect[];
     getFortune(): number;
     static isValid(item: EliteItemDto): boolean;
-    static fromArray(items: EliteItemDto[]): FarmingAccessory[];
+    static fromArray(items: EliteItemDto[], options?: PlayerOptions): FarmingAccessory[];
     static fakeItem(info: UpgradeableInfo, options?: PlayerOptions): FarmingAccessory | undefined;
 }

package/dist/fortune/farmingaccessory.js

@@ -1,7 +1,8 @@
 import { Stat } from '../constants/stats.js';
 import { FARMING_ACCESSORIES_INFO } from '../items/accessories.js';
+import { statsToEffects } from '../items/sources/effects-util.js';
+import { gemEffects } from '../items/sources/gems.js';
 import { getSourceProgress } from '../upgrades/getsourceprogress.js';
-import { registerItem } from '../upgrades/itemregistry.js';
 import { ACCESSORY_FORTUNE_SOURCES } from '../upgrades/sources/accessorysources.js';
 import { getGemStat, getPeridotFortune } from '../util/gems.js';
 import { UpgradeableBase } from './upgradeablebase.js';
@@ -13,10 +14,15 @@ export class FarmingAccessory extends UpgradeableBase {
     getProgress(stats, zeroed = false) {
         return getSourceProgress(this, ACCESSORY_FORTUNE_SOURCES, zeroed, stats);
     }
+    setOptions(options) {
+        this.options = options;
+        this.getFortune();
+    }
     getStat(stat) {
         let sum = 0;
         // Base fortune
         sum += this.info.baseStats?.[stat] ?? 0;
+        sum += this.getCalculatedStats()[stat] ?? 0;
         // Gems
         const gemStat = getGemStat(this.item, stat, this.rarity);
         if (gemStat > 0) {
@@ -24,11 +30,24 @@ export class FarmingAccessory extends UpgradeableBase {
         }
         return sum;
     }
+    /**
+     * Returns the declarative `Effect[]` representation of every contribution
+     * this accessory makes. Base stats, computed stats, and (halved) gem
+     * stats.
+     */
+    getEffects(_env) {
+        const sourceName = this.info.name;
+        const effects = [];
+        effects.push(...statsToEffects(this.info.baseStats, sourceName));
+        effects.push(...statsToEffects(this.getCalculatedStats(), sourceName));
+        effects.push(...gemEffects(this.item, this.rarity, `${sourceName} (Gems)`, 0.5));
+        return effects;
+    }
     getFortune() {
         this.fortuneBreakdown = {};
         let sum = 0;
         // Base fortune
-        const base = this.info.baseStats?.[Stat.FarmingFortune] ?? 0;
+        const base = (this.info.baseStats?.[Stat.FarmingFortune] ?? 0) + (this.getCalculatedStats()[Stat.FarmingFortune] ?? 0);
         if (base > 0) {
             this.fortuneBreakdown['Base Stats'] = base;
             sum += base;
@@ -36,7 +55,7 @@ export class FarmingAccessory extends UpgradeableBase {
         // Gems
         let peridot = getPeridotFortune(this.rarity, this.item);
         if (peridot > 0) {
-            peridot = +(peridot / 2).toFixed(2); // Only half the fortune is applied on accessories
+            peridot = +(peridot / 2).toFixed(2); // Only half the stats are applied on accessories
             this.fortuneBreakdown['Peridot Gems'] = peridot;
             sum += peridot;
         }
@@ -46,10 +65,10 @@ export class FarmingAccessory extends UpgradeableBase {
     static isValid(item) {
         return FARMING_ACCESSORIES_INFO[item.skyblockId] !== undefined;
     }
-    static fromArray(items) {
+    static fromArray(items, options) {
         return items
             .filter((item) => FarmingAccessory.isValid(item))
-            .map((item) => new FarmingAccessory(item))
+            .map((item) => new FarmingAccessory(item, options))
             .sort((a, b) => b.fortune - a.fortune);
     }
     static fakeItem(info, options) {
@@ -66,12 +85,4 @@ export class FarmingAccessory extends UpgradeableBase {
         return new FarmingAccessory(fake, options);
     }
 }
-for (const item of Object.values(FARMING_ACCESSORIES_INFO)) {
-    if (!item)
-        continue;
-    registerItem({
-        info: item,
-        fakeItem: (i, o) => FarmingAccessory.fakeItem(i, o),
-    });
-}
 //# sourceMappingURL=farmingaccessory.js.map

package/dist/fortune/farmingaccessory.js.map

@@ -1 +1 @@
-{"version":3,"file":"farmingaccessory.js","sourceRoot":"","sources":["../../src/fortune/farmingaccessory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"farmingaccessory.js","sourceRoot":"","sources":["../../src/fortune/farmingaccessory.ts"],"names":[],"mappings":"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"}

package/dist/fortune/farmingarmor.d.ts

@@ -2,7 +2,8 @@ import type { Crop } from '../constants/crops.js';
 import { type Rarity, type Reforge, ReforgeTarget, type ReforgeTier } from '../constants/reforges.js';
 import { type SpecialCrop } from '../constants/specialcrops.js';
 import { Stat } from '../constants/stats.js';
-import type { FortuneSourceProgress, FortuneUpgrade } from '../constants/upgrades.js';
+import { type FortuneSourceProgress, type FortuneUpgrade, type StatQueryOptions } from '../constants/upgrades.js';
+import type { Effect, EffectEnvironment } from '../effects/types.js';
 import { type ArmorSetBonus, type FarmingArmorInfo, GearSlot } from '../items/armor.js';
 import type { PlayerOptions } from '../player/playeroptions.js';
 import { FarmingEquipment } from './farmingequipment.js';
@@ -42,6 +43,7 @@ export declare class ArmorSet {
     updateArmorSlot(piece: FarmingArmor): void;
     updateEquipmentSlot(piece: FarmingEquipment): void;
     getPiece(slot: GearSlot): FarmingArmor | FarmingEquipment | undefined;
+    getStartingPiece(slot: GearSlot): FarmingArmor | FarmingEquipment | undefined;
     setPiece(armor: FarmingArmor | FarmingEquipment): void;
     private recalculateFamilies;
     static getSetBonusFrom(armor: (FarmingArmor | FarmingEquipment | null)[]): {
@@ -50,7 +52,13 @@ export declare class ArmorSet {
         bonus: ArmorSetBonus;
         special: SpecialCrop[] | undefined;
     }[];
-    getStat(stat: Stat): number;
+    getStat(stat: Stat, crop?: Crop): number;
+    /**
+     * Returns the declarative `Effect[]` for the entire armor set: every armor
+     * piece's effects, every equipment piece's effects, and the armor / equipment
+     * set bonuses keyed by current piece count.
+     */
+    getEffects(env: EffectEnvironment): Effect[];
     getFortuneBreakdown(reloadFamilies?: boolean): Record<string, number>;
     specialDropsCalc(blocksBroken: number, crop: Crop): {
         id: string;
@@ -58,11 +66,9 @@ export declare class ArmorSet {
         amount: number;
         npc: number;
     } | null;
-    specialDropsCount(crop: Crop): 0 | 2 | 1 | 3 | 4;
+    specialDropsCount(crop: Crop): 0 | 1 | 2 | 3 | 4;
     getProgress(stats?: Stat[], zeroed?: boolean): FortuneSourceProgress[];
-    getUpgrades(options?: {
-        stat?: Stat;
-    }): FortuneUpgrade[];
+    getUpgrades(options?: StatQueryOptions): FortuneUpgrade[];
     getPieceProgress(slot: GearSlot): FortuneSourceProgress[];
     get slots(): Record<GearSlot, FarmingArmor | FarmingEquipment | undefined>;
     get slotOptions(): Record<GearSlot, (FarmingArmor | FarmingEquipment)[]>;
@@ -83,11 +89,16 @@ export declare class FarmingArmor extends UpgradeableBase {
     options?: PlayerOptions;
     constructor(item: EliteItemDto, options?: PlayerOptions);
     setOptions(options: PlayerOptions): void;
-    getStat(stat: Stat): number;
+    getStat(stat: Stat, crop?: Crop): number;
+    /**
+     * Returns the declarative `Effect[]` representation of every contribution
+     * this armor piece makes: base stats, per-farming-level stats, reforge,
+     * gems, and enchants. Set bonuses are handled at the `ArmorSet` level (see
+     * {@link ArmorSet.getEffects}).
+     */
+    getEffects(env: EffectEnvironment): Effect[];
     getFortune(): number;
-    getUpgrades(options?: {
-        stat?: Stat;
-    }): FortuneUpgrade[];
+    getUpgrades(options?: StatQueryOptions): FortuneUpgrade[];
     getItemUpgrade(): import("../constants/upgrades.js").Upgrade | undefined;
     getLastItemUpgrade(): {
         upgrade: import("../constants/upgrades.js").Upgrade;