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

package/dist/import/decode.js

@@ -0,0 +1,73 @@
+/**
+ * Decode a ListForge share payload into a JSON object.
+ *
+ * ListForge packs a roster as `base64( gzip( utf8(json) ) )` and embeds it in a
+ * URL hash fragment: `https://app/#/listforge/<BASE64>`. The fragment is used
+ * deliberately so browsers never send it to a server, preserving the payload
+ * verbatim. A valid gzipped payload always base64-encodes to a string starting
+ * with `H4sIAAAAAAAAA`.
+ *
+ * {@link decodeListForge} accepts any of three forms and returns the parsed JSON:
+ * - a full URL (the segment after the last `/` is taken),
+ * - a bare base64 segment,
+ * - an already-decoded JSON string (passed straight to `JSON.parse`).
+ *
+ * Only `node:zlib` is used — no third-party dependency.
+ *
+ * @packageDocumentation
+ */
+import { gunzipSync } from "node:zlib";
+/** The base64 prefix every ListForge gzip payload begins with. */
+const GZIP_BASE64_PREFIX = "H4sIA";
+/** The path marker ListForge uses ahead of the payload. */
+const LISTFORGE_MARKER = "/listforge/";
+/**
+ * Extract the payload segment from an input that may be a URL.
+ *
+ * The base64 alphabet includes `/`, so a bare base64 segment cannot be split on
+ * `/`. We only treat the input as a URL when it carries the `/listforge/` marker
+ * or an `http(s)://` scheme; otherwise it is returned unchanged.
+ */
+function extractSegment(input) {
+    const markerIndex = input.indexOf(LISTFORGE_MARKER);
+    if (markerIndex !== -1) {
+        return input.slice(markerIndex + LISTFORGE_MARKER.length);
+    }
+    if (/^https?:\/\//i.test(input)) {
+        const lastSlash = input.lastIndexOf("/");
+        return lastSlash === -1 ? input : input.slice(lastSlash + 1);
+    }
+    return input;
+}
+/**
+ * Decode a ListForge payload (URL, bare base64, or raw JSON) into a JSON value.
+ *
+ * @throws if the input is neither valid JSON nor a decodable gzip payload.
+ */
+export function decodeListForge(input) {
+    const trimmed = input.trim();
+    if (trimmed === "") {
+        throw new Error("decodeListForge: empty input");
+    }
+    // Raw JSON object passed directly.
+    if (trimmed.startsWith("{")) {
+        return JSON.parse(trimmed);
+    }
+    const segment = extractSegment(trimmed);
+    if (!segment.startsWith(GZIP_BASE64_PREFIX)) {
+        throw new Error("decodeListForge: input is not a ListForge payload (expected raw JSON, " +
+            `or a gzip+base64 segment beginning with "${GZIP_BASE64_PREFIX}…")`);
+    }
+    let json;
+    try {
+        const bytes = Buffer.from(segment, "base64");
+        json = gunzipSync(bytes).toString("utf8");
+    }
+    catch (cause) {
+        throw new Error("decodeListForge: failed to gunzip base64 payload", {
+            cause,
+        });
+    }
+    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/import-roster.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 — NewRecruit's tighter matchers run first so
+ * the ListForge fallback only catches generic BattleScribe JSON.
+ *
+ * @packageDocumentation
+ */
+import { Dataset } from "../data/dataset.js";
+import type { Roster } 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;
+//# 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;;;;;;;;;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"}

package/dist/import/import-roster.js

@@ -0,0 +1,97 @@
+/**
+ * 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 — NewRecruit's tighter matchers run first so
+ * the ListForge fallback only catches generic BattleScribe JSON.
+ *
+ * @packageDocumentation
+ */
+import { Dataset } from "../data/dataset.js";
+import { selectAdapter } from "./adapter.js";
+import { decodeListForge } from "./decode.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";
+/**
+ * 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
+ * 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.
+ */
+const ADAPTERS = [
+    newRecruitJsonAdapter,
+    newRecruitWtcFullAdapter,
+    newRecruitWtcCompactAdapter,
+    newRecruitSimpleAdapter,
+    listForgeAdapter,
+];
+/**
+ * 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 function importListForge(input, opts = {}) {
+    const decoded = decodeListForge(input);
+    return importRoster(decoded, opts);
+}
+/**
+ * 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 function importNewRecruit(input, opts = {}) {
+    const trimmed = input.trimStart();
+    if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+        try {
+            return importRoster(JSON.parse(input), opts);
+        }
+        catch {
+            // Fall through to treating the input as raw text.
+        }
+    }
+    return importRoster(input, opts);
+}
+/**
+ * Import an already-decoded payload. Selects the matching format adapter and
+ * resolves the result against the dataset. Accepts either a parsed JSON object
+ * (NewRecruit JSON / ListForge) or a string (the three NewRecruit text formats).
+ */
+/**
+ * Detect an already-resolved canonical {@link Roster} (the JSON shape produced
+ * by `rosterJsonSerializer`). Lets a downstream consumer round-trip canonical
+ * Roster JSON through `importRoster` without going through an adapter.
+ */
+function isCanonicalRoster(decoded) {
+    if (typeof decoded !== "object" || decoded === null)
+        return false;
+    const r = decoded;
+    const source = r.source;
+    return (typeof source === "object" &&
+        source !== null &&
+        typeof source.format === "string" &&
+        Array.isArray(r.units) &&
+        "diagnostics" in r);
+}
+export function importRoster(decoded, opts = {}) {
+    if (isCanonicalRoster(decoded))
+        return decoded;
+    const ds = opts.dataset ?? Dataset.embedded();
+    const adapter = selectAdapter(decoded, [...ADAPTERS]);
+    const parsed = adapter.parse(decoded);
+    return resolve(parsed, ds, adapter.id);
+}
+//# sourceMappingURL=import-roster.js.map

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

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

package/dist/import/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Army-list importer: turn an external list-builder export into a resolved
+ * 40kdc roster.
+ *
+ * v1 supports ListForge's "share JSON" payload. The output is a {@link Roster}
+ * keyed on 40kdc entity ids and validatable against
+ * `schemas/core/roster.schema.json`. Resolution is lenient — unmatched names are
+ * retained with candidate suggestions and summarised in diagnostics.
+ *
+ * @packageDocumentation
+ */
+export { importListForge, importNewRecruit, importRoster } from "./import-roster.js";
+export type { ImportOptions } from "./import-roster.js";
+export { decodeListForge } from "./decode.js";
+export { resolve } from "./resolve.js";
+export { listForgeAdapter } from "./listforge.js";
+export { newRecruitJsonAdapter } from "./newrecruit-json.js";
+export { newRecruitSimpleAdapter } from "./newrecruit-simple.js";
+export { newRecruitWtcCompactAdapter, newRecruitWtcFullAdapter, } from "./newrecruit-wtc.js";
+export type { FormatAdapter } from "./adapter.js";
+export type { Roster, RosterUnit, RosterWargear, RosterSource, RosterFormat, RosterPoints, ResolvedRef, Candidate, RosterLeaderAttachment, Diagnostics, Warning, WarningCode, BattleSize, GameVersionRef, ParsedRoster, ParsedUnit, ParsedWargear, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/import/index.js

@@ -0,0 +1,19 @@
+/**
+ * Army-list importer: turn an external list-builder export into a resolved
+ * 40kdc roster.
+ *
+ * v1 supports ListForge's "share JSON" payload. The output is a {@link Roster}
+ * keyed on 40kdc entity ids and validatable against
+ * `schemas/core/roster.schema.json`. Resolution is lenient — unmatched names are
+ * retained with candidate suggestions and summarised in diagnostics.
+ *
+ * @packageDocumentation
+ */
+export { importListForge, importNewRecruit, importRoster } from "./import-roster.js";
+export { decodeListForge } from "./decode.js";
+export { resolve } from "./resolve.js";
+export { listForgeAdapter } from "./listforge.js";
+export { newRecruitJsonAdapter } from "./newrecruit-json.js";
+export { newRecruitSimpleAdapter } from "./newrecruit-simple.js";
+export { newRecruitWtcCompactAdapter, newRecruitWtcFullAdapter, } from "./newrecruit-wtc.js";
+//# sourceMappingURL=index.js.map

package/dist/import/index.js.map

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

package/dist/import/listforge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ListForge adapter: lower a decoded ListForge "share JSON" payload (a
+ * BattleScribe-derived roster tree) to a {@link ParsedRoster}.
+ *
+ * The walk reads an ALLOWLIST of fields only — `name`, `number`, `type`,
+ * `categories[].name`, `group`, and `costs` point values — and never touches
+ * `rules[].description` or ability `profiles[].characteristics[].$text`, which
+ * carry reproduced rules text. This keeps the importer's output free of
+ * copyrighted prose by construction.
+ *
+ * Selection-tree shape (recursive `selections`):
+ * - Configuration nodes (`type: "upgrade"`) named "Detachment" / "Battle Size"
+ *   carry the chosen value as their first child selection.
+ * - Unit nodes (`type: "model" | "unit"`) carry role categories, a points cost,
+ *   and — nested anywhere beneath them — their wargear (weapon-category
+ *   selections), enhancement (a selection whose `group` starts "Enhancements"),
+ *   the "Warlord" marker, and model sub-selections.
+ * - Every unit carries a `"Faction: <Name>"` category.
+ *
+ * @packageDocumentation
+ */
+import type { FormatAdapter } from "./adapter.js";
+export declare const listForgeAdapter: FormatAdapter;
+//# sourceMappingURL=listforge.d.ts.map

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

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

package/dist/import/listforge.js

@@ -0,0 +1,201 @@
+const PTS_COST_NAME = "pts";
+const FACTION_CATEGORY = /^Faction:\s*(.+)$/;
+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"
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function asString(value) {
+    return typeof value === "string" ? value : null;
+}
+function selectionName(sel) {
+    return asString(sel.name) ?? "";
+}
+function selectionType(sel) {
+    return asString(sel.type) ?? "";
+}
+/** A selection's multiplicity (`number`), defaulting to 1. */
+function selectionCount(sel) {
+    return typeof sel.number === "number" && sel.number > 0 ? sel.number : 1;
+}
+/** Point value from a selection's cost block, or null when absent. */
+function pointsOf(sel) {
+    for (const raw of asArray(sel.costs)) {
+        const cost = raw;
+        if (asString(cost.name) === PTS_COST_NAME && typeof cost.value === "number") {
+            return cost.value;
+        }
+    }
+    return null;
+}
+function categoryNames(sel) {
+    return asArray(sel.categories)
+        .map((c) => asString(c.name))
+        .filter((n) => n !== null);
+}
+function childSelections(sel) {
+    return asArray(sel.selections);
+}
+/** Depth-first visit of a selection and everything beneath it. */
+function walk(sel, visit) {
+    visit(sel);
+    for (const child of childSelections(sel))
+        walk(child, visit);
+}
+function isUnitSelection(sel) {
+    const type = selectionType(sel);
+    return type === "model" || type === "unit";
+}
+function isCharacter(sel) {
+    return categoryNames(sel).some((n) => CHARACTER_CATEGORIES.has(n));
+}
+function isWeaponSelection(sel) {
+    return categoryNames(sel).some((n) => n.endsWith(WEAPON_CATEGORY_SUFFIX));
+}
+function isEnhancementSelection(sel) {
+    const group = asString(sel.group);
+    return group !== null && group.startsWith(ENHANCEMENT_GROUP_PREFIX);
+}
+/** Sum the model count of a unit from its nested model selections. */
+function modelCount(unit) {
+    let total = 0;
+    walk(unit, (s) => {
+        if (selectionType(s) === "model")
+            total += selectionCount(s);
+    });
+    return total > 0 ? total : selectionCount(unit);
+}
+/** Build a parsed unit from a top-level unit selection. */
+function parseUnit(unit) {
+    const wargear = [];
+    let enhancement_raw_name = null;
+    let enhancement_points = null;
+    let is_warlord = false;
+    for (const node of childSelections(unit)) {
+        walk(node, (s) => {
+            if (isEnhancementSelection(s)) {
+                if (enhancement_raw_name === null) {
+                    enhancement_raw_name = selectionName(s);
+                    enhancement_points = pointsOf(s);
+                }
+                return;
+            }
+            if (selectionName(s) === "Warlord") {
+                is_warlord = true;
+                return;
+            }
+            if (isWeaponSelection(s)) {
+                wargear.push({ raw_name: selectionName(s), count: selectionCount(s) });
+            }
+        });
+    }
+    return {
+        raw_name: selectionName(unit),
+        is_character: isCharacter(unit),
+        model_count: modelCount(unit),
+        points: pointsOf(unit),
+        is_warlord,
+        enhancement_raw_name,
+        enhancement_points,
+        wargear,
+    };
+}
+/** Value carried as the first child of a named configuration selection. */
+function configValue(selections, configName) {
+    const node = selections.find((s) => selectionName(s) === configName);
+    if (!node)
+        return null;
+    const child = childSelections(node)[0];
+    return child ? selectionName(child) : null;
+}
+function parseLimit(label) {
+    if (!label)
+        return null;
+    const match = POINTS_LIMIT.exec(label);
+    if (!match)
+        return null;
+    return Number.parseInt(match[1].replace(/,/g, ""), 10);
+}
+/** First `"Faction: X"` category found anywhere; reports all distinct names. */
+function collectFactions(forces) {
+    const seen = new Set();
+    for (const force of forces) {
+        for (const sel of childSelections(force)) {
+            walk(sel, (s) => {
+                for (const name of categoryNames(s)) {
+                    const match = FACTION_CATEGORY.exec(name);
+                    if (match)
+                        seen.add(match[1].trim());
+                }
+            });
+        }
+    }
+    return [...seen];
+}
+function rosterOf(decoded) {
+    if (!decoded || typeof decoded !== "object")
+        return null;
+    const roster = decoded.roster;
+    if (!roster || typeof roster !== "object")
+        return null;
+    if (!Array.isArray(roster.forces))
+        return null;
+    return roster;
+}
+export const listForgeAdapter = {
+    id: "listforge",
+    matches(decoded) {
+        return rosterOf(decoded) !== null;
+    },
+    parse(decoded) {
+        const payload = decoded;
+        const roster = rosterOf(decoded);
+        if (!roster) {
+            throw new Error("listforge: payload has no roster.forces array");
+        }
+        const forces = asArray(roster.forces);
+        // Configuration lives among each force's top-level selections.
+        let detachment_raw_name = null;
+        let battle_size_raw = null;
+        const units = [];
+        for (const force of forces) {
+            const top = childSelections(force);
+            detachment_raw_name ??= configValue(top, "Detachment");
+            battle_size_raw ??= configValue(top, "Battle Size");
+            for (const sel of top) {
+                if (isUnitSelection(sel))
+                    units.push(parseUnit(sel));
+            }
+        }
+        const factions = collectFactions(forces);
+        const total_reported = pointsOf(roster);
+        // Honest computed total: sum every cost line in the tree. A unit's own cost
+        // and its nested enhancement's cost are distinct lines that together make up
+        // the unit's army contribution, so a full walk reproduces the army total.
+        let total_computed = 0;
+        for (const force of forces) {
+            for (const sel of childSelections(force)) {
+                walk(sel, (s) => {
+                    const pts = pointsOf(s);
+                    if (pts)
+                        total_computed += pts;
+                });
+            }
+        }
+        return {
+            name: asString(payload.name) ?? asString(roster.name) ?? "Imported roster",
+            generated_by: asString(payload.generatedBy),
+            faction_raw_name: factions[0] ?? null,
+            detachment_raw_name,
+            battle_size_raw,
+            declared_limit: parseLimit(battle_size_raw),
+            total_reported,
+            total_computed,
+            units,
+            multi_force: factions.length > 1,
+        };
+    },
+};
+//# sourceMappingURL=listforge.js.map

package/dist/import/listforge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listforge.js","sourceRoot":"","sources":["../../src/import/listforge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ListForge adapter: lower a decoded ListForge \"share JSON\" payload (a\n * BattleScribe-derived roster tree) to a {@link ParsedRoster}.\n *\n * The walk reads an ALLOWLIST of fields only — `name`, `number`, `type`,\n * `categories[].name`, `group`, and `costs` point values — and never touches\n * `rules[].description` or ability `profiles[].characteristics[].$text`, which\n * carry reproduced rules text. This keeps the importer's output free of\n * copyrighted prose by construction.\n *\n * Selection-tree shape (recursive `selections`):\n * - Configuration nodes (`type: \"upgrade\"`) named \"Detachment\" / \"Battle Size\"\n *   carry the chosen value as their first child selection.\n * - Unit nodes (`type: \"model\" | \"unit\"`) carry role categories, a points cost,\n *   and — nested anywhere beneath them — their wargear (weapon-category\n *   selections), enhancement (a selection whose `group` starts \"Enhancements\"),\n *   the \"Warlord\" marker, and model sub-selections.\n * - Every unit carries a `\"Faction: <Name>\"` category.\n *\n * @packageDocumentation\n */\nimport type { FormatAdapter } from \"./adapter.js\";\nimport type { ParsedRoster, ParsedUnit, ParsedWargear } from \"./types.js\";\n\nconst PTS_COST_NAME = \"pts\";\nconst FACTION_CATEGORY = /^Faction:\\s*(.+)$/;\nconst POINTS_LIMIT = /(\\d[\\d,]*)\\s*Point/i;\nconst ENHANCEMENT_GROUP_PREFIX = \"Enhancements\";\nconst CHARACTER_CATEGORIES = new Set([\"Character\", \"Epic Hero\"]);\nconst WEAPON_CATEGORY_SUFFIX = \" Weapon\"; // \"Ranged Weapon\", \"Melee Weapon\", \"Psychic Weapon\"\n\n// --- Minimal structural views of the parts of the payload we read. ----------\n\ninterface RawCategory {\n  name?: unknown;\n}\ninterface RawCost {\n  name?: unknown;\n  value?: unknown;\n}\ninterface RawSelection {\n  name?: unknown;\n  type?: unknown;\n  number?: unknown;\n  group?: unknown;\n  categories?: unknown;\n  costs?: unknown;\n  selections?: unknown;\n}\n\nfunction asArray(value: unknown): unknown[] {\n  return Array.isArray(value) ? value : [];\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction selectionName(sel: RawSelection): string {\n  return asString(sel.name) ?? \"\";\n}\n\nfunction selectionType(sel: RawSelection): string {\n  return asString(sel.type) ?? \"\";\n}\n\n/** A selection's multiplicity (`number`), defaulting to 1. */\nfunction selectionCount(sel: RawSelection): number {\n  return typeof sel.number === \"number\" && sel.number > 0 ? sel.number : 1;\n}\n\n/** Point value from a selection's cost block, or null when absent. */\nfunction pointsOf(sel: RawSelection): number | null {\n  for (const raw of asArray(sel.costs)) {\n    const cost = raw as RawCost;\n    if (asString(cost.name) === PTS_COST_NAME && typeof cost.value === \"number\") {\n      return cost.value;\n    }\n  }\n  return null;\n}\n\nfunction categoryNames(sel: RawSelection): string[] {\n  return asArray(sel.categories)\n    .map((c) => asString((c as RawCategory).name))\n    .filter((n): n is string => n !== null);\n}\n\nfunction childSelections(sel: RawSelection): RawSelection[] {\n  return asArray(sel.selections) as RawSelection[];\n}\n\n/** Depth-first visit of a selection and everything beneath it. */\nfunction walk(sel: RawSelection, visit: (s: RawSelection) => void): void {\n  visit(sel);\n  for (const child of childSelections(sel)) walk(child, visit);\n}\n\nfunction isUnitSelection(sel: RawSelection): boolean {\n  const type = selectionType(sel);\n  return type === \"model\" || type === \"unit\";\n}\n\nfunction isCharacter(sel: RawSelection): boolean {\n  return categoryNames(sel).some((n) => CHARACTER_CATEGORIES.has(n));\n}\n\nfunction isWeaponSelection(sel: RawSelection): boolean {\n  return categoryNames(sel).some((n) => n.endsWith(WEAPON_CATEGORY_SUFFIX));\n}\n\nfunction isEnhancementSelection(sel: RawSelection): boolean {\n  const group = asString(sel.group);\n  return group !== null && group.startsWith(ENHANCEMENT_GROUP_PREFIX);\n}\n\n/** Sum the model count of a unit from its nested model selections. */\nfunction modelCount(unit: RawSelection): number {\n  let total = 0;\n  walk(unit, (s) => {\n    if (selectionType(s) === \"model\") total += selectionCount(s);\n  });\n  return total > 0 ? total : selectionCount(unit);\n}\n\n/** Build a parsed unit from a top-level unit selection. */\nfunction parseUnit(unit: RawSelection): ParsedUnit {\n  const wargear: ParsedWargear[] = [];\n  let enhancement_raw_name: string | null = null;\n  let enhancement_points: number | null = null;\n  let is_warlord = false;\n\n  for (const node of childSelections(unit)) {\n    walk(node, (s) => {\n      if (isEnhancementSelection(s)) {\n        if (enhancement_raw_name === null) {\n          enhancement_raw_name = selectionName(s);\n          enhancement_points = pointsOf(s);\n        }\n        return;\n      }\n      if (selectionName(s) === \"Warlord\") {\n        is_warlord = true;\n        return;\n      }\n      if (isWeaponSelection(s)) {\n        wargear.push({ raw_name: selectionName(s), count: selectionCount(s) });\n      }\n    });\n  }\n\n  return {\n    raw_name: selectionName(unit),\n    is_character: isCharacter(unit),\n    model_count: modelCount(unit),\n    points: pointsOf(unit),\n    is_warlord,\n    enhancement_raw_name,\n    enhancement_points,\n    wargear,\n  };\n}\n\n/** Value carried as the first child of a named configuration selection. */\nfunction configValue(\n  selections: RawSelection[],\n  configName: string,\n): string | null {\n  const node = selections.find((s) => selectionName(s) === configName);\n  if (!node) return null;\n  const child = childSelections(node)[0];\n  return child ? selectionName(child) : null;\n}\n\nfunction parseLimit(label: string | null): number | null {\n  if (!label) return null;\n  const match = POINTS_LIMIT.exec(label);\n  if (!match) return null;\n  return Number.parseInt(match[1].replace(/,/g, \"\"), 10);\n}\n\n/** First `\"Faction: X\"` category found anywhere; reports all distinct names. */\nfunction collectFactions(forces: RawSelection[]): string[] {\n  const seen = new Set<string>();\n  for (const force of forces) {\n    for (const sel of childSelections(force)) {\n      walk(sel, (s) => {\n        for (const name of categoryNames(s)) {\n          const match = FACTION_CATEGORY.exec(name);\n          if (match) seen.add(match[1].trim());\n        }\n      });\n    }\n  }\n  return [...seen];\n}\n\ninterface RawRoster {\n  name?: unknown;\n  costs?: unknown;\n  forces?: unknown;\n}\ninterface RawPayload {\n  name?: unknown;\n  generatedBy?: unknown;\n  roster?: unknown;\n}\n\nfunction rosterOf(decoded: unknown): RawRoster | null {\n  if (!decoded || typeof decoded !== \"object\") return null;\n  const roster = (decoded as RawPayload).roster;\n  if (!roster || typeof roster !== \"object\") return null;\n  if (!Array.isArray((roster as RawRoster).forces)) return null;\n  return roster as RawRoster;\n}\n\nexport const listForgeAdapter: FormatAdapter = {\n  id: \"listforge\",\n\n  matches(decoded: unknown): boolean {\n    return rosterOf(decoded) !== null;\n  },\n\n  parse(decoded: unknown): ParsedRoster {\n    const payload = decoded as RawPayload;\n    const roster = rosterOf(decoded);\n    if (!roster) {\n      throw new Error(\"listforge: payload has no roster.forces array\");\n    }\n\n    const forces = asArray(roster.forces) as RawSelection[];\n\n    // Configuration lives among each force's top-level selections.\n    let detachment_raw_name: string | null = null;\n    let battle_size_raw: string | null = null;\n    const units: ParsedUnit[] = [];\n    for (const force of forces) {\n      const top = childSelections(force);\n      detachment_raw_name ??= configValue(top, \"Detachment\");\n      battle_size_raw ??= configValue(top, \"Battle Size\");\n      for (const sel of top) {\n        if (isUnitSelection(sel)) units.push(parseUnit(sel));\n      }\n    }\n\n    const factions = collectFactions(forces);\n    const total_reported = pointsOf(roster as RawSelection);\n\n    // Honest computed total: sum every cost line in the tree. A unit's own cost\n    // and its nested enhancement's cost are distinct lines that together make up\n    // the unit's army contribution, so a full walk reproduces the army total.\n    let total_computed = 0;\n    for (const force of forces) {\n      for (const sel of childSelections(force)) {\n        walk(sel, (s) => {\n          const pts = pointsOf(s);\n          if (pts) total_computed += pts;\n        });\n      }\n    }\n\n    return {\n      name: asString(payload.name) ?? asString(roster.name) ?? \"Imported roster\",\n      generated_by: asString(payload.generatedBy),\n      faction_raw_name: factions[0] ?? null,\n      detachment_raw_name,\n      battle_size_raw,\n      declared_limit: parseLimit(battle_size_raw),\n      total_reported,\n      total_computed,\n      units,\n      multi_force: factions.length > 1,\n    };\n  },\n};\n"]}

