@alpaca-software/40kdc-data 0.2.0 → 0.3.1

package/dist/terrain/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/terrain/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Terrain layout resolver — turns a {@link TerrainLayout} (template references +\n * centroid-anchored placements + rotation/mirror) into absolute board-space\n * polygon vertices. This is the shared geometry contract pinned by the\n * `conformance/terrain-resolver` corpus; the Rust crate implements the same\n * function and must reproduce these vertices byte-for-byte (4-dp rounded).\n *\n * ## Transform contract\n *\n * Frames are board inches, origin at a board corner, **y-down** (per\n * `common.schema.json#/$defs/vec2`). A footprint is authored in natural local\n * y-down coordinates; the resolver derives its **polygon area centroid** and\n * treats local vertices as `(v - centroid)`, so `position` always denotes the\n * centroid and is invariant under rotation and mirror.\n *\n * Local → board, for an unparented piece, is `mirror → rotate → translate`:\n *\n *   board = position + R_cw(rotation) · M(mirror) · (v - centroid)\n *\n * with `M`: horizontal → (-x, y), vertical → (x, -y); and `R_cw(θ)` a clockwise\n * rotation in the y-down frame, `[[cosθ, -sinθ], [sinθ, cosθ]]`.\n *\n * A feature with a `parent_area_id` (or a template's composed feature) is first\n * placed in the parent area's **centroid-local frame** (origin at the area\n * centroid), then carried through the area's own placement:\n *\n *   board = T_area ∘ R_area ∘ M_area ( featurePos + R_feat · M_feat · (w - C_feat) )\n *\n * ## Emission order (a pinned invariant)\n *\n * Pieces are emitted in `layout.pieces` order. When a piece instances an area\n * template that carries composed `features`, those features are emitted\n * immediately after their area, in template-declaration order.\n */\n\nexport interface Vec2 {\n  x: number;\n  y: number;\n}\n\nexport type Footprint =\n  | { type: \"rectangle\"; width: number; height: number }\n  | { type: \"right-triangle\"; width: number; height: number }\n  | { type: \"polygon\"; points: Vec2[] };\n\nexport type Mirror = \"none\" | \"horizontal\" | \"vertical\";\n\nexport interface ComposedFeature {\n  id?: string;\n  template: string;\n  position: Vec2;\n  rotation_degrees?: number;\n  mirror?: Mirror;\n  floor?: number;\n}\n\nexport interface TerrainTemplate {\n  id: string;\n  name?: string;\n  kind: \"area\" | \"feature\";\n  footprint: Footprint;\n  default_height_inches?: number;\n  default_blocking?: boolean;\n  default_terrain_area_keywords?: string[];\n  features?: ComposedFeature[];\n}\n\nexport interface LayoutPiece {\n  id?: string;\n  name?: string;\n  piece_type?: \"area\" | \"feature\";\n  template?: string;\n  footprint?: Footprint;\n  position: Vec2;\n  rotation_degrees?: number;\n  mirror?: Mirror;\n  parent_area_id?: string;\n  floor?: number;\n  height_inches?: number;\n  terrain_area_keywords?: string[];\n  link_group?: string;\n}\n\nexport interface TerrainLayout {\n  id: string;\n  name: string;\n  pieces?: LayoutPiece[];\n}\n\nexport interface ResolvedPiece {\n  /** Layout-local id when present, else the piece name, else null. */\n  id: string | null;\n  name: string | null;\n  piece_type: \"area\" | \"feature\";\n  floor: number;\n  /** Absolute board-space polygon vertices, y-down. */\n  vertices: Vec2[];\n}\n\nconst DEG = Math.PI / 180;\n\n/** A footprint's polygon vertices in natural local (y-down) coordinates. */\nexport function footprintVertices(fp: Footprint): Vec2[] {\n  switch (fp.type) {\n    case \"rectangle\":\n      return [\n        { x: 0, y: 0 },\n        { x: fp.width, y: 0 },\n        { x: fp.width, y: fp.height },\n        { x: 0, y: fp.height },\n      ];\n    case \"right-triangle\":\n      // Right angle at the local origin, legs along +x and +y.\n      return [\n        { x: 0, y: 0 },\n        { x: fp.width, y: 0 },\n        { x: 0, y: fp.height },\n      ];\n    case \"polygon\":\n      return fp.points.map((p) => ({ x: p.x, y: p.y }));\n    default: {\n      const exhaustive: never = fp;\n      throw new Error(`unknown footprint type: ${JSON.stringify(exhaustive)}`);\n    }\n  }\n}\n\n/**\n * Polygon area centroid (shoelace). Falls back to the vertex mean when the\n * polygon is degenerate (zero signed area, e.g. collinear points) so the\n * resolver never divides by zero.\n */\nexport function polygonCentroid(verts: Vec2[]): Vec2 {\n  const n = verts.length;\n  if (n === 0) return { x: 0, y: 0 };\n  let twiceArea = 0;\n  let cx = 0;\n  let cy = 0;\n  for (let i = 0; i < n; i++) {\n    const a = verts[i];\n    const b = verts[(i + 1) % n];\n    const cross = a.x * b.y - b.x * a.y;\n    twiceArea += cross;\n    cx += (a.x + b.x) * cross;\n    cy += (a.y + b.y) * cross;\n  }\n  if (twiceArea === 0) {\n    const mean = verts.reduce((acc, v) => ({ x: acc.x + v.x, y: acc.y + v.y }), { x: 0, y: 0 });\n    return { x: mean.x / n, y: mean.y / n };\n  }\n  return { x: cx / (3 * twiceArea), y: cy / (3 * twiceArea) };\n}\n\nfunction applyMirror(v: Vec2, m: Mirror): Vec2 {\n  switch (m) {\n    case \"horizontal\":\n      return { x: -v.x, y: v.y };\n    case \"vertical\":\n      return { x: v.x, y: -v.y };\n    default:\n      return v;\n  }\n}\n\n/** Clockwise rotation by `deg` degrees in the y-down frame. */\nfunction rotateCw(v: Vec2, deg: number): Vec2 {\n  if (deg === 0) return { x: v.x, y: v.y };\n  const r = deg * DEG;\n  const c = Math.cos(r);\n  const s = Math.sin(r);\n  return { x: c * v.x - s * v.y, y: s * v.x + c * v.y };\n}\n\n/** mirror → rotate (no translation). The orientation-only part of a placement. */\nfunction orient(v: Vec2, rotation: number, mirror: Mirror): Vec2 {\n  return rotateCw(applyMirror(v, mirror), rotation);\n}\n\n/**\n * The board-space offset of each footprint vertex from the piece centroid,\n * after mirror + rotation but before translation. Adding `position` to each\n * gives the resolved board vertices; this is the orientation-only part a\n * card-measurement solver inverts to recover the centroid. Vertex order matches\n * {@link footprintVertices}.\n */\nexport function orientedOffsets(footprint: Footprint, rotation: number, mirror: Mirror): Vec2[] {\n  const verts = footprintVertices(footprint);\n  const c = polygonCentroid(verts);\n  return verts.map((v) => orient({ x: v.x - c.x, y: v.y - c.y }, rotation, mirror));\n}\n\n/**\n * Place a footprint's local vertices into a target frame: recenter on the\n * footprint centroid, mirror, rotate, then translate so the centroid lands on\n * `position`. The target frame is board space for an area, or the parent area's\n * centroid-local frame for a composed/parented feature.\n */\nfunction placeFootprint(\n  fp: Footprint,\n  position: Vec2,\n  rotation: number,\n  mirror: Mirror,\n): Vec2[] {\n  const verts = footprintVertices(fp);\n  const c = polygonCentroid(verts);\n  return verts.map((v) => {\n    const o = orient({ x: v.x - c.x, y: v.y - c.y }, rotation, mirror);\n    return { x: o.x + position.x, y: o.y + position.y };\n  });\n}\n\nconst TWO_DP_ROUND = 1e4;\nfunction round4(v: Vec2): Vec2 {\n  return { x: Math.round(v.x * TWO_DP_ROUND) / TWO_DP_ROUND, y: Math.round(v.y * TWO_DP_ROUND) / TWO_DP_ROUND };\n}\n\nfunction resolvedIdName(piece: { id?: string; name?: string }): { id: string | null; name: string | null } {\n  return { id: piece.id ?? null, name: piece.name ?? null };\n}\n\nexport class TerrainResolveError extends Error {}\n\n/**\n * Resolve a layout to absolute board-space vertices per piece. `templates` is\n * the catalog a piece's `template` references resolve against.\n */\nexport function resolveLayout(layout: TerrainLayout, templates: TerrainTemplate[]): ResolvedPiece[] {\n  const byId = new Map<string, TerrainTemplate>();\n  for (const t of templates) byId.set(t.id, t);\n\n  const pieces = layout.pieces ?? [];\n  const areasById = new Map<string, LayoutPiece>();\n  for (const p of pieces) if (p.id) areasById.set(p.id, p);\n\n  const footprintOf = (piece: { template?: string; footprint?: Footprint }, where: string): Footprint => {\n    if (piece.footprint) return piece.footprint;\n    if (piece.template) {\n      const t = byId.get(piece.template);\n      if (!t) throw new TerrainResolveError(`${where}: unknown template \"${piece.template}\"`);\n      return t.footprint;\n    }\n    throw new TerrainResolveError(`${where}: piece has neither footprint nor template`);\n  };\n\n  const out: ResolvedPiece[] = [];\n\n  for (const piece of pieces) {\n    const where = piece.id ?? piece.name ?? \"<piece>\";\n    const fp = footprintOf(piece, where);\n    const rotation = piece.rotation_degrees ?? 0;\n    const mirror = piece.mirror ?? \"none\";\n    const pieceType = piece.piece_type ?? (piece.parent_area_id ? \"feature\" : \"area\");\n\n    if (piece.parent_area_id) {\n      // Feature placed in its parent area's centroid-local frame.\n      const parent = areasById.get(piece.parent_area_id);\n      if (!parent) {\n        throw new TerrainResolveError(`${where}: unknown parent_area_id \"${piece.parent_area_id}\"`);\n      }\n      const areaLocal = placeFootprint(fp, piece.position, rotation, mirror);\n      const aRot = parent.rotation_degrees ?? 0;\n      const aMirror = parent.mirror ?? \"none\";\n      const vertices = areaLocal.map((p) => {\n        const o = orient(p, aRot, aMirror);\n        return round4({ x: o.x + parent.position.x, y: o.y + parent.position.y });\n      });\n      out.push({ ...resolvedIdName(piece), piece_type: pieceType, floor: piece.floor ?? 0, vertices });\n      continue;\n    }\n\n    // Unparented area or feature: place directly in board space.\n    const vertices = placeFootprint(fp, piece.position, rotation, mirror).map(round4);\n    out.push({ ...resolvedIdName(piece), piece_type: pieceType, floor: piece.floor ?? 0, vertices });\n\n    // Expand an area template's composed features, carried through this area's\n    // placement (same composition math as a parented feature).\n    if (piece.template) {\n      const t = byId.get(piece.template);\n      for (const feat of t?.features ?? []) {\n        const ft = byId.get(feat.template);\n        if (!ft) {\n          throw new TerrainResolveError(`${where}: composed feature references unknown template \"${feat.template}\"`);\n        }\n        const areaLocal = placeFootprint(\n          ft.footprint,\n          feat.position,\n          feat.rotation_degrees ?? 0,\n          feat.mirror ?? \"none\",\n        );\n        const featVerts = areaLocal.map((p) => {\n          const o = orient(p, rotation, mirror);\n          return round4({ x: o.x + piece.position.x, y: o.y + piece.position.y });\n        });\n        out.push({\n          id: feat.id ?? null,\n          name: ft.name ?? null,\n          piece_type: \"feature\",\n          floor: feat.floor ?? 0,\n          vertices: featVerts,\n        });\n      }\n    }\n  }\n\n  return out;\n}\n"]}

