cxtms 1.9.250 → 1.9.252

package/package.json

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

package/schemas/components/field-collection.json

@@ -210,6 +210,35 @@
             "isClosed": false
           }
         },
+        "onItemAdd": {
+          "$ref": "../schemas.json#/definitions/actionsList",
+          "description": "Actions fired after an item is added. Variables include parentItem, item, index, and fieldName."
+        },
+        "onItemRemove": {
+          "$ref": "../schemas.json#/definitions/actionsList",
+          "description": "Actions fired after an item is removed. Variables include parentItem, the removed item, index, and fieldName."
+        },
+        "dotsMenu": {
+          "type": "object",
+          "required": ["items"],
+          "properties": {
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["label"],
+                "properties": {
+                  "label": { "type": ["string", "object"] },
+                  "disabled": {},
+                  "permission": { "type": "string" },
+                  "onClick": { "$ref": "../schemas.json#/definitions/actionsList" },
+                  "remove": { "type": "boolean", "default": false }
+                }
+              }
+            }
+          },
+          "description": "Custom per-item menu. Items with remove=true invoke built-in collection removal; other items dispatch onClick."
+        },
         "groupMode": {
           "type": "boolean",
           "default": false,
@@ -264,6 +293,13 @@
             }
           ]
         },
+        "itemHeaderFields": {
+          "oneOf": [
+            { "type": "object" },
+            { "type": "array", "items": { "type": "object" } }
+          ],
+          "description": "Interactive components rendered in the always-visible accordion summary. Uses the same item/index/collection variables and field-name prefixing as itemTemplate."
+        },
         "groupTemplate": {
           "type": "object",
           "description": "Custom template for group headers",
@@ -390,7 +426,9 @@
         "showExpandAll": { "type": "boolean", "default": true },
         "collapseNested": { "type": "boolean", "default": true },
         "autoItemTitle": { "type": "boolean", "default": true },
-        "density": { "type": "string", "enum": ["compact", "comfortable"], "default": "compact" }
+        "density": { "type": "string", "enum": ["compact", "comfortable"], "default": "compact" },
+        "rowVariant": { "type": "string", "enum": ["card", "flat"], "default": "card", "description": "Row chrome: card uses a bordered panel; flat uses dividers while retaining the open-row accent." },
+        "nestedVariant": { "type": "string", "enum": ["panel", "rail", "none"], "default": "panel", "description": "Nested collection chrome: panel uses a box, rail uses a left border and indent, and none removes wrapper chrome." }
       }
     }
   },

package/schemas/components/module.json

