← Symbaroumv1.5.0

Changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog 1.1.0, and this project adheres to Semantic Versioning 2.0.0.

1.5.0 - 2026-05-03

Printable PDF export — a paper-friendly view of any saved character so players who build in the app can carry the build to a tabletop session on a real PG sheet.

Added

  • Print route at /characters/[id]/print — a sibling to the regular sheet that loads the same character via LocalCharacterStore.load(id) and renders a <PrintableSheet> optimized for paper.
  • <PrintableSheet> component showing every static field needed for paper transfer: identity, ability scores + modifiers, saving throws, all 18 skills, combat pills (max HP / hit die / prof bonus / initiative / speed / corruption threshold), the full feature list (origin → subchoice → background → class → approach, plus per-level features through current level), boons and burdens with full descriptions, level-up feats with descriptions, spells known grouped by level (name + level only — descriptions stay in the PG), equipment from class picks + background, identity tropes, and a Notes block with reserved space for handwritten additions.
  • Auto-fire window.print() on mount with a 250ms paint settle so fonts load before the dialog snapshots the page. A no-print control bar above the sheet exposes "← Back to sheet" and "Print again" for re-firing or stepping back.
  • "Print" link in the regular sheet's action bar (next to "Export JSON") that opens the print route in a new browser tab.
  • Print stylesheet — @page { size: A4; margin: 12mm 14mm }, white body background, near-black text, @media print overrides that hide controls. Section cards apply CSS break-inside: avoid so the printer never splits a feature mid-paragraph.
  • Traceability footer — Generated by symbarator vX.Y.Z on YYYY-MM-DD reading from lib/version.ts.
  • 5 new E2E tests in e2e/print.spec.ts covering route render, deliberate omission of companion-mode live state, the regular sheet's Print link wiring, empty-section hiding (Notes always shows), and the version+date footer format. Existing 35 tests still pass.

