lingee-ui 0.0.13 → 0.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/dist/{chunk-M37T4ADR.mjs → chunk-BIETJXHD.mjs} +1 -1
  2. package/dist/chunk-FHQEJ42C.js +1 -0
  3. package/dist/chunk-G4FASWRJ.mjs +1 -0
  4. package/dist/{chunk-LSZ4P7R5.js → chunk-GLNNJIRF.js} +1 -1
  5. package/dist/{chunk-6QCL57T5.mjs → chunk-HJ7XGNWS.mjs} +1 -1
  6. package/dist/chunk-IFHC5A33.mjs +1 -0
  7. package/dist/{chunk-TL6FYFGR.js → chunk-MIVVBEBP.js} +1 -1
  8. package/dist/{chunk-XOVQPZCB.js → chunk-WYTTL6TA.js} +1 -1
  9. package/dist/chunk-X65SV4WZ.js +1 -0
  10. package/dist/{chunk-56AGGSSV.mjs → chunk-YLMME3Z2.mjs} +1 -1
  11. package/dist/index.css +1 -1
  12. package/dist/index.d.mts +104 -1
  13. package/dist/index.d.ts +104 -1
  14. package/dist/index.js +2 -2
  15. package/dist/index.mjs +2 -2
  16. package/dist/input/index.css +1 -1
  17. package/dist/input/index.js +1 -1
  18. package/dist/input/index.mjs +1 -1
  19. package/dist/popover/index.js +1 -1
  20. package/dist/popover/index.mjs +1 -1
  21. package/dist/tabs/index.css +1 -1
  22. package/dist/tabs/index.js +1 -1
  23. package/dist/tabs/index.mjs +1 -1
  24. package/dist/toast/index.css +1 -1
  25. package/dist/toast/index.js +1 -1
  26. package/dist/toast/index.mjs +1 -1
  27. package/dist/tree/index.css +1 -1
  28. package/dist/tree/index.js +1 -1
  29. package/dist/tree/index.mjs +1 -1
  30. package/package.json +1 -1
  31. package/skill/AGENTS-SNIPPET.md +2 -2
  32. package/skill/SKILL.md +5 -5
  33. package/skill/VERSION.json +3 -3
  34. package/skill/references/components/dialog.md +13 -0
  35. package/skill/references/components/sidebar.md +33 -2
  36. package/skill/references/icons.md +3 -2
  37. package/skill/references/setup.md +1 -1
  38. package/skill/references/tokens.md +1 -1
  39. package/dist/chunk-DHCCF3XI.mjs +0 -1
  40. package/dist/chunk-FTEVUZKX.js +0 -1
  41. package/dist/chunk-LBNA6G3N.js +0 -1
  42. package/dist/chunk-N524EGAL.mjs +0 -1
package/dist/index.d.mts CHANGED
@@ -244,6 +244,14 @@ declare const zhCN: {
244
244
  /** 错误态传入 onRetry 后,固定追加在 description 之后的重试引导 */
245
245
  retry: string;
246
246
  };
247
+ Sidebar: {
248
+ expand: string;
249
+ collapse: string;
250
+ /** 文件夹三态占位的兜底文案,业务有更贴切说法时用 statusText 覆盖 */
251
+ loading: string;
252
+ empty: string;
253
+ loadError: string;
254
+ };
247
255
  };
248
256
 
249
257
  /** 语言包类型,由 zh-CN 推导结构 */
@@ -383,6 +391,13 @@ declare const enUS: {
383
391
  Empty: {
384
392
  retry: string;
385
393
  };
394
+ Sidebar: {
395
+ expand: string;
396
+ collapse: string;
397
+ loading: string;
398
+ empty: string;
399
+ loadError: string;
400
+ };
386
401
  };
387
402
 
388
403
  interface ComponentConfig {
@@ -1964,6 +1979,67 @@ interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivEle
1964
1979
  className?: string;
1965
1980
  style?: CSSProperties;
1966
1981
  }
