@archivist-gg/dnd5e 0.3.19 → 0.3.24

package/dist/subclass/subclass.codec.js

@@ -1,17 +1 @@
-import {
-  subclassCodec
-} from "../chunk-NZO7M5GV.js";
-import "../chunk-UNYR5GLI.js";
-import "../chunk-LNT64X7C.js";
-import "../chunk-4U55VNC7.js";
-import "../chunk-G6MHJDVT.js";
-import "../chunk-CJYCVNW2.js";
-import "../chunk-B2QHP6UF.js";
-import "../chunk-WYGD2UGN.js";
-import "../chunk-ZJXSXVFP.js";
-import "../chunk-OOL4KMG2.js";
-import "../chunk-JXWNXIIZ.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  subclassCodec
-};
+import{subclassCodec}from"../chunk-7AKJBRBD.js";import"../chunk-TLXFGGWH.js";import"../chunk-7J5BNH2D.js";import"../chunk-S5UCI27C.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-V6NQ547U.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-KBFSJ5WE.js";import"../chunk-6IC53O3Q.js";import"../chunk-I26FHSI6.js";export{subclassCodec};

package/dist/subclass/subclass.parser.js

@@ -1,16 +1 @@
-import {
-  parseSubclass
-} from "../chunk-UNYR5GLI.js";
-import "../chunk-LNT64X7C.js";
-import "../chunk-4U55VNC7.js";
-import "../chunk-G6MHJDVT.js";
-import "../chunk-CJYCVNW2.js";
-import "../chunk-B2QHP6UF.js";
-import "../chunk-WYGD2UGN.js";
-import "../chunk-ZJXSXVFP.js";
-import "../chunk-OOL4KMG2.js";
-import "../chunk-JXWNXIIZ.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  parseSubclass
-};
+import{parseSubclass}from"../chunk-TLXFGGWH.js";import"../chunk-7J5BNH2D.js";import"../chunk-S5UCI27C.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-V6NQ547U.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-KBFSJ5WE.js";import"../chunk-6IC53O3Q.js";import"../chunk-I26FHSI6.js";export{parseSubclass};

package/dist/subclass/subclass.schema.d.ts

@@ -15,7 +15,7 @@ export declare const subclassEntitySchema: z.ZodObject<{
             full: "full";
             pact: "pact";
             third: "third";
-            artificer: "artificer";
+            "half-up": "half-up";
         }>>;
         ability: z.ZodEnum<{
             str: "str";
@@ -66,6 +66,7 @@ export declare const subclassEntitySchema: z.ZodObject<{
             band: "band";
             tab: "tab";
         }>>;
+        equivalent_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
         recovery: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;

package/dist/subclass/subclass.schema.js

@@ -1,14 +1 @@
-import {
-  subclassEntitySchema
-} from "../chunk-LNT64X7C.js";
-import "../chunk-G6MHJDVT.js";
-import "../chunk-CJYCVNW2.js";
-import "../chunk-B2QHP6UF.js";
-import "../chunk-WYGD2UGN.js";
-import "../chunk-ZJXSXVFP.js";
-import "../chunk-OOL4KMG2.js";
-import "../chunk-JXWNXIIZ.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  subclassEntitySchema
-};
+import{subclassEntitySchema}from"../chunk-7J5BNH2D.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-V6NQ547U.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-KBFSJ5WE.js";import"../chunk-6IC53O3Q.js";import"../chunk-I26FHSI6.js";export{subclassEntitySchema};

package/dist/subclass/subclass.types.d.ts

