lingee-ui 0.0.21 → 0.0.22

package/dist/index.d.mts

@@ -12,10 +12,11 @@ export { Input, InputProps, InputShape, InputSize } from './input/index.mjs';
 export { T as Textarea, a as TextareaAutoSizeConfig, b as TextareaProps } from './index-CZhoE8dw.mjs';
 export { ToastConfig, ToastGlobalConfig, ToastType, toast } from './toast/index.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { T as TagProps } from './index-B0J-mUew.mjs';
+export { a as TagPresetColor, b as TagShape, c as TagSize, d as TagVariant, e as Tree, f as TreeAllowDropOptions, g as TreeCheckInfo, h as TreeDropInfo, i as TreeExpandAction, j as TreeExpandInfo, k as TreeFieldNames, l as TreeIndentGuide, m as TreeNodeAction, n as TreeNodeData, o as TreeNodeExtra, p as TreeNodeExtraRenderContext, q as TreeNodeItemPresentation, r as TreeNodeState, s as TreeNodeTag, t as TreeProps, u as TreeSelectInfo, v as TreeSize } from './index-B0J-mUew.mjs';
 import { L as LgSize } from './index-B5SLxsZP.mjs';
 export { a as LgShape, b as LgVariant } from './index-B5SLxsZP.mjs';
 import { SvgIconProps } from 'lingee-icon';
-export { Tree, TreeAllowDropOptions, TreeCheckInfo, TreeDropInfo, TreeExpandAction, TreeExpandInfo, TreeFieldNames, TreeIndentGuide, TreeNodeData, TreeNodeState, TreeProps, TreeSelectInfo, TreeSize } from './tree/index.mjs';
 import { FormInstance as FormInstance$1, Rule } from 'rc-field-form/es/interface';
 export { Rule } from 'rc-field-form/es/interface';
 import { ClassValue } from 'clsx';
@@ -27,6 +28,22 @@ import 'class-variance-authority/types';
  * - `sm` 小型 —— 13px 文字，默认尖括号分隔
  */
 type BreadcrumbSize = "sm" | "md";
