dsh-piggy 0.25.0

package/packages/pet-core/src/data/minutes.js

@@ -0,0 +1,23 @@
+// @ts-check
+/**
+ * 时间常量 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/data/minutes
+ */
+
+export const MINUTES = Object.freeze({
+  quarter: 15,
+  half: 30,
+  hour: 60,
+  ninety: 90,
+  twoHours: 120,
+  threeHours: 180,
+  fourHours: 240,
+  sixHours: 360,
+  eightHours: 480,
+  halfDay: 720,
+  day: 1440,
+})
+
+// ---------------------------------------------------------------------------
+// Illness — three chains of four stages, straight from the reverse engineering.
+// ---------------------------------------------------------------------------

package/packages/pet-core/src/data/profile.js

@@ -0,0 +1,60 @@
+// @ts-check
+/**
+ * 居民卡：性格、口头禅、签名、星座 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ *
+ * B9（用户 2026-10-01）：照动森居民卡。性格在拆纸盒时随机一种，带一个默认口头禅和签名；
+ * 口头禅和签名主人都能改，猪说话时会不时带上口头禅。
+ * @module dsh-piggy/data/profile
+ */
+
+/**
+ * @typedef {object} Personality
+ * @property {string} key
+ * @property {string} label
+ * @property {string} emoji
+ * @property {string} catchphrase - 默认口头禅
+ * @property {string} motto - 默认签名
+ */
+
+/** @type {ReadonlyArray<Personality>} */
+export const PERSONALITIES = Object.freeze([
+  Object.freeze({ key: 'peppy', label: '元气', emoji: '🌟', catchphrase: '嘿嘿', motto: '今天也要元气满满！' }),
+  Object.freeze({ key: 'lazy', label: '悠闲', emoji: '😴', catchphrase: '呼噜', motto: '能躺着，绝不坐着。' }),
+  Object.freeze({ key: 'cranky', label: '暴躁', emoji: '😤', catchphrase: '哼', motto: '别惹我，除非你带了吃的。' }),
+  Object.freeze({ key: 'sisterly', label: '大姐姐', emoji: '💁', catchphrase: '懂吗', motto: '有事找我，我罩着你。' }),
+  Object.freeze({ key: 'snooty', label: '自恋', emoji: '💅', catchphrase: '啧啧', motto: '我是这片最可爱的猪。' }),
+  Object.freeze({ key: 'normal', label: '普通', emoji: '🙂', catchphrase: '嗯嗯', motto: '平平淡淡才是真。' }),
+])
+
+export const personalityByKey = key => PERSONALITIES.find(entry => entry.key === key) ?? null
+
+/** 口头禅最多几个字。 */
+export const CATCHPHRASE_MAX = 6
+
+/** 签名最多几个字。 */
+export const MOTTO_MAX = 24
+
+/** 猪说一句话时，句末带上口头禅的概率。 */
+export const CATCHPHRASE_CHANCE = 0.4
+
+/** 这些场景不带口头禅：生病、吃错药、走了的时候不该卖萌。 */
+export const SERIOUS_SCENES = Object.freeze(['death', 'sick', 'wrongMedicine'])
+
+/**
+ * 星座：每个星座的**起始**月日（含），按日历顺序；1 月 1 日到 1 月 19 日落在最后一行之后，
+ * 即摩羯座（从上一年 12 月 22 日开始）。
+ */
+export const ZODIAC = Object.freeze([
+  Object.freeze({ month: 1, day: 20, label: '水瓶座', emoji: '♒' }),
+  Object.freeze({ month: 2, day: 19, label: '双鱼座', emoji: '♓' }),
+  Object.freeze({ month: 3, day: 21, label: '白羊座', emoji: '♈' }),
+  Object.freeze({ month: 4, day: 20, label: '金牛座', emoji: '♉' }),
+  Object.freeze({ month: 5, day: 21, label: '双子座', emoji: '♊' }),
+  Object.freeze({ month: 6, day: 22, label: '巨蟹座', emoji: '♋' }),
+  Object.freeze({ month: 7, day: 23, label: '狮子座', emoji: '♌' }),
+  Object.freeze({ month: 8, day: 23, label: '处女座', emoji: '♍' }),
+  Object.freeze({ month: 9, day: 23, label: '天秤座', emoji: '♎' }),
+  Object.freeze({ month: 10, day: 24, label: '天蝎座', emoji: '♏' }),
+  Object.freeze({ month: 11, day: 23, label: '射手座', emoji: '♐' }),
+  Object.freeze({ month: 12, day: 22, label: '摩羯座', emoji: '♑' }),
+])

