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

package/dist/import/resolve.js

@@ -0,0 +1,190 @@
+import { normalizeName } from "../data/normalize.js";
+/** The dataset edition/dataslate stamped onto an imported roster. */
+const ROSTER_GAME_VERSION = { edition: "11th", dataslate: "pre-launch-provisional" };
+const MAX_CANDIDATES = 5;
+/** Accumulates warnings and resolved/unresolved tallies during an import. */
+class DiagnosticsBuilder {
+    resolved_units = 0;
+    unresolved_units = 0;
+    resolved_weapons = 0;
+    unresolved_weapons = 0;
+    warnings = [];
+    warn(code, message, raw_name = null) {
+        this.warnings.push({ code, message, raw_name });
+    }
+    build() {
+        return {
+            resolved_units: this.resolved_units,
+            unresolved_units: this.unresolved_units,
+            resolved_weapons: this.resolved_weapons,
+            unresolved_weapons: this.unresolved_weapons,
+            warnings: this.warnings,
+        };
+    }
+}
+function unresolved(raw_name, candidates = []) {
+    return { id: null, raw_name, resolved: false, candidates };
+}
+function resolved(id, raw_name) {
+    return { id, raw_name, resolved: true, candidates: [] };
+}
+function toCandidates(records) {
+    return records.slice(0, MAX_CANDIDATES).map((r) => ({ id: r.id, name: r.name }));
+}
+/** Map a source battle-size label to the 40kdc enum, if recognisable. */
+function mapBattleSize(raw) {
+    if (!raw)
+        return null;
+    const key = normalizeName(raw);
+    if (key.includes("strike force"))
+        return "strike-force";
+    if (key.includes("incursion"))
+        return "incursion";
+    return null;
+}
+export function resolve(parsed, ds, format = "listforge") {
+    const diag = new DiagnosticsBuilder();
+    if (parsed.multi_force) {
+        diag.warn("multi-force", "Source list contains more than one faction; the primary faction was used for scoping.");
+    }
+    // --- Faction (resolved first so other lookups can scope to it). -----------
+    let faction_id = null;
+    if (parsed.faction_raw_name) {
+        const hit = ds.factions.find(parsed.faction_raw_name);
+        if (hit) {
+            faction_id = hit.id;
+        }
+        else {
+            diag.warn("faction-unresolved", "Faction name did not match any 40kdc faction.", parsed.faction_raw_name);
+        }
+    }
+    // --- Detachment (scoped to faction, then global fallback). ----------------
+    let detachment_id = null;
+    if (parsed.detachment_raw_name) {
+        const key = normalizeName(parsed.detachment_raw_name);
+        const scoped = faction_id
+            ? ds.detachments.byFaction(faction_id).find((d) => normalizeName(d.name ?? "") === key)
+            : undefined;
+        const hit = scoped ?? ds.detachments.find(parsed.detachment_raw_name);
+        if (hit) {
+            detachment_id = hit.id;
+        }
+        else {
+            diag.warn("detachment-unresolved", "Detachment name did not match any 40kdc detachment.", parsed.detachment_raw_name);
+        }
+    }
+    // --- Battle size. ---------------------------------------------------------
+    const battle_size = mapBattleSize(parsed.battle_size_raw);
+    if (parsed.battle_size_raw && battle_size === null) {
+        diag.warn("battle-size-unmapped", "Battle size label could not be mapped.", parsed.battle_size_raw);
+    }
+    // --- Units (and their enhancements / wargear). ----------------------------
+    const units = parsed.units.map((u) => resolveUnit(u, faction_id, detachment_id, ds, diag));
+    // --- Leader attachments (second pass: needs all resolved unit ids). -------
+    inferLeaderAttachments(parsed.units, units, ds, diag);
+    // --- Points reconciliation (reported vs computed kept distinct). ----------
+    if (parsed.total_reported !== null && parsed.total_reported !== parsed.total_computed) {
+        diag.warn("points-mismatch", `Source-reported total (${parsed.total_reported}) differs from the sum of cost lines (${parsed.total_computed}).`);
+    }
+    return {
+        name: parsed.name,
+        source: { format, generated_by: parsed.generated_by },
+        faction_id,
+        detachment_id,
+        battle_size,
+        points: {
+            declared_limit: parsed.declared_limit,
+            total_reported: parsed.total_reported,
+            total_computed: parsed.total_computed,
+        },
+        units,
+        game_version: { ...ROSTER_GAME_VERSION },
+        diagnostics: diag.build(),
+    };
+}
+function resolveUnit(parsed, faction_id, detachment_id, ds, diag) {
+    // Prefer a faction-scoped match (the same unit id recurs across factions),
+    // then fall back to a global name lookup.
+    const key = normalizeName(parsed.raw_name);
+    const scoped = faction_id
+        ? ds.units.byFaction(faction_id).find((u) => normalizeName(u.name) === key)
+        : undefined;
+    const all = ds.units.findAll(parsed.raw_name);
+    const hit = scoped ?? all[0];
+    let ref;
+    if (hit) {
+        ref = resolved(hit.id, parsed.raw_name);
+        diag.resolved_units += 1;
+    }
+    else {
+        ref = unresolved(parsed.raw_name, toCandidates(all));
+        diag.unresolved_units += 1;
+        diag.warn("unit-unresolved", "Unit name did not match any 40kdc unit.", parsed.raw_name);
+    }
+    const enhancement = parsed.enhancement_raw_name
+        ? resolveEnhancement(parsed.enhancement_raw_name, detachment_id, ds, diag)
+        : null;
+    const enhancement_points = enhancement === null ? null : parsed.enhancement_points;
+    const wargear = parsed.wargear.map((w) => {
+        const hits = ds.weapons.findAll(w.raw_name);
+        if (hits[0]) {
+            diag.resolved_weapons += 1;
+            return { ref: resolved(hits[0].id, w.raw_name), count: w.count };
+        }
+        diag.unresolved_weapons += 1;
+        diag.warn("weapon-unresolved", "Weapon name did not match any 40kdc weapon.", w.raw_name);
+        return { ref: unresolved(w.raw_name, toCandidates(hits)), count: w.count };
+    });
+    return {
+        ref,
+        model_count: parsed.model_count,
+        points: parsed.points,
+        is_warlord: parsed.is_warlord,
+        enhancement,
+        enhancement_points,
+        wargear,
+        leader_attachment: null,
+    };
+}
+function resolveEnhancement(raw_name, detachment_id, ds, diag) {
+    const key = normalizeName(raw_name);
+    // Enhancements belong to a detachment, not a faction — scope by detachment_id.
+    const scoped = detachment_id
+        ? ds.enhancements.all.find((e) => e.detachment_id === detachment_id && normalizeName(e.name ?? "") === key)
+        : undefined;
+    const hit = scoped ?? ds.enhancements.find(raw_name);
+    if (hit) {
+        return resolved(hit.id, raw_name);
+    }
+    diag.warn("enhancement-unresolved", "Enhancement name did not match any 40kdc enhancement.", raw_name);
+    return unresolved(raw_name, toCandidates(ds.enhancements.findAll(raw_name)));
+}
+/**
+ * Infer leader→bodyguard attachments. The source format does not encode an
+ * unambiguous attachment, so each inferred link is marked provisional: we match
+ * a resolved character unit against a resolved non-character unit in the same
+ * roster using the dataset's leader-attachment data.
+ */
+function inferLeaderAttachments(parsedUnits, units, ds, diag) {
+    const bodyguardIds = new Set(units.filter((u, i) => u.ref.id && !parsedUnits[i].is_character).map((u) => u.ref.id));
+    units.forEach((unit, i) => {
+        if (!unit.ref.id || !parsedUnits[i].is_character)
+            return;
+        const leaderId = unit.ref.id;
+        const attachment = ds.leaderAttachments.find((la) => la.leader_id === leaderId);
+        if (!attachment)
+            return;
+        const bodyguardId = attachment.eligible_bodyguard_ids.find((id) => bodyguardIds.has(id));
+        if (!bodyguardId)
+            return;
+        const bodyguard = units.find((u) => u.ref.id === bodyguardId);
+        if (!bodyguard)
+            return;
+        unit.leader_attachment = {
+            bodyguard_ref: resolved(bodyguardId, bodyguard.ref.raw_name),
+            provisional: true,
+        };
+        diag.warn("leader-attachment-inferred", "Leader attachment was inferred from leader-attachment data and is provisional.", unit.ref.raw_name);
+    });
+}
+//# sourceMappingURL=resolve.js.map

