@bysages/react 0.4.4 → 0.6.0

package/dist/ai-prompt-input-Cl9ulICF.mjs

@@ -0,0 +1,401 @@
+import { n as iconHtml, r as iconNode } from "./icon-C9udWCyz.mjs";
+import { t as useElementId } from "./id-Ctic_3o8.mjs";
+import { t as withSelfRoot } from "./family-Co1YsN4N.mjs";
+import { n as useComponentMessages } from "./messages-B6n0lVyt.mjs";
+import { Button } from "./components/button/index.mjs";
+import { Field } from "./components/field/index.mjs";
+import { n as MentionsVessel, r as useMentions } from "./mentions-B59tQDPt.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from "react";
+// src/components/ai-prompt-input/editor.ts
+const triggerList = (triggers) => {
+	return (triggers == null ? ["@"] : Array.isArray(triggers) ? triggers : [triggers]).filter((trigger) => trigger.length > 0);
+};
+const tokensFor = (value, entries, triggers) => {
+	const tokens = [];
+	const add = (pattern, entry, trigger) => {
+		if (!pattern || !value.includes(pattern)) return;
+		tokens.push({
+			pattern,
+			entry,
+			trigger
+		});
+	};
+	entries.forEach((entry) => {
+		triggers.forEach((trigger) => {
+			add(trigger + entry.label, entry, trigger);
+			const inserted = entry.insertText?.trim();
+			if (inserted?.startsWith(trigger)) add(inserted, entry, trigger);
+		});
+	});
+	return tokens.sort((left, right) => {
+		return value.indexOf(left.pattern) - value.indexOf(right.pattern) || right.pattern.length - left.pattern.length;
+	});
+};
+const readToken = (node) => ({
+	pattern: `${node.dataset.promptTrigger ?? "@"}${node.dataset.promptLabel ?? ""}`,
+	trigger: node.dataset.promptTrigger ?? "@",
+	entry: {
+		id: node.dataset.promptId,
+		label: node.dataset.promptLabel ?? "",
+		value: node.dataset.promptValue ?? "",
+		icon: node.dataset.promptIcon,
+		kind: node.dataset.promptKind
+	}
+});
+const readNode = (node) => {
+	if (node.nodeType === Node.TEXT_NODE) return node.textContent ?? "";
+	if (!(node instanceof HTMLElement)) return "";
+	if (node.tagName === "BR") return "\n";
+	if (node.dataset.promptToken === "") return readToken(node).pattern;
+	const block = node.tagName === "DIV" || node.tagName === "P";
+	const children = Array.from(node.childNodes).map(readNode).join("");
+	return block && children ? `${children}\n` : children;
+};
+const serializeEditor = (root) => Array.from(root.childNodes).map(readNode).join("").replace(/\n$/, "");
+const readCaret = (root) => {
+	const selection = window.getSelection();
+	if (document.activeElement !== root || !selection || selection.rangeCount === 0) return serializeEditor(root).length;
+	const selected = selection.getRangeAt(selection.rangeCount - 1);
+	const range = document.createRange();
+	range.selectNodeContents(root);
+	range.setEnd(selected.endContainer, selected.endOffset);
+	return range.toString().length;
+};
+const caretPosition = (root, offset) => {
+	const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT);
+	let remaining = offset;
+	let node = walker.nextNode();
+	let last = null;
+	while (node) {
+		const text = node;
+		if (remaining <= text.data.length) return {
+			container: text,
+			offset: remaining
+		};
+		remaining -= text.data.length;
+		last = text;
+		node = walker.nextNode();
+	}
+	return last ? {
+		container: last,
+		offset: last.data.length
+	} : {
+		container: root,
+		offset: root.childNodes.length
+	};
+};
+const tokenNode = (model) => {
+	const node = document.createElement("span");
+	node.contentEditable = "false";
+	node.dataset.promptToken = "";
+	node.setAttribute("data-scope", "ai");
+	node.setAttribute("data-part", "prompt-mention");
+	node.dataset.promptTrigger = model.trigger;
+	node.dataset.promptLabel = model.entry.label;
+	node.dataset.promptValue = model.entry.value;
+	if (model.entry.kind != null) node.dataset.promptKind = model.entry.kind;
+	if (model.entry.id) node.dataset.promptId = model.entry.id;
+	if (model.entry.icon) node.dataset.promptIcon = model.entry.icon;
+	node.title = `${model.trigger}${model.entry.label}`;
+	const trigger = document.createElement("span");
+	trigger.textContent = model.trigger;
+	trigger.setAttribute("data-scope", "ai");
+	trigger.setAttribute("data-part", "mention-trigger");
+	node.append(trigger);
+	if (model.entry.icon) {
+		const icon = document.createElement("span");
+		icon.setAttribute("data-scope", "ai");
+		icon.setAttribute("data-part", "mention-icon");
+		icon.innerHTML = iconHtml(model.entry.icon, {
+			"data-scope": "icon",
+			"data-part": "root",
+			"data-size": "inherit"
+		});
+		node.append(icon);
+	}
+	const label = document.createElement("span");
+	label.textContent = model.entry.label;
+	label.setAttribute("data-scope", "ai");
+	label.setAttribute("data-part", "mention-label");
+	node.append(label);
+	return node;
+};
+const renderEditor = (root, value, entries, triggers) => {
+	const fragment = document.createDocumentFragment();
+	let cursor = 0;
+	tokensFor(value, entries, triggerList(triggers)).forEach((model) => {
+		const start = value.indexOf(model.pattern, cursor);
+		if (start === -1) return;
+		if (start > cursor) fragment.append(value.slice(cursor, start));
+		fragment.append(tokenNode(model));
+		cursor = start + model.pattern.length;
+	});
+	if (cursor < value.length) fragment.append(value.slice(cursor));
+	root.replaceChildren(fragment);
+	root.toggleAttribute("data-empty", root.childNodes.length === 0);
+};
+/** Insert a mention as a rich token. The hidden trigger text keeps the
+* browser selection and the serialized plain text in step. */
+const insertEditorToken = (root, entry, trigger, start, end) => {
+	const hasTailSpace = /^\s/.test(serializeEditor(root).slice(end));
+	const range = document.createRange();
+	const from = caretPosition(root, start);
+	const to = caretPosition(root, end);
+	range.setStart(from.container, from.offset);
+	range.setEnd(to.container, to.offset);
+	range.deleteContents();
+	const node = tokenNode({
+		pattern: trigger + entry.label,
+		entry,
+		trigger
+	});
+	range.insertNode(node);
+	let tail = null;
+	if (!hasTailSpace) {
+		tail = document.createTextNode(" ");
+		node.after(tail);
+	}
+	root.focus();
+	const selection = window.getSelection();
+	const followingText = (() => {
+		let current = node.nextSibling;
+		while (current) {
+			if (current.nodeType === Node.TEXT_NODE) return current;
+			const text = document.createTreeWalker(current, NodeFilter.SHOW_TEXT).nextNode();
+			if (text) return text;
+			current = current.nextSibling;
+		}
+		return null;
+	})();
+	const target = tail ?? followingText;
+	if (selection && target) {
+		const caret = document.createRange();
+		if (tail) caret.selectNodeContents(tail);
+		else caret.setStart(target, 0);
+		caret.collapse(true);
+		selection.removeAllRanges();
+		selection.addRange(caret);
+	}
+	return serializeEditor(root);
+};
+const setEditorCaret = (root, offset) => {
+	const position = caretPosition(root, offset);
+	const selection = window.getSelection();
+	if (!selection) return;
+	const range = document.createRange();
+	range.setStart(position.container, position.offset);
+	range.collapse(true);
+	selection.removeAllRanges();
+	selection.addRange(range);
+};
+const insertLineBreak = (root) => {
+	document.execCommand("insertLineBreak");
+	return serializeEditor(root);
+};
+// src/components/ai-prompt-input/index.tsx
+const arrowUpIcon = iconNode("arrow-up", {
+	width: 14,
+	height: 14
+});
+const stopIcon = iconNode("square", {
+	width: 14,
+	height: 14
+});
+/** An empty slot leaves no part in the anatomy — the bare vessel keeps
+* its single-line posture. */
+function row(part, content) {
+	if (content == null || Array.isArray(content) && content.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		"data-scope": "ai",
+		"data-part": part,
+		children: content
+	});
+}
+function PromptInputImpl({ value, onValueChange, onSubmit, onStop, placeholder, "aria-label": ariaLabel, disabled = false, busy = false, mentions, onSelect, header, leading, trailing, footer, footerEnd, ...rest }) {
+	injectComponentStyle("ai");
+	const fieldRef = useRef(null);
+	const editorRef = useRef(null);
+	const hostId = useElementId("ai-prompt", rest);
+	const messages = useComponentMessages();
+	const placeholderText = placeholder ?? messages.ai.conversation;
+	const mentionsActive = mentions != null;
+	const mentionState = useMentions(() => ({
+		items: mentions?.items ?? [],
+		trigger: mentions?.trigger,
+		triggers: mentions?.triggers,
+		commitKeys: mentions?.commitKeys ?? [
+			"Enter",
+			" ",
+			"Tab"
+		]
+	}), () => fieldRef.current, {
+		getCaret: () => mentions ? readCaret(editorRef.current) : void 0,
+		getText: () => mentions ? serializeEditor(editorRef.current) : fieldRef.current?.value ?? value,
+		setText: (next) => onValueChange?.(next),
+		select: (entry) => {
+			onSelect?.(entry);
+			return mentions?.insertOnSelect !== false || mentions?.clearQueryOnSelect !== false;
+		},
+		commit: (entry) => insertChoice(entry)
+	});
+	useEffect(() => {
+		const editor = editorRef.current;
+		if (!editor) return;
+		renderEditor(editor, value, mentions?.items ?? [], mentions?.triggers);
+		editor.toggleAttribute("data-empty", !value);
+	});
+	const publishEditor = () => {
+		const editor = editorRef.current;
+		if (!editor) return;
+		const next = serializeEditor(editor);
+		editor.toggleAttribute("data-empty", !next);
+		onValueChange?.(next);
+	};
+	const insertChoice = (entry) => {
+		const editor = editorRef.current;
+		const clearQuery = mentions?.insertOnSelect === false && mentions?.clearQueryOnSelect !== false;
+		if (!editor || entry.disabled || mentions?.insertOnSelect === false && !clearQuery) {
+			mentionState.close();
+			return;
+		}
+		if (clearQuery) {
+			const text = serializeEditor(editor);
+			const next = text.slice(0, mentionState.anchorIndex.current) + text.slice(mentionState.caretIndex.current);
+			renderEditor(editor, next, mentions?.items ?? [], mentions?.triggers);
+			editor.toggleAttribute("data-empty", !next);
+			editor.focus();
+			setEditorCaret(editor, mentionState.anchorIndex.current);
+			onValueChange?.(next);
+			mentionState.close();
+			return;
+		}
+		onSelect?.(entry);
+		const next = insertEditorToken(editor, entry, mentionState.activeTrigger.current, mentionState.anchorIndex.current, mentionState.caretIndex.current);
+		editor.toggleAttribute("data-empty", !next);
+		onValueChange?.(next);
+		mentionState.close();
+	};
+	const submit = () => {
+		const text = value.trim();
+		if (!text || disabled || busy) return;
+		onSubmit?.(text);
+		onValueChange?.("");
+	};
+	const editorKeydown = (event) => {
+		if (event.nativeEvent.isComposing || event.keyCode === 229) return;
+		if (event.key === "Enter" && event.shiftKey) {
+			event.preventDefault();
+			const editor = editorRef.current;
+			if (!editor) return;
+			onValueChange?.(insertLineBreak(editor));
+			return;
+		}
+		if (mentionState.onKeydown(event)) return;
+		if (event.key === "Enter") {
+			event.preventDefault();
+			submit();
+		}
+	};
+	const seal = busy ? /* @__PURE__ */ jsx(Button, {
+		variant: "solid",
+		size: "sm",
+		square: true,
+		type: "button",
+		"aria-label": messages.ai.stop,
+		disabled,
+		onClick: () => onStop?.(),
+		children: stopIcon
+	}) : /* @__PURE__ */ jsx(Button, {
+		variant: "solid",
+		size: "sm",
+		square: true,
+		type: "submit",
+		"aria-label": messages.ai.send,
+		disabled: disabled || !value.trim(),
+		children: arrowUpIcon
+	});
+	const hasFooter = footer != null && (!Array.isArray(footer) || footer.length > 0);
+	return /* @__PURE__ */ jsxs("form", {
+		...rest,
+		"data-scope": "ai",
+		"data-part": "prompt",
+		onSubmit: (event) => {
+			event.preventDefault();
+			submit();
+		},
+		children: [
+			row("prompt-header", header),
+			/* @__PURE__ */ jsxs("div", {
+				"data-scope": "ai",
+				"data-part": "prompt-main",
+				children: [
+					row("prompt-leading", leading),
+					mentionsActive ? /* @__PURE__ */ jsx("div", {
+						ref: editorRef,
+						contentEditable: !disabled,
+						role: "combobox",
+						"aria-autocomplete": "list",
+						tabIndex: disabled ? void 0 : 0,
+						"aria-label": ariaLabel ?? messages.ai.conversation,
+						"aria-expanded": mentionState.open,
+						"aria-controls": mentionState.open ? `${hostId}:mentions:popup` : void 0,
+						"aria-disabled": disabled || void 0,
+						"data-scope": "ai",
+						"data-part": "prompt-editor",
+						"data-empty": value ? void 0 : "",
+						"data-placeholder": placeholderText,
+						"data-disabled": disabled || void 0,
+						onInput: () => {
+							publishEditor();
+							if (!disabled) mentionState.onInput();
+						},
+						onKeyDown: editorKeydown
+					}) : /* @__PURE__ */ jsx(Field.Root, { children: /* @__PURE__ */ jsx(Field.Textarea, {
+						ref: fieldRef,
+						autoresize: true,
+						rows: 1,
+						value,
+						placeholder: placeholderText,
+						"aria-label": ariaLabel ?? messages.ai.conversation,
+						disabled,
+						onChange: (event) => {
+							onValueChange?.(event.target.value);
+							mentionState.onInput();
+						},
+						onKeyDown: (event) => {
+							if (event.nativeEvent.isComposing || event.keyCode === 229) return;
+							if (mentionState.onKeydown(event)) return;
+							if (event.key === "Enter" && !event.shiftKey) {
+								event.preventDefault();
+								submit();
+							}
+						}
+					}) }),
+					mentionsActive ? /* @__PURE__ */ jsx(MentionsVessel, {
+						id: `${hostId}:mentions`,
+						open: mentionState.open,
+						matches: mentionState.matches,
+						active: mentionState.active,
+						anchor: editorRef.current,
+						placement: mentions?.placement ?? "top-start",
+						onInsert: insertChoice,
+						onActiveChange: mentionState.setActive,
+						onOpenChange: (open) => {
+							if (!open) mentionState.close();
+						}
+					}) : null,
+					row("prompt-trailing", hasFooter ? trailing : trailing ?? seal)
+				]
+			}),
+			hasFooter ? /* @__PURE__ */ jsxs("div", {
+				"data-scope": "ai",
+				"data-part": "prompt-footer",
+				children: [footer, row("prompt-end", footerEnd == null ? seal : /* @__PURE__ */ jsxs(Fragment, { children: [footerEnd, seal] }))]
+			}) : null
+		]
+	});
+}
+const PromptInput = withSelfRoot(PromptInputImpl);
+export { PromptInput as t };