Changed

  • The print route deliberately omits companion-mode live state (currentHp, tempHp, currentSpellSlots, hitDiceRemaining, deathSaves, corruption.permanent/temporary). The printout is a paper-transfer artifact for the character snapshot — only the computed Corruption Threshold appears, not the running counters.
  • Visual style is paper-first: the parchment / gradient look from the screen sheet is intentionally absent on the print route. A single crimson rule (#7a1f1f) under each section header is the only color accent.

1.4.0 - 2026-05-03

Companion mode — the read-only character sheet becomes a play-time companion. Apply damage, spend slots, take rests, track death saves, and adjust Corruption directly from the sheet.

Added

  • HP & Vitals panel at the top of the sheet. Current/max readout (downed pill turns crimson when at 0), Damage / Heal / Set-Temp-HP inputs that apply on click or Enter. Temp HP soaks before currentHp; healing caps at maxHp; currentHp floors at 0.
  • Hit Dice tracker + "Spend Hit Die" button inside the Vitals panel. Heals by floor(hitDie/2) + 1 + Con mod (min 1) and decrements hitDiceRemaining.
  • Death Saves panel — appears only when currentHp === 0. Three success and three failure pips with explicit ✓ / ✗ buttons; counters cap at 3. Three successes shows a "Stable" indicator; three failures shows "Dead". Healing above 0 hides the panel and zeroes the counters.
  • Spell Slot pip rows above the Spellcraft tabs (only for spellcasting approaches). One pip per slot, click filled to spend, click empty to restore. Bounded by the approach's progression at the current level.
  • Corruption parchment with explicit + / − adjusters next to the computed Threshold; "Over" badge when temporary > threshold. Surfaces fields that already lived on Character but were never editable.
  • Rest panel with three buttons: Short Rest (UI affordance), Long Rest (full HP, half HD restored rounded up, all spell slots, death saves cleared, temp HP cleared), Extended Rest (long rest + every Hit Die restored).
  • lib/character/live-state.ts — pure-function module exporting every state transition (applyDamage, applyHeal, addTempHp, spendSlot, restoreSlot, spendHitDie, recordDeathSave, shortRest, longRest, extendedRest, bumpCorruption). All bound checks live here; UI never produces invalid state.
  • 5 new E2E tests in e2e/companion.spec.ts — damage round-trip + persistence, slot spend/restore, long rest restoration, death-saves cap-and-hide, wounded level-up keeps current HP at the offset (capacity grows, no auto-heal).

Changed

  • Schema — Character gains five required fields: currentHp: number, tempHp: number, currentSpellSlots: number[] (length 9), hitDiceRemaining: number, deathSaves: { successes; failures }. Pre-1.4 saves are backfilled by migrateCharacter on first load: currentHp = maxHp, tempHp = 0, currentSpellSlots from the approach's progression row at the character's level (or nine zeros for non-spellcasters), hitDiceRemaining = level, deathSaves = { 0, 0 }. No persisted save fails to load.
  • Level-up flow now bumps live state alongside max stats: currentHp advances by the same delta maxHp does (a wounded character gains capacity, not healing); hitDiceRemaining increments by 1; newly-unlocked spell-slot tiers start full while already-existing tiers keep their spent count. The Confirm step now surfaces the current-HP delta and HD bump.
  • Sheet layout — the static "Hit Points" and "Hit Dice" rows in the right-column Combat block were removed (the new Vitals panel is the source of truth). The static "Shadow & Corruption" parchment is replaced by the interactive Corruption panel. The Spellcraft parchment shows pips above the spellbook tabs.
  • Companion-mode buttons use a Symbaroum-themed SymButton (crimson primary, dark-on-cream secondary) instead of shadcn Button defaults — the design-token palette washed out against the cream parchment background.

1.3.0 - 2026-05-02

Boons & Burdens at character creation, with ability bonuses flowing through to the sheet.

Added

  • Boons & Burdens wizard step between Abilities and Skills/Equipment. Pick 0 or 1 boon and 0 or 1 burden at L1; the step is optional and skipping it is valid.
  • Choice-boon support: when a boon's ability bonus is "choice" (e.g. Blood Ties, Con Artist, Enterprise), the wizard surfaces an inline ability picker. The chosen ability persists in the new Character.boonAbilityChoices field.
  • Boon ability bonuses honored on the sheet. computeFinalAbilities now adds boon +1s as a fourth bonuses term alongside origin-fixed, origin-floating, and subchoice. A character with Archivist (INT +1) sees their final INT total bumped by 1 wherever it's displayed.
  • Origin restrictions for boons — hand-coded BOON_FORBIDDEN_ORIGINS map blocks Absolute Memory for Dwarves and Beast Tongue for Goblins (per PG p. 147–155). Restricted boons are visibly disabled in the picker and rejected by the validator if reached via hand-edited JSON.
  • Boons and Burdens sections on the character sheet. Resolved via BOON_BY_ID / BURDEN_BY_ID. Each section hides when its array is empty. Boons that grant an ability bonus show a (+1 INT)-style suffix on the card title.
  • Reusable <FeatGroup> component factored out of <FeatList> so Boons / Burdens / level-up Feats all share the same card style without duplication.
  • 6 new E2E tests in e2e/boons-burdens.spec.ts covering: empty hides section, fixed-ability boon shows on sheet with chosen-ability label, choice-boon shows the chosen ability, burden shows on sheet, wizard picks Archivist and persists, choice-boon validation rejects empty advance then accepts after picking the ability.

Changed

  • Schema — Character gains a required boonAbilityChoices: Record<string, Ability> field. Pre-1.3 saves are backfilled with {} by migrateCharacter on first load. No persisted save fails to load.
  • Wizard STEPS widens from 7 to 8 entries; the new step lives at /builder/boons-burdens?id=<id>.
  • <FeatList>'s "Boons" subgroup renamed to "From the Boon list" to clarify it's the level-up Character.feats resolved against the boon catalog, not the new L1 Character.boons.

Fixed

  • /changelog E2E selector tightened with .first() — three released versions now share the date string and the previous selector matched all of them.

1.2.0 - 2026-05-02

Release tooling: three Claude Code slash commands that automate the documented SemVer release flow.

Added

  • /patch, /minor, /major slash commands under .claude/commands/. Each one runs the full release flow non-interactively: preflight (clean tree, on main, up-to-date with origin), abort if no commits since the last v* tag, compute the next version, draft a Keep a Changelog entry from git log <last-tag>..HEAD, run npm version <level> --no-git-tag-version, commit release: vX.Y.Z with CHANGELOG + package.json + package-lock.json, tag, push branch, push tag.
  • Bias and guardrails per command:
    • /patch biases the changelog toward ### Fixed.
    • /minor biases toward ### Added and surfaces detected breaking changes (Character/storage shape edits, modified spec scenarios) instead of silently promoting.
    • /major refuses to proceed without a concrete breaking change identified, and fronts the entry with an explicit BREAKING callout plus migration guidance.
  • Shared safety rails across all three: halt on any failure, never amend or force-push, never re-tag an existing version, no npm install / npm audit fix side effects.

1.1.0 - 2026-05-02

Tab-per-level spells UI and a proper grouped feat list on the sheet.

Added

  • Reusable <SpellTabs> component — one tab per spell level with a count badge, empty levels auto-hidden, default-active = lowest available. Used in three places: the sheet spellbook, the level-up picker, and the L1 builder approach step.
  • <SpellCard> leaf component with display and picker modes via a discriminated union; school and ritual badges; reused inside every tabbed view.
  • <FeatList> component on the character sheet — resolves boon ids via BOON_BY_ID and renders one card per feat (name + description). The Changeling sentinel change-self and fighting-style:* markers are grouped under a separate "Special" subsection.
  • e2e/sheet.spec.ts with two tests covering the sheet spellbook tabs (renders for known levels only; clicking a tab swaps the visible pool).
  • spell-tabs switch the visible pool when clicked test in e2e/level-up.spec.ts.

Changed

  • Sheet spellbook uses <SpellTabs> in display mode instead of two flat <SpellList> blocks. Only renders tabs for spell levels the character actually knows spells at.
  • Level-up SpellsLearnedStep uses <SpellTabs> for leveled spells; cantrips stay as a flat grid above. Removed the inline (L1) annotation and the "Pick from any level you have slots for: 1, 2" hint paragraph since the tab row makes the available levels self-evident.
  • L1 builder ApproachStep uses <SpellTabs levels={[1]}> so the visual language matches what the player will see at level-up time.
  • Sheet feats rendered as a grouped card list (Boons / Special) in their own Parchment section instead of c.feats.join(", ") inside the Features blurb.

Fixed

  • "Higher-level spells when slots unlock" E2E test asserts tab presence (1st, 2nd) instead of the deprecated hint paragraph.

1.0.0 - 2026-05-02

First feature-complete release. The character builder ships with the full Ruins of Symbaroum 5E rules data, sheet-driven leveling from L1 to L20, an E2E test suite, and the canonical PG spell catalog.

Added

  • L1 character builder. Seven-step wizard (Origin → Background → Class → Approach → Abilities → Skills & Equipment → Identity) with localStorage persistence and JSON export/import.
  • Origins, classes, approaches, backgrounds, skills. All five Symbaroum classes (Captain, Hunter, Mystic, Scoundrel, Warrior) and their approaches encoded with PG-accurate rules data.
  • Leveling from L1 to L20. Sheet-driven Level Up dialog covering HP gain (average / rolled), ASI / feat / Changeling Change Self, fighting-style picks, and spell learning. Symbaroum places ASI/feat slots at L4/8/10/12/16/19, with Captain and Warrior gaining a bonus slot at L14 per the PG.
  • Spellcasting on approaches, not classes. Mystic (full caster, every approach), Warrior/Templar (half caster), Hunter/Witch Hunter (ritual-only), Scoundrel/Former Cultist (half caster). Per-approach progression matches the PG charts.
  • Full spell catalog. 297 spells across cantrips through 9th level, tagged by tradition (Sorcerer, Theurg, Troll Singer, Witch, Wizard) per PG pp. 187–190. Symbaroum-specific spells (Black Bolt, Spirit Walk, Holy Smoke, Anathema, Lifegiver, Soul Stone, Blood Storm, etc.) included with PG-derived mechanical summaries.
  • Storage migration. Pre-leveling-shape saves load cleanly and gain feats/maxHp/widened level on first load.
  • End-to-end test suite. Playwright + Chromium, 19 tests covering the L1 builder happy path, every level-up variant (including the duplicate-spell dedupe and dialog-remount regressions), schema migration, JSON round-trip, and the L20 disable. Runs in ~5 seconds via npm run test:e2e.
  • Versioning surface. This changelog, plus a v1.0.0 badge in the home footer and on the character sheet header that links here.

Changed

  • Character.level widened from the literal 1 to a 1..20 numeric union.
  • ClassDef.spellcasting moved to ApproachDef.spellcasting so non-Mystic spellcasting approaches (Templar, Witch Hunter, Former Cultist) can carry their own progressions.
  • Mystic L1 cantrips known corrected from 2 to 6 per PG p. 108; spells known progression set to [2, 3, 4, …, 21] (+1 per level).
  • Tradition tags corrected: Artifact Crafter → Troll Singer list, Staff Mage / Symbolist → Wizard list, Former Cultist → Sorcerer list (PG pp. 111, 115, 117, 129).

Fixed

  • Dialog state retention across consecutive level-ups (answer.pick undefined on second open) — the sheet now keys the dialog on ${id}-${level} so it remounts fresh each time.
  • Level-up spell pickers exclude already-known spells, fixing the duplicate-Bless regression for Templars.
  • Spell pickers surface every spell level the character has slots for (e.g. a Templar at L6 sees both 1st- and 2nd-level Theurg spells).