@next-bricks/ai-portal 0.70.1 → 0.70.3

package/dist-types/elevo-sidebar/index.d.ts

@@ -28,7 +28,9 @@ export interface ElevoSidebarProps {
 }
 export type { ActionClickDetail, Project, ProjectActionClickDetail };
 /**
- * 构件 `ai-portal.elevo-sidebar`
+ * Elevo AI 侧边栏，包含 Logo 导航、新建对话、历史记录、项目列表及个人账户操作，支持折叠和抽屉两种行为模式。
+ *
+ * @category layout-component
  */
 export declare class ElevoSidebar extends ReactNextElement implements ElevoSidebarProps {
     #private;
@@ -52,13 +54,28 @@ export declare class ElevoSidebar extends ReactNextElement implements ElevoSideb
     accessor scope: "default" | "space" | undefined;
     accessor spaceNav: SpaceNavProps | undefined;
     /**
-     * @param delay Delay in milliseconds before pulling the latest chat history.
+     * 延迟一段时间后拉取最新对话历史
+     * @param delay 拉取前的等待时长（毫秒），用于等待任务标题生成完成
      */
     pullHistory(delay: number): void;
+    /** 展开侧边栏（behavior 为 drawer 时有效） */
     open(): void;
+    /** 折叠侧边栏（behavior 为 drawer 时有效） */
     close(): void;
+    /**
+     * 从历史列表中移除指定项目及其对话
+     * @param projectId 要移除的项目 instanceId
+     */
     removeProject(projectId: string): void;
+    /**
+     * 向项目列表中追加一个新项目
+     * @param project 要追加的项目对象
+     */
     addProject(project: Project): void;
+    /**
+     * 将指定对话标记为已移入项目，从历史列表中隐藏
+     * @param conversationId 要移动的对话 ID
+     */
     moveConversation(conversationId: string): void;
     render(): React.JSX.Element;
 }

package/dist-types/flow-tabs/index.d.ts

