@archivist-gg/dnd5e 0.3.9 → 0.3.11

package/dist/pc/pc.additional-spells.js

@@ -5,12 +5,12 @@ import {
   prefixOf,
   raceIsUngated,
   resolveSpellByName
-} from "../chunk-MI7P3NX3.js";
+} from "../chunk-3HX5VLWP.js";
 import "../chunk-PVCEA4HZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-6X4KUDMU.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-WELIKLZF.js";
 import "../chunk-UA5KS2PL.js";
 export {

package/dist/pc/pc.decision-engine.js

@@ -4,14 +4,14 @@ import {
   collectChosenAbilityPoints,
   collectChosenProficiencies,
   computeEffectiveProficiencies
-} from "../chunk-HLQAFZKQ.js";
+} from "../chunk-2INMRR3Q.js";
 import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-YHYTW5QA.js";
-import "../chunk-MI7P3NX3.js";
+import "../chunk-3HX5VLWP.js";
 import "../chunk-PVCEA4HZ.js";
 import "../chunk-UBBKSYBY.js";
 import "../chunk-CBEKVAX4.js";
@@ -26,8 +26,8 @@ import {
 import "../chunk-YBLDE5CG.js";
 import "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-PDJSUH24.js";
 import "../chunk-WELIKLZF.js";
 import "../chunk-4U55VNC7.js";

package/dist/pc/pc.proficiencies.js

@@ -2,14 +2,14 @@ import {
   collectChosenProficiencies,
   collectProficiencyGrants,
   computeEffectiveProficiencies
-} from "../chunk-HLQAFZKQ.js";
+} from "../chunk-2INMRR3Q.js";
 import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-YHYTW5QA.js";
-import "../chunk-MI7P3NX3.js";
+import "../chunk-3HX5VLWP.js";
 import "../chunk-PVCEA4HZ.js";
 import "../chunk-UBBKSYBY.js";
 import "../chunk-CBEKVAX4.js";
@@ -25,8 +25,8 @@ import "../chunk-6X4KUDMU.js";
 import "../chunk-YBLDE5CG.js";
 import "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-PDJSUH24.js";
 import "../chunk-WELIKLZF.js";
 import "../chunk-4U55VNC7.js";

package/dist/pc/pc.recalc.js

@@ -4,7 +4,7 @@ import {
 import {
   collectChosenAbilityPoints,
   collectChosenProficiencies
-} from "../chunk-HLQAFZKQ.js";
+} from "../chunk-2INMRR3Q.js";
 import {
   resourceLevelFor
 } from "../chunk-4ISR76DH.js";
@@ -21,7 +21,7 @@ import {
   unarmedDieColumnFor
 } from "../chunk-IUAAXXNO.js";
 import "../chunk-YHYTW5QA.js";
-import "../chunk-MI7P3NX3.js";
+import "../chunk-3HX5VLWP.js";
 import "../chunk-PVCEA4HZ.js";
 import {
   toDefenseSlug
@@ -54,8 +54,8 @@ import {
   isValidMaxFormula
 } from "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import {
   abilityModifier,
   attackBonus,

package/dist/pc/pc.resolver.js

@@ -10,14 +10,14 @@ import {
   dedupeResolvedSpells,
   resolveOriginFeat,
   stripSlug
-} from "../chunk-HLQAFZKQ.js";
+} from "../chunk-2INMRR3Q.js";
 import "../chunk-4ISR76DH.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-O4SRD3J5.js";
 import "../chunk-PP2UHLBA.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-YHYTW5QA.js";
-import "../chunk-MI7P3NX3.js";
+import "../chunk-3HX5VLWP.js";
 import "../chunk-PVCEA4HZ.js";
 import "../chunk-UBBKSYBY.js";
 import "../chunk-CBEKVAX4.js";
@@ -30,8 +30,8 @@ import "../chunk-6X4KUDMU.js";
 import "../chunk-YBLDE5CG.js";
 import "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-PDJSUH24.js";
 import "../chunk-WELIKLZF.js";
 import "../chunk-4U55VNC7.js";

