@exponential_app/eui 0.2.1 → 0.3.0

package/catalog/a11y.json

@@ -244,12 +244,19 @@
     },
     "Carousel": {
       "role": "region",
-      "notes": "region, roledescription carousel; each page a group `page i of n`",
+      "notes": "region, roledescription carousel; each page a group `page i of n`; the counter `$string.pageCounter` is hidden (each page already says page i of n); each thumbnail a button `page i of n`, aria-current on the current one",
       "keys": [
         "ArrowLeft/ArrowRight: previous/next page while focus is inside",
         "Home/End: first/last page"
       ]
     },
+    "Mosaic": {
+      "role": "group",
+      "notes": "group labelled `label`; each tile a button named its picture's `alt`; the `+N` tile reads `alt` then `+N` ($string.morePictures).",
+      "keys": [
+        "Tab through the tiles; Enter, Space: select"
+      ]
+    },
     "Tabs": {
       "role": "tablist",
       "notes": "tablist / tab / tabpanel",
@@ -595,6 +602,13 @@
         "Tab through the links; Enter: select"
       ]
     },
+    "Outline": {
+      "role": "navigation",
+      "notes": "navigation labelled by `caption`; each row a link (aria-current=location on the active row) named `title` then the count; press fires `select {id}`.",
+      "keys": [
+        "Tab through the rows; Enter, Space: select"
+      ]
+    },
     "Stepper": {
       "role": "list",
       "notes": "list; the current step aria-current=step. Each step a listitem labelled `stepDone`/`stepCurrent`/`stepUpcoming`; the current one aria-current=step ($a11y).",

package/catalog/core.catalog.json

@@ -698,6 +698,41 @@
           "description": "The step's state."
         }
       }
+    },
+    "outlineItem": {
+      "description": "One Outline row.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "required": true,
+          "description": "Reported by `select`."
+        },
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The row text."
+        },
+        "count": {
+          "type": "number",
+          "bindable": true,
+          "description": "A muted count."
+        }
+      }
+    },
+    "picture": {
+      "description": "One picture of a Mosaic.",
+      "properties": {
+        "src": {
+          "type": "url",
+          "required": true,
+          "description": "The image URL."
+        },
+        "alt": {
+          "type": "string",
+          "description": "The accessibility description."
+        }
+      }
     }
   },
   "functions": {
@@ -2069,6 +2104,18 @@
           "type": "boolean",
           "default": true,
           "description": "Shows the page dots."
+        },
+        "counter": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows `i / n`."
+        },
+        "thumbnails": {
+          "type": "array",
+          "items": {
+            "type": "url"
+          },
+          "description": "A thumbnail URL per page."
         }
       },
       "events": [
@@ -2079,6 +2126,51 @@
         "indicators": true
       }
     },
+    "Mosaic": {
+      "kind": "macro",
+      "group": "media",
+      "lite": false,
+      "children": "none",
+      "description": "Pictures: halves, or one large + two small with `+N`; press fires `select {index}`.",
+      "props": {
+        "pictures": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "picture"
+          },
+          "required": true,
+          "description": "The pictures in order."
+        },
+        "label": {
+          "type": "string",
+          "description": "The a11y label."
+        }
+      },
+      "events": [
+        "select"
+      ],
+      "example": {
+        "pictures": [
+          {
+            "src": "https://example.com/editor.png",
+            "alt": "Editor"
+          },
+          {
+            "src": "https://example.com/preview.png",
+            "alt": "Preview"
+          },
+          {
+            "src": "https://example.com/data.png",
+            "alt": "Data"
+          },
+          {
+            "src": "https://example.com/versions.png",
+            "alt": "Versions"
+          }
+        ]
+      }
+    },
     "Tabs": {
       "kind": "native",
       "group": "navigation",
@@ -2492,6 +2584,56 @@
         ]
       }
     },
