# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.1] - 2026-04-05

### Fix

- `parseFishingRod` now resolves rod tier by `itemId` instead of `name` — older save files set all
  fishing rod names to `"Fishing Rod"`, causing every rod to fall back to level -1 (unknown);
  switching to `itemId` (`TrainingRod`, `BambooPole`, `FiberglassRod`, `IridiumRod`,
  `AdvancedIridiumRod`) correctly identifies the rod in both old and new saves

## [1.0.0] - 2026-04-05

### Added

- `rarecrows` module — `RarecrowQuery` class and `rarecrows()` factory exposing all 8 rarecrows with
  `number`, `name`, `image`, and `obtain` fields; `sortByNumber()` sort method
- `SaveData.rarecrows: SaveRarecrows` — parses all placed rarecrow item IDs from the save file,
  including rarecrows stored inside chests and building interior objects
- `SaveRarecrows` interface (`placed: string[]`) exported from `save-file`

## [0.33.0] - 2026-04-04

### Added

- Prices now available on hats data when applicable.

## [0.32.0] - 2026-03-29

### Breaking Changes

- `SaveData.pet: SavePet | null` renamed to `pets: SavePet[]` — all pets are now returned as an
  array; callers must update property access from `data.pet` to `data.pets`
- `parsePet(root)` renamed to `parsePets(root, player)` — new signature accepts the raw player node
  to identify the starter pet; returns `SavePet[]` instead of `SavePet | null`
- `SavePet` gains a required `starter: boolean` field — `true` for the pet chosen at game start
  (matched by `whichPetType` + `whichPetBreed`), `false` for all additional pets
- `SaveToolLevels` tool fields changed from `number` to
  `SaveToolLevel { level: number; enchantment: string | null }` — callers must update e.g.
  `toolLevels.axe` → `toolLevels.axe.level`
- `SaveToolLevels` gains a required `currentlyUpgrading: SaveUpgradingTool | null` field — set when
  a tool is at the blacksmith; the tool's `level` is backfilled to its pre-upgrade value

### Added

- `SaveToolLevel` interface (`level`, `enchantment`) — enchantment name is stripped of its
  `Enchantment` suffix (e.g. `ShavingEnchantment` → `Shaving`), or `null` if none applied
- `SaveUpgradingTool` interface (`tool`, `name`) — identifies which tool is at the blacksmith and
  its display name (e.g. `{ tool: 'pan', name: 'Iridium Pan' }`)
- Enchantments are now parsed for all tools including FishingRod; array-format enchantment nodes are
  handled (first entry used)

## [0.31.0] - 2026-03-29

### Added

- `FishCategory` type added
  (`'regular' | 'crab-pot' | 'night-market' | 'legendary' | 'legendary-2' | 'other'`)
- `category: FishCategory` field added to all 77 entries in `data/fish.json`
- `byCategory(category: FishCategory)` filter method added to `FishQuery`
- Fish sample script updated to display per-category counts
- Fish tests updated to cover `byCategory()` across all 6 categories

### Fix

- Added missing Caviar item to the Abandoned Joja Mart bundle in `data/bundles.json`

### Chore

- Bump Dependency Versions

## [0.30.0] - 2026-03-24

### Fix

- Update Farmer Level count to math proper in Perfection Tracker data

## [0.29.0] - 2026-03-23

## Added

- Added `lostBooksFound` and `helpWantedQuests` to `SavePlayer`
- Added to parser for lostBooksFound and helpWantedQuests

## [0.28.0] - 2026-03-23

### Added

- Add `sellPrice` to `footwear.json`.

## [0.27.0] - 2026-03-22

### Added

- `data/joja-development.json` — 5 Joja Community Development projects with `id`, `name`,
  `description`, `cost`, `ccEquivalent` (maps to Community Center room mail flag), and `order`:
  Greenhouse (35,000g), Bridge (25,000g), Panning (20,000g), Minecarts (15,000g), Bus (40,000g)
