@archivist-gg/dnd5e 0.3.17 → 0.3.24

package/dist/pc/pc.infusions.js

@@ -1,64 +1 @@
-import {
-  buildInfusionContext,
-  createEntry,
-  eligibleTargets,
-  endInfusion,
-  entryCharges,
-  infuseEntry,
-  infusionsEndedByChoice,
-  infusionsEndedByClassEdit,
-  isItemBound,
-  isMarkedEntry,
-  markerKey,
-  normalizedPickKey,
-  optionCandidates,
-  parsePickKey,
-  poolActiveWords,
-  poolCountLabel,
-  reconcileChoiceEdit,
-  reconcileClassEdit,
-  resolveCopyOption,
-  resolveEntryEntity,
-  resolveOptionRows,
-  scaledInfuseItem,
-  splitOne,
-  withEntryCharges
-} from "../chunk-3VZZDKRA.js";
-import "../chunk-W6GC6OKK.js";
-import "../chunk-B3DP42OM.js";
-import "../chunk-IUAAXXNO.js";
-import "../chunk-IHE6KVC3.js";
-import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
-import "../chunk-LVQLWRCU.js";
-import "../chunk-CM5CWO4K.js";
-import "../chunk-ZCTUYGNV.js";
-import "../chunk-3TM34RSJ.js";
-import "../chunk-PDJSUH24.js";
-import "../chunk-WELIKLZF.js";
-export {
-  buildInfusionContext,
-  createEntry,
-  eligibleTargets,
-  endInfusion,
-  entryCharges,
-  infuseEntry,
-  infusionsEndedByChoice,
-  infusionsEndedByClassEdit,
-  isItemBound,
-  isMarkedEntry,
-  markerKey,
-  normalizedPickKey,
-  optionCandidates,
-  parsePickKey,
-  poolActiveWords,
-  poolCountLabel,
-  reconcileChoiceEdit,
-  reconcileClassEdit,
-  resolveCopyOption,
-  resolveEntryEntity,
-  resolveOptionRows,
-  scaledInfuseItem,
-  splitOne,
-  withEntryCharges
-};
+import{buildInfusionContext,createEntry,eligibleTargets,endInfusion,entryCharges,infuseEntry,infusionsEndedByChoice,infusionsEndedByClassEdit,isItemBound,isMarkedEntry,markerKey,normalizedPickKey,optionCandidates,parsePickKey,poolActiveWords,poolCountLabel,reconcileChoiceEdit,reconcileClassEdit,resolveCopyOption,resolveEntryEntity,resolveOptionRows,scaledInfuseItem,splitOne,withEntryCharges}from"../chunk-DY6FVAGA.js";import"../chunk-CMIEZQL4.js";import"../chunk-BGX36NPE.js";import"../chunk-O776WL7O.js";import"../chunk-DVUXUIPV.js";import"../chunk-YGH7S5ZF.js";import"../chunk-4IAMSRHD.js";import"../chunk-DZITM5AG.js";import"../chunk-PZ4L2EEG.js";import"../chunk-QMEKQTUT.js";import"../chunk-63YJPWTM.js";import"../chunk-BREHZNTL.js";import"../chunk-7FPQJDFD.js";import"../chunk-EVT7MGAC.js";export{buildInfusionContext,createEntry,eligibleTargets,endInfusion,entryCharges,infuseEntry,infusionsEndedByChoice,infusionsEndedByClassEdit,isItemBound,isMarkedEntry,markerKey,normalizedPickKey,optionCandidates,parsePickKey,poolActiveWords,poolCountLabel,reconcileChoiceEdit,reconcileClassEdit,resolveCopyOption,resolveEntryEntity,resolveOptionRows,scaledInfuseItem,splitOne,withEntryCharges};

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

@@ -0,0 +1,18 @@
+import type { EntityRegistry } from "@archivist-gg/core";
+import type { ItemEntity } from "@archivist-gg/dnd5e/item/item.types";
+import type { ArmorEntity } from "@archivist-gg/dnd5e/armor/armor.types";
+import type { WeaponEntity } from "@archivist-gg/dnd5e/weapon/weapon.types";
+import type { FeatureEffect } from "../types/feature-effect.js";
+import { type EntryView, type InfusionContext } from "./pc.infusions.js";
+import type { EquipmentEntry, ResolvedFeature } from "./pc.types.js";
+export declare function itemBenefitsActive(entry: EquipmentEntry, entity: ItemEntity | ArmorEntity | WeaponEntity | null, registry: EntityRegistry | null, view?: EntryView | null): boolean;
+export declare function itemLabel(entry: EquipmentEntry, entity: {
+    name?: unknown;
+} | null): string;
+export declare const ITEM_ROW_KINDS: ReadonlySet<FeatureEffect["kind"]>;
+export declare function readItemEffects(entity: unknown): {
+    effects: FeatureEffect[];
+    invalid: string[];
+};
+export declare function itemRowEffects(entity: unknown): FeatureEffect[];
+export declare function buildItemFeatures(equipment: readonly EquipmentEntry[], registry: EntityRegistry, infusions: InfusionContext | undefined, warnings: string[]): ResolvedFeature[];

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

