@archivist-gg/dnd5e 0.3.13 → 0.3.17

package/dist/{chunk-UE6LKRXQ.js → chunk-T6QIF5XR.js}

@@ -251,6 +251,21 @@ var knownSpellObjectSchema = z.object({
   always_prepared: z.boolean().optional()
 }).strict();
 var knownSpellEntrySchema = z.union([z.string().min(1), knownSpellObjectSchema]);
+var sheetViewFilterSchema = z.object({
+  show: z.array(z.string().min(1)).optional(),
+  hide: z.array(z.string().min(1)).optional()
+});
+var sheetPoolViewSchema = z.object({
+  show: z.enum(["known", "granted", "not-known"]).optional().catch(void 0),
+  off: z.record(z.string(), z.array(z.string())).optional(),
+  folded: z.array(z.string().min(1)).optional()
+});
+var sheetStateSchema = z.object({
+  layout: z.object({ saves: z.enum(["section"]).optional().catch(void 0) }).optional(),
+  favorites: z.array(z.string().min(1)).optional(),
+  filters: z.object({ actions: sheetViewFilterSchema.optional(), passive: sheetViewFilterSchema.optional() }).optional(),
+  pools: z.record(z.string(), sheetPoolViewSchema).optional()
+});
 var characterSchema = z.object({
   name: z.string().min(1),
   edition: z.enum(["2014", "2024"]),
@@ -323,6 +338,7 @@ var characterSchema = z.object({
     vulnerabilities: z.array(z.string()).default([]),
     condition_immunities: z.array(z.string()).default([])
   }).partial().optional(),
+  sheet: sheetStateSchema.optional(),
   state: characterStateSchema
 });
 

package/dist/{chunk-4BZ47YJ4.js → chunk-TULQ4FFX.js}

@@ -20,6 +20,7 @@ function emptyFeatureEffectTotals() {
     initiative_bonus: 0,
     initiative_terms: [],
     skill_bonus_terms: [],
+    save_bonus_terms: [],
     half_proficiency_terms: [],
     hp_per_level_bonus: 0,
     hp_per_level_terms: [],
@@ -118,7 +119,7 @@ function computeFeatureEffects(features, opts) {
     if (!foldsNow(rf, (_a = opts == null ? void 0 : opts.activeBuffs) != null ? _a : /* @__PURE__ */ new Set())) continue;
     const level = (_b = opts == null ? void 0 : opts.levelFor) == null ? void 0 : _b.call(opts, rf.source);
     for (const eff of selfEffectsOf(rf.feature)) {
-      applyEffect(out, eff, (_c = rf.feature.name) != null ? _c : "Feature", level);
+      applyEffect(out, columnScaledRider(eff, rf, level, opts == null ? void 0 : opts.tableDiceFor), (_c = rf.feature.name) != null ? _c : "Feature", level, rf.source);
     }
   }
   return out;
@@ -182,13 +183,23 @@ function scaled(base, key, scalesAt, level) {
   }
   return best;
 }
+function columnScaledRider(eff, rf, level, tableDiceFor) {
+  if (eff.kind !== "damage-bonus" || level === void 0 || !tableDiceFor) return eff;
+  const src = rf.source;
+  const column = rf.feature.name;
+  if (src.kind !== "class" && src.kind !== "subclass" || !column) return eff;
+  const atGain = tableDiceFor(src, column, src.level);
+  if (!atGain || atGain.toLowerCase() !== eff.amount.trim().toLowerCase()) return eff;
+  const now = tableDiceFor(src, column, level);
+  return now ? { ...eff, amount: now } : eff;
+}
 function riderScope(appliesTo) {
   if (appliesTo === void 0 || appliesTo === "all" || appliesTo === "spell") return void 0;
   const words = Array.isArray(appliesTo) ? appliesTo : [appliesTo];
   return words.includes("weapon") ? void 0 : [...words];
 }
-function applyEffect(out, eff, label, level) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
+function applyEffect(out, eff, label, level, owner) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   switch (eff.kind) {
     case "initiative-bonus":
       out.initiative_bonus += eff.value;
@@ -202,10 +213,19 @@ function applyEffect(out, eff, label, level) {
         label
       });
       break;
