@alpaca-software/40kdc-data 0.1.1 → 0.1.3

package/dist/import/rosterizer.js

@@ -0,0 +1,348 @@
+// --- 40K rulebook Classification§Designation conventions. -------------------
+// These pin the strings the adapter looks for. Tune them in one place if a
+// real Rosterizer export uses different labels.
+const CLS_ROSTER = "Roster";
+const CLS_FACTION = "Faction";
+const CLS_DETACHMENT = "Detachment";
+const CLS_UNIT = "Unit";
+const CLS_SQUAD = "Squad"; // alternative unit class some rulebooks use
+const CLS_WEAPON = "Weapon";
+const CLS_ENHANCEMENT = "Enhancement";
+const CLS_BATTLE_SIZE = "Battle Size";
+const CLS_TRAIT = "Trait";
+const DSG_WARLORD = "Warlord";
+const CHAR_CLASSIFICATIONS = new Set(["Character", "Epic Hero"]);
+const POINTS_STAT_KEYS = ["Points", "Pts"];
+const POINTS_LIMIT = /(\d[\d,]*)\s*Point/i;
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function asObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function asString(value) {
+    return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value === "string") {
+        const n = Number.parseFloat(value);
+        return Number.isFinite(n) ? n : null;
+    }
+    return null;
+}
+/** Split `Classification§Designation` into its two halves. Falls back to the
+ * raw `classification`/`designation` fields when `item` is absent. */
+function splitItem(asset) {
+    const item = asString(asset.item);
+    if (item !== null) {
+        const idx = item.indexOf("§"); // §
+        if (idx >= 0) {
+            return {
+                classification: item.slice(0, idx),
+                designation: item.slice(idx + 1),
+            };
+        }
+    }
+    return {
+        classification: asString(asset.classification) ?? "",
+        designation: asString(asset.designation) ?? "",
+    };
+}
+/** A user-facing display name for an asset: `name` override beats the
+ * designation parsed out of the `item` key. */
+function displayName(asset) {
+    return asString(asset.name) ?? splitItem(asset).designation;
+}
+function quantity(asset) {
+    const n = asNumber(asset.quantity);
+    return n !== null && n > 0 ? Math.trunc(n) : 1;
+}
+function included(asset) {
+    const a = asset.assets;
+    return asArray(a?.included);
+}
+function traits(asset) {
+    const a = asset.assets;
+    return asArray(a?.traits);
+}
+/** Points cost from `stats.Points.value` (or aliases) / `meta.points`, or null. */
+function pointsOf(asset) {
+    const stats = asObject(asset.stats);
+    if (stats) {
+        for (const key of POINTS_STAT_KEYS) {
+            const stat = asObject(stats[key]);
+            if (stat) {
+                const v = asNumber(stat.value);
+                if (v !== null)
+                    return Math.trunc(v);
+            }
+        }
+    }
+    const meta = asObject(asset.meta);
+    if (meta) {
+        const v = asNumber(meta.points);
+        if (v !== null)
+            return Math.trunc(v);
+    }
+    return null;
+}
+/** Depth-first visit of an asset and every included/trait descendant. */
+function walk(asset, visit) {
+    visit(asset);
+    for (const child of included(asset))
+        walk(child, visit);
+    for (const child of traits(asset))
+        walk(child, visit);
+}
+function classOf(asset) {
+    return splitItem(asset).classification;
+}
+function isUnitAsset(asset) {
+    const cls = classOf(asset);
+    return cls === CLS_UNIT || cls === CLS_SQUAD;
+}
+function isWeaponAsset(asset) {
+    const cls = classOf(asset);
+    // Match exact "Weapon", or any "<X> Weapon" classification (e.g. "Ranged Weapon").
+    return cls === CLS_WEAPON || cls.endsWith(` ${CLS_WEAPON}`);
+}
+function isEnhancementAsset(asset) {
+    return classOf(asset) === CLS_ENHANCEMENT;
+}
+function isCharacterAsset(asset) {
+    const keywords = asObject(asset.keywords);
+    if (keywords) {
+        for (const list of Object.values(keywords)) {
+            for (const kw of asArray(list)) {
+                if (typeof kw === "string" && CHAR_CLASSIFICATIONS.has(kw))
+                    return true;
+            }
+        }
+    }
+    // Any nested trait classified as Character also flags the unit.
+    for (const t of traits(asset)) {
+        if (CHAR_CLASSIFICATIONS.has(classOf(t)))
+            return true;
+        const dsg = displayName(t);
+        if (CHAR_CLASSIFICATIONS.has(dsg))
+            return true;
+    }
+    return false;
+}
+function isWarlordTrait(asset) {
+    const { classification, designation } = splitItem(asset);
+    if (designation === DSG_WARLORD)
+        return true;
+    return classification === CLS_TRAIT && designation === DSG_WARLORD;
+}
+/** Sum every Weapon/Enhancement-bearing leaf quantity to derive the unit's
+ * model count. Falls back to `quantity(unit)` when the tree has no per-model
+ * markers (single-model entries). */
+function modelCount(unit) {
+    // Rosterizer doesn't carve "model" out separately from "unit" the way
+    // BattleScribe does; the unit's own quantity is the model count for
+    // squads. For multi-model squads with explicit per-model children, each
+    // child unit-class asset's quantity contributes.
+    let nested = 0;
+    for (const child of included(unit)) {
+        if (isUnitAsset(child))
+            nested += quantity(child);
+    }
+    return nested > 0 ? nested : quantity(unit);
+}
+function parseUnit(unit) {
+    const wargear = [];
+    let enhancement_raw_name = null;
+    let enhancement_points = null;
+    let is_warlord = false;
+    for (const child of included(unit)) {
+        walk(child, (a) => {
+            if (isEnhancementAsset(a)) {
+                if (enhancement_raw_name === null) {
+                    enhancement_raw_name = displayName(a);
+                    enhancement_points = pointsOf(a);
+                }
+                return;
+            }
+            if (isWeaponAsset(a)) {
+                wargear.push({ raw_name: displayName(a), count: quantity(a) });
+            }
+        });
+    }
+    for (const t of traits(unit)) {
+        walk(t, (a) => {
+            if (isWarlordTrait(a))
+                is_warlord = true;
+        });
+    }
+    return {
+        raw_name: displayName(unit),
+        is_character: isCharacterAsset(unit),
+        model_count: modelCount(unit),
+        points: pointsOf(unit),
+        is_warlord,
+        enhancement_raw_name,
+        enhancement_points,
+        wargear,
+    };
+}
+/** Resolve the snapshot Asset tree from an envelope, preferring the explicit
+ * `snapshot` field but falling through to the history-present roster. */
+function snapshotOf(env) {
+    const snap = asObject(env.snapshot);
+    if (snap)
+        return snap;
+    const history = asObject(env.history);
+    const present = history && asObject(history.present);
+    if (present) {
+        const present_roster = asObject(present.roster);
+        if (present_roster)
+            return present_roster;
+    }
+    return null;
+}
+function isRosterizerEnvelope(decoded) {
+    const env = asObject(decoded);
+    if (!env)
+        return false;
+    if (!asObject(env.rulebook))
+        return false;
+    return snapshotOf(env) !== null;
+}
+/** Find the first child Asset with the given classification, if any. */
+function findChildByClass(asset, cls) {
+    for (const c of included(asset)) {
+        if (classOf(c) === cls)
+            return c;
+    }
+    return null;
+}
+function parseLimit(label) {
+    if (!label)
+        return null;
+    const match = POINTS_LIMIT.exec(label);
+    if (!match)
+        return null;
+    return Number.parseInt(match[1].replace(/,/g, ""), 10);
+}
+export const rosterizerAdapter = {
+    id: "rosterizer",
+    matches(decoded) {
+        return isRosterizerEnvelope(decoded);
+    },
+    parse(decoded) {
+        if (!isRosterizerEnvelope(decoded)) {
+            throw new Error("rosterizer: payload is not a Rosterizer roster envelope");
+        }
+        const snapshot = snapshotOf(decoded);
+        if (snapshot === null) {
+            throw new Error("rosterizer: envelope has no snapshot or history.present.roster");
+        }
+        // Treat the snapshot as the roster root regardless of its `item` value —
+        // some exports root at `Roster§Roster`, others at the faction itself.
+        const root = snapshot;
+        // Roster-level metadata children. Faction and detachment come from the
+        // first child Asset of their respective classification; battle size the
+        // same way. Walk the whole tree (rather than just root.assets.included)
+        // so nested-force shapes still pick up the markers.
+        let faction_raw_name = null;
+        let detachment_raw_name = null;
+        let battle_size_raw = null;
+        const factions = [];
+        walk(root, (a) => {
+            const cls = classOf(a);
+            if (cls === CLS_FACTION) {
+                const name = displayName(a);
+                if (!factions.includes(name))
+                    factions.push(name);
+                faction_raw_name ??= name;
+            }
+            else if (cls === CLS_DETACHMENT) {
+                detachment_raw_name ??= displayName(a);
+            }
+            else if (cls === CLS_BATTLE_SIZE) {
+                battle_size_raw ??= displayName(a);
+            }
+        });
+        // Allow the rulebook envelope to carry a battle-size override (e.g.
+        // `rulebook.notes: "2000 Point limit"`) — strictly optional.
+        if (battle_size_raw === null) {
+            const rulebook = asObject(decoded.rulebook);
+            // Intentionally not reading rulebook.notes — it may carry prose.
+            void rulebook;
+        }
+        // Collect units: any Unit/Squad asset anywhere in the tree, excluding
+        // ones nested under another unit (those are attached leaders we'll fold
+        // into leader_attachment via the resolver — but ParsedUnit doesn't model
+        // them yet, so for v1 every Unit asset becomes a top-level ParsedUnit).
+        const units = [];
+        const collectUnits = (a, underUnit) => {
+            if (isUnitAsset(a) && !underUnit) {
+                units.push(parseUnit(a));
+                for (const c of included(a))
+                    collectUnits(c, true);
+                for (const c of traits(a))
+                    collectUnits(c, true);
+                return;
+            }
+            if (isUnitAsset(a) && underUnit) {
+                // Nested unit (leader on a body, body on a leader, etc.) — emit it as
+                // its own top-level ParsedUnit so the resolver can match its id and
+                // the leader-attachment inference pass can link the two.
+                units.push(parseUnit(a));
+                return;
+            }
+            for (const c of included(a))
+                collectUnits(c, underUnit);
+            for (const c of traits(a))
+                collectUnits(c, underUnit);
+        };
+        collectUnits(root, false);
+        // Roster-level total: prefer an explicit Points stat on the root, else
+        // sum every unit's (base + enhancement) contribution.
+        const total_reported = pointsOf(root);
+        let total_computed = 0;
+        for (const u of units) {
+            total_computed += u.points ?? 0;
+            total_computed += u.enhancement_points ?? 0;
+        }
+        const env = decoded;
+        const rulebook = asObject(env.rulebook);
+        const generated_by = rulebook ? asString(rulebook.name) ?? asString(rulebook.url) : null;
+        const name = displayName(root) || asString(rulebook?.name) || "Imported roster";
+        return {
+            name,
+            generated_by,
+            faction_raw_name,
+            detachment_raw_name,
+            battle_size_raw,
+            declared_limit: parseLimit(battle_size_raw),
+            total_reported,
+            total_computed,
+            units,
+            multi_force: factions.length > 1,
+        };
+    },
+};
+// Internals re-exported for the symmetric exporter and unit tests.
+export const _internals = {
+    CLS_ROSTER,
+    CLS_FACTION,
+    CLS_DETACHMENT,
+    CLS_UNIT,
+    CLS_WEAPON,
+    CLS_ENHANCEMENT,
+    CLS_BATTLE_SIZE,
+    CLS_TRAIT,
+    DSG_WARLORD,
+    POINTS_STAT_KEYS,
+    splitItem,
+    displayName,
+    classOf,
+    findChildByClass,
+};
+//# sourceMappingURL=rosterizer.js.map

