@archivist-gg/dnd5e 0.3.17 → 0.3.24

package/dist/schemas/feature-schema.js

@@ -1,12 +1 @@
-import {
-  featureObjectSchema,
-  featureSchema
-} from "../chunk-YD2VAHA6.js";
-import "../chunk-WYGD2UGN.js";
-import "../chunk-ZJXSXVFP.js";
-import "../chunk-5MXFW4O3.js";
-import "../chunk-2JSQE3DD.js";
-export {
-  featureObjectSchema,
-  featureSchema
-};
+import{featureObjectSchema,featureSchema}from"../chunk-V6NQ547U.js";import"../chunk-ZE46ADXS.js";import"../chunk-CCFIINBA.js";import"../chunk-KBFSJ5WE.js";import"../chunk-6IC53O3Q.js";export{featureObjectSchema,featureSchema};

package/dist/schemas/resource-schema.d.ts

@@ -47,6 +47,7 @@ export declare const resourceSchema: 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;
@@ -75,40 +76,6 @@ export declare const resourceSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
-/** A feature's / optional feature's resource spend.
- *
- *  `amount` is the MINIMUM spend. When `amount_max` is present the spend is a
- *  RANGE (`amount` .. `amount_max`). Readers of `consumes.resource`, re-measured
- *  2026-09-05 across both repos' `src` after plugin task T4 landed: the ENGINE still has
- *  exactly one, `pc/pc.pools.ts`'s pool vote (R4-G4 §4.2.3, whose owner-aware form T2 shipped;
- *  the `consumes.resource` key itself PREDATES T2, measured on `821f80d`), which reads the
- *  id to pick `ResolvedPool.resource` and never spends it; the PLUGIN now has SEVEN FUNCTIONS over
- *  EIGHT code lines in four files (the unit matters: `grep -rn "consumes\.resource\|consumes?\.resource"
- *  packages/obsidian/src` returns NINE lines, one of them docblock prose, and `consumeCost` reads the
- *  field on two of the eight). They are: `renderSpendControl` (`components/actions/spend-control.ts`),
- *  which SPENDS it; the four row sites that gate that call, `PoolTab.row`, `PoolTab.grantedRow` and
- *  `PoolTab.blockCard` (`components/pool-tab.ts`) and `renderBoonRow`
- *  (`components/actions/boon-rows.ts`). Their gates, measured 2026-09-05 with `grep -n` on
- *  `pool-tab.ts`, are NOT the same test, because their callers differ: `row` is gated on the entry
- *  being SELECTED (`renderSpellLike` sends it every available candidate), `blockCard` on the entry
- *  being GRANTED OR SELECTED (`renderBlocks` sends it the available candidates, then the stranded
- *  picks, then the grants), and `grantedRow` is UNCONDITIONAL because it is reached only by the loop
- *  over `pool.grants`, as is `renderBoonRow`, which the plugin's `section-renderer.ts` reaches only
- *  with a `kind` of "selected" or "granted". One rule, KNOWN entries only, expressed four ways;
- *  `renderFeatureRow` (`components/actions/feature-rows.ts`), whose owner-and-spender rule
- *  decides between the row slot, the expand card and no control at all; and `consumeCost`
- *  (`components/pool-tab.ts`), the ONE Cost label the row sub-line and the block card now
- *  share, which prints the resource's NAME from the index and keeps the raw id only as the
- *  fallback for an id the character does not own (it no longer singularizes or capitalizes
- *  it). The field IS spent as of R4-G4 T4: §3's control spends `amount` exactly through
- *  `CharacterEditState.spendFeatureUse`, the clamped quantity-taking primitive the plugin
- *  already had. What R4-G4 does NOT do (§15): the HOW-MUCH UI for a range spend
- *  and its validation rule stay G8, and the converter un-withhold that would emit
- *  `amount_max` at all is a G7 handoff. So `amount_max` stays DECLARED here only, with
- *  zero emitted carriers, and the refine is undefined-safe by construction so the
- *  corpus that ships without the key keeps parsing: 294 `Feature.consumes` carriers
- *  over 161 documents, plus 70 `OptionalFeature.consumes` documents (R4-G3a §9; an
- *  unguarded refine refuses all 231, measured). */
 export declare const resourceConsumptionSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodEnum<{
         "spell-slots": "spell-slots";

package/dist/schemas/resource-schema.js

@@ -1,12 +1 @@
-import {
-  actionCostEnum,
-  resetTriggerEnum,
-  resourceConsumptionSchema,
-  resourceSchema
-} from "../chunk-ZJXSXVFP.js";
-export {
-  actionCostEnum,
-  resetTriggerEnum,
-  resourceConsumptionSchema,
-  resourceSchema
-};
+import{actionCostEnum,resetTriggerEnum,resourceConsumptionSchema,resourceSchema}from"../chunk-CCFIINBA.js";export{actionCostEnum,resetTriggerEnum,resourceConsumptionSchema,resourceSchema};

package/dist/schemas/selection-pool-schema.js

@@ -1,10 +1 @@
-import {
-  poolGrantSchema,
-  selectionPoolSchema,
-  tabDeclSchema
-} from "../chunk-G6MHJDVT.js";
-export {
-  poolGrantSchema,
-  selectionPoolSchema,
-  tabDeclSchema
-};
+import{poolGrantSchema,selectionPoolSchema,tabDeclSchema}from"../chunk-GCYUCIDN.js";export{poolGrantSchema,selectionPoolSchema,tabDeclSchema};

package/dist/spell/casting-time.d.ts

@@ -1,22 +1,7 @@
-/**
- * The ONE reader of a spell's `casting_time` string. Every consumer (the plugin's compact Cast-table label,
- * the add-drawer's filter bucket and its sort rank) goes through here, so a spelling that one of them
- * understands the others understand too. Before this, each kept its own exact-string switch over the bundle's
- * spellings (`action`, `bonus-action`, `1minute`), and they drifted: a converted or AI-generated spell's
- * `1 action` / `10 minute` printed raw in the Cast table, and every vault spell spelled `bonus action`,
- * `1 minute` or `1 hour` filtered as "special".
- *
- * The LEADING token decides. Prose after it (a reaction's trigger, Plant Growth's "or 8 hours") is left for
- * the caller's tooltip and never matched, and the trailing word boundary stops a word that merely starts with
- * a unit (`reactionary`, `bonuses`, `minuteman`) from reading as one. A count is optional and only meaningful
- * for minutes and hours; `bonus` may drop the word `action`, which hand-authored spells do.
- */
 export type CastingTimeKind = "action" | "bonus" | "reaction" | "time";
 export interface ParsedCastingTime {
     kind: CastingTimeKind;
-    /** 1 for the action economy; the stated number of minutes / hours for `time` (1 when omitted). */
     count: number;
-    /** Present only for `time`. */
     unit?: "minute" | "hour";
 }
 export declare function parseCastingTime(token: string | undefined): ParsedCastingTime | null;

package/dist/spell/casting-time.js

@@ -1,6 +1 @@
-import {
-  parseCastingTime
-} from "../chunk-W6GC6OKK.js";
-export {
-  parseCastingTime
-};
+import{parseCastingTime}from"../chunk-CMIEZQL4.js";export{parseCastingTime};

package/dist/spell/spell.access.d.ts

@@ -6,10 +6,4 @@ export interface SpellCandidate {
     level: number;
     entity: Spell;
 }
-/**
- * Pure spell-picker filter. Enumerates all `spell` entities from the registry
- * (an empty query returns every spell of the type), drops already-known slugs,
- * then applies the name search and — unless `showAll` is set — the class/level
- * gate. Results are sorted by level then name.
- */
 export declare function classSpellCandidates(registry: EntityRegistry, classSlugs: string[], maxLevel: number, knownSlugs: Set<string>, showAll?: boolean, query?: string): SpellCandidate[];

package/dist/spell/spell.access.js

@@ -1,45 +1 @@
-import {
-  baseClassName
-} from "../chunk-VTTA2ALZ.js";
-
-// src/spell/spell.access.ts
-var LISTED_CLASS_NAMES = /* @__PURE__ */ new WeakMap();
-function listedClassNames(registry) {
-  const count = registry.count();
-  const cached = LISTED_CLASS_NAMES.get(registry);
-  if (cached && cached.count === count) return cached.names;
-  const names = /* @__PURE__ */ new Set();
-  for (const e of registry.search("", "spell", Number.POSITIVE_INFINITY)) {
-    const classes = e.data.classes;
-    if (!Array.isArray(classes)) continue;
-    for (const c of classes) names.add(baseClassName(String(c)));
-  }
-  LISTED_CLASS_NAMES.set(registry, { count, names });
-  return names;
-}
-function classSpellCandidates(registry, classSlugs, maxLevel, knownSlugs, showAll = false, query = "") {
-  const all = registry.search(query, "spell", Number.POSITIVE_INFINITY);
-  const q = query.toLowerCase();
-  const classSet = new Set(classSlugs.map((s) => baseClassName(s)));
-  let unlistable = false;
-  if (!showAll && classSet.size > 0) {
-    const listed = listedClassNames(registry);
-    unlistable = [...classSet].some((n) => !listed.has(n));
-  }
-  return all.filter((e) => !knownSlugs.has(e.slug)).map((e) => {
-    var _a;
-    const entity = e.data;
-    return { slug: e.slug, name: e.name, entity, level: (_a = entity.level) != null ? _a : 0 };
-  }).filter((c) => {
-    var _a;
-    if (q && !c.name.toLowerCase().includes(q)) return false;
-    if (showAll) return true;
-    if (c.level > maxLevel) return false;
-    if (unlistable) return true;
-    const classes = ((_a = c.entity.classes) != null ? _a : []).map((x) => baseClassName(x));
-    return classes.some((x) => classSet.has(x));
-  }).sort((a, b) => a.level - b.level || a.name.localeCompare(b.name));
-}
-export {
-  classSpellCandidates
-};
+import{baseClassName}from"../chunk-CAPYNIGK.js";var LISTED_CLASS_NAMES=new WeakMap;function listedClassNames(registry){const count=registry.count();const cached=LISTED_CLASS_NAMES.get(registry);if(cached&&cached.count===count)return cached.names;const names=new Set;for(const e of registry.search("","spell",Number.POSITIVE_INFINITY)){const classes=e.data.classes;if(!Array.isArray(classes))continue;for(const c of classes)names.add(baseClassName(String(c)))}LISTED_CLASS_NAMES.set(registry,{count,names});return names}function classSpellCandidates(registry,classSlugs,maxLevel,knownSlugs,showAll=false,query=""){const all=registry.search(query,"spell",Number.POSITIVE_INFINITY);const q=query.toLowerCase();const classSet=new Set(classSlugs.map(s=>baseClassName(s)));let unlistable=false;if(!showAll&&classSet.size>0){const listed=listedClassNames(registry);unlistable=[...classSet].some(n=>!listed.has(n))}return all.filter(e=>!knownSlugs.has(e.slug)).map(e=>{var _a;const entity=e.data;return{slug:e.slug,name:e.name,entity,level:(_a=entity.level)!=null?_a:0}}).filter(c=>{var _a;if(q&&!c.name.toLowerCase().includes(q))return false;if(showAll)return true;if(c.level>maxLevel)return false;if(unlistable)return true;const classes=((_a=c.entity.classes)!=null?_a:[]).map(x=>baseClassName(x));return classes.some(x=>classSet.has(x))}).sort((a,b)=>a.level-b.level||a.name.localeCompare(b.name))}export{classSpellCandidates};

package/dist/spell/spell.ai-schema.js

@@ -1,6 +1 @@
-import {
-  spellInputSchema
-} from "../chunk-656QCX4U.js";
-export {
-  spellInputSchema
-};
+import{spellInputSchema}from"../chunk-IHPLT2ZT.js";export{spellInputSchema};

package/dist/spell/spell.codec.js

@@ -1,9 +1 @@
-import {
-  spellCodec
-} from "../chunk-OOSRUJBI.js";
-import "../chunk-7Q2VPKCD.js";
-import "../chunk-ZDAEGJH4.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  spellCodec
-};
+import{spellCodec}from"../chunk-XKJXT2PN.js";import"../chunk-4KVVAENP.js";import"../chunk-7EL3GWWJ.js";import"../chunk-I26FHSI6.js";export{spellCodec};