+    case "save-bonus":
+      out.save_bonus_terms.push({
+        saves: [...(_b = eff.saves) != null ? _b : []],
+        ability: eff.ability,
+        minimum: (_c = eff.minimum) != null ? _c : 0,
+        ...eff.inactive_while ? { inactiveWhile: eff.inactive_while } : {},
+        label
+      });
+      break;
     case "half-proficiency":
       out.half_proficiency_terms.push({
-        skills: ((_b = eff.skills) != null ? _b : []).map(toProfSlug),
-        round: (_c = eff.round) != null ? _c : "down",
+        skills: ((_d = eff.skills) != null ? _d : []).map(toProfSlug),
+        round: (_e = eff.round) != null ? _e : "down",
         label
       });
       break;
@@ -272,7 +292,7 @@ function applyEffect(out, eff, label, level) {
     }
     case "roll-modifier": {
       const rolls = eff.roll === "any" ? ["ability-check", "saving-throw", "attack"] : [eff.roll];
-      const scopes = (_d = normalizeRollScope(eff.scope, rolls[0])) != null ? _d : [eff.scope];
+      const scopes = (_f = normalizeRollScope(eff.scope, rolls[0])) != null ? _f : [eff.scope];
       for (const roll of rolls) for (const scope of scopes)
         out.rollModifiers.push({ mode: eff.mode, roll, scope, condition: eff.condition, label });
       break;
@@ -282,13 +302,13 @@ function applyEffect(out, eff, label, level) {
         ability: eff.ability === "any" ? void 0 : eff.ability,
         on_success: eff.on_success,
         on_failure: eff.on_failure,
-        appliesTo: (_e = eff.applies_to) != null ? _e : void 0,
+        appliesTo: (_g = eff.applies_to) != null ? _g : void 0,
         condition: eff.condition,
         label
       });
       break;
     case "crit-range":
-      if (((_f = eff.applies_to) != null ? _f : "weapon") !== "spell") out.critRange = Math.min(out.critRange, eff.min_roll);
+      if (((_h = eff.applies_to) != null ? _h : "weapon") !== "spell") out.critRange = Math.min(out.critRange, eff.min_roll);
       break;
     case "extra-attack":
       out.extraAttack = Math.max(out.extraAttack, scaled(eff.count, "count", eff.scales_at, level));