package/dist/terrain/solve.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Card-measurement centroid solver — the inverse of the resolver's placement.
+ *
+ * Reference cards locate a terrain area by dimension lines: "this feature of the
+ * area is D inches from a board edge". The feature referenced varies per card
+ * and per piece, which is exactly why a single canonical anchor (the centroid)
+ * is hard to read off a card directly. This solver lets a user transcribe the
+ * card verbatim — pick the template, set the orientation shown, then enter one
+ * horizontal and one vertical dimension line against whatever feature the card
+ * happens to draw — and back-solves the centroid `position` the schema stores.
+ *
+ * Because the centroid is rotation- and mirror-invariant, orientation is fixed
+ * first; each dimension line then pins one axis of the centroid in closed form.
+ */
+import { type Footprint, type Mirror, type Vec2 } from "./resolve.js";
+/** A board edge a card dimension is measured from. left/right pin x; top/bottom pin y. */
+export type BoardEdge = "left" | "right" | "top" | "bottom";
+/**
+ * Which feature of the placed area a dimension line reaches: a specific
+ * footprint vertex (by index, in {@link footprintVertices} order), or one of
+ * the placed area's axis-aligned bounding faces ("the left face", etc.).
+ */
+export type FeatureRef = {
+    kind: "vertex";
+    index: number;
+} | {
+    kind: "face";
+    side: "min-x" | "max-x" | "min-y" | "max-y";
+};
+/** One card dimension line: `distance` inches from `edge` to `feature`. */
+export interface DimensionLine {
+    edge: BoardEdge;
+    distance: number;
+    feature: FeatureRef;
+}
+export interface SolveInput {
+    footprint: Footprint;
+    rotation: number;
+    mirror: Mirror;
+    /** Board extents in inches (40kdc standard is 60 × 44). */
+    board: {
+        width: number;
+        height: number;
+    };
+    /** Two perpendicular dimension lines: exactly one must pin x, one must pin y. */
+    lines: [DimensionLine, DimensionLine];
+}
+export declare class TerrainSolveError extends Error {
+}
+/**
+ * Back-solve the centroid `position` from a template, its orientation, and two
+ * perpendicular card dimension lines. Closed form — one x-line and one y-line
+ * pin the two unknowns directly.
+ */
+export declare function solveCentroid(input: SolveInput): Vec2;
+//# sourceMappingURL=solve.d.ts.map

