@archivist-gg/dnd5e 0.3.17 → 0.3.19

package/dist/monster/monster.parser.js

@@ -1,13 +1,13 @@
 import {
   migrateLegacy,
   parseMonster
-} from "../chunk-JCMUVZIK.js";
-import "../chunk-7ATNGKBS.js";
-import "../chunk-YD2VAHA6.js";
+} from "../chunk-BJWSOQUC.js";
+import "../chunk-VP5TIXDK.js";
+import "../chunk-B2QHP6UF.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
+import "../chunk-OOL4KMG2.js";
+import "../chunk-JXWNXIIZ.js";
 import "../chunk-UA5KS2PL.js";
 export {
   migrateLegacy,

package/dist/monster/monster.schema.js

@@ -11,12 +11,12 @@ import {
   monsterSpeedSchema,
   monsterSpellcastingSchema,
   monsterTypeSchema
-} from "../chunk-7ATNGKBS.js";
-import "../chunk-YD2VAHA6.js";
+} from "../chunk-VP5TIXDK.js";
+import "../chunk-B2QHP6UF.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
+import "../chunk-OOL4KMG2.js";
+import "../chunk-JXWNXIIZ.js";
 import "../chunk-UA5KS2PL.js";
 export {
   MONSTER_KNOWN_KEYS,

package/dist/optional-feature/optional-feature.codec.js

@@ -1,12 +1,12 @@
 import {
   optionalFeatureCodec
-} from "../chunk-G6PBI2BU.js";
-import "../chunk-PQZ4LM4Z.js";
-import "../chunk-DOXSFYLH.js";
+} from "../chunk-FVXLP7P3.js";
+import "../chunk-FMUD3LDV.js";
+import "../chunk-VN5DLURA.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
+import "../chunk-OOL4KMG2.js";
+import "../chunk-JXWNXIIZ.js";
 import "../chunk-UA5KS2PL.js";
 export {
   optionalFeatureCodec

package/dist/optional-feature/optional-feature.parser.js

@@ -1,11 +1,11 @@
 import {
   parseOptionalFeature
-} from "../chunk-PQZ4LM4Z.js";
-import "../chunk-DOXSFYLH.js";
+} from "../chunk-FMUD3LDV.js";
+import "../chunk-VN5DLURA.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
+import "../chunk-OOL4KMG2.js";
+import "../chunk-JXWNXIIZ.js";
 import "../chunk-UA5KS2PL.js";
 export {
   parseOptionalFeature

package/dist/optional-feature/optional-feature.schema.d.ts

@@ -301,6 +301,15 @@ export declare const optionalFeatureEntitySchema: z.ZodObject<{
             finesse: "finesse";
             thrown: "thrown";
         }>>]>>;
+        spell_scope: z.ZodOptional<z.ZodObject<{
+            list: z.ZodOptional<z.ZodString>;
+            level: z.ZodOptional<z.ZodNumber>;
+            school: z.ZodOptional<z.ZodString>;
+            damage_types: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            damage_type_pick: z.ZodOptional<z.ZodString>;
+            spells: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            once: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
         condition: z.ZodOptional<z.ZodString>;
         subject: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/optional-feature/optional-feature.schema.js

@@ -2,11 +2,11 @@ import {
   infuseBlockSchema,
   optionRowSchema,
   optionalFeatureEntitySchema
-} from "../chunk-DOXSFYLH.js";
+} from "../chunk-VN5DLURA.js";
 import "../chunk-WYGD2UGN.js";
 import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
