@copilotkit/react-core 2.0.0-rc.1 → 2.0.0-rc.10

package/dist/generative-ui.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generative-ui.d.mts","names":[],"sources":["../src/generative-ui/refs.ts","../src/generative-ui/catalog-export.ts","../src/generative-ui/GenerativeUISurface.tsx","../src/generative-ui/markdown/MarkdownSurfaces.tsx","../src/generative-ui/hooks.ts","../src/generative-ui/standard/index.ts"],"mappings":";;;;;;;;;;;;;iBAgCgB,KAAA,CAAM,WAAA,YAAoB,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA,uCAAA,KAAA,CAAA,YAAA,mBAAA,KAAA,CAAA,qBAAA,SAAA,QAAA,CAAA,SAAA,IAAA,KAAA,CAAA,WAAA;;;AAA1C;;;;iBAcgB,SAAA,CAAU,WAAA,YAAoB,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,QAAA,EAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,SAAA,WAAA,CAAA,CAAA,SAAA;;;;;;;;;gFAAA,KAAA,CAAA,qBAAA;;;;;;;UChB7B,wBAAA;;EAEf,KAAA;;EAEA,WAAA;;EAEA,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;ADUF;;;iBCkBgB,iBAAA,CACd,EAAA,EAAI,YAAA,EACJ,OAAA,GAAS,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UC1DD,4BAAA;;EAER,EAAA;;;;;EAKA,WAAA;EFiBmB;EEfnB,QAAA,GAAW,SAAA;EACX,SAAA;EFcwC;;;;;;EEPxC,UAAA;AAAA;;;;;KAqBU,wBAAA,YACC,YAAA,QAAoB,YAAA,SAC7B,4BAAA;EFhBsC;;;;EEuBlC,EAAA,EAAI,EAAA;EFvB8B;;AAc1C;;;;EEgBQ,UAAA,YAAsB,yBAAA,CAA0B,EAAA;AAAA;EAEhD,EAAA;EAAgB,UAAA;AAAA;;;;;;;;;;;;;;;iBA0CR,mBAAA,YACH,YAAA,QAAoB,YAAA,MAAA,CAAA;EAE/B,EAAA;EACA,WAAA;EACA,EAAA;EACA,UAAA;EACA,QAAA;EACA,SAAA;EACA;AAAA,GACC,wBAAA,CAAyB,EAAA,IAAG,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;KCnG1B,aAAA,GAAgB,4BAAA;;;;;;AHerB;KGmDY,qBAAA,GAAwB,aAAA;EHnDM,sEGqDxC,OAAA,UHrDwC;EGuDxC,SAAA,UHvDwC;EGyDxC,WAAA;AAAA;;;;;;;;;;;;;;;AH3CF;;;;iBGsJgB,gBAAA,CAAA;EACd,OAAA;EACA,SAAA;EACA,WAAA;EAAA,GACG;AAAA,GACF,qBAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;KC/KnB,UAAA,YACQ,YAAA,yBACO,mBAAA,CAAoB,EAAA,KACpC,WAAA,CAAY,yBAAA,CAA0B,EAAA,WAAa,GAAA;;;AJGvD;;;;;;;;;;;;;;;;iBIiBgB,oBAAA,YACH,YAAA,yBACO,mBAAA,CAAoB,EAAA,WAAA,CACtC,EAAA,EAAI,EAAA,EAAI,GAAA,EAAK,GAAA,EAAK,KAAA,EAAO,UAAA,CAAW,EAAA,EAAI,GAAA;;;;;;;;AJN1C;;;;;;;;;;;;;;;iBIgEgB,uBAAA,YACH,YAAA,oBACE,wBAAA,CAAyB,EAAA,EAAA,CAEtC,EAAA,EAAI,EAAA,EACJ,IAAA,EAAM,IAAA,EACN,OAAA,GAAU,IAAA,EAAM,wBAAA,CAAyB,EAAA,EAAI,IAAA;;;;;;;;;;;;AJpF/C;;;;;;;;;;;;;;;cKuCa,UAAA;;;;;;cAGX,GAAA,CAAA,SAAA"}
+{"version":3,"file":"generative-ui.d.mts","names":[],"sources":["../src/generative-ui/refs.ts","../src/generative-ui/catalog-export.ts","../src/generative-ui/GenerativeUISurface.tsx","../src/generative-ui/markdown/MarkdownSurfaces.tsx","../src/generative-ui/hooks.ts","../src/generative-ui/standard/index.ts"],"mappings":";;;;;;;;;;;;;iBAgCgB,KAAA,CAAM,WAAA,YAAoB,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,SAAA,EAAA,CAAA,CAAA,YAAA,sCAAA,KAAA,CAAA,YAAA,mBAAA,KAAA,CAAA,qBAAA,SAAA,QAAA,CAAA,SAAA,IAAA,KAAA,CAAA,WAAA;;;AAA1C;;;;iBAcgB,SAAA,CAAU,WAAA,YAAoB,CAAA,CAAA,OAAA,CAAA,CAAA,CAAA,QAAA,WAAA,CAAA,CAAA,QAAA,CAAA,CAAA,CAAA,SAAA,GAAA,CAAA,CAAA,SAAA;;;8GAAA,KAAA,CAAA,qBAAA;;;;;;;UChB7B,wBAAA;;EAEf,KAAA;;EAEA,WAAA;;EAEA,YAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4Bc,iBAAA,CACd,EAAA,EAAI,YAAA,EACJ,OAAA,GAAS,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UC1DD,4BAAA;;EAER,EAAA;;;;;EAKA,WAAA;EFiBmB;EEfnB,QAAA,GAAW,SAAA;EACX,SAAA;EFcwC;;;;;;EEPxC,UAAA;AAAA;;;;;KAqBU,wBAAA,YACC,YAAA,QAAoB,YAAA,SAC7B,4BAAA;EFhBsC;;;;EEuBlC,EAAA,EAAI,EAAA;EFvB8B;;;;;AAc1C;EEgBQ,UAAA,YAAsB,yBAAA,CAA0B,EAAA;AAAA;EAEhD,EAAA;EAAgB,UAAA;AAAA;;;;;;;;;;;;;;;iBA0CR,mBAAA,YACH,YAAA,QAAoB,YAAA,MAAA,CAAA;EAE/B,EAAA;EACA,WAAA;EACA,EAAA;EACA,UAAA;EACA,QAAA;EACA,SAAA;EACA;AAAA,GACC,wBAAA,CAAyB,EAAA,IAAG,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;KCnG1B,aAAA,GAAgB,4BAAA;;;;;;AHerB;KGmDY,qBAAA,GAAwB,aAAA;EHnDM,sEGqDxC,OAAA,UHrDwC;EGuDxC,SAAA,UHvDwC;EGyDxC,WAAA;AAAA;;;;;;;;;;;;;;;;;;AH3CF;iBGsJgB,gBAAA,CAAA;EACd,OAAA;EACA,SAAA;EACA,WAAA;EAAA,GACG;AAAA,GACF,qBAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;KC/KnB,UAAA,YACQ,YAAA,yBACO,mBAAA,CAAoB,EAAA,KACpC,WAAA,CAAY,yBAAA,CAA0B,EAAA,WAAa,GAAA;;;AJGvD;;;;;;;;;;;;;;;;iBIiBgB,oBAAA,YACH,YAAA,yBACO,mBAAA,CAAoB,EAAA,WAAA,CACtC,EAAA,EAAI,EAAA,EAAI,GAAA,EAAK,GAAA,EAAK,KAAA,EAAO,UAAA,CAAW,EAAA,EAAI,GAAA;;;;;;;;;;;AJN1C;;;;;;;;;;;;iBIgEgB,uBAAA,YACH,YAAA,oBACE,wBAAA,CAAyB,EAAA,EAAA,CAEtC,EAAA,EAAI,EAAA,EACJ,IAAA,EAAM,IAAA,EACN,OAAA,GAAU,IAAA,EAAM,wBAAA,CAAyB,EAAA,EAAI,IAAA;;;;;;;;;;;;AJpF/C;;;;;;;;;;;;;;;cKuCa,UAAA;;;;;;cAGX,CAAA,CAAA,SAAA"}