package/dist/import/rosterizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rosterizer.js","sourceRoot":"","sources":["../../src/import/rosterizer.ts"],"names":[],"mappings":"AA6BA,+EAA+E;AAC/E,2EAA2E;AAC3E,gDAAgD;AAEhD,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,cAAc,GAAG,YAAY,CAAC;AACpC,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,4CAA4C;AACvE,MAAM,UAAU,GAAG,QAAQ,CAAC;AAC5B,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,SAAS,GAAG,OAAO,CAAC;AAC1B,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;AAEjE,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC3C,MAAM,YAAY,GAAG,qBAAqB,CAAC;AA+C3C,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;sEACsE;AACtE,SAAS,SAAS,CAAC,KAAe;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;QACnC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,OAAO;gBACL,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAClC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;aACjC,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO;QACL,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE;QACpD,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;KAC/C,CAAC;AACJ,CAAC;AAED;+CAC+C;AAC/C,SAAS,WAAW,CAAC,KAAe;IAClC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;AAC9D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAe;IAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAe;IAC/B,MAAM,CAAC,GAAG,KAAK,CAAC,MAAsC,CAAC;IACvD,OAAO,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAe,CAAC;AAC5C,CAAC;AAED,SAAS,MAAM,CAAC,KAAe;IAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,MAAsC,CAAC;IACvD,OAAO,OAAO,CAAC,CAAC,EAAE,MAAM,CAAe,CAAC;AAC1C,CAAC;AAED,mFAAmF;AACnF,SAAS,QAAQ,CAAC,KAAe;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAmB,CAAC;YACpD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC/B,IAAI,CAAC,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,SAAS,IAAI,CAAC,KAAe,EAAE,KAA4B;IACzD,KAAK,CAAC,KAAK,CAAC,CAAC;IACb,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,OAAO,CAAC,KAAe;IAC9B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,KAAe;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,SAAS,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,mFAAmF;IACnF,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAe;IACzC,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,eAAe,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe;IACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,IAAI,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IACD,gEAAgE;IAChE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtD,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAe;IACrC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,WAAW,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,cAAc,KAAK,SAAS,IAAI,WAAW,KAAK,WAAW,CAAC;AACrE,CAAC;AAED;;qCAEqC;AACrC,SAAS,UAAU,CAAC,IAAc;IAChC,sEAAsE;IACtE,oEAAoE;IACpE,wEAAwE;IACxE,iDAAiD;IACjD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,WAAW,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,UAAU,GAAG,KAAK,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YAChB,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1B,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;oBAClC,oBAAoB,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;oBACtC,kBAAkB,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACZ,IAAI,cAAc,CAAC,CAAC,CAAC;gBAAE,UAAU,GAAG,IAAI,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC;QAC3B,YAAY,EAAE,gBAAgB,CAAC,IAAI,CAAC;QACpC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC;QAC7B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;QACtB,UAAU;QACV,oBAAoB;QACpB,kBAAkB;QAClB,OAAO;KACR,CAAC;AACJ,CAAC;AAED;yEACyE;AACzE,SAAS,UAAU,CAAC,GAAgB;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,IAAI;QAAE,OAAO,IAAgB,CAAC;IAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAsB,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,QAAQ,CAAE,OAA0B,CAAC,MAAM,CAAC,CAAC;QACpE,IAAI,cAAc;YAAE,OAAO,cAA0B,CAAC;IACxD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAgB;IAC5C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAuB,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;AAClC,CAAC;AAED,wEAAwE;AACxE,SAAS,gBAAgB,CAAC,KAAe,EAAE,GAAW;IACpD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAoB;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,EAAE,EAAE,YAAY;IAEhB,OAAO,CAAC,OAAgB;QACtB,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAgB;QACpB,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,yEAAyE;QACzE,sEAAsE;QACtE,MAAM,IAAI,GAAG,QAAQ,CAAC;QAEtB,uEAAuE;QACvE,wEAAwE;QACxE,wEAAwE;QACxE,oDAAoD;QACpD,IAAI,gBAAgB,GAAkB,IAAI,CAAC;QAC3C,IAAI,mBAAmB,GAAkB,IAAI,CAAC;QAC9C,IAAI,eAAe,GAAkB,IAAI,CAAC;QAC1C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE;YACf,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,gBAAgB,KAAK,IAAI,CAAC;YAC5B,CAAC;iBAAM,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;gBAClC,mBAAmB,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;YACzC,CAAC;iBAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;gBACnC,eAAe,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oEAAoE;QACpE,6DAA6D;QAC7D,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAE,OAAuB,CAAC,QAAQ,CAAuB,CAAC;YACnF,iEAAiE;YACjE,KAAK,QAAQ,CAAC;QAChB,CAAC;QAED,sEAAsE;QACtE,wEAAwE;QACxE,yEAAyE;QACzE,wEAAwE;QACxE,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,MAAM,YAAY,GAAG,CAAC,CAAW,EAAE,SAAkB,EAAQ,EAAE;YAC7D,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;oBAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACnD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;oBAAE,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;gBAChC,sEAAsE;gBACtE,oEAAoE;gBACpE,yDAAyD;gBACzD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;gBAAE,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;gBAAE,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE1B,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,cAAc,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;YAChC,cAAc,IAAI,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,GAAG,GAAG,OAAsB,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAuB,CAAC;QAC9D,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,iBAAiB,CAAC;QAEhF,OAAO;YACL,IAAI;YACJ,YAAY;YACZ,gBAAgB;YAChB,mBAAmB;YACnB,eAAe;YACf,cAAc,EAAE,UAAU,CAAC,eAAe,CAAC;YAC3C,cAAc;YACd,cAAc;YACd,KAAK;YACL,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC;SACjC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,mEAAmE;AACnE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU;IACV,WAAW;IACX,cAAc;IACd,QAAQ;IACR,UAAU;IACV,eAAe;IACf,eAAe;IACf,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,SAAS;IACT,WAAW;IACX,OAAO;IACP,gBAAgB;CACjB,CAAC","sourcesContent":["/**\n * Rosterizer adapter: lower a Rosterizer roster JSON payload to a\n * {@link ParsedRoster}.\n *\n * Rosterizer (https://rosterizer.com) stores a roster as a `Roster` envelope\n * with a recursive `Asset` tree under `snapshot` (or `history.present.roster`\n * as a fallback). Every entity — faction, detachment, unit, weapon, ability,\n * enhancement — is an `Asset` keyed by `Classification§Designation` (e.g.\n * `\"Unit§Tactical Squad\"`). Children sit under `assets.included` (game pieces)\n * and `assets.traits` (modifiers, abilities, markers).\n *\n * The schema is rulebook-agnostic, so the actual `Classification` strings come\n * from whichever Rosterizer rulebook authored the roster. The constants below\n * encode the 40K convention used by the consortium's reference rulebook; tune\n * them here without touching parser logic if a real export disagrees.\n *\n * **IP safety**: the walk reads an ALLOWLIST — `item`, `designation`, `name`,\n * `classification`, `quantity`, `meta.points`, `stats.Points.value`,\n * `aspects.Visibility`, and the recursive `assets.included`/`assets.traits`\n * children. Prose-bearing fields — `text`, `description`, `rules`, ability\n * `stats`, `_layers`, `lineage`, `processed`, `classIdentity`, `bareResourceKey`\n * — are never touched, so the importer's output is free of copyrighted prose\n * by construction.\n *\n * @packageDocumentation\n */\nimport type { FormatAdapter } from \"./adapter.js\";\nimport type { ParsedRoster, ParsedUnit, ParsedWargear } from \"./types.js\";\n\n// --- 40K rulebook Classification§Designation conventions. -------------------\n// These pin the strings the adapter looks for. Tune them in one place if a\n// real Rosterizer export uses different labels.\n\nconst CLS_ROSTER = \"Roster\";\nconst CLS_FACTION = \"Faction\";\nconst CLS_DETACHMENT = \"Detachment\";\nconst CLS_UNIT = \"Unit\";\nconst CLS_SQUAD = \"Squad\"; // alternative unit class some rulebooks use\nconst CLS_WEAPON = \"Weapon\";\nconst CLS_ENHANCEMENT = \"Enhancement\";\nconst CLS_BATTLE_SIZE = \"Battle Size\";\nconst CLS_TRAIT = \"Trait\";\nconst DSG_WARLORD = \"Warlord\";\nconst CHAR_CLASSIFICATIONS = new Set([\"Character\", \"Epic Hero\"]);\n\nconst POINTS_STAT_KEYS = [\"Points\", \"Pts\"];\nconst POINTS_LIMIT = /(\\d[\\d,]*)\\s*Point/i;\n\n// --- Structural views ------------------------------------------------------\n\ninterface RawStat {\n  value?: unknown;\n}\ninterface RawAspects {\n  Visibility?: unknown;\n}\ninterface RawAssetChildren {\n  included?: unknown;\n  traits?: unknown;\n}\ninterface RawAsset {\n  item?: unknown;\n  name?: unknown;\n  designation?: unknown;\n  classification?: unknown;\n  quantity?: unknown;\n  aspects?: unknown;\n  assets?: unknown;\n  meta?: unknown;\n  stats?: unknown;\n  keywords?: unknown;\n}\ninterface RawRulebook {\n  name?: unknown;\n  game?: unknown;\n  publisher?: unknown;\n  url?: unknown;\n}\ninterface RawHistoryItem {\n  roster?: unknown;\n  note?: unknown;\n}\ninterface RawHistory {\n  present?: unknown;\n}\ninterface RawEnvelope {\n  rulebook?: unknown;\n  snapshot?: unknown;\n  history?: unknown;\n  slug?: unknown;\n  authors?: unknown;\n}\n\nfunction asArray(value: unknown): unknown[] {\n  return Array.isArray(value) ? value : [];\n}\n\nfunction asObject(value: unknown): Record<string, unknown> | null {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction asNumber(value: unknown): number | null {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\") {\n    const n = Number.parseFloat(value);\n    return Number.isFinite(n) ? n : null;\n  }\n  return null;\n}\n\n/** Split `Classification§Designation` into its two halves. Falls back to the\n * raw `classification`/`designation` fields when `item` is absent. */\nfunction splitItem(asset: RawAsset): { classification: string; designation: string } {\n  const item = asString(asset.item);\n  if (item !== null) {\n    const idx = item.indexOf(\"§\"); // §\n    if (idx >= 0) {\n      return {\n        classification: item.slice(0, idx),\n        designation: item.slice(idx + 1),\n      };\n    }\n  }\n  return {\n    classification: asString(asset.classification) ?? \"\",\n    designation: asString(asset.designation) ?? \"\",\n  };\n}\n\n/** A user-facing display name for an asset: `name` override beats the\n * designation parsed out of the `item` key. */\nfunction displayName(asset: RawAsset): string {\n  return asString(asset.name) ?? splitItem(asset).designation;\n}\n\nfunction quantity(asset: RawAsset): number {\n  const n = asNumber(asset.quantity);\n  return n !== null && n > 0 ? Math.trunc(n) : 1;\n}\n\nfunction included(asset: RawAsset): RawAsset[] {\n  const a = asset.assets as RawAssetChildren | undefined;\n  return asArray(a?.included) as RawAsset[];\n}\n\nfunction traits(asset: RawAsset): RawAsset[] {\n  const a = asset.assets as RawAssetChildren | undefined;\n  return asArray(a?.traits) as RawAsset[];\n}\n\n/** Points cost from `stats.Points.value` (or aliases) / `meta.points`, or null. */\nfunction pointsOf(asset: RawAsset): number | null {\n  const stats = asObject(asset.stats);\n  if (stats) {\n    for (const key of POINTS_STAT_KEYS) {\n      const stat = asObject(stats[key]) as RawStat | null;\n      if (stat) {\n        const v = asNumber(stat.value);\n        if (v !== null) return Math.trunc(v);\n      }\n    }\n  }\n  const meta = asObject(asset.meta);\n  if (meta) {\n    const v = asNumber(meta.points);\n    if (v !== null) return Math.trunc(v);\n  }\n  return null;\n}\n\n/** Depth-first visit of an asset and every included/trait descendant. */\nfunction walk(asset: RawAsset, visit: (a: RawAsset) => void): void {\n  visit(asset);\n  for (const child of included(asset)) walk(child, visit);\n  for (const child of traits(asset)) walk(child, visit);\n}\n\nfunction classOf(asset: RawAsset): string {\n  return splitItem(asset).classification;\n}\n\nfunction isUnitAsset(asset: RawAsset): boolean {\n  const cls = classOf(asset);\n  return cls === CLS_UNIT || cls === CLS_SQUAD;\n}\n\nfunction isWeaponAsset(asset: RawAsset): boolean {\n  const cls = classOf(asset);\n  // Match exact \"Weapon\", or any \"<X> Weapon\" classification (e.g. \"Ranged Weapon\").\n  return cls === CLS_WEAPON || cls.endsWith(` ${CLS_WEAPON}`);\n}\n\nfunction isEnhancementAsset(asset: RawAsset): boolean {\n  return classOf(asset) === CLS_ENHANCEMENT;\n}\n\nfunction isCharacterAsset(asset: RawAsset): boolean {\n  const keywords = asObject(asset.keywords);\n  if (keywords) {\n    for (const list of Object.values(keywords)) {\n      for (const kw of asArray(list)) {\n        if (typeof kw === \"string\" && CHAR_CLASSIFICATIONS.has(kw)) return true;\n      }\n    }\n  }\n  // Any nested trait classified as Character also flags the unit.\n  for (const t of traits(asset)) {\n    if (CHAR_CLASSIFICATIONS.has(classOf(t))) return true;\n    const dsg = displayName(t);\n    if (CHAR_CLASSIFICATIONS.has(dsg)) return true;\n  }\n  return false;\n}\n\nfunction isWarlordTrait(asset: RawAsset): boolean {\n  const { classification, designation } = splitItem(asset);\n  if (designation === DSG_WARLORD) return true;\n  return classification === CLS_TRAIT && designation === DSG_WARLORD;\n}\n\n/** Sum every Weapon/Enhancement-bearing leaf quantity to derive the unit's\n * model count. Falls back to `quantity(unit)` when the tree has no per-model\n * markers (single-model entries). */\nfunction modelCount(unit: RawAsset): number {\n  // Rosterizer doesn't carve \"model\" out separately from \"unit\" the way\n  // BattleScribe does; the unit's own quantity is the model count for\n  // squads. For multi-model squads with explicit per-model children, each\n  // child unit-class asset's quantity contributes.\n  let nested = 0;\n  for (const child of included(unit)) {\n    if (isUnitAsset(child)) nested += quantity(child);\n  }\n  return nested > 0 ? nested : quantity(unit);\n}\n\nfunction parseUnit(unit: RawAsset): ParsedUnit {\n  const wargear: ParsedWargear[] = [];\n  let enhancement_raw_name: string | null = null;\n  let enhancement_points: number | null = null;\n  let is_warlord = false;\n\n  for (const child of included(unit)) {\n    walk(child, (a) => {\n      if (isEnhancementAsset(a)) {\n        if (enhancement_raw_name === null) {\n          enhancement_raw_name = displayName(a);\n          enhancement_points = pointsOf(a);\n        }\n        return;\n      }\n      if (isWeaponAsset(a)) {\n        wargear.push({ raw_name: displayName(a), count: quantity(a) });\n      }\n    });\n  }\n  for (const t of traits(unit)) {\n    walk(t, (a) => {\n      if (isWarlordTrait(a)) is_warlord = true;\n    });\n  }\n\n  return {\n    raw_name: displayName(unit),\n    is_character: isCharacterAsset(unit),\n    model_count: modelCount(unit),\n    points: pointsOf(unit),\n    is_warlord,\n    enhancement_raw_name,\n    enhancement_points,\n    wargear,\n  };\n}\n\n/** Resolve the snapshot Asset tree from an envelope, preferring the explicit\n * `snapshot` field but falling through to the history-present roster. */\nfunction snapshotOf(env: RawEnvelope): RawAsset | null {\n  const snap = asObject(env.snapshot);\n  if (snap) return snap as RawAsset;\n  const history = asObject(env.history) as RawHistory | null;\n  const present = history && asObject(history.present);\n  if (present) {\n    const present_roster = asObject((present as RawHistoryItem).roster);\n    if (present_roster) return present_roster as RawAsset;\n  }\n  return null;\n}\n\nfunction isRosterizerEnvelope(decoded: unknown): decoded is RawEnvelope {\n  const env = asObject(decoded) as RawEnvelope | null;\n  if (!env) return false;\n  if (!asObject(env.rulebook)) return false;\n  return snapshotOf(env) !== null;\n}\n\n/** Find the first child Asset with the given classification, if any. */\nfunction findChildByClass(asset: RawAsset, cls: string): RawAsset | null {\n  for (const c of included(asset)) {\n    if (classOf(c) === cls) return c;\n  }\n  return null;\n}\n\nfunction parseLimit(label: string | null): number | null {\n  if (!label) return null;\n  const match = POINTS_LIMIT.exec(label);\n  if (!match) return null;\n  return Number.parseInt(match[1].replace(/,/g, \"\"), 10);\n}\n\nexport const rosterizerAdapter: FormatAdapter = {\n  id: \"rosterizer\",\n\n  matches(decoded: unknown): boolean {\n    return isRosterizerEnvelope(decoded);\n  },\n\n  parse(decoded: unknown): ParsedRoster {\n    if (!isRosterizerEnvelope(decoded)) {\n      throw new Error(\"rosterizer: payload is not a Rosterizer roster envelope\");\n    }\n    const snapshot = snapshotOf(decoded);\n    if (snapshot === null) {\n      throw new Error(\"rosterizer: envelope has no snapshot or history.present.roster\");\n    }\n\n    // Treat the snapshot as the roster root regardless of its `item` value —\n    // some exports root at `Roster§Roster`, others at the faction itself.\n    const root = snapshot;\n\n    // Roster-level metadata children. Faction and detachment come from the\n    // first child Asset of their respective classification; battle size the\n    // same way. Walk the whole tree (rather than just root.assets.included)\n    // so nested-force shapes still pick up the markers.\n    let faction_raw_name: string | null = null;\n    let detachment_raw_name: string | null = null;\n    let battle_size_raw: string | null = null;\n    const factions: string[] = [];\n    walk(root, (a) => {\n      const cls = classOf(a);\n      if (cls === CLS_FACTION) {\n        const name = displayName(a);\n        if (!factions.includes(name)) factions.push(name);\n        faction_raw_name ??= name;\n      } else if (cls === CLS_DETACHMENT) {\n        detachment_raw_name ??= displayName(a);\n      } else if (cls === CLS_BATTLE_SIZE) {\n        battle_size_raw ??= displayName(a);\n      }\n    });\n\n    // Allow the rulebook envelope to carry a battle-size override (e.g.\n    // `rulebook.notes: \"2000 Point limit\"`) — strictly optional.\n    if (battle_size_raw === null) {\n      const rulebook = asObject((decoded as RawEnvelope).rulebook) as RawRulebook | null;\n      // Intentionally not reading rulebook.notes — it may carry prose.\n      void rulebook;\n    }\n\n    // Collect units: any Unit/Squad asset anywhere in the tree, excluding\n    // ones nested under another unit (those are attached leaders we'll fold\n    // into leader_attachment via the resolver — but ParsedUnit doesn't model\n    // them yet, so for v1 every Unit asset becomes a top-level ParsedUnit).\n    const units: ParsedUnit[] = [];\n    const collectUnits = (a: RawAsset, underUnit: boolean): void => {\n      if (isUnitAsset(a) && !underUnit) {\n        units.push(parseUnit(a));\n        for (const c of included(a)) collectUnits(c, true);\n        for (const c of traits(a)) collectUnits(c, true);\n        return;\n      }\n      if (isUnitAsset(a) && underUnit) {\n        // Nested unit (leader on a body, body on a leader, etc.) — emit it as\n        // its own top-level ParsedUnit so the resolver can match its id and\n        // the leader-attachment inference pass can link the two.\n        units.push(parseUnit(a));\n        return;\n      }\n      for (const c of included(a)) collectUnits(c, underUnit);\n      for (const c of traits(a)) collectUnits(c, underUnit);\n    };\n    collectUnits(root, false);\n\n    // Roster-level total: prefer an explicit Points stat on the root, else\n    // sum every unit's (base + enhancement) contribution.\n    const total_reported = pointsOf(root);\n    let total_computed = 0;\n    for (const u of units) {\n      total_computed += u.points ?? 0;\n      total_computed += u.enhancement_points ?? 0;\n    }\n\n    const env = decoded as RawEnvelope;\n    const rulebook = asObject(env.rulebook) as RawRulebook | null;\n    const generated_by = rulebook ? asString(rulebook.name) ?? asString(rulebook.url) : null;\n    const name = displayName(root) || asString(rulebook?.name) || \"Imported roster\";\n\n    return {\n      name,\n      generated_by,\n      faction_raw_name,\n      detachment_raw_name,\n      battle_size_raw,\n      declared_limit: parseLimit(battle_size_raw),\n      total_reported,\n      total_computed,\n      units,\n      multi_force: factions.length > 1,\n    };\n  },\n};\n\n// Internals re-exported for the symmetric exporter and unit tests.\nexport const _internals = {\n  CLS_ROSTER,\n  CLS_FACTION,\n  CLS_DETACHMENT,\n  CLS_UNIT,\n  CLS_WEAPON,\n  CLS_ENHANCEMENT,\n  CLS_BATTLE_SIZE,\n  CLS_TRAIT,\n  DSG_WARLORD,\n  POINTS_STAT_KEYS,\n  splitItem,\n  displayName,\n  classOf,\n  findChildByClass,\n};\n"]}