+    "Outline": {
+      "kind": "macro",
+      "group": "navigation",
+      "lite": true,
+      "children": "none",
+      "description": "Anchor rows under a caption, one active; press fires `select {id}`.",
+      "props": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "outlineItem"
+          },
+          "required": true,
+          "description": "The rows in order."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The active row id."
+        },
+        "caption": {
+          "type": "string",
+          "description": "The heading."
+        }
+      },
+      "events": [
+        "select"
+      ],
+      "example": {
+        "caption": "Outline",
+        "value": "part-a",
+        "items": [
+          {
+            "id": "current",
+            "title": "Current state"
+          },
+          {
+            "id": "part-a",
+            "title": "Part A: editor-first creation",
+            "count": 5
+          },
+          {
+            "id": "part-b",
+            "title": "Part B: MCP for eApps",
+            "count": 2
+          }
+        ]
+      }
+    },
     "Stepper": {
       "kind": "macro",
       "group": "navigation",

package/catalog/core.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://ui.exponential.at/catalogs/core/v1",
   "title": "Exponential UI core",
-  "description": "Exponential UI core catalog v1: 89 components (natives + macros), the A2UI basic catalog's 14 functions plus 19 core functions, the Box style whitelist and the token names. Generated by packages/exponential-ui/scripts/generate.ts from catalog/core.catalog.json — do not edit.",
+  "description": "Exponential UI core catalog v1: 91 components (natives + macros), the A2UI basic catalog's 14 functions plus 19 core functions, the Box style whitelist and the token names. Generated by packages/exponential-ui/scripts/generate.ts from catalog/core.catalog.json — do not edit.",
   "catalogId": "https://ui.exponential.at/catalogs/core/v1",
   "liteCatalogId": "https://ui.exponential.at/catalogs/core-lite/v1",
   "components": {
@@ -4006,6 +4006,19 @@
               "description": "Shows the page dots.",
               "default": true
             },
+            "counter": {
+              "type": "boolean",
+              "description": "Shows `i / n`.",
+              "default": false
+            },
+            "thumbnails": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "format": "uri-reference"
+              },
+              "description": "A thumbnail URL per page."
+            },
             "children": {
               "$ref": "#/$defs/ChildList"
             },
@@ -4035,6 +4048,57 @@
       ],
       "unevaluatedProperties": false
     },
+    "Mosaic": {
+      "type": "object",
+      "description": "Pictures: halves, or one large + two small with `+N`; press fires `select {index}`.",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "Mosaic"
+            },
+            "pictures": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/picture"
+              },
+              "description": "The pictures in order."
+            },
+            "label": {
+              "type": "string",
+              "description": "The a11y label."
+            },
+            "on": {
+              "type": "object",
+              "properties": {
+                "select": {
+                  "$ref": "#/$defs/Action"
+                }
+              },
+              "additionalProperties": false
+            },
+            "style": {
+              "$ref": "#/$defs/Style"
+            },
+            "visible": {
+              "$ref": "#/$defs/Visible"
+            },
+            "accessibility": {
+              "$ref": "#/$defs/AccessibilityAttributes"
+            }
+          },
+          "required": [
+            "component",
+            "pictures"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "Tabs": {
       "type": "object",
       "description": "Tab navigation; the child at index i is the panel of tab i.",
@@ -5301,6 +5365,71 @@
       ],
       "unevaluatedProperties": false
     },
+    "Outline": {
+      "type": "object",
+      "description": "Anchor rows under a caption, one active; press fires `select {id}`.",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "component": {
+              "const": "Outline"
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/outlineItem"
+              },
+              "description": "The rows in order."
+            },
+            "value": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/$defs/DataBinding"
+                },
+                {
+                  "$ref": "#/$defs/FunctionCall"
+                }
+              ],
+              "description": "The active row id."
+            },
+            "caption": {
+              "type": "string",
+              "description": "The heading."
+            },
+            "on": {
+              "type": "object",
+              "properties": {
+                "select": {
+                  "$ref": "#/$defs/Action"
+                }
+              },
+              "additionalProperties": false
+            },
+            "style": {
+              "$ref": "#/$defs/Style"
+            },
+            "visible": {
+              "$ref": "#/$defs/Visible"
+            },
+            "accessibility": {
+              "$ref": "#/$defs/AccessibilityAttributes"
+            }
+          },
+          "required": [
+            "component",
+            "items"
+          ]
+        }
+      ],
+      "unevaluatedProperties": false
+    },
     "Stepper": {
       "type": "object",
       "description": "Wizard progress: numbered steps, finished ones ticked.",
@@ -24164,6 +24293,68 @@
       ],
       "additionalProperties": false
     },