package/dist/spell/casting-time.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The ONE reader of a spell's `casting_time` string. Every consumer (the plugin's compact Cast-table label,
+ * the add-drawer's filter bucket and its sort rank) goes through here, so a spelling that one of them
+ * understands the others understand too. Before this, each kept its own exact-string switch over the bundle's
+ * spellings (`action`, `bonus-action`, `1minute`), and they drifted: a converted or AI-generated spell's
+ * `1 action` / `10 minute` printed raw in the Cast table, and every vault spell spelled `bonus action`,
+ * `1 minute` or `1 hour` filtered as "special".
+ *
+ * The LEADING token decides. Prose after it (a reaction's trigger, Plant Growth's "or 8 hours") is left for
+ * the caller's tooltip and never matched, and the trailing word boundary stops a word that merely starts with
+ * a unit (`reactionary`, `bonuses`, `minuteman`) from reading as one. A count is optional and only meaningful
+ * for minutes and hours; `bonus` may drop the word `action`, which hand-authored spells do.
+ */
+export type CastingTimeKind = "action" | "bonus" | "reaction" | "time";
+export interface ParsedCastingTime {
+    kind: CastingTimeKind;
+    /** 1 for the action economy; the stated number of minutes / hours for `time` (1 when omitted). */
+    count: number;
+    /** Present only for `time`. */
+    unit?: "minute" | "hour";
+}
+export declare function parseCastingTime(token: string | undefined): ParsedCastingTime | null;

package/dist/spell/casting-time.js

@@ -0,0 +1,6 @@
+import {
+  parseCastingTime
+} from "../chunk-W6GC6OKK.js";
+export {
+  parseCastingTime
+};

package/dist/spell/spell.codec.js

