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

package/dist/data/collection.d.ts

@@ -29,6 +29,7 @@ export declare class Collection<T, V> implements Iterable<V> {
     private readonly byId;
     private readonly byNorm;
     private readonly byFactionId;
+    private readonly idOf;
     private readonly nameOf?;
     private readonly wrapFn;
     constructor(cfg: CollectionConfig<T, V>);
@@ -38,6 +39,14 @@ export declare class Collection<T, V> implements Iterable<V> {
     get size(): number;
     /** Look up by exact id. */
     get(id: string): V | undefined;
+    /**
+     * Look up by exact id *within a faction*. Use this when an id is shared
+     * across factions (e.g. `chaos-land-raider` lives under five Chaos factions)
+     * and a faction context is known — {@link get} would return whichever copy
+     * was registered first, which may belong to the wrong faction. Returns
+     * `undefined` when no record with that id belongs to `factionId`.
+     */
+    getInFaction(id: string, factionId: string): V | undefined;
     /** Whether a record with this exact id exists. */
     has(id: string): boolean;
     /**

package/dist/data/collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/data/collection.ts"],"names":[],"mappings":"AAiBA,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC;IACpC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,sEAAsE;IACtE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACzC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,4CAA4C;IAC5C,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IAsBvC,6DAA6D;IAC7D,IAAI,GAAG,IAAI,CAAC,EAAE,CAEb;IAED,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2BAA2B;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAK9B,kDAAkD;IAClD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;IAc3B,gFAAgF;IAChF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE;IAIjC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;CAGjC"}
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/data/collection.ts"],"names":[],"mappings":"AAiBA,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC;IACpC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,sEAAsE;IACtE,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC1B;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAClC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACzC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,4CAA4C;IAC5C,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,GAAG,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IAuBvC,6DAA6D;IAC7D,IAAI,GAAG,IAAI,CAAC,EAAE,CAEb;IAED,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2BAA2B;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAK9B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAM1D,kDAAkD;IAClD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;IAc3B,gFAAgF;IAChF,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE;IAIjC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;CAGjC"}

package/dist/data/collection.js

@@ -27,9 +27,11 @@ export class Collection {
     byId = new Map();
     byNorm = new Map();
     byFactionId = new Map();
+    idOf;
     nameOf;
     wrapFn;
     constructor(cfg) {
+        this.idOf = cfg.idOf;
         this.nameOf = cfg.nameOf;
         this.wrapFn = cfg.wrap;
         const dedupeKeyOf = cfg.dedupeKeyOf ?? cfg.idOf;
@@ -64,6 +66,18 @@ export class Collection {
         const item = this.byId.get(id);
         return item ? this.wrapFn(item) : undefined;
     }
+    /**
+     * Look up by exact id *within a faction*. Use this when an id is shared
+     * across factions (e.g. `chaos-land-raider` lives under five Chaos factions)
+     * and a faction context is known — {@link get} would return whichever copy
+     * was registered first, which may belong to the wrong faction. Returns
+     * `undefined` when no record with that id belongs to `factionId`.
+     */
+    getInFaction(id, factionId) {
+        const list = this.byFactionId.get(factionId);
+        const item = list?.find((i) => this.idOf(i) === id);
+        return item ? this.wrapFn(item) : undefined;
+    }
     /** Whether a record with this exact id exists. */
     has(id) {
         return this.byId.has(id);

package/dist/data/collection.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/data/collection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAqB/C;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IACJ,KAAK,GAAQ,EAAE,CAAC;IAChB,IAAI,GAAG,IAAI,GAAG,EAAa,CAAC;IAC5B,MAAM,GAAG,IAAI,GAAG,EAAe,CAAC;IAChC,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;IACrC,MAAM,CAAmC;IACzC,MAAM,CAAiB;IAExC,YAAY,GAA2B;QACrC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC;QACvB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS,CAAC,mBAAmB;YACtD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEtB,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,4BAA4B;YAE7E,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;YAEvD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,2BAA2B;IAC3B,GAAG,CAAC,EAAU;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,CAAC;IAED,kDAAkD;IAClD,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAa;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAa;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAErC,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;aACvE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,gFAAgF;IAChF,SAAS,CAAC,SAAiB;QACzB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACxE,CAAC;CACF;AAED,SAAS,IAAI,CAAO,GAAgB,EAAE,GAAM,EAAE,KAAQ;IACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;QAC9B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * A queryable, iterable view over one entity collection.\n *\n * Indexes (by id, by normalized name, by faction) are built once at construction.\n * Records are deduplicated by {@link CollectionConfig.dedupeKeyOf} (default: id,\n * first occurrence wins). Some records are intentionally shared: the same unit\n * id (e.g. `ministorum-priest`) appears under several factions, so units dedupe\n * on `(faction_id, id)` to keep each faction's copy; identical core abilities\n * (e.g. `leader`) copied into many faction files dedupe away on `ability_id`.\n *\n * `get(id)`/`find` return the first match when an id is shared across factions;\n * use {@link Collection.byFaction} or {@link Collection.findAll} to disambiguate.\n *\n * @packageDocumentation\n */\nimport { normalizeName } from \"./normalize.js\";\n\n/** How a {@link Collection} reads keys and builds views from raw records. */\nexport interface CollectionConfig<T, V> {\n  items: T[];\n  /** Primary id of a record (e.g. `u => u.id`, `a => a.ability_id`). */\n  idOf: (item: T) => string;\n  /**\n   * Uniqueness key used for deduplication. Defaults to {@link idOf}. Set to a\n   * composite (e.g. `(faction_id, id)`) for records that share an id across\n   * factions, so distinct copies are preserved rather than collapsed.\n   */\n  dedupeKeyOf?: (item: T) => string;\n  /** Display name, if the record has one — drives {@link Collection.find}. */\n  nameOf?: (item: T) => string | undefined;\n  /** Owning faction id, if applicable — drives {@link Collection.byFaction}. */\n  factionOf?: (item: T) => string | null | undefined;\n  /** Wrap a raw record in its linked view. */\n  wrap: (item: T) => V;\n}\n\n/**\n * A collection of one entity type, exposing id/name/faction lookups.\n *\n * Iterable: `for (const unit of units) { … }`.\n *\n * @typeParam T - the raw (generated) record type\n * @typeParam V - the linked view type returned to callers\n */\nexport class Collection<T, V> implements Iterable<V> {\n  private readonly items: T[] = [];\n  private readonly byId = new Map<string, T>();\n  private readonly byNorm = new Map<string, T[]>();\n  private readonly byFactionId = new Map<string, T[]>();\n  private readonly nameOf?: (item: T) => string | undefined;\n  private readonly wrapFn: (item: T) => V;\n\n  constructor(cfg: CollectionConfig<T, V>) {\n    this.nameOf = cfg.nameOf;\n    this.wrapFn = cfg.wrap;\n    const dedupeKeyOf = cfg.dedupeKeyOf ?? cfg.idOf;\n    const seen = new Set<string>();\n    for (const item of cfg.items) {\n      const dedupeKey = dedupeKeyOf(item);\n      if (seen.has(dedupeKey)) continue; // first-wins dedup\n      seen.add(dedupeKey);\n      this.items.push(item);\n\n      const id = cfg.idOf(item);\n      if (!this.byId.has(id)) this.byId.set(id, item); // first-wins for shared ids\n\n      const name = cfg.nameOf?.(item);\n      if (name) push(this.byNorm, normalizeName(name), item);\n\n      const faction = cfg.factionOf?.(item);\n      if (faction) push(this.byFactionId, faction, item);\n    }\n  }\n\n  /** Every record, deduplicated by id, in first-seen order. */\n  get all(): V[] {\n    return this.items.map((item) => this.wrapFn(item));\n  }\n\n  /** Number of distinct records. */\n  get size(): number {\n    return this.items.length;\n  }\n\n  /** Look up by exact id. */\n  get(id: string): V | undefined {\n    const item = this.byId.get(id);\n    return item ? this.wrapFn(item) : undefined;\n  }\n\n  /** Whether a record with this exact id exists. */\n  has(id: string): boolean {\n    return this.byId.has(id);\n  }\n\n  /**\n   * Find one record by id or name. Name matching is diacritic- and\n   * punctuation-insensitive (see {@link normalizeName}), trying, in order:\n   * exact id → exact normalized name → normalized-name substring. Returns the\n   * first match; names can repeat across factions, so use {@link findAll} or\n   * {@link byFaction} when a query may be ambiguous.\n   *\n   * @example\n   * units.find(\"Kharn\"); // resolves \"Khârn the Betrayer\"\n   */\n  find(query: string): V | undefined {\n    return this.findAll(query)[0];\n  }\n\n  /**\n   * All records matching a query, by the same rules as {@link find}. An exact id\n   * match returns just that record; otherwise every normalized-name-exact match\n   * is returned, falling back to every normalized-name-substring match. Useful\n   * to surface (rather than silently collapse) names shared across factions.\n   */\n  findAll(query: string): V[] {\n    const byId = this.byId.get(query);\n    if (byId) return [this.wrapFn(byId)];\n\n    const key = normalizeName(query);\n    const exact = this.byNorm.get(key);\n    if (exact && exact.length > 0) return exact.map((i) => this.wrapFn(i));\n\n    if (!this.nameOf || key === \"\") return [];\n    return this.items\n      .filter((item) => normalizeName(this.nameOf!(item) ?? \"\").includes(key))\n      .map((item) => this.wrapFn(item));\n  }\n\n  /** All records belonging to a faction id (empty if the type has no faction). */\n  byFaction(factionId: string): V[] {\n    return (this.byFactionId.get(factionId) ?? []).map((i) => this.wrapFn(i));\n  }\n\n  [Symbol.iterator](): Iterator<V> {\n    return this.items.map((item) => this.wrapFn(item))[Symbol.iterator]();\n  }\n}\n\nfunction push<K, T>(map: Map<K, T[]>, key: K, value: T): void {\n  const existing = map.get(key);\n  if (existing) existing.push(value);\n  else map.set(key, [value]);\n}\n"]}
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/data/collection.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * A queryable, iterable view over one entity collection.\n *\n * Indexes (by id, by normalized name, by faction) are built once at construction.\n * Records are deduplicated by {@link CollectionConfig.dedupeKeyOf} (default: id,\n * first occurrence wins). Some records are intentionally shared: the same unit\n * id (e.g. `ministorum-priest`) appears under several factions, so units dedupe\n * on `(faction_id, id)` to keep each faction's copy; identical core abilities\n * (e.g. `leader`) copied into many faction files dedupe away on `ability_id`.\n *\n * `get(id)`/`find` return the first match when an id is shared across factions;\n * use {@link Collection.byFaction} or {@link Collection.findAll} to disambiguate.\n *\n * @packageDocumentation\n */\nimport { normalizeName } from \"./normalize.js\";\n\n/** How a {@link Collection} reads keys and builds views from raw records. */\nexport interface CollectionConfig<T, V> {\n  items: T[];\n  /** Primary id of a record (e.g. `u => u.id`, `a => a.ability_id`). */\n  idOf: (item: T) => string;\n  /**\n   * Uniqueness key used for deduplication. Defaults to {@link idOf}. Set to a\n   * composite (e.g. `(faction_id, id)`) for records that share an id across\n   * factions, so distinct copies are preserved rather than collapsed.\n   */\n  dedupeKeyOf?: (item: T) => string;\n  /** Display name, if the record has one — drives {@link Collection.find}. */\n  nameOf?: (item: T) => string | undefined;\n  /** Owning faction id, if applicable — drives {@link Collection.byFaction}. */\n  factionOf?: (item: T) => string | null | undefined;\n  /** Wrap a raw record in its linked view. */\n  wrap: (item: T) => V;\n}\n\n/**\n * A collection of one entity type, exposing id/name/faction lookups.\n *\n * Iterable: `for (const unit of units) { … }`.\n *\n * @typeParam T - the raw (generated) record type\n * @typeParam V - the linked view type returned to callers\n */\nexport class Collection<T, V> implements Iterable<V> {\n  private readonly items: T[] = [];\n  private readonly byId = new Map<string, T>();\n  private readonly byNorm = new Map<string, T[]>();\n  private readonly byFactionId = new Map<string, T[]>();\n  private readonly idOf: (item: T) => string;\n  private readonly nameOf?: (item: T) => string | undefined;\n  private readonly wrapFn: (item: T) => V;\n\n  constructor(cfg: CollectionConfig<T, V>) {\n    this.idOf = cfg.idOf;\n    this.nameOf = cfg.nameOf;\n    this.wrapFn = cfg.wrap;\n    const dedupeKeyOf = cfg.dedupeKeyOf ?? cfg.idOf;\n    const seen = new Set<string>();\n    for (const item of cfg.items) {\n      const dedupeKey = dedupeKeyOf(item);\n      if (seen.has(dedupeKey)) continue; // first-wins dedup\n      seen.add(dedupeKey);\n      this.items.push(item);\n\n      const id = cfg.idOf(item);\n      if (!this.byId.has(id)) this.byId.set(id, item); // first-wins for shared ids\n\n      const name = cfg.nameOf?.(item);\n      if (name) push(this.byNorm, normalizeName(name), item);\n\n      const faction = cfg.factionOf?.(item);\n      if (faction) push(this.byFactionId, faction, item);\n    }\n  }\n\n  /** Every record, deduplicated by id, in first-seen order. */\n  get all(): V[] {\n    return this.items.map((item) => this.wrapFn(item));\n  }\n\n  /** Number of distinct records. */\n  get size(): number {\n    return this.items.length;\n  }\n\n  /** Look up by exact id. */\n  get(id: string): V | undefined {\n    const item = this.byId.get(id);\n    return item ? this.wrapFn(item) : undefined;\n  }\n\n  /**\n   * Look up by exact id *within a faction*. Use this when an id is shared\n   * across factions (e.g. `chaos-land-raider` lives under five Chaos factions)\n   * and a faction context is known — {@link get} would return whichever copy\n   * was registered first, which may belong to the wrong faction. Returns\n   * `undefined` when no record with that id belongs to `factionId`.\n   */\n  getInFaction(id: string, factionId: string): V | undefined {\n    const list = this.byFactionId.get(factionId);\n    const item = list?.find((i) => this.idOf(i) === id);\n    return item ? this.wrapFn(item) : undefined;\n  }\n\n  /** Whether a record with this exact id exists. */\n  has(id: string): boolean {\n    return this.byId.has(id);\n  }\n\n  /**\n   * Find one record by id or name. Name matching is diacritic- and\n   * punctuation-insensitive (see {@link normalizeName}), trying, in order:\n   * exact id → exact normalized name → normalized-name substring. Returns the\n   * first match; names can repeat across factions, so use {@link findAll} or\n   * {@link byFaction} when a query may be ambiguous.\n   *\n   * @example\n   * units.find(\"Kharn\"); // resolves \"Khârn the Betrayer\"\n   */\n  find(query: string): V | undefined {\n    return this.findAll(query)[0];\n  }\n\n  /**\n   * All records matching a query, by the same rules as {@link find}. An exact id\n   * match returns just that record; otherwise every normalized-name-exact match\n   * is returned, falling back to every normalized-name-substring match. Useful\n   * to surface (rather than silently collapse) names shared across factions.\n   */\n  findAll(query: string): V[] {\n    const byId = this.byId.get(query);\n    if (byId) return [this.wrapFn(byId)];\n\n    const key = normalizeName(query);\n    const exact = this.byNorm.get(key);\n    if (exact && exact.length > 0) return exact.map((i) => this.wrapFn(i));\n\n    if (!this.nameOf || key === \"\") return [];\n    return this.items\n      .filter((item) => normalizeName(this.nameOf!(item) ?? \"\").includes(key))\n      .map((item) => this.wrapFn(item));\n  }\n\n  /** All records belonging to a faction id (empty if the type has no faction). */\n  byFaction(factionId: string): V[] {\n    return (this.byFactionId.get(factionId) ?? []).map((i) => this.wrapFn(i));\n  }\n\n  [Symbol.iterator](): Iterator<V> {\n    return this.items.map((item) => this.wrapFn(item))[Symbol.iterator]();\n  }\n}\n\nfunction push<K, T>(map: Map<K, T[]>, key: K, value: T): void {\n  const existing = map.get(key);\n  if (existing) existing.push(value);\n  else map.set(key, [value]);\n}\n"]}

package/dist/data/dataset.d.ts

@@ -9,8 +9,38 @@ import type { DeploymentPattern, Detachment, Enhancement, ForceDisposition, Game
 import { Collection } from "./collection.js";
 import { AbilityView, FactionView, UnitView, WeaponKeywordView, WeaponView } from "./entities.js";
 import { type RawData } from "./types.js";
-import type { Buff, EngineContext } from "../cruncher/buffs.js";
+import type { Buff, BuffSource, EngineContext } from "../cruncher/buffs.js";
 import { type EligibilityInput, type EligibleAbility } from "../abilities-resolver/index.js";
+/**
+ * One toggleable buff lever for damage analysis: the contributions it adds and
+ * whether it's on by default. `enabled` is `true` for buffs that always apply
+ * (intrinsic keywords, unconditional abilities) and `false` for player
+ * decisions — stratagems (CP cost) and activatable gates (dice-pool options,
+ * `choice` branches, timing-gated activations). A consumer flips `enabled`,
+ * then crunches the enabled subset; an optimizer searches it.
+ *
+ * @see {@link Dataset.stackableBuffsFor}
+ */
+export type StackableBuff = {
+    /** Stable toggle id (stable across re-enumeration of the same input). */
+    id: string;
+    /** Human label for the lever. */
+    label: string;
+    /** Contributions this lever adds when enabled (≥1). */
+    buffs: Buff[];
+    /** Default selection state. */
+    enabled: boolean;
+    /** Where the lever came from. */
+    source: BuffSource;
+    /** Id of the mutually-limited {@link StackableBuffGroup} this belongs to, if any. */
+    group?: string;
+};
+/** A pool of {@link StackableBuff} levers limited to `maxActivations` at once. */
+export type StackableBuffGroup = {
+    id: string;
+    label: string;
+    maxActivations: number;
+};
 /** The whole dataset, with linked accessors over every entity collection. */
 export declare class Dataset {
     readonly units: Collection<Unit, UnitView>;
@@ -53,6 +83,23 @@ export declare class Dataset {
     unitsWithWeapon(weaponId: string): UnitView[];
     /** Weapons whose profiles reference the given weapon-keyword id. */
     weaponsWithKeyword(keywordId: string): WeaponView[];
+    /**
+     * Leaders whose leader-attachment data lists `bodyguardUnitId` among its
+     * eligible body units, sorted by name. The attachment is stored on the
+     * leader pointing down to its bodyguards, so answering "which leaders can
+     * attach to this unit?" means scanning the attachment list. Returns an empty
+     * array for a unit that no leader can attach to (including leader units).
+     */
+    leadersAttachableTo(bodyguardUnitId: string): UnitView[];
+    /**
+     * The inverse of {@link leadersAttachableTo}: the body units the given
+     * leader can attach to, sorted by name. Scans the same leader-attachment
+     * data from the leader's side (`leader_id` matches; resolve each
+     * `eligible_bodyguard_ids` entry), deduped by id. Empty for a non-leader
+     * unit. Together the two queries give the bidirectional attachment graph the
+     * SPA needs to offer a partner dropdown from either end.
+     */
+    bodyguardsAttachableFrom(leaderUnitId: string): UnitView[];
     /**
      * Enumerate every ability that could apply to the given unit in `phase`,
      * grouped by source. The SPA uses this to render the abilities pane.
@@ -62,7 +109,7 @@ export declare class Dataset {
      * Attacker-perspective {@link Buff} stack for a (unit, phase) combination:
      * intrinsic weapon-profile keywords plus every eligible ability whose DSL
      * effect translates to an attacker-side buff (army, detachment, unit,
-     * leader, support, plus any stratagems the caller has opted into).
+     * attached members, support, plus any stratagems the caller has opted into).
      *
      * The result includes only buffs the buff layer can express today — the
      * `unsupported` half of the DSL→Buff translation is dropped here so callers
@@ -95,6 +142,37 @@ export declare class Dataset {
     defensiveBuffsFor(input: EligibilityInput & {
         optedInStratagemIds?: string[];
     }, context: EngineContext): Buff[];
+    /**
+     * Enumerate every attacker-side buff a unit could stack in `context` as a
+     * list of toggleable levers, plus the activation groups that limit them.
+     *
+     * Unlike {@link buffsFor} — which returns only the buffs that auto-apply —
+     * this surfaces the *player decisions* too: stratagems, and the activatable
+     * gates the DSL models as dice-pool options, `choice` branches, or
+     * timing-gated activations (e.g. Blessings of Khorne's three keyword grants).
+     * Each lever carries `enabled` (its default state) and, where it's part of a
+     * limited pool, a `group` id whose {@link StackableBuffGroup} caps how many
+     * can fire at once. The intended loop:
+     *
+     * ```ts
+     * const { buffs } = ds.stackableBuffsFor(input, ctx);
+     * const chosen = buffs.filter(b => b.enabled).flatMap(b => b.buffs);
+     * crunch({ ...profiles, buffs: chosen, context: ctx }, ds);
+     * ```
+     *
+     * Target/phase conditions a lever still carries (e.g. "vs Infantry") ride on
+     * each buff's `applicableWhen`, so toggling it on is always safe — the
+     * resolver gates it per-target.
+     */
+    stackableBuffsFor(input: EligibilityInput & {
+        weaponProfiles?: {
+            weaponId: string;
+            profileIndex: number;
+        }[];
+    }, context: EngineContext): {
+        buffs: StackableBuff[];
+        groups: StackableBuffGroup[];
+    };
     /** Shared implementation for buffsFor / defensiveBuffsFor. */
     private collectBuffs;
     private buildIndexes;

package/dist/data/dataset.d.ts.map

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

package/dist/data/dataset.js

@@ -111,6 +111,46 @@ export class Dataset {
     weaponsWithKeyword(keywordId) {
         return (this.weaponsByKeyword.get(keywordId) ?? []).map((w) => new WeaponView(w, this));
     }
+    /**
+     * Leaders whose leader-attachment data lists `bodyguardUnitId` among its
+     * eligible body units, sorted by name. The attachment is stored on the
+     * leader pointing down to its bodyguards, so answering "which leaders can
+     * attach to this unit?" means scanning the attachment list. Returns an empty
+     * array for a unit that no leader can attach to (including leader units).
+     */
+    leadersAttachableTo(bodyguardUnitId) {
+        return this.leaderAttachments
+            .filter((la) => la.eligible_bodyguard_ids.includes(bodyguardUnitId))
+            .map((la) => this.units.get(la.leader_id))
+            .filter((u) => u !== undefined)
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    /**
+     * The inverse of {@link leadersAttachableTo}: the body units the given
+     * leader can attach to, sorted by name. Scans the same leader-attachment
+     * data from the leader's side (`leader_id` matches; resolve each
+     * `eligible_bodyguard_ids` entry), deduped by id. Empty for a non-leader
+     * unit. Together the two queries give the bidirectional attachment graph the
+     * SPA needs to offer a partner dropdown from either end.
+     */
+    bodyguardsAttachableFrom(leaderUnitId) {
+        const seen = new Set();
+        const out = [];
+        for (const la of this.leaderAttachments) {
+            if (la.leader_id !== leaderUnitId)
+                continue;
+            for (const bodyguardId of la.eligible_bodyguard_ids) {
+                if (seen.has(bodyguardId))
+                    continue;
+                const unit = this.units.get(bodyguardId);
+                if (!unit)
+                    continue;
+                seen.add(bodyguardId);
+                out.push(unit);
+            }
+        }
+        return out.sort((a, b) => a.name.localeCompare(b.name));
+    }
     /**
      * Enumerate every ability that could apply to the given unit in `phase`,
      * grouped by source. The SPA uses this to render the abilities pane.
@@ -122,7 +162,7 @@ export class Dataset {
      * Attacker-perspective {@link Buff} stack for a (unit, phase) combination:
      * intrinsic weapon-profile keywords plus every eligible ability whose DSL
      * effect translates to an attacker-side buff (army, detachment, unit,
-     * leader, support, plus any stratagems the caller has opted into).
+     * attached members, support, plus any stratagems the caller has opted into).
      *
      * The result includes only buffs the buff layer can express today — the
      * `unsupported` half of the DSL→Buff translation is dropped here so callers
@@ -150,25 +190,117 @@ export class Dataset {
     defensiveBuffsFor(input, context) {
         return this.collectBuffs(input, context, "target");
     }
+    /**
+     * Enumerate every attacker-side buff a unit could stack in `context` as a
+     * list of toggleable levers, plus the activation groups that limit them.
+     *
+     * Unlike {@link buffsFor} — which returns only the buffs that auto-apply —
+     * this surfaces the *player decisions* too: stratagems, and the activatable
+     * gates the DSL models as dice-pool options, `choice` branches, or
+     * timing-gated activations (e.g. Blessings of Khorne's three keyword grants).
+     * Each lever carries `enabled` (its default state) and, where it's part of a
+     * limited pool, a `group` id whose {@link StackableBuffGroup} caps how many
+     * can fire at once. The intended loop:
+     *
+     * ```ts
+     * const { buffs } = ds.stackableBuffsFor(input, ctx);
+     * const chosen = buffs.filter(b => b.enabled).flatMap(b => b.buffs);
+     * crunch({ ...profiles, buffs: chosen, context: ctx }, ds);
+     * ```
+     *
+     * Target/phase conditions a lever still carries (e.g. "vs Infantry") ride on
+     * each buff's `applicableWhen`, so toggling it on is always safe — the
+     * resolver gates it per-target.
+     */
+    stackableBuffsFor(input, context) {
+        const buffs = [];
+        const groups = new Map();
+        // Surface the attachment fact to the DSL translator so `is-attached` /
+        // `model-is-leader` conditions can evaluate. Clone — never mutate the
+        // caller's context. An explicitly-set flag wins over the derivation.
+        const ctx = {
+            ...context,
+            attackerAttached: context.attackerAttached ?? (input.attachedUnitIds?.length ?? 0) > 0,
+        };
+        // Intrinsic weapon-profile keywords — always on.
+        for (const ref of input.weaponProfiles ?? []) {
+            const weapon = this.weapons.get(ref.weaponId);
+            if (!weapon)
+                continue;
+            const wk = weapon.profileBuffs(ref.profileIndex, ctx);
+            if (wk.length === 0)
+                continue;
+            buffs.push({
+                id: `weapon:${ref.weaponId}:${ref.profileIndex}`,
+                label: `${weapon.name} keywords`,
+                buffs: wk,
+                enabled: true,
+                source: wk[0].source,
+            });
+        }
+        for (const entry of this.eligibleAbilities(input, ctx.phase)) {
+            const source = bufferSourceFromEligible(entry);
+            const { applied, activatable } = entry.ability.describeBuffs(source, ctx, "attacker");
+            // Stratagems cost CP — opt-in, not on by default.
+            const isStratagem = entry.source.kind === "detachment-stratagem";
+            if (applied.length > 0) {
+                buffs.push({
+                    id: `${entry.source.kind}:${entry.ability.id}`,
+                    label: entry.ability.name,
+                    buffs: applied,
+                    enabled: !isStratagem,
+                    source,
+                });
+            }
+            for (const act of activatable) {
+                let groupId;
+                if (act.group) {
+                    groupId = act.group.id;
+                    if (!groups.has(groupId)) {
+                        groups.set(groupId, {
+                            id: groupId,
+                            label: entry.ability.name,
+                            maxActivations: act.group.maxActivations,
+                        });
+                    }
+                }
+                buffs.push({
+                    id: act.id,
+                    label: `${entry.ability.name} — ${act.label}`,
+                    buffs: act.buffs,
+                    enabled: false,
+                    source,
+                    group: groupId,
+                });
+            }
+        }
+        return { buffs, groups: [...groups.values()] };
+    }
     /** Shared implementation for buffsFor / defensiveBuffsFor. */
     collectBuffs(input, context, perspective) {
         const out = [];
+        // Surface the attachment fact to the DSL translator (see stackableBuffsFor).
+        // Clone — never mutate the caller's context; explicit flag wins.
+        const ctx = {
+            ...context,
+            attackerAttached: context.attackerAttached ?? (input.attachedUnitIds?.length ?? 0) > 0,
+        };
         // Weapon-profile keywords are attacker-only.
         if (perspective === "attacker") {
             for (const ref of input.weaponProfiles ?? []) {
                 const weapon = this.weapons.get(ref.weaponId);
                 if (!weapon)
                     continue;
-                out.push(...weapon.profileBuffs(ref.profileIndex, context));
+                out.push(...weapon.profileBuffs(ref.profileIndex, ctx));
             }
         }
         const optedIn = new Set(input.optedInStratagemIds ?? []);
-        for (const entry of this.eligibleAbilities(input, context.phase)) {
+        for (const entry of this.eligibleAbilities(input, ctx.phase)) {
             if (entry.source.kind === "detachment-stratagem" && !optedIn.has(entry.source.stratagemId)) {
                 continue;
             }
             const source = bufferSourceFromEligible(entry);
-            out.push(...entry.ability.getBuffs(source, context, perspective));
+            out.push(...entry.ability.getBuffs(source, ctx, perspective));
         }
         return out;
     }
@@ -235,8 +367,13 @@ function bufferSourceFromEligible(entry) {
             return { kind: "ability", abilityId, abilityKind: "detachment-stratagem" };
         case "unit":
             return { kind: "ability", abilityId, abilityKind: "unit" };
-        case "leader":
-            return { kind: "ability", abilityId, abilityKind: "leader" };
+        case "attached":
+            return {
+                kind: "ability",
+                abilityId,
+                abilityKind: "attached",
+                sourceUnitId: entry.source.unitId,
+            };
         case "support":
             return { kind: "ability", abilityId, abilityKind: "support" };
     }

package/dist/data/dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataset.js","sourceRoot":"","sources":["../../src/data/dataset.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * {@link Dataset} ties the embedded records together: it owns every\n * {@link Collection}, builds the cross-entity indexes once, and is the `this`\n * the linked views resolve against.\n *\n * @packageDocumentation\n */\nimport type {\n  DeploymentPattern,\n  Detachment,\n  Enhancement,\n  ForceDisposition,\n  GameVersion,\n  InteractionFlag,\n  LeaderAttachment,\n  Mission,\n  MissionMatchup,\n  Phase,\n  ResourcePool,\n  SecondaryCard,\n  Stratagem,\n  TimingFlag,\n  Unit,\n  UnitComposition,\n  WargearOption,\n  WeaponKeyword,\n} from \"../generated.js\";\nimport { Collection } from \"./collection.js\";\nimport {\n  AbilityView,\n  FactionView,\n  UnitView,\n  WeaponKeywordView,\n  WeaponView,\n} from \"./entities.js\";\nimport { emptyRawData, type RawData } from \"./types.js\";\nimport { RAW_DATA } from \"./bundle.generated.js\";\nimport type { Buff, BuffSource, EngineContext } from \"../cruncher/buffs.js\";\nimport {\n  resolveEligibleAbilities,\n  type EligibilityInput,\n  type EligibleAbility,\n} from \"../abilities-resolver/index.js\";\n\n/** The whole dataset, with linked accessors over every entity collection. */\nexport class Dataset {\n  // Richly-linked collections.\n  readonly units: Collection<Unit, UnitView>;\n  readonly weapons: Collection<RawData[\"weapons\"][number], WeaponView>;\n  readonly weaponKeywords: Collection<WeaponKeyword, WeaponKeywordView>;\n  readonly factions: Collection<RawData[\"factions\"][number], FactionView>;\n  readonly abilities: Collection<RawData[\"abilities\"][number], AbilityView>;\n\n  // Id-bearing collections without bespoke views (records returned as-is).\n  readonly detachments: Collection<Detachment, Detachment>;\n  readonly enhancements: Collection<Enhancement, Enhancement>;\n  readonly stratagems: Collection<Stratagem, Stratagem>;\n  readonly wargearOptions: Collection<WargearOption, WargearOption>;\n  readonly missions: Collection<Mission, Mission>;\n  readonly missionMatchups: Collection<MissionMatchup, MissionMatchup>;\n  readonly secondaryCards: Collection<SecondaryCard, SecondaryCard>;\n  readonly deploymentPatterns: Collection<DeploymentPattern, DeploymentPattern>;\n  readonly forceDispositions: Collection<ForceDisposition, ForceDisposition>;\n  readonly resourcePools: Collection<ResourcePool, ResourcePool>;\n\n  // Id-less collections, exposed as plain arrays.\n  readonly leaderAttachments: readonly LeaderAttachment[];\n  readonly unitCompositions: readonly UnitComposition[];\n  readonly gameVersions: readonly GameVersion[];\n  readonly timingFlags: readonly TimingFlag[];\n  readonly interactionFlags: readonly InteractionFlag[];\n  readonly phaseMappings: readonly RawData[\"phaseMappings\"][number][];\n\n  /** `source_type:source_id` → unioned phases. */\n  private readonly phaseIndex = new Map<string, Phase[]>();\n  /** ability id → units that list it. */\n  private readonly unitsByAbility = new Map<string, Unit[]>();\n  /** weapon id → units that list it. */\n  private readonly unitsByWeapon = new Map<string, Unit[]>();\n  /** weapon-keyword id → weapons whose profiles reference it. */\n  private readonly weaponsByKeyword = new Map<string, RawData[\"weapons\"][number][]>();\n\n  constructor(raw: RawData = emptyRawData()) {\n    this.units = new Collection({\n      items: raw.units,\n      idOf: (u) => u.id,\n      // The same unit id is shared across factions (e.g. ministorum-priest);\n      // keep each faction's copy, collapse only true within-faction duplicates.\n      dedupeKeyOf: (u) => `${u.faction_id}::${u.id}`,\n      nameOf: (u) => u.name,\n      factionOf: (u) => u.faction_id,\n      wrap: (u) => new UnitView(u, this),\n    });\n    this.weapons = new Collection({\n      items: raw.weapons,\n      idOf: (w) => w.id,\n      nameOf: (w) => w.name,\n      wrap: (w) => new WeaponView(w, this),\n    });\n    this.weaponKeywords = new Collection({\n      items: raw.weaponKeywords,\n      idOf: (k) => k.id,\n      nameOf: (k) => k.name,\n      wrap: (k) => new WeaponKeywordView(k, this),\n    });\n    this.factions = new Collection({\n      items: raw.factions,\n      idOf: (f) => f.id,\n      nameOf: (f) => f.name,\n      wrap: (f) => new FactionView(f, this),\n    });\n    this.abilities = new Collection({\n      items: raw.abilities,\n      idOf: (a) => a.ability_id,\n      nameOf: (a) => a.name,\n      factionOf: (a) => a.faction_id,\n      wrap: (a) => new AbilityView(a, this),\n    });\n\n    this.detachments = idCollection(raw.detachments, (d) => d.faction_id);\n    this.enhancements = idCollection(raw.enhancements);\n    this.stratagems = idCollection(raw.stratagems);\n    this.wargearOptions = idCollection(raw.wargearOptions);\n    this.missions = idCollection(raw.missions);\n    this.missionMatchups = idCollection(raw.missionMatchups);\n    this.secondaryCards = idCollection(raw.secondaryCards);\n    this.deploymentPatterns = idCollection(raw.deploymentPatterns);\n    this.forceDispositions = idCollection(raw.forceDispositions);\n    this.resourcePools = idCollection(raw.resourcePools);\n\n    this.leaderAttachments = raw.leaderAttachments;\n    this.unitCompositions = raw.unitCompositions;\n    this.gameVersions = raw.gameVersions;\n    this.timingFlags = raw.timingFlags;\n    this.interactionFlags = raw.interactionFlags;\n    this.phaseMappings = raw.phaseMappings;\n\n    this.buildIndexes(raw);\n  }\n\n  /** The dataset built from the package's embedded data. */\n  static embedded(): Dataset {\n    return new Dataset(RAW_DATA);\n  }\n\n  /** Phases a source acts in, unioned across its phase-mappings. */\n  phasesFor(sourceType: string, sourceId: string): Phase[] {\n    return this.phaseIndex.get(`${sourceType}:${sourceId}`) ?? [];\n  }\n\n  /** Units that list the given ability id. */\n  unitsWithAbility(abilityId: string): UnitView[] {\n    return (this.unitsByAbility.get(abilityId) ?? []).map((u) => new UnitView(u, this));\n  }\n\n  /** Units that list the given weapon id. */\n  unitsWithWeapon(weaponId: string): UnitView[] {\n    return (this.unitsByWeapon.get(weaponId) ?? []).map((u) => new UnitView(u, this));\n  }\n\n  /** Weapons whose profiles reference the given weapon-keyword id. */\n  weaponsWithKeyword(keywordId: string): WeaponView[] {\n    return (this.weaponsByKeyword.get(keywordId) ?? []).map((w) => new WeaponView(w, this));\n  }\n\n  /**\n   * Enumerate every ability that could apply to the given unit in `phase`,\n   * grouped by source. The SPA uses this to render the abilities pane.\n   */\n  eligibleAbilities(input: EligibilityInput, phase: Phase): EligibleAbility[] {\n    return resolveEligibleAbilities(this, input, phase);\n  }\n\n  /**\n   * Attacker-perspective {@link Buff} stack for a (unit, phase) combination:\n   * intrinsic weapon-profile keywords plus every eligible ability whose DSL\n   * effect translates to an attacker-side buff (army, detachment, unit,\n   * leader, support, plus any stratagems the caller has opted into).\n   *\n   * The result includes only buffs the buff layer can express today — the\n   * `unsupported` half of the DSL→Buff translation is dropped here so callers\n   * who just want the stack don't need to thread diagnostics through. Use\n   * {@link AbilityView.describeBuffs} when you need the diagnostics for an\n   * individual ability. Symmetric to {@link defensiveBuffsFor}, which walks\n   * the same eligibility set under target perspective.\n   */\n  buffsFor(\n    input: EligibilityInput & {\n      weaponProfiles?: { weaponId: string; profileIndex: number }[];\n      /** Stratagem ids the caller has opted into spending CP on. */\n      optedInStratagemIds?: string[];\n    },\n    context: EngineContext,\n  ): Buff[] {\n    return this.collectBuffs(input, context, \"attacker\");\n  }\n\n  /**\n   * Defender-perspective buff stack for the chosen unit: walks the same\n   * eligible-abilities set as {@link buffsFor} but translates each ability's\n   * DSL effect as defensive (FNP, save mods from `stat-modifier Sv`,\n   * toughness mods from `stat-modifier T`, save rerolls, incoming hit\n   * penalties from `bs-modifier`). Use this when the chosen unit is being\n   * crunched as the *target* — the engine reads `feelNoPain`/`saveMod`/\n   * `toughnessMod` out of `resolveBuffs` so wiring the result into `crunch`\n   * just means concatenating onto the existing `buffs` array.\n   *\n   * `weaponProfiles` are ignored under target perspective — weapon-keyword\n   * effects ride with the firing weapon, not the receiving unit.\n   */\n  defensiveBuffsFor(\n    input: EligibilityInput & { optedInStratagemIds?: string[] },\n    context: EngineContext,\n  ): Buff[] {\n    return this.collectBuffs(input, context, \"target\");\n  }\n\n  /** Shared implementation for buffsFor / defensiveBuffsFor. */\n  private collectBuffs(\n    input: EligibilityInput & {\n      weaponProfiles?: { weaponId: string; profileIndex: number }[];\n      optedInStratagemIds?: string[];\n    },\n    context: EngineContext,\n    perspective: \"attacker\" | \"target\",\n  ): Buff[] {\n    const out: Buff[] = [];\n\n    // Weapon-profile keywords are attacker-only.\n    if (perspective === \"attacker\") {\n      for (const ref of input.weaponProfiles ?? []) {\n        const weapon = this.weapons.get(ref.weaponId);\n        if (!weapon) continue;\n        out.push(...weapon.profileBuffs(ref.profileIndex, context));\n      }\n    }\n\n    const optedIn = new Set(input.optedInStratagemIds ?? []);\n    for (const entry of this.eligibleAbilities(input, context.phase)) {\n      if (entry.source.kind === \"detachment-stratagem\" && !optedIn.has(entry.source.stratagemId)) {\n        continue;\n      }\n      const source = bufferSourceFromEligible(entry);\n      out.push(...entry.ability.getBuffs(source, context, perspective));\n    }\n\n    return out;\n  }\n\n  private buildIndexes(raw: RawData): void {\n    for (const pm of raw.phaseMappings) {\n      const key = `${pm.source_type}:${pm.source_id}`;\n      const existing = this.phaseIndex.get(key) ?? [];\n      for (const phase of pm.phases) {\n        if (!existing.includes(phase)) existing.push(phase);\n      }\n      this.phaseIndex.set(key, existing);\n    }\n    for (const unit of raw.units) {\n      for (const abilityId of unit.ability_ids ?? []) push(this.unitsByAbility, abilityId, unit);\n      for (const weaponId of unit.weapon_ids ?? []) push(this.unitsByWeapon, weaponId, unit);\n    }\n    const seenByKeyword = new Map<string, Set<string>>();\n    for (const weapon of raw.weapons) {\n      for (const profile of weapon.profiles) {\n        for (const ref of profile.keywords ?? []) {\n          let seen = seenByKeyword.get(ref.keyword_id);\n          if (!seen) {\n            seen = new Set();\n            seenByKeyword.set(ref.keyword_id, seen);\n          }\n          if (seen.has(weapon.id)) continue;\n          seen.add(weapon.id);\n          push(this.weaponsByKeyword, ref.keyword_id, weapon);\n        }\n      }\n    }\n  }\n}\n\n/** Build a passthrough collection for an id-bearing record type. */\nfunction idCollection<T extends { id: string }>(\n  items: T[],\n  factionOf?: (item: T) => string | null | undefined,\n): Collection<T, T> {\n  return new Collection<T, T>({\n    items,\n    idOf: (i) => i.id,\n    nameOf: (i) => (i as { name?: string }).name,\n    factionOf,\n    wrap: (i) => i,\n  });\n}\n\nfunction push<T>(map: Map<string, T[]>, key: string, value: T): void {\n  const existing = map.get(key);\n  if (existing) existing.push(value);\n  else map.set(key, [value]);\n}\n\n/** Map an EligibleAbility back to the BuffSource the translator expects. */\nfunction bufferSourceFromEligible(entry: EligibleAbility): BuffSource {\n  const abilityId = entry.ability.id;\n  switch (entry.source.kind) {\n    case \"army\":\n      return { kind: \"ability\", abilityId, abilityKind: \"army\" };\n    case \"detachment\":\n      return { kind: \"ability\", abilityId, abilityKind: \"detachment\" };\n    case \"detachment-stratagem\":\n      return { kind: \"ability\", abilityId, abilityKind: \"detachment-stratagem\" };\n    case \"unit\":\n      return { kind: \"ability\", abilityId, abilityKind: \"unit\" };\n    case \"leader\":\n      return { kind: \"ability\", abilityId, abilityKind: \"leader\" };\n    case \"support\":\n      return { kind: \"ability\", abilityId, abilityKind: \"support\" };\n  }\n}\n"]}
+{"version":3,"file":"dataset.js","sourceRoot":"","sources":["../../src/data/dataset.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * {@link Dataset} ties the embedded records together: it owns every\n * {@link Collection}, builds the cross-entity indexes once, and is the `this`\n * the linked views resolve against.\n *\n * @packageDocumentation\n */\nimport type {\n  DeploymentPattern,\n  Detachment,\n  Enhancement,\n  ForceDisposition,\n  GameVersion,\n  InteractionFlag,\n  LeaderAttachment,\n  Mission,\n  MissionMatchup,\n  Phase,\n  ResourcePool,\n  SecondaryCard,\n  Stratagem,\n  TimingFlag,\n  Unit,\n  UnitComposition,\n  WargearOption,\n  WeaponKeyword,\n} from \"../generated.js\";\nimport { Collection } from \"./collection.js\";\nimport {\n  AbilityView,\n  FactionView,\n  UnitView,\n  WeaponKeywordView,\n  WeaponView,\n} from \"./entities.js\";\nimport { emptyRawData, type RawData } from \"./types.js\";\nimport { RAW_DATA } from \"./bundle.generated.js\";\nimport type { Buff, BuffSource, EngineContext } from \"../cruncher/buffs.js\";\nimport {\n  resolveEligibleAbilities,\n  type EligibilityInput,\n  type EligibleAbility,\n} from \"../abilities-resolver/index.js\";\n\n/**\n * One toggleable buff lever for damage analysis: the contributions it adds and\n * whether it's on by default. `enabled` is `true` for buffs that always apply\n * (intrinsic keywords, unconditional abilities) and `false` for player\n * decisions — stratagems (CP cost) and activatable gates (dice-pool options,\n * `choice` branches, timing-gated activations). A consumer flips `enabled`,\n * then crunches the enabled subset; an optimizer searches it.\n *\n * @see {@link Dataset.stackableBuffsFor}\n */\nexport type StackableBuff = {\n  /** Stable toggle id (stable across re-enumeration of the same input). */\n  id: string;\n  /** Human label for the lever. */\n  label: string;\n  /** Contributions this lever adds when enabled (≥1). */\n  buffs: Buff[];\n  /** Default selection state. */\n  enabled: boolean;\n  /** Where the lever came from. */\n  source: BuffSource;\n  /** Id of the mutually-limited {@link StackableBuffGroup} this belongs to, if any. */\n  group?: string;\n};\n\n/** A pool of {@link StackableBuff} levers limited to `maxActivations` at once. */\nexport type StackableBuffGroup = {\n  id: string;\n  label: string;\n  maxActivations: number;\n};\n\n/** The whole dataset, with linked accessors over every entity collection. */\nexport class Dataset {\n  // Richly-linked collections.\n  readonly units: Collection<Unit, UnitView>;\n  readonly weapons: Collection<RawData[\"weapons\"][number], WeaponView>;\n  readonly weaponKeywords: Collection<WeaponKeyword, WeaponKeywordView>;\n  readonly factions: Collection<RawData[\"factions\"][number], FactionView>;\n  readonly abilities: Collection<RawData[\"abilities\"][number], AbilityView>;\n\n  // Id-bearing collections without bespoke views (records returned as-is).\n  readonly detachments: Collection<Detachment, Detachment>;\n  readonly enhancements: Collection<Enhancement, Enhancement>;\n  readonly stratagems: Collection<Stratagem, Stratagem>;\n  readonly wargearOptions: Collection<WargearOption, WargearOption>;\n  readonly missions: Collection<Mission, Mission>;\n  readonly missionMatchups: Collection<MissionMatchup, MissionMatchup>;\n  readonly secondaryCards: Collection<SecondaryCard, SecondaryCard>;\n  readonly deploymentPatterns: Collection<DeploymentPattern, DeploymentPattern>;\n  readonly forceDispositions: Collection<ForceDisposition, ForceDisposition>;\n  readonly resourcePools: Collection<ResourcePool, ResourcePool>;\n\n  // Id-less collections, exposed as plain arrays.\n  readonly leaderAttachments: readonly LeaderAttachment[];\n  readonly unitCompositions: readonly UnitComposition[];\n  readonly gameVersions: readonly GameVersion[];\n  readonly timingFlags: readonly TimingFlag[];\n  readonly interactionFlags: readonly InteractionFlag[];\n  readonly phaseMappings: readonly RawData[\"phaseMappings\"][number][];\n\n  /** `source_type:source_id` → unioned phases. */\n  private readonly phaseIndex = new Map<string, Phase[]>();\n  /** ability id → units that list it. */\n  private readonly unitsByAbility = new Map<string, Unit[]>();\n  /** weapon id → units that list it. */\n  private readonly unitsByWeapon = new Map<string, Unit[]>();\n  /** weapon-keyword id → weapons whose profiles reference it. */\n  private readonly weaponsByKeyword = new Map<string, RawData[\"weapons\"][number][]>();\n\n  constructor(raw: RawData = emptyRawData()) {\n    this.units = new Collection({\n      items: raw.units,\n      idOf: (u) => u.id,\n      // The same unit id is shared across factions (e.g. ministorum-priest);\n      // keep each faction's copy, collapse only true within-faction duplicates.\n      dedupeKeyOf: (u) => `${u.faction_id}::${u.id}`,\n      nameOf: (u) => u.name,\n      factionOf: (u) => u.faction_id,\n      wrap: (u) => new UnitView(u, this),\n    });\n    this.weapons = new Collection({\n      items: raw.weapons,\n      idOf: (w) => w.id,\n      nameOf: (w) => w.name,\n      wrap: (w) => new WeaponView(w, this),\n    });\n    this.weaponKeywords = new Collection({\n      items: raw.weaponKeywords,\n      idOf: (k) => k.id,\n      nameOf: (k) => k.name,\n      wrap: (k) => new WeaponKeywordView(k, this),\n    });\n    this.factions = new Collection({\n      items: raw.factions,\n      idOf: (f) => f.id,\n      nameOf: (f) => f.name,\n      wrap: (f) => new FactionView(f, this),\n    });\n    this.abilities = new Collection({\n      items: raw.abilities,\n      idOf: (a) => a.ability_id,\n      nameOf: (a) => a.name,\n      factionOf: (a) => a.faction_id,\n      wrap: (a) => new AbilityView(a, this),\n    });\n\n    this.detachments = idCollection(raw.detachments, (d) => d.faction_id);\n    this.enhancements = idCollection(raw.enhancements);\n    this.stratagems = idCollection(raw.stratagems);\n    this.wargearOptions = idCollection(raw.wargearOptions);\n    this.missions = idCollection(raw.missions);\n    this.missionMatchups = idCollection(raw.missionMatchups);\n    this.secondaryCards = idCollection(raw.secondaryCards);\n    this.deploymentPatterns = idCollection(raw.deploymentPatterns);\n    this.forceDispositions = idCollection(raw.forceDispositions);\n    this.resourcePools = idCollection(raw.resourcePools);\n\n    this.leaderAttachments = raw.leaderAttachments;\n    this.unitCompositions = raw.unitCompositions;\n    this.gameVersions = raw.gameVersions;\n    this.timingFlags = raw.timingFlags;\n    this.interactionFlags = raw.interactionFlags;\n    this.phaseMappings = raw.phaseMappings;\n\n    this.buildIndexes(raw);\n  }\n\n  /** The dataset built from the package's embedded data. */\n  static embedded(): Dataset {\n    return new Dataset(RAW_DATA);\n  }\n\n  /** Phases a source acts in, unioned across its phase-mappings. */\n  phasesFor(sourceType: string, sourceId: string): Phase[] {\n    return this.phaseIndex.get(`${sourceType}:${sourceId}`) ?? [];\n  }\n\n  /** Units that list the given ability id. */\n  unitsWithAbility(abilityId: string): UnitView[] {\n    return (this.unitsByAbility.get(abilityId) ?? []).map((u) => new UnitView(u, this));\n  }\n\n  /** Units that list the given weapon id. */\n  unitsWithWeapon(weaponId: string): UnitView[] {\n    return (this.unitsByWeapon.get(weaponId) ?? []).map((u) => new UnitView(u, this));\n  }\n\n  /** Weapons whose profiles reference the given weapon-keyword id. */\n  weaponsWithKeyword(keywordId: string): WeaponView[] {\n    return (this.weaponsByKeyword.get(keywordId) ?? []).map((w) => new WeaponView(w, this));\n  }\n\n  /**\n   * Leaders whose leader-attachment data lists `bodyguardUnitId` among its\n   * eligible body units, sorted by name. The attachment is stored on the\n   * leader pointing down to its bodyguards, so answering \"which leaders can\n   * attach to this unit?\" means scanning the attachment list. Returns an empty\n   * array for a unit that no leader can attach to (including leader units).\n   */\n  leadersAttachableTo(bodyguardUnitId: string): UnitView[] {\n    return this.leaderAttachments\n      .filter((la) => la.eligible_bodyguard_ids.includes(bodyguardUnitId))\n      .map((la) => this.units.get(la.leader_id))\n      .filter((u): u is UnitView => u !== undefined)\n      .sort((a, b) => a.name.localeCompare(b.name));\n  }\n\n  /**\n   * The inverse of {@link leadersAttachableTo}: the body units the given\n   * leader can attach to, sorted by name. Scans the same leader-attachment\n   * data from the leader's side (`leader_id` matches; resolve each\n   * `eligible_bodyguard_ids` entry), deduped by id. Empty for a non-leader\n   * unit. Together the two queries give the bidirectional attachment graph the\n   * SPA needs to offer a partner dropdown from either end.\n   */\n  bodyguardsAttachableFrom(leaderUnitId: string): UnitView[] {\n    const seen = new Set<string>();\n    const out: UnitView[] = [];\n    for (const la of this.leaderAttachments) {\n      if (la.leader_id !== leaderUnitId) continue;\n      for (const bodyguardId of la.eligible_bodyguard_ids) {\n        if (seen.has(bodyguardId)) continue;\n        const unit = this.units.get(bodyguardId);\n        if (!unit) continue;\n        seen.add(bodyguardId);\n        out.push(unit);\n      }\n    }\n    return out.sort((a, b) => a.name.localeCompare(b.name));\n  }\n\n  /**\n   * Enumerate every ability that could apply to the given unit in `phase`,\n   * grouped by source. The SPA uses this to render the abilities pane.\n   */\n  eligibleAbilities(input: EligibilityInput, phase: Phase): EligibleAbility[] {\n    return resolveEligibleAbilities(this, input, phase);\n  }\n\n  /**\n   * Attacker-perspective {@link Buff} stack for a (unit, phase) combination:\n   * intrinsic weapon-profile keywords plus every eligible ability whose DSL\n   * effect translates to an attacker-side buff (army, detachment, unit,\n   * attached members, support, plus any stratagems the caller has opted into).\n   *\n   * The result includes only buffs the buff layer can express today — the\n   * `unsupported` half of the DSL→Buff translation is dropped here so callers\n   * who just want the stack don't need to thread diagnostics through. Use\n   * {@link AbilityView.describeBuffs} when you need the diagnostics for an\n   * individual ability. Symmetric to {@link defensiveBuffsFor}, which walks\n   * the same eligibility set under target perspective.\n   */\n  buffsFor(\n    input: EligibilityInput & {\n      weaponProfiles?: { weaponId: string; profileIndex: number }[];\n      /** Stratagem ids the caller has opted into spending CP on. */\n      optedInStratagemIds?: string[];\n    },\n    context: EngineContext,\n  ): Buff[] {\n    return this.collectBuffs(input, context, \"attacker\");\n  }\n\n  /**\n   * Defender-perspective buff stack for the chosen unit: walks the same\n   * eligible-abilities set as {@link buffsFor} but translates each ability's\n   * DSL effect as defensive (FNP, save mods from `stat-modifier Sv`,\n   * toughness mods from `stat-modifier T`, save rerolls, incoming hit\n   * penalties from `bs-modifier`). Use this when the chosen unit is being\n   * crunched as the *target* — the engine reads `feelNoPain`/`saveMod`/\n   * `toughnessMod` out of `resolveBuffs` so wiring the result into `crunch`\n   * just means concatenating onto the existing `buffs` array.\n   *\n   * `weaponProfiles` are ignored under target perspective — weapon-keyword\n   * effects ride with the firing weapon, not the receiving unit.\n   */\n  defensiveBuffsFor(\n    input: EligibilityInput & { optedInStratagemIds?: string[] },\n    context: EngineContext,\n  ): Buff[] {\n    return this.collectBuffs(input, context, \"target\");\n  }\n\n  /**\n   * Enumerate every attacker-side buff a unit could stack in `context` as a\n   * list of toggleable levers, plus the activation groups that limit them.\n   *\n   * Unlike {@link buffsFor} — which returns only the buffs that auto-apply —\n   * this surfaces the *player decisions* too: stratagems, and the activatable\n   * gates the DSL models as dice-pool options, `choice` branches, or\n   * timing-gated activations (e.g. Blessings of Khorne's three keyword grants).\n   * Each lever carries `enabled` (its default state) and, where it's part of a\n   * limited pool, a `group` id whose {@link StackableBuffGroup} caps how many\n   * can fire at once. The intended loop:\n   *\n   * ```ts\n   * const { buffs } = ds.stackableBuffsFor(input, ctx);\n   * const chosen = buffs.filter(b => b.enabled).flatMap(b => b.buffs);\n   * crunch({ ...profiles, buffs: chosen, context: ctx }, ds);\n   * ```\n   *\n   * Target/phase conditions a lever still carries (e.g. \"vs Infantry\") ride on\n   * each buff's `applicableWhen`, so toggling it on is always safe — the\n   * resolver gates it per-target.\n   */\n  stackableBuffsFor(\n    input: EligibilityInput & {\n      weaponProfiles?: { weaponId: string; profileIndex: number }[];\n    },\n    context: EngineContext,\n  ): { buffs: StackableBuff[]; groups: StackableBuffGroup[] } {\n    const buffs: StackableBuff[] = [];\n    const groups = new Map<string, StackableBuffGroup>();\n\n    // Surface the attachment fact to the DSL translator so `is-attached` /\n    // `model-is-leader` conditions can evaluate. Clone — never mutate the\n    // caller's context. An explicitly-set flag wins over the derivation.\n    const ctx: EngineContext = {\n      ...context,\n      attackerAttached: context.attackerAttached ?? (input.attachedUnitIds?.length ?? 0) > 0,\n    };\n\n    // Intrinsic weapon-profile keywords — always on.\n    for (const ref of input.weaponProfiles ?? []) {\n      const weapon = this.weapons.get(ref.weaponId);\n      if (!weapon) continue;\n      const wk = weapon.profileBuffs(ref.profileIndex, ctx);\n      if (wk.length === 0) continue;\n      buffs.push({\n        id: `weapon:${ref.weaponId}:${ref.profileIndex}`,\n        label: `${weapon.name} keywords`,\n        buffs: wk,\n        enabled: true,\n        source: wk[0].source,\n      });\n    }\n\n    for (const entry of this.eligibleAbilities(input, ctx.phase)) {\n      const source = bufferSourceFromEligible(entry);\n      const { applied, activatable } = entry.ability.describeBuffs(source, ctx, \"attacker\");\n      // Stratagems cost CP — opt-in, not on by default.\n      const isStratagem = entry.source.kind === \"detachment-stratagem\";\n\n      if (applied.length > 0) {\n        buffs.push({\n          id: `${entry.source.kind}:${entry.ability.id}`,\n          label: entry.ability.name,\n          buffs: applied,\n          enabled: !isStratagem,\n          source,\n        });\n      }\n\n      for (const act of activatable) {\n        let groupId: string | undefined;\n        if (act.group) {\n          groupId = act.group.id;\n          if (!groups.has(groupId)) {\n            groups.set(groupId, {\n              id: groupId,\n              label: entry.ability.name,\n              maxActivations: act.group.maxActivations,\n            });\n          }\n        }\n        buffs.push({\n          id: act.id,\n          label: `${entry.ability.name} — ${act.label}`,\n          buffs: act.buffs,\n          enabled: false,\n          source,\n          group: groupId,\n        });\n      }\n    }\n\n    return { buffs, groups: [...groups.values()] };\n  }\n\n  /** Shared implementation for buffsFor / defensiveBuffsFor. */\n  private collectBuffs(\n    input: EligibilityInput & {\n      weaponProfiles?: { weaponId: string; profileIndex: number }[];\n      optedInStratagemIds?: string[];\n    },\n    context: EngineContext,\n    perspective: \"attacker\" | \"target\",\n  ): Buff[] {\n    const out: Buff[] = [];\n\n    // Surface the attachment fact to the DSL translator (see stackableBuffsFor).\n    // Clone — never mutate the caller's context; explicit flag wins.\n    const ctx: EngineContext = {\n      ...context,\n      attackerAttached: context.attackerAttached ?? (input.attachedUnitIds?.length ?? 0) > 0,\n    };\n\n    // Weapon-profile keywords are attacker-only.\n    if (perspective === \"attacker\") {\n      for (const ref of input.weaponProfiles ?? []) {\n        const weapon = this.weapons.get(ref.weaponId);\n        if (!weapon) continue;\n        out.push(...weapon.profileBuffs(ref.profileIndex, ctx));\n      }\n    }\n\n    const optedIn = new Set(input.optedInStratagemIds ?? []);\n    for (const entry of this.eligibleAbilities(input, ctx.phase)) {\n      if (entry.source.kind === \"detachment-stratagem\" && !optedIn.has(entry.source.stratagemId)) {\n        continue;\n      }\n      const source = bufferSourceFromEligible(entry);\n      out.push(...entry.ability.getBuffs(source, ctx, perspective));\n    }\n\n    return out;\n  }\n\n  private buildIndexes(raw: RawData): void {\n    for (const pm of raw.phaseMappings) {\n      const key = `${pm.source_type}:${pm.source_id}`;\n      const existing = this.phaseIndex.get(key) ?? [];\n      for (const phase of pm.phases) {\n        if (!existing.includes(phase)) existing.push(phase);\n      }\n      this.phaseIndex.set(key, existing);\n    }\n    for (const unit of raw.units) {\n      for (const abilityId of unit.ability_ids ?? []) push(this.unitsByAbility, abilityId, unit);\n      for (const weaponId of unit.weapon_ids ?? []) push(this.unitsByWeapon, weaponId, unit);\n    }\n    const seenByKeyword = new Map<string, Set<string>>();\n    for (const weapon of raw.weapons) {\n      for (const profile of weapon.profiles) {\n        for (const ref of profile.keywords ?? []) {\n          let seen = seenByKeyword.get(ref.keyword_id);\n          if (!seen) {\n            seen = new Set();\n            seenByKeyword.set(ref.keyword_id, seen);\n          }\n          if (seen.has(weapon.id)) continue;\n          seen.add(weapon.id);\n          push(this.weaponsByKeyword, ref.keyword_id, weapon);\n        }\n      }\n    }\n  }\n}\n\n/** Build a passthrough collection for an id-bearing record type. */\nfunction idCollection<T extends { id: string }>(\n  items: T[],\n  factionOf?: (item: T) => string | null | undefined,\n): Collection<T, T> {\n  return new Collection<T, T>({\n    items,\n    idOf: (i) => i.id,\n    nameOf: (i) => (i as { name?: string }).name,\n    factionOf,\n    wrap: (i) => i,\n  });\n}\n\nfunction push<T>(map: Map<string, T[]>, key: string, value: T): void {\n  const existing = map.get(key);\n  if (existing) existing.push(value);\n  else map.set(key, [value]);\n}\n\n/** Map an EligibleAbility back to the BuffSource the translator expects. */\nfunction bufferSourceFromEligible(entry: EligibleAbility): BuffSource {\n  const abilityId = entry.ability.id;\n  switch (entry.source.kind) {\n    case \"army\":\n      return { kind: \"ability\", abilityId, abilityKind: \"army\" };\n    case \"detachment\":\n      return { kind: \"ability\", abilityId, abilityKind: \"detachment\" };\n    case \"detachment-stratagem\":\n      return { kind: \"ability\", abilityId, abilityKind: \"detachment-stratagem\" };\n    case \"unit\":\n      return { kind: \"ability\", abilityId, abilityKind: \"unit\" };\n    case \"attached\":\n      return {\n        kind: \"ability\",\n        abilityId,\n        abilityKind: \"attached\",\n        sourceUnitId: entry.source.unitId,\n      };\n    case \"support\":\n      return { kind: \"ability\", abilityId, abilityKind: \"support\" };\n  }\n}\n"]}

package/dist/data/entities.d.ts

@@ -7,7 +7,7 @@
  */
 import type { AbilityDSLEntry, Faction, Phase, Unit, Weapon, WeaponKeyword } from "../generated.js";
 import type { Buff, BuffSource, EngineContext } from "../cruncher/buffs.js";
-import { type TranslationPerspective, type UnsupportedFragment } from "../cruncher/from-dsl.js";
+import { type EffectTranslation, type TranslationPerspective } from "../cruncher/from-dsl.js";
 import type { Dataset } from "./dataset.js";
 /** A unit, linked to its faction, weapons, and abilities. */
 export declare class UnitView {
@@ -70,10 +70,7 @@ export declare class AbilityView {
      * fragments the buff layer can't model. The SPA renders these as warnings
      * so users see which abilities have effects that need a manual toggle.
      */
-    describeBuffs(source: BuffSource, context?: EngineContext, perspective?: TranslationPerspective): {
-        applied: Buff[];
-        unsupported: UnsupportedFragment[];
-    };
+    describeBuffs(source: BuffSource, context?: EngineContext, perspective?: TranslationPerspective): EffectTranslation;
 }
 /** A weapon, linked to the units that carry it. */
 export declare class WeaponView {

package/dist/data/entities.d.ts.map

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