package/dist/terrain/solve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve.d.ts","sourceRoot":"","sources":["../../src/terrain/solve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAEvF,0FAA0F;AAC1F,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;CAAE,CAAC;AAElE,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,iFAAiF;IACjF,KAAK,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;CACvC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAkD/C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAYrD"}

package/dist/terrain/solve.js

@@ -0,0 +1,80 @@
+/**
+ * Card-measurement centroid solver — the inverse of the resolver's placement.
+ *
+ * Reference cards locate a terrain area by dimension lines: "this feature of the
+ * area is D inches from a board edge". The feature referenced varies per card
+ * and per piece, which is exactly why a single canonical anchor (the centroid)
+ * is hard to read off a card directly. This solver lets a user transcribe the
+ * card verbatim — pick the template, set the orientation shown, then enter one
+ * horizontal and one vertical dimension line against whatever feature the card
+ * happens to draw — and back-solves the centroid `position` the schema stores.
+ *
+ * Because the centroid is rotation- and mirror-invariant, orientation is fixed
+ * first; each dimension line then pins one axis of the centroid in closed form.
+ */
+import { orientedOffsets } from "./resolve.js";
+export class TerrainSolveError extends Error {
+}
+/** The signed offset (from the centroid) the given feature resolves to, on its axis. */
+function featureOffset(offsets, feature, axis) {
+    if (feature.kind === "vertex") {
+        const o = offsets[feature.index];
+        if (!o)
+            throw new TerrainSolveError(`vertex index ${feature.index} out of range`);
+        return axis === "x" ? o.x : o.y;
+    }
+    const xs = offsets.map((o) => o.x);
+    const ys = offsets.map((o) => o.y);
+    switch (feature.side) {
+        case "min-x":
+            return Math.min(...xs);
+        case "max-x":
+            return Math.max(...xs);
+        case "min-y":
+            return Math.min(...ys);
+        case "max-y":
+            return Math.max(...ys);
+    }
+}
+function axisOfEdge(edge) {
+    return edge === "left" || edge === "right" ? "x" : "y";
+}
+/** Solve one axis of the centroid from a single dimension line. */
+function solveAxis(line, offsets, board) {
+    const axis = axisOfEdge(line.edge);
+    const o = featureOffset(offsets, line.feature, axis);
+    // edge → centroid:  near-side edges measure from 0; far-side from the extent.
+    let value;
+    switch (line.edge) {
+        case "left":
+            value = line.distance - o;
+            break;
+        case "right":
+            value = board.width - line.distance - o;
+            break;
+        case "top":
+            value = line.distance - o;
+            break;
+        case "bottom":
+            value = board.height - line.distance - o;
+            break;
+    }
+    return { axis, value };
+}
+/**
+ * Back-solve the centroid `position` from a template, its orientation, and two
+ * perpendicular card dimension lines. Closed form — one x-line and one y-line
+ * pin the two unknowns directly.
+ */
+export function solveCentroid(input) {
+    const offsets = orientedOffsets(input.footprint, input.rotation, input.mirror);
+    const a = solveAxis(input.lines[0], offsets, input.board);
+    const b = solveAxis(input.lines[1], offsets, input.board);
+    if (a.axis === b.axis) {
+        throw new TerrainSolveError("the two dimension lines must pin different axes (one of left/right, one of top/bottom)");
+    }
+    const x = a.axis === "x" ? a.value : b.value;
+    const y = a.axis === "y" ? a.value : b.value;
+    return { x, y };
+}
+//# sourceMappingURL=solve.js.map

package/dist/terrain/solve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"solve.js","sourceRoot":"","sources":["../../src/terrain/solve.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Card-measurement centroid solver — the inverse of the resolver's placement.\n *\n * Reference cards locate a terrain area by dimension lines: \"this feature of the\n * area is D inches from a board edge\". The feature referenced varies per card\n * and per piece, which is exactly why a single canonical anchor (the centroid)\n * is hard to read off a card directly. This solver lets a user transcribe the\n * card verbatim — pick the template, set the orientation shown, then enter one\n * horizontal and one vertical dimension line against whatever feature the card\n * happens to draw — and back-solves the centroid `position` the schema stores.\n *\n * Because the centroid is rotation- and mirror-invariant, orientation is fixed\n * first; each dimension line then pins one axis of the centroid in closed form.\n */\nimport { orientedOffsets, type Footprint, type Mirror, type Vec2 } from \"./resolve.js\";\n\n/** A board edge a card dimension is measured from. left/right pin x; top/bottom pin y. */\nexport type BoardEdge = \"left\" | \"right\" | \"top\" | \"bottom\";\n\n/**\n * Which feature of the placed area a dimension line reaches: a specific\n * footprint vertex (by index, in {@link footprintVertices} order), or one of\n * the placed area's axis-aligned bounding faces (\"the left face\", etc.).\n */\nexport type FeatureRef =\n  | { kind: \"vertex\"; index: number }\n  | { kind: \"face\"; side: \"min-x\" | \"max-x\" | \"min-y\" | \"max-y\" };\n\n/** One card dimension line: `distance` inches from `edge` to `feature`. */\nexport interface DimensionLine {\n  edge: BoardEdge;\n  distance: number;\n  feature: FeatureRef;\n}\n\nexport interface SolveInput {\n  footprint: Footprint;\n  rotation: number;\n  mirror: Mirror;\n  /** Board extents in inches (40kdc standard is 60 × 44). */\n  board: { width: number; height: number };\n  /** Two perpendicular dimension lines: exactly one must pin x, one must pin y. */\n  lines: [DimensionLine, DimensionLine];\n}\n\nexport class TerrainSolveError extends Error {}\n\n/** The signed offset (from the centroid) the given feature resolves to, on its axis. */\nfunction featureOffset(offsets: Vec2[], feature: FeatureRef, axis: \"x\" | \"y\"): number {\n  if (feature.kind === \"vertex\") {\n    const o = offsets[feature.index];\n    if (!o) throw new TerrainSolveError(`vertex index ${feature.index} out of range`);\n    return axis === \"x\" ? o.x : o.y;\n  }\n  const xs = offsets.map((o) => o.x);\n  const ys = offsets.map((o) => o.y);\n  switch (feature.side) {\n    case \"min-x\":\n      return Math.min(...xs);\n    case \"max-x\":\n      return Math.max(...xs);\n    case \"min-y\":\n      return Math.min(...ys);\n    case \"max-y\":\n      return Math.max(...ys);\n  }\n}\n\nfunction axisOfEdge(edge: BoardEdge): \"x\" | \"y\" {\n  return edge === \"left\" || edge === \"right\" ? \"x\" : \"y\";\n}\n\n/** Solve one axis of the centroid from a single dimension line. */\nfunction solveAxis(line: DimensionLine, offsets: Vec2[], board: { width: number; height: number }): { axis: \"x\" | \"y\"; value: number } {\n  const axis = axisOfEdge(line.edge);\n  const o = featureOffset(offsets, line.feature, axis);\n  // edge → centroid:  near-side edges measure from 0; far-side from the extent.\n  let value: number;\n  switch (line.edge) {\n    case \"left\":\n      value = line.distance - o;\n      break;\n    case \"right\":\n      value = board.width - line.distance - o;\n      break;\n    case \"top\":\n      value = line.distance - o;\n      break;\n    case \"bottom\":\n      value = board.height - line.distance - o;\n      break;\n  }\n  return { axis, value };\n}\n\n/**\n * Back-solve the centroid `position` from a template, its orientation, and two\n * perpendicular card dimension lines. Closed form — one x-line and one y-line\n * pin the two unknowns directly.\n */\nexport function solveCentroid(input: SolveInput): Vec2 {\n  const offsets = orientedOffsets(input.footprint, input.rotation, input.mirror);\n  const a = solveAxis(input.lines[0], offsets, input.board);\n  const b = solveAxis(input.lines[1], offsets, input.board);\n  if (a.axis === b.axis) {\n    throw new TerrainSolveError(\n      \"the two dimension lines must pin different axes (one of left/right, one of top/bottom)\",\n    );\n  }\n  const x = a.axis === \"x\" ? a.value : b.value;\n  const y = a.axis === \"y\" ? a.value : b.value;\n  return { x, y };\n}\n"]}

