lingee-ui 0.0.14 → 0.0.15

package/dist/index.d.mts

@@ -1,12 +1,12 @@
-import { B as ButtonProps } from './index-7pb5YOcq.mjs';
-export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-7pb5YOcq.mjs';
+import { B as ButtonProps } from './index-89atTLPD.mjs';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-89atTLPD.mjs';
 import * as React$1 from 'react';
 import React__default, { ReactNode, CSSProperties, HTMLAttributes, MouseEvent, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { TooltipProps } from './tooltip/index.mjs';
 export { Tooltip, TooltipPlacement } from './tooltip/index.mjs';
 export { TabItem, Tabs, TabsOverflow, TabsProps, TabsScrollOptions, TabsSize, TabsVariant } from './tabs/index.mjs';
 import { PopoverContentProps } from './popover/index.mjs';
-export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverArrow, PopoverArrowProps, PopoverClose, PopoverCloseProps, PopoverContent, PopoverPlacement, PopoverProps, PopoverTrigger, PopoverTriggerProps } from './popover/index.mjs';
+export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverArrow, PopoverArrowProps, PopoverClose, PopoverCloseProps, PopoverContent, PopoverPlacement, PopoverProps, PopoverTrigger, PopoverTriggerAction, PopoverTriggerProps } from './popover/index.mjs';
 export { Switch, SwitchProps, SwitchSize } from './switch/index.mjs';
 export { Input, InputProps, InputShape, InputSize } from './input/index.mjs';
 export { Textarea, TextareaProps } from './textarea/index.mjs';
@@ -724,10 +724,22 @@ interface HostModalPageProps<P> {
      * 渲染函数收到 `close`，用于绘制自己的关闭按钮。
      *
      * 只传本属性不会让宿主去掉标题栏 —— 那由发起端的 `headless` 决定。
-     * 两处不匹配的后果：发起端开了而这里没传 → 弹窗没有任何关闭入口（只能点遮罩）；
+     * 两处不匹配的后果：发起端开了而这里没传 → 由内置关闭按钮兜住出口（见 `closable`）；
      * 这里传了而发起端没开 → 宿主标题栏与自绘头部上下叠两层。
      */
     header?: (close: (result?: unknown) => void) => React__default.ReactNode;
+    /**
+     * 是否渲染内置关闭按钮（面板右上角绝对定位）。
+     *
+     * 缺省按「宿主有没有提供关闭入口」自动判定，无需业务传值：
+     *  - 发起端开了 `headless`：宿主不画标题栏与关闭按钮，本组件补上内置按钮，
+     *    省去业务侧重复实现（设计稿常把关闭按钮画在内容区右上角，并不需要整个自绘头部）
+     *  - 发起端未开 `headless`：宿主标题栏自带关闭按钮，不再叠加
+     *  - 传了 `header`：自绘头部通常已含关闭入口，同样不叠加
+     *
+     * 显式传值可覆盖以上判定。
+     */
+    closable?: boolean;
     /** 附加到容器上的类名，用于控制内边距等业务样式 */
     className?: string;
 }
@@ -743,7 +755,7 @@ interface HostModalPageProps<P> {
  *   );
  * }
  */
-declare function HostModalPage<P = unknown>({ children, fallback, ready, header, className, }: HostModalPageProps<P>): react_jsx_runtime.JSX.Element | null;
+declare function HostModalPage<P = unknown>({ children, fallback, ready, header, closable, className, }: HostModalPageProps<P>): react_jsx_runtime.JSX.Element | null;
 declare namespace HostModalPage {
     var displayName: string;
 }
@@ -1571,6 +1583,16 @@ type EmptyCardStatus = "loading" | "empty" | "error";
 type EmptyCardVariant = "block" | "inline";
 /** 上下留白档位 */
 type EmptyCardSpacing = "none" | "normal" | "loose";