package/dist/import/types.d.ts

@@ -53,15 +53,21 @@ export interface RosterLeaderAttachment {
 export interface RosterUnit {
     ref: ResolvedRef;
     model_count: number;
+    /** Base unit cost (without the enhancement). */
     points: number | null;
     is_warlord: boolean;
     enhancement: ResolvedRef | null;
+    /** Points cost of the enhancement when the source reported one; null otherwise. */
+    enhancement_points: number | null;
     wargear: RosterWargear[];
     leader_attachment: RosterLeaderAttachment | null;
 }
+/** Identifier for the adapter that produced this roster. New format adapters
+ * extend this union; `roster.schema.json` keeps the canonical enum. */
+export type RosterFormat = "listforge" | "newrecruit-json" | "newrecruit-wtc-compact" | "newrecruit-wtc-full" | "newrecruit-simple" | "rosterizer" | "gw";
 /** Provenance of the imported list. */
 export interface RosterSource {
-    format: "listforge";
+    format: RosterFormat;
     generated_by: string | null;
 }
 /** Point totals; reported and computed are kept distinct, never reconciled. */
@@ -112,9 +118,12 @@ export interface ParsedUnit {
     /** True when the source classifies this as a character/leader-capable model. */
     is_character: boolean;
     model_count: number;
+    /** Base unit cost (without the enhancement). */
     points: number | null;
     is_warlord: boolean;
     enhancement_raw_name: string | null;
+    /** Points cost of the enhancement when the source reported one; null otherwise. */
+    enhancement_points: number | null;
     wargear: ParsedWargear[];
 }
 /**
@@ -141,3 +150,4 @@ export interface ParsedRoster {
     /** True when the source contained more than one distinct faction. */
     multi_force: boolean;
 }
