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

package/dist/data/entities.d.ts

@@ -1,11 +1,13 @@
 /**
- * Linked views over the four richly-connected entity types. Each wraps a raw
+ * Linked views over the richly-connected entity types. Each wraps a raw
  * generated record and resolves its relationships lazily against the owning
  * {@link Dataset}; the full underlying record is always available via `.raw`.
  *
  * @packageDocumentation
  */
-import type { AbilityDSLEntry, Faction, Phase, Unit, Weapon } from "../generated.js";
+import type { AbilityDSLEntry, Faction, Phase, Unit, Weapon, WeaponKeyword } from "../generated.js";
+import type { Buff, BuffSource, EngineContext } from "../cruncher/buffs.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 {
@@ -23,6 +25,12 @@ export declare class UnitView {
     get weapons(): WeaponView[];
     /** Abilities referenced by `ability_ids`; unresolved ids are skipped. */
     get abilities(): AbilityView[];
+    /**
+     * The stat profile at index `i` (default 0). Returns the schema-generated
+     * profile object directly so callers can feed it straight to the engine
+     * without an intermediate wrapper.
+     */
+    profileAt(i?: number): Unit["profiles"][number];
 }
 /**
  * An ability, linked to the phases it acts in and the units that have it.
@@ -47,6 +55,22 @@ export declare class AbilityView {
     get phases(): Phase[];
     /** Units that list this ability in their `ability_ids`. */
     get units(): UnitView[];