+/**
+ * 水平对齐。
+ * - center: 居中，区块级/页面级占位的默认形态
+ * - start: 左对齐，用于列表内嵌占位 —— 与上方列表项同一阅读起点，
+ *   居中会让一行小字悬在空白正中，与列表的阅读动线脱节
+ *
+ * 只负责对齐，不含缩进：对齐基准（列表项文字 / 分组标题）由所在容器决定，
+ * 组件无从得知，需要缩进时由消费方在外层补 padding。
+ */
+type EmptyCardAlign = "center" | "start";
 interface EmptyCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onClick" | "size"> {
     status: EmptyCardStatus;
     /** 描述文案。组件不内置文案，由消费方传入 */
@@ -1586,6 +1608,8 @@ interface EmptyCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"
     size?: EmptySize;
     variant?: EmptyCardVariant;
     spacing?: EmptyCardSpacing;
+    /** 水平对齐，默认 "center" */
+    align?: EmptyCardAlign;
     /**
      * 重试回调。仅 status="error" 时生效。
      * 传入后整体渲染为可点击按钮：带浅色底 + hover 反馈，
@@ -1857,6 +1881,14 @@ interface SidebarHeaderProps extends HTMLAttributes<HTMLDivElement> {
     className?: string;
     style?: CSSProperties;
 }
+interface SidebarStickyHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    /** 占满剩余宽度的主内容 */
+    children?: ReactNode;
+    /** 固定在右侧、不参与主内容压缩的操作区 */
+    actions?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
 interface SidebarTabItem {
     key: string;
     label: ReactNode;
@@ -1890,11 +1922,14 @@ interface SidebarCollapsibleNavItemChild {
     disabled?: boolean;
     onClick?: () => void;
 }
+type SidebarCaretTone = "muted" | "default";
 interface SidebarCollapsibleNavItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     icon?: ReactNode;
     label: ReactNode;
     /** 头部高亮态。内部会与子项 active 做互斥：任一子项 active 时头部不高亮 */
     active?: boolean;
+    /** 箭头视觉层级，default 保留语义色的完整不透明度 */
+    caretTone?: SidebarCaretTone;
     /** 受控展开态 */
     open?: boolean;
     /** 非受控初始展开态，open 传入时忽略 */
@@ -2161,6 +2196,13 @@ declare const SidebarRoot: React__default.ForwardRefExoticComponent<SidebarRootP
  */
 declare const SidebarHeader: React__default.ForwardRefExoticComponent<SidebarHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Sidebar.StickyHeader — 吸顶内容与右侧操作区的通用布局。
+ *
+ * 吸顶层必须作为滚动容器的直接子元素，才能相对该容器生效。
+ */
+declare const SidebarStickyHeader: React__default.ForwardRefExoticComponent<SidebarStickyHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+
 /**
  * Sidebar.TabBar — 侧边栏顶部分段页签
  *
@@ -2426,6 +2468,7 @@ declare function formatFileSize(bytes: number): string;
 declare const Sidebar: {
     Root: React$1.ForwardRefExoticComponent<SidebarRootProps & React$1.RefAttributes<HTMLDivElement>>;
     Header: React$1.ForwardRefExoticComponent<SidebarHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+    StickyHeader: React$1.ForwardRefExoticComponent<SidebarStickyHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
     TabBar: React$1.ForwardRefExoticComponent<SidebarTabBarProps & React$1.RefAttributes<HTMLDivElement>>;
     NavItem: React$1.ForwardRefExoticComponent<SidebarNavItemProps & React$1.RefAttributes<HTMLButtonElement>>;
     CollapsibleNavItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleNavItemProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3436,4 +3479,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, 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 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, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, Pagination, type PaginationProps, type PaginationVariant, 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, 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, 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, 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, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, useComponentConfig, useComponentLocale, useLocale, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, 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, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, Pagination, type PaginationProps, type PaginationVariant, 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, 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, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, useComponentConfig, useComponentLocale, useLocale, useSite, zhCN };

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import { B as ButtonProps } from './index-7pb5YOcq.js';
-export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-7pb5YOcq.js';
+import { B as ButtonProps } from './index-89atTLPD.js';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-89atTLPD.js';
 import * as React$1 from 'react';
 import React__default, { ReactNode, CSSProperties, HTMLAttributes, MouseEvent, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { TooltipProps } from './tooltip/index.js';
 export { Tooltip, TooltipPlacement } from './tooltip/index.js';
 export { TabItem, Tabs, TabsOverflow, TabsProps, TabsScrollOptions, TabsSize, TabsVariant } from './tabs/index.js';
 import { PopoverContentProps } from './popover/index.js';
-export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverArrow, PopoverArrowProps, PopoverClose, PopoverCloseProps, PopoverContent, PopoverPlacement, PopoverProps, PopoverTrigger, PopoverTriggerProps } from './popover/index.js';
+export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverArrow, PopoverArrowProps, PopoverClose, PopoverCloseProps, PopoverContent, PopoverPlacement, PopoverProps, PopoverTrigger, PopoverTriggerAction, PopoverTriggerProps } from './popover/index.js';
 export { Switch, SwitchProps, SwitchSize } from './switch/index.js';
 export { Input, InputProps, InputShape, InputSize } from './input/index.js';
 export { Textarea, TextareaProps } from './textarea/index.js';
@@ -724,10 +724,22 @@ interface HostModalPageProps<P> {
      * 渲染函数收到 `close`，用于绘制自己的关闭按钮。
      *
      * 只传本属性不会让宿主去掉标题栏 —— 那由发起端的 `headless` 决定。
-     * 两处不匹配的后果：发起端开了而这里没传 → 弹窗没有任何关闭入口（只能点遮罩）；
+     * 两处不匹配的后果：发起端开了而这里没传 → 由内置关闭按钮兜住出口（见 `closable`）；
      * 这里传了而发起端没开 → 宿主标题栏与自绘头部上下叠两层。
      */
     header?: (close: (result?: unknown) => void) => React__default.ReactNode;
+    /**
+     * 是否渲染内置关闭按钮（面板右上角绝对定位）。
+     *
+     * 缺省按「宿主有没有提供关闭入口」自动判定，无需业务传值：
+     *  - 发起端开了 `headless`：宿主不画标题栏与关闭按钮，本组件补上内置按钮，
+     *    省去业务侧重复实现（设计稿常把关闭按钮画在内容区右上角，并不需要整个自绘头部）
+     *  - 发起端未开 `headless`：宿主标题栏自带关闭按钮，不再叠加
+     *  - 传了 `header`：自绘头部通常已含关闭入口，同样不叠加
+     *
+     * 显式传值可覆盖以上判定。
+     */
+    closable?: boolean;
     /** 附加到容器上的类名，用于控制内边距等业务样式 */
     className?: string;
 }