package/dist/spell/spell.enrichment.js

@@ -1,9 +1 @@
-import {
-  enrichSpell
-} from "../chunk-WSVMLNTO.js";
-import "../chunk-DEEHHLAP.js";
-import "../chunk-PDJSUH24.js";
-import "../chunk-WELIKLZF.js";
-export {
-  enrichSpell
-};
+import{enrichSpell}from"../chunk-2NUDWOFG.js";import"../chunk-MGGKZGLG.js";import"../chunk-7FPQJDFD.js";import"../chunk-EVT7MGAC.js";export{enrichSpell};

package/dist/spell/spell.filter.d.ts

@@ -1,15 +1,10 @@
 import type { SpellCandidate } from "./spell.access.js";
 export type CastTimeCat = "action" | "bonus" | "reaction" | "long" | "special";
 export type RangeCat = "self" | "touch" | "ranged" | "special";
-/** Cast-time bucket, read through `parseCastingTime` (the same reader the Cast table's label uses, so the two
- *  cannot drift). Minutes/hours fold into "long"; unreadable or absent → "special". */
 export declare function castTimeCategory(token: string | undefined): CastTimeCat;
-/** Range bucket from the human range string. Honest read, documented buckets:
- *  "Self…"→self, "Touch…"→touch, "<n> feet|ft"→ranged, else (mile/Sight/…)→special. */
 export declare function rangeCategory(range: string | undefined): RangeCat;
 export type SortKey = "name" | "level" | "time" | "school" | "range" | "damage" | "save" | "source";
 export type SortDir = "asc" | "desc";
 export declare function castTimeRank(token: string | undefined): number;