package/dist/{ai-response-CjjjprMY.mjs → ai-response-DTxdL5rX.mjs}

@@ -1,11 +1,11 @@
-import { n as iconHtml } from "./icon-Cri0-7-x.mjs";
-import { t as withSelfRoot } from "./family-DE_GQeeM.mjs";
-import { n as useComponentMessages } from "./messages-1jJWtaYU.mjs";
+import { n as iconHtml } from "./icon-C9udWCyz.mjs";
+import { t as withSelfRoot } from "./family-Co1YsN4N.mjs";
+import { n as useComponentMessages } from "./messages-B6n0lVyt.mjs";
 import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx } from "react/jsx-runtime";
 import { useEffect, useRef } from "react";
-import { renderHtml } from "@tanstack/markdown/html";
-//#region src/components/ai-response/code-copy.ts
+import { renderMarkdown } from "@bysages/core/markdown";
+// src/components/ai-response/code-copy.ts
 /** The two curated icons a copy affordance needs: the stamp and its
 * confirmation. Inline SVG keeps the enhancement framework-agnostic —
 * it lives beside the renderer's generated code HTML. */
@@ -67,8 +67,7 @@ async function clickCodeCopy(event, copyLabel, copiedLabel) {
 		button.setAttribute("aria-label", copyLabel);
 	}, REVERT_MS);
 }