- `parseJoja()` parser added — new `joja` field on `SaveData` tracking `isMember` (from `JojaMember`
  mail flag), `completed` (event `502261`), and `developments[]` (array of `{ id, purchased }`
  driven by `joja-development.json`)
- `SaveJoja` and `SaveJojaDevelopment` interfaces added to save file types
- `images/shop/Joja Development Form.png` downloaded (640×288)

## [0.26.0] - 2026-03-22

### Added

- `data/island-upgrades.json` — 11 Ginger Island parrot upgrades with `id` (mail flag), `name`,
  `description`, `cost` (Golden Walnuts), and `location`
- `JojaParrotCalculator` class and `jojaParrotCalculator()` factory added to the `calculator` module
  — `cost(walnutsFound)` returns gold needed (remaining × 10,000g), `remaining()` returns unfound
  count, `total` (130), and `costPerWalnut` (10,000g) getters

### Changed

- `SaveIslandUpgrades` type changed from a flat object with named booleans to `SaveIslandUpgrade[]`
  — array of `{ id: string; unlocked: boolean }` driven by the data file IDs
- `parseIslandUpgrades()` parser updated to iterate `island-upgrades.json` IDs instead of hardcoded
  property names

## [0.25.0] - 2026-03-22

### Added

- `purchasePrice: number | null` field added to `Pet` type — Cats and Dogs 40,000g, Turtle 60,000g,
  Iridium Turtle 500,000g, Horse `null` (obtained via Stable building)

## [0.24.0] - 2026-03-22

### Added

- `parseFishPonds()` parser added — new `fishPonds` field on `SaveData` extracting fish pond
  buildings with `buildingId`, `fishType` (item ID), `currentOccupants`, and `maxOccupants`
- `SaveFishPond` interface added to save file types

## [0.23.0] - 2026-03-22

### Added

- **Greenhouse** added to `data/buildings.json` — unlocked via Community Center Pantry bundles or
  Joja purchase; climate-controlled building for all-season crop growing
- `animalCapacity?: number` optional field added to `Building` type — Coop (4), Big Coop (8), Deluxe
  Coop (12), Barn (4), Big Barn (8), Deluxe Barn (12), Slime Hutch (20)
- `BuildingBuilder` type expanded to include `'Community Center' | 'Joja'`

## [0.22.0] - 2026-03-22

### Added

- `parseHorse()` parser added — new `horse` field on `SaveData` capturing horse name, type, and
  HorseId from the Farm location; returns `null` if no horse exists
- `SaveHorse` interface added to save file types (`{ name: string; type: 'horse'; id: string }`)

## [0.21.0] - 2026-03-21

### Fix

- Special item IDs updated to match `Powers.json` keys: 12 special-items, 19 books, 5 masteries, 5
  skill-books all converted to PascalCase format

## [0.20.0] - 2026-03-21

### Added

- `willyBackRoomInvitation: boolean` field added to `SavePlayer` — checks for
  `"willyBackRoomInvitation"` mail flag in save file
- `parseCommunityCenter()` parser added — new `communityCenter` field on `SaveData` tracking unlock
  status, bundle activation, completion, ceremony attendance, Joja route, and individual room
  completions (boilerRoom, craftsRoom, pantry, fishTank, vault, bulletin)
- `SaveCommunityCenter` and `SaveCommunityCenterRooms` interfaces added to save file types

## [0.19.0] - 2026-03-21

### Added

- **Prismatic Slime** added to `data/monsters.json` as a top-level monster (HP 1000, damage 35);
  drops Slime and Prismatic Shard; image downloaded as GIF
- **Frost Jelly** extracted from Green Slime variants as its own top-level monster entry

### Fix

- `monster-loot.json` `droppedBy` arrays updated to use actual monster IDs from `monsters.json`
  instead of kebab-case slugs
- Dragon Tooth image path references updated in `wizard-shop.json` and `island-trader-shop.json`

