@sia.soul/sia-react-ui 0.1.40 → 0.1.41

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { T as TagStatus, B as BadgeProps } from './core-BAHoW7_e.cjs';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-BAHoW7_e.cjs';
+import { T as TagStatus, B as BadgeProps } from './core-C2IieVNm.cjs';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-C2IieVNm.cjs';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
 import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-YJbT-MF1.cjs';
 export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-YJbT-MF1.cjs';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-CtA-B8DB.cjs';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-2galnCvZ.cjs';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.cjs';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.cjs';
 import * as Monaco from 'monaco-editor';
@@ -2839,8 +2839,8 @@ declare const SIA_THEME: {
     readonly controlHeight: 32;
     /** 默认布局间距，单位为像素。 */
     readonly spacing: 16;
-    /** 默认字号，单位为像素。 */
-    readonly fontSize: 16;
+    /** 默认基础字号为 13 像素，对应 --sia-font-size；业务可通过 CSS 变量覆盖。 */
+    readonly fontSize: 13;
     /** 默认小号文字尺寸为 13 像素，对应 --sia-font-size-small；业务可通过 CSS 变量覆盖。 */
     readonly fontSizeSmall: 13;
     /** 大号文字尺寸，单位为像素。 */

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { T as TagStatus, B as BadgeProps } from './core-fn8h4yRg.js';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-fn8h4yRg.js';
+import { T as TagStatus, B as BadgeProps } from './core-ZmKnvCFV.js';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagSize, aA as TagVariant, aB as Timeline, aC as TimelineItem, aD as TimelineProps, aE as Toolbar, aF as ToolbarItem, aG as ToolbarProps, aH as Tooltip, aI as TooltipProps, aJ as Tour, aK as TourProps, aL as TourStep, aM as Tree, aN as TreeDropPosition, aO as TreeKey, aP as TreeNode, aQ as TreeProps, aR as Typography, aS as TypographyLinkProps, aT as TypographyProps, aU as TypographyTitleProps, aV as TypographyType, aW as Upload, aX as UploadChangeInfo, aY as UploadDraggerProps, aZ as UploadFile, a_ as UploadFileStatus, a$ as UploadHttpRequest, b0 as UploadItemActions, b1 as UploadProps, b2 as UploadRef, b3 as UploadRejectInfo, b4 as UploadRequestHandle, b5 as UploadRequestOptions, b6 as Watermark, b7 as WatermarkFont, b8 as WatermarkProps, b9 as message, ba as notification } from './core-ZmKnvCFV.js';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.js';
 import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-CCrPqULn.js';
 export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-CCrPqULn.js';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-D9W_mmMq.js';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-Dtj6XF9I.js';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.js';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.js';
 import * as Monaco from 'monaco-editor';
@@ -2839,8 +2839,8 @@ declare const SIA_THEME: {
     readonly controlHeight: 32;
     /** 默认布局间距，单位为像素。 */
     readonly spacing: 16;
-    /** 默认字号，单位为像素。 */
-    readonly fontSize: 16;
+    /** 默认基础字号为 13 像素，对应 --sia-font-size；业务可通过 CSS 变量覆盖。 */
+    readonly fontSize: 13;
     /** 默认小号文字尺寸为 13 像素，对应 --sia-font-size-small；业务可通过 CSS 变量覆盖。 */
     readonly fontSizeSmall: 13;
     /** 大号文字尺寸，单位为像素。 */

package/dist/index.js

@@ -80,7 +80,7 @@ import {
   Watermark,
   message,
   notification
-} from "./chunk-CEZ4GW3X.js";
+} from "./chunk-IPDCEXQO.js";
 import {
   TextArea
 } from "./chunk-SMCYEPBL.js";