package/dist/generative-ui.mjs

@@ -1,10 +1,10 @@
 "use client";
 
-import { A as GenerativeUIError, F as toJsonSchema, P as createGenerativeUI, _ as GenerativeUINodeContext, b as useRequiredGenerativeUIRuntime, c as SurfaceView, d as namedRole, f as useGenerativeUIAccessibility, g as useManagerVersion, h as useGenerativeUIState, j as isRecord, l as DARK_THEME_CSS, m as useGenerativeUIFunction, n as ProviderMarkdown, p as wrapperAria, r as DefaultGenerativeUIChatCard, t as MarkdownSurfaces, u as controlAria, y as useGenerativeUIRuntime } from "./MarkdownSurfaces-ChSlVYOk.mjs";
+import { F as toJsonSchema, K as IconSvg, O as isRecord, P as createGenerativeUI, _ as GenerativeUINodeContext, b as useRequiredGenerativeUIRuntime, c as SurfaceView, d as namedRole, f as useGenerativeUIAccessibility, g as useManagerVersion, h as useGenerativeUIState, j as GenerativeUIError, l as DARK_THEME_CSS, m as useGenerativeUIFunction, n as ProviderMarkdown, p as wrapperAria, r as DefaultGenerativeUIChatCard, t as MarkdownSurfaces, u as controlAria, y as useGenerativeUIRuntime } from "./MarkdownSurfaces-CimUSR3Y.mjs";
 import React, { Suspense, createContext, isValidElement, memo, useCallback, useContext, useEffect, useId, useInsertionEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { A2UI_CHILD_LIST_MARK, A2UI_CHILD_LIST_REF, A2UI_COMPONENT_ID_MARK, A2UI_COMPONENT_ID_REF, GENERATIVE_UI_FUNCTIONS, GENERATIVE_UI_MAX_TARGET_COMPONENTS, childRefKind, functionCallers } from "@copilotkit/shared";
-import { z } from "zod";
+import * as z from "zod";
 import { createPortal } from "react-dom";
 
 //#region src/generative-ui/refs.ts
@@ -584,27 +584,6 @@ const BORDER_COLORS = [
 	"danger",
 	"discovery"
 ];
-const BACKGROUNDS = [
-	"surface",
-	"surface-secondary",
-	"surface-tertiary",
-	"surface-elevated",
-	"surface-elevated-secondary",
-	"surface-inverted",
-	"surface-soft",
-	"info",
-	"warning",
-	"caution",
-	"success",
-	"danger",
-	"discovery",
-	"info-solid",
-	"warning-solid",
-	"caution-solid",
-	"success-solid",
-	"danger-solid",
-	"discovery-solid"
-];
 const RADIUS_PX = {
 	"2xs": "2px",
 	xs: "4px",
@@ -995,7 +974,7 @@ const layoutProps = {
 	rowGap: sizeValue.optional(),
 	columnGap: sizeValue.optional(),
 	padding: sizeValue.optional().describe("4px steps when a number"),
-	background: z.string().optional().describe(`One of ${BACKGROUNDS.join("|")} or a CSS color. Leave it unset. Only one summary panel in a Card can use "surface-secondary"`),
+	background: z.string().optional().describe("Leave it unset. A surface token such as surface, surface-secondary, info, success, warning, danger, discovery, or one with -solid, or a CSS color. Only one summary panel in a Card uses \"surface-secondary\""),
 	border: z.boolean().optional(),
 	borderColor: z.enum(BORDER_COLORS).optional(),
 	radius: radiusValue.optional(),
@@ -1863,7 +1842,7 @@ const layoutComponents = {
 	},
 	Row: {
 		component: Row,
-		description: "A horizontal flex container. For a label and value pair, use a Row with justify \"spaceBetween\": a Caption on the left and a Text with fontWeight \"medium\" on the right. Put buttons in a Row at the bottom of a Card: one Button with variant \"primary\", and the default or \"borderless\" for the others.",
+		description: "A horizontal flex container. Label and value pair: justify \"spaceBetween\", a Caption left and a Text with fontWeight \"medium\" right. Buttons go in a Row at the bottom of a Card: one variant \"primary\", the others default or \"borderless\".",
 		props: layoutSchema,
 		events: VISIBLE_EVENT,
 		slots: CHILDREN_SLOT
@@ -1884,7 +1863,7 @@ const layoutComponents = {
 	},
 	Card: {
 		component: Card,
-		description: "A bordered, padded container, only for an interactive panel (controls, a form, a configurator). Tables, charts and text do not need one. Give it a Title and a Caption. Separate the groups in it with a Divider or the plain gap, never with a nested Card or a bordered Box. Variant \"section\" is a heading and content without a box. Variant \"outline\" always has a box. In markdown mode, a Card without controls renders as \"section\" unless it sets variant or border.",
+		description: "A bordered panel, only for an interactive panel (controls, a form, a configurator); tables, charts and text need none. Give it a Title and a Caption. Separate groups with a Divider or the gap, never a nested Card or bordered Box. Variant \"section\": no box; \"outline\": always a box. In markdown mode, without controls it renders as \"section\" unless variant or border is set.",
 		props: cardSchema,
 		events: VISIBLE_EVENT,
 		slots: {
@@ -1908,7 +1887,7 @@ const layoutComponents = {
 	},
 	Carousel: {
 		component: Carousel,
-		description: "A row that scrolls horizontally and snaps to its slides, with previous and next arrows. Put CarouselItem or CarouselMediaItem children in it. Bind activeIndex with { \"@path\": \"/x\" } to read or set the slide in view.",
+		description: "A horizontally scrolling row that snaps to its CarouselItem or CarouselMediaItem children, with arrows. Bind activeIndex to read or set the slide in view.",
 		props: carouselSchema,
 		events: VISIBLE_EVENT,
 		slots: CHILDREN_SLOT,
@@ -1923,7 +1902,7 @@ const layoutComponents = {
 	},
 	CarouselMediaItem: {
 		component: CarouselMediaItem,
-		description: "A slide of a Carousel with an image on top and its children (a Caption, a Text) under it. size \"sm\" is 160px, \"md\" 240px (default), \"lg\" 320px wide. A click on the image opens all slides full-screen, unless href or onClick is set.",
+		description: "A Carousel slide: an image with its children (a Caption, a Text) under it. size \"sm\" 160px, \"md\" 240px (default), \"lg\" 320px wide. A click opens all slides full-screen, unless href or onClick is set.",
 		props: carouselMediaItemSchema,
 		events: {
 			...VISIBLE_EVENT,
@@ -2290,10 +2269,14 @@ const ICON_STROKE = {
 function kebabToPascal(name) {
 	return name.split(/[-_\s]+/).filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
 }
+/** "ArrowRight" gives "arrow-right", as Lucide names its icon classes. */
+function pascalToKebab(name) {
+	return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
 let lucidePromise = null;
 let lucideIcons = null;
 function loadLucideIcons() {
-	lucidePromise ??= import("lucide-react").then((module) => {
+	lucidePromise ??= import("lucide").then((module) => {
 		const icons = module.icons;
 		lucideIcons = icons;
 		return icons;
@@ -2301,9 +2284,9 @@ function loadLucideIcons() {
 	return lucidePromise;
 }
 /**
-* lucide-react has about 1,500 icons. A static import of its `icons` map
-* puts all of them in every bundle and makes module load slow. So the map
-* loads once, on first use, and the icons show when it is there.
+* Lucide has about 1,500 icons. A static import of its `icons` map puts all
+* of them in every bundle and makes module load slow. So the map loads once,
+* on first use, and the icons show when it is there.
 */
 function useLucideIcons() {
 	const [icons, setIcons] = useState(lucideIcons);
@@ -2319,6 +2302,20 @@ function useLucideIcons() {
 	}, []);
 	return icons;
 }
+/** The icon for a kebab-case or PascalCase name, or `null` when there is none. */
+function findLucideIcon(icons, name) {
+	const pascalName = kebabToPascal(name);
+	const key = pascalName in icons ? pascalName : name in icons ? name : null;
+	if (key === null) return null;
+	const nodes = icons[key].map(([tag, attributes]) => ({
+		tag,
+		attributes
+	}));
+	return {
+		lucideName: pascalToKebab(key),
+		nodes
+	};
+}
 /**
 * A lucide icon by kebab-case (or PascalCase) name. An unknown name renders
 * nothing. Without a `label`, the icon is hidden from screen readers.
@@ -2331,18 +2328,20 @@ function useLucideIcons() {
 function LucideIcon({ name, label, description, size = "md", color, weight, inline, style }) {
 	const icons = useLucideIcons();
 	if (!name || !icons) return null;
-	const IconComponent = icons[kebabToPascal(name)] ?? icons[name];
-	if (!IconComponent) return null;
+	const icon = findLucideIcon(icons, name);
+	if (!icon) return null;
 	const pixels = typeof size === "number" ? size : inline ? "1em" : ICON_PX$1[size];
-	return /* @__PURE__ */ jsx(IconComponent, {
-		...label === void 0 ? { "aria-hidden": true } : {
-			role: "img",
-			"aria-label": label,
-			"aria-description": description
-		},
+	const a11y = label === void 0 ? { "aria-hidden": true } : {
+		role: "img",
+		"aria-label": label,
+		"aria-description": description
+	};
+	return /* @__PURE__ */ jsx(IconSvg, {
+		lucideName: icon.lucideName,
+		nodes: icon.nodes,
+		...a11y,
 		focusable: "false",
-		width: pixels,
-		height: pixels,
+		size: pixels,
 		color: textColor(color) ?? "currentColor",
 		strokeWidth: weight ? ICON_STROKE[weight] : void 0,
 		style: {
@@ -2998,7 +2997,7 @@ const mediaComponents = {
 	},
 	Video: {
 		component: Video,
-		description: "A video player for a video file URL (with optional captions), or a YouTube link in privacy-enhanced mode: the poster shows first, and the player loads when the user presses play. A page on another video site shows as a link to it. Set title to name the video.",
+		description: "A video file URL (optional captions) or a YouTube link, privacy-enhanced: the poster shows until play. Other video sites show as a link. Set title.",
 		props: videoSchema
 	},
 	AudioPlayer: {
@@ -3044,7 +3043,7 @@ const followUpItem = z.union([z.string(), z.object({
 	message: text("The text sent when the user clicks. Default: label")
 })]);
 const followUpSchema = z.object({
-	items: z.array(followUpItem).optional().describe("Strings or { \"label\", \"message\"? }, or { \"@path\": \"/x\" }"),
+	items: z.array(followUpItem).optional(),
 	title: text("A caption above the pills")
 });
 const followUpArgs = z.object({ message: z.string().describe("The message of the clicked pill") });
@@ -3092,7 +3091,7 @@ const gridImage = z.object({
 	href: text("Opens this URL instead of the full-screen view")
 });
 const imageGridSchema = z.object({
-	images: z.array(gridImage).optional().describe("A list of { \"url\", \"description\"?, \"caption\"?, \"href\"? }, or { \"@path\": \"/x\" }"),
+	images: z.array(gridImage).optional(),
 	columns: z.number().optional().describe("Default 3"),
 	aspectRatio: z.string().optional().describe("Default \"1 / 1\""),
 	gap: sizeValue.optional().describe("Default 2"),
@@ -3672,7 +3671,7 @@ function ImageGrid(props) {
 const compositeComponents = {
 	LinkCard: {
 		component: LinkCard,
-		description: "A preview card of a URL: the favicon and domain, the title, a description and a thumbnail. A click opens the link in a new tab, or sends onClick when it is bound. Use it for sources, articles and products that have a page.",
+		description: "A preview of a URL: favicon and domain, title, description, thumbnail. A click opens it in a new tab, or sends onClick when bound. For sources, articles and products with a page.",
 		props: linkCardSchema,
 		events: { onClick: {
 			description: "Sent when the user clicks the card, instead of the link.",
@@ -3681,12 +3680,12 @@ const compositeComponents = {
 	},
 	Citation: {
 		component: Citation,
-		description: "An inline source marker ([1]) that shows the source on hover or click: the title, a snippet and a link. Put it inline after the sentence it supports, as a child of a Text or in a Row.",
+		description: "An inline source marker ([1]) showing title, snippet and link on hover or click. Put it right after the sentence it supports, as a child of a Text or in a Row.",
 		props: citationSchema
 	},
 	FollowUp: {
 		component: FollowUp,
-		description: "Suggested next prompts as pills. A click sends the message of the pill as the next turn of the user, with no event binding needed. Put it at the end of a surface, with two to four short items.",
+		description: "Suggested next prompts as pills; a click sends the pill's message as the user's next turn, no event needed. At the end of a surface, two to four short items.",
 		props: followUpSchema,
 		events: { onFollowUp: {
 			description: "Sent when the user clicks a pill. The args carry the message of the pill.",
@@ -3695,7 +3694,7 @@ const compositeComponents = {
 	},
 	EntityCard: {
 		component: EntityCard,
-		description: "A card for one thing (a product, place, person or listing): an image, title, subtitle, description, a price or meta line, a badge, a rating and up to three buttons. href opens a page, and onClick is sent when it is bound. Use a Grid of EntityCards for several things.",
+		description: "A card for one product, place, person or listing: image, title, subtitle, description, a price or meta line, badge, rating and up to three buttons. href opens a page; onClick is sent when bound. Use a Grid of them for several things.",
 		props: entityCardSchema,
 		events: {
 			onClick: {
@@ -3731,9 +3730,9 @@ const chartSchema = z.object({
 		"pie",
 		"donut"
 	]).optional().describe("Default \"bar\""),
-	data: z.array(z.record(z.string(), z.unknown())).optional().describe("A list of objects, or { \"@path\": \"/x\" }"),
+	data: z.array(z.record(z.string(), z.unknown())).optional(),
 	xKey: z.string().optional().describe("The field of the category axis"),
-	series: z.array(chartSeries).optional().describe("The value fields: strings or { \"key\", \"label\"?, \"color\"? }. Default: every number field except xKey"),
+	series: z.array(chartSeries).optional().describe("Default: every number field except xKey"),
 	stacked: z.boolean().optional(),
 	layout: z.enum(["vertical", "horizontal"]).optional().describe("\"horizontal\" draws the bars from left to right. Default \"vertical\""),
 	yAxis: z.object({
@@ -3741,7 +3740,7 @@ const chartSchema = z.object({
 		min: z.number().optional(),
 		max: z.number().optional(),
 		width: z.number().optional().describe("Pixels")
-	}).optional().describe("The value axis configuration object: {label?: string, min?: number, max?: number, width?: number}. Example: {label: \"Revenue (USD)\", min: 0, max: 100}. In horizontal charts, label, min and max apply to the horizontal value axis, and width sets the width of the category axis on the left."),
+	}).optional().describe("Example: {label: \"Revenue (USD)\", min: 0, max: 100}. In a horizontal chart it is the horizontal axis, and width sets the category axis width"),
 	showDots: z.boolean().optional().describe("Point markers on a line or area"),
 	barRadius: z.number().optional().describe("The corner radius of a bar, in pixels"),
 	innerRadius: z.union([z.number(), z.string()]).optional().describe("Pie and donut"),
@@ -3760,7 +3759,7 @@ const chartSchema = z.object({
 		"number",
 		"currency",
 		"percent"
-	]).optional().describe("Number formatting. With \"percent\", data values and axis min/max are fractions: 0.4 displays as 40%. For 0% to 10%, use min: 0 and max: 0.1."),
+	]).optional().describe("With \"percent\", data values and axis min/max are fractions: 0.4 shows as 40%; for 0% to 10%, use min: 0 and max: 0.1."),
 	currency: z.string().optional().describe("ISO code. Default \"USD\""),
 	title: z.string().optional()
 });
@@ -4174,7 +4173,7 @@ const mapMarker = z.object({
 	icon: z.string().optional()
 });
 const mapSchema = z.object({
-	markers: z.array(mapMarker).optional().describe("A list of places, or { \"@path\": \"/x\" }"),
+	markers: z.array(mapMarker).optional(),
 	route: z.boolean().optional().describe("Draws a line through the markers in order"),
 	selected: z.string().optional().describe("The label of the selected marker. Bind it with { \"@path\": \"/x\" } to read the choice of the user"),
 	height: z.number().optional().describe("Pixels. Default 240"),
@@ -4502,8 +4501,8 @@ const tableColumn = z.union([
 ]);
 const tableSchema = z.object({
 	caption: z.string().optional().describe("A short name of the table for screen readers. It is not shown"),
-	columns: z.array(tableColumn).optional().describe("Strings, { \"label\", \"align\"?, \"width\"?, \"componentId\"? } or { \"componentId\" }, or { \"@path\": \"/x\" }. Default []"),
-	rows: z.array(z.array(z.unknown())).optional().describe("A list of row lists, or { \"@path\": \"/x\" }. A cell is a string, a number, or { \"componentId\": \"<id>\" } to show a component. Default []"),
+	columns: z.array(tableColumn).optional().describe("Default []"),
+	rows: z.array(z.array(z.unknown())).optional().describe("A list of row lists. A cell is a string, a number, or { \"componentId\": \"<id>\" } to show a component. Default []"),
 	columnSizing: z.enum(["auto", "equal"]).optional().describe("Default \"auto\""),
 	dividers: z.boolean().optional().describe("Default true"),
 	stickyHeader: z.boolean().optional().describe("Default false"),
@@ -4535,7 +4534,7 @@ const listItemValue = z.union([z.string(), z.object({
 	value: z.union([z.string(), z.number()]).optional().describe("Without an action: shown on the right of the label, for a key and value fact. With an action: the payload of the pick, not shown")
 })]);
 const listSchema = z.object({
-	items: z.array(listItemValue).optional().describe("Strings or { \"label\", \"value\"?, \"description\"?, \"icon\"? }, or { \"@path\": \"/x\" }"),
+	items: z.array(listItemValue).optional(),
 	direction: z.enum(["vertical", "horizontal"]).optional().describe("Default \"vertical\". \"horizontal\" scrolls sideways"),
 	align: z.enum([
 		"start",
@@ -4989,7 +4988,7 @@ function ListItem(props) {
 const dataComponents = {
 	Table: {
 		component: Table,
-		description: "A data table. Put it in a plain Column, not in a Card. Give \"columns\" and \"rows\" (a list of row lists). Or give \"children\": TableSection or TableRow ids, or a template { \"componentId\", \"path\" } that repeats a TableRow for each item of a data list. To show a component (Badge, Button, Icon, Text) in a cell or a column header, set it to { \"componentId\": \"<id>\" } and put the id in \"cellComponents\".",
+		description: "A data table, in a plain Column, not a Card. Give \"columns\" and \"rows\", or \"children\": TableSection or TableRow ids, or a template { \"componentId\", \"path\" } repeating a TableRow per item. A component in a cell or header (Badge, Button, Icon, Text): { \"componentId\": \"<id>\" }, with the id in \"cellComponents\".",
 		props: tableSchema,
 		slots: {
 			children: "multiple",
@@ -5019,7 +5018,7 @@ const dataComponents = {
 	},
 	List: {
 		component: List,
-		description: "A list in a Card or next to another component. A plain list of text is markdown, not a List. Give \"items\" (strings or { \"label\", \"value\"?, \"description\"?, \"icon\"? }); without an action, an item with a value is a key and value row, for facts like Price: $1,599. Or, when there are no items, give \"children\": ListItem ids or a template. With an \"action\", the user can pick an item: the event context gets \"index\", \"label\" and \"value\" of the item.",
+		description: "A list in a Card or next to another component; a plain list of text is markdown. Give \"items\": an item with a value and no action is a key-value row (Price: $1,599). Or give \"children\": ListItem ids or a template. With \"action\" the user picks an item; the event context gets its index, label and value.",
 		props: listSchema,
 		events: { action: {
 			description: "Runs when the user picks an item. The args are the index, label and value of the item.",
@@ -5044,7 +5043,7 @@ const dataComponents = {
 	},
 	Map: {
 		component: MapView,
-		description: "A map with markers. With \"route\", a line connects the markers in order. Bind \"selected\" to { \"@path\": \"/x\" } to get the label of the marker that the user picks. When maps are not available, it shows a list of the places.",
+		description: "A map with markers; with \"route\" a line connects them in order. Bind \"selected\" to get the label of the marker the user picks. Without maps it shows a list of the places.",
 		props: mapSchema,
 		writable: ["selected"]
 	}
@@ -5600,7 +5599,7 @@ const feedbackComponents = {
 	},
 	Popover: {
 		component: Popover,
-		description: "A small overlay next to a trigger. Put exactly two children in it: one PopoverTrigger, then one PopoverContent. A click on the trigger opens and closes the content. Escape or a click outside closes it.",
+		description: "A small overlay: exactly two children, one PopoverTrigger then one PopoverContent. A click on the trigger toggles it; Escape or a click outside closes it.",
 		props: popoverSchema,
 		slots: CHILDREN_SLOT,
 		writable: ["open"]
@@ -5648,7 +5647,7 @@ const validationResult = z.object({
 	message: z.string().optional(),
 	code: z.string().optional(),
 	severity: severity.optional()
-}).passthrough();
+}).loose();
 const checksProp = z.array(z.object({
 	condition: z.union([z.boolean(), validationResult]).optional().describe("A validator call, for example {\"@call\":\"required\",\"args\":{\"value\":{\"@path\":\"/x\"}}}, or a boolean binding"),
 	message: z.string().optional().describe("Shown when the check fails, instead of the default message")
@@ -5734,7 +5733,7 @@ const optionList = z.array(z.union([z.string(), z.object({
 	value: z.string(),
 	label: z.string().optional(),
 	description: z.string().optional()
-})])).optional().describe("Strings or { \"value\", \"label\", \"description\"? }");
+})])).optional();
 const SIZES = [
 	"sm",
 	"md",
@@ -7186,7 +7185,7 @@ function Slider(props) {
 const inputComponents = {
 	Button: {
 		component: Button,
-		description: "A button that sends its onClick event. With href it opens the URL, and with copy it copies the text, both without the agent. Use variant \"primary\" for the one main Button in a Row, and the default for the others. With submit true inside a Form, it submits the Form. The child or children render instead of the label. With checks, it is disabled while a check fails.",
+		description: "Sends its onClick event; with href it opens the URL, with copy it copies the text. Variant \"primary\" for the one main Button in a Row. submit true submits the Form around it. Its children render instead of the label. With checks it is disabled while a check fails.",
 		props: buttonSchema,
 		events: { onClick: {
 			description: "Sent when the user clicks the button.",
@@ -7212,7 +7211,7 @@ const inputComponents = {
 	},
 	Form: {
 		component: Form,
-		description: "A layout container that is a form. It sends its onSubmit event when the user submits it (a Button with submit true, or Enter in a field). Put the values of its fields in the event context with { \"@path\": \"/x\" }.",
+		description: "A layout container that is a form. It sends onSubmit when the user submits (a Button with submit true, or Enter in a field). Put its field values in the event context with { \"@path\": \"/x\" }.",
 		props: formSchema,
 		events: { onSubmit: {
 			description: "Sent when the user submits the form.",
@@ -7269,13 +7268,13 @@ const inputComponents = {
 	},
 	ChoicePicker: {
 		component: ChoicePicker,
-		description: "A list of options, as checkboxes or chips. The user picks one, or several with variant \"multipleSelection\". Bind value with { \"@path\": \"/x\" } to read the chosen values as a list. Give it a label.",
+		description: "Options as checkboxes or chips: pick one, or several with variant \"multipleSelection\". Its value is the list of chosen values. Give it a label.",
 		props: choicePickerSchema,
 		writable: VALUE_WRITABLE
 	},
 	DateTimeInput: {
 		component: DateTimeInput,
-		description: "A date picker, or a time picker with enableTime, or both. Set timeStep (minutes) to offer fixed times, e.g. 30 for a booking. The value is ISO 8601. Bind value with { \"@path\": \"/x\" } to read it. Give it a label.",
+		description: "A date picker, a time picker with enableTime, or both. timeStep (minutes) offers fixed times, e.g. 30 for a booking. The value is ISO 8601. Give it a label.",
 		props: dateTimeInputSchema,
 		writable: VALUE_WRITABLE
 	}
@@ -7778,12 +7777,12 @@ function Tooltip({ trigger, content }) {
 const textComponents = {
 	Title: {
 		component: Title,
-		description: "A heading inside a Card or next to another component. A heading alone is markdown outside the fence. Use size \"2xl\" at most once in a surface, and \"lg\" for section headings. Size \"sm\" is an h4, \"md\" and \"lg\" are an h3 (default \"md\"), \"xl\" and larger are an h2. It is bold unless strong is false.",
+		description: "A heading in a Card or next to another component; a heading alone is markdown. Size \"2xl\" at most once per surface, \"lg\" for sections. \"sm\" is an h4, \"md\"/\"lg\" an h3 (default \"md\"), \"xl\" and up an h2. Bold unless strong is false.",
 		props: titleSchema
 	},
 	Text: {
 		component: Text,
-		description: "Body text inside a Card or next to another component. A paragraph alone is markdown outside the fence. Use color \"default\" or \"secondary\". `text` can have inline markdown: **bold**, *italic*, ~~strike~~, ++underline++, `code` and [link](https://example.com). The `children` ids render inline after the text, for example a Badge.",
+		description: "Body text in a Card or next to another component; a paragraph alone is markdown outside the fence. Color \"default\" or \"secondary\". `text` takes inline markdown (**bold**, *italic*, ~~strike~~, ++underline++, `code`, [link](url)). `children` ids render inline after it, e.g. a Badge.",
 		props: textSchema,
 		slots: CHILDREN_SLOT
 	},
@@ -7854,7 +7853,7 @@ const textComponents = {
 	},
 	Tooltip: {
 		component: Tooltip,
-		description: "Shows `content` when the user points at `trigger` or moves keyboard focus to it. `trigger` is one child id: a Text, Icon or Badge, not a Button or Link. `content` is one child id of short text, for example a Text. Do not put links or buttons in `content`.",
+		description: "Shows `content` when the user points at or focuses `trigger`. `trigger`: one child id, a Text, Icon or Badge (not a Button or Link). `content`: one child id of short text, no links or buttons.",
 		slots: {
 			trigger: "single",
 			content: "single"