@alpaca-software/40kdc-data 0.3.2 → 0.4.0

package/dist/converters/wargear-options.js

@@ -0,0 +1,187 @@
+/**
+ * Build wargear-option and wargear entities for one faction from army-assist's
+ * prose option table. Ties together the {@link parseOption} prose parser and the
+ * numeric→UUID {@link bridgeOptionsToUnits} bridge, then resolves the parsed
+ * weapon/wargear *names* to entity ids against the faction's own weapon registry
+ * (a name that is not a known weapon becomes a non-weapon `wargear` item).
+ *
+ * Anything that does not resolve cleanly — an unbridged datasheet, a prose line
+ * the parser rejects, an ambiguous unit match — is collected in `unparsed` for
+ * the caller to write to a report rather than dropped silently or guessed.
+ */
+import { nameToId } from "./id-generator.js";
+import { parseOption } from "./option-parser.js";
+import { bridgeOptionsToUnits, modelNameFromComposition, normModelName, } from "./option-bridge.js";
+/** Guess a coarse category for a non-weapon item from its name. */
+function categorize(name) {
+    const n = name.toLowerCase();
+    if (n.includes("icon"))
+        return "icon";
+    if (n.includes("standard") || n.includes("banner"))
+        return "standard";
+    if (n.includes("token"))
+        return "token";
+    return undefined;
+}
+/** Drop empty fields from a parsed constraint; return undefined if nothing left. */
+function cleanConstraint(c) {
+    const out = {};
+    if (c.model_name)
+        out.model_name = c.model_name;
+    if (c.per_n_models)
+        out.per_n_models = c.per_n_models;
+    if (c.max_count)
+        out.max_count = c.max_count;
+    if (c.any_number)
+        out.any_number = true;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function buildWargearOptions(factionDatasheets, allModels, allOptions, allComposition, unitWeaponIds, // UUID → weapon ids on that unit
+globalWeaponIds, // every weapon id in the faction
+gameVersion) {
+    const factionUuids = factionDatasheets.map((d) => d.id);
+    const factionUuidSet = new Set(factionUuids);
+    const nameByUuid = new Map(factionDatasheets.map((d) => [d.id, d.name]));
+    // UUID → normalized model-name set (numeric-side bridge target).
+    const modelsByUuid = new Map();
+    for (const m of allModels) {
+        if (!factionUuidSet.has(m.datasheet_id))
+            continue;
+        let set = modelsByUuid.get(m.datasheet_id);
+        if (!set)
+            modelsByUuid.set(m.datasheet_id, (set = new Set()));
+        set.add(normModelName(m.name));
+    }
+    // numeric → normalized model-name set (from composition descriptions).
+    const compByNumeric = new Map();
+    for (const c of allComposition) {
+        let set = compByNumeric.get(c.datasheet_id);
+        if (!set)
+            compByNumeric.set(c.datasheet_id, (set = new Set()));
+        set.add(modelNameFromComposition(c.description));
+    }
+    // numeric → its option rows.
+    const optionsByNumeric = new Map();
+    for (const o of allOptions) {
+        let rows = optionsByNumeric.get(o.datasheet_id);
+        if (!rows)
+            optionsByNumeric.set(o.datasheet_id, (rows = []));
+        rows.push(o);
+    }
+    const { byNumeric, ambiguous } = bridgeOptionsToUnits(factionUuids, modelsByUuid, compByNumeric, optionsByNumeric.keys());
+    // Shared units appear under several numeric ids (faction "views"); merge each
+    // UUID's option rows, deduped by description text, so we emit options once.
+    const rowsByUuid = new Map();
+    for (const [numericId, uuid] of byNumeric) {
+        const seen = new Set(rowsByUuid.get(uuid)?.map((r) => r.description ?? ""));
+        const rows = rowsByUuid.get(uuid) ?? [];
+        for (const r of optionsByNumeric.get(numericId) ?? []) {
+            const key = r.description ?? "";
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            rows.push(r);
+        }
+        rowsByUuid.set(uuid, rows);
+    }
+    const wargearOptions = [];
+    const wargearById = new Map();
+    const unparsed = [];
+    const MAX_LEN = 128; // entity-id / name schema maxLength
+    // Resolve a name to an id, queuing any new non-weapon item into `pending`
+    // (committed by the caller only once the whole option resolves, so a later
+    // failure can't leave an orphan wargear entity behind). Throws on a name that
+    // can't form a valid, in-bounds entity — the caller reports it.
+    const resolveName = (name, weaponIds, pending) => {
+        if (name.length > MAX_LEN)
+            throw new Error(`name too long: ${name.slice(0, 40)}…`);
+        const id = nameToId(name); // throws on a name with no id-safe characters
+        if (id.length > MAX_LEN)
+            throw new Error(`id too long: ${id.slice(0, 40)}…`);
+        if (weaponIds.has(id) || globalWeaponIds.has(id))
+            return id;
+        if (!wargearById.has(id) && !pending.has(id)) {
+            const entity = { id, name, game_version: gameVersion };
+            const category = categorize(name);
+            if (category)
+                entity.category = category;
+            pending.set(id, entity);
+        }
+        return id;
+    };
+    for (const [uuid, rows] of rowsByUuid) {
+        const unitName = nameByUuid.get(uuid);
+        const unitId = nameToId(unitName);
+        const weaponIds = unitWeaponIds.get(uuid) ?? new Set();
+        for (const row of rows.sort((a, b) => Number(a.line) - Number(b.line))) {
+            const result = parseOption(row.description);
+            if (result.ok === "skip")
+                continue;
+            if (result.ok === false) {
+                unparsed.push({
+                    unit_id: unitId,
+                    datasheet: unitName,
+                    line: row.line,
+                    description: row.description,
+                    reason: result.reason,
+                });
+                continue;
+            }
+            const o = result.option;
+            const entity = {
+                id: `${unitId}-${o.kind}-${row.line}`,
+                unit_id: unitId,
+                is_free: true,
+                game_version: gameVersion,
+            };
+            const constraint = cleanConstraint(o.constraint);
+            if (constraint)
+                entity.model_constraint = constraint;
+            const pending = new Map();
+            try {
+                if (o.replaces.length > 0) {
+                    entity.replaces = o.replaces.map((n) => resolveName(n, weaponIds, pending));
+                }
+                if (o.replacement) {
+                    entity.replacement = o.replacement.map((n) => resolveName(n, weaponIds, pending));
+                }
+                if (o.replacement_choice) {
+                    entity.replacement_choice = o.replacement_choice.map((g) => g.map((n) => resolveName(n, weaponIds, pending)));
+                }
+            }
+            catch (err) {
+                // A name that can't form a valid, in-bounds entity id (stray
+                // punctuation, an over-captured clause): report it rather than abort the
+                // faction, and discard any pending wargear so no orphan is emitted.
+                unparsed.push({
+                    unit_id: unitId,
+                    datasheet: unitName,
+                    line: row.line,
+                    description: row.description,
+                    reason: `name resolution failed: ${err.message}`,
+                });
+                continue;
+            }
+            for (const [id, w] of pending)
+                wargearById.set(id, w);
+            wargearOptions.push(entity);
+        }
+    }
+    for (const numericId of ambiguous) {
+        for (const row of optionsByNumeric.get(numericId) ?? []) {
+            unparsed.push({
+                unit_id: null,
+                datasheet: `numeric:${numericId}`,
+                line: row.line,
+                description: row.description,
+                reason: "ambiguous unit match (model names tie across datasheets)",
+            });
+        }
+    }
+    return {
+        wargearOptions,
+        wargear: [...wargearById.values()],
+        unparsed,
+    };
+}
+//# sourceMappingURL=wargear-options.js.map

package/dist/converters/wargear-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wargear-options.js","sourceRoot":"","sources":["../../src/converters/wargear-options.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Build wargear-option and wargear entities for one faction from army-assist's\n * prose option table. Ties together the {@link parseOption} prose parser and the\n * numeric→UUID {@link bridgeOptionsToUnits} bridge, then resolves the parsed\n * weapon/wargear *names* to entity ids against the faction's own weapon registry\n * (a name that is not a known weapon becomes a non-weapon `wargear` item).\n *\n * Anything that does not resolve cleanly — an unbridged datasheet, a prose line\n * the parser rejects, an ambiguous unit match — is collected in `unparsed` for\n * the caller to write to a report rather than dropped silently or guessed.\n */\nimport { nameToId } from \"./id-generator.js\";\nimport { parseOption, type ParsedConstraint } from \"./option-parser.js\";\nimport {\n  bridgeOptionsToUnits,\n  modelNameFromComposition,\n  normModelName,\n} from \"./option-bridge.js\";\n\ninterface SourceOption {\n  datasheet_id: string; // numeric\n  line: string;\n  description: string | null;\n}\ninterface SourceComposition {\n  datasheet_id: string; // numeric\n  line: string;\n  description: string;\n}\ninterface SourceModel {\n  datasheet_id: string; // UUID\n  name: string;\n}\n\ninterface GameVersion {\n  edition: string;\n  dataslate: string;\n}\n\nexport interface WargearEntity {\n  id: string;\n  name: string;\n  category?: string;\n  game_version: GameVersion;\n}\n\nexport interface WargearOptionEntity {\n  id: string;\n  unit_id: string;\n  model_constraint?: ParsedConstraint;\n  replaces?: string[];\n  replacement?: string[];\n  replacement_choice?: string[][];\n  is_free: boolean;\n  game_version: GameVersion;\n}\n\nexport interface UnparsedOption {\n  unit_id: string | null;\n  datasheet: string;\n  line: string;\n  description: string | null;\n  reason: string;\n}\n\nexport interface BuildWargearResult {\n  wargearOptions: WargearOptionEntity[];\n  wargear: WargearEntity[];\n  unparsed: UnparsedOption[];\n}\n\n/** Guess a coarse category for a non-weapon item from its name. */\nfunction categorize(name: string): string | undefined {\n  const n = name.toLowerCase();\n  if (n.includes(\"icon\")) return \"icon\";\n  if (n.includes(\"standard\") || n.includes(\"banner\")) return \"standard\";\n  if (n.includes(\"token\")) return \"token\";\n  return undefined;\n}\n\n/** Drop empty fields from a parsed constraint; return undefined if nothing left. */\nfunction cleanConstraint(c: ParsedConstraint): ParsedConstraint | undefined {\n  const out: ParsedConstraint = {};\n  if (c.model_name) out.model_name = c.model_name;\n  if (c.per_n_models) out.per_n_models = c.per_n_models;\n  if (c.max_count) out.max_count = c.max_count;\n  if (c.any_number) out.any_number = true;\n  return Object.keys(out).length > 0 ? out : undefined;\n}\n\nexport function buildWargearOptions(\n  factionDatasheets: readonly { id: string; name: string }[],\n  allModels: readonly SourceModel[],\n  allOptions: readonly SourceOption[],\n  allComposition: readonly SourceComposition[],\n  unitWeaponIds: Map<string, Set<string>>, // UUID → weapon ids on that unit\n  globalWeaponIds: Set<string>, // every weapon id in the faction\n  gameVersion: GameVersion,\n): BuildWargearResult {\n  const factionUuids = factionDatasheets.map((d) => d.id);\n  const factionUuidSet = new Set(factionUuids);\n  const nameByUuid = new Map(factionDatasheets.map((d) => [d.id, d.name]));\n\n  // UUID → normalized model-name set (numeric-side bridge target).\n  const modelsByUuid = new Map<string, Set<string>>();\n  for (const m of allModels) {\n    if (!factionUuidSet.has(m.datasheet_id)) continue;\n    let set = modelsByUuid.get(m.datasheet_id);\n    if (!set) modelsByUuid.set(m.datasheet_id, (set = new Set()));\n    set.add(normModelName(m.name));\n  }\n\n  // numeric → normalized model-name set (from composition descriptions).\n  const compByNumeric = new Map<string, Set<string>>();\n  for (const c of allComposition) {\n    let set = compByNumeric.get(c.datasheet_id);\n    if (!set) compByNumeric.set(c.datasheet_id, (set = new Set()));\n    set.add(modelNameFromComposition(c.description));\n  }\n\n  // numeric → its option rows.\n  const optionsByNumeric = new Map<string, SourceOption[]>();\n  for (const o of allOptions) {\n    let rows = optionsByNumeric.get(o.datasheet_id);\n    if (!rows) optionsByNumeric.set(o.datasheet_id, (rows = []));\n    rows.push(o);\n  }\n\n  const { byNumeric, ambiguous } = bridgeOptionsToUnits(\n    factionUuids,\n    modelsByUuid,\n    compByNumeric,\n    optionsByNumeric.keys(),\n  );\n\n  // Shared units appear under several numeric ids (faction \"views\"); merge each\n  // UUID's option rows, deduped by description text, so we emit options once.\n  const rowsByUuid = new Map<string, SourceOption[]>();\n  for (const [numericId, uuid] of byNumeric) {\n    const seen = new Set(rowsByUuid.get(uuid)?.map((r) => r.description ?? \"\"));\n    const rows = rowsByUuid.get(uuid) ?? [];\n    for (const r of optionsByNumeric.get(numericId) ?? []) {\n      const key = r.description ?? \"\";\n      if (seen.has(key)) continue;\n      seen.add(key);\n      rows.push(r);\n    }\n    rowsByUuid.set(uuid, rows);\n  }\n\n  const wargearOptions: WargearOptionEntity[] = [];\n  const wargearById = new Map<string, WargearEntity>();\n  const unparsed: UnparsedOption[] = [];\n\n  const MAX_LEN = 128; // entity-id / name schema maxLength\n  // Resolve a name to an id, queuing any new non-weapon item into `pending`\n  // (committed by the caller only once the whole option resolves, so a later\n  // failure can't leave an orphan wargear entity behind). Throws on a name that\n  // can't form a valid, in-bounds entity — the caller reports it.\n  const resolveName = (\n    name: string,\n    weaponIds: Set<string>,\n    pending: Map<string, WargearEntity>,\n  ): string => {\n    if (name.length > MAX_LEN) throw new Error(`name too long: ${name.slice(0, 40)}…`);\n    const id = nameToId(name); // throws on a name with no id-safe characters\n    if (id.length > MAX_LEN) throw new Error(`id too long: ${id.slice(0, 40)}…`);\n    if (weaponIds.has(id) || globalWeaponIds.has(id)) return id;\n    if (!wargearById.has(id) && !pending.has(id)) {\n      const entity: WargearEntity = { id, name, game_version: gameVersion };\n      const category = categorize(name);\n      if (category) entity.category = category;\n      pending.set(id, entity);\n    }\n    return id;\n  };\n\n  for (const [uuid, rows] of rowsByUuid) {\n    const unitName = nameByUuid.get(uuid)!;\n    const unitId = nameToId(unitName);\n    const weaponIds = unitWeaponIds.get(uuid) ?? new Set<string>();\n\n    for (const row of rows.sort((a, b) => Number(a.line) - Number(b.line))) {\n      const result = parseOption(row.description);\n      if (result.ok === \"skip\") continue;\n      if (result.ok === false) {\n        unparsed.push({\n          unit_id: unitId,\n          datasheet: unitName,\n          line: row.line,\n          description: row.description,\n          reason: result.reason,\n        });\n        continue;\n      }\n      const o = result.option;\n      const entity: WargearOptionEntity = {\n        id: `${unitId}-${o.kind}-${row.line}`,\n        unit_id: unitId,\n        is_free: true,\n        game_version: gameVersion,\n      };\n      const constraint = cleanConstraint(o.constraint);\n      if (constraint) entity.model_constraint = constraint;\n      const pending = new Map<string, WargearEntity>();\n      try {\n        if (o.replaces.length > 0) {\n          entity.replaces = o.replaces.map((n) => resolveName(n, weaponIds, pending));\n        }\n        if (o.replacement) {\n          entity.replacement = o.replacement.map((n) => resolveName(n, weaponIds, pending));\n        }\n        if (o.replacement_choice) {\n          entity.replacement_choice = o.replacement_choice.map((g) =>\n            g.map((n) => resolveName(n, weaponIds, pending)),\n          );\n        }\n      } catch (err) {\n        // A name that can't form a valid, in-bounds entity id (stray\n        // punctuation, an over-captured clause): report it rather than abort the\n        // faction, and discard any pending wargear so no orphan is emitted.\n        unparsed.push({\n          unit_id: unitId,\n          datasheet: unitName,\n          line: row.line,\n          description: row.description,\n          reason: `name resolution failed: ${(err as Error).message}`,\n        });\n        continue;\n      }\n      for (const [id, w] of pending) wargearById.set(id, w);\n      wargearOptions.push(entity);\n    }\n  }\n\n  for (const numericId of ambiguous) {\n    for (const row of optionsByNumeric.get(numericId) ?? []) {\n      unparsed.push({\n        unit_id: null,\n        datasheet: `numeric:${numericId}`,\n        line: row.line,\n        description: row.description,\n        reason: \"ambiguous unit match (model names tie across datasheets)\",\n      });\n    }\n  }\n\n  return {\n    wargearOptions,\n    wargear: [...wargearById.values()],\n    unparsed,\n  };\n}\n"]}