@@ -743,7 +755,7 @@ interface HostModalPageProps<P> {
  *   );
  * }
  */
-declare function HostModalPage<P = unknown>({ children, fallback, ready, header, className, }: HostModalPageProps<P>): react_jsx_runtime.JSX.Element | null;
+declare function HostModalPage<P = unknown>({ children, fallback, ready, header, closable, className, }: HostModalPageProps<P>): react_jsx_runtime.JSX.Element | null;
 declare namespace HostModalPage {
     var displayName: string;
 }
@@ -1571,6 +1583,16 @@ type EmptyCardStatus = "loading" | "empty" | "error";
 type EmptyCardVariant = "block" | "inline";
 /** 上下留白档位 */
 type EmptyCardSpacing = "none" | "normal" | "loose";
+/**
+ * 水平对齐。
+ * - center: 居中，区块级/页面级占位的默认形态
+ * - start: 左对齐，用于列表内嵌占位 —— 与上方列表项同一阅读起点，
+ *   居中会让一行小字悬在空白正中，与列表的阅读动线脱节
+ *
+ * 只负责对齐，不含缩进：对齐基准（列表项文字 / 分组标题）由所在容器决定，
+ * 组件无从得知，需要缩进时由消费方在外层补 padding。
+ */
+type EmptyCardAlign = "center" | "start";
 interface EmptyCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onClick" | "size"> {
     status: EmptyCardStatus;
     /** 描述文案。组件不内置文案，由消费方传入 */
