stardew-valley-data 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ 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.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

package/data/island-upgrades.json

@@ -0,0 +1,79 @@
+[
+  {
+    "id": "Island_FirstParrot",
+    "name": "Ginger Island North",
+    "description": "Feed Leo's parrot friend to unlock access to the north side of the island.",
+    "cost": 1,
+    "location": "Leo's Hut"
+  },
+  {
+    "id": "Island_Turtle",
+    "name": "Ginger Island West",
+    "description": "A turtle ferries the player to the western island region.",
+    "cost": 10,
+    "location": "Leo's Hut area"
+  },
+  {
+    "id": "Island_UpgradeHouse",
+    "name": "Island Farmhouse",
+    "description": "Provides sleeping quarters on the west side of the island so the player can stay overnight.",
+    "cost": 20,
+    "location": "Ginger Island West"
+  },
+  {
+    "id": "Island_Resort",
+    "name": "Island Resort",
+    "description": "Unlocks the beach resort on the south side of the island. Villagers can visit.",
+    "cost": 20,
+    "location": "Island South"
+  },
+  {
+    "id": "Island_UpgradeTrader",
+    "name": "Island Trader",
+    "description": "Unlocks the Island Trader shop on the north side of the island.",
+    "cost": 10,
+    "location": "Island North"
+  },
+  {
+    "id": "Island_UpgradeBridge",
+    "name": "Dig Site Bridge",
+    "description": "Repairs the bridge to access the island dig site.",
+    "cost": 10,
+    "location": "Island North"
+  },
+  {
+    "id": "Island_UpgradeParrotPlatform",
+    "name": "Parrot Express",
+    "description": "Enables the fast-travel parrot platform system around the island.",
+    "cost": 10,
+    "location": "Ginger Island (multiple stops)"
+  },
+  {
+    "id": "Island_UpgradeHouse_Mailbox",
+    "name": "Farmhouse Mailbox",
+    "description": "Adds a mailbox to the island farmhouse so the player can receive mail.",
+    "cost": 5,
+    "location": "Island Farmhouse"
+  },
+  {
+    "id": "Island_W_Obelisk",
+    "name": "Farm Obelisk",
+    "description": "Builds an obelisk near the island farmhouse that teleports the player back to the farm.",
+    "cost": 20,
+    "location": "Island Farmhouse"
+  },
+  {
+    "id": "Island_VolcanoBridge",
+    "name": "Volcano Bridge",
+    "description": "Builds a permanent bridge at the volcano dungeon entrance.",
+    "cost": 5,
+    "location": "Volcano Dungeon entrance"
+  },
+  {
+    "id": "Island_VolcanoShortcutOut",
+    "name": "Volcano Exit Shortcut",
+    "description": "Creates a shortcut exit passage on volcano dungeon level 5.",
+    "cost": 5,
+    "location": "Volcano Dungeon level 5"
+  }
+]

package/dist/index.d.mts

@@ -1464,6 +1464,22 @@ declare class KnowledgeCalculator {
 }
 /** Returns a KnowledgeCalculator instance for computing knowledge bonus sell prices. */
 declare function knowledgeCalculator(): KnowledgeCalculator;