-/** Numeric sort weight for a range string: Self=0, Touch=1, "<n> feet"=n, else large. */
 export declare function rangeSortValue(range: string | undefined): number;
 export declare function compareCandidates(a: SpellCandidate, b: SpellCandidate, key: SortKey, dir: SortDir): number;

package/dist/spell/spell.filter.js

@@ -1,75 +1 @@
-import {
-  parseCastingTime
-} from "../chunk-W6GC6OKK.js";
-
-// src/spell/spell.filter.ts
-function castTimeCategory(token) {
-  const parsed = parseCastingTime(token);
-  if (!parsed) return "special";
-  return parsed.kind === "time" ? "long" : parsed.kind;
-}
-function rangeCategory(range) {
-  if (!range) return "special";
-  if (/^self/i.test(range)) return "self";
-  if (/^touch/i.test(range)) return "touch";
-  if (/\d+\s*(feet|ft)\b/i.test(range)) return "ranged";
-  return "special";
-}
-var CAST_RANK = { action: 0, bonus: 1, reaction: 2, long: 3, special: 4 };
-function castTimeRank(token) {
-  return CAST_RANK[castTimeCategory(token)];
-}
-function rangeSortValue(range) {
-  if (!range) return 99999;
-  if (/^self/i.test(range)) return 0;
-  if (/^touch/i.test(range)) return 1;
-  const m = range.match(/(\d+)\s*(feet|ft)\b/i);
-  return m ? Number(m[1]) : 99999;
-}
-var EDITION_RANK = { "2014": 0, "2024": 1 };
-function cmpMaybe(a, b) {
-  if (a && b) return a.localeCompare(b);
-  if (a) return -1;
-  if (b) return 1;
-  return 0;
-}
-function compareCandidates(a, b, key, dir) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
-  const mul = dir === "asc" ? 1 : -1;
-  let r = 0;
-  switch (key) {
-    case "name":
-      r = a.name.localeCompare(b.name);
-      break;
-    case "level":
-      r = a.level - b.level;
-      break;
-    case "time":
-      r = castTimeRank(a.entity.casting_time) - castTimeRank(b.entity.casting_time);
-      break;
-    case "school":
-      r = cmpMaybe(a.entity.school, b.entity.school);
-      break;
-    case "range":
-      r = rangeSortValue(a.entity.range) - rangeSortValue(b.entity.range);
-      break;
-    case "damage":
-      r = cmpMaybe((_b = (_a = a.entity.damage) == null ? void 0 : _a.types) == null ? void 0 : _b[0], (_d = (_c = b.entity.damage) == null ? void 0 : _c.types) == null ? void 0 : _d[0]);
-      break;
-    case "save":
-      r = cmpMaybe((_e = a.entity.saving_throw) == null ? void 0 : _e.ability, (_f = b.entity.saving_throw) == null ? void 0 : _f.ability);
-      break;
-    case "source":
-      r = ((_h = EDITION_RANK[(_g = a.entity.edition) != null ? _g : ""]) != null ? _h : 9) - ((_j = EDITION_RANK[(_i = b.entity.edition) != null ? _i : ""]) != null ? _j : 9);
-      break;
-  }
-  if (r === 0 && key !== "name") r = a.name.localeCompare(b.name);
-  return r * mul;
-}
-export {
-  castTimeCategory,
-  castTimeRank,
-  compareCandidates,
-  rangeCategory,
-  rangeSortValue
-};
+import{parseCastingTime}from"../chunk-CMIEZQL4.js";function castTimeCategory(token){const parsed=parseCastingTime(token);if(!parsed)return"special";return parsed.kind==="time"?"long":parsed.kind}function rangeCategory(range){if(!range)return"special";if(/^self/i.test(range))return"self";if(/^touch/i.test(range))return"touch";if(/\d+\s*(feet|ft)\b/i.test(range))return"ranged";return"special"}var CAST_RANK={action:0,bonus:1,reaction:2,long:3,special:4};function castTimeRank(token){return CAST_RANK[castTimeCategory(token)]}function rangeSortValue(range){if(!range)return 99999;if(/^self/i.test(range))return 0;if(/^touch/i.test(range))return 1;const m=range.match(/(\d+)\s*(feet|ft)\b/i);return m?Number(m[1]):99999}var EDITION_RANK={"2014":0,"2024":1};function cmpMaybe(a,b){if(a&&b)return a.localeCompare(b);if(a)return-1;if(b)return 1;return 0}function compareCandidates(a,b,key,dir){var _a,_b,_c,_d,_e,_f,_g,_h,_i,_j;const mul=dir==="asc"?1:-1;let r=0;switch(key){case"name":r=a.name.localeCompare(b.name);break;case"level":r=a.level-b.level;break;case"time":r=castTimeRank(a.entity.casting_time)-castTimeRank(b.entity.casting_time);break;case"school":r=cmpMaybe(a.entity.school,b.entity.school);break;case"range":r=rangeSortValue(a.entity.range)-rangeSortValue(b.entity.range);break;case"damage":r=cmpMaybe((_b=(_a=a.entity.damage)==null?void 0:_a.types)==null?void 0:_b[0],(_d=(_c=b.entity.damage)==null?void 0:_c.types)==null?void 0:_d[0]);break;case"save":r=cmpMaybe((_e=a.entity.saving_throw)==null?void 0:_e.ability,(_f=b.entity.saving_throw)==null?void 0:_f.ability);break;case"source":r=((_h=EDITION_RANK[(_g=a.entity.edition)!=null?_g:""])!=null?_h:9)-((_j=EDITION_RANK[(_i=b.entity.edition)!=null?_i:""])!=null?_j:9);break}if(r===0&&key!=="name")r=a.name.localeCompare(b.name);return r*mul}export{castTimeCategory,castTimeRank,compareCandidates,rangeCategory,rangeSortValue};

