stardew-valley-data 0.31.0 → 0.32.0

package/CHANGELOG.md

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

package/dist/index.d.mts

@@ -2674,7 +2674,7 @@ interface SaveData {
     walnuts: SaveWalnuts;
     islandUpgrades: SaveIslandUpgrades;
     children: SaveChild[];
-    pet: SavePet | null;
+    pets: SavePet[];
     horse: SaveHorse | null;
     powers: SavePowers;
     raccoons: SaveRaccoons;
@@ -2706,15 +2706,27 @@ interface SavePlayer {
     gameVersion: string;
     millisecondsPlayed: number;
 }
-/** Upgrade levels for the player's tools (0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
+/** A tool currently being upgraded at the blacksmith. */
+interface SaveUpgradingTool {
+    tool: 'wateringCan' | 'pan' | 'pickaxe' | 'axe' | 'hoe';
+    name: string;
+}
+/** Level and active enchantment for a single tool. Enchantment is null when none is applied. */
+interface SaveToolLevel {
+    level: number;
+    enchantment: string | null;
+}
+/** Upgrade levels and enchantments for the player's tools (level 0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
 interface SaveToolLevels {
-    wateringCan: number;
-    pan: number;
-    pickaxe: number;
-    axe: number;
-    hoe: number;
-    trashCan: number;
-    fishingRod: number;
+    wateringCan: SaveToolLevel;
+    pan: SaveToolLevel;
+    pickaxe: SaveToolLevel;
+    axe: SaveToolLevel;
+    hoe: SaveToolLevel;
+    trashCan: SaveToolLevel;
+    fishingRod: SaveToolLevel;
+    /** The tool currently at the blacksmith being upgraded, or null if none. */
+    currentlyUpgrading: SaveUpgradingTool | null;
 }
 /** Mastery system progress including XP, levels spent, and unlocked perks. */
 interface SaveMastery {
@@ -2915,12 +2927,13 @@ interface SaveChild {
     age: number;
     gender: string;
 }
-/** The player's pet with type, breed variant, and friendship level. */
+/** A pet owned by the player. `starter` is true for the pet chosen at game start. */
 interface SavePet {
     name: string;
     type: string;
     breed: number;
     friendship: number;
+    starter: boolean;
 }
 /** The player's horse with name and unique ID. */
 interface SaveHorse {

package/dist/index.d.ts

@@ -2674,7 +2674,7 @@ interface SaveData {
     walnuts: SaveWalnuts;
     islandUpgrades: SaveIslandUpgrades;
     children: SaveChild[];
-    pet: SavePet | null;
+    pets: SavePet[];
     horse: SaveHorse | null;
     powers: SavePowers;
     raccoons: SaveRaccoons;
@@ -2706,15 +2706,27 @@ interface SavePlayer {
     gameVersion: string;
     millisecondsPlayed: number;
 }
-/** Upgrade levels for the player's tools (0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
+/** A tool currently being upgraded at the blacksmith. */
+interface SaveUpgradingTool {
+    tool: 'wateringCan' | 'pan' | 'pickaxe' | 'axe' | 'hoe';
+    name: string;
+}
+/** Level and active enchantment for a single tool. Enchantment is null when none is applied. */
+interface SaveToolLevel {
+    level: number;
+    enchantment: string | null;
+}
+/** Upgrade levels and enchantments for the player's tools (level 0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
 interface SaveToolLevels {
-    wateringCan: number;
-    pan: number;
-    pickaxe: number;
-    axe: number;
-    hoe: number;
-    trashCan: number;
-    fishingRod: number;
+    wateringCan: SaveToolLevel;
+    pan: SaveToolLevel;
+    pickaxe: SaveToolLevel;
+    axe: SaveToolLevel;
+    hoe: SaveToolLevel;
+    trashCan: SaveToolLevel;
+    fishingRod: SaveToolLevel;
+    /** The tool currently at the blacksmith being upgraded, or null if none. */
+    currentlyUpgrading: SaveUpgradingTool | null;
 }
 /** Mastery system progress including XP, levels spent, and unlocked perks. */
 interface SaveMastery {
@@ -2915,12 +2927,13 @@ interface SaveChild {
     age: number;
     gender: string;
 }
-/** The player's pet with type, breed variant, and friendship level. */
+/** A pet owned by the player. `starter` is true for the pet chosen at game start. */
 interface SavePet {
     name: string;
     type: string;
     breed: number;
     friendship: number;
+    starter: boolean;
 }
 /** The player's horse with name and unique ID. */
 interface SaveHorse {

package/dist/index.js

@@ -41140,7 +41140,10 @@ function parseChildren(root) {
   }
   return result;
 }
-function parsePet(root) {
+function parsePets(root, player) {
+  const results = [];
+  const starterType = str(player?.whichPetType);
+  const starterBreed = num(player?.whichPetBreed);
   const locations2 = ensureArray(root.locations?.GameLocation);
   for (const loc of locations2) {
     const l = loc;
@@ -41153,15 +41156,18 @@ function parsePet(root) {
         n["@_xsi:type"] ?? n["@_type"]
       );
       if (xsiType !== "Pet" && xsiType !== "Cat" && xsiType !== "Dog") continue;
-      return {
+      const type = str(n.petType, xsiType);
+      const breed = num(n.whichBreed);
+      results.push({
         name: str(n.name),
-        type: str(n.petType, xsiType),
-        breed: num(n.whichBreed),
-        friendship: num(n.friendshipTowardFarmer)
-      };
+        type,
+        breed,
+        friendship: num(n.friendshipTowardFarmer),
+        starter: type === starterType && breed === starterBreed
+      });
     }
   }
-  return null;
+  return results;
 }
 function parseHorse(root) {
   const locations2 = ensureArray(root.locations?.GameLocation);
@@ -41611,16 +41617,41 @@ function collectToolItems(node, depth = 0) {
   }
   return results;
 }
+function getEnchantmentName(item) {
+  const enc = item.enchantments;
+  if (!enc) return null;
+  const first = Array.isArray(enc) ? enc[0] : enc;
+  if (!first || typeof first !== "object") return null;
+  const xsiType = first["@_xsi:type"] ?? "";
+  return xsiType.replace(/Enchantment$/, "") || null;
+}
+function toolLevel(level, enchantment = null) {
+  return { level, enchantment };
+}
 function parseToolLevels(player, root) {
   const levels = {
-    wateringCan: 0,
-    pan: 0,
-    pickaxe: 0,
-    axe: 0,
-    hoe: 0,
-    trashCan: num(player.trashCanLevel),
-    fishingRod: -1
+    wateringCan: toolLevel(0),
+    pan: toolLevel(0),
+    pickaxe: toolLevel(0),
+    axe: toolLevel(0),
+    hoe: toolLevel(0),
+    trashCan: toolLevel(num(player.trashCanLevel)),
+    fishingRod: toolLevel(-1),
+    currentlyUpgrading: null
   };
+  const upgrading = player.toolBeingUpgraded;
+  if (upgrading) {
+    const xsiType = upgrading["@_xsi:type"] ?? upgrading["@_type"] ?? "";
+    const key = TOOL_KEY_MAP[xsiType];
+    if (key) {
+      const offset = key === "pan" ? 2 : 1;
+      const currentLevel = num(upgrading.upgradeLevel) - offset;
+      if (currentLevel > levels[key].level) {
+        levels[key] = toolLevel(currentLevel, getEnchantmentName(upgrading));
+      }
+      levels.currentlyUpgrading = { tool: key, name: str(upgrading.name) };
+    }
+  }
   const allItems2 = [
     ...collectToolItems(player.items),
     ...collectToolItems(root.locations?.GameLocation)
@@ -41631,10 +41662,14 @@ function parseToolLevels(player, root) {
     const key = TOOL_KEY_MAP[xsiType];
     if (key) {
       const level = num(i.upgradeLevel);
-      if (level > levels[key]) levels[key] = level;
+      if (level > levels[key].level) {
+        levels[key] = toolLevel(level, getEnchantmentName(i));
+      }
     } else if (xsiType === "FishingRod") {
       const rodLevel = FISHING_ROD_LEVEL[i.name] ?? -1;
-      if (rodLevel > levels.fishingRod) levels.fishingRod = rodLevel;
+      if (rodLevel > levels.fishingRod.level) {
+        levels.fishingRod = toolLevel(rodLevel, getEnchantmentName(i));
+      }
     }
   }
   return levels;
@@ -41882,7 +41917,7 @@ var v1 = (ctx) => ({
   walnuts: parseWalnuts(ctx.root),
   islandUpgrades: parseIslandUpgrades(ctx.mailSet),
   children: parseChildren(ctx.root),
-  pet: parsePet(ctx.root),
+  pets: parsePets(ctx.root, ctx.player),
   horse: parseHorse(ctx.root),
   powers: parsePowers(ctx.mailSet, ctx.eventsSet),
   raccoons: parseRaccoons(ctx.root, ctx.mailSet),