+//# sourceMappingURL=types.d.ts.map

package/dist/import/types.d.ts.map

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

package/dist/import/types.js

@@ -17,3 +17,4 @@
  * @packageDocumentation
  */
 export {};
+//# sourceMappingURL=types.js.map

package/dist/import/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/import/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG","sourcesContent":["/**\n * Types for the army-list importer.\n *\n * Two layers live here:\n * - The **output** types ({@link Roster} and friends) mirror\n *   `schemas/core/roster.schema.json` field-for-field. They are hand-authored\n *   rather than generated so importer work isn't gated on the Rust→typify codegen\n *   round-trip; the AJV validator (against the real schema) is the source of truth\n *   for conformance.\n * - The **intermediate** type ({@link ParsedRoster}) is format-agnostic: a parser\n *   adapter lowers a source payload to this shape (raw names + counts only, no\n *   resolved ids), and {@link resolve} turns it into a {@link Roster}.\n *\n * Nothing here ever carries reproduced rules or ability text — only permitted\n * facts (names, counts, points, keywords, entity ids).\n *\n * @packageDocumentation\n */\n\n/** A 40kdc battle size (mirrors the shared `battle-size` def). */\nexport type BattleSize = \"incursion\" | \"strike-force\";\n\n/** Diagnostic warning codes emitted during an import. */\nexport type WarningCode =\n  | \"faction-unresolved\"\n  | \"unit-unresolved\"\n  | \"weapon-unresolved\"\n  | \"enhancement-unresolved\"\n  | \"detachment-unresolved\"\n  | \"battle-size-unmapped\"\n  | \"points-mismatch\"\n  | \"leader-attachment-inferred\"\n  | \"multi-force\"\n  | \"unknown-field\";\n\n// ---------------------------------------------------------------------------\n// Output types (mirror roster.schema.json)\n// ---------------------------------------------------------------------------\n\n/** A near-match suggestion offered when resolution fails. */\nexport interface Candidate {\n  id: string;\n  name: string;\n}\n\n/**\n * A reference to a 40kdc entity that may or may not have resolved. Retains the\n * source's raw name so the import is lossless even on a miss.\n */\nexport interface ResolvedRef {\n  /** Resolved entity id, or null when no match was found. */\n  id: string | null;\n  /** The display name exactly as it appeared in the source payload. */\n  raw_name: string;\n  /** True iff {@link id} is non-null. */\n  resolved: boolean;\n  /** Up to 5 best-guess alternatives when resolution failed. */\n  candidates: Candidate[];\n}\n\n/** A weapon/wargear selection on a unit. */\nexport interface RosterWargear {\n  ref: ResolvedRef;\n  count: number;\n}\n\n/** An inferred, always-provisional leader→bodyguard attachment. */\nexport interface RosterLeaderAttachment {\n  bodyguard_ref: ResolvedRef;\n  provisional: boolean;\n}\n\n/** One unit entry in a roster. */\nexport interface RosterUnit {\n  ref: ResolvedRef;\n  model_count: number;\n  /** Base unit cost (without the enhancement). */\n  points: number | null;\n  is_warlord: boolean;\n  enhancement: ResolvedRef | null;\n  /** Points cost of the enhancement when the source reported one; null otherwise. */\n  enhancement_points: number | null;\n  wargear: RosterWargear[];\n  leader_attachment: RosterLeaderAttachment | null;\n}\n\n/** Identifier for the adapter that produced this roster. New format adapters\n * extend this union; `roster.schema.json` keeps the canonical enum. */\nexport type RosterFormat =\n  | \"listforge\"\n  | \"newrecruit-json\"\n  | \"newrecruit-wtc-compact\"\n  | \"newrecruit-wtc-full\"\n  | \"newrecruit-simple\"\n  | \"rosterizer\"\n  | \"gw\";\n\n/** Provenance of the imported list. */\nexport interface RosterSource {\n  format: RosterFormat;\n  generated_by: string | null;\n}\n\n/** Point totals; reported and computed are kept distinct, never reconciled. */\nexport interface RosterPoints {\n  declared_limit: number | null;\n  total_reported: number | null;\n  total_computed: number;\n}\n\n/** A single diagnostic warning. */\nexport interface Warning {\n  code: WarningCode;\n  message: string;\n  raw_name: string | null;\n}\n\n/** A summary of what resolved and what did not during the import. */\nexport interface Diagnostics {\n  resolved_units: number;\n  unresolved_units: number;\n  resolved_weapons: number;\n  unresolved_weapons: number;\n  warnings: Warning[];\n}\n\n/** Reference to the game edition + dataslate (mirrors game-version-ref). */\nexport interface GameVersionRef {\n  edition: string;\n  dataslate: string;\n}\n\n/** A fully-resolved army list. Validates against `roster.schema.json`. */\nexport interface Roster {\n  name: string;\n  source: RosterSource;\n  faction_id: string | null;\n  detachment_id: string | null;\n  battle_size: BattleSize | null;\n  points: RosterPoints;\n  units: RosterUnit[];\n  game_version: GameVersionRef;\n  diagnostics: Diagnostics;\n}\n\n// ---------------------------------------------------------------------------\n// Intermediate types (format-agnostic; produced by a parser adapter)\n// ---------------------------------------------------------------------------\n\n/** A weapon/wargear selection before id resolution. */\nexport interface ParsedWargear {\n  raw_name: string;\n  count: number;\n}\n\n/** A unit selection before id resolution. */\nexport interface ParsedUnit {\n  raw_name: string;\n  /** True when the source classifies this as a character/leader-capable model. */\n  is_character: boolean;\n  model_count: number;\n  /** Base unit cost (without the enhancement). */\n  points: number | null;\n  is_warlord: boolean;\n  enhancement_raw_name: string | null;\n  /** Points cost of the enhancement when the source reported one; null otherwise. */\n  enhancement_points: number | null;\n  wargear: ParsedWargear[];\n}\n\n/**\n * The format-agnostic intermediate. A {@link FormatAdapter} produces this from a\n * decoded source payload; {@link resolve} consumes it. Contains only raw display\n * names and counts — never reproduced rules text.\n */\nexport interface ParsedRoster {\n  name: string;\n  generated_by: string | null;\n  /** Raw faction name from the source (e.g. \"Grey Knights\"). */\n  faction_raw_name: string | null;\n  /** Raw detachment name (e.g. \"Banishers\"). */\n  detachment_raw_name: string | null;\n  /** Raw battle-size label (e.g. \"2. Strike Force (2000 Point limit)\"). */\n  battle_size_raw: string | null;\n  /** Points limit parsed from the battle-size label, if any. */\n  declared_limit: number | null;\n  /** Total points reported by the source cost block. */\n  total_reported: number | null;\n  /** Points summed from every cost line in the source tree. */\n  total_computed: number;\n  units: ParsedUnit[];\n  /** True when the source contained more than one distinct faction. */\n  multi_force: boolean;\n}\n"]}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export * from "./data/index.js";
 export * from "./generated.js";
 export { createValidator, findSchemaFiles, listSchemaIds, SCHEMAS_ROOT, } from "./schema-loader.js";