1982
+ /**
1983
+ * 文件夹取数状态。
1984
+ *
1985
+ * 合成单一联合值而非三个布尔:三态各自渲染占位时,两端极易在图标、
1986
+ * 高度、留白上写出不同结果,切换时产生跳动。收成一个值后占位形态只有一份。
1987
+ */
1988
+ type SidebarFolderStatus = "loading" | "empty" | "error" | "ready";
1989
+ /** 三态占位文案。组件库不持有业务文案,缺省时回退全局 locale 的 Sidebar 段 */
1990
+ interface SidebarFolderStatusText {
1991
+ loading: ReactNode;
1992
+ empty: ReactNode;
1993
+ error: ReactNode;
1994
+ }
1995
+ /** FolderNode 与 FolderSection 共有的状态区契约 */
1996
+ interface SidebarFolderStatusOwnProps {
1997
+ /** 取数状态,默认 "ready"(直接渲染 children) */
1998
+ status?: SidebarFolderStatus;
1999
+ /** 覆盖三态文案,未传的字段回退 locale */
2000
+ statusText?: Partial<SidebarFolderStatusText>;
2001
+ /** 重试回调,仅 status="error" 时生效 */
2002
+ onRetry?: () => void;
2003
+ }
2004
+ interface SidebarFolderNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">, SidebarFolderStatusOwnProps {
2005
+ /** 文件夹名称 */
2006
+ name: ReactNode;
2007
+ /**
2008
+ * 覆盖左侧图标。缺省时内置文件夹图标并随展开态切换,
2009
+ * 消费方无需自行处理两态图标与其配色
2010
+ */
2011
+ icon?: ReactNode;
2012
+ expanded?: boolean;
2013
+ onToggle?: () => void;
2014
+ /** 头部悬停操作区插槽(新建、更多菜单等) */
2015
+ actions?: ReactNode;
2016
+ /** 操作区常显。菜单打开时置 true,避免指针移到浮层后按钮消失 */
2017
+ actionsVisible?: boolean;
2018
+ /** 头部高亮态 */
2019
+ active?: boolean;
2020
+ /** 展开区内容,仅 status="ready" 时渲染 */
2021
+ children?: ReactNode;
2022
+ /** 箭头无障碍标签,缺省回退 locale */
2023
+ expandLabel?: string;
2024
+ collapseLabel?: string;
2025
+ className?: string;
2026
+ style?: CSSProperties;
2027
+ }
2028
+ interface SidebarFolderSectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">, SidebarFolderStatusOwnProps {
2029
+ /** 区块标题 */
2030
+ title: ReactNode;
2031
+ /** 区块折叠态 */
2032
+ expanded?: boolean;
2033
+ onToggle?: () => void;
2034
+ /** 标题行右侧操作区插槽(新建文件夹等) */
2035
+ actions?: ReactNode;
2036
+ /** 操作区常显,语义与 GroupHeader.actionsVisible 一致 */
2037
+ actionsVisible?: boolean;
2038
+ /** 文件夹列表,仅 status="ready" 且展开时渲染 */
2039
+ children?: ReactNode;
2040
+ className?: string;
2041
+ style?: CSSProperties;
2042
+ }
1967
2043
  interface SidebarFooterUserProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
1968
2044
  /** 头像插槽 */
1969
2045
  avatar?: ReactNode;
@@ -2143,6 +2219,31 @@ declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarL
2143
2219
  */
2144
2220
  declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
2145
2221
 
2222
+ /**
2223
+ * Sidebar.FolderNode — 文件夹节点
2224
+ *
2225
+ * 在 CollapsibleListItem 之上补两件事,二者都是各消费方原本要各写一遍的:
2226
+ * 1. 内置随展开态切换的文件夹图标,并把图标透明度提到 1
2227
+ * (文件夹图标是层级标识,降透明度后与会话行难以区分)
2228
+ * 2. 展开区四态收敛为单一 status,占位形态只有一份
2229
+ *
2230
+ * 不含请求、菜单项与业务文案:菜单以 actions 插槽传入,
2231
+ * 子项以 children 插槽传入(会话行需挂 menu / indicator,用数据结构表达不划算)。
2232
+ */
2233
+ declare const SidebarFolderNode: React__default.ForwardRefExoticComponent<SidebarFolderNodeProps & React__default.RefAttributes<HTMLDivElement>>;
2234
+
2235
+ /**
2236
+ * Sidebar.FolderSection — 文件夹区块
2237
+ *
2238
+ * GroupHeader 与区块级四态的固定组合。本身无新视觉,价值在于
2239
+ * 让区块占位与 FolderNode 内部占位共用同一形态 —— 分开写时两处
2240
+ * 留白与图标很难保持一致。
2241
+ *
2242
+ * 折叠时不渲染内容(包含占位):收起状态下连占位一起藏起,
2243
+ * 才是「折叠」的预期表现。
2244
+ */
2245
+ declare const SidebarFolderSection: React__default.ForwardRefExoticComponent<SidebarFolderSectionProps & React__default.RefAttributes<HTMLElement>>;
2246
+
2146
2247
  /**
2147
2248
  * Sidebar.FooterUser — 底栏左侧用户区(头像 + 名称 + 后缀徽标 + 展开箭头)
2148
2249
  *
@@ -2331,6 +2432,8 @@ declare const Sidebar: {
2331
2432
  GroupHeader: React$1.ForwardRefExoticComponent<SidebarGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
2332
2433
  ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
2333
2434
  CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
2435
+ FolderNode: React$1.ForwardRefExoticComponent<SidebarFolderNodeProps & React$1.RefAttributes<HTMLDivElement>>;
2436
+ FolderSection: React$1.ForwardRefExoticComponent<SidebarFolderSectionProps & React$1.RefAttributes<HTMLElement>>;
2334
2437
  Footer: React$1.ForwardRefExoticComponent<SidebarFooterProps & React$1.RefAttributes<HTMLDivElement>>;
2335
2438
  FooterUser: React$1.ForwardRefExoticComponent<SidebarFooterUserProps & React$1.RefAttributes<HTMLDivElement>>;
2336
2439
  FooterMenuStaticRow: React$1.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3333,4 +3436,4 @@ declare const Carousel: CarouselComponent;
3333
3436
  */
