stardew-valley-data 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -5,6 +5,112 @@ 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).
 
+## [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
@@ -29,7 +135,7 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 - Fix Typo in Wild Seed names to use abbreviated name over full
 
-## [v0.5.0] - 2026-03-18
+## [0.5.0] - 2026-03-18
 
 ### Breaking Changes
 
@@ -50,19 +156,19 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 - Bump Dependencies
 
-## [v0.4.0] - 2026-03-15
+## [0.4.0] - 2026-03-15
 
 ### Breaking Changes
 
 - Change many of the output modules for parsing the file.
 
-## [v0.3.0] - 2026-03-15
+## [0.3.0] - 2026-03-15
 
 ### Fix
 
 - Add missing Villager Events
 
-## [v0.2.0] - 2026-03-10
+## [0.2.0] - 2026-03-10
 
 ### Added
 

package/data/animals.json

@@ -105,13 +105,15 @@
       "id": "176",
       "name": "Egg",
       "sellPrice": 50,
-      "image": "images/animals/produce/Egg.png"
+      "image": "images/animals/produce/Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "174",
       "name": "Large Egg",
       "sellPrice": 95,
-      "image": "images/animals/produce/Large Egg.png"
+      "image": "images/animals/produce/Large Egg.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/White Chicken.png"
   },
@@ -131,13 +133,15 @@
       "id": "180",
       "name": "Brown Egg",
       "sellPrice": 50,
-      "image": "images/animals/produce/Brown Egg.png"
+      "image": "images/animals/produce/Brown Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "182",
       "name": "Large Brown Egg",
       "sellPrice": 95,
-      "image": "images/animals/produce/Large Brown Egg.png"
+      "image": "images/animals/produce/Large Brown Egg.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Brown Chicken.png"
   },
@@ -157,13 +161,15 @@
       "id": "176",
       "name": "Egg",
       "sellPrice": 50,
-      "image": "images/animals/produce/Egg.png"
+      "image": "images/animals/produce/Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "174",
       "name": "Large Egg",
       "sellPrice": 95,
-      "image": "images/animals/produce/Large Egg.png"
+      "image": "images/animals/produce/Large Egg.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Blue Chicken.png"
   },
@@ -183,7 +189,8 @@
       "id": "305",
       "name": "Void Egg",
       "sellPrice": 65,
-      "image": "images/animals/produce/Void Egg.png"
+      "image": "images/animals/produce/Void Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Void Chicken.png"
@@ -204,7 +211,8 @@
       "id": "928",
       "name": "Golden Egg",
       "sellPrice": 500,
-      "image": "images/animals/produce/Golden Egg.png"
+      "image": "images/animals/produce/Golden Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Golden Chicken.png"
@@ -225,13 +233,15 @@
       "id": "442",
       "name": "Duck Egg",
       "sellPrice": 95,
-      "image": "images/animals/produce/Duck Egg.png"
+      "image": "images/animals/produce/Duck Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "444",
       "name": "Duck Feather",
       "sellPrice": 250,
-      "image": "images/animals/produce/Duck Feather.png"
+      "image": "images/animals/produce/Duck Feather.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Duck.png"
   },
@@ -251,13 +261,15 @@
       "id": "440",
       "name": "Wool",
       "sellPrice": 340,
-      "image": "images/animals/produce/Wool.png"
+      "image": "images/animals/produce/Wool.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "446",
       "name": "Rabbit's Foot",
       "sellPrice": 565,
-      "image": "images/animals/produce/Rabbit's Foot.png"
+      "image": "images/animals/produce/Rabbit's Foot.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Rabbit.png"
   },
@@ -277,7 +289,8 @@
       "id": "107",
       "name": "Dinosaur Egg",
       "sellPrice": 350,
-      "image": "images/animals/produce/Dinosaur Egg.png"
+      "image": "images/animals/produce/Dinosaur Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Dinosaur.png"
@@ -298,13 +311,15 @@
       "id": "184",
       "name": "Milk",
       "sellPrice": 125,
-      "image": "images/animals/produce/Milk.png"
+      "image": "images/animals/produce/Milk.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "186",
       "name": "Large Milk",
       "sellPrice": 190,
-      "image": "images/animals/produce/Large Milk.png"
+      "image": "images/animals/produce/Large Milk.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/White Cow.png"
   },
@@ -324,13 +339,15 @@
       "id": "184",
       "name": "Milk",
       "sellPrice": 125,
-      "image": "images/animals/produce/Milk.png"
+      "image": "images/animals/produce/Milk.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "186",
       "name": "Large Milk",
       "sellPrice": 190,
-      "image": "images/animals/produce/Large Milk.png"
+      "image": "images/animals/produce/Large Milk.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Brown Cow.png"
   },
@@ -350,13 +367,15 @@
       "id": "436",
       "name": "Goat Milk",
       "sellPrice": 225,
-      "image": "images/animals/produce/Goat Milk.png"
+      "image": "images/animals/produce/Goat Milk.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": {
       "id": "438",
       "name": "Large Goat Milk",
       "sellPrice": 345,
-      "image": "images/animals/produce/Large Goat Milk.png"
+      "image": "images/animals/produce/Large Goat Milk.png",
+      "maxQuality": "iridium"
     },
     "image": "images/animals/Goat.png"
   },
@@ -376,7 +395,8 @@
       "id": "440",
       "name": "Wool",
       "sellPrice": 340,
-      "image": "images/animals/produce/Wool.png"
+      "image": "images/animals/produce/Wool.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Sheep.png"
@@ -397,7 +417,8 @@
       "id": "430",
       "name": "Truffle",
       "sellPrice": 625,
-      "image": "images/animals/produce/Truffle.png"
+      "image": "images/animals/produce/Truffle.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Pig.png"
@@ -418,7 +439,8 @@
       "id": "289",
       "name": "Ostrich Egg",
       "sellPrice": 600,
-      "image": "images/animals/produce/Ostrich Egg.png"
+      "image": "images/animals/produce/Ostrich Egg.png",
+      "maxQuality": "iridium"
     },
     "deluxeProduce": null,
     "image": "images/animals/Ostrich.png"