package/packages/pet-core/src/data/school.js

@@ -0,0 +1,99 @@
+// @ts-check
+/**
+ * 九门课与课时学段 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ *
+ * 数字全部来自 docs/tasks/numbers/B4-study-jobs.md（用户 2026-10-01 确认）。
+ * 照 QQ 宠物怀旧服 GrowUp.js：九门课各算各的课时，一门课上到第 9 / 20 / 40 / 95 节
+ * 就算这门课小学 / 中学 / 大学 / 研究生毕业，不需要九门一起升。
+ *
+ * @module dsh-piggy/data/school
+ */
+
+/**
+ * @typedef {object} Subject
+ * @property {string} key
+ * @property {string} label
+ * @property {string} emoji
+ * @property {'intel'|'charm'|'strong'} trait - 主要涨的属性
+ * @property {'intel'|'charm'|'strong'|null} secondary - 顺带涨的属性
+ */
+
+/**
+ * @param {string} key
+ * @param {string} label
+ * @param {string} emoji
+ * @param {'intel'|'charm'|'strong'} trait
+ * @param {'intel'|'charm'|'strong'|null} [secondary]
+ * @returns {Subject}
+ */
+const subject = (key, label, emoji, trait, secondary = null) => Object.freeze({ key, label, emoji, trait, secondary })
+
+/** @type {ReadonlyArray<Subject>} */
+export const SUBJECTS = Object.freeze([
+  subject('chinese', '语文', '📖', 'intel', 'charm'),
+  subject('mathematics', '数学', '🔢', 'intel'),
+  subject('politics', '政治', '⚖️', 'intel', 'strong'),
+  subject('music', '音乐', '🎵', 'charm'),
+  subject('art', '艺术', '🎨', 'charm', 'intel'),
+  subject('manners', '礼仪', '🎩', 'charm'),
+  subject('pe', '体育', '🏃', 'strong', 'charm'),
+  subject('labour', '劳技', '🔧', 'strong', 'intel'),
+  subject('wushu', '武术', '🥋', 'strong'),
+])
+
+export const subjectByKey = key => SUBJECTS.find(entry => entry.key === key) ?? null
+
+/**
+ * @typedef {object} SchoolStage
+ * @property {string} key
+ * @property {string} label
+ * @property {string} emoji
+ * @property {number} upTo - 这门课上到第几节还算这个学段（含）；最后一档是 Infinity
+ * @property {number} minutes - 每节时长
+ * @property {number} tuition - 每节学费
+ * @property {number} gain - 主属性 +
+ * @property {number} secondaryGain - 顺带属性 +
+ * @property {number} satiety - 每节消耗饱食
+ * @property {number} happiness - 每节消耗心情
+ */
+
+/**
+ * Where a subject is, by how many lessons of it the pig has taken. Lesson N
+ * belongs to the first stage whose `upTo` is ≥ N; finishing the lesson numbered
+ * exactly `upTo` is that stage's graduation.
+ * @type {ReadonlyArray<SchoolStage>}
+ */
+export const SCHOOL_STAGES = Object.freeze([
+  Object.freeze({ key: 'primary', label: '小学', emoji: '📚', upTo: 9, minutes: 20, tuition: 10, gain: 1, secondaryGain: 0, satiety: -5, happiness: -1 }),
+  Object.freeze({ key: 'middle', label: '中学', emoji: '🏫', upTo: 20, minutes: 30, tuition: 25, gain: 2, secondaryGain: 1, satiety: -7, happiness: -2 }),
+  Object.freeze({ key: 'college', label: '大学', emoji: '🏛', upTo: 40, minutes: 45, tuition: 60, gain: 3, secondaryGain: 1, satiety: -10, happiness: -3 }),
+  Object.freeze({ key: 'graduate', label: '研究生', emoji: '🔬', upTo: 95, minutes: 60, tuition: 120, gain: 4, secondaryGain: 2, satiety: -12, happiness: -4 }),
+  Object.freeze({ key: 'beyond', label: '学无止境', emoji: '🌌', upTo: Infinity, minutes: 60, tuition: 150, gain: 5, secondaryGain: 2, satiety: -12, happiness: -4 }),
+])
+
+/** Lesson counts that end a stage: finishing one of these is a graduation. */
+export const GRADUATION_LESSONS = Object.freeze(SCHOOL_STAGES.filter(stage => Number.isFinite(stage.upTo)).map(stage => stage.upTo))
+
+export const schoolStageByKey = key => SCHOOL_STAGES.find(stage => stage.key === key) ?? null
+
+/**
+ * The stage the *next* lesson of a subject belongs to, given how many have been
+ * taken. 0 taken → lesson 1 → 小学; 9 taken → lesson 10 → 中学.
+ * @param {number} taken
+ * @returns {SchoolStage}
+ */
+export function stageForNextLesson(taken) {
+  const lesson = Math.max(0, Math.floor(Number.isFinite(taken) ? taken : 0)) + 1
+  return SCHOOL_STAGES.find(stage => lesson <= stage.upTo) ?? SCHOOL_STAGES[SCHOOL_STAGES.length - 1]
+}
+
+/**
+ * The stage a subject has *finished*, or null before its first graduation.
+ * @param {number} taken
+ * @returns {SchoolStage|null}
+ */
+export function graduatedStage(taken) {
+  let done = null
+  for (const stage of SCHOOL_STAGES) if (Number.isFinite(stage.upTo) && taken >= stage.upTo) done = stage
+  return done
+}

