dsh-piggy 0.25.0

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

@@ -0,0 +1,108 @@
+// @ts-check
+/**
+ * 宠物日记：把「今天发生了什么」攒起来，跨天（06:00）写成一篇。
+ *
+ * 零 token：模板拼句，不调模型（data/daily.js 的 DIARY_LINES）。事件点只是在
+ * 原有逻辑旁边加一句 `noteToday(state, 'feed')`，判断和写入都在这里。
+ *
+ * @module dsh-piggy/core/diary
+ */
+import { DIARY_EMPTY_LINE, DIARY_LINES, DIARY_MAX, DIARY_MAX_SENTENCES, OWNER_TOKEN } from '../data.js'
+import { dayKeyFor } from './clock.js'
+import { ensureDialogue } from './lines.js'
+
+/** 一本空日记：没有历史，今天还没开始记。 */
+export function emptyDiary() {
+  return { entries: [], today: { day: null, counts: {} } }
+}
+
+/**
+ * 补默认值（新字段不加 upgrades 级、不动 STATE_VERSION）。
+ * @param {object} state
+ */
+export function ensureDiary(state) {
+  const raw = state.diary
+  if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+    state.diary = emptyDiary()
+    return state.diary
+  }
+  const entries = Array.isArray(raw.entries) ? raw.entries : []
+  const kept = []
+  for (const entry of entries) {
+    if (entry === null || typeof entry !== 'object') continue
+    if (typeof entry.day !== 'string' || typeof entry.text !== 'string') continue
+    if (entry.day === '' || entry.text === '') continue
+    kept.push({ day: entry.day, text: entry.text })
+  }
+  const today = raw.today !== null && typeof raw.today === 'object' && !Array.isArray(raw.today) ? raw.today : {}
+  const counts = {}
+  if (today.counts !== null && typeof today.counts === 'object' && !Array.isArray(today.counts)) {
+    for (const [key, value] of Object.entries(today.counts)) {
+      if (Number.isFinite(value) && value > 0) counts[key] = Math.floor(value)
+    }
+  }
+  state.diary = {
+    entries: kept.slice(-DIARY_MAX),
+    today: { day: typeof today.day === 'string' && today.day !== '' ? today.day : null, counts },
+  }
+  return state.diary
+}
+
+/**
+ * 记一笔今天发生了什么。
+ *
+ * 时间不进来（事件点只是加一行调用），归属哪一天由 `writeDiaryIfNewDay()` 定：
+ * 它每次读状态都会跑，所以计数不会记到错误的日子上。
+ * @param {object} state
+ * @param {string} kind - DIARY_LINES 里的 key；额外计数（coinsEarned 等）也走这里
+ * @param {number} [amount]
+ */
+export function noteToday(state, kind, amount = 1) {
+  const diary = ensureDiary(state)
+  diary.today.counts[kind] = (diary.today.counts[kind] ?? 0) + amount
+  return diary
+}
+
+/**
+ * 把一天的数字拼成一篇日记，最多 5 句。什么都没发生也有话说。
+ * @param {Record<string, number>} counts
+ * @param {string} ownerName
+ */
+export function composeDiary(counts, ownerName) {
+  const sentences = []
+  for (const entry of DIARY_LINES) {
+    if ((counts[entry.key] ?? 0) <= 0) continue
+    sentences.push(entry.said(counts).split(OWNER_TOKEN).join(ownerName))
+    if (sentences.length >= DIARY_MAX_SENTENCES) break
+  }
+  if (sentences.length === 0) return DIARY_EMPTY_LINE.split(OWNER_TOKEN).join(ownerName)
+  return sentences.join('')
+}
+
+/**
+ * 跨天了就把昨天（`today`）写成一篇，然后从今天重新开始记。
+ *
+ * 每次读状态都会调一次：第一次见到今天会把 `today.day` 归位；换了天就落笔。
+ * @returns {boolean} 是否写了新的一篇
+ */
+export function writeDiaryIfNewDay(state, nowMs) {
+  const diary = ensureDiary(state)
+  const today = dayKeyFor(nowMs)
+  if (diary.today.day === null) {
+    diary.today.day = today
+    return false
+  }
+  if (diary.today.day === today) return false
+
+  const owner = ensureDialogue(state).ownerName
+  diary.entries.push({ day: diary.today.day, text: composeDiary(diary.today.counts, owner) })
+  if (diary.entries.length > DIARY_MAX) diary.entries.splice(0, diary.entries.length - DIARY_MAX)
+  diary.today = { day: today, counts: {} }
+  return true
+}
+
+/** 面板要的那份：按日期倒序（新的在前）。 */
+export function diaryView(state) {
+  const diary = ensureDiary(state)
+  return diary.entries.slice().reverse().map(entry => ({ day: entry.day, text: entry.text }))
+}

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