## [0.18.0] - 2026-03-21

### Added

- `bookseller: number[]` field added to `SeasonData` type and all four seasons in
  `data/seasons.json` with possible Bookseller visit dates
- Bookseller calendar icon downloaded to `images/seasons/calendar-icons/Bookseller.png`

## [0.17.0] - 2026-03-21

### Fix

- Update DroppedBy Ids for Monsters in Monster Loot to match

## [0.16.0] - 2026-03-21

### Added

- **Dragon Tooth** (`id: "852"`) added to `data/monster-loot.json` — 500g sell price, dropped by
  Lava Lurk; image moved from `images/minerals/` to `images/monsters/monster-loot/`

## [0.15.0] - 2026-03-20

### Added

- `GeodeContent` interface added to `src/types/mineral.ts` —
  `{ name: string; image?: string; quantity?: string; chance?: string }`
- `contents?: GeodeContent[]` field added to `GeodeContainer` type — optional drop table listing all
  possible outputs for a given container
- **Artifact Trove** (`id: "275"`) added to `data/minerals.json` — opened at the Blacksmith for 25g;
  28 equally weighted (~3.6%) possible outputs covering all 24 artifacts plus Golden Pumpkin, Pearl,
  Treasure Appraisal Guide, and Treasure Chest
- **Golden Coconut** (`id: "791"`) added to `data/minerals.json` — Ginger Island container; first
  crack always yields a Golden Walnut; subsequent drops from a pool of 8 items including Banana
  Sapling, Mango Sapling, Fossilized Skull, and Iridium Ore
- **Mystery Box** (`id: "MysteryBox"`) added to `data/minerals.json` — 63 possible outputs with
  published chance rates; rare drops (Prismatic Shard, Pearl, Book of Stars, etc.) only unlock after
  opening 10 or more boxes
- **Golden Mystery Box** (`id: "GoldenMysteryBox"`) added to `data/minerals.json` — 65 possible
  outputs with improved rates over Mystery Box and no 10+ box unlock requirement; exclusive items:
  Golden Animal Cracker and Auto-Petter
- `images/misc/Golden Pumpkin.png` and `images/misc/Treasure Chest.png` downloaded (48×48)

## [0.14.0] - 2026-03-20

### Added

- `ProfessionCalculator` class and `professionCalculator()` factory added to the `calculator` module
  — 8 methods covering all sell-price profession bonuses: `artisan` (×1.4), `rancher` (×1.2),
  `tiller` (×1.1), `blacksmith` (×1.5), `gemologist` (×1.3), `tapper` (×1.25), `fisher` (×1.25),
  `angler` (×1.5); all use `Math.floor`
- `KnowledgeCalculator` class and `knowledgeCalculator()` factory added to the `calculator` module —
  `springOnionMastery` (×5) and `bearsKnowledge` (×3)
- `ProfessionBonus` type added to `src/types/common.ts` —
  `'artisan' | 'rancher' | 'tiller' | 'blacksmith' | 'gemologist' | 'tapper' | 'fisher' | 'angler'`
- `KnowledgeBonus` type added to `src/types/common.ts` —
  `'spring-onion-mastery' | 'bears-knowledge'`