-export { importListForge, importRoster, decodeListForge } from "./import/index.js";
+export { importListForge, importNewRecruit, importRoster, tryImportRoster, decodeListForge, } from "./import/index.js";
+export { exportRoster, newRecruitJsonSerializer, newRecruitSimpleSerializer, newRecruitWtcCompactSerializer, newRecruitWtcFullSerializer, rosterJsonSerializer, rosterizerSerializer, } from "./export/index.js";
+export type { ExportFormat, RosterSerializer } from "./export/index.js";
 export type { FormatAdapter } from "./import/index.js";
-export type { ImportOptions, Roster, RosterUnit, RosterWargear, RosterSource, RosterPoints, RosterLeaderAttachment, ResolvedRef, Candidate, Diagnostics, Warning, WarningCode, ParsedRoster, ParsedUnit, ParsedWargear, } from "./import/index.js";
+export type { ImportOptions, ImportResult, ImportFailureReason, AdapterTrial, Roster, RosterUnit, RosterWargear, RosterSource, RosterFormat, RosterPoints, RosterLeaderAttachment, ResolvedRef, Candidate, Diagnostics, Warning, WarningCode, ParsedRoster, ParsedUnit, ParsedWargear, } from "./import/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gBAAgB,CAAC;AAI/B,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,MAAM,EACN,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -8,4 +8,7 @@ export { createValidator, findSchemaFiles, listSchemaIds, SCHEMAS_ROOT, } from "
 // Army-list importer (ListForge → resolved 40kdc roster). Types are curated
 // rather than re-exported wholesale to avoid name clashes with generated types
 // (e.g. BattleSize, LeaderAttachment).
