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

package/dist/terrain/resolve.js

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

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/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",

package/dist/validate.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import type Ajv from \"ajv\";\nimport { readFileSync } from \"node:fs\";\nimport { glob } from \"glob\";\nimport { resolve, basename } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\nexport interface ValidationError {\n  file: string;\n  index: number;\n  errors: Array<{ path: string; message: string }>;\n}\n\nexport interface ValidationResult {\n  totalFiles: number;\n  totalItems: number;\n  passed: number;\n  failed: number;\n  errors: ValidationError[];\n}\n\n/**\n * Map from data file base-name prefix to schema $id.\n */\nconst SCHEMA_MAP: Record<string, string> = {\n  factions: \"https://40kdc.dev/schemas/core/faction.schema.json\",\n  units: \"https://40kdc.dev/schemas/core/unit.schema.json\",\n  weapons: \"https://40kdc.dev/schemas/core/weapon.schema.json\",\n  \"weapon-keywords\": \"https://40kdc.dev/schemas/core/weapon-keyword.schema.json\",\n  \"game-versions\": \"https://40kdc.dev/schemas/core/game-version.schema.json\",\n  detachments: \"https://40kdc.dev/schemas/core/detachment.schema.json\",\n  enhancements: \"https://40kdc.dev/schemas/core/enhancement.schema.json\",\n  stratagems: \"https://40kdc.dev/schemas/core/stratagem.schema.json\",\n  \"wargear-options\": \"https://40kdc.dev/schemas/core/wargear-option.schema.json\",\n  \"leader-attachments\": \"https://40kdc.dev/schemas/core/leader-attachment.schema.json\",\n  \"unit-compositions\": \"https://40kdc.dev/schemas/core/unit-composition.schema.json\",\n  \"force-dispositions\": \"https://40kdc.dev/schemas/core/force-disposition.schema.json\",\n  \"deployment-patterns\": \"https://40kdc.dev/schemas/core/deployment-pattern.schema.json\",\n  \"mission-matchups\": \"https://40kdc.dev/schemas/core/mission-matchup.schema.json\",\n  missions: \"https://40kdc.dev/schemas/core/mission.schema.json\",\n  \"secondary-cards\": \"https://40kdc.dev/schemas/core/secondary-card.schema.json\",\n  \"terrain-layouts\": \"https://40kdc.dev/schemas/core/terrain-layout.schema.json\",\n  \"phase-mappings\": \"https://40kdc.dev/schemas/enrichment/phase-mapping.schema.json\",\n  \"timing-flags\": \"https://40kdc.dev/schemas/enrichment/timing-flag.schema.json\",\n  \"interaction-flags\": \"https://40kdc.dev/schemas/enrichment/interaction-flag.schema.json\",\n  abilities: \"https://40kdc.dev/schemas/enrichment/ability-dsl/ability.schema.json\",\n  \"resource-pools\": \"https://40kdc.dev/schemas/enrichment/resource-pool.schema.json\",\n};\n\n/**\n * Determine which schema $id to use for a given data file path.\n * Convention: the file's base name prefix (before the first dot) maps to a schema.\n */\nfunction resolveSchemaId(filePath: string): string | null {\n  const base = basename(filePath);\n  for (const [prefix, schemaId] of Object.entries(SCHEMA_MAP)) {\n    if (base.startsWith(prefix)) {\n      return schemaId;\n    }\n  }\n  return null;\n}\n\n/**\n * Validate all data files matching the given glob pattern.\n * Each data file is expected to be a JSON array; each element is validated individually.\n */\nexport async function validateFiles(\n  ajv: Ajv,\n  pattern: string,\n  cwd?: string,\n): Promise<ValidationResult> {\n  const root = cwd ?? DATA_ROOT;\n  const files = await glob(pattern, { cwd: root, absolute: true });\n\n  const result: ValidationResult = {\n    totalFiles: files.length,\n    totalItems: 0,\n    passed: 0,\n    failed: 0,\n    errors: [],\n  };\n\n  for (const file of files) {\n    const schemaId = resolveSchemaId(file);\n    if (!schemaId) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `No schema mapping found for file: ${basename(file)}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    const validate = ajv.getSchema(schemaId);\n    if (!validate) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `Schema not found: ${schemaId}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    let data: unknown;\n    try {\n      const raw = readFileSync(file, \"utf-8\");\n      data = JSON.parse(raw);\n    } catch (err) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `Failed to parse JSON: ${(err as Error).message}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    if (!Array.isArray(data)) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: \"Data file must be a JSON array\" }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    for (let i = 0; i < data.length; i++) {\n      result.totalItems++;\n      const valid = validate(data[i]);\n      if (valid) {\n        result.passed++;\n      } else {\n        result.failed++;\n        result.errors.push({\n          file,\n          index: i,\n          errors: (validate.errors ?? []).map((e) => ({\n            path: e.instancePath || \"/\",\n            message: e.message ?? \"Unknown validation error\",\n          })),\n        });\n      }\n    }\n  }\n\n  return result;\n}\n"]}
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import type Ajv from \"ajv\";\nimport { readFileSync } from \"node:fs\";\nimport { glob } from \"glob\";\nimport { resolve, basename } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = fileURLToPath(new URL(\".\", import.meta.url));\nconst DATA_ROOT = resolve(__dirname, \"../../data\");\n\nexport interface ValidationError {\n  file: string;\n  index: number;\n  errors: Array<{ path: string; message: string }>;\n}\n\nexport interface ValidationResult {\n  totalFiles: number;\n  totalItems: number;\n  passed: number;\n  failed: number;\n  errors: ValidationError[];\n}\n\n/**\n * Map from data file base-name prefix to schema $id.\n */\nconst SCHEMA_MAP: Record<string, string> = {\n  factions: \"https://40kdc.dev/schemas/core/faction.schema.json\",\n  units: \"https://40kdc.dev/schemas/core/unit.schema.json\",\n  weapons: \"https://40kdc.dev/schemas/core/weapon.schema.json\",\n  \"weapon-keywords\": \"https://40kdc.dev/schemas/core/weapon-keyword.schema.json\",\n  \"game-versions\": \"https://40kdc.dev/schemas/core/game-version.schema.json\",\n  detachments: \"https://40kdc.dev/schemas/core/detachment.schema.json\",\n  enhancements: \"https://40kdc.dev/schemas/core/enhancement.schema.json\",\n  stratagems: \"https://40kdc.dev/schemas/core/stratagem.schema.json\",\n  \"wargear-options\": \"https://40kdc.dev/schemas/core/wargear-option.schema.json\",\n  \"leader-attachments\": \"https://40kdc.dev/schemas/core/leader-attachment.schema.json\",\n  \"unit-compositions\": \"https://40kdc.dev/schemas/core/unit-composition.schema.json\",\n  \"force-dispositions\": \"https://40kdc.dev/schemas/core/force-disposition.schema.json\",\n  \"deployment-patterns\": \"https://40kdc.dev/schemas/core/deployment-pattern.schema.json\",\n  \"mission-matchups\": \"https://40kdc.dev/schemas/core/mission-matchup.schema.json\",\n  missions: \"https://40kdc.dev/schemas/core/mission.schema.json\",\n  \"secondary-cards\": \"https://40kdc.dev/schemas/core/secondary-card.schema.json\",\n  \"terrain-templates\": \"https://40kdc.dev/schemas/core/terrain-template.schema.json\",\n  \"terrain-layouts\": \"https://40kdc.dev/schemas/core/terrain-layout.schema.json\",\n  \"phase-mappings\": \"https://40kdc.dev/schemas/enrichment/phase-mapping.schema.json\",\n  \"timing-flags\": \"https://40kdc.dev/schemas/enrichment/timing-flag.schema.json\",\n  \"interaction-flags\": \"https://40kdc.dev/schemas/enrichment/interaction-flag.schema.json\",\n  abilities: \"https://40kdc.dev/schemas/enrichment/ability-dsl/ability.schema.json\",\n  \"resource-pools\": \"https://40kdc.dev/schemas/enrichment/resource-pool.schema.json\",\n};\n\n/**\n * Determine which schema $id to use for a given data file path.\n * Convention: the file's base name prefix (before the first dot) maps to a schema.\n */\nfunction resolveSchemaId(filePath: string): string | null {\n  const base = basename(filePath);\n  for (const [prefix, schemaId] of Object.entries(SCHEMA_MAP)) {\n    if (base.startsWith(prefix)) {\n      return schemaId;\n    }\n  }\n  return null;\n}\n\n/**\n * Validate all data files matching the given glob pattern.\n * Each data file is expected to be a JSON array; each element is validated individually.\n */\nexport async function validateFiles(\n  ajv: Ajv,\n  pattern: string,\n  cwd?: string,\n): Promise<ValidationResult> {\n  const root = cwd ?? DATA_ROOT;\n  const files = await glob(pattern, { cwd: root, absolute: true });\n\n  const result: ValidationResult = {\n    totalFiles: files.length,\n    totalItems: 0,\n    passed: 0,\n    failed: 0,\n    errors: [],\n  };\n\n  for (const file of files) {\n    const schemaId = resolveSchemaId(file);\n    if (!schemaId) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `No schema mapping found for file: ${basename(file)}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    const validate = ajv.getSchema(schemaId);\n    if (!validate) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `Schema not found: ${schemaId}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    let data: unknown;\n    try {\n      const raw = readFileSync(file, \"utf-8\");\n      data = JSON.parse(raw);\n    } catch (err) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: `Failed to parse JSON: ${(err as Error).message}` }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    if (!Array.isArray(data)) {\n      result.errors.push({\n        file,\n        index: -1,\n        errors: [{ path: \"\", message: \"Data file must be a JSON array\" }],\n      });\n      result.failed++;\n      continue;\n    }\n\n    for (let i = 0; i < data.length; i++) {\n      result.totalItems++;\n      const valid = validate(data[i]);\n      if (valid) {\n        result.passed++;\n      } else {\n        result.failed++;\n        result.errors.push({\n          file,\n          index: i,\n          errors: (validate.errors ?? []).map((e) => ({\n            path: e.instancePath || \"/\",\n            message: e.message ?? \"Unknown validation error\",\n          })),\n        });\n      }\n    }\n  }\n\n  return result;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpaca-software/40kdc-data",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "The 40kdc Warhammer 40K dataset behind a linked, typed API — find units, follow them to their weapons, abilities, phases, and factions. Also validates data against the canonical JSON Schemas.",
   "keywords": [
@@ -52,6 +52,7 @@
     "codegen:data": "tsx src/codegen-data.ts",
     "gen:conformance": "tsx src/gen-conformance.ts",
     "docs:api": "typedoc",
+    "docs:api:html": "typedoc --options typedoc.html.json",
     "link:abilities": "tsx src/link-abilities.ts",
     "validate": "tsx src/cli.ts validate-all",
     "validate:core": "tsx src/cli.ts validate-core",

package/schemas/$defs/common.schema.json

@@ -81,6 +81,49 @@
       },
       "required": ["x", "y"],
       "additionalProperties": false
+    },
+    "footprint": {
+      "description": "A terrain piece's 2D footprint in local inches (y-down): an axis-aligned rectangle with its min corner at the local origin, a right triangle with the right angle at the local origin and legs along +x/+y, or an explicit polygon (>= 3 points). The placement resolver re-centers the footprint on its polygon area centroid, so the local-origin convention does not affect where the piece lands — only its shape matters.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": { "const": "rectangle" },
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 }
+          },
+          "required": ["type", "width", "height"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": { "const": "right-triangle" },
+            "width": { "type": "number", "exclusiveMinimum": 0 },
+            "height": { "type": "number", "exclusiveMinimum": 0 }
+          },
+          "required": ["type", "width", "height"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": { "const": "polygon" },
+            "points": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/vec2" },
+              "minItems": 3
+            }
+          },
+          "required": ["type", "points"],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "terrain-area-keyword": {
+      "type": "string",
+      "enum": ["obscuring", "hidden", "plunging-fire"],
+      "description": "An 11e terrain-area keyword. Confirmed launch set; extend as further keywords publish on dataslate."
     }
   }
 }