bsdata-parser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aodhan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# bsdata-parser
+
+A faithful, typed parser for [BSData](https://github.com/BSData) `.gst`/`.cat` XML game-data files into a typed Intermediate Representation (IR), plus a golden-diff harness for validating a downstream projection against a reference output.
+
+[![CI](https://github.com/aodhan-dev/bsdata-parser/actions/workflows/ci.yml/badge.svg)](https://github.com/aodhan-dev/bsdata-parser/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/bsdata-parser)](https://www.npmjs.com/package/bsdata-parser)
+
+## Why
+
+Naive BSData parsers flatten the XML as they go, silently dropping modifiers and conditions they cannot statically resolve. The result is recurring "missing option" bugs whenever BSData's conditional logic kicks in. This library solves that by keeping the full modifier/condition tree in the IR and leaving resolution to the projection layer.
+
+## Architecture
+
+```
+BSData (.gst/.cat)  ──parse──▶  IR (faithful tree)  ──project──▶  your output
+                                                                        │
+                                       reference output  ◀───diff───────┘
+```
+
+- **`src/parse`** - XML to IR. Mechanical transcription only: no interpretation, no flattening, no domain knowledge. Every modifier, condition, constraint, and repeat node is preserved verbatim.
+- **`src/project`** - IR to output. All domain interpretation lives here. This layer is intentionally not included in the package - you supply it, shaped to your own output schema.
+- **`harness/`** - golden-diff utilities. Load a reference output (oracle) and diff a candidate against it to find gaps. Auto-skips when no local data is present, so the test suite runs cleanly everywhere.
+
+## Installation
+
+```bash
+npm install bsdata-parser
+```
+
+## Usage
+
+```typescript
+import { parseToIr } from 'bsdata-parser'
+import type { Ir } from 'bsdata-parser'
+
+// 1. Load your .gst/.cat files however you like (fs, fetch, etc.)
+const files: Record<string, string> = {
+  'my-game.gst': '<gameSystem ...>...</gameSystem>',
+  'faction-a.cat': '<catalogue ...>...</catalogue>',
+}
+
+// 2. Parse to IR - faithful, lossless, typed
+const ir: Ir = parseToIr(files)
+
+// 3. Project to your output schema
+const output = myProjector(ir)
+```
+
+`parseToIr` accepts a `filename -> XML string` map and returns an `Ir` object containing the fully parsed game system and all catalogues as typed trees.
+
+## IR shape
+
+```typescript
+interface Ir {
+  gameSystem: IrCatalogueFile   // the .gst file
+  catalogues: IrCatalogueFile[] // all .cat files
+}
+
+interface IrCatalogueFile {
+  filename: string
+  kind: 'gameSystem' | 'catalogue'
+  id: string
+  name: string
+  gameSystemId?: string
+  catalogueLinks: IrCatalogueLink[]
+  root: IrCatalogueRoot
+}
+
+interface IrCatalogueRoot {
+  costTypes: IrCostType[]
+  profileTypes: IrProfileType[]
+  categoryEntries: IrCategoryEntry[]
+  rules: IrRule[]
+  sharedRules: IrRule[]
+  sharedProfiles: IrProfile[]
+  selectionEntries: IrSelectionEntry[]
+  sharedSelectionEntries: IrSelectionEntry[]
+  sharedSelectionEntryGroups: IrSelectionEntryGroup[]
+  entryLinks: IrEntryLink[]
+  forceEntries: IrForceEntry[]
+}
+```
+
+All node types (`IrSelectionEntry`, `IrConstraint`, `IrModifier`, `IrCondition`, etc.) are exported from the package. See `src/ir/types.ts` for the complete set.
+
+## Writing a projector
+
+A projector is a function `(ir: Ir) => YourOutputType`. It lives in your own codebase and is never part of this package:
+
+```typescript
+import { parseToIr } from 'bsdata-parser'
+import type { Ir } from 'bsdata-parser'
+
+function projectMyGame(ir: Ir): MyOutput {
+  const categories: Record<string, string> = {}
+  for (const entry of ir.gameSystem.root.categoryEntries) {
+    categories[entry.id] = entry.name
+  }
+
+  const units = ir.catalogues.flatMap(cat =>
+    cat.root.sharedSelectionEntries
+      .filter(e => e.type === 'unit' && !e.hidden)
+      .map(e => ({ id: e.id, name: e.name, faction: cat.name }))
+  )
+
+  return { categories, units }
+}
+
+export function buildOutput(files: Record<string, string>): MyOutput {
+  return projectMyGame(parseToIr(files))
+}
+```
+
+## Golden-diff harness
+
+The `harness/` directory contains utilities for validating that your projector reproduces a known-good reference output as a superset. Copy or adapt these into your own project:
+
+- `harness/oracle.ts` - `loadBsdata()`, `loadOracle()`, `hasData()` (reads from `BSDATA_DIR`)
+- `harness/diff.ts` - `diffCatalogues(oracle, candidate)` - counts-based diff, domain-agnostic
+
+Set `BSDATA_DIR` to a local directory containing:
+- `bsdata/` - the `.cat`/`.gst` source files
+- `catalogue.json` - a reference output to diff against
+
+```typescript
+// your-project/harness/golden-parity.test.ts
+import { describe, it, expect } from 'vitest'
+import { readFile, readdir } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { buildOutput } from './my-projector'
+
+const dir = process.env.BSDATA_DIR ?? ''
+const hasData = () => existsSync(join(dir, 'catalogue.json'))
+
+describe.skipIf(!hasData())('golden parity', () => {
+  it('reproduces every oracle collection', async () => {
+    const oracle = JSON.parse(await readFile(join(dir, 'catalogue.json'), 'utf-8'))
+    const names = (await readdir(join(dir, 'bsdata'))).filter(f => f.endsWith('.cat') || f.endsWith('.gst'))
+    const files: Record<string, string> = {}
+    await Promise.all(names.map(async n => { files[n] = await readFile(join(dir, 'bsdata', n), 'utf-8') }))
+    const candidate = buildOutput(files)
+    // diff: for every key in oracle, compare collection size
+    const diffs = Object.keys(oracle).filter(k => {
+      const size = (v: unknown) => Array.isArray(v) ? v.length : v && typeof v === 'object' ? Object.keys(v as object).length : 0
+      return size(oracle[k]) !== size((candidate as Record<string, unknown>)[k])
+    })
+    expect(diffs).toEqual([])
+  })
+})
+```
+
+## Data and domain code (never committed)
+
+No game data is bundled here. BSData source files are third-party content you assemble yourself. Your projector is likewise kept local - nothing data- or domain-specific should be published.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm test` | Unit suite + golden-parity test (auto-skips without `BSDATA_DIR`) |
+| `npm run build` | Compile to `dist/` via tsup |
+| `npm run typecheck` | `tsc --noEmit` |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,241 @@
+/**
+ * BSData intermediate representation (IR).
+ *
+ * A FAITHFUL, lossless-by-intent tree mirror of the BSData .gst / .cat model.
+ * Nothing is resolved, flattened, or interpreted here. Scope strings are raw BSData
+ * values. Modifier/condition trees are opaque. All interpretation belongs in the
+ * projection (src/project).
+ */
+interface IrConstraint {
+    id: string;
+    type: 'min' | 'max';
+    value: number;
+    scope: string;
+    field: string;
+    shared?: boolean;
+    includeChildSelections?: boolean;
+}
+interface IrCharacteristic {
+    name: string;
+    typeId: string;
+    value: string;
+}
+interface IrProfile {
+    id: string;
+    name: string;
+    hidden: boolean;
+    typeId: string;
+    typeName: string;
+    characteristics: IrCharacteristic[];
+}
+interface IrCost {
+    name: string;
+    typeId: string;
+    value: number;
+}
+interface IrRule {
+    id: string;
+    name: string;
+    hidden: boolean;
+    description: string;
+}
+interface IrInfoLink {
+    id: string;
+    name: string;
+    hidden: boolean;
+    targetId: string;
+    type: string;
+}
+interface IrCategoryLink {
+    id: string;
+    targetId: string;
+    primary: boolean;
+}
+/** Verbatim condition node - not evaluated, retained for the modifier tree. */
+interface IrCondition {
+    type: string;
+    value: number;
+    field: string;
+    scope: string;
+    childId?: string;
+    shared?: boolean;
+    includeChildSelections?: boolean;
+    percentValue?: boolean;
+}
+interface IrConditionGroup {
+    type: string;
+    conditions: IrCondition[];
+    conditionGroups: IrConditionGroup[];
+}
+/** Verbatim modifier node - not evaluated. */
+interface IrModifier {
+    type: string;
+    field: string;
+    value: string | number;
+    conditions: IrCondition[];
+    conditionGroups: IrConditionGroup[];
+    repeats: IrRepeat[];
+}
+interface IrRepeat {
+    value: number;
+    repeats: number;
+    field: string;
+    scope: string;
+    childId?: string;
+    shared?: boolean;
+    includeChildSelections?: boolean;
+    roundUp?: boolean;
+}
+type IrEntryType = 'unit' | 'model' | 'upgrade' | 'mount';
+interface IrSelectionEntry {
+    id: string;
+    name: string;
+    hidden: boolean;
+    collective: boolean;
+    import: boolean;
+    type: IrEntryType;
+    defaultAmount?: number;
+    constraints: IrConstraint[];
+    profiles: IrProfile[];
+    rules: IrRule[];
+    infoLinks: IrInfoLink[];
+    categoryLinks: IrCategoryLink[];
+    costs: IrCost[];
+    modifiers: IrModifier[];
+    selectionEntries: IrSelectionEntry[];
+    selectionEntryGroups: IrSelectionEntryGroup[];
+    entryLinks: IrEntryLink[];
+}
+interface IrSelectionEntryGroup {
+    id: string;
+    name: string;
+    hidden: boolean;
+    collective: boolean;
+    import: boolean;
+    defaultSelectionEntryId?: string;
+    constraints: IrConstraint[];
+    modifiers: IrModifier[];
+    selectionEntries: IrSelectionEntry[];
+    selectionEntryGroups: IrSelectionEntryGroup[];
+    entryLinks: IrEntryLink[];
+}
+interface IrEntryLink {
+    id: string;
+    name: string;
+    hidden: boolean;
+    collective: boolean;
+    import: boolean;
+    targetId: string;
+    type: string;
+    defaultAmount?: number;
+    comment?: string;
+    constraints: IrConstraint[];
+    costs: IrCost[];
+    modifiers: IrModifier[];
+    profiles: IrProfile[];
+    infoLinks: IrInfoLink[];
+    categoryLinks: IrCategoryLink[];
+    selectionEntries: IrSelectionEntry[];
+    selectionEntryGroups: IrSelectionEntryGroup[];
+    entryLinks: IrEntryLink[];
+}
+interface IrCategoryEntry {
+    id: string;
+    name: string;
+    hidden: boolean;
+}
+interface IrForceCategoryLink {
+    id: string;
+    targetId: string;
+    primary: boolean;
+    hidden: boolean;
+    constraints: IrConstraint[];
+}
+interface IrForceEntry {
+    id: string;
+    name: string;
+    hidden: boolean;
+    categoryLinks: IrForceCategoryLink[];
+    rules: IrRule[];
+    modifiers: IrModifier[];
+    forceEntries: IrForceEntry[];
+}
+interface IrCostType {
+    id: string;
+    name: string;
+    defaultCostLimit: number;
+}
+/** A BSData catalogueLink node: references another catalogue this one imports from. */
+interface IrCatalogueLink {
+    id: string;
+    name: string;
+    targetId: string;
+    type: string;
+    importRootEntries: boolean;
+}
+interface IrProfileType {
+    id: string;
+    name: string;
+    characteristicTypes: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+interface IrCatalogueRoot {
+    costTypes: IrCostType[];
+    profileTypes: IrProfileType[];
+    categoryEntries: IrCategoryEntry[];
+    rules: IrRule[];
+    /** Rules from the BSData &lt;sharedRules&gt; element: the canonical rule-definition pool. */
+    sharedRules: IrRule[];
+    /** Profiles from the BSData &lt;sharedProfiles&gt; element: abilities with Summary/Description characteristics. */
+    sharedProfiles: IrProfile[];
+    selectionEntries: IrSelectionEntry[];
+    sharedSelectionEntries: IrSelectionEntry[];
+    sharedSelectionEntryGroups: IrSelectionEntryGroup[];
+    entryLinks: IrEntryLink[];
+    forceEntries: IrForceEntry[];
+}
+/** A single parsed BSData file (game system or catalogue). */
+interface IrCatalogueFile {
+    filename: string;
+    kind: 'gameSystem' | 'catalogue';
+    id: string;
+    name: string;
+    gameSystemId?: string;
+    catalogueLinks: IrCatalogueLink[];
+    root: IrCatalogueRoot;
+}
+/** The whole parsed source set: the game system plus every catalogue. */
+interface Ir {
+    gameSystem: IrCatalogueFile;
+    catalogues: IrCatalogueFile[];
+}
+
+declare function parseToIr(files: Record<string, string>): Ir;
+
+/**
+ * IR -> downstream projection.
+ *
+ * Projects the faithful IR into the flattened, ready-to-consume shape the downstream application
+ * needs. ALL domain interpretation lives here; the IR and parser stay domain-agnostic. The concrete
+ * projector and its reference data are supplied locally and are never committed to this repo (see
+ * README) -- this repo ships the framework, not any specific data model.
+ *
+ * "Superset" is the contract: the projection MUST reproduce every field the reference output carries
+ * (so the existing consumer keeps working unchanged), and MAY add fields the current consumer lacks.
+ * The golden-diff harness asserts the reproduction half; new fields are additive and ignored.
+ *
+ * STUB. Supply a local implementation that imports your projector modules. The local file is
+ * gitignored so it never reaches this public repo. See CLAUDE.md for the hygiene rule.
+ */
+declare function projectCatalogue(_ir: Ir): Record<string, unknown>;
+
+/**
+ * Public entry point. `filename -> XML` map in, projected output object out. The signature matches
+ * the downstream consumer's existing build step so this can be wired in incrementally (swap the
+ * import, keep the golden diff green) without touching the consumer.
+ */
+declare function buildCatalogue(files: Record<string, string>): Record<string, unknown>;
+
+export { type Ir, type IrCatalogueFile, buildCatalogue, parseToIr, projectCatalogue };

package/dist/index.js

@@ -0,0 +1,302 @@
+// src/parse/xml.ts
+import { XMLParser } from "fast-xml-parser";
+var ALWAYS_ARRAY = /* @__PURE__ */ new Set([
+  "selectionEntry",
+  "selectionEntryGroup",
+  "entryLink",
+  "constraint",
+  "profile",
+  "characteristic",
+  "characteristicType",
+  "cost",
+  "costType",
+  "profileType",
+  "rule",
+  "categoryLink",
+  "categoryEntry",
+  "infoLink",
+  "modifier",
+  "condition",
+  "conditionGroup",
+  "repeat",
+  "forceEntry",
+  "catalogueLink"
+]);
+var xmlParser = new XMLParser({
+  ignoreAttributes: false,
+  attributeNamePrefix: "@_",
+  textNodeName: "#text",
+  isArray: (name) => ALWAYS_ARRAY.has(name),
+  parseAttributeValue: true
+});
+function arr(v) {
+  if (!v) return [];
+  if (Array.isArray(v)) return v;
+  return [v];
+}
+function bool(v) {
+  return v === true || v === "true";
+}
+function parseConstraint(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    type: n["@_type"] === "min" ? "min" : "max",
+    value: Number(n["@_value"] ?? 0),
+    scope: String(n["@_scope"] ?? ""),
+    field: String(n["@_field"] ?? "selections"),
+    shared: bool(n["@_shared"]),
+    includeChildSelections: bool(n["@_includeChildSelections"])
+  };
+}
+function parseCost(n) {
+  return {
+    name: String(n["@_name"] ?? ""),
+    typeId: String(n["@_typeId"] ?? ""),
+    value: Number(n["@_value"] ?? 0)
+  };
+}
+function parseCharacteristic(n) {
+  const raw = n["#text"];
+  return {
+    name: String(n["@_name"] ?? ""),
+    typeId: String(n["@_typeId"] ?? ""),
+    value: raw != null ? String(raw) : ""
+  };
+}
+function parseProfile(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    typeId: String(n["@_typeId"] ?? ""),
+    typeName: String(n["@_typeName"] ?? ""),
+    characteristics: arr(n.characteristics?.characteristic).map(parseCharacteristic)
+  };
+}
+function parseRule(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    description: n.description != null ? String(n.description) : ""
+  };
+}
+function parseInfoLink(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    targetId: String(n["@_targetId"] ?? ""),
+    type: String(n["@_type"] ?? "")
+  };
+}
+function parseCategoryLink(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    targetId: String(n["@_targetId"] ?? ""),
+    primary: bool(n["@_primary"])
+  };
+}
+function parseCondition(n) {
+  const out = {
+    type: String(n["@_type"] ?? ""),
+    value: Number(n["@_value"] ?? 0),
+    field: String(n["@_field"] ?? ""),
+    scope: String(n["@_scope"] ?? "")
+  };
+  if (n["@_childId"] != null) out.childId = String(n["@_childId"]);
+  if (n["@_shared"] != null) out.shared = bool(n["@_shared"]);
+  if (n["@_includeChildSelections"] != null) out.includeChildSelections = bool(n["@_includeChildSelections"]);
+  if (n["@_percentValue"] != null) out.percentValue = bool(n["@_percentValue"]);
+  return out;
+}
+function parseConditionGroup(n) {
+  return {
+    type: String(n["@_type"] ?? ""),
+    conditions: arr(n.conditions?.condition).map(parseCondition),
+    conditionGroups: arr(n.conditionGroups?.conditionGroup).map(parseConditionGroup)
+  };
+}
+function parseRepeat(n) {
+  const out = {
+    value: Number(n["@_value"] ?? 0),
+    repeats: Number(n["@_repeats"] ?? 0),
+    field: String(n["@_field"] ?? ""),
+    scope: String(n["@_scope"] ?? "")
+  };
+  if (n["@_childId"] != null) out.childId = String(n["@_childId"]);
+  if (n["@_shared"] != null) out.shared = bool(n["@_shared"]);
+  if (n["@_includeChildSelections"] != null) out.includeChildSelections = bool(n["@_includeChildSelections"]);
+  if (n["@_roundUp"] != null) out.roundUp = bool(n["@_roundUp"]);
+  return out;
+}
+function parseModifier(n) {
+  return {
+    type: String(n["@_type"] ?? ""),
+    field: String(n["@_field"] ?? ""),
+    value: n["@_value"] ?? "",
+    conditions: arr(n.conditions?.condition).map(parseCondition),
+    conditionGroups: arr(n.conditionGroups?.conditionGroup).map(parseConditionGroup),
+    repeats: arr(n.repeats?.repeat).map(parseRepeat)
+  };
+}
+function parseSelectionEntry(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    collective: bool(n["@_collective"]),
+    import: bool(n["@_import"]),
+    type: n["@_type"] ?? "upgrade",
+    ...n["@_defaultAmount"] != null ? { defaultAmount: Number(n["@_defaultAmount"]) } : {},
+    constraints: arr(n.constraints?.constraint).map(parseConstraint),
+    profiles: arr(n.profiles?.profile).map(parseProfile),
+    rules: arr(n.rules?.rule).map(parseRule),
+    infoLinks: arr(n.infoLinks?.infoLink).map(parseInfoLink),
+    categoryLinks: arr(n.categoryLinks?.categoryLink).map(parseCategoryLink),
+    costs: arr(n.costs?.cost).map(parseCost),
+    modifiers: arr(n.modifiers?.modifier).map(parseModifier),
+    selectionEntries: arr(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),
+    selectionEntryGroups: arr(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),
+    entryLinks: arr(n.entryLinks?.entryLink).map(parseEntryLink)
+  };
+}
+function parseSelectionEntryGroup(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    collective: bool(n["@_collective"]),
+    import: bool(n["@_import"]),
+    ...n["@_defaultSelectionEntryId"] != null ? { defaultSelectionEntryId: String(n["@_defaultSelectionEntryId"]) } : {},
+    constraints: arr(n.constraints?.constraint).map(parseConstraint),
+    modifiers: arr(n.modifiers?.modifier).map(parseModifier),
+    selectionEntries: arr(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),
+    selectionEntryGroups: arr(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),
+    entryLinks: arr(n.entryLinks?.entryLink).map(parseEntryLink)
+  };
+}
+function parseEntryLink(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    collective: bool(n["@_collective"]),
+    import: bool(n["@_import"]),
+    targetId: String(n["@_targetId"] ?? ""),
+    type: String(n["@_type"] ?? ""),
+    ...n["@_defaultAmount"] != null ? { defaultAmount: Number(n["@_defaultAmount"]) } : {},
+    ...n.comment != null ? { comment: String(n.comment).trim() } : {},
+    constraints: arr(n.constraints?.constraint).map(parseConstraint),
+    costs: arr(n.costs?.cost).map(parseCost),
+    modifiers: arr(n.modifiers?.modifier).map(parseModifier),
+    profiles: arr(n.profiles?.profile).map(parseProfile),
+    infoLinks: arr(n.infoLinks?.infoLink).map(parseInfoLink),
+    categoryLinks: arr(n.categoryLinks?.categoryLink).map(parseCategoryLink),
+    selectionEntries: arr(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),
+    selectionEntryGroups: arr(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),
+    entryLinks: arr(n.entryLinks?.entryLink).map(parseEntryLink)
+  };
+}
+function parseForceCategoryLink(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    targetId: String(n["@_targetId"] ?? ""),
+    primary: bool(n["@_primary"]),
+    hidden: bool(n["@_hidden"]),
+    constraints: arr(n.constraints?.constraint).map(parseConstraint)
+  };
+}
+function parseForceEntry(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    hidden: bool(n["@_hidden"]),
+    categoryLinks: arr(n.categoryLinks?.categoryLink).map(parseForceCategoryLink),
+    rules: arr(n.rules?.rule).map(parseRule),
+    modifiers: arr(n.modifiers?.modifier).map(parseModifier),
+    forceEntries: arr(n.forceEntries?.forceEntry).map(parseForceEntry)
+  };
+}
+function parseCatalogueLink(n) {
+  return {
+    id: String(n["@_id"] ?? ""),
+    name: String(n["@_name"] ?? ""),
+    targetId: String(n["@_targetId"] ?? ""),
+    type: String(n["@_type"] ?? ""),
+    importRootEntries: bool(n["@_importRootEntries"])
+  };
+}
+function parseCatalogueRoot(r) {
+  return {
+    costTypes: arr(r.costTypes?.costType).map((n) => ({
+      id: String(n["@_id"] ?? ""),
+      name: String(n["@_name"] ?? ""),
+      defaultCostLimit: Number(n["@_defaultCostLimit"] ?? -1)
+    })),
+    profileTypes: arr(r.profileTypes?.profileType).map((n) => ({
+      id: String(n["@_id"] ?? ""),
+      name: String(n["@_name"] ?? ""),
+      characteristicTypes: arr(n.characteristicTypes?.characteristicType).map((c) => ({
+        id: String(c["@_id"] ?? ""),
+        name: String(c["@_name"] ?? "")
+      }))
+    })),
+    categoryEntries: arr(r.categoryEntries?.categoryEntry).map((n) => ({
+      id: String(n["@_id"] ?? ""),
+      name: String(n["@_name"] ?? ""),
+      hidden: bool(n["@_hidden"])
+    })),
+    rules: arr(r.rules?.rule).map(parseRule),
+    sharedRules: arr(r.sharedRules?.rule).map(parseRule),
+    sharedProfiles: arr(r.sharedProfiles?.profile).map(parseProfile),
+    selectionEntries: arr(r.selectionEntries?.selectionEntry).map(parseSelectionEntry),
+    sharedSelectionEntries: arr(r.sharedSelectionEntries?.selectionEntry).map(parseSelectionEntry),
+    sharedSelectionEntryGroups: arr(r.sharedSelectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),
+    entryLinks: arr(r.entryLinks?.entryLink).map(parseEntryLink),
+    forceEntries: arr(r.forceEntries?.forceEntry).map(parseForceEntry)
+  };
+}
+function parseFile(filename, xml) {
+  const doc = xmlParser.parse(xml);
+  const isGst = "gameSystem" in doc;
+  const root = isGst ? doc.gameSystem : doc.catalogue;
+  const kind = isGst ? "gameSystem" : "catalogue";
+  return {
+    filename,
+    kind,
+    id: String(root["@_id"] ?? ""),
+    name: String(root["@_name"] ?? ""),
+    ...root["@_gameSystemId"] != null ? { gameSystemId: String(root["@_gameSystemId"]) } : {},
+    catalogueLinks: arr(root.catalogueLinks?.catalogueLink).map(parseCatalogueLink),
+    root: parseCatalogueRoot(root)
+  };
+}
+
+// src/parse/index.ts
+function parseToIr(files) {
+  const parsed = Object.entries(files).map(([filename, xml]) => parseFile(filename, xml));
+  const gameSystem = parsed.find((f) => f.kind === "gameSystem");
+  if (!gameSystem) throw new Error("parseToIr: no .gst file in source set");
+  return {
+    gameSystem,
+    catalogues: parsed.filter((f) => f.kind === "catalogue")
+  };
+}
+
+// src/project/catalogue.ts
+function projectCatalogue(_ir) {
+  return {};
+}
+
+// src/index.ts
+function buildCatalogue(files) {
+  const ir = parseToIr(files);
+  return projectCatalogue(ir);
+}
+export {
+  buildCatalogue,
+  parseToIr,
+  projectCatalogue
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse/xml.ts","../src/parse/index.ts","../src/project/catalogue.ts","../src/index.ts"],"sourcesContent":["import { XMLParser } from 'fast-xml-parser'\nimport type {\n  IrCatalogueFile, IrCatalogueRoot,\n  IrConstraint, IrCost, IrProfile, IrCharacteristic,\n  IrRule, IrInfoLink, IrCategoryLink,\n  IrModifier, IrCondition, IrConditionGroup, IrRepeat,\n  IrSelectionEntry, IrSelectionEntryGroup, IrEntryLink,\n  IrCostType, IrProfileType, IrCategoryEntry,\n  IrEntryType,\n  IrForceCategoryLink, IrForceEntry,\n  IrCatalogueLink,\n} from '../ir/types.ts'\n\nconst ALWAYS_ARRAY = new Set([\n  'selectionEntry', 'selectionEntryGroup', 'entryLink',\n  'constraint', 'profile', 'characteristic', 'characteristicType',\n  'cost', 'costType', 'profileType',\n  'rule', 'categoryLink', 'categoryEntry',\n  'infoLink', 'modifier', 'condition', 'conditionGroup', 'repeat',\n  'forceEntry', 'catalogueLink',\n])\n\nconst xmlParser = new XMLParser({\n  ignoreAttributes: false,\n  attributeNamePrefix: '@_',\n  textNodeName: '#text',\n  isArray: (name) => ALWAYS_ARRAY.has(name),\n  parseAttributeValue: true,\n})\n\n// ---- helpers ----\n\nfunction arr<T>(v: unknown): T[] {\n  if (!v) return []\n  if (Array.isArray(v)) return v as T[]\n  return [v as T]\n}\n\nfunction bool(v: unknown): boolean {\n  return v === true || v === 'true'\n}\n\n// ---- primitive node parsers ----\n\nfunction parseConstraint(n: any): IrConstraint {\n  return {\n    id: String(n['@_id'] ?? ''),\n    type: n['@_type'] === 'min' ? 'min' : 'max',\n    value: Number(n['@_value'] ?? 0),\n    scope: String(n['@_scope'] ?? ''),\n    field: String(n['@_field'] ?? 'selections'),\n    shared: bool(n['@_shared']),\n    includeChildSelections: bool(n['@_includeChildSelections']),\n  }\n}\n\nfunction parseCost(n: any): IrCost {\n  return {\n    name: String(n['@_name'] ?? ''),\n    typeId: String(n['@_typeId'] ?? ''),\n    value: Number(n['@_value'] ?? 0),\n  }\n}\n\nfunction parseCharacteristic(n: any): IrCharacteristic {\n  const raw = n['#text']\n  return {\n    name: String(n['@_name'] ?? ''),\n    typeId: String(n['@_typeId'] ?? ''),\n    value: raw != null ? String(raw) : '',\n  }\n}\n\nfunction parseProfile(n: any): IrProfile {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    typeId: String(n['@_typeId'] ?? ''),\n    typeName: String(n['@_typeName'] ?? ''),\n    characteristics: arr<any>(n.characteristics?.characteristic).map(parseCharacteristic),\n  }\n}\n\nfunction parseRule(n: any): IrRule {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    description: n.description != null ? String(n.description) : '',\n  }\n}\n\nfunction parseInfoLink(n: any): IrInfoLink {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    targetId: String(n['@_targetId'] ?? ''),\n    type: String(n['@_type'] ?? ''),\n  }\n}\n\nfunction parseCategoryLink(n: any): IrCategoryLink {\n  return {\n    id: String(n['@_id'] ?? ''),\n    targetId: String(n['@_targetId'] ?? ''),\n    primary: bool(n['@_primary']),\n  }\n}\n\nfunction parseCondition(n: any): IrCondition {\n  const out: IrCondition = {\n    type: String(n['@_type'] ?? ''),\n    value: Number(n['@_value'] ?? 0),\n    field: String(n['@_field'] ?? ''),\n    scope: String(n['@_scope'] ?? ''),\n  }\n  if (n['@_childId'] != null) out.childId = String(n['@_childId'])\n  if (n['@_shared'] != null) out.shared = bool(n['@_shared'])\n  if (n['@_includeChildSelections'] != null) out.includeChildSelections = bool(n['@_includeChildSelections'])\n  if (n['@_percentValue'] != null) out.percentValue = bool(n['@_percentValue'])\n  return out\n}\n\nfunction parseConditionGroup(n: any): IrConditionGroup {\n  return {\n    type: String(n['@_type'] ?? ''),\n    conditions: arr<any>(n.conditions?.condition).map(parseCondition),\n    conditionGroups: arr<any>(n.conditionGroups?.conditionGroup).map(parseConditionGroup),\n  }\n}\n\nfunction parseRepeat(n: any): IrRepeat {\n  const out: IrRepeat = {\n    value: Number(n['@_value'] ?? 0),\n    repeats: Number(n['@_repeats'] ?? 0),\n    field: String(n['@_field'] ?? ''),\n    scope: String(n['@_scope'] ?? ''),\n  }\n  if (n['@_childId'] != null) out.childId = String(n['@_childId'])\n  if (n['@_shared'] != null) out.shared = bool(n['@_shared'])\n  if (n['@_includeChildSelections'] != null) out.includeChildSelections = bool(n['@_includeChildSelections'])\n  if (n['@_roundUp'] != null) out.roundUp = bool(n['@_roundUp'])\n  return out\n}\n\nfunction parseModifier(n: any): IrModifier {\n  return {\n    type: String(n['@_type'] ?? ''),\n    field: String(n['@_field'] ?? ''),\n    value: n['@_value'] ?? '',\n    conditions: arr<any>(n.conditions?.condition).map(parseCondition),\n    conditionGroups: arr<any>(n.conditionGroups?.conditionGroup).map(parseConditionGroup),\n    repeats: arr<any>(n.repeats?.repeat).map(parseRepeat),\n  }\n}\n\n// ---- structural node parsers (mutually recursive) ----\n\nfunction parseSelectionEntry(n: any): IrSelectionEntry {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    collective: bool(n['@_collective']),\n    import: bool(n['@_import']),\n    type: (n['@_type'] ?? 'upgrade') as IrEntryType,\n    ...(n['@_defaultAmount'] != null ? { defaultAmount: Number(n['@_defaultAmount']) } : {}),\n    constraints: arr<any>(n.constraints?.constraint).map(parseConstraint),\n    profiles: arr<any>(n.profiles?.profile).map(parseProfile),\n    rules: arr<any>(n.rules?.rule).map(parseRule),\n    infoLinks: arr<any>(n.infoLinks?.infoLink).map(parseInfoLink),\n    categoryLinks: arr<any>(n.categoryLinks?.categoryLink).map(parseCategoryLink),\n    costs: arr<any>(n.costs?.cost).map(parseCost),\n    modifiers: arr<any>(n.modifiers?.modifier).map(parseModifier),\n    selectionEntries: arr<any>(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),\n    selectionEntryGroups: arr<any>(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),\n    entryLinks: arr<any>(n.entryLinks?.entryLink).map(parseEntryLink),\n  }\n}\n\nfunction parseSelectionEntryGroup(n: any): IrSelectionEntryGroup {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    collective: bool(n['@_collective']),\n    import: bool(n['@_import']),\n    ...(n['@_defaultSelectionEntryId'] != null\n      ? { defaultSelectionEntryId: String(n['@_defaultSelectionEntryId']) }\n      : {}),\n    constraints: arr<any>(n.constraints?.constraint).map(parseConstraint),\n    modifiers: arr<any>(n.modifiers?.modifier).map(parseModifier),\n    selectionEntries: arr<any>(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),\n    selectionEntryGroups: arr<any>(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),\n    entryLinks: arr<any>(n.entryLinks?.entryLink).map(parseEntryLink),\n  }\n}\n\nfunction parseEntryLink(n: any): IrEntryLink {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    collective: bool(n['@_collective']),\n    import: bool(n['@_import']),\n    targetId: String(n['@_targetId'] ?? ''),\n    type: String(n['@_type'] ?? ''),\n    ...(n['@_defaultAmount'] != null ? { defaultAmount: Number(n['@_defaultAmount']) } : {}),\n    ...(n.comment != null ? { comment: String(n.comment).trim() } : {}),\n    constraints: arr<any>(n.constraints?.constraint).map(parseConstraint),\n    costs: arr<any>(n.costs?.cost).map(parseCost),\n    modifiers: arr<any>(n.modifiers?.modifier).map(parseModifier),\n    profiles: arr<any>(n.profiles?.profile).map(parseProfile),\n    infoLinks: arr<any>(n.infoLinks?.infoLink).map(parseInfoLink),\n    categoryLinks: arr<any>(n.categoryLinks?.categoryLink).map(parseCategoryLink),\n    selectionEntries: arr<any>(n.selectionEntries?.selectionEntry).map(parseSelectionEntry),\n    selectionEntryGroups: arr<any>(n.selectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),\n    entryLinks: arr<any>(n.entryLinks?.entryLink).map(parseEntryLink),\n  }\n}\n\n// ---- force entry parsers ----\n\nfunction parseForceCategoryLink(n: any): IrForceCategoryLink {\n  return {\n    id: String(n['@_id'] ?? ''),\n    targetId: String(n['@_targetId'] ?? ''),\n    primary: bool(n['@_primary']),\n    hidden: bool(n['@_hidden']),\n    constraints: arr<any>(n.constraints?.constraint).map(parseConstraint),\n  }\n}\n\nfunction parseForceEntry(n: any): IrForceEntry {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    hidden: bool(n['@_hidden']),\n    categoryLinks: arr<any>(n.categoryLinks?.categoryLink).map(parseForceCategoryLink),\n    rules: arr<any>(n.rules?.rule).map(parseRule),\n    modifiers: arr<any>(n.modifiers?.modifier).map(parseModifier),\n    forceEntries: arr<any>(n.forceEntries?.forceEntry).map(parseForceEntry),\n  }\n}\n\n// ---- catalogue link parser ----\n\nfunction parseCatalogueLink(n: any): IrCatalogueLink {\n  return {\n    id: String(n['@_id'] ?? ''),\n    name: String(n['@_name'] ?? ''),\n    targetId: String(n['@_targetId'] ?? ''),\n    type: String(n['@_type'] ?? ''),\n    importRootEntries: bool(n['@_importRootEntries']),\n  }\n}\n\n// ---- catalogue root ----\n\nfunction parseCatalogueRoot(r: any): IrCatalogueRoot {\n  return {\n    costTypes: arr<any>(r.costTypes?.costType).map((n: any): IrCostType => ({\n      id: String(n['@_id'] ?? ''),\n      name: String(n['@_name'] ?? ''),\n      defaultCostLimit: Number(n['@_defaultCostLimit'] ?? -1),\n    })),\n    profileTypes: arr<any>(r.profileTypes?.profileType).map((n: any): IrProfileType => ({\n      id: String(n['@_id'] ?? ''),\n      name: String(n['@_name'] ?? ''),\n      characteristicTypes: arr<any>(n.characteristicTypes?.characteristicType).map((c: any) => ({\n        id: String(c['@_id'] ?? ''),\n        name: String(c['@_name'] ?? ''),\n      })),\n    })),\n    categoryEntries: arr<any>(r.categoryEntries?.categoryEntry).map((n: any): IrCategoryEntry => ({\n      id: String(n['@_id'] ?? ''),\n      name: String(n['@_name'] ?? ''),\n      hidden: bool(n['@_hidden']),\n    })),\n    rules: arr<any>(r.rules?.rule).map(parseRule),\n    sharedRules: arr<any>(r.sharedRules?.rule).map(parseRule),\n    sharedProfiles: arr<any>(r.sharedProfiles?.profile).map(parseProfile),\n    selectionEntries: arr<any>(r.selectionEntries?.selectionEntry).map(parseSelectionEntry),\n    sharedSelectionEntries: arr<any>(r.sharedSelectionEntries?.selectionEntry).map(parseSelectionEntry),\n    sharedSelectionEntryGroups: arr<any>(r.sharedSelectionEntryGroups?.selectionEntryGroup).map(parseSelectionEntryGroup),\n    entryLinks: arr<any>(r.entryLinks?.entryLink).map(parseEntryLink),\n    forceEntries: arr<any>(r.forceEntries?.forceEntry).map(parseForceEntry),\n  }\n}\n\n// ---- public entry ----\n\nexport function parseFile(filename: string, xml: string): IrCatalogueFile {\n  const doc = xmlParser.parse(xml)\n  const isGst = 'gameSystem' in doc\n  const root = isGst ? doc.gameSystem : doc.catalogue\n  const kind: 'gameSystem' | 'catalogue' = isGst ? 'gameSystem' : 'catalogue'\n  return {\n    filename,\n    kind,\n    id: String(root['@_id'] ?? ''),\n    name: String(root['@_name'] ?? ''),\n    ...(root['@_gameSystemId'] != null ? { gameSystemId: String(root['@_gameSystemId']) } : {}),\n    catalogueLinks: arr<any>(root.catalogueLinks?.catalogueLink).map(parseCatalogueLink),\n    root: parseCatalogueRoot(root),\n  }\n}\n","import type { Ir } from '../ir/types.ts'\nimport { parseFile } from './xml.ts'\n\nexport function parseToIr(files: Record<string, string>): Ir {\n  const parsed = Object.entries(files).map(([filename, xml]) => parseFile(filename, xml))\n  const gameSystem = parsed.find(f => f.kind === 'gameSystem')\n  if (!gameSystem) throw new Error('parseToIr: no .gst file in source set')\n  return {\n    gameSystem,\n    catalogues: parsed.filter(f => f.kind === 'catalogue'),\n  }\n}\n","import type { Ir } from '../ir/types.ts'\n\n/**\n * IR -> downstream projection.\n *\n * Projects the faithful IR into the flattened, ready-to-consume shape the downstream application\n * needs. ALL domain interpretation lives here; the IR and parser stay domain-agnostic. The concrete\n * projector and its reference data are supplied locally and are never committed to this repo (see\n * README) -- this repo ships the framework, not any specific data model.\n *\n * \"Superset\" is the contract: the projection MUST reproduce every field the reference output carries\n * (so the existing consumer keeps working unchanged), and MAY add fields the current consumer lacks.\n * The golden-diff harness asserts the reproduction half; new fields are additive and ignored.\n *\n * STUB. Supply a local implementation that imports your projector modules. The local file is\n * gitignored so it never reaches this public repo. See CLAUDE.md for the hygiene rule.\n */\nexport function projectCatalogue(_ir: Ir): Record<string, unknown> {\n  return {}\n}\n","import { parseToIr } from './parse/index.ts'\nimport { projectCatalogue } from './project/catalogue.ts'\n\n/**\n * Public entry point. `filename -> XML` map in, projected output object out. The signature matches\n * the downstream consumer's existing build step so this can be wired in incrementally (swap the\n * import, keep the golden diff green) without touching the consumer.\n */\nexport function buildCatalogue(files: Record<string, string>): Record<string, unknown> {\n  const ir = parseToIr(files)\n  return projectCatalogue(ir)\n}\n\nexport { parseToIr } from './parse/index.ts'\nexport { projectCatalogue } from './project/catalogue.ts'\nexport type { Ir, IrCatalogueFile } from './ir/types.ts'\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "bsdata-parser",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "description": "Faithful BSData .gst/.cat XML parser: parses game-data source files into a typed IR and exposes a golden-diff harness for validating a downstream projection.",
+  "keywords": ["bsdata", "battlescribe", "parser", "xml", "game-data"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aodhan-dev/bsdata-parser.git"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "git diff --quiet HEAD -- src/project/catalogue.ts || (echo 'ERROR: catalogue.ts has local changes (skip-worktree). Publish via the CI publish workflow on a version tag, not locally.' && exit 1)",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.41",
+    "tsup": "^8.5.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.1"
+  },
+  "dependencies": {
+    "fast-xml-parser": "^4.5.6"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}