@archivist-gg/dnd5e 0.3.19 → 0.3.26

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

@@ -12,10 +12,6 @@ export interface Spell {
     casting_time?: string;
     range?: string;
     components?: string;
-    /** D2b-B: the converter's structured material component (`components.m` as an object), kept beside the `components` string,
-     *  which cannot carry its numbers: `cost` in copper pieces as authored (5etools), `consume` true or a word ("optional").
-     *  Absent for a string `components`, a bare `m: true` or a string `m`. A PARSE output only, never a YAML key: the codec
-     *  drops it on serialize. */
     material?: SpellMaterial;
     duration?: string;
     concentration?: boolean;
@@ -26,9 +22,6 @@ export interface Spell {
     damage?: {
         types: string[];
     };
-    /** The BASE roll: the roll at the spell's own level, or a cantrip's tier-1 roll (before its first
-     *  `player_level_<N>` option). Like `casting_options[].damage_roll` it also carries healing rolls
-     *  (Cure Wounds `2d8`). Mirrors Open5e v2's top-level `damage_roll`. */
     damage_roll?: string;
     saving_throw?: {
         ability: string;

package/dist/srd/retired-items.d.ts

@@ -1,14 +1,10 @@
 export interface RetiredItem {
     retired_slug: string;
     retired_name: string;
-    /** The bundle-relative note path the retired record shipped at (dnd5e 0.3.12). */
     retired_path: string;
     kept_slug: string;
     kept_name: string;
 }
 export declare const RETIRED_ITEMS: readonly RetiredItem[];
-/** The kept slug for a retired item slug, or undefined. */
 export declare function keptSlugFor(slug: string): string | undefined;
-/** The kept slug for an UNWRAPPED link target: a slug, or a compendium path (`SRD 5e/Magic Items/Hand Crossbow +2`), read
- *  the way `resolveBaseItem` reads one. A vault-root path (`Compendium/SRD 5e/...`) never resolved and is left alone. */
 export declare function keptSlugForLink(target: string): string | undefined;

package/dist/srd/retired-items.js

@@ -1,11 +1 @@
-import {
-  RETIRED_ITEMS,
-  keptSlugFor,
-  keptSlugForLink
-} from "../chunk-CM5CWO4K.js";
-import "../chunk-ZCTUYGNV.js";
-export {
-  RETIRED_ITEMS,
-  keptSlugFor,
-  keptSlugForLink
-};
+import{RETIRED_ITEMS,keptSlugFor,keptSlugForLink}from"../chunk-PZ4L2EEG.js";import"../chunk-63YJPWTM.js";export{RETIRED_ITEMS,keptSlugFor,keptSlugForLink};

package/dist/srd-store.d.ts

@@ -7,47 +7,14 @@ export interface SrdEntity {
 export type SrdEntityType = "monster" | "spell" | "item" | "armor" | "weapon" | "feat" | "condition" | "class" | "subclass" | "background" | "race" | "optional-feature";
 export type SrdDataSources = Record<string, Record<string, unknown>[]>;
 export declare class SrdStore {
-    /** slug -> SrdEntity for O(1) lookup */
     private bySlug;
-    /** entityType -> SrdEntity[] for type-scoped operations */
     private byType;
-    /**
-     * Load entities from a map of source-key -> raw JSON arrays.
-     * Source keys are resolved through TYPE_MAP (e.g. "monster" -> "monster",
-     * "magicitems" -> "item"). If a key is not in TYPE_MAP it is used as-is.
-     */
     loadFromData(sources: SrdDataSources): void;
-    /**
-     * Load all bundled SRD JSON files from the canonical pipeline runtime.
-     * Both 2014 and 2024 editions are merged into a single store; entities are
-     * disambiguated by their edition-prefixed slugs (e.g. "srd-5e_aboleth" vs
-     * "srd-2024_aboleth").
-     */
     loadFromBundledJson(): void;
-    /**
-     * O(1) lookup by slug.
-     */
     getBySlug(slug: string): SrdEntity | undefined;
-    /**
-     * Ranked search: exact match > starts-with > contains.
-     * Case-insensitive. Optionally filtered by entityType.
-     */
     search(query: string, entityType?: string, limit?: number): SrdEntity[];
-    /**
-     * Return all entities of a given type.
-     */
     getAllOfType(entityType: string): SrdEntity[];
-    /**
-     * Return all registered entity type strings.
-     */
     getTypes(): string[];
-    /**
-     * Total number of entities across all types.
-     */
     count(): number;
-    /**
-     * @deprecated Use getBySlug() instead. Kept for backward compatibility.
-     * Exact name match (case-insensitive). Searches all types or a specific type.
-     */
     getByName(name: string, entityType?: string): SrdEntity | null;
 }

package/dist/subclass/subclass.codec.d.ts

@@ -1,11 +1,3 @@
 import type { DocCodec } from "@archivist-gg/core";
 import type { SubclassEntity } from "./subclass.types.js";
-/**
- * Normalizing codec (0c.1a). `parse` delegates to `parseSubclass`, which validates
- * against `subclassEntitySchema`. `subclass.types` is this entity's dnd5e home for
- * `SubclassEntity` (consumed by the PC resolver/types); its `Edition`/`SubclassSpellcastingConfig`
- * imports resolve dnd5e-internally from `class.types`. `serialize` stays `yaml.dump`
- * (the edit-save path uses obsidian's separate serializer; gate (d) verifies `yaml.dump`
- * round-trips through `parseSubclass`).
- */
 export declare const subclassCodec: DocCodec<SubclassEntity>;

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-RHIEOYDX.js";import"../chunk-ETDMOGFO.js";import"../chunk-ONCXJMJM.js";import"../chunk-S5UCI27C.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-NIWLD33X.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-LHH5XSEA.js";import"../chunk-ZVL5FXXO.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-ETDMOGFO.js";import"../chunk-ONCXJMJM.js";import"../chunk-S5UCI27C.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-NIWLD33X.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-LHH5XSEA.js";import"../chunk-ZVL5FXXO.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-ONCXJMJM.js";import"../chunk-GCYUCIDN.js";import"../chunk-X22SISGM.js";import"../chunk-NIWLD33X.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-LHH5XSEA.js";import"../chunk-ZVL5FXXO.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,7 @@
 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" | "heavy" | "pact-weapon";
+export type SpeedGateWord = "heavy-armor" | "armor" | "shield";
 export interface SpellScope {
     list?: string;
     level?: number;
@@ -22,23 +11,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[];
@@ -67,12 +49,17 @@ export type FeatureEffect = ({
 } & Qualified) | ({
     kind: "speed-bonus";
     mode: "walk" | "fly" | "swim" | "climb" | "burrow";
-    value: number;
+    value?: number;
+    equal_to?: "walk";
     set?: boolean;
     scales_at?: {
         level: number;
         value: number;
     }[];
+    inactive_while?: SpeedGateWord | SpeedGateWord[];
+} & Qualified) | ({
+    kind: "speed-rule";
+    flag: "ignore-armor-strength";
 } & Qualified) | ({
     kind: "attunement-limit";
     value: number;
@@ -139,6 +126,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;
 }