-export { importListForge, importRoster, decodeListForge } from "./import/index.js";
+export { importListForge, importNewRecruit, importRoster, tryImportRoster, decodeListForge, } from "./import/index.js";
+// Army-list exporter (Roster → text or JSON for any of the supported formats).
+export { exportRoster, newRecruitJsonSerializer, newRecruitSimpleSerializer, newRecruitWtcCompactSerializer, newRecruitWtcFullSerializer, rosterJsonSerializer, rosterizerSerializer, } from "./export/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,iBAAiB,CAAC;AAEhC,mDAAmD;AACnD,cAAc,gBAAgB,CAAC;AAE/B,8EAA8E;AAC9E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,4EAA4E;AAC5E,+EAA+E;AAC/E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC","sourcesContent":["// The linked, typed dataset — the primary entry point.\nexport * from \"./data/index.js\";\n\n// Generated types for every entity in the dataset.\nexport * from \"./generated.js\";\n\n// Schema access + AJV validation (secondary: this package also validates data\n// against the canonical JSON Schemas).\nexport {\n  createValidator,\n  findSchemaFiles,\n  listSchemaIds,\n  SCHEMAS_ROOT,\n} from \"./schema-loader.js\";\n\n// Army-list importer (ListForge → resolved 40kdc roster). Types are curated\n// rather than re-exported wholesale to avoid name clashes with generated types\n// (e.g. BattleSize, LeaderAttachment).\nexport {\n  importListForge,\n  importNewRecruit,\n  importRoster,\n  tryImportRoster,\n  decodeListForge,\n} from \"./import/index.js\";\n\n// Army-list exporter (Roster → text or JSON for any of the supported formats).\nexport {\n  exportRoster,\n  newRecruitJsonSerializer,\n  newRecruitSimpleSerializer,\n  newRecruitWtcCompactSerializer,\n  newRecruitWtcFullSerializer,\n  rosterJsonSerializer,\n  rosterizerSerializer,\n} from \"./export/index.js\";\nexport type { ExportFormat, RosterSerializer } from \"./export/index.js\";\nexport type { FormatAdapter } from \"./import/index.js\";\nexport type {\n  ImportOptions,\n  ImportResult,\n  ImportFailureReason,\n  AdapterTrial,\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  RosterLeaderAttachment,\n  ResolvedRef,\n  Candidate,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./import/index.js\";\n"]}