package/packages/pet-core/src/data/shop.js

@@ -0,0 +1,142 @@
+// @ts-check
+/**
+ * 商店、装扮与照护物品 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/data/shop
+ */
+
+import { MEDICINES, REVIVE_ITEM } from './illness.js'
+
+/** @type {ShopItem} */
+export const DEFAULT_TOY = Object.freeze({
+  key: 'ball', label: '小皮球', emoji: '🎾', price: 0, kind: 'toy',
+  happiness: 12, satiety: -3, default: true,
+})
+
+/**
+ * One shelf entry. Everything past `kind` is optional: food carries satiety,
+ * medicine carries a tier (and 百草丹 `cureAll`), 装扮 carries a slot and a level gate.
+ *
+ * @typedef {object} ShopItem
+ * @property {string} key
+ * @property {string} label
+ * @property {string} emoji
+ * @property {number} price
+ * @property {string} kind
+ * @property {number} [satiety]
+ * @property {number} [happiness]
+ * @property {number} [cleanliness]
+ * @property {number} [health]
+ * @property {number} [level]
+ * @property {boolean} [default]
+ * @property {boolean} [needed]
+ * @property {string} [slot]
+ * @property {number} [tier]
+ * @property {boolean} [cureAll]
+ * @property {string} [blurb]
+ */
+/**
+ * 装扮的等级门槛按 B2 的 60 级曲线重排（2026-10-01）：Lv10 约 5 天、Lv20 约 20 天、
+ * Lv40 约 2.7 个月、Lv50 约 4 个月 —— 翅膀是养了小半年的猪才穿得上的。
+ * @type {ReadonlyArray<ShopItem>}
+ */
+export const SHOP = Object.freeze([
+  // --- food ---------------------------------------------------------------
+  Object.freeze({ key: 'apple', label: '苹果', emoji: '🍎', price: 6, kind: 'food', satiety: 22, happiness: 3 }),
+  Object.freeze({ key: 'bread', label: '面包', emoji: '🍞', price: 10, kind: 'food', satiety: 32, happiness: 4 }),
+  Object.freeze({ key: 'bone', label: '肉骨头', emoji: '🍖', price: 15, kind: 'food', satiety: 45, happiness: 8, cleanliness: -4 }),
+  Object.freeze({ key: 'rice', label: '蛋炒饭', emoji: '🍚', price: 24, kind: 'food', satiety: 58, happiness: 10 }),
+  Object.freeze({ key: 'cake', label: '奶油蛋糕', emoji: '🎂', price: 40, kind: 'food', satiety: 80, happiness: 18, cleanliness: -8 }),
+  Object.freeze({ key: 'noodle', label: '大碗拉面', emoji: '🍜', price: 66, kind: 'food', satiety: 100, happiness: 26, cleanliness: -6 }),
+  Object.freeze({ key: 'fish', label: '小鱼干', emoji: '🐟', price: 12, kind: 'food', satiety: 30, happiness: 7 }),
+  Object.freeze({ key: 'pumpkin', label: '南瓜粥', emoji: '🎃', price: 34, kind: 'food', satiety: 62, happiness: 13 }),
+  Object.freeze({ key: 'skewer', label: '烤肉串', emoji: '🍢', price: 58, kind: 'food', satiety: 76, happiness: 21, cleanliness: -7 }),
+  Object.freeze({ key: 'feast', label: '豪华大餐', emoji: '🍱', price: 130, kind: 'food', satiety: 100, happiness: 34, cleanliness: -10 }),
+  // --- bath ---------------------------------------------------------------
+  Object.freeze({ key: 'soap', label: '香皂', emoji: '🧼', price: 6, kind: 'bath', cleanliness: 35, happiness: 2 }),
+  Object.freeze({ key: 'shower', label: '冲个澡', emoji: '🚿', price: 10, kind: 'bath', cleanliness: 50, happiness: 3 }),
+  Object.freeze({ key: 'shampoo', label: '沐浴露', emoji: '🧴', price: 14, kind: 'bath', cleanliness: 65, happiness: 6 }),
+  Object.freeze({ key: 'bubble', label: '泡泡浴', emoji: '🛁', price: 28, kind: 'bath', cleanliness: 100, happiness: 14 }),
+  Object.freeze({ key: 'sauna', label: '泡温泉', emoji: '🧖', price: 58, kind: 'bath', cleanliness: 100, happiness: 24, satiety: -8 }),
+  Object.freeze({ key: 'candle', label: '香薰', emoji: '🕯', price: 22, kind: 'bath', cleanliness: 58, happiness: 13 }),
+  Object.freeze({ key: 'milkbath', label: '牛奶浴', emoji: '🥛', price: 44, kind: 'bath', cleanliness: 85, happiness: 19 }),
+  Object.freeze({ key: 'deadsea', label: '死海泥', emoji: '🫧', price: 78, kind: 'bath', cleanliness: 100, happiness: 27, satiety: -6 }),
+  // --- toys ---------------------------------------------------------------
+  Object.freeze({ key: 'yoyo', label: '悠悠球', emoji: '🪀', price: 30, kind: 'toy', happiness: 22, satiety: -4 }),
+  Object.freeze({ key: 'blocks', label: '积木', emoji: '🎲', price: 45, kind: 'toy', happiness: 30, satiety: -5 }),
+  Object.freeze({ key: 'plush', label: '布偶', emoji: '🧸', price: 75, kind: 'toy', happiness: 42, satiety: -7 }),
+  Object.freeze({ key: 'scooter', label: '滑板车', emoji: '🛴', price: 120, kind: 'toy', happiness: 58, satiety: -10, cleanliness: -6 }),
+  Object.freeze({ key: 'carousel', label: '旋转木马', emoji: '🎠', price: 260, kind: 'toy', happiness: 80, satiety: -12, cleanliness: -8 }),
+  Object.freeze({ key: 'balloon', label: '气球', emoji: '🎈', price: 22, kind: 'toy', happiness: 24, satiety: -3 }),
+  Object.freeze({ key: 'puzzle', label: '拼图', emoji: '🧩', price: 60, kind: 'toy', happiness: 34, satiety: -5 }),
+  Object.freeze({ key: 'kite', label: '风筝', emoji: '🪁', price: 95, kind: 'toy', happiness: 48, satiety: -7 }),
+  Object.freeze({ key: 'rccar', label: '遥控车', emoji: '🏎', price: 180, kind: 'toy', happiness: 62, satiety: -9, cleanliness: -6 }),
+  Object.freeze({ key: 'bubbles', label: '泡泡机', emoji: '🫧', price: 220, kind: 'toy', happiness: 74, satiety: -10, cleanliness: -8 }),
+  // --- dress (家当) --------------------------------------------------------
+  // Not consumables: buy once, own forever, wear them. Each one needs a level,
+  // which is what ties 装扮 to the level axis instead of to the wallet.
+  // `slot` is a fixed anchor on the pig (see DRESS_SLOTS); one item per slot,
+  // so the artwork can be swapped in later without touching the logic.
+  Object.freeze({ key: 'scarf', label: '红围巾', emoji: '🧣', price: 80, kind: 'dress', level: 1, slot: 'neck', blurb: '脖子上暖乎乎的' }),
+  Object.freeze({ key: 'strawhat', label: '草帽', emoji: '👒', price: 150, kind: 'dress', level: 3, slot: 'head', blurb: '遮阳，也遮心虚' }),
+  Object.freeze({ key: 'sunglasses', label: '墨镜', emoji: '🕶', price: 260, kind: 'dress', level: 5, slot: 'face', blurb: '谁也不知道它在想什么' }),
+  Object.freeze({ key: 'overalls', label: '背带裤', emoji: '👖', price: 420, kind: 'dress', level: 8, slot: 'body', blurb: '干体力活穿的' }),
+  Object.freeze({ key: 'bowtie', label: '领结', emoji: '🎀', price: 600, kind: 'dress', level: 10, slot: 'neck', blurb: '上班用' }),
+  Object.freeze({ key: 'rainboots', label: '雨靴', emoji: '🥾', price: 900, kind: 'dress', level: 13, slot: 'feet', blurb: '踩水坑专用' }),
+  Object.freeze({ key: 'cape', label: '披风', emoji: '🦸', price: 1300, kind: 'dress', level: 16, slot: 'back', blurb: '风一吹就飘起来' }),
+  Object.freeze({ key: 'flowercrown', label: '花环', emoji: '💐', price: 1800, kind: 'dress', level: 20, slot: 'head', blurb: '春天做的' }),
+  Object.freeze({ key: 'tophat', label: '礼帽', emoji: '🎩', price: 2600, kind: 'dress', level: 25, slot: 'head', blurb: '正式场合' }),
+  Object.freeze({ key: 'necklace', label: '项链', emoji: '📿', price: 3600, kind: 'dress', level: 30, slot: 'neck', blurb: '据说是祖传的' }),
+  Object.freeze({ key: 'crown', label: '王冠', emoji: '👑', price: 5200, kind: 'dress', level: 40, slot: 'head', blurb: '自己给自己加冕' }),
+  Object.freeze({ key: 'wings', label: '翅膀', emoji: '🪽', price: 8000, kind: 'dress', level: 50, slot: 'back', blurb: '能不能飞，谁也没见它飞过' }),
+  // --- medicine: the twenty stage cures and 百草丹 (data/illness.js) ------
+  ...MEDICINES,
+  // --- revive -------------------------------------------------------------
+  REVIVE_ITEM,
+])
+
+/** Shop shelves, in the order the panel shows them. */
+export const KIND_ORDER = Object.freeze(['food', 'bath', 'toy', 'dress', 'medicine', 'revive'])
+
+export const KIND_LABEL = Object.freeze({
+  food: '食物',
+  bath: '洗浴',
+  toy: '玩具',
+  dress: '装扮',
+  medicine: '药品',
+  revive: '复活',
+})
+
+/** Which care action spends which shelf. */
+export const CARE_KIND = Object.freeze({ feed: 'food', bathe: 'bath', play: 'toy' })
+
+/**
+ * 装扮点位 —— 猪身上固定的几个锚点。
+ *
+ * 每个点位同时只挂一件；以后换成真正的立绘时，只需要改 client.js 里
+ * `.dp-slot[data-slot="…"]` 的偏移，逻辑和存档都不用动。
+ */
+export const DRESS_SLOTS = Object.freeze([
+  Object.freeze({ key: 'head', label: '头' }),
+  Object.freeze({ key: 'face', label: '脸' }),
+  Object.freeze({ key: 'neck', label: '脖子' }),
+  Object.freeze({ key: 'body', label: '身子' }),
+  Object.freeze({ key: 'back', label: '背后' }),
+  Object.freeze({ key: 'feet', label: '脚' }),
+])
+
+export const dressSlotByKey = key => DRESS_SLOTS.find(entry => entry.key === key) ?? null
+
+// ---------------------------------------------------------------------------
+// Lookups
+// ---------------------------------------------------------------------------
+
+export const itemByKey = key => SHOP.find(item => item.key === key) ?? null
+
+export const itemsOfKind = kind => SHOP.filter(item => item.kind === kind)
+
+/** Every item a care action will accept: the shelf, plus the free default toy. */
+export function careItems(kind) {
+  const bought = itemsOfKind(kind)
+  return kind === 'toy' ? [DEFAULT_TOY, ...bought] : bought
+}
+

