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

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.2.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",
@@ -60,6 +61,7 @@
     "audit:coverage": "tsx src/cli.ts audit-coverage --write",
     "scrub:defensive-flag": "tsx src/scrub-defensive-flag.ts",
     "author:input": "tsx src/author-input.ts",
+    "author:seed": "tsx src/author-seed.ts",
     "author:propose": "tsx src/author-batch.ts propose",
     "author:repair": "tsx src/author-batch.ts repair",
     "author:apply": "tsx src/author-batch.ts apply",

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."
     }
   }
 }

package/schemas/core/secondary-card.schema.json

@@ -111,39 +111,55 @@
       "required": ["operation"],
       "additionalProperties": false
     },
-    "action": {
-      "type": "object",
-      "description": "Optional player action the card enables.",
-      "properties": {
-        "starts": {
-          "$ref": "../defs/common.schema.json#/$defs/phase",
-          "description": "Phase in which the action can be started."
-        },
-        "player_turn": { "$ref": "../defs/common.schema.json#/$defs/player-turn" },
-        "units": {
-          "$ref": "../enrichment/ability-dsl/condition.schema.json",
-          "description": "Eligibility predicate for which units may perform the action."
-        },
-        "use_limit": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "Maximum number of times the action may be performed."
-        },
-        "completes": {
-          "$ref": "../enrichment/ability-dsl/condition.schema.json",
-          "description": "Predicate for when the action is considered complete."
+    "actions": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Optional player actions the card enables. Most cards have a single action; a few (e.g. Observe Enemy, with separate Baited-removal and Spotted actions) have two distinct actions on the same card.",
+      "items": {
+        "type": "object",
+        "properties": {
+          "action_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Optional kebab-case identifier used to reference this action from `action-completed` conditions in `awards[].when`."
+          },
+          "starts": {
+            "$ref": "../defs/common.schema.json#/$defs/phase",
+            "description": "Phase in which the action can be started."
+          },
+          "player_turn": { "$ref": "../defs/common.schema.json#/$defs/player-turn" },
+          "units": {
+            "$ref": "../enrichment/ability-dsl/condition.schema.json",
+            "description": "Eligibility predicate for which units may perform the action."
+          },
+          "use_limit": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum number of times the action may be performed (per turn unless `use_limit_scope` says otherwise)."
+          },
+          "use_limit_scope": {
+            "type": "string",
+            "enum": ["per-turn", "per-game"],
+            "default": "per-turn",
+            "description": "Whether `use_limit` is enforced per turn or once per game (e.g. Recover the Relics / Find and Deny 'Overwhelming Force' is once per game)."
+          },
+          "completes": {
+            "$ref": "../enrichment/ability-dsl/condition.schema.json",
+            "description": "Predicate for when the action is considered complete."
+          },
+          "effect": {
+            "$ref": "../enrichment/ability-dsl/effect.schema.json",
+            "description": "Effect applied when the action completes (e.g. terrain-area-tag, objective-tag, or unit-tag to mark transient state)."
+          }
         },
-        "effect": {
-          "$ref": "../enrichment/ability-dsl/effect.schema.json",
-          "description": "Effect applied when the action completes (e.g. terrain-area-tag to mark transient state on a terrain piece)."
-        }
-      },
-      "additionalProperties": false
+        "additionalProperties": false
+      }
     },
     "awards": {
       "type": "array",
       "minItems": 1,
-      "description": "VP-award blocks: each scores when `trigger` fires and the optional `when` condition holds. An award scores either a flat `vp` or a count-scaled `vp_per` (VP per instance of the thing named by `per`). Awards accrue independently and sum; a card's '+ ... CUMULATIVE' rows are modelled as separate awards flagged `cumulative` for faithful round-trip.",
+      "description": "VP-award blocks: each scores when `trigger` fires and the optional `when` condition holds. An award scores either a flat `vp` or a count-scaled `vp_per` (VP per instance of the thing named by `per`). Awards accrue independently and sum; a card's '+ ... CUMULATIVE' rows are modelled as separate awards flagged `cumulative` for faithful round-trip. Awards sharing the same `exclusive_group` value within a card resolve as the highest-scoring single award fires (the card's literal 'OR' rows between tier breakpoints, e.g. Record-Breaking Mission's 3-Fronts vs 4-Fronts).",
       "items": {
         "type": "object",
         "properties": {
@@ -174,6 +190,12 @@
             "type": "boolean",
             "default": false,
             "description": "Marks an award the card shows as an additive '+' bonus to the preceding award in the same trigger block (the card's CUMULATIVE rows). Purely descriptive — all awards accrue independently and are summed."
+          },
+          "exclusive_group": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64,
+            "description": "Awards sharing this kebab-case group key resolve as 'score only the highest, not the sum' (the card's literal OR between tier rows). Awards with different `exclusive_group` values, or no value, accrue independently."
           }
         },
         "oneOf": [

package/schemas/core/terrain-layout.schema.json

@@ -2,84 +2,68 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://40kdc.dev/schemas/core/terrain-layout.schema.json",
   "title": "Terrain Layout",
-  "description": "A recommended arrangement of terrain pieces on the board, independent of the deployment map (a deployment-pattern references the layouts it recommends via recommended_terrain_layout_ids). Geometry is the source of truth; the GW standard piece templates are expressed as explicit footprints, with an optional descriptive `template` label. Footprints are deliberately open (not enum-locked) — the launch catalog and its size are unconfirmed, so this models any shape rather than a fixed set. No layout data is authored yet.",
+  "description": "A recommended arrangement of terrain pieces on the board, independent of the deployment map (a deployment-pattern references the layouts it recommends via recommended_terrain_layout_ids). Each piece draws its geometry from a catalog `template` (a terrain-template entity) or an inline `footprint`; geometry is the source of truth. Placement is template-centroid-anchored: `position` is the piece's centroid, which is invariant under rotation and mirror, so orientation and location are decoupled. Resolved board-space vertices are derived by the shared terrain resolver (pinned by the conformance corpus), never stored here. No layout data is authored yet beyond migrated examples.",
   "type": "object",
   "$defs": {
-    "footprint": {
-      "description": "A terrain piece's 2D footprint, relative to the piece's `position`. Axis-aligned rectangle, right triangle (right angle at the local origin, legs along +x/+y), or an explicit polygon. GW's standard templates (e.g. 7\"×11.5\" rectangles, 8\"×11.5\" right triangles, 6\"×4\" rectangles, 10\"×2.5\" and 6\"×2\" lines) are all expressible here; lines are thin rectangles.",
-      "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/common.schema.json#/$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."
-    },
     "piece": {
       "type": "object",
-      "description": "One terrain feature placed on the board.",
+      "description": "One terrain piece placed on the board. Geometry comes from a catalog `template` or an inline `footprint` (if both are present, `footprint` is authoritative and `template` is provenance).",
       "properties": {
+        "id": {
+          "$ref": "../defs/common.schema.json#/$defs/entity-id",
+          "description": "Layout-local id. Required for any piece referenced by another piece's `parent_area_id`."
+        },
         "name": { "type": "string", "minLength": 1, "maxLength": 128 },
-        "footprint": { "$ref": "#/$defs/footprint" },
+        "piece_type": {
+          "type": "string",
+          "enum": ["area", "feature"],
+          "default": "area",
+          "description": "An `area` is a gameplay terrain zone (the 11e 'terrain area'); a `feature` is physical scenery (walls, containers, pipes) placed on an area."
+        },
+        "template": {
+          "$ref": "../defs/common.schema.json#/$defs/entity-id",
+          "description": "Id of the terrain-template this piece instances. Footprint and defaults (height, blocking, keywords) are taken from that template unless overridden here."
+        },
+        "footprint": {
+          "$ref": "../defs/common.schema.json#/$defs/footprint",
+          "description": "Inline geometry, standing in for or overriding a template footprint. Authoritative when present."
+        },
         "position": {
           "$ref": "../defs/common.schema.json#/$defs/vec2",
-          "description": "Board-inch placement of the footprint's local origin."
+          "description": "Placement of the piece's CENTROID (the polygon area centroid of its footprint). Rotation- and mirror-invariant: changing `rotation_degrees` or `mirror` never moves this point. In board inches, unless the piece is a feature with `parent_area_id`, in which case it is in the parent area's centroid-local frame."
         },
         "rotation_degrees": {
           "type": "number",
           "minimum": 0,
           "exclusiveMaximum": 360,
-          "description": "Clockwise rotation of the footprint about `position`. Absent or 0 means axis-aligned."
+          "description": "Clockwise rotation about the centroid in the y-down board frame. Absent or 0 means the template's natural orientation."
         },
-        "template": {
+        "mirror": {
           "type": "string",
-          "minLength": 1,
-          "maxLength": 64,
-          "description": "Optional descriptive label for the GW standard template this piece uses (e.g. 'large-ruin', 'long-wall'). Free-form, not enum-locked — the geometry in `footprint` is authoritative."
+          "enum": ["none", "horizontal", "vertical"],
+          "default": "none",
+          "description": "Reflection applied in the centroid-local frame before rotation: `horizontal` negates local x (left-right flip), `vertical` negates local y."
+        },
+        "parent_area_id": {
+          "$ref": "../defs/common.schema.json#/$defs/entity-id",
+          "description": "For a feature: the layout-local id of the area it sits on. The feature's `position`/`rotation_degrees`/`mirror` are composed with the parent area's placement, so moving, rotating, or mirroring the area carries the feature with it."
+        },
+        "floor": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Ruin floor this piece occupies (0 = ground level)."
         },
         "height_inches": {
           "type": "number",
           "minimum": 0,
-          "description": "Height of the piece in inches. Gates Plunging Fire (a piece 3\" or taller confers +1 BS on ground-level targets)."
+          "description": "Height of the piece in inches; overrides the template default. Gates Plunging Fire (a piece 3\" or taller confers +1 BS on ground-level targets)."
         },
         "terrain_area_keywords": {
           "type": "array",
           "uniqueItems": true,
-          "description": "Terrain-area keywords this piece's area carries.",
-          "items": { "$ref": "#/$defs/terrain-area-keyword" }
+          "description": "Terrain-area keywords this piece's area carries; overrides the template default.",
+          "items": { "$ref": "../defs/common.schema.json#/$defs/terrain-area-keyword" }
         },
         "link_group": {
           "type": "string",
@@ -109,7 +93,9 @@
           "additionalProperties": false
         }
       },
-      "required": ["footprint", "position"],
+      "required": ["position"],
+      "if": { "not": { "required": ["template"] } },
+      "then": { "required": ["footprint"] },
       "additionalProperties": false
     }
   },

package/schemas/core/terrain-template.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://40kdc.dev/schemas/core/terrain-template.schema.json",
+  "title": "Terrain Template",
+  "description": "A reusable terrain piece in the standard catalog: a gameplay area (the 11e terrain-area templates) or a scenery feature (walls, containers, pipes, floor segments). Footprints are authored in natural local inches; the terrain resolver derives each footprint's polygon area centroid and re-centers on it, so a layout piece that instances a template places its centroid via the layout's `position`. An `area` template may carry an embedded `features` list — scenery placed in the area's centroid-local frame — making the template a reusable composition (e.g. a ruin with its walls). Placing such a template places all of its features, transformed by the area's own placement.",
+  "type": "object",
+  "$defs": {
+    "composed-feature": {
+      "type": "object",
+      "description": "A feature placed on an area template, positioned in the area's centroid-local frame (y-down inches). When the area is placed, rotated, or mirrored, its composed features are carried along.",
+      "properties": {
+        "id": {
+          "$ref": "../defs/common.schema.json#/$defs/entity-id",
+          "description": "Composition-local id for this feature instance."
+        },
+        "template": {
+          "$ref": "../defs/common.schema.json#/$defs/entity-id",
+          "description": "Id of the feature-kind terrain-template to place."
+        },
+        "position": {
+          "$ref": "../defs/common.schema.json#/$defs/vec2",
+          "description": "The feature's centroid in the area's centroid-local frame (origin at the area centroid, y-down inches)."
+        },
+        "rotation_degrees": {
+          "type": "number",
+          "minimum": 0,
+          "exclusiveMaximum": 360,
+          "description": "Clockwise rotation of the feature about its own centroid, within the area-local frame."
+        },
+        "mirror": {
+          "type": "string",
+          "enum": ["none", "horizontal", "vertical"],
+          "default": "none"
+        },
+        "floor": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Ruin floor this feature occupies (0 = ground level)."
+        }
+      },
+      "required": ["template", "position"],
+      "additionalProperties": false
+    }
+  },
+  "properties": {
+    "id": { "$ref": "../defs/common.schema.json#/$defs/entity-id" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "kind": {
+      "type": "string",
+      "enum": ["area", "feature"],
+      "description": "`area` = a gameplay terrain zone; `feature` = physical scenery placed on an area."
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Catalog or mission pack the template originates from."
+    },
+    "footprint": { "$ref": "../defs/common.schema.json#/$defs/footprint" },
+    "default_height_inches": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Default height in inches for pieces instancing this template. Gates Plunging Fire (>= 3\")."
+    },
+    "default_blocking": {
+      "type": "boolean",
+      "description": "Whether the template blocks line of sight / movement by default."
+    },
+    "ground_accessible": {
+      "type": "boolean",
+      "default": true,
+      "description": "Whether models may be placed on the ground footprint. `false` marks an elevated-only piece (a platform reachable only on its `upper_floor`, e.g. a gantry/catwalk) or a solid obstacle with no valid placement (e.g. a generator). Meaningful for `kind: \"feature\"`."
+    },
+    "upper_floor": {
+      "type": "object",
+      "description": "An elevated platform carried by this feature (e.g. a ruin's second storey). Its footprint is authored in the SAME local frame as `footprint` and re-centered on the GROUND footprint's polygon area centroid, so the two floors stay registered when the piece is placed, rotated, or mirrored. Non-resolved metadata: the terrain resolver does not emit it; authoring/visualization tools render it as an overlay. Meaningful for `kind: \"feature\"`.",
+      "properties": {
+        "footprint": { "$ref": "../defs/common.schema.json#/$defs/footprint" },
+        "floor": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 1,
+          "description": "Ruin floor this platform occupies (1 = first floor above ground)."
+        }
+      },
+      "required": ["footprint"],
+      "additionalProperties": false
+    },
+    "default_terrain_area_keywords": {
+      "type": "array",
+      "uniqueItems": true,
+      "description": "Terrain-area keywords areas of this template carry by default. Meaningful for `kind: \"area\"`.",
+      "items": { "$ref": "../defs/common.schema.json#/$defs/terrain-area-keyword" }
+    },
+    "features": {
+      "type": "array",
+      "description": "Composed scenery features, in the area's centroid-local frame. Only meaningful for `kind: \"area\"`.",
+      "items": { "$ref": "#/$defs/composed-feature" }
+    },
+    "game_version": { "$ref": "../defs/game-version-ref.schema.json" }
+  },
+  "required": ["id", "name", "kind", "footprint", "game_version"],
+  "additionalProperties": false
+}