@@ -1586,6 +1608,8 @@ interface EmptyCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"
     size?: EmptySize;
     variant?: EmptyCardVariant;
     spacing?: EmptyCardSpacing;
+    /** 水平对齐，默认 "center" */
+    align?: EmptyCardAlign;
     /**
      * 重试回调。仅 status="error" 时生效。
      * 传入后整体渲染为可点击按钮：带浅色底 + hover 反馈，
@@ -1857,6 +1881,14 @@ interface SidebarHeaderProps extends HTMLAttributes<HTMLDivElement> {
     className?: string;
     style?: CSSProperties;
 }
+interface SidebarStickyHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    /** 占满剩余宽度的主内容 */
+    children?: ReactNode;
+    /** 固定在右侧、不参与主内容压缩的操作区 */
+    actions?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
 interface SidebarTabItem {
     key: string;
     label: ReactNode;
@@ -1890,11 +1922,14 @@ interface SidebarCollapsibleNavItemChild {
     disabled?: boolean;
     onClick?: () => void;
 }
+type SidebarCaretTone = "muted" | "default";
 interface SidebarCollapsibleNavItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
     icon?: ReactNode;
     label: ReactNode;
     /** 头部高亮态。内部会与子项 active 做互斥：任一子项 active 时头部不高亮 */
     active?: boolean;
+    /** 箭头视觉层级，default 保留语义色的完整不透明度 */
+    caretTone?: SidebarCaretTone;
     /** 受控展开态 */
     open?: boolean;
     /** 非受控初始展开态，open 传入时忽略 */
@@ -2161,6 +2196,13 @@ declare const SidebarRoot: React__default.ForwardRefExoticComponent<SidebarRootP
  */
 declare const SidebarHeader: React__default.ForwardRefExoticComponent<SidebarHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Sidebar.StickyHeader — 吸顶内容与右侧操作区的通用布局。
+ *
+ * 吸顶层必须作为滚动容器的直接子元素，才能相对该容器生效。
+ */
+declare const SidebarStickyHeader: React__default.ForwardRefExoticComponent<SidebarStickyHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+
 /**
  * Sidebar.TabBar — 侧边栏顶部分段页签
  *
@@ -2426,6 +2468,7 @@ declare function formatFileSize(bytes: number): string;
 declare const Sidebar: {
     Root: React$1.ForwardRefExoticComponent<SidebarRootProps & React$1.RefAttributes<HTMLDivElement>>;
     Header: React$1.ForwardRefExoticComponent<SidebarHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+    StickyHeader: React$1.ForwardRefExoticComponent<SidebarStickyHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
     TabBar: React$1.ForwardRefExoticComponent<SidebarTabBarProps & React$1.RefAttributes<HTMLDivElement>>;
     NavItem: React$1.ForwardRefExoticComponent<SidebarNavItemProps & React$1.RefAttributes<HTMLButtonElement>>;
     CollapsibleNavItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleNavItemProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3436,4 +3479,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, 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 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, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, Pagination, type PaginationProps, type PaginationVariant, 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, 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, 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, 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, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, useComponentConfig, useComponentLocale, useLocale, useSite, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, 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, LgSize, LingeeProvider, type LingeeProviderProps, type LingeeSite, type Locale, Pagination, type PaginationProps, type PaginationVariant, 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, 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, closeHostModal, cn, enUS, formatFileSize, getHostModalParams, isInHostModal, notifyHostModalReady, useComponentConfig, useComponentLocale, useLocale, useSite, zhCN };