package/packages/pet-core/src/data/traits.js

@@ -0,0 +1,42 @@
+// @ts-check
+/**
+ * 三维属性 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/data/traits
+ */
+
+/**
+ * Extra pay per trait point, as a fraction: 150 points doubles the wage.
+ *
+ * Was 1/15 when a lesson gave one point. Since B4 a subject taken to 大学 is
+ * worth ~90 points of its trait, and 1/15 hit the ×3 cap in the first month
+ * (on top of halved shifts, about 6× the pay on the job sheet). Cut to a tenth
+ * on 2026-10-01 at the owner's request.
+ */
+export const TRAIT_PAY_PER_POINT = 1 / 150
+
+/** ...but a pig that studied everything still only triples the wage, or the
+ *  late game has no shape left. */
+export const TRAIT_PAY_CAP = 3
+
+/** Shorter shift per trait point. 0 since 2026-10-01: traits pay more, shifts stay as long as the job table says. */
+export const TRAIT_SPEED_PER_POINT = 0
+
+export const TRAIT_SPEED_CAP = 0.5
+
+/** What one trait point buys on a given job. */
+export function traitBonus(traitKey, points) {
+  const n = Number.isFinite(points) ? Math.max(0, points) : 0
+  return {
+    pay: Math.min(TRAIT_PAY_CAP, 1 + n * TRAIT_PAY_PER_POINT),
+    minutes: Math.max(1 - TRAIT_SPEED_CAP, 1 - n * TRAIT_SPEED_PER_POINT),
+  }
+}
+
+/** The three traits QQ Pet tracks alongside growth. */
+export const TRAITS = Object.freeze({
+  intel: Object.freeze({ key: 'intel', label: '智力', emoji: '🧠' }),
+  charm: Object.freeze({ key: 'charm', label: '魅力', emoji: '✨' }),
+  strong: Object.freeze({ key: 'strong', label: '武力', emoji: '💪' }),
+})
+
+export const TRAIT_ORDER = Object.freeze(['intel', 'charm', 'strong'])