@@ -0,0 +1,82 @@
+// @ts-check
+/**
+ * 打工、上课回来随手带的东西。
+ *
+ * 纯函数领域逻辑：随机数来自 core/random.js（见 docs/CONVENTIONS.md）。
+ * 数字见 data/drops.js（docs/tasks/numbers/B4-study-jobs.md §4）。
+ * @module dsh-piggy/core/drops
+ */
+
+import {
+  DROP_SHELVES,
+  GRADUATION_DROP_COUNT,
+  GRADUATION_DROP_PRICE,
+  SHOP,
+  STUDY_DROP_CHANCE,
+  STUDY_DROP_MAX_PRICE,
+  WORK_DROP,
+  WORK_DROP_VALUE_RATIO,
+} from '../data.js'
+import { chance, pickOne } from './random.js'
+
+/**
+ * One item: pick a shelf by weight, then an item on it within the price range.
+ * A shelf with nothing in range falls back to its cheapest item, so a drop is
+ * never silently lost.
+ * @param {import('./random.js').Roll} next
+ * @param {{min?: number, max: number}} price
+ * @param {ReadonlyArray<{kinds: ReadonlyArray<string>, weight: number, tier?: number}>} shelves
+ */
+function pickItem(next, price, shelves) {
+  const total = shelves.reduce((sum, shelf) => sum + shelf.weight, 0)
+  let point = next() * total
+  let shelf = shelves[0]
+  for (const candidate of shelves) {
+    shelf = candidate
+    point -= candidate.weight
+    if (point < 0) break
+  }
+  const onShelf = SHOP.filter(item =>
+    shelf.kinds.includes(item.kind) && item.default !== true && item.cureAll !== true
+    && (shelf.tier === undefined || item.tier === shelf.tier))
+  const inRange = onShelf.filter(item => item.price <= price.max && item.price >= (price.min ?? 0))
+  const pool = inRange.length > 0 ? inRange : onShelf.slice().sort((a, b) => a.price - b.price).slice(0, 1)
+  return pickOne(next, pool)
+}
+
+/**
+ * Put `count` random items in the bag.
+ * @returns {Array<{key: string, label: string, emoji: string}>} what was given
+ */
+function give(state, count, next, price, shelves = DROP_SHELVES) {
+  const given = []
+  for (let index = 0; index < count; index += 1) {
+    const item = pickItem(next, price, shelves)
+    if (item === null) continue
+    state.inventory = { ...(state.inventory ?? {}) }
+    state.inventory[item.key] = (state.inventory[item.key] ?? 0) + 1
+    given.push({ key: item.key, label: item.label, emoji: item.emoji })
+  }
+  return given
+}
+
+/** After a shift: sometimes one thing, now and then two, each worth ≤ 30% of the pay. */
+export function workDrops(state, pay, next) {
+  const roll = next()
+  const count = roll < WORK_DROP.two ? 2 : roll < WORK_DROP.two + WORK_DROP.one ? 1 : 0
+  return give(state, count, next, { max: Math.max(1, pay * WORK_DROP_VALUE_RATIO) })
+}
+
+/** After a lesson: now and then one small thing. */
+export function studyDrops(state, next) {
+  return chance(next, STUDY_DROP_CHANCE) ? give(state, 1, next, { max: STUDY_DROP_MAX_PRICE }) : []
+}
+
+/** A graduation: three things from the better shelves, no medicine. */
+export function graduationDrops(state, next) {
+  const shelves = DROP_SHELVES.filter(shelf => !shelf.kinds.includes('medicine'))
+  return give(state, GRADUATION_DROP_COUNT, next, GRADUATION_DROP_PRICE, shelves)
+}
+
+/** "苹果、香皂" with their emoji — for the announcements. */
+export const describeDrops = given => given.map(item => `${item.emoji}${item.label}`).join('、')

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

