@sia.soul/sia-react-ui 0.1.20 → 0.1.22

package/dist/index.js

@@ -79,7 +79,7 @@ import {
   Watermark,
   message,
   notification
-} from "./chunk-3RWL67CK.js";
+} from "./chunk-7RNS52YG.js";
 import {
   TextArea
 } from "./chunk-YT6E3X2K.js";
@@ -89,12 +89,12 @@ import {
 import {
   RichTextContent,
   RichTextEditor
-} from "./chunk-I3EF5SF2.js";
+} from "./chunk-RWGSZW32.js";
 import {
   DatePicker,
   SelectDateRange,
   TimePanel
-} from "./chunk-LO3BUBWU.js";
+} from "./chunk-VN6PIPP7.js";
 import {
   Checkbox,
   FloatingScrollbarProvider,
@@ -109,7 +109,7 @@ import {
   Tree,
   useOverlayLifecycle,
   useScrollbarProximity
-} from "./chunk-4HB6GC24.js";
+} from "./chunk-3TRRBMXY.js";
 import {
   Dropdown,
   FILLED_ICON_NAMES,
@@ -120,7 +120,7 @@ import {
   PopupPortal,
   Segmented,
   Steps
-} from "./chunk-SUMXP2SF.js";
+} from "./chunk-KLI65JVD.js";
 import {
   Button
 } from "./chunk-TZGUBGA4.js";
@@ -183,6 +183,7 @@ var DEFAULT_PAGE_SIZE_OPTIONS = [10, 25, 50, 100, 200, 500, 1e3, 2e3, 5e3];
 function Pagination({
   size: sizeProp,
   total = 0,
+  currentPageCount,
   current,
   defaultCurrent = 1,
   pageSize,
@@ -209,6 +210,7 @@ function Pagination({
   const loading = refreshing ?? internalRefreshing;
   const sizes = [...new Set([...pageSizeOptions, size].filter((value) => value > 0))].sort((a, b) => a - b);
   const range = safeTotal ? [(safePage - 1) * size + 1, Math.min(safeTotal, safePage * size)] : [0, 0];
+  const pageCount = Math.max(0, currentPageCount ?? (safeTotal ? range[1] - range[0] + 1 : 0));
   if (hideOnSinglePage && totalPages <= 1) return null;
   function change(nextPage, nextSize = size) {
     const nextTotalPages = Math.max(1, Math.ceil(safeTotal / nextSize));
@@ -232,6 +234,11 @@ function Pagination({
     }
   }
   return /* @__PURE__ */ jsxs2("nav", { className: `sia-pagination sia-pagination--${controlSize} ${className}`.trim(), "aria-label": "\u5206\u9875", ...props, children: [
+    /* @__PURE__ */ jsxs2("span", { className: "sia-pagination__current-count", "aria-live": "polite", children: [
+      "\u5F53\u524D\u9875 ",
+      pageCount,
+      " \u6761"
+    ] }),
     showSizeChanger ? /* @__PURE__ */ jsxs2("div", { className: "sia-pagination__size", children: [
       /* @__PURE__ */ jsx2("span", { children: "\u6BCF\u9875\u663E\u793A" }),
       /* @__PURE__ */ jsx2(
@@ -561,7 +568,10 @@ function SpaceRoot({
     split !== void 0 && index < items.length - 1 ? /* @__PURE__ */ jsx4("span", { className: "sia-space__split", children: split }) : null
   ] }, index)) });
 }
-var Space = Object.assign(SpaceRoot, { Compact: SpaceCompact });
+var Space = Object.assign(SpaceRoot, {
+  /** 紧凑布局容器，将相邻控件组合为连续的按钮或输入组。 */
+  Compact: SpaceCompact
+});
 function Divider({
   orientation = "horizontal",
   variant = "solid",
@@ -834,7 +844,10 @@ function SplitterRoot({
     )];
   }) });
 }
-var Splitter = Object.assign(SplitterRoot, { Panel: SplitterPanel });
+var Splitter = Object.assign(SplitterRoot, {
+  /** Splitter 中的可调整大小面板。 */
+  Panel: SplitterPanel
+});
 
 // src/components/ToolPanel.tsx
 import { useId, useLayoutEffect, useRef as useRef3, useState as useState5 } from "react";
@@ -1384,7 +1397,9 @@ function openDrawer(config) {
   return handle;
 }
 var Drawer2 = Object.assign(DrawerRoot, {
+  /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
   open: openDrawer,
+  /** 关闭由此 API 打开的所有弹层。 */
   destroyAll() {
     [...drawerHandles].forEach((handle) => handle.destroy());
   }
@@ -1788,9 +1803,13 @@ function FormErrorList({ errors = [] }) {
   return errors.length ? /* @__PURE__ */ jsx9("div", { className: "sia-form-error-list", children: errors.map((error, index) => /* @__PURE__ */ jsx9("div", { children: error }, index)) }) : null;
 }
 var Form = Object.assign(FormRoot, {
+  /** 表单字段，负责字段值绑定、校验和标签布局。 */
   Item: FormItem,
+  /** 动态表单列表，提供字段索引以及新增、删除、移动操作。 */
   List: FormList,
+  /** 显示表单错误文本集合。 */
   ErrorList: FormErrorList,
+  /** 创建或复用表单实例，返回单元素元组 [form]。 */
   useForm
 });
 
@@ -1869,7 +1888,12 @@ function RadioGroup({
     children
   ] }) }) });
 }
