@cxtms/cx-schema 1.9.258 → 1.9.259

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxtms/cx-schema",
-  "version": "1.9.258",
+  "version": "1.9.259",
   "description": "Schema validation package for CXTMS YAML modules",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/schemas/components/timeline.json

@@ -115,6 +115,30 @@
           "$ref": "../schemas.json#/definitions/component",
           "description": "Mobile-only component used for normal-mode events whose mapped status is 'active'; receives 'item' bound to the event"
         },
+        "itemGroups": {
+          "type": "object",
+          "description": "Mobile normal-mode visual grouping for adjacent events whose templated key resolves to the same non-empty value",
+          "properties": {
+            "key": {
+              "$ref": "../schemas.json#/definitions/templateExpression",
+              "description": "Resolved per event with item, index, and collection"
+            },
+            "accent": {
+              "$ref": "../schemas.json#/definitions/templateExpression",
+              "description": "Frame color resolved with group and collection"
+            },
+            "background": {
+              "$ref": "../schemas.json#/definitions/templateExpression",
+              "description": "Frame fill resolved with group and collection"
+            },
+            "headerTemplate": {
+              "$ref": "../schemas.json#/definitions/component",
+              "description": "Rendered once above the grouped members; receives group and collection"
+            }
+          },
+          "required": ["key"],
+          "additionalProperties": false
+        },
         "eventSources": {
           "type": "array",
           "description": "Data providers executed for the current visible range or tracking milestone source",

package/skills/cxtms-module-builder/ref-components-specialized.md

@@ -347,6 +347,7 @@ MUI Lab Timeline for chronological events or milestone-based tracking progress.
 | `startDate` / `endDate` | `string` | current week | Initial date range for normal mode |
 | `eventSources` | `EventSource[]` | — | GraphQL/static event sources |
 | `eventTemplate` | `ComponentProps` | — | Custom event template for normal mode |
+| `itemGroups` | `{key, accent?, background?, headerTemplate?}` | — | Mobile normal-mode grouping for consecutive events with the same non-empty key |
 | `milestones` | `Milestone[]` | `[]` | Tracking milestones |
 | `options.height` | `string \| number` | `400`/`auto` | Component height |
 | `options.showTodayMarker` | `boolean` | `true` | Today marker in normal mode |
@@ -364,6 +365,8 @@ MUI Lab Timeline for chronological events or milestone-based tracking progress.
 
 **Events:** `onEventClick` (data: `event`)
 
+On mobile vertical timelines, `itemGroups` frames adjacent runs of two or more events whose templated `key` resolves equally. Runs are order-sensitive; isolated or empty keys remain ungrouped. `headerTemplate`, `accent`, and `background` resolve with `group = { key, items, size, startIndex, endIndex }` and `collection`. Grouped event templates also receive `groupPosition` and `groupOffset`. Tracking mode ignores grouping.
+
 ```yaml
 component: timeline
 name: orderTimeline