@@ -95,7 +95,7 @@ import {
   DatePicker,
   SelectDateRange,
   TimePanel
-} from "./chunk-6TLANQVX.js";
+} from "./chunk-LWVZEUGJ.js";
 import {
   Checkbox,
   FloatingScrollbarProvider,
@@ -110,7 +110,7 @@ import {
   Tree,
   useOverlayLifecycle,
   useScrollbarProximity
-} from "./chunk-ZTJUFVJO.js";
+} from "./chunk-3Q3S6CDZ.js";
 import {
   Dropdown,
   FILLED_ICON_NAMES,
@@ -7985,8 +7985,8 @@ var SIA_THEME = {
   controlHeight: 32,
   /** 默认布局间距，单位为像素。 */
   spacing: 16,
-  /** 默认字号，单位为像素。 */
-  fontSize: 16,
+  /** 默认基础字号为 13 像素，对应 --sia-font-size；业务可通过 CSS 变量覆盖。 */
+  fontSize: 13,
   /** 默认小号文字尺寸为 13 像素，对应 --sia-font-size-small；业务可通过 CSS 变量覆盖。 */
   fontSizeSmall: 13,
   /** 大号文字尺寸，单位为像素。 */

package/dist/{select-date-range-CtA-B8DB.d.cts → select-date-range-2galnCvZ.d.cts}

@@ -68,10 +68,10 @@ interface DatePickerProps extends SharedDatePickerProps {
      * @defaultValue false
      */
     multiple?: boolean;
-    /** 选择后需要点击确定才提交 */
+    /** 选择后需要点击确定才提交；带时间的范围必须确认后保存；纯日期范围点选后立即保存合法值，此属性仅控制是否保留面板供确认关闭。 */
     needConfirm?: boolean;
     /**
-     * 组合时间面板，可显示秒；范围选择会在宽屏并排显示起止面板，在窄屏分步选择
+     * 组合时间面板，可显示秒；范围选择始终显示单个面板，点击起止输入区域直接编辑对应端点；先确认当前端点，再切换到另一端点，两个端点确认后提交并关闭；锁定端点无需再次确认，快捷范围只需一次确认
      * @defaultValue false
      */
     showTime?: DatePickerShowTime;
@@ -125,11 +125,15 @@ interface DateRangePickerProps extends Omit<DatePickerProps, "value" | "defaultV
      * @defaultValue "→"
      */
     separator?: ReactNode;
-    /** 预设候选值或快捷选项集合。 */
+    /** 在面板左侧按配置顺序纵向显示的快捷范围；带时间时点击仅回填暂存值，再点击一次确定即提交并关闭，无需逐端确认；手动修改后恢复分步确认。 */
     presets?: readonly DateRangePickerPreset[];
     /** 日期区间允许的最大天数。 */
     maxRangeDays?: number;
-    /** 允许单独保留起点或终点；需要点击确定提交未完整的范围。 */
+    /**
+     * 按开始、结束顺序指定端点是否允许为空。任一端允许为空时，展开期间输入框即时显示暂存的日期时间；两端均必填时保留已提交值，完整确认后一起更新。
+     * 纯日期点选后立即通过 onChange 保存合法值，收起后保留；带时间仅即时显示暂存值，必须点击确定保存，未确认就收起则恢复已提交值。缺少必填端点或范围不合法时不保存。
+     * @defaultValue [false, false]
+     */
     allowEmpty?: readonly [boolean, boolean];
     /** 锁定指定端点，编辑和清空时保留其值。 */
     endpointDisabled?: readonly [boolean, boolean];
@@ -138,11 +142,12 @@ interface DateRangePickerProps extends Omit<DatePickerProps, "value" | "defaultV
     /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: readonly [string, string]) => void;
 }
+/** 日期范围选择；纯日期按两次点击组成范围，带时间时使用单面板分步设置起止值并确认提交。 */
 declare function DateRangePicker({ value, defaultValue, placeholder, placeholderMode, separator, presets, maxRangeDays, allowEmpty, endpointDisabled, size: sizeProp, status, allowClear, needConfirm, showTime, showToday, open, defaultOpen, suffixIcon, minDate, maxDate, disabledDate, disabled, className, onCalendarChange, onChange, onOpenChange, formatValue, renderExtraFooter, ...props }: DateRangePickerProps): react.JSX.Element;
 /** 日期选择组件。 */
 declare function DatePicker({ value, defaultValue, picker, size: sizeProp, status, allowClear, multiple, needConfirm, showTime, showToday, open, defaultOpen, suffixIcon, minDate, maxDate, presets, disabledDate, disabled, className, onChange, onOpenChange, placeholder, placeholderMode, formatValue, renderExtraFooter, ...props }: DatePickerProps): react.JSX.Element;
 declare namespace DatePicker {
-    /** 日期区间选择器。 */
+    /** 日期区间选择器；带时间时可从任一端开始，点击确定切换到另一端，两端确认后提交；锁定端点无需再次确认，快捷范围只需一次确认。纯日期支持在任一日历连续点选起止日期。 */
     const RangePicker: typeof DateRangePicker;
 }
 

package/dist/{select-date-range-D9W_mmMq.d.ts → select-date-range-Dtj6XF9I.d.ts}

@@ -68,10 +68,10 @@ interface DatePickerProps extends SharedDatePickerProps {
      * @defaultValue false
      */
     multiple?: boolean;
-    /** 选择后需要点击确定才提交 */
+    /** 选择后需要点击确定才提交；带时间的范围必须确认后保存；纯日期范围点选后立即保存合法值，此属性仅控制是否保留面板供确认关闭。 */
     needConfirm?: boolean;
     /**
-     * 组合时间面板，可显示秒；范围选择会在宽屏并排显示起止面板，在窄屏分步选择
+     * 组合时间面板，可显示秒；范围选择始终显示单个面板，点击起止输入区域直接编辑对应端点；先确认当前端点，再切换到另一端点，两个端点确认后提交并关闭；锁定端点无需再次确认，快捷范围只需一次确认
      * @defaultValue false
      */
     showTime?: DatePickerShowTime;
@@ -125,11 +125,15 @@ interface DateRangePickerProps extends Omit<DatePickerProps, "value" | "defaultV
      * @defaultValue "→"
      */
     separator?: ReactNode;
-    /** 预设候选值或快捷选项集合。 */
+    /** 在面板左侧按配置顺序纵向显示的快捷范围；带时间时点击仅回填暂存值，再点击一次确定即提交并关闭，无需逐端确认；手动修改后恢复分步确认。 */
     presets?: readonly DateRangePickerPreset[];
     /** 日期区间允许的最大天数。 */
     maxRangeDays?: number;
-    /** 允许单独保留起点或终点；需要点击确定提交未完整的范围。 */
+    /**
+     * 按开始、结束顺序指定端点是否允许为空。任一端允许为空时，展开期间输入框即时显示暂存的日期时间；两端均必填时保留已提交值，完整确认后一起更新。
+     * 纯日期点选后立即通过 onChange 保存合法值，收起后保留；带时间仅即时显示暂存值，必须点击确定保存，未确认就收起则恢复已提交值。缺少必填端点或范围不合法时不保存。
+     * @defaultValue [false, false]
+     */
     allowEmpty?: readonly [boolean, boolean];
     /** 锁定指定端点，编辑和清空时保留其值。 */
     endpointDisabled?: readonly [boolean, boolean];
@@ -138,11 +142,12 @@ interface DateRangePickerProps extends Omit<DatePickerProps, "value" | "defaultV
     /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: readonly [string, string]) => void;
 }