@@ -300,20 +320,21 @@ function applyEffect(out, eff, label, level) {
       if (eff.flag === "no-ranged-in-melee-disadvantage") out.attackNotes.push("No disadvantage firing in melee");
       break;
     case "damage-bonus":
-      if (((_g = eff.applies_to) != null ? _g : "weapon") !== "spell") {
+      if (((_i = eff.applies_to) != null ? _i : "weapon") !== "spell") {
         const scope = riderScope(eff.applies_to);
         out.damageBonuses.push({
           amount: eff.amount,
           damage_type: eff.damage_type,
           source: label,
           ...eff.condition ? { condition: eff.condition } : {},
-          ...scope ? { scope } : {}
+          ...scope ? { scope } : {},
+          ...owner ? { owner } : {}
         });
       }
       break;
     case "ability-score-increase":
       if (eff.abilities === "chosen") break;
-      for (const ab of eff.abilities) out.ability_bonus[ab] = ((_h = out.ability_bonus[ab]) != null ? _h : 0) + eff.amount;
+      for (const ab of eff.abilities) out.ability_bonus[ab] = ((_j = out.ability_bonus[ab]) != null ? _j : 0) + eff.amount;
       break;
     default:
       break;

package/dist/{chunk-PLOSP4XQ.js → chunk-UUBJCNQU.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-CJYCVNW2.js";
 import {
   featureSchema
-} from "./chunk-FPGXFD2M.js";
+} from "./chunk-YD2VAHA6.js";
 import {
   resourceSchema
 } from "./chunk-ZJXSXVFP.js";
@@ -18,7 +18,7 @@ import {
 } from "./chunk-IN4M4X7P.js";
 import {
   choiceSchema
-} from "./chunk-BRGLDWUP.js";
+} from "./chunk-5MXFW4O3.js";
 import {
   additionalSpellsEntrySchema,
   imageField,
@@ -110,6 +110,15 @@ var classEntitySchema = z.object({
   description: z.string(),
   hit_die: hitDieEnum,
   primary_abilities: z.array(abilityEnum).nonempty(),
+  // D2b-A (A-1): the class's recommended Standard Array (SRD 5.2 "Standard Array by Class"); absent on 2014 classes.
+  standard_array: z.strictObject({
+    str: z.number().int(),
+    dex: z.number().int(),
+    con: z.number().int(),
+    int: z.number().int(),
+    wis: z.number().int(),
+    cha: z.number().int()
+  }).optional(),
   saving_throws: z.array(abilityEnum).length(2),
   proficiencies: z.object({
     armor: z.array(armorCategoryEnum),

package/dist/{chunk-DPM6V7YX.js → chunk-VRV3NNTA.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-ZCTUYGNV.js";
 import {
   mirrorSpellShapes
-} from "./chunk-XY6X2APM.js";
+} from "./chunk-7Q2VPKCD.js";
 import {
   ABILITY_KEYS
 } from "./chunk-WELIKLZF.js";

package/dist/{chunk-R2V5LN3I.js → chunk-Y5VVP73C.js}

@@ -1,6 +1,6 @@
 import {
   raceEntitySchema
-} from "./chunk-X7VZY4ON.js";
+} from "./chunk-FANQVQ3D.js";
 import {
   aliasFeatureListActionCost
 } from "./chunk-4U55VNC7.js";

package/dist/{chunk-FPGXFD2M.js → chunk-YD2VAHA6.js}

@@ -8,10 +8,10 @@ import {
 } from "./chunk-ZJXSXVFP.js";
 import {
   choiceSchema
-} from "./chunk-BRGLDWUP.js";
+} from "./chunk-5MXFW4O3.js";
 import {
   featureEffectSchema
-} from "./chunk-ZMJQUZQH.js";
+} from "./chunk-2JSQE3DD.js";
 
 // src/schemas/feature-schema.ts
 import { z as z2 } from "zod";

package/dist/{chunk-G7ED5H2G.js → chunk-YKL6SHRJ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4U55VNC7.js";
 import {
   classEntitySchema
-} from "./chunk-PLOSP4XQ.js";
+} from "./chunk-UUBJCNQU.js";
 
 // src/class/class.parser.ts
 import { parseYaml } from "@archivist-gg/core";

package/dist/class/class.codec.js

@@ -1,17 +1,17 @@
 import {
   classCodec
-} from "../chunk-XJRNEQPD.js";
-import "../chunk-G7ED5H2G.js";
+} from "../chunk-MBX25B6D.js";
+import "../chunk-YKL6SHRJ.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-PLOSP4XQ.js";
+import "../chunk-UUBJCNQU.js";
 import "../chunk-G6MHJDVT.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-FPGXFD2M.js";
+import "../chunk-YD2VAHA6.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
 import "../chunk-IN4M4X7P.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   classCodec

package/dist/class/class.parser.js

@@ -1,16 +1,16 @@
 import {
   parseClass
-} from "../chunk-G7ED5H2G.js";
+} from "../chunk-YKL6SHRJ.js";
 import "../chunk-4U55VNC7.js";
-import "../chunk-PLOSP4XQ.js";
+import "../chunk-UUBJCNQU.js";
 import "../chunk-G6MHJDVT.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-FPGXFD2M.js";
+import "../chunk-YD2VAHA6.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
 import "../chunk-IN4M4X7P.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   parseClass

package/dist/class/class.schema.d.ts

@@ -22,6 +22,14 @@ export declare const classEntitySchema: z.ZodObject<{
         wis: "wis";
         cha: "cha";
     }>>;
+    standard_array: z.ZodOptional<z.ZodObject<{
+        str: z.ZodNumber;
+        dex: z.ZodNumber;
+        con: z.ZodNumber;
+        int: z.ZodNumber;
+        wis: z.ZodNumber;
+        cha: z.ZodNumber;
+    }, z.core.$strict>>;
     saving_throws: z.ZodArray<z.ZodEnum<{
         str: "str";
         dex: "dex";

package/dist/class/class.schema.js

@@ -1,14 +1,14 @@
 import {
   classEntitySchema
-} from "../chunk-PLOSP4XQ.js";
+} from "../chunk-UUBJCNQU.js";
 import "../chunk-G6MHJDVT.js";
 import "../chunk-CJYCVNW2.js";
-import "../chunk-FPGXFD2M.js";
+import "../chunk-YD2VAHA6.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
 import "../chunk-IN4M4X7P.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   classEntitySchema

package/dist/class/class.standard-array.d.ts

@@ -0,0 +1,16 @@
+/**
+ * D2b-A (A-1, user pick A) · the class's recommended Standard Array, which the Builder's Abilities step suggests.
+ */
+import type { Ability } from "@archivist-gg/dnd5e/types/choice";
+import type { ClassEntity } from "./class.types.js";
+/** Structural subset of the registry this reads. */
+export interface StandardArrayRegistry {
+    search(query: string, entityType: string, limit: number): Array<{
+        slug: string;
+        data: Record<string, unknown>;
+    }>;
+}
+/** The class's own `standard_array`; else, for a 2024 class that carries none (a book class imported before the table
+ *  was data), the table of its 2024 twin in the registry (the same bare slug, e.g. the SRD 2024 Fighter for the PHB
+ *  2024 Fighter). Null for a 2014 class and for a class with no 2024 twin (homebrew): the Builder then suggests nothing. */
+export declare function standardArrayFor(entity: Pick<ClassEntity, "slug" | "edition" | "standard_array">, registry: StandardArrayRegistry | null | undefined): Record<Ability, number> | null;

package/dist/class/class.standard-array.js

@@ -0,0 +1,20 @@
+import {
+  bareEntitySlug
+} from "../chunk-ZCTUYGNV.js";
+
+// src/class/class.standard-array.ts
+var isArray = (v) => !!v && typeof v === "object" && ["str", "dex", "con", "int", "wis", "cha"].every((k) => typeof v[k] === "number");
+function standardArrayFor(entity, registry) {
+  if (isArray(entity.standard_array)) return entity.standard_array;
+  if (entity.edition !== "2024" || !registry) return null;
+  const bare = bareEntitySlug(entity.slug);
+  for (const e of registry.search("", "class", Number.POSITIVE_INFINITY)) {
+    if (e.slug === entity.slug || bareEntitySlug(e.slug) !== bare) continue;
+    const d = e.data;
+    if (d.edition === "2024" && isArray(d.standard_array)) return d.standard_array;
+  }
+  return null;
+}
+export {
+  standardArrayFor
+};

package/dist/class/class.types.d.ts

@@ -69,6 +69,9 @@ export interface ClassEntity {
     description: string;
     hit_die: string;
     primary_abilities: Ability[];
+    /** D2b-A (A-1): the recommended Standard Array for the class, one score per ability (SRD 5.2 "Standard Array by
+     *  Class"). Absent on 2014 classes and homebrew; the Builder then suggests nothing. */
+    standard_array?: Record<Ability, number>;
     saving_throws: Ability[];
     proficiencies: ClassProficiencies;
     skill_choices: SkillChoices;

package/dist/dnd/amount-text.d.ts

@@ -0,0 +1,38 @@
+/**
+ * D2b-A · an AMOUNT that names a modifier prints the number (design §1.2 A, user rulings 2026-09-27).
+ *
+ * An effect amount, a rider amount or a save DC formula is written in the book's words ("1d8 plus your Wisdom
+ * modifier", "your spell save DC") or with a `{token}` ("2d4 + {spell_mod}"). Nothing rendered it as a number: the
+ * resource DSL (`resource-formula.ts`) has no dice production and no spellcasting idents. This module reads both at
+ * READ time, so existing notes and homebrew need no re-import:
+ *   1. `normalizeAmountPhrases` turns the closed phrase table below into tokens;
+ *   2. `resolveAmountText` substitutes each `{ident}` with its number and folds: a pure numeric result is evaluated by
+ *      the resource DSL (so `floor`, `max`, `ceil` keep working) and a trailing "(minimum of N)" is applied;
+ *      `<dice> +/- <numbers>` folds to one roll ("1d8+3"); anything else keeps its words with the numbers in place
+ *      ("one roll of your Martial Arts die + 3").
+ * The phrase table is the ONE place the book's English is read; an unmapped phrase stays as written.
+ */
+import { type FormulaBindings } from "./resource-formula.js";
+/** The DSL bindings plus the owner's spellcasting modifier and save DC (absent when the owner casts no spells). */
+export interface AmountBindings extends FormulaBindings {
+    spell_mod?: number;
+    spell_dc?: number;
+}
+/** The book phrases of `text` as tokens, "plus" as "+"; text with no mapped phrase comes back unchanged. */
+export declare function normalizeAmountPhrases(text: string): string;
+/**
+ * The amount as the sheet prints it: the phrases and tokens of `text` resolved against `b`. A pure number is
+ * evaluated ("13"); a roll plus numbers folds ("1d8+3"); other words keep their place with the numbers in ("the roll + 2
+ * (minimum of 1)"). An UNBOUND token prints its short label when the note wrote the token, and a book phrase whose
+ * token is unbound keeps the note's own words. Text with no phrase and no token comes back unchanged.
+ */
+export declare function resolveAmountText(text: string, b: AmountBindings): string;
+/** The leading dice roll of a resolved amount ("1d8+3" of "1d8+3 (minimum of 1)"), which the sheet makes rollable; null
+ *  when the amount does not open with a roll. */
+export declare function diceRollOf(resolved: string): string | null;
+/** The leading roll of `text` as the RAW characters it spans (`raw`, which the caller cuts the text by) and as a notation
+ *  with no spaces (`notation`, which the roller reads): "2d4 + 2 more" is { raw: "2d4 + 2", notation: "2d4+2" }. */
+export declare function diceRollPrefix(text: string): {
+    raw: string;
+    notation: string;
+} | null;

package/dist/dnd/amount-text.js

@@ -0,0 +1,13 @@
+import {
+  diceRollOf,
+  diceRollPrefix,
+  normalizeAmountPhrases,
+  resolveAmountText
+} from "../chunk-QH36K2PU.js";
+import "../chunk-EVMUJYUD.js";
+export {
+  diceRollOf,
+  diceRollPrefix,
+  normalizeAmountPhrases,
+  resolveAmountText
+};

package/dist/dnd/resource-words.d.ts

@@ -0,0 +1,4 @@
+/** The resource's name worded for `amount`: the last word singular for one, plural otherwise, when it is a count noun. */
+export declare function resourceCountWord(name: string, amount: number): string;
+/** "<amount> <name worded for it>" ("1 Superiority Die"). */
+export declare function countedResource(amount: number, name: string): string;

package/dist/dnd/resource-words.js

@@ -0,0 +1,30 @@
+// src/dnd/resource-words.ts
+var COUNT_NOUNS = [
+  ["Die", "Dice"],
+  ["Point", "Points"],
+  ["Use", "Uses"],
+  ["Seal", "Seals"],
+  ["Rage", "Rages"],
+  ["Cast", "Casts"],
+  ["Casting", "Castings"],
+  ["Scroll", "Scrolls"],
+  ["Charge", "Charges"],
+  ["Token", "Tokens"],
+  ["Slot", "Slots"]
+];
+var BY_WORD = new Map(
+  COUNT_NOUNS.flatMap((pair) => [[pair[0], pair], [pair[1], pair]])
+);
+function resourceCountWord(name, amount) {
+  const at = name.lastIndexOf(" ") + 1;
+  const pair = BY_WORD.get(name.slice(at));
+  if (!pair) return name;
+  return name.slice(0, at) + (amount === 1 ? pair[0] : pair[1]);
+}
+function countedResource(amount, name) {
+  return `${amount} ${resourceCountWord(name, amount)}`;
+}
+export {
+  countedResource,
+  resourceCountWord
+};

package/dist/feat/feat.codec.js

@@ -1,11 +1,11 @@
 import {
   featCodec
-} from "../chunk-6ZY3U6BQ.js";
-import "../chunk-4SLOJXJ4.js";
-import "../chunk-LVX6TQ3R.js";
+} from "../chunk-RYLXAYIQ.js";
+import "../chunk-7QN7XSAK.js";
+import "../chunk-PKX6TGRE.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   featCodec

package/dist/feat/feat.parser.js

@@ -1,10 +1,10 @@
 import {
   parseFeat
-} from "../chunk-4SLOJXJ4.js";
-import "../chunk-LVX6TQ3R.js";
+} from "../chunk-7QN7XSAK.js";
+import "../chunk-PKX6TGRE.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   parseFeat