package/dist/known-support-10e.d.ts

@@ -29,3 +29,4 @@
 export declare const KNOWN_SUPPORT_10E: Record<string, readonly string[]>;
 /** Flatten the registry to faction-prefixed ids for set membership tests. */
 export declare function knownSupportSet(): Set<string>;
+//# sourceMappingURL=known-support-10e.d.ts.map

package/dist/known-support-10e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-support-10e.d.ts","sourceRoot":"","sources":["../src/known-support-10e.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA0FH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAiB,CAAC;AAElF,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,CAM7C"}

package/dist/known-support-10e.js

@@ -111,3 +111,4 @@ export function knownSupportSet() {
     }
     return set;
 }
+//# sourceMappingURL=known-support-10e.js.map

package/dist/known-support-10e.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-support-10e.js","sourceRoot":"","sources":["../src/known-support-10e.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Canonical registry of 10e units carrying the \"additional leader\" / \"second\n * leader\" attachment rule — characters that can attach to a unit even when\n * another Leader (e.g. Captain, Chapter Master, Lieutenant) is already\n * attached. In 11e this is formalised as `attachment_role: \"support\"`.\n *\n * The registry has two layers:\n *\n *   1. **`FROM_UPSTREAM_SCRAPE`** — derived deterministically from army-assist\n *      `Datasheets.json` by scanning `leader_head` for the canonical phrasing\n *      (/already been attached|additional leader|attach this model.*even if/i)\n *      and resolving each datasheet name to our kebab-case unit id via the\n *      10e-archive's `data/core/<faction>/units.json` name table.\n *      shadowboxing's `assets/Datasheets.json` yields the same 40 names.\n *\n *   2. **`MANUAL_OVERLAY`** — units whose 10e \"additional leader\" rule is\n *      *not* captured by either upstream scraper (data-gap entries) plus\n *      non-character special cases. Each entry needs a one-line comment\n *      naming the SME source so the gap is auditable. This layer is the\n *      reason 40kdc-data exists as a canonical upstream.\n *\n * The exported `KNOWN_SUPPORT_10E` is the merged view. To refresh layer 1,\n * re-run the scan recipe documented above. To add a missing unit (layer 2),\n * edit `MANUAL_OVERLAY` with a comment justifying the entry.\n *\n * Treat every entry as a **proposal** until human review confirms. The port\n * emits a warning if a registry entry doesn't match an archive unit.\n */\n\n/** Layer 1 — derived from army-assist (and confirmed against shadowboxing). */\nconst FROM_UPSTREAM_SCRAPE: Record<string, readonly string[]> = {\n  \"adepta-sororitas\": [\"dialogus\", \"dogmata\", \"hospitaller\", \"imagifier\", \"ministorum-priest\"],\n\n  // Successor chapters share these units via `parent_faction_id`, so\n  // chapter-specific variants like `crusade-ancient` (Black Templars) live\n  // under adeptus-astartes.\n  \"adeptus-astartes\": [\n    \"ancient\",\n    \"ancient-in-terminator-armour\",\n    \"apothecary\",\n    \"apothecary-biologis\",\n    \"bladeguard-ancient\",\n    \"castellan\",\n    \"cato-sicarius\",\n    \"crusade-ancient\",\n    \"imperial-space-marine\",\n    \"lieutenant\",\n    \"lieutenant-in-phobos-armour\",\n    \"lieutenant-in-reiver-armour\",\n    \"sanguinary-priest\",\n  ],\n\n  \"adeptus-mechanicus\": [\"cybernetica-datasmith\"],\n\n  \"aeldari\": [\"eldrad-ulthran\", \"the-visarch\", \"warlock\"],\n\n  \"agents-of-the-imperium\": [\"ministorum-priest\"],\n\n  \"astra-militarum\": [\"death-rider-commissar\", \"ministorum-priest\"],\n\n  \"chaos-space-marines\": [\"master-of-executions\"],\n\n  \"death-guard\": [\n    \"biologus-putrifier\",\n    \"foul-blightspawn\",\n    \"icon-bearer\",\n    \"noxious-blightbringer\",\n    \"plague-surgeon\",\n    \"tallyman\",\n  ],\n\n  \"genestealer-cults\": [\"biophagus\", \"clamavus\", \"locus\", \"nexos\"],\n\n  \"necrons\": [\n    \"chronomancer\",\n    \"geomancer\",\n    \"orikan-the-diviner\",\n    \"plasmancer\",\n    \"psychomancer\",\n    \"technomancer\",\n  ],\n\n  \"world-eaters\": [\"master-of-executions\"],\n};\n\n/** Layer 2 — units the upstream scrape misses, plus non-character special cases. */\nconst MANUAL_OVERLAY: Record<string, readonly string[]> = {\n  // All three Kroot Shapers carry the additional-leader rule in the GW\n  // datasheet, but their `leader_head` in both army-assist and shadowboxing\n  // contains only the basic attachment list — the co-attach phrasing was\n  // dropped by both community scrapes. (Ethereal is *not* a co-attach Leader;\n  // confirmed not missing from the scrape.)\n  \"tau-empire\": [\"kroot-flesh-shaper\", \"kroot-trail-shaper\", \"kroot-war-shaper\"],\n\n  // Cryptothralls is a non-character bodyguard unit that joins a Cryptek-led\n  // unit. In 10e the co-attach Leader rule sits on the Cryptek datasheets\n  // (covered by layer 1); cryptothralls is included here for the 11e\n  // Support-pattern review since it's the \"joiner\" entity. May need a\n  // non-character Support encoding in 11e (`attachment_role` semantically\n  // expects a character).\n  \"necrons\": [\"cryptothralls\"],\n};\n\n/** Merge layers 1 and 2 into the public registry. */\nfunction mergeLayers(): Record<string, readonly string[]> {\n  const merged: Record<string, string[]> = {};\n  for (const [faction, ids] of Object.entries(FROM_UPSTREAM_SCRAPE)) {\n    merged[faction] = [...ids];\n  }\n  for (const [faction, ids] of Object.entries(MANUAL_OVERLAY)) {\n    merged[faction] = [...(merged[faction] ?? []), ...ids];\n  }\n  // Sort each list so output order is stable across re-runs.\n  for (const faction of Object.keys(merged)) merged[faction].sort();\n  return merged;\n}\n\nexport const KNOWN_SUPPORT_10E: Record<string, readonly string[]> = mergeLayers();\n\n/** Flatten the registry to faction-prefixed ids for set membership tests. */\nexport function knownSupportSet(): Set<string> {\n  const set = new Set<string>();\n  for (const [faction, ids] of Object.entries(KNOWN_SUPPORT_10E)) {\n    for (const id of ids) set.add(`${faction}:${id}`);\n  }\n  return set;\n}\n"]}