+/**
+ * Calculates the cost to purchase remaining Golden Walnuts from the Joja Parrot.
+ * Each unfound walnut costs 10,000g. All remaining walnuts are delivered after sleeping.
+ */
+declare class JojaParrotCalculator {
+    /** Calculate the gold cost to buy all remaining walnuts. */
+    cost(walnutsFound: number): number;
+    /** Returns how many walnuts are still unfound. */
+    remaining(walnutsFound: number): number;
+    /** The total number of Golden Walnuts available in the game. */
+    get total(): number;
+    /** The cost per individual unfound walnut (10,000g). */
+    get costPerWalnut(): number;
+}
+/** Returns a JojaParrotCalculator instance for computing Golden Walnut purchase costs. */
+declare function jojaParrotCalculator(): JojaParrotCalculator;
 
 /** Query builder for crop data. All filter and sort methods return a new CropQuery for chaining. */
 declare class CropQuery extends QueryBase<Crop> {
@@ -2878,20 +2894,13 @@ interface SaveWalnuts {
     found: number;
     collected: string[];
 }
-/** Ginger Island upgrade and unlock status for each parrot-purchasable feature. */
-interface SaveIslandUpgrades {
-    firstParrot: boolean;
-    turtle: boolean;
-    house: boolean;
-    resort: boolean;
-    trader: boolean;
-    bridge: boolean;
-    parrotPlatforms: boolean;
-    mailbox: boolean;
-    obelisk: boolean;
-    volcanoBridge: boolean;
-    volcanoShortcut: boolean;
+/** A single Ginger Island parrot upgrade with unlock status. */
+interface SaveIslandUpgrade {
+    id: string;
+    unlocked: boolean;
 }
+/** Ginger Island upgrade and unlock status for each parrot-purchasable feature. */
+type SaveIslandUpgrades = SaveIslandUpgrade[];
 /** A player's child with name, age stage, and gender. */
 interface SaveChild {
     name: string;
@@ -3003,4 +3012,4 @@ declare function resolveApiVersion(gameVersion: string): number;
  */
 declare function parseSaveFile(xml: string): SaveData;
 
-export { type Achievement, AchievementQuery, type Animal, type AnimalProduce, AnimalQuery, type Artifact, ArtifactQuery, ArtisanCalculator, type ArtisanEnergyResult, type ArtisanGood, type ArtisanGoodBuff, ArtisanGoodQuery, type ArtisanIngredient, type ArtisanResult, type ArtisanUses, type Backpack, type Bait, BaitQuery, type BarItem, type BlacksmithItem, BlacksmithQuery, type BooksellerAvailability, type BooksellerItem, BooksellerItemQuery, type BooksellerTrade, BooksellerTradeQuery, type Buff, type Building, type BuildingBuilder, type BuildingMaterial, BuildingQuery, type Bundle, type BundleItem, BundleQuery, type BundleReward, type BundleRoom, type CarpenterCategory, type CarpenterDay, type CarpenterItem, CarpenterQuery, type CasinoCategory, type CasinoItem, CasinoQuery, type CaskAging, type ChoppedTreeProduce, type CollectionItem, CollectionItemQuery, CollectionsQuery, type Concession, ConcessionQuery, type ConcessionTag, type CookedDish, type CookingBuff, CookingQuery, type CraftingIngredient, type CraftingOutput, CraftingQuery, type CraftingRecipe, type Crop, CropQuery, type DayOfWeek, type DesertTraderDay, type DesertTraderItem, DesertTraderQuery, type DwarfShopCategory, type DwarfShopItem, DwarfShopQuery, type EnergyHealth, EventQuery, type FarmAnimal, type FarmMap, FarmMapQuery, type Festival, type FieldOfficeCollection, type FieldOfficeCollectionData, type FieldOfficeDonation, FieldOfficeDonationQuery, FieldOfficeQuery, type FieldOfficeReward, type Fish, type FishCatchType, type FishPond, type FishPondProduce, FishQuery, type FishRoe, type FishWeather, type FishingRod, type FishingRodLevel, type Footwear, FootwearQuery, type Forageable, ForageableQuery, type FruitTree, type FruitTreeProduce, type GameEvent, type GameLocation, type GeodeContainer, type GeodeContent, type GiftPreferences, type GoldBundle, type GoldenWalnut, GoldenWalnutQuery, type GoldenWalnutTrackingType, type GrandpaCategory, GrandpaEvaluator, type GrandpaInput, type GrandpaResult, type GrandpaScoreEntry, type GuildCategory, type GuildItem, GuildQuery, type GuildWeaponType, type HarvestQuantity, type Hat, HatQuery, type HeartEvent, type HouseRenovation, HouseRenovationQuery, type HouseUpgrade, type HouseUpgradeMaterial, HouseUpgradeQuery, type Ingredient, type IslandTraderDay, type IslandTraderItem, IslandTraderQuery, type ItemBundle, type ItemQuality, type JojaBundle, type JojaItem, JojaQuery, type KnowledgeBonus, KnowledgeCalculator, type KrobusDay, type KrobusItem, KrobusQuery, type KrobusStockType, LATEST_API_VERSION, type LocationCategory, type LocationDay, type LocationHours, LocationQuery, type LocationType, type LostBook, LostBookQuery, MASTERY_LEVELS, type MarnieCategory, type MarnieItem, MarnieQuery, type MasteryLevel, type MasterySkill, type MasteryUnlock, type MedicalSupply, MedicalSupplyQuery, type MeleeWeapon, type Mineral, type MineralItem, MineralQuery, type MixedSeed, type MixedSeedProduces, MixedSeedQuery, type Monster, type MonsterLoot, MonsterLootQuery, MonsterQuery, type MonsterSlayerGoal, MonsterSlayerGoalQuery, type MonsterVariant, type NodeDrop, type NodeItem, type OasisCategory, type OasisDay, type OasisItem, OasisQuery, type OreItem, type PerfectionCategory, PerfectionQuery, type Pet, type PierreCategory, type PierreItem, PierreQuery, type PriceFormula, type ProfessionBonus, ProfessionCalculator, type ProfessionData, ProfessionQuery, type ProfessionSkill, type QiCurrency, type QiStockItem, QiStockQuery, type Quality, QualityCalculator, type QualityEnergyHealth, type QualityPrice, type Quest, QuestQuery, type RecipeSource, type ResourceItem, type Ring, RingQuery, SKILL_TITLES, type SaloonCategory, type SaloonItem, SaloonQuery, type SaveAnimal, type SaveBuilding, type SaveBundleData, type SaveBundleItem, type SaveBundleReward, type SaveBundleRoom, type SaveBundleStatus, type SaveChild, type SaveCollectionEntry, type SaveData, type SaveDate, type SaveFarm, type SaveFishEntry, type SaveFriendship, type SaveIslandUpgrades, type SaveItem, type SaveMastery, type SaveMasteryPerk, type SaveMineProgress, type SaveMonsterKillEntry, type SaveMuseum, type SavePerfection, type SavePet, type SavePlayer, type SavePowerEntry, type SavePowers, type SaveProfession, type SaveQuest, type SaveRaccoons, type SaveRecipeEntry, type SaveSecretNotes, type SaveShippedEntry, type SaveSkillLevel, type SaveSkills, type SaveSpecialOrders, type SaveStardropEntry, type SaveStats, type SaveWalnuts, type SearchResult, type SearchResultKind, type Season, type SeasonData, SeasonQuery, type SecretNote, SecretNoteQuery, type SecretNoteType, type SeedBuyPrice, type SimpleTool, type Skill, type SkillLevel, type SkillLevelRecipes, type SkillMastery, SkillQuery, type SlayerReward, type Slingshot, type SmeltRecipe, type SpecialItem, SpecialItemQuery, type SpecialItemType, type SpecialOrderCategory, type SpecialOrderData, SpecialOrderQuery, type Stage, type StarDrop, StarDropQuery, type StarDropSource, type Tackle, TackleQuery, type TitleThreshold, type Tool, type ToolLevel, ToolQuery, type ToolType, type TraderShopItem, type Tree, TreeQuery, type Trinket, TrinketQuery, type TrinketSource, type UniversalGifts, type UpgradeLevel, type UpgradeableTool, type VersionRange, type Villager, VillagerQuery, type VolcanoShopCategory, type VolcanoShopCurrency, type VolcanoShopItem, VolcanoShopQuery, type Weapon, WeaponQuery, type WeaponStat, WeaponStatQuery, type WeaponType, type Weather, WeatherQuery, type WildTree, type WildTreeTapper, type WillyCategory, type WillyItem, WillyQuery, type WizardBuilding, type WizardBuildingMaterial, WizardQuery, achievements, animals, applyPriceFormula, artifacts, artisanCalculator, artisanGoods, bait, blacksmith, booksellerShop, booksellerTrades, buildings, bundles, calculateArtisanPrice, carpenter, casino, collections, concessions, cooking, crafting, crops, desertTrader, dwarfShop, events, fieldOffice, fieldOfficeDonations, findFestival, fish, footwear, forageables, getMasteryLevel, getProfessionOptions, getTitle, getTitleScore, goldenWalnuts, grandpaEvaluator, guild, hats, houseRenovations, houseUpgrades, isFarmAnimal, isPet, islandTrader, joja, knowledgeCalculator, krobus, locations, lostBooks, maps, marnie, medicalSupplies, minerals, mixedSeeds, monsterLoot, monsterSlayerGoals, monsters, oasis, parseSaveFile, perfection, pierre, professionCalculator, professions, qiStock, qualityCalculator, quests, resolveApiVersion, rings, saloon, search, seasons, secretNotes, skills, specialItems, specialOrders, starDrops, tackle, tools, trees, trinkets, universalGifts, villagers, volcanoShop, weaponStats, weapons, weather, willy, wizard };
+export { type Achievement, AchievementQuery, type Animal, type AnimalProduce, AnimalQuery, type Artifact, ArtifactQuery, ArtisanCalculator, type ArtisanEnergyResult, type ArtisanGood, type ArtisanGoodBuff, ArtisanGoodQuery, type ArtisanIngredient, type ArtisanResult, type ArtisanUses, type Backpack, type Bait, BaitQuery, type BarItem, type BlacksmithItem, BlacksmithQuery, type BooksellerAvailability, type BooksellerItem, BooksellerItemQuery, type BooksellerTrade, BooksellerTradeQuery, type Buff, type Building, type BuildingBuilder, type BuildingMaterial, BuildingQuery, type Bundle, type BundleItem, BundleQuery, type BundleReward, type BundleRoom, type CarpenterCategory, type CarpenterDay, type CarpenterItem, CarpenterQuery, type CasinoCategory, type CasinoItem, CasinoQuery, type CaskAging, type ChoppedTreeProduce, type CollectionItem, CollectionItemQuery, CollectionsQuery, type Concession, ConcessionQuery, type ConcessionTag, type CookedDish, type CookingBuff, CookingQuery, type CraftingIngredient, type CraftingOutput, CraftingQuery, type CraftingRecipe, type Crop, CropQuery, type DayOfWeek, type DesertTraderDay, type DesertTraderItem, DesertTraderQuery, type DwarfShopCategory, type DwarfShopItem, DwarfShopQuery, type EnergyHealth, EventQuery, type FarmAnimal, type FarmMap, FarmMapQuery, type Festival, type FieldOfficeCollection, type FieldOfficeCollectionData, type FieldOfficeDonation, FieldOfficeDonationQuery, FieldOfficeQuery, type FieldOfficeReward, type Fish, type FishCatchType, type FishPond, type FishPondProduce, FishQuery, type FishRoe, type FishWeather, type FishingRod, type FishingRodLevel, type Footwear, FootwearQuery, type Forageable, ForageableQuery, type FruitTree, type FruitTreeProduce, type GameEvent, type GameLocation, type GeodeContainer, type GeodeContent, type GiftPreferences, type GoldBundle, type GoldenWalnut, GoldenWalnutQuery, type GoldenWalnutTrackingType, type GrandpaCategory, GrandpaEvaluator, type GrandpaInput, type GrandpaResult, type GrandpaScoreEntry, type GuildCategory, type GuildItem, GuildQuery, type GuildWeaponType, type HarvestQuantity, type Hat, HatQuery, type HeartEvent, type HouseRenovation, HouseRenovationQuery, type HouseUpgrade, type HouseUpgradeMaterial, HouseUpgradeQuery, type Ingredient, type IslandTraderDay, type IslandTraderItem, IslandTraderQuery, type ItemBundle, type ItemQuality, type JojaBundle, type JojaItem, JojaParrotCalculator, JojaQuery, type KnowledgeBonus, KnowledgeCalculator, type KrobusDay, type KrobusItem, KrobusQuery, type KrobusStockType, LATEST_API_VERSION, type LocationCategory, type LocationDay, type LocationHours, LocationQuery, type LocationType, type LostBook, LostBookQuery, MASTERY_LEVELS, type MarnieCategory, type MarnieItem, MarnieQuery, type MasteryLevel, type MasterySkill, type MasteryUnlock, type MedicalSupply, MedicalSupplyQuery, type MeleeWeapon, type Mineral, type MineralItem, MineralQuery, type MixedSeed, type MixedSeedProduces, MixedSeedQuery, type Monster, type MonsterLoot, MonsterLootQuery, MonsterQuery, type MonsterSlayerGoal, MonsterSlayerGoalQuery, type MonsterVariant, type NodeDrop, type NodeItem, type OasisCategory, type OasisDay, type OasisItem, OasisQuery, type OreItem, type PerfectionCategory, PerfectionQuery, type Pet, type PierreCategory, type PierreItem, PierreQuery, type PriceFormula, type ProfessionBonus, ProfessionCalculator, type ProfessionData, ProfessionQuery, type ProfessionSkill, type QiCurrency, type QiStockItem, QiStockQuery, type Quality, QualityCalculator, type QualityEnergyHealth, type QualityPrice, type Quest, QuestQuery, type RecipeSource, type ResourceItem, type Ring, RingQuery, SKILL_TITLES, type SaloonCategory, type SaloonItem, SaloonQuery, type SaveAnimal, type SaveBuilding, type SaveBundleData, type SaveBundleItem, type SaveBundleReward, type SaveBundleRoom, type SaveBundleStatus, type SaveChild, type SaveCollectionEntry, type SaveData, type SaveDate, type SaveFarm, type SaveFishEntry, type SaveFriendship, type SaveIslandUpgrades, type SaveItem, type SaveMastery, type SaveMasteryPerk, type SaveMineProgress, type SaveMonsterKillEntry, type SaveMuseum, type SavePerfection, type SavePet, type SavePlayer, type SavePowerEntry, type SavePowers, type SaveProfession, type SaveQuest, type SaveRaccoons, type SaveRecipeEntry, type SaveSecretNotes, type SaveShippedEntry, type SaveSkillLevel, type SaveSkills, type SaveSpecialOrders, type SaveStardropEntry, type SaveStats, type SaveWalnuts, type SearchResult, type SearchResultKind, type Season, type SeasonData, SeasonQuery, type SecretNote, SecretNoteQuery, type SecretNoteType, type SeedBuyPrice, type SimpleTool, type Skill, type SkillLevel, type SkillLevelRecipes, type SkillMastery, SkillQuery, type SlayerReward, type Slingshot, type SmeltRecipe, type SpecialItem, SpecialItemQuery, type SpecialItemType, type SpecialOrderCategory, type SpecialOrderData, SpecialOrderQuery, type Stage, type StarDrop, StarDropQuery, type StarDropSource, type Tackle, TackleQuery, type TitleThreshold, type Tool, type ToolLevel, ToolQuery, type ToolType, type TraderShopItem, type Tree, TreeQuery, type Trinket, TrinketQuery, type TrinketSource, type UniversalGifts, type UpgradeLevel, type UpgradeableTool, type VersionRange, type Villager, VillagerQuery, type VolcanoShopCategory, type VolcanoShopCurrency, type VolcanoShopItem, VolcanoShopQuery, type Weapon, WeaponQuery, type WeaponStat, WeaponStatQuery, type WeaponType, type Weather, WeatherQuery, type WildTree, type WildTreeTapper, type WillyCategory, type WillyItem, WillyQuery, type WizardBuilding, type WizardBuildingMaterial, WizardQuery, achievements, animals, applyPriceFormula, artifacts, artisanCalculator, artisanGoods, bait, blacksmith, booksellerShop, booksellerTrades, buildings, bundles, calculateArtisanPrice, carpenter, casino, collections, concessions, cooking, crafting, crops, desertTrader, dwarfShop, events, fieldOffice, fieldOfficeDonations, findFestival, fish, footwear, forageables, getMasteryLevel, getProfessionOptions, getTitle, getTitleScore, goldenWalnuts, grandpaEvaluator, guild, hats, houseRenovations, houseUpgrades, isFarmAnimal, isPet, islandTrader, joja, jojaParrotCalculator, knowledgeCalculator, krobus, locations, lostBooks, maps, marnie, medicalSupplies, minerals, mixedSeeds, monsterLoot, monsterSlayerGoals, monsters, oasis, parseSaveFile, perfection, pierre, professionCalculator, professions, qiStock, qualityCalculator, quests, resolveApiVersion, rings, saloon, search, seasons, secretNotes, skills, specialItems, specialOrders, starDrops, tackle, tools, trees, trinkets, universalGifts, villagers, volcanoShop, weaponStats, weapons, weather, willy, wizard };

package/dist/index.d.ts

@@ -1464,6 +1464,22 @@ declare class KnowledgeCalculator {
 }
 /** Returns a KnowledgeCalculator instance for computing knowledge bonus sell prices. */
 declare function knowledgeCalculator(): KnowledgeCalculator;
+/**
+ * Calculates the cost to purchase remaining Golden Walnuts from the Joja Parrot.
+ * Each unfound walnut costs 10,000g. All remaining walnuts are delivered after sleeping.
+ */
+declare class JojaParrotCalculator {
+    /** Calculate the gold cost to buy all remaining walnuts. */
+    cost(walnutsFound: number): number;
+    /** Returns how many walnuts are still unfound. */
+    remaining(walnutsFound: number): number;
+    /** The total number of Golden Walnuts available in the game. */
+    get total(): number;
+    /** The cost per individual unfound walnut (10,000g). */
+    get costPerWalnut(): number;
+}
+/** Returns a JojaParrotCalculator instance for computing Golden Walnut purchase costs. */
+declare function jojaParrotCalculator(): JojaParrotCalculator;
 
 /** Query builder for crop data. All filter and sort methods return a new CropQuery for chaining. */
 declare class CropQuery extends QueryBase<Crop> {
@@ -2878,20 +2894,13 @@ interface SaveWalnuts {
     found: number;
     collected: string[];
 }
-/** Ginger Island upgrade and unlock status for each parrot-purchasable feature. */
-interface SaveIslandUpgrades {
-    firstParrot: boolean;
-    turtle: boolean;
-    house: boolean;
-    resort: boolean;
-    trader: boolean;
-    bridge: boolean;
-    parrotPlatforms: boolean;
-    mailbox: boolean;
-    obelisk: boolean;
-    volcanoBridge: boolean;
-    volcanoShortcut: boolean;
+/** A single Ginger Island parrot upgrade with unlock status. */
+interface SaveIslandUpgrade {
+    id: string;
+    unlocked: boolean;
 }
+/** Ginger Island upgrade and unlock status for each parrot-purchasable feature. */
+type SaveIslandUpgrades = SaveIslandUpgrade[];
 /** A player's child with name, age stage, and gender. */
 interface SaveChild {
     name: string;
@@ -3003,4 +3012,4 @@ declare function resolveApiVersion(gameVersion: string): number;
  */
 declare function parseSaveFile(xml: string): SaveData;
 
-export { type Achievement, AchievementQuery, type Animal, type AnimalProduce, AnimalQuery, type Artifact, ArtifactQuery, ArtisanCalculator, type ArtisanEnergyResult, type ArtisanGood, type ArtisanGoodBuff, ArtisanGoodQuery, type ArtisanIngredient, type ArtisanResult, type ArtisanUses, type Backpack, type Bait, BaitQuery, type BarItem, type BlacksmithItem, BlacksmithQuery, type BooksellerAvailability, type BooksellerItem, BooksellerItemQuery, type BooksellerTrade, BooksellerTradeQuery, type Buff, type Building, type BuildingBuilder, type BuildingMaterial, BuildingQuery, type Bundle, type BundleItem, BundleQuery, type BundleReward, type BundleRoom, type CarpenterCategory, type CarpenterDay, type CarpenterItem, CarpenterQuery, type CasinoCategory, type CasinoItem, CasinoQuery, type CaskAging, type ChoppedTreeProduce, type CollectionItem, CollectionItemQuery, CollectionsQuery, type Concession, ConcessionQuery, type ConcessionTag, type CookedDish, type CookingBuff, CookingQuery, type CraftingIngredient, type CraftingOutput, CraftingQuery, type CraftingRecipe, type Crop, CropQuery, type DayOfWeek, type DesertTraderDay, type DesertTraderItem, DesertTraderQuery, type DwarfShopCategory, type DwarfShopItem, DwarfShopQuery, type EnergyHealth, EventQuery, type FarmAnimal, type FarmMap, FarmMapQuery, type Festival, type FieldOfficeCollection, type FieldOfficeCollectionData, type FieldOfficeDonation, FieldOfficeDonationQuery, FieldOfficeQuery, type FieldOfficeReward, type Fish, type FishCatchType, type FishPond, type FishPondProduce, FishQuery, type FishRoe, type FishWeather, type FishingRod, type FishingRodLevel, type Footwear, FootwearQuery, type Forageable, ForageableQuery, type FruitTree, type FruitTreeProduce, type GameEvent, type GameLocation, type GeodeContainer, type GeodeContent, type GiftPreferences, type GoldBundle, type GoldenWalnut, GoldenWalnutQuery, type GoldenWalnutTrackingType, type GrandpaCategory, GrandpaEvaluator, type GrandpaInput, type GrandpaResult, type GrandpaScoreEntry, type GuildCategory, type GuildItem, GuildQuery, type GuildWeaponType, type HarvestQuantity, type Hat, HatQuery, type HeartEvent, type HouseRenovation, HouseRenovationQuery, type HouseUpgrade, type HouseUpgradeMaterial, HouseUpgradeQuery, type Ingredient, type IslandTraderDay, type IslandTraderItem, IslandTraderQuery, type ItemBundle, type ItemQuality, type JojaBundle, type JojaItem, JojaQuery, type KnowledgeBonus, KnowledgeCalculator, type KrobusDay, type KrobusItem, KrobusQuery, type KrobusStockType, LATEST_API_VERSION, type LocationCategory, type LocationDay, type LocationHours, LocationQuery, type LocationType, type LostBook, LostBookQuery, MASTERY_LEVELS, type MarnieCategory, type MarnieItem, MarnieQuery, type MasteryLevel, type MasterySkill, type MasteryUnlock, type MedicalSupply, MedicalSupplyQuery, type MeleeWeapon, type Mineral, type MineralItem, MineralQuery, type MixedSeed, type MixedSeedProduces, MixedSeedQuery, type Monster, type MonsterLoot, MonsterLootQuery, MonsterQuery, type MonsterSlayerGoal, MonsterSlayerGoalQuery, type MonsterVariant, type NodeDrop, type NodeItem, type OasisCategory, type OasisDay, type OasisItem, OasisQuery, type OreItem, type PerfectionCategory, PerfectionQuery, type Pet, type PierreCategory, type PierreItem, PierreQuery, type PriceFormula, type ProfessionBonus, ProfessionCalculator, type ProfessionData, ProfessionQuery, type ProfessionSkill, type QiCurrency, type QiStockItem, QiStockQuery, type Quality, QualityCalculator, type QualityEnergyHealth, type QualityPrice, type Quest, QuestQuery, type RecipeSource, type ResourceItem, type Ring, RingQuery, SKILL_TITLES, type SaloonCategory, type SaloonItem, SaloonQuery, type SaveAnimal, type SaveBuilding, type SaveBundleData, type SaveBundleItem, type SaveBundleReward, type SaveBundleRoom, type SaveBundleStatus, type SaveChild, type SaveCollectionEntry, type SaveData, type SaveDate, type SaveFarm, type SaveFishEntry, type SaveFriendship, type SaveIslandUpgrades, type SaveItem, type SaveMastery, type SaveMasteryPerk, type SaveMineProgress, type SaveMonsterKillEntry, type SaveMuseum, type SavePerfection, type SavePet, type SavePlayer, type SavePowerEntry, type SavePowers, type SaveProfession, type SaveQuest, type SaveRaccoons, type SaveRecipeEntry, type SaveSecretNotes, type SaveShippedEntry, type SaveSkillLevel, type SaveSkills, type SaveSpecialOrders, type SaveStardropEntry, type SaveStats, type SaveWalnuts, type SearchResult, type SearchResultKind, type Season, type SeasonData, SeasonQuery, type SecretNote, SecretNoteQuery, type SecretNoteType, type SeedBuyPrice, type SimpleTool, type Skill, type SkillLevel, type SkillLevelRecipes, type SkillMastery, SkillQuery, type SlayerReward, type Slingshot, type SmeltRecipe, type SpecialItem, SpecialItemQuery, type SpecialItemType, type SpecialOrderCategory, type SpecialOrderData, SpecialOrderQuery, type Stage, type StarDrop, StarDropQuery, type StarDropSource, type Tackle, TackleQuery, type TitleThreshold, type Tool, type ToolLevel, ToolQuery, type ToolType, type TraderShopItem, type Tree, TreeQuery, type Trinket, TrinketQuery, type TrinketSource, type UniversalGifts, type UpgradeLevel, type UpgradeableTool, type VersionRange, type Villager, VillagerQuery, type VolcanoShopCategory, type VolcanoShopCurrency, type VolcanoShopItem, VolcanoShopQuery, type Weapon, WeaponQuery, type WeaponStat, WeaponStatQuery, type WeaponType, type Weather, WeatherQuery, type WildTree, type WildTreeTapper, type WillyCategory, type WillyItem, WillyQuery, type WizardBuilding, type WizardBuildingMaterial, WizardQuery, achievements, animals, applyPriceFormula, artifacts, artisanCalculator, artisanGoods, bait, blacksmith, booksellerShop, booksellerTrades, buildings, bundles, calculateArtisanPrice, carpenter, casino, collections, concessions, cooking, crafting, crops, desertTrader, dwarfShop, events, fieldOffice, fieldOfficeDonations, findFestival, fish, footwear, forageables, getMasteryLevel, getProfessionOptions, getTitle, getTitleScore, goldenWalnuts, grandpaEvaluator, guild, hats, houseRenovations, houseUpgrades, isFarmAnimal, isPet, islandTrader, joja, knowledgeCalculator, krobus, locations, lostBooks, maps, marnie, medicalSupplies, minerals, mixedSeeds, monsterLoot, monsterSlayerGoals, monsters, oasis, parseSaveFile, perfection, pierre, professionCalculator, professions, qiStock, qualityCalculator, quests, resolveApiVersion, rings, saloon, search, seasons, secretNotes, skills, specialItems, specialOrders, starDrops, tackle, tools, trees, trinkets, universalGifts, villagers, volcanoShop, weaponStats, weapons, weather, willy, wizard };
+export { type Achievement, AchievementQuery, type Animal, type AnimalProduce, AnimalQuery, type Artifact, ArtifactQuery, ArtisanCalculator, type ArtisanEnergyResult, type ArtisanGood, type ArtisanGoodBuff, ArtisanGoodQuery, type ArtisanIngredient, type ArtisanResult, type ArtisanUses, type Backpack, type Bait, BaitQuery, type BarItem, type BlacksmithItem, BlacksmithQuery, type BooksellerAvailability, type BooksellerItem, BooksellerItemQuery, type BooksellerTrade, BooksellerTradeQuery, type Buff, type Building, type BuildingBuilder, type BuildingMaterial, BuildingQuery, type Bundle, type BundleItem, BundleQuery, type BundleReward, type BundleRoom, type CarpenterCategory, type CarpenterDay, type CarpenterItem, CarpenterQuery, type CasinoCategory, type CasinoItem, CasinoQuery, type CaskAging, type ChoppedTreeProduce, type CollectionItem, CollectionItemQuery, CollectionsQuery, type Concession, ConcessionQuery, type ConcessionTag, type CookedDish, type CookingBuff, CookingQuery, type CraftingIngredient, type CraftingOutput, CraftingQuery, type CraftingRecipe, type Crop, CropQuery, type DayOfWeek, type DesertTraderDay, type DesertTraderItem, DesertTraderQuery, type DwarfShopCategory, type DwarfShopItem, DwarfShopQuery, type EnergyHealth, EventQuery, type FarmAnimal, type FarmMap, FarmMapQuery, type Festival, type FieldOfficeCollection, type FieldOfficeCollectionData, type FieldOfficeDonation, FieldOfficeDonationQuery, FieldOfficeQuery, type FieldOfficeReward, type Fish, type FishCatchType, type FishPond, type FishPondProduce, FishQuery, type FishRoe, type FishWeather, type FishingRod, type FishingRodLevel, type Footwear, FootwearQuery, type Forageable, ForageableQuery, type FruitTree, type FruitTreeProduce, type GameEvent, type GameLocation, type GeodeContainer, type GeodeContent, type GiftPreferences, type GoldBundle, type GoldenWalnut, GoldenWalnutQuery, type GoldenWalnutTrackingType, type GrandpaCategory, GrandpaEvaluator, type GrandpaInput, type GrandpaResult, type GrandpaScoreEntry, type GuildCategory, type GuildItem, GuildQuery, type GuildWeaponType, type HarvestQuantity, type Hat, HatQuery, type HeartEvent, type HouseRenovation, HouseRenovationQuery, type HouseUpgrade, type HouseUpgradeMaterial, HouseUpgradeQuery, type Ingredient, type IslandTraderDay, type IslandTraderItem, IslandTraderQuery, type ItemBundle, type ItemQuality, type JojaBundle, type JojaItem, JojaParrotCalculator, JojaQuery, type KnowledgeBonus, KnowledgeCalculator, type KrobusDay, type KrobusItem, KrobusQuery, type KrobusStockType, LATEST_API_VERSION, type LocationCategory, type LocationDay, type LocationHours, LocationQuery, type LocationType, type LostBook, LostBookQuery, MASTERY_LEVELS, type MarnieCategory, type MarnieItem, MarnieQuery, type MasteryLevel, type MasterySkill, type MasteryUnlock, type MedicalSupply, MedicalSupplyQuery, type MeleeWeapon, type Mineral, type MineralItem, MineralQuery, type MixedSeed, type MixedSeedProduces, MixedSeedQuery, type Monster, type MonsterLoot, MonsterLootQuery, MonsterQuery, type MonsterSlayerGoal, MonsterSlayerGoalQuery, type MonsterVariant, type NodeDrop, type NodeItem, type OasisCategory, type OasisDay, type OasisItem, OasisQuery, type OreItem, type PerfectionCategory, PerfectionQuery, type Pet, type PierreCategory, type PierreItem, PierreQuery, type PriceFormula, type ProfessionBonus, ProfessionCalculator, type ProfessionData, ProfessionQuery, type ProfessionSkill, type QiCurrency, type QiStockItem, QiStockQuery, type Quality, QualityCalculator, type QualityEnergyHealth, type QualityPrice, type Quest, QuestQuery, type RecipeSource, type ResourceItem, type Ring, RingQuery, SKILL_TITLES, type SaloonCategory, type SaloonItem, SaloonQuery, type SaveAnimal, type SaveBuilding, type SaveBundleData, type SaveBundleItem, type SaveBundleReward, type SaveBundleRoom, type SaveBundleStatus, type SaveChild, type SaveCollectionEntry, type SaveData, type SaveDate, type SaveFarm, type SaveFishEntry, type SaveFriendship, type SaveIslandUpgrades, type SaveItem, type SaveMastery, type SaveMasteryPerk, type SaveMineProgress, type SaveMonsterKillEntry, type SaveMuseum, type SavePerfection, type SavePet, type SavePlayer, type SavePowerEntry, type SavePowers, type SaveProfession, type SaveQuest, type SaveRaccoons, type SaveRecipeEntry, type SaveSecretNotes, type SaveShippedEntry, type SaveSkillLevel, type SaveSkills, type SaveSpecialOrders, type SaveStardropEntry, type SaveStats, type SaveWalnuts, type SearchResult, type SearchResultKind, type Season, type SeasonData, SeasonQuery, type SecretNote, SecretNoteQuery, type SecretNoteType, type SeedBuyPrice, type SimpleTool, type Skill, type SkillLevel, type SkillLevelRecipes, type SkillMastery, SkillQuery, type SlayerReward, type Slingshot, type SmeltRecipe, type SpecialItem, SpecialItemQuery, type SpecialItemType, type SpecialOrderCategory, type SpecialOrderData, SpecialOrderQuery, type Stage, type StarDrop, StarDropQuery, type StarDropSource, type Tackle, TackleQuery, type TitleThreshold, type Tool, type ToolLevel, ToolQuery, type ToolType, type TraderShopItem, type Tree, TreeQuery, type Trinket, TrinketQuery, type TrinketSource, type UniversalGifts, type UpgradeLevel, type UpgradeableTool, type VersionRange, type Villager, VillagerQuery, type VolcanoShopCategory, type VolcanoShopCurrency, type VolcanoShopItem, VolcanoShopQuery, type Weapon, WeaponQuery, type WeaponStat, WeaponStatQuery, type WeaponType, type Weather, WeatherQuery, type WildTree, type WildTreeTapper, type WillyCategory, type WillyItem, WillyQuery, type WizardBuilding, type WizardBuildingMaterial, WizardQuery, achievements, animals, applyPriceFormula, artifacts, artisanCalculator, artisanGoods, bait, blacksmith, booksellerShop, booksellerTrades, buildings, bundles, calculateArtisanPrice, carpenter, casino, collections, concessions, cooking, crafting, crops, desertTrader, dwarfShop, events, fieldOffice, fieldOfficeDonations, findFestival, fish, footwear, forageables, getMasteryLevel, getProfessionOptions, getTitle, getTitleScore, goldenWalnuts, grandpaEvaluator, guild, hats, houseRenovations, houseUpgrades, isFarmAnimal, isPet, islandTrader, joja, jojaParrotCalculator, knowledgeCalculator, krobus, locations, lostBooks, maps, marnie, medicalSupplies, minerals, mixedSeeds, monsterLoot, monsterSlayerGoals, monsters, oasis, parseSaveFile, perfection, pierre, professionCalculator, professions, qiStock, qualityCalculator, quests, resolveApiVersion, rings, saloon, search, seasons, secretNotes, skills, specialItems, specialOrders, starDrops, tackle, tools, trees, trinkets, universalGifts, villagers, volcanoShop, weaponStats, weapons, weather, willy, wizard };

package/dist/index.js

@@ -55,6 +55,7 @@ __export(index_exports, {
   HouseRenovationQuery: () => HouseRenovationQuery,
   HouseUpgradeQuery: () => HouseUpgradeQuery,
   IslandTraderQuery: () => IslandTraderQuery,
+  JojaParrotCalculator: () => JojaParrotCalculator,
   JojaQuery: () => JojaQuery,
   KnowledgeCalculator: () => KnowledgeCalculator,
   KrobusQuery: () => KrobusQuery,
@@ -140,6 +141,7 @@ __export(index_exports, {
   isPet: () => isPet,
   islandTrader: () => islandTrader,
   joja: () => joja,
+  jojaParrotCalculator: () => jojaParrotCalculator,
   knowledgeCalculator: () => knowledgeCalculator,
   krobus: () => krobus,
   locations: () => locations,
@@ -4550,6 +4552,30 @@ var KnowledgeCalculator = class {
 function knowledgeCalculator() {
   return new KnowledgeCalculator();
 }
+var TOTAL_GOLDEN_WALNUTS = 130;
+var JOJA_PARROT_COST_PER_WALNUT = 1e4;
+var JojaParrotCalculator = class {
+  /** Calculate the gold cost to buy all remaining walnuts. */
+  cost(walnutsFound) {
+    const remaining = Math.max(0, TOTAL_GOLDEN_WALNUTS - walnutsFound);
+    return remaining * JOJA_PARROT_COST_PER_WALNUT;
+  }
+  /** Returns how many walnuts are still unfound. */
+  remaining(walnutsFound) {
+    return Math.max(0, TOTAL_GOLDEN_WALNUTS - walnutsFound);
+  }
+  /** The total number of Golden Walnuts available in the game. */
+  get total() {
+    return TOTAL_GOLDEN_WALNUTS;
+  }
+  /** The cost per individual unfound walnut (10,000g). */
+  get costPerWalnut() {
+    return JOJA_PARROT_COST_PER_WALNUT;
+  }
+};
+function jojaParrotCalculator() {
+  return new JojaParrotCalculator();
+}
 
 // data/crops.json
 var crops_default = [
@@ -41117,21 +41143,94 @@ function parseInventory(items) {
   return result;
 }
 
+// data/island-upgrades.json
+var island_upgrades_default = [
+  {
+    id: "Island_FirstParrot",
+    name: "Ginger Island North",
+    description: "Feed Leo's parrot friend to unlock access to the north side of the island.",
+    cost: 1,
+    location: "Leo's Hut"
+  },
+  {
+    id: "Island_Turtle",
+    name: "Ginger Island West",
+    description: "A turtle ferries the player to the western island region.",
+    cost: 10,
+    location: "Leo's Hut area"
+  },
+  {
+    id: "Island_UpgradeHouse",
+    name: "Island Farmhouse",
+    description: "Provides sleeping quarters on the west side of the island so the player can stay overnight.",
+    cost: 20,
+    location: "Ginger Island West"
+  },
+  {
+    id: "Island_Resort",
+    name: "Island Resort",
+    description: "Unlocks the beach resort on the south side of the island. Villagers can visit.",
+    cost: 20,
+    location: "Island South"
+  },
+  {
+    id: "Island_UpgradeTrader",
+    name: "Island Trader",
+    description: "Unlocks the Island Trader shop on the north side of the island.",
+    cost: 10,
+    location: "Island North"
+  },
+  {
+    id: "Island_UpgradeBridge",
+    name: "Dig Site Bridge",
+    description: "Repairs the bridge to access the island dig site.",
+    cost: 10,
+    location: "Island North"
+  },
+  {
+    id: "Island_UpgradeParrotPlatform",
+    name: "Parrot Express",
+    description: "Enables the fast-travel parrot platform system around the island.",
+    cost: 10,
+    location: "Ginger Island (multiple stops)"
+  },
+  {
+    id: "Island_UpgradeHouse_Mailbox",
+    name: "Farmhouse Mailbox",
+    description: "Adds a mailbox to the island farmhouse so the player can receive mail.",
+    cost: 5,
+    location: "Island Farmhouse"
+  },
+  {
+    id: "Island_W_Obelisk",
+    name: "Farm Obelisk",
+    description: "Builds an obelisk near the island farmhouse that teleports the player back to the farm.",
+    cost: 20,
+    location: "Island Farmhouse"
+  },
+  {
+    id: "Island_VolcanoBridge",
+    name: "Volcano Bridge",
+    description: "Builds a permanent bridge at the volcano dungeon entrance.",
+    cost: 5,
+    location: "Volcano Dungeon entrance"
+  },
+  {
+    id: "Island_VolcanoShortcutOut",
+    name: "Volcano Exit Shortcut",
+    description: "Creates a shortcut exit passage on volcano dungeon level 5.",
+    cost: 5,
+    location: "Volcano Dungeon level 5"
+  }
+];
+
 // src/save-file/parsers/v1/island-upgrades.ts
+var UPGRADE_IDS = island_upgrades_default.map((u) => u.id);
 function parseIslandUpgrades(mail) {
-  return {
-    firstParrot: mail.has("Island_FirstParrot"),
-    turtle: mail.has("Island_Turtle"),
-    house: mail.has("Island_UpgradeHouse"),
-    resort: mail.has("Island_Resort"),
-    trader: mail.has("Island_UpgradeTrader"),
-    bridge: mail.has("Island_UpgradeBridge"),
-    parrotPlatforms: mail.has("Island_UpgradeParrotPlatform"),
-    mailbox: mail.has("Island_UpgradeHouse_Mailbox"),
-    obelisk: mail.has("Island_W_Obelisk"),
-    volcanoBridge: mail.has("Island_VolcanoBridge"),
-    volcanoShortcut: mail.has("Island_VolcanoShortcutOut")
-  };
+  return UPGRADE_IDS.map((id) => ({
+    id,
+    unlocked: mail.has(id)
+  }));
 }
 
 // src/save-file/parsers/v1/mail.ts
@@ -41744,6 +41843,7 @@ function parseSaveFile(xml) {
   HouseRenovationQuery,
   HouseUpgradeQuery,
   IslandTraderQuery,
+  JojaParrotCalculator,
   JojaQuery,
   KnowledgeCalculator,
   KrobusQuery,
@@ -41829,6 +41929,7 @@ function parseSaveFile(xml) {
   isPet,
   islandTrader,
   joja,
+  jojaParrotCalculator,
   knowledgeCalculator,
   krobus,
   locations,