lingee-ui 0.0.12 → 0.0.14

package/dist/index.d.mts

@@ -244,13 +244,28 @@ declare const zhCN: {
         /** 错误态传入 onRetry 后，固定追加在 description 之后的重试引导 */
         retry: string;
     };
+    Sidebar: {
+        expand: string;
+        collapse: string;
+        /** 文件夹三态占位的兜底文案，业务有更贴切说法时用 statusText 覆盖 */
+        loading: string;
+        empty: string;
+        loadError: string;
+    };
 };
 
 /** 语言包类型，由 zh-CN 推导结构 */
 type Locale = typeof zhCN;
+/** Dialog 的全局基线配置，单个 Dialog 的同名 Props 优先。 */
+interface DialogConfig {
+    /** 遮罩层 z-index；弹窗内容自动使用该值 + 1 */
+    zIndex?: number;
+}
 interface LingeeProviderProps {
     /** 语言包，默认中文 */
     locale?: Locale;
+    /** Dialog 组件的全局基线配置 */
+    dialog?: DialogConfig;
     /**
      * 运行宿主标识，默认不传。
      *
@@ -376,8 +391,21 @@ declare const enUS: {
     Empty: {
         retry: string;
     };
+    Sidebar: {
+        expand: string;
+        collapse: string;
+        loading: string;
+        empty: string;
+        loadError: string;
+    };
 };
 
+interface ComponentConfig {
+    dialog: DialogConfig;
+}
+/** 获取声明式组件当前生效的组件级配置。 */
+declare function useComponentConfig(): ComponentConfig;
+
 /**
  * 组件库根 Provider
  *
@@ -393,7 +421,7 @@ declare const enUS: {
  * </LingeeProvider>
  * ```
  */
-declare function LingeeProvider({ locale, site, children }: LingeeProviderProps): react_jsx_runtime.JSX.Element;
+declare function LingeeProvider({ locale, site, dialog, children }: LingeeProviderProps): react_jsx_runtime.JSX.Element;
 declare namespace LingeeProvider {
     var displayName: string;
 }
@@ -577,7 +605,7 @@ interface DialogProps {
     maskClassName?: string;
     /** 关闭后是否销毁子节点，默认 true */
     destroyOnHidden?: boolean;
-    /** 自定义 z-index */
+    /** 自定义 z-index；优先于 LingeeProvider 的 dialog.zIndex */
     zIndex?: number;
     /** 弹窗面板总高上限，默认 640px */
     maxHeight?: number | string;
@@ -633,7 +661,18 @@ interface DialogConfirmOptions extends Omit<DialogProps, "open" | "onOpenChange"
 declare const Dialog$1: React__default.FC<DialogProps>;
 
 declare function confirm(options: DialogConfirmOptions): Promise<boolean>;
-/** 命令式关闭当前 confirm 弹窗（不 resolve，用于外部强制关闭兜底） */
+/**
+ * 强制关闭确认弹窗：当前一项与队列中排队的全部按 false 结算。
+ *
+ * 为什么连排队项一起清掉，而不是只关当前一项：调用方的意图是「确保某个弹窗不在了」，
+ * 而队列化之后，目标弹窗可能还排在队里没显示。若只关 activeTask，就会关掉前面那个
+ * 无关的弹窗，而目标弹窗随后照样弹出来 —— 与调用方意图正好相反。
+ *
+ * 队列化前 `destroy()` 是无条件清场，语义确定；这里保持一致。
+ * 需要「只关自己那一个」的场景应当由调用方持有句柄，而不是依赖这个全局兜底。
+ *
+ * 与旧实现一致，不调用 onCancel，只结算 false。
+ */
 declare function closeConfirm(): void;
 
 /** 当前页面是否运行在宿主弹窗内（含端侧 webview 与浏览器 iframe 两种承载） */
@@ -1940,6 +1979,67 @@ interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivEle
     className?: string;
     style?: CSSProperties;
 }
+/**
+ * 文件夹取数状态。
+ *
+ * 合成单一联合值而非三个布尔：三态各自渲染占位时，两端极易在图标、
+ * 高度、留白上写出不同结果，切换时产生跳动。收成一个值后占位形态只有一份。
+ */
+type SidebarFolderStatus = "loading" | "empty" | "error" | "ready";
+/** 三态占位文案。组件库不持有业务文案，缺省时回退全局 locale 的 Sidebar 段 */
+interface SidebarFolderStatusText {
+    loading: ReactNode;
+    empty: ReactNode;
+    error: ReactNode;
+}
+/** FolderNode 与 FolderSection 共有的状态区契约 */
+interface SidebarFolderStatusOwnProps {
+    /** 取数状态，默认 "ready"（直接渲染 children） */
+    status?: SidebarFolderStatus;
+    /** 覆盖三态文案，未传的字段回退 locale */
+    statusText?: Partial<SidebarFolderStatusText>;
+    /** 重试回调，仅 status="error" 时生效 */
+    onRetry?: () => void;
+}
+interface SidebarFolderNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">, SidebarFolderStatusOwnProps {
+    /** 文件夹名称 */
+    name: ReactNode;
+    /**
+     * 覆盖左侧图标。缺省时内置文件夹图标并随展开态切换，
+     * 消费方无需自行处理两态图标与其配色
+     */
+    icon?: ReactNode;
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 头部悬停操作区插槽（新建、更多菜单等） */
+    actions?: ReactNode;
+    /** 操作区常显。菜单打开时置 true，避免指针移到浮层后按钮消失 */
+    actionsVisible?: boolean;
+    /** 头部高亮态 */
+    active?: boolean;
+    /** 展开区内容，仅 status="ready" 时渲染 */
+    children?: ReactNode;
+    /** 箭头无障碍标签，缺省回退 locale */
+    expandLabel?: string;
+    collapseLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFolderSectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">, SidebarFolderStatusOwnProps {
+    /** 区块标题 */
+    title: ReactNode;
+    /** 区块折叠态 */
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 标题行右侧操作区插槽（新建文件夹等） */
+    actions?: ReactNode;
+    /** 操作区常显，语义与 GroupHeader.actionsVisible 一致 */
+    actionsVisible?: boolean;
+    /** 文件夹列表，仅 status="ready" 且展开时渲染 */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
 interface SidebarFooterUserProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** 头像插槽 */
     avatar?: ReactNode;
@@ -2119,6 +2219,31 @@ declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarL
  */
 declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Sidebar.FolderNode — 文件夹节点
+ *
+ * 在 CollapsibleListItem 之上补两件事，二者都是各消费方原本要各写一遍的：
+ *  1. 内置随展开态切换的文件夹图标，并把图标透明度提到 1
+ *     （文件夹图标是层级标识，降透明度后与会话行难以区分）
+ *  2. 展开区四态收敛为单一 status，占位形态只有一份
+ *
+ * 不含请求、菜单项与业务文案：菜单以 actions 插槽传入，
+ * 子项以 children 插槽传入（会话行需挂 menu / indicator，用数据结构表达不划算）。
+ */
+declare const SidebarFolderNode: React__default.ForwardRefExoticComponent<SidebarFolderNodeProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FolderSection — 文件夹区块
+ *
+ * GroupHeader 与区块级四态的固定组合。本身无新视觉，价值在于
+ * 让区块占位与 FolderNode 内部占位共用同一形态 —— 分开写时两处
+ * 留白与图标很难保持一致。
+ *
+ * 折叠时不渲染内容（包含占位）：收起状态下连占位一起藏起，
+ * 才是「折叠」的预期表现。
+ */
+declare const SidebarFolderSection: React__default.ForwardRefExoticComponent<SidebarFolderSectionProps & React__default.RefAttributes<HTMLElement>>;
+
 /**
  * Sidebar.FooterUser — 底栏左侧用户区（头像 + 名称 + 后缀徽标 + 展开箭头）
  *
@@ -2307,6 +2432,8 @@ declare const Sidebar: {
     GroupHeader: React$1.ForwardRefExoticComponent<SidebarGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
     ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
     CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    FolderNode: React$1.ForwardRefExoticComponent<SidebarFolderNodeProps & React$1.RefAttributes<HTMLDivElement>>;
+    FolderSection: React$1.ForwardRefExoticComponent<SidebarFolderSectionProps & React$1.RefAttributes<HTMLElement>>;
     Footer: React$1.ForwardRefExoticComponent<SidebarFooterProps & React$1.RefAttributes<HTMLDivElement>>;
     FooterUser: React$1.ForwardRefExoticComponent<SidebarFooterUserProps & React$1.RefAttributes<HTMLDivElement>>;
     FooterMenuStaticRow: React$1.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3309,4 +3436,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 CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, 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, 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, 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 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 };

package/dist/index.d.ts

@@ -244,13 +244,28 @@ declare const zhCN: {
         /** 错误态传入 onRetry 后，固定追加在 description 之后的重试引导 */
         retry: string;
     };