@@ -1,47 +1,26 @@
-/**
- * D2b-A · nested choices on pool members (design §2.2, user rulings 2026-09-27: GENERAL and RECURSIVE).
- *
- * A pool member (an invocation, a maneuver, a fighting-style option, ...) may carry its own choices: Lessons of the First
- * Ones' Origin feat, Superior Technique's maneuver, Blessed and Druidic Warrior's cantrips, Pact of the Tome's cantrips
- * and rituals, the three blasts' cantrip. A nested pick lives in the pool's ANCHOR block under
- * `<poolId>:<pickKey>:<choiceId>` (a nested feat's own children under `<poolId>:<pickKey>:feat:<childId>`, the decision
- * engine's prefix chaining), keyed by the stored pick string, so reordering or adding picks never moves it.
- *
- * The choices are the member's authored `choices`; absent (every note in the vault today), they are DERIVED at read time
- * 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";
-/** Whether `ch` names a target rather than granting what it picks (the data flag `target: true`, which the spell-choose
- *  derivation below writes and an authored note may carry). */
 export declare function isTargetChoice(ch: Choice): boolean;
-/**
- * The member's choices: its authored `choices`, else the ones its raw keys ask for (see the module docblock). Pure; the
- * derived rows carry the member's edition so a pick never offers the other edition's twin.
- */
+export declare const PACT_WEAPON_CHOICE_ID = "pact-weapon";
+export declare function pactWeaponPick(sites: ReadonlyArray<Pick<PoolMemberSite, "choices" | "read">>): string | undefined;
+export declare function classPactWeaponPick(character: Pick<Character, "class">, classes: ReadonlyArray<Pick<ResolvedClass, "entity" | "subclass">>): string | undefined;
 export declare function memberChoices(entity: OptionalFeatureEntity | null | undefined): Choice[];
-/** One stored pool pick whose member carries choices, with the block its nested picks live in. */
+export declare function memberSpellTargets(member: OptionalFeatureEntity, read: (choiceId: string) => ChoiceValue | undefined): SpellTargets | null;
+export declare function spellsReached(targets: SpellTargets | undefined, spells: ReadonlyArray<Pick<ResolvedSpell, "slug" | "entity">>): string[];
 export interface PoolMemberSite {
     classIndex: number;
-    /** The pool's anchor level (the block's key in `choices`). */
     level: number;
     poolId: string;
-    /** The stored pick string (a copy of a repeatable note keeps its `slug#param`). */
     pickKey: string;
     member: OptionalFeatureEntity;
     memberSlug: string;
     choices: Choice[];
-    /** `<poolId>:<pickKey>:` */
     prefix: string;
-    /** The nested pick stored for a member choice id. */
     read: (choiceId: string) => ChoiceValue | undefined;
-    /** The anchor block, as stored. */
     block: Record<string, ChoiceValue>;
 }
