@kine-design/crud 0.0.1-beta.2 → 0.0.1-beta.21

package/dist/components/formPage/KApprovalDialog.d.ts

@@ -0,0 +1,99 @@
+import { PropType } from 'vue';
+export type ApprovalType = 'submit' | 'approve' | 'reject';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** 弹窗是否可见 */
+    visible: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 审批类型 */
+    type: {
+        type: PropType<ApprovalType>;
+        default: string;
+    };
+    /** 自定义标题，不传则使用默认 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 描述文字 */
+    description: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 摘要信息，如 "PO-2024-0087 | 供应商: 三星纺织 | ¥156,200" */
+    summary: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 备注输入框占位文本 */
+    remarkPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 备注是否必填（reject 默认必填） */
+    remarkRequired: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** 确认中加载态 */
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element | null, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, ("cancel" | "update:visible" | "confirm")[], "cancel" | "update:visible" | "confirm", import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** 弹窗是否可见 */
+    visible: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 审批类型 */
+    type: {
+        type: PropType<ApprovalType>;
+        default: string;
+    };
+    /** 自定义标题，不传则使用默认 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 描述文字 */
+    description: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 摘要信息，如 "PO-2024-0087 | 供应商: 三星纺织 | ¥156,200" */
+    summary: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 备注输入框占位文本 */
+    remarkPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 备注是否必填（reject 默认必填） */
+    remarkRequired: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** 确认中加载态 */
+    loading: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{
+    onCancel?: ((...args: any[]) => any) | undefined;
+    "onUpdate:visible"?: ((...args: any[]) => any) | undefined;
+    onConfirm?: ((...args: any[]) => any) | undefined;
+}>, {
+    type: ApprovalType;
+    summary: string;
+    title: string;
+    loading: boolean;
+    visible: boolean;
+    description: string;
+    remarkPlaceholder: string;
+    remarkRequired: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/formPage/KFormCard.d.ts

@@ -0,0 +1,49 @@
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** 区块标题 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 副标题 */
+    subtitle: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 是否可折叠 */
+    collapsible: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 初始是否折叠 */
+    defaultCollapsed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** 区块标题 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 副标题 */
+    subtitle: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 是否可折叠 */
+    collapsible: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 初始是否折叠 */
+    defaultCollapsed: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    title: string;
+    subtitle: string;
+    collapsible: boolean;
+    defaultCollapsed: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/formPage/KFormPage.d.ts

@@ -0,0 +1,14 @@
+import { PropType } from 'vue';
+import { FormPageConfig } from '../../composables/form/types';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    config: {
+        type: PropType<FormPageConfig>;
+        required: true;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    config: {
+        type: PropType<FormPageConfig>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/formPage/KMasterDetailPage.d.ts

@@ -0,0 +1,14 @@
+import { PropType } from 'vue';
+import { MasterDetailPageConfig } from '../../composables/form/types';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    config: {
+        type: PropType<MasterDetailPageConfig>;
+        required: true;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    config: {
+        type: PropType<MasterDetailPageConfig>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/formPage/KStickyActionBar.d.ts

@@ -0,0 +1,16 @@
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /** 左侧辅助信息，如"最后保存: 今天 14:23" */
+    hint: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /** 左侧辅助信息，如"最后保存: 今天 14:23" */
+    hint: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    hint: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/formPage/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @description formPage components barrel export
+ * @author 阿怪
+ * @date 2026/3/22
+ * @version v0.0.1
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { default as KFormCard } from './KFormCard';
+export { default as KStickyActionBar } from './KStickyActionBar';
+export { default as KApprovalDialog } from './KApprovalDialog';
+export type { ApprovalType } from './KApprovalDialog';
+export { default as KFormPage } from './KFormPage';
+export { default as KMasterDetailPage } from './KMasterDetailPage';

package/dist/components/layout/KLayout.d.ts

@@ -1,7 +1,10 @@
-export declare const LAYOUT_COLLAPSED_KEY: unique symbol;
-export declare const LAYOUT_TOGGLE_KEY: unique symbol;
-export declare const LAYOUT_SIDER_WIDTH_KEY: unique symbol;
-export declare const LAYOUT_COLLAPSED_WIDTH_KEY: unique symbol;
+import { InjectionKey, Ref } from 'vue';
+export declare const LAYOUT_COLLAPSED_KEY: InjectionKey<Ref<boolean>>;
+export declare const LAYOUT_TOGGLE_KEY: InjectionKey<() => void>;
+export declare const LAYOUT_SIDER_WIDTH_KEY: InjectionKey<string>;
+export declare const LAYOUT_COLLAPSED_WIDTH_KEY: InjectionKey<string>;
+export declare const LAYOUT_DRAWER_OPEN_KEY: InjectionKey<Ref<boolean>>;
+export declare const LAYOUT_TOGGLE_DRAWER_KEY: InjectionKey<() => void>;
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     /** 受控模式：外部传入 collapsed 状态 */
     collapsed: {

package/dist/composables/auth/useAuth.d.ts

@@ -1,5 +1,10 @@
 import { App } from 'vue';
 import { AuthOptions, AuthReturn } from './types';
+/** 内部 provide 结构，包含 auth 实例与 onUnauthorized 回调 */
+interface AuthProvide {
+    auth: AuthReturn;
+    onUnauthorized: (() => void) | undefined;
+}
 /**
  * 创建全局 auth 实例并安装到 Vue App。
  * 应在 main.ts 中调用一次，之后所有组件可通过 useAuth() 获取。
@@ -19,11 +24,6 @@ import { AuthOptions, AuthReturn } from './types';
  * ```
  */
 export declare function createAuth(app: App, options: AuthOptions): AuthReturn;
-/** 内部 provide 结构，包含 auth 实例与 onUnauthorized 回调 */
-interface AuthProvide {
-    auth: AuthReturn;
-    onUnauthorized: (() => void) | undefined;
-}
 /**
  * 在组件中获取全局 auth 实例。
  * 必须在 createAuth() 已安装的 App 子树内调用。

package/dist/composables/error/types.d.ts

@@ -1,3 +1,4 @@
+import { InjectionKey } from 'vue';
 import { UserFeedbackHandler, NetworkError, BusinessError } from '../request/types';
 /**
  * @description 全局错误处理模块类型定义
@@ -14,7 +15,7 @@ export type ErrorLevel = 'info' | 'warning' | 'error' | 'success';
 /** 401 未授权时的处理方式 */
 export type UnauthorizedStrategy = 'redirect' | 'dialog';
 /** provide/inject 使用的唯一 symbol key，避免命名冲突 */
-export declare const ERROR_HANDLER_INJECT_KEY: unique symbol;
+export declare const ERROR_HANDLER_INJECT_KEY: InjectionKey<ErrorHandlerOptions>;
 /** createErrorHandler 配置项 */
 export interface ErrorHandlerOptions {
     /** 用户反馈处理器，默认使用 defaultFeedbackHandler */

package/dist/composables/form/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @description form composables barrel export
+ * @author 阿怪
+ * @date 2026/3/22
+ * @version v0.0.1
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { useFormPage } from './useFormPage';
+export type { UseFormPageOptions, UseFormPageReturn } from './useFormPage';
+export { renderFormField } from './renderFormField';
+export type { FormFieldType, FormFieldConfig, FormPageConfig, DetailTableConfig, MasterDetailPageConfig, } from './types';

package/dist/composables/form/renderFormField.d.ts

@@ -0,0 +1,11 @@
+import { FormFieldConfig } from './types';
+/**
+ * 渲染单个表单字段控件。
+ *
+ * @param field        字段配置
+ * @param formData     响应式表单数据对象（reactive）
+ * @param errors       当前校验错误集合（已解包，非 Ref）
+ * @param validateField 触发单字段校验的函数
+ * @param slots        组件 slots，用于支持 `field-{param}` 自定义插槽
+ */
+export declare function renderFormField(field: FormFieldConfig, formData: Record<string, unknown>, errors: Record<string, string>, validateField: (param: string) => void, slots: Record<string, ((...args: unknown[]) => unknown) | undefined>): unknown;

package/dist/composables/form/types.d.ts

@@ -0,0 +1,104 @@
+import { EditableColumn } from '../../components/editableTable';
+/** 表单字段类型 */
+export type FormFieldType = 'text' | 'number' | 'select' | 'date' | 'textarea' | 'switch' | 'autocomplete' | 'custom';
+/** 表单字段配置 */
+export interface FormFieldConfig {
+    /** 字段名，对应数据对象的 key */
+    param: string;
+    /** 标签文本 */
+    label: string;
+    /** 字段类型 */
+    type?: FormFieldType;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否必填 */
+    required?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 跨列数（默认 1，textarea 常用 'full' 表示占满整行） */
+    span?: number | 'full';
+    /** select 类型的选项 */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    /** autocomplete 的 fetchSuggestions */
+    fetchSuggestions?: (query: string) => Promise<Array<{
+        label: string;
+        value: string | number;
+    }>>;
+    /** number 类型的前缀（如 ¥） */
+    prefix?: string;
+    /** number 类型的后缀（如 米、件） */
+    suffix?: string;
+    /** textarea 的行数 */
+    rows?: number;
+    /** textarea 的最大字数 */
+    maxLength?: number;
+    /** 自定义校验函数 */
+    validator?: (value: unknown, formData: Record<string, unknown>) => string | undefined;
+}
+/** SimpleFormPage 完整配置 */
+export interface FormPageConfig {
+    /** 页面标题 */
+    title: string;
+    /** API 路径 */
+    api: string;
+    /** 表单字段定义 */
+    fields: FormFieldConfig[];
+    /** 列数布局（默认 2） */
+    columns?: 1 | 2 | 3;
+    /** 主键字段（编辑模式下从路由取 id，默认 'id'） */
+    rowKey?: string;
+    /** 保存成功后跳转路径 */
+    redirectPath?: string;
+    /** 是否显示"保存草稿"按钮 */
+    showDraft?: boolean;
+    /** 提交按钮文本 */
+    submitText?: string;
+}
+/** 子表配置 */
+export interface DetailTableConfig {
+    /** 子表标题 */
+    title: string;
+    /** 子表字段名（对应主表数据中的数组字段） */
+    param: string;
+    /** 列定义（复用 EditableColumn） */
+    columns: EditableColumn[];
+    /** 是否显示汇总行 */
+    showSummary?: boolean;
+    /** 汇总行标签 */
+    summaryLabel?: string;
+    /** 币种前缀 */
+    currencyPrefix?: string;
+    /** 新增行按钮文本 */
+    addText?: string;
+}
+/** MasterDetailPage 完整配置 */
+export interface MasterDetailPageConfig {
+    /** 页面标题 */
+    title: string;
+    /** API 路径 */
+    api: string;
+    /** 面包屑路径 */
+    breadcrumb?: Array<{
+        label: string;
+        path?: string;
+    }>;
+    /** 主表字段定义 */
+    fields: FormFieldConfig[];
+    /** 主表列数布局（默认 3） */
+    columns?: 1 | 2 | 3;
+    /** 子表配置（支持多个子表） */
+    detailTables: DetailTableConfig[];
+    /** 主键字段 */
+    rowKey?: string;
+    /** 保存成功后跳转路径 */
+    redirectPath?: string;
+    /** 是否显示"保存草稿"按钮 */
+    showDraft?: boolean;
+    /** 提交按钮文本 */
+    submitText?: string;
+}

package/dist/composables/form/useFormPage.d.ts

@@ -0,0 +1,38 @@
+import { Ref } from 'vue';
+import { useRouter } from 'vue-router';
+import { FormFieldConfig } from './types';
+export interface UseFormPageOptions {
+    /** API 路径 */
+    api: string;
+    /** 字段配置 */
+    fields: FormFieldConfig[];
+    /** 主键字段 */
+    rowKey?: string;
+    /** 保存成功后跳转路径 */
+    redirectPath?: string;
+}
+export interface UseFormPageReturn {
+    /** 表单数据 */
+    formData: Record<string, unknown>;
+    /** 是否编辑模式（路由有 id） */
+    isEdit: Ref<boolean>;
+    /** 加载中 */
+    loading: Ref<boolean>;
+    /** 提交中 */
+    submitting: Ref<boolean>;
+    /** 字段错误信息 */
+    errors: Ref<Record<string, string>>;
+    /** 校验全部字段 */
+    validate: () => boolean;
+    /** 校验单个字段 */
+    validateField: (param: string) => string | undefined;
+    /** 提交表单 */
+    submit: (extraData?: Record<string, unknown>) => Promise<boolean>;
+    /** 保存草稿（不校验必填） */
+    saveDraft: (extraData?: Record<string, unknown>) => Promise<boolean>;
+    /** 返回上一页 */
+    goBack: () => void;
+    /** 路由实例 */
+    router: ReturnType<typeof useRouter>;
+}
+export declare function useFormPage(options: UseFormPageOptions): UseFormPageReturn;

package/dist/composables/index.d.ts

@@ -7,6 +7,8 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 export { defineRepository } from './defineRepository';
+export { useAutoCompleteSearch } from './search';
+export type { AutoCompleteSearchOptions, AutoCompleteSearchReturn } from './search';
 export { setupCrud } from './setupCrud';
 export type { EntityId, ListParams, MutationOptions, Repository, RepositoryEndpoints, UseListReturn, UseDetailReturn, UseMutationReturn, } from './types';
 export { defineCrudRoutes, createTabStore, useTabStore, useMenuFromRoutes, createRouterGuard, addTabFromRoute, } from './router';

package/dist/composables/page/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description CrudPage composable barrel export
+ * @author 阿怪
+ * @date 2026/3/22
+ * @version v0.0.1
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { useCrudPage } from './useCrudPage';
+export type { CrudPageConfig, CrudColumnConfig, CrudFilterConfig, StatusMapItem } from './types';

package/dist/composables/page/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @description CrudPage 配置驱动页面类型定义
+ * @author 阿怪
+ * @date 2026/3/22
+ * @version v0.0.1
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+/** 列配置 */
+export interface CrudColumnConfig {
+    /** 字段名，对应数据对象的 key */
+    param: string;
+    /** 列标题 */
+    label: string;
+    /** 列宽 */
+    width?: string;
+    /** 列类型，影响渲染方式 */
+    type?: 'text' | 'status' | 'date' | 'datetime' | 'image';
+}
+/** 筛选项配置 */
+export interface CrudFilterConfig {
+    /** 字段名，作为请求参数的 key */
+    param: string;
+    /** 筛选项标签 */
+    label: string;
+    /** 筛选项类型 */
+    type: 'input' | 'select';
+    /** select 类型的选项列表 */
+    options?: {
+        label: string;
+        value: string | number;
+    }[];
+    /** 占位文本 */
+    placeholder?: string;
+}
+/** 状态映射：字段值 → KTag 的 label + type */
+export type StatusMapItem = {
+    label: string;
+    type?: 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+};
+/** CrudPage 完整配置 */
+export interface CrudPageConfig {
+    /** 页面标题 */
+    title: string;
+    /** API 路径（基于 createRequest 的 baseURL） */
+    api: string;
+    /** 列定义 */
+    columns: CrudColumnConfig[];
+    /** 筛选项定义，为空则不显示搜索区 */
+    filters?: CrudFilterConfig[];
+    /** 状态字段的值 → 显示文本 + 标签颜色 映射 */
+    statusMap?: Record<string, StatusMapItem>;
+    /** 每页条数，默认 20 */
+    pageSize?: number;
+    /** 行主键字段，默认 'id' */
+    rowKey?: string;
+    /** 详情页路由前缀，用于构建查看/编辑路由：`${detailPath}/${row[rowKey]}` */
+    detailPath?: string;
+    /** 图片列 src 转换函数，将原始值转为可访问 URL */
+    imageResolver?: (raw: string) => string;
+}

package/dist/composables/page/useCrudPage.d.ts

@@ -0,0 +1,14 @@
+import { CrudPageConfig } from './types';
+export declare function useCrudPage(config: CrudPageConfig): {
+    page: import('vue').Ref<number, number>;
+    pageSize: import('vue').Ref<number, number>;
+    total: import('vue').Ref<number, number>;
+    totalPages: import('vue').ComputedRef<number>;
+    list: import('vue').Ref<Record<string, unknown>[], Record<string, unknown>[]>;
+    loading: import('vue').Ref<boolean, boolean>;
+    filters: Record<string, unknown>;
+    fetchData: () => Promise<void>;
+    onPageChange: (p: number) => void;
+    onSearch: () => void;
+    onReset: () => void;
+};

package/dist/composables/request/createRequest.d.ts

@@ -1,6 +1,8 @@
 import { RequestMethod, RequestOptions } from './types';
 import { RequestBuilder } from './requestBuilder';
 export interface RequestClient {
+    /** 请求基础 URL */
+    readonly baseURL: string;
     /** 简便方法，直接返回 Promise<T> */
     send<T>(method: RequestMethod, url: string, body?: unknown): Promise<T>;
     /** GET 请求 */

package/dist/composables/request/requestBuilder.d.ts

@@ -8,6 +8,8 @@ export interface RequestBuilderContext {
     getToken?: () => string | null | undefined;
     onUnauthorized?: () => void;
     responseInterceptor?: <T>(data: T) => T;
+    /** 用户反馈处理器（写操作成功后自动 showSuccess） */
+    feedback?: import('./types').UserFeedbackHandler;
     /** 注册 abort controller，供生命周期管理 */
     registerAbort?: (controller: AbortController) => void;
 }

package/dist/composables/search/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description search composables barrel export
+ * @author 阿怪
+ * @date 2026/3/22
+ * @version v0.0.1
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+export { useAutoCompleteSearch } from './useAutoCompleteSearch';
+export type { AutoCompleteSearchOptions, AutoCompleteSearchReturn } from './useAutoCompleteSearch';

package/dist/composables/search/useAutoCompleteSearch.d.ts

@@ -0,0 +1,50 @@
+import { Ref, ShallowRef } from 'vue';
+export interface AutoCompleteSearchOptions<T = any> {
+    /** API 路径，如 '/supplier' */
+    api: string;
+    /** 搜索参数名，如 'nameLike'，输入值会赋给这个 key */
+    searchKey: string;
+    /** 显示字段名，如 'supplierName'，用于回填输入框 */
+    labelKey: string;
+    /** 值字段名，默认 'id' */
+    valueKey?: string;
+    /** 每次搜索返回条数，默认 5 */
+    pageSize?: number;
+    /** 额外的固定查询参数 */
+    extraParams?: Record<string, unknown>;
+    /** 自定义过滤函数 */
+    filter?: (item: T) => boolean;
+    /** 自定义映射函数，将 API 返回的数据转换为 AutoComplete 需要的格式 */
+    mapFn?: (item: T) => {
+        label: string;
+        value: string | number;
+        raw: T;
+    };
+}
+export interface AutoCompleteSearchReturn<T = any> {
+    /** 输入框绑定值 */
+    inputValue: Ref<string>;
+    /** 建议列表 */
+    suggestions: ShallowRef<Array<{
+        label: string;
+        value: string | number;
+        raw: T;
+    }>>;
+    /** 加载状态 */
+    loading: Ref<boolean>;
+    /** 当前选中的原始数据 */
+    selected: ShallowRef<T | null>;
+    /** 搜索回调，绑定给 KAutoComplete 的 onSearch / fetchSuggestions */
+    onSearch: (query: string) => Promise<void>;
+    /** 选中回调 */
+    onSelect: (item: {
+        label: string;
+        value: string | number;
+        raw: T;
+    }) => void;
+    /** 清空选中 */
+    onClear: () => void;
+    /** 手动设置选中值（用于表单回填） */
+    setValue: (label: string, data: T | null) => void;
+}
+export declare function useAutoCompleteSearch<T = any>(options: AutoCompleteSearchOptions<T>): AutoCompleteSearchReturn<T>;