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

package/dist/import/gw.js

@@ -0,0 +1,245 @@
+import { factionFromKeyword, inferBattleSizeRaw, stripParenthetical, } from "./newrecruit-text.js";
+const FACTION_KEYWORD_PREFIX = "+ FACTION KEYWORD:";
+const HEADER_FIELDS = {
+    faction: /^\+\s*FACTION KEYWORD:\s*(.+?)\s*$/i,
+    detachment: /^\+\s*DETACHMENT:\s*(.+?)\s*$/i,
+    totalPoints: /^\+\s*TOTAL ARMY POINTS:\s*(\d+)\s*pts?\s*$/i,
+};
+const FENCE = /^\++\s*$/;
+const HEADER_LINE = /^\+/;
+const SECTION_HEADER = /^[A-Z][A-Z0-9 \-/&]+$/; // BATTLELINE, ALLIED UNITS, …
+const UNIT_HEADER = /^(.+?)\s*\(\s*(\d+)\s*pts?\s*\)\s*$/i;
+const BULLET_LINE = /^(\s*)•\s*(.+?)\s*$/u;
+const NX_PREFIX = /^(\d+)x\s+(.+)$/;
+const ENHANCEMENT_ANNOT = /^(.+?)\s*\(\+\s*(\d+)\s*pts?\s*\)\s*$/i;
+const WITH_LINE = /^[\t ]*\d+\s+with\b/m;
+const BULLET = /^[\t ]*•/mu;
+const ALLIED_SECTION = "ALLIED UNITS";
+const CHARACTERS_SECTION = "CHARACTERS";
+const CHARACTER_SUFFIX = " Character";
+const WARLORD_MARKER = "Warlord";
+/** Accept the input only when it carries the FACTION KEYWORD summary header,
+ * has `•` bullets, and lacks the WTC `N with` body lines. */
+function isGwText(decoded) {
+    if (typeof decoded !== "string")
+        return null;
+    if (!decoded.includes(FACTION_KEYWORD_PREFIX))
+        return null;
+    if (!BULLET.test(decoded))
+        return null;
+    if (WITH_LINE.test(decoded))
+        return null; // that's wtc-full
+    return decoded;
+}
+function parseHeader(lines) {
+    let faction_raw_name = null;
+    let detachment_raw_name = null;
+    let total_reported = null;
+    const fenceIndices = [];
+    for (let i = 0; i < lines.length && fenceIndices.length < 2; i += 1) {
+        if (FENCE.test(lines[i]))
+            fenceIndices.push(i);
+    }
+    let sawFactionKeyword = false;
+    for (const line of lines) {
+        if (!line.startsWith("+"))
+            continue;
+        const factionMatch = HEADER_FIELDS.faction.exec(line);
+        if (factionMatch) {
+            faction_raw_name = factionFromKeyword(factionMatch[1]);
+            sawFactionKeyword = true;
+            continue;
+        }
+        const detMatch = HEADER_FIELDS.detachment.exec(line);
+        if (detMatch) {
+            detachment_raw_name = stripParenthetical(detMatch[1]);
+            continue;
+        }
+        const ptsMatch = HEADER_FIELDS.totalPoints.exec(line);
+        if (ptsMatch) {
+            total_reported = Number.parseInt(ptsMatch[1], 10);
+        }
+    }
+    if (!sawFactionKeyword)
+        return null;
+    const bodyStart = fenceIndices.length >= 2 ? fenceIndices[1] + 1 : 0;
+    // The GW export has no POINTS LIMIT line — only TOTAL ARMY POINTS. Use it as
+    // the declared limit so the inferred battle size stays round-trippable.
+    const declared_limit = total_reported;
+    return {
+        header: {
+            name: "Imported roster",
+            faction_raw_name,
+            detachment_raw_name,
+            total_reported,
+            declared_limit,
+            battle_size_raw: inferBattleSizeRaw(declared_limit),
+        },
+        bodyStart,
+    };
+}
+function finishUnit(acc) {
+    const topIndent = acc.bullets.length
+        ? Math.min(...acc.bullets.map((b) => b.indent))
+        : 0;
+    const wargear = new Map();
+    let model_count = 0;
+    let is_warlord = false;
+    let is_character = acc.section === CHARACTERS_SECTION;
+    let enhancement_raw_name = null;
+    let enhancement_points = null;
+    const addWargear = (raw_name, count) => {
+        wargear.set(raw_name, (wargear.get(raw_name) ?? 0) + count);
+    };
+    for (let i = 0; i < acc.bullets.length; i += 1) {
+        const b = acc.bullets[i];
+        // A child bullet (deeper than the unit's top level) is a model group's
+        // weapon — its `Nx` count is already the squad-wide total.
+        if (b.indent > topIndent) {
+            if (b.count !== null)
+                addWargear(b.text, b.count);
+            continue;
+        }
+        // Top-level annotation (no `Nx` count): enhancement / character / warlord.
+        if (b.count === null) {
+            const enh = ENHANCEMENT_ANNOT.exec(b.text);
+            if (enh) {
+                if (enhancement_raw_name === null) {
+                    enhancement_raw_name = enh[1].trim();
+                    enhancement_points = Number.parseInt(enh[2], 10);
+                }
+                continue;
+            }
+            for (const token of b.text.split(",").map((s) => s.trim()).filter(Boolean)) {
+                if (token === WARLORD_MARKER)
+                    is_warlord = true;
+                else if (token.endsWith(CHARACTER_SUFFIX))
+                    is_character = true;
+            }
+            continue;
+        }
+        // Top-level `Nx` bullet: a model group when it has child bullets beneath
+        // it, otherwise plain wargear.
+        const next = acc.bullets[i + 1];
+        if (next && next.indent > topIndent) {
+            model_count += b.count;
+        }
+        else {
+            addWargear(b.text, b.count);
+        }
+    }
+    if (model_count === 0)
+        model_count = 1;
+    // The GW unit header points include the enhancement; back it out to the base.
+    const displayed = acc.displayed_pts;
+    const points = displayed === null
+        ? null
+        : enhancement_points !== null
+            ? displayed - enhancement_points
+            : displayed;
+    const wargearList = [];
+    for (const [raw_name, count] of wargear)
+        wargearList.push({ raw_name, count });
+    return {
+        raw_name: acc.raw_name,
+        is_character,
+        model_count,
+        points,
+        is_warlord,
+        enhancement_raw_name,
+        enhancement_points,
+        wargear: wargearList,
+    };
+}
+function parseBody(lines, bodyStart) {
+    const units = [];
+    let current = null;
+    let section = null;
+    let alliedUnits = 0;
+    const finalize = () => {
+        if (current) {
+            units.push(finishUnit(current));
+            current = null;
+        }
+    };
+    for (let i = bodyStart; i < lines.length; i += 1) {
+        const raw = lines[i];
+        const line = raw.trim();
+        if (!line || FENCE.test(line) || HEADER_LINE.test(line))
+            continue;
+        const bulletMatch = BULLET_LINE.exec(raw);
+        if (bulletMatch) {
+            if (current) {
+                const indent = bulletMatch[1].length;
+                const rest = bulletMatch[2];
+                const nx = NX_PREFIX.exec(rest);
+                current.bullets.push({
+                    indent,
+                    count: nx ? Number.parseInt(nx[1], 10) : null,
+                    text: (nx ? nx[2] : rest).trim(),
+                });
+            }
+            continue;
+        }
+        const unitMatch = UNIT_HEADER.exec(line);
+        if (unitMatch) {
+            finalize();
+            current = {
+                raw_name: unitMatch[1].trim(),
+                displayed_pts: Number.parseInt(unitMatch[2], 10),
+                section,
+                bullets: [],
+            };
+            if (section === ALLIED_SECTION)
+                alliedUnits += 1;
+            continue;
+        }
+        if (SECTION_HEADER.test(line)) {
+            finalize();
+            section = line;
+        }
+    }
+    finalize();
+    return { units, multi_force: alliedUnits > 0 };
+}
+export const gwAdapter = {
+    id: "gw",
+    matches(decoded) {
+        return isGwText(decoded) !== null;
+    },
+    parse(decoded) {
+        const text = isGwText(decoded);
+        if (text === null)
+            throw new Error("gw: input is not a GW app text export");
+        const lines = text.split(/\r?\n/);
+        const parsed = parseHeader(lines);
+        if (!parsed)
+            throw new Error('gw: missing "+ FACTION KEYWORD:" header');
+        const { header, bodyStart } = parsed;
+        const { units, multi_force } = parseBody(lines, bodyStart);
+        let total_computed = 0;
+        for (const u of units) {
+            total_computed += u.points ?? 0;
+            total_computed += u.enhancement_points ?? 0;
+        }
+        return {
+            name: header.name,
+            generated_by: null,
+            faction_raw_name: header.faction_raw_name,
+            detachment_raw_name: header.detachment_raw_name,
+            battle_size_raw: header.battle_size_raw,
+            declared_limit: header.declared_limit,
+            total_reported: header.total_reported,
+            total_computed,
+            units,
+            multi_force,
+        };
+    },
+};
+// Internals re-exported for unit tests.
+export const _internals = {
+    isGwText,
+    parseHeader,
+    parseBody,
+};
+//# sourceMappingURL=gw.js.map