+import "../chunk-OOL4KMG2.js";
+import "../chunk-JXWNXIIZ.js";
 import "../chunk-UA5KS2PL.js";
 export {
   infuseBlockSchema,

package/dist/pc/pc.additional-spells.d.ts

@@ -3,7 +3,7 @@ import type { RaceEntity } from "@archivist-gg/dnd5e/race/race.types";
 import type { FeatEntity } from "@archivist-gg/dnd5e/feat/feat.types";
 import type { Spell } from "@archivist-gg/dnd5e/spell/spell.types";
 import type { Ability } from "@archivist-gg/dnd5e";
-import type { ResolvedClass, ResolvedSpell } from "./pc.types.js";
+import type { ChoiceValue, ResolvedClass, ResolvedPool, ResolvedSpell } from "./pc.types.js";
 export declare const prefixOf: (slug: string) => string;
 /** §5.2.2 · a raw 5etools / bundle spell ref → the bare NAME slug. The path tail is taken ONLY for a wikilink; a bare
  *  name may legally contain "/" ("blindness/deafness" → "blindnessdeafness", the converter's own slug tail · Gate 0 B1).
@@ -34,7 +34,16 @@ export declare function resolveSpellByName(opts: {
 /** §5.2.9 · fold a race's entries ONLY when no select-inline on race.choices[] / traits[].choices[] / nested option.choices[]
  *  carries an id outside the structural set (nested: zero carriers, defensive). */
 export declare function raceIsUngated(race: RaceEntity): boolean;
-/** §5.2.1 · the reader. Every object it receives is the RAW registry entity; nothing is mutated. */
+/** SRD-G T4: the slugs (value and label) of every option the character CHOSE on a race's content select-inlines
+ *  (`race.choices[]` and `traits[].choices[]`, the structural set excluded), read through `read(<choice id>)`. */
+export declare function chosenRaceOptionKeys(race: RaceEntity, read: (id: string) => ChoiceValue | undefined): Set<string>;
+/** §5.2.1 · the reader. Every object it receives is the RAW registry entity; nothing is mutated.
+ *
+ *  SRD-G T4 (audit §3a): the RACE root also reads (1) a race whose lineage select-inline GATES it: the entry NAMED like
+ *  the option the character chose folds (the SRD 5.2 Tiefling's legacy, the Elf's and Gnome's lineage); an unnamed
+ *  entry on a gated race still folds nothing (it may belong to any lineage); (2) an `ability: {choose}` entry, when
+ *  `raceChoice("spellcasting-ability")` answers one of its abilities (unanswered, the entry waits for the pick);
+ *  (3) the `innate` level spells (the level 3 / 5 once-per-Long-Rest spells), folded always prepared like `known`. */
 export declare function collectAdditionalSpells(args: {
     race: RaceEntity | null;
     feats: FeatEntity[];
@@ -44,4 +53,9 @@ export declare function collectAdditionalSpells(args: {
     alreadyCollected: ResolvedSpell[];
     entities: EntityRegistry;
     warnings: string[];
+    /** SRD-G T4: the character's answer to a race choice, by choice id (`origin_choices["race:<id>"]`). */
+    raceChoice?: (id: string) => ChoiceValue | undefined;
+    /** User report 2026-09-28: the RESOLVED pools. Every member the character has (a pick or a grant; an item-bound one's
+     *  subject is its item) is a root, read at the owning class's level, its spells that class's. */
+    pools?: ReadonlyArray<ResolvedPool>;
 }): ResolvedSpell[];

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

@@ -1,13 +1,15 @@
 import {
   buildSpellNameIndex,
+  chosenRaceOptionKeys,
   collectAdditionalSpells,
   normalizeSpellRef,
   prefixOf,
   raceIsUngated,
   resolveSpellByName
-} from "../chunk-VRV3NNTA.js";
+} from "../chunk-LICYHPI3.js";
 import "../chunk-PVCEA4HZ.js";
 import "../chunk-LVQLWRCU.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-7Q2VPKCD.js";
 import "../chunk-ZDAEGJH4.js";
@@ -15,6 +17,7 @@ import "../chunk-WELIKLZF.js";
 import "../chunk-UA5KS2PL.js";
 export {
   buildSpellNameIndex,
+  chosenRaceOptionKeys,
   collectAdditionalSpells,
   normalizeSpellRef,
   prefixOf,

package/dist/pc/pc.amount-bindings.d.ts

@@ -4,8 +4,8 @@
  */
 import type { Ability } from "@archivist-gg/dnd5e/types/choice";
 import type { Spell } from "@archivist-gg/dnd5e/spell/spell.types";
-import type { AmountBindings } from "@archivist-gg/dnd5e/dnd/amount-text";
-import type { DerivedStats, FeatureSource, ResolvedCharacter, ResolvedSpell } from "./pc.types.js";
+import { type AmountBindings } from "@archivist-gg/dnd5e/dnd/amount-text";
+import type { DerivedStats, FeatureSource, ResolvedCharacter, ResolvedSpell, SpellDamageRider } from "./pc.types.js";
 /** The derived fields the bindings read (recalc builds them before its return; the sheet passes `ctx.derived`). */
 export type AmountDerived = Pick<DerivedStats, "proficiencyBonus" | "mods" | "spellcastingClasses"> & Partial<Pick<DerivedStats, "abilitySpellcasting">>;
 /** The class slug that owns `source`: a class by its slug, a subclass by the class that holds it, a feat through the
@@ -30,3 +30,12 @@ export declare function spellAmountBindings(spell: Pick<ResolvedSpell, "source"
  *  null. Read from the note's own words at read time; the roll must be the one the phrase follows, so a spell whose
  *  modifier rides a different roll (a heal beside a damage roll) adds nothing. */
 export declare function spellRollBonus(spell: Pick<Spell, "damage_roll" | "description">): string | null;
+/** The spell's printed roll with every spell damage rider that reaches it added INSIDE the one roll (bonus damage prints
+ *  in the damage cell, user ruling): Agonizing Blast's Charisma on its cantrip reads "1d10+3" (found live 2026-09-28),
+ *  Potent Spellcasting's Wisdom on Sacred Flame "1d8+3". A conditional rider, or one of another canonical damage type
+ *  than the spell's own, is not added here: it is a line of its own (`spellDamageRiderLines`). */
+export declare function addSpellDamageRiders(roll: string, spell: Pick<ResolvedSpell, "slug" | "entity">, derived: Partial<Pick<DerivedStats, "spellDamageRiders">>): string;
+/** The spell damage riders that reach `spell` but do not fold into its roll, each its own line in the damage cell, the
+ *  way a conditional weapon rider is (Power Surge's "+ 5 force" once a surge is spent; Arcane Firearm's "+ 1d8" through
+ *  the firearm): a `condition`, or another canonical damage type. `spells` and `once` are the engine's, not the line's. */
+export declare function spellDamageRiderLines(spell: Pick<ResolvedSpell, "slug" | "entity">, derived: Partial<Pick<DerivedStats, "spellDamageRiders">>): Array<Pick<SpellDamageRider, "amount" | "damage_type" | "source" | "condition">>;

package/dist/pc/pc.amount-bindings.js

@@ -1,23 +1,28 @@
 import {
+  addSpellDamageRiders,
   amountBindingsFor,
   ownerClassSlug,
   spellAmountBindings,
+  spellDamageRiderLines,
   spellRollBonus,
   spellcastingFor
-} from "../chunk-PXVNAY7T.js";
+} from "../chunk-TRBGC4ZG.js";
 import "../chunk-KR6JF3BF.js";
 import "../chunk-KSTV7J2U.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-LVQLWRCU.js";
+import "../chunk-WOHX7YTH.js";
 import "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
 import "../chunk-PDJSUH24.js";
 import "../chunk-WELIKLZF.js";
 export {
+  addSpellDamageRiders,
   amountBindingsFor,
   ownerClassSlug,
   spellAmountBindings,
+  spellDamageRiderLines,
   spellRollBonus,
   spellcastingFor
 };

package/dist/pc/pc.decision-engine.d.ts

@@ -203,6 +203,14 @@ export declare function computeEffectiveProficiencies(resolved: ResolvedCharacte
     languages: ProficiencyEntry[];
     tools: ProficiencyEntry[];
 };
+/** D4 A: the complement of {@link computeEffectiveProficiencies}: every language and tool the character's grants, picks
+ *  or adds would hold but `overrides.<domain>.remove` (or a `none` tools tri) suppresses, each entry keeping its
+ *  `sources` and `origin`. The proficiency picker draws these struck through ("Dwarf · removed"). Both functions read
+ *  ONE composer, so a row is kept or suppressed, never both and never neither. */
+export declare function computeSuppressedProficiencies(resolved: ResolvedCharacter): {
+    languages: ProficiencyEntry[];
+    tools: ProficiencyEntry[];
+};
 export interface OriginAbilityPoints {
     race: Partial<Record<Ability, number>>;
     background: Partial<Record<Ability, number>>;

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

@@ -4,31 +4,33 @@ import {
   buildDecisionLedger,
   collectChosenAbilityPoints,
   collectChosenProficiencies,
-  computeEffectiveProficiencies
-} from "../chunk-ONTGZR5T.js";
+  computeEffectiveProficiencies,
+  computeSuppressedProficiencies
+} from "../chunk-EJD47JHL.js";
 import "../chunk-2LULMQTF.js";
-import "../chunk-H5PTKYXL.js";
-import "../chunk-TULQ4FFX.js";
+import "../chunk-QA3YCOML.js";
+import "../chunk-64VNLMSG.js";
 import "../chunk-TOM66P2P.js";
 import "../chunk-KU3YLF6D.js";
-import "../chunk-HTYMW5CH.js";
+import "../chunk-5JXFJ5AU.js";
+import "../chunk-RD2MID3M.js";
+import "../chunk-LICYHPI3.js";
+import "../chunk-PVCEA4HZ.js";
 import "../chunk-KSTV7J2U.js";
 import "../chunk-DPUJDOKV.js";
 import "../chunk-LBEXLN6I.js";
-import "../chunk-RLGQ5PZZ.js";
-import "../chunk-3VZZDKRA.js";
+import "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
 import "../chunk-YHYTW5QA.js";
-import "../chunk-VRV3NNTA.js";
-import "../chunk-PVCEA4HZ.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-LHZXYFBU.js";
 import "../chunk-YBLDE5CG.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-EVMUJYUD.js";
 import "../chunk-VTTA2ALZ.js";
 import {
@@ -48,5 +50,6 @@ export {
   collectChosenAbilityPoints,
   collectChosenProficiencies,
   computeEffectiveProficiencies,
+  computeSuppressedProficiencies,
   wikilinkTailSlug
 };

package/dist/pc/pc.entry-overrides.js

@@ -11,15 +11,16 @@ import {
   isWeaponLikeEntry,
   itemChargesMax,
   scrollSpellCost
-} from "../chunk-3VZZDKRA.js";
+} from "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-3TM34RSJ.js";
 import "../chunk-PDJSUH24.js";

package/dist/pc/pc.equipment.js

@@ -4,22 +4,23 @@ import {
   computeSlotsAndAttacks,
   emptyAppliedBonuses,
   isWeaponSlugProficient
-} from "../chunk-JSM6JFZR.js";
+} from "../chunk-7XJHI5H5.js";
 import "../chunk-3LWMFYKS.js";
 import "../chunk-YDGMBMYI.js";
 import "../chunk-EJP263OP.js";
-import "../chunk-RLGQ5PZZ.js";
-import "../chunk-3VZZDKRA.js";
+import "../chunk-5JXFJ5AU.js";
+import "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-HHBD4SQ6.js";
 import "../chunk-A54HHCWW.js";
 import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-3TM34RSJ.js";
 import "../chunk-PDJSUH24.js";

package/dist/pc/pc.feature-effects.d.ts

@@ -1,6 +1,6 @@
 import type { FeatureEffect, SenseType } from "@archivist-gg/dnd5e/types/feature-effect";
 import type { Ability } from "@archivist-gg/dnd5e";
-import type { DamageRider, DefenseGrant, FeatureSource, ResolvedCharacter, ResolvedFeature, RollModifierEntry, SaveOutcomeEntry } from "./pc.types.js";
+import type { DamageRider, DefenseGrant, FeatureSource, ResolvedCharacter, ResolvedFeature, RollModifierEntry, SaveOutcomeEntry, SpellDamageRider } from "./pc.types.js";
 /**
  * A melee-attack ability override from a `weapon-ability` effect. `weaponSlugs`
  * (bare, namespace-stripped) scopes the override to matching weapon types only;
@@ -210,11 +210,18 @@ export interface FeatureEffectTotals {
     attackNotes: string[];
     /**
      * Additive on-hit damage riders from `damage-bonus` effects with
-     * `applies_to` weapon/all (spell-only ignored — no spell surface). Each is
+     * `applies_to` weapon/all (spell and all riders also go to `spellDamageBonuses`). Each is
      * labeled with the owning feature's name. recalc merges these onto every
      * weapon AttackRow's `damageRiders`.
      */
     damageBonuses: DamageRider[];
+    /**
+     * The `damage-bonus` effects with `applies_to: spell` or `all`, labeled with the owning feature's name and carrying its
+     * `spellTargets` and `spell_scope` (found live 2026-09-28: they were dropped here, so Agonizing Blast never reached its
+     * cantrip). recalc reads each against the character's spells (`spellsReached`, `spellsInScope`) into
+     * `DerivedStats.spellDamageRiders`.
+     */
+    spellDamageBonuses: SpellDamageRider[];
 }
 export declare function emptyFeatureEffectTotals(): FeatureEffectTotals;
 /**

package/dist/pc/pc.feature-effects.js

@@ -7,12 +7,25 @@ import {
   foldsNow,
   foldsOnSelf,
   selfEffectsOf
-} from "../chunk-TULQ4FFX.js";
+} from "../chunk-64VNLMSG.js";
 import "../chunk-TOM66P2P.js";
 import "../chunk-KU3YLF6D.js";
-import "../chunk-RLGQ5PZZ.js";
+import "../chunk-5JXFJ5AU.js";
+import "../chunk-RD2MID3M.js";
+import "../chunk-NXUY5XQN.js";
+import "../chunk-W6GC6OKK.js";
+import "../chunk-B3DP42OM.js";
+import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
+import "../chunk-IHE6KVC3.js";
+import "../chunk-LHZXYFBU.js";
+import "../chunk-YBLDE5CG.js";
 import "../chunk-LVQLWRCU.js";
+import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
+import "../chunk-3TM34RSJ.js";
+import "../chunk-PDJSUH24.js";
 import "../chunk-WELIKLZF.js";
 export {
   assembleEffectFeatures,

package/dist/pc/pc.infusions.js

@@ -23,15 +23,16 @@ import {
   scaledInfuseItem,
   splitOne,
   withEntryCharges
-} from "../chunk-3VZZDKRA.js";
+} from "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-3TM34RSJ.js";
 import "../chunk-PDJSUH24.js";

package/dist/pc/pc.member-choices.d.ts

@@ -11,7 +11,7 @@
  * from the raw keys the notes already carry (`feat_progression`, `optionalfeature_progression`, `additional_spells`
  * with `choose`, a `spell-choose` prerequisite), so existing notes work with no re-import. Authored `choices` win.
  */