package/dist/spell/spell.parser.d.ts

@@ -1,38 +1,7 @@
 import { Spell, SpellMaterial } from "./spell.types.js";
 import { ParseResult } from "@archivist-gg/core";
-/**
- * §3.3 · collapse the converter's structured `components` object to the corpus's own string form
- * (`V, S, M (a coin), R`), leaving a string input byte-unchanged. Letter order is V, S, M, R;
- * `m` object -> `M (<text>)` (the text already carries the cost prose), `m` string -> `M (<value>)`,
- * `m: true` -> a bare `M`. A boolean flag contributes its letter only when it is exactly `true`.
- * Casing follows the 862 string-form carriers (uppercase letters); `R` has no precedent among them
- * and is an invented-but-decided literal (Gate 0 B-5).
- *
- * The parameter is `unknown` on purpose: `spellComponentsObjectSchema` stays local and unexported,
- * so this function narrows structurally instead of importing the schema's type. `toStringSafe` is
- * the unreachable-shape fallback (the schema has already accepted the value by the time we run).
- */
 export declare function normalizeSpellComponents(value: unknown): string;
-/**
- * D2b-B · the structured material component the string form cannot carry: `components.m` when it is an OBJECT (`text` with an
- * optional `cost` and `consume`), copied field by field; `undefined` for every other shape. Structural narrowing, as above.
- */
 export declare function spellMaterialOf(value: unknown): SpellMaterial | undefined;
