dsh-piggy 0.25.0

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

@@ -0,0 +1,226 @@
+// @ts-check
+/**
+ * 存档迁移与字段清洗。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/migrate
+ */
+
+import { ILLNESS_CHAINS, INTERESTS, formByKey, MAX, SHOP, SOUVENIR_RARITY, TRAIT_ORDER, interestByKey, itemByKey, jobByKey, schoolStageByKey, subjectByKey, tripByKey } from '../data.js'
+import { MEMORY_LIMIT, STATE_VERSION } from './constants.js'
+import { clamp, clamp100 } from './effects.js'
+import { layEgg, pickSex } from './egg.js'
+import { ensureDaily } from './daily.js'
+import { ensureDiary } from './diary.js'
+import { ensureDialogue } from './lines.js'
+import { ensureProfile } from './profile.js'
+import { isSeed, seedFor } from './random.js'
+import { applyUpgrades } from './upgrades.js'
+
+/** Fill in anything a hand-edited or older save is missing. */
+export function migrate(input, nowMs) {
+  if (input === null || typeof input !== 'object' || Array.isArray(input)) return null
+  const onDiskVersion = typeof input.version === 'number' ? input.version : 0
+  // Untrusted save data: every field below is checked before it is used.
+  const raw = /** @type {any} */ (applyUpgrades(input, nowMs))
+  const egg = layEgg(typeof raw.bornAt === 'number' ? raw.bornAt : nowMs)
+  const state = { ...egg, ...raw }
+  state.version = STATE_VERSION
+  state.form = formByKey(raw.form)?.key ?? null
+  state.stats = { ...egg.stats, ...(asObject(raw.stats) ?? {}) }
+  state.stats.jobs = Number.isFinite(state.stats.jobs) ? Math.max(0, Math.floor(state.stats.jobs)) : 0
+  state.cooldowns = { ...(asObject(raw.cooldowns) ?? {}) }
+  state.inventory = sanitizeInventory(raw.inventory)
+  state.dress = sanitizeDressList(raw.dress)
+  // Only owned items can be worn, and unknown keys are dropped.
+  state.worn = sanitizeDressList(raw.worn).filter(key => state.dress.includes(key))
+  state.traits = sanitizeTraits(raw.traits)
+  state.lessons = sanitizeLessons(raw.lessons)
+  state.interests = sanitizeInterests(raw.interests)
+  state.souvenirs = sanitizeSouvenirs(raw.souvenirs)
+  state.pending = []
+  state.memories = Array.isArray(raw.memories)
+    ? raw.memories.filter(m => typeof m === 'string').slice(-MEMORY_LIMIT)
+    : []
+
+  for (const key of ['xp', 'weightG', 'satiety', 'happiness', 'cleanliness', 'health', 'coins', 'outingStreak', 'restMinutes', 'bornAt', 'lastFedAt', 'lastActiveAt', 'lastSeenAt']) {
+    if (typeof state[key] !== 'number' || !Number.isFinite(state[key])) state[key] = egg[key]
+  }
+  if (typeof raw.cleanliness !== 'number') state.cleanliness = egg.cleanliness
+  if (typeof raw.health !== 'number') state.health = raw.dead === true ? 0 : MAX.health
+  if (typeof raw.coins !== 'number') state.coins = egg.coins
+  // Starting money went 60 -> 500. A pig that hatched under the old number is
+  // broke through no fault of its owner, so top it up once — and only once, by
+  // keying off the version that was on disk when it was loaded.
+  if (onDiskVersion < 5 && state.coins >= 0 && state.coins < egg.coins) {
+    state.coins = egg.coins
+  }
+  if (typeof raw.diedAt !== 'number') state.diedAt = state.dead === true ? (raw.lastSeenAt ?? egg.bornAt) : null
+  if (typeof state.stage !== 'string') state.stage = state.hatched === true ? 'piglet' : 'box'
+  if (typeof state.name !== 'string' || state.name.trim() === '') state.name = egg.name
+
+  state.health = clamp(Math.round(state.health), 0, MAX.health)
+  state.satiety = clamp100(state.satiety)
+  state.happiness = clamp100(state.happiness)
+  state.cleanliness = clamp100(state.cleanliness)
+  state.coins = Math.max(0, Math.floor(state.coins))
+  state.illness = sanitizeIllness(raw.illness, nowMs)
+  state.activity = sanitizeActivity(raw.activity ?? raw.work)
+  state.dead = state.dead === true || state.health <= 0
+  state.hatched = state.hatched === true
+  if (!isSeed(state.seed)) state.seed = seedFor(state)
+  if (state.hatched && state.sex !== 'boy' && state.sex !== 'girl') state.sex = pickSex(state)
+  if (state.stage === 'elder') state.stage = 'middle'
+  if (!Number.isInteger(state.pendingSeq) || state.pendingSeq < 0) state.pendingSeq = 0
+  ensureDialogue(state)
+  // B9: personality, catchphrase and motto — filled in for older pigs on load.
+  ensureProfile(state)
+  ensureDaily(state)
+  ensureDiary(state)
+  return state
+}
+
+export function asObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : null
+}
+
+export function sanitizeInventory(raw) {
+  const source = asObject(raw)
+  if (source === null) return {}
+  const out = {}
+  for (const [key, count] of Object.entries(source)) {
+    if (!Number.isFinite(count)) continue
+    const n = Math.floor(count)
+    if (n > 0 && SHOP.some(item => item.key === key)) out[key] = n
+  }
+  return out
+}
+
+export function sanitizeTraits(raw) {
+  const source = asObject(raw)
+  const out = {}
+  for (const key of TRAIT_ORDER) {
+    const value = source?.[key]
+    out[key] = Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 0
+  }
+  return out
+}
+
+/** Lessons taken per subject (B4): known subject keys, whole positive counts. */
+export function sanitizeLessons(raw) {
+  const source = asObject(raw)
+  if (source === null) return {}
+  const out = {}
+  for (const [key, count] of Object.entries(source)) {
+    if (!Number.isFinite(count)) continue
+    const n = Math.floor(count)
+    if (n > 0 && subjectByKey(key) !== null) out[key] = n
+  }
+  return out
+}
+
+/**
+ * Souvenirs became objects in 0.20.0 so they could carry a rarity and a story.
+ * A save written before that holds bare strings ("贝壳"); wrap them so an old
+ * collection stays visible and sellable instead of being dropped.
+ */
+export function sanitizeSouvenirs(raw) {
+  if (!Array.isArray(raw)) return []
+  // No cap: the shelf used to keep only the last 40, which threw away the
+  // oldest keepsakes (and made them unsellable) without telling anyone.
+  const out = []
+  for (const entry of raw) {
+    if (typeof entry === 'string' && entry !== '') {
+      out.push({ key: entry, emoji: '🎁', label: entry, rarity: 'common', story: '', from: null, fromLabel: '' })
+      continue
+    }
+    const source = asObject(entry)
+    if (source === null || typeof source.key !== 'string' || source.key === '') continue
+    out.push({
+      key: source.key,
+      emoji: typeof source.emoji === 'string' && source.emoji !== '' ? source.emoji : '🎁',
+      label: typeof source.label === 'string' && source.label !== '' ? source.label : source.key,
+      rarity: typeof source.rarity === 'string' && SOUVENIR_RARITY[source.rarity] !== undefined ? source.rarity : 'common',
+      story: typeof source.story === 'string' ? source.story : '',
+      from: typeof source.from === 'string' ? source.from : null,
+      fromLabel: typeof source.fromLabel === 'string' ? source.fromLabel : '',
+    })
+  }
+  return out
+}
+
+/**
+ * Owned / worn 装扮 keys. Unknown and duplicate keys are dropped, and only real
+ * dress items survive, so a hand-edited save cannot dress the pig in a 药品.
+ */
+export function sanitizeDressList(raw) {
+  if (!Array.isArray(raw)) return []
+  const out = []
+  for (const key of raw) {
+    if (typeof key !== 'string') continue
+    const item = itemByKey(key)
+    if (item === null || item.kind !== 'dress' || out.includes(key)) continue
+    out.push(key)
+  }
+  return out
+}
+
+/** How many times each 兴趣课 has been taken; unknown keys are dropped. */
+export function sanitizeInterests(raw) {
+  const source = asObject(raw)
+  if (source === null) return {}
+  const out = {}
+  for (const entry of INTERESTS) {
+    const value = source[entry.key]
+    if (Number.isFinite(value) && value > 0) out[entry.key] = Math.floor(value)
+  }
+  return out
+}
+
+export function sanitizeIllness(raw, nowMs) {
+  const source = asObject(raw)
+  if (source === null) return null
+  const chain = Number.isInteger(source.chain) ? source.chain : -1
+  const stage = Number.isInteger(source.stage) ? source.stage : 0
+  if (chain < 0 || chain >= ILLNESS_CHAINS.length) return null
+  if (stage < 1 || stage > ILLNESS_CHAINS[chain].stages.length) return null
+  return {
+    chain,
+    stage,
+    since: Number.isFinite(source.since) ? source.since : nowMs,
+    progressMs: Number.isFinite(source.progressMs) ? Math.max(0, source.progressMs) : 0,
+  }
+}
+
+/** Accepts both the v4 `activity` record and the v3 `work` record. */
+export function sanitizeActivity(raw) {
+  const source = asObject(raw)
+  if (source === null) return null
+  if (!Number.isFinite(source.endsAt)) return null
+  const kind = source.kind ?? 'work'
+  if (!['work', 'study', 'trip', 'interest'].includes(kind)) return null
+  // A shift from an older job table survives if the upgrade priced it.
+  const known = kind === 'work'
+    ? jobByKey(source.key ?? source.job) !== null || Number.isFinite(source.legacyCoins)
+    : kind === 'study'
+      ? subjectByKey(source.key) !== null
+      : kind === 'interest'
+        ? interestByKey(source.key) !== null
+        : tripByKey(source.key) !== null
+  if (!known) return null
+  return {
+    kind,
+    key: source.key ?? source.job,
+    stage: kind === 'study' && schoolStageByKey(source.stage) !== null ? source.stage : undefined,
+    label: typeof source.label === 'string' ? source.label : '',
+    emoji: typeof source.emoji === 'string' ? source.emoji : '',
+    startedAt: Number(source.startedAt) || 0,
+    endsAt: source.endsAt,
+    cost: Number(source.cost) || 0,
+    ...(Number.isFinite(source.legacyCoins) ? { legacyCoins: source.legacyCoins, minutes: Number(source.minutes) || 0 } : {}),
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Small shared helpers
+// ---------------------------------------------------------------------------

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

@@ -0,0 +1,102 @@
+// @ts-check
+/**
+ * 居民卡：性格、口头禅、签名、生日星座（B9）。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，随机数来自 core/random.js（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/profile
+ */
+
+import { CATCHPHRASE_MAX, GRADUATION_LESSONS, MOTTO_MAX, PERSONALITIES, ZODIAC, personalityByKey } from '../data.js'
+import { CERTIFICATE_AFTER } from '../data.js'
+import { ageDays } from './clock.js'
+import { pickOne, rollerFor } from './random.js'
+
+/**
+ * Give a newly hatched pig its personality, and the catchphrase and motto that
+ * come with it (the owner can change both later).
+ * @param {object} state
+ */
+export function assignPersonality(state) {
+  const personality = pickOne(rollerFor(state), PERSONALITIES) ?? PERSONALITIES[0]
+  state.personality = personality.key
+  state.catchphrase = personality.catchphrase
+  state.motto = personality.motto
+}
+
+/** Make sure a hatched pig has every profile field (older saves, hand edits). */
+export function ensureProfile(state) {
+  if (state.hatched !== true) return
+  if (personalityByKey(state.personality) === null) {
+    assignPersonality(state)
+    return
+  }
+  const personality = personalityByKey(state.personality)
+  if (typeof state.catchphrase !== 'string' || state.catchphrase.trim() === '') state.catchphrase = personality?.catchphrase ?? ''
+  if (typeof state.motto !== 'string' || state.motto.trim() === '') state.motto = personality?.motto ?? ''
+}
+
+/** Trim, cut to `max` characters (not UTF-16 units), refuse empty. */
+function cleanText(raw, max) {
+  if (typeof raw !== 'string') return ''
+  return Array.from(raw.trim()).slice(0, max).join('')
+}
+
+/** The owner changes the pig's catchphrase. */
+export function setCatchphrase(state, raw) {
+  if (state === null) return { ok: false, reason: 'absent' }
+  const text = cleanText(raw, CATCHPHRASE_MAX)
+  if (text === '') return { ok: false, reason: 'empty' }
+  state.catchphrase = text
+  return { ok: true, catchphrase: text }
+}
+
+/** The owner changes the line on the pig's card. */
+export function setMotto(state, raw) {
+  if (state === null) return { ok: false, reason: 'absent' }
+  const text = cleanText(raw, MOTTO_MAX)
+  if (text === '') return { ok: false, reason: 'empty' }
+  state.motto = text
+  return { ok: true, motto: text }
+}
+
+/**
+ * The star sign for a month (1–12) and day.
+ * @returns {{label: string, emoji: string}}
+ */
+export function zodiacFor(month, day) {
+  let found = ZODIAC[ZODIAC.length - 1]
+  for (const sign of ZODIAC) {
+    if (month > sign.month || (month === sign.month && day >= sign.day)) found = sign
+  }
+  return { label: found.label, emoji: found.emoji }
+}
+
+/**
+ * Everything the villager card shows, worked out once on the host.
+ * @param {object} state
+ * @param {number} nowMs
+ */
+export function profileView(state, nowMs) {
+  if (state === null || state.hatched !== true) return null
+  const personality = personalityByKey(state.personality)
+  const born = new Date(typeof state.bornAt === 'number' ? state.bornAt : nowMs)
+  const month = born.getMonth() + 1
+  const day = born.getDate()
+  const lessons = state.lessons ?? {}
+  const graduated = Object.values(lessons).reduce(
+    (sum, count) => sum + GRADUATION_LESSONS.filter(mark => count >= mark).length, 0)
+  const certificates = Object.values(state.interests ?? {}).filter(count => count >= CERTIFICATE_AFTER).length
+  return {
+    personality: personality === null ? null : { key: personality.key, label: personality.label, emoji: personality.emoji },
+    catchphrase: typeof state.catchphrase === 'string' ? state.catchphrase : '',
+    motto: typeof state.motto === 'string' ? state.motto : '',
+    birthday: `${month} 月 ${day} 日`,
+    zodiac: zodiacFor(month, day),
+    counts: {
+      days: Math.floor(ageDays(state, nowMs)),
+      certificates,
+      souvenirs: Array.isArray(state.souvenirs) ? state.souvenirs.length : 0,
+      graduations: graduated,
+    },
+  }
+}

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

@@ -0,0 +1,79 @@
+// @ts-check
+/**
+ * 随机数：种子存在存档里，领域层自己推进。
+ *
+ * 领域层不许调用 Math.random()（见 test/core-boundary.test.js）。可随机的玩法
+ * （病自愈、以后的发病、掉落、礼包）一律从这里取数：种子是 `state.seed`，每取一次
+ * 就往前推一步，所以同一份存档加同样的操作，结果永远一样 —— 可复现、可测试，
+ * 也不需要把随机源一路穿过每个公开函数的签名。
+ *
+ * 需要指定结果的调用方（测试、调试页）可以直接给 `decay()` 传 `roll`。
+ *
+ * @module dsh-piggy/core/random
+ */
+
+/** @typedef {() => number} Roll 返回 [0, 1) 的一个数 */
+
+const UINT32 = 0x1_0000_0000
+
+/**
+ * A seed for a pig that has none yet (fresh egg, older save).
+ *
+ * Derived from its birthday and name, so two different pigs start on different
+ * sequences without the library having to read a clock or an entropy source.
+ * @param {{bornAt?: unknown, name?: unknown}} state
+ * @returns {number}
+ */
+export function seedFor(state) {
+  let hash = 0x811c9dc5
+  const text = `${typeof state.bornAt === 'number' ? state.bornAt : 0}|${typeof state.name === 'string' ? state.name : ''}`
+  for (let index = 0; index < text.length; index += 1) {
+    hash ^= text.charCodeAt(index)
+    hash = Math.imul(hash, 0x01000193) >>> 0
+  }
+  return hash >>> 0
+}
+
+/** Whether `value` is a usable stored seed (an unsigned 32-bit integer). */
+export const isSeed = value => Number.isInteger(value) && value >= 0 && value < UINT32
+
+/**
+ * Draw the next number in [0, 1) from the pig's own sequence (mulberry32).
+ * @param {{seed?: unknown, bornAt?: unknown, name?: unknown}} state - `seed` is advanced in place.
+ * @returns {number}
+ */
+export function roll(state) {
+  const current = isSeed(state.seed) ? /** @type {number} */ (state.seed) : seedFor(state)
+  const next = (current + 0x6d2b79f5) >>> 0
+  state.seed = next
+  let mixed = next
+  mixed = Math.imul(mixed ^ (mixed >>> 15), mixed | 1)
+  mixed ^= mixed + Math.imul(mixed ^ (mixed >>> 7), mixed | 61)
+  return ((mixed ^ (mixed >>> 14)) >>> 0) / UINT32
+}
+
+/**
+ * A `Roll` bound to one pig — what the settlement loop hands down.
+ * @param {object} state
+ * @returns {Roll}
+ */
+export const rollerFor = state => () => roll(state)
+
+/**
+ * True with probability `chance`.
+ * @param {Roll} next
+ * @param {number} chance - 0..1; anything outside is clamped.
+ */
+export const chance = (next, chance) => chance > 0 && next() < Math.min(1, chance)
+
+/**
+ * One element of `list`, or null when it is empty.
+ * @template T
+ * @param {Roll} next
+ * @param {ReadonlyArray<T>} list
+ * @returns {T|null}
+ */
+export function pickOne(next, list) {
+  if (list.length === 0) return null
+  return list[Math.min(list.length - 1, Math.floor(next() * list.length))]
+}

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

@@ -0,0 +1,81 @@
+// @ts-check
+/**
+ * 九门课：每门课各算各的课时，课时决定这门课在哪个学段、能干什么工作（B4）。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/school
+ */
+
+import { GRADUATION_LESSONS, SUBJECTS, TRAITS, graduatedStage, stageForNextLesson, subjectByKey } from '../data.js'
+import { begin } from './activity.js'
+import { TOO_WEAK_HEALTH } from './constants.js'
+import { remember } from './effects.js'
+
+/** Lessons taken per subject, always including every subject (0 = never). */
+export function courseView(state) {
+  const out = {}
+  for (const subject of SUBJECTS) out[subject.key] = state.lessons?.[subject.key] ?? 0
+  return out
+}
+
+/**
+ * Each subject as the panel needs it: where it is, what the next lesson costs
+ * and gives, and how far to the next graduation.
+ */
+export function studyView(state) {
+  const taken = courseView(state)
+  return SUBJECTS.map(subject => {
+    const count = taken[subject.key]
+    const next = stageForNextLesson(count)
+    const done = graduatedStage(count)
+    const nextGraduation = GRADUATION_LESSONS.find(mark => mark > count) ?? null
+    return {
+      key: subject.key,
+      label: subject.label,
+      emoji: subject.emoji,
+      trait: subject.trait,
+      traitLabel: TRAITS[subject.trait].label,
+      traitEmoji: TRAITS[subject.trait].emoji,
+      secondary: subject.secondary,
+      lessons: count,
+      stage: { key: next.key, label: next.label, emoji: next.emoji },
+      graduated: done === null ? null : { key: done.key, label: done.label },
+      nextGraduation,
+      minutes: next.minutes,
+      tuition: next.tuition,
+      gain: next.gain,
+      secondaryGain: subject.secondary === null ? 0 : next.secondaryGain,
+    }
+  })
+}
+
+/**
+ * Send the pig to the next lesson of a subject. The stage is decided by how
+ * many lessons of it the pig has already taken; `_stageKey` is accepted for
+ * older callers and ignored.
+ */
+export function startStudy(state, subjectKey, _stageKey, nowMs) {
+  if (state.hatched !== true) return { ok: false, reason: 'box' }
+  const subject = subjectByKey(subjectKey)
+  if (subject === null) return { ok: false, reason: 'unknown' }
+  if (state.dead) return { ok: false, reason: 'dead' }
+  if (state.activity !== null) return { ok: false, reason: 'away' }
+  if (state.health <= TOO_WEAK_HEALTH) return { ok: false, reason: 'weak' }
+  const taken = state.lessons?.[subject.key] ?? 0
+  const stage = stageForNextLesson(taken)
+  if (state.coins < stage.tuition) return { ok: false, reason: 'poor', price: stage.tuition }
+  if (state.satiety < 15) return { ok: false, reason: 'hungry' }
+
+  state.coins -= stage.tuition
+  const result = begin(state, {
+    kind: 'study', key: subject.key, stage: stage.key,
+    label: `${subject.label}（${stage.label}第 ${taken + 1} 节）`, emoji: subject.emoji,
+    minutes: stage.minutes, cost: stage.tuition,
+  }, nowMs)
+  if (!result.ok) {
+    state.coins += stage.tuition // refund if the pig turned out to be unavailable
+    return result
+  }
+  remember(state, `${subject.emoji} 去上${subject.label}第 ${taken + 1} 节（学费 ${stage.tuition}）`, nowMs)
+  return result
+}