-//#endregion
-//#region src/components/ai-response/tables.ts
+// src/components/ai-response/tables.ts
 /** Wide tables ride a scrolling lane instead of bursting the column.
 * The lane is a plain div: the table-as-scroll-container form is what
 * ate the mouse wheel over plain tables. Idempotent, so it can run
@@ -106,10 +105,10 @@ function wrapResponseTables(root) {
 		watchLane(lane);
 	}
 }
-//#endregion
-//#region src/components/ai-response/index.tsx
+// src/components/ai-response/index.tsx
 function ResponseImpl({ content, highlighter, copyLabel, copiedLabel, ...rest }) {
 	injectComponentStyle("ai");
+	injectComponentStyle("markdown");
 	const messages = useComponentMessages();
 	const resolvedCopyLabel = copyLabel ?? messages.ai.copyCode;
 	const resolvedCopiedLabel = copiedLabel ?? messages.ai.copied;
@@ -132,9 +131,8 @@ function ResponseImpl({ content, highlighter, copyLabel, copiedLabel, ...rest })
 		"data-scope": "ai",
 		"data-part": "response",
 		onClick,
-		dangerouslySetInnerHTML: { __html: renderHtml(content, highlighter ? { highlighter } : void 0) }
+		dangerouslySetInnerHTML: { __html: renderMarkdown(content, highlighter ? { highlighter } : void 0) }
 	});
 }
 const Response = withSelfRoot(ResponseImpl);
-//#endregion
 export { Response as t };

package/dist/{chevron-BA7kV9m7.mjs → chevron-DnImlNip.mjs}

@@ -1,6 +1,5 @@
-import { r as iconNode } from "./icon-Cri0-7-x.mjs";
-//#region src/components/ai/chevron.tsx
+import { r as iconNode } from "./icon-C9udWCyz.mjs";
+// src/components/ai/chevron.tsx
 /** The folding chevron the shared indicator turns. */
 const chevron = iconNode("chevron-right");