+    "outlineItem": {
+      "type": "object",
+      "description": "One Outline row.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Reported by `select`."
+        },
+        "title": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/$defs/DataBinding"
+            },
+            {
+              "$ref": "#/$defs/FunctionCall"
+            }
+          ],
+          "description": "The row text."
+        },
+        "count": {
+          "oneOf": [
+            {
+              "type": "number"
+            },
+            {
+              "$ref": "#/$defs/DataBinding"
+            },
+            {
+              "$ref": "#/$defs/FunctionCall"
+            }
+          ],
+          "description": "A muted count."
+        }
+      },
+      "required": [
+        "id",
+        "title"
+      ],
+      "additionalProperties": false
+    },
+    "picture": {
+      "type": "object",
+      "description": "One picture of a Mosaic.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "format": "uri-reference",
+          "description": "The image URL."
+        },
+        "alt": {
+          "type": "string",
+          "description": "The accessibility description."
+        }
+      },
+      "required": [
+        "src"
+      ],
+      "additionalProperties": false
+    },
     "anyComponent": {
       "oneOf": [
         {
@@ -24250,6 +24441,9 @@
         {
           "$ref": "#/components/Carousel"
         },
+        {
+          "$ref": "#/components/Mosaic"
+        },
         {
           "$ref": "#/components/Tabs"
         },
@@ -24277,6 +24471,9 @@
         {
           "$ref": "#/components/Breadcrumb"
         },
+        {
+          "$ref": "#/components/Outline"
+        },
         {
           "$ref": "#/components/Stepper"
         },

package/catalog/host.json

@@ -68,6 +68,16 @@
       "transports": ["http", "stdio", "script"],
       "functionPrefix": "tools."
     },
+    "exposes": {
+      "$comment": "VAPP-180 (the format half of the eMCP contract, packages/emcp fixtures/exposes.json in the Exponential repo): `exposes: [{name, title, description, input, access, run}]` = MCP tools a host's broker lists (as `<app>__<name>`) and runs as the CALLING person, data never code. `name` matches `limits.namePattern`, at most `limits.nameMax`, never holds `limits.separator`, unique; `title` (at most titleMax) and `description` (at most descriptionMax) non-blank; `input` = a JSON Schema `{type: \"object\", properties?}`; `access` read | write; at most `limits.maxTools` tools. `run` holds EXACTLY ONE of `runKinds`: `records: {op, kind, id?, where?, data?, limit?}` over the package's OWN kinds (op in `recordOps`; `readRecordOps` read, upsert writes; a delete is destructive and refused); `action` (+ `args`) = a host function name matching `actionPattern` (it reads when the last word of its name is a `readOpWords` word, else it writes); `upstream` (+ `tool`, `args`) = one of the package's `upstreams` (the MCP server names the HOST provides: Exponential = the team's MCP servers). Every string of `run` may hold `${input.<dotted path>}` templates whose first key is a declared input property. Destructive is never exposed: an action or upstream tool whose name holds a `destructiveWords` word (words = the lowercase letter runs) is refused. A binding declared read whose run writes is refused; an upstream tool's level is its live annotations', checked by the host at call. Issues come in binding order with the eMCP error code (`exposeIssues`). What a run may reach on a given host (which actions exist and are grantable, destructive arguments, which upstreams the team has) is the host's own check on top.",
+      "limits": { "namePattern": "^[a-z][a-z0-9_]*$", "nameMax": 40, "titleMax": 80, "descriptionMax": 1024, "maxTools": 32, "separator": "__" },
+      "runKinds": ["records", "action", "upstream"],
+      "recordOps": ["list", "get", "upsert"],
+      "readRecordOps": ["list", "get"],
+      "readOpWords": ["list", "get", "show", "catalog", "activity", "files"],
+      "destructiveWords": ["delete", "merge", "close", "end", "remove", "trash"],
+      "actionPattern": "^[a-z][a-z0-9_]*(\\.[a-z][a-z0-9_]*)+$"
+    },
     "extensions": {
       "$comment": "VAPP-161: `extensions: [{id, version, components?}]`: an extension catalog id the package needs beyond its catalogId, the minimum MAJOR.MINOR.PATCH (caret: the host's has the same major and is not lower; an unversioned registration satisfies any) and the components it uses. Install issues: an id not registered on the host (`extension <id> is not available on this host`), a version that does not satisfy (`extension <id> <have> does not satisfy ^<want>`), a component the registered extension does not define (`extension <id> has no component <name>`), a duplicate id. A host registers an extension's version as ExtensionDef.version.",
       "versionPattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$"