+    /**
+     * Buff stack this ability contributes against `context`, with provenance
+     * tagged via `source` (the caller knows whether this ability is being read
+     * as army, detachment, unit, leader, etc.). DSL branches the buff layer
+     * can't auto-apply are dropped here; call {@link describeBuffs} if you
+     * also want the diagnostics. `perspective` defaults to `"attacker"`; pass
+     * `"target"` to translate the ability as a defensive buff (FNP, T/Sv
+     * stat-mods, save rerolls, incoming hit penalties).
+     */
+    getBuffs(source: BuffSource, context?: EngineContext, perspective?: TranslationPerspective): Buff[];
+    /**
+     * Full DSL→Buff translation, including the `unsupported` list of effect
+     * 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): EffectTranslation;
 }
 /** A weapon, linked to the units that carry it. */
 export declare class WeaponView {
@@ -60,6 +84,46 @@ export declare class WeaponView {
     get name(): string;
     /** Units that list this weapon in their `weapon_ids`. */
     get units(): UnitView[];
+    /** The stat profile at index `i` (default 0). */
+    profileAt(i?: number): Weapon["profiles"][number];
+    /**
+     * Catalog views for each keyword referenced by profile `i`, paired with the
+     * reference-site parameters. Unresolved keyword ids are skipped.
+     */
+    keywordsAt(i?: number): {
+        keyword: WeaponKeywordView;
+        parameters: Record<string, unknown> | undefined;
+    }[];
+    /**
+     * Buffs contributed by profile `i`'s intrinsic keywords against `context` —
+     * the natural "what does this profile bring on its own?" call the engine
+     * makes automatically before adding ability/manual buffs.
+     */
+    profileBuffs(i: number | undefined, context: EngineContext): Buff[];
+}
+/**
+ * A weapon-keyword catalog entry, linked to the weapons whose profiles
+ * reference it. Exposes the keyword's mechanical effect as a buff stack
+ * via {@link getBuffs}.
+ */
+export declare class WeaponKeywordView {
+    /** The full generated `WeaponKeyword` record. */
+    readonly raw: WeaponKeyword;
+    private readonly ds;
+    constructor(
+    /** The full generated `WeaponKeyword` record. */
+    raw: WeaponKeyword, ds: Dataset);
+    get id(): string;
+    get name(): string;
+    /** Weapons whose profiles reference this keyword id. */
+    get weapons(): WeaponView[];
+    /**
+     * Buff contributions from this catalog entry, for one reference site:
+     * pass the keyword's `parameters` (e.g. `{ value: 1 }` for Sustained Hits 1)
+     * along with the `weaponId` that's carrying it (used as the buff source)
+     * and the engine `context` (e.g. attacker stationary?).
+     */
+    getBuffs(parameters: Record<string, unknown> | undefined, weaponId: string, context: EngineContext): Buff[];
 }
 /** A faction, linked to its units and the records scoped to it. */
 export declare class FactionView {
@@ -78,3 +142,4 @@ export declare class FactionView {
     /** Distinct weapons carried by this faction's units. */
     get weapons(): WeaponView[];
 }
+//# sourceMappingURL=entities.d.ts.map

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

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

package/dist/data/entities.js

@@ -1,3 +1,5 @@
+import { buffsFromKeyword } from "../cruncher/from-keyword.js";
+import { effectToBuffs, } from "../cruncher/from-dsl.js";
 /** A unit, linked to its faction, weapons, and abilities. */
 export class UnitView {
     raw;
@@ -26,6 +28,18 @@ export class UnitView {
     get abilities() {
         return resolveAll(this.raw.ability_ids, (id) => this.ds.abilities.get(id));
     }
+    /**
+     * The stat profile at index `i` (default 0). Returns the schema-generated
+     * profile object directly so callers can feed it straight to the engine
+     * without an intermediate wrapper.
+     */
+    profileAt(i = 0) {
+        const profile = this.raw.profiles[i];
+        if (profile === undefined) {
+            throw new RangeError(`UnitView(${this.raw.id}).profileAt(${i}): only ${this.raw.profiles.length} profile(s) defined`);
+        }
+        return profile;
+    }
 }
 /**
  * An ability, linked to the phases it acts in and the units that have it.
@@ -60,6 +74,27 @@ export class AbilityView {
     get units() {
         return this.ds.unitsWithAbility(this.raw.ability_id);
     }
+    /**
+     * Buff stack this ability contributes against `context`, with provenance
+     * tagged via `source` (the caller knows whether this ability is being read
+     * as army, detachment, unit, leader, etc.). DSL branches the buff layer
+     * can't auto-apply are dropped here; call {@link describeBuffs} if you
+     * also want the diagnostics. `perspective` defaults to `"attacker"`; pass
+     * `"target"` to translate the ability as a defensive buff (FNP, T/Sv
+     * stat-mods, save rerolls, incoming hit penalties).
+     */
+    getBuffs(source, context, perspective = "attacker") {
+        return this.describeBuffs(source, context, perspective).applied;
+    }
+    /**
+     * Full DSL→Buff translation, including the `unsupported` list of effect
+     * 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, context, perspective = "attacker") {
+        const ctx = context ?? { phase: "shooting" };
+        return effectToBuffs(this.raw.effect, source, ctx, perspective);
+    }
 }
 /** A weapon, linked to the units that carry it. */
 export class WeaponView {
@@ -81,6 +116,92 @@ export class WeaponView {
     get units() {
         return this.ds.unitsWithWeapon(this.raw.id);
     }
+    /** The stat profile at index `i` (default 0). */
+    profileAt(i = 0) {
+        const profile = this.raw.profiles[i];
+        if (profile === undefined) {
+            throw new RangeError(`WeaponView(${this.raw.id}).profileAt(${i}): only ${this.raw.profiles.length} profile(s) defined`);
+        }
+        return profile;
+    }
+    /**
+     * Catalog views for each keyword referenced by profile `i`, paired with the
+     * reference-site parameters. Unresolved keyword ids are skipped.
+     */
+    keywordsAt(i = 0) {
+        const profile = this.profileAt(i);
+        const refs = profile.keywords ?? [];
+        const out = [];
+        for (const ref of refs) {
+            const view = this.ds.weaponKeywords.get(ref.keyword_id);
+            if (!view)
+                continue;
+            out.push({
+                keyword: view,
+                parameters: ref.parameters,
+            });
+        }
+        return out;
+    }
+    /**
+     * Buffs contributed by profile `i`'s intrinsic keywords against `context` —
+     * the natural "what does this profile bring on its own?" call the engine
+     * makes automatically before adding ability/manual buffs.
+     */
+    profileBuffs(i, context) {
+        const index = i ?? 0;
+        const out = [];
+        for (const { keyword, parameters } of this.keywordsAt(index)) {
+            out.push(...buffsFromKeyword({
+                keywordId: keyword.id,
+                weaponId: this.raw.id,
+                effect: keyword.raw.effect,
+                ...(parameters !== undefined ? { parameters } : {}),
+                context,
+            }));
+        }
+        return out;
+    }
+}
+/**
+ * A weapon-keyword catalog entry, linked to the weapons whose profiles
+ * reference it. Exposes the keyword's mechanical effect as a buff stack
+ * via {@link getBuffs}.
+ */
+export class WeaponKeywordView {
+    raw;
+    ds;
+    constructor(
+    /** The full generated `WeaponKeyword` record. */
+    raw, ds) {
+        this.raw = raw;
+        this.ds = ds;
+    }
+    get id() {
+        return this.raw.id;
+    }
+    get name() {
+        return this.raw.name;
+    }
+    /** Weapons whose profiles reference this keyword id. */
+    get weapons() {
+        return this.ds.weaponsWithKeyword(this.raw.id);
+    }
+    /**
+     * Buff contributions from this catalog entry, for one reference site:
+     * pass the keyword's `parameters` (e.g. `{ value: 1 }` for Sustained Hits 1)
+     * along with the `weaponId` that's carrying it (used as the buff source)
+     * and the engine `context` (e.g. attacker stationary?).
+     */
+    getBuffs(parameters, weaponId, context) {
+        return buffsFromKeyword({
+            keywordId: this.raw.id,
+            weaponId,
+            effect: this.raw.effect,
+            ...(parameters !== undefined ? { parameters } : {}),
+            context,
+        });
+    }
 }
 /** A faction, linked to its units and the records scoped to it. */
 export class FactionView {
@@ -131,3 +252,4 @@ function resolveAll(ids, get) {
     }
     return out;
 }
+//# sourceMappingURL=entities.js.map

package/dist/data/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/data/entities.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Linked views over the richly-connected entity types. Each wraps a raw\n * generated record and resolves its relationships lazily against the owning\n * {@link Dataset}; the full underlying record is always available via `.raw`.\n *\n * @packageDocumentation\n */\nimport type {\n  AbilityDSLEntry,\n  Faction,\n  Phase,\n  Unit,\n  Weapon,\n  WeaponKeyword,\n} from \"../generated.js\";\nimport type { Buff, BuffSource, EngineContext } from \"../cruncher/buffs.js\";\nimport { buffsFromKeyword } from \"../cruncher/from-keyword.js\";\nimport {\n  effectToBuffs,\n  type EffectTranslation,\n  type TranslationPerspective,\n} from \"../cruncher/from-dsl.js\";\nimport type { Dataset } from \"./dataset.js\";\n\n/** A unit, linked to its faction, weapons, and abilities. */\nexport class UnitView {\n  constructor(\n    /** The full generated `Unit` record. */\n    readonly raw: Unit,\n    private readonly ds: Dataset,\n  ) {}\n\n  get id(): string {\n    return this.raw.id;\n  }\n\n  get name(): string {\n    return this.raw.name;\n  }\n\n  /** The unit's faction, or `undefined` if its `faction_id` is unknown. */\n  get faction(): FactionView | undefined {\n    return this.ds.factions.get(this.raw.faction_id);\n  }\n\n  /** Weapons referenced by `weapon_ids`; unresolved ids are skipped. */\n  get weapons(): WeaponView[] {\n    return resolveAll(this.raw.weapon_ids, (id) => this.ds.weapons.get(id));\n  }\n\n  /** Abilities referenced by `ability_ids`; unresolved ids are skipped. */\n  get abilities(): AbilityView[] {\n    return resolveAll(this.raw.ability_ids, (id) => this.ds.abilities.get(id));\n  }\n\n  /**\n   * The stat profile at index `i` (default 0). Returns the schema-generated\n   * profile object directly so callers can feed it straight to the engine\n   * without an intermediate wrapper.\n   */\n  profileAt(i = 0): Unit[\"profiles\"][number] {\n    const profile = this.raw.profiles[i];\n    if (profile === undefined) {\n      throw new RangeError(\n        `UnitView(${this.raw.id}).profileAt(${i}): only ${this.raw.profiles.length} profile(s) defined`,\n      );\n    }\n    return profile;\n  }\n}\n\n/**\n * An ability, linked to the phases it acts in and the units that have it.\n *\n * Phases are not stored on the ability — they live in `phase-mappings` records.\n *\n * @example\n * units.find(\"Kharn\")!.abilities\n *   .filter(a => a.phases.includes(\"shooting\"));\n */\nexport class AbilityView {\n  constructor(\n    /** The full generated ability record. */\n    readonly raw: AbilityDSLEntry,\n    private readonly ds: Dataset,\n  ) {}\n\n  /** The ability's id (`ability_id` in the raw record). */\n  get id(): string {\n    return this.raw.ability_id;\n  }\n\n  get name(): string {\n    return this.raw.name;\n  }\n\n  /** Game phases this ability acts in, unioned across its phase-mappings. */\n  get phases(): Phase[] {\n    return this.ds.phasesFor(\"ability\", this.raw.ability_id);\n  }\n\n  /** Units that list this ability in their `ability_ids`. */\n  get units(): UnitView[] {\n    return this.ds.unitsWithAbility(this.raw.ability_id);\n  }\n\n  /**\n   * Buff stack this ability contributes against `context`, with provenance\n   * tagged via `source` (the caller knows whether this ability is being read\n   * as army, detachment, unit, leader, etc.). DSL branches the buff layer\n   * can't auto-apply are dropped here; call {@link describeBuffs} if you\n   * also want the diagnostics. `perspective` defaults to `\"attacker\"`; pass\n   * `\"target\"` to translate the ability as a defensive buff (FNP, T/Sv\n   * stat-mods, save rerolls, incoming hit penalties).\n   */\n  getBuffs(\n    source: BuffSource,\n    context?: EngineContext,\n    perspective: TranslationPerspective = \"attacker\",\n  ): Buff[] {\n    return this.describeBuffs(source, context, perspective).applied;\n  }\n\n  /**\n   * Full DSL→Buff translation, including the `unsupported` list of effect\n   * fragments the buff layer can't model. The SPA renders these as warnings\n   * so users see which abilities have effects that need a manual toggle.\n   */\n  describeBuffs(\n    source: BuffSource,\n    context?: EngineContext,\n    perspective: TranslationPerspective = \"attacker\",\n  ): EffectTranslation {\n    const ctx: EngineContext = context ?? { phase: \"shooting\" };\n    return effectToBuffs(this.raw.effect, source, ctx, perspective);\n  }\n}\n\n/** A weapon, linked to the units that carry it. */\nexport class WeaponView {\n  constructor(\n    /** The full generated `Weapon` record. */\n    readonly raw: Weapon,\n    private readonly ds: Dataset,\n  ) {}\n\n  get id(): string {\n    return this.raw.id;\n  }\n\n  get name(): string {\n    return this.raw.name;\n  }\n\n  /** Units that list this weapon in their `weapon_ids`. */\n  get units(): UnitView[] {\n    return this.ds.unitsWithWeapon(this.raw.id);\n  }\n\n  /** The stat profile at index `i` (default 0). */\n  profileAt(i = 0): Weapon[\"profiles\"][number] {\n    const profile = this.raw.profiles[i];\n    if (profile === undefined) {\n      throw new RangeError(\n        `WeaponView(${this.raw.id}).profileAt(${i}): only ${this.raw.profiles.length} profile(s) defined`,\n      );\n    }\n    return profile;\n  }\n\n  /**\n   * Catalog views for each keyword referenced by profile `i`, paired with the\n   * reference-site parameters. Unresolved keyword ids are skipped.\n   */\n  keywordsAt(\n    i = 0,\n  ): { keyword: WeaponKeywordView; parameters: Record<string, unknown> | undefined }[] {\n    const profile = this.profileAt(i);\n    const refs = profile.keywords ?? [];\n    const out: { keyword: WeaponKeywordView; parameters: Record<string, unknown> | undefined }[] = [];\n    for (const ref of refs) {\n      const view = this.ds.weaponKeywords.get(ref.keyword_id);\n      if (!view) continue;\n      out.push({\n        keyword: view,\n        parameters: ref.parameters as Record<string, unknown> | undefined,\n      });\n    }\n    return out;\n  }\n\n  /**\n   * Buffs contributed by profile `i`'s intrinsic keywords against `context` —\n   * the natural \"what does this profile bring on its own?\" call the engine\n   * makes automatically before adding ability/manual buffs.\n   */\n  profileBuffs(i: number | undefined, context: EngineContext): Buff[] {\n    const index = i ?? 0;\n    const out: Buff[] = [];\n    for (const { keyword, parameters } of this.keywordsAt(index)) {\n      out.push(\n        ...buffsFromKeyword({\n          keywordId: keyword.id,\n          weaponId: this.raw.id,\n          effect: keyword.raw.effect,\n          ...(parameters !== undefined ? { parameters } : {}),\n          context,\n        }),\n      );\n    }\n    return out;\n  }\n}\n\n/**\n * A weapon-keyword catalog entry, linked to the weapons whose profiles\n * reference it. Exposes the keyword's mechanical effect as a buff stack\n * via {@link getBuffs}.\n */\nexport class WeaponKeywordView {\n  constructor(\n    /** The full generated `WeaponKeyword` record. */\n    readonly raw: WeaponKeyword,\n    private readonly ds: Dataset,\n  ) {}\n\n  get id(): string {\n    return this.raw.id;\n  }\n\n  get name(): string {\n    return this.raw.name;\n  }\n\n  /** Weapons whose profiles reference this keyword id. */\n  get weapons(): WeaponView[] {\n    return this.ds.weaponsWithKeyword(this.raw.id);\n  }\n\n  /**\n   * Buff contributions from this catalog entry, for one reference site:\n   * pass the keyword's `parameters` (e.g. `{ value: 1 }` for Sustained Hits 1)\n   * along with the `weaponId` that's carrying it (used as the buff source)\n   * and the engine `context` (e.g. attacker stationary?).\n   */\n  getBuffs(\n    parameters: Record<string, unknown> | undefined,\n    weaponId: string,\n    context: EngineContext,\n  ): Buff[] {\n    return buffsFromKeyword({\n      keywordId: this.raw.id,\n      weaponId,\n      effect: this.raw.effect,\n      ...(parameters !== undefined ? { parameters } : {}),\n      context,\n    });\n  }\n}\n\n/** A faction, linked to its units and the records scoped to it. */\nexport class FactionView {\n  constructor(\n    /** The full generated `Faction` record. */\n    readonly raw: Faction,\n    private readonly ds: Dataset,\n  ) {}\n\n  get id(): string {\n    return this.raw.id;\n  }\n\n  get name(): string {\n    return this.raw.name;\n  }\n\n  /** Units whose `faction_id` is this faction (may be empty for successors). */\n  get units(): UnitView[] {\n    return this.ds.units.byFaction(this.raw.id);\n  }\n\n  /** Faction-scoped abilities (abilities whose `faction_id` is this faction). */\n  get abilities(): AbilityView[] {\n    return this.ds.abilities.byFaction(this.raw.id);\n  }\n\n  /** Distinct weapons carried by this faction's units. */\n  get weapons(): WeaponView[] {\n    const seen = new Set<string>();\n    const out: WeaponView[] = [];\n    for (const unit of this.units) {\n      for (const weapon of unit.weapons) {\n        if (seen.has(weapon.id)) continue;\n        seen.add(weapon.id);\n        out.push(weapon);\n      }\n    }\n    return out;\n  }\n}\n\n/** Resolve a list of ids, dropping any that don't resolve. */\nfunction resolveAll<V>(ids: string[] | undefined, get: (id: string) => V | undefined): V[] {\n  const out: V[] = [];\n  for (const id of ids ?? []) {\n    const v = get(id);\n    if (v !== undefined) out.push(v);\n  }\n  return out;\n}\n"]}

package/dist/data/index.d.ts

@@ -20,12 +20,18 @@
  * factions.find("World Eaters")!.units.length;
  */
 export { Dataset } from "./dataset.js";
+export type { StackableBuff, StackableBuffGroup } from "./dataset.js";
 export { Collection } from "./collection.js";
 export type { CollectionConfig } from "./collection.js";
-export { UnitView, AbilityView, WeaponView, FactionView } from "./entities.js";
+export { UnitView, AbilityView, WeaponView, WeaponKeywordView, FactionView, } from "./entities.js";
 export { normalizeName } from "./normalize.js";
 export { emptyRawData } from "./types.js";
 export type { RawData } from "./types.js";
+export * from "../cruncher/index.js";
+export { effectToBuffs, parseKeywordGrant } from "../cruncher/from-dsl.js";
+export type { ActivatableBuff, ActivatableGroupRef, EffectTranslation, TranslationPerspective, UnsupportedFragment, } from "../cruncher/from-dsl.js";
+export * from "../abilities-resolver/index.js";
+export { resolveRosterUnit, resolveRosterWargear, resolveAttachedLeader, resolveAttachmentPartners, } from "./roster-resolve.js";
 import { Dataset } from "./dataset.js";
 /** The dataset built from this package's embedded data. */
 export declare const dataset: Dataset;
@@ -33,6 +39,8 @@ export declare const dataset: Dataset;
 export declare const units: import("./collection.js").Collection<import("../generated.js").Unit, import("./entities.js").UnitView>;
 /** All weapons, linked to the units that carry them. */
 export declare const weapons: import("./collection.js").Collection<import("../generated.js").Weapon, import("./entities.js").WeaponView>;
+/** Catalog of weapon keywords (Lethal Hits, Sustained Hits N, Anti-X N+, ...). */
+export declare const weaponKeywords: import("./collection.js").Collection<import("../generated.js").WeaponKeyword, import("./entities.js").WeaponKeywordView>;
 /** All factions, linked to their units, abilities, and weapons. */
 export declare const factions: import("./collection.js").Collection<import("../generated.js").Faction, import("./entities.js").FactionView>;
 /** All abilities, linked to their phases and the units that have them. */
@@ -57,3 +65,4 @@ export declare const deploymentPatterns: import("./collection.js").Collection<im
 export declare const forceDispositions: import("./collection.js").Collection<import("../generated.js").ForceDisposition, import("../generated.js").ForceDisposition>;
 /** All resource pools. */
 export declare const resourcePools: import("./collection.js").Collection<import("../generated.js").ResourcePool, import("../generated.js").ResourcePool>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK1C,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,cAAc,gCAAgC,CAAC;AAG/C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,2DAA2D;AAC3D,eAAO,MAAM,OAAO,SAAqB,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,KAAK,wGAAgB,CAAC;AACnC,wDAAwD;AACxD,eAAO,MAAM,OAAO,4GAAkB,CAAC;AACvC,kFAAkF;AAClF,eAAO,MAAM,cAAc,0HAAyB,CAAC;AACrD,mEAAmE;AACnE,eAAO,MAAM,QAAQ,8GAAmB,CAAC;AACzC,0EAA0E;AAC1E,eAAO,MAAM,SAAS,sHAAoB,CAAC;AAC3C,uBAAuB;AACvB,eAAO,MAAM,WAAW,kHAAsB,CAAC;AAC/C,wBAAwB;AACxB,eAAO,MAAM,YAAY,oHAAuB,CAAC;AACjD,sBAAsB;AACtB,eAAO,MAAM,UAAU,gHAAqB,CAAC;AAC7C,2BAA2B;AAC3B,eAAO,MAAM,cAAc,wHAAyB,CAAC;AACrD,oBAAoB;AACpB,eAAO,MAAM,QAAQ,4GAAmB,CAAC;AACzC,4BAA4B;AAC5B,eAAO,MAAM,eAAe,0HAA0B,CAAC;AACvD,mCAAmC;AACnC,eAAO,MAAM,cAAc,wHAAyB,CAAC;AACrD,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,gIAA6B,CAAC;AAC7D,8BAA8B;AAC9B,eAAO,MAAM,iBAAiB,8HAA4B,CAAC;AAC3D,0BAA0B;AAC1B,eAAO,MAAM,aAAa,sHAAwB,CAAC"}

package/dist/data/index.js

@@ -21,9 +21,19 @@
  */
 export { Dataset } from "./dataset.js";
 export { Collection } from "./collection.js";
-export { UnitView, AbilityView, WeaponView, FactionView } from "./entities.js";
+export { UnitView, AbilityView, WeaponView, WeaponKeywordView, FactionView, } from "./entities.js";
 export { normalizeName } from "./normalize.js";
 export { emptyRawData } from "./types.js";
+// The cruncher surface — buff types + the engine — re-exported from the data
+// package so downstream callers can import their whole 40kdc API from
+// `@alpaca-software/40kdc-data` without reaching into subpaths.
+export * from "../cruncher/index.js";
+// The DSL→Buff translator that powers AbilityView.getBuffs / describeBuffs.
+export { effectToBuffs, parseKeywordGrant } from "../cruncher/from-dsl.js";
+// The eligible-abilities resolver (also reachable as Dataset.eligibleAbilities).
+export * from "../abilities-resolver/index.js";
+// Bridge helpers from the importer's RosterUnit → linked views.
+export { resolveRosterUnit, resolveRosterWargear, resolveAttachedLeader, resolveAttachmentPartners, } from "./roster-resolve.js";
 import { Dataset } from "./dataset.js";
 /** The dataset built from this package's embedded data. */
 export const dataset = Dataset.embedded();
@@ -31,6 +41,8 @@ export const dataset = Dataset.embedded();
 export const units = dataset.units;
 /** All weapons, linked to the units that carry them. */
 export const weapons = dataset.weapons;
+/** Catalog of weapon keywords (Lethal Hits, Sustained Hits N, Anti-X N+, ...). */
+export const weaponKeywords = dataset.weaponKeywords;
 /** All factions, linked to their units, abilities, and weapons. */
 export const factions = dataset.factions;
 /** All abilities, linked to their phases and the units that have them. */
@@ -55,3 +67,4 @@ export const deploymentPatterns = dataset.deploymentPatterns;
 export const forceDispositions = dataset.forceDispositions;
 /** All resource pools. */
 export const resourcePools = dataset.resourcePools;
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACL,QAAQ,EACR,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,6EAA6E;AAC7E,sEAAsE;AACtE,gEAAgE;AAChE,cAAc,sBAAsB,CAAC;AAErC,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAS3E,iFAAiF;AACjF,cAAc,gCAAgC,CAAC;AAE/C,gEAAgE;AAChE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;AAE1C,kEAAkE;AAClE,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACnC,wDAAwD;AACxD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;AACvC,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACrD,mEAAmE;AACnE,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACzC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;AAC3C,uBAAuB;AACvB,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAC/C,wBAAwB;AACxB,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AACjD,sBAAsB;AACtB,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;AAC7C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACrD,oBAAoB;AACpB,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;AACzC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;AACvD,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;AACrD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAC7D,8BAA8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;AAC3D,0BAA0B;AAC1B,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC","sourcesContent":["/**\n * The linked, typed 40kdc dataset.\n *\n * The default {@link dataset} is built once from the data embedded in this\n * package; the top-level collections below are its accessors, re-exported for\n * the ergonomic one-liner form.\n *\n * @packageDocumentation\n *\n * @example\n * import { units } from \"@alpaca-software/40kdc-data\";\n *\n * units.find(\"Kharn\")!.abilities\n *   .filter(a => a.phases.includes(\"shooting\"))\n *   .map(a => a.id); // [\"berzerker-frenzy\"]\n *\n * @example\n * import { factions } from \"@alpaca-software/40kdc-data\";\n *\n * factions.find(\"World Eaters\")!.units.length;\n */\nexport { Dataset } from \"./dataset.js\";\nexport type { StackableBuff, StackableBuffGroup } from \"./dataset.js\";\nexport { Collection } from \"./collection.js\";\nexport type { CollectionConfig } from \"./collection.js\";\nexport {\n  UnitView,\n  AbilityView,\n  WeaponView,\n  WeaponKeywordView,\n  FactionView,\n} from \"./entities.js\";\nexport { normalizeName } from \"./normalize.js\";\nexport { emptyRawData } from \"./types.js\";\nexport type { RawData } from \"./types.js\";\n\n// The cruncher surface — buff types + the engine — re-exported from the data\n// package so downstream callers can import their whole 40kdc API from\n// `@alpaca-software/40kdc-data` without reaching into subpaths.\nexport * from \"../cruncher/index.js\";\n\n// The DSL→Buff translator that powers AbilityView.getBuffs / describeBuffs.\nexport { effectToBuffs, parseKeywordGrant } from \"../cruncher/from-dsl.js\";\nexport type {\n  ActivatableBuff,\n  ActivatableGroupRef,\n  EffectTranslation,\n  TranslationPerspective,\n  UnsupportedFragment,\n} from \"../cruncher/from-dsl.js\";\n\n// The eligible-abilities resolver (also reachable as Dataset.eligibleAbilities).\nexport * from \"../abilities-resolver/index.js\";\n\n// Bridge helpers from the importer's RosterUnit → linked views.\nexport {\n  resolveRosterUnit,\n  resolveRosterWargear,\n  resolveAttachedLeader,\n  resolveAttachmentPartners,\n} from \"./roster-resolve.js\";\n\nimport { Dataset } from \"./dataset.js\";\n\n/** The dataset built from this package's embedded data. */\nexport const dataset = Dataset.embedded();\n\n/** All units, linked to their faction, weapons, and abilities. */\nexport const units = dataset.units;\n/** All weapons, linked to the units that carry them. */\nexport const weapons = dataset.weapons;\n/** Catalog of weapon keywords (Lethal Hits, Sustained Hits N, Anti-X N+, ...). */\nexport const weaponKeywords = dataset.weaponKeywords;\n/** All factions, linked to their units, abilities, and weapons. */\nexport const factions = dataset.factions;\n/** All abilities, linked to their phases and the units that have them. */\nexport const abilities = dataset.abilities;\n/** All detachments. */\nexport const detachments = dataset.detachments;\n/** All enhancements. */\nexport const enhancements = dataset.enhancements;\n/** All stratagems. */\nexport const stratagems = dataset.stratagems;\n/** All wargear options. */\nexport const wargearOptions = dataset.wargearOptions;\n/** All missions. */\nexport const missions = dataset.missions;\n/** All mission matchups. */\nexport const missionMatchups = dataset.missionMatchups;\n/** All secondary mission cards. */\nexport const secondaryCards = dataset.secondaryCards;\n/** All deployment patterns. */\nexport const deploymentPatterns = dataset.deploymentPatterns;\n/** All force dispositions. */\nexport const forceDispositions = dataset.forceDispositions;\n/** All resource pools. */\nexport const resourcePools = dataset.resourcePools;\n"]}