-//#endregion
 export { chevron as t };

package/dist/components/accordion/index.d.mts

@@ -1,5 +1,4 @@
 import { Accordion as Accordion$1 } from "@ark-ui/react/accordion";
-//#region src/components/accordion/index.d.ts
 export type AccordionItem = {
   value: string;
   title: string;
@@ -22,4 +21,4 @@ declare namespace AccordionFacade {
 }
 type AccordionParts = typeof Accordion$1;
 export declare const Accordion: typeof AccordionFacade & AccordionParts;
-//#endregion
+export {};

package/dist/components/accordion/index.mjs

@@ -1,9 +1,9 @@
-import { r as iconNode } from "../../icon-Cri0-7-x.mjs";
-import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { r as iconNode } from "../../icon-C9udWCyz.mjs";
+import { t as useElementId } from "../../id-Ctic_3o8.mjs";
 import { Accordion as Accordion$1 } from "@ark-ui/react/accordion";
 import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx, jsxs } from "react/jsx-runtime";
-//#region src/components/accordion/index.tsx
+// src/components/accordion/index.tsx
 /** Ark's Accordion, dressed in the paper-and-ink system: a ruled sheet
 * folded by quiet rows, unfolding with a spring-chevoned dissolve. The
 * API is Ark's own — Root, Item, ItemTrigger, ItemContent, ItemIndicator. */