+    Sidebar: {
+        expand: string;
+        collapse: string;
+        /** 文件夹三态占位的兜底文案，业务有更贴切说法时用 statusText 覆盖 */
+        loading: string;
+        empty: string;
+        loadError: string;
+    };
 };
 
 /** 语言包类型，由 zh-CN 推导结构 */
 type Locale = typeof zhCN;
+/** Dialog 的全局基线配置，单个 Dialog 的同名 Props 优先。 */
+interface DialogConfig {
+    /** 遮罩层 z-index；弹窗内容自动使用该值 + 1 */
+    zIndex?: number;
+}
 interface LingeeProviderProps {
     /** 语言包，默认中文 */
     locale?: Locale;
+    /** Dialog 组件的全局基线配置 */
+    dialog?: DialogConfig;
     /**
      * 运行宿主标识，默认不传。
      *
@@ -376,8 +391,21 @@ declare const enUS: {
     Empty: {
         retry: string;
     };
+    Sidebar: {
+        expand: string;
+        collapse: string;
+        loading: string;
+        empty: string;
+        loadError: string;
+    };
 };
 
+interface ComponentConfig {
+    dialog: DialogConfig;
+}
+/** 获取声明式组件当前生效的组件级配置。 */
+declare function useComponentConfig(): ComponentConfig;
+
 /**
  * 组件库根 Provider
  *
@@ -393,7 +421,7 @@ declare const enUS: {
  * </LingeeProvider>
  * ```
  */
-declare function LingeeProvider({ locale, site, children }: LingeeProviderProps): react_jsx_runtime.JSX.Element;
+declare function LingeeProvider({ locale, site, dialog, children }: LingeeProviderProps): react_jsx_runtime.JSX.Element;
 declare namespace LingeeProvider {
     var displayName: string;
 }
@@ -577,7 +605,7 @@ interface DialogProps {
     maskClassName?: string;
     /** 关闭后是否销毁子节点，默认 true */
     destroyOnHidden?: boolean;
-    /** 自定义 z-index */
+    /** 自定义 z-index；优先于 LingeeProvider 的 dialog.zIndex */
     zIndex?: number;
     /** 弹窗面板总高上限，默认 640px */
     maxHeight?: number | string;
@@ -633,7 +661,18 @@ interface DialogConfirmOptions extends Omit<DialogProps, "open" | "onOpenChange"
 declare const Dialog$1: React__default.FC<DialogProps>;
 
 declare function confirm(options: DialogConfirmOptions): Promise<boolean>;
-/** 命令式关闭当前 confirm 弹窗（不 resolve，用于外部强制关闭兜底） */
+/**
+ * 强制关闭确认弹窗：当前一项与队列中排队的全部按 false 结算。
+ *
+ * 为什么连排队项一起清掉，而不是只关当前一项：调用方的意图是「确保某个弹窗不在了」，
+ * 而队列化之后，目标弹窗可能还排在队里没显示。若只关 activeTask，就会关掉前面那个
+ * 无关的弹窗，而目标弹窗随后照样弹出来 —— 与调用方意图正好相反。
+ *
+ * 队列化前 `destroy()` 是无条件清场，语义确定；这里保持一致。
+ * 需要「只关自己那一个」的场景应当由调用方持有句柄，而不是依赖这个全局兜底。
+ *
+ * 与旧实现一致，不调用 onCancel，只结算 false。
+ */
 declare function closeConfirm(): void;
 
 /** 当前页面是否运行在宿主弹窗内（含端侧 webview 与浏览器 iframe 两种承载） */
@@ -1940,6 +1979,67 @@ interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivEle
     className?: string;
     style?: CSSProperties;
 }
+/**
+ * 文件夹取数状态。
+ *
+ * 合成单一联合值而非三个布尔：三态各自渲染占位时，两端极易在图标、
+ * 高度、留白上写出不同结果，切换时产生跳动。收成一个值后占位形态只有一份。
+ */
+type SidebarFolderStatus = "loading" | "empty" | "error" | "ready";
+/** 三态占位文案。组件库不持有业务文案，缺省时回退全局 locale 的 Sidebar 段 */
+interface SidebarFolderStatusText {
+    loading: ReactNode;
+    empty: ReactNode;
+    error: ReactNode;
+}
+/** FolderNode 与 FolderSection 共有的状态区契约 */
+interface SidebarFolderStatusOwnProps {
+    /** 取数状态，默认 "ready"（直接渲染 children） */
+    status?: SidebarFolderStatus;
+    /** 覆盖三态文案，未传的字段回退 locale */
+    statusText?: Partial<SidebarFolderStatusText>;
+    /** 重试回调，仅 status="error" 时生效 */
+    onRetry?: () => void;
+}
+interface SidebarFolderNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">, SidebarFolderStatusOwnProps {
+    /** 文件夹名称 */
+    name: ReactNode;
+    /**
+     * 覆盖左侧图标。缺省时内置文件夹图标并随展开态切换，
+     * 消费方无需自行处理两态图标与其配色
+     */
+    icon?: ReactNode;
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 头部悬停操作区插槽（新建、更多菜单等） */
+    actions?: ReactNode;
+    /** 操作区常显。菜单打开时置 true，避免指针移到浮层后按钮消失 */
+    actionsVisible?: boolean;
+    /** 头部高亮态 */
+    active?: boolean;
+    /** 展开区内容，仅 status="ready" 时渲染 */
+    children?: ReactNode;
+    /** 箭头无障碍标签，缺省回退 locale */
+    expandLabel?: string;
+    collapseLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFolderSectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">, SidebarFolderStatusOwnProps {
+    /** 区块标题 */
+    title: ReactNode;
+    /** 区块折叠态 */
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 标题行右侧操作区插槽（新建文件夹等） */
+    actions?: ReactNode;
+    /** 操作区常显，语义与 GroupHeader.actionsVisible 一致 */
+    actionsVisible?: boolean;
+    /** 文件夹列表，仅 status="ready" 且展开时渲染 */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
 interface SidebarFooterUserProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** 头像插槽 */
     avatar?: ReactNode;
@@ -2119,6 +2219,31 @@ declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarL
  */
 declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Sidebar.FolderNode — 文件夹节点
+ *
+ * 在 CollapsibleListItem 之上补两件事，二者都是各消费方原本要各写一遍的：
+ *  1. 内置随展开态切换的文件夹图标，并把图标透明度提到 1
+ *     （文件夹图标是层级标识，降透明度后与会话行难以区分）
+ *  2. 展开区四态收敛为单一 status，占位形态只有一份
+ *
+ * 不含请求、菜单项与业务文案：菜单以 actions 插槽传入，
+ * 子项以 children 插槽传入（会话行需挂 menu / indicator，用数据结构表达不划算）。
+ */
+declare const SidebarFolderNode: React__default.ForwardRefExoticComponent<SidebarFolderNodeProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FolderSection — 文件夹区块
+ *
+ * GroupHeader 与区块级四态的固定组合。本身无新视觉，价值在于
+ * 让区块占位与 FolderNode 内部占位共用同一形态 —— 分开写时两处
+ * 留白与图标很难保持一致。
+ *
+ * 折叠时不渲染内容（包含占位）：收起状态下连占位一起藏起，
+ * 才是「折叠」的预期表现。
+ */
+declare const SidebarFolderSection: React__default.ForwardRefExoticComponent<SidebarFolderSectionProps & React__default.RefAttributes<HTMLElement>>;
+
 /**
  * Sidebar.FooterUser — 底栏左侧用户区（头像 + 名称 + 后缀徽标 + 展开箭头）
  *
@@ -2307,6 +2432,8 @@ declare const Sidebar: {
     GroupHeader: React$1.ForwardRefExoticComponent<SidebarGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
     ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
     CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    FolderNode: React$1.ForwardRefExoticComponent<SidebarFolderNodeProps & React$1.RefAttributes<HTMLDivElement>>;
+    FolderSection: React$1.ForwardRefExoticComponent<SidebarFolderSectionProps & React$1.RefAttributes<HTMLElement>>;
     Footer: React$1.ForwardRefExoticComponent<SidebarFooterProps & React$1.RefAttributes<HTMLDivElement>>;
     FooterUser: React$1.ForwardRefExoticComponent<SidebarFooterUserProps & React$1.RefAttributes<HTMLDivElement>>;
     FooterMenuStaticRow: React$1.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3309,4 +3436,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 CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, 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, 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, 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 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 };