package/packages/pet-core/src/data/travel.js

@@ -0,0 +1,87 @@
+// @ts-check
+/**
+ * 旅行与纪念品 —— 静态数值表（零逻辑、零 IO，见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/data/travel
+ */
+
+import { MINUTES } from './minutes.js'
+
+/**
+ * Rarity tiers for souvenirs: bragging rights, and a price tag.
+ *
+ * Deterministic — a souvenir's tier is a property of the souvenir, not a dice
+ * roll, so the whole collection stays testable and "the far trips are worth
+ * more" is a fact about the tables rather than a probability.
+ */
+export const SOUVENIR_RARITY = Object.freeze({
+  common: Object.freeze({ key: 'common', label: '普通', emoji: '⚪', price: 60 }),
+  rare: Object.freeze({ key: 'rare', label: '稀有', emoji: '🔵', price: 320 }),
+  legend: Object.freeze({ key: 'legend', label: '传说', emoji: '🟡', price: 1600 }),
+})
+
+export const rarityByKey = key => SOUVENIR_RARITY[key] ?? SOUVENIR_RARITY.common
+
+const souvenir = (key, emoji, label, rarity, story) => Object.freeze({ key, emoji, label, rarity, story })
+
+export const TRIPS = Object.freeze([
+  Object.freeze({ key: 'suburb', label: '郊游', emoji: '🧺', minutes: MINUTES.hour, cost: 60, happiness: 10, satiety: -8, souvenirs: Object.freeze([
+    souvenir('clover', '🍀', '四叶草', 'common', '在草堆里翻到一片四叶草，据说会带来好运。'),
+    souvenir('pinecone', '🌰', '松果', 'common', '捡了一颗松果，捏起来有点扎手。'),
+    souvenir('wildflower', '🌼', '野花', 'rare', '摘了一朵小野花，一路上都小心护着。'),
+  ]) }),
+  Object.freeze({ key: 'mountain', label: '名山大川', emoji: '🏔', minutes: MINUTES.threeHours, cost: 200, happiness: 16, satiety: -20, souvenirs: Object.freeze([
+    souvenir('cloudsea', '☁️', '云海照片', 'common', '爬到半山腰回头看，云在脚底下走。'),
+    souvenir('stone', '🪨', '山石', 'common', '从山涧里捡了块石头，摸起来凉凉的。'),
+    souvenir('bamboo', '🎍', '竹杖', 'rare', '在竹林里挑了根直溜的竹子当拐杖，拄着它上了山顶。'),
+    souvenir('echo', '🏔', '山谷回声', 'legend', '在山顶冲着对面喊了一嗓子，山谷把你的名字还了回来。'),
+  ]) }),
+  Object.freeze({ key: 'hotspring', label: '泡温泉', emoji: '♨️', minutes: MINUTES.sixHours, cost: 380, happiness: 20, satiety: -28, souvenirs: Object.freeze([
+    souvenir('towelmint', '🧺', '温泉毛巾', 'common', '印着当地小图案的毛巾，闻起来有硫磺味。'),
+    souvenir('springegg', '🥚', '温泉蛋', 'common', '在池边煮的蛋，蛋黄是半凝固的。'),
+    souvenir('omamori', '🧿', '平安符', 'rare', '泡完汤求了个平安符，据说能防着点倒霉事。'),
+  ]) }),
+  Object.freeze({ key: 'sea', label: '看海', emoji: '🌊', minutes: MINUTES.eightHours, cost: 620, happiness: 24, satiety: -42, souvenirs: Object.freeze([
+    souvenir('seasalt', '🧂', '海盐', 'common', '在礁石坑里刮了点海盐，咸得发苦。'),
+    souvenir('starfish', '⭐', '海星', 'common', '退潮时捡到一只海星，看完就放回水里了。'),
+    souvenir('shell', '🐚', '一枚海螺', 'rare', '在海边捡到一枚海螺，贴在耳朵上能听见浪声。'),
+    souvenir('driftbottle', '🍾', '漂流瓶', 'legend', '瓶子里有张潮湿的纸条，写着「你好，陌生人」。'),
+  ]) }),
+  Object.freeze({ key: 'oldtown', label: '古镇', emoji: '🏮', minutes: MINUTES.halfDay, cost: 1100, happiness: 30, satiety: -50, souvenirs: Object.freeze([
+    souvenir('woodcut', '🪵', '木刻', 'common', '巷口老师傅刻的小木牌，背面还有刀痕。'),
+    souvenir('lantern', '🏮', '小灯笼', 'rare', '买了一盏纸灯笼，晚上提着一路走回客栈。'),
+    souvenir('teapot', '🫖', '紫砂壶', 'legend', '在旧货摊上淘到的紫砂壶，壶底刻着一个看不清的年份。'),
+  ]) }),
+  Object.freeze({ key: 'abroad', label: '出国', emoji: '🌍', minutes: MINUTES.day, cost: 2000, happiness: 38, satiety: -80, souvenirs: Object.freeze([
+    souvenir('foreigncoin', '🪙', '外国硬币', 'common', '找零收到一枚硬币，上面的字一个都不认识。'),
+    souvenir('stamp', '📮', '异国邮票', 'rare', '在旧书摊上买了张盖过戳的邮票。'),
+    souvenir('postcard', '💌', '手写明信片', 'rare', '给自己寄了一张明信片，上面写着「我很好，就是有点想你」。'),
+    souvenir('snowglobe', '🔮', '水晶球', 'legend', '晃一晃，陌生的城市就会下雪。'),
+  ]) }),
+  Object.freeze({ key: 'aurora', label: '看极光', emoji: '🌌', minutes: MINUTES.day, cost: 3600, happiness: 44, satiety: -90, souvenirs: Object.freeze([
+    souvenir('polestone', '⛰', '极地石', 'common', '从冻土上抠下来一块石头，冰得刺手。'),
+    souvenir('compass', '🧭', '老罗盘', 'rare', '指针一直抖，最后还是能指回住的地方。'),
+    souvenir('icecrystal', '❄️', '冰晶', 'rare', '接住了一片雪花，在掌心化成一小滴水。'),
+    souvenir('auroraphoto', '🌌', '极光照片', 'legend', '守了三个晚上才等到的那一片绿光，快门按下去的时候手在抖。'),
+  ]) }),
+])
+
+/** Every souvenir on the map, flattened — the collection is global. */
+export const ALL_SOUVENIRS = Object.freeze(TRIPS.flatMap(trip => trip.souvenirs.map(entry => Object.freeze({ ...entry, from: trip.key, fromLabel: trip.label }))))
+
+export const souvenirByKey = key => ALL_SOUVENIRS.find(entry => entry.key === key) ?? null
+
+// ---------------------------------------------------------------------------
+// Items — one shop, four shelves.
+//
+//   food      feeds the pig
+//   bath      washes it
+//   toy       plays with it
+//   medicine  cures it (four tiers, one per illness stage)
+//   revive    brings it back
+//
+// Buying is not the only way in: every pig owns one scruffy default toy for
+// free, so `玩耍` always works even with an empty bag. That mirrors QQ Pet,
+// where the pet can amuse itself without a bought plaything.
+// ---------------------------------------------------------------------------
+
+export const tripByKey = key => TRIPS.find(trip => trip.key === key) ?? null