@@ -36,5 +36,4 @@ const Accordion = Object.assign(AccordionFacade, {
 	Root: AccordionRoot
 });
 injectComponentStyle("accordion");
-//#endregion
 export { Accordion };

package/dist/components/affix/index.d.mts

@@ -1,5 +1,4 @@
 import { HTMLAttributes } from "react";
-//#region src/components/affix/index.d.ts
 /**
  * A nail: the wrapped content travels with the page until it reaches its
  * offset, then stays put while the page moves on. The semantics are
@@ -20,4 +19,4 @@ declare function AffixImpl({ offsetTop, offsetBottom, ...rest }: AffixProps): im
 export declare const Affix: typeof AffixImpl & {
   Root: typeof AffixImpl;
 };
-//#endregion
+export {};

package/dist/components/affix/index.mjs

@@ -1,7 +1,7 @@
-import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
+import { t as withSelfRoot } from "../../family-Co1YsN4N.mjs";
 import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx } from "react/jsx-runtime";
-//#region src/components/affix/index.tsx
+// src/components/affix/index.tsx
 function AffixImpl({ offsetTop, offsetBottom, ...rest }) {
 	injectComponentStyle("affix");
 	return /* @__PURE__ */ jsx("div", {
@@ -16,5 +16,4 @@ function AffixImpl({ offsetTop, offsetBottom, ...rest }) {
 	});
 }
 const Affix = withSelfRoot(AffixImpl);
