@sia.soul/sia-react-ui 0.1.18 → 0.1.21

package/dist/markdown-editor.d.cts

@@ -1,30 +1,70 @@
 import * as react from 'react';
 import { HTMLAttributes } from 'react';
 import * as vditor from 'vditor';
-import { I as InputPlaceholderMode } from './shared-DAYZvZVu.cjs';
+import { I as InputPlaceholderMode } from './shared-Bx4B28Wh.cjs';
 
+/** 用于创建 Markdown 编辑器的 Vditor 构造函数类型。 */
 type VditorConstructor = typeof vditor["default"];
 declare global {
+    /** 供 Markdown 编辑器加载器使用的浏览器全局声明补充。 */
     interface Window {
+        /** Vditor 编辑器的构造入口。 */
         Vditor?: VditorConstructor;
     }
 }
+/** Markdown编辑器的模式类型。 */
 type MarkdownEditorMode = "wysiwyg" | "ir" | "sv";
+/** Markdown编辑器的属性配置。 */
 interface MarkdownEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ""
+     */
     defaultValue?: string;
+    /** Markdown 内容变化回调 */
     onChange?: (markdown: string) => void;
+    /**
+     * 所见即所得、即时渲染或源码模式
+     * @defaultValue "wysiwyg"
+     */
     mode?: MarkdownEditorMode;
+    /**
+     * 空内容提示
+     * @defaultValue "请输入 Markdown 正文"
+     */
     placeholder?: string;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 编辑器最小高度
+     * @defaultValue 320
+     */
     minHeight?: number | string;
+    /**
+     * 禁用编辑器
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue "Markdown 编辑器"
+     */
     ariaLabel?: string;
+    /** Vditor 静态资源地址；不传时使用组件库已安装的版本 */
     assetBaseUrl?: string;
+    /** 按 Ctrl / Command + S 时执行 */
     saveShortcut?: () => void;
+    /** 上传图片并返回图片地址；配置后显示上传按钮 */
     onUploadImage?: (file: File) => Promise<string> | string;
+    /**
+     * 识别剪贴板 Markdown 并保留语法结构
+     * @defaultValue true
+     */
     smartMarkdownPaste?: boolean;
 }
+/** Markdown编辑器组件。 */
 declare function MarkdownEditor({ value, defaultValue, onChange, mode, placeholder, placeholderMode, minHeight, disabled, ariaLabel, assetBaseUrl, saveShortcut, onUploadImage, smartMarkdownPaste, className, style, ...props }: MarkdownEditorProps): react.JSX.Element;
 
 export { MarkdownEditor, type MarkdownEditorMode, type MarkdownEditorProps };

package/dist/markdown-editor.d.ts

@@ -1,30 +1,70 @@
 import * as react from 'react';
 import { HTMLAttributes } from 'react';
 import * as vditor from 'vditor';
-import { I as InputPlaceholderMode } from './shared-DAYZvZVu.js';
+import { I as InputPlaceholderMode } from './shared-Bx4B28Wh.js';
 
+/** 用于创建 Markdown 编辑器的 Vditor 构造函数类型。 */
 type VditorConstructor = typeof vditor["default"];
 declare global {
+    /** 供 Markdown 编辑器加载器使用的浏览器全局声明补充。 */
     interface Window {
+        /** Vditor 编辑器的构造入口。 */
         Vditor?: VditorConstructor;
     }
 }
+/** Markdown编辑器的模式类型。 */
 type MarkdownEditorMode = "wysiwyg" | "ir" | "sv";
+/** Markdown编辑器的属性配置。 */
 interface MarkdownEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ""
+     */
     defaultValue?: string;
+    /** Markdown 内容变化回调 */
     onChange?: (markdown: string) => void;
+    /**
+     * 所见即所得、即时渲染或源码模式
+     * @defaultValue "wysiwyg"
+     */
     mode?: MarkdownEditorMode;
+    /**
+     * 空内容提示
+     * @defaultValue "请输入 Markdown 正文"
+     */
     placeholder?: string;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 编辑器最小高度
