cortena-ui 1.3.0 → 1.4.0

package/dist/a2ui/catalogue.js

@@ -0,0 +1,942 @@
+"use client";
+import { shakeable } from "../lib/shakeable.js";
+import { AlertView, BadgeView, ButtonLinkView, ButtonView, CardView, ChartView, CheckboxView, ColumnView, DataTableView, DateFieldView, DividerView, EmptyStateView, ImageView, LinkView, MarkdownView, ProgressViewComponent, RadioGroupView, RowView, SectionCardView, SelectView, SpacerView, StatusDotView, SwitchView, TabsView, TextAreaView, TextFieldView, TextView } from "./views.js";
+import { z } from "zod";
+//#region src/a2ui/catalogue.ts
+/**
+* The A2UI catalogue, bound to cortena-ui.
+*
+* A2UI's safety property is that an agent may only choose from a catalogue the
+* host controls: it cannot emit markup, styles or script, only a component name
+* and properties the host validates. This file is that catalogue. Each entry
+* declares
+*
+* - the A2UI component name an agent writes,
+* - a zod schema for its **resolved** properties (bindings already read),
+* - the event names it can raise,
+* - whether it takes children,
+* - a self-contained example, which is both the doc's sample and a fixture,
+* - the cortena-ui view that draws it.
+*
+* The vocabulary therefore grows with the package rather than with a parser:
+* adding a component here adds it to what every agent can draw, and
+* `catalogue-doc.ts` regenerates the prompt section from the same object, so
+* prompt and renderer cannot drift (DESIGN-34).
+*
+* Schemas describe resolved values because the renderer resolves `{ path }`
+* bindings, unwraps literals and normalises actions before validating. A view
+* therefore never receives an unchecked value, and a property an agent got
+* wrong produces an error card naming the property rather than a blank area.
+*/
+/** Keeps each entry's props type tied to its view without widening the record. */
+function entry(definition) {
+	return definition;
+}
+/**
+* A resolved action.
+*
+* On the wire an agent writes A2UI v0.9's `{ event: { name, context } }`, the
+* bare `{ name, context }`, or just the name as a string; the renderer
+* normalises all three to this before validation.
+*/
+const Action = /* @__PURE__ */ shakeable(() => z.object({
+	name: z.string().describe("Event name sent back to the agent."),
+	context: z.record(z.string(), z.unknown()).optional().describe("Extra values merged into the action payload.")
+}).describe("An action reported to the agent when the user interacts."));
+const Option = /* @__PURE__ */ shakeable(() => z.object({
+	value: z.string().describe("Value written to the data model."),
+	label: z.string().optional().describe("Text shown to the user; defaults to the value."),
+	disabled: z.boolean().optional()
+}));
+const gap = /* @__PURE__ */ shakeable(() => z.union([
+	z.literal(0),
+	z.literal(1),
+	z.literal(2),
+	z.literal(3),
+	z.literal(4),
+	z.literal(6),
+	z.literal(8)
+]).describe("Spacing step between children."));
+const padding = /* @__PURE__ */ shakeable(() => z.union([
+	z.literal(0),
+	z.literal(1),
+	z.literal(2),
+	z.literal(3),
+	z.literal(4),
+	z.literal(6),
+	z.literal(8)
+]).describe("Inner padding step."));
+const alignment = /* @__PURE__ */ shakeable(() => z.enum([
+	"start",
+	"center",
+	"end",
+	"stretch",
+	"baseline"
+]).describe("Cross-axis alignment."));
+const justification = /* @__PURE__ */ shakeable(() => z.enum([
+	"start",
+	"center",
+	"end",
+	"between"
+]).describe("Main-axis distribution."));
+const fieldChrome = /* @__PURE__ */ shakeable(() => ({
+	label: z.string().optional().describe("Field label."),
+	description: z.string().optional().describe("Helper text under the control."),
+	error: z.string().optional().describe("Validation message; also marks the field invalid."),
+	disabled: z.boolean().optional()
+}));
+const buttonVariant = /* @__PURE__ */ shakeable(() => z.enum([
+	"primary",
+	"secondary",
+	"outline",
+	"ghost",
+	"soft",
+	"destructive",
+	"link"
+]).describe("Visual weight."));
+const buttonSize = /* @__PURE__ */ shakeable(() => z.enum([
+	"sm",
+	"md",
+	"lg"
+]).describe("Control size."));
+/**
+* Root-relative means one slash and then a path. `//evil.example/x` is
+* protocol-relative — the browser resolves it against the page's scheme and
+* goes off-origin — and `/\evil.example` is the same trick, because browsers
+* treat a backslash after the leading slash as a second slash.
+*/
+const rootRelative = (value) => value.startsWith("/") && value[1] !== "/" && value[1] !== "\\";
+/**
+* A URL an agent may point at.
+*
+* Restricted by scheme rather than sanitised after the fact: `javascript:` and
+* friends never reach the DOM because they never pass validation, so the
+* component gets an error card instead.
+*/
+const httpUrl = /* @__PURE__ */ shakeable(() => z.string().refine((value) => /^https?:\/\//i.test(value) || rootRelative(value) || value.startsWith("#"), "Must be an http(s), root-relative or fragment URL.").describe("Destination URL (http, https, root-relative or fragment)."));
+const imageUrl = /* @__PURE__ */ shakeable(() => z.string().refine((value) => /^https?:\/\//i.test(value) || /^data:image\//i.test(value) || rootRelative(value), "Must be an http(s), root-relative or data:image URL.").describe("Image URL (http, https, root-relative or data:image)."));
+/** Every chart type the Chart composite draws, Recharts and Nivo alike. */
+const chartType = /* @__PURE__ */ shakeable(() => z.enum([
+	"bar",
+	"line",
+	"area",
+	"pie",
+	"donut",
+	"scatter",
+	"scatterplot",
+	"radar",
+	"funnel",
+	"heatmap",
+	"calendar",
+	"treemap",
+	"sunburst"
+]).describe("Chart type; the package picks Recharts or Nivo for it."));
+/**
+* A table's rows, or a handle to them.
+*
+* The server form is the point of `04-data-tables.md` in an agent context: the
+* agent calls a tool, gets back a `sourceId`, and passes that. The host resolves
+* it through `resolveDataSource`, so search, sort and paging stay on the backend
+* and a large result never travels through the model.
+*/
+const tableSource = /* @__PURE__ */ shakeable(() => z.union([z.object({
+	kind: z.literal("client"),
+	rows: z.array(z.record(z.string(), z.unknown())).describe("The rows, inline.")
+}), z.object({
+	kind: z.literal("server"),
+	sourceId: z.string().describe("Handle obtained from a tool; the host resolves it to a server source.")
+})]).describe("Where the table's rows come from."));
+const layout = /* @__PURE__ */ shakeable(() => ({
+	Column: entry({
+		name: "Column",
+		group: "layout",
+		summary: "Stacks its children vertically.",
+		props: z.object({
+			gap: gap.optional(),
+			padding: padding.optional(),
+			align: alignment.optional(),
+			justify: justification.optional()
+		}),
+		events: [],
+		children: "many",
+		example: { components: [
+			{
+				id: "col",
+				component: "Column",
+				gap: 3,
+				children: ["col-a", "col-b"]
+			},
+			{
+				id: "col-a",
+				component: "Text",
+				text: "First",
+				role: "body"
+			},
+			{
+				id: "col-b",
+				component: "Text",
+				text: "Second",
+				role: "body"
+			}
+		] },
+		view: ColumnView
+	}),
+	Row: entry({
+		name: "Row",
+		group: "layout",
+		summary: "Lays its children out horizontally, wrapping by default.",
+		props: z.object({
+			gap: gap.optional(),
+			padding: padding.optional(),
+			align: alignment.optional(),
+			justify: justification.optional(),
+			wrap: z.boolean().optional().describe("Set false to keep one line.")
+		}),
+		events: [],
+		children: "many",
+		example: { components: [
+			{
+				id: "row",
+				component: "Row",
+				gap: 2,
+				children: ["row-a", "row-b"]
+			},
+			{
+				id: "row-a",
+				component: "Badge",
+				label: "Open",
+				variant: "info"
+			},
+			{
+				id: "row-b",
+				component: "Badge",
+				label: "3 days",
+				variant: "neutral"
+			}
+		] },
+		view: RowView
+	}),
+	Card: entry({
+		name: "Card",
+		group: "layout",
+		summary: "A bordered surface grouping related content.",
+		props: z.object({
+			accent: z.boolean().optional().describe("Draw the border in the ring colour."),
+			flush: z.boolean().optional().describe("Remove the body padding.")
+		}),
+		events: [],
+		children: "many",
+		example: { components: [{
+			id: "card",
+			component: "Card",
+			children: ["card-text"]
+		}, {
+			id: "card-text",
+			component: "Text",
+			text: "Inside a card.",
+			role: "body"
+		}] },
+		view: CardView
+	}),
+	SectionCard: entry({
+		name: "SectionCard",
+		group: "layout",
+		summary: "A card with a title and description header above its children.",
+		props: z.object({
+			title: z.string().describe("Header title."),
+			description: z.string().optional().describe("Header description."),
+			flush: z.boolean().optional()
+		}),
+		events: [],
+		children: "many",
+		example: { components: [{
+			id: "section",
+			component: "SectionCard",
+			title: "Pipeline",
+			description: "Deals closing this quarter.",
+			children: ["section-text"]
+		}, {
+			id: "section-text",
+			component: "Text",
+			text: "Twelve open deals.",
+			role: "body"
+		}] },
+		view: SectionCardView
+	}),
+	Divider: entry({
+		name: "Divider",
+		group: "layout",
+		summary: "A hairline rule between sections.",
+		props: z.object({ orientation: z.enum(["horizontal", "vertical"]).optional() }),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "divider",
+			component: "Divider"
+		}] },
+		view: DividerView
+	}),
+	Spacer: entry({
+		name: "Spacer",
+		group: "layout",
+		summary: "Blank vertical space where a gap is not enough.",
+		props: z.object({ size: gap.optional().describe("Height step; default 4.") }),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "spacer",
+			component: "Spacer",
+			size: 4
+		}] },
+		view: SpacerView
+	})
+}));
+const text = /* @__PURE__ */ shakeable(() => ({
+	Text: entry({
+		name: "Text",
+		group: "text",
+		summary: "A run of plain text at one of the type-scale roles.",
+		props: z.object({
+			text: z.string().describe("The text to show."),
+			role: z.enum([
+				"heading",
+				"subheading",
+				"body",
+				"caption",
+				"eyebrow"
+			]).optional().describe("Type-scale role; default body."),
+			tone: z.enum([
+				"default",
+				"muted",
+				"success",
+				"warning",
+				"danger",
+				"info"
+			]).optional().describe("Semantic colour; default foreground."),
+			align: z.enum([
+				"start",
+				"center",
+				"end"
+			]).optional(),
+			mono: z.boolean().optional().describe("Render in the mono face, for ids and numbers.")
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "heading",
+			component: "Text",
+			text: "Quarterly review",
+			role: "heading"
+		}] },
+		view: TextView
+	}),
+	Markdown: entry({
+		name: "Markdown",
+		group: "text",
+		summary: "Rich text as markdown; sanitised, with GFM tables and code blocks.",
+		props: z.object({
+			text: z.string().describe("Markdown source."),
+			compact: z.boolean().optional().describe("Tighter rhythm, for chat bubbles.")
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "md",
+			component: "Markdown",
+			text: "**Summary**\n\n- Revenue up 12%\n- Churn flat\n",
+			compact: true
+		}] },
+		view: MarkdownView
+	})
+}));
+const input = /* @__PURE__ */ shakeable(() => ({
+	TextField: entry({
+		name: "TextField",
+		group: "input",
+		summary: "A single-line text input.",
+		props: z.object({
+			...fieldChrome,
+			value: z.string().optional().describe("Current value; bind it to the data model."),
+			placeholder: z.string().optional(),
+			type: z.enum([
+				"text",
+				"email",
+				"url",
+				"tel",
+				"number",
+				"password",
+				"search"
+			]).optional().describe("Input type; default text."),
+			required: z.boolean().optional(),
+			onChange: Action.optional().describe("Raised after the user stops typing.")
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { name: "" } },
+			components: [{
+				id: "name",
+				component: "TextField",
+				label: "Full name",
+				value: { path: "/form/name" },
+				placeholder: "Ada Lovelace",
+				onChange: { event: { name: "nameChanged" } }
+			}]
+		},
+		view: TextFieldView
+	}),
+	TextArea: entry({
+		name: "TextArea",
+		group: "input",
+		summary: "A multi-line text input.",
+		props: z.object({
+			...fieldChrome,
+			value: z.string().optional(),
+			placeholder: z.string().optional(),
+			rows: z.number().int().min(2).max(20).optional().describe("Visible rows; default 4."),
+			autoGrow: z.boolean().optional().describe("Grow with the content."),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { notes: "" } },
+			components: [{
+				id: "notes",
+				component: "TextArea",
+				label: "Notes",
+				value: { path: "/form/notes" },
+				rows: 3,
+				onChange: { event: { name: "notesChanged" } }
+			}]
+		},
+		view: TextAreaView
+	}),
+	Select: entry({
+		name: "Select",
+		group: "input",
+		summary: "A dropdown offering one of a fixed list of options.",
+		props: z.object({
+			...fieldChrome,
+			value: z.string().optional(),
+			placeholder: z.string().optional(),
+			options: z.array(Option).min(1).describe("The options to choose from."),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { region: "ap-south-1" } },
+			components: [{
+				id: "region",
+				component: "Select",
+				label: "Region",
+				value: { path: "/form/region" },
+				options: [{
+					value: "ap-south-1",
+					label: "Mumbai"
+				}, {
+					value: "eu-west-1",
+					label: "Ireland"
+				}],
+				onChange: { event: { name: "regionChanged" } }
+			}]
+		},
+		view: SelectView
+	}),
+	Checkbox: entry({
+		name: "Checkbox",
+		group: "input",
+		summary: "A single on/off box with a label.",
+		props: z.object({
+			label: z.string().optional().describe("Text beside the box."),
+			description: z.string().optional(),
+			disabled: z.boolean().optional(),
+			checked: z.boolean().optional(),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { terms: false } },
+			components: [{
+				id: "terms",
+				component: "Checkbox",
+				label: "I accept the terms",
+				checked: { path: "/form/terms" },
+				onChange: { event: { name: "termsChanged" } }
+			}]
+		},
+		view: CheckboxView
+	}),
+	Switch: entry({
+		name: "Switch",
+		group: "input",
+		summary: "A toggle for a setting that takes effect immediately.",
+		props: z.object({
+			label: z.string().optional(),
+			description: z.string().optional(),
+			disabled: z.boolean().optional(),
+			checked: z.boolean().optional(),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { alerts: true } },
+			components: [{
+				id: "alerts",
+				component: "Switch",
+				label: "Email alerts",
+				checked: { path: "/form/alerts" },
+				onChange: { event: { name: "alertsChanged" } }
+			}]
+		},
+		view: SwitchView
+	}),
+	RadioGroup: entry({
+		name: "RadioGroup",
+		group: "input",
+		summary: "One choice from a short visible list.",
+		props: z.object({
+			label: z.string().optional(),
+			description: z.string().optional(),
+			disabled: z.boolean().optional(),
+			value: z.string().optional(),
+			options: z.array(Option).min(2).describe("Two or more choices."),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { plan: "pro" } },
+			components: [{
+				id: "plan",
+				component: "RadioGroup",
+				label: "Plan",
+				value: { path: "/form/plan" },
+				options: [{
+					value: "free",
+					label: "Free"
+				}, {
+					value: "pro",
+					label: "Pro"
+				}],
+				onChange: { event: { name: "planChanged" } }
+			}]
+		},
+		view: RadioGroupView
+	}),
+	DateField: entry({
+		name: "DateField",
+		group: "input",
+		summary: "A date, typed or picked from a calendar. ISO yyyy-mm-dd on the wire.",
+		props: z.object({
+			...fieldChrome,
+			value: z.string().optional().describe("ISO date, yyyy-mm-dd."),
+			min: z.string().optional().describe("Earliest selectable ISO date."),
+			max: z.string().optional().describe("Latest selectable ISO date."),
+			onChange: Action.optional()
+		}),
+		events: ["change"],
+		children: "none",
+		example: {
+			data: { form: { start: "2026-09-01" } },
+			components: [{
+				id: "start",
+				component: "DateField",
+				label: "Start date",
+				value: { path: "/form/start" },
+				onChange: { event: { name: "startChanged" } }
+			}]
+		},
+		view: DateFieldView
+	}),
+	Button: entry({
+		name: "Button",
+		group: "input",
+		summary: "A button. Set submit to report the whole data model with the action.",
+		props: z.object({
+			label: z.string().describe("Button text."),
+			variant: buttonVariant.optional().describe("Visual weight; default primary."),
+			size: buttonSize.optional(),
+			disabled: z.boolean().optional(),
+			submit: z.boolean().optional().describe("Send the surface data model as the action payload; use for form submits."),
+			onPress: Action.optional().describe("Raised when the user presses the button.")
+		}),
+		events: ["press", "submit"],
+		children: "none",
+		example: { components: [{
+			id: "save",
+			component: "Button",
+			label: "Save",
+			variant: "primary",
+			submit: true,
+			onPress: { event: { name: "saveProfile" } }
+		}] },
+		view: ButtonView
+	}),
+	ButtonLink: entry({
+		name: "ButtonLink",
+		group: "input",
+		summary: "A link that looks like a button. Navigates; raises no action.",
+		props: z.object({
+			label: z.string(),
+			href: httpUrl,
+			variant: buttonVariant.optional().describe("Visual weight; default secondary."),
+			size: buttonSize.optional(),
+			target: z.enum(["_self", "_blank"]).optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "docs",
+			component: "ButtonLink",
+			label: "Open runbook",
+			href: "https://example.com/runbook",
+			target: "_blank"
+		}] },
+		view: ButtonLinkView
+	})
+}));
+const feedback = /* @__PURE__ */ shakeable(() => ({
+	Badge: entry({
+		name: "Badge",
+		group: "feedback",
+		summary: "A small status label.",
+		props: z.object({
+			label: z.string(),
+			variant: z.enum([
+				"default",
+				"success",
+				"warning",
+				"danger",
+				"info",
+				"neutral",
+				"outline"
+			]).optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "badge",
+			component: "Badge",
+			label: "Active",
+			variant: "success"
+		}] },
+		view: BadgeView
+	}),
+	Alert: entry({
+		name: "Alert",
+		group: "feedback",
+		summary: "A callout carrying a short message the user should notice.",
+		props: z.object({
+			title: z.string().optional(),
+			description: z.string().optional(),
+			variant: z.enum([
+				"default",
+				"success",
+				"warn",
+				"danger",
+				"info"
+			]).optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "alert",
+			component: "Alert",
+			variant: "warn",
+			title: "Quota at 90%",
+			description: "Upgrade before the end of the month."
+		}] },
+		view: AlertView
+	}),
+	Progress: entry({
+		name: "Progress",
+		group: "feedback",
+		summary: "A determinate or indeterminate progress bar.",
+		props: z.object({
+			value: z.number().nullable().optional().describe("Null renders the indeterminate bar."),
+			max: z.number().optional().describe("Maximum; default 100."),
+			label: z.string().optional(),
+			showValue: z.boolean().optional().describe("Set false to hide the numeric readout.")
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "progress",
+			component: "Progress",
+			label: "Indexing",
+			value: 64
+		}] },
+		view: ProgressViewComponent
+	}),
+	StatusDot: entry({
+		name: "StatusDot",
+		group: "feedback",
+		summary: "A coloured dot with a caption, for live status.",
+		props: z.object({
+			label: z.string().optional(),
+			tone: z.enum([
+				"accent",
+				"success",
+				"warning",
+				"danger",
+				"info",
+				"neutral"
+			]).optional(),
+			live: z.boolean().optional().describe("Add a pulsing halo for an active state.")
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "status",
+			component: "StatusDot",
+			label: "Running",
+			tone: "success",
+			live: true
+		}] },
+		view: StatusDotView
+	}),
+	EmptyState: entry({
+		name: "EmptyState",
+		group: "feedback",
+		summary: "The 'nothing here' surface; children become its actions.",
+		props: z.object({
+			title: z.string(),
+			description: z.string().optional(),
+			size: z.enum(["default", "compact"]).optional()
+		}),
+		events: [],
+		children: "many",
+		example: { components: [{
+			id: "empty",
+			component: "EmptyState",
+			title: "No results",
+			description: "Try a wider date range.",
+			children: ["empty-action"]
+		}, {
+			id: "empty-action",
+			component: "Button",
+			label: "Reset filters",
+			variant: "secondary",
+			onPress: { event: { name: "resetFilters" } }
+		}] },
+		view: EmptyStateView
+	})
+}));
+const data = /* @__PURE__ */ shakeable(() => ({
+	DataTable: entry({
+		name: "DataTable",
+		group: "data",
+		summary: "A sortable, searchable table. Pass rows inline, or a server sourceId obtained from a tool.",
+		props: z.object({
+			columns: z.array(z.object({
+				id: z.string().describe("Row property this column reads."),
+				label: z.string().optional().describe("Header text; defaults to the id."),
+				align: z.enum([
+					"start",
+					"center",
+					"end"
+				]).optional(),
+				filter: z.enum(["faceted", "text"]).optional().describe("Add a toolbar filter for this column."),
+				width: z.number().optional()
+			})).min(1),
+			dataSource: tableSource,
+			pageSize: z.number().int().min(1).max(200).optional().describe("Rows per page; default 10."),
+			density: z.enum(["default", "compact"]).optional(),
+			searchPlaceholder: z.string().optional(),
+			emptyMessage: z.string().optional(),
+			maxHeight: z.number().optional().describe("Scrolling body height in px."),
+			onRowClick: Action.optional().describe("Raised with the clicked row.")
+		}),
+		events: ["rowClick"],
+		children: "none",
+		example: { components: [{
+			id: "table",
+			component: "DataTable",
+			columns: [
+				{
+					id: "name",
+					label: "Name"
+				},
+				{
+					id: "status",
+					label: "Status",
+					filter: "faceted"
+				},
+				{
+					id: "deals",
+					label: "Deals",
+					align: "end"
+				}
+			],
+			dataSource: {
+				kind: "client",
+				rows: [{
+					name: "Ada Lovelace",
+					status: "active",
+					deals: 12
+				}, {
+					name: "Grace Hopper",
+					status: "invited",
+					deals: 4
+				}]
+			},
+			onRowClick: { event: { name: "openContact" } }
+		}] },
+		view: DataTableView
+	}),
+	Chart: entry({
+		name: "Chart",
+		group: "data",
+		summary: "Any chart the package draws: bar, line, area, pie, donut, scatter, radar, funnel, heatmap, calendar, treemap, sunburst.",
+		props: z.object({
+			type: chartType,
+			data: z.unknown().describe("Rows [{category, series…}] for bar/radar; series [{id, data:[{x,y}]}] for line/area/scatter/heatmap; slices [{id,value}] for pie/donut/funnel; days [{day,value}] for calendar; a tree {id, children} for treemap/sunburst."),
+			title: z.string().optional().describe("Caption above the chart."),
+			height: z.number().int().min(120).max(800).optional().describe("Drawing height in px."),
+			stacked: z.boolean().optional(),
+			legend: z.boolean().optional(),
+			grid: z.boolean().optional(),
+			scale: z.enum(["sequential", "diverging"]).optional().describe("Heatmap and calendar scale."),
+			indexBy: z.string().optional().describe("Category key for row data."),
+			keys: z.array(z.string()).optional().describe("Series keys for row data."),
+			from: z.string().optional().describe("Calendar range start, ISO date."),
+			to: z.string().optional().describe("Calendar range end, ISO date."),
+			emptyMessage: z.string().optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "chart",
+			component: "Chart",
+			type: "bar",
+			title: "Revenue by month",
+			data: [{
+				month: "Jan",
+				revenue: 42,
+				cost: 18
+			}, {
+				month: "Feb",
+				revenue: 51,
+				cost: 22
+			}]
+		}] },
+		view: ChartView
+	})
+}));
+const other = /* @__PURE__ */ shakeable(() => ({
+	Tabs: entry({
+		name: "Tabs",
+		group: "layout",
+		summary: "Tabbed panels; the nth child is the nth tab's panel.",
+		props: z.object({
+			tabs: z.array(z.object({
+				value: z.string(),
+				label: z.string()
+			})).min(2).describe("Tab bar, in order."),
+			value: z.string().optional().describe("Selected tab; defaults to the first."),
+			onChange: Action.optional()
+		}),
+		events: ["tabChange"],
+		children: "many",
+		example: { components: [
+			{
+				id: "tabs",
+				component: "Tabs",
+				tabs: [{
+					value: "summary",
+					label: "Summary"
+				}, {
+					value: "detail",
+					label: "Detail"
+				}],
+				children: ["tab-summary", "tab-detail"],
+				onChange: { event: { name: "tabChanged" } }
+			},
+			{
+				id: "tab-summary",
+				component: "Text",
+				text: "Two open incidents.",
+				role: "body"
+			},
+			{
+				id: "tab-detail",
+				component: "Text",
+				text: "INC-42, INC-51.",
+				role: "body"
+			}
+		] },
+		view: TabsView
+	}),
+	Image: entry({
+		name: "Image",
+		group: "text",
+		summary: "An image. Alt text is required.",
+		props: z.object({
+			src: imageUrl,
+			alt: z.string().describe("Alternative text; required."),
+			width: z.number().optional(),
+			height: z.number().optional(),
+			rounded: z.boolean().optional().describe("Set false for square corners."),
+			fit: z.enum(["cover", "contain"]).optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "image",
+			component: "Image",
+			src: "https://example.com/chart.png",
+			alt: "Revenue by month",
+			height: 160
+		}] },
+		view: ImageView
+	}),
+	Link: entry({
+		name: "Link",
+		group: "text",
+		summary: "An inline text link.",
+		props: z.object({
+			label: z.string(),
+			href: httpUrl,
+			target: z.enum(["_self", "_blank"]).optional()
+		}),
+		events: [],
+		children: "none",
+		example: { components: [{
+			id: "link",
+			component: "Link",
+			label: "View the incident",
+			href: "https://example.com/inc-42",
+			target: "_blank"
+		}] },
+		view: LinkView
+	})
+}));
+/**
+* The catalogue an agent draws from, and the renderer's default.
+*
+* A host may narrow it (hand the renderer a subset) but should not widen it
+* with components the prompt does not describe: an agent can only usefully
+* emit what `catalogue-doc.ts` told it about.
+*/
+const defaultCatalogue = /* @__PURE__ */ shakeable(() => Object.freeze({
+	...layout,
+	...text,
+	...input,
+	...feedback,
+	...data,
+	...other
+}));
+/** Catalogue id an agent may echo in `createSurface.catalogId`. */
+const A2UI_CATALOGUE_ID = "https://cortena.ai/a2ui/catalogues/cortena-ui/v1.json";
+/** Every component name in the catalogue, sorted. */
+function catalogueNames(catalogue = defaultCatalogue) {
+	return Object.keys(catalogue).sort();
+}
+//#endregion
+export { A2UI_CATALOGUE_ID, catalogueNames, defaultCatalogue };
+
+//# sourceMappingURL=catalogue.js.map