package/dist/data/normalize.d.ts

@@ -27,3 +27,4 @@
  * normalizeName("T'au");               // "tau"
  */
 export declare function normalizeName(input: string): string;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/data/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnD"}

package/dist/data/normalize.js

@@ -35,3 +35,4 @@ export function normalizeName(input) {
         .replace(/[\s-]+/g, " ")
         .trim();
 }
+//# sourceMappingURL=normalize.js.map

package/dist/data/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/data/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK;SACT,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;SAC9B,WAAW,EAAE;SACb,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,IAAI,EAAE,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Name normalization for diacritic- and punctuation-insensitive lookup.\n *\n * Warhammer 40,000 is played globally and many entity names carry diacritics or\n * punctuation — \"Khârn the Betrayer\", \"T'au\", \"Be'lakor\". A user typing the\n * plain-ASCII form of a name must still find the entity. Every name comparison\n * in this package routes through {@link normalizeName} so the matching rule is\n * defined in exactly one place; consumers can import it to reproduce the same\n * behaviour in their own search UIs.\n *\n * @packageDocumentation\n */\n\n/**\n * Reduce a display name to a canonical lookup key.\n *\n * The transform, in order:\n * 1. Unicode NFD-decompose, then strip combining marks — `Khârn` → `Kharn`.\n * 2. Casefold to lower case.\n * 3. Remove apostrophe and quote variants (`' ’ ‘ \\` \" “ ”`) — `T'au` → `Tau`.\n * 4. Collapse any run of whitespace or hyphens to a single space, then trim —\n *    `Be'lakor` → `belakor`, `the   betrayer` → `the betrayer`.\n *\n * The result is intended only for comparison; it is not a display value.\n *\n * @example\n * normalizeName(\"Khârn the Betrayer\"); // \"kharn the betrayer\"\n * normalizeName(\"T'au\");               // \"tau\"\n */\nexport function normalizeName(input: string): string {\n  return input\n    .normalize(\"NFD\")\n    .replace(/\\p{Diacritic}/gu, \"\")\n    .toLowerCase()\n    .replace(/['’‘`\"“”]/g, \"\")\n    .replace(/[\\s-]+/g, \" \")\n    .trim();\n}\n"]}

