@godxjp/ui 32.0.4 → 32.1.0

package/dist/components/data-entry/search-select.js

@@ -16,6 +16,8 @@ import {
 } from "./control-surface.js";
 import { normalizeSelectOptions } from "../../lib/select-options.js";
 import { Popover, PopoverContent, PopoverTrigger } from "../data-display/popover.js";
+import { Button } from "../general/button.js";
+import { Flex } from "../layout/flex.js";
 import { Command, CommandGroup } from "./command.js";
 import { Input } from "./input.js";
 const DEBOUNCE_MS = 250;
@@ -97,6 +99,8 @@ function SearchSelect(props) {
   const allowCreate = props.mode !== void 0 ? props.allowCreate : void 0;
   const createLabel = props.mode !== void 0 ? props.createLabel : void 0;
   const onCreate = props.mode !== void 0 ? props.onCreate : void 0;
+  const needConfirm = props.mode !== void 0 ? Boolean(props.needConfirm) : false;
+  const [pending, setPending] = React.useState(null);
   const fold = React.useCallback(
     (text) => caseSensitive ? text : text.toLowerCase(),
     [caseSensitive]
@@ -125,6 +129,7 @@ function SearchSelect(props) {
   const setOpen = React.useCallback(
     (next) => {
       if (!isOpenControlled) setInternalOpen(next);
+      if (!next) setPending(null);
       onOpenChange?.(next);
     },
     [isOpenControlled, onOpenChange]
@@ -158,8 +163,10 @@ function SearchSelect(props) {
     if (!multiple) return [];
     return Array.isArray(rawValue) ? rawValue : rawValue ? [rawValue] : [];
   }, [multiple, rawValue]);
+  const drafting = needConfirm && open;
+  const working = drafting ? pending ?? values : values;
   const value = multiple ? "" : Array.isArray(rawValue) ? rawValue[0] ?? "" : rawValue;
-  const isSelected = (optionValue) => multiple ? values.includes(optionValue) : value === optionValue;
+  const isSelected = (optionValue) => multiple ? working.includes(optionValue) : value === optionValue;
   const hasSelection = multiple ? values.length > 0 : Boolean(value);
   const reqId = React.useRef(0);
   const [freshPage, setFreshPage] = React.useState(0);
@@ -220,7 +227,7 @@ function SearchSelect(props) {
     if (!tagsMode) return { displayOptions: loaded, createOption: void 0 };
     const known = new Set(loaded.map((option) => option.value));
     const extras = [];
-    for (const entry of values) {
+    for (const entry of working) {
       if (known.has(entry)) continue;
       known.add(entry);
       const held = pickedOptions[entry] ?? { value: entry, label: entry };
@@ -232,7 +239,7 @@ function SearchSelect(props) {
     );
     const create = typedText && !exists && canCreate(typedText) ? { value: typedText, label: typedText } : void 0;
     const exact = typedText ? loaded.find(
-      (option) => !values.includes(option.value) && (fold(option.value) === typed || fold(option.label) === typed)
+      (option) => !working.includes(option.value) && (fold(option.value) === typed || fold(option.label) === typed)
     ) : void 0;
     const rest = exact ? loaded.filter((option) => option !== exact) : loaded;
     return {
@@ -242,7 +249,7 @@ function SearchSelect(props) {
   }, [
     tagsMode,
     loaded,
-    values,
+    working,
     typedText,
     pickedOptions,
     staticOptions,
@@ -302,16 +309,23 @@ function SearchSelect(props) {
     props.mode !== void 0 ? props.maxTagPlaceholder : void 0
   );
   const maxCount = props.mode !== void 0 ? props.maxCount : void 0;
-  const atMaxCount = maxCount !== void 0 && values.length >= maxCount;
+  const atMaxCount = maxCount !== void 0 && working.length >= maxCount;
   const remember = (option) => setPickedOptions((prev) => ({ ...prev, [option.value]: option }));
   const isInvented = (entry) => tagsMode && !(staticOptions ?? []).some((option) => option.value === entry) && !loaded.some((option) => option.value === entry);
-  const select = (option) => {
+  const select = (option, { commit = false } = {}) => {
     if (option.disabled) return;
     if (props.mode !== void 0) {
-      const already = values.includes(option.value);
-      if (!already && atMaxCount) return;
-      const next = already ? values.filter((entry) => entry !== option.value) : [...values, option.value];
+      const toDraft = drafting && !commit;
+      const base = toDraft ? working : values;
+      const already = base.includes(option.value);
+      if (!already && maxCount !== void 0 && base.length >= maxCount) return;
+      const next = already ? base.filter((entry) => entry !== option.value) : [...base, option.value];
       remember(option);
+      if (toDraft) {
+        setPending(next);
+        if (autoClearSearchValue) setQuery("");
+        return;
+      }
       if (!isControlled) setInternalValue(next);
       props.onValueChange?.(
         next,
@@ -334,7 +348,7 @@ function SearchSelect(props) {
   };
   const selectTokens = (text) => {
     if (props.mode === void 0) return;
-    const next = [...values];
+    const next = [...working];
     const picked = [];
     for (const raw of splitByTokenSeparators(text, tokenSeparators ?? [])) {
       const token = raw.trim();
@@ -351,6 +365,10 @@ function SearchSelect(props) {
     }
     if (picked.length === 0) return;
     for (const option of picked) remember(option);
+    if (drafting) {
+      setPending(next);
+      return;
+    }
     if (!isControlled) setInternalValue(next);
     props.onValueChange?.(
       next,
@@ -362,7 +380,19 @@ function SearchSelect(props) {
     }
   };
   const deselect = (chipValue) => {
-    select(optionFor(chipValue) ?? { value: chipValue, label: chipValue });
+    select(optionFor(chipValue) ?? { value: chipValue, label: chipValue }, { commit: true });
+  };
+  const confirm = () => {
+    if (props.mode !== void 0) {
+      const next = working;
+      if (!isControlled) setInternalValue(next);
+      props.onValueChange?.(
+        next,
+        next.map(optionFor).filter((entry) => entry !== null)
+      );
+    }
+    if (autoClearSearchValue) setQuery("");
+    setOpen(false);
   };
   const clear = () => {
     if (props.mode !== void 0) {
@@ -713,6 +743,28 @@ function SearchSelect(props) {
                       }
                     })
                   }
+                ) : null,
+                needConfirm ? /* @__PURE__ */ jsx(
+                  "div",
+                  {
+                    className: "ui-search-select-footer",
+                    "data-slot": "search-select-confirm",
+                    onKeyDown: (event) => event.stopPropagation(),
+                    children: /* @__PURE__ */ jsxs(Flex, { justify: "end", gap: "sm", children: [
+                      /* @__PURE__ */ jsx(
+                        Button,
+                        {
+                          type: "button",
+                          variant: "ghost",
+                          size: "sm",
+                          disabled: working.length === 0,
+                          onClick: () => setPending([]),
+                          children: t("common.clear")
+                        }
+                      ),
+                      /* @__PURE__ */ jsx(Button, { type: "button", size: "sm", onClick: confirm, children: t("dataEntry.timePicker.confirm") })
+                    ] })
+                  }
                 ) : null
               ] }) })
             }

package/dist/components/feedback/sonner.d.ts

@@ -1,10 +1,16 @@
 import * as React from "react";
 import { type ToasterProps } from "sonner";
+/**
+ * `--toast-duration` → milliseconds for Sonner's `duration` (gh#1253). Accepts the two CSS time
+ * units; anything else (unset, `initial`, a typo) is `undefined`, which leaves Sonner's own
+ * 4000ms default in charge rather than inventing a second one here.
+ */
+export declare function parseToastDuration(raw: string): number | undefined;
 /**
  * `richColors` defaults ON: it is the switch that makes sonner apply the per-type properties at
  * all (`[data-rich-colors='true'][data-type='success'] { … }`), so without it the tokens above
  * are declared and never read. A consumer can still pass `richColors={false}` for a deliberately
  * monochrome stack.
  */
-declare function Toaster({ style, richColors, ...props }: ToasterProps): React.JSX.Element;
+declare function Toaster({ style, richColors, toastOptions, ...props }: ToasterProps): React.JSX.Element;
 export { Toaster };

package/dist/components/feedback/sonner.js

@@ -5,6 +5,7 @@ import { createPortal } from "react-dom";
 import { CheckCircle2, Info, Loader2, OctagonX, TriangleAlert } from "lucide-react";
 import { Toaster as Sonner } from "sonner";
 import { useOverlayPortalContainer } from "../../lib/overlay-portal.js";
+import { useTranslation } from "../../i18n/use-translation.js";
 function useDocumentTheme() {
   return React.useSyncExternalStore(
     (onStoreChange) => {
@@ -25,6 +26,20 @@ function useDocumentTheme() {
     () => "light"
   );
 }
+function parseToastDuration(raw) {
+  const match = /^\s*(\d+(?:\.\d+)?)(ms|s)\s*$/.exec(raw);
+  if (!match) return void 0;
+  const ms = Number(match[1]) * (match[2] === "s" ? 1e3 : 1);
+  return ms > 0 ? ms : void 0;
+}
+function useToastDurationToken(host) {
+  const [duration, setDuration] = React.useState(void 0);
+  React.useEffect(() => {
+    const element = host ?? document.documentElement;
+    setDuration(parseToastDuration(getComputedStyle(element).getPropertyValue("--toast-duration")));
+  }, [host]);
+  return duration;
+}
 const TOAST_TONES = [
   { type: "success", hue: "success", ink: "text-success" },
   { type: "error", hue: "destructive", ink: "text-error" },
@@ -45,9 +60,11 @@ const toneVars = Object.fromEntries(
     [`--${type}-text`, `hsl(var(--${ink}))`]
   ])
 );
-function Toaster({ style, richColors = true, ...props }) {
+function Toaster({ style, richColors = true, toastOptions, ...props }) {
   const theme = useDocumentTheme();
+  const { t } = useTranslation();
   const overlayPortalContainer = useOverlayPortalContainer();
+  const tokenDuration = useToastDurationToken(overlayPortalContainer);
   const toaster = /* @__PURE__ */ jsx(
     Sonner,
     {
@@ -86,11 +103,14 @@ function Toaster({ style, richColors = true, ...props }) {
         bottom: "var(--toast-mobile-offset)",
         right: "var(--toast-mobile-offset)"
       },
+      duration: tokenDuration,
+      toastOptions: { closeButtonAriaLabel: t("feedback.toast.close"), ...toastOptions },
       ...props
     }
   );
   return overlayPortalContainer ? createPortal(toaster, overlayPortalContainer) : toaster;
 }
 export {
-  Toaster
+  Toaster,
+  parseToastDuration
 };

package/dist/components/feedback/use-toast.d.ts

@@ -1,3 +1,5 @@
 import { toast as sonnerToast } from "sonner";
+type SonnerToast = typeof sonnerToast;
+declare const toast: SonnerToast;
 export type { ExternalToast } from "sonner";
-export { sonnerToast, sonnerToast as toast };
+export { sonnerToast, toast };

package/dist/components/feedback/use-toast.js

@@ -1,6 +1,15 @@
 "use client";
 import { toast as sonnerToast } from "sonner";
+const withCloseButton = (show) => (message, data) => show(message, { closeButton: true, ...data });
+const toast = Object.assign(
+  (...args) => sonnerToast(...args),
+  sonnerToast,
+  {
+    error: withCloseButton(sonnerToast.error),
+    warning: withCloseButton(sonnerToast.warning)
+  }
+);
 export {
   sonnerToast,
-  sonnerToast as toast
+  toast
 };

package/dist/components/navigation/dropdown-menu.d.ts

@@ -154,6 +154,12 @@ interface DropdownMenuItemPropsOwn {
     disabled?: boolean;
     onSelect?: (event: Event) => void;
     textValue?: string;
+    /**
+     * A second, muted line under the label — the two-line row (gh#1246, parity with
+     * `MegaMenuLinkProp.description`). Rendered as RAC `<Text slot="description">`, so the item's
+     * accessible NAME stays the label and the description is wired as its `aria-describedby`.
+     */
+    description?: React.ReactNode;
     /** Mượn thẻ của con thay vì dựng `<div>` riêng — chỗ để nhét một `<Link>` vào một mục menu. */
     asChild?: boolean;
     /**
@@ -170,7 +176,7 @@ interface DropdownMenuItemPropsOwn {
     id?: string;
 }
 type DropdownMenuItemProps = React.PropsWithChildren<DropdownMenuItemPropsOwn> & Record<`data-${string}`, unknown>;
-export declare function DropdownMenuItem({ children, className, inset, variant, disabled, onSelect, textValue, asChild, ...forwarded }: DropdownMenuItemProps): React.JSX.Element;
+export declare function DropdownMenuItem({ children, className, inset, variant, disabled, onSelect, textValue, description, asChild, ...forwarded }: DropdownMenuItemProps): React.JSX.Element;
 interface DropdownMenuLabelPropsOwn {
     className?: string;
     inset?: boolean;

package/dist/components/navigation/dropdown-menu.js

@@ -16,6 +16,7 @@ import {
   Separator,
   OverlayArrow,
   SubmenuTrigger,
+  Text,
   useLocale
 } from "react-aria-components";
 import { Check, ChevronRight } from "lucide-react";
@@ -397,15 +398,18 @@ function DropdownMenuItem({
   disabled,
   onSelect,
   textValue,
+  description,
   asChild,
   ...forwarded
 }) {
   const tag = borrowedTag(children, asChild);
+  const label = tag ? tag.props.children : children;
+  const hasDescription = description != null && description !== false;
   return /* @__PURE__ */ jsx(
     MenuItem,
     {
       isDisabled: disabled,
-      textValue,
+      textValue: textValue ?? (typeof label === "string" ? label : void 0),
       onAction: onSelect ? () => onSelect(selectEvent("dropdownmenu.itemSelect")) : void 0,
       className: cn(
         "ui-dropdown-menu-item [&_svg:not([class*='text-'])]:text-muted-foreground",
@@ -420,6 +424,7 @@ function DropdownMenuItem({
             "data-slot": "dropdown-menu-item",
             "data-inset": inset,
             "data-variant": variant,
+            "data-description": hasDescription ? "" : void 0,
             ...radixItemState(state),
             // LAST, so a consumer's own `id`/`data-*` wins over ours rather than being
             // overwritten by the slot bookkeeping above (gh#631).
@@ -428,7 +433,18 @@ function DropdownMenuItem({
           content
         );
       },
-      children: tag ? tag.props.children : children
+      children: hasDescription ? /* @__PURE__ */ jsxs("span", { className: "ui-dropdown-menu-item-text", children: [
+        /* @__PURE__ */ jsx(Text, { slot: "label", className: "ui-dropdown-menu-item-label", children: label }),
+        /* @__PURE__ */ jsx(
+          Text,
+          {
+            slot: "description",
+            "data-slot": "dropdown-menu-item-description",
+            className: "ui-dropdown-menu-item-description",
+            children: description
+          }
+        )
+      ] }) : label
     }
   );
 }

package/dist/contracts/measurement.json

@@ -1,6 +1,6 @@
 {
   "$comment": "AUTO-GENERATED by scripts/gen-measurement-contract.mjs — do not edit. Read this instead of guessing: docs/MEASUREMENT-CONTRACT.md.",
-  "version": "32.0.4",
+  "version": "32.1.0",
   "targetSize": {
     "standard": "WCAG 2.2 SC 2.5.8 Target Size (Minimum), level AA — 24×24 CSS px",
     "min": 24,

package/dist/i18n/messages/en.json

@@ -14,6 +14,7 @@
     "previous": "Previous",
     "next": "Next",
     "selectedCount": "{count} selected",
+    "selectedOfTotal": "{count} of {total} selected",
     "typeToConfirm": "Type {phrase} to confirm"
   },
   "dataEntry": {
@@ -32,7 +33,13 @@
       "placeholder": "Select date range",
       "from": "From",
       "to": "To",
-      "openCalendar": "Open calendar"
+      "openCalendar": "Open calendar",
+      "selectEnd": "Select end date",
+      "days": {
+        "one": "{count} day",
+        "other": "{count} days"
+      },
+      "summary": "{range} · {days}"
     },
     "timePicker": {
       "placeholder": "Select time",
@@ -50,6 +57,10 @@
     "searchInput": {
       "placeholder": "Search…"
     },
+    "commandPalette": {
+      "recent": "Recent searches",
+      "clearRecent": "Clear recent searches"
+    },
     "autocomplete": {
       "placeholder": "Search or select…",
       "empty": "No results found"
@@ -241,10 +252,14 @@
       "dropped": "Dropped {label} at position {position} of {count}.",
       "cancelled": "Move cancelled. {label} is back at position {position} of {count}."
     },
+    "checkboxGroup": {
+      "selectAll": "Select all"
+    },
     "passwordStrength": {
       "weak": "Weak",
       "fair": "Fair",
       "strong": "Strong",
+      "empty": "Enter a password",
       "meter": "Password strength {score} of 4",
       "passed": "Passed: ",
       "failed": "Not yet: ",
@@ -267,6 +282,9 @@
       "dismiss": "Dismiss",
       "verifying": "Verifying…",
       "stepUpFailed": "Re-authentication failed. Please try again."
+    },
+    "toast": {
+      "close": "Close notification"
     }
   },
   "layout": {

package/dist/i18n/messages/ja.json

@@ -14,6 +14,7 @@
     "previous": "前へ",
     "next": "次へ",
     "selectedCount": "{count} 件選択",
+    "selectedOfTotal": "{total} 件中 {count} 件選択",
     "typeToConfirm": "確認のため {phrase} と入力"
   },
   "dataEntry": {
@@ -32,7 +33,12 @@
       "placeholder": "期間を選択",
       "from": "開始",
       "to": "終了",
-      "openCalendar": "カレンダーを開く"
+      "openCalendar": "カレンダーを開く",
+      "selectEnd": "終了日を選択",
+      "days": {
+        "other": "{count}日間"
+      },
+      "summary": "{range}（{days}）"
     },
     "timePicker": {
       "placeholder": "時刻を選択",
@@ -50,6 +56,10 @@
     "searchInput": {
       "placeholder": "検索…"
     },
+    "commandPalette": {
+      "recent": "最近の検索",
+      "clearRecent": "検索履歴を消去"
+    },
     "autocomplete": {
       "placeholder": "検索または選択…",
       "empty": "結果が見つかりません"
@@ -237,10 +247,14 @@
       "dropped": "{label} を {count} 件中 {position} 番目に置きました。",
       "cancelled": "移動を取り消しました。{label} は {count} 件中 {position} 番目に戻りました。"
     },
+    "checkboxGroup": {
+      "selectAll": "すべて選択"
+    },
     "passwordStrength": {
       "weak": "弱い",
       "fair": "普通",
       "strong": "強い",
+      "empty": "パスワードを入力",
       "meter": "パスワードの強度 4 段階中 {score}",
       "passed": "達成: ",
       "failed": "未達成: ",
@@ -263,6 +277,9 @@
       "dismiss": "閉じる",
       "verifying": "確認中…",
       "stepUpFailed": "再認証に失敗しました。もう一度お試しください。"
+    },
+    "toast": {
+      "close": "通知を閉じる"
     }
   },
   "layout": {

package/dist/i18n/messages/vi.json

@@ -14,6 +14,7 @@
     "previous": "Trước",
     "next": "Tiếp",
     "selectedCount": "{count} đã chọn",
+    "selectedOfTotal": "Đã chọn {count}/{total}",
     "typeToConfirm": "Nhập {phrase} để xác nhận"
   },
   "dataEntry": {
@@ -32,7 +33,12 @@
       "placeholder": "Chọn khoảng ngày",
       "from": "Từ",
       "to": "Đến",
-      "openCalendar": "Mở lịch"
+      "openCalendar": "Mở lịch",
+      "selectEnd": "Chọn ngày kết thúc",
+      "days": {
+        "other": "{count} ngày"
+      },
+      "summary": "{range} · {days}"
     },
     "timePicker": {
       "placeholder": "Chọn giờ",
@@ -50,6 +56,10 @@
     "searchInput": {
       "placeholder": "Tìm kiếm…"
     },
+    "commandPalette": {
+      "recent": "Tìm kiếm gần đây",
+      "clearRecent": "Xóa lịch sử tìm kiếm"
+    },
     "autocomplete": {
       "placeholder": "Tìm hoặc chọn…",
       "empty": "Không tìm thấy kết quả"
@@ -238,10 +248,14 @@
       "dropped": "Đã thả {label} ở vị trí {position}/{count}.",
       "cancelled": "Đã huỷ di chuyển. {label} trở lại vị trí {position}/{count}."
     },
+    "checkboxGroup": {
+      "selectAll": "Chọn tất cả"
+    },
     "passwordStrength": {
       "weak": "Yếu",
       "fair": "Trung bình",
       "strong": "Mạnh",
+      "empty": "Nhập mật khẩu",
       "meter": "Độ mạnh mật khẩu {score} trên 4",
       "passed": "Đạt: ",
       "failed": "Chưa đạt: ",
@@ -264,6 +278,9 @@
       "dismiss": "Đóng",
       "verifying": "Đang xác minh…",
       "stepUpFailed": "Xác thực lại thất bại. Vui lòng thử lại."
+    },
+    "toast": {
+      "close": "Đóng thông báo"
     }
   },
   "layout": {

package/dist/lib/shortcut.d.ts

@@ -0,0 +1,17 @@
+/**
+ * A global keyboard shortcut, parsed from a combo string. Shared by `CommandPalette` (toggles the
+ * dialog) and `SearchInput` (focuses the field) so both read `"mod+k"` the same way (gh#1250).
+ */
+export type ShortcutSpec = {
+    key: string;
+    mod: boolean;
+    shift: boolean;
+    alt: boolean;
+    meta: boolean;
+    ctrl: boolean;
+};
+/** `"mod+shift+p"` → its parts. `true` is `mod+k`. */
+export declare function parseShortcut(shortcut: boolean | string): ShortcutSpec | null;
+export declare function shortcutMatches(spec: ShortcutSpec, event: KeyboardEvent): boolean;
+/** The hint a trigger shows: `mod+shift+p` → `⌘⇧P`. */
+export declare function shortcutHint(spec: ShortcutSpec): string;

package/dist/lib/shortcut.js

@@ -0,0 +1,37 @@
+import { isApplePlatform } from "./platform.js";
+function parseShortcut(shortcut) {
+  if (shortcut === false) return null;
+  const parts = (shortcut === true ? "mod+k" : shortcut).toLowerCase().split("+").map((p) => p.trim());
+  const key = parts.pop() ?? "";
+  if (!key) return null;
+  return {
+    key,
+    mod: parts.includes("mod"),
+    meta: parts.includes("meta") || parts.includes("cmd"),
+    ctrl: parts.includes("ctrl"),
+    shift: parts.includes("shift"),
+    alt: parts.includes("alt") || parts.includes("option")
+  };
+}
+function shortcutMatches(spec, event) {
+  const keyMatches = event.key.toLowerCase() === spec.key || /^[a-z]$/.test(spec.key) && event.code === `Key${spec.key.toUpperCase()}`;
+  if (!keyMatches) return false;
+  if (spec.mod && !(isApplePlatform() ? event.metaKey : event.ctrlKey)) return false;
+  if (spec.meta && !event.metaKey) return false;
+  if (spec.ctrl && !event.ctrlKey) return false;
+  return event.shiftKey === spec.shift && event.altKey === spec.alt;
+}
+function shortcutHint(spec) {
+  return [
+    spec.meta || spec.mod && isApplePlatform() ? "\u2318" : "",
+    spec.ctrl || spec.mod && !isApplePlatform() ? "Ctrl+" : "",
+    spec.alt ? "\u2325" : "",
+    spec.shift ? "\u21E7" : "",
+    spec.key.length === 1 ? spec.key.toUpperCase() : spec.key
+  ].join("");
+}
+export {
+  parseShortcut,
+  shortcutHint,
+  shortcutMatches
+};

package/dist/props/components/data-entry.prop.d.ts

@@ -468,6 +468,13 @@ export type SearchInputProp = FieldA11yProps & {
     status?: ControlStatusProp;
     /** Chrome level — antd `variant`. Default `outlined`. */
     variant?: ControlVariantProp;
+    /**
+     * A global shortcut that FOCUSES the field (gh#1250). `false` (default) binds none; `true` is
+     * ⌘K on Apple platforms and Ctrl+K elsewhere; a combo string (`"mod+/"`, `"mod+shift+f"`) binds
+     * that, read exactly as `CommandPalette.shortcut`. Shows a trailing key-cap hint while the field
+     * is empty. Never fires during IME composition, nor while `disabled`.
+     */
+    shortcut?: boolean | string;
 };
 /**
  * @see Checkbox
@@ -510,6 +517,16 @@ export type CheckboxGroupProp = FieldA11yProps & {
     id?: IdProp;
     className?: ClassNameProp;
     children?: React.ReactNode;
+    /**
+     * A leading "select all" box (gh#1245), `options` form only. Its state is derived from the group
+     * value — checked when every enabled option is selected, mixed on a partial selection, clear
+     * otherwise — and it is followed by a muted "{n} of {m} selected" count and a separator. One
+     * click is one `onValueChange`. Disabled options are outside it in both directions: neither
+     * counted nor added nor removed. `{ label }` replaces the default "Select all" text.
+     */
+    selectAll?: boolean | {
+        label?: React.ReactNode;
+    };
 };
 /** @see Radio.Group */
 export type RadioGroupProp = FieldA11yProps & {
@@ -1014,6 +1031,15 @@ export type DatePickerProp = DatePickerBaseProp & ({
     showTime?: false;
     /** Which endpoints may stay empty (antd `allowEmpty`), as `[from, to]`. */
     allowEmpty?: [boolean, boolean];
+    /**
+     * A polite live summary under the day grid: the start date while only the start is
+     * held, then `Intl.DateTimeFormat#formatRange` of both edges and the INCLUSIVE day count,
+     * plural-aware (en "7 days", ja 「7日間」). Default `true`. Day grid only — the
+     * month / quarter / year period grids have no day count to report and ignore it. The
+     * `to` edge's "Select end date" prompt while only the start is held is independent of
+     * this flag.
+     */
+    showSummary?: boolean;
     presets?: {
         label: React.ReactNode;
         value: DateRange | (() => DateRange);
@@ -1623,6 +1649,14 @@ export type SearchSelectMultipleProp = {
      * a token only counts when it matches a row; in `mode="tags"` it is accepted as it stands.
      */
     tokenSeparators?: string[];
+    /**
+     * Hold the panel's picks as a DRAFT until OK commits them (antd's `needConfirm`, the same word
+     * `TimePicker` / `DatePicker` use). Row toggles move a pending set; the footer's OK fires ONE
+     * `onValueChange` with the whole set and closes; its Clear empties the pending set; Escape or an
+     * outside click discards it, so the trigger keeps the committed values. `onSelect` /
+     * `onDeselect` do not fire for draft toggles. Default `false` (commit on every toggle).
+     */
+    needConfirm?: boolean;
 } & SelectTagsCreateProp;
 /**
  * antd `labelInValue`, single. The value carries its own label, so a screen that never sees the
@@ -1650,6 +1684,8 @@ export type SelectLabelInValueMultipleProp = {
     maxTagPlaceholder?: MaxTagPlaceholderProp;
     maxTagTextLength?: number;
     tokenSeparators?: string[];
+    /** @see SearchSelectMultipleProp.needConfirm */
+    needConfirm?: boolean;
     tagRender?: (props: {
         value: string;
         label: React.ReactNode;