@@ -1,8 +1,8 @@
 import {
   spellCodec
-} from "../chunk-JSZ4H6AQ.js";
-import "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+} from "../chunk-MWCCGPG3.js";
+import "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-UA5KS2PL.js";
 export {
   spellCodec

package/dist/spell/spell.filter.d.ts

@@ -1,8 +1,8 @@
 import type { SpellCandidate } from "./spell.access.js";
 export type CastTimeCat = "action" | "bonus" | "reaction" | "long" | "special";
 export type RangeCat = "self" | "touch" | "ranged" | "special";
-/** Cast-time bucket from the stored token (mirrors compactCastingTime's set).
- *  Rounds/minutes/hours fold into "long"; null/unknown → "special". */
+/** Cast-time bucket, read through `parseCastingTime` (the same reader the Cast table's label uses, so the two
+ *  cannot drift). Minutes/hours fold into "long"; unreadable or absent → "special". */
 export declare function castTimeCategory(token: string | undefined): CastTimeCat;
 /** Range bucket from the human range string. Honest read, documented buckets:
  *  "Self…"→self, "Touch…"→touch, "<n> feet|ft"→ranged, else (mile/Sight/…)→special. */

package/dist/spell/spell.filter.js

@@ -1,24 +1,12 @@
+import {
+  parseCastingTime
+} from "../chunk-W6GC6OKK.js";
+
 // src/spell/spell.filter.ts
 function castTimeCategory(token) {
-  switch (token) {
-    case "action":
-      return "action";
-    case "bonus-action":
-      return "bonus";
-    case "reaction":
-      return "reaction";
-    case "minute":
-    case "1minute":
-    case "10minutes":
-    case "hour":
-    case "1hour":
-    case "8hours":
-    case "12hours":
-    case "24hours":
-      return "long";
-    default:
-      return "special";
-  }
+  const parsed = parseCastingTime(token);
+  if (!parsed) return "special";
+  return parsed.kind === "time" ? "long" : parsed.kind;
 }
 function rangeCategory(range) {
   if (!range) return "special";

package/dist/spell/spell.parser.js

@@ -3,8 +3,8 @@ import {
   normalizeSpellComponents,
   normalizeSpellDuration,
   parseSpell
-} from "../chunk-OZP6JFGT.js";
-import "../chunk-VQAXTIBW.js";
+} from "../chunk-XY6X2APM.js";
+import "../chunk-ZDAEGJH4.js";
 import "../chunk-UA5KS2PL.js";
 export {
   mirrorSpellShapes,

package/dist/spell/spell.scaling.d.ts

@@ -9,16 +9,39 @@ export interface SpellEffectParts {
     /** As printed: the roll, `"<N> targets"`, the duration, or the authored sentence verbatim. */
     value: string;
 }
+/** The spell's base roll (`damage_roll`), trimmed, or null when absent, empty or whitespace-only. The ONE base-roll
+ *  check: every reader of `damage_roll` (the scaling readers here, the spell card) goes through it. */
+export declare function spellBaseRoll(spell: Spell): string | null;
 /**
- * At-a-glance scaled effect for casting a LEVELLED `spell` with a slot of `slotLevel`,
- * read from structured `casting_options` (`type: "slot_level_<N>"`), WITH the field it
- * came from. Returns null when absent or untrustworthy. The FIRST present field wins, in
- * this order: `damage_roll`, `target_count`, `duration`, `desc` (so an option carrying a
- * roll AND a sentence yields the roll). A `target_count` that equals the slot level is
- * the known SRD-2014 bad encoding (e.g. Magic Missile 2nd->2 instead of 4) and is
- * suppressed. This errs toward showing nothing rather than a wrong number.
+ * At-a-glance effect for casting a LEVELLED `spell` with a slot of `slotLevel`, WITH the field
+ * it came from. Returns null when absent or untrustworthy.
+ *
+ * A structured `casting_options` entry for that slot (`type: "slot_level_<N>"`) wins: the FIRST
+ * present field, in this order: `damage_roll`, `target_count`, `duration`, `desc` (so an option
+ * carrying a roll AND a sentence yields the roll). A `target_count` that equals the slot level is
+ * the known SRD-2014 bad encoding (e.g. Magic Missile 2nd->2 instead of 4) and is suppressed.
+ *
+ * With no option for the slot, the spell's BASE roll (`damage_roll`) answers at the spell's OWN
+ * level only. Above it, whether the base roll is still the roll dealt is `spellBaseRollAtSlot`'s
+ * question (it is when the damage does not scale); a SCALING spell missing its option above base
+ * stays null here. A CANTRIP is never read by slot (null): its roll follows the character's level,
+ * `spellEffectAtCharacterLevel`, even when it is cast from a scroll. This errs toward showing
+ * nothing rather than a wrong number.
  */
 export declare function spellEffectPartsAtSlot(spell: Spell, slotLevel: number): SpellEffectParts | null;
+/**
+ * The spell's BASE roll at a slot of `slotLevel` when the data PROVES its damage does not scale, so every slot at or
+ * above the spell's level deals the base roll. Two proofs, and only these:
+ *   (a) it has `slot_level_<N>` options and every one carries only a `duration` and / or a `target_count` (plus the
+ *       `concentration` flag a duration carries): 2024 Hex and Hunter's Mark scale their duration, Magic Missile and
+ *       Scorching Ray their target count;
+ *   (b) it has no slot options AND no `at_higher_levels` text (Finger of Death).
+ * Anything else is NOT proof: prose-only scaling (2014 Cure Wounds' "increases by 1d8 for each slot level above
+ * 1st", with no options) would print the unscaled base on every upcast row, so it stays null there. The companion of
+ * `spellEffectPartsAtSlot`: a row prints this roll beside a target count, and the duration a slot option carries
+ * prints in its own cell. Null for a cantrip, below the spell's level, and when the spell has no base roll.
+ */
+export declare function spellBaseRollAtSlot(spell: Spell, slotLevel: number): string | null;
 /** The value of `spellEffectPartsAtSlot`, without its field. */
 export declare function spellEffectAtSlot(spell: Spell, slotLevel: number): string | null;
 /**
@@ -26,9 +49,10 @@ export declare function spellEffectAtSlot(spell: Spell, slotLevel: number): stri
  * `casting_options` (`type: "player_level_<N>"`). The roll of the HIGHEST `N <= characterLevel` wins: SRD 5e authors
  * one option per level from 5 to 20, SRD 2024 and the converter author only 5 / 11 / 17. An option with no roll or an
  * EMPTY one never qualifies (SRD 5e Acid Splash and Poison Spray open with `player_level_2..4` carrying
- * `damage_roll: ''`; Eldritch Blast 2024 authors `target_count` only). Null for a levelled spell, for a level that is
- * not a finite number (a fixture-built `derived` omits `totalLevel`), and when nothing qualifies: no corpus authors
- * `player_level_1`, so a cantrip's base roll below level 5 is not in the data and nothing is invented here.
+ * `damage_roll: ''`; Eldritch Blast 2024 authors `target_count` only). When no tier qualifies (below the first tier,
+ * or tiers that carry no roll) the spell's BASE roll `damage_roll` answers: the tier-1 roll (Fire Bolt `1d10` at 4,
+ * Eldritch Blast's per-beam `1d10` at any level). Null for a levelled spell, for a level that is not a finite number
+ * (a fixture-built `derived` omits `totalLevel`), and when neither a tier nor a non-empty base roll exists.
  */
 export declare function spellEffectAtCharacterLevel(spell: Spell, characterLevel: number): string | null;
 /** Owned slot levels strictly above the spell's base level (scaling spells only). */

package/dist/spell/spell.scaling.js

@@ -3,10 +3,19 @@ function spellScales(spell) {
   var _a, _b, _c, _d;
   return ((_b = (_a = spell.casting_options) == null ? void 0 : _a.length) != null ? _b : 0) > 0 || ((_d = (_c = spell.at_higher_levels) == null ? void 0 : _c.length) != null ? _d : 0) > 0;
 }
+function spellBaseRoll(spell) {
+  const roll = typeof spell.damage_roll === "string" ? spell.damage_roll.trim() : "";
+  return roll !== "" ? roll : null;
+}
 function spellEffectPartsAtSlot(spell, slotLevel) {
-  var _a;
-  const opt = ((_a = spell.casting_options) != null ? _a : []).find((o) => o.type === `slot_level_${slotLevel}`);
-  if (!opt) return null;
+  var _a, _b;
+  const base = (_a = spell.level) != null ? _a : 0;
+  if (base === 0) return null;
+  const opt = ((_b = spell.casting_options) != null ? _b : []).find((o) => o.type === `slot_level_${slotLevel}`);
+  if (!opt) {
+    const roll = spellBaseRoll(spell);
+    return roll !== null && slotLevel === base ? { field: "damage_roll", value: roll } : null;
+  }
   if (opt.damage_roll) return { field: "damage_roll", value: opt.damage_roll };
   if (typeof opt.target_count === "number") {
     if (opt.target_count === slotLevel) return null;
@@ -15,6 +24,27 @@ function spellEffectPartsAtSlot(spell, slotLevel) {
   if (opt.duration) return { field: "duration", value: opt.duration };
   return opt.desc != null ? { field: "desc", value: opt.desc } : null;
 }
+var NON_ROLL_SCALES = /* @__PURE__ */ new Set(["duration", "target_count"]);
+var NON_ROLL_OPTION_FIELDS = /* @__PURE__ */ new Set([...NON_ROLL_SCALES, "concentration"]);
+function spellBaseRollAtSlot(spell, slotLevel) {
+  var _a, _b, _c;
+  const base = (_a = spell.level) != null ? _a : 0;
+  if (base === 0 || slotLevel < base) return null;
+  const roll = spellBaseRoll(spell);
+  if (roll === null) return null;
+  const slotOptions = ((_b = spell.casting_options) != null ? _b : []).filter((o) => {
+    var _a2;
+    return /^slot_level_\d+$/.test(String((_a2 = o.type) != null ? _a2 : ""));
+  });
+  if (slotOptions.length > 0) {
+    const onlyNonRoll = slotOptions.every((o) => {
+      const fields = Object.entries(o).filter(([k, v]) => k !== "type" && v != null).map(([k]) => k);
+      return fields.some((k) => NON_ROLL_SCALES.has(k)) && fields.every((k) => NON_ROLL_OPTION_FIELDS.has(k));
+    });
+    return onlyNonRoll ? roll : null;
+  }
+  return ((_c = spell.at_higher_levels) != null ? _c : []).some((t) => typeof t === "string" && t.trim() !== "") ? null : roll;
+}
 function spellEffectAtSlot(spell, slotLevel) {
   var _a, _b;
   return (_b = (_a = spellEffectPartsAtSlot(spell, slotLevel)) == null ? void 0 : _a.value) != null ? _b : null;
@@ -30,7 +60,7 @@ function spellEffectAtCharacterLevel(spell, characterLevel) {
     const n = Number(m[1]);
     if (n <= characterLevel && (best === null || n > best.n)) best = { n, roll: opt.damage_roll };
   }
-  return best ? best.roll : null;
+  return best ? best.roll : spellBaseRoll(spell);
 }
 function upcastLevelsFor(spell, ownedSlotLevels) {
   var _a;
@@ -39,6 +69,8 @@ function upcastLevelsFor(spell, ownedSlotLevels) {
   return ownedSlotLevels.filter((l) => l > base).sort((a, b) => a - b);
 }
 export {
+  spellBaseRoll,
+  spellBaseRollAtSlot,
   spellEffectAtCharacterLevel,
   spellEffectAtSlot,
   spellEffectPartsAtSlot,

package/dist/spell/spell.schema.d.ts

@@ -40,6 +40,7 @@ export declare const spellEntitySchema: z.ZodObject<{
     damage: z.ZodOptional<z.ZodObject<{
         types: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
+    damage_roll: z.ZodOptional<z.ZodString>;
     saving_throw: z.ZodOptional<z.ZodObject<{
         ability: z.ZodString;
     }, z.core.$strip>>;

package/dist/spell/spell.schema.js

@@ -1,6 +1,6 @@
 import {
   spellEntitySchema
-} from "../chunk-VQAXTIBW.js";
+} from "../chunk-ZDAEGJH4.js";
 import "../chunk-UA5KS2PL.js";
 export {
   spellEntitySchema

package/dist/spell/spell.types.d.ts

@@ -16,6 +16,10 @@ export interface Spell {
     damage?: {
         types: string[];
     };
+    /** The BASE roll: the roll at the spell's own level, or a cantrip's tier-1 roll (before its first
+     *  `player_level_<N>` option). Like `casting_options[].damage_roll` it also carries healing rolls
+     *  (Cure Wounds `2d8`). Mirrors Open5e v2's top-level `damage_roll`. */
+    damage_roll?: string;
     saving_throw?: {
         ability: string;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archivist-gg/dnd5e",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "license": "MIT AND CC-BY-4.0",
   "type": "module",
   "publishConfig": {