3334
3437
  declare function cn(...inputs: ClassValue[]): string;
3335
3438
 
3336
- 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, 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 };
3439
+ 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 CHANGED
@@ -244,6 +244,14 @@ declare const zhCN: {
244
244
  /** 错误态传入 onRetry 后,固定追加在 description 之后的重试引导 */
245
245
  retry: string;
246
246
  };
247
+ Sidebar: {
248
+ expand: string;
249
+ collapse: string;
250
+ /** 文件夹三态占位的兜底文案,业务有更贴切说法时用 statusText 覆盖 */
251
+ loading: string;
252
+ empty: string;
253
+ loadError: string;
254
+ };
247
255
  };
248
256
 
249
257
  /** 语言包类型,由 zh-CN 推导结构 */
@@ -383,6 +391,13 @@ declare const enUS: {
383
391
  Empty: {
384
392
  retry: string;
385
393
  };
394
+ Sidebar: {
395
+ expand: string;
396
+ collapse: string;
397
+ loading: string;
398
+ empty: string;
399
+ loadError: string;
400
+ };
386
401
  };
387
402
 
388
403
  interface ComponentConfig {
@@ -1964,6 +1979,67 @@ interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivEle
1964
1979
  className?: string;
1965
1980
  style?: CSSProperties;
1966
1981
  }
1982
+ /**
1983
+ * 文件夹取数状态。
1984
+ *
1985
+ * 合成单一联合值而非三个布尔:三态各自渲染占位时,两端极易在图标、
1986
+ * 高度、留白上写出不同结果,切换时产生跳动。收成一个值后占位形态只有一份。
1987
+ */
1988
+ type SidebarFolderStatus = "loading" | "empty" | "error" | "ready";
1989
+ /** 三态占位文案。组件库不持有业务文案,缺省时回退全局 locale 的 Sidebar 段 */
1990
+ interface SidebarFolderStatusText {
1991
+ loading: ReactNode;
1992
+ empty: ReactNode;
1993
+ error: ReactNode;
1994
+ }
1995
+ /** FolderNode 与 FolderSection 共有的状态区契约 */
1996
+ interface SidebarFolderStatusOwnProps {
1997
+ /** 取数状态,默认 "ready"(直接渲染 children) */
1998
+ status?: SidebarFolderStatus;
1999
+ /** 覆盖三态文案,未传的字段回退 locale */
2000
+ statusText?: Partial<SidebarFolderStatusText>;
2001
+ /** 重试回调,仅 status="error" 时生效 */
2002
+ onRetry?: () => void;
2003
+ }
2004
+ interface SidebarFolderNodeProps extends Omit<HTMLAttributes<HTMLDivElement>, "title">, SidebarFolderStatusOwnProps {
2005
+ /** 文件夹名称 */
2006
+ name: ReactNode;
2007
+ /**
2008
+ * 覆盖左侧图标。缺省时内置文件夹图标并随展开态切换,
2009
+ * 消费方无需自行处理两态图标与其配色
2010
+ */
2011
+ icon?: ReactNode;
2012
+ expanded?: boolean;
2013
+ onToggle?: () => void;
2014
+ /** 头部悬停操作区插槽(新建、更多菜单等) */
2015
+ actions?: ReactNode;
2016
+ /** 操作区常显。菜单打开时置 true,避免指针移到浮层后按钮消失 */
2017
+ actionsVisible?: boolean;
2018
+ /** 头部高亮态 */
2019
+ active?: boolean;
2020
+ /** 展开区内容,仅 status="ready" 时渲染 */
2021
+ children?: ReactNode;
2022
+ /** 箭头无障碍标签,缺省回退 locale */
2023
+ expandLabel?: string;
2024
+ collapseLabel?: string;
2025
+ className?: string;
2026
+ style?: CSSProperties;
2027
+ }
2028
+ interface SidebarFolderSectionProps extends Omit<HTMLAttributes<HTMLElement>, "title">, SidebarFolderStatusOwnProps {
2029
+ /** 区块标题 */
2030
+ title: ReactNode;
2031
+ /** 区块折叠态 */
2032
+ expanded?: boolean;
2033
+ onToggle?: () => void;
2034
+ /** 标题行右侧操作区插槽(新建文件夹等) */
2035
+ actions?: ReactNode;
2036
+ /** 操作区常显,语义与 GroupHeader.actionsVisible 一致 */
2037
+ actionsVisible?: boolean;
2038
+ /** 文件夹列表,仅 status="ready" 且展开时渲染 */
2039
+ children?: ReactNode;
2040
+ className?: string;
2041
+ style?: CSSProperties;
2042
+ }
1967
2043
  interface SidebarFooterUserProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