@@ -135,7 +135,7 @@
     },
     "defaultData": {
       "type": "array",
-      "description": "Default data imports loaded with the module. Supported entities include reference/master data such as Terminal; Terminal rows match by Name unless keys are provided.",
+      "description": "Default data imports loaded with the module. Supported entities include reference/master data such as Terminal and EquipmentStatus; EquipmentStatus rows match by StatusName unless keys are provided.",
       "items": {
         "type": "object",
         "properties": {

package/schemas/components/planner.json

@@ -1 +1 @@
-{"$schema":"http://json-schema.org/draft-07/schema#","title":"Planner Component","type":"object","required":["component","props"],"properties":{"component":{"const":"planner"},"name":{"type":"string"},"props":{"type":"object","required":["queries","rows","columns","itemTemplate"],"properties":{"height":{},"refreshHandler":{"type":"string"},"debug":{"type":"boolean"},"options":{"type":"object","properties":{"enableVirtualization":{"type":"boolean"},"virtualizeThreshold":{"type":"number"},"estimatedRowHeight":{"type":"number"}},"additionalProperties":true},"queries":{"type":"array","minItems":1,"items":{"type":"object","required":["name","query"],"properties":{"name":{"type":"string"},"query":{"type":"object"},"itemsPath":{"type":"string"},"parentAs":{"type":"string"},"mapping":{"type":"object"}},"additionalProperties":true}},"rows":{"type":"object","required":["groupBy","headerWidth"],"properties":{"groupBy":{"type":"string"},"fromQuery":{"type":"string"},"key":{"type":"string"},"label":{},"orderBy":{"type":"array"},"unassigned":{"type":"object"},"headerWidth":{"type":"number"}},"additionalProperties":true},"columns":{"type":"object","required":["width"],"properties":{"orderBy":{"type":"array"},"appendEmpty":{"type":"boolean","description":"Keep one trailing empty slot beyond the largest group."},"label":{},"width":{"type":"number"}},"additionalProperties":true},"rowHeaderTemplate":{"$ref":"../schemas.json#/definitions/component"},"itemTemplate":{"$ref":"../schemas.json#/definitions/component"},"emptyCellTemplate":{"$ref":"../schemas.json#/definitions/component"},"summaryComponent":{"$ref":"../schemas.json#/definitions/component"},"emptyStateTemplate":{"$ref":"../schemas.json#/definitions/component"},"itemAccent":{},"events":{"type":"object","additionalProperties":{"$ref":"../schemas.json#/definitions/actionsList"}}},"additionalProperties":true}},"additionalProperties":true}
+{"$schema":"http://json-schema.org/draft-07/schema#","title":"Planner Component","type":"object","required":["component","props"],"properties":{"component":{"const":"planner"},"name":{"type":"string"},"props":{"type":"object","required":["queries","rows","columns","itemTemplate"],"properties":{"height":{},"refreshHandler":{"type":"string"},"debug":{"type":"boolean"},"options":{"type":"object","properties":{"enableVirtualization":{"type":"boolean"},"virtualizeThreshold":{"type":"number"},"estimatedRowHeight":{"type":"number"}},"additionalProperties":true},"queries":{"type":"array","minItems":1,"items":{"type":"object","required":["name","query"],"properties":{"name":{"type":"string"},"query":{"type":"object"},"itemsPath":{"type":"string"},"parentAs":{"type":"string"},"mapping":{"type":"object"}},"additionalProperties":true}},"rows":{"type":"object","required":["groupBy","headerWidth"],"properties":{"groupBy":{"type":"string"},"fromQuery":{"type":"string"},"key":{"type":"string"},"label":{},"orderBy":{"type":"array"},"unassigned":{"type":"object"},"headerWidth":{"type":"number"}},"additionalProperties":true},"columns":{"type":"object","required":["width"],"properties":{"orderBy":{"type":"array"},"appendEmpty":{"type":"boolean","description":"Keep one trailing empty slot beyond the largest group."},"label":{},"width":{"type":"number"}},"additionalProperties":true},"rowHeaderTemplate":{"$ref":"../schemas.json#/definitions/component"},"itemTemplate":{"$ref":"../schemas.json#/definitions/component"},"emptyCellTemplate":{"$ref":"../schemas.json#/definitions/component"},"summaryComponent":{"$ref":"../schemas.json#/definitions/component"},"emptyStateTemplate":{"$ref":"../schemas.json#/definitions/component"},"itemAccent":{},"dragSource":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"data":{},"canDrag":{}},"additionalProperties":false},"events":{"type":"object","additionalProperties":{"$ref":"../schemas.json#/definitions/actionsList"}}},"additionalProperties":true}},"additionalProperties":true}

package/schemas/fields/datetime.json

@@ -4,6 +4,7 @@
   "description": "Schema for datetime input field type",
   "type": "object",
   "properties": {
+    "displayMode": { "type": "string", "enum": ["readEdit"], "description": "Show the formatted value as text until clicked, then return to read display on blur." },
     "type": { "type": "string", "const": "datetime" },
     "label": {
       "oneOf": [{ "type": "string" }, { "$ref": "../schemas.json#/definitions/localized" }],

package/schemas/fields/select-async.json

@@ -30,6 +30,11 @@
       "description": "Whether field is disabled",
       "x-example": false
     },
+    "displayMode": {
+      "type": "string",
+      "enum": ["readEdit"],
+      "description": "Show the resolved option label as text until clicked, then return to read display on blur."
+    },
     "options": {
       "type": "object",
       "description": "Select-async specific options",

package/schemas/fields/time.json

@@ -4,6 +4,7 @@
   "description": "Schema for time input field type",
   "type": "object",
   "properties": {
+    "displayMode": { "type": "string", "enum": ["readEdit"], "description": "Show the formatted value as text until clicked, then return to read display on blur." },
     "type": {
       "type": "string",
       "const": "time"
@@ -88,4 +89,4 @@
     }
   },
   "required": ["type"]
-}
+}

package/schemas/schemas.json

@@ -291,8 +291,8 @@
           "description": "Enable dynamic grid features"
         },
         "enableViews": {
-          "type": "boolean",
-          "description": "Enable view switching"
+          "type": ["boolean", "string"],
+          "description": "Enable view switching. String templates are resolved against component variables and store state."
         },
         "enableSearch": {
           "type": "boolean",
@@ -307,8 +307,8 @@
           "description": "Enable column management"
         },
         "enableFilter": {
-          "type": "boolean",
-          "description": "Enable filtering"
+          "type": ["boolean", "string"],
+          "description": "Enable filtering. String templates are resolved against component variables and store state."
         },
         "defaultView": {
           "type": "string",

package/schemas/workflows/flow/transition.json

@@ -17,7 +17,7 @@
       "oneOf": [
         {
           "type": "string",
-          "description": "Single source state name, or '*' for wildcard (any non-final state)."
+          "description": "Single source state name, or '*' for wildcard (any non-final state except the transition's own target state)."
         },
         {
           "type": "array",

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

@@ -45,11 +45,11 @@ Full-featured data table with views, filtering, sorting, pagination, and row act
 | `includeEntityKeysInExport` | `boolean` | `true` | Force `entityKeys`/primary keys into exports even when hidden, preserving ID-first re-import matching. Set `false` for id-less templates or cross-space copies. |
 | `navigationType` | `navigate \| dialog \| store` | — | **Required.** Row click behavior |
 | `enableDynamicGrid` | `boolean` | — | Enable dynamic columns |
-| `enableViews` | `boolean` | — | Show view selector |
+| `enableViews` | `boolean \| template` | — | Show view selector; templates resolve against variables and store |
 | `enableSearch` | `boolean` | — | Show search input |
 | `enablePagination` | `boolean` | — | Show pagination |
 | `enableColumns` | `boolean` | — | Show column selector |
-| `enableFilter` | `boolean` | — | Show filter panel |
+| `enableFilter` | `boolean \| template` | — | Show filter panel; templates resolve against variables and store |
 | `defaultView` | `string` | — | Default view name |
 | `defaultPageSize` | `number` | `20` | Rows per page |
 | `enableRefresh` | `boolean` | — | Auto-refresh |

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

@@ -593,6 +593,9 @@ When `options.allowRemove` is enabled and the item count is above `minItems`, re
 | `addButton.icon` | `string` | `plus` | Add button icon |
 | `addButton.position` | `top \| bottom \| both` | `bottom` | Add button placement |
 | `defaultItem` | `any` | — | Template for new items |
+| `onItemAdd` | `action[]` | — | Fires after add with `parentItem`, new `item`, `index`, and `fieldName` |
+| `onItemRemove` | `action[]` | — | Fires after removal with `parentItem`, removed `item`, `index`, and `fieldName` |
+| `dotsMenu.items` | `{label,disabled?,permission?,onClick?,remove?}[]` | Delete only | Custom per-item menu; `remove: true` invokes built-in soft/hard removal |
 | `layout` | `list \| grid \| accordion` | `list` | Layout mode |
 | `cols` | `number` | `1` | Grid columns (non-responsive). For adaptive item layouts, set `cols: 1` and use a `layout` inside `itemTemplate` with `itemDefaults.size: { xs, md }`. |
 | `groupCols` | `number \| {xs,sm,md,lg,xl}` | `1` | Group columns when `groupMode` is true |
@@ -623,6 +626,11 @@ the header unless its position is explicit. Nested collections collapse by defau
 records expand automatically. `itemIcon`, `itemSubtitle`, and badge/count templates receive the
 parent variables plus `item`, `index`, and the item's own fields.
 
+Add/remove hooks support live persistence rather than waiting for a parent form submit. Custom
+menu actions receive the same row variables. A field's `onBlur` action receives its current value
+as `changedValues`, and placeholders inside item templates can reference `item`, `index`, and
+`parentItem`.
+
 ```yaml
 component: field-collection
 name: lineItems
@@ -673,6 +681,10 @@ props:
 
 Grouped collections can render groups in multiple columns. Use a fixed `groupCols` count or responsive breakpoint counts; each count is converted to Material UI's 12-column grid.
 
+Accordion collections support `itemHeaderFields` for interactive fields that remain visible while a row is collapsed. The header fields share `item`, `index`, `collection`, and field-name prefixing with `itemTemplate`; wrap them in a `layout` for grid sizing. Use `rowVariant: flat` and `nestedVariant: rail` or `none` to reduce card chrome in nested collections.
+
+For `datetime`, `time`, and `select-async` fields, `displayMode: readEdit` renders the current value as text until clicked and returns to text on blur.
+
 ```yaml
 component: field-collection
 name: businessHours

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

@@ -471,6 +471,8 @@ Optional templates cover row headers, empty cells/state, and summaries. Events a
 
 Set `columns.appendEmpty: true` to render one trailing empty ordinal slot beyond the largest group, ensuring every lane has an append target.
 
+Set `props.dragSource` to make planner cards draggable between lanes. It uses the shared `type`, optional `data`, and optional templated `canDrag` contract; target cells receive the payload through `dragItem` and `dragType`. Native dragging is desktop-only, so keep a click-driven equivalent.
+
 ## timeline-grid
 
 CSS Grid-based timeline with swim lanes, drill-down, and virtual scrolling.

package/skills/cxtms-workflow-builder/ref-flow.md

@@ -175,7 +175,7 @@ For Order-triggered auto-transitions, `order.orderStatusName` is available in th
 ### From States
 - Single state: `from: Draft`
 - Multiple states: `from: [Draft, Submitted]`
-- Wildcard (any non-final state): `from: "*"`
+- Wildcard (any non-final state other than the transition's own target): `from: "*"`. This prevents a wildcard transition from repeatedly transitioning an entity into its current state; matching is case-insensitive.
 
 ### Execution Order
 1. Validate transition from current state