package/packages/pet-core/src/data.js

@@ -0,0 +1,52 @@
+// @ts-check
+/**
+ * dsh-piggy · data — the static game tables.
+ *
+ * Numbers and names only, no behaviour. The illness chains, thresholds, the
+ * nine school subjects, the job/trip idea and the item categories are lifted
+ * from QQ 宠物 (怀旧服 v1.2.4) as documented by xuemian168/qqpet_automation's
+ * reverse engineering and the original asset tree:
+ *
+ *   img_res/study/  xx-* (小学) · dx-* (大学) · yjs-* (研究生)
+ *                   art 美术 · chinese 语文 · labouring 劳动 · manner 礼仪 ·
+ *                   mathematics 数学 · music 音乐 · pe 体育 · politics 政治 ·
+ *                   wushu 武术
+ *   img_res/work/   the job set
+ *   img_res/food/   food art, one entry per dish
+ *   img_res/commodity/  the sundries — bath things and toys
+ *   models.py       ActiveOption { work, study, trip, ill, die }
+ *                   PetInfo { growth, hunger, clean, health, mood, yb,
+ *                             intel 智力, charm 魅力, strong 武力 }
+ *                   StoreInventory { food, commodity, medicine, background }
+ *
+ * The last one is the reason care costs an item: the original keeps **food**,
+ * **commodity** and **medicine** as separate inventory categories, and its own
+ * heal path is "find the matching medicine in the bag → use it → recover".
+ * Feeding, bathing and playing work the same way here.
+ *
+ * Attribute scale: QQ Pet counts in the thousands and its hunger ceiling grows
+ * with level (3000 + 100 × min(level, 30)); this pig draws 0-100 bars instead,
+ * with the QQ Pet thresholds rescaled:
+ *   hunger 720/3100 ≈ 23%  → satiety < 25
+ *   clean  1080/3100 ≈ 35% → cleanliness < 35
+ *   mood   100/1000 = 10%  → happiness < 35 (a little kinder)
+ *   health 5 → 5, unchanged — 0 is still death.
+ *
+ * @module dsh-piggy/data
+ */
+
+export * from './data/minutes.js'
+export * from './data/traits.js'
+export * from './data/illness.js'
+export * from './data/life.js'
+export * from './data/growth.js'
+export * from './data/jobs.js'
+export * from './data/school.js'
+export * from './data/interests.js'
+export * from './data/travel.js'
+export * from './data/shop.js'
+export * from './data/drops.js'
+export * from './data/lines.js'
+export * from './data/profile.js'
+export * from './data/daily.js'
+export * from './data/evolution.js'

package/packages/pet-core/src/index.js

@@ -0,0 +1,12 @@
+// @ts-check
+/**
+ * @dsh-piggy/core —— 宠物的纯领域模型与数值表。
+ *
+ * 零依赖、零 IO：不读文件、不发请求、不碰 DOM、不自己取时间或随机数。
+ * 宿主（DSH 插件、以后的独立版）负责存档、时钟和界面，把 nowMs 等外部输入传进来。
+ *
+ * @module @dsh-piggy/core
+ */
+
+export * from './core.js'
+export * from './data.js'