@botiverse/raft-ui 0.31.0 → 0.32.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [0.32.1](https://github.com/botiverse/raft-design/compare/v0.32.0...v0.32.1) (2026-10-23)
+
+### Fixed
+
+- **ChoiceList** (wip): a row's name or description line that is cut off has its whole text as its `title` while it is cut off, so a long description can still be read with a mouse. ([#783](https://github.com/botiverse/raft-design/pull/783))
+  - Docs: https://raft-design.botiverse.build/components/choice-list/
+
+## [0.32.0](https://github.com/botiverse/raft-design/compare/v0.31.0...v0.32.0) (2026-10-23)
+
+### Added
+
+- **ChoiceList** (wip): `matchedValues`, for a product with its own search (a ranked people search shared with mentions). With it ChoiceList shows the values the caller's search found, in the caller's order, instead of matching `searchText` itself; the chosen rows still come first and "No match" still shows. A value given twice shows once. Pass matches for the current text, and keep the previous ones while a slower search works. ([#780](https://github.com/botiverse/raft-design/pull/780))
+  - Docs: https://raft-design.botiverse.build/components/choice-list/
+
 ## [0.31.0](https://github.com/botiverse/raft-design/compare/v0.30.0...v0.31.0) (2026-10-23)
 
 ### Design System

package/dist/wip.d.mts

@@ -762,6 +762,13 @@ type ChoiceListCommonProps = {
    */
   searchValue?: string;
   onSearchValueChange?: (value: string) => void;
+  /**
+   * The values of the items that match the search text, in the order to show
+   * them, for a caller with its own search (a ranked people search shared
+   * with mentions). With it ChoiceList doesn't match `searchText` itself; it
+   * still keeps the chosen rows first and says when nothing matches.
+   */
+  matchedValues?: readonly string[];
   /** The clear button's accessible name. */
   clearSearchLabel: string;
   /** The line under the chosen rows when nothing else matches. */

package/dist/wip.mjs

@@ -2379,6 +2379,16 @@ function isDrawn(line) {
 function descriptionLines(description) {
 	return (Array.isArray(description) ? description : [description]).filter(isDrawn);
 }
+function CutLine({ id, slot, className, children }) {
+	const ref = useOverflowTitle();
+	return /* @__PURE__ */ jsx("span", {
+		ref,
+		id,
+		"data-slot": slot,
+		className,
+		children
+	});
+}
 const NOT_TEXT_INPUTS = /* @__PURE__ */ new Set([
 	"button",
 	"checkbox",
@@ -2400,15 +2410,18 @@ function searchTextOf(item) {
 	if (item.searchText !== void 0) return item.searchText;
 	return typeof item.label === "string" ? item.label : "";
 }
-function visibleItems(items, needle, pinned, chosen) {
+function visibleItems(items, needle, pinned, chosen, matchedValues) {
 	if (!needle) return {
 		rows: items,
 		noMatch: false
 	};
-	const matches = (item) => searchTextOf(item).toLowerCase().includes(needle);
-	const isPinned = (item) => pinned.includes(item.value);
+	const matched = matchedValues ? new Set(matchedValues) : null;
+	const matches = (item) => matched ? matched.has(item.value) : searchTextOf(item).toLowerCase().includes(needle);
+	const pinnedSet = new Set(pinned);
+	const isPinned = (item) => pinnedSet.has(item.value);
 	const top = items.filter((item) => isPinned(item) || chosen.includes(item.value) && !matches(item));
-	const rest = items.filter((item) => !top.includes(item) && matches(item));
+	const byValue = matchedValues ? new Map(items.map((item) => [item.value, item])) : null;
+	const rest = (byValue && matched ? [...matched].flatMap((value) => byValue.get(value) ?? []) : items).filter((item) => !top.includes(item) && matches(item));
 	return {
 		rows: [...top, ...rest],
 		noMatch: !items.some(matches)
@@ -2441,7 +2454,7 @@ function layoutSections(rows, groups) {
 	};
 }
 function ChoiceList(props) {
-	const { items, search = "auto", "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, disabled = false, searchLabel, searchPlaceholder, defaultSearchValue = "", searchValue, onSearchValueChange, clearSearchLabel, noMatchLabel, empty, groups, footer, fill = false, className } = props;
+	const { items, search = "auto", "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, disabled = false, searchLabel, searchPlaceholder, defaultSearchValue = "", searchValue, onSearchValueChange, matchedValues, clearSearchLabel, noMatchLabel, empty, groups, footer, fill = false, className } = props;
 	const value = props.value;
 	const chosen = useMemo(() => value === null ? [] : typeof value === "string" ? [value] : value, [value]);
 	const [ownQuery, setOwnQuery] = useState(defaultSearchValue);
@@ -2471,7 +2484,7 @@ function ChoiceList(props) {
 		setPinnedFor(query);
 		setPinned(chosen);
 	}
-	const { rows, noMatch } = visibleItems(items, searchable ? query.trim().toLowerCase() : "", pinned, chosen);
+	const { rows, noMatch } = visibleItems(items, searchable ? query.trim().toLowerCase() : "", pinned, chosen, matchedValues);
 	const hasAction = rows.some((item) => item.action !== void 0 && item.action !== null);
 	const slots = choiceList({
 		scroll: searchable && !fill,
@@ -2536,16 +2549,16 @@ function ChoiceList(props) {
 				/* @__PURE__ */ jsxs("span", {
 					"data-slot": "choice-list-body",
 					className: slots.body(),
-					children: [/* @__PURE__ */ jsx("span", {
+					children: [/* @__PURE__ */ jsx(CutLine, {
 						id: `${id}-label`,
-						"data-slot": "choice-list-label",
+						slot: "choice-list-label",
 						className: slots.label(),
 						children: item.label
 					}), lines.length > 0 ? /* @__PURE__ */ jsx("span", {
 						id: `${id}-description`,
 						className: "contents",
-						children: lines.map((line, index) => /* @__PURE__ */ jsx("span", {
-							"data-slot": "choice-list-description",
+						children: lines.map((line, index) => /* @__PURE__ */ jsx(CutLine, {
+							slot: "choice-list-description",
 							className: slots.description(),
 							children: line
 						}, index))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-ui",
-  "version": "0.31.0",
+  "version": "0.32.1",
   "description": "React components and CSS foundations for the Raft Design System.",
   "keywords": [
     "agent-skills",