-/**
- * §3.3 · collapse the converter's structured `duration` array to the corpus's own lowercase string
- * form (`until dispelled`, `up to 1 hour`), leaving a string input byte-unchanged. Concentration is
- * NEVER synthesised here — the separate `concentration` boolean drives the sheet's `Conc · ` prefix.
- * Zero docs carry more than one entry; the `; ` join is the defensive path for the day one does.
- */
 export declare function normalizeSpellDuration(value: unknown): string;
-/**
- * R4-G7 §7.5 · the RESOLVE-time twin of the two normalisations `parseSpell` performs below. The PC pipeline
- * reads RAW registry entities (`reg.data as unknown as Spell`), so a converter spell reaches the sheet with a
- * structured `components` object and `duration` array unless it passes through here; `componentLetters`
- * (the sheet) and the add drawer's duration cell both read strings. The `!= null` guards MIRROR `parseSpell`'s
- * own, so a spell that authors neither key keeps neither. Lives HERE, beside the normalisers, and not in
- * `pc.resolver.ts`, which already imports `pc.additional-spells` and would make the two a value cycle
- * [G2-I-2]. Returns a fresh object; the shared registry entity is never mutated.
- */
 export declare function mirrorSpellShapes(entity: Spell): Spell;
 export declare function parseSpell(source: string): ParseResult<Spell>;

package/dist/spell/spell.parser.js