package/dist/import/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/import/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resolve a {@link ParsedRoster} onto 40kdc entity ids, producing a {@link Roster}.\n *\n * Resolution is lenient: a name that doesn't match a 40kdc entity yields a\n * {@link ResolvedRef} with `id: null`, `resolved: false`, and up to five\n * candidate suggestions — the roster is never dropped or rejected. Everything\n * that didn't resolve cleanly is summarised in the {@link Diagnostics} block.\n *\n * Matching reuses the dataset's own lookups ({@link Collection.find},\n * {@link Collection.findAll}, {@link Collection.byFaction}) and\n * {@link normalizeName}; there is no bespoke fuzzy matcher. Faction is resolved\n * first so unit/detachment/enhancement lookups can be scoped to it — the same\n * unit id can appear under several factions, so scoping disambiguates.\n *\n * @packageDocumentation\n */\nimport type { Dataset } from \"../data/dataset.js\";\nimport { normalizeName } from \"../data/normalize.js\";\nimport type {\n  BattleSize,\n  Candidate,\n  Diagnostics,\n  ParsedRoster,\n  ParsedUnit,\n  ResolvedRef,\n  Roster,\n  RosterFormat,\n  RosterUnit,\n  Warning,\n  WarningCode,\n} from \"./types.js\";\n\n/** The dataset edition/dataslate stamped onto an imported roster. */\nconst ROSTER_GAME_VERSION = { edition: \"11th\", dataslate: \"pre-launch-provisional\" };\n\nconst MAX_CANDIDATES = 5;\n\ninterface NamedRecord {\n  id: string;\n  name: string;\n}\n\n/** Accumulates warnings and resolved/unresolved tallies during an import. */\nclass DiagnosticsBuilder {\n  resolved_units = 0;\n  unresolved_units = 0;\n  resolved_weapons = 0;\n  unresolved_weapons = 0;\n  readonly warnings: Warning[] = [];\n\n  warn(code: WarningCode, message: string, raw_name: string | null = null): void {\n    this.warnings.push({ code, message, raw_name });\n  }\n\n  build(): Diagnostics {\n    return {\n      resolved_units: this.resolved_units,\n      unresolved_units: this.unresolved_units,\n      resolved_weapons: this.resolved_weapons,\n      unresolved_weapons: this.unresolved_weapons,\n      warnings: this.warnings,\n    };\n  }\n}\n\nfunction unresolved(raw_name: string, candidates: Candidate[] = []): ResolvedRef {\n  return { id: null, raw_name, resolved: false, candidates };\n}\n\nfunction resolved(id: string, raw_name: string): ResolvedRef {\n  return { id, raw_name, resolved: true, candidates: [] };\n}\n\nfunction toCandidates(records: readonly NamedRecord[]): Candidate[] {\n  return records.slice(0, MAX_CANDIDATES).map((r) => ({ id: r.id, name: r.name }));\n}\n\n/** Map a source battle-size label to the 40kdc enum, if recognisable. */\nfunction mapBattleSize(raw: string | null): BattleSize | null {\n  if (!raw) return null;\n  const key = normalizeName(raw);\n  if (key.includes(\"strike force\")) return \"strike-force\";\n  if (key.includes(\"incursion\")) return \"incursion\";\n  return null;\n}\n\nexport function resolve(\n  parsed: ParsedRoster,\n  ds: Dataset,\n  format: RosterFormat = \"listforge\",\n): Roster {\n  const diag = new DiagnosticsBuilder();\n\n  if (parsed.multi_force) {\n    diag.warn(\n      \"multi-force\",\n      \"Source list contains more than one faction; the primary faction was used for scoping.\",\n    );\n  }\n\n  // --- Faction (resolved first so other lookups can scope to it). -----------\n  let faction_id: string | null = null;\n  if (parsed.faction_raw_name) {\n    const hit = ds.factions.find(parsed.faction_raw_name);\n    if (hit) {\n      faction_id = hit.id;\n    } else {\n      diag.warn(\"faction-unresolved\", \"Faction name did not match any 40kdc faction.\", parsed.faction_raw_name);\n    }\n  }\n\n  // --- Detachment (scoped to faction, then global fallback). ----------------\n  let detachment_id: string | null = null;\n  if (parsed.detachment_raw_name) {\n    const key = normalizeName(parsed.detachment_raw_name);\n    const scoped = faction_id\n      ? ds.detachments.byFaction(faction_id).find((d) => normalizeName(d.name ?? \"\") === key)\n      : undefined;\n    const hit = scoped ?? ds.detachments.find(parsed.detachment_raw_name);\n    if (hit) {\n      detachment_id = hit.id;\n    } else {\n      diag.warn(\"detachment-unresolved\", \"Detachment name did not match any 40kdc detachment.\", parsed.detachment_raw_name);\n    }\n  }\n\n  // --- Battle size. ---------------------------------------------------------\n  const battle_size = mapBattleSize(parsed.battle_size_raw);\n  if (parsed.battle_size_raw && battle_size === null) {\n    diag.warn(\"battle-size-unmapped\", \"Battle size label could not be mapped.\", parsed.battle_size_raw);\n  }\n\n  // --- Units (and their enhancements / wargear). ----------------------------\n  const units = parsed.units.map((u) => resolveUnit(u, faction_id, detachment_id, ds, diag));\n\n  // --- Leader attachments (second pass: needs all resolved unit ids). -------\n  inferLeaderAttachments(parsed.units, units, ds, diag);\n\n  // --- Points reconciliation (reported vs computed kept distinct). ----------\n  if (parsed.total_reported !== null && parsed.total_reported !== parsed.total_computed) {\n    diag.warn(\n      \"points-mismatch\",\n      `Source-reported total (${parsed.total_reported}) differs from the sum of cost lines (${parsed.total_computed}).`,\n    );\n  }\n\n  return {\n    name: parsed.name,\n    source: { format, generated_by: parsed.generated_by },\n    faction_id,\n    detachment_id,\n    battle_size,\n    points: {\n      declared_limit: parsed.declared_limit,\n      total_reported: parsed.total_reported,\n      total_computed: parsed.total_computed,\n    },\n    units,\n    game_version: { ...ROSTER_GAME_VERSION },\n    diagnostics: diag.build(),\n  };\n}\n\nfunction resolveUnit(\n  parsed: ParsedUnit,\n  faction_id: string | null,\n  detachment_id: string | null,\n  ds: Dataset,\n  diag: DiagnosticsBuilder,\n): RosterUnit {\n  // Prefer a faction-scoped match (the same unit id recurs across factions),\n  // then fall back to a global name lookup.\n  const key = normalizeName(parsed.raw_name);\n  const scoped = faction_id\n    ? ds.units.byFaction(faction_id).find((u) => normalizeName(u.name) === key)\n    : undefined;\n  const all = ds.units.findAll(parsed.raw_name);\n  const hit = scoped ?? all[0];\n\n  let ref: ResolvedRef;\n  if (hit) {\n    ref = resolved(hit.id, parsed.raw_name);\n    diag.resolved_units += 1;\n  } else {\n    ref = unresolved(parsed.raw_name, toCandidates(all));\n    diag.unresolved_units += 1;\n    diag.warn(\"unit-unresolved\", \"Unit name did not match any 40kdc unit.\", parsed.raw_name);\n  }\n\n  const enhancement = parsed.enhancement_raw_name\n    ? resolveEnhancement(parsed.enhancement_raw_name, detachment_id, ds, diag)\n    : null;\n  const enhancement_points = enhancement === null ? null : parsed.enhancement_points;\n\n  const wargear = parsed.wargear.map((w) => {\n    const hits = ds.weapons.findAll(w.raw_name);\n    if (hits[0]) {\n      diag.resolved_weapons += 1;\n      return { ref: resolved(hits[0].id, w.raw_name), count: w.count };\n    }\n    diag.unresolved_weapons += 1;\n    diag.warn(\"weapon-unresolved\", \"Weapon name did not match any 40kdc weapon.\", w.raw_name);\n    return { ref: unresolved(w.raw_name, toCandidates(hits)), count: w.count };\n  });\n\n  return {\n    ref,\n    model_count: parsed.model_count,\n    points: parsed.points,\n    is_warlord: parsed.is_warlord,\n    enhancement,\n    enhancement_points,\n    wargear,\n    leader_attachment: null,\n  };\n}\n\nfunction resolveEnhancement(\n  raw_name: string,\n  detachment_id: string | null,\n  ds: Dataset,\n  diag: DiagnosticsBuilder,\n): ResolvedRef {\n  const key = normalizeName(raw_name);\n  // Enhancements belong to a detachment, not a faction — scope by detachment_id.\n  const scoped = detachment_id\n    ? ds.enhancements.all.find((e) => e.detachment_id === detachment_id && normalizeName(e.name ?? \"\") === key)\n    : undefined;\n  const hit = scoped ?? ds.enhancements.find(raw_name);\n  if (hit) {\n    return resolved(hit.id, raw_name);\n  }\n  diag.warn(\"enhancement-unresolved\", \"Enhancement name did not match any 40kdc enhancement.\", raw_name);\n  return unresolved(raw_name, toCandidates(ds.enhancements.findAll(raw_name) as NamedRecord[]));\n}\n\n/**\n * Infer leader→bodyguard attachments. The source format does not encode an\n * unambiguous attachment, so each inferred link is marked provisional: we match\n * a resolved character unit against a resolved non-character unit in the same\n * roster using the dataset's leader-attachment data.\n */\nfunction inferLeaderAttachments(\n  parsedUnits: ParsedUnit[],\n  units: RosterUnit[],\n  ds: Dataset,\n  diag: DiagnosticsBuilder,\n): void {\n  const bodyguardIds = new Set(\n    units.filter((u, i) => u.ref.id && !parsedUnits[i].is_character).map((u) => u.ref.id as string),\n  );\n\n  units.forEach((unit, i) => {\n    if (!unit.ref.id || !parsedUnits[i].is_character) return;\n    const leaderId = unit.ref.id;\n    const attachment = ds.leaderAttachments.find((la) => la.leader_id === leaderId);\n    if (!attachment) return;\n    const bodyguardId = attachment.eligible_bodyguard_ids.find((id) => bodyguardIds.has(id));\n    if (!bodyguardId) return;\n\n    const bodyguard = units.find((u) => u.ref.id === bodyguardId);\n    if (!bodyguard) return;\n\n    unit.leader_attachment = {\n      bodyguard_ref: resolved(bodyguardId, bodyguard.ref.raw_name),\n      provisional: true,\n    };\n    diag.warn(\n      \"leader-attachment-inferred\",\n      \"Leader attachment was inferred from leader-attachment data and is provisional.\",\n      unit.ref.raw_name,\n    );\n  });\n}\n"]}

package/dist/import/types.d.ts

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

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

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

package/dist/import/types.js

@@ -0,0 +1,20 @@
+/**
+ * Types for the army-list importer.
+ *
+ * Two layers live here:
+ * - The **output** types ({@link Roster} and friends) mirror
+ *   `schemas/core/roster.schema.json` field-for-field. They are hand-authored
+ *   rather than generated so importer work isn't gated on the Rust→typify codegen
+ *   round-trip; the AJV validator (against the real schema) is the source of truth
+ *   for conformance.
+ * - The **intermediate** type ({@link ParsedRoster}) is format-agnostic: a parser
+ *   adapter lowers a source payload to this shape (raw names + counts only, no
+ *   resolved ids), and {@link resolve} turns it into a {@link Roster}.
+ *
+ * Nothing here ever carries reproduced rules or ability text — only permitted
+ * facts (names, counts, points, keywords, entity ids).
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/import/types.js.map

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

package/dist/index.d.ts

@@ -1,3 +1,9 @@
 export * from "./data/index.js";
 export * from "./generated.js";
 export { createValidator, findSchemaFiles, listSchemaIds, SCHEMAS_ROOT, } from "./schema-loader.js";
+export { importListForge, importNewRecruit, importRoster, decodeListForge, } from "./import/index.js";
+export { exportRoster, newRecruitJsonSerializer, newRecruitSimpleSerializer, newRecruitWtcCompactSerializer, newRecruitWtcFullSerializer, rosterJsonSerializer, } from "./export/index.js";
+export type { ExportFormat, RosterSerializer } from "./export/index.js";
+export type { FormatAdapter } from "./import/index.js";
+export type { ImportOptions, Roster, RosterUnit, RosterWargear, RosterSource, RosterFormat, RosterPoints, RosterLeaderAttachment, ResolvedRef, Candidate, Diagnostics, Warning, WarningCode, ParsedRoster, ParsedUnit, ParsedWargear, } from "./import/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,gBAAgB,CAAC;AAI/B,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,aAAa,EACb,MAAM,EACN,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,WAAW,EACX,SAAS,EACT,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -5,3 +5,10 @@ export * from "./generated.js";
 // Schema access + AJV validation (secondary: this package also validates data
 // against the canonical JSON Schemas).
 export { createValidator, findSchemaFiles, listSchemaIds, SCHEMAS_ROOT, } from "./schema-loader.js";
+// Army-list importer (ListForge → resolved 40kdc roster). Types are curated
+// rather than re-exported wholesale to avoid name clashes with generated types
+// (e.g. BattleSize, LeaderAttachment).
+export { importListForge, importNewRecruit, importRoster, decodeListForge, } from "./import/index.js";
+// Army-list exporter (Roster → text or JSON for any of the supported formats).
+export { exportRoster, newRecruitJsonSerializer, newRecruitSimpleSerializer, newRecruitWtcCompactSerializer, newRecruitWtcFullSerializer, rosterJsonSerializer, } from "./export/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,cAAc,iBAAiB,CAAC;AAEhC,mDAAmD;AACnD,cAAc,gBAAgB,CAAC;AAE/B,8EAA8E;AAC9E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,eAAe,EACf,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,4EAA4E;AAC5E,+EAA+E;AAC/E,uCAAuC;AACvC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,+EAA+E;AAC/E,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC","sourcesContent":["// The linked, typed dataset — the primary entry point.\nexport * from \"./data/index.js\";\n\n// Generated types for every entity in the dataset.\nexport * from \"./generated.js\";\n\n// Schema access + AJV validation (secondary: this package also validates data\n// against the canonical JSON Schemas).\nexport {\n  createValidator,\n  findSchemaFiles,\n  listSchemaIds,\n  SCHEMAS_ROOT,\n} from \"./schema-loader.js\";\n\n// Army-list importer (ListForge → resolved 40kdc roster). Types are curated\n// rather than re-exported wholesale to avoid name clashes with generated types\n// (e.g. BattleSize, LeaderAttachment).\nexport {\n  importListForge,\n  importNewRecruit,\n  importRoster,\n  decodeListForge,\n} from \"./import/index.js\";\n\n// Army-list exporter (Roster → text or JSON for any of the supported formats).\nexport {\n  exportRoster,\n  newRecruitJsonSerializer,\n  newRecruitSimpleSerializer,\n  newRecruitWtcCompactSerializer,\n  newRecruitWtcFullSerializer,\n  rosterJsonSerializer,\n} from \"./export/index.js\";\nexport type { ExportFormat, RosterSerializer } from \"./export/index.js\";\nexport type { FormatAdapter } from \"./import/index.js\";\nexport type {\n  ImportOptions,\n  Roster,\n  RosterUnit,\n  RosterWargear,\n  RosterSource,\n  RosterFormat,\n  RosterPoints,\n  RosterLeaderAttachment,\n  ResolvedRef,\n  Candidate,\n  Diagnostics,\n  Warning,\n  WarningCode,\n  ParsedRoster,\n  ParsedUnit,\n  ParsedWargear,\n} from \"./import/index.js\";\n"]}

package/dist/known-support-10e.d.ts

@@ -29,3 +29,4 @@
 export declare const KNOWN_SUPPORT_10E: Record<string, readonly string[]>;
 /** Flatten the registry to faction-prefixed ids for set membership tests. */
 export declare function knownSupportSet(): Set<string>;
+//# sourceMappingURL=known-support-10e.d.ts.map

package/dist/known-support-10e.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-support-10e.d.ts","sourceRoot":"","sources":["../src/known-support-10e.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AA0FH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAiB,CAAC;AAElF,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,CAM7C"}

package/dist/known-support-10e.js

@@ -111,3 +111,4 @@ export function knownSupportSet() {
     }
     return set;
 }
+//# sourceMappingURL=known-support-10e.js.map

package/dist/known-support-10e.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"known-support-10e.js","sourceRoot":"","sources":["../src/known-support-10e.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Canonical registry of 10e units carrying the \"additional leader\" / \"second\n * leader\" attachment rule — characters that can attach to a unit even when\n * another Leader (e.g. Captain, Chapter Master, Lieutenant) is already\n * attached. In 11e this is formalised as `attachment_role: \"support\"`.\n *\n * The registry has two layers:\n *\n *   1. **`FROM_UPSTREAM_SCRAPE`** — derived deterministically from army-assist\n *      `Datasheets.json` by scanning `leader_head` for the canonical phrasing\n *      (/already been attached|additional leader|attach this model.*even if/i)\n *      and resolving each datasheet name to our kebab-case unit id via the\n *      10e-archive's `data/core/<faction>/units.json` name table.\n *      shadowboxing's `assets/Datasheets.json` yields the same 40 names.\n *\n *   2. **`MANUAL_OVERLAY`** — units whose 10e \"additional leader\" rule is\n *      *not* captured by either upstream scraper (data-gap entries) plus\n *      non-character special cases. Each entry needs a one-line comment\n *      naming the SME source so the gap is auditable. This layer is the\n *      reason 40kdc-data exists as a canonical upstream.\n *\n * The exported `KNOWN_SUPPORT_10E` is the merged view. To refresh layer 1,\n * re-run the scan recipe documented above. To add a missing unit (layer 2),\n * edit `MANUAL_OVERLAY` with a comment justifying the entry.\n *\n * Treat every entry as a **proposal** until human review confirms. The port\n * emits a warning if a registry entry doesn't match an archive unit.\n */\n\n/** Layer 1 — derived from army-assist (and confirmed against shadowboxing). */\nconst FROM_UPSTREAM_SCRAPE: Record<string, readonly string[]> = {\n  \"adepta-sororitas\": [\"dialogus\", \"dogmata\", \"hospitaller\", \"imagifier\", \"ministorum-priest\"],\n\n  // Successor chapters share these units via `parent_faction_id`, so\n  // chapter-specific variants like `crusade-ancient` (Black Templars) live\n  // under adeptus-astartes.\n  \"adeptus-astartes\": [\n    \"ancient\",\n    \"ancient-in-terminator-armour\",\n    \"apothecary\",\n    \"apothecary-biologis\",\n    \"bladeguard-ancient\",\n    \"castellan\",\n    \"cato-sicarius\",\n    \"crusade-ancient\",\n    \"imperial-space-marine\",\n    \"lieutenant\",\n    \"lieutenant-in-phobos-armour\",\n    \"lieutenant-in-reiver-armour\",\n    \"sanguinary-priest\",\n  ],\n\n  \"adeptus-mechanicus\": [\"cybernetica-datasmith\"],\n\n  \"aeldari\": [\"eldrad-ulthran\", \"the-visarch\", \"warlock\"],\n\n  \"agents-of-the-imperium\": [\"ministorum-priest\"],\n\n  \"astra-militarum\": [\"death-rider-commissar\", \"ministorum-priest\"],\n\n  \"chaos-space-marines\": [\"master-of-executions\"],\n\n  \"death-guard\": [\n    \"biologus-putrifier\",\n    \"foul-blightspawn\",\n    \"icon-bearer\",\n    \"noxious-blightbringer\",\n    \"plague-surgeon\",\n    \"tallyman\",\n  ],\n\n  \"genestealer-cults\": [\"biophagus\", \"clamavus\", \"locus\", \"nexos\"],\n\n  \"necrons\": [\n    \"chronomancer\",\n    \"geomancer\",\n    \"orikan-the-diviner\",\n    \"plasmancer\",\n    \"psychomancer\",\n    \"technomancer\",\n  ],\n\n  \"world-eaters\": [\"master-of-executions\"],\n};\n\n/** Layer 2 — units the upstream scrape misses, plus non-character special cases. */\nconst MANUAL_OVERLAY: Record<string, readonly string[]> = {\n  // All three Kroot Shapers carry the additional-leader rule in the GW\n  // datasheet, but their `leader_head` in both army-assist and shadowboxing\n  // contains only the basic attachment list — the co-attach phrasing was\n  // dropped by both community scrapes. (Ethereal is *not* a co-attach Leader;\n  // confirmed not missing from the scrape.)\n  \"tau-empire\": [\"kroot-flesh-shaper\", \"kroot-trail-shaper\", \"kroot-war-shaper\"],\n\n  // Cryptothralls is a non-character bodyguard unit that joins a Cryptek-led\n  // unit. In 10e the co-attach Leader rule sits on the Cryptek datasheets\n  // (covered by layer 1); cryptothralls is included here for the 11e\n  // Support-pattern review since it's the \"joiner\" entity. May need a\n  // non-character Support encoding in 11e (`attachment_role` semantically\n  // expects a character).\n  \"necrons\": [\"cryptothralls\"],\n};\n\n/** Merge layers 1 and 2 into the public registry. */\nfunction mergeLayers(): Record<string, readonly string[]> {\n  const merged: Record<string, string[]> = {};\n  for (const [faction, ids] of Object.entries(FROM_UPSTREAM_SCRAPE)) {\n    merged[faction] = [...ids];\n  }\n  for (const [faction, ids] of Object.entries(MANUAL_OVERLAY)) {\n    merged[faction] = [...(merged[faction] ?? []), ...ids];\n  }\n  // Sort each list so output order is stable across re-runs.\n  for (const faction of Object.keys(merged)) merged[faction].sort();\n  return merged;\n}\n\nexport const KNOWN_SUPPORT_10E: Record<string, readonly string[]> = mergeLayers();\n\n/** Flatten the registry to faction-prefixed ids for set membership tests. */\nexport function knownSupportSet(): Set<string> {\n  const set = new Set<string>();\n  for (const [faction, ids] of Object.entries(KNOWN_SUPPORT_10E)) {\n    for (const id of ids) set.add(`${faction}:${id}`);\n  }\n  return set;\n}\n"]}