+/**
+ * 宽度不足时的处理策略：
+ * - `ellipsis` 收缩省略（默认）—— 首项最先省略、最少保留一个字，其次中间项，最后当前页；
+ *   `maxItems` 折叠出的省略号始终完整，不参与收缩
+ * - `scroll` 横向滚动 —— 全部层级完整展示、不折叠，溢出时两端出现箭头
+ */
+type BreadcrumbOverflow = "ellipsis" | "scroll";
+/** 滚动细节配置，仅 `overflow="scroll"` 下有意义 */
+interface BreadcrumbScrollOptions {
+    /** 箭头显示策略：`true` 溢出即显示 / `"hover"` 悬浮或键盘聚焦时显示 / `false` 不显示，默认 `true` */
+    arrows?: boolean | "hover";
+    /** 点击箭头单次滚动距离（px），默认 200 */
+    step?: number;
+    /** 是否显示边缘渐隐，默认 `true` */
+    fade?: boolean;
+}
 interface BreadcrumbItem {
     /** 唯一标识 */
     key: string;
@@ -61,13 +78,19 @@ interface BreadcrumbProps {
      *
      * 折叠后保留首项与末尾若干项，可见单元总数（含省略号）等于该值。
      * 小于 3 时不折叠 —— 首项、省略号、末项三者缺一，折叠就失去意义。
+     *
+     * `overflow="scroll"` 下不生效：滚动模式承诺完整展示全部层级。
      */
     maxItems?: number;
-    /** 单项文字最大宽度（px），超出显示省略号 */
+    /** 单项文字最大宽度（px），超出显示省略号。`overflow="scroll"` 下不生效 */
     itemMaxWidth?: number;
+    /** 宽度不足时的处理策略，默认 `ellipsis` */
+    overflow?: BreadcrumbOverflow;
+    /** 滚动细节配置，仅 `overflow="scroll"` 生效 */
+    scrollOptions?: BreadcrumbScrollOptions;
     /** 传入后在最前面显示返回箭头，点击触发 */
     onBack?: () => void;
-    /** 自定义内容，传入时忽略 `items` */
+    /** 自定义内容，传入时忽略 `items`（`overflow` 同样不生效） */
     children?: ReactNode;
     /** 自定义类名 */
     className?: string;
@@ -199,6 +222,9 @@ declare const zhCN: {
         back: string;
         /** nav 的无障碍标签，屏幕阅读器用于播报导航区域用途 */
         label: string;
+        /** overflow="scroll" 两端箭头的提示与无障碍标签 */
+        scrollLeft: string;
+        scrollRight: string;
     };
     Select: {
         loading: string;
@@ -386,6 +412,8 @@ declare const enUS: {
         more: string;
         back: string;
         label: string;
+        scrollLeft: string;
+        scrollRight: string;
     };
     Select: {
         loading: string;
@@ -566,43 +594,9 @@ declare function useComponentLocale<K extends keyof Omit<Locale, "locale">>(comp
  */
 declare function useSite(): LingeeSite | undefined;
 
-/** 预设语义色 */
-type TagPresetColor = "primary" | "info" | "success" | "warning" | "danger" | "amber" | "yellow" | "cyan" | "purple";
-/**
- * 视觉变体
- * - tint：纯色浅底，通用标记场景
- * - gradient：渐变浅底，用于提示类徽标（警告 / 建议 / 提示）
- * - glow：渐变底 + 光斑装饰，用于等级类徽标（钻石 / 黄金 / 铂金）
- */
-type TagVariant = "tint" | "gradient" | "glow";
-/** 标签尺寸 */
-type TagSize = LgSize;
-/** 标签圆角形状（仅 variant="tint" 生效，其余变体圆角由变体规范决定） */
-type TagShape = "pill" | "rounded";
-interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
-    /** 色彩：预设语义色 或 任意 CSS 色值字符串，默认 "info" */
-    color?: TagPresetColor | (string & {});
-    /** 视觉变体，默认 "tint" */
-    variant?: TagVariant;
-    /** 尺寸，默认 "md"（sm: 20px, md: 24px, lg: 32px） */
-    size?: TagSize;
-    /** 圆角形状，默认 "pill"（pill: 999px, rounded: 8px） */
-    shape?: TagShape;
-    /** 前缀图标（尺寸由组件统一控制，无需自行设置宽高） */
-    icon?: ReactNode;
-    /** 自定义背景（覆盖默认背景，支持渐变等任意 CSS background 值） */
-    background?: string;
-    /** 是否可关闭（显示关闭按钮） */
-    closable?: boolean;
-    /** 关闭回调 */
-    onClose?: (e: MouseEvent<HTMLSpanElement>) => void;
-    /** 子内容（文字、图标自由组合） */
-    children?: ReactNode;
-}
-
 /**
  * Tag 标签组件
- * 支持预设语义色、自定义色值、渐变 / 光斑变体、前缀图标、可关闭等能力
+ * 支持预设语义色、自定义色值、文字 / 实底 / 描边 / 渐变 / 光斑变体、前缀图标、可关闭等能力
  */
 declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLSpanElement>>;
 
@@ -4155,4 +4149,4 @@ declare const Carousel: CarouselComponent;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbOverflow, type BreadcrumbProps, type BreadcrumbScrollOptions, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, TagProps, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };

package/dist/index.d.ts

@@ -12,10 +12,11 @@ export { Input, InputProps, InputShape, InputSize } from './input/index.js';
 export { T as Textarea, a as TextareaAutoSizeConfig, b as TextareaProps } from './index-CZhoE8dw.js';
 export { ToastConfig, ToastGlobalConfig, ToastType, toast } from './toast/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { T as TagProps } from './index-Dmm11UAd.js';
+export { a as TagPresetColor, b as TagShape, c as TagSize, d as TagVariant, e as Tree, f as TreeAllowDropOptions, g as TreeCheckInfo, h as TreeDropInfo, i as TreeExpandAction, j as TreeExpandInfo, k as TreeFieldNames, l as TreeIndentGuide, m as TreeNodeAction, n as TreeNodeData, o as TreeNodeExtra, p as TreeNodeExtraRenderContext, q as TreeNodeItemPresentation, r as TreeNodeState, s as TreeNodeTag, t as TreeProps, u as TreeSelectInfo, v as TreeSize } from './index-Dmm11UAd.js';
 import { L as LgSize } from './index-B5SLxsZP.js';
 export { a as LgShape, b as LgVariant } from './index-B5SLxsZP.js';
 import { SvgIconProps } from 'lingee-icon';
-export { Tree, TreeAllowDropOptions, TreeCheckInfo, TreeDropInfo, TreeExpandAction, TreeExpandInfo, TreeFieldNames, TreeIndentGuide, TreeNodeData, TreeNodeState, TreeProps, TreeSelectInfo, TreeSize } from './tree/index.js';
 import { FormInstance as FormInstance$1, Rule } from 'rc-field-form/es/interface';
 export { Rule } from 'rc-field-form/es/interface';
 import { ClassValue } from 'clsx';
@@ -27,6 +28,22 @@ import 'class-variance-authority/types';
  * - `sm` 小型 —— 13px 文字，默认尖括号分隔
  */
 type BreadcrumbSize = "sm" | "md";
+/**
+ * 宽度不足时的处理策略：
+ * - `ellipsis` 收缩省略（默认）—— 首项最先省略、最少保留一个字，其次中间项，最后当前页；
+ *   `maxItems` 折叠出的省略号始终完整，不参与收缩
+ * - `scroll` 横向滚动 —— 全部层级完整展示、不折叠，溢出时两端出现箭头
+ */
+type BreadcrumbOverflow = "ellipsis" | "scroll";
+/** 滚动细节配置，仅 `overflow="scroll"` 下有意义 */
+interface BreadcrumbScrollOptions {
+    /** 箭头显示策略：`true` 溢出即显示 / `"hover"` 悬浮或键盘聚焦时显示 / `false` 不显示，默认 `true` */
+    arrows?: boolean | "hover";
+    /** 点击箭头单次滚动距离（px），默认 200 */
+    step?: number;
+    /** 是否显示边缘渐隐，默认 `true` */
+    fade?: boolean;
+}
 interface BreadcrumbItem {
     /** 唯一标识 */
     key: string;
@@ -61,13 +78,19 @@ interface BreadcrumbProps {
      *
      * 折叠后保留首项与末尾若干项，可见单元总数（含省略号）等于该值。
      * 小于 3 时不折叠 —— 首项、省略号、末项三者缺一，折叠就失去意义。
+     *
+     * `overflow="scroll"` 下不生效：滚动模式承诺完整展示全部层级。
      */
     maxItems?: number;
-    /** 单项文字最大宽度（px），超出显示省略号 */
+    /** 单项文字最大宽度（px），超出显示省略号。`overflow="scroll"` 下不生效 */
     itemMaxWidth?: number;
+    /** 宽度不足时的处理策略，默认 `ellipsis` */
+    overflow?: BreadcrumbOverflow;
+    /** 滚动细节配置，仅 `overflow="scroll"` 生效 */
+    scrollOptions?: BreadcrumbScrollOptions;
     /** 传入后在最前面显示返回箭头，点击触发 */
     onBack?: () => void;
-    /** 自定义内容，传入时忽略 `items` */
+    /** 自定义内容，传入时忽略 `items`（`overflow` 同样不生效） */
     children?: ReactNode;
     /** 自定义类名 */
     className?: string;
@@ -199,6 +222,9 @@ declare const zhCN: {
         back: string;
         /** nav 的无障碍标签，屏幕阅读器用于播报导航区域用途 */
         label: string;
+        /** overflow="scroll" 两端箭头的提示与无障碍标签 */
+        scrollLeft: string;
+        scrollRight: string;
     };
     Select: {
         loading: string;
@@ -386,6 +412,8 @@ declare const enUS: {
         more: string;
         back: string;
         label: string;
+        scrollLeft: string;
+        scrollRight: string;
     };
     Select: {
         loading: string;
@@ -566,43 +594,9 @@ declare function useComponentLocale<K extends keyof Omit<Locale, "locale">>(comp
  */
 declare function useSite(): LingeeSite | undefined;
 
-/** 预设语义色 */
-type TagPresetColor = "primary" | "info" | "success" | "warning" | "danger" | "amber" | "yellow" | "cyan" | "purple";
-/**
- * 视觉变体
- * - tint：纯色浅底，通用标记场景
- * - gradient：渐变浅底，用于提示类徽标（警告 / 建议 / 提示）
- * - glow：渐变底 + 光斑装饰，用于等级类徽标（钻石 / 黄金 / 铂金）
- */
-type TagVariant = "tint" | "gradient" | "glow";
-/** 标签尺寸 */
-type TagSize = LgSize;
-/** 标签圆角形状（仅 variant="tint" 生效，其余变体圆角由变体规范决定） */
-type TagShape = "pill" | "rounded";
-interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
-    /** 色彩：预设语义色 或 任意 CSS 色值字符串，默认 "info" */
-    color?: TagPresetColor | (string & {});
-    /** 视觉变体，默认 "tint" */
-    variant?: TagVariant;
-    /** 尺寸，默认 "md"（sm: 20px, md: 24px, lg: 32px） */
-    size?: TagSize;
-    /** 圆角形状，默认 "pill"（pill: 999px, rounded: 8px） */
-    shape?: TagShape;
-    /** 前缀图标（尺寸由组件统一控制，无需自行设置宽高） */
-    icon?: ReactNode;
-    /** 自定义背景（覆盖默认背景，支持渐变等任意 CSS background 值） */
-    background?: string;
-    /** 是否可关闭（显示关闭按钮） */
-    closable?: boolean;
-    /** 关闭回调 */
-    onClose?: (e: MouseEvent<HTMLSpanElement>) => void;
-    /** 子内容（文字、图标自由组合） */
-    children?: ReactNode;
-}
-
 /**
  * Tag 标签组件
- * 支持预设语义色、自定义色值、渐变 / 光斑变体、前缀图标、可关闭等能力
+ * 支持预设语义色、自定义色值、文字 / 实底 / 描边 / 渐变 / 光斑变体、前缀图标、可关闭等能力
  */
 declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLSpanElement>>;
 
@@ -4155,4 +4149,4 @@ declare const Carousel: CarouselComponent;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbOverflow, type BreadcrumbProps, type BreadcrumbScrollOptions, type BreadcrumbSize, ButtonProps, Carousel, type CarouselApi, type CarouselDotsPlacement, CarouselItem, type CarouselItemProps, type CarouselProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type ComponentConfig, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfig, type DialogConfirmOptions, type DialogHostModal, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, type DropdownEllipsisTooltip, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownStatus, type DropdownStatusProps, type DropdownStatusText, type DropdownStatusType, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, EllipsisTooltip, type EllipsisTooltipProps, Empty, EmptyCard, type EmptyCardAlign, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FeedbackAttachment, type FeedbackFileWallItem, type FeedbackHistoryDetail, type FeedbackHistoryItem, type FeedbackReply, type FeedbackSimilarItem, type FeedbackStatus, type FeedbackTabKey, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, HostModalPage, type HostModalPageProps, type HostToastLevel, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, InfiniteScroll, type InfiniteScrollProps, type InfiniteScrollTarget, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, DEFAULT_TABS as PERSON_PICKER_DEFAULT_TABS, ENTITY_TYPE_ORDER as PERSON_PICKER_TYPE_ORDER, Pagination, type PaginationProps, type PaginationVariant, PersonPicker, PersonPickerPanel, type PersonPickerPanelProps, type PersonPickerProps, type PickerChangeInfo, type PickerEntity, type PickerEntityType, type PickerExtra, type PickerGroup, type PickerMode, type PickerOrgPathItem, type PickerPaneData, type PickerSection, type PickerSelectedCount, type PickerState, type PickerTabChangeContext, type PickerTabKey, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, SidebarAuthImage, type SidebarAuthImageProps, type SidebarCaretPlacement, type SidebarCaretTone, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFeedbackAttachmentRow, type SidebarFeedbackAttachmentRowProps, SidebarFeedbackDetail, type SidebarFeedbackDetailProps, SidebarFeedbackField, type SidebarFeedbackFieldProps, SidebarFeedbackFileWall, type SidebarFeedbackFileWallProps, SidebarFeedbackHistoryItem, type SidebarFeedbackHistoryItemProps, SidebarFeedbackHistoryPanel, type SidebarFeedbackHistoryPanelProps, SidebarFeedbackModal, type SidebarFeedbackModalProps, SidebarFeedbackSimilarItem, type SidebarFeedbackSimilarItemProps, SidebarFeedbackSubmitPanel, type SidebarFeedbackSubmitPanelProps, SidebarFolderNode, type SidebarFolderNodeProps, SidebarFolderSection, type SidebarFolderSectionProps, type SidebarFolderStatus, type SidebarFolderStatusText, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarFooterUser, type SidebarFooterUserProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarStickyHeader, type SidebarStickyHeaderProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, type TableStatusText, type TableStatusType, Tag, TagProps, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, TooltipProps, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, type UsePickerStateOptions, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, entityKey as personPickerEntityKey, useComponentConfig, useComponentLocale, useLocale, usePickerState as usePersonPickerState, useSite, zhCN };