@@ -1,16 +1 @@
-import {
-  mirrorSpellShapes,
-  normalizeSpellComponents,
-  normalizeSpellDuration,
-  parseSpell,
-  spellMaterialOf
-} from "../chunk-7Q2VPKCD.js";
-import "../chunk-ZDAEGJH4.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  mirrorSpellShapes,
-  normalizeSpellComponents,
-  normalizeSpellDuration,
-  parseSpell,
-  spellMaterialOf
-};
+import{mirrorSpellShapes,normalizeSpellComponents,normalizeSpellDuration,parseSpell,spellMaterialOf}from"../chunk-4KVVAENP.js";import"../chunk-7EL3GWWJ.js";import"../chunk-I26FHSI6.js";export{mirrorSpellShapes,normalizeSpellComponents,normalizeSpellDuration,parseSpell,spellMaterialOf};

package/dist/spell/spell.scaling.d.ts

@@ -1,59 +1,13 @@
 import type { Spell } from "./spell.types.js";
-/** A spell repeats under higher levels only if it has a real upcast benefit. */
 export declare function spellScales(spell: Spell): boolean;
-/** The `casting_options` field a scaled value was read from (R4-G7 T8 RIDER-16). */
 export type SpellEffectField = "damage_roll" | "target_count" | "duration" | "desc";
-/** A scaled value and the FIELD it came from, so a renderer decides where it prints from the field. */
 export interface SpellEffectParts {
     field: SpellEffectField;
-    /** As printed: the roll, `"<N> targets"`, the duration, or the authored sentence verbatim. */
     value: string;
 }
-/** The spell's base roll (`damage_roll`), trimmed, or null when absent, empty or whitespace-only. The ONE base-roll
- *  check: every reader of `damage_roll` (the scaling readers here, the spell card) goes through it. */
 export declare function spellBaseRoll(spell: Spell): string | null;
-/**
- * At-a-glance effect for casting a LEVELLED `spell` with a slot of `slotLevel`, WITH the field
- * it came from. Returns null when absent or untrustworthy.
- *
- * A structured `casting_options` entry for that slot (`type: "slot_level_<N>"`) wins: the FIRST
- * present field, in this order: `damage_roll`, `target_count`, `duration`, `desc` (so an option
- * carrying a roll AND a sentence yields the roll). A `target_count` that equals the slot level is
- * the known SRD-2014 bad encoding (e.g. Magic Missile 2nd->2 instead of 4) and is suppressed.
- *
- * With no option for the slot, the spell's BASE roll (`damage_roll`) answers at the spell's OWN
- * level only. Above it, whether the base roll is still the roll dealt is `spellBaseRollAtSlot`'s
- * question (it is when the damage does not scale); a SCALING spell missing its option above base
- * stays null here. A CANTRIP is never read by slot (null): its roll follows the character's level,
- * `spellEffectAtCharacterLevel`, even when it is cast from a scroll. This errs toward showing
- * nothing rather than a wrong number.
- */
 export declare function spellEffectPartsAtSlot(spell: Spell, slotLevel: number): SpellEffectParts | null;
-/**
- * The spell's BASE roll at a slot of `slotLevel` when the data PROVES its damage does not scale, so every slot at or
- * above the spell's level deals the base roll. Two proofs, and only these:
- *   (a) it has `slot_level_<N>` options and every one carries only a `duration` and / or a `target_count` (plus the
- *       `concentration` flag a duration carries): 2024 Hex and Hunter's Mark scale their duration, Magic Missile and
- *       Scorching Ray their target count;
- *   (b) it has no slot options AND no `at_higher_levels` text (Finger of Death).
- * Anything else is NOT proof: prose-only scaling (2014 Cure Wounds' "increases by 1d8 for each slot level above
- * 1st", with no options) would print the unscaled base on every upcast row, so it stays null there. The companion of
- * `spellEffectPartsAtSlot`: a row prints this roll beside a target count, and the duration a slot option carries
- * prints in its own cell. Null for a cantrip, below the spell's level, and when the spell has no base roll.
- */
 export declare function spellBaseRollAtSlot(spell: Spell, slotLevel: number): string | null;
-/** The value of `spellEffectPartsAtSlot`, without its field. */
 export declare function spellEffectAtSlot(spell: Spell, slotLevel: number): string | null;
-/**
- * R4-G7 T8 RIDER-15 (F-NODICE (a)): a CANTRIP's damage roll at the character's total level, read from structured
- * `casting_options` (`type: "player_level_<N>"`). The roll of the HIGHEST `N <= characterLevel` wins: SRD 5e authors
- * one option per level from 5 to 20, SRD 2024 and the converter author only 5 / 11 / 17. An option with no roll or an
- * EMPTY one never qualifies (SRD 5e Acid Splash and Poison Spray open with `player_level_2..4` carrying
- * `damage_roll: ''`; Eldritch Blast 2024 authors `target_count` only). When no tier qualifies (below the first tier,
- * or tiers that carry no roll) the spell's BASE roll `damage_roll` answers: the tier-1 roll (Fire Bolt `1d10` at 4,
- * Eldritch Blast's per-beam `1d10` at any level). Null for a levelled spell, for a level that is not a finite number
- * (a fixture-built `derived` omits `totalLevel`), and when neither a tier nor a non-empty base roll exists.
- */
 export declare function spellEffectAtCharacterLevel(spell: Spell, characterLevel: number): string | null;
