@blueking/chat-x 0.0.49-beta.1 → 0.0.49-beta.11

package/dist/ag-ui/types/constants.d.ts

@@ -49,6 +49,7 @@ export declare enum MessageRole {
 }
 export declare enum MessageStatus {
     Complete = "complete",
+    Completed = "completed",
     Disabled = "disabled",
     Error = "error",
     Fetching = "fetching",// 请求中

package/dist/ag-ui/types/file.d.ts

@@ -1,18 +1,8 @@
-export declare enum AIFileType {
-    Html = "html",
-    Jpg = "jpg",
-    Json = "json",
-    /** 后台扩展名别名，与 Markdown 等价 */
-    Md = "md",
-    Markdown = "markdown",
-    Pdf = "pdf",
-    Txt = "txt"
-}
 export type AIFileInfo = {
     name: string;
     outputId: string;
     size: number;
-    type: AIFileType;
+    type: string;
 };
 /** 点击文件产物后异步获取的下载 / 预览地址（snake_case） */
 export type ArtifactUrlResult = {

package/dist/ag-ui/types/messages.d.ts

@@ -15,6 +15,8 @@ declare global {
 }
 export interface BaseMessage<T extends MessageType, C = string> {
     content: C;
+    /** 消息创建时间，ISO 字符串或毫秒时间戳，由消息层（chat-helper）写入 */
+    createdAt?: number | string;
     id: number | string;
     messageId: number | string;
     name?: string;

package/dist/components/chat-message/assistant-message/assistant-message.vue.d.ts

@@ -1,11 +1,22 @@
 import type { AssistantMessage } from '../../../ag-ui/types/messages';
+interface AssistantMessageProps {
+    content?: string;
+    id?: AssistantMessage['id'];
+    messageId?: AssistantMessage['messageId'];
+    name?: AssistantMessage['name'];
+    property?: AssistantMessage['property'];
+    role?: AssistantMessage['role'];
+    status?: AssistantMessage['status'];
+    toolCalls?: AssistantMessage['toolCalls'];
+    uid?: AssistantMessage['uid'];
+}
 declare var __VLS_1: {
     content: string;
 };
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Partial<AssistantMessage>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Partial<AssistantMessage>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<AssistantMessageProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AssistantMessageProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-file-card.vue.d.ts

@@ -3,8 +3,6 @@ import 'tippy.js/dist/tippy.css';
 type __VLS_Props = {
     active?: boolean;
     file: AIFileInfo;
-    index?: number;
-    messageUid?: string;
     onDownload?: (file: AIFileInfo) => void;
     onPreview?: (file: AIFileInfo) => void;
     variant?: 'card' | 'list';

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/artifact-preview-host.vue.d.ts

@@ -1,8 +1,11 @@
 import type { AIFileInfo } from '../../../../../ag-ui/types/file';
-import type { SessionArtifact } from '../../../../../composables/use-artifact-preview';
 type __VLS_Props = {
-    file?: AIFileInfo | SessionArtifact;
+    file?: AIFileInfo;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    content: import("vue").ShallowRef<string, string>;
+    renderer: import("vue").ShallowRef<import("./preview-strategy.ts").ArtifactPreviewRendererKind, import("./preview-strategy.ts").ArtifactPreviewRendererKind>;
+    status: import("vue").ShallowRef<import("./use-artifact-preview-loader").ArtifactPreviewStatus, import("./use-artifact-preview-loader").ArtifactPreviewStatus>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/preview-strategy.d.ts

@@ -1,9 +1,8 @@
-import { AIFileType } from '../../../../../ag-ui/types/file';
-export type ArtifactPreviewLoadStrategy = 'preview_url_iframe' | 'text_from_download';
-export type ArtifactPreviewRendererKind = 'html' | 'markdown' | 'txt' | 'urlIframe';
+export type ArtifactPreviewLoadStrategy = 'preview_url' | 'text_from_download';
+export type ArtifactPreviewRendererKind = 'code' | 'html' | 'image' | 'markdown' | 'txt' | 'urlIframe';
 export type ArtifactPreviewStrategy = {
     load: ArtifactPreviewLoadStrategy;
     renderer: ArtifactPreviewRendererKind;
 };
-/** 按文件类型解析预览加载策略与渲染器；未单独注册的类型默认 preview_url iframe */
-export declare const getArtifactPreviewStrategy: (type: AIFileType) => ArtifactPreviewStrategy;
+/** 按文件类型解析预览加载策略与渲染器；未登记的类型默认 preview_url iframe */
+export declare const getArtifactPreviewStrategy: (type?: string, name?: string) => ArtifactPreviewStrategy;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/code-preview.vue.d.ts

@@ -0,0 +1,8 @@
+import 'highlight.js/styles/github-dark.css';
+type __VLS_Props = {
+    content: string;
+    extension: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/image-preview.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    name?: string;
+    url: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/use-artifact-preview-loader.d.ts

@@ -14,6 +14,7 @@ export declare const useArtifactPreviewLoader: (options: {
 }) => {
     content: import("vue").ShallowRef<string, string>;
     dispose: () => void;
+    downloadUrl: import("vue").ShallowRef<string, string>;
     load: () => Promise<void>;
     previewUrl: import("vue").ShallowRef<string, string>;
     renderer: import("vue").ShallowRef<ArtifactPreviewRendererKind, ArtifactPreviewRendererKind>;

package/dist/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue.d.ts

@@ -1,4 +1,5 @@
 import type { SessionArtifact } from '../../../../composables/use-artifact-preview';
+import 'tippy.js/dist/tippy.css';
 type __VLS_Props = {
     activeId: string;
     artifacts: SessionArtifact[];

package/dist/components/chat-message/assistant-message/message-artifacts/message-artifacts.vue.d.ts

@@ -1,7 +1,6 @@
 import type { AIFileInfo } from '../../../../ag-ui/types/file';
 type __VLS_Props = {
     artifacts: AIFileInfo[];
-    messageUid?: string;
     onDownload?: (file: AIFileInfo) => void;
     onPreview?: (file: AIFileInfo) => void;
 };

package/dist/components/chat-message/interrupt-message/user-question/use-user-question.d.ts

@@ -9,9 +9,9 @@ export type NormalizedUserQuestionOption = UserQuestionOptionItem & {
     letter: string;
 };
 /**
- * 用户回答问题（human-in-the-loop）的答案聚合与 resume payload 构建。
+ * 用户回答问题（human-in-the-loop）的答案聚合、题目分页与 resume payload 构建。
  *
- * 设计目标：composable 只负责「收集每题答案 + 完成态计算 + payload 组装」，
+ * 设计目标：composable 只负责「收集每题答案 + 完成态计算 + 分页定位 + payload 组装」，
  * 对「回答形态」（单选/多选/表单/任意自定义）零感知；
  * 各题如何作答与如何校验，全部下沉到对应的渲染组件（默认为选择题），
  * 渲染组件作答有效时回传已组装的 {@link UserQuestionAnswerItem}，无效时回传 undefined。
@@ -23,6 +23,11 @@ export declare const useUserQuestion: (getInterrupt: () => undefined | UserQuest
     answeredCount: import("vue").ComputedRef<number>;
     totalCount: import("vue").ComputedRef<number>;
     completed: import("vue").ComputedRef<boolean>;
+    currentIndex: import("vue").ShallowRef<number, number>;
+    canGoPrev: import("vue").ComputedRef<boolean>;
+    canGoNext: import("vue").ComputedRef<boolean>;
+    goPrev: () => void;
+    goNext: () => void;
     getAnswer: (questionIndex: number) => undefined | UserQuestionAnswerItem;
     setAnswer: (questionIndex: number, answer: undefined | UserQuestionAnswerItem) => void;
     buildResolvePayload: () => UserQuestionResume;

package/dist/components/chat-message/user-message/user-message.vue.d.ts

@@ -1,3 +1,4 @@
+import { type InputContent } from '../../../ag-ui/types';
 import { type TagSchema, MessageToolsStatus } from '../../../types';
 import { type MessageToolsProps } from '../../message-tools/message-tools.vue';
 import type { UserMessage } from '../../../ag-ui/types/messages';
@@ -6,7 +7,19 @@ export type UserMessageActionsProps = {
     onInputConfirm?: (content: UserMessage['content'], docSchema: TagSchema) => Promise<void>;
     onShortcutConfirm?: (formModel: Record<string, unknown>) => Promise<void>;
 };
-type __VLS_Props = Partial<UserMessage> & Pick<MessageToolsProps, 'onAction' | 'tippyOptions'> & UserMessageActionsProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+interface UserMessageProps extends UserMessageActionsProps {
+    content?: InputContent[] | string;
+    createdAt?: UserMessage['createdAt'];
+    id?: UserMessage['id'];
+    messageId?: UserMessage['messageId'];
+    name?: UserMessage['name'];
+    onAction?: MessageToolsProps['onAction'];
+    property?: UserMessage['property'];
+    role?: UserMessage['role'];
+    status?: UserMessage['status'];
+    tippyOptions?: MessageToolsProps['tippyOptions'];
+    uid?: UserMessage['uid'];
+}
+declare const __VLS_export: import("vue").DefineComponent<UserMessageProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<UserMessageProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/file-icon/file-icon.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    fileName?: string;
+    fileType?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/index.d.ts

@@ -14,15 +14,17 @@ export type { IModelCapability, IModelOption, IModelProperty, ModelCapabilityThe
 import MessageContainer from './chat-message/message-container/message-container.vue';
 import MessageRender from './chat-message/message-render/message-render.vue';
 import ExecutionSummary from './execution-summary/execution-summary.vue';
+import FileIcon from './file-icon/file-icon.vue';
 import HighlightKeyword from './highlight-keyword/highlight-keyword';
 import ImagePreviewGroup from './image-preview/image-preview-group.vue';
 import ImagePreview from './image-preview/image-preview.vue';
 import AiImage from './image-preview/image.vue';
 import MessageLoading from './message-loading/message-loading.vue';
+import MessageTime from './message-tools/message-time/message-time.vue';
 import MessageTools from './message-tools/message-tools.vue';
 import MessageUserFeedback from './message-tools/user-feedback/user-feedback.vue';
 import SelectionFooter from './selection-footer/selection-footer.vue';
 import ToolCallRender from './tool-call/toolcall-render/toolcall-render.vue';
 export * from './chat-message/interrupt-message';
 export * from './markdown-token';
-export { AiImage, AiLoading, AiSelection, ChatContainer, ChatInput, commonErrorContent, ContentRender, ExecutionSummary, HighlightKeyword, ImagePreview, ImagePreviewGroup, MessageContainer, MessageLoading, MessageRender, MessageTools, MessageUserFeedback, ModelSelector, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };
+export { AiImage, AiLoading, AiSelection, ChatContainer, ChatInput, commonErrorContent, ContentRender, ExecutionSummary, FileIcon, HighlightKeyword, ImagePreview, ImagePreviewGroup, MessageContainer, MessageLoading, MessageRender, MessageTime, MessageTools, MessageUserFeedback, ModelSelector, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };

package/dist/components/message-tools/message-time/format-message-time.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 格式化消息时间，四档规则来自设计稿标注
+ * 今天 `12:00`；昨天 `昨天 12:00`；今年内更早 `3-12 12:00`；非今年 `2026-3-12 12:00`
+ * @param createdAt 消息创建时间，ISO 字符串或毫秒时间戳
+ * @param timezone IANA 时区名；不传则按浏览器时区展示
+ * @returns 无值或非法时间时返回空字符串，由调用方决定是否渲染
+ */
+export declare const formatMessageTime: (createdAt?: number | string, timezone?: string) => string;

package/dist/components/message-tools/message-time/message-time.vue.d.ts

@@ -0,0 +1,8 @@
+export type MessageTimeProps = {
+    createdAt?: number | string;
+    /** IANA 时区名；优先于全局配置，两者都未配置时按浏览器时区展示 */
+    timezone?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<MessageTimeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MessageTimeProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/message-tools/message-tools.vue.d.ts

@@ -9,7 +9,11 @@ export type MessageToolsProps = {
     tippyOptions?: AITippyProps;
     updateTools?: IToolBtn[];
 };
-declare const __VLS_export: import("vue").DefineComponent<MessageToolsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+type __VLS_Slots = {
+    append?: () => unknown;
+    prepend?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<MessageToolsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     feedback: (tool: IToolBtn, reasonList: string[], otherReason: string) => any;
 }, string, import("vue").PublicProps, Readonly<MessageToolsProps> & Readonly<{
     onFeedback?: ((tool: IToolBtn, reasonList: string[], otherReason: string) => any) | undefined;
@@ -17,5 +21,11 @@ declare const __VLS_export: import("vue").DefineComponent<MessageToolsProps, {},
     messageTools: IToolBtn[];
     updateTools: IToolBtn[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/composables/use-artifact-preview.d.ts

@@ -7,46 +7,36 @@ export declare const FILE_ARTIFACT_TAB_NAME = "file-artifact";
 export type OpenArtifactPreviewPayload = {
     /** 被点击的文件 */
     file: AIFileInfo;
-    /** 文件在所属消息 artifacts 中的下标 */
-    index: number;
-    /** 所属 AssistantMessage 的 uid */
-    messageUid: string;
 };
 /**
- * 会话级文件产物：在 AIFileInfo 基础上补充命中所需的唯一 id 与所属消息。
- * 由于同一会话可能出现「多个 AssistantMessage + 同名文件」，文件名不可作为唯一键，
- * 统一用 messageUid + 消息内下标 + outputId 组合出全局唯一 id。
+ * 会话级文件产物：以 outputId 为会话内唯一键（同 outputId 视为同一文件）。
+ * 拍平去重后即为 AIFileInfo，此处用别名标明语义。
  */
-export type SessionArtifact = AIFileInfo & {
-    artifactId: string;
-    messageUid: string;
-};
+export type SessionArtifact = AIFileInfo;
 type ArtifactPreviewContext = {
-    /** 当前命中的文件 id */
+    /** 当前命中的文件 outputId */
     activeArtifactId: Ref<string>;
     /** 是否具备异步取链能力（有 onArtifactClick 时下载按钮可见） */
     canResolveArtifactUrl: ComputedRef<boolean>;
     /** 由文件卡片触发：命中文件并弹出/切换到文件产物侧栏 */
     openPreview: (payload: OpenArtifactPreviewPayload) => void;
-    /** 按 outputId 缓存并解析 download_url / preview_url */
+    /** 解析 download_url / preview_url：每次重新取链；同文件并发去重 */
     resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
-    /** 直接设置命中文件 id（侧栏列表内切换用） */
+    /** 直接设置命中文件 outputId（侧栏列表内切换用） */
     setActiveArtifactId: (id: string) => void;
 };
-/** 统一的文件产物唯一 id 生成规则，Provider 与文件卡片两侧必须一致 */
-export declare const buildArtifactId: (messageUid: string, index: number, outputId: string) => string;
 /** 通过临时 <a> 触发浏览器下载 */
 export declare const triggerArtifactDownload: (url: string, fileName: string) => void;
 /**
  * 文件产物预览 Provider（在 ChatContainer 内使用）。
- * 维护「命中文件」状态，并封装 onArtifactClick 的 URL 解析与按 outputId 缓存；
+ * 维护「命中文件」状态，并封装 onArtifactClick 取链（每次重新获取 + 并发去重）；
  * 打开侧栏 Tab 的副作用由外部 onOpen 注入。
  */
 export declare const useArtifactPreviewProvider: (options: {
     /** 读取业务侧异步取链回调（用 getter 保持对 props 变更敏感） */
     getOnArtifactClick?: () => OnArtifactClick | undefined;
     /** 命中文件后触发：由容器负责 addCustomTab + 展开侧栏 + 选中 Tab */
-    onOpen: (artifactId: string) => void;
+    onOpen: (outputId: string) => void;
 }) => {
     activeArtifactId: import("vue").ShallowRef<string, string>;
     canResolveArtifactUrl: ComputedRef<boolean>;

package/dist/composables/use-container-scroll.d.ts

@@ -1,18 +1,25 @@
 import { type ComputedRef, type MaybeRef } from 'vue';
 export declare const CONTAINER_SCROLL_TOKEN: unique symbol;
 export declare const SHOW_SCROLL_BOTTOM_BTN_DISTANCE = 100;
+/**
+ * 距底部超过该距离时视为大跨度定位（首屏渲染、切换会话、异步内容撑高），
+ * 此时直接瞬时贴底；平滑滚动只用于流式输出过程中的小幅跟随。
+ */
+export declare const INSTANT_SCROLL_DISTANCE = 600;
 export type ContainerScrollData = {
     autoScrollEnabled: boolean;
     isScrollBottom: boolean;
+    jumpToBottom: () => void;
     scrollBottomHeight: number;
-    toScrollBottom: () => void;
+    toScrollBottom: (behavior?: ScrollBehavior) => void;
     toScrollTop: () => void;
 };
 export declare const useContainerScrollProvider: (containerRef: MaybeRef<HTMLElement | null>, bottomRef: MaybeRef<HTMLElement | null>) => {
     autoScrollEnabled: import("vue").ShallowRef<boolean, boolean>;
     isScrollBottom: import("vue").ShallowRef<boolean, boolean>;
     scrollBottomHeight: import("vue").ShallowRef<number, number>;
-    toScrollBottom: () => void;
+    jumpToBottom: () => void;
+    toScrollBottom: (behavior?: ScrollBehavior) => void;
     toScrollTop: () => void;
     debouncedShowScrollBottomBtn: import("vue").Ref<boolean, boolean>;
 };

package/dist/composables/use-custom-tab.d.ts

@@ -1,17 +1,19 @@
-import { type ComputedRef, type ShallowRef } from 'vue';
+import { type ComputedRef, type Ref, type ShallowRef } from 'vue';
 import type { CustomTab } from '../types';
 export declare const CUSTOM_TAB_TOKEN: unique symbol;
 export declare const EXECUTION_TAB_NAME = "execution";
 /** 自定义 Tab 默认排序权重；执行情况固定为 0，业务自定义 Tab 缺省回退到此值 */
 export declare const DEFAULT_TAB_ORDER = 100;
 export declare function useCustomTabProvider<T extends Record<string, unknown>>(options: {
+    /** 侧栏折叠态；由容器传入受控 ref（如 ChatContainer 的 v-model:asideCollapsed），缺省内部自持 */
+    collapsed?: Ref<boolean>;
     /** 执行情况 Tab 是否展示，缺省 true；传 getter 以保持响应式 */
     executionTabVisible?: () => boolean | undefined;
     onTabChange?: (tab: CustomTab<T>) => void;
 }): {
     tabs: ShallowRef<CustomTab<T>[], CustomTab<T>[]>;
     displayTabs: ComputedRef<CustomTab<T>[]>;
-    selectedTab: import("vue").Ref<{
+    selectedTab: Ref<{
         closable?: boolean | undefined;
         data?: import("vue").UnwrapRef<T & {
             messageUid?: string;
@@ -32,8 +34,9 @@ export declare function useCustomTabProvider<T extends Record<string, unknown>>(
         order?: number | undefined;
         visible?: boolean | undefined;
     }>;
-    isCollapse: ShallowRef<boolean, boolean>;
+    isCollapse: Ref<boolean, boolean>;
     addCustomTab: (tab: CustomTab<T>) => void;
+    ensureCustomTab: (tab: CustomTab<T>) => void;
     removeCustomTab: (tabName: CustomTab<T>["name"]) => void;
     selectCustomTab: (tab: CustomTab<T>) => void;
     resetCustomTab: () => void;
@@ -41,6 +44,7 @@ export declare function useCustomTabProvider<T extends Record<string, unknown>>(
 export declare const useCustomTabConsumer: <T extends Record<string, unknown>>() => {
     addCustomTab: (tab: CustomTab<T>) => void;
     displayTabs: ComputedRef<CustomTab<T>[]>;
+    ensureCustomTab: (tab: CustomTab<T>) => void;
     removeCustomTab: (tabName: CustomTab<T>["name"]) => void;
     selectCustomTab: (tab: CustomTab<T>) => void;
     selectedTab: ShallowRef<CustomTab<T> | null>;

package/dist/composables/use-global-config.d.ts

@@ -4,9 +4,12 @@ export type AiSizeMode = 'normal' | 'small';
 export type GlobalConfig = {
     size?: ComputedRef<AiSizeMode>;
     supportUpload: ComputedRef<boolean>;
+    /** IANA 时区名，用于消息时间展示；未配置时按浏览器时区展示 */
+    timezone?: ComputedRef<string | undefined>;
 };
 export declare const useGlobalConfig: (options: GlobalConfig) => {
     size: ComputedRef<AiSizeMode> | undefined;
     supportUpload: ComputedRef<boolean>;
+    timezone: ComputedRef<string | undefined> | undefined;
 };
 export declare const injectGlobalConfig: () => GlobalConfig | undefined;