package/dist/import/gw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gw.js","sourceRoot":"","sources":["../../src/import/gw.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAEpD,MAAM,aAAa,GAAG;IACpB,OAAO,EAAE,qCAAqC;IAC9C,UAAU,EAAE,gCAAgC;IAC5C,WAAW,EAAE,8CAA8C;CACnD,CAAC;AAEX,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,cAAc,GAAG,uBAAuB,CAAC,CAAC,8BAA8B;AAC9E,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAC3D,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAC3C,MAAM,SAAS,GAAG,iBAAiB,CAAC;AACpC,MAAM,iBAAiB,GAAG,wCAAwC,CAAC;AACnE,MAAM,SAAS,GAAG,sBAAsB,CAAC;AACzC,MAAM,MAAM,GAAG,YAAY,CAAC;AAE5B,MAAM,cAAc,GAAG,cAAc,CAAC;AACtC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AACxC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AACtC,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC;6DAC6D;AAC7D,SAAS,QAAQ,CAAC,OAAgB;IAChC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,kBAAkB;IAC5D,OAAO,OAAO,CAAC;AACjB,CAAC;AAWD,SAAS,WAAW,CAAC,KAAe;IAClC,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAC3C,IAAI,mBAAmB,GAAkB,IAAI,CAAC;IAC9C,IAAI,cAAc,GAAkB,IAAI,CAAC;IAEzC,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACpC,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,YAAY,EAAE,CAAC;YACjB,gBAAgB,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,iBAAiB,GAAG,IAAI,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,mBAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,cAAc,GAAG,cAAc,CAAC;IACtC,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,iBAAiB;YACvB,gBAAgB;YAChB,mBAAmB;YACnB,cAAc;YACd,cAAc;YACd,eAAe,EAAE,kBAAkB,CAAC,cAAc,CAAC;SACpD;QACD,SAAS;KACV,CAAC;AACJ,CAAC;AAeD,SAAS,UAAU,CAAC,GAAY;IAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM;QAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC,CAAC;IAEN,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,YAAY,GAAG,GAAG,CAAC,OAAO,KAAK,kBAAkB,CAAC;IACtD,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAE7C,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,KAAa,EAAQ,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAEzB,uEAAuE;QACvE,2DAA2D;QAC3D,IAAI,CAAC,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;gBAAE,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;oBAClC,oBAAoB,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACrC,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,CAAC;gBACD,SAAS;YACX,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3E,IAAI,KAAK,KAAK,cAAc;oBAAE,UAAU,GAAG,IAAI,CAAC;qBAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBAAE,YAAY,GAAG,IAAI,CAAC;YACjE,CAAC;YACD,SAAS;QACX,CAAC;QAED,yEAAyE;QACzE,+BAA+B;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YACpC,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,WAAW,KAAK,CAAC;QAAE,WAAW,GAAG,CAAC,CAAC;IAEvC,8EAA8E;IAC9E,MAAM,SAAS,GAAG,GAAG,CAAC,aAAa,CAAC;IACpC,MAAM,MAAM,GACV,SAAS,KAAK,IAAI;QAChB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,kBAAkB,KAAK,IAAI;YAC3B,CAAC,CAAC,SAAS,GAAG,kBAAkB;YAChC,CAAC,CAAC,SAAS,CAAC;IAElB,MAAM,WAAW,GAAoB,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,OAAO;QAAE,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAE/E,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY;QACZ,WAAW;QACX,MAAM;QACN,UAAU;QACV,oBAAoB;QACpB,kBAAkB;QAClB,OAAO,EAAE,WAAW;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAe,EAAE,SAAiB;IAInD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YAChC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAElE,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACrC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;oBACnB,MAAM;oBACN,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;oBAC7C,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;iBACjC,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,EAAE,CAAC;YACX,OAAO,GAAG;gBACR,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC7B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAChD,OAAO;gBACP,OAAO,EAAE,EAAE;aACZ,CAAC;YACF,IAAI,OAAO,KAAK,cAAc;gBAAE,WAAW,IAAI,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,QAAQ,EAAE,CAAC;YACX,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,GAAG,CAAC,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC,EAAE,EAAE,IAAI;IAER,OAAO,CAAC,OAAgB;QACtB,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAgB;QACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAE5E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACxE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QAErC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE3D,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,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,cAAc;YACd,KAAK;YACL,WAAW;SACZ,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,QAAQ;IACR,WAAW;IACX,SAAS;CACV,CAAC","sourcesContent":["/**\n * GW adapter: lower the Games Workshop 40K app's plain-text army-list export to\n * a {@link ParsedRoster}.\n *\n * The format opens with the same `++++…++++` summary fence as the NewRecruit WTC\n * formats (FACTION KEYWORD / DETACHMENT / TOTAL ARMY POINTS / WARLORD /\n * ENHANCEMENT / NUMBER OF UNITS / SECONDARY), then lists units grouped under\n * ALL-CAPS battlefield-role sections (`BATTLELINE`, `CHARACTERS`,\n * `ALLIED UNITS`, …). Each unit is a header line `Name (N pts)` followed by\n * `•`-bulleted entries:\n *\n * ```\n * War Dog Executioner (130 pts)\n * • 1x Armoured feet\n * • 2x War Dog autocannon\n * • Houndpack Lance Character, Warlord\n *\n * Nurglings (40 pts)\n * • 3x Nurgling Swarm\n *     • 3x Diseased claws and teeth\n * ```\n *\n * Bullet classification (the parsing crux):\n * - A top-level `• Nx Thing` *with* further-indented child bullets is a **model\n *   group** — `N` adds to the model count and the children are that group's\n *   wargear (Nurglings, Beasts of Nurgle).\n * - A top-level `• Nx Thing` *without* children is plain **wargear**.\n * - A bullet *without* an `Nx` count is an **annotation**: `… Character` flags a\n *   character, `Warlord` flags the warlord, `Name (+N pts)` is the enhancement.\n *\n * **Disjointness from the WTC matchers**: the GW format always carries `•`\n * bullets and never the WTC `N with` lines. wtc-full always has `N with` (so it\n * never collides), and wtc-compact never has bullets (its matcher now excludes\n * them). This adapter therefore matches on *bullets present* + *no `N with`*.\n *\n * The GW export carries no separate POINTS LIMIT line, so `declared_limit`\n * falls back to TOTAL ARMY POINTS (the round-trippable battle-size signal).\n *\n * @packageDocumentation\n */\nimport type { FormatAdapter } from \"./adapter.js\";\nimport type { ParsedRoster, ParsedUnit, ParsedWargear } from \"./types.js\";\nimport {\n  factionFromKeyword,\n  inferBattleSizeRaw,\n  stripParenthetical,\n} from \"./newrecruit-text.js\";\n\nconst FACTION_KEYWORD_PREFIX = \"+ FACTION KEYWORD:\";\n\nconst HEADER_FIELDS = {\n  faction: /^\\+\\s*FACTION KEYWORD:\\s*(.+?)\\s*$/i,\n  detachment: /^\\+\\s*DETACHMENT:\\s*(.+?)\\s*$/i,\n  totalPoints: /^\\+\\s*TOTAL ARMY POINTS:\\s*(\\d+)\\s*pts?\\s*$/i,\n} as const;\n\nconst FENCE = /^\\++\\s*$/;\nconst HEADER_LINE = /^\\+/;\nconst SECTION_HEADER = /^[A-Z][A-Z0-9 \\-/&]+$/; // BATTLELINE, ALLIED UNITS, …\nconst UNIT_HEADER = /^(.+?)\\s*\\(\\s*(\\d+)\\s*pts?\\s*\\)\\s*$/i;\nconst BULLET_LINE = /^(\\s*)•\\s*(.+?)\\s*$/u;\nconst NX_PREFIX = /^(\\d+)x\\s+(.+)$/;\nconst ENHANCEMENT_ANNOT = /^(.+?)\\s*\\(\\+\\s*(\\d+)\\s*pts?\\s*\\)\\s*$/i;\nconst WITH_LINE = /^[\\t ]*\\d+\\s+with\\b/m;\nconst BULLET = /^[\\t ]*•/mu;\n\nconst ALLIED_SECTION = \"ALLIED UNITS\";\nconst CHARACTERS_SECTION = \"CHARACTERS\";\nconst CHARACTER_SUFFIX = \" Character\";\nconst WARLORD_MARKER = \"Warlord\";\n\n/** Accept the input only when it carries the FACTION KEYWORD summary header,\n * has `•` bullets, and lacks the WTC `N with` body lines. */\nfunction isGwText(decoded: unknown): string | null {\n  if (typeof decoded !== \"string\") return null;\n  if (!decoded.includes(FACTION_KEYWORD_PREFIX)) return null;\n  if (!BULLET.test(decoded)) return null;\n  if (WITH_LINE.test(decoded)) return null; // that's wtc-full\n  return decoded;\n}\n\ninterface GwHeader {\n  name: string;\n  faction_raw_name: string | null;\n  detachment_raw_name: string | null;\n  total_reported: number | null;\n  declared_limit: number | null;\n  battle_size_raw: string | null;\n}\n\nfunction parseHeader(lines: string[]): { header: GwHeader; bodyStart: number } | null {\n  let faction_raw_name: string | null = null;\n  let detachment_raw_name: string | null = null;\n  let total_reported: number | null = null;\n\n  const fenceIndices: number[] = [];\n  for (let i = 0; i < lines.length && fenceIndices.length < 2; i += 1) {\n    if (FENCE.test(lines[i])) fenceIndices.push(i);\n  }\n\n  let sawFactionKeyword = false;\n  for (const line of lines) {\n    if (!line.startsWith(\"+\")) continue;\n    const factionMatch = HEADER_FIELDS.faction.exec(line);\n    if (factionMatch) {\n      faction_raw_name = factionFromKeyword(factionMatch[1]);\n      sawFactionKeyword = true;\n      continue;\n    }\n    const detMatch = HEADER_FIELDS.detachment.exec(line);\n    if (detMatch) {\n      detachment_raw_name = stripParenthetical(detMatch[1]);\n      continue;\n    }\n    const ptsMatch = HEADER_FIELDS.totalPoints.exec(line);\n    if (ptsMatch) {\n      total_reported = Number.parseInt(ptsMatch[1], 10);\n    }\n  }\n\n  if (!sawFactionKeyword) return null;\n\n  const bodyStart = fenceIndices.length >= 2 ? fenceIndices[1] + 1 : 0;\n  // The GW export has no POINTS LIMIT line — only TOTAL ARMY POINTS. Use it as\n  // the declared limit so the inferred battle size stays round-trippable.\n  const declared_limit = total_reported;\n  return {\n    header: {\n      name: \"Imported roster\",\n      faction_raw_name,\n      detachment_raw_name,\n      total_reported,\n      declared_limit,\n      battle_size_raw: inferBattleSizeRaw(declared_limit),\n    },\n    bodyStart,\n  };\n}\n\ninterface Bullet {\n  indent: number;\n  count: number | null;\n  text: string;\n}\n\ninterface UnitAcc {\n  raw_name: string;\n  displayed_pts: number | null;\n  section: string | null;\n  bullets: Bullet[];\n}\n\nfunction finishUnit(acc: UnitAcc): ParsedUnit {\n  const topIndent = acc.bullets.length\n    ? Math.min(...acc.bullets.map((b) => b.indent))\n    : 0;\n\n  const wargear = new Map<string, number>();\n  let model_count = 0;\n  let is_warlord = false;\n  let is_character = acc.section === CHARACTERS_SECTION;\n  let enhancement_raw_name: string | null = null;\n  let enhancement_points: number | null = null;\n\n  const addWargear = (raw_name: string, count: number): void => {\n    wargear.set(raw_name, (wargear.get(raw_name) ?? 0) + count);\n  };\n\n  for (let i = 0; i < acc.bullets.length; i += 1) {\n    const b = acc.bullets[i];\n\n    // A child bullet (deeper than the unit's top level) is a model group's\n    // weapon — its `Nx` count is already the squad-wide total.\n    if (b.indent > topIndent) {\n      if (b.count !== null) addWargear(b.text, b.count);\n      continue;\n    }\n\n    // Top-level annotation (no `Nx` count): enhancement / character / warlord.\n    if (b.count === null) {\n      const enh = ENHANCEMENT_ANNOT.exec(b.text);\n      if (enh) {\n        if (enhancement_raw_name === null) {\n          enhancement_raw_name = enh[1].trim();\n          enhancement_points = Number.parseInt(enh[2], 10);\n        }\n        continue;\n      }\n      for (const token of b.text.split(\",\").map((s) => s.trim()).filter(Boolean)) {\n        if (token === WARLORD_MARKER) is_warlord = true;\n        else if (token.endsWith(CHARACTER_SUFFIX)) is_character = true;\n      }\n      continue;\n    }\n\n    // Top-level `Nx` bullet: a model group when it has child bullets beneath\n    // it, otherwise plain wargear.\n    const next = acc.bullets[i + 1];\n    if (next && next.indent > topIndent) {\n      model_count += b.count;\n    } else {\n      addWargear(b.text, b.count);\n    }\n  }\n\n  if (model_count === 0) model_count = 1;\n\n  // The GW unit header points include the enhancement; back it out to the base.\n  const displayed = acc.displayed_pts;\n  const points =\n    displayed === null\n      ? null\n      : enhancement_points !== null\n        ? displayed - enhancement_points\n        : displayed;\n\n  const wargearList: ParsedWargear[] = [];\n  for (const [raw_name, count] of wargear) wargearList.push({ raw_name, count });\n\n  return {\n    raw_name: acc.raw_name,\n    is_character,\n    model_count,\n    points,\n    is_warlord,\n    enhancement_raw_name,\n    enhancement_points,\n    wargear: wargearList,\n  };\n}\n\nfunction parseBody(lines: string[], bodyStart: number): {\n  units: ParsedUnit[];\n  multi_force: boolean;\n} {\n  const units: ParsedUnit[] = [];\n  let current: UnitAcc | null = null;\n  let section: string | null = null;\n  let alliedUnits = 0;\n\n  const finalize = (): void => {\n    if (current) {\n      units.push(finishUnit(current));\n      current = null;\n    }\n  };\n\n  for (let i = bodyStart; i < lines.length; i += 1) {\n    const raw = lines[i];\n    const line = raw.trim();\n    if (!line || FENCE.test(line) || HEADER_LINE.test(line)) continue;\n\n    const bulletMatch = BULLET_LINE.exec(raw);\n    if (bulletMatch) {\n      if (current) {\n        const indent = bulletMatch[1].length;\n        const rest = bulletMatch[2];\n        const nx = NX_PREFIX.exec(rest);\n        current.bullets.push({\n          indent,\n          count: nx ? Number.parseInt(nx[1], 10) : null,\n          text: (nx ? nx[2] : rest).trim(),\n        });\n      }\n      continue;\n    }\n\n    const unitMatch = UNIT_HEADER.exec(line);\n    if (unitMatch) {\n      finalize();\n      current = {\n        raw_name: unitMatch[1].trim(),\n        displayed_pts: Number.parseInt(unitMatch[2], 10),\n        section,\n        bullets: [],\n      };\n      if (section === ALLIED_SECTION) alliedUnits += 1;\n      continue;\n    }\n\n    if (SECTION_HEADER.test(line)) {\n      finalize();\n      section = line;\n    }\n  }\n\n  finalize();\n  return { units, multi_force: alliedUnits > 0 };\n}\n\nexport const gwAdapter: FormatAdapter = {\n  id: \"gw\",\n\n  matches(decoded: unknown): boolean {\n    return isGwText(decoded) !== null;\n  },\n\n  parse(decoded: unknown): ParsedRoster {\n    const text = isGwText(decoded);\n    if (text === null) throw new Error(\"gw: input is not a GW app text export\");\n\n    const lines = text.split(/\\r?\\n/);\n    const parsed = parseHeader(lines);\n    if (!parsed) throw new Error('gw: missing \"+ FACTION KEYWORD:\" header');\n    const { header, bodyStart } = parsed;\n\n    const { units, multi_force } = parseBody(lines, bodyStart);\n\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    return {\n      name: header.name,\n      generated_by: null,\n      faction_raw_name: header.faction_raw_name,\n      detachment_raw_name: header.detachment_raw_name,\n      battle_size_raw: header.battle_size_raw,\n      declared_limit: header.declared_limit,\n      total_reported: header.total_reported,\n      total_computed,\n      units,\n      multi_force,\n    };\n  },\n};\n\n// Internals re-exported for unit tests.\nexport const _internals = {\n  isGwText,\n  parseHeader,\n  parseBody,\n};\n"]}