package/schemas/enrichment/ability-dsl/condition.schema.json

@@ -11,7 +11,7 @@
     },
     "simple-condition": {
       "type": "object",
-      "$comment": "Board/meta-state and scoring predicates. `parameters` is intentionally open (additionalProperties: true); each type documents its own param convention. Scoring predicates added for mission cards: `units-destroyed` { side: 'enemy'|'friendly', window: 'this-turn'|'previous-turn', count_min: int } — at least count_min units of `side` were destroyed in `window`. `units-destroyed-comparison` { subject: {side, window}, comparator: 'greater-than'|'greater-or-equal', reference: {side, window} } — compares two destruction tallies (e.g. more enemy units destroyed this turn than friendly last turn). `objective-majority` { relative_to: 'opponent' } — you control more objectives than the named party. `controls-objective` params: { count_min: int, objective_role?: 'central', exclude?: 'home', objective?: 'opponent-home' }.",
+      "$comment": "Board/meta-state and scoring predicates. `parameters` is intentionally open (additionalProperties: true); each type documents its own param convention. Scoring predicates added for mission cards: `units-destroyed` { side: 'enemy'|'friendly', window: 'this-turn'|'previous-turn', count_min: int } — at least count_min units of `side` were destroyed in `window`. `units-destroyed-comparison` { subject: {side, window}, comparator: 'greater-than'|'greater-or-equal', reference: {side, window} } — compares two destruction tallies (e.g. more enemy units destroyed this turn than friendly last turn). `objective-majority` { relative_to: 'opponent' } — you control more objectives than the named party. `controls-objective` params: { count_min: int, objective_role?: 'central'|'expansion'|'non-home'|'home', exclude?: 'home', objective?: 'opponent-home'|'your-home', scope?: 'enemy-territory'|'your-territory' }. Mission-card extensions (11e primary deck): `action-completed` { action_id?: string, target_kind?: 'objective'|'terrain'|'enemy-unit'|'self', target_filter?: { in_enemy_territory?: bool, objective_role?: 'central'|'non-home', exclude?: 'home' }, count_min: int, window?: 'this-turn'|'previous-turn'|'cumulative' } — at least count_min instances of a named action were completed in the window. `objective-has-tag` { tag: 'baited'|'triangulated'|'consecrated'|'sabotaged'|'marked'|'vanguard'|'spotted', count_min: int, count_max?: int, objective?: 'opponent-home'|'your-home', scope?: 'enemy-territory'|'your-territory' } — at least count_min objectives carry the named transient tag. `unit-has-tag` { tag: 'doomed'|'spotted', side: 'enemy'|'friendly', count_min: int, window?: 'destroyed-this-turn'|'still-on-board' } — at least count_min units of `side` carry the tag (optionally with a destruction filter — Punishment scores when a Doomed unit was destroyed or left the battlefield). `terrain-has-tag` { tag: 'mined'|'marked'|'vanguard', friendly_units_min?: int, enemy_units_max?: int, last_marked?: bool, in_enemy_dz?: bool } — terrain piece state predicate; `last_marked` selects the most-recently-marked piece (Find and Deny / Recover the Relics' Overwhelming Force trigger). `new-objective-controlled` { count_min: int } — at least count_min objectives are controlled this turn that were not controlled in the previous command phase. `engagement-fronts` { count_min: int } — friendly units engage enemies in at least count_min distinct fronts; a 'front' is one of the territory zones from the deployment-pattern's `territories[]`, so this composes with the existing `territory-control` predicate. `destroyed-while-on-objective` { destroyer_on_objective?: bool, victim_on_objective?: bool, count_min: int } — count_min enemy units were destroyed this turn under the named spatial condition (the destroying friendly unit, the destroyed enemy unit, or both were standing on an objective at the moment of the kill).",
       "properties": {
         "type": {
           "type": "string",
@@ -27,7 +27,10 @@
             "destroyed-by-attack-type", "controls-objective", "is-attached",
             "terrain-area-control", "engagement-state", "territory-control",
             "fights-first", "disposition-matches",
-            "units-destroyed", "units-destroyed-comparison", "objective-majority"
+            "units-destroyed", "units-destroyed-comparison", "objective-majority",
+            "action-completed", "objective-has-tag", "unit-has-tag",
+            "terrain-has-tag", "new-objective-controlled",
+            "engagement-fronts", "destroyed-while-on-objective"
           ]
         },
         "parameters": { "type": "object", "additionalProperties": true },

package/schemas/enrichment/ability-dsl/effect.schema.json

@@ -30,6 +30,7 @@
             "model-destruction", "resurrection",
             "resource-gain", "resource-spend",
             "charge-roll-modifier", "terrain-area-tag",
+            "objective-tag", "unit-tag",
             "bs-modifier", "engagement-passthrough"
           ]
         },