-/** Structural subset of the registry the raw enumerator reads. */
 export interface MemberRegistry {
     getByTypeAndSlug(entityType: string, slug: string): {
         slug: string;
@@ -52,39 +31,29 @@ export interface MemberRegistry {
         data: Record<string, unknown>;
     }>;
 }
-/**
- * Every pool member site from the RAW character (the resolver's view, before pools resolve): each class's and subclass's
- * declared pools, their anchor levels (`poolAnchorLevel`, the one derivation `resolvePool` uses), the picks stored there,
- * each resolved to its note (full slug, else bare). A pick with no note, or a note with no choices, yields no site, so an
- * orphan nested key is inert.
- */
 export declare function poolMemberSites(classes: ResolvedClass[], registry: MemberRegistry): PoolMemberSite[];
-/** The same sites read from a RESOLVED character's pools (the ledger's, the proficiency walk's and recalc's view). */
 export declare function poolMemberSitesOf(resolved: Pick<ResolvedCharacter, "pools" | "classes">): PoolMemberSite[];
-/** A feat the character picked, where it was picked, and how its own children are read. */
 export interface FeatPickSite {
     slug: string;
     classIndex: number;
     level: number | null;
     via: FeatVia | null;
-    /** A child choice of THIS feat, as stored (`feat:<id>` in the slot's block, or `<prefix>feat:<id>` under a member). */
     read: (childId: string) => ChoiceValue | undefined;
 }
-/**
- * Every feat pick with its own read (design §2.2 step 4): the class-slot picks (`choices[<level>].feat`, children under
- * `feat:<id>`) and the pool-member picks (a member choice of `entity_type: feat`, children under `<prefix>feat:<id>`).
- * The ONE list the four feat readers walk (the resolver's feats and feat spells, the proficiency walk, ability points).
- * `classSlugOf` names a class for the provenance. NOT de-duplicated: a feat taken twice (Magic Initiate, one spell list
- * each) is two sites with two reads; a reader that lists feats de-duplicates by slug itself (first wins).
- */
 export declare function featPickSites(classEntries: ReadonlyArray<{
     choices?: Character["class"][number]["choices"] | ResolvedClass["choices"];
 }> | undefined, memberSites: PoolMemberSite[], classSlugOf: (classIndex: number) => string | null): FeatPickSite[];
-/** Look a feat pick up in the resolved feats (by slug, then bare slug). */
+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[];
 export declare function featOfSite(site: FeatPickSite, feats: ReadonlyArray<FeatEntity>): FeatEntity | undefined;
-/**
- * The nested keys an array write to `key` orphans (design §2.2 step 8): every `<key>:<k>:*` whose `k` was stored before
- * and is not in `next`. Pure; the writer deletes them in the same write, so a re-pick never resurrects an old answer.
- * A key that is not a pool (no array stored) orphans nothing.
- */
 export declare function nestedPickKeysToPrune(block: Record<string, unknown> | undefined, key: string, next: readonly string[]): string[];

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

@@ -1,32 +1 @@
-import {
-  featOfSite,
-  featPickSites,
-  isTargetChoice,
-  memberChoices,
-  nestedPickKeysToPrune,
-  poolMemberSites,
-  poolMemberSitesOf
-} from "../chunk-HTYMW5CH.js";
-import "../chunk-3VZZDKRA.js";
-import "../chunk-W6GC6OKK.js";
-import "../chunk-B3DP42OM.js";
-import "../chunk-IUAAXXNO.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-ZCTUYGNV.js";
-import "../chunk-3TM34RSJ.js";
-import "../chunk-PDJSUH24.js";
-import "../chunk-WELIKLZF.js";
-export {
-  featOfSite,
-  featPickSites,
-  isTargetChoice,
-  memberChoices,
-  nestedPickKeysToPrune,
-  poolMemberSites,
-  poolMemberSitesOf
-};
+import{PACT_WEAPON_CHOICE_ID,classPactWeaponPick,featOfSite,featPickSites,isTargetChoice,memberChoices,memberSpellTargets,nestedPickKeysToPrune,pactWeaponPick,poolMemberSites,poolMemberSitesOf,raceFeatSites,spellsReached}from"../chunk-QBA757AU.js";import"../chunk-DY6FVAGA.js";import"../chunk-CMIEZQL4.js";import"../chunk-BGX36NPE.js";import"../chunk-O776WL7O.js";import"../chunk-DVUXUIPV.js";import"../chunk-YGH7S5ZF.js";import"../chunk-4IAMSRHD.js";import"../chunk-3QQOATV3.js";import"../chunk-DZITM5AG.js";import"../chunk-PZ4L2EEG.js";import"../chunk-QMEKQTUT.js";import"../chunk-63YJPWTM.js";import"../chunk-BREHZNTL.js";import"../chunk-7FPQJDFD.js";import"../chunk-EVT7MGAC.js";export{PACT_WEAPON_CHOICE_ID,classPactWeaponPick,featOfSite,featPickSites,isTargetChoice,memberChoices,memberSpellTargets,nestedPickKeysToPrune,pactWeaponPick,poolMemberSites,poolMemberSitesOf,raceFeatSites,spellsReached};

package/dist/pc/pc.parser.js

@@ -1,58 +1 @@
-import {
-  characterSchema
-} from "../chunk-T6QIF5XR.js";
-import "../chunk-S7REMWW4.js";
-import {
-  keptSlugForLink
-} from "../chunk-CM5CWO4K.js";
-import "../chunk-ZCTUYGNV.js";
-
-// src/pc/pc.parser.ts
-import * as yaml from "js-yaml";
-function parsePC(source) {
-  var _a;
-  let raw;
-  try {
-    raw = yaml.load(source);
-  } catch (e) {
-    const msg = e instanceof Error ? e.message : String(e);
-    return { success: false, error: `YAML parse error: ${msg}` };
-  }
-  if (!raw || typeof raw !== "object") {
-    return { success: false, error: "Invalid YAML: expected an object" };
-  }
-  const result = characterSchema.safeParse(raw);
-  if (!result.success) {
-    const issue = result.error.issues[0];
-    const path = issue.path.length ? issue.path.join(".") : "(root)";
-    return { success: false, error: `${path}: ${issue.message}` };
-  }
-  const data = result.data;
-  const legacyState = data.state;
-  const legacyCurrency = legacyState.currency;
-  if (legacyCurrency && !data.currency) {
-    data.currency = legacyCurrency;
-  }
-  if (legacyCurrency) {
-    delete legacyState.currency;
-  }
-  if (legacyState.attuned_items) {
-    delete legacyState.attuned_items;
-  }
-  for (const entry of (_a = data.equipment) != null ? _a : []) {
-    if (typeof entry.item !== "string") continue;
-    const next = migrateRetiredItemLink(entry.item);
-    if (next !== null) entry.item = next;
-  }
-  return { success: true, data };
-}
-function migrateRetiredItemLink(item) {
-  var _a;
-  const m = /^\[\[([^\]|]+)(\|[^\]]*)?\]\]$/.exec(item.trim());
-  const kept = keptSlugForLink(m ? m[1] : item);
-  if (kept === void 0) return null;
-  return m ? `[[${kept}${(_a = m[2]) != null ? _a : ""}]]` : kept;
-}
-export {
-  parsePC
-};
+import{characterSchema}from"../chunk-5FEXHY4U.js";import"../chunk-KM75CC6Q.js";import{keptSlugForLink}from"../chunk-PZ4L2EEG.js";import"../chunk-63YJPWTM.js";import*as yaml from"js-yaml";function parsePC(source){var _a;let raw;try{raw=yaml.load(source)}catch(e){const msg=e instanceof Error?e.message:String(e);return{success:false,error:`YAML parse error: ${msg}`}}if(!raw||typeof raw!=="object"){return{success:false,error:"Invalid YAML: expected an object"}}const result=characterSchema.safeParse(raw);if(!result.success){const issue=result.error.issues[0];const path=issue.path.length?issue.path.join("."):"(root)";return{success:false,error:`${path}: ${issue.message}`}}const data=result.data;const legacyState=data.state;const legacyCurrency=legacyState.currency;if(legacyCurrency&&!data.currency){data.currency=legacyCurrency}if(legacyCurrency){delete legacyState.currency}if(legacyState.attuned_items){delete legacyState.attuned_items}for(const entry of(_a=data.equipment)!=null?_a:[]){if(typeof entry.item!=="string")continue;const next=migrateRetiredItemLink(entry.item);if(next!==null)entry.item=next}return{success:true,data}}function migrateRetiredItemLink(item){var _a;const m=/^\[\[([^\]|]+)(\|[^\]]*)?\]\]$/.exec(item.trim());const kept=keptSlugForLink(m?m[1]:item);if(kept===void 0)return null;return m?`[[${kept}${(_a=m[2])!=null?_a:""}]]`:kept}export{parsePC};