package/dist/import/newrecruit-json.d.ts

@@ -0,0 +1,31 @@
+/**
+ * NewRecruit JSON adapter: lower a decoded NewRecruit roster export (a
+ * BattleScribe-derived tree, same outer shape as ListForge) to a {@link ParsedRoster}.
+ *
+ * NewRecruit-specific signals used to detect the format:
+ * - `generatedBy` reports the NewRecruit URL ("https://newrecruit.eu"), and/or
+ * - `roster.xmlns` is set to the BattleScribe rosterSchema namespace.
+ *
+ * The primary faction surfaces in `forces[].catalogueName` (e.g.
+ * "Chaos - Chaos Knights") — we take the segment after the final " - ". Falls
+ * back to the first `"Faction: X"` category if no catalogueName is present.
+ *
+ * The walk reads the same ALLOWLIST as the ListForge adapter — `name`,
+ * `number`, `type`, `categories[].name`, `group`, `costs` point values, and
+ * `catalogueName`. `rules[].description`, ability `profiles[].characteristics[].$text`,
+ * and every other prose field are never touched, so the importer's output is
+ * free of copyrighted prose by construction.
+ *
+ * Selection-tree shape (recursive `selections`) is identical to ListForge:
+ * - Configuration nodes (`type: "upgrade"`) named "Detachment" / "Battle Size"
+ *   carry the chosen value as their first child selection.
+ * - Unit nodes (`type: "model" | "unit"`) carry role categories, a points cost,
+ *   and — nested anywhere beneath them — their wargear (weapon-category
+ *   selections), enhancement (a selection whose `group` starts "Enhancements"),
+ *   the "Warlord" marker, and model sub-selections.
+ *
+ * @packageDocumentation
+ */
+import type { FormatAdapter } from "./adapter.js";
+export declare const newRecruitJsonAdapter: FormatAdapter;
+//# sourceMappingURL=newrecruit-json.d.ts.map

package/dist/import/newrecruit-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newrecruit-json.d.ts","sourceRoot":"","sources":["../../src/import/newrecruit-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4NlD,eAAO,MAAM,qBAAqB,EAAE,aA4DnC,CAAC"}