@alpaca-software/40kdc-data 0.5.11 → 0.5.14

package/dist/import/types.d.ts

@@ -19,7 +19,7 @@
 /** A 40kdc battle size (mirrors the shared `battle-size` def). */
 export type BattleSize = "incursion" | "strike-force";
 /** Diagnostic warning codes emitted during an import. */
-export type WarningCode = "faction-unresolved" | "unit-unresolved" | "weapon-unresolved" | "enhancement-unresolved" | "detachment-unresolved" | "battle-size-unmapped" | "points-mismatch" | "leader-attachment-inferred" | "multi-force" | "unknown-field";
+export type WarningCode = "faction-unresolved" | "unit-unresolved" | "weapon-unresolved" | "enhancement-unresolved" | "detachment-unresolved" | "detachment-points-exceeded" | "battle-size-unmapped" | "points-mismatch" | "leader-attachment-inferred" | "multi-force" | "unknown-field";
 /** A near-match suggestion offered when resolution fails. */
 export interface Candidate {
     id: string;
@@ -44,6 +44,12 @@ export interface RosterWargear {
     ref: ResolvedRef;
     count: number;
 }
+/** One detachment on the roster, paired with its resolved DP cost. */
+export interface RosterDetachment {
+    ref: ResolvedRef;
+    /** DP cost (1–3) from the resolved detachment entity; null when unresolved or unrecorded. */
+    dp_cost: number | null;
+}
 /** An inferred, always-provisional leader→bodyguard attachment. */
 export interface RosterLeaderAttachment {
     bodyguard_ref: ResolvedRef;
@@ -73,6 +79,8 @@ export interface RosterSource {
 /** Point totals; reported and computed are kept distinct, never reconciled. */
 export interface RosterPoints {
     declared_limit: number | null;
+    /** 11e detachment-point budget from the battle size (strike-force 3, incursion 2); null when unknown. */
+    detachment_cap: number | null;
     total_reported: number | null;
     total_computed: number;
 }
@@ -100,7 +108,7 @@ export interface Roster {
     name: string;
     source: RosterSource;
     faction_id: string | null;
-    detachment_id: string | null;
+    detachments: RosterDetachment[];
     battle_size: BattleSize | null;
     points: RosterPoints;
     units: RosterUnit[];
@@ -136,8 +144,11 @@ export interface ParsedRoster {
     generated_by: string | null;
     /** Raw faction name from the source (e.g. "Grey Knights"). */
     faction_raw_name: string | null;
-    /** Raw detachment name (e.g. "Banishers"). */
-    detachment_raw_name: string | null;
+    /**
+     * Raw detachment names in source order (e.g. ["Gladius Task Force"]). 11e lists may
+     * carry several; most formats and pre-11e lists carry zero or one.
+     */
+    detachment_raw_names: string[];
     /** Raw battle-size label (e.g. "2. Strike Force (2000 Point limit)"). */
     battle_size_raw: string | null;
     /** Points limit parsed from the battle-size label, if any. */

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

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

package/dist/import/types.js.map

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

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export type { ResolvedPiece, ResolvedVec2, BoardEdge, FeatureRef, Keystone, Keys
 export * from "./scoring/index.js";
 export * from "./cruncher/index.js";
 export * from "./compare.js";
+export * from "./scope.js";
 export { importListForge, importNewRecruit, importRoster, tryImportRoster, decodeListForge, } from "./import/index.js";
 export { exportRoster, newRecruitJsonSerializer, newRecruitSimpleSerializer, newRecruitWtcCompactSerializer, newRecruitWtcFullSerializer, rosterJsonSerializer, rosterizerSerializer, } from "./export/index.js";
 export type { ExportFormat, RosterSerializer } from "./export/index.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -21,6 +21,10 @@ export * from "./cruncher/index.js";
 // built on the cruncher. Mirrors `python/src/wh40kdc/compare.py`; the per-cell
 // math is pinned against Python by the `conformance/compare` corpus.
 export * from "./compare.js";
+// Roster-highlighting scope: resolve which units an ability's curated
+// `applies_to` keyword filter benefits. Mirrors `wh40kdc::scope` (Rust) and
+// `wh40kdc.scope` (Python); pinned by the `conformance/applies-to` corpus.
+export * from "./scope.js";
 // Schema access + AJV validation lives behind the `./validate` subpath export
 // (`@alpaca-software/40kdc-data/validate`), NOT the root barrel: it reads
 // schema files from disk at module load (node:fs/node:url), which breaks

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,iBAAiB,CAAC;AAEhC,mDAAmD;AACnD,cAAc,gBAAgB,CAAC;AAE/B,0EAA0E;AAC1E,6EAA6E;AAC7E,cAAc,sBAAsB,CAAC;AAWrC,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAiB5B,6EAA6E;AAC7E,+EAA+E;AAC/E,yDAAyD;AACzD,cAAc,oBAAoB,CAAC;AAEnC,4EAA4E;AAC5E,oEAAoE;AACpE,8EAA8E;AAC9E,cAAc,qBAAqB,CAAC;AAEpC,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,cAAc,cAAc,CAAC;AAE7B,8EAA8E;AAC9E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE;AAErE,4EAA4E;AAC5E,+EAA+E;AAC/E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC","sourcesContent":["// The linked, typed dataset — the primary entry point.\nexport * from \"./data/index.js\";\n\n// Generated types for every entity in the dataset.\nexport * from \"./generated.js\";\n\n// Plain-English translation of structured data (scoring-card awards + the\n// shared Ability-DSL condition humanizer). Cross-impl pinned by conformance.\nexport * from \"./translate/index.js\";\n\n// `ScoringTrigger` is emitted by both ./generated.js (schema-derived) and\n// ./translate (hand-authored). They are structurally identical; disambiguate the\n// two wildcard re-exports in favour of the generated, schema-canonical type.\nexport type { ScoringTrigger } from \"./generated.js\";\n\n// `AbilityScope` likewise: ./translate/effect.ts hand-authors a looser view\n// for the describer; prefer the generated, schema-canonical type.\nexport type { AbilityScope } from \"./generated.js\";\n\n// Terrain geometry resolver (template-anchored layout → board-space vertices).\n// Curated (not wildcard) so its internal type aliases don't clash with the\n// generated Footprint/TerrainTemplate/TerrainLayout types. Cross-impl pinned.\nexport {\n  resolveLayout,\n  polygonCentroid,\n  footprintVertices,\n  orientedOffsets,\n  TerrainResolveError,\n  solveCentroid,\n  solveCentroidTriangulated,\n  solveCentroidAttached,\n  TerrainSolveError,\n  keystoneMeasurements,\n  BOARD_INCHES,\n  TerrainKeystoneError,\n} from \"./terrain/index.js\";\nexport type {\n  ResolvedPiece,\n  ResolvedVec2,\n  BoardEdge,\n  FeatureRef,\n  Keystone,\n  KeystoneMeasurement,\n  DimensionLine,\n  SolveInput,\n  TriangulationLine,\n  TriangulateInput,\n  AttachLine,\n  AttachPiece,\n  AttachInput,\n} from \"./terrain/index.js\";\n\n// Card-driven secondary-mission scoring: compute VP from asserted awards and\n// track per-round, per-player scoring. Mirrored by the Rust `wh40kdc::scoring`\n// module and pinned by the `conformance/scoring` corpus.\nexport * from \"./scoring/index.js\";\n\n// Damage-projection engine (expected-value math over weapon/unit profiles).\n// Mirrored by the Rust `wh40kdc::cruncher` module and pinned by the\n// `conformance/cruncher` corpus. Pure functions — universal (Node + browser).\nexport * from \"./cruncher/index.js\";\n\n// Fleet comparison (attacker set × target-profile set → expected-kills matrix),\n// built on the cruncher. Mirrors `python/src/wh40kdc/compare.py`; the per-cell\n// math is pinned against Python by the `conformance/compare` corpus.\nexport * from \"./compare.js\";\n\n// Schema access + AJV validation lives behind the `./validate` subpath export\n// (`@alpaca-software/40kdc-data/validate`), NOT the root barrel: it reads\n// schema files from disk at module load (node:fs/node:url), which breaks\n// browser bundles. The root barrel stays universal (Node + browser).\n\n// Army-list importer (ListForge → resolved 40kdc roster). Types are curated\n// rather than re-exported wholesale to avoid name clashes with generated types\n// (e.g. BattleSize, LeaderAttachment).\nexport {\n  importListForge,\n  importNewRecruit,\n  importRoster,\n  tryImportRoster,\n  decodeListForge,\n} from \"./import/index.js\";\n\n// Army-list exporter (Roster → text or JSON for any of the supported formats).\nexport {\n  exportRoster,\n  newRecruitJsonSerializer,\n  newRecruitSimpleSerializer,\n  newRecruitWtcCompactSerializer,\n  newRecruitWtcFullSerializer,\n  rosterJsonSerializer,\n  rosterizerSerializer,\n} from \"./export/index.js\";\nexport type { ExportFormat, RosterSerializer } from \"./export/index.js\";\nexport type { FormatAdapter } from \"./import/index.js\";\nexport type {\n  ImportOptions,\n  ImportResult,\n  ImportFailureReason,\n  AdapterTrial,\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  RosterLeaderAttachment,\n  ResolvedRef,\n  Candidate,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./import/index.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,iBAAiB,CAAC;AAEhC,mDAAmD;AACnD,cAAc,gBAAgB,CAAC;AAE/B,0EAA0E;AAC1E,6EAA6E;AAC7E,cAAc,sBAAsB,CAAC;AAWrC,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAiB5B,6EAA6E;AAC7E,+EAA+E;AAC/E,yDAAyD;AACzD,cAAc,oBAAoB,CAAC;AAEnC,4EAA4E;AAC5E,oEAAoE;AACpE,8EAA8E;AAC9E,cAAc,qBAAqB,CAAC;AAEpC,gFAAgF;AAChF,+EAA+E;AAC/E,qEAAqE;AACrE,cAAc,cAAc,CAAC;AAE7B,sEAAsE;AACtE,4EAA4E;AAC5E,2EAA2E;AAC3E,cAAc,YAAY,CAAC;AAE3B,8EAA8E;AAC9E,0EAA0E;AAC1E,yEAAyE;AACzE,qEAAqE;AAErE,4EAA4E;AAC5E,+EAA+E;AAC/E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC","sourcesContent":["// The linked, typed dataset — the primary entry point.\nexport * from \"./data/index.js\";\n\n// Generated types for every entity in the dataset.\nexport * from \"./generated.js\";\n\n// Plain-English translation of structured data (scoring-card awards + the\n// shared Ability-DSL condition humanizer). Cross-impl pinned by conformance.\nexport * from \"./translate/index.js\";\n\n// `ScoringTrigger` is emitted by both ./generated.js (schema-derived) and\n// ./translate (hand-authored). They are structurally identical; disambiguate the\n// two wildcard re-exports in favour of the generated, schema-canonical type.\nexport type { ScoringTrigger } from \"./generated.js\";\n\n// `AbilityScope` likewise: ./translate/effect.ts hand-authors a looser view\n// for the describer; prefer the generated, schema-canonical type.\nexport type { AbilityScope } from \"./generated.js\";\n\n// Terrain geometry resolver (template-anchored layout → board-space vertices).\n// Curated (not wildcard) so its internal type aliases don't clash with the\n// generated Footprint/TerrainTemplate/TerrainLayout types. Cross-impl pinned.\nexport {\n  resolveLayout,\n  polygonCentroid,\n  footprintVertices,\n  orientedOffsets,\n  TerrainResolveError,\n  solveCentroid,\n  solveCentroidTriangulated,\n  solveCentroidAttached,\n  TerrainSolveError,\n  keystoneMeasurements,\n  BOARD_INCHES,\n  TerrainKeystoneError,\n} from \"./terrain/index.js\";\nexport type {\n  ResolvedPiece,\n  ResolvedVec2,\n  BoardEdge,\n  FeatureRef,\n  Keystone,\n  KeystoneMeasurement,\n  DimensionLine,\n  SolveInput,\n  TriangulationLine,\n  TriangulateInput,\n  AttachLine,\n  AttachPiece,\n  AttachInput,\n} from \"./terrain/index.js\";\n\n// Card-driven secondary-mission scoring: compute VP from asserted awards and\n// track per-round, per-player scoring. Mirrored by the Rust `wh40kdc::scoring`\n// module and pinned by the `conformance/scoring` corpus.\nexport * from \"./scoring/index.js\";\n\n// Damage-projection engine (expected-value math over weapon/unit profiles).\n// Mirrored by the Rust `wh40kdc::cruncher` module and pinned by the\n// `conformance/cruncher` corpus. Pure functions — universal (Node + browser).\nexport * from \"./cruncher/index.js\";\n\n// Fleet comparison (attacker set × target-profile set → expected-kills matrix),\n// built on the cruncher. Mirrors `python/src/wh40kdc/compare.py`; the per-cell\n// math is pinned against Python by the `conformance/compare` corpus.\nexport * from \"./compare.js\";\n\n// Roster-highlighting scope: resolve which units an ability's curated\n// `applies_to` keyword filter benefits. Mirrors `wh40kdc::scope` (Rust) and\n// `wh40kdc.scope` (Python); pinned by the `conformance/applies-to` corpus.\nexport * from \"./scope.js\";\n\n// Schema access + AJV validation lives behind the `./validate` subpath export\n// (`@alpaca-software/40kdc-data/validate`), NOT the root barrel: it reads\n// schema files from disk at module load (node:fs/node:url), which breaks\n// browser bundles. The root barrel stays universal (Node + browser).\n\n// Army-list importer (ListForge → resolved 40kdc roster). Types are curated\n// rather than re-exported wholesale to avoid name clashes with generated types\n// (e.g. BattleSize, LeaderAttachment).\nexport {\n  importListForge,\n  importNewRecruit,\n  importRoster,\n  tryImportRoster,\n  decodeListForge,\n} from \"./import/index.js\";\n\n// Army-list exporter (Roster → text or JSON for any of the supported formats).\nexport {\n  exportRoster,\n  newRecruitJsonSerializer,\n  newRecruitSimpleSerializer,\n  newRecruitWtcCompactSerializer,\n  newRecruitWtcFullSerializer,\n  rosterJsonSerializer,\n  rosterizerSerializer,\n} from \"./export/index.js\";\nexport type { ExportFormat, RosterSerializer } from \"./export/index.js\";\nexport type { FormatAdapter } from \"./import/index.js\";\nexport type {\n  ImportOptions,\n  ImportResult,\n  ImportFailureReason,\n  AdapterTrial,\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  RosterLeaderAttachment,\n  ResolvedRef,\n  Candidate,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./import/index.js\";\n"]}

package/dist/merge-faction-pack.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merge-faction-pack.d.ts.map

package/dist/merge-faction-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-faction-pack.d.ts","sourceRoot":"","sources":["../src/merge-faction-pack.ts"],"names":[],"mappings":""}

package/dist/merge-faction-pack.js

@@ -0,0 +1,157 @@
+/**
+ * Merge IP-safe faction-pack staging (`data/_audit/faction-pack-input/<faction>.json`,
+ * produced by `extract-faction-pack.ts`) into `data/core/<faction>/`.
+ *
+ * For every staged detachment whose *core* entry is still a bare shell — empty
+ * `stratagem_ids` AND empty `enhancement_ids` — this creates the core stratagem
+ * and enhancement entities from the staged metadata and wires their ids onto the
+ * detachment. Detachments that already carry entities (converted from army-assist,
+ * or merged earlier) are left untouched, so re-running is additive and safe.
+ *
+ * The DSL link stays open: every created entity gets `ability_id: null`. Authoring
+ * the mechanic happens separately via the `author:*` pipeline.
+ *
+ * Field provenance (mirrors the hand-merged Space Marine packs):
+ *  - stratagem: name + cp_cost + phases + player_turn straight from staging; the
+ *    GW `type` is omitted (faction packs don't print it for new detachments) and
+ *    `timing` defaults to `once-per-phase` when the pack didn't state a frequency.
+ *  - enhancement: name from staging; `cost: 0` + `points_provisional: true` until
+ *    the Munitorum Field Manual lands; `keyword_restrictions` is the faction's
+ *    army keyword; `upgrade_tag: true` (faction-pack enhancements are upgrades).
+ *
+ * IP firewall: staging carries names + numeric/enum metadata only — never prose —
+ * so nothing this tool writes is GW rules text.
+ *
+ * Usage:
+ *   tsx tools/src/merge-faction-pack.ts <faction-id> [<faction-id> …]
+ *   tsx tools/src/merge-faction-pack.ts --all-xenos
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const DATA_ROOT = resolve(__dirname, "../../data");
+/** Faction-id → the army keyword that gates its enhancements. */
+const FACTION_KEYWORD = {
+    orks: "Orks",
+    aeldari: "Aeldari",
+    drukhari: "Drukhari",
+    tyranids: "Tyranids",
+    "genestealer-cults": "Genestealer Cults",
+    necrons: "Necrons",
+    "leagues-of-votann": "Leagues of Votann",
+    "tau-empire": "T’au Empire",
+};
+const XENOS = Object.keys(FACTION_KEYWORD);
+const GAME_VERSION = { edition: "11th", dataslate: "pre-launch-provisional" };
+function readJson(path) {
+    return JSON.parse(readFileSync(path, "utf-8"));
+}
+function writeJson(path, value) {
+    writeFileSync(path, JSON.stringify(value, null, 2) + "\n");
+}
+function mergeFaction(faction) {
+    const keyword = FACTION_KEYWORD[faction];
+    if (!keyword)
+        throw new Error(`no faction keyword mapping for ${faction}`);
+    const dir = resolve(DATA_ROOT, "core", faction);
+    const staging = readJson(resolve(DATA_ROOT, "_audit", "faction-pack-input", `${faction}.json`));
+    const detachments = readJson(resolve(dir, "detachments.json"));
+    const stratagems = readJson(resolve(dir, "stratagems.json"));
+    const enhancements = readJson(resolve(dir, "enhancements.json"));
+    const detById = new Map(detachments.map((d) => [d.id, d]));
+    const stratIds = new Set(stratagems.map((s) => s.id));
+    const enhIds = new Set(enhancements.map((e) => e.id));
+    let addedStrat = 0;
+    let addedEnh = 0;
+    let wiredDets = 0;
+    const skipped = [];
+    const renames = [];
+    /**
+     * A globally-unique id for a new entity. GW reuses stratagem/enhancement names
+     * across detachments (e.g. Ork "Long, Uncontrolled Bursts" is in both More Dakka!
+     * and Rollin' Deff) — distinct mechanics that collide on the bare name kebab. On
+     * collision we detachment-scope the id so existing ids stay stable and the entity
+     * collection (keyed by id) never overwrites. The staging entry is renamed to match.
+     */
+    function uniqueId(baseId, detId, taken) {
+        if (!taken.has(baseId))
+            return baseId;
+        const scoped = `${detId}-${baseId}`;
+        if (taken.has(scoped))
+            throw new Error(`cannot disambiguate id ${baseId} for ${detId}`);
+        renames.push(`${baseId} → ${scoped}`);
+        return scoped;
+    }
+    for (const sd of staging.detachments) {
+        const det = detById.get(sd.id);
+        if (!det) {
+            skipped.push(`${sd.id} (no core detachment)`);
+            continue;
+        }
+        const isBareShell = (det.stratagem_ids ?? []).length === 0 &&
+            (det.enhancement_ids ?? []).length === 0;
+        if (!isBareShell)
+            continue; // already populated — leave it.
+        for (const s of sd.stratagems) {
+            s.id = uniqueId(s.id, sd.id, stratIds); // mutate staging to stay consistent
+            stratagems.push({
+                id: s.id,
+                name: s.name,
+                category: "detachment",
+                detachment_id: sd.id,
+                cp_cost: s.cp_cost ?? 1,
+                phases: s.phases,
+                player_turn: s.player_turn ?? "either",
+                timing: s.timing ?? "once-per-phase",
+                target_restrictions: null,
+                ability_id: null,
+                game_version: { ...GAME_VERSION },
+            });
+            stratIds.add(s.id);
+            addedStrat++;
+        }
+        for (const e of sd.enhancements) {
+            e.id = uniqueId(e.id, sd.id, enhIds);
+            enhancements.push({
+                id: e.id,
+                name: e.name,
+                detachment_id: sd.id,
+                cost: e.cost ?? 0,
+                keyword_restrictions: [keyword],
+                ability_id: null,
+                is_unique: true,
+                game_version: { ...GAME_VERSION },
+                points_provisional: true,
+                upgrade_tag: true,
+                max_targets: 1,
+            });
+            enhIds.add(e.id);
+            addedEnh++;
+        }
+        det.stratagem_ids = sd.stratagems.map((s) => s.id);
+        det.enhancement_ids = sd.enhancements.map((e) => e.id);
+        wiredDets++;
+    }
+    writeJson(resolve(dir, "detachments.json"), detachments);
+    writeJson(resolve(dir, "stratagems.json"), stratagems);
+    writeJson(resolve(dir, "enhancements.json"), enhancements);
+    // Persist any id renames back to staging so it stays the source for authoring.
+    if (renames.length)
+        writeJson(resolve(DATA_ROOT, "_audit", "faction-pack-input", `${faction}.json`), staging);
+    console.log(`${faction}: wired ${wiredDets} detachment(s), +${addedStrat} stratagems, +${addedEnh} enhancements` +
+        (renames.length ? `; renamed ${renames.join("; ")}` : "") +
+        (skipped.length ? `; skipped ${skipped.join(", ")}` : ""));
+}
+function main() {
+    const args = process.argv.slice(2);
+    const factions = args.includes("--all-xenos") ? XENOS : args;
+    if (factions.length === 0) {
+        console.error("usage: merge-faction-pack.ts <faction-id>… | --all-xenos");
+        process.exit(1);
+    }
+    for (const f of factions)
+        mergeFaction(f);
+}
+main();
+//# sourceMappingURL=merge-faction-pack.js.map

package/dist/merge-faction-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-faction-pack.js","sourceRoot":"","sources":["../src/merge-faction-pack.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Merge IP-safe faction-pack staging (`data/_audit/faction-pack-input/<faction>.json`,\n * produced by `extract-faction-pack.ts`) into `data/core/<faction>/`.\n *\n * For every staged detachment whose *core* entry is still a bare shell — empty\n * `stratagem_ids` AND empty `enhancement_ids` — this creates the core stratagem\n * and enhancement entities from the staged metadata and wires their ids onto the\n * detachment. Detachments that already carry entities (converted from army-assist,\n * or merged earlier) are left untouched, so re-running is additive and safe.\n *\n * The DSL link stays open: every created entity gets `ability_id: null`. Authoring\n * the mechanic happens separately via the `author:*` pipeline.\n *\n * Field provenance (mirrors the hand-merged Space Marine packs):\n *  - stratagem: name + cp_cost + phases + player_turn straight from staging; the\n *    GW `type` is omitted (faction packs don't print it for new detachments) and\n *    `timing` defaults to `once-per-phase` when the pack didn't state a frequency.\n *  - enhancement: name from staging; `cost: 0` + `points_provisional: true` until\n *    the Munitorum Field Manual lands; `keyword_restrictions` is the faction's\n *    army keyword; `upgrade_tag: true` (faction-pack enhancements are upgrades).\n *\n * IP firewall: staging carries names + numeric/enum metadata only — never prose —\n * so nothing this tool writes is GW rules text.\n *\n * Usage:\n *   tsx tools/src/merge-faction-pack.ts <faction-id> [<faction-id> …]\n *   tsx tools/src/merge-faction-pack.ts --all-xenos\n */\nimport { readFileSync, writeFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\n/** Faction-id → the army keyword that gates its enhancements. */\nconst FACTION_KEYWORD: Record<string, string> = {\n  orks: \"Orks\",\n  aeldari: \"Aeldari\",\n  drukhari: \"Drukhari\",\n  tyranids: \"Tyranids\",\n  \"genestealer-cults\": \"Genestealer Cults\",\n  necrons: \"Necrons\",\n  \"leagues-of-votann\": \"Leagues of Votann\",\n  \"tau-empire\": \"T’au Empire\",\n};\n\nconst XENOS = Object.keys(FACTION_KEYWORD);\n\nconst GAME_VERSION = { edition: \"11th\", dataslate: \"pre-launch-provisional\" } as const;\n\ninterface StagedStratagem {\n  id: string;\n  name: string;\n  type: string | null;\n  cp_cost: number | null;\n  phases: string[];\n  player_turn: string | null;\n  timing: string | null;\n}\ninterface StagedEnhancement {\n  id: string;\n  name: string;\n  cost: number | null;\n}\ninterface StagedDetachment {\n  id: string;\n  name: string;\n  detachment_rule_name: string | null;\n  stratagems: StagedStratagem[];\n  enhancements: StagedEnhancement[];\n}\ninterface Staging {\n  faction_id: string;\n  detachments: StagedDetachment[];\n}\n\nfunction readJson<T>(path: string): T {\n  return JSON.parse(readFileSync(path, \"utf-8\")) as T;\n}\nfunction writeJson(path: string, value: unknown): void {\n  writeFileSync(path, JSON.stringify(value, null, 2) + \"\\n\");\n}\n\nfunction mergeFaction(faction: string): void {\n  const keyword = FACTION_KEYWORD[faction];\n  if (!keyword) throw new Error(`no faction keyword mapping for ${faction}`);\n\n  const dir = resolve(DATA_ROOT, \"core\", faction);\n  const staging = readJson<Staging>(\n    resolve(DATA_ROOT, \"_audit\", \"faction-pack-input\", `${faction}.json`),\n  );\n  const detachments = readJson<Record<string, unknown>[]>(resolve(dir, \"detachments.json\"));\n  const stratagems = readJson<Record<string, unknown>[]>(resolve(dir, \"stratagems.json\"));\n  const enhancements = readJson<Record<string, unknown>[]>(resolve(dir, \"enhancements.json\"));\n\n  const detById = new Map(detachments.map((d) => [d.id as string, d]));\n  const stratIds = new Set(stratagems.map((s) => s.id as string));\n  const enhIds = new Set(enhancements.map((e) => e.id as string));\n\n  let addedStrat = 0;\n  let addedEnh = 0;\n  let wiredDets = 0;\n  const skipped: string[] = [];\n  const renames: string[] = [];\n\n  /**\n   * A globally-unique id for a new entity. GW reuses stratagem/enhancement names\n   * across detachments (e.g. Ork \"Long, Uncontrolled Bursts\" is in both More Dakka!\n   * and Rollin' Deff) — distinct mechanics that collide on the bare name kebab. On\n   * collision we detachment-scope the id so existing ids stay stable and the entity\n   * collection (keyed by id) never overwrites. The staging entry is renamed to match.\n   */\n  function uniqueId(baseId: string, detId: string, taken: Set<string>): string {\n    if (!taken.has(baseId)) return baseId;\n    const scoped = `${detId}-${baseId}`;\n    if (taken.has(scoped)) throw new Error(`cannot disambiguate id ${baseId} for ${detId}`);\n    renames.push(`${baseId} → ${scoped}`);\n    return scoped;\n  }\n\n  for (const sd of staging.detachments) {\n    const det = detById.get(sd.id);\n    if (!det) {\n      skipped.push(`${sd.id} (no core detachment)`);\n      continue;\n    }\n    const isBareShell =\n      ((det.stratagem_ids as unknown[]) ?? []).length === 0 &&\n      ((det.enhancement_ids as unknown[]) ?? []).length === 0;\n    if (!isBareShell) continue; // already populated — leave it.\n\n    for (const s of sd.stratagems) {\n      s.id = uniqueId(s.id, sd.id, stratIds); // mutate staging to stay consistent\n      stratagems.push({\n        id: s.id,\n        name: s.name,\n        category: \"detachment\",\n        detachment_id: sd.id,\n        cp_cost: s.cp_cost ?? 1,\n        phases: s.phases,\n        player_turn: s.player_turn ?? \"either\",\n        timing: s.timing ?? \"once-per-phase\",\n        target_restrictions: null,\n        ability_id: null,\n        game_version: { ...GAME_VERSION },\n      });\n      stratIds.add(s.id);\n      addedStrat++;\n    }\n    for (const e of sd.enhancements) {\n      e.id = uniqueId(e.id, sd.id, enhIds);\n      enhancements.push({\n        id: e.id,\n        name: e.name,\n        detachment_id: sd.id,\n        cost: e.cost ?? 0,\n        keyword_restrictions: [keyword],\n        ability_id: null,\n        is_unique: true,\n        game_version: { ...GAME_VERSION },\n        points_provisional: true,\n        upgrade_tag: true,\n        max_targets: 1,\n      });\n      enhIds.add(e.id);\n      addedEnh++;\n    }\n\n    det.stratagem_ids = sd.stratagems.map((s) => s.id);\n    det.enhancement_ids = sd.enhancements.map((e) => e.id);\n    wiredDets++;\n  }\n\n  writeJson(resolve(dir, \"detachments.json\"), detachments);\n  writeJson(resolve(dir, \"stratagems.json\"), stratagems);\n  writeJson(resolve(dir, \"enhancements.json\"), enhancements);\n  // Persist any id renames back to staging so it stays the source for authoring.\n  if (renames.length)\n    writeJson(\n      resolve(DATA_ROOT, \"_audit\", \"faction-pack-input\", `${faction}.json`),\n      staging,\n    );\n\n  console.log(\n    `${faction}: wired ${wiredDets} detachment(s), +${addedStrat} stratagems, +${addedEnh} enhancements` +\n      (renames.length ? `; renamed ${renames.join(\"; \")}` : \"\") +\n      (skipped.length ? `; skipped ${skipped.join(\", \")}` : \"\"),\n  );\n}\n\nfunction main(): void {\n  const args = process.argv.slice(2);\n  const factions = args.includes(\"--all-xenos\") ? XENOS : args;\n  if (factions.length === 0) {\n    console.error(\"usage: merge-faction-pack.ts <faction-id>… | --all-xenos\");\n    process.exit(1);\n  }\n  for (const f of factions) mergeFaction(f);\n}\n\nmain();\n"]}

package/dist/pack-blocks.d.ts

@@ -0,0 +1,32 @@
+/** A positioned text block from `pdftotext -bbox-layout`. `gy` is page-globalised y. */
+export interface Block {
+    x: number;
+    gy: number;
+    text: string;
+}
+/** Section headers (caps) that are never card/enhancement names. */
+export declare const SECTION_WORDS: RegExp;
+export declare function runPdftotext(args: string[]): string;
+export declare const decodeEntities: (s: string) => string;
+/**
+ * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises
+ * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without
+ * relying on printed page numbers (which drift from physical pages on later pages
+ * when full-bleed art is inserted).
+ */
+export declare function allBlocks(pdf: string): Block[];
+/** Title/caps name → kebab id, matching existing entity-id conventions. */
+export declare function slug(name: string): string;
+/** Title-case a pack ALL-CAPS header for storage as a display name. */
+export declare function titleCase(raw: string): string;
+export declare const normCaps: (s: string) => string;
+/** A card/enhancement name candidate: a real caps header, not a section word or token. */
+export declare const isCapsHeader: (t: string) => boolean;
+/** Two blocks share a column when their left edges are within tolerance. */
+export declare const sameColumn: (a: number, b: number) => boolean;
+/** Split a trailing "… N CP" off a name block. */
+export declare const stripCp: (t: string) => {
+    name: string;
+    cp: number | null;
+};
+//# sourceMappingURL=pack-blocks.d.ts.map

package/dist/pack-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-blocks.d.ts","sourceRoot":"","sources":["../src/pack-blocks.ts"],"names":[],"mappings":"AAsBA,wFAAwF;AACxF,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,eAAO,MAAM,aAAa,QAA4E,CAAC;AAEvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CASnD;AAED,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,KAAG,MAMf,CAAC;AAE7B;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CAc9C;AAED,2EAA2E;AAC3E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOzC;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAED,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,KAAG,MAC8B,CAAC;AAEpE,0FAA0F;AAC1F,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,OAQhB,CAAC;AAE1B,4EAA4E;AAC5E,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAA+B,CAAC;AAElF,kDAAkD;AAClD,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAGpE,CAAC"}

package/dist/pack-blocks.js

@@ -0,0 +1,99 @@
+/**
+ * Shared bbox-coordinate primitives for parsing GW 11e Faction Pack PDFs.
+ *
+ * GW lays each card out as discrete, positioned text blocks. `pdftotext
+ * -bbox-layout` emits per-word coordinates; we group them into blocks and locate
+ * cards by coordinate (column + reading-order y) rather than by the linear text
+ * stream — `-layout` interleaves the packs' 2-column stratagem cards into garbage.
+ *
+ * These primitives are layout-independent (column positions differ across packs)
+ * and are shared by two tools:
+ *   - `extract-faction-pack.ts` — emits names + numeric/enum metadata only (the
+ *     committed, IP-safe staging file). It never writes prose.
+ *   - `author-input-pack.ts` — captures each card's rule body (prose) into the
+ *     gitignored authoring worklist. It is the only consumer that emits prose.
+ *
+ * Keeping the coordinate machinery here lets both share it without weakening the
+ * first tool's "never emits prose" property.
+ *
+ * Requires `pdftotext` (poppler) on PATH — authoring-time only, not CI.
+ */
+import { execFileSync } from "node:child_process";
+/** Section headers (caps) that are never card/enhancement names. */
+export const SECTION_WORDS = /^(DETACHMENT RULES?|ENHANCEMENTS?|STRATAGEMS?|KEYWORDS?|RESTRICTIONS?)$/;
+export function runPdftotext(args) {
+    try {
+        return execFileSync("pdftotext", args, { encoding: "utf-8", maxBuffer: 128 * 1024 * 1024 });
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error("pdftotext not found — install poppler (e.g. `brew install poppler`).");
+        }
+        throw err;
+    }
+}
+export const decodeEntities = (s) => s
+    .replace(/&/g, "&")
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&#39;/g, "'")
+    .replace(/&quot;/g, '"');
+/**
+ * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises
+ * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without
+ * relying on printed page numbers (which drift from physical pages on later pages
+ * when full-bleed art is inserted).
+ */
+export function allBlocks(pdf) {
+    const html = runPdftotext(["-bbox-layout", pdf, "-"]);
+    const blocks = [];
+    html.split(/<page\b/).slice(1).forEach((pageHtml, pageIdx) => {
+        const offset = pageIdx * 100000;
+        for (const m of pageHtml.matchAll(/<block\b([^>]*)>([\s\S]*?)<\/block>/g)) {
+            const x = Number(/xMin="([\d.]+)"/.exec(m[1])?.[1] ?? "0");
+            const y = Number(/yMin="([\d.]+)"/.exec(m[1])?.[1] ?? "0");
+            const words = [...m[2].matchAll(/<word[^>]*>([^<]*)<\/word>/g)].map((w) => decodeEntities(w[1]));
+            const text = words.join(" ").replace(/\s+/g, " ").trim();
+            if (text)
+                blocks.push({ x, gy: offset + y, text });
+        }
+    });
+    return blocks;
+}
+/** Title/caps name → kebab id, matching existing entity-id conventions. */
+export function slug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[’']/g, "")
+        .replace(/&/g, " and ")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+/** Title-case a pack ALL-CAPS header for storage as a display name. */
+export function titleCase(raw) {
+    const small = new Set(["of", "the", "and", "to", "a", "in", "for"]);
+    return raw
+        .trim()
+        .toLowerCase()
+        .split(/\s+/)
+        .map((w, i) => (i > 0 && small.has(w) ? w : w.charAt(0).toUpperCase() + w.slice(1)))
+        .join(" ");
+}
+export const normCaps = (s) => s.toUpperCase().replace(/[’']/g, "'").replace(/\s+/g, " ").trim();
+/** A card/enhancement name candidate: a real caps header, not a section word or token. */
+export const isCapsHeader = (t) => /^[A-Z0-9][A-Z0-9'’.,!&/()\- ]*$/.test(t) &&
+    /[A-Z]{3,}/.test(t) && // a real word, not a "1CP"/"D6" token
+    t.length >= 3 &&
+    t.length <= 46 &&
+    t.split(" ").length <= 7 &&
+    !SECTION_WORDS.test(t) &&
+    !/^\d+\s?CP$/.test(t) &&
+    !/\bSTRATAGEM$/.test(t);
+/** Two blocks share a column when their left edges are within tolerance. */
+export const sameColumn = (a, b) => Math.abs(a - b) < 46;
+/** Split a trailing "… N CP" off a name block. */
+export const stripCp = (t) => {
+    const m = t.match(/^(.*?)[\s]+(\d+)\s?CP$/);
+    return m ? { name: m[1].trim(), cp: Number(m[2]) } : { name: t, cp: null };
+};
+//# sourceMappingURL=pack-blocks.js.map

package/dist/pack-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-blocks.js","sourceRoot":"","sources":["../src/pack-blocks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared bbox-coordinate primitives for parsing GW 11e Faction Pack PDFs.\n *\n * GW lays each card out as discrete, positioned text blocks. `pdftotext\n * -bbox-layout` emits per-word coordinates; we group them into blocks and locate\n * cards by coordinate (column + reading-order y) rather than by the linear text\n * stream — `-layout` interleaves the packs' 2-column stratagem cards into garbage.\n *\n * These primitives are layout-independent (column positions differ across packs)\n * and are shared by two tools:\n *   - `extract-faction-pack.ts` — emits names + numeric/enum metadata only (the\n *     committed, IP-safe staging file). It never writes prose.\n *   - `author-input-pack.ts` — captures each card's rule body (prose) into the\n *     gitignored authoring worklist. It is the only consumer that emits prose.\n *\n * Keeping the coordinate machinery here lets both share it without weakening the\n * first tool's \"never emits prose\" property.\n *\n * Requires `pdftotext` (poppler) on PATH — authoring-time only, not CI.\n */\nimport { execFileSync } from \"node:child_process\";\n\n/** A positioned text block from `pdftotext -bbox-layout`. `gy` is page-globalised y. */\nexport interface Block {\n  x: number;\n  gy: number;\n  text: string;\n}\n\n/** Section headers (caps) that are never card/enhancement names. */\nexport const SECTION_WORDS = /^(DETACHMENT RULES?|ENHANCEMENTS?|STRATAGEMS?|KEYWORDS?|RESTRICTIONS?)$/;\n\nexport function runPdftotext(args: string[]): string {\n  try {\n    return execFileSync(\"pdftotext\", args, { encoding: \"utf-8\", maxBuffer: 128 * 1024 * 1024 });\n  } catch (err: unknown) {\n    if ((err as { code?: string }).code === \"ENOENT\") {\n      throw new Error(\"pdftotext not found — install poppler (e.g. `brew install poppler`).\");\n    }\n    throw err;\n  }\n}\n\nexport const decodeEntities = (s: string): string =>\n  s\n    .replace(/&amp;/g, \"&\")\n    .replace(/&lt;/g, \"<\")\n    .replace(/&gt;/g, \">\")\n    .replace(/&#39;/g, \"'\")\n    .replace(/&quot;/g, '\"');\n\n/**\n * Parse the whole pack's bbox-layout HTML into positioned blocks. `gy` globalises\n * y across pages (pageIndex × 100000 + y) so blocks sort in reading order without\n * relying on printed page numbers (which drift from physical pages on later pages\n * when full-bleed art is inserted).\n */\nexport function allBlocks(pdf: string): Block[] {\n  const html = runPdftotext([\"-bbox-layout\", pdf, \"-\"]);\n  const blocks: Block[] = [];\n  html.split(/<page\\b/).slice(1).forEach((pageHtml, pageIdx) => {\n    const offset = pageIdx * 100000;\n    for (const m of pageHtml.matchAll(/<block\\b([^>]*)>([\\s\\S]*?)<\\/block>/g)) {\n      const x = Number(/xMin=\"([\\d.]+)\"/.exec(m[1])?.[1] ?? \"0\");\n      const y = Number(/yMin=\"([\\d.]+)\"/.exec(m[1])?.[1] ?? \"0\");\n      const words = [...m[2].matchAll(/<word[^>]*>([^<]*)<\\/word>/g)].map((w) => decodeEntities(w[1]));\n      const text = words.join(\" \").replace(/\\s+/g, \" \").trim();\n      if (text) blocks.push({ x, gy: offset + y, text });\n    }\n  });\n  return blocks;\n}\n\n/** Title/caps name → kebab id, matching existing entity-id conventions. */\nexport function slug(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[’']/g, \"\")\n    .replace(/&/g, \" and \")\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\n/** Title-case a pack ALL-CAPS header for storage as a display name. */\nexport function titleCase(raw: string): string {\n  const small = new Set([\"of\", \"the\", \"and\", \"to\", \"a\", \"in\", \"for\"]);\n  return raw\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .map((w, i) => (i > 0 && small.has(w) ? w : w.charAt(0).toUpperCase() + w.slice(1)))\n    .join(\" \");\n}\n\nexport const normCaps = (s: string): string =>\n  s.toUpperCase().replace(/[’']/g, \"'\").replace(/\\s+/g, \" \").trim();\n\n/** A card/enhancement name candidate: a real caps header, not a section word or token. */\nexport const isCapsHeader = (t: string): boolean =>\n  /^[A-Z0-9][A-Z0-9'’.,!&/()\\- ]*$/.test(t) &&\n  /[A-Z]{3,}/.test(t) && // a real word, not a \"1CP\"/\"D6\" token\n  t.length >= 3 &&\n  t.length <= 46 &&\n  t.split(\" \").length <= 7 &&\n  !SECTION_WORDS.test(t) &&\n  !/^\\d+\\s?CP$/.test(t) &&\n  !/\\bSTRATAGEM$/.test(t);\n\n/** Two blocks share a column when their left edges are within tolerance. */\nexport const sameColumn = (a: number, b: number): boolean => Math.abs(a - b) < 46;\n\n/** Split a trailing \"… N CP\" off a name block. */\nexport const stripCp = (t: string): { name: string; cp: number | null } => {\n  const m = t.match(/^(.*?)[\\s]+(\\d+)\\s?CP$/);\n  return m ? { name: m[1].trim(), cp: Number(m[2]) } : { name: t, cp: null };\n};\n"]}

package/dist/rube-goldberg.js

@@ -51,7 +51,7 @@ function walkLinkedApi(label, roster, ds) {
     rule(`${label}: walking the linked Dataset API`);
     console.log(`Roster: ${roster.name} (${roster.units.length} units)`);
     console.log(`  faction_id     = ${roster.faction_id ?? "—"}`);
-    console.log(`  detachment_id  = ${roster.detachment_id ?? "—"}`);
+    console.log(`  detachments    = ${roster.detachments.map((d) => d.ref.id ?? d.ref.raw_name).join(", ") || "—"}`);
     console.log(`  total_computed = ${roster.points.total_computed}`);
     for (const u of roster.units) {
         if (!u.ref.id) {

package/dist/rube-goldberg.js.map

@@ -1 +1 @@
-{"version":3,"file":"rube-goldberg.js","sourceRoot":"","sources":["../src/rube-goldberg.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env tsx\n/**\n * Rube Goldberg machine — round-trips a NewRecruit list through every\n * supported format and walks the linked Dataset API at each end.\n *\n * Loop:\n * ```\n *  seed (newrecruit-json) → import → Roster₀\n *    → export wtc-compact → import\n *    → export wtc-full    → import\n *    → export simple      → import\n *    → export newrecruit-json → import → Rosterₙ\n * ```\n *\n * Asserts `Roster₀ == Rosterₙ` at the Roster level (after stripping\n * `source` + `diagnostics`, which legitimately change across hops). Exits\n * non-zero on divergence. Walks `unit.faction.units` / `weapon.units` /\n * `ability.phases` at each end to demonstrate the cross-reference loops.\n *\n * Strict IP rule: only ids, names, and counts may be printed. No ability\n * description text, no rules text — none of that is stored in the\n * dataset, so we can't accidentally leak it, but be careful adding fields.\n *\n * @packageDocumentation\n */\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { Dataset } from \"./data/dataset.js\";\nimport { exportRoster, type ExportFormat } from \"./export/index.js\";\nimport { importRoster } from \"./import/import-roster.js\";\nimport type { Roster } from \"./import/types.js\";\n\nconst SEED_PATH = join(\n  dirname(fileURLToPath(import.meta.url)),\n  \"..\",\n  \"..\",\n  \"conformance\",\n  \"roster\",\n  \"chaos-knights-houndpack\",\n  \"input.newrecruit-json.json\",\n);\n\nconst HOPS: ExportFormat[] = [\n  \"newrecruit-wtc-compact\",\n  \"newrecruit-wtc-full\",\n  \"newrecruit-simple\",\n  \"newrecruit-json\",\n];\n\n/** Strip the fields that legitimately change across format hops so the\n *  fixed-point comparison can focus on the structural Roster shape. */\nfunction stable(r: Roster): Record<string, unknown> {\n  const x = JSON.parse(JSON.stringify(r)) as Record<string, unknown>;\n  delete x.source;\n  delete x.diagnostics;\n  return x;\n}\n\nfunction rule(title: string): void {\n  console.log(`\\n── ${title} ${\"─\".repeat(Math.max(0, 60 - title.length))}`);\n}\n\nfunction walkLinkedApi(label: string, roster: Roster, ds: Dataset): void {\n  rule(`${label}: walking the linked Dataset API`);\n  console.log(`Roster: ${roster.name} (${roster.units.length} units)`);\n  console.log(`  faction_id     = ${roster.faction_id ?? \"—\"}`);\n  console.log(`  detachment_id  = ${roster.detachment_id ?? \"—\"}`);\n  console.log(`  total_computed = ${roster.points.total_computed}`);\n\n  for (const u of roster.units) {\n    if (!u.ref.id) {\n      console.log(`  · ${u.ref.raw_name}  [unresolved]`);\n      continue;\n    }\n    const unit = ds.units.get(u.ref.id);\n    if (!unit) {\n      console.log(`  · ${u.ref.id}  [not in dataset]`);\n      continue;\n    }\n    const fac = unit.faction;\n    const facUnits = fac?.units.length ?? 0;\n    console.log(`  · ${unit.id}  →  faction=${fac?.id ?? \"—\"} (faction has ${facUnits} units)`);\n\n    for (const w of unit.weapons) {\n      const carriers = w.units.length;\n      console.log(`      weapon=${w.id}  carried by ${carriers} units`);\n    }\n    for (const a of unit.abilities) {\n      const phaseIds = a.phases.join(\",\") || \"—\";\n      const carriers = a.units.length;\n      console.log(`      ability=${a.id}  phases=[${phaseIds}]  on ${carriers} units`);\n    }\n  }\n}\n\nfunction main(): number {\n  const ds = Dataset.embedded();\n  const seedJson = JSON.parse(readFileSync(SEED_PATH, \"utf8\"));\n\n  rule(\"seed\");\n  console.log(`Loading: conformance/roster/chaos-knights-houndpack/input.newrecruit-json.json`);\n\n  const roster0 = importRoster(seedJson, { dataset: ds });\n  walkLinkedApi(\"Roster₀\", roster0, ds);\n\n  let current: Roster = roster0;\n  for (const [i, fmt] of HOPS.entries()) {\n    const text = exportRoster(current, fmt);\n    const bytes = Buffer.byteLength(text, \"utf8\");\n    const isJson = fmt === \"newrecruit-json\";\n    const reimported = importRoster(isJson ? JSON.parse(text) : text, { dataset: ds });\n    console.log(\n      `[hop ${i + 1}/${HOPS.length}] ${fmt}  →  ${bytes.toLocaleString()} bytes  →  reimport: ${reimported.units.length} units (computed ${reimported.points.total_computed} pts)`,\n    );\n    current = reimported;\n  }\n\n  walkLinkedApi(\"Rosterₙ\", current, ds);\n\n  rule(\"fixed-point check\");\n  const before = stable(roster0);\n  const after = stable(current);\n  const equal = JSON.stringify(before) === JSON.stringify(after);\n  if (equal) {\n    console.log(`Roster₀ == Rosterₙ after ${HOPS.length} format hops (source/diagnostics excluded).`);\n    return 0;\n  }\n  console.error(`Roster₀ ≠ Rosterₙ — round-trip diverged.`);\n  return 1;\n}\n\nprocess.exit(main());\n"]}
+{"version":3,"file":"rube-goldberg.js","sourceRoot":"","sources":["../src/rube-goldberg.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env tsx\n/**\n * Rube Goldberg machine — round-trips a NewRecruit list through every\n * supported format and walks the linked Dataset API at each end.\n *\n * Loop:\n * ```\n *  seed (newrecruit-json) → import → Roster₀\n *    → export wtc-compact → import\n *    → export wtc-full    → import\n *    → export simple      → import\n *    → export newrecruit-json → import → Rosterₙ\n * ```\n *\n * Asserts `Roster₀ == Rosterₙ` at the Roster level (after stripping\n * `source` + `diagnostics`, which legitimately change across hops). Exits\n * non-zero on divergence. Walks `unit.faction.units` / `weapon.units` /\n * `ability.phases` at each end to demonstrate the cross-reference loops.\n *\n * Strict IP rule: only ids, names, and counts may be printed. No ability\n * description text, no rules text — none of that is stored in the\n * dataset, so we can't accidentally leak it, but be careful adding fields.\n *\n * @packageDocumentation\n */\nimport { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { Dataset } from \"./data/dataset.js\";\nimport { exportRoster, type ExportFormat } from \"./export/index.js\";\nimport { importRoster } from \"./import/import-roster.js\";\nimport type { Roster } from \"./import/types.js\";\n\nconst SEED_PATH = join(\n  dirname(fileURLToPath(import.meta.url)),\n  \"..\",\n  \"..\",\n  \"conformance\",\n  \"roster\",\n  \"chaos-knights-houndpack\",\n  \"input.newrecruit-json.json\",\n);\n\nconst HOPS: ExportFormat[] = [\n  \"newrecruit-wtc-compact\",\n  \"newrecruit-wtc-full\",\n  \"newrecruit-simple\",\n  \"newrecruit-json\",\n];\n\n/** Strip the fields that legitimately change across format hops so the\n *  fixed-point comparison can focus on the structural Roster shape. */\nfunction stable(r: Roster): Record<string, unknown> {\n  const x = JSON.parse(JSON.stringify(r)) as Record<string, unknown>;\n  delete x.source;\n  delete x.diagnostics;\n  return x;\n}\n\nfunction rule(title: string): void {\n  console.log(`\\n── ${title} ${\"─\".repeat(Math.max(0, 60 - title.length))}`);\n}\n\nfunction walkLinkedApi(label: string, roster: Roster, ds: Dataset): void {\n  rule(`${label}: walking the linked Dataset API`);\n  console.log(`Roster: ${roster.name} (${roster.units.length} units)`);\n  console.log(`  faction_id     = ${roster.faction_id ?? \"—\"}`);\n  console.log(\n    `  detachments    = ${\n      roster.detachments.map((d) => d.ref.id ?? d.ref.raw_name).join(\", \") || \"—\"\n    }`,\n  );\n  console.log(`  total_computed = ${roster.points.total_computed}`);\n\n  for (const u of roster.units) {\n    if (!u.ref.id) {\n      console.log(`  · ${u.ref.raw_name}  [unresolved]`);\n      continue;\n    }\n    const unit = ds.units.get(u.ref.id);\n    if (!unit) {\n      console.log(`  · ${u.ref.id}  [not in dataset]`);\n      continue;\n    }\n    const fac = unit.faction;\n    const facUnits = fac?.units.length ?? 0;\n    console.log(`  · ${unit.id}  →  faction=${fac?.id ?? \"—\"} (faction has ${facUnits} units)`);\n\n    for (const w of unit.weapons) {\n      const carriers = w.units.length;\n      console.log(`      weapon=${w.id}  carried by ${carriers} units`);\n    }\n    for (const a of unit.abilities) {\n      const phaseIds = a.phases.join(\",\") || \"—\";\n      const carriers = a.units.length;\n      console.log(`      ability=${a.id}  phases=[${phaseIds}]  on ${carriers} units`);\n    }\n  }\n}\n\nfunction main(): number {\n  const ds = Dataset.embedded();\n  const seedJson = JSON.parse(readFileSync(SEED_PATH, \"utf8\"));\n\n  rule(\"seed\");\n  console.log(`Loading: conformance/roster/chaos-knights-houndpack/input.newrecruit-json.json`);\n\n  const roster0 = importRoster(seedJson, { dataset: ds });\n  walkLinkedApi(\"Roster₀\", roster0, ds);\n\n  let current: Roster = roster0;\n  for (const [i, fmt] of HOPS.entries()) {\n    const text = exportRoster(current, fmt);\n    const bytes = Buffer.byteLength(text, \"utf8\");\n    const isJson = fmt === \"newrecruit-json\";\n    const reimported = importRoster(isJson ? JSON.parse(text) : text, { dataset: ds });\n    console.log(\n      `[hop ${i + 1}/${HOPS.length}] ${fmt}  →  ${bytes.toLocaleString()} bytes  →  reimport: ${reimported.units.length} units (computed ${reimported.points.total_computed} pts)`,\n    );\n    current = reimported;\n  }\n\n  walkLinkedApi(\"Rosterₙ\", current, ds);\n\n  rule(\"fixed-point check\");\n  const before = stable(roster0);\n  const after = stable(current);\n  const equal = JSON.stringify(before) === JSON.stringify(after);\n  if (equal) {\n    console.log(`Roster₀ == Rosterₙ after ${HOPS.length} format hops (source/diagnostics excluded).`);\n    return 0;\n  }\n  console.error(`Roster₀ ≠ Rosterₙ — round-trip diverged.`);\n  return 1;\n}\n\nprocess.exit(main());\n"]}

package/dist/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";AAsBA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAqC5C,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AA8C3B,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,QAAA,MAAM,WAAW,oJASP,CAAC;AACX,KAAK,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAgB9C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAmID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,CAAC,EACG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrG,IAAI,GACJ,SAAS,GACZ,MAAM,GAAG,IAAI,CAQf;AA0kBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAgDhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9E"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";AAsBA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAsC5C,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AA8C3B,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE,QAAA,MAAM,WAAW,oJASP,CAAC;AACX,KAAK,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAgB9C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAmID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,CAAC,EACG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrG,IAAI,GACJ,SAAS,GACZ,MAAM,GAAG,IAAI,CAQf;AA0mBD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAkDhG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc9E"}