@elabs-ai/components-ai 4.2.0 → 5.1.0

package/src/a2ui/catalog.source.json

@@ -0,0 +1,772 @@
+{
+  "$comment": "A2UI catalog SOURCE (D2 — the generative-UI path). Hand-authored: which @elabs-ai/components-ui components an agent may name in a surface, which may hold children, and which events a node's `on` map can bind. `pnpm gen` (packages/cli/scripts/gen-a2ui-catalog.mjs) merges each entry with the manifest's prop table + cva variants into core/catalog.generated.ts. Two entries are `builtin` layout nodes the renderer draws itself. A type with `\"package\": \"@elabs-ai/components-charts\"` is generated into that package's own `src/a2ui/catalog.generated.ts` and bound there (`CHARTS_A2UI_BINDINGS`); an app merges it with `createA2uiCatalog`, because `ai` may not import `charts`. Keep the list small and real: a type here is a promise an agent will rely on.",
+  "version": "1",
+  "types": {
+    "Stack": {
+      "builtin": true,
+      "children": true,
+      "summary": "Vertical or horizontal flex group. The default container — put siblings in a Stack, never bare.",
+      "props": {
+        "direction": {
+          "enum": ["column", "row"],
+          "default": "column"
+        },
+        "gap": {
+          "enum": ["none", "xs", "sm", "md", "lg"],
+          "default": "md"
+        },
+        "align": {
+          "enum": ["start", "center", "end", "stretch"],
+          "default": "stretch"
+        },
+        "justify": {
+          "enum": ["start", "center", "end", "between"],
+          "default": "start"
+        },
+        "wrap": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "Grid": {
+      "builtin": true,
+      "children": true,
+      "summary": "Responsive CSS grid, 1–4 equal columns (collapses to one column on narrow screens).",
+      "props": {
+        "columns": {
+          "enum": [1, 2, 3, 4],
+          "default": 2
+        },
+        "gap": {
+          "enum": ["none", "xs", "sm", "md", "lg"],
+          "default": "md"
+        }
+      }
+    },
+    "Heading": {
+      "children": true,
+      "summary": "Section heading; `level` sets the HTML rank (1–6), `size` the type role.",
+      "props": {
+        "level": {
+          "enum": [1, 2, 3, 4, 5, 6],
+          "default": 2
+        }
+      }
+    },
+    "Text": {
+      "children": true,
+      "summary": "A paragraph or inline run of text with a type role and tone."
+    },
+    "Card": {
+      "children": true,
+      "summary": "The one generic surface — compose CardHeader / CardContent / CardFooter inside.",
+      "omit": ["detailReveal", "detailSize", "interactive"]
+    },
+    "CardHeader": {
+      "children": true
+    },
+    "CardTitle": {
+      "children": true
+    },
+    "CardDescription": {
+      "children": true
+    },
+    "CardContent": {
+      "children": true
+    },
+    "CardFooter": {
+      "children": true
+    },
+    "CardAction": {
+      "children": true,
+      "summary": "The header's trailing action slot (a Button, a Badge)."
+    },
+    "SectionHeader": {
+      "summary": "Title + description + optional actions above a region.",
+      "props": {
+        "title": {
+          "type": "node",
+          "required": true
+        },
+        "description": {
+          "type": "node"
+        },
+        "eyebrow": {
+          "type": "node"
+        },
+        "actions": {
+          "type": "node"
+        }
+      }
+    },
+    "Separator": {
+      "props": {
+        "orientation": {
+          "enum": ["horizontal", "vertical"],
+          "default": "horizontal"
+        }
+      }
+    },
+    "Badge": {
+      "children": true
+    },
+    "StatusBadge": {
+      "summary": "A closed status vocabulary with icon + text (never colour alone).",
+      "props": {
+        "status": {
+          "enum": [
+            "pending",
+            "running",
+            "complete",
+            "awaiting-approval",
+            "denied",
+            "failed",
+            "skipped"
+          ],
+          "required": true
+        },
+        "hideIcon": {
+          "type": "boolean"
+        }
+      }
+    },
+    "Alert": {
+      "children": true,
+      "summary": "Compose AlertTitle + AlertDescription inside.",
+      "props": {
+        "variant": {
+          "enum": ["default", "destructive", "success", "warning", "info"]
+        }
+      }
+    },
+    "AlertTitle": {
+      "children": true
+    },
+    "AlertDescription": {
+      "children": true
+    },
+    "Progress": {
+      "props": {
+        "value": {
+          "type": "number",
+          "required": true
+        },
+        "max": {
+          "type": "number"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      }
+    },
+    "MetricCard": {
+      "summary": "One KPI: label, value, optional delta. Put several in a Grid.",
+      "props": {
+        "valueFormat": {
+          "enum": ["number", "compact", "currency", "percent"]
+        },
+        "delta": {
+          "type": "string"
+        },
+        "deltaDirection": {
+          "enum": ["up", "down", "neutral"]
+        },
+        "positiveIsGood": {
+          "type": "boolean"
+        },
+        "currency": {
+          "type": "string"
+        }
+      },
+      "omit": ["announceLoading", "copyExactValue", "icon", "visual"]
+    },
+    "Descriptions": {
+      "children": true,
+      "summary": "Key–value list; children are DescriptionsItem.",
+      "props": {
+        "columns": {
+          "enum": [1, 2, 3]
+        },
+        "layout": {
+          "enum": ["horizontal", "vertical"]
+        }
+      }
+    },
+    "DescriptionsItem": {
+      "children": true
+    },
+    "Table": {
+      "children": true,
+      "summary": "Compose TableHeader/TableBody → TableRow → TableHead/TableCell."
+    },
+    "TableHeader": {
+      "children": true
+    },
+    "TableBody": {
+      "children": true
+    },
+    "TableFooter": {
+      "children": true
+    },
+    "TableRow": {
+      "children": true
+    },
+    "TableHead": {
+      "children": true
+    },
+    "TableCell": {
+      "children": true
+    },
+    "TableCaption": {
+      "children": true
+    },
+    "Tabs": {
+      "children": true,
+      "summary": "Compose TabsList (TabsTrigger…) + TabsContent per value.",
+      "props": {
+        "defaultValue": {
+          "type": "string",
+          "required": true
+        }
+      },
+      "events": {
+        "change": "onValueChange"
+      }
+    },
+    "TabsList": {
+      "children": true
+    },
+    "TabsTrigger": {
+      "children": true,
+      "props": {
+        "value": {
+          "type": "string",
+          "required": true
+        },
+        "disabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "TabsContent": {
+      "children": true,
+      "props": {
+        "value": {
+          "type": "string",
+          "required": true
+        }
+      }
+    },
+    "Accordion": {
+      "children": true,
+      "props": {
+        "type": {
+          "enum": ["single", "multiple"],
+          "required": true
+        },
+        "defaultValue": {
+          "type": "string"
+        },
+        "collapsible": {
+          "type": "boolean"
+        }
+      },
+      "events": {
+        "change": "onValueChange"
+      }
+    },
+    "AccordionItem": {
+      "children": true,
+      "props": {
+        "value": {
+          "type": "string",
+          "required": true
+        }
+      }
+    },
+    "AccordionTrigger": {
+      "children": true
+    },
+    "AccordionContent": {
+      "children": true
+    },
+    "Timeline": {
+      "summary": "Ordered status timeline from `items` (title, status, timestamp, description).",
+      "props": {
+        "items": {
+          "type": "array",
+          "required": true,
+          "description": "[{ title, description?, status?: \"done\"|\"active\"|\"pending\", timestamp? }]"
+        }
+      }
+    },
+    "EmptyState": {
+      "summary": "Nothing here yet — title, description, optional actions."
+    },
+    "StatePanel": {
+      "summary": "An empty / error / loading message panel."
+    },
+    "Avatar": {
+      "children": true,
+      "summary": "Compose AvatarFallback (initials) inside."
+    },
+    "AvatarFallback": {
+      "children": true
+    },
+    "Kbd": {
+      "children": true
+    },
+    "Button": {
+      "children": true,
+      "summary": "An action. Bind `on.click`; one `variant: \"default\"` per group.",
+      "props": {
+        "disabled": {
+          "type": "boolean"
+        },
+        "type": {
+          "enum": ["button", "submit"],
+          "default": "button"
+        }
+      },
+      "events": {
+        "click": "onClick"
+      }
+    },
+    "ButtonGroup": {
+      "children": true
+    },
+    "Label": {
+      "children": true,
+      "props": {
+        "htmlFor": {
+          "type": "string"
+        }
+      }
+    },
+    "Input": {
+      "props": {
+        "id": {
+          "type": "string"
+        },
+        "type": {
+          "enum": ["text", "email", "number", "password", "search", "tel", "url", "date"]
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "defaultValue": {
+          "type": "string"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onChange"
+      }
+    },
+    "Textarea": {
+      "props": {
+        "id": {
+          "type": "string"
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "defaultValue": {
+          "type": "string"
+        },
+        "rows": {
+          "type": "number"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onChange"
+      }
+    },
+    "Checkbox": {
+      "props": {
+        "id": {
+          "type": "string"
+        },
+        "defaultChecked": {
+          "type": "boolean"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onCheckedChange"
+      }
+    },
+    "Switch": {
+      "props": {
+        "id": {
+          "type": "string"
+        },
+        "defaultChecked": {
+          "type": "boolean"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onCheckedChange"
+      }
+    },
+    "RadioGroup": {
+      "children": true,
+      "props": {
+        "defaultValue": {
+          "type": "string"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onValueChange"
+      }
+    },
+    "RadioGroupItem": {
+      "props": {
+        "value": {
+          "type": "string",
+          "required": true
+        },
+        "id": {
+          "type": "string"
+        },
+        "disabled": {
+          "type": "boolean"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      }
+    },
+    "Slider": {
+      "props": {
+        "defaultValue": {
+          "type": "array"
+        },
+        "min": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "step": {
+          "type": "number"
+        },
+        "aria-label": {
+          "type": "string"
+        }
+      },
+      "events": {
+        "change": "onValueChange"
+      }
+    },
+    "Select": {
+      "children": true,
+      "summary": "Compose SelectTrigger (SelectValue) + SelectContent (SelectItem…).",
+      "props": {
+        "defaultValue": {
+          "type": "string"
+        },
+        "disabled": {
+          "type": "boolean"
+        }
+      },
+      "events": {
+        "change": "onValueChange"
+      }
+    },
+    "SelectTrigger": {
+      "children": true,
+      "props": {
+        "aria-label": {
+          "type": "string"
+        }
+      }
+    },
+    "SelectValue": {
+      "props": {
+        "placeholder": {
+          "type": "string"
+        }
+      }
+    },
+    "SelectContent": {
+      "children": true
+    },
+    "SelectItem": {
+      "children": true,
+      "props": {
+        "value": {
+          "type": "string",
+          "required": true
+        },
+        "disabled": {
+          "type": "boolean"
+        }
+      }
+    },
+    "Collapsible": {
+      "children": true,
+      "props": {
+        "defaultOpen": {
+          "type": "boolean"
+        }
+      },
+      "events": {
+        "change": "onOpenChange"
+      }
+    },
+    "CollapsibleTrigger": {
+      "children": true,
+      "props": {
+        "asChild": {
+          "type": "boolean"
+        }
+      }
+    },
+    "CollapsibleContent": {
+      "children": true
+    },
+    "BentoGrid": {
+      "children": true,
+      "summary": "Feature/bento grid; children are BentoGridItem."
+    },
+    "BentoGridItem": {
+      "children": true,
+      "props": {
+        "size": {
+          "enum": ["sm", "md", "lg", "hero"]
+        }
+      }
+    },
+    "AutoChart": {
+      "package": "@elabs-ai/components-charts",
+      "summary": "ONE chart from a serializable ChartSpec — AutoChart picks the mark when `type` is omitted. The chart the agent should reach for.",
+      "props": {
+        "spec": {
+          "type": "object",
+          "required": true,
+          "description": "{ data: row[], x: string, series: string[] | { key, label?, axis?: left|right, mark?: line|area|column }[] (type: \"dual-axis\" only: default axis left, mark line; needs ≥1 line series, no right-axis columns), type?: line|area|bar|pie|scatter|radar|funnel|candlestick|heatmap|calendar|waterfall|dumbbell|unit|treemap|histogram|box|strip|bump|stream|diverging-bar|dual-axis, xType?: time|category|number, y2?, axes?: { y2?: { align?: independent|ticks, proportional?: boolean, zero?: both|auto } } (type: \"dual-axis\" only, right axis vs left; default align ticks, zero auto), group?, title?, description?, stacked?: boolean|percent|diverging, orientation?: vertical|horizontal, donut?, legend?: boolean (an object form exists; AutoChart reads it as boolean truthy today), valueFormat?: number|compact|currency|percent, currency?, palette?: mono|sequential|categorical, emphasis?: analytical|editorial, kind?: steps|records|ranking|change (change: a two-measure spec reads as a before/after move, for dumbbell), nulls?: gap|zero|connect (line/area/stream non-numeric sample, default gap), curve?: linear|monotone|natural|step|step-before|step-after (line/area/stream, default monotone), symbols?: { placement?: all|ends|first|last, shape?: circle|square|triangle|diamond|cross|star|plus|hexagon, style?: filled|hollow, size? } (line/area/stream point markers), size?: { key, range?: [lo,hi] } (scatter bubble size), shapeBy?: { key, shapes?: marker-shape[] } (scatter shape by category), trend?: linear|log (scatter trend line), shapes?: [{ kind: line|path, … }] (scatter reference lines/areas), variant?: dumbbell|slope|arrow|dots (dumbbell only, default dumbbell), delta?: { show, mode: absolute|percent } (dumbbell delta label), groupSmall?: { threshold?, max?, label? } (pie: fold small slices into an Other slice), half?: boolean (pie half-donut, default false), labels?: { series?: end|key|none, values?: { placement: first|last|all|peaks, count?, minGap?, outline?, matchColor?, format? }, points?: { key, mode?: auto|all, priorityKey? }, slices?: { placement?: inside|outside|none, show: (label|value|percent)[], matchColor?, minAngle? }, comparison?: value|difference|none } (label engine), annotations?: [{ kind: text|range|line|row, … }] (notes, bands, reference lines, row notes in data units), divergingCenter?: string (neutral series when stacked is diverging), sort?: asc|desc|none|{by,dir} (bar) | start|end|delta|deltaPercent|data|label|none (dumbbell) | desc|none (pie) | data|increasesFirst|decreasesFirst (waterfall, default data), groupBy?: string (bar/dumbbell row grouping; waterfall: a subtotal after each group), colorBy?: { key, scale?: categorical|sequential|diverging, steps? } (bar per-bar / scatter per-point colour), overlays?: [{ kind: value|range, … }] (bar value markers, range spans), comparison?: { key, label? } (bar muted prior-period column), notes?: string (italic notes under an enclosing ChartFrame), byline?: { kind?: chart|map|table, author } (ChartFrame footer: kind + author), source?: string | { name, href? } (ChartFrame footer attribution), altText?: string (image text alternative, default: description), tooltip?: { variant?: rows|table|inline, focus?: boolean, pin?: boolean } (forwarded to ChartTooltip, default rows), facet?: { by: string | { series: true }, columns?, scales?: { y?: shared|independent, rangeRounding? }, sort?: start|end|delta|deltaPercent|range|title|data, baseline?: { key } | { series }, panelHeight? } (line/area/bar/pie small multiples), dataFormat?: differences|runningTotals (waterfall only, default differences), zoomToDifferences?: boolean (waterfall only, default false) }"
+        },
+        "height": {
+          "type": "number",
+          "description": "Pixels; omit for the default."
+        },
+        "loading": {
+          "type": "boolean"
+        }
+      },
+      "events": {
+        "datapointClick": "onDatapointClick"
+      },
+      "omit": ["copyValueOnActivate", "dimExcluded"]
+    },
+    "ChartCard": {
+      "package": "@elabs-ai/components-charts",
+      "children": true,
+      "summary": "A titled card around a chart: title, description, source line; put an AutoChart inside.",
+      "props": {
+        "title": {
+          "type": "node",
+          "required": true
+        },
+        "description": {
+          "type": "node"
+        },
+        "actions": {
+          "type": "node"
+        },
+        "source": {
+          "type": "node",
+          "description": "Where the numbers come from — always state it."
+        },
+        "height": {
+          "type": "number"
+        },
+        "loading": {
+          "type": "boolean"
+        }
+      },
+      "omit": ["titleAs"]
+    },
+    "MetricGrid": {
+      "package": "@elabs-ai/components-charts",
+      "children": true,
+      "summary": "The KPI summary row: 2–4 MetricCards, optionally one featured (wider).",
+      "props": {
+        "columns": {
+          "enum": [2, 3, 4]
+        },
+        "featured": {
+          "type": "number",
+          "description": "Index of the tile to feature (0-based)."
+        },
+        "featuredSpan": {
+          "enum": [2, 3]
+        },
+        "reveal": {
+          "type": "boolean"
+        },
+        "loading": {
+          "type": "boolean"
+        }
+      }
+    },
+    "Sparkline": {
+      "package": "@elabs-ai/components-charts",
+      "summary": "A tiny trend (bar or line) with an optional target line and normal band — inside a MetricCard or a table cell.",
+      "props": {
+        "values": {
+          "type": "array",
+          "required": true,
+          "description": "Numbers, oldest first."
+        },
+        "variant": {
+          "enum": ["bar", "line"]
+        },
+        "label": {
+          "type": "string",
+          "description": "Accessible name — say what the series is."
+        },
+        "target": {
+          "type": "number"
+        },
+        "band": {
+          "type": "array",
+          "description": "[low, high] — the normal range, shaded."
+        },
+        "showLastValue": {
+          "type": "boolean"
+        },
+        "emphasizeLast": {
+          "type": "boolean"
+        },
+        "width": {
+          "type": "number"
+        },
+        "height": {
+          "type": "number"
+        },
+        "fit": {
+          "enum": ["fixed", "fill"]
+        },
+        "lastValueSuffix": {
+          "type": "string"
+        }
+      }
+    },
+    "BulletChart": {
+      "package": "@elabs-ai/components-charts",
+      "summary": "Actual vs target inside qualitative bands — the honest 'am I on target?' mark.",
+      "props": {
+        "value": {
+          "type": "number",
+          "required": true
+        },
+        "target": {
+          "type": "number"
+        },
+        "comparative": {
+          "type": "number",
+          "description": "A second reference, e.g. last year."
+        },
+        "bands": {
+          "type": "array",
+          "description": "[{ to: number, label?: string }] ascending."
+        },
+        "min": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "orientation": {
+          "enum": ["horizontal", "vertical"]
+        },
+        "size": {
+          "enum": ["sm", "md"]
+        },
+        "showAxis": {
+          "type": "boolean"
+        },
+        "valueFormat": {
+          "enum": ["number", "compact", "currency", "percent"]
+        },
+        "higherIsBetter": {
+          "type": "boolean"
+        },
+        "accessibleLabel": {
+          "type": "string"
+        }
+      }
+    },
+    "Gauge": {
+      "package": "@elabs-ai/components-charts",
+      "summary": "A notched gauge for one value against a scale, with optional target and milestones.",
+      "props": {
+        "value": {
+          "type": "number",
+          "required": true,
+          "description": "0–100 share of the scale."
+        },
+        "centerValue": {
+          "type": "number",
+          "required": true,
+          "description": "The figure shown in the middle."
+        },
+        "defaultLabel": {
+          "type": "string"
+        },
+        "prefix": {
+          "type": "string"
+        },
+        "suffix": {
+          "type": "string"
+        },
+        "target": {
+          "type": "number"
+        },
+        "milestones": {
+          "type": "array"
+        },
+        "width": {
+          "type": "number"
+        },
+        "height": {
+          "type": "number"
+        },
+        "accessibleLabel": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}