package/dist/data/roster-resolve.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Bridge helpers between the importer's flat-data {@link Roster} types and
+ * the linked {@link UnitView} the cruncher consumes. The importer ships
+ * unit entries as plain interfaces (`RosterUnit` is data, not behaviour),
+ * so the lookup is a free function rather than a method.
+ *
+ * @packageDocumentation
+ */
+import type { Roster, RosterUnit, RosterWargear } from "../import/types.js";
+import type { Dataset } from "./dataset.js";
+import type { UnitView, WeaponView } from "./entities.js";
+/**
+ * Resolve a roster's unit entry against the dataset, returning the linked
+ * {@link UnitView}. Returns `undefined` when:
+ *   - the roster's `ref.id` is `null` (the importer couldn't match the unit), or
+ *   - the id doesn't appear in the dataset (e.g. the roster was authored
+ *     against an older dataslate than the bundled one).
+ *
+ * Doesn't surface diagnostics — the caller already has them on the roster's
+ * own `diagnostics` field.
+ */
+export declare function resolveRosterUnit(rosterUnit: RosterUnit, dataset: Dataset): UnitView | undefined;
+/**
+ * Resolve every wargear entry on a roster unit to a {@link WeaponView},
+ * keeping each entry's count alongside. Unresolved entries are dropped
+ * silently (matching {@link resolveRosterUnit}). Useful when the SPA
+ * needs to enumerate firing options after the user picks a roster unit.
+ */
+export declare function resolveRosterWargear(wargear: RosterWargear[], dataset: Dataset): {
+    weapon: WeaponView;
+    count: number;
+}[];
+/**
+ * The roster's leader entry attached to `bodyguardUnitId`, if any. Import
+ * stores the inferred (always-provisional) attachment on the *leader's*
+ * {@link RosterUnit}, pointing down to its bodyguard via
+ * `leader_attachment.bodyguard_ref`. Selection UIs start from the body unit,
+ * so this scans for the leader whose `bodyguard_ref.id` matches. Returns
+ * `undefined` when no leader in the roster is attached to that unit (the
+ * common case — attachments are optional at game start).
+ */
+export declare function resolveAttachedLeader(roster: Roster, bodyguardUnitId: string): RosterUnit | undefined;
+/**
+ * Every roster unit attached to `unitId`, resolved from *either* end of the
+ * attachment. A leader+bodyguard are one combined unit, so a selection UI may
+ * start from either half:
+ *   - `unitId` is the **bodyguard** → the leader(s) whose
+ *     `leader_attachment.bodyguard_ref.id` points at it (body-first, the
+ *     {@link resolveAttachedLeader} direction), and
+ *   - `unitId` is the **leader** → the bodyguard its own `leader_attachment`
+ *     points to.
+ * Returns the partner {@link RosterUnit}s (deduped, source order). Empty when
+ * the unit has no attachment in this roster — the common case, since
+ * attachments are optional at game start. Shaped as a list to carry 11th
+ * edition's multi-member attachments without an API change.
+ */
+export declare function resolveAttachmentPartners(roster: Roster, unitId: string): RosterUnit[];
+//# sourceMappingURL=roster-resolve.d.ts.map