@@ -18,12 +18,10 @@ export interface SubclassEntity {
     selection_pools?: SelectionPool[];
     pool_grants?: PoolGrant[];
     tabs?: TabDecl[];
-    /** Converter/bundle extras declared by subclass.schema.ts §2.7; all optional, none read today. */
     rendering_hint?: string;
     short_name?: string;
     has_fluff?: boolean;
     has_fluff_images?: boolean;
-    /** RAW 5etools passthrough (single measured key-set `{_subclassFluff:{…}}`): mirrors `z.unknown()`. */
     fluff?: unknown;
     table_col_labels?: string[];
     cantrip_progression?: number[];
@@ -33,6 +31,5 @@ export interface SubclassEntity {
     feat_progression?: ProgressionEntry[];
     optionalfeature_progression?: ProgressionEntry[];
     additional_spells?: AdditionalSpellsEntry[];
-    /** One wikilink, or an array of them for the multi-fluff-image emit. */
     image?: string | string[];
 }

package/dist/types/attack.d.ts

@@ -19,4 +19,6 @@ export interface Attack {
     properties?: string[];
     range?: AttackRange;
     condition?: string;
+    weapon_category?: "simple" | "martial";
+    mastery?: string;
 }

package/dist/types/casting-option.d.ts

@@ -1,7 +1,3 @@
-/** A single alternate casting mode for a spell (e.g. a different shape, range,
- *  or scaling). Lives in dnd5e so the build-time SRD spell merger can consume
- *  it without a tools→obsidian reverse edge; obsidian `spell.types` re-exports
- *  it for the renderer/parser. */
 export interface CastingOption {
     type: string;
     damage_roll?: string;

package/dist/types/choice.d.ts

@@ -3,107 +3,38 @@ import type { FeatureEffect } from "./feature-effect.js";
 export type Ability = keyof Abilities;
 export type SkillSlug = "acrobatics" | "animal-handling" | "arcana" | "athletics" | "deception" | "history" | "insight" | "intimidation" | "investigation" | "medicine" | "nature" | "perception" | "performance" | "persuasion" | "religion" | "sleight-of-hand" | "stealth" | "survival";
 export declare const ALL_SKILL_SLUGS: SkillSlug[];
-/** The language vocabulary the engine matches every language grant and pick
- *  against: 8 standard + 8 exotic + 2 SECRET. It is NOT "the SRD language set" —
- *  the two secret languages are class-taught and appear on no SRD language list.
- *  Slugs are edition-agnostic, apostrophe-retaining and canonical under
- *  `toProfSlug`, exactly as ALL_TOOLS is.
- *
- *  A cross-repo CONTRACT with three kinds of consumer, so widening this list is a
- *  data change at all three · named by symbol, because line cites rot:
- *   · the SRD GENERATOR: `race-merge.ts` builds `KNOWN_LANGUAGES = new Set(ALL_LANGUAGES)`
- *     and `extractLanguagesFromTraits` gates species prose tokens through it, so
- *     this constant is INPUT DATA to canonical species output. That name belongs
- *     to the generator and to nothing else. Guarded by
- *     `tests/srd-canonical/merger-rules/srd-race-languages.test.ts`.
- *   · the ENGINE: `enumerateOptions` uses it as the from-less `domain:"language"`
- *     picker pool, and `computeEffectiveProficiencies` canonicalizes grants, picks
- *     and manual adds against it through `pc.decision-engine.ts`'s one canonical
- *     comparison, `matchPool` — a module-level helper it shares with its other call
- *     sites, not one of its own. `computeEffectiveProficiencies` reads ALL_LANGUAGES
- *     from HERE, directly — it does not go through the generator's KNOWN_LANGUAGES.
- *   · the PLUGIN: `proficiency-picker.ts` (D4 A) lists STANDARD, EXOTIC ("Rare") and
- *     SECRET_LANGUAGES as its Languages rows, plus any held or removed value they miss.
- *  Membership is also what makes two spellings of one language FOLD onto a single
- *  row: a vocabulary MISS keys on the raw string and splits the row in two. */
 export declare const STANDARD_LANGUAGES: string[];
 export declare const EXOTIC_LANGUAGES: string[];
-/** Secret languages: granted by a class feature (Druid, Rogue), never carried by a
- *  race or background language list. `thieves'-cant` RETAINS the ASCII apostrophe —
- *  the file's stated convention, and the slug `toProfSlug` already produces from
- *  both live spellings (the converter's `Thieves' Cant` and the 2014 SRD prose's
- *  U+2019 form). */
 export declare const SECRET_LANGUAGES: string[];
 export declare const ALL_LANGUAGES: string[];
-/** The SRD tool set: 17 artisan's tools + 10 musical instruments + 2 gaming sets
- *  + 6 other tools = 35. Like ALL_LANGUAGES this is a SINGLE edition-agnostic
- *  list covering 2014 and 2024, and where the two editions name the same tool
- *  differently the 2024 name wins. Across all 35 entries there is exactly one
- *  such delta: `Playing Card Set` (2014) vs `Playing Cards` (2024), resolved
- *  here to "playing-cards".
- *
- *  Apostrophes are RETAINED ("thieves'-tools", "calligrapher's-supplies").
- *  These are the slugs the product already emits · see
- *  `tools/srd-canonical/merger-rules/background-merge.ts`, whose output is live
- *  in `background.2024.json` · and humanizeProficiency is apostrophe-safe.
- *  Stripping the apostrophes would diverge from that live data and CREATE the
- *  collision it would claim to avoid.
- *
- *  Every entry is already canonical under toProfSlug (identity) and the set is
- *  collision-free under it. Ordering is alphabetical within each subset, and
- *  ALL_TOOLS composes the four subsets in that order, mirroring
- *  ALL_LANGUAGES = STANDARD + EXOTIC + SECRET. The list is a cross-repo contract: a
- *  one-entry divergence is silent and permanent, so it is pinned verbatim. */
 export declare const ARTISANS_TOOLS: string[];
 export declare const MUSICAL_INSTRUMENTS: string[];
 export declare const GAMING_SETS: string[];
 export declare const OTHER_TOOLS: string[];
 export declare const ALL_TOOLS: string[];
 export type FeatCategory = "origin" | "general" | "fighting-style" | "epic-boon";
-/** Closed, enumerated registry filter — YAML can never express a query the
- *  engine would apply unsafely. `"self"` resolves against the owning
- *  class/subclass at ledger-build time. */
 export interface EntityFilter {
     feature_type?: string;
     category?: string;
     parent_class?: "self";
     available_to?: "self";
-    /** Weapon proficiency class. Matched against a weapon entity's compound
-     *  `category` (e.g. "martial-melee") by prefix, so "martial" covers both
-     *  martial-melee and martial-ranged. */
     weapon_category?: "simple" | "martial";
-    /** Armor proficiency class. Matched against an armor entity's `category`
-     *  field exactly; "shield" selects shields. */
     armor_category?: "light" | "medium" | "heavy" | "shield";
-    /** Item axis: an item entity's `type` ("instrument", "artisan's tools", "gaming set"); ANY listed type matches.
-     *  Compared case-insensitively with apostrophes, separators and a plural "s" folded (`categoryWords` in
-     *  pc.tool-picks.ts), so "artisans tools" matches "artisan's tools". A starting-equipment tool category
-     *  (`musical-instrument`, `artisan's-tools`, `gaming-set`, or an `X-or-Y` union of them) sets it. */
     item_type?: string[];
-    /** Item axis: true keeps only MUNDANE items, dropping one whose `rarity` names a magic tier. Starting gear sets
-     *  it, because magic instruments (Instrument of Scribing, +3 Rhythm-Maker's Drum) also carry `type: instrument`. */
     mundane?: boolean;
-    /** Spell axis: filter spells by class list, level, and edition. Set together on a
-     *  select-entity{entity_type:"spell"} choice (e.g. Magic Initiate). */
     list?: string;
     level?: number;
     edition?: string;
-    /** D2b-A: true keeps only spells a note marks `ritual` (Pact of the Tome's rituals). */
     ritual?: boolean;
+    inventory?: boolean;
 }
 export interface InlineOption {
     value: string;
     label: string;
     description?: string;
-    /** Applied via a synthesized resolved feature when the option is selected. */
     effects?: FeatureEffect[];
-    /** Nested decisions revealed when this option is selected (recursive). */
     choices?: Choice[];
 }
-/** The four game-agnostic decision primitives. All game knowledge (which
- *  options, which counts) lives in data — authored in the SRD overlay or
- *  inline in homebrew entity notes. `id` is the persistence key under
- *  `ClassEntry.choices[level]` / `Character.origin_choices`. */
 export type Choice = {
     kind: "select-inline";
     id: string;
@@ -118,8 +49,6 @@ export type Choice = {
     entity_type: string;
     from?: string[];
     where?: EntityFilter;
-    /** D2b-A: the pick names a TARGET (the cantrip a blast invocation's rider reaches), not a grant: nothing it picks
-     *  becomes the character's own (a spell, a feat, a feature). */
     target?: true;
 } | {
     kind: "select-proficiency";

package/dist/types/choice.js

@@ -1,24 +1 @@
-import {
-  ALL_LANGUAGES,
-  ALL_SKILL_SLUGS,
-  ALL_TOOLS,
-  ARTISANS_TOOLS,
-  EXOTIC_LANGUAGES,
-  GAMING_SETS,
-  MUSICAL_INSTRUMENTS,
-  OTHER_TOOLS,
-  SECRET_LANGUAGES,
-  STANDARD_LANGUAGES
-} from "../chunk-KU3YLF6D.js";
-export {
-  ALL_LANGUAGES,
-  ALL_SKILL_SLUGS,
-  ALL_TOOLS,
-  ARTISANS_TOOLS,
-  EXOTIC_LANGUAGES,
-  GAMING_SETS,
-  MUSICAL_INSTRUMENTS,
-  OTHER_TOOLS,
-  SECRET_LANGUAGES,
-  STANDARD_LANGUAGES
-};
+import{ALL_LANGUAGES,ALL_SKILL_SLUGS,ALL_TOOLS,ARTISANS_TOOLS,EXOTIC_LANGUAGES,GAMING_SETS,MUSICAL_INSTRUMENTS,OTHER_TOOLS,SECRET_LANGUAGES,STANDARD_LANGUAGES}from"../chunk-4JEF3CET.js";export{ALL_LANGUAGES,ALL_SKILL_SLUGS,ALL_TOOLS,ARTISANS_TOOLS,EXOTIC_LANGUAGES,GAMING_SETS,MUSICAL_INSTRUMENTS,OTHER_TOOLS,SECRET_LANGUAGES,STANDARD_LANGUAGES};

package/dist/types/edition.d.ts

@@ -1,4 +1 @@
-/** The two D&D 5e rules editions Archivist canonicalizes content for.
- *  Single source of truth — obsidian `class.types` and the dnd5e entity
- *  types both import it from here. */
 export type Edition = "2014" | "2024";

package/dist/types/equipment-grant.d.ts

@@ -1,14 +1,4 @@
-/** One thing a starting-equipment option grants. `item` is a BARE compendium
- *  slug (e.g. "chain-mail"); the seeder resolves it to the full edition slug.
- *  `category` is a player-picked class of item ("martial-weapon",
- *  "simple-weapon", "martial-melee-weapon", "any-armor", "shield",
- *  "musical-instrument", "artisan's-tools", "gaming-set", a tool `X-or-Y` union;
- *  the vocabulary is `categoryToEntitySelect`'s in pc.decision-engine.ts) resolved
- *  by a nested select-entity. `gold` is gp folded into the bundle. */
-export type EquipmentGrant = 
-/** `contains_value` (COPPER; `1500` = 15 gp) is seeded as gold by the plugin's starting-equipment seeder
- *  (R4-G3b §9); `worth_value` is never seeded; `display_name` is read by grantLabel. */
-{
+export type EquipmentGrant = {
     item: string;
     qty?: number;
     contains_value?: number;
@@ -21,30 +11,16 @@ export type EquipmentGrant =
 } | {
     gold: number;
 };
-/** THE rule for which grant is a player-picked CATEGORY: an object whose `category` is a non-empty string. Shared by
- *  the engine's nested-pick synthesis and the plugin's seeder, so the nth category grant of an option always
- *  consumes the nth pick key and the two can never count a malformed grant differently. */
 export declare function isCategoryGrant(g: unknown): g is Extract<EquipmentGrant, {
     category: string;
 }>;
-/** The persistence key of the nested pick for grant `k` of option `j` of starting-equipment entry `i`: the one
- *  spelling the engine emits and the plugin reads. `k` indexes the option's WHOLE grant list, not its category
- *  grants alone. */
 export declare const equipmentCategoryKey: (i: number, j: number, k: number) => string;
-/** The ORDERED pick keys of one option's category grants, the order `resolveGrants` consumes them in. */
 export declare const equipmentCategoryKeys: (grants: readonly unknown[], i: number, j: number) => string[];
-/** True for a starting-equipment decision key (`equipment-<i>` and its nested picks). The Equipment step owns
- *  these; every other step's decision strip leaves them out. */
 export declare const isStartingEquipmentKey: (key: string) => boolean;
-/** One selectable option of a `kind:"choice"` starting-equipment entry. `label`
- *  is the human display string (the `.pc-cb-eqopt` text); `grants` is what seeds. */
 export interface EquipmentOption {
     label: string;
     grants: EquipmentGrant[];
 }
-/** Structured starting equipment. Shared by class + background. A `fixed` entry
- *  may carry a `label` for the un-parsed (prose fallback) case where `grants`
- *  is empty — it then displays but seeds nothing (graceful degradation). */
 export type StartingEquipmentEntry = {
     kind: "choice";
     options: EquipmentOption[];
@@ -56,8 +32,6 @@ export type StartingEquipmentEntry = {
     kind: "gold";
     amount: number;
 };
-/** Buy-with-Gold budget. `fixed` gp (2024) or a `dice`×`multiplier` roll (2014
- *  "XdY × 10"); average is derived by the consumer. */
 export interface StartingGold {
     fixed?: number;
     dice?: string;

package/dist/types/equipment-grant.js

@@ -1,12 +1 @@
-import {
-  equipmentCategoryKey,
-  equipmentCategoryKeys,
-  isCategoryGrant,
-  isStartingEquipmentKey
-} from "../chunk-2LULMQTF.js";
-export {
-  equipmentCategoryKey,
-  equipmentCategoryKeys,
-  isCategoryGrant,
-  isStartingEquipmentKey
-};
+import{equipmentCategoryKey,equipmentCategoryKeys,isCategoryGrant,isStartingEquipmentKey}from"../chunk-2EOGK6R6.js";export{equipmentCategoryKey,equipmentCategoryKeys,isCategoryGrant,isStartingEquipmentKey};

package/dist/types/feature-effect.d.ts

@@ -1,18 +1,6 @@
 import type { Ability } from "./choice.js";
 export type SenseType = "darkvision" | "blindsight" | "tremorsense" | "truesight";
-/** A damage rider's weapon scope, the `damage-bonus` arm's structured `applies_to` words (ART-c1 Task 9b, controller
- *  ruling 8): `melee` and `ranged` are the weapon's CATEGORY (a thrown melee weapon stays melee), `unarmed` the engine's
- *  Unarmed Strike row, `finesse` and `thrown` the row's properties, and `weapon` every attack row (today's reach, the
- *  Unarmed Strike row included). A list reaches a row when ANY word matches it. */
-export type WeaponScope = "weapon" | "melee" | "ranged" | "unarmed" | "finesse" | "thrown";
-/** A spell damage rider's spell scope, the `damage-bonus` arm's `spell_scope` (found 2026-09-29: Potent Spellcasting,
- *  Empowered Evocation, Elemental Affinity and Radiant Soul said which spells they reach only in prose, so they reached
- *  none). The rider reaches a character's spell that DEALS DAMAGE when every word it carries matches: `list` the spell is
- *  on that class's list, `level` its exact level (0 = cantrip), `school` its school, `damage_types` it deals ANY of them,
- *  `damage_type_pick` it deals the damage type the character chose at that `select-inline` (its option value or a type
- *  named in its label, "Red (Fire)"), `spells` it is one of these (a name or a slug). `once`: the rider adds to ONE damage
- *  roll of the casting, however many rolls or targets the spell has ("one damage roll of that spell"). Read with
- *  `applies_to: spell` or `all`; `all` with no scope reaches every damaging spell. */
+export type WeaponScope = "weapon" | "melee" | "ranged" | "unarmed" | "finesse" | "thrown" | "pact-weapon";
 export interface SpellScope {
     list?: string;
     level?: number;
@@ -22,23 +10,16 @@ export interface SpellScope {
     spells?: string[];
     once?: boolean;
 }
-/** Present on every arm: whose numbers the effect changes. Absent === "self". The engine's fold readers skip
- *  every effect whose subject is present and not "self" (`foldsOnSelf` in pc.feature-effects.ts). */
 type Subject = {
     subject?: string;
 };
-/** A prose qualifier, carried for display; on `apply-condition` and `immune-condition` the `condition` key is the
- *  condition NAME instead, so those two arms do not carry this qualifier. */
 type Qualified = {
     condition?: string;
 } & Subject;
-/**
- * Hand-written MIRROR of `featureEffectSchema` (schemas/feature-effect-schema.ts). The two are cross-checked at the
- * four parser returns and by `_kindPin` in the schema file; edit both in the same commit.
- */
 export type FeatureEffect = ({
     kind: "initiative-bonus";
-    value: number;
+    value?: number;
+    amount?: string;
 } & Qualified) | ({
     kind: "skill-bonus";
     skills: string[];
@@ -139,6 +120,7 @@ export type FeatureEffect = ({
         level: number;
         count: number;
     }[];
+    applies_to?: WeaponScope | WeaponScope[];
 } & Qualified) | ({
     kind: "reroll-damage";
     max_reroll: number;

package/dist/types/feature.d.ts

@@ -3,24 +3,10 @@ import type { Resource, ResourceConsumption, ActionCost } from "./resource.js";
 import type { Attack } from "./attack.js";
 import type { FeatureEffect } from "./feature-effect.js";
 import type { Duration } from "../schemas/duration-schema.js";
-/**
- * Recharge / per-day usage limits on a Feature (e.g. monster action).
- *
- * - `recharge_on_roll`: at the start of each turn, recharges on a d6 roll
- *   ≥ `param`. Renders as "Recharge {param}-6" (or "Recharge 6" when param=6).
- * - `per_day`: usable `param` times per day. Renders as "{param}/Day".
- * - `per_short_rest` / `per_long_rest`: usable `param` times per rest.
- */
 export interface FeatureRecharge {
     type: "recharge_on_roll" | "per_day" | "per_short_rest" | "per_long_rest";
     param: number;
 }
-/** The converter's 14-key companion binding (R4-G5 §7, ruling G5-UR2 "declare now, card after the G7 re-emit").
- *  DECLARED, not read: the converter withholds the key today (`P9_NOT_EMITTED_FIELDS`), 0 converted and 0 bundle
- *  notes carry it, and the Passive-tab card is a G8 booking. Every closed-vocabulary leaf is a plain `string` and
- *  every position the converter can emit as null is `| null`, for the reason the schema mirror states: a class,
- *  subclass or race parser refuses a WHOLE document on one nested leaf failure, so a mirror stricter than the
- *  emitter is a total-loss risk on the day the re-emit lands. */
 export interface FeatureCompanion {
     statblock?: string;
     statblock_wikilink?: string | null;
@@ -81,15 +67,10 @@ export interface Feature {
     sub_features?: Feature[];
     resources?: Resource[];
     recharge?: FeatureRecharge;
-    /** Phase 3 activatable buffs: when true, the feature's effects fold only while
-     *  its `id` is present in `Character.state.active_buffs` (toggled in the UI). */
     activatable?: boolean;
-    /** Always-on marker; renders a "Passive" tag. */
     passive?: boolean;
-    /** How long the buff lasts; rendered as a static label (no live countdown). */
     duration?: Duration;
     class_source?: string;
-    /** Always "" on every measured carrier — never constrain it non-empty. */
     rendering_hint?: string;
     subclass_short_name?: string;
     subclass_source?: string;
@@ -97,14 +78,11 @@ export interface Feature {
     is_class_feature_variant?: boolean;
     gain_subclass_feature?: boolean;
     gain_subclass_feature_has_content?: boolean;
-    /** 5etools entry type; values {"inset","item"}. */
     type?: string;
     action_cost?: ActionCost;
     save?: {
         ability: string;
         dc_formula: string;
     };
-    /** The companion this feature binds (R4-G5 §7). Declared so the class / subclass / race parsers stop stripping
-     *  it on the day the G7 re-emit lands; nothing reads it in G5. */
     companion?: FeatureCompanion;
 }

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

@@ -4,13 +4,7 @@ import type { ActionCost, ResetTrigger, ResourceConsumption } from "./resource.j
 import type { Duration } from "../schemas/duration-schema.js";
 import type { Edition } from "./edition.js";
 import type { AdditionalSpellsEntry, ProgressionEntry } from "../schemas/entity-extras-schema.js";
-/**
- * Documentation-only union of the canonical SRD feature types. The
- * `feature_type` field is now an open string (see {@link OptionalFeatureEntity})
- * so homebrew categories parse; this union is kept purely as a reference list.
- */
-export type OptionalFeatureKind = "invocation" | "fighting_style" | "metamagic" | "maneuver" | "infusion" | "artificer_plan" | "pact_boon";
-/** A class/subclass named reference carried by a level prerequisite; mirrors namedRefSchema. */
+export type OptionalFeatureKind = "invocation" | "fighting_style" | "metamagic" | "maneuver" | "infusion" | "pact_boon";
 export type OptionalFeatureNamedRef = {
     name: string;
     source?: string;
@@ -46,7 +40,6 @@ export type OptionalFeaturePrerequisite = {
     entry?: string;
     entry_summary?: string;
 };
-/** ART-a (spec §4.2). */
 export interface FilterSpec {
     rarity: string[];
     types?: string[];
@@ -89,7 +82,6 @@ export interface InfuseItem {
         recharge_amount?: string;
     };
     action?: ActionCost;
-    /** ART-c1 (R-3 a): the Actions row's range ("Self"); absent draws no range. */
     range?: string;
 }
 export interface InfuseTarget {
@@ -121,53 +113,31 @@ export interface OptionalFeatureEntity {
     name: string;
     edition: Edition;
     source: string;
-    /** Open string category (e.g. "invocation"); see {@link OptionalFeatureKind} for canonical SRD values. */
     feature_type: string;
     description: string;
     prerequisites: OptionalFeaturePrerequisite[];
-    /** Wikilinks to classes/subclasses that can pick this option. */
     available_to: string[];
-    /** Mechanical effects mirrored on Feat — same shape. */
     effects: FeatureEffect[];
-    /** Optional action economy when the option grants an active ability. */
     action_cost?: ActionCost | null;
-    /** Optional uses tracker. */
     uses?: {
         max: number | string;
         recharge: ResetTrigger;
     } | null;
-    /** Resource cost to use this option (e.g. burn a Seal). */
     consumes?: ResourceConsumption | null;
-    /** How long the granted effect lasts (rendered as a label in Phase 2). */
     duration?: Duration | null;
-    /** Always-on marker; renders a "Passive" tag. */
     passive?: boolean;
-    /** Phase 3 activatable buffs: when true, the boon's effects fold only while its
-     *  slug is present in `Character.state.active_buffs` (toggled in the PoolTab). */
     activatable?: boolean;
-    /** Converter extras declared by optional-feature.schema.ts §2.5; all optional.
-     *  `rendering_hint` is the ONE of these whose VALUES are load-bearing (88 records carry a
-     *  real marker such as `dice-pool`); reading it is G4's row, declaring it is this one's. */
     rendering_hint?: string;
-    /** `band` = also drawn in the header strip. Absent/`tab` = the Resources tab only. */
     surface?: "band" | "tab";
     additional_spells?: AdditionalSpellsEntry[];
     is_class_feature_variant?: boolean;
     has_fluff_images?: boolean;
     feat_progression?: ProgressionEntry[];
     optionalfeature_progression?: ProgressionEntry[];
-    /** One wikilink, or an array of them for the multi-fluff-image emit. */
     image?: string | string[];
-    /** ART-a (spec §4.1): a pick is a COPY `<note slug>#<param>`; needs `options` and `item_choice`. */
     repeatable?: true;
-    /** `learn`: the param is the item's FULL slug (TCE); `create`: the param is a row key, the item chosen at Create (EFA). */
     item_choice?: "learn" | "create";
-    /** The table a copy's param must satisfy (spec §4.2). */
     options?: OptionRow[];
-    /** This member infuses an existing object; its effect is an item-vocabulary overlay (spec §4.2). */
     infuse?: InfuseBlock;
-    /** D2b-A (design §2.2 step 1): the member's OWN choices (Lessons of the First Ones' Origin feat, Superior Technique's
-     *  maneuver, Pact of the Tome's cantrips and rituals), in the same `Choice` vocabulary features and feats use. Absent,
-     *  the engine derives them from the raw keys the note already carries (`memberChoices`, `pc.member-choices.ts`). */
     choices?: Choice[];
 }

package/dist/types/resource.d.ts

@@ -1,5 +1,3 @@
-/** `either` = recovered by a short OR a long rest (R4-G3a §8.2; the 43 "short or
- *  long rest" rows). Kept in step with `resetTriggerEnum` in schemas/resource-schema.ts. */
 export type ResetTrigger = "short-rest" | "long-rest" | "either" | "dawn" | "dusk" | "turn" | "round" | "custom";
 export type ActionCost = "action" | "bonus-action" | "reaction" | "free" | "special";
 export interface ResourceDie {
@@ -13,17 +11,6 @@ export interface ResourceRecovery {
     action?: ActionCost;
     uses?: number;
     reset: ResetTrigger;
-    /** The recovery KIND; absent = `uses` (R4-G4 §7, UR2), applied by the RESOLVER
-     *  (pc/pc.resources.ts `resolveRecovery`) and never by a schema default, because
-     *  the sheet reads RAW entities. The CARRIERS, re-measured 2026-09-05 after R4-G4
-     *  T2b's regen shipped the bundle (this sentence was authored at T2, BEFORE that
-     *  regen, and said ZERO, which it no longer is): `grep -rl "restores:" --include='*.md'`
-     *  returns the TWO bundle Wizard notes (`SRD 2024/Classes/Wizard.md` and
-     *  `SRD 5e/Classes/Wizard.md`), whose Arcane Recovery rows T2b's overlay stamps
-     *  `spell-slots` and which §7.1 measured as the only spell-slot recoveries in shipped
-     *  data; the embedded `.compendium-bundle/index.json` carries the key on one line for
-     *  the same two rows; the converter corpus carries it on NO note. Kept in step with
-     *  `resourceSchema.recovery` in schemas/resource-schema.ts. */
     restores?: "uses" | "spell-slots";
 }
 export interface ResourceScaleStep {
@@ -41,24 +28,17 @@ export interface Resource {
     scales_at?: ResourceScaleStep[];
     die?: ResourceDie;
     reset: ResetTrigger;
-    /** Presentation, carried and never interpreted by the engine: which control draws this resource.
-     *  The renderer owns the hint → component table. */
     rendering_hint?: string;
-    /** `band` = also drawn in the header strip; absent = the Resources tab alone. */
     surface?: "band" | "tab";
     consumes?: ResourceConsumesLink;
     recovery?: ResourceRecovery[];
+    equivalent_ids?: string[];
 }
 export interface ResourceConsumption {
     source?: "resource" | "class-column" | "attack-dice" | "spell-slots";
     resource?: string;
     column?: string;
-    /** The MINIMUM spend when `amount_max` is present, otherwise the exact spend. */
     amount: number;
-    /** Upper bound of a RANGE spend (`amount` .. `amount_max`), int and positive.
-     *  DECLARED only in R4-G3a §9: zero emitted carriers, zero readers; spending a
-     *  range is G4's. Kept in step with `resourceConsumptionSchema` in
-     *  schemas/resource-schema.ts, whose refine is undefined-safe. */
     amount_max?: number;
     expend_condition?: "roll_succeeds" | "roll_fails" | "target_takes_damage" | "always";
     free_uses?: {

package/dist/types/selection-pool.d.ts

@@ -1,4 +1,3 @@
-/** ART-a (spec §4.5): the at-once counter of an item-bound pool; its defaults are applied at read (`poolActiveWords`). */
 export interface PoolActive {
     column: string;
     label: string;
@@ -7,8 +6,6 @@ export interface PoolActive {
     create_label?: string;
     create_verb?: string;
 }
-/** A (sub)class-declared selectable pool (e.g. Interdict Boons). The engine is
- *  generic: every game-specific string lives here in data, never in code. */
 export interface SelectionPool {
     id: string;
     label: string;
@@ -19,19 +16,14 @@ export interface SelectionPool {
             available_to: "self";
         };
     };
-    /** Pick count read from the owning class table column at the current level. `label` is the known-counter word,
-     *  read through `poolCountLabel` (absent reads "Known", ART-a spec §4.5). */
     count: {
         column: string;
         label?: string;
     };
     replaceable?: boolean;
-    /** ART-a (spec §4.5): the at-once counter (Infused Items, Magic Items). */
     active?: PoolActive;
-    /** ART-a (spec §4.5): a resource id the tab head shows when the pool spends none of its own. */
     head_resource?: string;
 }
-/** Subclass auto-grants that extend a named pool and do NOT count toward picks. */
 export interface PoolGrant {
     pool: string;
     grants: Array<{
@@ -39,24 +31,8 @@ export interface PoolGrant {
         at_level: number;
     }>;
 }
-/** Presentation hint for a data-declared tab. `dice-pool` / `point-pool` are DERIVED from the
- *  members' `rendering_hint` at resolve time onto `ResolvedPool.layout` (pc/pool-layout.ts), and that
- *  derivation is UNCONDITIONAL: it runs whether or not the declaration carries a `layout`. R4-G4 T5
- *  LANDED the precedence in the plugin: `TabsContainer`'s dynamic-pool-tab loop reads the AUTHORED
- *  value first, then `ResolvedPool.layout`. Since PT (spec §9) every pool tab draws one table and the value
- *  picks only the tab's HEAD (`poolPresentation`); `spell-like` and `blocks` still parse and are ignored.
- *  R4-G5 CLOSED that list, and NOT by adding values: `pool-selection` and `stance` never get a layout value
- *  (measured, spec §10: the three `stance`-hinted documents are field-identical to three unhinted siblings, and
- *  `pool-selection`'s meaning is delivered by `spell-like` plus the §5 head), and `granted-die-to-ally` is a
- *  PER-ROW affordance (`EntryAffordance` below), never a pool layout: mapping it here would bury four maneuvers
- *  under 39 on one vote of 43. This union keeps its four members and `RENDERING_HINT_LAYOUT` its two keys. */
 export type PoolLayout = "spell-like" | "blocks" | "dice-pool" | "point-pool";
-/** A PER-ENTRY affordance derived from ONE optional feature's own `rendering_hint` (R4-G5 §4.2.1). The sibling of
- *  `PoolLayout`, and deliberately not part of it: a layout is a POOL-level MAJORITY vote, so a hint carried by
- *  four of 43 maneuvers could never win one, and mapping it would be a monotone loss for the other 39. The table,
- *  the derivation and the caption live in `pc/pool-layout.ts`. ONE member today. */
 export type EntryAffordance = "granted-die";
-/** A data-declared tab that renders a pool (one generic pool-tab per declaration). */
 export interface TabDecl {
     id: string;
     label: string;

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

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