@iamjameslennon/ddb-mcp 2.8.0 → 2.9.1

package/dist/tools/character/features.js

@@ -0,0 +1,107 @@
+/**
+ * Features domain — feats (real + disguised), class features, racial traits,
+ * background feature. Owns the features block.
+ *
+ * Phase 5c of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Output strings are pre-formatted (e.g. featLines = ["• Great Weapon Master: …"])
+ * to preserve byte-for-byte parity with the original inline code.
+ */
+import { arr, hasTag, num, obj, str, stripHtml } from "./helpers.js";
+// ── Feats ────────────────────────────────────────────────────────────────────
+function buildFeatLines(char, resolveTemplates) {
+    // DDB stores some non-feat entries in the feats array.
+    // __DISGUISE_FEAT = class features surfaced as feats (shown in OTHER FEATURES).
+    // __INITIAL_ASI   = 2024 background Ability Score Improvements (already in ABILITY SCORES; drop entirely).
+    const allFeats = arr(char.feats);
+    const realFeats = allFeats.filter(f => !hasTag(f, "__DISGUISE_FEAT") && !hasTag(f, "__INITIAL_ASI"));
+    const disguisedFeats = allFeats.filter(f => hasTag(f, "__DISGUISE_FEAT"));
+    const featLines = realFeats.map(f => {
+        const def = obj(f.definition);
+        const snippet = resolveTemplates(stripHtml(str(def.snippet || def.description))).slice(0, 120);
+        return `• ${str(def.name)}${snippet ? `: ${snippet}${snippet.length >= 120 ? "…" : ""}` : ""}`;
+    });
+    const disguisedFeatLines = disguisedFeats.map(f => `• ${str(obj(f.definition).name)}`);
+    return { featLines, disguisedFeatLines, realFeatCount: realFeats.length };
+}
+// ── Class features ───────────────────────────────────────────────────────────
+function buildClassFeatureLines(classes) {
+    const lines = [];
+    const seen = new Set();
+    for (const c of classes) {
+        const charLevel = num(c.level);
+        for (const cf of arr(c.classFeatures)) {
+            const def = obj(cf.definition);
+            const line = `• ${str(def.name)} (${str(obj(c.definition).name)} ${num(def.requiredLevel || 1)})`;
+            if (num(def.requiredLevel || 0) <= charLevel && !seen.has(line)) {
+                seen.add(line);
+                lines.push(line);
+            }
+        }
+    }
+    return lines;
+}
+// ── Racial traits ────────────────────────────────────────────────────────────
+function buildRacialTraitLines(char) {
+    return arr(obj(char.race).racialTraits).map(t => `• ${str(obj(t.definition).name)}`);
+}
+// ── Background feature ───────────────────────────────────────────────────────
+function buildBackgroundFeature(char, resolveTemplates) {
+    // For custom backgrounds, featureName may reflect a feat name rather than
+    // the actual background feature. Check customBackground first if present.
+    const bgObj = obj(char.background);
+    const customBg = obj(bgObj.customBackground);
+    const featuresBackgroundDef = obj(obj(customBg.featuresBackground).definition);
+    const customBgDef = Object.keys(featuresBackgroundDef).length > 0
+        ? featuresBackgroundDef
+        : obj(customBg.definition);
+    const bgDef = Object.keys(customBgDef).length > 0 ? customBgDef : obj(bgObj.definition);
+    return {
+        name: str(bgDef.featureName),
+        isFeat: bgDef.featureIsFeat === true,
+        descSnippet: bgDef.featureDescription
+            ? resolveTemplates(stripHtml(str(bgDef.featureDescription))).slice(0, 300)
+            : "",
+    };
+}
+// ── Public API ───────────────────────────────────────────────────────────────
+export function computeFeatures(core) {
+    const { char, classes, resolveTemplates } = core;
+    const { featLines, disguisedFeatLines, realFeatCount } = buildFeatLines(char, resolveTemplates);
+    return {
+        featLines,
+        disguisedFeatLines,
+        realFeatCount,
+        classFeatureLines: buildClassFeatureLines(classes),
+        racialTraitLines: buildRacialTraitLines(char),
+        background: buildBackgroundFeature(char, resolveTemplates),
+    };
+}
+export function formatFeaturesBlock(f) {
+    return [
+        `FEATS (${f.realFeatCount})`,
+        ...(f.featLines.length ? f.featLines : ["  (none)"]),
+        ``,
+        ...(f.disguisedFeatLines.length ? [
+            `OTHER FEATURES (stored as feats in API but NOT player-chosen feats)`,
+            ...f.disguisedFeatLines,
+            ``,
+        ] : []),
+        `CLASS FEATURES`,
+        ...f.classFeatureLines,
+        ``,
+        `RACIAL TRAITS`,
+        ...f.racialTraitLines,
+        ``,
+        ...(!f.background.name || f.background.isFeat ? [] : (() => {
+            const desc = f.background.descSnippet;
+            const descSnippet = desc ? `${desc}${desc.length >= 300 ? "…" : ""}` : "";
+            return [
+                `BACKGROUND FEATURE`,
+                `  ${f.background.name}${descSnippet ? `: ${descSnippet}` : ""}`,
+                ``,
+            ];
+        })()),
+    ];
+}
+//# sourceMappingURL=features.js.map