package/dist/translate/condition.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Humanize an Ability-DSL / scoring `condition` into plain English.
+ *
+ * Shared by the ability-text CLI (`commands/translate.ts`) and the scoring-card
+ * translator (`scoring.ts`). Output is **ASCII-only** with a fixed clause and
+ * parameter order: it is pinned byte-for-byte across the TS and Rust ports by
+ * the `conformance/scoring-translation` corpus, so any phrasing change here is a
+ * semantic corpus change (bump `conformance/SPEC_VERSION`).
+ */
+/**
+ * Minimal structural view of a condition node. Matches both the ability-dsl
+ * condition schema and the `secondary-card` award `when` field (a simple node
+ * carries `type` + `parameters` + `negated`; a compound node carries
+ * `operator` + `operands`).
+ */
+export interface Condition {
+    type?: string;
+    operator?: "and" | "or" | "not";
+    operands?: Condition[];
+    parameters?: Record<string, unknown>;
+    negated?: boolean;
+}
+/** kebab-case → space-separated words (`enemy-territory` → `enemy territory`). */
+export declare function dekebab(s: string): string;
+export declare function describeCondition(c: Condition): string;
+//# sourceMappingURL=condition.d.ts.map

package/dist/translate/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../src/translate/condition.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzC;AAWD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAoItD"}

package/dist/translate/condition.js