+     * @defaultValue 320
+     */
     minHeight?: number | string;
+    /**
+     * 禁用编辑器
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue "Markdown 编辑器"
+     */
     ariaLabel?: string;
+    /** Vditor 静态资源地址；不传时使用组件库已安装的版本 */
     assetBaseUrl?: string;
+    /** 按 Ctrl / Command + S 时执行 */
     saveShortcut?: () => void;
+    /** 上传图片并返回图片地址；配置后显示上传按钮 */
     onUploadImage?: (file: File) => Promise<string> | string;
+    /**
+     * 识别剪贴板 Markdown 并保留语法结构
+     * @defaultValue true
+     */
     smartMarkdownPaste?: boolean;
 }
+/** Markdown编辑器组件。 */
 declare function MarkdownEditor({ value, defaultValue, onChange, mode, placeholder, placeholderMode, minHeight, disabled, ariaLabel, assetBaseUrl, saveShortcut, onUploadImage, smartMarkdownPaste, className, style, ...props }: MarkdownEditorProps): react.JSX.Element;
 
 export { MarkdownEditor, type MarkdownEditorMode, type MarkdownEditorProps };

package/dist/rich-text-editor.cjs

@@ -1274,6 +1274,7 @@ function DropdownRoot({
   open,
   defaultOpen = false,
   disabled = false,
+  showTriggerIcon = true,
   arrow = false,
   autoFocus = false,
   openDelay = 80,
@@ -1434,6 +1435,10 @@ function DropdownRoot({
       className: "sia-dropdown__menu"
     }
   );
+  const triggerNode = showTriggerIcon && (0, import_react6.isValidElement)(children) && children.type === Button && children.props.children !== void 0 && children.props.children !== null ? (0, import_react6.cloneElement)(children, {}, /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: "sia-dropdown__trigger-content", children: [
+    children.props.children,
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Icon, { name: "chevron-down", size: 14, className: "sia-dropdown__trigger-icon" })
+  ] })) : children;
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
     "span",
     {
@@ -1449,7 +1454,7 @@ function DropdownRoot({
       onKeyDown: handleKeyDown,
       ...props,
       children: [
-        children,
+        triggerNode,
         /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
           "span",
           {
@@ -1496,7 +1501,7 @@ function DropdownButton({
 }) {
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("span", { className: `sia-dropdown-button ${className}`.trim(), children: [
     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(Button, { ...buttonProps, disabled, onClick, children }),
-    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DropdownRoot, { ...dropdownProps, disabled, trigger, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(DropdownRoot, { ...dropdownProps, disabled, trigger, showTriggerIcon: false, children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
       Button,
       {
         ...buttonProps,
@@ -1508,7 +1513,10 @@ function DropdownButton({
     ) })
   ] });
 }
-var Dropdown = Object.assign(DropdownRoot, { Button: DropdownButton });
+var Dropdown = Object.assign(DropdownRoot, {
+  /** 组合主操作按钮与下拉菜单的按钮组件。 */
+  Button: DropdownButton
+});
 
 // src/components/Input.tsx
 var import_react7 = require("react");

package/dist/rich-text-editor.d.cts

@@ -1,29 +1,74 @@
 import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
-import { I as InputPlaceholderMode } from './shared-DAYZvZVu.cjs';
+import { I as InputPlaceholderMode } from './shared-Bx4B28Wh.cjs';
 
+/** 处理富文本粘贴图片的函数，返回可插入编辑器的图片地址。 */
 type RichTextImagePasteHandler = (file: File) => string | Promise<string>;
+/** 富文本内容采用的存储格式。 */
 type RichTextContentFormat = "html" | "markdown";
+/** 富文本编辑工具栏的按钮配置。 */
 type RichTextToolbar = "basic" | "full";
+/** 富文本编辑器的属性配置。 */
 interface RichTextEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "contentEditable" | "onChange"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ""
+     */
     defaultValue?: string;
+    /**
+     * 输入和输出的内容格式
+     * @defaultValue "html"
+     */
     contentFormat?: RichTextContentFormat;
+    /**
+     工具栏配置。
+     * @defaultValue "basic"
+     */
     toolbar?: RichTextToolbar;
+    /**
+     * 空内容提示
+     * @defaultValue "请输入内容"
+     */
     placeholder?: string;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 禁用编辑和工具栏
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 编辑区域最小高度
+     * @defaultValue 150
+     */
     minHeight?: number | string;
+    /**
+     * 图片粘贴能力的工具栏提示
+     * @defaultValue "可直接粘贴图片"
+     */
     pasteImageHint?: ReactNode;
+    /** 内容变化回调，格式由 contentFormat 决定 */
     onChange?: (content: string) => void;
+    /** 处理剪贴板图片并返回可访问地址 */
     onPasteImage?: RichTextImagePasteHandler;
+    /** 按 Ctrl / Command + S 时执行 */
     saveShortcut?: () => void;
 }
+/** 富文本内容的属性配置。 */
 interface RichTextContentProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    /** 需要显示的内容，支持文本或 React 节点。 */
     content: string;
+    /**
+     * 内容为空时显示的占位内容
+     * @defaultValue "暂无内容"
+     */
     emptyText?: ReactNode;
 }
+/** 富文本内容组件。 */
 declare function RichTextContent({ content, emptyText, className, ...props }: RichTextContentProps): react.JSX.Element;
+/** 富文本编辑器组件。 */
 declare function RichTextEditor({ value, defaultValue, contentFormat, toolbar, placeholder, placeholderMode, disabled, minHeight, pasteImageHint, onChange, onPasteImage, saveShortcut, className, id, style, "aria-label": ariaLabel, ...props }: RichTextEditorProps): react.JSX.Element;
 
 export { RichTextContent, type RichTextContentFormat, type RichTextContentProps, RichTextEditor, type RichTextEditorProps, type RichTextImagePasteHandler, type RichTextToolbar };

package/dist/rich-text-editor.d.ts

@@ -1,29 +1,74 @@
 import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
-import { I as InputPlaceholderMode } from './shared-DAYZvZVu.js';
+import { I as InputPlaceholderMode } from './shared-Bx4B28Wh.js';
 
+/** 处理富文本粘贴图片的函数，返回可插入编辑器的图片地址。 */
 type RichTextImagePasteHandler = (file: File) => string | Promise<string>;
+/** 富文本内容采用的存储格式。 */
 type RichTextContentFormat = "html" | "markdown";
+/** 富文本编辑工具栏的按钮配置。 */
 type RichTextToolbar = "basic" | "full";
+/** 富文本编辑器的属性配置。 */
 interface RichTextEditorProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "contentEditable" | "onChange"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ""
+     */
     defaultValue?: string;
+    /**
+     * 输入和输出的内容格式
+     * @defaultValue "html"
+     */
     contentFormat?: RichTextContentFormat;
+    /**
+     工具栏配置。
+     * @defaultValue "basic"
+     */
     toolbar?: RichTextToolbar;
+    /**
+     * 空内容提示
+     * @defaultValue "请输入内容"
+     */
     placeholder?: string;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 禁用编辑和工具栏
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 编辑区域最小高度
+     * @defaultValue 150
+     */
     minHeight?: number | string;
+    /**
+     * 图片粘贴能力的工具栏提示
+     * @defaultValue "可直接粘贴图片"
+     */
     pasteImageHint?: ReactNode;
+    /** 内容变化回调，格式由 contentFormat 决定 */
     onChange?: (content: string) => void;
+    /** 处理剪贴板图片并返回可访问地址 */
     onPasteImage?: RichTextImagePasteHandler;
+    /** 按 Ctrl / Command + S 时执行 */
     saveShortcut?: () => void;
 }
+/** 富文本内容的属性配置。 */
 interface RichTextContentProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    /** 需要显示的内容，支持文本或 React 节点。 */
     content: string;
+    /**
+     * 内容为空时显示的占位内容
+     * @defaultValue "暂无内容"
+     */
     emptyText?: ReactNode;
 }
+/** 富文本内容组件。 */
 declare function RichTextContent({ content, emptyText, className, ...props }: RichTextContentProps): react.JSX.Element;
+/** 富文本编辑器组件。 */
 declare function RichTextEditor({ value, defaultValue, contentFormat, toolbar, placeholder, placeholderMode, disabled, minHeight, pasteImageHint, onChange, onPasteImage, saveShortcut, className, id, style, "aria-label": ariaLabel, ...props }: RichTextEditorProps): react.JSX.Element;
 
 export { RichTextContent, type RichTextContentFormat, type RichTextContentProps, RichTextEditor, type RichTextEditorProps, type RichTextImagePasteHandler, type RichTextToolbar };

package/dist/rich-text-editor.js

@@ -1,8 +1,8 @@
 import {
   RichTextContent,
   RichTextEditor
-} from "./chunk-I3EF5SF2.js";
-import "./chunk-SUMXP2SF.js";
+} from "./chunk-RWGSZW32.js";
+import "./chunk-KLI65JVD.js";
 import "./chunk-TZGUBGA4.js";
 import "./chunk-3VJ4CZDQ.js";
 export {

package/dist/{select-date-range-Bdb-hi9c.d.ts → select-date-range-CGRb3-W8.d.ts}

@@ -1,94 +1,208 @@
 import * as react from 'react';
 import { InputHTMLAttributes, ReactNode, HTMLAttributes, CSSProperties } from 'react';
-import { I as InputPlaceholderMode, C as ControlSize, a as ControlStatus } from './shared-DAYZvZVu.js';
-import { c as SelectOption, e as SelectValue } from './Select-Ce2Irbpt.js';
+import { I as InputPlaceholderMode, C as ControlSize, a as ControlStatus } from './shared-Bx4B28Wh.js';
+import { S as SelectOption, e as SelectValue } from './Select-BNSE67xn.js';
 
+/** 日期选择附带的时间选择配置。 */
 type DatePickerShowTime = boolean | {
+    /** 是否显示秒选择。 */
     showSecond?: boolean;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: string | readonly [string, string];
 };
 
+/** 日期选择的类型标识。 */
 type DatePickerType = "date" | "week" | "month" | "year" | "quarter";
+/** 日期选择的值类型。 */
 type DatePickerValue = string | readonly string[];
+/** 日期选择面板中的快捷日期选项。 */
 type DatePickerPreset = {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: string | (() => string);
 };
+/** 日期区间面板中的快捷范围选项。 */
 type DateRangePickerPreset = {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: readonly [string, string] | (() => readonly [string, string]);
 };
+/** 日期禁用判断函数收到的面板和范围上下文。 */
 type DatePickerDisabledInfo = {
+    /** 范围、渐变或转换的起始值。 */
     from?: string;
+    /** 类型标识，用于选择对应的表现形式。 */
     type: "date";
 };
+/** SharedDatePicker的属性配置。 */
 type SharedDatePickerProps = Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "value" | "defaultValue" | "onChange" | "multiple">;
+/** 日期选择的属性配置。 */
 interface DatePickerProps extends SharedDatePickerProps {
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: DatePickerValue;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: DatePickerValue;
+    /**
+     * 日期粒度
+     * @defaultValue "date"
+     */
     picker?: DatePickerType;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue true
+     */
     allowClear?: boolean;
+    /**
+     是否允许在同一面板选择多个日期。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /** 选择后需要点击确定才提交 */
     needConfirm?: boolean;
+    /**
+     * 组合时间面板，可显示秒；范围选择会在宽屏并排显示起止面板，在窄屏分步选择
+     * @defaultValue false
+     */
     showTime?: DatePickerShowTime;
+    /**
+     * 是否显示返回今天的入口。
+     * @defaultValue true
+     */
     showToday?: boolean;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue false
+     */
     defaultOpen?: boolean;
+    /** 显示在控件末尾的图标。 */
     suffixIcon?: ReactNode;
+    /** 允许选择的最早日期。 */
     minDate?: string;
+    /** 允许选择的最晚日期。 */
     maxDate?: string;
+    /** 预设候选值或快捷选项集合。 */
     presets?: readonly DatePickerPreset[];
+    /** 判断某个日期是否不可选的函数。 */
     disabledDate?: (value: string, info: DatePickerDisabledInfo) => boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: DatePickerValue) => void;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
     /** 只格式化显示文字，不改变传入和回调的标准日期值。 */
     formatValue?: (value: string) => string;
+    /** 渲染面板底部的自定义扩展区域。 */
     renderExtraFooter?: () => ReactNode;
 }
+/** 日期区间选择的属性配置。 */
 interface DateRangePickerProps extends Omit<DatePickerProps, "value" | "defaultValue" | "onChange" | "placeholder" | "multiple" | "presets"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: readonly [string, string];
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ["", ""]
+     */
     defaultValue?: readonly [string, string];
+    /**
+     * 未填写或未选择时的提示内容。
+     * @defaultValue ["开始日期", "结束日期"]
+     */
     placeholder?: readonly [string, string];
+    /**
+     * 全局分隔符，可传入图标或文字
+     * @defaultValue "→"
+     */
     separator?: ReactNode;
+    /** 预设候选值或快捷选项集合。 */
     presets?: readonly DateRangePickerPreset[];
+    /** 日期区间允许的最大天数。 */
     maxRangeDays?: number;
     /** 允许单独保留起点或终点；需要点击确定提交未完整的范围。 */
     allowEmpty?: readonly [boolean, boolean];
     /** 锁定指定端点，编辑和清空时保留其值。 */
     endpointDisabled?: readonly [boolean, boolean];
+    /** 日期区间选择过程中的暂存值变化时调用。 */
     onCalendarChange?: (value: readonly [string, string]) => void;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     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;
 }
 
+/** 类型与日期区间组合选择的值类型。 */
 interface SelectDateRangeValue {
+    /** 选择指定项，或日期类型选择器的配置。 */
     select: SelectValue;
+    /** 是否启用范围选择，或指定选择范围。 */
     range: readonly [string, string];
 }
+/** 类型与日期区间组合选择的属性配置。 */
 interface SelectDateRangeProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 可供用户选择的候选项列表。 */
     options: readonly SelectOption[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: SelectDateRangeValue;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: SelectDateRangeValue;
+    /**
+     * 选择器占位内容
+     * @defaultValue "请选择类型"
+     */
     selectPlaceholder?: ReactNode;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
     /** 左侧选择器宽度，数字单位为 px；右侧日期范围自动填充剩余宽度。 */
     selectWidth?: CSSProperties["width"];
+    /**
+     * 开始和结束日期占位内容
+     * @defaultValue ["开始日期", "结束日期"]
+     */
     rangePlaceholder?: readonly [string, string];
+    /**
+     * 日期类型选择器的无障碍名称。
+     * @defaultValue "选择类型"
+     */
     selectAriaLabel?: string;
+    /**
+     * 日期区间控件的无障碍名称。
+     * @defaultValue "日期范围"
+     */
     rangeAriaLabel?: string;
+    /** 预设候选值或快捷选项集合。 */
     presets?: readonly DateRangePickerPreset[];
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: SelectDateRangeValue) => void;
 }
+/** 类型与日期区间组合选择组件。 */
 declare function SelectDateRange({ options, value, defaultValue, selectPlaceholder, placeholderMode, selectWidth, rangePlaceholder, selectAriaLabel, rangeAriaLabel, presets, size: sizeProp, status, disabled, onChange, className, style, ...props }: SelectDateRangeProps): react.JSX.Element;
 
 export { DatePicker as D, SelectDateRange as S, type DatePickerDisabledInfo as a, type DatePickerPreset as b, type DatePickerProps as c, type DatePickerShowTime as d, type DatePickerType as e, type DatePickerValue as f, type DateRangePickerPreset as g, type DateRangePickerProps as h, type SelectDateRangeProps as i, type SelectDateRangeValue as j };