@icen.ai/ui 0.8.1 → 0.10.0

package/dist/vue.d.mts

@@ -0,0 +1,344 @@
+import { AiClient, AiAuditor } from './behaviors/ai-provider.js';
+import * as vue from 'vue';
+import { PropType, Ref } from 'vue';
+import { IcenEventMap } from './behaviors/events.js';
+import { ChartSpec } from './behaviors/charts.js';
+export { ChartHandle } from './behaviors/charts.js';
+import { TableOptions } from './behaviors/datatable.js';
+export { TableColumn, TableHandle } from './behaviors/datatable.js';
+import { AiMessageModel } from './behaviors/ai-chat.js';
+export { AiMessageHandle } from './behaviors/ai-chat.js';
+import { AiProviderOption, AiComposerCurrentModel, AiComposerBindOpts } from './behaviors/ai-composer.js';
+export { AiContent, AiContentPart, AiStatus, AiToolCallModel, AiUsage } from './behaviors/ai-core.js';
+import './behaviors/mentions.js';
+import './behaviors/suggestions.js';
+import './behaviors/kb-core.js';
+import './behaviors/icons.js';
+import './behaviors/popover.js';
+import './behaviors/ai-panel.js';
+import './behaviors/context-menu.js';
+
+type MaybeRef<T> = T | Ref<T | null>;
+type Cleanup = (() => void) | void;
+/**
+ * 生命周期接线原语：mounted 时调 init，清理函数在 unmounted / deps 变化时执行。
+ * init 本体需幂等（库内 init* 全部满足）；SSR 下 onMounted 不上服务端，天然安全。
+ */
+declare function useIcenInit(init: (root?: HTMLElement | Document) => Cleanup, deps?: unknown[]): void;
+/**
+ * 事件桥原语：onIcen 的 Vue 形态。within 传 Ref 或元素；缺省全局（广播事件
+ * icen:ai-done / icen:ai-usage 只经 [document, window]，要收广播必须缺省 within）。
+ */
+declare function useIcenEvent<K extends keyof IcenEventMap>(type: K, handler: (detail: IcenEventMap[K], event: CustomEvent<IcenEventMap[K]>) => void, opts?: {
+    within?: MaybeRef<HTMLElement | Document | null>;
+}): void;
+interface VueRendererConfig<Opts, Handle> {
+    create: (el: HTMLElement, opts: Opts) => Handle;
+    /** 缺省：数据变化时 destroy + 重建（同一容器元素） */
+    update?: (handle: Handle, opts: Opts) => void;
+    destroy: (handle: Handle) => void;
+    /** 数据 prop 名（IcenChart 用 'spec'，其余 'opts'） */
+    prop?: string;
+    /** kebab 化 icen 事件名（不带 icen: 前缀；emits 声明 + 透出，detail 为契约 detail） */
+    events?: string[];
+    defaultClass?: string;
+}
+/**
+ * 薄封装工厂：props 进，同一个命令式内核出。
+ * mounted → create + 事件桥；数据 prop deep watch → update 或 destroy+重建；unmounted → destroy。
+ * 句柄经 defineExpose({ getHandle }) 透出。
+ */
+declare function createVueRenderer<Opts, Handle>(cfg: VueRendererConfig<Opts, Handle>): vue.DefineComponent<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<Opts>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, string[], string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<Opts>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+/** 图表：renderChart 封装；spec deep watch → handle.update（原地重渲） */
+declare const IcenChart: vue.DefineComponent<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<ChartSpec>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, string[], string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<ChartSpec>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+/** 数据表：createTable 封装；opts 变化 destroy + 重建 */
+declare const IcenDataTable: vue.DefineComponent<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<TableOptions<Record<string, unknown>>>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, string[], string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<TableOptions<Record<string, unknown>>>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+/** AI 消息：renderAiMessage 快照渲染；model 变化 = 清空容器 + 重渲 */
+declare const IcenAiMessage: vue.DefineComponent<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<AiMessageModel>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, string[], string, vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    [x: string]: {
+        type: PropType<AiMessageModel>;
+        required: true;
+        default?: undefined;
+    } | {
+        type: StringConstructor;
+        default: undefined;
+        required?: undefined;
+    } | {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+        required?: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    [x: `on${Capitalize<string>}`]: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+interface IcenAiComposerProps {
+    client?: AiClient;
+    models?: {
+        providers: AiProviderOption[];
+        current?: AiComposerCurrentModel;
+    };
+    usage?: AiComposerBindOpts['usage'];
+    messagesEl?: MaybeRef<HTMLElement | null>;
+    class?: string;
+    style?: string | Record<string, string>;
+}
+/**
+ * AI 输入台：内部 initAiComposer + setComposerModels + bindComposer，
+ * unmounted 调 binding.unbind()。emits 透出 composer 事件族（kebab）。
+ * DOM 契约为 ai-composer.css 头注释的标记骨架。
+ */
+declare const IcenAiComposer: vue.DefineComponent<vue.ExtractPropTypes<{
+    client: {
+        type: PropType<AiClient>;
+        default: undefined;
+    };
+    models: {
+        type: PropType<IcenAiComposerProps["models"]>;
+        default: undefined;
+    };
+    usage: {
+        type: PropType<IcenAiComposerProps["usage"]>;
+        default: undefined;
+    };
+    messagesEl: {
+        type: PropType<IcenAiComposerProps["messagesEl"]>;
+        default: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>, () => vue.VNode<vue.RendererNode, vue.RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, ("ai-usage" | "ai-todo-toggle" | "ai-ref" | "ai-command" | "ai-model-change" | "ai-attach" | "ai-dequeue" | "ai-queue" | "ai-stop" | "ai-send")[], "ai-usage" | "ai-todo-toggle" | "ai-ref" | "ai-command" | "ai-model-change" | "ai-attach" | "ai-dequeue" | "ai-queue" | "ai-stop" | "ai-send", vue.PublicProps, Readonly<vue.ExtractPropTypes<{
+    client: {
+        type: PropType<AiClient>;
+        default: undefined;
+    };
+    models: {
+        type: PropType<IcenAiComposerProps["models"]>;
+        default: undefined;
+    };
+    usage: {
+        type: PropType<IcenAiComposerProps["usage"]>;
+        default: undefined;
+    };
+    messagesEl: {
+        type: PropType<IcenAiComposerProps["messagesEl"]>;
+        default: undefined;
+    };
+    class: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    style: {
+        type: PropType<string | Record<string, string>>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    "onAi-usage"?: ((...args: any[]) => any) | undefined;
+    "onAi-todo-toggle"?: ((...args: any[]) => any) | undefined;
+    "onAi-ref"?: ((...args: any[]) => any) | undefined;
+    "onAi-command"?: ((...args: any[]) => any) | undefined;
+    "onAi-model-change"?: ((...args: any[]) => any) | undefined;
+    "onAi-attach"?: ((...args: any[]) => any) | undefined;
+    "onAi-dequeue"?: ((...args: any[]) => any) | undefined;
+    "onAi-queue"?: ((...args: any[]) => any) | undefined;
+    "onAi-stop"?: ((...args: any[]) => any) | undefined;
+    "onAi-send"?: ((...args: any[]) => any) | undefined;
+}>, {
+    class: string;
+    style: string | Record<string, string>;
+    usage: {
+        from: "context" | "billing" | AiAuditor;
+        total?: number;
+    } | undefined;
+    models: {
+        providers: AiProviderOption[];
+        current?: AiComposerCurrentModel;
+    } | undefined;
+    messagesEl: MaybeRef<HTMLElement | null> | undefined;
+    client: AiClient;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, true, {}, any>;
+
+export { AiClient, AiComposerBindOpts, AiComposerCurrentModel, AiMessageModel, AiProviderOption, ChartSpec, IcenAiComposer, type IcenAiComposerProps, IcenAiMessage, IcenChart, IcenDataTable, TableOptions, type VueRendererConfig, createVueRenderer, useIcenEvent, useIcenInit };