package/dist/import/import-roster.d.ts

@@ -3,13 +3,16 @@
  *
  * The adapter seam ({@link FormatAdapter}) lets every supported source format
  * plug in here without touching {@link decode} or {@link resolve}. Adapters are
- * registered in priority order — NewRecruit's tighter matchers run first so
- * the ListForge fallback only catches generic BattleScribe JSON.
+ * registered in priority order, and every adapter's `matches()` predicate is
+ * tight enough that **at most one** matches any given decoded payload —
+ * {@link tryImportRoster} relies on that disjointness to short-circuit on the
+ * first match.
  *
  * @packageDocumentation
  */
 import { Dataset } from "../data/dataset.js";
-import type { Roster } from "./types.js";
+import type { FormatAdapter } from "./adapter.js";
+import type { Roster, RosterFormat } from "./types.js";
 export interface ImportOptions {
     /** Dataset to resolve against. Defaults to the package's embedded dataset. */
     dataset?: Dataset;
@@ -32,4 +35,50 @@ export declare function importListForge(input: string, opts?: ImportOptions): Ro
  */
 export declare function importNewRecruit(input: string, opts?: ImportOptions): Roster;
 export declare function importRoster(decoded: unknown, opts?: ImportOptions): Roster;
+/** Why a {@link tryImportRoster} call did not produce a roster. */
+export type ImportFailureReason = "empty-input" | "decode-failed" | "no-adapter-matched" | "parse-failed";
+/** Per-adapter outcome from a {@link tryImportRoster} dispatch. */
+export interface AdapterTrial {
+    id: RosterFormat;
+    /** True iff this adapter's `matches()` predicate accepted the decoded input. */
+    matched: boolean;
+    /** Present when {@link matched} is true and `parse()` then threw — the matcher
+     * violated its contract. Absent for clean rejections. */
+    reason?: string;
+}
+/** Discriminated result returned by {@link tryImportRoster}. */
+export type ImportResult = {
+    ok: true;
+    roster: Roster;
+    format: RosterFormat;
+} | {
+    ok: false;
+    reason: ImportFailureReason;
+    message: string;
+    trials: AdapterTrial[];
+};
+/**
+ * Auto-detect and import any supported roster format from a single string.
+ *
+ * Pipeline:
+ * 1. Empty input → `empty-input`.
+ * 2. Looks like a ListForge URL / base64 payload → decode (base64 + gunzip + JSON.parse).
+ * 3. Looks like raw JSON (starts with `{`/`[`) → JSON.parse.
+ * 4. Otherwise treat as text.
+ * 5. Greedy first-match adapter dispatch. The first adapter whose `matches()`
+ *    accepts the decoded value wins; subsequent adapters are not tried.
+ * 6. If the matched adapter's `parse()` throws, that's a matcher contract
+ *    violation — surfaced as `parse-failed`, not silently retried.
+ *
+ * Caller never sees an exception; the discriminated {@link ImportResult} carries
+ * either the resolved {@link Roster} (with the detected {@link RosterFormat})
+ * or a typed failure plus per-adapter trial info for diagnostics.
+ *
+ * Prefer this over {@link importListForge} / {@link importNewRecruit} when the
+ * caller doesn't know which format the user pasted.
+ */
+export declare function tryImportRoster(input: string, opts?: ImportOptions): ImportResult;
+/** The adapter list, exposed for tests that need to walk every matcher (e.g.
+ * the disjointness invariant test). */
+export declare const REGISTERED_ADAPTERS: readonly FormatAdapter[];
 //# sourceMappingURL=import-roster.d.ts.map

package/dist/import/import-roster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-roster.d.ts","sourceRoot":"","sources":["../../src/import/import-roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAY7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAqBzC,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAG/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAUhF;AAyBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAM/E"}
+{"version":3,"file":"import-roster.d.ts","sourceRoot":"","sources":["../../src/import/import-roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAalD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA2BvD,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAG/E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAUhF;AAyBD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAM/E;AAMD,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,eAAe,GACf,oBAAoB,GACpB,cAAc,CAAC;AAEnB,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,YAAY,CAAC;IACjB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB;6DACyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAClD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB,CAAC;AAWN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,aAAkB,GACvB,YAAY,CA+Dd;AAED;uCACuC;AACvC,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAAa,CAAC"}

package/dist/import/import-roster.js

@@ -3,32 +3,42 @@
  *
  * The adapter seam ({@link FormatAdapter}) lets every supported source format
  * plug in here without touching {@link decode} or {@link resolve}. Adapters are
- * registered in priority order — NewRecruit's tighter matchers run first so
- * the ListForge fallback only catches generic BattleScribe JSON.
+ * registered in priority order, and every adapter's `matches()` predicate is
+ * tight enough that **at most one** matches any given decoded payload —
+ * {@link tryImportRoster} relies on that disjointness to short-circuit on the
+ * first match.
  *
  * @packageDocumentation
  */
 import { Dataset } from "../data/dataset.js";
 import { selectAdapter } from "./adapter.js";
 import { decodeListForge } from "./decode.js";
+import { gwAdapter } from "./gw.js";
 import { listForgeAdapter } from "./listforge.js";
 import { newRecruitJsonAdapter } from "./newrecruit-json.js";
 import { newRecruitSimpleAdapter } from "./newrecruit-simple.js";
 import { newRecruitWtcCompactAdapter, newRecruitWtcFullAdapter, } from "./newrecruit-wtc.js";
 import { resolve } from "./resolve.js";
+import { rosterizerAdapter } from "./rosterizer.js";
 /**
  * Adapters available to {@link importRoster}, in match-priority order.
  *
  * NewRecruit-JSON runs ahead of ListForge because both recognise a
  * `roster.forces` BattleScribe payload, and the NewRecruit signature is more
  * specific (`xmlns: rosterSchema` or `generatedBy: newrecruit.eu`). The text
- * adapters (`wtc-compact` / `wtc-full` / `simple`) only match strings and
+ * adapters (`gw` / `wtc-compact` / `wtc-full` / `simple`) only match strings and
  * disambiguate among themselves via structural cues, so their order amongst
  * each other doesn't matter; wtc-full goes before wtc-compact because its
- * matcher is the more specific of the two.
+ * matcher is the more specific of the two. GW shares the WTC summary header but
+ * carries `•` bullets and no `N with` lines, so it stays disjoint from both wtc
+ * matchers. Rosterizer rides at the top of the JSON dispatch — its `rulebook` +
+ * `snapshot` signature is structurally distinct from the BattleScribe
+ * `roster.forces` shape.
  */
 const ADAPTERS = [
+    rosterizerAdapter,
     newRecruitJsonAdapter,
+    gwAdapter,
     newRecruitWtcFullAdapter,
     newRecruitWtcCompactAdapter,
     newRecruitSimpleAdapter,
@@ -94,4 +104,104 @@ export function importRoster(decoded, opts = {}) {
     const parsed = adapter.parse(decoded);
     return resolve(parsed, ds, adapter.id);
 }
+/** Cheap predicate: does the input look like ListForge's URL-or-base64 wrapper? */
+function looksLikeListForgeEncoded(input) {
+    if (input.includes("/listforge/"))
+        return true;
+    if (/^https?:\/\//i.test(input))
+        return true;
+    // Every gzip-then-base64 payload starts with this prefix.
+    if (input.startsWith("H4sIA"))
+        return true;
+    return false;
+}
+/**
+ * Auto-detect and import any supported roster format from a single string.
+ *
+ * Pipeline:
+ * 1. Empty input → `empty-input`.
+ * 2. Looks like a ListForge URL / base64 payload → decode (base64 + gunzip + JSON.parse).
+ * 3. Looks like raw JSON (starts with `{`/`[`) → JSON.parse.
+ * 4. Otherwise treat as text.
+ * 5. Greedy first-match adapter dispatch. The first adapter whose `matches()`
+ *    accepts the decoded value wins; subsequent adapters are not tried.
+ * 6. If the matched adapter's `parse()` throws, that's a matcher contract
+ *    violation — surfaced as `parse-failed`, not silently retried.
+ *
+ * Caller never sees an exception; the discriminated {@link ImportResult} carries
+ * either the resolved {@link Roster} (with the detected {@link RosterFormat})
+ * or a typed failure plus per-adapter trial info for diagnostics.
+ *
+ * Prefer this over {@link importListForge} / {@link importNewRecruit} when the
+ * caller doesn't know which format the user pasted.
+ */
+export function tryImportRoster(input, opts = {}) {
+    const trimmed = input.trim();
+    if (trimmed === "") {
+        return { ok: false, reason: "empty-input", message: "input is empty", trials: [] };
+    }
+    let decoded;
+    if (looksLikeListForgeEncoded(trimmed)) {
+        try {
+            decoded = decodeListForge(trimmed);
+        }
+        catch (err) {
+            const message = err.message;
+            return {
+                ok: false,
+                reason: "decode-failed",
+                message: `failed to decode ListForge payload: ${message}`,
+                trials: [{ id: "listforge", matched: false, reason: message }],
+            };
+        }
+    }
+    else if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            decoded = JSON.parse(trimmed);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                reason: "decode-failed",
+                message: `input looks like JSON but failed to parse: ${err.message}`,
+                trials: [],
+            };
+        }
+    }
+    else {
+        decoded = input;
+    }
+    const ds = opts.dataset ?? Dataset.embedded();
+    const trials = [];
+    for (const adapter of ADAPTERS) {
+        if (!adapter.matches(decoded)) {
+            trials.push({ id: adapter.id, matched: false });
+            continue;
+        }
+        try {
+            const parsed = adapter.parse(decoded);
+            const roster = resolve(parsed, ds, adapter.id);
+            return { ok: true, roster, format: adapter.id };
+        }
+        catch (err) {
+            const message = err.message;
+            trials.push({ id: adapter.id, matched: true, reason: message });
+            return {
+                ok: false,
+                reason: "parse-failed",
+                message: `${adapter.id}: ${message}`,
+                trials,
+            };
+        }
+    }
+    return {
+        ok: false,
+        reason: "no-adapter-matched",
+        message: `tried ${ADAPTERS.length} formats, none recognised the input`,
+        trials,
+    };
+}
+/** The adapter list, exposed for tests that need to walk every matcher (e.g.
+ * the disjointness invariant test). */
+export const REGISTERED_ADAPTERS = ADAPTERS;
 //# sourceMappingURL=import-roster.js.map

package/dist/import/import-roster.js.map

@@ -1 +1 @@
-{"version":3,"file":"import-roster.js","sourceRoot":"","sources":["../../src/import/import-roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC;;;;;;;;;;GAUG;AACH,MAAM,QAAQ,GAA6B;IACzC,qBAAqB;IACrB,wBAAwB;IACxB,2BAA2B;IAC3B,uBAAuB;IACvB,gBAAgB;CACjB,CAAC;AAOF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,OAAsB,EAAE;IACrE,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,OAAsB,EAAE;IACtE,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IAClC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,OAAgB;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,CAAC,GAAG,OAAkC,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,MAA6C,CAAC;IAC/D,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QACtB,aAAa,IAAI,CAAC,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,OAAsB,EAAE;IACrE,IAAI,iBAAiB,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC","sourcesContent":["/**\n * Orchestrates an army-list import: decode → parse → resolve.\n *\n * The adapter seam ({@link FormatAdapter}) lets every supported source format\n * plug in here without touching {@link decode} or {@link resolve}. Adapters are\n * registered in priority order — NewRecruit's tighter matchers run first so\n * the ListForge fallback only catches generic BattleScribe JSON.\n *\n * @packageDocumentation\n */\nimport { Dataset } from \"../data/dataset.js\";\nimport type { FormatAdapter } from \"./adapter.js\";\nimport { selectAdapter } from \"./adapter.js\";\nimport { decodeListForge } from \"./decode.js\";\nimport { listForgeAdapter } from \"./listforge.js\";\nimport { newRecruitJsonAdapter } from \"./newrecruit-json.js\";\nimport { newRecruitSimpleAdapter } from \"./newrecruit-simple.js\";\nimport {\n  newRecruitWtcCompactAdapter,\n  newRecruitWtcFullAdapter,\n} from \"./newrecruit-wtc.js\";\nimport { resolve } from \"./resolve.js\";\nimport type { Roster } from \"./types.js\";\n\n/**\n * Adapters available to {@link importRoster}, in match-priority order.\n *\n * NewRecruit-JSON runs ahead of ListForge because both recognise a\n * `roster.forces` BattleScribe payload, and the NewRecruit signature is more\n * specific (`xmlns: rosterSchema` or `generatedBy: newrecruit.eu`). The text\n * adapters (`wtc-compact` / `wtc-full` / `simple`) only match strings and\n * disambiguate among themselves via structural cues, so their order amongst\n * each other doesn't matter; wtc-full goes before wtc-compact because its\n * matcher is the more specific of the two.\n */\nconst ADAPTERS: readonly FormatAdapter[] = [\n  newRecruitJsonAdapter,\n  newRecruitWtcFullAdapter,\n  newRecruitWtcCompactAdapter,\n  newRecruitSimpleAdapter,\n  listForgeAdapter,\n];\n\nexport interface ImportOptions {\n  /** Dataset to resolve against. Defaults to the package's embedded dataset. */\n  dataset?: Dataset;\n}\n\n/**\n * Import a ListForge share payload into a resolved 40kdc {@link Roster}.\n *\n * `input` may be a full ListForge URL, a bare base64 segment, or an\n * already-decoded JSON string — all are handled transparently. For NewRecruit\n * sources, use {@link importNewRecruit} (no base64/gzip decode).\n */\nexport function importListForge(input: string, opts: ImportOptions = {}): Roster {\n  const decoded = decodeListForge(input);\n  return importRoster(decoded, opts);\n}\n\n/**\n * Import a NewRecruit export (any of the four formats — JSON, wtc-compact,\n * wtc-full, simple) into a resolved 40kdc {@link Roster}.\n *\n * The JSON form is parsed when `input` is valid JSON; the text forms are\n * dispatched on string content. No base64/gzip decoding is attempted —\n * NewRecruit exports are not encoded.\n */\nexport function importNewRecruit(input: string, opts: ImportOptions = {}): Roster {\n  const trimmed = input.trimStart();\n  if (trimmed.startsWith(\"{\") || trimmed.startsWith(\"[\")) {\n    try {\n      return importRoster(JSON.parse(input), opts);\n    } catch {\n      // Fall through to treating the input as raw text.\n    }\n  }\n  return importRoster(input, opts);\n}\n\n/**\n * Import an already-decoded payload. Selects the matching format adapter and\n * resolves the result against the dataset. Accepts either a parsed JSON object\n * (NewRecruit JSON / ListForge) or a string (the three NewRecruit text formats).\n */\n/**\n * Detect an already-resolved canonical {@link Roster} (the JSON shape produced\n * by `rosterJsonSerializer`). Lets a downstream consumer round-trip canonical\n * Roster JSON through `importRoster` without going through an adapter.\n */\nfunction isCanonicalRoster(decoded: unknown): decoded is Roster {\n  if (typeof decoded !== \"object\" || decoded === null) return false;\n  const r = decoded as Record<string, unknown>;\n  const source = r.source as Record<string, unknown> | undefined;\n  return (\n    typeof source === \"object\" &&\n    source !== null &&\n    typeof source.format === \"string\" &&\n    Array.isArray(r.units) &&\n    \"diagnostics\" in r\n  );\n}\n\nexport function importRoster(decoded: unknown, opts: ImportOptions = {}): Roster {\n  if (isCanonicalRoster(decoded)) return decoded;\n  const ds = opts.dataset ?? Dataset.embedded();\n  const adapter = selectAdapter(decoded, [...ADAPTERS]);\n  const parsed = adapter.parse(decoded);\n  return resolve(parsed, ds, adapter.id);\n}\n"]}
+{"version":3,"file":"import-roster.js","sourceRoot":"","sources":["../../src/import/import-roster.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Orchestrates an army-list import: decode → parse → resolve.\n *\n * The adapter seam ({@link FormatAdapter}) lets every supported source format\n * plug in here without touching {@link decode} or {@link resolve}. Adapters are\n * registered in priority order, and every adapter's `matches()` predicate is\n * tight enough that **at most one** matches any given decoded payload —\n * {@link tryImportRoster} relies on that disjointness to short-circuit on the\n * first match.\n *\n * @packageDocumentation\n */\nimport { Dataset } from \"../data/dataset.js\";\nimport type { FormatAdapter } from \"./adapter.js\";\nimport { selectAdapter } from \"./adapter.js\";\nimport { decodeListForge } from \"./decode.js\";\nimport { gwAdapter } from \"./gw.js\";\nimport { listForgeAdapter } from \"./listforge.js\";\nimport { newRecruitJsonAdapter } from \"./newrecruit-json.js\";\nimport { newRecruitSimpleAdapter } from \"./newrecruit-simple.js\";\nimport {\n  newRecruitWtcCompactAdapter,\n  newRecruitWtcFullAdapter,\n} from \"./newrecruit-wtc.js\";\nimport { resolve } from \"./resolve.js\";\nimport { rosterizerAdapter } from \"./rosterizer.js\";\nimport type { Roster, RosterFormat } from \"./types.js\";\n\n/**\n * Adapters available to {@link importRoster}, in match-priority order.\n *\n * NewRecruit-JSON runs ahead of ListForge because both recognise a\n * `roster.forces` BattleScribe payload, and the NewRecruit signature is more\n * specific (`xmlns: rosterSchema` or `generatedBy: newrecruit.eu`). The text\n * adapters (`gw` / `wtc-compact` / `wtc-full` / `simple`) only match strings and\n * disambiguate among themselves via structural cues, so their order amongst\n * each other doesn't matter; wtc-full goes before wtc-compact because its\n * matcher is the more specific of the two. GW shares the WTC summary header but\n * carries `•` bullets and no `N with` lines, so it stays disjoint from both wtc\n * matchers. Rosterizer rides at the top of the JSON dispatch — its `rulebook` +\n * `snapshot` signature is structurally distinct from the BattleScribe\n * `roster.forces` shape.\n */\nconst ADAPTERS: readonly FormatAdapter[] = [\n  rosterizerAdapter,\n  newRecruitJsonAdapter,\n  gwAdapter,\n  newRecruitWtcFullAdapter,\n  newRecruitWtcCompactAdapter,\n  newRecruitSimpleAdapter,\n  listForgeAdapter,\n];\n\nexport interface ImportOptions {\n  /** Dataset to resolve against. Defaults to the package's embedded dataset. */\n  dataset?: Dataset;\n}\n\n/**\n * Import a ListForge share payload into a resolved 40kdc {@link Roster}.\n *\n * `input` may be a full ListForge URL, a bare base64 segment, or an\n * already-decoded JSON string — all are handled transparently. For NewRecruit\n * sources, use {@link importNewRecruit} (no base64/gzip decode).\n */\nexport function importListForge(input: string, opts: ImportOptions = {}): Roster {\n  const decoded = decodeListForge(input);\n  return importRoster(decoded, opts);\n}\n\n/**\n * Import a NewRecruit export (any of the four formats — JSON, wtc-compact,\n * wtc-full, simple) into a resolved 40kdc {@link Roster}.\n *\n * The JSON form is parsed when `input` is valid JSON; the text forms are\n * dispatched on string content. No base64/gzip decoding is attempted —\n * NewRecruit exports are not encoded.\n */\nexport function importNewRecruit(input: string, opts: ImportOptions = {}): Roster {\n  const trimmed = input.trimStart();\n  if (trimmed.startsWith(\"{\") || trimmed.startsWith(\"[\")) {\n    try {\n      return importRoster(JSON.parse(input), opts);\n    } catch {\n      // Fall through to treating the input as raw text.\n    }\n  }\n  return importRoster(input, opts);\n}\n\n/**\n * Import an already-decoded payload. Selects the matching format adapter and\n * resolves the result against the dataset. Accepts either a parsed JSON object\n * (NewRecruit JSON / ListForge) or a string (the three NewRecruit text formats).\n */\n/**\n * Detect an already-resolved canonical {@link Roster} (the JSON shape produced\n * by `rosterJsonSerializer`). Lets a downstream consumer round-trip canonical\n * Roster JSON through `importRoster` without going through an adapter.\n */\nfunction isCanonicalRoster(decoded: unknown): decoded is Roster {\n  if (typeof decoded !== \"object\" || decoded === null) return false;\n  const r = decoded as Record<string, unknown>;\n  const source = r.source as Record<string, unknown> | undefined;\n  return (\n    typeof source === \"object\" &&\n    source !== null &&\n    typeof source.format === \"string\" &&\n    Array.isArray(r.units) &&\n    \"diagnostics\" in r\n  );\n}\n\nexport function importRoster(decoded: unknown, opts: ImportOptions = {}): Roster {\n  if (isCanonicalRoster(decoded)) return decoded;\n  const ds = opts.dataset ?? Dataset.embedded();\n  const adapter = selectAdapter(decoded, [...ADAPTERS]);\n  const parsed = adapter.parse(decoded);\n  return resolve(parsed, ds, adapter.id);\n}\n\n// ---------------------------------------------------------------------------\n// tryImportRoster — single string-in, structured-result-out entry point.\n// ---------------------------------------------------------------------------\n\n/** Why a {@link tryImportRoster} call did not produce a roster. */\nexport type ImportFailureReason =\n  | \"empty-input\"\n  | \"decode-failed\"\n  | \"no-adapter-matched\"\n  | \"parse-failed\";\n\n/** Per-adapter outcome from a {@link tryImportRoster} dispatch. */\nexport interface AdapterTrial {\n  id: RosterFormat;\n  /** True iff this adapter's `matches()` predicate accepted the decoded input. */\n  matched: boolean;\n  /** Present when {@link matched} is true and `parse()` then threw — the matcher\n   * violated its contract. Absent for clean rejections. */\n  reason?: string;\n}\n\n/** Discriminated result returned by {@link tryImportRoster}. */\nexport type ImportResult =\n  | { ok: true; roster: Roster; format: RosterFormat }\n  | {\n      ok: false;\n      reason: ImportFailureReason;\n      message: string;\n      trials: AdapterTrial[];\n    };\n\n/** Cheap predicate: does the input look like ListForge's URL-or-base64 wrapper? */\nfunction looksLikeListForgeEncoded(input: string): boolean {\n  if (input.includes(\"/listforge/\")) return true;\n  if (/^https?:\\/\\//i.test(input)) return true;\n  // Every gzip-then-base64 payload starts with this prefix.\n  if (input.startsWith(\"H4sIA\")) return true;\n  return false;\n}\n\n/**\n * Auto-detect and import any supported roster format from a single string.\n *\n * Pipeline:\n * 1. Empty input → `empty-input`.\n * 2. Looks like a ListForge URL / base64 payload → decode (base64 + gunzip + JSON.parse).\n * 3. Looks like raw JSON (starts with `{`/`[`) → JSON.parse.\n * 4. Otherwise treat as text.\n * 5. Greedy first-match adapter dispatch. The first adapter whose `matches()`\n *    accepts the decoded value wins; subsequent adapters are not tried.\n * 6. If the matched adapter's `parse()` throws, that's a matcher contract\n *    violation — surfaced as `parse-failed`, not silently retried.\n *\n * Caller never sees an exception; the discriminated {@link ImportResult} carries\n * either the resolved {@link Roster} (with the detected {@link RosterFormat})\n * or a typed failure plus per-adapter trial info for diagnostics.\n *\n * Prefer this over {@link importListForge} / {@link importNewRecruit} when the\n * caller doesn't know which format the user pasted.\n */\nexport function tryImportRoster(\n  input: string,\n  opts: ImportOptions = {},\n): ImportResult {\n  const trimmed = input.trim();\n  if (trimmed === \"\") {\n    return { ok: false, reason: \"empty-input\", message: \"input is empty\", trials: [] };\n  }\n\n  let decoded: unknown;\n  if (looksLikeListForgeEncoded(trimmed)) {\n    try {\n      decoded = decodeListForge(trimmed);\n    } catch (err) {\n      const message = (err as Error).message;\n      return {\n        ok: false,\n        reason: \"decode-failed\",\n        message: `failed to decode ListForge payload: ${message}`,\n        trials: [{ id: \"listforge\", matched: false, reason: message }],\n      };\n    }\n  } else if (trimmed.startsWith(\"{\") || trimmed.startsWith(\"[\")) {\n    try {\n      decoded = JSON.parse(trimmed);\n    } catch (err) {\n      return {\n        ok: false,\n        reason: \"decode-failed\",\n        message: `input looks like JSON but failed to parse: ${(err as Error).message}`,\n        trials: [],\n      };\n    }\n  } else {\n    decoded = input;\n  }\n\n  const ds = opts.dataset ?? Dataset.embedded();\n  const trials: AdapterTrial[] = [];\n  for (const adapter of ADAPTERS) {\n    if (!adapter.matches(decoded)) {\n      trials.push({ id: adapter.id, matched: false });\n      continue;\n    }\n    try {\n      const parsed = adapter.parse(decoded);\n      const roster = resolve(parsed, ds, adapter.id);\n      return { ok: true, roster, format: adapter.id };\n    } catch (err) {\n      const message = (err as Error).message;\n      trials.push({ id: adapter.id, matched: true, reason: message });\n      return {\n        ok: false,\n        reason: \"parse-failed\",\n        message: `${adapter.id}: ${message}`,\n        trials,\n      };\n    }\n  }\n\n  return {\n    ok: false,\n    reason: \"no-adapter-matched\",\n    message: `tried ${ADAPTERS.length} formats, none recognised the input`,\n    trials,\n  };\n}\n\n/** The adapter list, exposed for tests that need to walk every matcher (e.g.\n * the disjointness invariant test). */\nexport const REGISTERED_ADAPTERS: readonly FormatAdapter[] = ADAPTERS;\n"]}

package/dist/import/index.d.ts

@@ -9,8 +9,8 @@
  *
  * @packageDocumentation
  */
-export { importListForge, importNewRecruit, importRoster } from "./import-roster.js";
-export type { ImportOptions } from "./import-roster.js";
+export { importListForge, importNewRecruit, importRoster, tryImportRoster, REGISTERED_ADAPTERS, } from "./import-roster.js";
+export type { ImportOptions, ImportResult, ImportFailureReason, AdapterTrial, } from "./import-roster.js";
 export { decodeListForge } from "./decode.js";
 export { resolve } from "./resolve.js";
 export { listForgeAdapter } from "./listforge.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,WAAW,EACX,OAAO,EACP,WAAW,EACX,UAAU,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,WAAW,EACX,OAAO,EACP,WAAW,EACX,UAAU,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/import/index.js

@@ -9,7 +9,7 @@
  *
  * @packageDocumentation
  */
-export { importListForge, importNewRecruit, importRoster } from "./import-roster.js";
+export { importListForge, importNewRecruit, importRoster, tryImportRoster, REGISTERED_ADAPTERS, } from "./import-roster.js";
 export { decodeListForge } from "./decode.js";
 export { resolve } from "./resolve.js";
 export { listForgeAdapter } from "./listforge.js";

package/dist/import/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC","sourcesContent":["/**\n * Army-list importer: turn an external list-builder export into a resolved\n * 40kdc roster.\n *\n * v1 supports ListForge's \"share JSON\" payload. The output is a {@link Roster}\n * keyed on 40kdc entity ids and validatable against\n * `schemas/core/roster.schema.json`. Resolution is lenient — unmatched names are\n * retained with candidate suggestions and summarised in diagnostics.\n *\n * @packageDocumentation\n */\nexport { importListForge, importNewRecruit, importRoster } from \"./import-roster.js\";\nexport type { ImportOptions } from \"./import-roster.js\";\nexport { decodeListForge } from \"./decode.js\";\nexport { resolve } from \"./resolve.js\";\nexport { listForgeAdapter } from \"./listforge.js\";\nexport { newRecruitJsonAdapter } from \"./newrecruit-json.js\";\nexport { newRecruitSimpleAdapter } from \"./newrecruit-simple.js\";\nexport {\n  newRecruitWtcCompactAdapter,\n  newRecruitWtcFullAdapter,\n} from \"./newrecruit-wtc.js\";\nexport type { FormatAdapter } from \"./adapter.js\";\nexport type {\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  ResolvedRef,\n  Candidate,\n  RosterLeaderAttachment,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  BattleSize,\n  GameVersionRef,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC","sourcesContent":["/**\n * Army-list importer: turn an external list-builder export into a resolved\n * 40kdc roster.\n *\n * v1 supports ListForge's \"share JSON\" payload. The output is a {@link Roster}\n * keyed on 40kdc entity ids and validatable against\n * `schemas/core/roster.schema.json`. Resolution is lenient — unmatched names are\n * retained with candidate suggestions and summarised in diagnostics.\n *\n * @packageDocumentation\n */\nexport {\n  importListForge,\n  importNewRecruit,\n  importRoster,\n  tryImportRoster,\n  REGISTERED_ADAPTERS,\n} from \"./import-roster.js\";\nexport type {\n  ImportOptions,\n  ImportResult,\n  ImportFailureReason,\n  AdapterTrial,\n} from \"./import-roster.js\";\nexport { decodeListForge } from \"./decode.js\";\nexport { resolve } from \"./resolve.js\";\nexport { listForgeAdapter } from \"./listforge.js\";\nexport { newRecruitJsonAdapter } from \"./newrecruit-json.js\";\nexport { newRecruitSimpleAdapter } from \"./newrecruit-simple.js\";\nexport {\n  newRecruitWtcCompactAdapter,\n  newRecruitWtcFullAdapter,\n} from \"./newrecruit-wtc.js\";\nexport type { FormatAdapter } from \"./adapter.js\";\nexport type {\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  ResolvedRef,\n  Candidate,\n  RosterLeaderAttachment,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  BattleSize,\n  GameVersionRef,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./types.js\";\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"listforge.d.ts","sourceRoot":"","sources":["../../src/import/listforge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAmMlD,eAAO,MAAM,gBAAgB,EAAE,aA0D9B,CAAC"}
+{"version":3,"file":"listforge.d.ts","sourceRoot":"","sources":["../../src/import/listforge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiNlD,eAAO,MAAM,gBAAgB,EAAE,aA4D9B,CAAC"}

package/dist/import/listforge.js

@@ -4,6 +4,8 @@ const POINTS_LIMIT = /(\d[\d,]*)\s*Point/i;
 const ENHANCEMENT_GROUP_PREFIX = "Enhancements";
 const CHARACTER_CATEGORIES = new Set(["Character", "Epic Hero"]);
 const WEAPON_CATEGORY_SUFFIX = " Weapon"; // "Ranged Weapon", "Melee Weapon", "Psychic Weapon"
+const NEWRECRUIT_XMLNS = "http://www.battlescribe.net/schema/rosterSchema";
+const NEWRECRUIT_HOST_PREFIX = "https://newrecruit";
 function asArray(value) {
     return Array.isArray(value) ? value : [];
 }
@@ -144,10 +146,22 @@ function rosterOf(decoded) {
         return null;
     return roster;
 }
+/** Detect a NewRecruit-flavoured BattleScribe payload. ListForge's matcher
+ * excludes these so the greedy first-match dispatcher routes them to the
+ * NewRecruit adapter without falling through to here. */
+function hasNewRecruitSignature(decoded, roster) {
+    if (asString(roster.xmlns) === NEWRECRUIT_XMLNS)
+        return true;
+    const genBy = asString(decoded.generatedBy) ?? asString(roster.generatedBy);
+    return genBy !== null && genBy.toLowerCase().startsWith(NEWRECRUIT_HOST_PREFIX);
+}
 export const listForgeAdapter = {
     id: "listforge",
     matches(decoded) {
-        return rosterOf(decoded) !== null;
+        const roster = rosterOf(decoded);
+        if (!roster)
+            return false;
+        return !hasNewRecruitSignature(decoded, roster);
     },
     parse(decoded) {
         const payload = decoded;