@@ -0,0 +1,171 @@
+/**
+ * Humanize an Ability-DSL / scoring `condition` into plain English.
+ *
+ * Shared by the ability-text CLI (`commands/translate.ts`) and the scoring-card
+ * translator (`scoring.ts`). Output is **ASCII-only** with a fixed clause and
+ * parameter order: it is pinned byte-for-byte across the TS and Rust ports by
+ * the `conformance/scoring-translation` corpus, so any phrasing change here is a
+ * semantic corpus change (bump `conformance/SPEC_VERSION`).
+ */
+/** kebab-case → space-separated words (`enemy-territory` → `enemy territory`). */
+export function dekebab(s) {
+    return s.replace(/-/g, " ");
+}
+function str(v) {
+    return typeof v === "string" ? v : String(v);
+}
+/** `2` + `objective` → `2+ objectives`. Nouns here are all regular plurals. */
+function count(n, noun) {
+    return `${str(n)}+ ${noun}s`;
+}
+export function describeCondition(c) {
+    // Compound nodes first — join the operands with lowercase connectives so the
+    // result reads naturally inside a "... when X and Y" clause.
+    if (c.operator === "and" && c.operands) {
+        return c.operands.map(describeCondition).join(" and ");
+    }
+    if (c.operator === "or" && c.operands) {
+        return c.operands.map(describeCondition).join(" or ");
+    }
+    if (c.operator === "not" && c.operands) {
+        return `not (${c.operands.map(describeCondition).join(", ")})`;
+    }
+    const negate = c.negated ? "not " : "";
+    const p = c.parameters ?? {};
+    switch (c.type) {
+        // ── Ability-DSL conditions (ported from commands/translate.ts) ──────────
+        case "phase-is":
+            return `${negate}during the ${str(p.phase)} phase`;
+        case "timing-is":
+            return `${negate}at ${dekebab(str(p.timing))}`;
+        case "player-turn-is":
+            return `${negate}in ${p.turn === "your-turn" ? "your" : p.turn === "opponent-turn" ? "the opponent's" : "either player's"} turn`;
+        case "charged-this-turn":
+            return `${negate}the unit charged this turn`;
+        case "advanced-this-turn":
+            return `${negate}the unit advanced this turn`;
+        case "remained-stationary":
+            return `${negate}the unit remained stationary`;
+        case "unit-below-starting-strength":
+            return `${negate}the unit is below starting strength`;
+        case "unit-below-half-strength":
+            return `${negate}the unit is below half strength`;
+        case "unit-has-keyword":
+            return `${negate}the unit has "${str(p.keyword)}"`;
+        case "target-has-keyword":
+            return `${negate}the target has "${str(p.keyword)}"`;
+        case "model-is-leader":
+            return `${negate}the model is leading a unit`;
+        case "is-attached":
+            return `${negate}attached to a ${p.keyword ? `${str(p.keyword)} ` : ""}unit`;
+        case "attack-is-type":
+            return `${negate}for ${str(p.attack_type)} attacks`;
+        case "is-battle-shocked":
+            return `${negate}the unit is battle-shocked`;
+        case "has-lost-wounds":
+            return `${negate}the model has lost wounds`;
+        case "opponent-unit-within-range":
+            return `${negate}an enemy unit is within ${p.range === "engagement" ? "engagement range" : `${str(p.range)}"`}`;
+        case "unit-within-range-of":
+            return `${negate}within ${str(p.range)}" of ${str(p.target_type ?? "target")}${p.keyword ? ` (${str(p.keyword)})` : ""}`;
+        case "within-range-of-objective":
+            return `${negate}within range of an objective`;
+        case "has-fought-this-phase":
+            return `${negate}has fought this phase`;
+        case "destroyed-by-attack-type":
+            return `${negate}destroyed by a ${str(p.attack_type)} attack`;
+        // ── Scoring conditions (secondary-card award `when`) ────────────────────
+        case "objective-majority":
+            return `${negate}you hold more objectives than the ${dekebab(str(p.relative_to ?? "opponent"))}`;
+        case "controls-objective": {
+            const noun = p.objective_role ? `${dekebab(str(p.objective_role))} objective` : "objective";
+            let s = `${negate}you control ${count(p.count_min ?? 1, noun)}`;
+            if (p.objective != null)
+                s += ` (${dekebab(str(p.objective))})`;
+            if (p.scope != null)
+                s += ` in ${dekebab(str(p.scope))}`;
+            if (p.exclude != null)
+                s += ` (excluding ${dekebab(str(p.exclude))})`;
+            return s;
+        }
+        case "units-destroyed":
+            return `${negate}${count(p.count_min ?? 1, `${str(p.side)} unit`)} destroyed ${dekebab(str(p.window))}`;
+        case "units-destroyed-comparison": {
+            const subj = (p.subject ?? {});
+            const ref = (p.reference ?? {});
+            const cmp = p.comparator === "greater-or-equal" ? "at least as many" : "more";
+            const link = p.comparator === "greater-or-equal" ? "as" : "than";
+            return `${negate}you destroyed ${cmp} ${str(subj.side)} units ${dekebab(str(subj.window))} ${link} ${str(ref.side)} units ${dekebab(str(ref.window))}`;
+        }
+        case "new-objective-controlled":
+            return `${negate}you newly control ${count(p.count_min ?? 1, "objective")} this turn`;
+        case "destroyed-while-on-objective": {
+            let s = `${negate}${count(p.count_min ?? 1, "enemy unit")} destroyed`;
+            if (p.destroyer_on_objective)
+                s += " by a unit on an objective";
+            if (p.victim_on_objective)
+                s += " while on an objective";
+            return s;
+        }
+        case "action-completed": {
+            let s = `${negate}${count(p.count_min ?? 1, "action")} completed`;
+            if (p.action_id != null)
+                s += ` (${dekebab(str(p.action_id))})`;
+            if (p.target_kind != null)
+                s += ` on ${dekebab(str(p.target_kind))}`;
+            const tf = (p.target_filter ?? {});
+            if (tf.objective_role != null)
+                s += ` (${dekebab(str(tf.objective_role))})`;
+            if (tf.in_enemy_territory)
+                s += " in enemy territory";
+            if (tf.exclude != null)
+                s += ` (excluding ${dekebab(str(tf.exclude))})`;
+            if (p.window != null)
+                s += ` ${dekebab(str(p.window))}`;
+            return s;
+        }
+        case "objective-has-tag": {
+            let s = `${negate}${count(p.count_min ?? 1, "objective")} tagged ${dekebab(str(p.tag))}`;
+            if (p.count_max != null)
+                s += ` (at most ${str(p.count_max)})`;
+            if (p.objective != null)
+                s += ` (${dekebab(str(p.objective))})`;
+            if (p.scope != null)
+                s += ` in ${dekebab(str(p.scope))}`;
+            if (p.last_marked)
+                s += " (most recently marked)";
+            return s;
+        }
+        case "unit-has-tag": {
+            let s = `${negate}${count(p.count_min ?? 1, `${str(p.side)} unit`)} tagged ${dekebab(str(p.tag))}`;
+            if (p.window != null)
+                s += ` (${dekebab(str(p.window))})`;
+            return s;
+        }
+        case "terrain-has-tag": {
+            let s = `${negate}terrain tagged ${dekebab(str(p.tag))}`;
+            if (p.friendly_units_min != null)
+                s += ` with ${str(p.friendly_units_min)}+ friendly units`;
+            if (p.enemy_units_max != null)
+                s += ` and at most ${str(p.enemy_units_max)} enemy units`;
+            if (p.last_marked)
+                s += " (most recently marked)";
+            if (p.in_enemy_dz)
+                s += " in the enemy deployment zone";
+            return s;
+        }
+        case "terrain-area-control":
+            return `${negate}you control a terrain area with ${str(p.min_models ?? 1)}+ models`;
+        case "territory-control": {
+            let s = `${negate}you control ${dekebab(str(p.territory_ref ?? "your-territory"))}`;
+            if (p.enemy_units_max != null)
+                s += ` with at most ${str(p.enemy_units_max)} enemy units`;
+            return s;
+        }
+        case "engagement-fronts":
+            return `${negate}you are engaged on ${str(p.count_min ?? 1)}+ fronts`;
+        default:
+            return `${negate}${dekebab(c.type ?? "unknown")}`;
+    }
+}
+//# sourceMappingURL=condition.js.map

