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

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/import/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,EAAE,EAAE,YAAY,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IACnC,sEAAsE;IACtE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC;CACvC;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,aAAa,EAAE,GACxB,aAAa,CASf"}

package/dist/import/adapter.js

@@ -7,3 +7,4 @@ export function selectAdapter(decoded, adapters) {
     }
     return adapter;
 }
+//# sourceMappingURL=adapter.js.map

package/dist/import/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/import/adapter.ts"],"names":[],"mappings":"AA0BA,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,QAAyB;IAEzB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,WAAW,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * The format-adapter seam.\n *\n * Each supported source format implements {@link FormatAdapter}: it recognises a\n * decoded payload ({@link FormatAdapter.matches}) and lowers it to the\n * format-agnostic {@link ParsedRoster} ({@link FormatAdapter.parse}). Resolution\n * onto 40kdc entity ids happens once, downstream, against any `ParsedRoster` —\n * so adding a new source format (New Recruit, WTC, …) means writing one adapter,\n * not touching the resolver.\n *\n * v1 registers only {@link listForgeAdapter}.\n *\n * @packageDocumentation\n */\nimport type { ParsedRoster, RosterFormat } from \"./types.js\";\n\n/** Recognises and parses one source list-export format. */\nexport interface FormatAdapter {\n  /** Stable identifier for the format. Carries through to `Roster.source.format`. */\n  id: RosterFormat;\n  /** True when this adapter can parse the given decoded payload. */\n  matches(decoded: unknown): boolean;\n  /** Lower a recognised payload to the format-agnostic intermediate. */\n  parse(decoded: unknown): ParsedRoster;\n}\n\n/** Pick the first adapter that recognises the payload. */\nexport function selectAdapter(\n  decoded: unknown,\n  adapters: FormatAdapter[],\n): FormatAdapter {\n  const adapter = adapters.find((a) => a.matches(decoded));\n  if (!adapter) {\n    throw new Error(\n      \"no registered import adapter recognises this payload \" +\n        `(tried: ${adapters.map((a) => a.id).join(\", \") || \"none\"})`,\n    );\n  }\n  return adapter;\n}\n"]}

package/dist/import/decode.d.ts

@@ -4,3 +4,4 @@
  * @throws if the input is neither valid JSON nor a decodable gzip payload.
  */
 export declare function decodeListForge(input: string): unknown;
+//# sourceMappingURL=decode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/import/decode.ts"],"names":[],"mappings":"AA6CA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA+BtD"}

package/dist/import/decode.js

@@ -70,3 +70,4 @@ export function decodeListForge(input) {
     }
     return JSON.parse(json);
 }
+//# sourceMappingURL=decode.js.map

package/dist/import/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/import/decode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,kEAAkE;AAClE,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,2DAA2D;AAC3D,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAEvC;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpD,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,mCAAmC;IACnC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,wEAAwE;YACtE,4CAA4C,kBAAkB,KAAK,CACtE,CAAC;IACJ,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,kDAAkD,EAAE;YAClE,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["/**\n * Decode a ListForge share payload into a JSON object.\n *\n * ListForge packs a roster as `base64( gzip( utf8(json) ) )` and embeds it in a\n * URL hash fragment: `https://app/#/listforge/<BASE64>`. The fragment is used\n * deliberately so browsers never send it to a server, preserving the payload\n * verbatim. A valid gzipped payload always base64-encodes to a string starting\n * with `H4sIAAAAAAAAA`.\n *\n * {@link decodeListForge} accepts any of three forms and returns the parsed JSON:\n * - a full URL (the segment after the last `/` is taken),\n * - a bare base64 segment,\n * - an already-decoded JSON string (passed straight to `JSON.parse`).\n *\n * Only `node:zlib` is used — no third-party dependency.\n *\n * @packageDocumentation\n */\nimport { gunzipSync } from \"node:zlib\";\n\n/** The base64 prefix every ListForge gzip payload begins with. */\nconst GZIP_BASE64_PREFIX = \"H4sIA\";\n\n/** The path marker ListForge uses ahead of the payload. */\nconst LISTFORGE_MARKER = \"/listforge/\";\n\n/**\n * Extract the payload segment from an input that may be a URL.\n *\n * The base64 alphabet includes `/`, so a bare base64 segment cannot be split on\n * `/`. We only treat the input as a URL when it carries the `/listforge/` marker\n * or an `http(s)://` scheme; otherwise it is returned unchanged.\n */\nfunction extractSegment(input: string): string {\n  const markerIndex = input.indexOf(LISTFORGE_MARKER);\n  if (markerIndex !== -1) {\n    return input.slice(markerIndex + LISTFORGE_MARKER.length);\n  }\n  if (/^https?:\\/\\//i.test(input)) {\n    const lastSlash = input.lastIndexOf(\"/\");\n    return lastSlash === -1 ? input : input.slice(lastSlash + 1);\n  }\n  return input;\n}\n\n/**\n * Decode a ListForge payload (URL, bare base64, or raw JSON) into a JSON value.\n *\n * @throws if the input is neither valid JSON nor a decodable gzip payload.\n */\nexport function decodeListForge(input: string): unknown {\n  const trimmed = input.trim();\n  if (trimmed === \"\") {\n    throw new Error(\"decodeListForge: empty input\");\n  }\n\n  // Raw JSON object passed directly.\n  if (trimmed.startsWith(\"{\")) {\n    return JSON.parse(trimmed);\n  }\n\n  const segment = extractSegment(trimmed);\n\n  if (!segment.startsWith(GZIP_BASE64_PREFIX)) {\n    throw new Error(\n      \"decodeListForge: input is not a ListForge payload (expected raw JSON, \" +\n        `or a gzip+base64 segment beginning with \"${GZIP_BASE64_PREFIX}…\")`,\n    );\n  }\n\n  let json: string;\n  try {\n    const bytes = Buffer.from(segment, \"base64\");\n    json = gunzipSync(bytes).toString(\"utf8\");\n  } catch (cause) {\n    throw new Error(\"decodeListForge: failed to gunzip base64 payload\", {\n      cause,\n    });\n  }\n\n  return JSON.parse(json);\n}\n"]}

