@tfdesign/b-end 1.0.4

package/src/index.d.ts

@@ -0,0 +1,1073 @@
+/* Auto-generated by scripts/generate-tfds-b-end-types.mjs — DO NOT EDIT */
+import type * as React from 'react';
+
+/**
+ * 所有 TFDS 组件共享的通用 HTML / React 属性。
+ * 提供 className / style / id / aria-* / data-* / onClick 等基础能力，
+ * 业务组件可以在此之上扩展自身专属 props。
+ */
+export interface TfdsCommonProps extends Omit<React.HTMLAttributes<HTMLElement>, "children"> {
+  className?: string;
+  style?: React.CSSProperties;
+  children?: React.ReactNode;
+}
+
+/** Avatar — 单个实体（人/机器人/AI/兜底）的头像锚点。用于表格、会话、导航等需要「一眼认出是谁」的位置；不用于多人交叠缩略（那是 AvatarGroup）。 */
+export interface AvatarProps extends TfdsCommonProps {
+  /** enum<round | rect>, default: "round" */
+  shape?: "round" | "rect";
+  /** enum<xxs | mini | xs | s | default | m>, default: "default" */
+  size?: "xxs" | "mini" | "xs" | "s" | "default" | "m";
+  /** enum<image | eng | ch | fallback | robot | ai>, default: "image" */
+  type?: "image" | "eng" | "ch" | "fallback" | "robot" | "ai";
+  /** string, default: null */
+  src?: string;
+  /** string, default: null */
+  label?: string;
+  /** string, default: "头像" */
+  alt?: string;
+}
+export const Avatar: React.FC<AvatarProps>;
+
+/** AvatarGroup — 多人参与的缩略表达：固定 5 个圆形图片头像、固定交叠间距，用于「协作成员、围观者」等氛围装饰。需要可配置人数/顺序/文案时请用列表 + 多个 Avatar，不要用本组件硬凑。 */
+export interface AvatarGroupProps extends TfdsCommonProps {
+  /** enum<s | default | m>, default: "s" */
+  size?: "s" | "default" | "m";
+}
+export const AvatarGroup: React.FC<AvatarGroupProps>;
+
+/** Icon — 矢量符号（1198+ 图标名）。用于按钮/输入框前后缀、导航、状态提示等「非人像」图形；需要人像或账号识别请用 Avatar，需要文字标签请用 Button/Tag。 */
+export interface IconProps extends TfdsCommonProps {
+  /** string, default: "check-stroked" */
+  name?: string;
+  /** enum<xs | sm | md | lg | xl>, default: "sm" */
+  size?: "xs" | "sm" | "md" | "lg" | "xl";
+  /** string, default: "currentColor" */
+  color?: string;
+}
+export const Icon: React.FC<IconProps>;
+
+/** NavBar — 业务竖向导航栏，集成品牌区、业务入口切换、平台首页模块高亮、主导航、底部工具按钮和用户头像。 */
+export interface NavBarProps extends TfdsCommonProps {
+  /** enum<ola | bytehi>, default: "ola" */
+  platform?: "ola" | "bytehi";
+  /** string, default: "" */
+  promptText?: string;
+  /** string, default: "OLA" */
+  brandName?: string;
+  /** string, default: "抖音社区" */
+  appLabel?: string;
+  /** array, default: null */
+  appBusinesses?: unknown[];
+  /** string */
+  currentAppId?: string;
+  /** string, default: null */
+  defaultAppId?: string;
+  /** function, default: null */
+  onAppChange?: (...args: any[]) => any;
+  /** string, default: "平台首页" */
+  moduleLabel?: string;
+  /** boolean, default: true */
+  activeModule?: boolean;
+  /** array, default: null */
+  navItems?: unknown[];
+  /** string, default: null */
+  activeNavId?: string;
+  /** string, default: null */
+  activeUtilityId?: string;
+  /** string, default: null */
+  selectedItemId?: string;
+  /** string, default: null */
+  defaultSelectedItemId?: string;
+  /** boolean, default: false */
+  showUtilityActions?: boolean;
+  /** array, default: null */
+  utilityItems?: unknown[];
+  /** function, default: null */
+  onSelect?: (...args: any[]) => any;
+  /** enum<image | robot | fallback>, default: "image" */
+  avatarType?: "image" | "robot" | "fallback";
+  /** string, default: null */
+  avatarSrc?: string;
+  /** string, default: "当前用户头像" */
+  avatarAlt?: string;
+}
+export const NavBar: React.FC<NavBarProps>;
+
+/** TagBar — 业务标签栏，集成顶部搜索、业务切换、树形标签与最小宽度折叠，适合服务平台左侧标签导航场景。 */
+export interface TagBarProps extends TfdsCommonProps {
+  /** array, default: null */
+  businesses?: unknown[];
+  /** string */
+  currentBusinessId?: string;
+  /** string, default: null */
+  defaultBusinessId?: string;
+  /** function, default: null */
+  onBusinessChange?: (...args: any[]) => any;
+  /** array, default: null */
+  items?: unknown[];
+  /** string */
+  selectedItemId?: string;
+  /** string, default: null */
+  defaultSelectedItemId?: string;
+  /** function, default: null */
+  onSelect?: (...args: any[]) => any;
+  /** array, default: null */
+  expandedIds?: unknown[];
+  /** array, default: null */
+  defaultExpandedIds?: unknown[];
+  /** function, default: null */
+  onExpandedChange?: (...args: any[]) => any;
+  /** boolean, default: true */
+  searchable?: boolean;
+  /** string */
+  searchValue?: string;
+  /** string, default: "" */
+  defaultSearchValue?: string;
+  /** function, default: null */
+  onSearchChange?: (...args: any[]) => any;
+  /** boolean, default: true */
+  collapsible?: boolean;
+  /** boolean */
+  collapsed?: boolean;
+  /** boolean, default: false */
+  defaultCollapsed?: boolean;
+  /** function, default: null */
+  onCollapsedChange?: (...args: any[]) => any;
+  /** enum<transparent | panel>, default: "transparent" */
+  tone?: "transparent" | "panel";
+  /** boolean, default: true */
+  resizable?: boolean;
+  /** number */
+  width?: number;
+  /** number, default: 240 */
+  defaultWidth?: number;
+  /** number, default: 160 */
+  minWidth?: number;
+  /** number, default: 360 */
+  maxWidth?: number;
+  /** number, default: 130 */
+  collapseThreshold?: number;
+  /** function, default: null */
+  onWidthChange?: (...args: any[]) => any;
+}
+export const TagBar: React.FC<TagBarProps>;
+
+/** Card — 业务信息摘要卡片，支持数据卡片、商品卡片和信息卡片三类结构。颜色使用遵循背景反衬原则：灰色背景用白底卡，白色背景用灰底卡。 */
+export interface CardProps extends TfdsCommonProps {
+  /** enum<data | product | info>, default: "data" */
+  type?: "data" | "product" | "info";
+  /** enum<white | grey>, default: "white" */
+  color?: "white" | "grey";
+  /** string, default: "智能服务近7天趋势分析" */
+  title?: string;
+  /** string, default: "针对指定业务场景下智能服务核心指标、运行路径、渠道等进行趋势分析，并输出总结报告" */
+  description?: string;
+  /** array, default: null */
+  stats?: unknown[];
+  /** array, default: null */
+  tags?: unknown[];
+  /** string, default: "已使用" */
+  productStatus?: string;
+  /** string, default: null */
+  productImageSrc?: string;
+  /** string, default: "商品图" */
+  productImageAlt?: string;
+  /** string, default: "magic-wand-01-stroked" */
+  infoIconName?: string;
+  /** enum<pink | blue | green | orange | purple | brand | grey>, default: "pink" */
+  infoIconTone?: "pink" | "blue" | "green" | "orange" | "purple" | "brand" | "grey";
+  /** enum<tone | inverse>, default: "inverse" */
+  infoIconStyle?: "tone" | "inverse";
+  /** enum<default | icon-right>, default: "icon-right" */
+  infoLayout?: "default" | "icon-right";
+  /** enum<hidden | visible>, default: "hidden" */
+  dataIconVisible?: "hidden" | "visible";
+  /** string, default: "edit-04-stroked" */
+  dataIconName?: string;
+  /** enum<pink | blue | green | orange | purple | brand | grey>, default: "blue" */
+  dataIconTone?: "pink" | "blue" | "green" | "orange" | "purple" | "brand" | "grey";
+  /** enum<tone | inverse>, default: "inverse" */
+  dataIconStyle?: "tone" | "inverse";
+  /** string, default: "段然" */
+  infoMetaLabel?: string;
+  /** string, default: "官方能力" */
+  infoMetaBadge?: string;
+  /** enum<brand | red | orange | yellow | green | cyan | blue | purple | pink | teal | grey | white | ai>, default: null */
+  infoMetaBadgeVariant?: "brand" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "pink" | "teal" | "grey" | "white" | "ai";
+  /** string, default: null */
+  infoMetaAvatarSrc?: string;
+  /** string, default: "用户头像" */
+  infoMetaAvatarAlt?: string;
+  /** array, default: null */
+  infoStats?: unknown[];
+  /** function, default: null */
+  onAction?: (...args: any[]) => any;
+  /** string, default: "查看卡片详情" */
+  actionAriaLabel?: string;
+}
+export const Card: React.FC<CardProps>;
+
+/** ConversationList — 会话 / 工单 / 线程侧栏列表，用于 IM 对话、即时通讯工作台、客服接待、工单处理、托管队列等需要按状态分组浏览并快速切换当前处理线程的业务场景，默认支持“默认列表 / 卡片列表”双布局切换。 */
+export interface ConversationListProps extends TfdsCommonProps {
+  /** enum<default | card>, default: "default" */
+  variant?: "default" | "card";
+  /** enum<default | card>, default: "default" */
+  defaultVariant?: "default" | "card";
+  /** function, default: null */
+  onVariantChange?: (...args: any[]) => any;
+  /** string, default: "会话列表" */
+  title?: string;
+  /** array, default: null */
+  tabs?: unknown[];
+  /** string, default: null */
+  activeTab?: string;
+  /** string, default: "all" */
+  defaultActiveTab?: string;
+  /** function, default: null */
+  onTabChange?: (...args: any[]) => any;
+  /** array, default: null */
+  sections?: unknown[];
+  /** string, default: null */
+  activeItemId?: string;
+  /** string, default: null */
+  defaultActiveItemId?: string;
+  /** function, default: null */
+  onItemClick?: (...args: any[]) => any;
+  /** function, default: null */
+  onSend?: (...args: any[]) => any;
+  /** boolean, default: true */
+  showActions?: boolean;
+  /** boolean, default: true */
+  showLayoutToggle?: boolean;
+  /** boolean, default: true */
+  resizable?: boolean;
+  /** boolean, default: true */
+  collapsible?: boolean;
+  /** boolean, default: true */
+  autoCollapseOnNarrow?: boolean;
+  /** function, default: null */
+  onLayoutWidthRequest?: (...args: any[]) => any;
+}
+export const ConversationList: React.FC<ConversationListProps>;
+
+/** InfoDisplayPanel — 信息展示面板框架，用于客服工作台、在线 Agent、工单详情右侧信息区等场景；默认以主栏承载全部 tabs，并可按当前选中 tab 拆分出独立栏，最多支持 3 栏。 */
+export interface InfoDisplayPanelProps extends TfdsCommonProps {
+  /** array, default: null */
+  panels?: unknown[];
+  /** number, default: null */
+  columnCount?: number;
+  /** number, default: 3 */
+  defaultColumnCount?: number;
+  /** function, default: null */
+  onColumnCountChange?: (...args: any[]) => any;
+  /** number, default: 200 */
+  minPanelWidth?: number;
+  /** object, default: null */
+  activeTabs?: Record<string, unknown>;
+  /** object, default: null */
+  defaultActiveTabs?: Record<string, unknown>;
+  /** function, default: null */
+  onTabChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onSplitChange?: (...args: any[]) => any;
+  /** function, default: null */
+  renderPanelContent?: (...args: any[]) => any;
+}
+export const InfoDisplayPanel: React.FC<InfoDisplayPanelProps>;
+
+/** ChatBubble — IM 聊天气泡，支持左右 2 种角色布局、单条/多条 2 种气泡组织，以及图片/机器人/AI/隐藏 4 种头像类型，并支持 hover 查看分层消息时间。 */
+export interface ChatBubbleProps extends TfdsCommonProps {
+  /** enum<incoming | outgoing>, default: "incoming" */
+  variant?: "incoming" | "outgoing";
+  /** enum<single | multiple>, default: "single" */
+  layout?: "single" | "multiple";
+  /** enum<image | robot | ai | none>, default: "none" */
+  avatarType?: "image" | "robot" | "ai" | "none";
+  /** enum<default | large>, default: "large" */
+  size?: "default" | "large";
+  /** enum<default | white | grey | ai>, default: "default" */
+  incomingTone?: "default" | "white" | "grey" | "ai";
+  /** enum<default | white | grey | ai>, default: "white" */
+  outgoingTone?: "default" | "white" | "grey" | "ai";
+  /** enum<hidden | read>, default: "hidden" */
+  receipt?: "hidden" | "read";
+  /** array, default: null */
+  messages?: unknown[];
+  /** array, default: null */
+  timestamps?: unknown[];
+  /** string, default: null */
+  avatarSrc?: string;
+  /** string, default: "头像" */
+  avatarAlt?: string;
+}
+export const ChatBubble: React.FC<ChatBubbleProps>;
+
+/** ChatInput — 对话/消息发送输入框，统一覆盖所有「输入内容并发出」场景。变体选择只看一个维度——UI 上是否有 Agent/工具栏：有（Agent 切换 / @ / 指令 / 附件）→ default；没有 → im-basic。im-basic（基础输入框）是使用频率最高的变体，适用范围：IM 消息输入、会话底部发送栏、评论框、工单回复、模型 Playground 发送栏（type prompt → 「发送并运行模型」）、任何 user/assistant 测试界面。default/default-sm/replying/busy/readonly 专用于内置完整 AI 工具栏的 Agent 对话场景（三层结构：底层氛围背景 → 输入区域 → 猫条）。im-basic 左下角按钮通过声明式 `imActions` 场景化配置，默认是图片 + 表情，最多展示 5 个。 */
+export interface ChatInputProps extends TfdsCommonProps {
+  /** enum<default-sm | default | im-basic | replying | busy | readonly>, default: "default" */
+  variant?: "default-sm" | "default" | "im-basic" | "replying" | "busy" | "readonly";
+  /** string, default: "Auto" */
+  agentName?: string;
+  /** array, default: "内置 5 个示例 Agent" */
+  agentOptions?: unknown[];
+  /** array, default: "内置 5 个示例 Mention" */
+  mentionOptions?: unknown[];
+  /** array, default: "内置 4 个示例 Command" */
+  commandOptions?: unknown[];
+  /** string, default: "*" */
+  acceptFiles?: string;
+  /** boolean, default: true */
+  multipleFiles?: boolean;
+  /** string, default: null */
+  catBarText?: string;
+  /** node, default: null */
+  catBarIcon?: React.ReactNode;
+  /** string, default: "需要我为你做什么" */
+  placeholder?: string;
+  /** string, default: null */
+  statusText?: string;
+  /** string, default: null */
+  actionText?: string;
+  /** function, default: null */
+  onSend?: (...args: any[]) => any;
+  /** function, default: null */
+  onStop?: (...args: any[]) => any;
+  /** function, default: null */
+  onAction?: (...args: any[]) => any;
+  /** function, default: null */
+  onAgentChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onMentionsChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onCommandsChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onAttachmentsChange?: (...args: any[]) => any;
+  /** array, default: "仅 im-basic 生效；默认图片+表情，最多展示 5 个" */
+  imActions?: unknown[];
+  /** function, default: null */
+  onImImageClick?: (...args: any[]) => any;
+  /** function, default: null */
+  onImEmojiClick?: (...args: any[]) => any;
+  /** node, default: null */
+  toolbar?: React.ReactNode;
+}
+export const ChatInput: React.FC<ChatInputProps>;
+
+/** ChatMessage — AI 对话页「一条消息」原子单元（行业对齐 assistant-ui Message / Microsoft ChatMessage）。一个 ChatMessage = 一条消息（user 气泡 / AI 头像 / 文本回复 / 执行流 / 卡片回复 / 深度思考 / 操作栏），按 role 与 7 类子能力组合呈现。 */
+export interface ChatMessageProps extends TfdsCommonProps {
+  /** string, default: "ai" */
+  role?: string;
+  /** string, default: "" */
+  timestamp?: string;
+  /** object|boolean, default: null */
+  header?: unknown;
+  /** object, default: null */
+  thinking?: Record<string, unknown>;
+  /** string, default: "" */
+  leadText?: string;
+  /** object, default: null */
+  plan?: Record<string, unknown>;
+  /** string, default: "梳理抖音电商客服售后退换货政策并生成标准答复口径" */
+  title?: string;
+  /** string, default: "completed" */
+  status?: string;
+  /** string, default: "check-circle-stroked" */
+  statusIconName?: string;
+  /** array, default: null */
+  steps?: unknown[];
+  /** array, default: null */
+  taskGroups?: unknown[];
+  /** string, default: "" */
+  resultText?: string;
+  /** array, default: null */
+  resultArtifacts?: unknown[];
+  /** array, default: null */
+  confirms?: unknown[];
+  /** string, default: null */
+  taskBadge?: string;
+  /** array|object, default: null */
+  followUps?: unknown;
+  /** object|boolean, default: null */
+  actions?: unknown;
+  /** array, default: null */
+  userContent?: unknown[];
+  /** array, default: null */
+  userAttachments?: unknown[];
+  /** object, default: null */
+  userQuote?: Record<string, unknown>;
+  /** enum<auto | surface | fill>, default: "auto" */
+  userBubbleTone?: "auto" | "surface" | "fill";
+  /** boolean, default: true */
+  defaultExpanded?: boolean;
+  /** boolean, default: undefined */
+  expanded?: boolean;
+  /** function, default: null */
+  onExpandedChange?: (...args: any[]) => any;
+}
+export const ChatMessage: React.FC<ChatMessageProps>;
+
+/** Button — 触发一次性动作（提交、取消、打开弹窗、行内「编辑/删除」）。不负责在同一视图内切换多块内容（那是 Tabs）；不负责从枚举里选题（那是 Select/Radio）。primary 为每视图唯一主按钮（黑底）。⚠️ 尺寸硬规则：全局默认 size="md"（36px），AI 生成页面时禁止擅自使用 size="sm"，仅在设计明确标注或卡片空间极度受限时才可使用 SM。 */
+export interface ButtonProps extends TfdsCommonProps {
+  /** enum<primary | outline-brand | outline-black | ghost-brand | ghost-black | text-brand | text-black>, default: "primary" */
+  variant?: "primary" | "outline-brand" | "outline-black" | "ghost-brand" | "ghost-black" | "text-brand" | "text-black";
+  /** enum<sm | md>, default: "md" */
+  size?: "sm" | "md";
+  /** enum<rounded | full>, default: "rounded" */
+  radius?: "rounded" | "full";
+  /** node, default: null */
+  icon?: React.ReactNode;
+  /** boolean, default: false */
+  iconOnly?: boolean;
+  /** node, default: null */
+  tooltip?: React.ReactNode;
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: false */
+  loading?: boolean;
+}
+export const Button: React.FC<ButtonProps>;
+
+/** Tabs — 同一页面或同一卡片内，多块平级内容的切换（视图状态保持在本页）。典型：详情子页签、表单分段、筛选维度切换。跨模块站点级导航优先侧栏/路由，而不是 Tabs 堆满一级入口。 */
+export interface TabsProps extends TfdsCommonProps {
+  /** enum<line | button | pill | segment>, default: "line" */
+  variant?: "line" | "button" | "pill" | "segment";
+  /** enum<sm | md | lg>, default: "sm" */
+  size?: "sm" | "md" | "lg";
+  /** array, default: null */
+  items?: unknown[];
+  /** number, default: 0 */
+  activeIndex?: number;
+  /** number, default: 0 */
+  defaultIndex?: number;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+}
+export const Tabs: React.FC<TabsProps>;
+
+/** FormTitle — B端标题组件，统一收敛整体页面总标题、工作台标题、一级/二级/三级标题和卡片标题 5 种变体；描述文案默认隐藏，仅在有板块介绍/场景说明/明确要求时通过 showDescription 显示；支持标题后缀 titleSuffix（如状态 Tag）。⚠️ 字体强约束：所有变体的标题文字均通过组件内部 `[font-weight:var(--font-semibold)]` 固定为 600 semibold，字号、行高、颜色由组件 token 固定，禁止通过 className 或 style 覆写字体粗细、字号、颜色。 */
+export interface FormTitleProps extends TfdsCommonProps {
+  /** enum<form | level-1 | level-2 | level-3 | card>, default: "form" */
+  variant?: "form" | "level-1" | "level-2" | "level-3" | "card";
+  /** string, default: "表单标题" */
+  title?: string;
+  /** string, default: "一级标题描述" */
+  description?: string;
+  /** ReactNode, default: null */
+  titleSuffix?: unknown;
+  /** boolean, default: false */
+  showDescription?: boolean;
+}
+export const FormTitle: React.FC<FormTitleProps>;
+
+/** Form — B端表单组合组件，负责字段标题、说明、错误反馈与 top/left 布局；字段控件复用平台已有基础组件，覆盖 13 类表单字段。 */
+export interface FormProps extends TfdsCommonProps {
+  /** enum<vertical | grid>, default: "vertical" */
+  layout?: "vertical" | "grid";
+  /** enum<top | left>, default: "top" */
+  labelPosition?: "top" | "left";
+  /** enum<sm | md>, default: "md" */
+  size?: "sm" | "md";
+  /** array, default: null */
+  items?: unknown[];
+  /** number, default: 1 */
+  columns?: number;
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: true */
+  requiredMark?: boolean;
+  /** boolean, default: false */
+  labelOptional?: boolean;
+  /** boolean, default: false */
+  labelRequired?: boolean;
+  /** boolean, default: false */
+  labelAi?: boolean;
+  /** boolean, default: false */
+  labelHelp?: boolean;
+}
+export const Form: React.FC<FormProps>;
+
+export const FORM_FIELD_TYPES: readonly string[];
+export const FORM_SAMPLE_ITEMS: readonly Record<string, unknown>[];
+
+/** Input — 用户自输入的短文本/搜索词。值不可穷举或需键盘高效录入时用 Input；若合法值来自有限枚举列表，应优先 Select 或 Radio，避免用 Input 接收「只能是 A/B/C」的值。 */
+export interface InputProps extends TfdsCommonProps {
+  /** enum<default | error>, default: "default" */
+  status?: "default" | "error";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** node, default: null */
+  prefix?: React.ReactNode;
+  /** node, default: null */
+  suffix?: React.ReactNode;
+  /** boolean, default: false */
+  allowClear?: boolean;
+  /** string, default: null */
+  aiSuggestion?: string;
+  /** array, default: null */
+  aiSuggestions?: unknown[];
+  /** string, default: "请输入" */
+  placeholder?: string;
+  /** string | array */
+  value?: unknown;
+  /** string | array */
+  defaultValue?: unknown;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onClear?: (...args: any[]) => any;
+  /** function, default: null */
+  onAdoptSuggestion?: (...args: any[]) => any;
+  /** function, default: null */
+  onRefreshAiSuggestions?: (...args: any[]) => any;
+}
+export const Input: React.FC<InputProps>;
+
+/** TextArea — 多行文本输入，与 Input 共用边框与状态语义；固定 MD 尺寸（14px 字、与 Input md 一致的内边距）。新增 code 类型用于代码 / Prompt 编辑，左侧显示行号并使用等宽字体。默认占位 3 行高度，可选 1～5 行作为最小高度（1 行与 Input md 同高）。高度仅按内容与规则自动变化，不可拖拽改高。maxLength 可选，不设则字数不限。 */
+export interface TextAreaProps extends TfdsCommonProps {
+  /** enum<default | code>, default: "default" */
+  variant?: "default" | "code";
+  /** enum<1 | 2 | 3 | 4 | 5>, default: 3 */
+  minRows?: "1" | "2" | "3" | "4" | "5";
+  /** enum<default | error>, default: "default" */
+  status?: "default" | "error";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** number */
+  maxLength?: number;
+  /** boolean, default: false */
+  showCount?: boolean;
+  /** boolean, default: true */
+  enforceMaxLength?: boolean;
+  /** enum<vertical | none>, default: "vertical" */
+  resize?: "vertical" | "none";
+  /** boolean, default: false */
+  fillHeight?: boolean;
+  /** string, default: null */
+  aiSuggestion?: string;
+  /** array, default: null */
+  aiSuggestions?: unknown[];
+  /** string, default: "请输入" */
+  placeholder?: string;
+  /** string | array */
+  value?: unknown;
+  /** string | array */
+  defaultValue?: unknown;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onAdoptSuggestion?: (...args: any[]) => any;
+  /** function, default: null */
+  onRefreshAiSuggestions?: (...args: any[]) => any;
+}
+export const TextArea: React.FC<TextAreaProps>;
+
+/** InputNumber — 数字输入框，复用 Input 触发器视觉，支持最小值、最大值、步长、小数精度，以及外置/内置步进按钮。 */
+export interface InputNumberProps extends TfdsCommonProps {
+  /** enum<default | error>, default: "default" */
+  status?: "default" | "error";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: false */
+  innerButtons?: boolean;
+  /** boolean, default: true */
+  controls?: boolean;
+  /** number */
+  min?: number;
+  /** number */
+  max?: number;
+  /** number, default: 1 */
+  step?: number;
+  /** number */
+  precision?: number;
+  /** string, default: "请输入" */
+  placeholder?: string;
+  /** number | string */
+  value?: unknown;
+  /** number | string */
+  defaultValue?: unknown;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onStep?: (...args: any[]) => any;
+}
+export const InputNumber: React.FC<InputNumberProps>;
+
+/** Select — 从预定义 options 中选值：节省纵向空间、选项可较多、与 Input 视觉同构。单选枚举默认 mode=default；同一字段多选且以标签形式回显用 mode=tag。少量互斥项且需一眼比较布局 → 优先 Radio。 */
+export interface SelectProps extends TfdsCommonProps {
+  /** enum<default | error>, default: "default" */
+  status?: "default" | "error";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: false */
+  allowClear?: boolean;
+  /** enum<default | tag>, default: "default" */
+  mode?: "default" | "tag";
+  /** string, default: null */
+  aiSuggestion?: string;
+  /** array, default: null */
+  aiSuggestions?: unknown[];
+  /** string, default: "请选择" */
+  placeholder?: string;
+  /** array, default: null */
+  options?: unknown[];
+  /** string | array */
+  value?: unknown;
+  /** string | array, default: null */
+  defaultValue?: unknown;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onClear?: (...args: any[]) => any;
+  /** function, default: null */
+  onAdoptSuggestion?: (...args: any[]) => any;
+  /** function, default: null */
+  onRefreshAiSuggestions?: (...args: any[]) => any;
+}
+export const Select: React.FC<SelectProps>;
+
+/** RadioGroup — 互斥单选：同一组内只能选一个值。适合选项少、需要并排或纵列展示全部标签的表单场景。多选请用 CheckboxGroup；布尔即时开关请用 Switch；选项很多请用 Select。 */
+export interface RadioGroupProps extends TfdsCommonProps {
+  /** enum<brand | black>, default: "brand" */
+  variant?: "brand" | "black";
+  /** enum<vertical | horizontal>, default: "vertical" */
+  layout?: "vertical" | "horizontal";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** string */
+  value?: string;
+  /** string, default: null */
+  defaultValue?: string;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** string, default: null */
+  name?: string;
+}
+export const RadioGroup: React.FC<RadioGroupProps>;
+
+export interface RadioProps extends TfdsCommonProps {
+  value?: unknown;
+  checked?: boolean;
+  disabled?: boolean;
+  onChange?: (...args: any[]) => any;
+}
+export const Radio: React.FC<RadioProps>;
+
+/** CheckboxGroup — 多选或二元勾选（含「全选/半选」树形父级）。用于权限、标签、筛选条件、同意协议等。互斥单选用 Radio；单一功能开闭且立即生效优先 Switch。 */
+export interface CheckboxGroupProps extends TfdsCommonProps {
+  /** enum<brand | black>, default: "brand" */
+  variant?: "brand" | "black";
+  /** enum<sm | md>, default: "md" */
+  size?: "sm" | "md";
+  /** enum<vertical | horizontal>, default: "vertical" */
+  layout?: "vertical" | "horizontal";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** array */
+  value?: unknown[];
+  /** array, default: null */
+  defaultValue?: unknown[];
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** boolean, default: null */
+  checked?: boolean;
+  /** boolean, default: false */
+  defaultChecked?: boolean;
+  /** boolean, default: false */
+  indeterminate?: boolean;
+}
+export const CheckboxGroup: React.FC<CheckboxGroupProps>;
+
+export interface CheckboxProps extends TfdsCommonProps {
+  value?: unknown;
+  checked?: boolean;
+  disabled?: boolean;
+  onChange?: (...args: any[]) => any;
+}
+export const Checkbox: React.FC<CheckboxProps>;
+
+/** Switch — 开关组件，两种状态间即时切换，支持品牌绿/主色黑两种视觉变体，尺寸固定为 MD（36px 体系）。 */
+export interface SwitchProps extends TfdsCommonProps {
+  /** enum<brand | black>, default: "brand" */
+  variant?: "brand" | "black";
+  /** boolean, default: null */
+  checked?: boolean;
+  /** boolean, default: false */
+  defaultChecked?: boolean;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** boolean, default: false */
+  disabled?: boolean;
+}
+export const Switch: React.FC<SwitchProps>;
+
+/** Slider — 滑动输入条，支持单值和区间双滑块，拖动时显示数值气泡并支持刻度标签。 */
+export interface SliderProps extends TfdsCommonProps {
+  /** number, default: 0 */
+  min?: number;
+  /** number, default: 100 */
+  max?: number;
+  /** number, default: 1 */
+  step?: number;
+  /** array */
+  value?: unknown[];
+  /** array, default: [20,80] */
+  defaultValue?: unknown[];
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: true */
+  showTooltip?: boolean;
+  /** node, default: null */
+  marks?: React.ReactNode;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onAfterChange?: (...args: any[]) => any;
+}
+export const Slider: React.FC<SliderProps>;
+
+/** Upload — 图片宫格上传，96×96 缩略图卡片，支持上传进度、错误重试和禁用态。 */
+export interface UploadProps extends TfdsCommonProps {
+  /** string, default: "image/*" */
+  accept?: string;
+  /** boolean, default: true */
+  multiple?: boolean;
+  /** number */
+  limit?: number;
+  /** number */
+  maxSize?: number;
+  /** number */
+  minSize?: number;
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** array */
+  value?: unknown[];
+  /** array, default: null */
+  defaultValue?: unknown[];
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onRemove?: (...args: any[]) => any;
+  /** function, default: null */
+  beforeUpload?: (...args: any[]) => any;
+  /** function, default: null */
+  onSuccess?: (...args: any[]) => any;
+  /** function, default: null */
+  onError?: (...args: any[]) => any;
+  /** function, default: null */
+  onProgress?: (...args: any[]) => any;
+}
+export const Upload: React.FC<UploadProps>;
+
+/** FormFieldStack — 纵向堆叠 Form 的业务片段（无独立背景/描边、无 FormTitle、无底栏按钮）：按 FormFieldStack 间距样式规范（p-6、gap-6、全宽 stretch）组合任意数量与类型的基础表单控件。stackLayout=select-stack 为 5 段单列 select 示意；stackLayout=mixed-fields 为单 Form 内含 2×input / 2×select / 2×radio / 2×checkbox / 3×textarea 示意。 */
+export interface FormFieldStackProps extends TfdsCommonProps {
+  /** enum<select-stack | mixed-fields>, default: "select-stack" */
+  stackLayout?: "select-stack" | "mixed-fields";
+}
+export const FormFieldStack: React.FC<FormFieldStackProps>;
+
+/** Table — B端业务列表表格，支持标准表格与卡片型表单两种类型。标准表格按列配置单元格类型与尺寸；卡片型表单用于策略、流程、脚本、模板等带父项和版本子项的业务列表，并带展开、查看、更多和分页交互。 */
+export interface TableProps extends TfdsCommonProps {
+  /** enum<table | card-form>, default: "table" */
+  variant?: "table" | "card-form";
+  /** array, default: null */
+  columns?: unknown[];
+  /** array, default: null */
+  dataSource?: unknown[];
+  /** string, default: "id" */
+  rowKey?: string;
+  /** object, default: null */
+  pagination?: Record<string, unknown>;
+  /** array, default: null */
+  expandedRowKeys?: unknown[];
+  /** array, default: [] */
+  defaultExpandedRowKeys?: unknown[];
+  /** function, default: null */
+  onExpandedRowKeysChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onView?: (...args: any[]) => any;
+  /** function, default: null */
+  onMore?: (...args: any[]) => any;
+  /** function, default: null */
+  onPageChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onPageSizeChange?: (...args: any[]) => any;
+  /** string, default: "暂无数据" */
+  emptyText?: string;
+  /** enum<none | first | last | both>, default: "none" */
+  fixedColumnsMode?: "none" | "first" | "last" | "both";
+}
+export const Table: React.FC<TableProps>;
+
+/** DatePicker — 日期选择器，支持日期、日期时间、日期范围、日期时间范围 4 种类型。 */
+export interface DatePickerProps extends TfdsCommonProps {
+  /** enum<date | datetime | daterange | datetimerange>, default: "date" */
+  type?: "date" | "datetime" | "daterange" | "datetimerange";
+  /** string */
+  value?: string;
+  /** string */
+  defaultValue?: string;
+  /** string, default: "" */
+  placeholder?: string;
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: false */
+  defaultOpen?: boolean;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+}
+export const DatePicker: React.FC<DatePickerProps>;
+
+/** TimePicker — 时间选择器，支持单时间与时间范围，触发器视觉对齐 DatePicker，浮层内按 Figma 滚轮面板选择时/分。 */
+export interface TimePickerProps extends TfdsCommonProps {
+  /** enum<time | timerange>, default: "time" */
+  type?: "time" | "timerange";
+  /** string | array */
+  value?: unknown;
+  /** string | array */
+  defaultValue?: unknown;
+  /** string, default: "" */
+  placeholder?: string;
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** boolean, default: false */
+  defaultOpen?: boolean;
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+}
+export const TimePicker: React.FC<TimePickerProps>;
+
+/** Modal — 模态弹窗面板，含标题区、内容区和底部按钮。支持居中（center）和全屏弹窗（fullscreen）两种布局变体。 */
+export interface ModalProps extends TfdsCommonProps {
+  /** enum<center | fullscreen>, default: "center" */
+  layout?: "center" | "fullscreen";
+  /** enum<sm | md | lg>, default: "md" */
+  size?: "sm" | "md" | "lg";
+  /** string, default: "模态标题" */
+  title?: string;
+  /** string, default: "模态副标题" */
+  subtitle?: string;
+  /** boolean, default: true */
+  showFooterHint?: boolean;
+  /** string, default: "提示信息" */
+  footerHint?: string;
+  /** string, default: "取消" */
+  cancelText?: string;
+  /** string, default: "确定" */
+  confirmText?: string;
+  /** function, default: null */
+  onClose?: (...args: any[]) => any;
+  /** function, default: null */
+  onCancel?: (...args: any[]) => any;
+  /** function, default: null */
+  onConfirm?: (...args: any[]) => any;
+  /** node, default: null */
+  footer?: React.ReactNode;
+}
+export const Modal: React.FC<ModalProps>;
+
+/** Sheet — 侧边抽屉面板，从屏幕右侧（或左侧）滑入，含标题区、内容区和底部按钮，3 档宽度，内容超高可滚动。 */
+export interface SheetProps extends TfdsCommonProps {
+  /** enum<sm | md | lg>, default: "md" */
+  size?: "sm" | "md" | "lg";
+  /** boolean, default: true */
+  showFooterHint?: boolean;
+  /** string, default: "侧边标题" */
+  title?: string;
+  /** string, default: "侧边副标题" */
+  subtitle?: string;
+  /** string, default: "提示信息" */
+  footerHint?: string;
+  /** string, default: "取消" */
+  cancelText?: string;
+  /** string, default: "确定" */
+  confirmText?: string;
+  /** function, default: null */
+  onClose?: (...args: any[]) => any;
+  /** function, default: null */
+  onCancel?: (...args: any[]) => any;
+  /** function, default: null */
+  onConfirm?: (...args: any[]) => any;
+  /** node, default: null */
+  footer?: React.ReactNode;
+}
+export const Sheet: React.FC<SheetProps>;
+
+/** TagInput — 标签输入框，严格复用 Tag 展示已选项与 +N 折叠项，宽度自适应折叠超出标签，并通过 Tooltip 展示被省略标签。 */
+export interface TagInputProps extends TfdsCommonProps {
+  /** enum<default | error>, default: "default" */
+  status?: "default" | "error";
+  /** boolean, default: false */
+  disabled?: boolean;
+  /** string, default: "请输入" */
+  placeholder?: string;
+  /** array */
+  value?: unknown[];
+  /** array, default: null */
+  defaultValue?: unknown[];
+  /** function, default: null */
+  onChange?: (...args: any[]) => any;
+  /** function, default: null */
+  onRemove?: (...args: any[]) => any;
+  /** array | string | object, default: null */
+  aiSuggestion?: unknown;
+  /** array, default: null */
+  aiSuggestions?: unknown[];
+  /** function, default: null */
+  onAdoptSuggestion?: (...args: any[]) => any;
+  /** function, default: null */
+  onRefreshAiSuggestions?: (...args: any[]) => any;
+  /** boolean, default: true */
+  closable?: boolean;
+  /** enum<brand | red | orange | yellow | green | cyan | blue | purple | pink | teal | grey | white>, default: "grey" */
+  tagVariant?: "brand" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "pink" | "teal" | "grey" | "white";
+  /** enum<s | m | l>, default: "m" */
+  tagSize?: "s" | "m" | "l";
+}
+export const TagInput: React.FC<TagInputProps>;
+
+/** Tag — 标签组件，用于标记、分类或状态展示。支持 13 种颜色变体、2 档字体粗细、3 档尺寸、3 种圆角、可关闭功能。 */
+export interface TagProps extends TfdsCommonProps {
+  /** enum<brand | red | orange | yellow | green | cyan | blue | purple | pink | teal | grey | white | ai>, default: "brand" */
+  variant?: "brand" | "red" | "orange" | "yellow" | "green" | "cyan" | "blue" | "purple" | "pink" | "teal" | "grey" | "white" | "ai";
+  /** enum<regular | bold>, default: "bold" */
+  fontWeight?: "regular" | "bold";
+  /** enum<s | m | l>, default: "m" */
+  size?: "s" | "m" | "l";
+  /** enum<md | full>, default: "md" */
+  radius?: "md" | "full";
+  /** boolean, default: false */
+  showIcon?: boolean;
+  /** string, default: "tag-01-stroked" */
+  iconName?: string;
+  /** boolean, default: false */
+  closable?: boolean;
+  /** function, default: null */
+  onClose?: (...args: any[]) => any;
+}
+export const Tag: React.FC<TagProps>;
+
+/** Toast — 轻量反馈条：信息/成功/警示/错误四态，左侧状态图标（相对行首额外 4px 左边距）+ 主文案 + 可选文字操作（绿色文字 Button）+ 可关闭；宽度随内容收缩（w-fit），最大不超过 min(100%,560px)；圆角 12px、可选语义描边（bordered）、内距 12px、主文案 14px 半粗，行内纵向居中对齐。规范仅覆盖单条条目视觉；全局队列、停留时长与 Portal 由业务集成（对齐 HiUI Toast）。 */
+export interface ToastProps extends TfdsCommonProps {
+  /** enum<info | success | warning | error>, default: "info" */
+  type?: "info" | "success" | "warning" | "error";
+  /** string, default: "补充信息或状态切换" */
+  message?: string;
+  /** array, default: null */
+  actions?: unknown[];
+  /** boolean, default: true */
+  bordered?: boolean;
+  /** boolean, default: true */
+  showClose?: boolean;
+  /** function, default: null */
+  onClose?: (...args: any[]) => any;
+}
+export const Toast: React.FC<ToastProps>;
+
+/** Tooltip — 文字提示气泡，hover/focus 触发，支持 12 个方位与视口边缘自动翻转。默认深色变体（grey-800 背景 + 白字），light 白底变体仅用于 TagInput +N 更多标签场景；文本容器固定规格（圆角 8px、内距 8/12、字号 14px），通过 Portal 渲染到 body 以避开父容器裁切。 */
+export interface TooltipProps extends TfdsCommonProps {
+  /** enum<top | top-start | top-end | bottom | bottom-start | bottom-end | left | left-start | left-end | right | right-start | right-end>, default: "top" */
+  placement?: "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
+  /** boolean, default: true */
+  arrow?: boolean;
+  /** boolean, default: true */
+  autoFlip?: boolean;
+  /** boolean, default: false */
+  defaultOpen?: boolean;
+  /** number, default: 100 */
+  mouseEnterDelay?: number;
+  /** number, default: 100 */
+  mouseLeaveDelay?: number;
+  /** node, default: null */
+  content?: React.ReactNode;
+  /** enum<dark | light>, default: "dark" */
+  tone?: "dark" | "light";
+}
+export const Tooltip: React.FC<TooltipProps>;
+
+/** Empty — 空状态占位组件，固定布局（插画 → 文案 → 操作），所有内容区域独立配置、按需组合。10 种内置插画对应常见场景；标题/描述/链接行/三种按钮均可独立传入或省略；buttonLayout 控制横排/竖排。 */
+export interface EmptyProps extends TfdsCommonProps {
+  /** enum<no-result | no-content | not-found | no-access | failure | idle | success | construction | administrator-1 | administrator-2>, default: "no-content" */
+  illustrationType?: "no-result" | "no-content" | "not-found" | "no-access" | "failure" | "idle" | "success" | "construction" | "administrator-1" | "administrator-2";
+  /** enum<row | column>, default: "row" */
+  buttonLayout?: "row" | "column";
+  /** string, default: "空状态标题" */
+  title?: string;
+  /** string, default: "这是一段对当前空状态的描述文本" */
+  description?: string;
+  /** string, default: "一级操作" */
+  primaryLabel?: string;
+  /** function, default: null */
+  onPrimary?: (...args: any[]) => any;
+  /** string, default: "" */
+  secondaryLabel?: string;
+  /** function, default: null */
+  onSecondary?: (...args: any[]) => any;
+  /** string, default: "" */
+  tertiaryLabel?: string;
+  /** function, default: null */
+  onTertiary?: (...args: any[]) => any;
+  /** string, default: "" */
+  linkPrefix?: string;
+  /** string, default: "" */
+  linkText?: string;
+  /** function, default: null */
+  onLinkClick?: (...args: any[]) => any;
+}
+export const Empty: React.FC<EmptyProps>;
+
+/** FullScreenPage — 全屏操作页容器，覆盖整个模版框架（含侧边导航），适合分步骤编辑、创建页面不同板块内容流程，以及内容量大、需沉浸长时间编辑的业务场景。支持白底（直铺/描边面板）和灰底（白卡面板）两种背景模式。 */
+export interface FullScreenPageProps extends TfdsCommonProps {
+  /** enum<white | grey>, default: "white" */
+  bg?: "white" | "grey";
+  /** string, default: "页面标题" */
+  title?: string;
+  /** function, default: null */
+  onBack?: (...args: any[]) => any;
+  /** node, default: null */
+  headerActions?: React.ReactNode;
+}
+export const FullScreenPage: React.FC<FullScreenPageProps>;
+
+/** 页面模板 / Page Pattern Props（业务可按需扩展，如 thread / messages / sections / panels 等） */
+export interface TfdsPagePatternProps extends TfdsCommonProps {
+  thread?: Record<string, unknown>;
+  messages?: ReadonlyArray<Record<string, unknown>>;
+  sections?: ReadonlyArray<Record<string, unknown>>;
+  panels?: ReadonlyArray<Record<string, unknown>>;
+  activeConversationId?: string;
+  defaultActiveConversationId?: string;
+  onActiveConversationChange?: (id: string) => void;
+  userAvatarSrc?: string;
+  agentAvatarSrc?: string;
+  leftPanel?: React.ReactNode;
+  mainPanel?: React.ReactNode;
+  rightPanel?: React.ReactNode;
+}
+export const VariableManagementPage: React.FC<TfdsPagePatternProps>;
+export const McpManagementPage: React.FC<TfdsPagePatternProps>;
+export const TabTopBarListPage: React.FC<TfdsPagePatternProps>;
+export const StrategyListPage: React.FC<TfdsPagePatternProps>;
+export const BasePageFramePattern: React.FC<TfdsPagePatternProps>;
+export const ChatHomePagePattern: React.FC<TfdsPagePatternProps>;
+export const CopilotPagePattern: React.FC<TfdsPagePatternProps>;
+export const ChatConversationPattern: React.FC<TfdsPagePatternProps>;
+export const IMConversationPattern: React.FC<TfdsPagePatternProps>;
+export const CustomerServiceWorkspaceFramePattern: React.FC<TfdsPagePatternProps>;
+
+/** 包内本地成员头像数据（用于 Avatar / IM / 表格头像列默认头像） */
+export interface TfdsTeamMember {
+  id: string;
+  name: string;
+  avatarSrc: string;
+  [key: string]: unknown;
+}
+export const TEAM_MEMBERS: readonly TfdsTeamMember[];
+export const DEFAULT_TEAM_MEMBER: TfdsTeamMember;
+export const TEAM_MEMBER_AVATAR_SRCS: readonly string[];
+export function getTeamMemberByIndex(index: number): TfdsTeamMember;
+export function getTeamMemberByName(name: string): TfdsTeamMember | undefined;
+export function getTeamMemberBySeed(seed: string | number): TfdsTeamMember;
+export function getTeamAvatarBySeed(seed: string | number): string;
+export function getRandomTeamMember(): TfdsTeamMember;
+export function getRandomTeamAvatarSrc(): string;