package/dist/feat/feat.schema.d.ts

@@ -88,6 +88,31 @@ export declare const featEntitySchema: z.ZodObject<{
         minimum: z.ZodOptional<z.ZodNumber>;
         condition: z.ZodOptional<z.ZodString>;
         subject: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"save-bonus">;
+        ability: z.ZodEnum<{
+            str: "str";
+            dex: "dex";
+            con: "con";
+            int: "int";
+            wis: "wis";
+            cha: "cha";
+        }>;
+        minimum: z.ZodOptional<z.ZodNumber>;
+        saves: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            str: "str";
+            dex: "dex";
+            con: "con";
+            int: "int";
+            wis: "wis";
+            cha: "cha";
+        }>>>;
+        inactive_while: z.ZodOptional<z.ZodEnum<{
+            incapacitated: "incapacitated";
+            unconscious: "unconscious";
+        }>>;
+        condition: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"half-proficiency">;
         skills: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/feat/feat.schema.js

@@ -1,9 +1,9 @@
 import {
   featEntitySchema
-} from "../chunk-LVX6TQ3R.js";
+} from "../chunk-PKX6TGRE.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-BRGLDWUP.js";
-import "../chunk-ZMJQUZQH.js";
+import "../chunk-5MXFW4O3.js";
+import "../chunk-2JSQE3DD.js";
 import "../chunk-UA5KS2PL.js";
 export {
   featEntitySchema