package/dist/tools/character/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../../src/tools/character/features.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/helpers.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Primitive helpers shared across the character module.
+ *
+ * Phase 1 of the character.ts refactor — see docs/character-refactor.md.
+ * No business logic — pure type/string/number utilities.
+ */
+import type { Mod, ProficiencyMod, ExpertiseMod, HalfProficiencyMod, BonusMod, SetMod, SetBaseMod, SenseMod, ResistanceMod, ImmunityMod, VulnerabilityMod, LanguageMod } from "./types.js";
+export declare const str: (v: unknown) => string;
+export declare const num: (v: unknown) => number;
+export declare const arr: <T>(v: unknown) => T[];
+export declare const obj: (v: unknown) => Record<string, unknown>;
+export declare const signed: (n: number) => string;
+export declare const modOf: (score: number) => number;
+export declare const capitalize: (s: string) => string;
+/**
+ * Lightweight HTML strip + whitespace collapse. Used for character snippets
+ * (one-line summaries). For full HTML stripping with entity decoding, see
+ * `stripHtml` in `src/utils.ts`.
+ */
+export declare const stripHtml: (s: string) => string;
+/** Returns true if the feat has the given category tagName. */
+export declare const hasTag: (feat: Mod, tag: string) => boolean;
+export declare const isProficiencyMod: (m: Mod) => m is Mod & ProficiencyMod;
+export declare const isExpertiseMod: (m: Mod) => m is Mod & ExpertiseMod;
+export declare const isHalfProficiencyMod: (m: Mod) => m is Mod & HalfProficiencyMod;
+export declare const isBonusMod: (m: Mod) => m is Mod & BonusMod;
+export declare const isSetMod: (m: Mod) => m is Mod & SetMod;
+export declare const isSetBaseMod: (m: Mod) => m is Mod & SetBaseMod;
+export declare const isSenseMod: (m: Mod) => m is Mod & SenseMod;
+export declare const isResistanceMod: (m: Mod) => m is Mod & ResistanceMod;
+export declare const isImmunityMod: (m: Mod) => m is Mod & ImmunityMod;
+export declare const isVulnerabilityMod: (m: Mod) => m is Mod & VulnerabilityMod;
+export declare const isLanguageMod: (m: Mod) => m is Mod & LanguageMod;
+/**
+ * True if any class entry is a Champion Fighter at level 7+ — the
+ * threshold at which the Remarkable Athlete feature kicks in. DDB does
+ * NOT emit a `half-proficiency` modifier for Remarkable Athlete (the way
+ * it does for Bard's Jack of All Trades), so this predicate is the only
+ * way to detect the feature reliably. Used by:
+ *   - vitals.ts: adds half prof to initiative
+ *   - stats.ts:  adds half prof to non-proficient STR/DEX/CON skills
+ *
+ * Detection accepts both shapes DDB has used for subclassDefinition
+ * (`{ name: "..." }` and `{ definition: { name: "..." } }`).
+ */
+export declare function hasRemarkableAthlete(classes: ReadonlyArray<Record<string, unknown>>): boolean;
+/** Display labels for the six ability scores, in canonical order. */
+export declare const statNames: string[];
+/** Internal slugs for the six ability scores, in canonical order (matches statNames). */
+export declare const statKeys: string[];
+/**
+ * Levenshtein edit distance between two strings. Used by character-name
+ * fuzzy resolution (character.ts) and definition-query matching
+ * (definition.ts).
+ */
+export declare function levenshteinDistance(a: string, b: string): number;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/character/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/character/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3L,eAAO,MAAM,GAAG,GAAI,GAAG,OAAO,KAAG,MAAsC,CAAC;AACxE,eAAO,MAAM,GAAG,GAAI,GAAG,OAAO,KAAG,MAAyC,CAAC;AAC3E,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,GAAG,OAAO,KAAG,CAAC,EAA0C,CAAC;AAChF,eAAO,MAAM,GAAG,GAAI,GAAG,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAEd,CAAC;AAE1C,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAqC,CAAC;AACzE,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,KAAG,MAAsC,CAAC;AAC7E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,MAAgD,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MACiB,CAAC;AAExD,+DAA+D;AAC/D,eAAO,MAAM,MAAM,GAAI,MAAM,GAAG,EAAE,KAAK,MAAM,KAAG,OAC4C,CAAC;AAO7F,eAAO,MAAM,gBAAgB,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,cACM,CAAC;AAE5D,eAAO,MAAM,cAAc,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,YACM,CAAC;AAE1D,eAAO,MAAM,oBAAoB,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,kBACO,CAAC;AAEjE,eAAO,MAAM,UAAU,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,QACM,CAAC;AAEtD,eAAO,MAAM,QAAQ,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,MACM,CAAC;AAEpD,eAAO,MAAM,YAAY,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,UACO,CAAC;AAEzD,eAAO,MAAM,UAAU,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,QACM,CAAC;AAEtD,eAAO,MAAM,eAAe,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,aACM,CAAC;AAE3D,eAAO,MAAM,aAAa,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,WACM,CAAC;AAEzD,eAAO,MAAM,kBAAkB,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,gBACM,CAAC;AAE9D,eAAO,MAAM,aAAa,GAAI,GAAG,GAAG,KAAG,CAAC,IAAI,GAAG,GAAG,WACM,CAAC;AAEzD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAM7F;AAED,qEAAqE;AACrE,eAAO,MAAM,SAAS,UAA6C,CAAC;AAEpE,yFAAyF;AACzF,eAAO,MAAM,QAAQ,UAAkF,CAAC;AAExG;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAahE"}