- `profession: ProfessionBonus[]` field added to 12 item interfaces and all corresponding data
  entries — empty array means no profession bonus applies; most items carry one profession; Smoked
  Fish carries two (`["artisan", "angler"]` — it benefits from both simultaneously); fish entries
  carry `["fisher", "angler"]` to reflect the full level-5/level-10 fishing profession path:
  - `Crop` (`data/crops.json`, 47 entries) — `["tiller"]`
  - `Forageable` (`data/forageables.json`, 49 entries) — `[]` (Botanist affects quality, not price)
  - `ArtisanGood` (`data/artisan-goods.json`, 30 entries) — `["artisan"]` for 26 goods, `["tapper"]`
    for 4 tapper products (Oak Resin, Maple Syrup, Pine Tar, Mystic Syrup); Smoked Fish gets
    `["artisan", "angler"]`
  - `MineralItem` (`data/minerals.json`) — `["gemologist"]`
  - `GeodeContainer`, `OreItem`, `ResourceItem` (`data/minerals.json`) — `[]`
  - `BarItem` (`data/minerals.json`, 6 entries) — `["blacksmith"]`
  - `AnimalProduce` (`data/animals.json`) — `["rancher"]`
  - `Fish` (`data/fish.json`, 77 entries) — `["fisher", "angler"]` for 71 true fish; `[]` for
    Seaweed, Green Algae, White Algae, Sea Jelly, River Jelly, Cave Jelly
  - `FruitTreeProduce` (`data/trees.json`) — `["tiller"]`
  - `WildTreeTapper` (`data/trees.json`) — `["tapper"]`
- `knowledge: KnowledgeBonus[]` field added to `Forageable` type and all 49 forageable entries —
  Spring Onion: `["spring-onion-mastery"]`; Blackberry and Salmonberry: `["bears-knowledge"]`; all
  others: `[]`

## [0.13.0] - 2026-03-20

### Added

- `ChoppedTreeProduce` interface added to `src/types/tree.ts` —
  `{ id: string; name: string; image?: string }`; `image` is optional for special cases (e.g. Golden
  Coconut on Palm Tree)
- `choppedProduce: ChoppedTreeProduce[]` field added to both `FruitTree` and `WildTree` types and
  all 14 existing tree entries in `data/trees.json`:
  - Fruit trees (8): each produces its own sapling
  - Oak, Maple, Pine: Wood + Sap + seed
  - Mahogany: Mahogany Seed + Hardwood
  - Mushroom, Mystic: Wood + Sap + seed
  - Fiddlehead Stalk: Fiddlehead Fern + Mossy Seed
  - Palm Tree: Wood + Coconut + Golden Coconut (Golden Coconut includes `image` path)
- Wild tree `image` fields updated from `stage-5.png` sprites to portrait images for all 6 wild
  trees; portrait PNGs downloaded to each tree's folder (`portrait.png`)
- `seedId`, `seedName`, `seedImage` made optional on `WildTree` — Palm Tree has no plantable seed
- **Fiddlehead Stalk** (`id: "12"`) added to `data/trees.json` — Green Rain Tree type 3; tapper
  yields 1 Fiddlehead Fern every 2 days (not winter); chops to Fiddlehead Fern + Mossy Seed; 5 stage
  images and portrait downloaded to `images/trees/fiddlehead/`
- **Palm Tree** (`id: "6"`) added to `data/trees.json` — found in Calico Desert and Ginger Island;
  not plantable by players; 3 growth stages; chops to Wood + Coconut + Golden Coconut; portrait and
  stage images downloaded to `images/trees/palm/`; `seedImage` reuses existing Coconut image from
  `images/forageables/`

### Fixed

- Grape crop image corrected to the proper sprite (`images/crops/grape/crop.png`)
- Powdermelon now correctly appears in the `giant()` crop filter
- `search/index.ts` and `sample/trees/index.ts` updated to guard optional
  `seedId`/`seedName`/`seedImage` fields on `WildTree` so seedless trees (Palm Tree) are handled
  correctly

## [0.12.0] - 2026-03-19

### Fixes

- Changed crab-pot catchType fish to be `"roe": null` since they should not show in producing roe.

## [0.11.0] - 2026-03-19

### Added

- `energyHealthFormula: string | null` field added to all 30 artisan goods in
  `data/artisan-goods.json` and `ArtisanGood` type — mirrors `sellPriceFormula`; set to a
  descriptive string for the 7 variable-output goods (Wine, Juice, Pickles, Jelly, Dried Fruit,
  Dried Mushrooms, Smoked Fish), `null` for all fixed-value and inedible goods
- `energyHealth` set to `null` (from absent) for the 7 formula-based artisan goods — signals that
  the value must be calculated from the source ingredient using `energyHealthFormula`