@@ -0,0 +1,84 @@
+// @ts-check
+/**
+ * 记忆、公告与属性结算。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/effects
+ */
+
+import { MAX } from '../data.js'
+import { MEMORY_LIMIT, PENDING_LIMIT } from './constants.js'
+
+export const clamp = (value, min, max) => Math.min(max, Math.max(min, value))
+
+export const clamp100 = value => clamp(value, 0, 100)
+
+// ---------------------------------------------------------------------------
+// Life — the pig is measured in days, not in points
+//
+// QQ Pet's pets hatch, grow up and eventually die; nothing in it is a level to
+// grind. This is that idea, on a clock the pig can actually be watched against.
+// XP still accumulates from real work, but it feeds *weight*: a fatter pig, not
+// a higher one.
+// ---------------------------------------------------------------------------
+
+export function clock(nowMs) {
+  const d = new Date(nowMs)
+  return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`
+}
+
+export function remember(state, text, nowMs) {
+  state.memories.push(`[${clock(nowMs)}] ${text}`)
+  if (state.memories.length > MEMORY_LIMIT) state.memories.splice(0, state.memories.length - MEMORY_LIMIT)
+}
+
+/**
+ * Queue a message for the panel.
+ *
+ * Every message gets an `id` from a counter that only goes up, so the panel
+ * can tell two messages from the same instant apart — keying on `at` showed
+ * only the first of "病情加重" + "走了" and lost the second.
+ * @param {object} state
+ * @param {string} kind
+ * @param {string} text
+ * @param {number} nowMs
+ * @param {Record<string, unknown>} [extra] - kind-specific fields, e.g. a line's replies.
+ * @returns {{id: number, kind: string, text: string, at: number}}
+ */
+export function announce(state, kind, text, nowMs, extra = {}) {
+  state.pending = Array.isArray(state.pending) ? state.pending : []
+  const id = (Number.isInteger(state.pendingSeq) && state.pendingSeq >= 0 ? state.pendingSeq : 0) + 1
+  state.pendingSeq = id
+  const message = { ...extra, id, kind, text, at: nowMs }
+  state.pending.push(message)
+  if (state.pending.length > PENDING_LIMIT) state.pending.splice(0, state.pending.length - PENDING_LIMIT)
+  return message
+}
+
+export function takePending(state) {
+  const out = Array.isArray(state.pending) ? state.pending.slice() : []
+  state.pending = []
+  return out
+}
+
+/** Take and clear the queued announcements. */
+export function drainPending(state) {
+  return takePending(state)
+}
+
+/**
+ * Apply bar, weight and health changes. Growth is not an effect: it goes
+ * through growth.js `grow()`, which is what announces level-ups.
+ */
+export function applyEffects(state, effects, nowMs) {
+  if (effects.satiety) state.satiety = clamp100(state.satiety + effects.satiety)
+  if (effects.happiness) state.happiness = clamp100(state.happiness + effects.happiness)
+  if (effects.cleanliness) state.cleanliness = clamp100(state.cleanliness + effects.cleanliness)
+  if (effects.weightG) state.weightG = Math.max(400, state.weightG + effects.weightG)
+  if (effects.health) state.health = clamp(Math.round(state.health + effects.health), 0, MAX.health)
+  state.lastActiveAt = nowMs
+}
+
+// ---------------------------------------------------------------------------
+// Passive diet
+// ---------------------------------------------------------------------------

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

@@ -0,0 +1,120 @@
+// @ts-check
+/**
+ * 新猪的初始状态。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/egg
+ */
+
+import { DEFAULT_TIME_SCALE, MAX } from '../data.js'
+import { BIRTH_WEIGHT_G, HATCH_WEIGHT_G, STATE_VERSION } from './constants.js'
+import { remember } from './effects.js'
+import { emptyDialogue } from './lines.js'
+import { assignPersonality } from './profile.js'
+import { roll } from './random.js'
+
+export function layEgg(nowMs) {
+  return {
+    version: STATE_VERSION,
+    name: '猪猪',
+    bornAt: nowMs,
+    hatched: false,
+    dead: false,
+    /** When the pig died, so the grave can be left alone long enough for a soul. */
+    diedAt: null,
+    /** Last stage the panel announced; drives the "grew up" message. */
+    stage: 'box',
+    /** 加冕选的形态（data/evolution.js 的 key），null 是普通的猪。 */
+    form: null,
+    /** Accumulated pig time in ms — age is this, not wall clock. */
+    ageMs: 0,
+    /** 1 = the stage table is real months. See DEFAULT_TIME_SCALE. */
+    timeScale: DEFAULT_TIME_SCALE,
+    /** True when developer mode forced the age; the panel says so. */
+    ageForced: false,
+    xp: 0,
+    weightG: BIRTH_WEIGHT_G,
+    satiety: 70,
+    happiness: 70,
+    cleanliness: 90,
+    health: MAX.health,
+    // Enough to buy medicine on day one: at 60 a sick pig could not afford the
+    // cheapest cure and had nothing left to earn it with.
+    coins: 500,
+    inventory: {},
+    // 家当: dress items are bought once, owned forever, and worn.
+    dress: [],
+    worn: [],
+    traits: { intel: 0, charm: 0, strong: 0 },
+    // Lessons taken per subject (B4): the count decides the subject's stage
+    // and which jobs the pig qualifies for.
+    lessons: {},
+    // 兴趣课修读次数；满 CERTIFICATE_AFTER 次拿证。
+    interests: {},
+    souvenirs: [],
+    illness: null,
+    activity: null,
+    outingStreak: 0,
+    restMinutes: 0,
+    lastFedAt: 0,
+    lastActiveAt: nowMs,
+    lastSeenAt: nowMs,
+    cooldowns: {},
+    pending: [],
+    pendingSeq: 0,
+    dialogue: emptyDialogue(),
+    memories: [],
+    stats: {
+      turns: 0, messages: 0, tools: 0, toolErrors: 0, agentErrors: 0,
+      levelUps: 0, feeds: 0, baths: 0, plays: 0, pets: 0,
+      jobs: 0, coinsEarned: 0, purchases: 0, illnesses: 0, cures: 0, deaths: 0, revives: 0,
+      courses: 0, lessons: 0, trips: 0, sales: 0, interests: 0,
+    },
+  }
+}
+
+/**
+ * Open the box. The piglet falls out — it does not start as a fully grown pig,
+ * and `ageDays` starts counting from the moment it does.
+ */
+/**
+ * Open an existing box in place, keeping everything the save already has.
+ * `hatchEgg` builds a brand new pig; this one just lets the piglet out.
+ */
+export function hatch(state, nowMs) {
+  state.hatched = true
+  // A new body starts at Lv1: anything the box picked up before it opened
+  // (older saves let it eat real work) does not count toward growing up.
+  state.xp = 0
+  state.sex = pickSex(state)
+  assignPersonality(state)
+  state.bornAt = nowMs
+  state.ageForced = false
+  state.dead = false
+  state.diedAt = null
+  state.stage = 'piglet'
+  state.weightG += HATCH_WEIGHT_G
+  state.health = Math.max(state.health, 1)
+  remember(state, '纸盒打开了，一只小猪蹦了出来 🐷', nowMs)
+  return state
+}
+
+export function hatchEgg(nowMs) {
+  const state = layEgg(nowMs)
+  state.hatched = true
+  state.sex = pickSex(state)
+  assignPersonality(state)
+  state.bornAt = nowMs
+  state.ageForced = false
+  state.weightG += HATCH_WEIGHT_G
+  state.stage = 'piglet'
+  remember(state, '纸盒打开了，一只小猪蹦了出来 🐷', nowMs)
+  return state
+}
+
+/**
+ * Boy or girl, 50/50, from the pig's own random sequence.
+ * @param {object} state
+ * @returns {'boy'|'girl'}
+ */
+export const pickSex = state => (roll(state) < 0.5 ? 'boy' : 'girl')

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

@@ -0,0 +1,90 @@
+// @ts-check
+/**
+ * 加冕：长成之后由主人选一种形态（data/evolution.js）。达标不会自动加冕，
+ * 不加钱、不改成长和疾病规则，只换样子。复活保留形态，领养的新猪从头来。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/evolution
+ */
+
+import { DEFAULT_FORM, FORMS, LIFE_STAGES, TRAITS, formByKey } from '../data.js'
+import { levelFor, lifeStageFor } from './clock.js'
+import { announce, remember } from './effects.js'
+import { decay } from './settlement.js'
+
+/** The level a stage starts at (成年猪 → 40). */
+function stageLevel(stageKey) {
+  return LIFE_STAGES.find(stage => stage.key === stageKey)?.fromLevel ?? 0
+}
+
+/** One form's conditions, each with what the pig has now. */
+function requirementsFor(state, form) {
+  const rows = [{ key: 'level', label: '等级', have: levelFor(state.xp), need: stageLevel(form.stage) }]
+  for (const [key, need] of Object.entries(form.requires)) {
+    rows.push({
+      key,
+      label: key === 'jobs' ? '打工' : (TRAITS[key]?.label ?? key),
+      have: key === 'jobs' ? (state.stats?.jobs ?? 0) : (state.traits?.[key] ?? 0),
+      need,
+    })
+  }
+  return rows.map(row => ({ ...row, met: row.have >= row.need }))
+}
+
+/**
+ * Every form and how close the pig is to it. `ready` means 加冕 would work now.
+ * @param {object} state
+ * @returns {{ current: string | null, forms: object[] } | null}
+ */
+export function formsView(state) {
+  if (state === null || state.hatched !== true) return null
+  const alive = state.dead !== true
+  return {
+    current: formByKey(state.form)?.key ?? null,
+    forms: FORMS.map(form => {
+      const requirements = requirementsFor(state, form)
+      return {
+        key: form.key, label: form.label, emoji: form.emoji, art: form.art,
+        current: state.form === form.key,
+        ready: alive && state.form !== form.key && requirements.every(row => row.met),
+        requirements,
+      }
+    }),
+  }
+}
+
+/**
+ * 加冕. Settles elapsed time first, so a pig that died while the panel was
+ * closed cannot be crowned. Crowning into the form it already has is a no-op.
+ * @param {object} state
+ * @param {number} nowMs
+ * @param {string} [formKey]
+ */
+export function crown(state, nowMs, formKey = DEFAULT_FORM) {
+  if (state === null) return { ok: false, reason: 'absent' }
+  const form = formByKey(formKey)
+  if (form === null) return { ok: false, reason: 'unknown' }
+  if (state.hatched !== true) return { ok: false, reason: 'box' }
+  decay(state, nowMs)
+  if (state.dead === true) return { ok: false, reason: 'dead' }
+  if (state.form === form.key) return { ok: true, form: form.key }
+  const missing = requirementsFor(state, form).filter(row => !row.met)
+  if (missing.length > 0) return { ok: false, reason: 'coronation-ineligible', missing }
+  state.form = form.key
+  remember(state, `👑 加冕成为${form.label}，本事和生活都照旧`, nowMs)
+  announce(state, 'coronation', `${state.name} 加冕成为${form.label}！`, nowMs)
+  return { ok: true, form: form.key }
+}
+
+/**
+ * The life stage with the chosen form laid over it: same key and size, the
+ * form's name, line and sprite. The grave and earlier stages are untouched.
+ * @param {object} state
+ * @param {number} nowMs
+ */
+export function formStageView(state, nowMs) {
+  const life = lifeStageFor(state, nowMs)
+  const form = state === null ? null : formByKey(state.form)
+  if (form === null || life.key !== form.stage) return { ...life, actionArt: false, hides: [] }
+  return { ...life, label: form.label, art: form.art, line: form.line, actionArt: form.actionArt, hides: [...form.hides] }
+}

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

@@ -0,0 +1,110 @@
+// @ts-check
+/**
+ * 成长：时间自己长、照顾好坏定快慢、陪主人干活有加成、升级和换形态。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * 数字见 data/growth.js（docs/tasks/numbers/B2-growth.md）。
+ * @module dsh-piggy/core/growth
+ */
+
+import {
+  DSH_GROWTH,
+  DSH_GROWTH_DAILY_CAP,
+  GROWTH_PER_HOUR,
+  MAX,
+  MIN_GROWTH_FACTOR,
+  MOOD_GROWTH_FACTORS,
+  NEGLECT_GROWTH_FACTOR,
+  SICK_GROWTH_PENALTY_PER_HEALTH,
+  THRESHOLDS,
+  WORK_GROWTH_PER_HOUR,
+} from '../data.js'
+import { dayKeyFor, levelFor, levelTitle, lifeStageFor } from './clock.js'
+import { announce, remember } from './effects.js'
+import { say } from './lines.js'
+import { noteToday } from './diary.js'
+
+/**
+ * How fast the pig is growing right now, as a multiplier on the base rate.
+ * Mood sets the band; being hungry or dirty and being ill each take a further
+ * cut. The factors multiply, and never drop below MIN_GROWTH_FACTOR.
+ * @param {object} state
+ * @returns {number}
+ */
+export function careFactor(state) {
+  const mood = MOOD_GROWTH_FACTORS.find(band => state.happiness >= band.min) ?? MOOD_GROWTH_FACTORS.at(-1)
+  let factor = mood?.factor ?? 1
+  if (state.satiety < THRESHOLDS.hungry || state.cleanliness < THRESHOLDS.dirty) factor *= NEGLECT_GROWTH_FACTOR
+  if (state.illness !== null && state.illness !== undefined) {
+    const lost = Math.max(0, MAX.health - state.health)
+    factor *= Math.max(0, 1 - lost * SICK_GROWTH_PENALTY_PER_HEALTH)
+  }
+  return Math.max(MIN_GROWTH_FACTOR, factor)
+}
+
+/**
+ * Add growth and announce whatever it crosses: each level, a new title, a new
+ * body. The only way `xp` should ever go up.
+ * @param {object} state
+ * @param {number} amount
+ * @param {number} nowMs
+ */
+export function grow(state, amount, nowMs) {
+  if (!(amount > 0) || state.hatched !== true || state.dead === true) return
+  const before = levelFor(state.xp)
+  const stageBefore = state.stage
+  state.xp = (Number.isFinite(state.xp) ? state.xp : 0) + amount
+  const after = levelFor(state.xp)
+  if (after > before) announceLevelUp(state, before, after, nowMs)
+  const stage = lifeStageFor(state, nowMs)
+  if (stage.key !== stageBefore) {
+    state.stage = stage.key
+    remember(state, `长成了${stage.label} ${stage.emoji}`, nowMs)
+    announce(state, 'stage', `${state.name} 长成了${stage.label} ${stage.emoji}`, nowMs)
+    noteToday(state, 'stage')
+    say(state, 'growUp', nowMs)
+  }
+}
+
+function announceLevelUp(state, before, after, nowMs) {
+  state.stats.levelUps = (state.stats.levelUps ?? 0) + (after - before)
+  noteToday(state, 'levelUp', after - before)
+  const title = levelTitle(after)
+  const newTitle = levelTitle(before).level !== title.level
+  remember(state, `升到 Lv.${after}${newTitle ? `，成了「${title.label}」` : ''}`, nowMs)
+  announce(state, 'levelup', newTitle
+    ? `${state.name} 升到 Lv.${after}，成了「${title.label}」${title.emoji}`
+    : `${state.name} 升到 Lv.${after} ✨`, nowMs)
+  say(state, 'levelup', nowMs)
+}
+
+/**
+ * Growth from time passing: the base rate times the care factor, over pig time
+ * (so the debug page's time scale speeds it up along with age).
+ * @param {object} state
+ * @param {number} pigMs - elapsed pig time in this step
+ * @param {number} atMs
+ */
+export function growWithTime(state, pigMs, atMs) {
+  grow(state, (pigMs / 3_600_000) * GROWTH_PER_HOUR * careFactor(state), atMs)
+}
+
+/**
+ * The bonus for keeping the owner company while they really work — a turn
+ * ended, a tool ran — up to DSH_GROWTH_DAILY_CAP a day.
+ * @param {object} state
+ * @param {string} event - a DIET key; only those in DSH_GROWTH count
+ * @param {number} nowMs
+ */
+export function growFromRealWork(state, event, nowMs) {
+  const amount = DSH_GROWTH[event]
+  if (amount === undefined || state.hatched !== true || state.dead === true) return
+  const day = dayKeyFor(nowMs)
+  const today = state.realWorkGrowth?.day === day ? state.realWorkGrowth.amount : 0
+  const granted = Math.min(amount, Math.max(0, DSH_GROWTH_DAILY_CAP - today))
+  state.realWorkGrowth = { day, amount: today + granted }
+  grow(state, granted, nowMs)
+}
+
+/** Growth for time spent out working or travelling. */
+export const outingGrowth = minutes => Math.round((minutes / 60) * WORK_GROWTH_PER_HOUR)