-//#endregion
 export { Affix };

package/dist/components/ai/index.d.mts

@@ -1,2 +1,107 @@
-import { a as FileUIPart, c as SourceUrlUIPart, d as ToolUIPart, f as UIMessage, i as DataUIPart, l as StepStartUIPart, n as AiActions, o as ReasoningUIPart, p as UIMessagePart, r as AiContent, s as SourceDocumentUIPart, t as Ai, u as TextUIPart } from "../../index-B4twHAQC.mjs";
-export { Ai, AiActions, AiContent, type DataUIPart, type FileUIPart, type ReasoningUIPart, type SourceDocumentUIPart, type SourceUrlUIPart, type StepStartUIPart, type TextUIPart, type ToolUIPart, type UIMessage, type UIMessagePart };
+import { ActionProps } from "../ai-action/index.mjs";
+import { r as ToolProps } from "../../index-lCsvE2Vl.mjs";
+import { C as toolPartDisplay, S as AiToolDisplay, _ as AiSdkSourceDocumentPart, a as AiMediaProps, b as AiSdkTextPart, c as AiPartsSlots, d as AiSdkFilePart, f as AiSdkMediaPart, g as AiSdkReasoningPart, h as AiSdkReasoningFilePart, i as AiMediaKind, l as AiSdkCustomPart, m as AiSdkMessagePart, n as MessageProps, o as AiParts, p as AiSdkMessage, r as AiMedia, s as AiPartsProps, u as AiSdkDataPart, v as AiSdkSourceUrlPart, x as AiSdkToolPart, y as AiSdkStepStartPart } from "../../index-CjO4Ggf0.mjs";
+import { PromptInputProps } from "../ai-prompt-input/index.mjs";
+import { ReasoningProps } from "../ai-reasoning/index.mjs";
+import { ResponseProps } from "../ai-response/index.mjs";
+import { SourceProps, SourcesProps } from "../ai-source/index.mjs";
+import { SuggestionProps } from "../ai-suggestion/index.mjs";
+import { HTMLAttributes } from "react";
+import { ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatState, ChatStatus, CreateUIMessage, CustomContentUIPart, DataUIPart, DynamicToolUIPart, FileUIPart, InferUITools, ProviderMetadata, ProviderReference, ReasoningFileUIPart, ReasoningUIPart, SourceDocumentUIPart, SourceUrlUIPart, StepStartUIPart, TextUIPart, ToolSet, ToolUIPart, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UITool, UIToolInvocation, UITools } from "ai";
+/** The log itself: the column every stroke lands in, a landmark to
+ * screen readers. While the reply streams, the log follows its growth —
+ * but only while the reader rests at the bottom edge. */
+export declare function AiConversation({ autoScroll, children, ...rest }: HTMLAttributes<HTMLElement> & {
+  autoScroll?: boolean;
+}): import("react").JSX.Element;
+/** The optional jump-to-latest door: an explicit part the caller drops
+ * inside the conversation when the log scrolls. It watches the log's
+ * distance from the bottom edge and surfaces only while the reader is
+ * away — clicking returns to the stream. Nothing renders by default. */
+export declare function AiJumpToLatest({ threshold, onJump, children, ...rest }: HTMLAttributes<HTMLButtonElement> & {
+  threshold?: number;
+  onJump?: () => void;
+}): import("react").JSX.Element;
+/** The bubble's inner measure — content that belongs to neither side
+ * specifically. */
+export declare const AiContent: {
+  ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+  displayName: string;
+} & {
+  Root: {
+    ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+    displayName: string;
+  };
+};
+/** The quiet row under a message — copy, retry, feedback. */
+export declare const AiActions: {
+  ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+  displayName: string;
+} & {
+  Root: {
+    ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+    displayName: string;
+  };
+};
+/** The while-it-works whisper for the in-flight turns. */
+declare function AiLoader({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+/** The whole family under one handle — `Ai.Conversation`,
+ * `Ai.Message`, and the rest, exactly as before the split. */
+export declare const Ai: typeof AiConversation & {
+  Root: typeof AiConversation;
+  Conversation: typeof AiConversation;
+  MessageContent: {
+    ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+    displayName: string;
+  } & {
+    Root: {
+      ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+      displayName: string;
+    };
+  };
+  Actions: {
+    ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+    displayName: string;
+  } & {
+    Root: {
+      ({ children, ...rest }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+      displayName: string;
+    };
+  };
+  Loader: typeof AiLoader;
+  Media: ((props: AiMediaProps) => import("react").JSX.Element | null) & {
+    Root: (props: AiMediaProps) => import("react").JSX.Element | null;
+  };
+  Parts: (<MESSAGE extends AiSdkMessage>(props: AiPartsProps<MESSAGE>) => string | number | bigint | true | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element) & {
+    Root: <MESSAGE extends AiSdkMessage>(props: AiPartsProps<MESSAGE>) => string | number | bigint | true | Iterable<import("react").ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | import("react").JSX.Element;
+  };
+  JumpToLatest: typeof AiJumpToLatest;
+  Message: (<MESSAGE extends AiSdkMessage>({ message, role: roleProp, children, ...rest }: MessageProps<MESSAGE>) => import("react").JSX.Element) & {
+    Root: <MESSAGE extends AiSdkMessage>({ message, role: roleProp, children, ...rest }: MessageProps<MESSAGE>) => import("react").JSX.Element;
+  };
+  Response: (({ content, highlighter, copyLabel, copiedLabel, ...rest }: ResponseProps) => import("react").JSX.Element) & {
+    Root: ({ content, highlighter, copyLabel, copiedLabel, ...rest }: ResponseProps) => import("react").JSX.Element;
+  };
+  Reasoning: (({ label, children, ...rest }: ReasoningProps) => import("react").JSX.Element) & {
+    Root: ({ label, children, ...rest }: ReasoningProps) => import("react").JSX.Element;
+  };
+  Tool: (({ name, label, status, approval, input, inputValue, output, outputValue, defaultOpen, onApprove, onDeny, ...rest }: ToolProps) => import("react").JSX.Element) & {
+    Root: ({ name, label, status, approval, input, inputValue, output, outputValue, defaultOpen, onApprove, onDeny, ...rest }: ToolProps) => import("react").JSX.Element;
+  };
+  Sources: (({ children, ...rest }: SourcesProps) => import("react").JSX.Element) & {
+    Root: ({ children, ...rest }: SourcesProps) => import("react").JSX.Element;
+  };
+  Source: (({ href, children, ...rest }: SourceProps) => import("react").JSX.Element) & {
+    Root: ({ href, children, ...rest }: SourceProps) => import("react").JSX.Element;
+  };
+  Action: (({ label, children, ...rest }: ActionProps) => import("react").JSX.Element) & {
+    Root: ({ label, children, ...rest }: ActionProps) => import("react").JSX.Element;
+  };
+  Suggestion: (({ prompt, onSelect, ...rest }: SuggestionProps) => import("react").JSX.Element) & {
+    Root: ({ prompt, onSelect, ...rest }: SuggestionProps) => import("react").JSX.Element;
+  };
+  PromptInput: (({ value, onValueChange, onSubmit, onStop, placeholder, "aria-label": ariaLabel, disabled, busy, mentions, onSelect, header, leading, trailing, footer, footerEnd, ...rest }: PromptInputProps) => import("react").JSX.Element) & {
+    Root: ({ value, onValueChange, onSubmit, onStop, placeholder, "aria-label": ariaLabel, disabled, busy, mentions, onSelect, header, leading, trailing, footer, footerEnd, ...rest }: PromptInputProps) => import("react").JSX.Element;
+  };
+};
+export { AiMedia, type AiMediaKind, type AiMediaProps, AiParts, type AiPartsProps, type AiPartsSlots, type AiSdkCustomPart, type AiSdkDataPart, type AiSdkFilePart, type AiSdkMediaPart, type AiSdkMessage, type AiSdkMessagePart, type AiSdkReasoningFilePart, type AiSdkReasoningPart, type AiSdkSourceDocumentPart, type AiSdkSourceUrlPart, type AiSdkStepStartPart, type AiSdkTextPart, type AiSdkToolPart, type AiToolDisplay, type ChatOnDataCallback, type ChatOnErrorCallback, type ChatOnFinishCallback, type ChatState, type ChatStatus, type CreateUIMessage, type CustomContentUIPart, type DataUIPart, type DynamicToolUIPart, type FileUIPart, type InferUITools, type MessageProps, type ProviderMetadata, type ProviderReference, type ReasoningFileUIPart, type ReasoningUIPart, type SourceDocumentUIPart, type SourceUrlUIPart, type StepStartUIPart, type TextUIPart, type ToolSet, type ToolUIPart, type UIDataTypes, type UIMessage, type UIMessageChunk, type UIMessagePart, type UITool, type UIToolInvocation, type UITools, toolPartDisplay };