- `ArtisanGoodBuff` interface added to `src/types/artisan-good.ts` —
  `{ stat: string; value: number }`
- `buffs: ArtisanGoodBuff[]` and `buffDuration: number | null` fields added to all 30 artisan goods
  and `ArtisanGood` type — Beer, Mead, Pale Ale, Wine each buff `Speed -1`; Coffee buffs `Speed +1`;
  Green Tea buffs `Speed +0.5`; all others have empty `buffs` array
- `images/misc/Speed.png` — 24×24 Speed stat icon added to match existing Energy, Health, and Poison
  misc icons

## [0.10.0] - 2026-03-19

### Added

- `Sturgeon Roe` entry added to `data/forageables.json` with id `"812S"` — a Sturgeon-specific
  variant of Roe; sell price 130g (`30 + floor(200/2)`), image
  `images/forageables/Sturgeon Roe.png`, locations "Fish Ponds (Sturgeon)", all seasons, same
  energy/health as Roe (50/22)

### Fixed

- Caviar ingredient in `data/artisan-goods.json` corrected from `id: "723"` (Oyster — wrong) to
  `id: "812S"` (Sturgeon Roe); Sturgeon Roe has no unique game object id — the game dynamically
  renames Roe (id `812`) to "Sturgeon Roe" when produced by a Sturgeon pond

## [0.9.0] - 2026-03-19

### Added

- `ArtisanCalculator` class and `artisanCalculator()` factory added to the `calculator` module —
  covers Roe, Aged Roe, Honey, Wine, Juice, Pickles, Jelly, Dried Mushrooms, Dried Fruit, and Smoked
  Fish; returns sell price and (where applicable) energy/health values
- `ArtisanResult` and `ArtisanEnergyResult` types added to `src/types/calculator.ts`
- `ArtisanUses` interface added to `src/types/common.ts` —
  `{ honey, wine, juice, pickles, jelly, driedMushrooms, driedFruit: boolean }`
- `artisanUses: ArtisanUses` field added to all crops (`data/crops.json`, `Crop` type), all
  forageables (`data/forageables.json`, `Forageable` type), and all fruit tree produce
  (`data/trees.json`, `FruitTreeProduce` type)
- `canSmoke: boolean` field added to all 77 fish in `data/fish.json` and `Fish` type — `true` for
  all rod-caught fish except Seaweed, Green Algae, and White Algae
- `roe: FishRoe | null` field added to all 77 fish — `'roe'` for 68 standard roe producers,
  `'caviar'` for Sturgeon (roe → Caviar in Preserves Jar), `null` for Squid/Midnight Squid (Squid
  Ink) and non-pond items
- `fishPond: FishPond | null` field added to all 77 fish — `null` for non-pond items (algae,
  jellies); all 71 pond-eligible fish include a `produce` array of `{ product, minPopulation }`
  entries sourced from the wiki Fish Pond produce table
- `FishRoe`, `FishPond`, and `FishPondProduce` types added to `src/types/fish.ts`
- `.smokeable()`, `.byRoe(type)`, and `.pondEligible()` filter methods added to `FishQuery`
- `byArtisanUse(use: keyof ArtisanUses)` filter method added to `CropQuery`, `ForageableQuery`, and
  `TreeQuery`
- `sample/artisan-uses/` — new cross-module sample showing all items grouped by artisan use across
  crops, forageables, and fruit trees
- Cactus Fruit added to `data/forageables.json` (id `90`; fruit — wine, jelly, driedFruit)
- Tea Leaves moved from `data/forageables.json` to `data/crops.json` — vegetable,
  spring/summer/fall, 20-day grow / 1-day regrow, juice and pickles artisan uses; growth stage
  images added to `images/crops/tea-leaves/`
- Added `Energy.png`, `Health.png`, and `Poison.png` icon images (20×20) to `images/misc/`
- `maxQuality` field (`ItemQuality`) added to all farm animal produce and deluxe produce in
  `data/animals.json` and `AnimalProduce` type