package/dist/link-abilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reverse-link enrichment ability `unit_ids` arrays into each unit's
+ * `ability_ids` in core data.
+ *
+ * Each `data/enrichment/<faction>/abilities.json` entry carries a
+ * `unit_ids` array naming the units that ability applies to. This script
+ * inverts that into `data/core/<faction>/units.json[*].ability_ids`.
+ *
+ * Additionally layers in `leader-attachments.json` — every `leader_id`
+ * gains the `"leader"` core ability.
+ *
+ * Idempotent and additive: existing `ability_ids` are preserved so
+ * manually-curated links (e.g. core abilities like "deep-strike",
+ * "deadly-demise-d3" not reachable via the enrichment unit_ids path)
+ * survive re-runs.
+ *
+ * Cross-faction routing: each `(unit_id, ability_id)` pair is bucketed
+ * to whichever `data/core/<faction>/units.json` actually contains that
+ * `unit_id` — so subfaction enrichment files contribute to the
+ * appropriate shared core file (e.g. Blood Angels enrichment routes
+ * into `adeptus-astartes/units.json`).
+ *
+ * Usage:
+ *   npx tsx tools/src/link-abilities.ts                  # all factions
+ *   npx tsx tools/src/link-abilities.ts --faction orks   # one faction
+ *   npx tsx tools/src/link-abilities.ts --dry-run        # report only
+ */
+export interface LinkOptions {
+    rootDir?: string;
+    factionFilter?: string;
+    dryRun?: boolean;
+}
+export interface LinkSummary {
+    factionsScanned: number;
+    unitsChanged: number;
+    abilityLinksAdded: number;
+    unknownUnitIdReferences: string[];
+    filesWritten: string[];
+}
+export declare function linkAbilities(opts?: LinkOptions): LinkSummary;
+//# sourceMappingURL=link-abilities.d.ts.map

package/dist/link-abilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-abilities.d.ts","sourceRoot":"","sources":["../src/link-abilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAwBH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAkBD,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAgB,GAAG,WAAW,CAsFjE"}