@archivist-gg/dnd5e 0.1.1 → 0.3.0

package/dist/pc/pc.types.d.ts

@@ -35,6 +35,10 @@ export interface EquipmentEntryOverrides {
     immune?: string[];
     vulnerable?: string[];
     condition_immune?: string[];
+    /** Per-instance spell payload (e.g. the spell a Spell Scroll casts). */
+    spell?: string;
+    /** Ability governing this instance's spell save DC / attack when cast. */
+    spell_ability?: Ability;
 }
 export interface EquipmentEntryState {
     charges?: {
@@ -92,6 +96,10 @@ export interface KnownSpellObject {
     source?: "class" | "feat" | "item" | "race" | "domain";
     prepared?: boolean;
     always_prepared?: boolean;
+    /** The spell's own spellcasting ability (e.g. WIS for a Magic Initiate (Cleric)
+     *  pick). Belongs on the persisted shape for symmetry with ResolvedSpell.ability;
+     *  feat spells arrive via origin_choices, but a known-spell entry may carry it. */
+    ability?: Ability;
 }
 export type KnownSpellEntry = string | KnownSpellObject;
 export type PassiveKind = "perception" | "investigation" | "insight";
@@ -112,6 +120,8 @@ export interface CharacterOverrides {
     }>;
     hp?: {
         max?: number;
+        rolled?: number;
+        modifier?: number;
     };
     ac?: number;
     speed?: number;
@@ -120,6 +130,10 @@ export interface CharacterOverrides {
         saveDC?: number;
         attackBonus?: number;
     };
+    /** Character-level spellcasting ability for spells that carry no ability of
+     *  their own (e.g. a Spell Scroll cast by a non-caster): the DC-ability fallback
+     *  after a per-instance override and the character's own class ability. */
+    spellcasting_ability?: Ability;
     spell_slots?: Record<number, number>;
     attunement_limit?: number;
 }
@@ -267,6 +281,14 @@ export interface ResolvedSpell {
     source: "class" | "feat" | "item" | "race" | "domain";
     prepared: boolean;
     alwaysPrepared: boolean;
+    /** The spell's OWN spellcasting ability. For a feat spell this carries the
+     *  chosen ability (e.g. WIS for Magic Initiate (Cleric)) while classSlug stays
+     *  null (a feat spell is not owned by a class for DC/ability). Absent/undefined
+     *  for class spells, which derive their ability from classSlug. */
+    ability?: Ability | null;
+    /** Index of the originating equipment entry when this spell was granted by a
+     *  per-instance item (e.g. a Spell Scroll). Absent for class/feat/race spells. */
+    entryIndex?: number;
 }
 export interface ResolvedClass {
     entity: ClassEntity | null;
@@ -319,6 +341,27 @@ export interface ACTerm {
     amount: number;
     kind: "armor" | "shield" | "item" | "unarmored" | "override" | "dex" | "ability" | "feature";
 }
+/** Structured max-HP math for the Max HP modal. Spec: P5 2026-07-21. */
+export interface HPBreakdown {
+    diceSum: number;
+    diceSource: "rolled" | "average";
+    averageDiceSum: number;
+    conMod: number;
+    conLevels: number;
+    clampApplied: boolean;
+    perLevelTerms: {
+        label: string;
+        perLevel: number;
+        levels: number;
+        total: number;
+    }[];
+    modifier: number | null;
+    exhaustionMultiplier: number;
+    exhaustionLevel: number;
+    derivedMax: number;
+    override: number | null;
+    final: number;
+}
 /** An additive on-hit damage rider (dice or flat) applied to an attack, from a
  *  feature (global — all weapon attacks) or a magic item (that weapon only).
  *  `amount` is a dice/flat string ("2d6", "1d8", "2"); `damage_type` optional
@@ -333,6 +376,10 @@ export interface AttackRow {
     id: string;
     name: string;
     range?: string;
+    /** Secondary thrown-mode range ("20/60 ft") for a throwable melee weapon.
+     *  Display-only; rendered as a stacked muted second line in the Range cell.
+     *  Absent otherwise. */
+    thrownRange?: string;
     toHit: number;
     damageDice: string;
     damageType: string;
@@ -376,15 +423,17 @@ export interface AttackRow {
     attackNotes?: string[];
     /** 2024 Weapon Mastery for this attack, present only when the character has
      *  chosen mastery of this weapon AND is proficient with it AND the weapon
-     *  declares a mastery property. `slug`/`label`/`description` come from the
-     *  mastery glossary; `derived` carries the computed number for the two
-     *  numeric masteries (topple → Save DC, graze → On-miss damage) and is absent
-     *  for the rest. Additive + display-only — absent (undefined) on untouched
-     *  rows so nothing else changes. */
+     *  declares a mastery property. `slug`/`label`/`description`/`gist` come from
+     *  the mastery glossary (`gist` = a one-line effect summary for the Actions-tab
+     *  mastery column, e.g. "on fail: Prone"); `derived` carries the computed
+     *  number for the two numeric masteries (topple → Save DC, graze → On-miss
+     *  damage) and is absent for the rest. Additive + display-only, absent
+     *  (undefined) on untouched rows so nothing else changes. */
     mastery?: {
         slug: string;
         label: string;
         description: string;
+        gist?: string;
         derived?: {
             label: string;
             value: number;
@@ -480,6 +529,16 @@ export interface DerivedStats {
     } | null;
     /** One entry per casting class (multiclass-aware). Empty for non-casters. */
     spellcastingClasses: SpellcastingClassInfo[];
+    /** Save DC / attack bonus for spells that carry their OWN spellcasting
+     *  ability rather than a class (feat-granted spells, e.g. Magic Initiate).
+     *  Keyed by that ability; populated for every ability a feat spell uses.
+     *  Computed independently of class casters, so a NON-caster (empty
+     *  spellcastingClasses / null spellcasting) still gets a real DC/attack.
+     *  Empty object when the character has no such spell. */
+    abilitySpellcasting: Partial<Record<Ability, {
+        saveDC: number;
+        attackBonus: number;
+    }>>;
     /** Derived standard slot totals by spell level (before user override). */
     derivedSpellSlots: Record<number, number>;
     /** Warlock Pact Magic, or null. */
@@ -497,6 +556,7 @@ export interface DerivedStats {
         condition_immunities: string[];
     };
     acBreakdown: ACTerm[];
+    hpBreakdown: HPBreakdown;
     acInformational: import("@archivist-gg/dnd5e/item/item.conditions.types").InformationalBonus[];
     /** Situational saving-throw bonuses (e.g. +1 vs spells) for save tooltips. */
     savesInformational: import("@archivist-gg/dnd5e/item/item.conditions.types").InformationalBonus[];

package/dist/race/race.codec.js

@@ -1,12 +1,12 @@
 import {
   raceCodec
-} from "../chunk-PKC77VZP.js";
-import "../chunk-IDTDACM6.js";
-import "../chunk-FFULAF2P.js";
-import "../chunk-DABBCYTT.js";
+} from "../chunk-ZZGEVJKX.js";
+import "../chunk-PHQRGDRQ.js";
+import "../chunk-2BWAID3Y.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   raceCodec

package/dist/race/race.parser.js

@@ -1,11 +1,11 @@
 import {
   parseRace
-} from "../chunk-IDTDACM6.js";
-import "../chunk-FFULAF2P.js";
-import "../chunk-DABBCYTT.js";
+} from "../chunk-PHQRGDRQ.js";
+import "../chunk-2BWAID3Y.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   parseRace

package/dist/race/race.schema.js

@@ -1,10 +1,10 @@
 import {
   raceEntitySchema
-} from "../chunk-FFULAF2P.js";
-import "../chunk-DABBCYTT.js";
+} from "../chunk-2BWAID3Y.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   raceEntitySchema

package/dist/schemas/choice-schema.js

@@ -1,6 +1,6 @@
 import {
   choiceSchema
-} from "../chunk-CDW7R2QT.js";
+} from "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   choiceSchema

package/dist/schemas/feature-schema.js

@@ -1,9 +1,9 @@
 import {
   featureSchema
-} from "../chunk-DABBCYTT.js";
+} from "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   featureSchema