- `maxQuality` field added to all artisan goods in `data/artisan-goods.json` and `ArtisanGood` type
  — `'iridium'` for cask-ageable goods, `'base'` for all others
- `maxQuality` field added to all forageables in `data/forageables.json` and `Forageable` type —
  `'iridium'` for foraged items, `'base'` for resources (Wood, Stone, Sap, etc.)
- `maxQuality` field added to all crops in `data/crops.json` and `Crop` type — `'iridium'` for all
  crops except Fiber (`'base'`)
- `ItemQuality` shared type (`'base' | 'silver' | 'gold' | 'iridium'`) added to
  `src/types/common.ts`; used across `AnimalProduce`, `ArtisanGood`, `Crop`, `Forageable`, and
  `Fish` types
- `data/fish.json` — `maxQuality` field added to all fish entries (already typed, now present in
  data)

### Changed

- Tea Leaves removed from `data/forageables.json`; consolidated to `data/crops.json`
- `images/forageables/Tea Leaves.png` and `images/craftable/seeds/Tea Sapling.png` removed —
  replaced by unified images under `images/crops/tea-leaves/`; `data/crafting.json` reference
  updated accordingly
- `FishQuality` type removed from `src/types/fish.ts`; `maxQuality` now uses the shared
  `ItemQuality` type
- `tsconfig.json` — enabled `noUnusedLocals` and `noUnusedParameters` for stricter compile-time
  checks

### Documentation

- `src/modules/calculator/README.md` — added `ArtisanCalculator` methods, formulas, and examples
- `src/modules/crops/README.md` — added `byArtisanUse` filter and `artisanUses` fields table rows
- `src/modules/forageables/README.md` — added `byArtisanUse` filter and `artisanUses` fields table
  rows
- `src/modules/trees/README.md` — added `byArtisanUse` filter and `produce.artisanUses` fields table
  rows; added example usage
- `src/modules/fish/README.md` — added `canSmoke` row to fish fields table
- `src/modules/animals/README.md` — added `produce.maxQuality` and `deluxeProduce.maxQuality` rows
  to farm animal fields table
- `src/modules/artisan-goods/README.md` — added `energyHealth` and `maxQuality` rows to fields table
- `src/modules/crops/README.md` — added `maxQuality` row to crop fields table
- `src/modules/fish/README.md` — added `energyHealth` and `maxQuality` rows to fish fields table
- `src/modules/forageables/README.md` — added `energyHealth` and `maxQuality` rows to forageable
  fields table

### Chore

- Renamed internal data constants from `all*Data` to `*Data` pattern across 7 modules (`fish`,
  `forageables`, `cooking`, `bait`, `footwear`, `tackle`, `pierre-shop`) per naming conventions
- Fixed sort methods in `bait`, `tackle`, and `cooking` modules to use inline
  `return new XxxQuery([...this.data].sort(...))` style for consistency
- Moved filter methods before sort methods in `cooking` module to match ordering convention
- Added JSDoc to filter/sort methods in `hats`, `footwear`, `weather`, `maps`, `weapon-stats`,
  `bait`, and `tackle` modules
- Added `DayOfWeek` and `TraderShopItem` shared types to `src/types/common.ts`; five duplicate
  day-of-week unions (`CarpenterDay`, `DesertTraderDay`, `IslandTraderDay`, `OasisDay`,
  `LocationDay`) are now type aliases
- `DesertTraderItem` and `IslandTraderItem` are now aliases for the shared `TraderShopItem` type,
  removing an identical 11-field interface duplicated across two files
- `CraftingIngredient` is now a type alias for the existing `Ingredient` type in `common.ts`,
  removing a structurally identical duplicate interface

## [0.8.0] - 2026-03-18

### Fix

- Fix Parser of Cooking Recipes to properly show cooked count

## [0.7.0] - 2026-03-18

