twico-ui 1.22.3 → 1.23.0

package/dist/index.d.cts

@@ -1597,6 +1597,10 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   virtualized?: boolean;
   /** Extra option rows rendered above/below the viewport when `virtualized`, to smooth fast scrolling. @default 8 */
   overscan?: number;
+  /** Let long option labels/descriptions wrap onto multiple lines instead of truncating to one line with an
+   *  ellipsis — useful when options share a long prefix and differ only in a truncated tail. Takes precedence
+   *  over `virtualized` (wrapped rows aren't a fixed height). @default false */
+  wrapOptions?: boolean;
   /** Composed with the field's open-on-focus behavior — your handler runs first. */
   onFocus?: React.FocusEventHandler<HTMLInputElement>;
   /** Composed with the field's keyboard navigation (Arrows/Enter/Escape) — your handler runs first; call `event.preventDefault()` to suppress it. */

package/dist/index.d.ts

@@ -1597,6 +1597,10 @@ interface ComboboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>
   virtualized?: boolean;
   /** Extra option rows rendered above/below the viewport when `virtualized`, to smooth fast scrolling. @default 8 */
   overscan?: number;
+  /** Let long option labels/descriptions wrap onto multiple lines instead of truncating to one line with an
+   *  ellipsis — useful when options share a long prefix and differ only in a truncated tail. Takes precedence
+   *  over `virtualized` (wrapped rows aren't a fixed height). @default false */
+  wrapOptions?: boolean;
   /** Composed with the field's open-on-focus behavior — your handler runs first. */
   onFocus?: React.FocusEventHandler<HTMLInputElement>;
   /** Composed with the field's keyboard navigation (Arrows/Enter/Escape) — your handler runs first; call `event.preventDefault()` to suppress it. */

package/dist/index.mjs

@@ -5650,6 +5650,10 @@ var COMBO_CSS = `
 .twc-opt__main { display: flex; flex-direction: column; gap: 1px; min-width: 0; flex: 1; }
 .twc-opt__label { line-height: 1.3; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .twc-opt__desc { font-size: var(--text-xs); color: var(--color-text-muted); line-height: 1.3; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* #300: wrapOptions \u2014 let long labels/descriptions wrap onto multiple lines instead of truncating.
+   overflow-wrap: anywhere also breaks a single very long token so it can't overflow the popover edge. */
+.twc-opt[data-wrap="true"] { align-items: flex-start; }
+.twc-opt[data-wrap="true"] .twc-opt__label, .twc-opt[data-wrap="true"] .twc-opt__desc { overflow: visible; text-overflow: clip; white-space: normal; overflow-wrap: anywhere; }
 .twc-opt__check { flex: none; color: var(--color-primary); display: inline-flex; }
 .twc-opt__check svg { width: 16px; height: 16px; }
 .twc-pop__empty { padding: 14px 12px; text-align: center; font-size: var(--text-sm); color: var(--color-text-subtle); }
@@ -5710,8 +5714,9 @@ function Combobox({
   loading = false,
   emptyText = "No results found",
   name,
-  virtualized = false,
+  virtualized: virtualizedProp = false,
   overscan = 8,
+  wrapOptions = false,
   id,
   className = "",
   onFocus,
@@ -5719,6 +5724,8 @@ function Combobox({
   ...rest
 }) {
   const __twcStyles = useScopedStyles("twc-combo-styles", COMBO_CSS);
+  if (virtualizedProp && wrapOptions) warnOnce("combobox-wrap-virtualized", "twico-ui Combobox: `wrapOptions` disables `virtualized` \u2014 wrapped option rows aren't a fixed height.");
+  const virtualized = virtualizedProp && !wrapOptions;
   const groups = React51__default.useMemo(() => normalizeGroups(options), [options]);
   const flat = React51__default.useMemo(() => groups.flatMap((g) => g.options), [groups]);
   const autoId = React51__default.useId();
@@ -5905,6 +5912,7 @@ function Combobox({
         "data-disabled": o.disabled || void 0,
         "data-selected": isSel || void 0,
         "data-active": idx === active || void 0,
+        "data-wrap": wrapOptions || void 0,
         onMouseEnter: () => {
           if (!o.disabled) setActive(idx);
         },