lingee-ui 0.0.8 → 0.0.9

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 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 * 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, TabsProps, TabsSize, TabsVariant } from './tabs/index.js';
-export { Tooltip, TooltipPlacement, TooltipProps } from './tooltip/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 { Switch, SwitchProps, SwitchSize } from './switch/index.js';
@@ -9,8 +12,6 @@ export { Input, InputProps, InputShape, InputSize } from './input/index.js';
 export { Textarea, TextareaProps } from './textarea/index.js';
 export { ToastConfig, ToastGlobalConfig, ToastType, toast } from './toast/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
-import React__default, { ReactNode, HTMLAttributes, MouseEvent, CSSProperties, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { L as LgSize } from './index-B5SLxsZP.js';
 export { a as LgShape, b as LgVariant } from './index-B5SLxsZP.js';
 import { SvgIconProps } from 'lingee-icon';
@@ -20,6 +21,55 @@ export { Rule } from 'rc-field-form/es/interface';
 import { ClassValue } from 'clsx';
 import 'class-variance-authority/types';
 
+interface EllipsisTooltipProps extends Omit<TooltipProps, "children" | "content" | "open" | "onOpenChange" | "container"> {
+    /** 提示内容。通常与 children 相同，为空时不弹出 */
+    content?: ReactNode;
+    children?: ReactNode;
+    /**
+     * 容器标签。默认 span —— 可安全嵌入 button 等仅接受
+     * phrasing content 的元素内
+     */
+    as?: "span" | "div";
+    /**
+     * 是否自带单行省略样式，默认 true。
+     * 关闭后省略表现由消费方的 className 决定（如多行截断场景）
+     */
+    ellipsis?: boolean;
+    /**
+     * 触发阈值（0~1）。文本宽度超过 `容器宽度 × threshold` 时弹出，
+     * 默认 1 即真正溢出才弹。调小可在接近溢出时提前提示
+     */
+    threshold?: number;
+    /**
+     * 提示内容的最大字符数，超出截断并追加省略号，默认 2000。
+     * 超长文本会让提示浮层占据过大空间
+     */
+    maxLength?: number;
+    /**
+     * 祖先容器的 className。传入后提示浮层的最大宽度对齐该祖先宽度，
+     * 用于让提示不超出所在卡片/胶囊的视觉边界
+     */
+    anchorClassName?: string;
+    /**
+     * 浮层挂载容器。接收触发节点并返回容器 ——
+     * 用于在 overflow 裁剪的滚动容器内就地挂载
+     */
+    getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * EllipsisTooltip 省略提示
+ *
+ * 仅在文本真正被截断时才弹出提示 —— 无条件挂 Tooltip 会让未截断的文本
+ * 也弹出重复内容，形成干扰。
+ *
+ * 用受控 open 而非 Tooltip 的 disabled：disabled 时 Radix Root 不渲染，
+ * onOpenChange 不触发，就拿不到 hover 这个测量时机。
+ */
+declare const EllipsisTooltip: React__default.ForwardRefExoticComponent<EllipsisTooltipProps & React__default.RefAttributes<HTMLElement>>;
+
 /**
  * 中文语言包（默认语言）
  * 按组件名为 key 组织翻译文案
@@ -39,6 +89,9 @@ declare const zhCN: {
     };
     Dropdown: {
         clear: string;
+        loading: string;
+        loadError: string;
+        empty: string;
     };
     Tabs: {
         scrollLeft: string;
@@ -148,6 +201,9 @@ declare const enUS: {
     };
     Dropdown: {
         clear: string;
+        loading: string;
+        loadError: string;
+        empty: string;
     };
     Tabs: {
         scrollLeft: string;
@@ -511,6 +567,23 @@ interface DropdownLabelData {
 }
 /** items 快捷模式的数据项类型 */
 type DropdownItemData = DropdownMenuItemData | DropdownSeparatorData | DropdownLabelData;
+/** 面板三态。与 Empty.Card 的 status 同名同义 */
+type DropdownStatusType = "loading" | "empty" | "error";
+/** 三态文案覆盖。未提供的键回落到 locale 内置文案 */
+interface DropdownStatusText {
+    loading?: ReactNode;
+    empty?: ReactNode;
+    error?: ReactNode;
+}
+interface DropdownStatusProps {
+    status: DropdownStatusType;
+    /** 覆盖该状态的默认文案 */
+    description?: ReactNode;
+    /** 重试回调。仅 status="error" 时生效，传入后占位整体可点击 */
+    onRetry?: () => void;
+    /** 额外类名 */
+    className?: string;
+}
 interface DropdownProps {
     /** 子元素（Trigger + Content），或仅 Trigger 元素（配合 items 快捷模式） */
     children: ReactNode;
@@ -533,11 +606,22 @@ interface DropdownProps {
     contentProps?: Omit<DropdownContentProps, "children">;
     /** 当前选中的 item key 列表，匹配的项会显示勾选图标 */
     selectedKeys?: string[];
-    /** 加载中状态，为 true 时显示 loadingContent 或默认 loading */
+    /** 加载中状态，为 true 时面板显示加载占位 */
     loading?: boolean;
-    /** 自定义加载中渲染内容 */
+    /**
+     * 加载失败状态，为 true 时面板显示失败占位。
+     * 优先级低于 loading（重试期间应展示加载中而非上一次的失败）
+     */
+    loadError?: boolean;
+    /** 加载失败时的重试回调，传入后失败占位整体可点击 */
+    onRetry?: () => void;
+    /** 覆盖三态占位的默认文案，未传的键走 locale 内置文案 */
+    statusText?: DropdownStatusText;
+    /** 自定义加载中渲染内容，覆盖默认占位 */
     loadingContent?: ReactNode;
-    /** 自定义空态渲染内容（items 为空数组且非 loading 时显示） */
+    /** 自定义失败渲染内容，覆盖默认占位 */
+    errorContent?: ReactNode;
+    /** 自定义空态渲染内容（items 为空数组且非 loading / loadError 时显示） */
     emptyContent?: ReactNode;
     /**
      * 自定义面板渲染，参数 menu 为默认渲染的菜单项列表
@@ -664,6 +748,11 @@ interface DropdownSubTriggerProps {
     disabled?: boolean;
     /** 前置图标 */
     icon?: ReactNode;
+    /**
+     * 鼠标进入回调，在组件内部展开子菜单的逻辑之后执行。
+     * 用于「展开时才拉取数据」这类懒加载场景
+     */
+    onMouseEnter?: React__default.MouseEventHandler<HTMLDivElement>;
 }
 interface DropdownSubContentProps extends Pick<PopoverContentProps, "side" | "align" | "sideOffset" | "alignOffset" | "className" | "collisionPadding" | "container"> {
     /** 子菜单面板内容 */
@@ -708,7 +797,7 @@ interface DropdownButtonProps extends Omit<React__default.ButtonHTMLAttributes<H
 
 declare const DropdownButton: React__default.ForwardRefExoticComponent<DropdownButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
 
-declare function Dropdown({ children, open, defaultOpen, onOpenChange, modal, disabled, items, contentProps, selectedKeys, loading, loadingContent, emptyContent, dropdownRender, header, footer, }: DropdownProps): react_jsx_runtime.JSX.Element;
+declare function Dropdown({ children, open, defaultOpen, onOpenChange, modal, disabled, items, contentProps, selectedKeys, loading, loadError, onRetry, statusText, loadingContent, errorContent, emptyContent, dropdownRender, header, footer, }: DropdownProps): react_jsx_runtime.JSX.Element;
 declare namespace Dropdown {
     var displayName: string;
 }
@@ -729,6 +818,21 @@ declare function DropdownSeparator({ className }: DropdownSeparatorProps): react
 declare namespace DropdownSeparator {
     var displayName: string;
 }
+/**
+ * 面板内的加载 / 空 / 失败占位。
+ *
+ * 复用 Empty.Card 的默认块级形态（variant="block" + spacing="normal"）：
+ * 三态共用同一 min-height，面板在「加载中 → 有数据 / 空 / 失败」之间
+ * 切换时高度不变。不要压 spacing —— 去掉留白后图标与文字紧贴，
+ * 看起来会像行内轻量提示而非块级占位。
+ *
+ * 文案不内置在 Empty.Card 层，改由此处从 locale 取默认值，
+ * 消费方通过 description 覆盖，这样多语言无需每个调用点重复传参。
+ */
+declare function DropdownStatus({ status, description, onRetry, className }: DropdownStatusProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownStatus {
+    var displayName: string;
+}
 declare function DropdownGroup({ children }: DropdownGroupProps): react_jsx_runtime.JSX.Element;
 declare namespace DropdownGroup {
     var displayName: string;
@@ -1152,6 +1256,226 @@ declare const Empty: React__default.ForwardRefExoticComponent<EmptyProps & React
     Card: React__default.ForwardRefExoticComponent<EmptyCardProps & React__default.RefAttributes<HTMLDivElement>>;
 };
 
+/** 附件/截图元信息 */
+interface FeedbackAttachment {
+    name: string;
+    /** 文件大小（字节） */
+    size?: number;
+    /** 访问 URL（图片用于预览，附件用于下载） */
+    url?: string;
+    /** 是否图片：图片走缩略图预览，其余走附件卡片 */
+    isImage?: boolean;
+    /** MIME 或扩展名，用于取附件图标 */
+    fileType?: string;
+}
+/** 反馈处理状态 */
+type FeedbackStatus = "pending" | "replied";
+/** 历史列表项 */
+interface FeedbackHistoryItem {
+    id: string;
+    title: string;
+    status: FeedbackStatus;
+    /**
+     * 回复已读态。false = 有未读回复（画红点）；true = 已读；
+     * null/undefined = 未回复或后端未上线 —— 三态必须区分，
+     * 否则未回复的工单会全部亮红点
+     */
+    replyRead?: boolean | null;
+}
+/** 官方回复 */
+interface FeedbackReply {
+    replyContent?: string;
+    attachments?: FeedbackAttachment[];
+}
+/** 相似问题 */
+interface FeedbackSimilarItem {
+    id: string;
+    title: string;
+    description?: string;
+    voteCount: number;
+    voted?: boolean;
+    attachments?: FeedbackAttachment[];
+}
+/** 历史详情 */
+interface FeedbackHistoryDetail {
+    id: string;
+    description: string;
+    images?: FeedbackAttachment[];
+    attachments?: FeedbackAttachment[];
+    /** 是否允许读取当前对话信息，为真时展示告知卡片 */
+    allowSessionView?: boolean;
+    reply?: FeedbackReply;
+    /** 详情响应携带的是查看前的旧值，据此高亮「新回复」 */
+    replyRead?: boolean | null;
+    similar?: FeedbackSimilarItem[];
+}
+type FeedbackTabKey = "submit" | "history";
+interface SidebarFeedbackModalProps {
+    open: boolean;
+    /** 关闭请求。遮罩点击已禁用，仅右上角关闭按钮与取消触发 */
+    onClose: () => void;
+    activeTab: FeedbackTabKey;
+    onTabChange: (key: FeedbackTabKey) => void;
+    /** 提交页签文案 */
+    submitTabLabel: ReactNode;
+    /** 历史页签文案 */
+    historyTabLabel: ReactNode;
+    /** 历史页签是否显示未读红点 */
+    historyUnread?: boolean;
+    /** 关闭按钮无障碍标签 */
+    closeLabel?: string;
+    /** 提交面板内容 */
+    submitPanel?: ReactNode;
+    /**
+     * 历史面板内容。
+     * 首次切到历史页签后才挂载，避免无谓请求 —— 由消费方控制传入时机
+     */
+    historyPanel?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackSubmitPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 顶部提示条（会话内打开时的说明），传 null 不渲染 */
+    notice?: ReactNode;
+    /** 表单区内容：由 FeedbackField 组合 */
+    children?: ReactNode;
+    /** 底部按钮区 */
+    footer?: ReactNode;
+    /** 拖拽悬停态，驱动上传区高亮 */
+    dragOver?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+/** 表单字段容器 */
+interface SidebarFeedbackFieldProps extends HTMLAttributes<HTMLDivElement> {
+    label?: ReactNode;
+    /** 显示必填星号 */
+    required?: boolean;
+    /** 标签行右侧插槽（如横向翻页箭头） */
+    labelExtra?: ReactNode;
+    /** 字段下方灰色提示 */
+    hint?: ReactNode;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+/** 文件墙条目 */
+interface FeedbackFileWallItem {
+    uid: string;
+    /** 图片走缩略图、附件走图标卡片 */
+    kind: "image" | "attachment";
+    name: string;
+    size?: number;
+    /** 图片预览地址 */
+    url?: string;
+    /** 附件图标地址 */
+    iconUrl?: string;
+}
+interface SidebarFeedbackFileWallProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    items: FeedbackFileWallItem[];
+    /** 移除某项 */
+    onRemove?: (uid: string) => void;
+    /** 点击图片，用于外部预览 */
+    onPreview?: (uid: string) => void;
+    /** 是否显示「截图中」占位卡 */
+    capturing?: boolean;
+    /** 截图中文案 */
+    capturingText?: ReactNode;
+    /** 尾部添加区（通常是 Upload 触发器），达到数量上限时消费方不传 */
+    addSlot?: ReactNode;
+    /** 大小格式化，默认按 B/KB/MB 输出 */
+    formatSize?: (bytes: number) => string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackHistoryPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 左栏顶部工具区（搜索框） */
+    toolbar?: ReactNode;
+    /** 左栏列表内容 */
+    list?: ReactNode;
+    /** 右栏详情内容 */
+    detail?: ReactNode;
+    /** 列表滚动容器 ref，供无限滚动挂载 */
+    listRef?: React.Ref<HTMLDivElement>;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackHistoryItemProps extends Omit<HTMLAttributes<HTMLButtonElement>, "onSelect"> {
+    item: FeedbackHistoryItem;
+    selected?: boolean;
+    onSelect?: () => void;
+    /** 状态标签文案，由消费方按 status 提供 */
+    statusLabel: ReactNode;
+    /** 时间/关注数等元信息 */
+    meta?: ReactNode;
+    /** 未读红点无障碍标签 */
+    unreadLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackDetailProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title"> {
+    /** 标题（固定为「反馈描述」这类静态文案，由消费方传入） */
+    title: ReactNode;
+    /** 标题下方元信息 */
+    meta?: ReactNode;
+    /** 反馈描述正文 */
+    description?: ReactNode;
+    /** 描述下方的附件区，通常是 FeedbackAttachmentRow */
+    attachments?: ReactNode;
+    attachmentsLabel?: ReactNode;
+    /** 「已允许读取对话」告知卡片 */
+    notice?: {
+        title: ReactNode;
+        description: ReactNode;
+    } | null;
+    /** 官方回复区 */
+    reply?: ReactNode;
+    /** 相似问题区 */
+    similar?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackAttachmentRowProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    items: FeedbackAttachment[];
+    /** 点击图片：回传本组图片 URL 列表与命中索引，供预览组左右切换 */
+    onPreviewImage?: (urls: string[], index: number) => void;
+    /** 点击附件（下载） */
+    onDownload?: (item: FeedbackAttachment) => void;
+    /** 取附件图标地址 */
+    resolveIcon?: (item: FeedbackAttachment) => string | undefined;
+    formatSize?: (bytes: number) => string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFeedbackSimilarItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    item: FeedbackSimilarItem;
+    /** 展开态。为空时组件自行维护（默认按是否有描述决定） */
+    expanded?: boolean;
+    onExpandedChange?: (next: boolean) => void;
+    /** 赞同点击。已赞同时组件不再触发 */
+    onVote?: () => void;
+    voteLabel: ReactNode;
+    /** 展开区内的附件区 */
+    attachments?: ReactNode;
+    attachmentsLabel?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarAuthImageProps extends Omit<React.ImgHTMLAttributes<HTMLImageElement>, "onClick" | "onLoad" | "src"> {
+    src?: string;
+    /**
+     * 鉴权 token，拼为 `Authorization: Bearer {token}`。
+     * 由消费方注入 —— 组件库不读取任何运行环境
+     */
+    token?: string;
+    /** 额外请求头，与 token 合并（同名时以此为准） */
+    headers?: Record<string, string>;
+    /** 加载完成，回传 blob URL 供父组件收集用于预览 */
+    onLoaded?: (blobUrl: string) => void;
+    /** 点击图片，回传已加载的 blob URL */
+    onImageClick?: (blobUrl: string) => void;
+}
+
 interface SidebarRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** 展开宽度（px），默认 280 */
     width?: number;
@@ -1289,7 +1613,7 @@ interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivEle
     className?: string;
     style?: CSSProperties;
 }
-interface SidebarFooterProps extends HTMLAttributes<HTMLDivElement> {
+interface SidebarFooterUserProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** 头像插槽 */
     avatar?: ReactNode;
     /** 名称，为空时不渲染身份区 */
@@ -1298,13 +1622,35 @@ interface SidebarFooterProps extends HTMLAttributes<HTMLDivElement> {
     nameSuffix?: ReactNode;
     /** 用户菜单展开态，驱动触发区高亮与箭头旋转 */
     menuOpen?: boolean;
+    /**
+     * 是否显示展开箭头。默认 false —— 触发区整体可点，
+     * 箭头属冗余提示。需要显式指示可展开时开启。
+     *
+     * 开启后：常态隐藏，hover 或菜单打开时显现；
+     * 菜单向上弹出，故默认指向上方，展开后转回向下
+     */
+    showCaret?: boolean;
+    /**
+     * 姓名超长时是否 hover 出全称提示，默认 true。
+     * 仅在真正溢出时弹出，未溢出不干扰
+     */
+    nameTooltip?: boolean;
     /** 点击触发区。回传触发元素的 DOMRect，便于消费方自行定位浮层 */
     onTriggerClick?: (rect: DOMRect) => void;
-    /** 右侧动作区插槽 */
-    actions?: ReactNode;
     className?: string;
     style?: CSSProperties;
 }
+interface SidebarFooterProps extends Omit<HTMLAttributes<HTMLDivElement>, "children">, SidebarFooterUserProps {
+    /** 右侧动作区插槽 */
+    actions?: ReactNode;
+    /**
+     * 自定义左侧内容，传入时忽略 avatar/name 等。
+     *
+     * 需要外挂用户菜单时用它 —— 把 Sidebar.FooterUser 交给 DropdownTrigger
+     * 单独包裹，避免右侧动作按钮被并入菜单触发区
+     */
+    children?: ReactNode;
+}
 interface SidebarFooterMenuStaticRowProps extends HTMLAttributes<HTMLDivElement> {
     /** 行首图标 */
     icon?: ReactNode;
@@ -1447,13 +1793,24 @@ declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarL
 declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /**
- * Sidebar.Footer — 底部用户信息条
+ * Sidebar.FooterUser — 底栏左侧用户区（头像 + 名称 + 后缀徽标 + 展开箭头）
+ *
+ * 单独成件而非塞进 Footer：用户菜单的 DropdownTrigger 必须只包裹这里，
+ * 若包住整个 Footer，右侧动作按钮也会成为触发器的一部分，
+ * 点「反馈」「产物管理」时会连带弹出用户菜单。
+ *
+ * 用 div + role 而非 button：作为 Dropdown trigger 时嵌套 button 是非法结构。
+ */
+declare const SidebarFooterUser: React__default.ForwardRefExoticComponent<SidebarFooterUserProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.Footer — 底部条容器
  *
- * 只收敛「头像 + 名称 + 后缀徽标 + 展开箭头 + 动作区」骨架，
- * 用户菜单与动作按钮均以插槽传入 —— 各业务的菜单项集合差异极大。
+ * 一行左右结构：左侧 FooterUser 占满剩余宽度，右侧动作区靠右贴边。
  *
- * onTriggerClick 回传 DOMRect：部分消费方的浮层需要手动定位，
- * 只给事件对象不足以定位。
+ * 两种用法：
+ * - 传 avatar/name 等：内部自行渲染 FooterUser（无需外挂菜单时最省事）
+ * - 传 children：完全自定义左侧内容，用于把 FooterUser 单独交给
+ *   DropdownTrigger 包裹，使动作按钮不被并入菜单触发区
  */
 declare const SidebarFooter: React__default.ForwardRefExoticComponent<SidebarFooterProps & React__default.RefAttributes<HTMLDivElement>>;
 
@@ -1502,6 +1859,99 @@ declare const SidebarUsagePanel: React__default.ForwardRefExoticComponent<Sideba
  */
 declare const SidebarUsagePanelSection: React__default.ForwardRefExoticComponent<SidebarUsagePanelSectionProps & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Sidebar.FeedbackModal — 问题反馈弹窗骨架
+ *
+ * 只负责「弹窗 + 双页签 + 未读红点 + 关闭」这层外壳，
+ * 两个面板内容由消费方注入 —— 取数、提交、截图能力各端差异极大。
+ *
+ * 历史面板建议首次切换后才传入，避免未打开就发请求。
+ */
+declare const SidebarFeedbackModal: React__default.ForwardRefExoticComponent<SidebarFeedbackModalProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FeedbackSubmitPanel — 提交反馈面板
+ *
+ * 内容区滚动、底部按钮固定。拖拽事件由消费方挂在本组件上
+ * （需要访问 dataTransfer 做文件校验，组件库不介入）。
+ */
+declare const SidebarFeedbackSubmitPanel: React__default.ForwardRefExoticComponent<SidebarFeedbackSubmitPanelProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.FeedbackField — 表单字段容器
+ *
+ * 统一「标签 + 必填星号 + 右侧插槽 + 控件 + 提示」的间距，
+ * 避免每个字段各写一遍 margin。
+ */
+declare const SidebarFeedbackField: React__default.ForwardRefExoticComponent<SidebarFeedbackFieldProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FeedbackFileWall — 横向文件墙
+ *
+ * 图片走缩略图、附件走图标卡片，两者同尺寸同排展示。
+ * 超出宽度时内部横向滚动而非撑破弹窗，翻页箭头由消费方放在
+ * FeedbackField 的 labelExtra 插槽（需要读滚动状态，故不内置）。
+ *
+ * 只负责展示与移除；添加动作以 addSlot 注入（通常是 Upload 触发器），
+ * 因为文件校验与截图能力各端不同。
+ */
+declare const SidebarFeedbackFileWall: React__default.ForwardRefExoticComponent<SidebarFeedbackFileWallProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FeedbackHistoryPanel — 历史面板双栏骨架
+ *
+ * 左栏定宽列表、右栏自适应详情，中间竖分割线。
+ * 分页与取数由消费方负责，列表滚动容器通过 listRef 暴露以挂载无限滚动。
+ */
+declare const SidebarFeedbackHistoryPanel: React__default.ForwardRefExoticComponent<SidebarFeedbackHistoryPanelProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.FeedbackHistoryItem — 历史列表卡片
+ *
+ * 状态标签与未读红点同行，标题与元信息各占一行。
+ * 未读判定由消费方给出（replyRead 三态需业务语义），此处只按数据渲染。
+ */
+declare const SidebarFeedbackHistoryItem: React__default.ForwardRefExoticComponent<SidebarFeedbackHistoryItemProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Sidebar.FeedbackDetail — 反馈详情
+ *
+ * 描述 / 附件 / 授权告知 / 官方回复 / 相似问题五段，
+ * 后两段由消费方按数据决定是否传入，不传即不渲染分割线。
+ */
+declare const SidebarFeedbackDetail: React__default.ForwardRefExoticComponent<SidebarFeedbackDetailProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.FeedbackAttachmentRow — 附件行
+ *
+ * 图片渲染缩略图并聚合为一个预览分组（点任意图可左右切换），
+ * 其余渲染为可下载的图标卡片。
+ */
+declare const SidebarFeedbackAttachmentRow: React__default.ForwardRefExoticComponent<SidebarFeedbackAttachmentRowProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.FeedbackSimilarItem — 相似问题卡片
+ *
+ * 可折叠 + 赞同。展开态默认按「是否有描述」初始化 ——
+ * 有内容可看时直接展开，避免用户逐个点开。
+ */
+declare const SidebarFeedbackSimilarItem: React__default.ForwardRefExoticComponent<SidebarFeedbackSimilarItemProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.AuthImage — 带鉴权的图片
+ *
+ * 用 fetch 携带鉴权头拉取图片再转 blob URL 交给 <img>，
+ * 解决 Electron renderer 中 <img src> 不自动带 token 的问题。
+ *
+ * token 由 props 注入而非组件内读取环境：组件库不持有任何运行环境依赖。
+ * Web 端若靠 cookie 鉴权则无需本组件，直接用 <img> 即可。
+ */
+declare const SidebarAuthImage: React__default.ForwardRefExoticComponent<SidebarAuthImageProps & React__default.RefAttributes<HTMLImageElement>>;
+
+/**
+ * 文件大小格式化。
+ *
+ * 与两端既有实现一致：1KB 以下按字节、1MB 以下按 KB，其余按 MB，
+ * 均保留一位小数。
+ */
+declare function formatFileSize(bytes: number): string;
+
 /**
  * Sidebar 侧边栏
  *
@@ -1531,11 +1981,22 @@ declare const Sidebar: {
     ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
     CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
     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>>;
     FooterBadge: React$1.ForwardRefExoticComponent<SidebarFooterBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
     UsageBar: React$1.ForwardRefExoticComponent<SidebarUsageBarProps & React$1.RefAttributes<HTMLDivElement>>;
     UsagePanel: React$1.ForwardRefExoticComponent<SidebarUsagePanelProps & React$1.RefAttributes<HTMLDivElement>>;
     UsagePanelSection: React$1.ForwardRefExoticComponent<SidebarUsagePanelSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackModal: React$1.ForwardRefExoticComponent<SidebarFeedbackModalProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackSubmitPanel: React$1.ForwardRefExoticComponent<SidebarFeedbackSubmitPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackField: React$1.ForwardRefExoticComponent<SidebarFeedbackFieldProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackFileWall: React$1.ForwardRefExoticComponent<SidebarFeedbackFileWallProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackHistoryPanel: React$1.ForwardRefExoticComponent<SidebarFeedbackHistoryPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackHistoryItem: React$1.ForwardRefExoticComponent<SidebarFeedbackHistoryItemProps & React$1.RefAttributes<HTMLButtonElement>>;
+    FeedbackDetail: React$1.ForwardRefExoticComponent<SidebarFeedbackDetailProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackAttachmentRow: React$1.ForwardRefExoticComponent<SidebarFeedbackAttachmentRowProps & React$1.RefAttributes<HTMLDivElement>>;
+    FeedbackSimilarItem: React$1.ForwardRefExoticComponent<SidebarFeedbackSimilarItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    AuthImage: React$1.ForwardRefExoticComponent<SidebarAuthImageProps & React$1.RefAttributes<HTMLImageElement>>;
 };
 
 /** 主轴方向类型 */
@@ -2379,4 +2840,4 @@ declare const ScrollBar: React__default.ForwardRefExoticComponent<ScrollBarProps
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, ButtonProps, 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 DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, 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, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, Empty, EmptyCard, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, LgSize, LingeeProvider, type LingeeProviderProps, 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, type SidebarCaretPlacement, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, 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, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, cn, enUS, useComponentLocale, useLocale, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, ButtonProps, 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 DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, 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, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, LgSize, LingeeProvider, type LingeeProviderProps, 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, cn, enUS, formatFileSize, useComponentLocale, useLocale, zhCN };