package/dist/link-abilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reverse-link enrichment ability `unit_ids` arrays into each unit's
+ * `ability_ids` in core data.
+ *
+ * Each `data/enrichment/<faction>/abilities.json` entry carries a
+ * `unit_ids` array naming the units that ability applies to. This script
+ * inverts that into `data/core/<faction>/units.json[*].ability_ids`.
+ *
+ * Additionally layers in `leader-attachments.json` — every `leader_id`
+ * gains the `"leader"` core ability.
+ *
+ * Idempotent and additive: existing `ability_ids` are preserved so
+ * manually-curated links (e.g. core abilities like "deep-strike",
+ * "deadly-demise-d3" not reachable via the enrichment unit_ids path)
+ * survive re-runs.
+ *
+ * Cross-faction routing: each `(unit_id, ability_id)` pair is bucketed
+ * to whichever `data/core/<faction>/units.json` actually contains that
+ * `unit_id` — so subfaction enrichment files contribute to the
+ * appropriate shared core file (e.g. Blood Angels enrichment routes
+ * into `adeptus-astartes/units.json`).
+ *
+ * Usage:
+ *   npx tsx tools/src/link-abilities.ts                  # all factions
+ *   npx tsx tools/src/link-abilities.ts --faction orks   # one faction
+ *   npx tsx tools/src/link-abilities.ts --dry-run        # report only
+ */
+export interface LinkOptions {
+    rootDir?: string;
+    factionFilter?: string;
+    dryRun?: boolean;
+}
+export interface LinkSummary {
+    factionsScanned: number;
+    unitsChanged: number;
+    abilityLinksAdded: number;
+    unknownUnitIdReferences: string[];
+    filesWritten: string[];
+}
+export declare function linkAbilities(opts?: LinkOptions): LinkSummary;
+//# sourceMappingURL=link-abilities.d.ts.map

package/dist/link-abilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-abilities.d.ts","sourceRoot":"","sources":["../src/link-abilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAwBH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAkBD,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAgB,GAAG,WAAW,CAsFjE"}