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

package/dist/integrity.js

@@ -0,0 +1,120 @@
+import { readFileSync } from "node:fs";
+import { glob } from "glob";
+import { resolve, basename, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+const DATA_ROOT = resolve(__dirname, "../../data");
+/**
+ * Factions whose units carry exactly one bare legion/faction faction_keyword.
+ *
+ * These are the shared-datasheet factions where contamination has been observed:
+ * a unit materialized from a parent template keeps the parent's faction keyword
+ * (e.g. a World Eaters Chaos Rhino left carrying `Emperor's Children`, or a Chaos
+ * Space Marines unit carrying the full multi-legion union line). For a faction in
+ * this map, every unit's `faction_keywords` must be a subset of `{home}`.
+ *
+ * Factions absent from this map (e.g. Space Marine chapters, which legitimately
+ * carry several faction_keywords) are not subject to the membership check, so the
+ * guard never produces a false positive on them. Extend this map as other
+ * single-token factions adopt the convention.
+ */
+export const FACTION_HOME_KEYWORD = {
+    "chaos-space-marines": "Heretic Astartes",
+    "world-eaters": "World Eaters",
+    "death-guard": "Death Guard",
+    "thousand-sons": "Thousand Sons",
+    "emperors-children": "Emperor’s Children",
+};
+function readArray(file) {
+    return JSON.parse(readFileSync(file, "utf-8"));
+}
+function loadAbilityIds(file, into) {
+    try {
+        for (const a of readArray(file)) {
+            if (a.ability_id)
+                into.add(a.ability_id);
+        }
+    }
+    catch {
+        // file absent — faction has no enrichment abilities, or no shared core pool
+    }
+}
+/**
+ * Cross-entity referential integrity that per-file JSON Schema validation cannot
+ * express:
+ *
+ *  - every unit `ability_id` must resolve to an ability defined in that faction's
+ *    `enrichment/<faction>/abilities.json` (or the shared `enrichment/_core` pool).
+ *    Same-faction scoping is deliberate — a union check would pass shared-unit
+ *    contaminants because they happen to be defined in some *other* faction's
+ *    enrichment.
+ *  - every unit `faction_keywords` entry must be permitted for the unit's faction
+ *    (see {@link FACTION_HOME_KEYWORD}).
+ *
+ * Results reuse {@link ValidationResult} so the CLI reporter can render them.
+ */
+export async function checkReferentialIntegrity(dataRoot) {
+    const root = dataRoot ?? DATA_ROOT;
+    const result = {
+        totalFiles: 0,
+        totalItems: 0,
+        passed: 0,
+        failed: 0,
+        errors: [],
+    };
+    // Shared core ability pool, available to every faction (optional).
+    const coreAbilities = new Set();
+    loadAbilityIds(resolve(root, "enrichment/_core/abilities.json"), coreAbilities);
+    const unitFiles = await glob("core/*/units.json", { cwd: root, absolute: true });
+    unitFiles.sort();
+    for (const file of unitFiles) {
+        const faction = basename(dirname(file));
+        if (faction.startsWith("_"))
+            continue; // scratch/example/report dirs
+        let units;
+        try {
+            units = readArray(file);
+        }
+        catch {
+            continue; // structural problems are the AJV pass's job
+        }
+        if (!Array.isArray(units))
+            continue;
+        const defined = new Set(coreAbilities);
+        loadAbilityIds(resolve(root, `enrichment/${faction}/abilities.json`), defined);
+        const home = FACTION_HOME_KEYWORD[faction];
+        result.totalFiles++;
+        for (let i = 0; i < units.length; i++) {
+            const u = units[i];
+            result.totalItems++;
+            const errs = [];
+            for (const aid of u.ability_ids ?? []) {
+                if (!defined.has(aid)) {
+                    errs.push({
+                        path: `/${i}/ability_ids`,
+                        message: `unit "${u.id}": ability_id "${aid}" is not defined in ${faction} enrichment`,
+                    });
+                }
+            }
+            if (home !== undefined) {
+                for (const fk of u.faction_keywords ?? []) {
+                    if (fk !== home) {
+                        errs.push({
+                            path: `/${i}/faction_keywords`,
+                            message: `unit "${u.id}": faction_keyword "${fk}" is not permitted for ${faction} (expected only "${home}")`,
+                        });
+                    }
+                }
+            }
+            if (errs.length > 0) {
+                result.failed++;
+                result.errors.push({ file, index: i, errors: errs });
+            }
+            else {
+                result.passed++;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=integrity.js.map

package/dist/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../src/integrity.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { glob } from \"glob\";\nimport { resolve, basename, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { ValidationResult } from \"./validate.js\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\n/**\n * Factions whose units carry exactly one bare legion/faction faction_keyword.\n *\n * These are the shared-datasheet factions where contamination has been observed:\n * a unit materialized from a parent template keeps the parent's faction keyword\n * (e.g. a World Eaters Chaos Rhino left carrying `Emperor's Children`, or a Chaos\n * Space Marines unit carrying the full multi-legion union line). For a faction in\n * this map, every unit's `faction_keywords` must be a subset of `{home}`.\n *\n * Factions absent from this map (e.g. Space Marine chapters, which legitimately\n * carry several faction_keywords) are not subject to the membership check, so the\n * guard never produces a false positive on them. Extend this map as other\n * single-token factions adopt the convention.\n */\nexport const FACTION_HOME_KEYWORD: Record<string, string> = {\n  \"chaos-space-marines\": \"Heretic Astartes\",\n  \"world-eaters\": \"World Eaters\",\n  \"death-guard\": \"Death Guard\",\n  \"thousand-sons\": \"Thousand Sons\",\n  \"emperors-children\": \"Emperor’s Children\",\n};\n\ninterface UnitLike {\n  id?: string;\n  ability_ids?: string[];\n  faction_keywords?: string[];\n}\ninterface AbilityLike {\n  ability_id?: string;\n}\n\nfunction readArray<T>(file: string): T[] {\n  return JSON.parse(readFileSync(file, \"utf-8\")) as T[];\n}\n\nfunction loadAbilityIds(file: string, into: Set<string>): void {\n  try {\n    for (const a of readArray<AbilityLike>(file)) {\n      if (a.ability_id) into.add(a.ability_id);\n    }\n  } catch {\n    // file absent — faction has no enrichment abilities, or no shared core pool\n  }\n}\n\n/**\n * Cross-entity referential integrity that per-file JSON Schema validation cannot\n * express:\n *\n *  - every unit `ability_id` must resolve to an ability defined in that faction's\n *    `enrichment/<faction>/abilities.json` (or the shared `enrichment/_core` pool).\n *    Same-faction scoping is deliberate — a union check would pass shared-unit\n *    contaminants because they happen to be defined in some *other* faction's\n *    enrichment.\n *  - every unit `faction_keywords` entry must be permitted for the unit's faction\n *    (see {@link FACTION_HOME_KEYWORD}).\n *\n * Results reuse {@link ValidationResult} so the CLI reporter can render them.\n */\nexport async function checkReferentialIntegrity(dataRoot?: string): Promise<ValidationResult> {\n  const root = dataRoot ?? DATA_ROOT;\n  const result: ValidationResult = {\n    totalFiles: 0,\n    totalItems: 0,\n    passed: 0,\n    failed: 0,\n    errors: [],\n  };\n\n  // Shared core ability pool, available to every faction (optional).\n  const coreAbilities = new Set<string>();\n  loadAbilityIds(resolve(root, \"enrichment/_core/abilities.json\"), coreAbilities);\n\n  const unitFiles = await glob(\"core/*/units.json\", { cwd: root, absolute: true });\n  unitFiles.sort();\n\n  for (const file of unitFiles) {\n    const faction = basename(dirname(file));\n    if (faction.startsWith(\"_\")) continue; // scratch/example/report dirs\n\n    let units: UnitLike[];\n    try {\n      units = readArray<UnitLike>(file);\n    } catch {\n      continue; // structural problems are the AJV pass's job\n    }\n    if (!Array.isArray(units)) continue;\n\n    const defined = new Set<string>(coreAbilities);\n    loadAbilityIds(resolve(root, `enrichment/${faction}/abilities.json`), defined);\n    const home = FACTION_HOME_KEYWORD[faction];\n\n    result.totalFiles++;\n    for (let i = 0; i < units.length; i++) {\n      const u = units[i];\n      result.totalItems++;\n      const errs: Array<{ path: string; message: string }> = [];\n\n      for (const aid of u.ability_ids ?? []) {\n        if (!defined.has(aid)) {\n          errs.push({\n            path: `/${i}/ability_ids`,\n            message: `unit \"${u.id}\": ability_id \"${aid}\" is not defined in ${faction} enrichment`,\n          });\n        }\n      }\n\n      if (home !== undefined) {\n        for (const fk of u.faction_keywords ?? []) {\n          if (fk !== home) {\n            errs.push({\n              path: `/${i}/faction_keywords`,\n              message: `unit \"${u.id}\": faction_keyword \"${fk}\" is not permitted for ${faction} (expected only \"${home}\")`,\n            });\n          }\n        }\n      }\n\n      if (errs.length > 0) {\n        result.failed++;\n        result.errors.push({ file, index: i, errors: errs });\n      } else {\n        result.passed++;\n      }\n    }\n  }\n\n  return result;\n}\n"]}

package/dist/report.d.ts

@@ -1,4 +1,4 @@
 import type { ValidationResult } from "./validate.js";
 export type ReporterMode = "pretty" | "json";
-export declare function formatReport(result: ValidationResult, mode: ReporterMode): string;
+export declare function formatReport(result: ValidationResult, mode: ReporterMode, title?: string): string;
 //# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAgCjF"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7C,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,EAClB,KAAK,SAAiC,GACrC,MAAM,CAgCR"}

package/dist/report.js

@@ -1,11 +1,11 @@
 import chalk from "chalk";
-export function formatReport(result, mode) {
+export function formatReport(result, mode, title = "40kdc Data Validation Report") {
     if (mode === "json") {
         return JSON.stringify(result, null, 2);
     }
     const lines = [];
     lines.push("");
-    lines.push(chalk.bold("40kdc Data Validation Report"));
+    lines.push(chalk.bold(title));
     lines.push(chalk.gray("─".repeat(40)));
     lines.push(`Files scanned:  ${result.totalFiles}`);
     lines.push(`Items validated: ${result.totalItems}`);

package/dist/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,UAAU,YAAY,CAAC,MAAwB,EAAE,IAAkB;IACvE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import chalk from \"chalk\";\nimport type { ValidationResult } from \"./validate.js\";\n\nexport type ReporterMode = \"pretty\" | \"json\";\n\nexport function formatReport(result: ValidationResult, mode: ReporterMode): string {\n  if (mode === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const lines: string[] = [];\n  lines.push(\"\");\n  lines.push(chalk.bold(\"40kdc Data Validation Report\"));\n  lines.push(chalk.gray(\"─\".repeat(40)));\n  lines.push(`Files scanned:  ${result.totalFiles}`);\n  lines.push(`Items validated: ${result.totalItems}`);\n  lines.push(chalk.green(`Passed: ${result.passed}`));\n\n  if (result.failed > 0) {\n    lines.push(chalk.red(`Failed: ${result.failed}`));\n    lines.push(\"\");\n\n    for (const err of result.errors) {\n      const loc = err.index >= 0 ? `[${err.index}]` : \"\";\n      lines.push(chalk.red(`  ✗ ${err.file}${loc}`));\n      for (const e of err.errors) {\n        lines.push(chalk.yellow(`    ${e.path}: ${e.message}`));\n      }\n    }\n  } else {\n    lines.push(chalk.green(`Failed: 0`));\n    lines.push(\"\");\n    lines.push(chalk.green(\"All validations passed.\"));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,UAAU,YAAY,CAC1B,MAAwB,EACxB,IAAkB,EAClB,KAAK,GAAG,8BAA8B;IAEtC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["import chalk from \"chalk\";\nimport type { ValidationResult } from \"./validate.js\";\n\nexport type ReporterMode = \"pretty\" | \"json\";\n\nexport function formatReport(\n  result: ValidationResult,\n  mode: ReporterMode,\n  title = \"40kdc Data Validation Report\",\n): string {\n  if (mode === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n\n  const lines: string[] = [];\n  lines.push(\"\");\n  lines.push(chalk.bold(title));\n  lines.push(chalk.gray(\"─\".repeat(40)));\n  lines.push(`Files scanned:  ${result.totalFiles}`);\n  lines.push(`Items validated: ${result.totalItems}`);\n  lines.push(chalk.green(`Passed: ${result.passed}`));\n\n  if (result.failed > 0) {\n    lines.push(chalk.red(`Failed: ${result.failed}`));\n    lines.push(\"\");\n\n    for (const err of result.errors) {\n      const loc = err.index >= 0 ? `[${err.index}]` : \"\";\n      lines.push(chalk.red(`  ✗ ${err.file}${loc}`));\n      for (const e of err.errors) {\n        lines.push(chalk.yellow(`    ${e.path}: ${e.message}`));\n      }\n    }\n  } else {\n    lines.push(chalk.green(`Failed: 0`));\n    lines.push(\"\");\n    lines.push(chalk.green(\"All validations passed.\"));\n  }\n\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/runner.d.ts.map

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

package/dist/runner.js

@@ -23,6 +23,7 @@ import { Dataset } from "./data/dataset.js";
 import { normalizeName } from "./data/normalize.js";
 import { maximalLoadout } from "./data/loadout.js";
 import { exportRoster } from "./export/index.js";
+import { decodeShareToken, encodeShareToken } from "./share/index.js";
 import { importRoster, tryImportRoster } from "./import/import-roster.js";
 import { createValidator } from "./schema-loader.js";
 import { attributeStages, crunch } from "./cruncher/index.js";
@@ -215,6 +216,34 @@ function handleExport(args) {
         return err("EXPORT_FAILED", { detail: e.message });
     }
 }
+function handleShareEncode(args) {
+    if (typeof args !== "object" || args === null) {
+        return err("INVALID_INPUT", { detail: "share_encode args must be an object" });
+    }
+    const a = args;
+    if (typeof a.list !== "object" || a.list === null) {
+        return err("INVALID_INPUT", { detail: "share_encode.list must be an object" });
+    }
+    try {
+        return ok(encodeShareToken(a.list));
+    }
+    catch (e) {
+        // An id absent from the embedded registry is the only expected throw.
+        return err("INVALID_INPUT", { detail: e.message });
+    }
+}
+function handleShareDecode(args) {
+    if (typeof args !== "object" || args === null) {
+        return err("INVALID_INPUT", { detail: "share_decode args must be an object" });
+    }
+    const a = args;
+    if (typeof a.token !== "string") {
+        return err("INVALID_INPUT", { detail: "share_decode.token must be a string" });
+    }
+    // The DecodeResult ({ ok, list } | { ok, reason }) is the compared value;
+    // a malformed/stale token is a normal result, not a protocol error.
+    return ok(decodeShareToken(a.token));
+}
 /**
  * Canonical string encoding of a base size for cross-impl comparison (mirrors the
  * string-encoding used by `maximal_loadout`). Returns null for an absent base.
@@ -318,6 +347,15 @@ function handleLinkedQuery(state, args) {
                     return err("UNKNOWN_ENTITY", { kind: "faction", id: input.factionId });
                 return ok(f.weapons.map((x) => x.id));
             }
+            case "units_with_keyword":
+                return ok(ds.unitsWithKeyword(input.keyword ?? "").map((u) => u.id));
+            case "allies_for": {
+                const raw = input.detachmentIds;
+                const detachmentIds = Array.isArray(raw) ? raw : [];
+                return ok(ds.alliesFor(input.factionId ?? "", detachmentIds).map((r) => r.id));
+            }
+            case "ally_units_for":
+                return ok(ds.allyUnitsFor(input.ruleId ?? "").map((u) => u.id));
             default:
                 return err("INVALID_INPUT", { detail: `unknown linked_query: ${a.query}` });
         }
@@ -856,6 +894,10 @@ export function dispatch(state, req) {
             return handleResolveTerrain(req.args);
         case "keystones":
             return handleKeystones(req.args);
+        case "share_encode":
+            return handleShareEncode(req.args);
+        case "share_decode":
+            return handleShareDecode(req.args);
         case "shutdown":
             return ok(null);
         default: