@alpaca-software/40kdc-data 0.5.11 → 0.5.14

package/schemas/core/roster.schema.json

@@ -39,12 +39,10 @@
       ],
       "description": "Resolved primary faction; null when the source faction could not be matched."
     },
-    "detachment_id": {
-      "oneOf": [
-        { "$ref": "../defs/common.schema.json#/$defs/entity-id" },
-        { "type": "null" }
-      ],
-      "description": "Resolved detachment; null when absent or unmatched."
+    "detachments": {
+      "type": "array",
+      "description": "Resolved detachments. 11e lists may field several detachments under a detachment-point cap; pre-11e lists carry zero or one. Order is load-bearing (source/parse order). Empty when the source declared no detachment.",
+      "items": { "$ref": "#/$defs/roster-detachment" }
     },
     "battle_size": {
       "oneOf": [
@@ -61,6 +59,10 @@
           "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }],
           "description": "Points ceiling parsed from the battle size (e.g. 2000), if known."
         },
+        "detachment_cap": {
+          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }],
+          "description": "11e detachment-point budget derived from the battle size (strike-force 3, incursion 2); null when the battle size is unknown. The sum of each detachment's `dp_cost` is meant to fit within this cap."
+        },
         "total_reported": {
           "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }],
           "description": "Total points as reported by the source roster's cost block."
@@ -71,7 +73,7 @@
           "description": "Sum of this roster's per-unit point values."
         }
       },
-      "required": ["declared_limit", "total_reported", "total_computed"],
+      "required": ["declared_limit", "detachment_cap", "total_reported", "total_computed"],
       "additionalProperties": false
     },
     "units": {
@@ -81,7 +83,7 @@
     "game_version": { "$ref": "../defs/game-version-ref.schema.json" },
     "diagnostics": { "$ref": "#/$defs/roster-diagnostics" }
   },
-  "required": ["name", "source", "faction_id", "detachment_id", "battle_size", "points", "units", "game_version", "diagnostics"],
+  "required": ["name", "source", "faction_id", "detachments", "battle_size", "points", "units", "game_version", "diagnostics"],
   "additionalProperties": false,
   "$defs": {
     "roster-resolved-ref": {
@@ -122,6 +124,19 @@
       "required": ["id", "raw_name", "resolved", "candidates"],
       "additionalProperties": false
     },
+    "roster-detachment": {
+      "type": "object",
+      "description": "One detachment selected on the roster, paired with its resolved detachment-point cost.",
+      "properties": {
+        "ref": { "$ref": "#/$defs/roster-resolved-ref" },
+        "dp_cost": {
+          "oneOf": [{ "type": "integer", "minimum": 0 }, { "type": "null" }],
+          "description": "Detachment-point cost (1–3) looked up from the resolved detachment entity's `detachment_points`. Null when the detachment is unresolved or the entity records no cost."
+        }
+      },
+      "required": ["ref", "dp_cost"],
+      "additionalProperties": false
+    },
     "roster-unit": {
       "type": "object",
       "properties": {
@@ -193,6 +208,7 @@
                   "weapon-unresolved",
                   "enhancement-unresolved",
                   "detachment-unresolved",
+                  "detachment-points-exceeded",
                   "battle-size-unmapped",
                   "points-mismatch",
                   "leader-attachment-inferred",

package/schemas/core/stratagem.schema.json

@@ -15,7 +15,7 @@
     "type": {
       "type": "string",
       "enum": ["battle-tactic", "strategic-ploy", "epic-deed", "wargear"],
-      "description": "GW-printed stratagem category from the card"
+      "description": "GW-printed stratagem category from the card. Optional: 11e faction packs omit it for newly introduced detachments, and the category has no in-game effect; absent when the source does not state one."
     },
     "detachment_id": {
       "oneOf": [
@@ -53,6 +53,6 @@
     },
     "game_version": { "$ref": "../defs/game-version-ref.schema.json" }
   },
-  "required": ["id", "name", "category", "type", "cp_cost", "phases", "player_turn", "timing", "game_version"],
+  "required": ["id", "name", "category", "cp_cost", "phases", "player_turn", "timing", "game_version"],
   "additionalProperties": false
 }

package/schemas/core/unit-composition.schema.json

@@ -28,6 +28,13 @@
           "base_size_mm": {
             "description": "This model's base. Absent when no base could be resolved for the model.",
             "$ref": "../defs/common.schema.json#/$defs/base-size"
+          },
+          "hull_shape_id": {
+            "description": "Optional reference to a hull-shape entity giving this model's 2D collision polygon, used instead of the circular/oval base footprint. By convention a model carrying this should set `base_size_mm.shape` to \"hull\".",
+            "oneOf": [
+              { "$ref": "../defs/common.schema.json#/$defs/entity-id" },
+              { "type": "null" }
+            ]
           }
         },
         "required": ["name", "min", "max"],

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

@@ -39,6 +39,20 @@
     },
     "effect": { "$ref": "effect.schema.json" },
     "scope": { "$ref": "scope.schema.json" },
+    "applies_to": {
+      "description": "Static, human-curated keyword filter naming which datasheet units this ability benefits, for roster-side highlighting. A unit matches when it carries every keyword in `required_keywords` (across its `keywords` + `faction_keywords`) and none in `excluded_keywords`. This is a denormalized projection distinct from the runtime `effect` condition tree (which mixes static class, runtime-granted markers, and timing gates and must not be scraped for scope). Absent/null means no resolvable unit scope — consumers render no highlight rather than guess.",
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "required_keywords": { "$ref": "../../defs/common.schema.json#/$defs/keyword-list" },
+            "excluded_keywords": { "$ref": "../../defs/common.schema.json#/$defs/keyword-list" }
+          },
+          "additionalProperties": false
+        },
+        { "type": "null" }
+      ]
+    },
     "interactions": {
       "type": "array",
       "items": {