package/dist/tools/character/helpers.js

@@ -0,0 +1,80 @@
+/**
+ * Primitive helpers shared across the character module.
+ *
+ * Phase 1 of the character.ts refactor — see docs/character-refactor.md.
+ * No business logic — pure type/string/number utilities.
+ */
+export const str = (v) => (v != null ? String(v) : "");
+export const num = (v) => (typeof v === "number" ? v : 0);
+export const arr = (v) => (Array.isArray(v) ? v : []);
+export const obj = (v) => v != null && typeof v === "object" && !Array.isArray(v)
+    ? v : {};
+export const signed = (n) => (n >= 0 ? `+${n}` : `${n}`);
+export const modOf = (score) => Math.floor((score - 10) / 2);
+export const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+/**
+ * Lightweight HTML strip + whitespace collapse. Used for character snippets
+ * (one-line summaries). For full HTML stripping with entity decoding, see
+ * `stripHtml` in `src/utils.ts`.
+ */
+export const stripHtml = (s) => s.replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim();
+/** Returns true if the feat has the given category tagName. */
+export const hasTag = (feat, tag) => arr(obj(feat.definition).categories).some(c => c.tagName === tag);
+// ── Mod type guards (follow-up A) ─────────────────────────────────────────────
+// Narrow `Mod` (Record<string, unknown>) to the discriminated shapes in
+// `types.ts`. Each guard checks `type` and the fields the consumer reads, so
+// downstream code sees `subType: string` directly without a `str()` wrapper.
+export const isProficiencyMod = (m) => m.type === "proficiency" && typeof m.subType === "string";
+export const isExpertiseMod = (m) => m.type === "expertise" && typeof m.subType === "string";
+export const isHalfProficiencyMod = (m) => m.type === "half-proficiency" && typeof m.subType === "string";
+export const isBonusMod = (m) => m.type === "bonus" && typeof m.subType === "string";
+export const isSetMod = (m) => m.type === "set" && typeof m.subType === "string";
+export const isSetBaseMod = (m) => m.type === "set-base" && typeof m.subType === "string";
+export const isSenseMod = (m) => m.type === "sense" && typeof m.subType === "string";
+export const isResistanceMod = (m) => m.type === "resistance" && typeof m.subType === "string";
+export const isImmunityMod = (m) => m.type === "immunity" && typeof m.subType === "string";
+export const isVulnerabilityMod = (m) => m.type === "vulnerability" && typeof m.subType === "string";
+export const isLanguageMod = (m) => m.type === "language" && typeof m.subType === "string";
+/**
+ * True if any class entry is a Champion Fighter at level 7+ — the
+ * threshold at which the Remarkable Athlete feature kicks in. DDB does
+ * NOT emit a `half-proficiency` modifier for Remarkable Athlete (the way
+ * it does for Bard's Jack of All Trades), so this predicate is the only
+ * way to detect the feature reliably. Used by:
+ *   - vitals.ts: adds half prof to initiative
+ *   - stats.ts:  adds half prof to non-proficient STR/DEX/CON skills
+ *
+ * Detection accepts both shapes DDB has used for subclassDefinition
+ * (`{ name: "..." }` and `{ definition: { name: "..." } }`).
+ */
+export function hasRemarkableAthlete(classes) {
+    return classes.some(cls => {
+        const sub = obj(cls.subclassDefinition);
+        const subName = str(obj(sub.definition ?? cls.subclassDefinition).name || sub.name);
+        return /champion/i.test(subName) && num(cls.level) >= 7;
+    });
+}
+/** Display labels for the six ability scores, in canonical order. */
+export const statNames = ["STR", "DEX", "CON", "INT", "WIS", "CHA"];
+/** Internal slugs for the six ability scores, in canonical order (matches statNames). */
+export const statKeys = ["strength", "dexterity", "constitution", "intelligence", "wisdom", "charisma"];
+/**
+ * Levenshtein edit distance between two strings. Used by character-name
+ * fuzzy resolution (character.ts) and definition-query matching
+ * (definition.ts).
+ */
+export function levenshteinDistance(a, b) {
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    const matrix = Array.from({ length: a.length + 1 }, (_, i) => Array.from({ length: b.length + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)));
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost);
+        }
+    }
+    return matrix[a.length][b.length];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/character/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/tools/character/helpers.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/identity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Identity domain — name, race (with 2024 variant detection), class line,
+ * background, XP, inspiration. Owns the header block.
+ *
+ * Phase 3 of the character.ts refactor — see docs/character-refactor.md.
+ */
+import type { CoreStats } from "./types.js";
+export interface Identity {
+    charName: string;
+    race: string;
+    classLine: string;
+    totalLevel: number;
+    background: string;
+    xp: number;
+    inspiration: boolean;
+}
+export declare function computeIdentity(core: CoreStats): Identity;
+export declare function formatHeaderBlock(i: Identity): string[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/tools/character/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/tools/character/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;CACtB;AAoDD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,CAWzD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,EAAE,CAUvD"}

package/dist/tools/character/identity.js

@@ -0,0 +1,84 @@
+/**
+ * Identity domain — name, race (with 2024 variant detection), class line,
+ * background, XP, inspiration. Owns the header block.
+ *
+ * Phase 3 of the character.ts refactor — see docs/character-refactor.md.
+ */
+import { arr, num, obj, str } from "./helpers.js";
+/**
+ * 2024 races store the sub-selection (Elven Lineage, Fiendish Legacy, Giant
+ * Ancestry, Gnomish Lineage, …) in `char.options.race[]` rather than in the
+ * subRaceShortName field that 2014 characters use. The option name encodes
+ * the chosen variant — e.g. "Wood Elf Lineage", "Infernal Legacy",
+ * "Stone's Endurance (Stone Giant)". Pattern-match the suffix so this is
+ * generic across every 2024 race that follows the same naming convention.
+ *
+ * Note: 2024 Aasimar Celestial Revelation is *not* a creation-time choice —
+ * the player picks one of Heavenly Wings / Inner Radiance / Necrotic Shroud
+ * each time they transform, and `char.options.race` is empty for Aasimar.
+ * Header correctly shows just "Aasimar" with no parenthetical.
+ */
+function detectRaceVariant(char) {
+    for (const opt of arr(obj(char.options).race)) {
+        const name = str(obj(opt.definition).name).trim();
+        if (!name)
+            continue;
+        // "Wood Elf Lineage" / "High Elf Lineage" / "Drow Lineage"
+        //  / "Forest Gnome Lineage" / "Rock Gnome Lineage" / …
+        let m = name.match(/^(.+?)\s+Lineage$/);
+        if (m)
+            return m[1];
+        // "Infernal Legacy" / "Abyssal Legacy" / "Chthonic Legacy"
+        m = name.match(/^(.+?)\s+Legacy$/);
+        if (m)
+            return m[1];
+        // Giant Ancestry: "Stone's Endurance (Stone Giant)" etc.
+        m = name.match(/\(([A-Za-z]+)\s+Giant\)$/);
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+function deriveRace(char) {
+    const base = str(obj(char.race).fullName || obj(char.race).baseName);
+    const variant = detectRaceVariant(char);
+    if (!variant)
+        return base;
+    // Avoid "Wood Elf (Wood Elf)" if the base race name already mentions the
+    // variant (defensive — happens when fullName has been pre-decorated).
+    if (base.toLowerCase().includes(variant.toLowerCase()))
+        return base;
+    return `${base} (${variant})`;
+}
+function buildClassLine(classes) {
+    return classes.map(c => {
+        const def = obj(c.definition);
+        const sub = obj(c.subclassDefinition);
+        const lvl = num(c.level);
+        return sub.name ? `${def.name} (${sub.name}) ${lvl}` : `${def.name} ${lvl}`;
+    }).join(" / ");
+}
+export function computeIdentity(core) {
+    const { char, classes, totalLevel } = core;
+    return {
+        charName: str(char.name),
+        race: deriveRace(char),
+        classLine: buildClassLine(classes),
+        totalLevel,
+        background: str(obj(obj(char.background).definition).name),
+        xp: num(char.currentXp),
+        inspiration: !!char.inspiration,
+    };
+}
+export function formatHeaderBlock(i) {
+    return [
+        `═══════════════════════════════════════`,
+        `  ${i.charName}`,
+        `  ${i.race} | ${i.classLine} | Level ${i.totalLevel}`,
+        `  Background: ${i.background || "—"} | XP: ${i.xp}`,
+        `  Inspiration: ${i.inspiration ? "Yes" : "No"}`,
+        `═══════════════════════════════════════`,
+        ``,
+    ];
+}
+//# sourceMappingURL=identity.js.map

package/dist/tools/character/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/tools/character/identity.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/inventory.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Inventory domain — equipped armor, carried (non-weapon) items, attunement
+ * count, and currency. Owns the inventory block.
+ *
+ * Phase 8 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Weapons are intentionally excluded — they're surfaced in the ACTIONS
+ * block (Phase 6a). Equipped armor is shown separately with its AC value;
+ * everything else non-weapon is rolled into a single comma-separated
+ * INVENTORY line with ×N consolidation.
+ */
+import type { CoreStats } from "./types.js";
+export interface Inventory {
+    equippedNonWeapons: string[];
+    inventoryLine: string;
+    attuned: number;
+    currencyLine: string;
+}
+export declare function computeInventory(core: CoreStats): Inventory;
+export declare function formatInventoryBlock(inv: Inventory): string[];
+//# sourceMappingURL=inventory.d.ts.map

package/dist/tools/character/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../src/tools/character/inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAY,SAAS,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CA2B3D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAU7D"}

package/dist/tools/character/inventory.js

@@ -0,0 +1,61 @@
+/**
+ * Inventory domain — equipped armor, carried (non-weapon) items, attunement
+ * count, and currency. Owns the inventory block.
+ *
+ * Phase 8 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Weapons are intentionally excluded — they're surfaced in the ACTIONS
+ * block (Phase 6a). Equipped armor is shown separately with its AC value;
+ * everything else non-weapon is rolled into a single comma-separated
+ * INVENTORY line with ×N consolidation.
+ */
+import { num, obj, str } from "./helpers.js";
+function buildCurrencyLine(char) {
+    const currencies = obj(char.currencies);
+    return ["pp", "gp", "ep", "sp", "cp"]
+        .map(c => `${num(currencies[c])}${c}`)
+        .filter(c => !c.startsWith("0"))
+        .join(", ") || "none";
+}
+export function computeInventory(core) {
+    const { char, inventory } = core;
+    const equippedNonWeapons = [];
+    const carriedItems = new Map();
+    let attuned = 0;
+    for (const i of inventory) {
+        const def = obj(i.definition);
+        const iName = str(def.name);
+        const filterType = str(def.filterType);
+        const qty = num(i.quantity) || 1;
+        if (i.isAttuned)
+            attuned++;
+        if (i.equipped && filterType === "Armor") {
+            const ac2 = num(def.armorClass);
+            equippedNonWeapons.push(`${iName}${ac2 ? ` (AC ${ac2})` : ""}`);
+        }
+        else if (filterType !== "Weapon") {
+            carriedItems.set(iName, (carriedItems.get(iName) ?? 0) + qty);
+        }
+    }
+    const inventoryLine = [...carriedItems.entries()]
+        .map(([n, q]) => q > 1 ? `${n} ×${q}` : n)
+        .join(", ");
+    return {
+        equippedNonWeapons,
+        inventoryLine,
+        attuned,
+        currencyLine: buildCurrencyLine(char),
+    };
+}
+export function formatInventoryBlock(inv) {
+    return [
+        ...(inv.equippedNonWeapons.length
+            ? [`EQUIPPED`, ...inv.equippedNonWeapons.map(e => `  ${e}`), ``]
+            : []),
+        ...(inv.inventoryLine ? [`INVENTORY`, `  ${inv.inventoryLine}`, ``] : []),
+        `ATTUNEMENT: ${inv.attuned}/3 slots used`,
+        ``,
+        `CURRENCY: ${inv.currencyLine}`,
+    ];
+}
+//# sourceMappingURL=inventory.js.map

package/dist/tools/character/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../../src/tools/character/inventory.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/notes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Notes domain — personality traits, backstory, allies/organisations, and
+ * additional possessions/notes. Owns the notes block.
+ *
+ * Phase 8 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Uses the full `stripHtml` from `../../utils.js` (which decodes HTML
+ * entities) rather than the lightweight helpers version — backstory and
+ * traits frequently contain entities like `’` and `—`.
+ */
+import type { CoreStats } from "./types.js";
+export interface Notes {
+    traitLines: string[];
+    backstoryText: string | null;
+    allyLines: string[];
+    extraLines: string[];
+}
+export declare function computeNotes(core: CoreStats): Notes;
+export declare function formatNotesBlock(n: Notes): string[];
+//# sourceMappingURL=notes.d.ts.map

package/dist/tools/character/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../../src/tools/character/notes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAYD,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CA6BnD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,CAWnD"}

package/dist/tools/character/notes.js

@@ -0,0 +1,63 @@
+/**
+ * Notes domain — personality traits, backstory, allies/organisations, and
+ * additional possessions/notes. Owns the notes block.
+ *
+ * Phase 8 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Uses the full `stripHtml` from `../../utils.js` (which decodes HTML
+ * entities) rather than the lightweight helpers version — backstory and
+ * traits frequently contain entities like `’` and `—`.
+ */
+import { stripHtml } from "../../utils.js";
+import { obj, str } from "./helpers.js";
+const field = (v) => {
+    const s = stripHtml(str(v)).trim();
+    return s || null;
+};
+const labelled = (label, pad, v) => {
+    const t = field(v);
+    return t ? `  ${label.padEnd(pad)}${t}` : null;
+};
+export function computeNotes(core) {
+    const { char } = core;
+    const traits = obj(char.traits);
+    const notes = obj(char.notes);
+    const traitLines = [
+        labelled("Traits:", 13, traits.personalityTraits),
+        labelled("Ideals:", 13, traits.ideals),
+        labelled("Bonds:", 13, traits.bonds),
+        labelled("Flaws:", 13, traits.flaws),
+        labelled("Appearance:", 13, traits.appearance),
+    ].filter((l) => l !== null);
+    const allyLines = [
+        labelled("Allies:", 15, notes.allies),
+        labelled("Organisations:", 15, notes.organizations),
+    ].filter((l) => l !== null);
+    const extraLines = [
+        labelled("Possessions:", 13, notes.personalPossessions),
+        labelled("Other:", 13, notes.otherNotes),
+    ].filter((l) => l !== null);
+    return {
+        traitLines,
+        backstoryText: field(notes.backstory),
+        allyLines,
+        extraLines,
+    };
+}
+export function formatNotesBlock(n) {
+    const hasAny = n.traitLines.length || n.backstoryText || n.allyLines.length || n.extraLines.length;
+    if (!hasAny) {
+        return ["No notes or backstory have been recorded for this character."];
+    }
+    const out = [];
+    if (n.traitLines.length)
+        out.push("PERSONALITY", ...n.traitLines, "");
+    if (n.backstoryText)
+        out.push("BACKSTORY", `  ${n.backstoryText}`, "");
+    if (n.allyLines.length)
+        out.push("ALLIES & ORGANISATIONS", ...n.allyLines, "");
+    if (n.extraLines.length)
+        out.push("ADDITIONAL NOTES", ...n.extraLines, "");
+    return out;
+}
+//# sourceMappingURL=notes.js.map

package/dist/tools/character/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../../../src/tools/character/notes.ts"],"names":[],"mappings":"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"}

package/dist/tools/character/parse.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `parseCharacterData(raw, sections)` — the orchestrator.
+ *
+ * Phase 9 of the character.ts refactor — see docs/character-refactor.md.
+ *
+ * Every domain (identity, vitals, ac, stats, defenses, features, actions,
+ * spells, inventory, notes) computed once via `computeCoreStats`, then
+ * routed through `sections` to pick which blocks to render. No business
+ * logic lives here — only the section → block routing.
+ */
+import type { CharData, ParseSection } from "./types.js";
+export declare function parseCharacterData(raw: CharData, sections?: ParseSection): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/tools/character/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/tools/character/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAYzD,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,QAAQ,EACb,QAAQ,GAAE,YAAqB,GAC9B,MAAM,CAkER"}