package/dist/spell/spell.access.js

@@ -1,6 +1,6 @@
 import {
   baseClassName
-} from "../chunk-J2RYSZMQ.js";
+} from "../chunk-VTTA2ALZ.js";
 
 // src/spell/spell.access.ts
 function classSpellCandidates(registry, classSlugs, maxLevel, knownSlugs, showAll = false, query = "") {

package/dist/subclass/subclass.codec.js

@@ -1,13 +1,13 @@
 import {
   subclassCodec
-} from "../chunk-SSXBYF3P.js";
-import "../chunk-PMADYMUI.js";
-import "../chunk-B7UXKNLD.js";
+} from "../chunk-XLSVNUTK.js";
+import "../chunk-L7E2UT5A.js";
+import "../chunk-W7HWMMBF.js";
 import "../chunk-4TIJKN6O.js";
-import "../chunk-DABBCYTT.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   subclassCodec

package/dist/subclass/subclass.parser.js

@@ -1,12 +1,12 @@
 import {
   parseSubclass
-} from "../chunk-PMADYMUI.js";
-import "../chunk-B7UXKNLD.js";
+} from "../chunk-L7E2UT5A.js";
+import "../chunk-W7HWMMBF.js";
 import "../chunk-4TIJKN6O.js";
-import "../chunk-DABBCYTT.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   parseSubclass