@@ -45,7 +46,7 @@
         "modifier": { "type": "object", "additionalProperties": true }
       },
       "required": ["type", "target"],
-      "$comment": "When `type` is `re-roll`, `modifier` must carry `roll` (string) and `subset` (`ones` | `all-failures`). Rerolls always target failures; the subset decides whether only 1s are rerolled or every failed die. The constraint is enforced by AJV at validation time and stripped from the codegen bundle (typify can't model if/then/else) — the generated TS/Rust types therefore see `modifier` as an open object, matching its other-`type` callers. When `type` is `feel-no-pain`, `modifier` carries `threshold` (the FNP save target) and optionally `scope` ∈ {`all`, `mortal`}; an absent scope defaults to `all` (fires on every unsaved wound). The two scopes compose independently against the mortal-wound stream.",
+      "$comment": "When `type` is `re-roll`, `modifier` must carry `roll` (string) and `subset` (`ones` | `all-failures`). Rerolls always target failures; the subset decides whether only 1s are rerolled or every failed die. The constraint is enforced by AJV at validation time and stripped from the codegen bundle (typify can't model if/then/else) — the generated TS/Rust types therefore see `modifier` as an open object, matching its other-`type` callers. When `type` is `feel-no-pain`, `modifier` carries `threshold` (the FNP save target) and optionally `scope` ∈ {`all`, `mortal`}; an absent scope defaults to `all` (fires on every unsaved wound). The two scopes compose independently against the mortal-wound stream. Tag effects (`terrain-area-tag`, `objective-tag`, `unit-tag`) set a transient marker on the named subject; `modifier` carries `tag` (string) and optionally `source` ('this-action'|'destroying-unit') and `clears_on` ('turn-rollover'|'never'). `target` for tag effects names the kind of entity the tag is applied to ('unit', 'self') — a placeholder, since the marker target is the objective/terrain/unit specified by the action context, not a combat target.",
       "allOf": [
         {
           "if": {