-import type { Character, ChoiceValue, FeatVia, ResolvedCharacter, ResolvedClass } from "./pc.types.js";
+import type { Character, ChoiceValue, FeatVia, ResolvedCharacter, ResolvedClass, ResolvedSpell, SpellTargets } from "./pc.types.js";
 import type { Choice } from "@archivist-gg/dnd5e/types/choice";
 import type { OptionalFeatureEntity } from "@archivist-gg/dnd5e/types/optional-feature.types";
 import type { FeatEntity } from "@archivist-gg/dnd5e/feat/feat.types";
@@ -23,6 +23,22 @@ export declare function isTargetChoice(ch: Choice): boolean;
  * derived rows carry the member's edition so a pick never offers the other edition's twin.
  */
 export declare function memberChoices(entity: OptionalFeatureEntity | null | undefined): Choice[];
+/**
+ * The spells a member's spell-scoped damage rider reaches, as its DATA names them (found live 2026-09-28: Agonizing
+ * Blast's Charisma never reached its cantrip): each answer of a spell target pick (`isTargetChoice`, the blasts' cantrip,
+ * read through `read`, the member's nested key) and each `spell-known` prerequisite (the 2014 Agonizing Blast's Eldritch
+ * Blast). A target pick left unanswered keeps its filter in `open` (see {@link spellsReached}). Null when the member names
+ * no spell, so its spell riders reach none.
+ */
+export declare function memberSpellTargets(member: OptionalFeatureEntity, read: (choiceId: string) => ChoiceValue | undefined): SpellTargets | null;
+/**
+ * The slugs of the character's `spells` a rider with `targets` reaches, unique, in `spells` order: every spell a ref
+ * names (its full slug, else its bare name, so a path link `[[SRD 5e/eldritch-blast]]` finds `srd-5e_spell_eldritch-blast`),
+ * and, for each open target pick, its ONE legal answer: the character's own spells that match the pick's filter and roll
+ * damage, when exactly one does ("one of your known Warlock cantrips that deals damage" with only Eldritch Blast known).
+ * Two or more legal answers are a choice the player has not made, and reach none.
+ */
+export declare function spellsReached(targets: SpellTargets | undefined, spells: ReadonlyArray<Pick<ResolvedSpell, "slug" | "entity">>): string[];
 /** One stored pool pick whose member carries choices, with the block its nested picks live in. */
 export interface PoolMemberSite {
     classIndex: number;
@@ -80,6 +96,22 @@ export interface FeatPickSite {
 export declare function featPickSites(classEntries: ReadonlyArray<{
     choices?: Character["class"][number]["choices"] | ResolvedClass["choices"];
 }> | undefined, memberSites: PoolMemberSite[], classSlugOf: (classIndex: number) => string | null): FeatPickSite[];
+/** SRD-G T4 (audit §3b): a feat the character picked through a SPECIES (the SRD 5.2 Human's Versatile: "You gain an
+ *  Origin feat of your choice"): a `select-entity` of `entity_type: feat` on `race.choices[]` or a trait's `choices[]`,
+ *  answered under `origin_choices["race:<id>"]`. The feat's OWN children are read under `race:feat:<childId>`, the key
+ *  the builder's ledger writes them to (a race item's feat children carry the `feat:` prefix, namespace `race`). */
+export interface RaceFeatSite {
+    slug: string;
+    via: FeatVia;
+    read: (childId: string) => ChoiceValue | undefined;
+}
+export declare function raceFeatSites(race: {
+    slug: string;
+    choices?: unknown;
+    traits?: ReadonlyArray<{
+        choices?: unknown;
+    }>;
+} | null | undefined, originChoices: Readonly<Record<string, ChoiceValue>> | undefined): RaceFeatSite[];
 /** Look a feat pick up in the resolved feats (by slug, then bare slug). */
 export declare function featOfSite(site: FeatPickSite, feats: ReadonlyArray<FeatEntity>): FeatEntity | undefined;
 /**

package/dist/pc/pc.member-choices.js

@@ -3,20 +3,24 @@ import {
   featPickSites,
   isTargetChoice,
   memberChoices,
+  memberSpellTargets,
   nestedPickKeysToPrune,
   poolMemberSites,
-  poolMemberSitesOf
-} from "../chunk-HTYMW5CH.js";
-import "../chunk-3VZZDKRA.js";
+  poolMemberSitesOf,
+  raceFeatSites,
+  spellsReached
+} from "../chunk-RD2MID3M.js";
+import "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-LHZXYFBU.js";
 import "../chunk-YBLDE5CG.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-3TM34RSJ.js";
 import "../chunk-PDJSUH24.js";
@@ -26,7 +30,10 @@ export {
   featPickSites,
   isTargetChoice,
   memberChoices,
+  memberSpellTargets,
   nestedPickKeysToPrune,
   poolMemberSites,
-  poolMemberSitesOf
+  poolMemberSitesOf,
+  raceFeatSites,
+  spellsReached
 };

package/dist/pc/pc.parser.js

@@ -1,6 +1,6 @@
 import {
   characterSchema
-} from "../chunk-T6QIF5XR.js";
+} from "../chunk-NTU2DXNG.js";
 import "../chunk-S7REMWW4.js";
 import {
   keptSlugForLink

package/dist/pc/pc.pools.js

@@ -4,15 +4,16 @@ import {
   resolveAllPools,
   resolvePool,
   strandedPicks
-} from "../chunk-3VZZDKRA.js";
+} from "../chunk-NXUY5XQN.js";
 import "../chunk-W6GC6OKK.js";
 import "../chunk-B3DP42OM.js";
 import "../chunk-IUAAXXNO.js";
+import "../chunk-ZUQW5VBZ.js";
 import "../chunk-IHE6KVC3.js";
 import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
 import "../chunk-LVQLWRCU.js";
 import "../chunk-CM5CWO4K.js";
+import "../chunk-4J6DS3EJ.js";
 import "../chunk-ZCTUYGNV.js";
 import "../chunk-3TM34RSJ.js";
 import "../chunk-PDJSUH24.js";

package/dist/pc/pc.proficiencies.d.ts

@@ -1,4 +1,6 @@
 import type { ResolvedCharacter } from "./pc.types.js";
+import type { WeaponEntity } from "@archivist-gg/dnd5e/weapon/weapon.types";
+import { type ProficiencyKind } from "./pc.proficiency-normalize.js";
 import { type ProficiencyEntry, type ProficiencyGrant } from "./pc.proficiency-grants.js";
 /** Re-exported for the plugin: both types are DECLARED in the leaf so that
  *  pc.decision-engine can reference them without importing this module, which
@@ -62,3 +64,15 @@ export interface ProficiencySources {
 }
 export declare function collectProficiencySources(resolved: ResolvedCharacter): ProficiencySources;
 export declare function aggregateProficiencies(resolved: ResolvedCharacter): ProficiencyAggregate;
+/** D4 A: one kind's proficiencies as the picker needs them: `effective` is exactly the sheet's line (the aggregate's
+ *  bucket), `removed` every grant or pick the user's overrides suppress, keeping its `sources`. Both halves come out of
+ *  the composers the sheet reads, so the picker and the sheet line cannot disagree. */
+export declare function proficiencyOverview(resolved: ResolvedCharacter, kind: ProficiencyKind): {
+    effective: ProficiencyEntry[];
+    removed: ProficiencyEntry[];
+};
+/** D4 A: the effective weapon entry that covers `weapon` without naming it, a category (`simple`, `martial`, or the
+ *  entity's own `martial-melee` form) or a property-qualified grant ("Martial weapons that have the Light property").
+ *  The same three arms as the live gate, `isWeaponSlugProficient` (pc.equipment.ts), so the picker's dimmed "via" row
+ *  and the attack row's proficiency agree. Undefined when nothing but the weapon's own entry could cover it. */
+export declare function weaponCoveredBy(effective: readonly ProficiencyEntry[], weapon: Pick<WeaponEntity, "category" | "properties" | "range" | "slug">): ProficiencyEntry | undefined;