@opentiny/tiny-robot 0.2.0-alpha.0 → 0.2.0-alpha.1

package/dist/suggestion/components/CategoryNav.vue.d.ts

@@ -0,0 +1,45 @@
+import { PropType } from 'vue';
+import { Category } from '../index.type';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'category-label'?(_: {
+            category: Category;
+        }): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    categories: {
+        type: PropType<Category[]>;
+        required: true;
+    };
+    activeCategory: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "category-select": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    categories: {
+        type: PropType<Category[]>;
+        required: true;
+    };
+    activeCategory: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    "onCategory-select"?: ((...args: any[]) => any) | undefined;
+}>, {
+    activeCategory: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/suggestion/components/SuggestionCapsule.vue.d.ts

@@ -0,0 +1,32 @@
+import { PropType } from 'vue';
+import { SuggestionItem } from '../index.type';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    suggestions: {
+        type: PropType<SuggestionItem[]>;
+        required: true;
+    };
+    isExpanded: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "show-expand-button": (...args: any[]) => void;
+    "suggestion-click": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    suggestions: {
+        type: PropType<SuggestionItem[]>;
+        required: true;
+    };
+    isExpanded: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{
+    "onShow-expand-button"?: ((...args: any[]) => any) | undefined;
+    "onSuggestion-click"?: ((...args: any[]) => any) | undefined;
+}>, {
+    isExpanded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    capsuleRef: HTMLDivElement;
+}, any>;
+export default _default;

package/dist/suggestion/components/SuggestionPanel.vue.d.ts

@@ -0,0 +1,84 @@
+import { PropType } from 'vue';
+import { SuggestionItem, Category } from '../index.type';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'title-icon'?(_: {}): any;
+        'loading-indicator'?(_: {}): any;
+        item?(_: {
+            item: SuggestionItem;
+            active: boolean;
+        }): any;
+        empty?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    items: {
+        type: PropType<SuggestionItem[]>;
+        required: true;
+    };
+    categories: {
+        type: PropType<Category[]>;
+        default: () => never[];
+    };
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    maxVisibleItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>, {
+    handleKeyDown: (e: KeyboardEvent) => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (...args: any[]) => void;
+    close: (...args: any[]) => void;
+    "category-select": (...args: any[]) => void;
+    "item-hover": (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    items: {
+        type: PropType<SuggestionItem[]>;
+        required: true;
+    };
+    categories: {
+        type: PropType<Category[]>;
+        default: () => never[];
+    };
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    maxVisibleItems: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>> & Readonly<{
+    onSelect?: ((...args: any[]) => any) | undefined;
+    onClose?: ((...args: any[]) => any) | undefined;
+    "onCategory-select"?: ((...args: any[]) => any) | undefined;
+    "onItem-hover"?: ((...args: any[]) => any) | undefined;
+}>, {
+    loading: boolean;
+    title: string;
+    categories: Category[];
+    maxVisibleItems: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/suggestion/composables/useKeyboardNavigation.d.ts

@@ -0,0 +1,18 @@
+import { Ref } from 'vue';
+import { SuggestionItem } from '../index.type';
+export interface KeyboardNavigationOptions {
+    onSelect?: (item: SuggestionItem) => void;
+    onClose?: () => void;
+    initialIndex?: number;
+}
+/**
+ * 处理指令列表的键盘导航
+ * @param items 当前可见的指令项列表
+ * @param options 配置选项
+ */
+export declare function useKeyboardNavigation(items: Ref<SuggestionItem[]>, options?: KeyboardNavigationOptions): {
+    activeIndex: Ref<number, number>;
+    handleKeyDown: (e: KeyboardEvent) => void;
+    scrollToActive: () => void;
+    setActiveIndex: (index: number) => void;
+};

package/dist/suggestion/composables/useSuggestionFilter.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+import { SuggestionItem } from '../index.type';
+/**
+ * 过滤和搜索指令项列表
+ * @param items 原始指令项列表
+ * @param searchTerm 搜索关键词
+ */
+export declare function useSuggestionFilter(items: Ref<SuggestionItem[]>, searchTerm: Ref<string>): {
+    filteredItems: import('vue').ComputedRef<SuggestionItem[]>;
+};

package/dist/suggestion/composables/useTriggerDetection.d.ts

@@ -0,0 +1,11 @@
+import { SuggestionProps } from '../index.type';
+/**
+ * 使用hook处理快捷键触发和命令过滤逻辑
+ */
+export declare const useTriggerDetection: (props: SuggestionProps) => {
+    isTriggerKey: (char: string) => boolean;
+    detectTrigger: (event: Event, text: string) => {
+        text: string;
+        position: number;
+    } | null;
+};

package/dist/suggestion/index.d.ts

@@ -0,0 +1,7 @@
+import { App } from 'vue';
+import { default as Suggestion } from './index.vue';
+declare const install: <T>(app: App<T>) => void;
+declare const _default: typeof Suggestion & {
+    install: typeof install;
+};
+export default _default;

package/dist/suggestion/index.type.d.ts

@@ -0,0 +1,94 @@
+import { VNode } from 'vue';
+/**
+ * 分类定义
+ */
+export interface Category {
+    /** 唯一标识 */
+    id: string;
+    /** 显示名称 */
+    label: string;
+    /** 可选图标 */
+    icon?: VNode;
+    /** 该分类下的指令项 */
+    items: SuggestionItem[];
+}
+/**
+ * 指令项定义
+ */
+export interface SuggestionItem {
+    /** 唯一标识 */
+    id: string;
+    /** 显示文本 */
+    text: string;
+    /** 指令值 */
+    value: string;
+    /** 图标 */
+    icon?: VNode;
+    /** 关键词，用于搜索和过滤 */
+    keywords?: string[];
+    /** 描述文本 */
+    description?: string;
+    /** 指令模板，用于在输入框中显示可编辑的模板 */
+    template?: string;
+}
+/**
+ * 触发位置信息
+ */
+export interface TriggerContext {
+    /** 触发的文本 */
+    text: string;
+    /** 触发的位置 */
+    position: number;
+}
+/**
+ * 组件属性
+ */
+export interface SuggestionProps {
+    /** 触发快捷键列表 */
+    triggerKeys?: string[];
+    /** 指令项列表 */
+    items: SuggestionItem[];
+    /** 分类列表 */
+    categories?: Category[];
+    /** 是否显示面板 (支持v-model) */
+    open?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 主题，light或dark */
+    theme?: 'light' | 'dark';
+    /** 是否显示加载状态 */
+    loading?: boolean;
+    /** 是否点击外部关闭面板 */
+    closeOnOutsideClick?: boolean;
+    /** 面板标题 */
+    title?: string;
+    /** 最大显示条目数 */
+    maxVisibleItems?: number;
+    /** 默认是否展开完整指令列表 */
+    defaultExpanded?: boolean;
+}
+/** 触发信息类型 */
+export type TriggerInfo = TriggerContext | false;
+/** 触发处理函数类型 */
+export type TriggerHandler = (info: TriggerInfo) => void;
+/**
+ * 组件事件
+ */
+export interface SuggestionEmits {
+    /** 双向绑定打开状态 (v-model) */
+    (e: 'update:open', value: boolean): void;
+    /** 选中指令项 */
+    (e: 'select', value: string, context?: TriggerContext): void;
+    /** 关闭面板 */
+    (e: 'close'): void;
+    /** 触发回调 */
+    (e: 'trigger', handler: TriggerHandler): void;
+    /** 选择分类 */
+    (e: 'category-select', category: Category): void;
+    /** 点击胶囊指令 */
+    (e: 'suggestion-select', item: SuggestionItem): void;
+    /** 展开/收起状态变化 */
+    (e: 'update:expanded', expanded: boolean): void;
+    /** 填充模板到输入框 */
+    (e: 'fill-template', template: string): void;
+}

package/dist/suggestion/index.vue.d.ts

@@ -0,0 +1,343 @@
+import { SuggestionItem, SuggestionProps, TriggerHandler, TriggerContext, Category } from './index.type';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'capsule-icon'?(_: {
+            suggestion: any;
+        }): any;
+        trigger?(_: {
+            onTrigger: TriggerHandler;
+            onKeyDown: (e: KeyboardEvent) => void;
+            onInput: (event: Event, text: string) => boolean;
+        }): any;
+        'title-icon'?(_: {}): any;
+        'category-label'?(_: {
+            category: any;
+        }): any;
+        item?(_: {
+            item: SuggestionItem;
+            active: boolean;
+        }): any;
+        'loading-indicator'?(_: {}): any;
+        empty?(_: {}): any;
+    };
+    refs: {
+        rootRef: HTMLDivElement;
+        panelRef: ({
+            $: import('vue').ComponentInternalInstance;
+            $data: {};
+            $props: Partial<{
+                loading: boolean;
+                title: string;
+                categories: Category[];
+                maxVisibleItems: number;
+            }> & Omit<{
+                readonly loading: boolean;
+                readonly title: string;
+                readonly items: SuggestionItem[];
+                readonly categories: Category[];
+                readonly maxVisibleItems: number;
+                readonly onSelect?: ((...args: any[]) => any) | undefined;
+                readonly onClose?: ((...args: any[]) => any) | undefined;
+                readonly "onCategory-select"?: ((...args: any[]) => any) | undefined;
+                readonly "onItem-hover"?: ((...args: any[]) => any) | undefined;
+            } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "loading" | "title" | "categories" | "maxVisibleItems">;
+            $attrs: {
+                [x: string]: unknown;
+            };
+            $refs: {
+                [x: string]: unknown;
+            };
+            $slots: Readonly<{
+                [name: string]: import('vue').Slot<any> | undefined;
+            }>;
+            $root: import('vue').ComponentPublicInstance | null;
+            $parent: import('vue').ComponentPublicInstance | null;
+            $host: Element | null;
+            $emit: ((event: "select", ...args: any[]) => void) & ((event: "close", ...args: any[]) => void) & ((event: "category-select", ...args: any[]) => void) & ((event: "item-hover", ...args: any[]) => void);
+            $el: HTMLDivElement;
+            $options: import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+                items: {
+                    type: import('vue').PropType<SuggestionItem[]>;
+                    required: true;
+                };
+                categories: {
+                    type: import('vue').PropType<Category[]>;
+                    default: () => never[];
+                };
+                loading: {
+                    type: BooleanConstructor;
+                    default: boolean;
+                };
+                title: {
+                    type: StringConstructor;
+                    default: string;
+                };
+                maxVisibleItems: {
+                    type: NumberConstructor;
+                    default: number;
+                };
+            }>> & Readonly<{
+                onSelect?: ((...args: any[]) => any) | undefined;
+                onClose?: ((...args: any[]) => any) | undefined;
+                "onCategory-select"?: ((...args: any[]) => any) | undefined;
+                "onItem-hover"?: ((...args: any[]) => any) | undefined;
+            }>, {
+                handleKeyDown: (e: KeyboardEvent) => void;
+            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+                select: (...args: any[]) => void;
+                close: (...args: any[]) => void;
+                "category-select": (...args: any[]) => void;
+                "item-hover": (...args: any[]) => void;
+            }, string, {
+                loading: boolean;
+                title: string;
+                categories: Category[];
+                maxVisibleItems: number;
+            }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+                beforeCreate?: (() => void) | (() => void)[];
+                created?: (() => void) | (() => void)[];
+                beforeMount?: (() => void) | (() => void)[];
+                mounted?: (() => void) | (() => void)[];
+                beforeUpdate?: (() => void) | (() => void)[];
+                updated?: (() => void) | (() => void)[];
+                activated?: (() => void) | (() => void)[];
+                deactivated?: (() => void) | (() => void)[];
+                beforeDestroy?: (() => void) | (() => void)[];
+                beforeUnmount?: (() => void) | (() => void)[];
+                destroyed?: (() => void) | (() => void)[];
+                unmounted?: (() => void) | (() => void)[];
+                renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+                errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
+            };
+            $forceUpdate: () => void;
+            $nextTick: typeof import('vue').nextTick;
+            $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+        } & Readonly<{
+            loading: boolean;
+            title: string;
+            categories: Category[];
+            maxVisibleItems: number;
+        }> & Omit<Readonly<import('vue').ExtractPropTypes<{
+            items: {
+                type: import('vue').PropType<SuggestionItem[]>;
+                required: true;
+            };
+            categories: {
+                type: import('vue').PropType<Category[]>;
+                default: () => never[];
+            };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            title: {
+                type: StringConstructor;
+                default: string;
+            };
+            maxVisibleItems: {
+                type: NumberConstructor;
+                default: number;
+            };
+        }>> & Readonly<{
+            onSelect?: ((...args: any[]) => any) | undefined;
+            onClose?: ((...args: any[]) => any) | undefined;
+            "onCategory-select"?: ((...args: any[]) => any) | undefined;
+            "onItem-hover"?: ((...args: any[]) => any) | undefined;
+        }>, "handleKeyDown" | ("loading" | "title" | "categories" | "maxVisibleItems")> & import('vue').ShallowUnwrapRef<{
+            handleKeyDown: (e: KeyboardEvent) => void;
+        }> & {} & import('vue').ComponentCustomProperties & {} & {
+            $slots: {
+                'title-icon'?(_: {}): any;
+                'loading-indicator'?(_: {}): any;
+                item?(_: {
+                    item: SuggestionItem;
+                    active: boolean;
+                }): any;
+                empty?(_: {}): any;
+            };
+        }) | null;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<SuggestionProps, {
+    trigger: TriggerHandler;
+    keyDown: (e: KeyboardEvent) => void;
+    input: (event: Event, text: string) => boolean;
+    toggleExpand: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (value: string, context?: TriggerContext | undefined) => any;
+    close: () => any;
+    "suggestion-select": (item: SuggestionItem) => any;
+    "update:open": (value: boolean) => any;
+    trigger: (handler: TriggerHandler) => any;
+    "category-select": (category: Category) => any;
+    "update:expanded": (expanded: boolean) => any;
+    "fill-template": (template: string) => any;
+}, string, import('vue').PublicProps, Readonly<SuggestionProps> & Readonly<{
+    onSelect?: ((value: string, context?: TriggerContext | undefined) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    "onSuggestion-select"?: ((item: SuggestionItem) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    onTrigger?: ((handler: TriggerHandler) => any) | undefined;
+    "onCategory-select"?: ((category: Category) => any) | undefined;
+    "onUpdate:expanded"?: ((expanded: boolean) => any) | undefined;
+    "onFill-template"?: ((template: string) => any) | undefined;
+}>, {
+    loading: boolean;
+    title: string;
+    items: SuggestionItem[];
+    categories: Category[];
+    theme: "light" | "dark";
+    maxVisibleItems: number;
+    triggerKeys: string[];
+    open: boolean;
+    closeOnOutsideClick: boolean;
+    defaultExpanded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    rootRef: HTMLDivElement;
+    panelRef: ({
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{
+            loading: boolean;
+            title: string;
+            categories: Category[];
+            maxVisibleItems: number;
+        }> & Omit<{
+            readonly loading: boolean;
+            readonly title: string;
+            readonly items: SuggestionItem[];
+            readonly categories: Category[];
+            readonly maxVisibleItems: number;
+            readonly onSelect?: ((...args: any[]) => any) | undefined;
+            readonly onClose?: ((...args: any[]) => any) | undefined;
+            readonly "onCategory-select"?: ((...args: any[]) => any) | undefined;
+            readonly "onItem-hover"?: ((...args: any[]) => any) | undefined;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "loading" | "title" | "categories" | "maxVisibleItems">;
+        $attrs: {
+            [x: string]: unknown;
+        };
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import('vue').Slot<any> | undefined;
+        }>;
+        $root: import('vue').ComponentPublicInstance | null;
+        $parent: import('vue').ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: ((event: "select", ...args: any[]) => void) & ((event: "close", ...args: any[]) => void) & ((event: "category-select", ...args: any[]) => void) & ((event: "item-hover", ...args: any[]) => void);
+        $el: HTMLDivElement;
+        $options: import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+            items: {
+                type: import('vue').PropType<SuggestionItem[]>;
+                required: true;
+            };
+            categories: {
+                type: import('vue').PropType<Category[]>;
+                default: () => never[];
+            };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            title: {
+                type: StringConstructor;
+                default: string;
+            };
+            maxVisibleItems: {
+                type: NumberConstructor;
+                default: number;
+            };
+        }>> & Readonly<{
+            onSelect?: ((...args: any[]) => any) | undefined;
+            onClose?: ((...args: any[]) => any) | undefined;
+            "onCategory-select"?: ((...args: any[]) => any) | undefined;
+            "onItem-hover"?: ((...args: any[]) => any) | undefined;
+        }>, {
+            handleKeyDown: (e: KeyboardEvent) => void;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+            select: (...args: any[]) => void;
+            close: (...args: any[]) => void;
+            "category-select": (...args: any[]) => void;
+            "item-hover": (...args: any[]) => void;
+        }, string, {
+            loading: boolean;
+            title: string;
+            categories: Category[];
+            maxVisibleItems: number;
+        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{
+        loading: boolean;
+        title: string;
+        categories: Category[];
+        maxVisibleItems: number;
+    }> & Omit<Readonly<import('vue').ExtractPropTypes<{
+        items: {
+            type: import('vue').PropType<SuggestionItem[]>;
+            required: true;
+        };
+        categories: {
+            type: import('vue').PropType<Category[]>;
+            default: () => never[];
+        };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        title: {
+            type: StringConstructor;
+            default: string;
+        };
+        maxVisibleItems: {
+            type: NumberConstructor;
+            default: number;
+        };
+    }>> & Readonly<{
+        onSelect?: ((...args: any[]) => any) | undefined;
+        onClose?: ((...args: any[]) => any) | undefined;
+        "onCategory-select"?: ((...args: any[]) => any) | undefined;
+        "onItem-hover"?: ((...args: any[]) => any) | undefined;
+    }>, "handleKeyDown" | ("loading" | "title" | "categories" | "maxVisibleItems")> & import('vue').ShallowUnwrapRef<{
+        handleKeyDown: (e: KeyboardEvent) => void;
+    }> & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            'title-icon'?(_: {}): any;
+            'loading-indicator'?(_: {}): any;
+            item?(_: {
+                item: SuggestionItem;
+                active: boolean;
+            }): any;
+            empty?(_: {}): any;
+        };
+    }) | null;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/suggestion/utils/dom.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 测量元素文本宽度
+ * @param text 要测量的文本
+ * @param className 应用的样式类名
+ * @returns 测量后的宽度
+ */
+export declare function measureTextWidth(text: string, className?: string): number;
+/**
+ * 确保元素在容器中可见
+ * @param container 容器元素
+ * @param element 需要显示的元素
+ */
+export declare function ensureElementVisible(container: HTMLElement, element: HTMLElement): void;
+/**
+ * 带缓存的文本宽度测量
+ * @param text 要测量的文本
+ * @param className 样式类名
+ * @returns 测量后的宽度
+ */
+export declare function getCachedTextWidth(text: string, className?: string): number;