@@ -10,7 +10,11 @@ export interface Tab {
     label: string;
 }
 /**
- * 构件 `ai-portal.flow-tabs`
+ * 流程标签页组件，提供带背景画布动效的标签导航，支持工具栏插槽和默认内容插槽。
+ *
+ * @category navigate
+ * @slot toolbar - 标签栏右侧工具栏区域
+ * @slot default - 标签页内容区域
  */
 export declare class FlowTabs extends ReactNextElement implements FlowTabsProps {
     #private;

package/dist-types/gantt-chart/i18n.d.ts

@@ -8,7 +8,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/gantt-chart", import("i18next").KeyPrefix<"bricks/ai-portal/gantt-chart">, "bricks/ai-portal/gantt-chart">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/gantt-chart/index.d.ts

@@ -7,7 +7,9 @@ export interface GanttChartProps {
     nodes?: GanttNode[];
 }
 /**
- * 构件 `ai-portal.gantt-chart`
+ * 甘特图组件，以树状层级结构展示任务节点及其时间条，支持折叠展开和全屏操作。
+ *
+ * @category chart
  */
 export declare class GanttChart extends ReactNextElement implements GanttChartProps {
     #private;

package/dist-types/goal-card-list/i18n.d.ts

@@ -9,7 +9,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/goal-card-list", import("i18next").KeyPrefix<"bricks/ai-portal/goal-card-list">, "bricks/ai-portal/goal-card-list">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/goal-card-list/index.d.ts

@@ -8,13 +8,20 @@ export interface GoalCardListProps {
     activeKey?: string;
 }
 /**
- * 构件 `ai-portal.goal-card-list`
+ * 目标卡片列表，以分层卡片形式展示目标项，支持内联编辑标题、状态切换、新建对话及追加子目标。
+ *
+ * @category display-component
  */
 export declare class GoalCardList extends ReactNextElement implements GoalCardListProps {
     #private;
     accessor goalList: GoalItem[] | undefined;
     accessor cardStyle: React.CSSProperties | undefined;
     accessor activeKey: string | undefined;
+    /**
+     * 将待定子目标提交为正式目标项
+     * @param pendingId 待定子目标的临时 instanceId
+     * @param newItem 创建完成后的真实目标数据
+     */
     appendChildDone(pendingId: string, newItem: GoalItem): void;
     render(): React.JSX.Element;
 }

package/dist-types/home-container/index.d.ts

@@ -5,7 +5,10 @@ export interface HomeContainerProps {
     sticky?: boolean;
 }
 /**
- * 构件 `ai-portal.home-container`
+ * AI Portal 首页容器，通过 sticky 属性控制顶部吸附行为，内容通过默认插槽传入。
+ *
+ * @category layout-component
+ * @slot default - 页面内容区域
  */
 export declare class HomeContainer extends ReactNextElement implements HomeContainerProps {
     accessor sticky: boolean | undefined;

package/dist-types/icon-button/index.d.ts

@@ -13,7 +13,10 @@ export interface IconButtonProps {
 }
 export type IconButtonVariant = "default" | "light" | "mini" | "mini-light" | "bordered";
 /**
- * 构件 `ai-portal.icon-button`
+ * 图标按钮，支持多种视觉变体、禁用状态、Tooltip 提示及文字插槽。
+ *
+ * @category interact-basic
+ * @slot default - 图标旁边的文字内容（可选）
  */
 export declare class IconButton extends ReactNextElement implements IconButtonProps {
     accessor icon: (GeneralIconProps & HTMLAttributes<GeneralIcon>) | undefined;

package/dist-types/mcp-tools/i18n.d.ts

@@ -17,7 +17,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/mcp-tools", import("i18next").KeyPrefix<"bricks/ai-portal/mcp-tools">, "bricks/ai-portal/mcp-tools">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/mcp-tools/index.d.ts

@@ -18,7 +18,9 @@ export interface McpServer {
     name: string;
 }
 /**
- * 构件 `ai-portal.mcp-tools`
+ * MCP 工具列表组件，按服务分组展示工具信息，支持按平台分类过滤和吸顶标签栏。
+ *
+ * @category display-component
  */
 export declare class McpTools extends ReactNextElement implements McpToolsProps {
     accessor list: McpTool[] | undefined;

package/dist-types/notice-dropdown/i18n.d.ts

@@ -9,7 +9,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/notice-dropdown", import("i18next").KeyPrefix<"bricks/ai-portal/notice-dropdown">, "bricks/ai-portal/notice-dropdown">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/notice-list/i18n.d.ts

@@ -8,7 +8,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/notice-list", import("i18next").KeyPrefix<"bricks/ai-portal/notice-list">, "bricks/ai-portal/notice-list">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/page-container/index.d.ts

@@ -15,14 +15,21 @@ export interface Breadcrumb {
 /**
  * 构件 `ai-portal.page-container`
  *
+ * 页面容器构件，提供统一的页面布局，包含面包屑导航、页面标题和内容区域。
+ *
  * @slot - 内容
  * @slot toolbar - 工具栏
  */
 export declare class PageContainer extends ReactNextElement implements PageContainerProps {
+    /** 页面标题，同时会调用 applyPageTitle 更新浏览器标签页标题 */
     accessor pageTitle: string | undefined;
+    /** 面包屑导航配置，每项包含 text 和 url */
     accessor breadcrumbs: Breadcrumb[] | undefined;
+    /** 内容区域宽度模式，通过 CSS attribute selector 控制样式，不触发重新渲染 */
     accessor size: "medium" | "small" | "full" | undefined;
+    /** 页面变体，通过 CSS attribute selector 控制样式，不触发重新渲染 */
     accessor variant: "default" | "form" | undefined;
+    /** 是否固定头部（含面包屑和标题）到页面顶部 */
     accessor sticky: boolean | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/preview-container/i18n.d.ts

@@ -6,7 +6,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/preview-container", import("i18next").KeyPrefix<"bricks/ai-portal/preview-container">, "bricks/ai-portal/preview-container">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/preview-container/index.d.ts

@@ -7,10 +7,14 @@ export interface PreviewContainerProps {
 }
 /**
  * 构件 `ai-portal.preview-container`
+ *
+ * TSX 源码预览容器，将 TSX 源码字符串解析并渲染为完整的页面视图。
  */
 export declare class PreviewContainer extends ReactNextElement implements PreviewContainerProps {
     #private;
+    /** TSX 源码字符串，将被解析并渲染为页面视图 */
     accessor source: string | undefined;
+    /** 渲染上下文中可访问的 URL，传入后可在视图内通过路由相关 API 使用 */
     accessor url: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/project-conversations/i18n.d.ts

@@ -6,7 +6,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/project-conversations", import("i18next").KeyPrefix<"bricks/ai-portal/project-conversations">, "bricks/ai-portal/project-conversations">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/project-knowledges/i18n.d.ts

@@ -6,7 +6,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/project-knowledges", import("i18next").KeyPrefix<"bricks/ai-portal/project-knowledges">, "bricks/ai-portal/project-knowledges">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/project-knowledges/index.d.ts

@@ -20,11 +20,16 @@ export interface ActionClickDetail {
 }
 /**
  * 构件 `ai-portal.project-knowledges`
+ *
+ * 项目知识库列表构件，展示项目中的知识条目，支持操作菜单和点击跳转。
  */
 export declare class ProjectKnowledges extends ReactNextElement implements ProjectKnowledgesProps {
     #private;
+    /** 知识列表数据，为 undefined 时显示加载状态 */
     accessor list: Knowledge[] | undefined;
+    /** 知识详情链接模板，支持使用知识字段插值 */
     accessor urlTemplate: string | undefined;
+    /** 操作菜单配置，每条知识行尾显示可操作的菜单项 */
     accessor actions: ActionType[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/running-flow/index.d.ts

@@ -24,9 +24,12 @@ export interface RunningFlowMapEvents {
 }
 /**
  * 构件 `ai-portal.running-flow`
+ *
+ * 运行中的流程视图构件，以泳道方式展示各阶段的活动及其运行状态（completed、working、input-required 等）。
  */
 export declare class RunningFlow extends ReactNextElement implements RunningFlowProps {
     #private;
+    /** 流程阶段配置数据，每个阶段包含名称和活动列表 */
     accessor spec: FlowStage[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/shared/ActivityPlan/i18n.d.ts

@@ -8,7 +8,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/ActivityPlan", import("i18next").KeyPrefix<"bricks/ai-portal/ActivityPlan">, "bricks/ai-portal/ActivityPlan">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/AskUser/i18n.d.ts

@@ -6,7 +6,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/AskUser", import("i18next").KeyPrefix<"bricks/ai-portal/AskUser">, "bricks/ai-portal/AskUser">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/ChatBox/i18n.d.ts

@@ -9,7 +9,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/ChatBox", import("i18next").KeyPrefix<"bricks/ai-portal/ChatBox">, "bricks/ai-portal/ChatBox">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/CreatedView/i18n.d.ts

@@ -8,7 +8,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/CreatedView", import("i18next").KeyPrefix<"bricks/ai-portal/CreatedView">, "bricks/ai-portal/CreatedView">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/FilePreview/i18n.d.ts

@@ -11,7 +11,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/FilePreview", import("i18next").KeyPrefix<"bricks/ai-portal/FilePreview">, "bricks/ai-portal/FilePreview">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/FileUpload/i18n.d.ts

@@ -14,7 +14,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/FileUpload", import("i18next").KeyPrefix<"bricks/ai-portal/FileUpload">, "bricks/ai-portal/FileUpload">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/shared/NodeFeedback/i18n.d.ts

@@ -18,7 +18,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/NodeFeedback", import("i18next").KeyPrefix<"bricks/ai-portal/NodeFeedback">, "bricks/ai-portal/NodeFeedback">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/show-case/i18n.d.ts

@@ -6,7 +6,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/show-case", import("i18next").KeyPrefix<"bricks/ai-portal/show-case">, "bricks/ai-portal/show-case">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/show-case/index.d.ts

@@ -8,10 +8,15 @@ export interface ShowCaseProps {
 }
 /**
  * 构件 `ai-portal.show-case`
+ *
+ * 案例展示卡片构件，以彩色背景卡片展示单个优秀案例，点击可跳转到案例详情。
  */
 export declare class ShowCase extends ReactNextElement implements ShowCaseProps {
+    /** 案例标题，同时用于计算卡片背景色 */
     accessor caseTitle: string | undefined;
+    /** 案例摘要描述 */
     accessor summary: string | undefined;
+    /** 点击卡片跳转的目标链接 */
     accessor url: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/show-cases/i18n.d.ts

@@ -7,7 +7,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/show-cases", import("i18next").KeyPrefix<"bricks/ai-portal/show-cases">, "bricks/ai-portal/show-cases">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/show-cases/index.d.ts

@@ -8,9 +8,13 @@ export interface ShowCasesProps {
 }
 /**
  * 构件 `ai-portal.show-cases`
+ *
+ * 案例列表展示构件，支持按场景分组筛选，展示多个优秀案例卡片。
  */
 export declare class ShowCases extends ReactNextElement implements ShowCasesProps {
+    /** 案例数据列表，每项可包含 scenario 字段用于分组筛选 */
     accessor list: ShowCaseType[] | undefined;
+    /** 每个场景分组下最多显示的案例数量 */
     accessor limit: number | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/chat-panel-welcome/i18n.d.ts

@@ -5,7 +5,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/chat-panel-welcome", import("i18next").KeyPrefix<"bricks/ai-portal/chat-panel-welcome">, "bricks/ai-portal/chat-panel-welcome">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/space-workbench/chat-panel-welcome/index.d.ts

@@ -6,8 +6,11 @@ export interface ChatPanelWelcomeProps {
 }
 /**
  * 构件 `ai-portal.chat-panel-welcome`
+ *
+ * 聊天面板欢迎语构件，展示带有 Elevo 头像的欢迎消息。
  */
 export declare class ChatPanelWelcome extends ReactNextElement implements ChatPanelWelcomeProps {
+    /** 欢迎语文本内容 */
     accessor text: string | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/i18n.d.ts

@@ -77,7 +77,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/space-workbench", import("i18next").KeyPrefix<"bricks/ai-portal/space-workbench">, "bricks/ai-portal/space-workbench">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/space-workbench/index.d.ts

@@ -14,13 +14,20 @@ export interface SpaceWorkbenchProps {
 }
 /**
  * 构件 `ai-portal.space-workbench`
+ *
+ * 协作空间工作台，集成顶部导航、侧边栏（知识库、业务实例）、聊天区域和服务流等核心功能的一体化工作台构件。
  */
 export declare class SpaceWorkbench extends ReactNextElement implements SpaceWorkbenchProps {
     #private;
+    /** 消息通知列表 */
     accessor notices: NoticeItem[] | undefined;
+    /** 知识库列表 */
     accessor knowledges: KnowledgeItem[] | undefined;
+    /** 空间详情信息，必填 */
     accessor spaceDetail: SpaceDetail;
+    /** 消息中心跳转链接，必填 */
     accessor notifyCenterUrl: string;
+    /** 文件上传配置选项 */
     accessor uploadOptions: UploadOptions | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/space-chat-guide/i18n.d.ts

@@ -5,7 +5,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/space-chat-guide", import("i18next").KeyPrefix<"bricks/ai-portal/space-chat-guide">, "bricks/ai-portal/space-chat-guide">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/space-workbench/space-chat-guide/index.d.ts

@@ -7,8 +7,11 @@ export interface SpaceChatGuideProps {
 }
 /**
  * 构件 `ai-portal.space-chat-guide`
+ *
+ * 空间聊天引导构件，根据空间详情展示引导信息，帮助用户快速开始聊天。
  */
 export declare class SpaceChatGuide extends ReactNextElement implements SpaceChatGuideProps {
+    /** 空间详情信息，必填，用于展示空间相关的引导内容 */
     accessor spaceDetail: SpaceDetail;
     render(): React.JSX.Element;
 }

package/dist-types/space-workbench/space-logo/index.d.ts

@@ -10,6 +10,7 @@ export interface SpaceLogoProps {
  * 协作空间的 Logo 展示组件
  */
 export declare class SpaceLogo extends ReactNextElement implements SpaceLogoProps {
+    /** Logo 容器尺寸（px），图标为容器的 87.5%，圆角为容器的 25%，默认 48 */
     accessor size: number | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/stage-flow/i18n.d.ts

@@ -14,7 +14,7 @@ export declare const locales: {
     en: Locale;
     zh: Locale;
 };
-export declare const t: any;
+export declare const t: import("i18next").TFunction<"bricks/ai-portal/stage-flow", import("i18next").KeyPrefix<"bricks/ai-portal/stage-flow">, "bricks/ai-portal/stage-flow">;
 type Locale = {
     [k in K]: string;
 } & {

package/dist-types/stage-flow/index.d.ts

@@ -28,14 +28,35 @@ export interface EditActivityDetail {
 }
 /**
  * 构件 `ai-portal.stage-flow`
+ *
+ * 阶段流程编辑器构件，支持以泳道方式展示和编辑服务流的阶段与活动。
  */
 export declare class StageFlow extends ReactNextElement implements StageFlowProps {
     #private;
+    /** 阶段流程配置数据，每个阶段包含名称和活动列表 */
     accessor spec: Stage[] | undefined;
+    /** AI 员工列表，用于在活动中显示分配的员工名称 */
     accessor aiEmployees: AIEmployee[] | undefined;
+    /** 是否为只读模式，只读时不显示编辑、添加、删除操作 */
     accessor readOnly: boolean | undefined;
+    /**
+     * 向指定阶段添加活动
+     * @param stage 目标阶段
+     * @param activity 要添加的活动数据
+     */
     addActivity(stage: Stage, activity: FlowActivity): void;
+    /**
+     * 编辑指定阶段中的某个活动
+     * @param stage 目标阶段
+     * @param activity 更新后的活动数据
+     * @param activityIndex 活动在阶段中的索引
+     */
     editActivity(stage: Stage, activity: FlowActivity, activityIndex: number): void;
+    /**
+     * 删除指定阶段中的某个活动
+     * @param stage 目标阶段
+     * @param activityIndex 活动在阶段中的索引
+     */
     deleteActivity(stage: Stage, activityIndex: number): void;
     render(): React.JSX.Element;
 }

package/dist-types/stat-with-mini-chart/index.d.ts

@@ -9,18 +9,25 @@ export interface StatWithMiniChartProps extends Pick<MiniLineChartProps, "data"
 }
 /**
  * 构件 `ai-portal.stat-with-mini-chart`
+ *
+ * 带迷你折线图的统计数据展示构件，在统计数值旁边渲染一个迷你折线图。
  */
 export declare class StatWithMiniChart extends ReactNextElement implements StatWithMiniChartProps {
+    /** 统计指标标签名称 */
     accessor label: string | undefined;
+    /** 统计数值文本 */
     accessor value: string | undefined;
     /**
+     * 展示尺寸，medium 时图表高度为 92px，small 时为 55px
      * @default "medium"
      */
     accessor size: "medium" | "small" | undefined;
     /**
+     * 折线颜色
      * @default "var(--color-brand)"
      */
     accessor lineColor: string | undefined;
+    /** 是否在折线下方显示渐变填充区域 */
     accessor showArea: boolean | undefined;
     /**
      * Specify the minimum value of the y-axis.
@@ -33,13 +40,16 @@ export declare class StatWithMiniChart extends ReactNextElement implements StatW
      */
     accessor max: number | undefined;
     /**
+     * x 轴字段名（数据中时间字段的 key）
      * @default "0"
      */
     accessor xField: string | undefined;
     /**
+     * y 轴字段名（数据中数值字段的 key）
      * @default "1"
      */
     accessor yField: string | undefined;
+    /** 图表数据源，每项为包含 xField 和 yField 字段的对象 */
     accessor data: Record<string, number>[] | undefined;
     render(): React.JSX.Element;
 }

package/dist-types/sticky-container/index.d.ts

@@ -8,12 +8,15 @@ export type StickyContainerVariant = "default" | "home";
 /**
  * 构件 `ai-portal.sticky-container`
  *
+ * 粘性容器构件，使内容在页面滚动时固定在顶部。
+ *
  * @slot - 内容
  * @slot header - 头部
  * @slot toolbar - 工具栏
  */
 export declare class StickyContainer extends ReactNextElement implements StickyContainerProps {
     /**
+     * 变体风格，通过 CSS attribute selector 控制样式，不触发重新渲染
      * @default "default"
      */
     accessor variant: StickyContainerVariant | undefined;

package/dist-types/tab-list/index.d.ts

@@ -18,12 +18,16 @@ export interface TabListMapping {
 /**
  * 构件 `ai-portal.tab-list`
  *
+ * 标签页列表构件，展示可切换的标签页，点击后触发事件并自动更新选中状态。
+ *
  * @part tabs - The tab list container
  * @part tab - The individual tab
  */
 export declare class TabList extends ReactNextElement implements TabListProps {
     #private;
+    /** 标签页配置列表，每项包含 id 和 label */
     accessor tabs: Tab[] | undefined;
+    /** 当前激活的标签页 id */
     accessor activeTab: string | undefined;
     render(): React.JSX.Element;
 }