@alpaca-software/40kdc-data 0.5.5 → 0.5.12

package/README.md

@@ -61,6 +61,16 @@ as `normalizeName` so you can reproduce it in your own search UI.
 
 Auto-generated from the source: [`docs/api/`](docs/api/README.md).
 
+## See it in action
+
+Open-source example apps built on this package:
+
+- [List Builder](https://list-builder.alpacasoft.dev) — build an army list and export to ListForge / NewRecruit.
+- [Salvo](https://salvo.alpacasoft.dev) — damage calculator over the cruncher and abilities-resolver.
+- [Mission Matrix](https://mission-matrix.alpacasoft.dev) — the 11th-edition Force Disposition matchup grid.
+- [Layout Editor](https://layout-editor.alpacasoft.dev) — author terrain layouts on a board; exports terrain-layout JSON.
+- [Hull Tracer](https://hull-tracer.alpacasoft.dev) — trace a model's collision hull from a top-down photo; exports geometry-only hull-shape JSON.
+
 ## Also: schema validation
 
 This package also ships the canonical JSON Schemas and an AJV-based validator

package/dist/codegen-data.js

@@ -24,6 +24,7 @@ const EXCLUDED_DIRS = new Set(["_example", "_port-audit"]);
 /** Map a data file's base name (sans `.json`) to its `RawData` collection key. */
 const FILE_TO_COLLECTION = {
     units: "units",
+    "target-profiles": "targetProfiles",
     weapons: "weapons",
     "weapon-keywords": "weaponKeywords",
     factions: "factions",
@@ -44,6 +45,7 @@ const FILE_TO_COLLECTION = {
     "force-dispositions": "forceDispositions",
     "terrain-templates": "terrainTemplates",
     "terrain-layouts": "terrainLayouts",
+    "hull-shapes": "hullShapes",
     "resource-pools": "resourcePools",
     "timing-flags": "timingFlags",
     "interaction-flags": "interactionFlags",

package/dist/codegen-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-data.js","sourceRoot":"","sources":["../src/codegen-data.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bundles every authored data file under `data/` into a single embedded module,\n * `src/data/bundle.generated.ts`.\n *\n * The bundle is inlined as an escaped JSON *string* that is `JSON.parse`d at load\n * time (mirroring the Rust crate's `include_str!`): tsc typechecks it instantly\n * (it is just a string), it parses once at import, and it compiles into `dist`\n * with no runtime filesystem access — so the published package works in Node,\n * bundlers, and browsers alike, where `data/` is not shipped.\n *\n * Run via `npm run codegen:data`. The output is gitignored and regenerated on\n * build/test/pack.\n */\nimport { readdirSync, readFileSync, statSync, writeFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { emptyRawData, type RawData } from \"./data/types.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst REPO_ROOT = resolve(__dirname, \"../..\");\nconst DATA_ROOTS = [join(REPO_ROOT, \"data\", \"core\"), join(REPO_ROOT, \"data\", \"enrichment\")];\nconst OUT_FILE = join(__dirname, \"data\", \"bundle.generated.ts\");\n\n/** Directory names that hold examples/scratch data and must never be bundled. */\nconst EXCLUDED_DIRS = new Set([\"_example\", \"_port-audit\"]);\n\n/** Map a data file's base name (sans `.json`) to its `RawData` collection key. */\nconst FILE_TO_COLLECTION: Record<string, keyof RawData> = {\n  units: \"units\",\n  weapons: \"weapons\",\n  \"weapon-keywords\": \"weaponKeywords\",\n  factions: \"factions\",\n  abilities: \"abilities\",\n  \"phase-mappings\": \"phaseMappings\",\n  detachments: \"detachments\",\n  stratagems: \"stratagems\",\n  enhancements: \"enhancements\",\n  \"leader-attachments\": \"leaderAttachments\",\n  \"unit-compositions\": \"unitCompositions\",\n  \"wargear-options\": \"wargearOptions\",\n  wargear: \"wargear\",\n  \"game-versions\": \"gameVersions\",\n  missions: \"missions\",\n  \"mission-matchups\": \"missionMatchups\",\n  \"secondary-cards\": \"missionCards\",\n  \"deployment-patterns\": \"deploymentPatterns\",\n  \"force-dispositions\": \"forceDispositions\",\n  \"terrain-templates\": \"terrainTemplates\",\n  \"terrain-layouts\": \"terrainLayouts\",\n  \"resource-pools\": \"resourcePools\",\n  \"timing-flags\": \"timingFlags\",\n  \"interaction-flags\": \"interactionFlags\",\n};\n\n/** The id-bearing key for a collection, used only for duplicate-id reporting. */\nconst ID_KEY: Partial<Record<keyof RawData, string>> = {\n  abilities: \"ability_id\",\n};\n\n/** Recursively collect bundleable `.json` files, skipping excluded dirs/examples. */\nfunction collectFiles(dir: string): string[] {\n  const out: string[] = [];\n  for (const entry of readdirSync(dir)) {\n    if (EXCLUDED_DIRS.has(entry)) continue;\n    const full = join(dir, entry);\n    if (statSync(full).isDirectory()) {\n      out.push(...collectFiles(full));\n    } else if (entry.endsWith(\".json\") && !entry.endsWith(\".example.json\")) {\n      out.push(full);\n    }\n  }\n  return out;\n}\n\nfunction baseName(file: string): string {\n  return file.slice(file.lastIndexOf(\"/\") + 1, -\".json\".length);\n}\n\nfunction build(): RawData {\n  const data = emptyRawData();\n  for (const root of DATA_ROOTS) {\n    for (const file of collectFiles(root)) {\n      const collection = FILE_TO_COLLECTION[baseName(file)];\n      if (!collection) continue; // schema/scratch json we don't bundle\n      const parsed = JSON.parse(readFileSync(file, \"utf-8\")) as unknown;\n      if (!Array.isArray(parsed)) {\n        throw new Error(`expected a JSON array in ${file}`);\n      }\n      (data[collection] as unknown[]).push(...parsed);\n    }\n  }\n  return data;\n}\n\n/** Warn (do not fail) on duplicate primary ids — a data-hygiene signal. */\nfunction reportDuplicateIds(data: RawData): void {\n  for (const [collection, key] of Object.entries(ID_KEY) as [keyof RawData, string][]) {\n    const seen = new Set<string>();\n    const dupes = new Set<string>();\n    for (const item of data[collection] as Record<string, unknown>[]) {\n      const id = item[key] as string | undefined;\n      if (id === undefined) continue;\n      if (seen.has(id)) dupes.add(id);\n      else seen.add(id);\n    }\n    if (dupes.size > 0) {\n      console.warn(`  ⚠ ${collection}: ${dupes.size} duplicate ${key}(s), e.g. ${[...dupes].slice(0, 3).join(\", \")}`);\n    }\n  }\n}\n\nfunction emit(data: RawData): string {\n  // JSON.stringify of the JSON text yields a valid, fully-escaped JS string\n  // literal — safe to drop straight into the generated source.\n  const jsonText = JSON.stringify(data);\n  const literal = JSON.stringify(jsonText);\n  return `/* GENERATED by 'npm run codegen:data' from the repository's data/ tree. DO NOT EDIT BY HAND. */\nimport type { RawData } from \"./types.js\";\n\nconst JSON_TEXT = ${literal};\n\n/** The full 40kdc dataset, embedded at build time and parsed once at load. */\nexport const RAW_DATA: RawData = JSON.parse(JSON_TEXT) as RawData;\n`;\n}\n\nfunction main(): void {\n  const data = build();\n  reportDuplicateIds(data);\n  writeFileSync(OUT_FILE, emit(data));\n  const counts = (Object.keys(data) as (keyof RawData)[])\n    .map((k) => `${k}=${data[k].length}`)\n    .join(\", \");\n  console.log(`Wrote ${OUT_FILE}\\n  ${counts}`);\n}\n\nmain();\n"]}
+{"version":3,"file":"codegen-data.js","sourceRoot":"","sources":["../src/codegen-data.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Bundles every authored data file under `data/` into a single embedded module,\n * `src/data/bundle.generated.ts`.\n *\n * The bundle is inlined as an escaped JSON *string* that is `JSON.parse`d at load\n * time (mirroring the Rust crate's `include_str!`): tsc typechecks it instantly\n * (it is just a string), it parses once at import, and it compiles into `dist`\n * with no runtime filesystem access — so the published package works in Node,\n * bundlers, and browsers alike, where `data/` is not shipped.\n *\n * Run via `npm run codegen:data`. The output is gitignored and regenerated on\n * build/test/pack.\n */\nimport { readdirSync, readFileSync, statSync, writeFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { emptyRawData, type RawData } from \"./data/types.js\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst REPO_ROOT = resolve(__dirname, \"../..\");\nconst DATA_ROOTS = [join(REPO_ROOT, \"data\", \"core\"), join(REPO_ROOT, \"data\", \"enrichment\")];\nconst OUT_FILE = join(__dirname, \"data\", \"bundle.generated.ts\");\n\n/** Directory names that hold examples/scratch data and must never be bundled. */\nconst EXCLUDED_DIRS = new Set([\"_example\", \"_port-audit\"]);\n\n/** Map a data file's base name (sans `.json`) to its `RawData` collection key. */\nconst FILE_TO_COLLECTION: Record<string, keyof RawData> = {\n  units: \"units\",\n  \"target-profiles\": \"targetProfiles\",\n  weapons: \"weapons\",\n  \"weapon-keywords\": \"weaponKeywords\",\n  factions: \"factions\",\n  abilities: \"abilities\",\n  \"phase-mappings\": \"phaseMappings\",\n  detachments: \"detachments\",\n  stratagems: \"stratagems\",\n  enhancements: \"enhancements\",\n  \"leader-attachments\": \"leaderAttachments\",\n  \"unit-compositions\": \"unitCompositions\",\n  \"wargear-options\": \"wargearOptions\",\n  wargear: \"wargear\",\n  \"game-versions\": \"gameVersions\",\n  missions: \"missions\",\n  \"mission-matchups\": \"missionMatchups\",\n  \"secondary-cards\": \"missionCards\",\n  \"deployment-patterns\": \"deploymentPatterns\",\n  \"force-dispositions\": \"forceDispositions\",\n  \"terrain-templates\": \"terrainTemplates\",\n  \"terrain-layouts\": \"terrainLayouts\",\n  \"hull-shapes\": \"hullShapes\",\n  \"resource-pools\": \"resourcePools\",\n  \"timing-flags\": \"timingFlags\",\n  \"interaction-flags\": \"interactionFlags\",\n};\n\n/** The id-bearing key for a collection, used only for duplicate-id reporting. */\nconst ID_KEY: Partial<Record<keyof RawData, string>> = {\n  abilities: \"ability_id\",\n};\n\n/** Recursively collect bundleable `.json` files, skipping excluded dirs/examples. */\nfunction collectFiles(dir: string): string[] {\n  const out: string[] = [];\n  for (const entry of readdirSync(dir)) {\n    if (EXCLUDED_DIRS.has(entry)) continue;\n    const full = join(dir, entry);\n    if (statSync(full).isDirectory()) {\n      out.push(...collectFiles(full));\n    } else if (entry.endsWith(\".json\") && !entry.endsWith(\".example.json\")) {\n      out.push(full);\n    }\n  }\n  return out;\n}\n\nfunction baseName(file: string): string {\n  return file.slice(file.lastIndexOf(\"/\") + 1, -\".json\".length);\n}\n\nfunction build(): RawData {\n  const data = emptyRawData();\n  for (const root of DATA_ROOTS) {\n    for (const file of collectFiles(root)) {\n      const collection = FILE_TO_COLLECTION[baseName(file)];\n      if (!collection) continue; // schema/scratch json we don't bundle\n      const parsed = JSON.parse(readFileSync(file, \"utf-8\")) as unknown;\n      if (!Array.isArray(parsed)) {\n        throw new Error(`expected a JSON array in ${file}`);\n      }\n      (data[collection] as unknown[]).push(...parsed);\n    }\n  }\n  return data;\n}\n\n/** Warn (do not fail) on duplicate primary ids — a data-hygiene signal. */\nfunction reportDuplicateIds(data: RawData): void {\n  for (const [collection, key] of Object.entries(ID_KEY) as [keyof RawData, string][]) {\n    const seen = new Set<string>();\n    const dupes = new Set<string>();\n    for (const item of data[collection] as Record<string, unknown>[]) {\n      const id = item[key] as string | undefined;\n      if (id === undefined) continue;\n      if (seen.has(id)) dupes.add(id);\n      else seen.add(id);\n    }\n    if (dupes.size > 0) {\n      console.warn(`  ⚠ ${collection}: ${dupes.size} duplicate ${key}(s), e.g. ${[...dupes].slice(0, 3).join(\", \")}`);\n    }\n  }\n}\n\nfunction emit(data: RawData): string {\n  // JSON.stringify of the JSON text yields a valid, fully-escaped JS string\n  // literal — safe to drop straight into the generated source.\n  const jsonText = JSON.stringify(data);\n  const literal = JSON.stringify(jsonText);\n  return `/* GENERATED by 'npm run codegen:data' from the repository's data/ tree. DO NOT EDIT BY HAND. */\nimport type { RawData } from \"./types.js\";\n\nconst JSON_TEXT = ${literal};\n\n/** The full 40kdc dataset, embedded at build time and parsed once at load. */\nexport const RAW_DATA: RawData = JSON.parse(JSON_TEXT) as RawData;\n`;\n}\n\nfunction main(): void {\n  const data = build();\n  reportDuplicateIds(data);\n  writeFileSync(OUT_FILE, emit(data));\n  const counts = (Object.keys(data) as (keyof RawData)[])\n    .map((k) => `${k}=${data[k].length}`)\n    .join(\", \");\n  console.log(`Wrote ${OUT_FILE}\\n  ${counts}`);\n}\n\nmain();\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAkBA,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAqDD,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAsCf"}
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAkBA,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA2DD,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/commands/import.js

@@ -34,7 +34,9 @@ function formatPretty(roster) {
     const lines = [];
     lines.push(`Roster: ${roster.name}`);
     lines.push(`  Faction:    ${roster.faction_id ?? "(unresolved)"}`);
-    lines.push(`  Detachment: ${roster.detachment_id ?? "(none/unresolved)"}`);
+    lines.push(`  Detachments: ${roster.detachments
+        .map((d) => `${d.ref.id ?? d.ref.raw_name}${d.dp_cost != null ? ` (${d.dp_cost} DP)` : ""}`)
+        .join(", ") || "(none/unresolved)"}`);
     lines.push(`  Battle size: ${roster.battle_size ?? "(unmapped)"}`);
     lines.push(`  Points: computed ${roster.points.total_computed}` +
         (roster.points.total_reported !== null ? `, reported ${roster.points.total_reported}` : "") +

package/dist/commands/import.js.map

@@ -1 +1 @@
-{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `import` command: turn a ListForge army-list export into a 40kdc roster.\n *\n * Input may be a ListForge URL, a bare base64 segment, an already-decoded JSON\n * string, or a path to a file containing any of those (or `-`/omitted for stdin).\n * The resolved roster is validated against `roster.schema.json` before output —\n * a guard that the importer only ever emits schema-valid rosters.\n *\n * The import is lenient: unresolved entries do not fail the command (exit 0).\n * Only a decode failure or schema-invalid output is fatal (exit 1).\n */\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { importListForge } from \"../import/index.js\";\nimport { createValidator } from \"../schema-loader.js\";\nimport type { Roster } from \"../import/index.js\";\n\nconst ROSTER_SCHEMA_ID = \"https://40kdc.dev/schemas/core/roster.schema.json\";\n\ninterface ImportOpts {\n  reporter: string;\n  out?: string;\n}\n\nfunction readStdin(): string {\n  try {\n    return readFileSync(0, \"utf8\");\n  } catch {\n    return \"\";\n  }\n}\n\n/** Resolve the command's input source to a raw payload string. */\nfunction resolveInput(input: string | undefined): string {\n  if (!input || input === \"-\") return readStdin().trim();\n  if (existsSync(input)) return readFileSync(input, \"utf8\").trim();\n  return input;\n}\n\nfunction formatPretty(roster: Roster): string {\n  const d = roster.diagnostics;\n  const lines: string[] = [];\n  lines.push(`Roster: ${roster.name}`);\n  lines.push(`  Faction:    ${roster.faction_id ?? \"(unresolved)\"}`);\n  lines.push(`  Detachment: ${roster.detachment_id ?? \"(none/unresolved)\"}`);\n  lines.push(`  Battle size: ${roster.battle_size ?? \"(unmapped)\"}`);\n  lines.push(\n    `  Points: computed ${roster.points.total_computed}` +\n      (roster.points.total_reported !== null ? `, reported ${roster.points.total_reported}` : \"\") +\n      (roster.points.declared_limit !== null ? `, limit ${roster.points.declared_limit}` : \"\"),\n  );\n  lines.push(`  Units (${roster.units.length}):`);\n  for (const u of roster.units) {\n    const mark = u.ref.resolved ? \"✓\" : \"✗\";\n    const id = u.ref.resolved ? u.ref.id : `${u.ref.raw_name} → unresolved`;\n    const extras: string[] = [];\n    if (u.is_warlord) extras.push(\"warlord\");\n    if (u.enhancement) extras.push(`enh:${u.enhancement.resolved ? u.enhancement.id : \"?\"}`);\n    if (u.leader_attachment) extras.push(`leads:${u.leader_attachment.bodyguard_ref.id}?`);\n    const suffix = extras.length ? ` [${extras.join(\", \")}]` : \"\";\n    lines.push(`    ${mark} ${id} ×${u.model_count}${u.points !== null ? ` (${u.points}pts)` : \"\"}${suffix}`);\n  }\n  lines.push(\n    `  Resolved: ${d.resolved_units} units / ${d.resolved_weapons} weapons; ` +\n      `unresolved: ${d.unresolved_units} units / ${d.unresolved_weapons} weapons`,\n  );\n  if (d.warnings.length) {\n    lines.push(`  Warnings (${d.warnings.length}):`);\n    for (const w of d.warnings) {\n      lines.push(`    - [${w.code}]${w.raw_name ? ` \"${w.raw_name}\":` : \"\"} ${w.message}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n\nexport async function importCommand(\n  input: string | undefined,\n  opts: ImportOpts,\n): Promise<void> {\n  const payload = resolveInput(input);\n  if (!payload) {\n    console.error(\"import: no input (provide a URL/base64/JSON argument, a file path, or pipe via stdin)\");\n    process.exit(1);\n  }\n\n  let roster: Roster;\n  try {\n    roster = importListForge(payload);\n  } catch (err) {\n    console.error(`import: failed to decode/parse payload: ${(err as Error).message}`);\n    process.exit(1);\n  }\n\n  // Guard: our own output must be schema-valid.\n  const validate = createValidator().getSchema(ROSTER_SCHEMA_ID);\n  if (!validate) {\n    console.error(`import: roster schema not found (${ROSTER_SCHEMA_ID})`);\n    process.exit(1);\n  }\n  if (!validate(roster)) {\n    console.error(\"import: produced roster failed schema validation:\");\n    console.error(JSON.stringify(validate.errors, null, 2));\n    process.exit(1);\n  }\n\n  const json = JSON.stringify(roster, null, 2);\n  if (opts.out) {\n    writeFileSync(opts.out, json + \"\\n\", \"utf8\");\n    console.error(`Wrote roster → ${opts.out}`);\n  }\n\n  if (opts.reporter === \"pretty\") {\n    console.log(formatPretty(roster));\n  } else if (!opts.out) {\n    console.log(json);\n  }\n}\n"]}
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `import` command: turn a ListForge army-list export into a 40kdc roster.\n *\n * Input may be a ListForge URL, a bare base64 segment, an already-decoded JSON\n * string, or a path to a file containing any of those (or `-`/omitted for stdin).\n * The resolved roster is validated against `roster.schema.json` before output —\n * a guard that the importer only ever emits schema-valid rosters.\n *\n * The import is lenient: unresolved entries do not fail the command (exit 0).\n * Only a decode failure or schema-invalid output is fatal (exit 1).\n */\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { importListForge } from \"../import/index.js\";\nimport { createValidator } from \"../schema-loader.js\";\nimport type { Roster } from \"../import/index.js\";\n\nconst ROSTER_SCHEMA_ID = \"https://40kdc.dev/schemas/core/roster.schema.json\";\n\ninterface ImportOpts {\n  reporter: string;\n  out?: string;\n}\n\nfunction readStdin(): string {\n  try {\n    return readFileSync(0, \"utf8\");\n  } catch {\n    return \"\";\n  }\n}\n\n/** Resolve the command's input source to a raw payload string. */\nfunction resolveInput(input: string | undefined): string {\n  if (!input || input === \"-\") return readStdin().trim();\n  if (existsSync(input)) return readFileSync(input, \"utf8\").trim();\n  return input;\n}\n\nfunction formatPretty(roster: Roster): string {\n  const d = roster.diagnostics;\n  const lines: string[] = [];\n  lines.push(`Roster: ${roster.name}`);\n  lines.push(`  Faction:    ${roster.faction_id ?? \"(unresolved)\"}`);\n  lines.push(\n    `  Detachments: ${\n      roster.detachments\n        .map((d) => `${d.ref.id ?? d.ref.raw_name}${d.dp_cost != null ? ` (${d.dp_cost} DP)` : \"\"}`)\n        .join(\", \") || \"(none/unresolved)\"\n    }`,\n  );\n  lines.push(`  Battle size: ${roster.battle_size ?? \"(unmapped)\"}`);\n  lines.push(\n    `  Points: computed ${roster.points.total_computed}` +\n      (roster.points.total_reported !== null ? `, reported ${roster.points.total_reported}` : \"\") +\n      (roster.points.declared_limit !== null ? `, limit ${roster.points.declared_limit}` : \"\"),\n  );\n  lines.push(`  Units (${roster.units.length}):`);\n  for (const u of roster.units) {\n    const mark = u.ref.resolved ? \"✓\" : \"✗\";\n    const id = u.ref.resolved ? u.ref.id : `${u.ref.raw_name} → unresolved`;\n    const extras: string[] = [];\n    if (u.is_warlord) extras.push(\"warlord\");\n    if (u.enhancement) extras.push(`enh:${u.enhancement.resolved ? u.enhancement.id : \"?\"}`);\n    if (u.leader_attachment) extras.push(`leads:${u.leader_attachment.bodyguard_ref.id}?`);\n    const suffix = extras.length ? ` [${extras.join(\", \")}]` : \"\";\n    lines.push(`    ${mark} ${id} ×${u.model_count}${u.points !== null ? ` (${u.points}pts)` : \"\"}${suffix}`);\n  }\n  lines.push(\n    `  Resolved: ${d.resolved_units} units / ${d.resolved_weapons} weapons; ` +\n      `unresolved: ${d.unresolved_units} units / ${d.unresolved_weapons} weapons`,\n  );\n  if (d.warnings.length) {\n    lines.push(`  Warnings (${d.warnings.length}):`);\n    for (const w of d.warnings) {\n      lines.push(`    - [${w.code}]${w.raw_name ? ` \"${w.raw_name}\":` : \"\"} ${w.message}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n\nexport async function importCommand(\n  input: string | undefined,\n  opts: ImportOpts,\n): Promise<void> {\n  const payload = resolveInput(input);\n  if (!payload) {\n    console.error(\"import: no input (provide a URL/base64/JSON argument, a file path, or pipe via stdin)\");\n    process.exit(1);\n  }\n\n  let roster: Roster;\n  try {\n    roster = importListForge(payload);\n  } catch (err) {\n    console.error(`import: failed to decode/parse payload: ${(err as Error).message}`);\n    process.exit(1);\n  }\n\n  // Guard: our own output must be schema-valid.\n  const validate = createValidator().getSchema(ROSTER_SCHEMA_ID);\n  if (!validate) {\n    console.error(`import: roster schema not found (${ROSTER_SCHEMA_ID})`);\n    process.exit(1);\n  }\n  if (!validate(roster)) {\n    console.error(\"import: produced roster failed schema validation:\");\n    console.error(JSON.stringify(validate.errors, null, 2));\n    process.exit(1);\n  }\n\n  const json = JSON.stringify(roster, null, 2);\n  if (opts.out) {\n    writeFileSync(opts.out, json + \"\\n\", \"utf8\");\n    console.error(`Wrote roster → ${opts.out}`);\n  }\n\n  if (opts.reporter === \"pretty\") {\n    console.log(formatPretty(roster));\n  } else if (!opts.out) {\n    console.log(json);\n  }\n}\n"]}

package/dist/compare.d.ts

@@ -0,0 +1,167 @@
+import type { Dataset } from "./data/dataset.js";
+import type { UnitView } from "./data/entities.js";
+import type { TargetProfile, Unit, Weapon } from "./generated.js";
+export type ComparePhase = "shooting" | "fight";
+export type CompareMetric = "best-weapon" | "unit-total";
+/** Which weapon type fires in a phase: shooting → ranged, fight → melee. */
+export declare function weaponTypeForComparePhase(phase: ComparePhase): "ranged" | "melee";
+/** One attacker weapon profile evaluated against one target. */
+export interface WeaponCell {
+    weaponId: string;
+    weaponName: string;
+    profileIndex: number;
+    profileName: string;
+    range: number | null;
+    reaches: boolean;
+    withinHalfRange: boolean;
+    expectedKills: number;
+}
+/** One (attacker unit, target profile) pair across all the unit's weapons. */
+export interface MatrixCell {
+    targetProfileId: string;
+    targetProfileName: string;
+    best: WeaponCell | null;
+    unitTotal: number;
+    weapons: WeaponCell[];
+}
+export interface MatrixRow {
+    unitId: string;
+    unitName: string;
+    cells: MatrixCell[];
+    /** Peak cell value across targets — the row's sort key. */
+    peak: number;
+}
+/** A target profile resolved to its live dataset unit. */
+export interface ResolvedTarget {
+    profileId: string;
+    profileName: string;
+    unitRaw: Unit;
+    modelCount: number;
+}
+export declare function cellValue(cell: MatrixCell, metric: CompareMetric): number;
+/**
+ * Resolve a target profile to its referenced unit, faction-scoped (shared ids
+ * like Rhino/Forgefiend appear under several factions). Returns null if the
+ * referenced unit is absent.
+ */
+export declare function resolveTarget(ds: Dataset, profile: TargetProfile): ResolvedTarget | null;
+/**
+ * Expected models killed for one (weapon profile, target) at a distance. The
+ * single unit of computation the matrix and the conformance corpus share.
+ */
+export declare function expectedKills(ds: Dataset, weaponRaw: Weapon, profileIndex: number, target: ResolvedTarget, phase: ComparePhase, modelsFiring: number, withinHalfRange: boolean): number;
+/**
+ * Expected post-FNP damage (wounds dealt) for one weapon profile against a
+ * target. The summable counterpart to {@link expectedKills}: damage adds
+ * linearly across weapons, so a unit's total output is built by summing this
+ * over its loadout and converting to kills once — never by summing per-weapon
+ * kills (each weapon's models-killed caps independently, which over-counts).
+ */
+export declare function expectedDamage(ds: Dataset, weaponRaw: Weapon, profileIndex: number, target: ResolvedTarget, phase: ComparePhase, modelsFiring: number, withinHalfRange: boolean): number;
+/**
+ * Evaluate every phase-appropriate weapon profile of one attacker unit against
+ * one target, returning per-weapon results plus the best.
+ */
+export declare function unitVsTarget(ds: Dataset, attackerUnit: UnitView, target: ResolvedTarget, distance: number, phase: ComparePhase, modelsFiring?: number): MatrixCell;
+/** Result of evaluating one (attacker weapon profile, target profile) cell. */
+export interface CompareCell {
+    expectedKills: number;
+    reaches: boolean;
+    withinHalfRange: boolean;
+    modelCount: number;
+}
+/**
+ * Evaluate one (attacker weapon profile, target profile) cell — the single-cell
+ * entry point shared by the conformance runner and consumers. Throws on unknown
+ * profile/weapon ids so the runner can map them to the closed error enum.
+ */
+export declare function compareCell(ds: Dataset, opts: {
+    factionId: string;
+    unitId: string;
+    weaponId: string;
+    profileIndex: number;
+    targetProfileId: string;
+    distance: number;
+    phase: ComparePhase;
+    modelsFiring?: number;
+}): CompareCell;
+/** The cross product: one row per attacker unit, one column per target. */
+export declare function buildMatrix(ds: Dataset, attackerUnits: UnitView[], targets: ResolvedTarget[], distance: number, phase: ComparePhase, metric: CompareMetric, modelsFiring?: number): MatrixRow[];
+/** One weapon in a loadout: `count` copies of `weaponId` profile `profileIndex`. */
+export interface LoadoutLine {
+    weaponId: string;
+    profileIndex?: number;
+    count: number;
+}
+/** A named weapon configuration to evaluate. `points` enables per-point ranking
+ * and lets you compare unit *choices* (one Defiler vs two Forgefiends) on equal
+ * footing — a config can span multiple bodies (just list all their weapons). */
+export interface LoadoutConfig {
+    label: string;
+    points?: number | null;
+    lines: LoadoutLine[];
+}
+export interface LoadoutTargetResult {
+    targetProfileId: string;
+    targetProfileName: string;
+    /** Total post-FNP wounds the whole config deals to this target. */
+    damage: number;
+    /** Models killed = min(modelCount, damage / W) — capped once, after summing. */
+    kills: number;
+}
+export interface LoadoutRanking {
+    config: LoadoutConfig;
+    results: LoadoutTargetResult[];
+    /** The metric the configs were ranked by (damage against the rank target, or
+     * summed across all targets when no rank target is given). */
+    score: number;
+    /** `score` per 100 points, or null when the config carries no points. */
+    scorePer100Points: number | null;
+}
+/**
+ * Total a single loadout against one target, summing post-FNP damage across all
+ * weapon lines (each fired by `count` models) and converting to kills *once*.
+ * A line whose weapon can't reach `distance` contributes nothing.
+ */
+export declare function loadoutOutput(ds: Dataset, config: LoadoutConfig, target: ResolvedTarget, distance: number, phase: ComparePhase): LoadoutTargetResult;
+/**
+ * Rank loadout configs against a set of targets. Each config is scored by its
+ * damage against `rankTargetId` (or summed across all targets when omitted);
+ * results are sorted high-to-low, with `scorePer100Points` for points-aware
+ * comparison across unit choices.
+ */
+export declare function rankLoadouts(ds: Dataset, configs: LoadoutConfig[], targets: ResolvedTarget[], distance: number, phase: ComparePhase, rankTargetId?: string): LoadoutRanking[];
+/**
+ * Evaluate one loadout against one target by ids — the single-call entry point
+ * for the conformance runner. Throws on unknown profile so the runner maps it
+ * to the closed error enum.
+ */
+export declare function loadoutCell(ds: Dataset, opts: {
+    lines: LoadoutLine[];
+    targetProfileId: string;
+    distance: number;
+    phase: ComparePhase;
+}): {
+    damage: number;
+    kills: number;
+};
+/** Result of deriving a unit's shooting-loadout space from its wargear. */
+export interface EnumeratedLoadouts {
+    configs: LoadoutConfig[];
+    diagnostics: string[];
+    /** Always false: the dataset doesn't record per-model weapon counts, so every
+     * line defaults to count=1. Configs are reliable for *relative* slot ranking;
+     * absolute totals need counts supplied by hand. */
+    countsKnown: boolean;
+}
+/**
+ * Derive the shooting-loadout choice space for a unit from its wargear options:
+ * each mutually-exclusive ranged-weapon swap (grouped by option id) is an axis,
+ * and the cross product yields candidate configs (count=1 per weapon). Mirror
+ * of the Python `enumerate_loadouts`. Heuristic, not spec-pinned — it reflects
+ * the (imperfect) wargear data and conservatively drops refs it can't resolve.
+ */
+export declare function enumerateLoadouts(ds: Dataset, factionId: string, unitId: string): EnumeratedLoadouts;
+/** Render a matrix as a Discord-paste markdown table. */
+export declare function matrixToMarkdown(rows: MatrixRow[], targets: ResolvedTarget[], metric: CompareMetric): string;
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.d.ts.map

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

package/dist/compare.js

@@ -0,0 +1,302 @@
+/**
+ * Fleet comparison: expected kills of attacker units against target-profile
+ * archetypes. The cross product — a set of attacker units against a set of
+ * targets — yielding a matrix of expected models killed per (unit, target).
+ *
+ * Target profiles reference real dataset units (`faction_id` + `unit_id`), so
+ * each cell resolves the live unit and feeds it straight to {@link crunch}; the
+ * target's defensive abilities (FNP, ability invulns, save/toughness mods) are
+ * resolved via {@link Dataset.defensiveBuffsFor} and stacked onto the crunch.
+ * Rapid Fire / Melta come for free: each cell sets `withinHalfRange` from
+ * `distance <= range / 2`.
+ *
+ * Python mirror: `python/src/wh40kdc/compare.py`. The per-cell `expectedKills`
+ * is pinned against Python by the `compare` conformance area.
+ *
+ * @packageDocumentation
+ */
+import { crunch } from "./cruncher/index.js";
+/** Which weapon type fires in a phase: shooting → ranged, fight → melee. */
+export function weaponTypeForComparePhase(phase) {
+    return phase === "fight" ? "melee" : "ranged";
+}
+export function cellValue(cell, metric) {
+    if (metric === "unit-total")
+        return cell.unitTotal;
+    return cell.best?.expectedKills ?? 0;
+}
+/**
+ * Resolve a target profile to its referenced unit, faction-scoped (shared ids
+ * like Rhino/Forgefiend appear under several factions). Returns null if the
+ * referenced unit is absent.
+ */
+export function resolveTarget(ds, profile) {
+    const unit = ds.units.getInFaction(profile.unit_id, profile.faction_id);
+    if (!unit)
+        return null;
+    const override = profile.model_count_override ?? null;
+    const modelCount = override ?? unit.raw.model_count?.min ?? 1;
+    return { profileId: profile.id, profileName: profile.name, unitRaw: unit.raw, modelCount };
+}
+/**
+ * Expected models killed for one (weapon profile, target) at a distance. The
+ * single unit of computation the matrix and the conformance corpus share.
+ */
+export function expectedKills(ds, weaponRaw, profileIndex, target, phase, modelsFiring, withinHalfRange) {
+    const ctx = { phase, withinHalfRange };
+    const buffs = ds.defensiveBuffsFor({ unitId: target.unitRaw.id, factionId: target.unitRaw.faction_id }, ctx);
+    const out = crunch({
+        attacker: { weapon: weaponRaw, profileIndex },
+        target: { unit: target.unitRaw, profileIndex: 0, modelCount: target.modelCount },
+        modelsFiring,
+        buffs,
+        context: ctx,
+    }, ds);
+    const stage = out.stages.find((s) => s.name === "models-killed");
+    return stage ? stage.expected : 0;
+}
+/**
+ * Expected post-FNP damage (wounds dealt) for one weapon profile against a
+ * target. The summable counterpart to {@link expectedKills}: damage adds
+ * linearly across weapons, so a unit's total output is built by summing this
+ * over its loadout and converting to kills once — never by summing per-weapon
+ * kills (each weapon's models-killed caps independently, which over-counts).
+ */
+export function expectedDamage(ds, weaponRaw, profileIndex, target, phase, modelsFiring, withinHalfRange) {
+    const ctx = { phase, withinHalfRange };
+    const buffs = ds.defensiveBuffsFor({ unitId: target.unitRaw.id, factionId: target.unitRaw.faction_id }, ctx);
+    const out = crunch({
+        attacker: { weapon: weaponRaw, profileIndex },
+        target: { unit: target.unitRaw, profileIndex: 0, modelCount: target.modelCount },
+        modelsFiring,
+        buffs,
+        context: ctx,
+    }, ds);
+    const stage = out.stages.find((s) => s.name === "after-fnp");
+    return stage ? stage.expected : 0;
+}
+/**
+ * Evaluate every phase-appropriate weapon profile of one attacker unit against
+ * one target, returning per-weapon results plus the best.
+ */
+export function unitVsTarget(ds, attackerUnit, target, distance, phase, modelsFiring = 1) {
+    const wantType = weaponTypeForComparePhase(phase);
+    const weapons = [];
+    for (const weapon of attackerUnit.weapons) {
+        const wraw = weapon.raw;
+        if (wraw.type !== wantType)
+            continue;
+        wraw.profiles.forEach((wprofile, idx) => {
+            const rng = wprofile.range;
+            const isRanged = typeof rng === "number";
+            const reaches = !isRanged || rng >= distance;
+            const withinHalf = isRanged && distance <= rng / 2;
+            const kills = reaches
+                ? expectedKills(ds, wraw, idx, target, phase, modelsFiring, withinHalf)
+                : 0;
+            weapons.push({
+                weaponId: wraw.id,
+                weaponName: weapon.name,
+                profileIndex: idx,
+                profileName: wprofile.name ?? weapon.name,
+                range: isRanged ? rng : null,
+                reaches,
+                withinHalfRange: withinHalf,
+                expectedKills: kills,
+            });
+        });
+    }
+    const reaching = weapons.filter((w) => w.reaches);
+    const best = reaching.reduce((acc, w) => (acc === null || w.expectedKills > acc.expectedKills ? w : acc), null);
+    const unitTotal = reaching.reduce((sum, w) => sum + w.expectedKills, 0);
+    return { targetProfileId: target.profileId, targetProfileName: target.profileName, best, unitTotal, weapons };
+}
+/**
+ * Evaluate one (attacker weapon profile, target profile) cell — the single-cell
+ * entry point shared by the conformance runner and consumers. Throws on unknown
+ * profile/weapon ids so the runner can map them to the closed error enum.
+ */
+export function compareCell(ds, opts) {
+    const profile = ds.targetProfiles.get(opts.targetProfileId);
+    if (!profile)
+        throw new Error(`unknown target profile: ${opts.targetProfileId}`);
+    const target = resolveTarget(ds, profile);
+    if (!target) {
+        throw new Error(`target profile ${opts.targetProfileId} references missing unit ${profile.unit_id}`);
+    }
+    const weapon = ds.weapons.get(opts.weaponId);
+    if (!weapon)
+        throw new Error(`unknown weapon: ${opts.weaponId}`);
+    const wraw = weapon.raw;
+    const rng = wraw.profiles[opts.profileIndex]?.range;
+    const isRanged = typeof rng === "number";
+    const reaches = !isRanged || rng >= opts.distance;
+    const withinHalfRange = isRanged && opts.distance <= rng / 2;
+    const kills = reaches
+        ? expectedKills(ds, wraw, opts.profileIndex, target, opts.phase, opts.modelsFiring ?? 1, withinHalfRange)
+        : 0;
+    return { expectedKills: kills, reaches, withinHalfRange, modelCount: target.modelCount };
+}
+/** The cross product: one row per attacker unit, one column per target. */
+export function buildMatrix(ds, attackerUnits, targets, distance, phase, metric, modelsFiring = 1) {
+    const rows = attackerUnits.map((unit) => {
+        const cells = targets.map((t) => unitVsTarget(ds, unit, t, distance, phase, modelsFiring));
+        const peak = cells.reduce((m, c) => Math.max(m, cellValue(c, metric)), 0);
+        return { unitId: unit.id, unitName: unit.name, cells, peak };
+    });
+    return rows.sort((a, b) => b.peak - a.peak);
+}
+/**
+ * Total a single loadout against one target, summing post-FNP damage across all
+ * weapon lines (each fired by `count` models) and converting to kills *once*.
+ * A line whose weapon can't reach `distance` contributes nothing.
+ */
+export function loadoutOutput(ds, config, target, distance, phase) {
+    let damage = 0;
+    for (const line of config.lines) {
+        const weapon = ds.weapons.get(line.weaponId);
+        if (!weapon)
+            continue;
+        const profileIndex = line.profileIndex ?? 0;
+        const rng = weapon.raw.profiles[profileIndex]?.range;
+        const isRanged = typeof rng === "number";
+        if (isRanged && rng < distance)
+            continue; // out of range
+        const withinHalf = isRanged && distance <= rng / 2;
+        damage += expectedDamage(ds, weapon.raw, profileIndex, target, phase, line.count, withinHalf);
+    }
+    const w = target.unitRaw.profiles[0]?.W ?? 1;
+    const kills = w > 0 ? Math.min(target.modelCount, damage / w) : 0;
+    return {
+        targetProfileId: target.profileId,
+        targetProfileName: target.profileName,
+        damage,
+        kills,
+    };
+}
+/**
+ * Rank loadout configs against a set of targets. Each config is scored by its
+ * damage against `rankTargetId` (or summed across all targets when omitted);
+ * results are sorted high-to-low, with `scorePer100Points` for points-aware
+ * comparison across unit choices.
+ */
+export function rankLoadouts(ds, configs, targets, distance, phase, rankTargetId) {
+    const ranked = configs.map((config) => {
+        const results = targets.map((t) => loadoutOutput(ds, config, t, distance, phase));
+        const score = rankTargetId
+            ? (results.find((r) => r.targetProfileId === rankTargetId)?.damage ?? 0)
+            : results.reduce((sum, r) => sum + r.damage, 0);
+        const scorePer100Points = config.points && config.points > 0 ? (score / config.points) * 100 : null;
+        return { config, results, score, scorePer100Points };
+    });
+    return ranked.sort((a, b) => b.score - a.score);
+}
+/**
+ * Evaluate one loadout against one target by ids — the single-call entry point
+ * for the conformance runner. Throws on unknown profile so the runner maps it
+ * to the closed error enum.
+ */
+export function loadoutCell(ds, opts) {
+    const profile = ds.targetProfiles.get(opts.targetProfileId);
+    if (!profile)
+        throw new Error(`unknown target profile: ${opts.targetProfileId}`);
+    const target = resolveTarget(ds, profile);
+    if (!target)
+        throw new Error(`target profile ${opts.targetProfileId} references a missing unit`);
+    const res = loadoutOutput(ds, { label: "", lines: opts.lines }, target, opts.distance, opts.phase);
+    return { damage: res.damage, kills: res.kills };
+}
+function resolveWeaponId(ref, weaponIds) {
+    if (weaponIds.has(ref))
+        return ref;
+    if (ref.endsWith("s") && weaponIds.has(ref.slice(0, -1)))
+        return ref.slice(0, -1);
+    return null;
+}
+/**
+ * Derive the shooting-loadout choice space for a unit from its wargear options:
+ * each mutually-exclusive ranged-weapon swap (grouped by option id) is an axis,
+ * and the cross product yields candidate configs (count=1 per weapon). Mirror
+ * of the Python `enumerate_loadouts`. Heuristic, not spec-pinned — it reflects
+ * the (imperfect) wargear data and conservatively drops refs it can't resolve.
+ */
+export function enumerateLoadouts(ds, factionId, unitId) {
+    const unit = ds.units.getInFaction(unitId, factionId);
+    if (!unit)
+        throw new Error(`unit ${unitId} not found in faction ${factionId}`);
+    const weaponIds = new Set(ds.weapons.all.map((w) => w.raw.id));
+    const isRanged = (wid) => ds.weapons.get(wid)?.raw.type === "ranged";
+    const baseRanged = [
+        ...new Set(unit.weapons.filter((w) => w.raw.type === "ranged").map((w) => w.raw.id)),
+    ].sort();
+    const diagnostics = [];
+    // Group choices by option id so duplicate rows of one physical slot union
+    // into a single exclusive axis (rather than letting two of its options stack).
+    const choicesByOption = new Map();
+    for (const opt of ds.wargearOptionsOf(unit.raw)) {
+        const oid = opt.id ?? JSON.stringify(opt);
+        const rawChoices = [];
+        const o = opt;
+        if (o.replaces)
+            rawChoices.push(o.replaces);
+        if (o.replacement)
+            rawChoices.push(o.replacement);
+        for (const ch of o.replacement_choice ?? [])
+            rawChoices.push(ch);
+        const bucket = choicesByOption.get(oid) ?? [];
+        for (const ch of rawChoices) {
+            const rids = [];
+            for (const ref of ch) {
+                const wid = resolveWeaponId(ref, weaponIds);
+                if (wid === null)
+                    diagnostics.push(`option ${oid}: unresolved ref ${JSON.stringify(ref)}`);
+                else if (isRanged(wid))
+                    rids.push(wid);
+            }
+            if (rids.length) {
+                const key = [...rids].sort().join("|");
+                if (!bucket.some((b) => [...b].sort().join("|") === key))
+                    bucket.push(rids);
+            }
+        }
+        choicesByOption.set(oid, bucket);
+    }
+    const axes = [...choicesByOption.values()].filter((c) => c.length > 1);
+    const swapMembers = new Set(axes.flat(2));
+    const fixed = baseRanged.filter((w) => !swapMembers.has(w));
+    let combos = [fixed];
+    for (const axis of axes) {
+        combos = combos.flatMap((combo) => axis.map((choice) => [...combo, ...choice]));
+    }
+    const byLabel = new Map();
+    const points = unit.raw.points?.[0]?.cost ?? null;
+    for (const combo of combos) {
+        const weapons = [...new Set(combo)].sort();
+        if (!weapons.length)
+            continue;
+        const label = weapons.map((w) => ds.weapons.get(w)?.name ?? w).join(" + ");
+        if (!byLabel.has(label)) {
+            byLabel.set(label, {
+                label,
+                points,
+                lines: weapons.map((w) => ({ weaponId: w, count: 1 })),
+            });
+        }
+    }
+    return { configs: [...byLabel.values()], diagnostics: [...new Set(diagnostics)].sort(), countsKnown: false };
+}
+/** Render a matrix as a Discord-paste markdown table. */
+export function matrixToMarkdown(rows, targets, metric) {
+    const headers = ["Unit", ...targets.map((t) => t.profileName)];
+    const lines = [`| ${headers.join(" | ")} |`, `|${headers.map(() => "---").join("|")}|`];
+    for (const row of rows) {
+        const cells = row.cells.map((c) => {
+            const v = cellValue(c, metric);
+            const text = v ? v.toFixed(2) : "—";
+            return v >= 1 ? `**${text}**` : text;
+        });
+        lines.push(`| ${[row.unitName, ...cells].join(" | ")} |`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=compare.js.map