package/dist/pc/pc.pools.d.ts

@@ -3,25 +3,22 @@ import type { ResolvedCharacter, ResolvedClass, ResolvedPool, ResolvedPoolEntry
 import type { SelectionPool } from "@archivist-gg/dnd5e/types/selection-pool";
 import type { OptionalFeatureEntity } from "@archivist-gg/dnd5e/types/optional-feature.types";
 import type { ResourceIndex } from "./pc.resources.js";
-/** Structural subset of EntityRegistry used here (lets tests pass a fake). */
 export interface PoolRegistry {
     search(query: string, entityType: string, limit: number): RegisteredEntity[];
     getByTypeAndSlug(entityType: string, slug: string): RegisteredEntity | undefined;
 }
 export declare function levelPrereqMax(d: OptionalFeatureEntity): number;
-/** The pool's ANCHOR level (its picks live in `choices[anchorLevel][pool.id]`): the first level whose count column
- *  carries a value of at least 1, else 1; `columnSeen` says whether any level carried the column at all. ONE derivation
- *  shared by `resolvePool` and the nested-choice enumerator (D2b-A, `pc.member-choices.ts`), so the two always agree. */
+export declare function levelPrereqRefsMet(d: OptionalFeatureEntity, rc: Pick<ResolvedClass, "entity" | "subclass">): boolean;
 export declare function poolAnchorLevel(entity: Pick<NonNullable<ResolvedClass["entity"]>, "table">, pool: Pick<SelectionPool, "count">): {
     anchorLevel: number;
     columnSeen: boolean;
 };
 export declare function resolvePool(rc: ResolvedClass, classIndex: number, pool: SelectionPool, registry: PoolRegistry, index: ResourceIndex, edition?: string): ResolvedPool;
 export declare function resolveAllPools(resolved: ResolvedCharacter, registry: PoolRegistry, index: ResourceIndex): ResolvedPool[];
-/** The stored picks that survived resolution but are NOT in the collapsed `available` list, compared by FULL
- *  slug: exactly the rule the plugin's `strandedSelections` used before T3 retires it (R4-G5 §3.2.3). Because
- *  §9.2.3's resolution rewrites a collapsed twin to its survivor, only a GENUINE prerequisite-failing pick (the
- *  one resolved by step 3 from the full scan) can land here, and it keeps its entity so the builder strip and the
- *  sheet can both dress it "prerequisite unmet". A granted feature is already excluded from `selected`, so a
- *  grant never appears here. Pure over the resolved pool: it reads nothing the resolver did not compute. */
 export declare function strandedPicks(pool: ResolvedPool): ResolvedPoolEntry[];
+export declare function heldPicks(pool: ResolvedPool): ResolvedPoolEntry[];
+export declare function withoutStrandedSites<T extends {
+    classIndex: number;
+    poolId: string;
+    memberSlug: string;
+}>(sites: T[], classes: ResolvedClass[], registry: PoolRegistry, edition?: string): T[];

package/dist/pc/pc.pools.js

@@ -1,26 +1 @@
-import {
-  levelPrereqMax,
-  poolAnchorLevel,
-  resolveAllPools,
-  resolvePool,
-  strandedPicks
-} from "../chunk-3VZZDKRA.js";
-import "../chunk-W6GC6OKK.js";
-import "../chunk-B3DP42OM.js";
-import "../chunk-IUAAXXNO.js";
-import "../chunk-IHE6KVC3.js";
-import "../chunk-LHZXYFBU.js";
-import "../chunk-ZUQW5VBZ.js";
-import "../chunk-LVQLWRCU.js";
-import "../chunk-CM5CWO4K.js";
-import "../chunk-ZCTUYGNV.js";
-import "../chunk-3TM34RSJ.js";
-import "../chunk-PDJSUH24.js";
-import "../chunk-WELIKLZF.js";
-export {
-  levelPrereqMax,
-  poolAnchorLevel,
-  resolveAllPools,
-  resolvePool,
-  strandedPicks
-};
+import{heldPicks,levelPrereqMax,levelPrereqRefsMet,poolAnchorLevel,resolveAllPools,resolvePool,strandedPicks,withoutStrandedSites}from"../chunk-DY6FVAGA.js";import"../chunk-CMIEZQL4.js";import"../chunk-BGX36NPE.js";import"../chunk-O776WL7O.js";import"../chunk-DVUXUIPV.js";import"../chunk-YGH7S5ZF.js";import"../chunk-4IAMSRHD.js";import"../chunk-DZITM5AG.js";import"../chunk-PZ4L2EEG.js";import"../chunk-QMEKQTUT.js";import"../chunk-63YJPWTM.js";import"../chunk-BREHZNTL.js";import"../chunk-7FPQJDFD.js";import"../chunk-EVT7MGAC.js";export{heldPicks,levelPrereqMax,levelPrereqRefsMet,poolAnchorLevel,resolveAllPools,resolvePool,strandedPicks,withoutStrandedSites};

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

@@ -1,45 +1,14 @@
 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
- *  would close a cycle (spec §4.3). */
 export type { ProficiencyEntry, ProficiencyOrigin } from "./pc.proficiency-grants.js";
-/** Every bucket carries provenance (spec §7.1). `languages`/`tools` ARE
- *  {@link computeEffectiveProficiencies}' output, unmodified · `armor`/`weapons`
- *  are composed below from the raw grant walk, because they have no vocabulary
- *  constant to canonicalize against (spec §3.3's second rule) · and for `weapons`
- *  that grant walk is followed by the chosen `select-entity{weapon}` picks
- *  (R4-G3b §7 F5), which land with origin `pick`. */
 export interface ProficiencyAggregate {
     armor: ProficiencyEntry[];
     weapons: ProficiencyEntry[];
     tools: ProficiencyEntry[];
     languages: ProficiencyEntry[];
 }
-/** Normalized intermediate of every proficiency/language source the DISPLAY path
- *  reads, in one place. Among the ENTITY branches only the class one is a live
- *  proficiency source today (race/bg/feat `.proficiencies` object fields do not
- *  exist on those entities); race languages, bg tool/lang, and feat grants read
- *  their real fields, and the four `effect*` buckets carry what a feature's
- *  `kind: "proficiency"` effects grant · that is the live path a 2014 race trait
- *  actually uses (R4-P3c). Chosen picks come from the single decision walk in
- *  pc.decision-engine so display can never diverge from the persisted picks.
- *
- *  Every grant bucket carries `{value, source}` rather than a bare value: the
- *  walk holds the granting entity and the aggregate needs it to fill
- *  `ProficiencyEntry.sources` for armor and weapons (spec §7.1). The
- *  language/tool grant buckets are still surfaced here for completeness, but
- *  the aggregate no longer reads them · languages and tools come from
- *  computeEffectiveProficiencies, which does its own grant walk so that
- *  suppressions and manual adds can never be skipped by a second composer.
- *
- *  These names are RE-DECLARED by hand rather than inherited: this interface
- *  does not `extends ProficiencyGrants`, so a bucket added to the grant walk
- *  stays invisible here until it is added here too. `collectProficiencySources`
- *  spreads the grants object, so an undeclared bucket still flows at RUNTIME ·
- *  the compiler is the only thing that notices, and only where the field is
- *  read. Nothing iterates these objects with Object.keys/values/entries, so a
- *  declaration gap is inert rather than corrupting; it is still a gap. */
 export interface ProficiencySources {
     classArmor: ProficiencyGrant[];
     classWeaponFixed: ProficiencyGrant[];
@@ -62,3 +31,8 @@ export interface ProficiencySources {
 }
 export declare function collectProficiencySources(resolved: ResolvedCharacter): ProficiencySources;
 export declare function aggregateProficiencies(resolved: ResolvedCharacter): ProficiencyAggregate;
+export declare function proficiencyOverview(resolved: ResolvedCharacter, kind: ProficiencyKind): {
+    effective: ProficiencyEntry[];
+    removed: ProficiencyEntry[];
+};
+export declare function weaponCoveredBy(effective: readonly ProficiencyEntry[], weapon: Pick<WeaponEntity, "category" | "properties" | "range" | "slug">): ProficiencyEntry | undefined;

package/dist/pc/pc.proficiencies.js

@@ -1,107 +1 @@
-import {
-  collectChosenProficiencies,
-  collectProficiencyGrants,
-  computeEffectiveProficiencies
-} from "../chunk-ONTGZR5T.js";
-import "../chunk-2LULMQTF.js";
-import "../chunk-H5PTKYXL.js";
-import "../chunk-TULQ4FFX.js";
-import "../chunk-TOM66P2P.js";
-import "../chunk-KU3YLF6D.js";
-import "../chunk-HTYMW5CH.js";
-import "../chunk-KSTV7J2U.js";
-import "../chunk-DPUJDOKV.js";
-import "../chunk-LBEXLN6I.js";
-import {
-  proficiencyLabel,
-  toProfSlug
-} from "../chunk-RLGQ5PZZ.js";
-import "../chunk-3VZZDKRA.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-IHE6KVC3.js";
-import "../chunk-LHZXYFBU.js";
-import "../chunk-YBLDE5CG.js";
-import "../chunk-ZUQW5VBZ.js";
-import "../chunk-LVQLWRCU.js";
-import "../chunk-CM5CWO4K.js";
-import "../chunk-EVMUJYUD.js";
-import "../chunk-VTTA2ALZ.js";
-import "../chunk-ZCTUYGNV.js";
-import "../chunk-7Q2VPKCD.js";
-import "../chunk-ZDAEGJH4.js";
-import "../chunk-3TM34RSJ.js";
-import "../chunk-PDJSUH24.js";
-import "../chunk-WELIKLZF.js";
-import "../chunk-4U55VNC7.js";
-import "../chunk-UA5KS2PL.js";
-
-// src/pc/pc.proficiencies.ts
-function collectProficiencySources(resolved) {
-  const g = collectProficiencyGrants(resolved);
-  const chosen = collectChosenProficiencies(resolved);
-  return {
-    ...g,
-    chosenLanguages: chosen.languages,
-    chosenTools: chosen.tools,
-    chosenWeapons: chosen.weapons
-  };
-}
-function aggregateProficiencies(resolved) {
-  const src = collectProficiencySources(resolved);
-  const effective = computeEffectiveProficiencies(resolved);
-  return {
-    // Walk order defines `sources` order (spec §4.1): class before feats, and
-    // for weapons the class `fixed` names before the class categories, matching
-    // the insertion order of the bucket this replaced, exactly.
-    //
-    // Effect buckets go LAST: first-seen wins the dedupe key, so an existing
-    // class or feat grant keeps its shipped spelling and label and the effect
-    // only appends its source name. Reordering these silently relabels rows.
-    //
-    // The chosen weapon PICKS are the second argument, so they are seeded after
-    // every grant bucket: a weapon both granted and picked stays ONE row that
-    // keeps origin `grant` and its granting source(s) (R4-G3b §7 F5 · the same
-    // grants-then-picks order computeEffectiveProficiencies uses for the
-    // language and tool buckets). Armor passes none.
-    armor: composeGrantEntries([src.classArmor, src.featArmor, src.effectArmor]),
-    weapons: composeGrantEntries([src.classWeaponFixed, src.classWeaponCategories, src.featWeapons, src.effectWeapons], src.chosenWeapons),
-    tools: effective.tools,
-    languages: effective.languages
-  };
-}
-function composeGrantEntries(buckets, picks = []) {
-  const byKey = /* @__PURE__ */ new Map();
-  for (const bucket of buckets) {
-    for (const g of bucket) {
-      const key = toProfSlug(g.value);
-      const existing = byKey.get(key);
-      if (!existing) {
-        byKey.set(key, {
-          value: g.value,
-          label: prettyName(g.value),
-          sources: [g.source],
-          origin: "grant"
-        });
-        continue;
-      }
-      if (!existing.sources.includes(g.source)) existing.sources.push(g.source);
-    }
-  }
-  for (const v of picks) {
-    const k = toProfSlug(v);
-    if (!byKey.has(k)) byKey.set(k, { value: v, label: prettyName(v), sources: [], origin: "pick" });
-  }
-  return [...byKey.values()].sort((a, b) => a.label < b.label ? -1 : a.label > b.label ? 1 : 0);
-}
-function prettyName(slug) {
-  return proficiencyLabel(slug);
-}
-export {
-  aggregateProficiencies,
-  collectProficiencySources
-};
+import{qualifiedGrantCovers}from"../chunk-T55DELVL.js";import"../chunk-SEOASDO4.js";import{collectChosenProficiencies,collectProficiencyGrants,computeEffectiveProficiencies,computeSuppressedProficiencies}from"../chunk-IGVRLGLM.js";import"../chunk-2EOGK6R6.js";import"../chunk-RQZCGXUZ.js";import"../chunk-PQAVMK3T.js";import"../chunk-HCK6IUB3.js";import"../chunk-FOLHTMSC.js";import"../chunk-4JEF3CET.js";import{normKey,proficiencyKey,proficiencyLabel,toProfSlug,weaponProfKey}from"../chunk-VTQ4RWEG.js";import"../chunk-QBA757AU.js";import"../chunk-A7H6LX47.js";import"../chunk-UBUKCRZ3.js";import"../chunk-PZUPZBTN.js";import"../chunk-NI364WV7.js";import"../chunk-QVWT67WA.js";import"../chunk-DY6FVAGA.js";import"../chunk-CMIEZQL4.js";import"../chunk-BGX36NPE.js";import"../chunk-O776WL7O.js";import"../chunk-3LWOVRLA.js";import"../chunk-DVUXUIPV.js";import"../chunk-YGH7S5ZF.js";import"../chunk-4IAMSRHD.js";import"../chunk-3QQOATV3.js";import"../chunk-DZITM5AG.js";import"../chunk-PZ4L2EEG.js";import"../chunk-QMEKQTUT.js";import"../chunk-EAARMPCW.js";import"../chunk-CAPYNIGK.js";import"../chunk-63YJPWTM.js";import"../chunk-4KVVAENP.js";import"../chunk-7EL3GWWJ.js";import"../chunk-BREHZNTL.js";import"../chunk-7FPQJDFD.js";import"../chunk-EVT7MGAC.js";import"../chunk-S5UCI27C.js";import"../chunk-6IC53O3Q.js";import"../chunk-I26FHSI6.js";function collectProficiencySources(resolved){const g=collectProficiencyGrants(resolved);const chosen=collectChosenProficiencies(resolved);return{...g,chosenLanguages:chosen.languages,chosenTools:chosen.tools,chosenWeapons:chosen.weapons}}function aggregateProficiencies(resolved){const{armor,weapons}=composeArmorWeapons(resolved);const effective=computeEffectiveProficiencies(resolved);return{armor:armor.kept,weapons:weapons.kept,tools:effective.tools,languages:effective.languages}}function proficiencyOverview(resolved,kind){if(kind==="armor"||kind==="weapons"){const c=composeArmorWeapons(resolved)[kind];return{effective:c.kept,removed:c.suppressed}}return{effective:computeEffectiveProficiencies(resolved)[kind],removed:computeSuppressedProficiencies(resolved)[kind]}}function weaponCoveredBy(effective,weapon){const cat=typeof weapon.category==="string"?weapon.category:"";const base=cat.split("-")[0];return effective.find(e=>{const key=weaponProfKey(e.value);if((key==="simple"||key==="martial")&&key===base)return true;if(cat&&key===normKey(cat))return true;return qualifiedGrantCovers(e.value,weapon)})}function composeArmorWeapons(resolved){const src=collectProficiencySources(resolved);return{armor:applyKindOverrides(resolved,"armor",composeGrantEntries([src.classArmor,src.featArmor,src.effectArmor])),weapons:applyKindOverrides(resolved,"weapons",composeGrantEntries([src.classWeaponFixed,src.classWeaponCategories,src.featWeapons,src.effectWeapons],src.chosenWeapons))}}function applyKindOverrides(resolved,kind,entries){var _a,_b,_c,_d;const ov=(_b=(_a=resolved.definition)==null?void 0:_a.overrides)==null?void 0:_b[kind];const key=v=>proficiencyKey(kind,v);const all=[...entries];for(const v of(_c=ov==null?void 0:ov.add)!=null?_c:[]){if(!all.some(e=>key(e.value)===key(v)))all.push({value:v,label:prettyName(v),sources:[],origin:"manual"})}const removes=new Set(((_d=ov==null?void 0:ov.remove)!=null?_d:[]).map(key));const byLabel=(a,b)=>a.label<b.label?-1:a.label>b.label?1:0;return{kept:all.filter(e=>!removes.has(key(e.value))).sort(byLabel),suppressed:all.filter(e=>removes.has(key(e.value))).sort(byLabel)}}function composeGrantEntries(buckets,picks=[]){const byKey=new Map;for(const bucket of buckets){for(const g of bucket){const key=toProfSlug(g.value);const existing=byKey.get(key);if(!existing){byKey.set(key,{value:g.value,label:prettyName(g.value),sources:[g.source],origin:"grant"});continue}if(!existing.sources.includes(g.source))existing.sources.push(g.source)}}for(const v of picks){const k=toProfSlug(v);if(!byKey.has(k))byKey.set(k,{value:v,label:prettyName(v),sources:[],origin:"pick"})}return[...byKey.values()].sort((a,b)=>a.label<b.label?-1:a.label>b.label?1:0)}function prettyName(slug){return proficiencyLabel(slug)}export{aggregateProficiencies,collectProficiencySources,proficiencyOverview,weaponCoveredBy};

package/dist/pc/pc.proficiency-grants.d.ts

@@ -1,25 +1,12 @@
 import type { ResolvedCharacter } from "./pc.types.js";
 export type ProficiencyOrigin = "grant" | "pick" | "manual" | "custom";
 export interface ProficiencyEntry {
-    /** Canonical slug when the value lands on the domain vocabulary, else the raw string. Spec §3.3. */
     value: string;
-    /** Display form. Spec §3.3's first code block (languages/tools) or second (armor/weapons). */
     label: string;
-    /** EVERY granting entity's display name, in walk order: class, race,
-     *  background, feats, then feature EFFECTS last (R4-P3c · both composers order
-     *  the effect bucket last so a first-seen entity grant keeps its own label). */
     sources: string[];
     origin: ProficiencyOrigin;
-    /** R4-G4 §9: tool expertise rides the grant channel (the ONE channel the panel
-     *  and the modal read); the manual tri `overrides.tools.proficiency` (spec §9.3,
-     *  Tier B) is its second writer, applied in `computeEffectiveProficiencies`.
-     *  ABSENT rather than `false` on a plain entry. */
     expertise?: boolean;
 }
-/** One granted value plus the display name of the entity that granted it.
- *  `expertise` is present (and `true`) only when the granting effect authored it
- *  (R4-G4 §9.2), so a plain grant keeps the exact two-key shape every pre-phase
- *  reader was written against. */
 export interface ProficiencyGrant {
     value: string;
     source: string;
@@ -42,17 +29,4 @@ export interface ProficiencyGrants {
     effectTools: ProficiencyGrant[];
     effectLanguages: ProficiencyGrant[];
 }
-/** Every FIXED proficiency/language a character's entities grant, each paired
- *  with the display name of the entity that granted it. Walk order is
- *  class → race → background → feats, and that order defines `sources` ordering
- *  downstream (spec §4.1).
- *
- *  This module is a LEAF on purpose: it must import nothing from the decision
- *  engine module, so that the engine can import it without a cycle. NOT enforced
- *  by any test or lint rule · a previous comment claimed a grep guard that has
- *  never existed. It is a convention, and this phase adds a feature-effects
- *  import that is cycle-free by inspection, not by tooling.
- *  The walk returns raw `{value, source}` buckets and nothing else · no
- *  humanizing, no sorting, no dedupe. Label composition stays with the
- *  module-private `prettyName` in `pc.proficiencies.ts` (spec §7.1). */
 export declare function collectProficiencyGrants(resolved: ResolvedCharacter): ProficiencyGrants;

package/dist/pc/pc.proficiency-normalize.d.ts

@@ -1,29 +1,8 @@
-/** Normalized token-set key for matching class weapon DISPLAY names ("hand crossbows")
- *  against weapon-entity names ("Crossbow, hand"). EXACT equality on the key; verified
- *  collision-free across the SRD weapon set. Strip-"s" singularizer does not handle
- *  irregular plurals; no SRD weapon triggers that. */
 export declare const normKey: (s: string) => string;
-/** Canonical proficiency slug: lowercase, curly apostrophe folded to ASCII,
- *  whitespace collapsed to hyphens. Universally idempotent (one pass removes all
- *  whitespace) and the IDENTITY over ALL_SKILL_SLUGS / ALL_LANGUAGES / ALL_TOOLS,
- *  which are already canonical. The fold list is deliberately U+2019-only: no SRD
- *  tool name contains any other non-ASCII character. */
 export declare const toProfSlug: (s: string) => string;
-/** Apostrophe-safe title case: capitalizes only at start-of-string or after
- *  whitespace, never after `'` (so "smith's-tools" reads "Smith's Tools", not
- *  "Smith'S Tools"). Intentionally the same body as the plugin's humanizeSlug.
- *  The divergence that matters is one level up: prettyName is
- *  humanizeProficiency(toProfSlug(x)), and the U+2019 fold lives in toProfSlug.
- *  Do NOT "simplify" prettyName to a bare humanizer call · that reintroduces
- *  the duplicate-row defect (one proficiency rendering as two rows). */
 export declare const humanizeProficiency: (s: string) => string;
-/** The display label for one AUTHORED proficiency value that no vocabulary canonicalizes (R4-G7 T8 RIDER-14).
- *  The rule reads the value's SHAPE, never a word list:
- *  - a value with no whitespace is a slug ("thieves'-tools", "heavy"), and a phrase with no uppercase letter
- *    ("hand crossbows") carries no authored casing and shares its slug's `toProfSlug` key: both keep today's
- *    `humanizeProficiency(toProfSlug(raw))` (the fold and the apostrophe rule of the composition above);
- *  - a phrase that carries authored uppercase is PROSE ("Martial weapons that have the Light property",
- *    "... the 2H or H property") and prints as authored: U+2019 folded to ASCII, whitespace trimmed and collapsed,
- *    the first character capitalised, every other letter untouched. Title-casing it word by word lower-cased
- *    `2H` to `2h` and read "That Have The Light Property". */
 export declare const proficiencyLabel: (raw: string) => string;
+export type ProficiencyKind = "armor" | "weapons" | "tools" | "languages";
+export declare const weaponProfKey: (raw: string) => string;
+export declare const armorProfKey: (raw: string) => string;
+export declare const proficiencyKey: (kind: ProficiencyKind, raw: string) => string;

package/dist/pc/pc.proficiency-normalize.js

@@ -1,12 +1 @@
-import {
-  humanizeProficiency,
-  normKey,
-  proficiencyLabel,
-  toProfSlug
-} from "../chunk-RLGQ5PZZ.js";
-export {
-  humanizeProficiency,
-  normKey,
-  proficiencyLabel,
-  toProfSlug
-};
+import{armorProfKey,humanizeProficiency,normKey,proficiencyKey,proficiencyLabel,toProfSlug,weaponProfKey}from"../chunk-VTQ4RWEG.js";export{armorProfKey,humanizeProficiency,normKey,proficiencyKey,proficiencyLabel,toProfSlug,weaponProfKey};

package/dist/pc/pc.proficiency-query.d.ts

@@ -6,19 +6,6 @@ interface ProficienciesForQuery {
     weapons: ProficiencySet;
     tools: ProficiencySet;
 }
-/** NOT the live weapon gate · that is `isWeaponSlugProficient` in
- *  `pc.equipment.ts`, reached from `computeAttacks`. The two are near-twins,
- *  NOT aliases: that function's docblock records where their matching diverges,
- *  so anything asserting runtime behaviour must call it, not this one. */
 export declare function isProficientWithWeapon(weapon: WeaponEntity, profs: ProficienciesForQuery): boolean;
-/** No live armor gate exists at all · nothing in the product gates on armor
- *  proficiency today (`computeAppliedBonuses` takes `_profs` and ignores it),
- *  so this has no production caller either. Do NOT read that as "the
- *  `.specific` branch is dead": `normalizeArmorProf` in `pc.recalc.ts` routes
- *  an authored `armor: { specific: [...] }` block straight into it. No SRD
- *  entity uses that object form for armor yet, but `weapons:` and `tools:`
- *  already do in the same `proficiencies:` block, so it is one plausible
- *  keystroke away · and the function is published API besides. Trimming that
- *  branch could silently regress either. */
 export declare function isProficientWithArmor(armor: ArmorEntity, profs: ProficienciesForQuery): boolean;
 export {};