1968
2044
  /** 头像插槽 */
1969
2045
  avatar?: ReactNode;
@@ -2143,6 +2219,31 @@ declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarL
2143
2219
  */
2144
2220
  declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
2145
2221
 
2222
+ /**
2223
+ * Sidebar.FolderNode — 文件夹节点
2224
+ *
2225
+ * 在 CollapsibleListItem 之上补两件事,二者都是各消费方原本要各写一遍的:
2226
+ * 1. 内置随展开态切换的文件夹图标,并把图标透明度提到 1
2227
+ * (文件夹图标是层级标识,降透明度后与会话行难以区分)
2228
+ * 2. 展开区四态收敛为单一 status,占位形态只有一份
2229
+ *
2230
+ * 不含请求、菜单项与业务文案:菜单以 actions 插槽传入,
2231
+ * 子项以 children 插槽传入(会话行需挂 menu / indicator,用数据结构表达不划算)。
2232
+ */
2233
+ declare const SidebarFolderNode: React__default.ForwardRefExoticComponent<SidebarFolderNodeProps & React__default.RefAttributes<HTMLDivElement>>;
2234
+
2235
+ /**
2236
+ * Sidebar.FolderSection — 文件夹区块
2237
+ *
2238
+ * GroupHeader 与区块级四态的固定组合。本身无新视觉,价值在于
2239
+ * 让区块占位与 FolderNode 内部占位共用同一形态 —— 分开写时两处
2240
+ * 留白与图标很难保持一致。
2241
+ *
2242
+ * 折叠时不渲染内容(包含占位):收起状态下连占位一起藏起,
2243
+ * 才是「折叠」的预期表现。
2244
+ */
2245
+ declare const SidebarFolderSection: React__default.ForwardRefExoticComponent<SidebarFolderSectionProps & React__default.RefAttributes<HTMLElement>>;
2246
+
2146
2247
  /**
2147
2248
  * Sidebar.FooterUser — 底栏左侧用户区(头像 + 名称 + 后缀徽标 + 展开箭头)
2148
2249
  *
@@ -2331,6 +2432,8 @@ declare const Sidebar: {
2331
2432
  GroupHeader: React$1.ForwardRefExoticComponent<SidebarGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
2332
2433
  ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
2333
2434
  CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
2435
+ FolderNode: React$1.ForwardRefExoticComponent<SidebarFolderNodeProps & React$1.RefAttributes<HTMLDivElement>>;
2436
+ FolderSection: React$1.ForwardRefExoticComponent<SidebarFolderSectionProps & React$1.RefAttributes<HTMLElement>>;
2334
2437
  Footer: React$1.ForwardRefExoticComponent<SidebarFooterProps & React$1.RefAttributes<HTMLDivElement>>;
2335
2438
  FooterUser: React$1.ForwardRefExoticComponent<SidebarFooterUserProps & React$1.RefAttributes<HTMLDivElement>>;
2336
2439
  FooterMenuStaticRow: React$1.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -3333,4 +3436,4 @@ declare const Carousel: CarouselComponent;
3333
3436
  */
3334
3437
  declare function cn(...inputs: ClassValue[]): string;
3335
3438
 
3336
- 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, 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 };
3439
+ 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 };