package/dist/subclass/subclass.schema.js

@@ -1,11 +1,11 @@
 import {
   subclassEntitySchema
-} from "../chunk-B7UXKNLD.js";
+} from "../chunk-W7HWMMBF.js";
 import "../chunk-4TIJKN6O.js";
-import "../chunk-DABBCYTT.js";
+import "../chunk-CZPMTQOY.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-PZOWBI3B.js";
-import "../chunk-CDW7R2QT.js";
+import "../chunk-NXSWH3AE.js";
 import "../chunk-NXR3BD2V.js";
 export {
   subclassEntitySchema

package/dist/types/choice.d.ts

@@ -19,6 +19,11 @@ export interface EntityFilter {
     /** Armor proficiency class. Matched against an armor entity's `category`
      *  field exactly; "shield" selects shields. */
     armor_category?: "light" | "medium" | "heavy" | "shield";
+    /** Spell axis: filter spells by class list, level, and edition. Set together on a
+     *  select-entity{entity_type:"spell"} choice (e.g. Magic Initiate). */
+    list?: string;
+    level?: number;
+    edition?: string;
 }
 export interface InlineOption {
     value: string;

package/dist/weapon/weapon-mastery.d.ts

@@ -1,8 +1,11 @@
 export declare const MASTERY: Record<string, {
     label: string;
     description: string;
+    gist: string;
 }>;
 export declare function masteryLabel(slug: string): string | undefined;
+/** One-line effect gist for a mastery slug (or undefined for an unknown slug). */
+export declare function masteryGist(slug: string): string | undefined;
 export declare function masteryDerived(slug: string, abilityMod: number, proficiencyBonus: number): {
     label: string;
     value: number;

package/dist/weapon/weapon.classify.d.ts

@@ -0,0 +1,21 @@
+import type { WeaponEntity } from "./weapon.types.js";
+/** The two attack modes a weapon supports, derived from data the SRD pipeline
+ *  actually preserves. The SRD runtime data miscategorizes throwable MELEE
+ *  weapons (dagger/spear/handaxe/javelin/light hammer/trident) as `*-ranged`,
+ *  so the melee/ranged split is reconstructed here instead of trusted:
+ *  a category-ranged weapon is PURE ranged only when it needs ammunition or
+ *  loading, or is one of the two genuinely-ranged thrown weapons (dart, net —
+ *  a closed SRD set; a homebrew weapon whose bare slug is exactly "dart"/"net"
+ *  is force-classified pure ranged). Everything else category-ranged is a
+ *  throwable melee weapon. `reach` is 5 ft, +5 with the reach property. */
+export interface WeaponRangeModes {
+    melee: {
+        reach: number;
+    } | null;
+    ranged: {
+        normal: number;
+        long: number;
+        thrown: boolean;
+    } | null;
+}
+export declare function classifyWeaponRange(weapon: Pick<WeaponEntity, "category" | "properties" | "range" | "slug">): WeaponRangeModes;

package/dist/weapon/weapon.classify.js

@@ -0,0 +1,7 @@
+import {
+  classifyWeaponRange
+} from "../chunk-353WXS6S.js";
+import "../chunk-LV4SNWZQ.js";
+export {
+  classifyWeaponRange
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archivist-gg/dnd5e",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "license": "MIT",
   "type": "module",
   "publishConfig": {

package/dist/chunk-6PXE7T7C.js

@@ -1,79 +0,0 @@
-import {
-  readTableColumn
-} from "./chunk-5XUXXAQJ.js";
-import {
-  bareEntitySlug,
-  wikilinkTailSlug
-} from "./chunk-TJCNX6UZ.js";
-
-// src/pc/pc.pools.ts
-function levelPrereqMax(d) {
-  var _a;
-  return ((_a = d.prerequisites) != null ? _a : []).filter((p) => p.kind === "level").reduce((m, p) => Math.max(m, p.min), 0);
-}
-function resolvePool(rc, classIndex, pool, registry) {
-  var _a, _b, _c, _d, _e, _f, _g;
-  const entity = rc.entity;
-  const level = rc.level;
-  const ownerBare = bareEntitySlug(entity.slug);
-  const col = pool.count.column;
-  const count = (_a = readTableColumn(entity.table, level, [col])) != null ? _a : 0;
-  let anchorLevel = 1;
-  for (let l = 1; l <= 20; l++) {
-    const c = readTableColumn(entity.table, l, [col]);
-    if (c != null && c >= 1) {
-      anchorLevel = l;
-      break;
-    }
-  }
-  const ft = pool.source.where.feature_type;
-  const all = registry.search("", "optional-feature", Number.POSITIVE_INFINITY);
-  const byBare = /* @__PURE__ */ new Map();
-  const available = [];
-  for (const e of all) {
-    const d = e.data;
-    const entry = { slug: e.slug, entity: d };
-    byBare.set(bareEntitySlug(e.slug), entry);
-    if (d.feature_type !== ft) continue;
-    if (!((_b = d.available_to) != null ? _b : []).some((l) => wikilinkTailSlug(l) === ownerBare)) continue;
-    if (levelPrereqMax(d) > level) continue;
-    available.push(entry);
-  }
-  const grantDecls = [
-    ...(_d = (_c = rc.entity) == null ? void 0 : _c.pool_grants) != null ? _d : [],
-    ...(_f = (_e = rc.subclass) == null ? void 0 : _e.pool_grants) != null ? _f : []
-  ];
-  const grantsRaw = grantDecls.filter((g) => g.pool === pool.id).flatMap((g) => g.grants).filter((g) => g.at_level <= level).map((g) => byBare.get(wikilinkTailSlug(g.feature))).filter((e) => e != null);
-  const grantedBare = /* @__PURE__ */ new Set();
-  const grants = grantsRaw.filter((e) => {
-    const key = bareEntitySlug(e.slug);
-    if (grantedBare.has(key)) return false;
-    grantedBare.add(key);
-    return true;
-  });
-  const raw = (_g = rc.choices[anchorLevel]) == null ? void 0 : _g[pool.id];
-  const selectedSlugs = Array.isArray(raw) ? raw : typeof raw === "string" ? [raw] : [];
-  const selected = selectedSlugs.map((s) => byBare.get(bareEntitySlug(s))).filter((e) => e != null).filter((e) => !grantedBare.has(bareEntitySlug(e.slug)));
-  return { id: pool.id, label: pool.label, classIndex, count, anchorLevel, selected, available, grants };
-}
-function resolveAllPools(resolved, registry) {
-  const out = [];
-  resolved.classes.forEach((rc, classIndex) => {
-    var _a, _b, _c;
-    if (!rc.entity) return;
-    const decls = [...(_a = rc.entity.selection_pools) != null ? _a : [], ...(_c = (_b = rc.subclass) == null ? void 0 : _b.selection_pools) != null ? _c : []];
-    const seen = /* @__PURE__ */ new Set();
-    for (const pool of decls) {
-      if (seen.has(pool.id)) continue;
-      seen.add(pool.id);
-      out.push(resolvePool(rc, classIndex, pool, registry));
-    }
-  });
-  return out;
-}
-
-export {
-  levelPrereqMax,
-  resolvePool,
-  resolveAllPools
-};