package/dist/translate/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../src/translate/condition.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Humanize an Ability-DSL / scoring `condition` into plain English.\n *\n * Shared by the ability-text CLI (`commands/translate.ts`) and the scoring-card\n * translator (`scoring.ts`). Output is **ASCII-only** with a fixed clause and\n * parameter order: it is pinned byte-for-byte across the TS and Rust ports by\n * the `conformance/scoring-translation` corpus, so any phrasing change here is a\n * semantic corpus change (bump `conformance/SPEC_VERSION`).\n */\n\n/**\n * Minimal structural view of a condition node. Matches both the ability-dsl\n * condition schema and the `secondary-card` award `when` field (a simple node\n * carries `type` + `parameters` + `negated`; a compound node carries\n * `operator` + `operands`).\n */\nexport interface Condition {\n  type?: string;\n  operator?: \"and\" | \"or\" | \"not\";\n  operands?: Condition[];\n  parameters?: Record<string, unknown>;\n  negated?: boolean;\n}\n\n/** kebab-case → space-separated words (`enemy-territory` → `enemy territory`). */\nexport function dekebab(s: string): string {\n  return s.replace(/-/g, \" \");\n}\n\nfunction str(v: unknown): string {\n  return typeof v === \"string\" ? v : String(v);\n}\n\n/** `2` + `objective` → `2+ objectives`. Nouns here are all regular plurals. */\nfunction count(n: unknown, noun: string): string {\n  return `${str(n)}+ ${noun}s`;\n}\n\nexport function describeCondition(c: Condition): string {\n  // Compound nodes first — join the operands with lowercase connectives so the\n  // result reads naturally inside a \"... when X and Y\" clause.\n  if (c.operator === \"and\" && c.operands) {\n    return c.operands.map(describeCondition).join(\" and \");\n  }\n  if (c.operator === \"or\" && c.operands) {\n    return c.operands.map(describeCondition).join(\" or \");\n  }\n  if (c.operator === \"not\" && c.operands) {\n    return `not (${c.operands.map(describeCondition).join(\", \")})`;\n  }\n\n  const negate = c.negated ? \"not \" : \"\";\n  const p = c.parameters ?? {};\n\n  switch (c.type) {\n    // ── Ability-DSL conditions (ported from commands/translate.ts) ──────────\n    case \"phase-is\":\n      return `${negate}during the ${str(p.phase)} phase`;\n    case \"timing-is\":\n      return `${negate}at ${dekebab(str(p.timing))}`;\n    case \"player-turn-is\":\n      return `${negate}in ${p.turn === \"your-turn\" ? \"your\" : p.turn === \"opponent-turn\" ? \"the opponent's\" : \"either player's\"} turn`;\n    case \"charged-this-turn\":\n      return `${negate}the unit charged this turn`;\n    case \"advanced-this-turn\":\n      return `${negate}the unit advanced this turn`;\n    case \"remained-stationary\":\n      return `${negate}the unit remained stationary`;\n    case \"unit-below-starting-strength\":\n      return `${negate}the unit is below starting strength`;\n    case \"unit-below-half-strength\":\n      return `${negate}the unit is below half strength`;\n    case \"unit-has-keyword\":\n      return `${negate}the unit has \"${str(p.keyword)}\"`;\n    case \"target-has-keyword\":\n      return `${negate}the target has \"${str(p.keyword)}\"`;\n    case \"model-is-leader\":\n      return `${negate}the model is leading a unit`;\n    case \"is-attached\":\n      return `${negate}attached to a ${p.keyword ? `${str(p.keyword)} ` : \"\"}unit`;\n    case \"attack-is-type\":\n      return `${negate}for ${str(p.attack_type)} attacks`;\n    case \"is-battle-shocked\":\n      return `${negate}the unit is battle-shocked`;\n    case \"has-lost-wounds\":\n      return `${negate}the model has lost wounds`;\n    case \"opponent-unit-within-range\":\n      return `${negate}an enemy unit is within ${p.range === \"engagement\" ? \"engagement range\" : `${str(p.range)}\"`}`;\n    case \"unit-within-range-of\":\n      return `${negate}within ${str(p.range)}\" of ${str(p.target_type ?? \"target\")}${p.keyword ? ` (${str(p.keyword)})` : \"\"}`;\n    case \"within-range-of-objective\":\n      return `${negate}within range of an objective`;\n    case \"has-fought-this-phase\":\n      return `${negate}has fought this phase`;\n    case \"destroyed-by-attack-type\":\n      return `${negate}destroyed by a ${str(p.attack_type)} attack`;\n\n    // ── Scoring conditions (secondary-card award `when`) ────────────────────\n    case \"objective-majority\":\n      return `${negate}you hold more objectives than the ${dekebab(str(p.relative_to ?? \"opponent\"))}`;\n    case \"controls-objective\": {\n      const noun = p.objective_role ? `${dekebab(str(p.objective_role))} objective` : \"objective\";\n      let s = `${negate}you control ${count(p.count_min ?? 1, noun)}`;\n      if (p.objective != null) s += ` (${dekebab(str(p.objective))})`;\n      if (p.scope != null) s += ` in ${dekebab(str(p.scope))}`;\n      if (p.exclude != null) s += ` (excluding ${dekebab(str(p.exclude))})`;\n      return s;\n    }\n    case \"units-destroyed\":\n      return `${negate}${count(p.count_min ?? 1, `${str(p.side)} unit`)} destroyed ${dekebab(str(p.window))}`;\n    case \"units-destroyed-comparison\": {\n      const subj = (p.subject ?? {}) as Record<string, unknown>;\n      const ref = (p.reference ?? {}) as Record<string, unknown>;\n      const cmp = p.comparator === \"greater-or-equal\" ? \"at least as many\" : \"more\";\n      const link = p.comparator === \"greater-or-equal\" ? \"as\" : \"than\";\n      return `${negate}you destroyed ${cmp} ${str(subj.side)} units ${dekebab(str(subj.window))} ${link} ${str(ref.side)} units ${dekebab(str(ref.window))}`;\n    }\n    case \"new-objective-controlled\":\n      return `${negate}you newly control ${count(p.count_min ?? 1, \"objective\")} this turn`;\n    case \"destroyed-while-on-objective\": {\n      let s = `${negate}${count(p.count_min ?? 1, \"enemy unit\")} destroyed`;\n      if (p.destroyer_on_objective) s += \" by a unit on an objective\";\n      if (p.victim_on_objective) s += \" while on an objective\";\n      return s;\n    }\n    case \"action-completed\": {\n      let s = `${negate}${count(p.count_min ?? 1, \"action\")} completed`;\n      if (p.action_id != null) s += ` (${dekebab(str(p.action_id))})`;\n      if (p.target_kind != null) s += ` on ${dekebab(str(p.target_kind))}`;\n      const tf = (p.target_filter ?? {}) as Record<string, unknown>;\n      if (tf.objective_role != null) s += ` (${dekebab(str(tf.objective_role))})`;\n      if (tf.in_enemy_territory) s += \" in enemy territory\";\n      if (tf.exclude != null) s += ` (excluding ${dekebab(str(tf.exclude))})`;\n      if (p.window != null) s += ` ${dekebab(str(p.window))}`;\n      return s;\n    }\n    case \"objective-has-tag\": {\n      let s = `${negate}${count(p.count_min ?? 1, \"objective\")} tagged ${dekebab(str(p.tag))}`;\n      if (p.count_max != null) s += ` (at most ${str(p.count_max)})`;\n      if (p.objective != null) s += ` (${dekebab(str(p.objective))})`;\n      if (p.scope != null) s += ` in ${dekebab(str(p.scope))}`;\n      if (p.last_marked) s += \" (most recently marked)\";\n      return s;\n    }\n    case \"unit-has-tag\": {\n      let s = `${negate}${count(p.count_min ?? 1, `${str(p.side)} unit`)} tagged ${dekebab(str(p.tag))}`;\n      if (p.window != null) s += ` (${dekebab(str(p.window))})`;\n      return s;\n    }\n    case \"terrain-has-tag\": {\n      let s = `${negate}terrain tagged ${dekebab(str(p.tag))}`;\n      if (p.friendly_units_min != null) s += ` with ${str(p.friendly_units_min)}+ friendly units`;\n      if (p.enemy_units_max != null) s += ` and at most ${str(p.enemy_units_max)} enemy units`;\n      if (p.last_marked) s += \" (most recently marked)\";\n      if (p.in_enemy_dz) s += \" in the enemy deployment zone\";\n      return s;\n    }\n    case \"terrain-area-control\":\n      return `${negate}you control a terrain area with ${str(p.min_models ?? 1)}+ models`;\n    case \"territory-control\": {\n      let s = `${negate}you control ${dekebab(str(p.territory_ref ?? \"your-territory\"))}`;\n      if (p.enemy_units_max != null) s += ` with at most ${str(p.enemy_units_max)} enemy units`;\n      return s;\n    }\n    case \"engagement-fronts\":\n      return `${negate}you are engaged on ${str(p.count_min ?? 1)}+ fronts`;\n\n    default:\n      return `${negate}${dekebab(c.type ?? \"unknown\")}`;\n  }\n}\n"]}