package/dist/data/roster-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-resolve.d.ts","sourceRoot":"","sources":["../../src/data/roster-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,GACf,QAAQ,GAAG,SAAS,CAItB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,OAAO,GACf;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAUzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GACtB,UAAU,GAAG,SAAS,CAIxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,UAAU,EAAE,CAkBd"}

package/dist/data/roster-resolve.js

@@ -0,0 +1,82 @@
+/**
+ * Resolve a roster's unit entry against the dataset, returning the linked
+ * {@link UnitView}. Returns `undefined` when:
+ *   - the roster's `ref.id` is `null` (the importer couldn't match the unit), or
+ *   - the id doesn't appear in the dataset (e.g. the roster was authored
+ *     against an older dataslate than the bundled one).
+ *
+ * Doesn't surface diagnostics — the caller already has them on the roster's
+ * own `diagnostics` field.
+ */
+export function resolveRosterUnit(rosterUnit, dataset) {
+    const id = rosterUnit.ref.id;
+    if (id === null)
+        return undefined;
+    return dataset.units.get(id);
+}
+/**
+ * Resolve every wargear entry on a roster unit to a {@link WeaponView},
+ * keeping each entry's count alongside. Unresolved entries are dropped
+ * silently (matching {@link resolveRosterUnit}). Useful when the SPA
+ * needs to enumerate firing options after the user picks a roster unit.
+ */
+export function resolveRosterWargear(wargear, dataset) {
+    const out = [];
+    for (const w of wargear) {
+        const id = w.ref.id;
+        if (id === null)
+            continue;
+        const weapon = dataset.weapons.get(id);
+        if (!weapon)
+            continue;
+        out.push({ weapon, count: w.count });
+    }
+    return out;
+}
+/**
+ * The roster's leader entry attached to `bodyguardUnitId`, if any. Import
+ * stores the inferred (always-provisional) attachment on the *leader's*
+ * {@link RosterUnit}, pointing down to its bodyguard via
+ * `leader_attachment.bodyguard_ref`. Selection UIs start from the body unit,
+ * so this scans for the leader whose `bodyguard_ref.id` matches. Returns
+ * `undefined` when no leader in the roster is attached to that unit (the
+ * common case — attachments are optional at game start).
+ */
+export function resolveAttachedLeader(roster, bodyguardUnitId) {
+    return roster.units.find((u) => u.leader_attachment?.bodyguard_ref.id === bodyguardUnitId);
+}
+/**
+ * Every roster unit attached to `unitId`, resolved from *either* end of the
+ * attachment. A leader+bodyguard are one combined unit, so a selection UI may
+ * start from either half:
+ *   - `unitId` is the **bodyguard** → the leader(s) whose
+ *     `leader_attachment.bodyguard_ref.id` points at it (body-first, the
+ *     {@link resolveAttachedLeader} direction), and
+ *   - `unitId` is the **leader** → the bodyguard its own `leader_attachment`
+ *     points to.
+ * Returns the partner {@link RosterUnit}s (deduped, source order). Empty when
+ * the unit has no attachment in this roster — the common case, since
+ * attachments are optional at game start. Shaped as a list to carry 11th
+ * edition's multi-member attachments without an API change.
+ */
+export function resolveAttachmentPartners(roster, unitId) {
+    const seen = new Set();
+    const out = [];
+    const add = (u) => {
+        if (!u || seen.has(u))
+            return;
+        seen.add(u);
+        out.push(u);
+    };
+    for (const u of roster.units) {
+        // Body-first: leaders pointing down at `unitId`.
+        if (u.leader_attachment?.bodyguard_ref.id === unitId)
+            add(u);
+        // Leader-first: `unitId`'s own entry points down at a bodyguard.
+        if (u.ref.id === unitId && u.leader_attachment) {
+            add(roster.units.find((b) => b.ref.id === u.leader_attachment.bodyguard_ref.id));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=roster-resolve.js.map

package/dist/data/roster-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster-resolve.js","sourceRoot":"","sources":["../../src/data/roster-resolve.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAsB,EACtB,OAAgB;IAEhB,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7B,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwB,EACxB,OAAgB;IAEhB,MAAM,GAAG,GAA4C,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,EAAE,KAAK,IAAI;YAAE,SAAS;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,eAAuB;IAEvB,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,KAAK,eAAe,CACjE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,GAAG,EAAc,CAAC;IACnC,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,CAAyB,EAAE,EAAE;QACxC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO;QAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,iDAAiD;QACjD,IAAI,CAAC,CAAC,iBAAiB,EAAE,aAAa,CAAC,EAAE,KAAK,MAAM;YAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,iEAAiE;QACjE,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC,iBAAiB,EAAE,CAAC;YAC/C,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,iBAAkB,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["/**\n * Bridge helpers between the importer's flat-data {@link Roster} types and\n * the linked {@link UnitView} the cruncher consumes. The importer ships\n * unit entries as plain interfaces (`RosterUnit` is data, not behaviour),\n * so the lookup is a free function rather than a method.\n *\n * @packageDocumentation\n */\nimport type { Roster, RosterUnit, RosterWargear } from \"../import/types.js\";\nimport type { Dataset } from \"./dataset.js\";\nimport type { UnitView, WeaponView } from \"./entities.js\";\n\n/**\n * Resolve a roster's unit entry against the dataset, returning the linked\n * {@link UnitView}. Returns `undefined` when:\n *   - the roster's `ref.id` is `null` (the importer couldn't match the unit), or\n *   - the id doesn't appear in the dataset (e.g. the roster was authored\n *     against an older dataslate than the bundled one).\n *\n * Doesn't surface diagnostics — the caller already has them on the roster's\n * own `diagnostics` field.\n */\nexport function resolveRosterUnit(\n  rosterUnit: RosterUnit,\n  dataset: Dataset,\n): UnitView | undefined {\n  const id = rosterUnit.ref.id;\n  if (id === null) return undefined;\n  return dataset.units.get(id);\n}\n\n/**\n * Resolve every wargear entry on a roster unit to a {@link WeaponView},\n * keeping each entry's count alongside. Unresolved entries are dropped\n * silently (matching {@link resolveRosterUnit}). Useful when the SPA\n * needs to enumerate firing options after the user picks a roster unit.\n */\nexport function resolveRosterWargear(\n  wargear: RosterWargear[],\n  dataset: Dataset,\n): { weapon: WeaponView; count: number }[] {\n  const out: { weapon: WeaponView; count: number }[] = [];\n  for (const w of wargear) {\n    const id = w.ref.id;\n    if (id === null) continue;\n    const weapon = dataset.weapons.get(id);\n    if (!weapon) continue;\n    out.push({ weapon, count: w.count });\n  }\n  return out;\n}\n\n/**\n * The roster's leader entry attached to `bodyguardUnitId`, if any. Import\n * stores the inferred (always-provisional) attachment on the *leader's*\n * {@link RosterUnit}, pointing down to its bodyguard via\n * `leader_attachment.bodyguard_ref`. Selection UIs start from the body unit,\n * so this scans for the leader whose `bodyguard_ref.id` matches. Returns\n * `undefined` when no leader in the roster is attached to that unit (the\n * common case — attachments are optional at game start).\n */\nexport function resolveAttachedLeader(\n  roster: Roster,\n  bodyguardUnitId: string,\n): RosterUnit | undefined {\n  return roster.units.find(\n    (u) => u.leader_attachment?.bodyguard_ref.id === bodyguardUnitId,\n  );\n}\n\n/**\n * Every roster unit attached to `unitId`, resolved from *either* end of the\n * attachment. A leader+bodyguard are one combined unit, so a selection UI may\n * start from either half:\n *   - `unitId` is the **bodyguard** → the leader(s) whose\n *     `leader_attachment.bodyguard_ref.id` points at it (body-first, the\n *     {@link resolveAttachedLeader} direction), and\n *   - `unitId` is the **leader** → the bodyguard its own `leader_attachment`\n *     points to.\n * Returns the partner {@link RosterUnit}s (deduped, source order). Empty when\n * the unit has no attachment in this roster — the common case, since\n * attachments are optional at game start. Shaped as a list to carry 11th\n * edition's multi-member attachments without an API change.\n */\nexport function resolveAttachmentPartners(\n  roster: Roster,\n  unitId: string,\n): RosterUnit[] {\n  const seen = new Set<RosterUnit>();\n  const out: RosterUnit[] = [];\n  const add = (u: RosterUnit | undefined) => {\n    if (!u || seen.has(u)) return;\n    seen.add(u);\n    out.push(u);\n  };\n\n  for (const u of roster.units) {\n    // Body-first: leaders pointing down at `unitId`.\n    if (u.leader_attachment?.bodyguard_ref.id === unitId) add(u);\n    // Leader-first: `unitId`'s own entry points down at a bodyguard.\n    if (u.ref.id === unitId && u.leader_attachment) {\n      add(roster.units.find((b) => b.ref.id === u.leader_attachment!.bodyguard_ref.id));\n    }\n  }\n  return out;\n}\n"]}

package/dist/data/types.d.ts

@@ -7,7 +7,7 @@
  *
  * @packageDocumentation
  */
-import type { AbilityDSLEntry, DeploymentPattern, Detachment, Enhancement, Faction, ForceDisposition, GameVersion, InteractionFlag, LeaderAttachment, Mission, MissionMatchup, PhaseMapping, ResourcePool, SecondaryCard, Stratagem, TimingFlag, Unit, UnitComposition, WargearOption, Weapon } from "../generated.js";
+import type { AbilityDSLEntry, DeploymentPattern, Detachment, Enhancement, Faction, ForceDisposition, GameVersion, InteractionFlag, LeaderAttachment, Mission, MissionMatchup, PhaseMapping, ResourcePool, SecondaryCard, Stratagem, TimingFlag, Unit, UnitComposition, WargearOption, Weapon, WeaponKeyword } from "../generated.js";
 /**
  * Every entity collection in the dataset, keyed by camelCase collection name.
  *
@@ -18,6 +18,8 @@ import type { AbilityDSLEntry, DeploymentPattern, Detachment, Enhancement, Facti
 export interface RawData {
     units: Unit[];
     weapons: Weapon[];
+    /** Catalog of weapon keywords (Lethal Hits, Sustained Hits N, Anti-X N+, ...). */
+    weaponKeywords: WeaponKeyword[];
     factions: Faction[];
     /** Community-authored ability mechanics (key is `ability_id`, not `id`). */
     abilities: AbilityDSLEntry[];
@@ -41,3 +43,4 @@ export interface RawData {
 }
 /** A `RawData` with every collection initialised to an empty array. */
 export declare function emptyRawData(): RawData;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,UAAU,EACV,IAAI,EACJ,eAAe,EACf,aAAa,EACb,MAAM,EACN,aAAa,EACd,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kFAAkF;IAClF,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,4EAA4E;IAC5E,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;IACxC,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC;AAED,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,OAAO,CAwBtC"}

package/dist/data/types.js

@@ -3,6 +3,7 @@ export function emptyRawData() {
     return {
         units: [],
         weapons: [],
+        weaponKeywords: [],
         factions: [],
         abilities: [],
         phaseMappings: [],
@@ -23,3 +24,4 @@ export function emptyRawData() {
         interactionFlags: [],
     };
 }
+//# sourceMappingURL=types.js.map

package/dist/data/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/data/types.ts"],"names":[],"mappings":"AAmEA,uEAAuE;AACvE,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;QACX,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,EAAE;QAChB,iBAAiB,EAAE,EAAE;QACrB,gBAAgB,EAAE,EAAE;QACpB,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,EAAE;QACnB,cAAc,EAAE,EAAE;QAClB,kBAAkB,EAAE,EAAE;QACtB,iBAAiB,EAAE,EAAE;QACrB,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,EAAE;KACrB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The shape of the embedded data bundle: one named array per entity collection.\n *\n * `RawData` is the boundary between the generated JSON-Schema types and the\n * linked view layer. The codegen ({@link file://../codegen-data.ts}) emits a\n * `RAW_DATA: RawData` constant; {@link Dataset} wraps it with linked accessors.\n *\n * @packageDocumentation\n */\nimport type {\n  AbilityDSLEntry,\n  DeploymentPattern,\n  Detachment,\n  Enhancement,\n  Faction,\n  ForceDisposition,\n  GameVersion,\n  InteractionFlag,\n  LeaderAttachment,\n  Mission,\n  MissionMatchup,\n  PhaseMapping,\n  ResourcePool,\n  SecondaryCard,\n  Stratagem,\n  TimingFlag,\n  Unit,\n  UnitComposition,\n  WargearOption,\n  Weapon,\n  WeaponKeyword,\n} from \"../generated.js\";\n\n/**\n * Every entity collection in the dataset, keyed by camelCase collection name.\n *\n * Collections with no authored data yet (e.g. `interactionFlags`) are present\n * as empty arrays so the API surface is stable and new data flows through\n * automatically once authored.\n */\nexport interface RawData {\n  units: Unit[];\n  weapons: Weapon[];\n  /** Catalog of weapon keywords (Lethal Hits, Sustained Hits N, Anti-X N+, ...). */\n  weaponKeywords: WeaponKeyword[];\n  factions: Faction[];\n  /** Community-authored ability mechanics (key is `ability_id`, not `id`). */\n  abilities: AbilityDSLEntry[];\n  /** Phase assignments, joined to abilities/stratagems/etc. via `source_id`. */\n  phaseMappings: PhaseMapping[];\n  detachments: Detachment[];\n  stratagems: Stratagem[];\n  enhancements: Enhancement[];\n  leaderAttachments: LeaderAttachment[];\n  unitCompositions: UnitComposition[];\n  wargearOptions: WargearOption[];\n  gameVersions: GameVersion[];\n  missions: Mission[];\n  missionMatchups: MissionMatchup[];\n  secondaryCards: SecondaryCard[];\n  deploymentPatterns: DeploymentPattern[];\n  forceDispositions: ForceDisposition[];\n  resourcePools: ResourcePool[];\n  timingFlags: TimingFlag[];\n  interactionFlags: InteractionFlag[];\n}\n\n/** A `RawData` with every collection initialised to an empty array. */\nexport function emptyRawData(): RawData {\n  return {\n    units: [],\n    weapons: [],\n    weaponKeywords: [],\n    factions: [],\n    abilities: [],\n    phaseMappings: [],\n    detachments: [],\n    stratagems: [],\n    enhancements: [],\n    leaderAttachments: [],\n    unitCompositions: [],\n    wargearOptions: [],\n    gameVersions: [],\n    missions: [],\n    missionMatchups: [],\n    secondaryCards: [],\n    deploymentPatterns: [],\n    forceDispositions: [],\n    resourcePools: [],\n    timingFlags: [],\n    interactionFlags: [],\n  };\n}\n"]}