-var Radio2 = Object.assign(RadioRoot, { Button: RadioButton, Group: RadioGroup });
+var Radio2 = Object.assign(RadioRoot, {
+  /** 组合主操作按钮与下拉菜单的按钮组件。 */
+  Button: RadioButton,
+  /** 组合多个子项并统一管理布局或选择状态。 */
+  Group: RadioGroup
+});
 
 // src/components/Slider.tsx
 import { useState as useState7 } from "react";
@@ -4652,7 +4676,7 @@ function TableCellContent({ children, ellipsis, title }) {
       layouts.forEach((layout) => layout.removeAttribute("data-table-inline-layout"));
     };
   }, [children, ellipsis, customContent]);
-  return /* @__PURE__ */ jsx20("div", { ref, className: "sia-table__cell-content", title, "data-custom-content": customContent || void 0, "data-content-overflow": ellipsis && customContent && overflowing || void 0, children });
+  return /* @__PURE__ */ jsx20("div", { ref, className: "sia-table__cell-content", "data-custom-content": customContent || void 0, "data-content-overflow": ellipsis && customContent && overflowing || void 0, children: title ? /* @__PURE__ */ jsx20(Tooltip, { title, className: "sia-table__cell-tooltip", children: /* @__PURE__ */ jsx20("span", { children }) }) : children });
 }
 
 // src/components/Table/Table.tsx