-/** Owned slot levels strictly above the spell's base level (scaling spells only). */
 export declare function upcastLevelsFor(spell: Spell, ownedSlotLevels: number[]): number[];

package/dist/spell/spell.scaling.js

@@ -1,79 +1 @@
-// src/spell/spell.scaling.ts
-function spellScales(spell) {
-  var _a, _b, _c, _d;
-  return ((_b = (_a = spell.casting_options) == null ? void 0 : _a.length) != null ? _b : 0) > 0 || ((_d = (_c = spell.at_higher_levels) == null ? void 0 : _c.length) != null ? _d : 0) > 0;
-}
-function spellBaseRoll(spell) {
-  const roll = typeof spell.damage_roll === "string" ? spell.damage_roll.trim() : "";
-  return roll !== "" ? roll : null;
-}
-function spellEffectPartsAtSlot(spell, slotLevel) {
-  var _a, _b;
-  const base = (_a = spell.level) != null ? _a : 0;
-  if (base === 0) return null;
-  const opt = ((_b = spell.casting_options) != null ? _b : []).find((o) => o.type === `slot_level_${slotLevel}`);
-  if (!opt) {
-    const roll = spellBaseRoll(spell);
-    return roll !== null && slotLevel === base ? { field: "damage_roll", value: roll } : null;
-  }
-  if (opt.damage_roll) return { field: "damage_roll", value: opt.damage_roll };
-  if (typeof opt.target_count === "number") {
-    if (opt.target_count === slotLevel) return null;
-    return { field: "target_count", value: `${opt.target_count} targets` };
-  }
-  if (opt.duration) return { field: "duration", value: opt.duration };
-  return opt.desc != null ? { field: "desc", value: opt.desc } : null;
-}
-var NON_ROLL_SCALES = /* @__PURE__ */ new Set(["duration", "target_count"]);
-var NON_ROLL_OPTION_FIELDS = /* @__PURE__ */ new Set([...NON_ROLL_SCALES, "concentration"]);
-function spellBaseRollAtSlot(spell, slotLevel) {
-  var _a, _b, _c;
-  const base = (_a = spell.level) != null ? _a : 0;
-  if (base === 0 || slotLevel < base) return null;
-  const roll = spellBaseRoll(spell);
-  if (roll === null) return null;
-  const slotOptions = ((_b = spell.casting_options) != null ? _b : []).filter((o) => {
-    var _a2;
-    return /^slot_level_\d+$/.test(String((_a2 = o.type) != null ? _a2 : ""));
-  });
-  if (slotOptions.length > 0) {
-    const onlyNonRoll = slotOptions.every((o) => {
-      const fields = Object.entries(o).filter(([k, v]) => k !== "type" && v != null).map(([k]) => k);
-      return fields.some((k) => NON_ROLL_SCALES.has(k)) && fields.every((k) => NON_ROLL_OPTION_FIELDS.has(k));
-    });
-    return onlyNonRoll ? roll : null;
-  }
-  return ((_c = spell.at_higher_levels) != null ? _c : []).some((t) => typeof t === "string" && t.trim() !== "") ? null : roll;
-}
-function spellEffectAtSlot(spell, slotLevel) {
-  var _a, _b;
-  return (_b = (_a = spellEffectPartsAtSlot(spell, slotLevel)) == null ? void 0 : _a.value) != null ? _b : null;
-}
-var PLAYER_LEVEL_TYPE = /^player_level_(\d+)$/;
-function spellEffectAtCharacterLevel(spell, characterLevel) {
-  var _a, _b, _c;
-  if (((_a = spell.level) != null ? _a : 0) !== 0 || !Number.isFinite(characterLevel)) return null;
-  let best = null;
-  for (const opt of (_b = spell.casting_options) != null ? _b : []) {
-    const m = PLAYER_LEVEL_TYPE.exec(String((_c = opt.type) != null ? _c : ""));
-    if (!m || typeof opt.damage_roll !== "string" || opt.damage_roll.trim() === "") continue;
-    const n = Number(m[1]);
-    if (n <= characterLevel && (best === null || n > best.n)) best = { n, roll: opt.damage_roll };
-  }
-  return best ? best.roll : spellBaseRoll(spell);
-}
-function upcastLevelsFor(spell, ownedSlotLevels) {
-  var _a;
-  const base = (_a = spell.level) != null ? _a : 0;
-  if (base < 1 || !spellScales(spell)) return [];
-  return ownedSlotLevels.filter((l) => l > base).sort((a, b) => a - b);
-}
-export {
-  spellBaseRoll,
-  spellBaseRollAtSlot,
-  spellEffectAtCharacterLevel,
-  spellEffectAtSlot,
-  spellEffectPartsAtSlot,
-  spellScales,
-  upcastLevelsFor
-};
+function spellScales(spell){var _a,_b,_c,_d;return((_b=(_a=spell.casting_options)==null?void 0:_a.length)!=null?_b:0)>0||((_d=(_c=spell.at_higher_levels)==null?void 0:_c.length)!=null?_d:0)>0}function spellBaseRoll(spell){const roll=typeof spell.damage_roll==="string"?spell.damage_roll.trim():"";return roll!==""?roll:null}function spellEffectPartsAtSlot(spell,slotLevel){var _a,_b;const base=(_a=spell.level)!=null?_a:0;if(base===0)return null;const opt=((_b=spell.casting_options)!=null?_b:[]).find(o=>o.type===`slot_level_${slotLevel}`);if(!opt){const roll=spellBaseRoll(spell);return roll!==null&&slotLevel===base?{field:"damage_roll",value:roll}:null}if(opt.damage_roll)return{field:"damage_roll",value:opt.damage_roll};if(typeof opt.target_count==="number"){if(opt.target_count===slotLevel)return null;return{field:"target_count",value:`${opt.target_count} targets`}}if(opt.duration)return{field:"duration",value:opt.duration};return opt.desc!=null?{field:"desc",value:opt.desc}:null}var NON_ROLL_SCALES=new Set(["duration","target_count"]);var NON_ROLL_OPTION_FIELDS=new Set([...NON_ROLL_SCALES,"concentration"]);function spellBaseRollAtSlot(spell,slotLevel){var _a,_b,_c;const base=(_a=spell.level)!=null?_a:0;if(base===0||slotLevel<base)return null;const roll=spellBaseRoll(spell);if(roll===null)return null;const slotOptions=((_b=spell.casting_options)!=null?_b:[]).filter(o=>{var _a2;return/^slot_level_\d+$/.test(String((_a2=o.type)!=null?_a2:""))});if(slotOptions.length>0){const onlyNonRoll=slotOptions.every(o=>{const fields=Object.entries(o).filter(([k,v])=>k!=="type"&&v!=null).map(([k])=>k);return fields.some(k=>NON_ROLL_SCALES.has(k))&&fields.every(k=>NON_ROLL_OPTION_FIELDS.has(k))});return onlyNonRoll?roll:null}return((_c=spell.at_higher_levels)!=null?_c:[]).some(t=>typeof t==="string"&&t.trim()!=="")?null:roll}function spellEffectAtSlot(spell,slotLevel){var _a,_b;return(_b=(_a=spellEffectPartsAtSlot(spell,slotLevel))==null?void 0:_a.value)!=null?_b:null}var PLAYER_LEVEL_TYPE=/^player_level_(\d+)$/;function spellEffectAtCharacterLevel(spell,characterLevel){var _a,_b,_c;if(((_a=spell.level)!=null?_a:0)!==0||!Number.isFinite(characterLevel))return null;let best=null;for(const opt of(_b=spell.casting_options)!=null?_b:[]){const m=PLAYER_LEVEL_TYPE.exec(String((_c=opt.type)!=null?_c:""));if(!m||typeof opt.damage_roll!=="string"||opt.damage_roll.trim()==="")continue;const n=Number(m[1]);if(n<=characterLevel&&(best===null||n>best.n))best={n,roll:opt.damage_roll}}return best?best.roll:spellBaseRoll(spell)}function upcastLevelsFor(spell,ownedSlotLevels){var _a;const base=(_a=spell.level)!=null?_a:0;if(base<1||!spellScales(spell))return[];return ownedSlotLevels.filter(l=>l>base).sort((a,b)=>a-b)}export{spellBaseRoll,spellBaseRollAtSlot,spellEffectAtCharacterLevel,spellEffectAtSlot,spellEffectPartsAtSlot,spellScales,upcastLevelsFor};

package/dist/spell/spell.schema.js

@@ -1,7 +1 @@
-import {
-  spellEntitySchema
-} from "../chunk-ZDAEGJH4.js";
-import "../chunk-UA5KS2PL.js";
-export {
-  spellEntitySchema
-};
+import{spellEntitySchema}from"../chunk-7EL3GWWJ.js";import"../chunk-I26FHSI6.js";export{spellEntitySchema};

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>;