package/dist/translate/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Plain-English translation of structured game data — currently the
+ * `secondary-card` scoring `awards` (mission "how to play" readouts) and the
+ * shared Ability-DSL condition humanizer. Output is ASCII-only and pinned
+ * across language ports by the `conformance/scoring-translation` corpus.
+ */
+export { describeCondition, dekebab, type Condition } from "./condition.js";
+export { describeTrigger, describeAward, describeScoringCard, type ScoringTrigger, type ScoringAward, } from "./scoring.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/translate/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/translate/index.js

@@ -0,0 +1,9 @@
+/**
+ * Plain-English translation of structured game data — currently the
+ * `secondary-card` scoring `awards` (mission "how to play" readouts) and the
+ * shared Ability-DSL condition humanizer. Output is ASCII-only and pinned
+ * across language ports by the `conformance/scoring-translation` corpus.
+ */
+export { describeCondition, dekebab } from "./condition.js";
+export { describeTrigger, describeAward, describeScoringCard, } from "./scoring.js";
+//# sourceMappingURL=index.js.map

package/dist/translate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/translate/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAkB,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,eAAe,EACf,aAAa,EACb,mBAAmB,GAGpB,MAAM,cAAc,CAAC","sourcesContent":["/**\n * Plain-English translation of structured game data — currently the\n * `secondary-card` scoring `awards` (mission \"how to play\" readouts) and the\n * shared Ability-DSL condition humanizer. Output is ASCII-only and pinned\n * across language ports by the `conformance/scoring-translation` corpus.\n */\nexport { describeCondition, dekebab, type Condition } from \"./condition.js\";\nexport {\n  describeTrigger,\n  describeAward,\n  describeScoringCard,\n  type ScoringTrigger,\n  type ScoringAward,\n} from \"./scoring.js\";\n"]}

package/dist/translate/scoring.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Humanize a `secondary-card` scoring `award` into plain English.
+ *
+ * Output is **ASCII-only** with a fixed clause order, pinned byte-for-byte
+ * across the TS and Rust ports by the `conformance/scoring-translation` corpus.
+ * The community `text` summary and the `actions` list are verbatim data, not
+ * translation, so they are not produced here — only the structured `awards`.
+ */
+import type { SecondaryCard } from "../generated.js";
+import { type Condition } from "./condition.js";
+/** When a VP award is evaluated (the `trigger` block on an award). */
+export interface ScoringTrigger {
+    timing?: "start-of-turn" | "end-of-turn" | "start-of-phase" | "end-of-phase" | "end-of-battle";
+    phase?: "command" | "movement" | "shooting" | "charge" | "fight";
+    player_turn?: "your-turn" | "opponent-turn" | "either";
+    battle_round?: {
+        min?: number;
+        max?: number;
+    };
+}
+/** One VP-award block on a scoring card. */
+export interface ScoringAward {
+    trigger?: ScoringTrigger;
+    when?: Condition;
+    vp?: number;
+    vp_per?: number;
+    per?: string;
+    per_max?: number;
+    cumulative?: boolean;
+    exclusive_group?: string;
+}
+/** "End of your Command phase (round 2+)" and friends. */
+export declare function describeTrigger(t: ScoringTrigger): string;
+/** "End of your Command phase (round 2+): 3 VP per controlled objective when ..." */
+export declare function describeAward(a: ScoringAward): string;
+/** Humanize every award on a card, in array order (the order is load-bearing). */
+export declare function describeScoringCard(card: SecondaryCard): string[];
+//# sourceMappingURL=scoring.d.ts.map

package/dist/translate/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/translate/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5E,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,gBAAgB,GAAG,cAAc,GAAG,eAAe,CAAC;IAC/F,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CAAC;IACvD,YAAY,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAyCzD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAiBrD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAGjE"}

package/dist/translate/scoring.js

@@ -0,0 +1,80 @@
+/**
+ * Humanize a `secondary-card` scoring `award` into plain English.
+ *
+ * Output is **ASCII-only** with a fixed clause order, pinned byte-for-byte
+ * across the TS and Rust ports by the `conformance/scoring-translation` corpus.
+ * The community `text` summary and the `actions` list are verbatim data, not
+ * translation, so they are not produced here — only the structured `awards`.
+ */
+import { describeCondition, dekebab } from "./condition.js";
+function capitalize(s) {
+    return s.length === 0 ? s : s[0].toUpperCase() + s.slice(1);
+}
+/** "End of your Command phase (round 2+)" and friends. */
+export function describeTrigger(t) {
+    const turn = t.player_turn === "opponent-turn"
+        ? "the opponent's"
+        : t.player_turn === "either"
+            ? "any"
+            : "your";
+    let base;
+    switch (t.timing) {
+        case "start-of-turn":
+            base = `Start of ${turn} turn`;
+            break;
+        case "end-of-turn":
+            base = `End of ${turn} turn`;
+            break;
+        case "start-of-phase":
+            base = `Start of ${turn} ${capitalize(t.phase ?? "")} phase`;
+            break;
+        case "end-of-phase":
+            base = `End of ${turn} ${capitalize(t.phase ?? "")} phase`;
+            break;
+        case "end-of-battle":
+            base = "End of the battle";
+            break;
+        default:
+            base = t.phase ? `During ${turn} ${capitalize(t.phase)} phase` : "Any time";
+    }
+    const br = t.battle_round;
+    if (br) {
+        const { min, max } = br;
+        if (min != null && max != null) {
+            base += min === max ? ` (round ${min})` : ` (rounds ${min}-${max})`;
+        }
+        else if (min != null) {
+            base += ` (round ${min}+)`;
+        }
+        else if (max != null) {
+            base += ` (rounds 1-${max})`;
+        }
+    }
+    return base;
+}
+/** "End of your Command phase (round 2+): 3 VP per controlled objective when ..." */
+export function describeAward(a) {
+    const trigger = a.trigger ? describeTrigger(a.trigger) : "Any time";
+    let amount;
+    if (a.vp != null) {
+        amount = `${a.vp} VP`;
+    }
+    else if (a.vp_per != null) {
+        amount = `${a.vp_per} VP per ${a.per ? dekebab(a.per) : "instance"}`;
+        if (a.per_max != null)
+            amount += ` (max ${a.per_max})`;
+    }
+    else {
+        amount = "no VP";
+    }
+    const prefix = a.cumulative ? "+ " : "";
+    const when = a.when ? ` when ${describeCondition(a.when)}` : "";
+    const tier = a.exclusive_group ? " [highest tier]" : "";
+    return `${prefix}${trigger}: ${amount}${when}${tier}`;
+}
+/** Humanize every award on a card, in array order (the order is load-bearing). */
+export function describeScoringCard(card) {
+    const awards = (card.awards ?? []);
+    return awards.map(describeAward);
+}
+//# sourceMappingURL=scoring.js.map

