@mcp-b/react-components 0.48.0 → 0.49.0

package/dist/components/agents-sdk/WorkspaceMountManager.js

@@ -1,19 +1,16 @@
-import { I as PaperclipIcon } from "../../icons-CeGfXO21.js";
 import { Button } from "../foundations/Button.js";
-import { Card, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
-import { Popover } from "../foundations/Popover.js";
 import { EmptyState } from "../foundations/EmptyState.js";
-import { AppTopBar } from "../general-purpose/AppTopBar.js";
+import { Popover } from "../foundations/Popover.js";
+import { Card, CardFooter, CardHeader, CardTitle } from "../foundations/Card.js";
 import "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/agents-sdk/WorkspaceMountManager.tsx
 /** Controlled local-mount presentation; native handles and persistence stay in the host. */
-function WorkspaceMountManager({ mounts, adding = false, busyMountId = null, error, onAdd, onReconnect, onRemove, triggerLabel = "Attach local folders" }) {
+function WorkspaceMountManager({ mounts, adding = false, busyMountId = null, error, onAdd, onReconnect, onRemove, trigger }) {
 	const busy = adding || busyMountId !== null;
-	return /* @__PURE__ */ jsxs(Popover.Root, { children: [/* @__PURE__ */ jsx(AppTopBar.Button, {
-		label: triggerLabel,
-		render: /* @__PURE__ */ jsx(Popover.Trigger, { unstyled: true }),
-		children: /* @__PURE__ */ jsx(PaperclipIcon, {})
+	return /* @__PURE__ */ jsxs(Popover.Root, { children: [/* @__PURE__ */ jsx(Popover.Trigger, {
+		render: trigger,
+		unstyled: true
 	}), /* @__PURE__ */ jsx(Popover.Portal, { children: /* @__PURE__ */ jsx(Popover.Positioner, {
 		side: "bottom",
 		align: "end",

package/dist/components/agents-sdk/WorkspaceNavigationRestoration.d.ts

@@ -0,0 +1,38 @@
+import { n as WorkspaceDestination } from "../../WorkspaceLink-Bh9-Jo1r.js";
+import * as React from "react";
+
+//#region src/components/agents-sdk/WorkspaceNavigationRestoration.d.ts
+interface WorkspaceNavigationRestoration {
+  focusDestination?: WorkspaceDestination;
+  focusScope?: string;
+  scrollTop?: number;
+}
+interface WorkspaceNavigationRestorationContextValue {
+  get(entryKey: string): WorkspaceNavigationRestoration | undefined;
+  recordFocus(entryKey: string, destination: WorkspaceDestination, scope?: string): void;
+  recordScroll(entryKey: string, scrollTop: number): void;
+}
+/**
+ * Owns entry-keyed presentation state unless an ancestor already provides it.
+ * This lets a full application share restoration between chat and files while
+ * keeping a standalone WorkspaceExplorer self-contained.
+ */
+declare function WorkspaceNavigationRestorationBoundary({
+  children
+}: {
+  children: React.ReactNode;
+}): string | number | bigint | boolean | React.JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+/** Restores a link in a named surface, including when that surface renders asynchronously. */
+declare function WorkspaceNavigationFocusRestorer({
+  entryKey,
+  rootRef,
+  scope
+}: {
+  entryKey: string;
+  rootRef: React.RefObject<HTMLElement | null>;
+  scope: string;
+}): null;
+declare function useWorkspaceNavigationRestoration(): WorkspaceNavigationRestorationContextValue | null;
+declare function useRequiredWorkspaceNavigationRestoration(): WorkspaceNavigationRestorationContextValue;
+//#endregion
+export { WorkspaceNavigationFocusRestorer, WorkspaceNavigationRestoration, WorkspaceNavigationRestorationBoundary, WorkspaceNavigationRestorationContextValue, useRequiredWorkspaceNavigationRestoration, useWorkspaceNavigationRestoration };

package/dist/components/agents-sdk/WorkspaceNavigationRestoration.js

@@ -0,0 +1,86 @@
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/agents-sdk/WorkspaceNavigationRestoration.tsx
+const WorkspaceNavigationRestorationContext = React.createContext(null);
+/**
+* Owns entry-keyed presentation state unless an ancestor already provides it.
+* This lets a full application share restoration between chat and files while
+* keeping a standalone WorkspaceExplorer self-contained.
+*/
+function WorkspaceNavigationRestorationBoundary({ children }) {
+	const parent = React.use(WorkspaceNavigationRestorationContext);
+	const restorationsRef = React.useRef(/* @__PURE__ */ new Map());
+	const localValue = React.useMemo(() => ({
+		get: (entryKey) => restorationsRef.current.get(entryKey),
+		recordFocus: (entryKey, destination, scope) => {
+			const current = restorationsRef.current.get(entryKey);
+			restorationsRef.current.set(entryKey, {
+				...current,
+				focusDestination: destination,
+				focusScope: scope
+			});
+		},
+		recordScroll: (entryKey, scrollTop) => {
+			const current = restorationsRef.current.get(entryKey);
+			restorationsRef.current.set(entryKey, {
+				...current,
+				scrollTop
+			});
+		}
+	}), []);
+	if (parent) return children;
+	return /* @__PURE__ */ jsx(WorkspaceNavigationRestorationContext, {
+		value: localValue,
+		children
+	});
+}
+function findDestinationLink(root, destination) {
+	if (destination.kind !== "file") return null;
+	return [...root.querySelectorAll("[data-workspace-link=\"file\"]")].find((candidate) => candidate.dataset.workspacePath === destination.path && (candidate.dataset.workspaceDestinationFragment || null) === destination.fragment) ?? null;
+}
+/** Restores a link in a named surface, including when that surface renders asynchronously. */
+function WorkspaceNavigationFocusRestorer({ entryKey, rootRef, scope }) {
+	const restoration = useWorkspaceNavigationRestoration();
+	const handledEntryRef = React.useRef(null);
+	React.useEffect(() => {
+		if (handledEntryRef.current === entryKey) return;
+		const saved = restoration?.get(entryKey);
+		if (!saved?.focusDestination || saved.focusScope !== scope) return;
+		const focusDestination = saved.focusDestination;
+		const root = rootRef.current;
+		if (!root) return;
+		const restore = () => {
+			const surface = [...root.matches("[data-workspace-restoration-scope]") ? [root] : [], ...root.querySelectorAll("[data-workspace-restoration-scope]")].find((candidate) => candidate.dataset.workspaceRestorationScope === scope);
+			const target = surface ? findDestinationLink(surface, focusDestination) : null;
+			if (!target) return false;
+			target.focus({ preventScroll: true });
+			handledEntryRef.current = entryKey;
+			return true;
+		};
+		if (restore()) return;
+		const observer = new MutationObserver(() => {
+			if (restore()) observer.disconnect();
+		});
+		observer.observe(root, {
+			childList: true,
+			subtree: true
+		});
+		return () => observer.disconnect();
+	}, [
+		entryKey,
+		restoration,
+		rootRef,
+		scope
+	]);
+	return null;
+}
+function useWorkspaceNavigationRestoration() {
+	return React.use(WorkspaceNavigationRestorationContext);
+}
+function useRequiredWorkspaceNavigationRestoration() {
+	const restoration = useWorkspaceNavigationRestoration();
+	if (!restoration) throw new Error("Workspace navigation restoration is unavailable outside its boundary.");
+	return restoration;
+}
+//#endregion
+export { WorkspaceNavigationFocusRestorer, WorkspaceNavigationRestorationBoundary, useRequiredWorkspaceNavigationRestoration, useWorkspaceNavigationRestoration };

package/dist/components/agents-sdk/WorkspaceProject.d.ts

@@ -1,4 +1,3 @@
-import { ThinkFullAppPanel } from "./ThinkFullApp.js";
 import { WorkspaceConceptQueryOptions } from "./WorkspaceConcept.js";
 import { CardProps } from "../foundations/Card.js";
 import * as React from "react";
@@ -82,11 +81,8 @@ interface WorkspaceProjectFileCardProps extends Omit<WorkspaceProjectCardProps,
   fallback?: React.ReactNode;
 }
 interface WorkspaceProjectsPanelProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
-  projects: readonly WorkspaceProjectView[];
-  loading?: boolean;
-  /** Query failure to show instead of the empty state. Loaded projects win. */
-  error?: string;
-  onRetry?: () => void;
+  /** Shared workspace query and host actions, also used by inline project cards. */
+  source: WorkspaceProjectSource;
 }
 declare function WorkspaceProjectCard({
   className,
@@ -116,16 +112,11 @@ declare function useWorkspaceProjects(source: WorkspaceProjectSource): readonly
  */
 declare function WorkspaceProjectsPanel({
   className,
-  error,
-  loading,
-  projects,
-  onRetry,
+  source,
   ref,
   ...props
 }: WorkspaceProjectsPanelProps & {
-  ref?: React.Ref<HTMLElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-declare function workspaceProjectsPanel(source: WorkspaceProjectSource): ThinkFullAppPanel;
 //#endregion
-export { WorkspaceProject, WorkspaceProjectCard, WorkspaceProjectCardProps, WorkspaceProjectFile, WorkspaceProjectFileCard, WorkspaceProjectFileCardProps, WorkspaceProjectFileView, WorkspaceProjectSection, WorkspaceProjectSectionItem, WorkspaceProjectSectionItemView, WorkspaceProjectSectionView, WorkspaceProjectSource, WorkspaceProjectThread, WorkspaceProjectThreadOrigin, WorkspaceProjectThreadView, WorkspaceProjectView, WorkspaceProjectsPanel, WorkspaceProjectsPanelProps, useWorkspaceProjects, workspaceProjectsPanel };
+export { WorkspaceProject, WorkspaceProjectCard, WorkspaceProjectCardProps, WorkspaceProjectFile, WorkspaceProjectFileCard, WorkspaceProjectFileCardProps, WorkspaceProjectFileView, WorkspaceProjectSection, WorkspaceProjectSectionItem, WorkspaceProjectSectionItemView, WorkspaceProjectSectionView, WorkspaceProjectSource, WorkspaceProjectThread, WorkspaceProjectThreadOrigin, WorkspaceProjectThreadView, WorkspaceProjectView, WorkspaceProjectsPanel, WorkspaceProjectsPanelProps, useWorkspaceProjects };

package/dist/components/agents-sdk/WorkspaceProject.js

@@ -1,13 +1,13 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { $ as UserIcon, C as FolderIcon, D as LinkIcon, K as SpinnerIcon, S as FileIcon, j as MessageSquareIcon, u as CalendarIcon } from "../../icons-CeGfXO21.js";
+import { $ as UserIcon, C as FolderIcon, D as LinkIcon, K as SpinnerIcon, S as FileIcon, j as MessageSquareIcon, u as CalendarIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
 import { IconButton } from "../foundations/IconButton.js";
 import { a as formatErrorMessage } from "../../format-COCyV98Z.js";
-import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
-import { DescriptionList } from "../foundations/DescriptionList.js";
 import { EmptyState } from "../foundations/EmptyState.js";
 import { LinkButton } from "../foundations/LinkButton.js";
-import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-GqsCYxqT.js";
+import { DescriptionList } from "../foundations/DescriptionList.js";
+import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
+import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useQuery } from "@tanstack/react-query";
@@ -119,7 +119,10 @@ function WorkspaceProjectCard({ className, project, ref, ...props }) {
 			/* @__PURE__ */ jsxs(CardTitle, {
 				id: titleId,
 				className: "connected-app-card__title",
-				render: /* @__PURE__ */ jsx("h3", {}),
+				render: (props) => /* @__PURE__ */ jsx("h3", {
+					...props,
+					children: props.children
+				}),
 				children: [/* @__PURE__ */ jsx("span", {
 					className: "connected-app-card__icon",
 					"aria-hidden": "true",
@@ -152,7 +155,7 @@ function WorkspaceProjectFileCard({ fallback = null, path, source, ...props }) {
 	return project ? /* @__PURE__ */ jsx(WorkspaceProjectCard, {
 		...props,
 		project: projectWithSource(project, source)
-	}) : fallback;
+	}, JSON.stringify(source.queryOptions.queryKey)) : fallback;
 }
 /** Design-system-owned project query shared by panels, cards, and composer context. */
 function useWorkspaceProjects(source) {
@@ -163,7 +166,9 @@ function useWorkspaceProjects(source) {
 * query failure with nothing loaded renders as a quiet inline error, never as
 * an empty library.
 */
-function WorkspaceProjectsPanel({ className, error, loading = false, projects, onRetry, ref, ...props }) {
+function WorkspaceProjectsPanel({ className, source, ref, ...props }) {
+	const query = useQuery(source.queryOptions);
+	const projects = query.data ?? [];
 	return /* @__PURE__ */ jsx("section", {
 		ref,
 		"data-slot": "workspace-projects-panel",
@@ -172,26 +177,26 @@ function WorkspaceProjectsPanel({ className, error, loading = false, projects, o
 		"aria-label": props["aria-label"] ?? "Projects",
 		children: projects.length > 0 ? /* @__PURE__ */ jsx("ul", {
 			className: "sigvelo-stack-list sigvelo-stack",
-			children: projects.map((project) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceProjectCard, { project }) }, project.path))
-		}) : error !== void 0 ? /* @__PURE__ */ jsx(EmptyState, {
+			children: projects.map((project) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(WorkspaceProjectCard, { project: projectWithSource(project, source) }) }, project.path))
+		}) : query.error ? /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(FolderIcon, {}),
 			title: "Projects unavailable",
-			description: error,
-			children: onRetry ? /* @__PURE__ */ jsx(Button, {
+			description: formatErrorMessage(query.error),
+			children: /* @__PURE__ */ jsx(Button, {
 				size: "sm",
 				variant: "outline",
 				color: "neutral",
-				onClick: onRetry,
+				onClick: () => void query.refetch(),
 				children: "Retry"
-			}) : null
-		}) : loading ? /* @__PURE__ */ jsx(EmptyState, {
+			})
+		}) : query.isPending ? /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(SpinnerIcon, {}),
 			title: "Loading projects"
 		}) : /* @__PURE__ */ jsx(EmptyState, {
 			icon: /* @__PURE__ */ jsx(FolderIcon, {}),
 			title: "No projects"
 		})
-	});
+	}, JSON.stringify(source.queryOptions.queryKey));
 }
 function projectWithSource(project, source) {
 	return {
@@ -215,24 +220,5 @@ function projectWithSource(project, source) {
 		onDelete: source.onDelete ? () => source.onDelete?.(project.path) : void 0
 	};
 }
-function WorkspaceProjectSourcePanel({ source }) {
-	const query = useQuery(source.queryOptions);
-	return /* @__PURE__ */ jsx(WorkspaceProjectsPanel, {
-		projects: (query.data ?? []).map((project) => projectWithSource(project, source)),
-		error: query.isError ? formatErrorMessage(query.error) : void 0,
-		loading: query.isPending,
-		onRetry: query.isError ? () => void query.refetch() : void 0,
-		"aria-busy": query.isFetching || void 0
-	});
-}
-/** Canonical workbench descriptor; hosts supply only the source adapter. */
-function workspaceProjectsPanel(source) {
-	return {
-		id: "projects",
-		label: "Projects",
-		icon: /* @__PURE__ */ jsx(FolderIcon, {}),
-		render: () => /* @__PURE__ */ jsx(WorkspaceProjectSourcePanel, { source })
-	};
-}
 //#endregion
-export { WorkspaceProjectCard, WorkspaceProjectFileCard, WorkspaceProjectsPanel, useWorkspaceProjects, workspaceProjectsPanel };
+export { WorkspaceProjectCard, WorkspaceProjectFileCard, WorkspaceProjectsPanel, useWorkspaceProjects };

package/dist/components/agents-sdk/WorkspaceUserScript.d.ts

@@ -41,7 +41,7 @@ declare function WorkspaceUserScriptsPanel({
   scripts,
   ...props
 }: WorkspaceUserScriptsPanelProps & {
-  ref?: React.Ref<HTMLElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLElement>;
 }): React.JSX.Element;
 //#endregion
 export { WorkspaceUserScript, WorkspaceUserScriptCard, WorkspaceUserScriptCardProps, WorkspaceUserScriptsPanel, WorkspaceUserScriptsPanelProps };

package/dist/components/agents-sdk/WorkspaceUserScript.js

@@ -1,11 +1,11 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { P as MonitorIcon, S as FileIcon, m as CodeIcon } from "../../icons-CeGfXO21.js";
+import { P as MonitorIcon, S as FileIcon, m as CodeIcon } from "../../icons-cuEtsgj9.js";
 import { IconButton } from "../foundations/IconButton.js";
-import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
-import { DescriptionList } from "../foundations/DescriptionList.js";
 import { EmptyState } from "../foundations/EmptyState.js";
+import { DescriptionList } from "../foundations/DescriptionList.js";
 import { Switch } from "../foundations/Switch.js";
-import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-GqsCYxqT.js";
+import { Card, CardAction, CardContent, CardDescription, CardHeader, CardTitle } from "../foundations/Card.js";
+import { i as WorkspaceDeleteControl, n as WorkspaceComposerLink, t as FaviconMark } from "../../workspace-assets-Bg7XhPsk.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/agents-sdk/WorkspaceUserScript.tsx
@@ -93,7 +93,10 @@ function WorkspaceUserScriptCard({ className, script, ref, ...props }) {
 			/* @__PURE__ */ jsxs(CardTitle, {
 				id: titleId,
 				className: "connected-app-card__title",
-				render: /* @__PURE__ */ jsx("h3", {}),
+				render: (props) => /* @__PURE__ */ jsx("h3", {
+					...props,
+					children: props.children
+				}),
 				children: [/* @__PURE__ */ jsx("span", {
 					className: "connected-app-card__icon",
 					"aria-hidden": "true",

package/dist/components/ai-sdk/Activity.d.ts

@@ -43,7 +43,7 @@ declare function Activity({
   ref,
   ...props
 }: ActivityProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 interface ActivityTriggerProps extends Omit<React.ComponentProps<typeof Collapsible.Trigger>, "unstyled" | "children"> {
   /** The action being taken. Defaults to "Working…". */

package/dist/components/ai-sdk/Activity.js

@@ -1,7 +1,7 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
+import { p as ChevronRightIcon } from "../../icons-cuEtsgj9.js";
 import { Collapsible } from "../foundations/Collapsible.js";
 import { useExpansionState } from "./ExpansionState.js";
-import { p as ChevronRightIcon } from "../../icons-CeGfXO21.js";
 import * as React from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/ai-sdk/Activity.tsx

package/dist/components/ai-sdk/AgentAttention.d.ts

@@ -1,4 +1,4 @@
-import { r as ButtonProps } from "../../Button-CZt3yywF.js";
+import { r as ButtonProps } from "../../Button-DjONW5UW.js";
 import * as React from "react";
 
 //#region src/components/ai-sdk/AgentAttention.d.ts
@@ -17,7 +17,7 @@ declare function AgentAttention({
   ref,
   ...props
 }: AgentAttentionProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 interface AgentAttentionHeadingProps {
   /** Leading visual. Decorative by default; put meaning in the title. */

package/dist/components/ai-sdk/AgentChatStartScreen.d.ts

@@ -1,2 +1,89 @@
-import { a as AgentChatStarterList, i as AgentChatStarterItem, n as AgentChatStartScreenProps, o as AgentChatStarterListProps, r as AgentChatStarter, s as AgentChatStarterProps, t as AgentChatStartScreen } from "../../AgentChatStartScreen-Bkv7Avni.js";
-export { AgentChatStartScreen, AgentChatStartScreenProps, AgentChatStarter, AgentChatStarterItem, AgentChatStarterList, AgentChatStarterListProps, AgentChatStarterProps };
+import { r as ButtonProps } from "../../Button-DjONW5UW.js";
+import { vt as PromptInputTray } from "../../PromptInput-C4Mofitz.js";
+import * as React from "react";
+import { useRender } from "@base-ui/react/use-render";
+
+//#region src/components/ai-sdk/AgentChatStartScreen.d.ts
+interface AgentChatStarterItem {
+  id: string;
+  label: React.ReactNode;
+  icon?: React.ReactNode;
+  muted?: boolean;
+  disabled?: boolean;
+  /** Accessible label for this suggestion's optional dismiss action. */
+  dismissLabel?: string;
+}
+interface AgentChatStarterListProps extends Omit<React.ComponentPropsWithoutRef<"ul">, "children" | "onDismiss" | "onSelect"> {
+  /** Complete starter data from a host-owned suggestion query. */
+  items: readonly AgentChatStarterItem[];
+  onSelect: (item: AgentChatStarterItem) => void;
+  /** Enables dismiss actions for items that provide `dismissLabel`. */
+  onDismiss?: (item: AgentChatStarterItem) => void;
+}
+interface AgentChatStartScreenProps extends useRender.ComponentProps<"section"> {}
+/** First-turn layout beneath the same draft provider as the live composer. */
+declare function AgentChatStartScreen({
+  render,
+  ref,
+  children,
+  ...props
+}: AgentChatStartScreenProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+interface AgentChatStartScreenPrimaryProps extends useRender.ComponentProps<"div"> {
+  heading?: React.ReactNode;
+}
+/** Heading and live-composer group; suggestions are a separate sibling below it. */
+declare function AgentChatStartScreenPrimary({
+  heading,
+  render,
+  ref,
+  children,
+  ...props
+}: AgentChatStartScreenPrimaryProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Stacking boundary for a caller-owned form and its docked utility tray. */
+declare function AgentChatStartScreenComposer({
+  render,
+  ref,
+  ...props
+}: useRender.ComponentProps<"div">): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Utility actions share PromptInputTray's native props and ref. */
+declare function AgentChatStartScreenTray({
+  className,
+  ...props
+}: Omit<React.ComponentProps<typeof PromptInputTray>, "side">): React.JSX.Element;
+/** Starter prompts or an app-authored guide; remains in layout while the draft is active. */
+declare function AgentChatStartScreenSuggestions({
+  render,
+  ref,
+  ...props
+}: useRender.ComponentProps<"div">): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+/** Semantic list for first-turn prompts below an `AgentChatStartScreen`. */
+declare function AgentChatStarterList({
+  items,
+  onSelect,
+  onDismiss,
+  className,
+  ...props
+}: AgentChatStarterListProps): React.JSX.Element;
+interface AgentChatStarterProps extends Omit<ButtonProps, "color" | "iconOnly" | "size" | "variant"> {
+  /** Decorative icon shown before the prompt label. */
+  icon?: React.ReactNode;
+  /** Render the prompt with quieter onboarding emphasis. */
+  muted?: boolean;
+  /** Optional independent action for removing a suggested prompt. */
+  onDismiss?: React.MouseEventHandler<HTMLButtonElement>;
+  /** Accessible name for the dismiss action. */
+  dismissLabel?: string;
+}
+/** One full-width, keyboard-native starter prompt. */
+declare function AgentChatStarter({
+  icon,
+  muted,
+  onDismiss,
+  dismissLabel,
+  children,
+  className,
+  type,
+  ...props
+}: AgentChatStarterProps): React.JSX.Element;
+//#endregion
+export { AgentChatStartScreen, AgentChatStartScreenComposer, AgentChatStartScreenPrimary, AgentChatStartScreenPrimaryProps, AgentChatStartScreenProps, AgentChatStartScreenSuggestions, AgentChatStartScreenTray, AgentChatStarter, AgentChatStarterItem, AgentChatStarterList, AgentChatStarterListProps, AgentChatStarterProps };

package/dist/components/ai-sdk/AgentChatStartScreen.js

@@ -1,50 +1,71 @@
 import { t as cx } from "../../class-names-BiMDVpUo.js";
-import { nt as XIcon } from "../../icons-CeGfXO21.js";
+import { nt as XIcon } from "../../icons-cuEtsgj9.js";
 import { Button } from "../foundations/Button.js";
 import { IconButton } from "../foundations/IconButton.js";
-import { PromptInputTray } from "./PromptInput.js";
-import * as React from "react";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { PromptInputTray, usePromptInputController } from "./PromptInput.js";
+import "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useRender } from "@base-ui/react/use-render";
+import { mergeProps } from "@base-ui/react/merge-props";
 //#region src/components/ai-sdk/AgentChatStartScreen.tsx
-/**
-* Welcoming first-turn layout for `AgentChat` and `ThinkChat`.
-*
-* `AgentChat` normally creates this component through its `startScreen` prop so
-* the same live composer moves from the center of the empty view to the pinned
-* transcript position after the first message.
-*/
-function AgentChatStartScreen({ heading = "What should we work on?", composer, composerTray, lead, starters, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...props }) {
-	const headingId = React.useId();
-	return /* @__PURE__ */ jsx("section", {
-		"data-slot": "agent-chat-start-screen",
-		className: cx("agent-chat-start-screen", className),
-		"aria-label": ariaLabel,
-		"aria-labelledby": ariaLabel ? void 0 : ariaLabelledBy ?? (heading ? headingId : void 0),
+/** First-turn layout beneath the same draft provider as the live composer. */
+function AgentChatStartScreen({ render, ref, children, ...props }) {
+	const { textInput, attachments } = usePromptInputController();
+	return useRender({
+		defaultTagName: "section",
+		render,
+		ref,
+		props: mergeProps({
+			"data-slot": "agent-chat-start-screen",
+			"data-drafting": textInput.value.length > 0 || attachments.files.length > 0 ? "" : void 0,
+			className: "agent-chat-start-screen",
+			"aria-label": props["aria-labelledby"] ? void 0 : "New conversation",
+			children: /* @__PURE__ */ jsx("div", {
+				className: "agent-chat-start-screen__content",
+				children
+			})
+		}, props)
+	});
+}
+/** Heading and live-composer group; suggestions are a separate sibling below it. */
+function AgentChatStartScreenPrimary({ heading = "What should we work on?", render, ref, children, ...props }) {
+	return useRender({
+		defaultTagName: "div",
+		render,
+		ref,
+		props: mergeProps({
+			className: "agent-chat-start-screen__primary",
+			children: /* @__PURE__ */ jsxs(Fragment, { children: [heading ? /* @__PURE__ */ jsx("h2", {
+				className: "agent-chat-start-screen__heading",
+				children: heading
+			}) : null, children] })
+		}, props)
+	});
+}
+/** Stacking boundary for a caller-owned form and its docked utility tray. */
+function AgentChatStartScreenComposer({ render, ref, ...props }) {
+	return useRender({
+		defaultTagName: "div",
+		render,
+		ref,
+		props: mergeProps({ className: "agent-chat-start-screen__composer" }, props)
+	});
+}
+/** Utility actions share PromptInputTray's native props and ref. */
+function AgentChatStartScreenTray({ className, ...props }) {
+	return /* @__PURE__ */ jsx(PromptInputTray, {
 		...props,
-		children: /* @__PURE__ */ jsxs("div", {
-			className: "agent-chat-start-screen__content",
-			children: [/* @__PURE__ */ jsxs("div", {
-				className: "agent-chat-start-screen__primary",
-				children: [heading ? /* @__PURE__ */ jsx("h2", {
-					id: headingId,
-					className: "agent-chat-start-screen__heading",
-					children: heading
-				}) : null, /* @__PURE__ */ jsxs("div", {
-					className: "agent-chat-start-screen__composer",
-					children: [composer, composerTray ? /* @__PURE__ */ jsx(PromptInputTray, {
-						side: "bottom",
-						className: "agent-chat-start-screen__composer-tray",
-						children: composerTray
-					}) : null]
-				})]
-			}), lead ? /* @__PURE__ */ jsx("div", {
-				className: "agent-chat-start-screen__lead",
-				children: lead
-			}) : starters?.items.length ? /* @__PURE__ */ jsx("div", {
-				className: "agent-chat-start-screen__starters",
-				children: /* @__PURE__ */ jsx(AgentChatStarterList, { ...starters })
-			}) : null]
-		})
+		side: "bottom",
+		className: cx("agent-chat-start-screen__composer-tray", className)
+	});
+}
+/** Starter prompts or an app-authored guide; remains in layout while the draft is active. */
+function AgentChatStartScreenSuggestions({ render, ref, ...props }) {
+	return useRender({
+		defaultTagName: "div",
+		render,
+		ref,
+		props: mergeProps({ className: "agent-chat-start-screen__suggestions" }, props)
 	});
 }
 /** Semantic list for first-turn prompts below an `AgentChatStartScreen`. */
@@ -99,4 +120,4 @@ function AgentChatStarter({ icon, muted = false, onDismiss, dismissLabel, childr
 	});
 }
 //#endregion
-export { AgentChatStartScreen, AgentChatStarter, AgentChatStarterList };
+export { AgentChatStartScreen, AgentChatStartScreenComposer, AgentChatStartScreenPrimary, AgentChatStartScreenSuggestions, AgentChatStartScreenTray, AgentChatStarter, AgentChatStarterList };

package/dist/components/ai-sdk/AgentMessageParts.d.ts

@@ -1,2 +1,46 @@
-import { i as AgentMessageRenderPartContext, n as AgentMessageParts, r as AgentMessagePartsProps, t as AgentMessagePart } from "../../AgentMessageParts-C7L-Mv9U.js";
+import * as React from "react";
+import { ChatStatus, UIMessage } from "ai";
+
+//#region src/components/ai-sdk/AgentMessageParts.d.ts
+type AgentMessagePart<MessageT extends UIMessage = UIMessage> = MessageT["parts"][number];
+interface AgentMessageRenderPartContext<MessageT extends UIMessage = UIMessage> {
+  message: MessageT;
+  part: AgentMessagePart<MessageT>;
+  partIndex: number;
+  defaultRender: () => React.ReactNode;
+}
+interface AgentMessagePartsProps<MessageT extends UIMessage = UIMessage> {
+  /** The whole upstream AI SDK message whose parts should render in order. */
+  message: MessageT;
+  /** Drives native reasoning streaming UI. Settled messages default to `ready`. */
+  status?: ChatStatus;
+  /**
+   * Override rendering per part. Return `undefined` to use the default renderer,
+   * `null` to suppress the part, or call `defaultRender()` to compose the
+   * built-in result into custom UI.
+   *
+   * The default renderer uses upstream helpers where available:
+   * `isTextUIPart`, `isReasoningUIPart`, `isFileUIPart`, `isToolUIPart`,
+   * `getToolName`, and the native AI SDK tool-part state fields. It
+   * also renders native AI SDK `source-url`/`source-document` parts as a single
+   * grouped `Sources` block when they appear consecutively, consolidates native
+   * reasoning parts into one disclosure, and treats `step-start` as a silent
+   * structural boundary. App-defined `data-*` parts stay whole and should be
+   * narrowed with AI SDK's `isDataUIPart` inside this callback. If you override
+   * source rendering, return a React node for every source part you want to
+   * show; returning `undefined` keeps the upstream-shaped source-run grouping.
+   */
+  renderPart?: (context: AgentMessageRenderPartContext<MessageT>) => React.ReactNode | undefined;
+}
+/**
+ * Renders the ordered parts of one whole AI SDK `UIMessage` without adding a
+ * transcript, message wrapper, composer, or transport. Compose it inside
+ * `Message` for read-only run previews and child-agent transcript rows.
+ */
+declare function AgentMessageParts<MessageT extends UIMessage = UIMessage>({
+  message,
+  status,
+  renderPart
+}: AgentMessagePartsProps<MessageT>): (React.JSX.Element | null)[];
+//#endregion
 export { AgentMessagePart, AgentMessageParts, AgentMessagePartsProps, AgentMessageRenderPartContext };

package/dist/components/ai-sdk/Approval.d.ts

@@ -11,7 +11,7 @@ declare function Approval({
   ref,
   ...props
 }: ApprovalProps & {
-  ref?: React.Ref<HTMLDivElement>;
+  /** Ref forwarded to the component's rendered root element. */ref?: React.Ref<HTMLDivElement>;
 }): React.JSX.Element;
 interface ApprovalHeaderProps extends React.HTMLAttributes<HTMLDivElement> {}
 /** Question and optional queue position for an approval request. */