cxtms 1.9.268 → 1.9.270

package/package.json

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

package/schemas/actions/all.json

@@ -27,6 +27,7 @@
     { "$ref": "resetDirtyState.json" },
     { "$ref": "clipboard.json" },
     { "$ref": "sound.json" },
-    { "$ref": "vibrate.json" }
+    { "$ref": "vibrate.json" },
+    { "$ref": "assistantContext.json" }
   ]
 }

package/schemas/actions/assistantContext.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "assistantContext Action",
+  "type": "object",
+  "properties": {
+    "assistantContext": {
+      "type": "object",
+      "properties": {
+        "kind": { "type": "string", "enum": ["page", "record", "dialog"], "default": "record" },
+        "name": { "$ref": "../schemas.json#/definitions/localized" },
+        "icon": { "type": "string" },
+        "data": { "type": "object", "additionalProperties": true },
+        "questions": {
+          "type": "array",
+          "maxItems": 5,
+          "items": { "$ref": "../schemas.json#/definitions/localized" }
+        },
+        "agent": { "type": "string", "description": "Agent model ID; falls back to the active agent when unavailable" },
+        "open": { "type": "boolean", "default": false }
+      },
+      "required": ["name"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["assistantContext"],
+  "additionalProperties": false
+}

package/schemas/components/appComponent.json

@@ -33,6 +33,23 @@
             "order": {
               "type": "integer",
               "description": "Order of the component in the target slot"
+            },
+            "assistantContext": {
+              "type": "object",
+              "description": "Live structured context published to the AI Assistant while this component is mounted",
+              "properties": {
+                "kind": { "type": "string", "enum": ["page", "record", "dialog"] },
+                "name": { "$ref": "../schemas.json#/definitions/localized" },
+                "icon": { "type": "string" },
+                "data": { "type": "object", "additionalProperties": true },
+                "questions": {
+                  "type": "array",
+                  "maxItems": 5,
+                  "items": { "$ref": "../schemas.json#/definitions/localized" }
+                }
+              },
+              "required": ["name"],
+              "additionalProperties": false
             }
           },
           "additionalProperties": true

package/schemas/components/tab.json

@@ -23,6 +23,11 @@
         },
         "isHidden": {
           "$ref": "../schemas.json#/definitions/templateExpression"
+        },
+        "contentCard": {
+          "type": "boolean",
+          "default": true,
+          "description": "Wrap this tab's content in a card when the parent tabs layout is cards"
         }
       }
     },

package/schemas/components/tabs.json

@@ -39,6 +39,12 @@
         "defaultTab": {
           "type": "string",
           "description": "Default active tab name"
+        },
+        "layout": {
+          "type": "string",
+          "enum": ["cards", "classic"],
+          "default": "cards",
+          "description": "cards separates the tab strip and active content; classic keeps them in one card"
         }
       }
     },

package/schemas/fields/attachment.json

@@ -51,6 +51,16 @@
           "description": "Camera capture quality setting",
           "default": "high"
         },
+        "enableZoom": {
+          "type": "boolean",
+          "description": "On mobile, show camera zoom controls and remember the selected zoom per field",
+          "default": false
+        },
+        "cameraZoom": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "description": "Initial camera zoom factor; on mobile it is clamped to the device-supported range"
+        },
         "captureFormat": {
           "type": "string",
           "enum": ["jpeg", "png"],

package/skills/cxtms-module-builder/SKILL.md

@@ -287,6 +287,17 @@ components:
 
 ## Action Types
 
+Use `assistantContext` to add structured AI context from an event. It requires `name`; supports `kind` (`page`, `record`, or `dialog`), `icon`, template-resolved `data`, up to five `questions`, an optional agent model ID, and `open: true`. It adds immediately to an empty chat and proposes the context once messages exist.
+
+```yaml
+- assistantContext:
+    kind: record
+    name: "Order {{ orderNumber }}"
+    data: { entityType: Order, entityId: "{{ orderId }}" }
+    questions: ["Summarize this order"]
+    open: true
+```
+
 Actions are used in event handlers (onClick, onSubmit, etc.) as arrays:
 
 ```yaml

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

@@ -455,6 +455,8 @@ still control the displayed label and stored value.
 | `links` | `{entityType, entityId}[]` or template | More entities to link the same upload to: `Order`, `Contact`, `Job`, `TrackingEvent`. Entries whose `entityType` or `entityId` resolves empty are skipped |
 | `category` | `string` | Attachment category (web) |
 | `allowMultiple` / `allowCamera` / `clearAfterUpload` | `boolean` | Upload behavior |
+| `enableZoom` | `boolean` | Mobile: show camera zoom controls and remember the selected zoom per field |
+| `cameraZoom` | `number` | Mobile: initial/fixed camera zoom factor; device capabilities determine the available range |
 | `maxSize` / `allowedExtensions` | `number` / `string[]` | File limits |
 | `onUploaded` | actions | Runs after each upload; `attachment` is in scope |
 

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

@@ -94,25 +94,32 @@ MUI Button with icon, label, loading state, and action dispatch.
 
 ## dropdown
 
-Action dropdown menu (not a form select). MUI Button + Menu with permission-gated items.
+Action dropdown menu (not a form select), with matching web and mobile behavior.
 
 **Props:**
 | Prop | Type | Description |
 |------|------|-------------|
-| `label` | `ILocalizeString` | Trigger button label |
-| `icon` | `string` | Trigger button icon |
+| `label` | `ILocalizeString` | Optional trigger label; omit for a 40x40 icon-only more-actions button |
+| `ariaLabel` | `ILocalizeString` | Accessible label for an icon-only trigger (default: `More actions`) |
+| `icon` | `string` | Trigger icon (icon-only default: `tabler-dots-vertical`) |
 | `name` | `string` | Component name |
 | `items` | `MenuItem[]` | Menu items |
 | `items[].label` | `ILocalizeString` | Item label |
 | `items[].value` | `any` | Item key |
 | `items[].disabled` | `string \| boolean` | Disable (template expression) |
 | `items[].permission` | `string` | Permission gate — hidden if not granted |
+| `items[].isVisible` / `isHidden` | expression | Visibility gates evaluated with variables, store, and form values |
+| `items[].icon` | `string` | Leading item icon |
+| `items[].color` | `string` | Semantic color; use `error` for destructive actions |
+| `items[].divider` | `boolean` | Render a separator instead of an action |
 | `items[].onClick` | `action[]` | Per-item action |
 | `options.size` | `string` | Button size (default: `medium`) |
 | `options.variant` | `string` | Button variant (default: `outlined`) |
 
 **Events:** `onClick` (button level), `items[].onClick` (per item)
 
+Leading, trailing, and duplicate dividers are removed after visibility filtering. If no actionable items remain, the trigger is not rendered.
+
 ```yaml
 component: dropdown
 name: actionsDropdown

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

@@ -424,6 +424,8 @@ props:
 
 ## tabs
 
+Tabs use separate cards for the tab strip and active content by default. Set `props.layout: classic` to keep the header, strip, and content in one card. In the default card layout, a tab may set `props.contentCard: false` when its child (such as a data grid) already supplies its own frame.
+
 Tabbed interface with MUI TabContext. Tab state stored in URL params.
 
 Tabs may contain a `slot` child as an extension point. The web renderer replaces that child