package/dist/translate/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/translate/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAkB,MAAM,gBAAgB,CAAC;AAsB5E,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,CAAiB;IAC/C,MAAM,IAAI,GACR,CAAC,CAAC,WAAW,KAAK,eAAe;QAC/B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,CAAC,CAAC,WAAW,KAAK,QAAQ;YAC1B,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,MAAM,CAAC;IAEf,IAAI,IAAY,CAAC;IACjB,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,eAAe;YAClB,IAAI,GAAG,YAAY,IAAI,OAAO,CAAC;YAC/B,MAAM;QACR,KAAK,aAAa;YAChB,IAAI,GAAG,UAAU,IAAI,OAAO,CAAC;YAC7B,MAAM;QACR,KAAK,gBAAgB;YACnB,IAAI,GAAG,YAAY,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC;YAC7D,MAAM;QACR,KAAK,cAAc;YACjB,IAAI,GAAG,UAAU,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC;YAC3D,MAAM;QACR,KAAK,eAAe;YAClB,IAAI,GAAG,mBAAmB,CAAC;YAC3B,MAAM;QACR;YACE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IAChF,CAAC;IAED,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC;IAC1B,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,GAAG,IAAI,GAAG,GAAG,CAAC;QACtE,CAAC;aAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,WAAW,GAAG,IAAI,CAAC;QAC7B,CAAC;aAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,cAAc,GAAG,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,CAAe;IAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAEpE,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;IACxB,CAAC;SAAM,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QACrE,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,OAAO,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,OAAO,GAAG,MAAM,GAAG,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,IAAmB;IACrD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAA8B,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC","sourcesContent":["/**\n * Humanize a `secondary-card` scoring `award` into plain English.\n *\n * Output is **ASCII-only** with a fixed clause order, pinned byte-for-byte\n * across the TS and Rust ports by the `conformance/scoring-translation` corpus.\n * The community `text` summary and the `actions` list are verbatim data, not\n * translation, so they are not produced here — only the structured `awards`.\n */\n\nimport type { SecondaryCard } from \"../generated.js\";\nimport { describeCondition, dekebab, type Condition } from \"./condition.js\";\n\n/** When a VP award is evaluated (the `trigger` block on an award). */\nexport interface ScoringTrigger {\n  timing?: \"start-of-turn\" | \"end-of-turn\" | \"start-of-phase\" | \"end-of-phase\" | \"end-of-battle\";\n  phase?: \"command\" | \"movement\" | \"shooting\" | \"charge\" | \"fight\";\n  player_turn?: \"your-turn\" | \"opponent-turn\" | \"either\";\n  battle_round?: { min?: number; max?: number };\n}\n\n/** One VP-award block on a scoring card. */\nexport interface ScoringAward {\n  trigger?: ScoringTrigger;\n  when?: Condition;\n  vp?: number;\n  vp_per?: number;\n  per?: string;\n  per_max?: number;\n  cumulative?: boolean;\n  exclusive_group?: string;\n}\n\nfunction capitalize(s: string): string {\n  return s.length === 0 ? s : s[0].toUpperCase() + s.slice(1);\n}\n\n/** \"End of your Command phase (round 2+)\" and friends. */\nexport function describeTrigger(t: ScoringTrigger): string {\n  const turn =\n    t.player_turn === \"opponent-turn\"\n      ? \"the opponent's\"\n      : t.player_turn === \"either\"\n        ? \"any\"\n        : \"your\";\n\n  let base: string;\n  switch (t.timing) {\n    case \"start-of-turn\":\n      base = `Start of ${turn} turn`;\n      break;\n    case \"end-of-turn\":\n      base = `End of ${turn} turn`;\n      break;\n    case \"start-of-phase\":\n      base = `Start of ${turn} ${capitalize(t.phase ?? \"\")} phase`;\n      break;\n    case \"end-of-phase\":\n      base = `End of ${turn} ${capitalize(t.phase ?? \"\")} phase`;\n      break;\n    case \"end-of-battle\":\n      base = \"End of the battle\";\n      break;\n    default:\n      base = t.phase ? `During ${turn} ${capitalize(t.phase)} phase` : \"Any time\";\n  }\n\n  const br = t.battle_round;\n  if (br) {\n    const { min, max } = br;\n    if (min != null && max != null) {\n      base += min === max ? ` (round ${min})` : ` (rounds ${min}-${max})`;\n    } else if (min != null) {\n      base += ` (round ${min}+)`;\n    } else if (max != null) {\n      base += ` (rounds 1-${max})`;\n    }\n  }\n  return base;\n}\n\n/** \"End of your Command phase (round 2+): 3 VP per controlled objective when ...\" */\nexport function describeAward(a: ScoringAward): string {\n  const trigger = a.trigger ? describeTrigger(a.trigger) : \"Any time\";\n\n  let amount: string;\n  if (a.vp != null) {\n    amount = `${a.vp} VP`;\n  } else if (a.vp_per != null) {\n    amount = `${a.vp_per} VP per ${a.per ? dekebab(a.per) : \"instance\"}`;\n    if (a.per_max != null) amount += ` (max ${a.per_max})`;\n  } else {\n    amount = \"no VP\";\n  }\n\n  const prefix = a.cumulative ? \"+ \" : \"\";\n  const when = a.when ? ` when ${describeCondition(a.when)}` : \"\";\n  const tier = a.exclusive_group ? \" [highest tier]\" : \"\";\n  return `${prefix}${trigger}: ${amount}${when}${tier}`;\n}\n\n/** Humanize every award on a card, in array order (the order is load-bearing). */\nexport function describeScoringCard(card: SecondaryCard): string[] {\n  const awards = (card.awards ?? []) as unknown as ScoringAward[];\n  return awards.map(describeAward);\n}\n"]}

package/dist/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAS3B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AA4CD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CA+E3B"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAS3B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AA6CD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CA+E3B"}

package/dist/validate.js

@@ -24,6 +24,7 @@ const SCHEMA_MAP = {
     "mission-matchups": "https://40kdc.dev/schemas/core/mission-matchup.schema.json",
     missions: "https://40kdc.dev/schemas/core/mission.schema.json",
     "secondary-cards": "https://40kdc.dev/schemas/core/secondary-card.schema.json",
+    "terrain-templates": "https://40kdc.dev/schemas/core/terrain-template.schema.json",
     "terrain-layouts": "https://40kdc.dev/schemas/core/terrain-layout.schema.json",
     "phase-mappings": "https://40kdc.dev/schemas/enrichment/phase-mapping.schema.json",
     "timing-flags": "https://40kdc.dev/schemas/enrichment/timing-flag.schema.json",