### Fix

- Fix Collection lists using wrong Ids

## [0.6.0] - 2026-03-18

### Added

- Added FishingPole Level to Parser tool

## [0.5.1] - 2026-03-18

### Fix

- Fix Typo in Wild Seed names to use abbreviated name over full

## [0.5.0] - 2026-03-18

### Breaking Changes

- Change Fishing Rod structure to show in an array over individual items.

### Added

- Added new text for Skill unlocks of Additional for Fishing and Foraging details.

### Fix

- Fix Skills showing wrong item unlocks per level
- Fix Trash can showing as enchantable
- Fix Copper Pan text to Pan name
- Add missing millisecondsPlayed to parser

### Chore

- Bump Dependencies

## [0.4.0] - 2026-03-15

### Breaking Changes

- Change many of the output modules for parsing the file.

## [0.3.0] - 2026-03-15

### Fix

- Add missing Villager Events

## [0.2.0] - 2026-03-10

### Added

#### Core Architecture

- Query builder pattern with `QueryBase<T>` abstract base class providing 5 terminal methods:
  `get()`, `first()`, `find()`, `findByName()`, `count()`
- All query classes return new instances on filter/sort for immutable chaining
- Dual module output (ESM + CommonJS) with TypeScript declarations via tsup
- Path alias system (`@/types`, `@/common/*`, `@/data/*`, `@/modules/*`)
- 1,912 bundled image assets organized across 37 subfolders
- 67 structured JSON data files with ~1,870 total entries

#### Data Modules (68 total)

- **Items & Equipment**: bait (7), tackle (10), footwear (18), hats (122), rings (30), tools (21),
  weapons (62), weapon-stats (5), trinkets (8), special-items (41)
- **Farming & Nature**: crops (46), trees (14 — fruit + wild via discriminated union), artisan-goods
  (27), animals (27 — pets + farm animals via discriminated union), mixed-seeds (2), seasons (4)
- **Fishing**: fish (77)
- **Foraging & Mining**: forageables (48), minerals (97), artifacts (42)
- **Cooking & Crafting**: cooking (81), crafting (150)
- **Combat**: monsters (44), monster-loot (5), monster-slayer-goals (12 — with validated monster
  target lists)
- **NPCs & Social**: villagers (34), universal-gifts, events (100), quests (58), special-orders (28)
- **Progression**: achievements (49), skills (5), professions (30), perfection (11), stardrops (7),
  golden-walnuts (69), secret-notes (38), lost-books (21), collections, bundles (61 — standard +
  remix variants)
- **Shops** (18 modules): pierre (54), saloon (16), blacksmith (4), carpenter (21), marnie (14),
  willy (24), krobus (16), guild (38), casino (13), desert-trader (26), oasis (16), volcano (10),
  island-trader (23), dwarf (11), joja (34), qi (27), bookseller, medical-supplies (2)
- **World & Locations**: locations (38), maps (8), buildings (23), weather (9), farmhouse
  (upgrades + renovations), field-office (4 collections, 9 donations), concessions (24)
- **Calculators**: quality calculator (sell price and energy/health scaling by quality tier),
  grandpa evaluator (score 0–21 across 7 categories, candles 1–4)
- **Search**: global `search(query, kinds?)` function across all modules with deduplication and
  parent tracking
- **Save File**: `parseSaveFile(xml)` parser with versioned parser sets for extracting player data
  from XML save files

#### Utility Functions

- `isPet()` / `isFarmAnimal()` type guards for the Animal discriminated union
- `calculateArtisanPrice()` / `applyPriceFormula()` for artisan good pricing
- `getTitleScore()` / `getTitle()` / `getMasteryLevel()` for skill progression calculations

#### Testing & Validation

- 98 test files with ~8,700 lines of test code covering all modules
- Sample runner system with 68 sub-runners validating image paths and exercising query logic
- Sample output capture to `sample/output/` with per-module `.txt` files and `summary.txt`