package/dist/import/gw.d.ts

@@ -0,0 +1,69 @@
+/**
+ * GW adapter: lower the Games Workshop 40K app's plain-text army-list export to
+ * a {@link ParsedRoster}.
+ *
+ * The format opens with the same `++++…++++` summary fence as the NewRecruit WTC
+ * formats (FACTION KEYWORD / DETACHMENT / TOTAL ARMY POINTS / WARLORD /
+ * ENHANCEMENT / NUMBER OF UNITS / SECONDARY), then lists units grouped under
+ * ALL-CAPS battlefield-role sections (`BATTLELINE`, `CHARACTERS`,
+ * `ALLIED UNITS`, …). Each unit is a header line `Name (N pts)` followed by
+ * `•`-bulleted entries:
+ *
+ * ```
+ * War Dog Executioner (130 pts)
+ * • 1x Armoured feet
+ * • 2x War Dog autocannon
+ * • Houndpack Lance Character, Warlord
+ *
+ * Nurglings (40 pts)
+ * • 3x Nurgling Swarm
+ *     • 3x Diseased claws and teeth
+ * ```
+ *
+ * Bullet classification (the parsing crux):
+ * - A top-level `• Nx Thing` *with* further-indented child bullets is a **model
+ *   group** — `N` adds to the model count and the children are that group's
+ *   wargear (Nurglings, Beasts of Nurgle).
+ * - A top-level `• Nx Thing` *without* children is plain **wargear**.
+ * - A bullet *without* an `Nx` count is an **annotation**: `… Character` flags a
+ *   character, `Warlord` flags the warlord, `Name (+N pts)` is the enhancement.
+ *
+ * **Disjointness from the WTC matchers**: the GW format always carries `•`
+ * bullets and never the WTC `N with` lines. wtc-full always has `N with` (so it
+ * never collides), and wtc-compact never has bullets (its matcher now excludes
+ * them). This adapter therefore matches on *bullets present* + *no `N with`*.
+ *
+ * The GW export carries no separate POINTS LIMIT line, so `declared_limit`
+ * falls back to TOTAL ARMY POINTS (the round-trippable battle-size signal).
+ *
+ * @packageDocumentation
+ */
+import type { FormatAdapter } from "./adapter.js";
+import type { ParsedUnit } from "./types.js";
+/** Accept the input only when it carries the FACTION KEYWORD summary header,
+ * has `•` bullets, and lacks the WTC `N with` body lines. */
+declare function isGwText(decoded: unknown): string | null;
+interface GwHeader {
+    name: string;
+    faction_raw_name: string | null;
+    detachment_raw_name: string | null;
+    total_reported: number | null;
+    declared_limit: number | null;
+    battle_size_raw: string | null;
+}
+declare function parseHeader(lines: string[]): {
+    header: GwHeader;
+    bodyStart: number;
+} | null;
+declare function parseBody(lines: string[], bodyStart: number): {
+    units: ParsedUnit[];
+    multi_force: boolean;
+};
+export declare const gwAdapter: FormatAdapter;
+export declare const _internals: {
+    isGwText: typeof isGwText;
+    parseHeader: typeof parseHeader;
+    parseBody: typeof parseBody;
+};
+export {};
+//# sourceMappingURL=gw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gw.d.ts","sourceRoot":"","sources":["../../src/import/gw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAgB,UAAU,EAAiB,MAAM,YAAY,CAAC;AA8B1E;6DAC6D;AAC7D,iBAAS,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMjD;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+CpF;AA8FD,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG;IACtD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB,CAsDA;AAED,eAAO,MAAM,SAAS,EAAE,aAqCvB,CAAC;AAGF,eAAO,MAAM,UAAU;;;;CAItB,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * Orchestrates an army-list import: decode → parse → resolve.
+ *
+ * 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, 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 { 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;
+}
+/**
+ * Import a ListForge share payload into a resolved 40kdc {@link Roster}.
+ *
+ * `input` may be a full ListForge URL, a bare base64 segment, or an
+ * already-decoded JSON string — all are handled transparently. For NewRecruit
+ * sources, use {@link importNewRecruit} (no base64/gzip decode).
+ */
+export declare function importListForge(input: string, opts?: ImportOptions): Roster;
+/**
+ * Import a NewRecruit export (any of the four formats — JSON, wtc-compact,
+ * wtc-full, simple) into a resolved 40kdc {@link Roster}.
+ *
+ * The JSON form is parsed when `input` is valid JSON; the text forms are
+ * dispatched on string content. No base64/gzip decoding is attempted —
+ * NewRecruit exports are not encoded.
+ */
+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

@@ -0,0 +1 @@
+{"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"}