@@ -4814,6 +4838,7 @@ function isInteractiveTableTarget(target) {
 function createCellSelectionPlugin(options = {}) {
   let dragMode = null;
   let dragAnchor = null;
+  let textCell = null;
   let headerDragAnchorKey = null;
   let snapshotCache = null;
   let latestContext = null;
@@ -5115,12 +5140,17 @@ function createCellSelectionPlugin(options = {}) {
         return;
       }
       if (!isSelectable(row, column, context)) return;
-      event.preventDefault();
       window.getSelection()?.removeAllRanges();
       focusTable(event.currentTarget);
       const address = { rowKey: row.key, columnKey: column.key };
-      dragAnchor = event.shiftKey && context.state.range ? context.state.range.anchor : address;
-      dragMode = "cells";
+      const extendRange = event.shiftKey && context.state.range;
+      dragAnchor = extendRange ? extendRange.anchor : address;
+      dragMode = extendRange ? "cells" : "text";
+      textCell = extendRange ? null : event.currentTarget;
+      if (extendRange) {
+        event.preventDefault();
+        window.getSelection()?.removeAllRanges();
+      }
       setSelection(context, { anchor: dragAnchor, focus: address });
     },
     onCellPointerMove(row, column, event, context) {
@@ -5128,6 +5158,7 @@ function createCellSelectionPlugin(options = {}) {
       if ((event.buttons & 1) === 0) {
         dragMode = null;
         dragAnchor = null;
+        textCell = null;
         return;
       }
       if (dragMode === "rows") {
@@ -5137,6 +5168,12 @@ function createCellSelectionPlugin(options = {}) {
         return;
       }
       if (!isSelectable(row, column, context)) return;
+      if (dragMode === "text") {
+        if (sameCellAddress(dragAnchor, { rowKey: row.key, columnKey: column.key })) return;
+        dragMode = "cells";
+        textCell = null;
+        focusTable(event.currentTarget);
+      }
       event.preventDefault();
       window.getSelection()?.removeAllRanges();
       setSelection(context, {
@@ -5170,14 +5207,29 @@ function createCellSelectionPlugin(options = {}) {
     },
     onMount() {
       const stopDragging = () => {
+        constrainTextSelection();
         dragMode = null;
         dragAnchor = null;
+        textCell = null;
         headerDragAnchorKey = null;
       };
+      const constrainTextSelection = () => {
+        if (!dragMode) return;
+        const selection = window.getSelection();
+        if (!selection || selection.isCollapsed) return;
+        if (dragMode !== "text" || !textCell?.contains(selection.anchorNode) || !textCell.contains(selection.focusNode)) {
+          selection.removeAllRanges();
+        }
+      };
+      const handleSelectStart = (event) => {
+        if (dragMode && dragMode !== "text") event.preventDefault();
+      };
       const handleCopy = (event) => {
         const context = latestContext;
         if (options.copyable === false || !context || !activeRoot || !activeRoot.contains(document.activeElement) || isInteractiveTableTarget(document.activeElement))
           return;
+        const selection = window.getSelection();
+        if (selection && !selection.isCollapsed && selection.toString()) return;
         const text = copyText(context);
         if (!text) return;
         event.preventDefault();
@@ -5185,11 +5237,18 @@ function createCellSelectionPlugin(options = {}) {
         options.onCopy?.(text, selectedCells(context));
       };
       window.addEventListener("pointerup", stopDragging);
+      window.addEventListener("pointercancel", stopDragging);
       window.addEventListener("blur", stopDragging);
+      document.addEventListener("selectionchange", constrainTextSelection);
+      document.addEventListener("selectstart", handleSelectStart);
       document.addEventListener("copy", handleCopy);
       return () => {
+        stopDragging();
         window.removeEventListener("pointerup", stopDragging);
+        window.removeEventListener("pointercancel", stopDragging);
         window.removeEventListener("blur", stopDragging);
+        document.removeEventListener("selectionchange", constrainTextSelection);
+        document.removeEventListener("selectstart", handleSelectStart);
         document.removeEventListener("copy", handleCopy);
       };
     },
@@ -5921,6 +5980,7 @@ function createPaginationPlugin(options = {}) {
         Pagination,
         {
           className: "sia-table__pagination",
+          currentPageCount: context.rows.length,
           current: page.current,
           pageSize: page.pageSize,
           pageSizeOptions: options.pageSizeOptions ?? DEFAULT_PAGE_SIZE_OPTIONS,
@@ -6689,7 +6749,6 @@ function ColumnSettingPanel({
                           "span",
                           {
                             className: "sia-table-settings__name",
-                            title: labels.get(item.key) ?? item.key,
                             children: labels.get(item.key) ?? item.key
                           }
                         ),
@@ -6961,7 +7020,6 @@ function ToolbarItems({
         danger: item.danger,
         icon: item.icon,
         disabled,
-        title: typeof item.label === "string" ? item.label : void 0,
         onClick: () => void item.onClick?.(context),
         children: item.label
       },
@@ -7233,7 +7291,7 @@ var TableBodyRow = memo(function TableBodyRow2({
               TableCellContent,
               {
                 ellipsis: column.ellipsis !== false,
-                title: column.showTitle !== false && column.ellipsis !== false && typeof value === "string" ? value : void 0,
+                title: column.showTitle === true && column.ellipsis !== false && typeof value === "string" ? value : void 0,
                 children: pluginCellProps.content !== void 0 ? pluginCellProps.content : column.render ? column.render(value, row.record, row.sourceIndex, { row, rowIndex, column }) : value
               }
             )
@@ -7658,7 +7716,7 @@ function TableInner(props, ref) {
       const fixed = normalizeFixed(column.fixed);
       const fixedEdgeClass = fixed === "left" && column.key === leftFixedEdgeKey ? " sia-table__cell--fixed-left-edge" : fixed === "right" && column.key === rightFixedEdgeKey ? " sia-table__cell--fixed-right-edge" : "";
       const autoWidthClass = column.autoWidth ? " sia-table__cell--auto-width" : "";
-      return /* @__PURE__ */ jsx22("td", { "data-column-key": column.key, className: `sia-table__cell sia-table__cell--${column.align ?? "left"} sia-table__summary-cell${isLabel ? " sia-table__summary-cell--label" : ""}${fixed ? ` sia-table__cell--fixed sia-table__cell--fixed-${fixed}` : ""}${fixedEdgeClass}${autoWidthClass}`, style: getFixedStyle(column), children: isLabel ? /* @__PURE__ */ jsx22("span", { className: "sia-table__summary-label", title: typeof content === "string" ? content : void 0, children: content }) : content }, column.key);
+      return /* @__PURE__ */ jsx22("td", { "data-column-key": column.key, className: `sia-table__cell sia-table__cell--${column.align ?? "left"} sia-table__summary-cell${isLabel ? " sia-table__summary-cell--label" : ""}${fixed ? ` sia-table__cell--fixed sia-table__cell--fixed-${fixed}` : ""}${fixedEdgeClass}${autoWidthClass}`, style: getFixedStyle(column), children: isLabel ? /* @__PURE__ */ jsx22("span", { className: "sia-table__summary-label", children: content }) : content }, column.key);
     }) }, summary.key);
   }
   return /* @__PURE__ */ jsxs21(
@@ -7884,19 +7942,33 @@ var ThemeSwitch = forwardRef6(function ThemeSwitch2({
 
 // src/theme.ts
 var SIA_THEME = {
+  /** 主色。 */
   colorPrimary: "#1677ff",
+  /** 主色的悬停色。 */
   colorPrimaryHover: "#4096ff",
+  /** 主色的按下色。 */
   colorPrimaryActive: "#0958d9",
+  /** 主要文本颜色。 */
   colorText: "#1f1f1f",
+  /** 次要文本颜色。 */
   colorTextSecondary: "#666666",
+  /** 页面背景颜色。 */
   colorBackground: "#f5f7fa",
+  /** 组件表面颜色。 */
   colorSurface: "#ffffff",
+  /** 默认边框颜色。 */
   colorBorder: "#d9d9d9",
+  /** 默认圆角半径，单位为像素。 */
   borderRadius: 6,
+  /** 默认控件高度，单位为像素。 */
   controlHeight: 32,
+  /** 默认布局间距，单位为像素。 */
   spacing: 16,
+  /** 默认字号，单位为像素。 */
   fontSize: 16,
+  /** 小号文字尺寸，单位为像素。 */
   fontSizeSmall: 14,
+  /** 大号文字尺寸，单位为像素。 */
   fontSizeLarge: 18
 };
 function applySiaTheme(mode, target = document.documentElement) {
@@ -8304,7 +8376,7 @@ function QueryForm({
               {
                 className: "sia-query-form__field",
                 hidden: collapsed && index >= Math.min(limit, fittingCount),
-                style: entry.width !== void 0 ? { flexBasis: entry.width, width: entry.width } : void 0,
+                style: entry.width !== void 0 ? { "--sia-query-item-width": typeof entry.width === "number" ? `${entry.width}px` : entry.width } : void 0,
                 children: entry.content
               },
               entry.key

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 {