@cxtms/cx-schema 1.9.263 → 1.9.264

package/package.json

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

package/schemas/components/avatar.json

@@ -19,6 +19,9 @@
         "src": {
           "description": "Image URL. Falls back to initials when empty or failed to load"
         },
+        "text": {
+          "description": "Explicit fallback text displayed after src and before generated initials. Template-aware; text longer than two characters scales to fit"
+        },
         "firstName": {
           "description": "Explicit first name (organization user form). Takes priority over name"
         },
@@ -79,7 +82,7 @@
     }
   },
   "additionalProperties": true,
-  "description": "Circular avatar with automatic two-letter initials. Sources are tried in priority order: src image, firstName + lastName, name, email, then a placeholder user icon.",
+  "description": "Circular avatar with explicit text or automatic initials. Sources are tried in priority order: src image, text, firstName + lastName, name, email, then a placeholder user icon.",
   "x-examples": [
     {
       "component": "avatar",

package/schemas/components/card.json

@@ -77,7 +77,7 @@
             },
             "header": {
               "type": "object",
-              "description": "Card header configuration",
+              "description": "Card header configuration. title and subheader accept localized values; title, subheader, and icon are template-aware",
               "additionalProperties": true
             },
             "actions": {

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

@@ -281,7 +281,7 @@ Composable MUI ListItem with component slots and built-in popover menu.
 | `secondaryComponent` | `ComponentProps` | Secondary text area component |
 | `avatarComponent` | `ComponentProps` | Avatar slot component |
 | `secondaryAction` | `ComponentProps` | Right-side action component |
-| `selected` | `boolean` | Visual selection state |
+| `selected` | `boolean \| template string` | Visual selection state; templates resolve against props, variables, and store values |
 | `disabled` | `boolean` | Disabled state |
 | `divider` | `boolean` | Bottom divider |
 | `button` | `boolean` | Render as ListItemButton |
@@ -291,6 +291,8 @@ Composable MUI ListItem with component slots and built-in popover menu.
 
 **Events:** `onClick`, `menu.items[].onClick`
 
+Both event forms receive `sender`, the component's named `actions`, and the active React Hook Form/custom form context (with Formik retained for compatibility), so list-item actions can read or update the surrounding form.
+
 **Children:** Fallback — rendered when no primary/secondary components.
 
 ```yaml

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

@@ -521,12 +521,13 @@ props:
 
 ## avatar
 
-Template-aware display component for compact entity cards and planner headers. Circular avatar with automatic two-letter initials. Sources tried in priority order: `src` image → `firstName` + `lastName` → `name` → `email` → placeholder user icon. Color is picked deterministically from the theme palette by hashing `colorSeed`.
+Template-aware display component for compact entity cards and planner headers. Circular avatar with explicit text or automatic two-letter initials. Sources tried in priority order: `src` image → `text` → `firstName` + `lastName` → `name` → `email` → placeholder user icon. Color is picked deterministically from the theme palette by hashing `colorSeed`.
 
 **Props (all template-parsed):**
 | Prop | Type | Description |
 |------|------|-------------|
 | `src` | `string` | Image URL; falls back to initials when empty or broken |
+| `text` | `string` | Explicit fallback text after `src`; values longer than two characters scale to fit |
 | `name` | `string` | Full name: `Andre Kovac` → AK, `Kovac, Andre` → AK, `Madonna` → MA |
 | `firstName` / `lastName` | `string` | Explicit name parts (organization user form); take priority over `name` |
 | `email` | `string` | Last text fallback: local part, digits dropped (`andre.kovac@…` → AK) |
@@ -624,7 +625,7 @@ Icon renderer. Supports FontAwesome, Tabler, and Feather icons.
 **Props:**
 | Prop | Type | Description |
 |------|------|-------------|
-| `icon` | `string` | Icon name: FontAwesome name, `tabler-*` class, or `activity` |
+| `icon` | `string` | Template-aware icon name: FontAwesome name, `tabler-*` class, or `activity`; resolves against variables and store values |
 | `color` | `string` | MUI palette color (e.g., `primary`, `error.light`) or CSS color |
 | `iconColor` | `string` | Higher-priority color override |
 | `style` | `object` | Inline styles |
@@ -633,7 +634,7 @@ Icon renderer. Supports FontAwesome, Tabler, and Feather icons.
 component: icon
 name: statusIcon
 props:
-  icon: check-circle
+  icon: "{{ item.statusIcon }}"
   color: success
 ```
 

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

@@ -519,13 +519,15 @@ MUI Card container with optional header, content, and actions.
 | `className` | `string` | — | Additional CSS class |
 | `bgcolor` | `string` | — | Background color |
 | `color` | `string` | — | Text color |
-| `header` | `{title?, subheader?, icon?, iconColor?, sx?}` | — | Renders MUI CardHeader; icon is its avatar |
+| `header` | `{title?, subheader?, icon?, iconColor?, sx?}` | — | Renders MUI CardHeader; title/subheader may be localized and title, subheader, and icon are template-aware |
 | `disableContentWrapper` | `boolean` | `false` | Skip CardContent wrapper |
 | `contentSx` | `SxProps` | — | CardContent styles |
 | `contentClassName` | `string` | `card-content` | CardContent CSS class |
 
 **Children:** Yes — wrapped in CardContent (unless `disableContentWrapper`).
 
+When `onClick` is present, the card is keyboard accessible: Enter and Space activate it and a focus outline is shown. Actions receive the card name as `sender`; keyboard events from nested interactive controls are ignored.
+
 ```yaml
 component: card
 name: summaryCard