+/** 日期范围选择；纯日期按两次点击组成范围，带时间时使用单面板分步设置起止值并确认提交。 */
 declare function DateRangePicker({ value, defaultValue, placeholder, placeholderMode, separator, presets, maxRangeDays, allowEmpty, endpointDisabled, size: sizeProp, status, allowClear, needConfirm, showTime, showToday, open, defaultOpen, suffixIcon, minDate, maxDate, disabledDate, disabled, className, onCalendarChange, onChange, onOpenChange, formatValue, renderExtraFooter, ...props }: DateRangePickerProps): react.JSX.Element;
 /** 日期选择组件。 */
 declare function DatePicker({ value, defaultValue, picker, size: sizeProp, status, allowClear, multiple, needConfirm, showTime, showToday, open, defaultOpen, suffixIcon, minDate, maxDate, presets, disabledDate, disabled, className, onChange, onOpenChange, placeholder, placeholderMode, formatValue, renderExtraFooter, ...props }: DatePickerProps): react.JSX.Element;
 declare namespace DatePicker {
-    /** 日期区间选择器。 */
+    /** 日期区间选择器；带时间时可从任一端开始，点击确定切换到另一端，两端确认后提交；锁定端点无需再次确认，快捷范围只需一次确认。纯日期支持在任一日历连续点选起止日期。 */
     const RangePicker: typeof DateRangePicker;
 }