@hzab/data-model 2.0.3-alpha.0 → 2.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,1305 @@
+import * as _axios from 'axios';
+import { AxiosRequestConfig, InternalAxiosRequestConfig, AxiosResponse, AxiosInstance } from 'axios';
+
+/**
+ * 接口缓存
+ *
+ * 在本地模型上，将 axios 请求配置中的 `cache` 字段设置为 `CacheItem`，
+ * 即可在请求拦截器中自动缓存请求结果。
+ *
+ * 在响应拦截器中，如果请求命中缓存，则直接返回缓存结果，
+ * 否则继续执行请求，并将结果缓存。
+ *
+ * 缓存结果的过期时间由 `cacheTTL` 配置，默认 3000 毫秒。
+ */
+
+/**
+ * 缓存配置
+ */
+interface CacheOpt {
+    /** 缓存时间 毫秒 */
+    cacheTTL?: number;
+}
+/**
+ * 缓存方法入参配置
+ */
+interface RequestCacheParams {
+    options?: CacheOpt;
+}
+/**
+ * 接口入参（用于生成缓存 key）
+ */
+interface Req {
+    method?: string;
+    baseURL?: string;
+    url?: string;
+    params?: unknown;
+    data?: unknown;
+}
+/**
+ * 缓存对象
+ */
+interface CacheItem {
+    key: string;
+    /** 过期时间戳 */
+    expires: number;
+    /** 缓存的 promise（进行中或已 settled） */
+    promise: Promise<unknown>;
+    /** 缓存的 axios config 配置 */
+    config?: InternalAxiosRequestConfig;
+    resolve: (d: unknown) => void;
+    reject: (err: unknown) => void;
+    /** 首个请求是否已结束 */
+    settled?: boolean;
+    /** 是否已成功写入结果（仅成功响应进入结果缓存） */
+    hasResult?: boolean;
+    /** 从所属 RequestCache 中移除本条目 */
+    clear?: () => void;
+}
+/**
+ * 命中缓存时 reject 的错误对象（供响应拦截器识别）
+ */
+interface CacheHitError {
+    from: "cache";
+    code: 200;
+    key: string;
+    config: InternalAxiosRequestConfig;
+    cache: CacheItem;
+}
+/**
+ * 是否为缓存命中错误
+ */
+declare function isCacheHitError(error: unknown): error is CacheHitError;
+/**
+ * 接口缓存类
+ * - 进行中：相同 key 复用同一个 promise（请求去重）
+ * - 成功后：在 TTL 内复用结果；失败不保留结果缓存
+ */
+declare class RequestCache {
+    options: CacheOpt;
+    cacheTTL: number;
+    _cacheMap: Map<string, CacheItem>;
+    constructor(params?: RequestCacheParams);
+    /**
+     * 处理 axios request 拦截逻辑
+     */
+    handleAxRequest(config: InternalAxiosRequestConfig & {
+        cache?: CacheItem;
+    }): (InternalAxiosRequestConfig<any, any> & {
+        cache?: CacheItem;
+    }) | Promise<never>;
+    /**
+     * 缓存是否仍有效（未过期）
+     */
+    isFresh(cache?: CacheItem | null): cache is CacheItem;
+    /**
+     * 判断是否存在可复用缓存（进行中，或 TTL 内的成功结果）
+     */
+    hasCache(axConf: Req): boolean;
+    /**
+     * 获取缓存
+     */
+    getCache(axConf: Req): CacheItem | undefined;
+    /**
+     * 按 key 获取未过期缓存
+     */
+    getCacheByKey(key: string): CacheItem | undefined;
+    /**
+     * 添加缓存
+     */
+    addCache(data: CacheItem, opt?: CacheOpt): CacheItem;
+    rmCache(config: Req): void;
+    /**
+     * 获取缓存的 key
+     */
+    getCacheKey(config?: Req): string;
+    /**
+     * 序列化对象，保证属性顺序一致
+     */
+    private stableStringify;
+}
+
+declare const TOKEN = "token";
+interface AxiosRequestConfigWithCache extends InternalAxiosRequestConfig {
+    cache?: CacheItem;
+}
+type AxiosResponseCus = AxiosResponse & {
+    config: AxiosRequestConfigWithCache;
+};
+declare const axios: AxiosInstance;
+/**
+ * 创建带共享拦截器（RequestCache）的 axios 实例。
+ * 不替换默认 `axios`；多 baseURL / 单测注入优先用本工厂 + `DataModel({ axios })`。
+ * 若需被后续 `setAx*` 批量作用，再 `registerAxios([client])`。
+ */
+declare function createAxiosClient(config?: AxiosRequestConfig): AxiosInstance;
+/**
+ * 处理错误回调函数的选项接口
+ */
+interface HandleErrCbOptions {
+    /** 直接替换回调函数 */
+    replaceErrCb?: boolean;
+    /** 日志前缀 */
+    logPrefix?: string;
+    /**
+     * 稳定 id：同实例同 id 再次挂载时先 eject 旧拦截器（幂等）。
+     * 不传则每次追加一层（多次调用会重复触发）。
+     */
+    id?: string;
+}
+/**
+ * setToken 选项接口
+ */
+interface SetTokenOptions {
+    /** 是否同时设置 cookie */
+    hasCookie?: boolean;
+    /** cookie 属性配置 */
+    cookieAttrs?: Record<string, unknown>;
+}
+/**
+ * getToken 选项接口
+ */
+interface GetTokenOptions {
+    /** 是否从 cookie 获取 */
+    hasCookie?: boolean;
+}
+/**
+ * 设置 token（localStorage 便捷封装，并同步 Authorization）
+ * @param token token 值
+ * @param opt 选项（`hasCookie` 需要已安装 optional peer `js-cookie`，否则仅写 localStorage）
+ */
+declare function setToken(token?: string, opt?: SetTokenOptions): void;
+/**
+ * 获取 token（localStorage 优先；`hasCookie` 时尽力读 cookie，未加载则回退 localStorage）
+ * @param opt 选项
+ * @returns token 值
+ */
+declare function getToken(opt?: GetTokenOptions): string;
+declare const temp: {
+    axiosList: AxiosInstance[];
+};
+/**
+ * 将 axios 实例登记进列表，供后续 `setAx*` 批量作用（按引用去重）。
+ * 只作用于调用当时已在列表中的实例；后登记的实例不会自动补上已挂过的拦截器。
+ * @param axiosList axios 实例列表
+ * @returns 更新后的 axios 实例列表
+ */
+declare function registerAxios(axiosList: AxiosInstance[]): AxiosInstance[];
+/**
+ * @deprecated 旧写法别名；等价 `registerAxios`。
+ */
+declare const setAxios: typeof registerAxios;
+/**
+ * @deprecated 旧写法；设置默认 axios 实例，供未显式传 `axios` 的 DataModel 兜底。
+ */
+declare function setDefaultAxios(ax?: AxiosInstance): void;
+/** 读取默认 axios 实例（供 DataModel 构造兜底） */
+declare function getDefaultAxios(): AxiosInstance | undefined;
+/**
+ * 为当前 `axiosList` 中的实例挂请求拦截器。
+ * 仅作用于调用当时已登记的实例；后 `registerAxios` 的实例不会自动继承。
+ * 传入 `opt.id` 时可幂等替换同 id 拦截器；不传 id 则每次追加。
+ */
+declare function setAxRequest(cb: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig | Promise<InternalAxiosRequestConfig>, errCb?: (error: any) => Promise<any>, opt?: HandleErrCbOptions): void;
+/**
+ * 为当前 `axiosList` 中的实例挂响应拦截器。
+ * 语义同 `setAxRequest`（当时列表 / 可选 `opt.id` 幂等）。
+ */
+declare function setAxResponse(cb: (response: AxiosResponse) => AxiosResponse | Promise<AxiosResponse>, errCb?: (error: unknown) => Promise<unknown>, opt?: HandleErrCbOptions): void;
+/**
+ * 处理错误回调函数
+ * @param errCb 错误回调
+ * @param opt 选项
+ * @returns 处理后的错误回调
+ */
+declare function handleErrCb(errCb?: (error: any) => Promise<any>, opt?: HandleErrCbOptions): (error: any) => Promise<any>;
+/**
+ * 设置 axios.defaults
+ * @param key 配置键
+ * @param val 配置值
+ */
+declare function setAxDefaults(key: string, val: any): void;
+/**
+ * 设置 headers
+ * @param key header 键
+ * @param val header 值
+ */
+declare function setAxHeaders(key: string, val: any): void;
+/**
+ * 设置 timeout
+ * @param timeout 超时时间
+ */
+declare function setAxTimeout(timeout?: number): void;
+/**
+ * 设置 Authorization token
+ * @param token token 值
+ */
+declare function setAxAuthorization(token: string): void;
+/**
+ * 设置 baseUrl
+ * @param url 基础 URL
+ */
+declare function setAxBaseUrl(url: string): void;
+/**
+ * 获取 AbortController，用于取消请求（推荐，配合 axios config.signal）
+ * @returns AbortController
+ */
+declare function createAbortController(): AbortController;
+/**
+ * @deprecated 旧写法；获取 axios.CancelToken.source，用于取消请求。
+ * 新页面推荐 `createAbortController` + `signal`。
+ * @returns CancelToken source
+ */
+declare function getCancelTokenSource(): _axios.CancelTokenSource;
+/**
+ * 检查是否是 cancel / abort 的结果
+ */
+declare function isCancel(res: unknown): boolean;
+
+/**
+ * 通用 JSON 对象类型
+ */
+type JSONObject = Record<string, any>;
+/**
+ * 查询参数类型
+ */
+type QueryParams = JSONObject;
+/**
+ * 请求数据类型
+ */
+type RequestData = JSONObject;
+/**
+ * 响应数据类型
+ */
+interface ResponseData<T = Record<string, any>> extends AxiosResponse {
+    data: ResData<T>;
+}
+/**
+ * 接口返回数据格式
+ */
+interface ResData<T = Record<string, any>> {
+    code: number;
+    data: T;
+    msg: string;
+}
+/**
+ * Axios 配置类型
+ */
+type AxiosConfig = AxiosRequestConfig;
+/**
+ * 数据映射函数类型（入参 / 出参同为 `T`，与实体泛型贯通）
+ * @template T - 映射数据类型
+ */
+type MapFunction<T = any> = (data: T) => T;
+/**
+ * 带原始参数的映射函数类型（用于请求前处理，支持同步 / 异步）
+ * @template T - 处理后的参数类型
+ * @template P - 原始参数类型
+ */
+type RequestMapFunction<T = RequestData, P = unknown> = (params: T, originalParams?: P) => T | Promise<T>;
+/**
+ * 列表请求返回结果接口
+ * @template T - 列表项数据类型
+ */
+interface GetListResult<T = Record<string, any>> {
+    /** 列表数据 */
+    list: T[];
+    /** 分页信息 */
+    pagination: {
+        current?: number;
+        total: number;
+        pageSize?: number;
+    };
+    /** 其他扩展字段 */
+    [key: string]: any;
+}
+/**
+ * 自定义列表请求函数类型
+ * @template T - 列表项数据类型
+ */
+type GetListFunc<T = Record<string, any>> = (query: QueryParams) => Promise<GetListResult<T>>;
+/**
+ * @deprecated 旧写法响应处理函数；2.1 兼容层。设置后 `handleRes` 走旧分支，否则走 `responseAdapter`。
+ */
+type HandleResponseFunc = (response: AxiosResponse) => ResponseData;
+
+/**
+ * 三端 CRUD 正式契约。本地模型可对 `ctx` / `axiosConf` 忽略（签名对齐）。
+ * List 页消费子集类型由 `@hzab/data-display` 的 `ListRenderModel` 定义，本包不耦合 UI。
+ */
+interface ICrudModel<T = Record<string, any>> {
+    query: QueryParams;
+    ctx?: Record<string, any>;
+    get(q?: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T | null>;
+    getList(q?: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<GetListResult<T>>;
+    create(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    update(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    patch(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    delete(config: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<unknown>;
+    multipleDelete(config: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+}
+
+/**
+ * 删除请求配置（对齐 axios.delete：params / data）
+ */
+interface ModelDeleteConfig {
+    params?: Record<string, any>;
+    data?: Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * 批量删除结果
+ */
+interface MultipleDeleteResult {
+    sucList: any[];
+    failList: any[];
+}
+/**
+ * 三端 DataModel 共用的 CRUD / maps 构造参数。
+ * `*Api` 在本地模型上可为形态对齐占位；`*Map` 与实体泛型 `T` 贯通。
+ */
+interface CrudModelOptions<T = Record<string, any>> {
+    /**
+     * 非空则按 key 复用实例（各端 registry 带前缀，互不冲突）。
+     * 首次创建写入 registry；再次 `new` / `getInstance` 同 key 返回已有实例。
+     * 默认不传 = 每次 new 新实例（测试 / 临时模型）。
+     */
+    singletonKey?: string;
+    /** 请求 url 替换的额外参数 */
+    ctx?: JSONObject;
+    /** GET 请求的参数 */
+    query?: QueryParams;
+    /** POST 接口地址 */
+    createApi?: string;
+    /** GET 详情 接口地址 */
+    getApi?: string;
+    /** GET 列表 接口地址 */
+    getListApi?: string;
+    /** GET 列表 接口回调，用于自定义列表请求接口 */
+    getListFunc?: GetListFunc<T>;
+    /** PUT 接口地址 */
+    updateApi?: string;
+    /** PATCH 接口地址 */
+    patchApi?: string;
+    /** DELETE 接口地址 */
+    deleteApi?: string;
+    /** DELETE 批量删除 接口地址 */
+    multipleDeleteApi?: string;
+    /** GET 列表 接口请求前数据处理回调 */
+    getListReqMap?: RequestMapFunction<QueryParams>;
+    /** GET 列表 接口请求结果数据处理回调 */
+    getListResMap?: MapFunction<GetListResult<T>>;
+    /** GET 详情 接口请求前数据处理回调 */
+    getReqMap?: RequestMapFunction<QueryParams>;
+    /** GET 详情 接口请求结果数据处理回调 */
+    getResMap?: MapFunction<T>;
+    /** POST 接口请求前数据处理回调 */
+    createReqMap?: RequestMapFunction<RequestData>;
+    /** POST 接口请求结果数据处理回调 */
+    createResMap?: MapFunction<T>;
+    /** PUT 接口请求前数据处理回调 */
+    updateReqMap?: RequestMapFunction<RequestData>;
+    /** PUT 接口请求结果数据处理回调 */
+    updateResMap?: MapFunction<T>;
+    /** PATCH 接口请求前数据处理回调 */
+    patchReqMap?: RequestMapFunction<RequestData>;
+    /** PATCH 接口请求结果数据处理回调 */
+    patchResMap?: MapFunction<T>;
+    /** DELETE 接口请求前数据处理回调 */
+    deleteReqMap?: RequestMapFunction<JSONObject>;
+    /** DELETE 接口请求结果数据处理回调 */
+    deleteResMap?: MapFunction;
+    /** DELETE 批量删除 接口请求前数据处理回调 */
+    multipleDeleteReqMap?: RequestMapFunction<JSONObject>;
+    /** DELETE 批量删除 接口请求结果数据处理回调 */
+    multipleDeleteResMap?: MapFunction<MultipleDeleteResult>;
+    /**
+     * @deprecated 旧写法字段；2.1 仅保留供旧 list-render 提交前直接调用。
+     * `create()` 内部只跑 `createReqMap`，不会二次调用本字段。
+     */
+    createMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；仅保留供旧 list-render 提交前直接调用。
+     * `update()` 内部只跑 `updateReqMap`，不会二次调用本字段。
+     */
+    updateMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；仅保留供旧 list-render 提交前直接调用。
+     * `patch()` 内部只跑 `patchReqMap`，不会二次调用本字段。
+     */
+    patchMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；`get()` 内先跑本字段再跑 `getResMap`（先旧后新）。
+     */
+    getMap?: MapFunction<T>;
+    /**
+     * @deprecated 旧写法字段；`getList()` 内逐条 map `list[]`（不是 `getListResMap` 的 1:1）。
+     */
+    getListMap?: MapFunction<T>;
+}
+/**
+ * DataModel / ArrayDataModel / IndexedDbDataModel 的共性基类：
+ * CRUD 模板（ReqMap → do* → ResMap）、query 合并、本地入参处理、删除 id 解析、configure。
+ * 子类只实现 `doGet` / `doGetList` / `doCreate` / …
+ */
+declare abstract class BaseDataModel<T = Record<string, any>> implements ICrudModel<T> {
+    /** 注册用 key（不含端前缀）；无单例时为 undefined */
+    readonly singletonKey?: string;
+    ctx: Record<string, any>;
+    query: QueryParams;
+    createApi?: string;
+    getApi?: string;
+    getListApi?: string;
+    getListFunc?: GetListFunc<T>;
+    updateApi?: string;
+    patchApi?: string;
+    deleteApi?: string;
+    multipleDeleteApi?: string;
+    getListReqMap?: RequestMapFunction<QueryParams>;
+    getListResMap?: MapFunction<GetListResult<T>>;
+    getReqMap?: RequestMapFunction<QueryParams>;
+    getResMap?: MapFunction<T>;
+    createReqMap?: RequestMapFunction<RequestData>;
+    createResMap?: MapFunction<T>;
+    updateReqMap?: RequestMapFunction<RequestData>;
+    updateResMap?: MapFunction<T>;
+    patchReqMap?: RequestMapFunction<RequestData>;
+    patchResMap?: MapFunction<T>;
+    deleteReqMap?: RequestMapFunction<JSONObject>;
+    deleteResMap?: MapFunction;
+    multipleDeleteReqMap?: RequestMapFunction<JSONObject>;
+    multipleDeleteResMap?: MapFunction<MultipleDeleteResult>;
+    /**
+     * @deprecated 旧写法字段；仅保留供旧 list-render 提交前直接调用。
+     * `create()` 等模板不调用本字段（见 `createReqMap`）。
+     */
+    createMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；仅保留供旧 list-render 提交前直接调用。
+     */
+    updateMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；仅保留供旧 list-render 提交前直接调用。
+     */
+    patchMap?: MapFunction<RequestData>;
+    /**
+     * @deprecated 旧写法字段；`get()` 内先跑本字段再跑 `getResMap`（先旧后新）。
+     */
+    getMap?: MapFunction<T>;
+    /**
+     * @deprecated 旧写法字段；`getList()` 内逐条 map `list[]`（不是 `getListResMap` 的 1:1）。
+     */
+    getListMap?: MapFunction<T>;
+    constructor(params?: CrudModelOptions<T>);
+    /**
+     * 显式更新配置。二次 `getInstance` **不会**合并 options，改 api / maps 等必须走本方法。
+     * - 浅层赋值 api / maps 等
+     * - `query` / `ctx`：merge 出新对象
+     * - 忽略 `singletonKey`（不可通过 configure 改 key）
+     */
+    configure(partial: Partial<CrudModelOptions<T>>): this;
+    /**
+     * 合并实例 query 与调用参数，并去掉空值
+     */
+    protected mergeQuery(q?: QueryParams): QueryParams;
+    /**
+     * 应用可选 ResMap
+     */
+    protected applyResMap<U>(data: U, resMap?: MapFunction<U>): U;
+    /**
+     * FormData → 对象 → reqMap（本地模型用；保留 File/Blob 引用，不转回 FormData）
+     */
+    handleInputParams(params: RequestData | FormData, reqMapFn?: RequestMapFunction<RequestData>): Promise<Record<string, any>>;
+    /**
+     * 从 delete config 解析主键：`config[idKey]` → `params` → `data` → `ctx`
+     */
+    protected resolveDeleteId(config: ModelDeleteConfig, idKey: string, ctx?: Record<string, any>): any;
+    get(q?: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T | null>;
+    getList(q?: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<GetListResult<T>>;
+    create(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    update(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    patch(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    delete(config?: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<unknown>;
+    multipleDelete(config?: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+    protected abstract doGet(query: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T | null>;
+    protected abstract doGetList(query: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<GetListResult<T>>;
+    protected abstract doCreate(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected abstract doUpdate(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected abstract doPatch(data: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected abstract doDelete(config: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<unknown>;
+    protected abstract doMultipleDelete(config: ModelDeleteConfig, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+}
+
+/**
+ * 三端统一业务错误（HTTP / Array / IndexedDB）。
+ * 用户可见文案只走 `_msg`。
+ */
+declare class ModelError extends Error {
+    code?: number | string;
+    /** 唯一用户可见文案字段 */
+    _msg?: string;
+    cause?: unknown;
+    response?: unknown;
+    data?: unknown;
+    constructor(message: string, init?: Partial<ModelError>);
+}
+/** 是否为 ModelError */
+declare function isModelError(err: unknown): err is ModelError;
+/**
+ * @deprecated 兼容旧 API：`ApiError` 已统一为 `ModelError`。
+ * 注意 `_message`（deprecated）仅在旧写法解析路径动态写入，不属正式契约。
+ */
+type ApiError = ModelError;
+
+/** DataModel 全局默认错误文案 */
+interface DataModelMessages {
+    defaultErrMsg: string;
+    networkErrMsg: string;
+}
+/**
+ * 批量设置 DataModel 默认错误文案
+ * @param partial 要覆盖的错误文案
+ */
+declare function setDataModelMessages(partial: Partial<DataModelMessages>): void;
+/**
+ * @deprecated 旧写法；等价 `setDataModelMessages({ defaultErrMsg })`。
+ */
+declare function setDefaultErrMsg(msg: string): void;
+/**
+ * @deprecated 旧写法；等价 `setDataModelMessages({ networkErrMsg })`。
+ */
+declare function setNetworkErrMsg(msg: string): void;
+
+/**
+ * HTTP 响应协议适配器：替代硬编码 `code == 200` / Spring 分页字段。
+ * 传入 Partial 时与 `defaultResponseAdapter` 浅合并（见 `resolveResponseAdapter`）。
+ */
+
+interface ResponseAdapter {
+    isSuccess(body: unknown, raw: AxiosResponse): boolean;
+    getData<T = unknown>(body: unknown, raw: AxiosResponse): T;
+    getMessage(body: unknown, raw: AxiosResponse): string;
+    normalizeList?<T = unknown>(data: unknown): GetListResult<T> | unknown;
+}
+/**
+ * 默认协议：`{ code, data, msg }`；Spring `content` + `pageNumber` 归一为 `{ list, pagination }`。
+ */
+declare const defaultResponseAdapter: ResponseAdapter;
+/** 将用户传入的 Partial 与默认适配器浅合并。 */
+declare function resolveResponseAdapter(partial?: Partial<ResponseAdapter>): ResponseAdapter;
+
+/**
+ * DataModel 构造函数参数接口
+ */
+interface DataModelOptions<T = Record<string, any>> extends CrudModelOptions<T> {
+    /**
+     * 响应协议适配器；可只传要覆盖的方法，其余合并自 `defaultResponseAdapter`。
+     */
+    responseAdapter?: Partial<ResponseAdapter>;
+    /** 请求的 axios 实例 */
+    axios?: typeof axios;
+    /** axios 配置 */
+    axiosConf?: AxiosConfig;
+    /** GET 列表接口 axios 配置 */
+    getListAxiosConf?: AxiosConfig;
+    /** GET 详情接口 axios 配置 */
+    getAxiosConf?: AxiosConfig;
+    /** POST 接口 axios 配置 */
+    createAxiosConf?: AxiosConfig;
+    /** PUT 接口 axios 配置 */
+    updateAxiosConf?: AxiosConfig;
+    /** PATCH 接口 axios 配置 */
+    patchAxiosConf?: AxiosConfig;
+    /** DELETE 接口 axios 配置 */
+    deleteAxiosConf?: AxiosConfig;
+    /** DELETE 批量删除接口 axios 配置 */
+    multipleDeleteAxiosConf?: AxiosConfig;
+    /**
+     * @deprecated 旧写法字段；设置后 `handleRes` 走旧分支，否则走 `responseAdapter`。
+     */
+    handleResponse?: HandleResponseFunc;
+    /**
+     * @deprecated 旧写法字段；为 true 时 `get`/`create` 等直接 resolve 原始 response。
+     */
+    isResponse?: boolean;
+    /**
+     * @deprecated 旧写法字段；为 true 时直接 resolve `response.data`（或 response）。
+     */
+    isResponseData?: boolean;
+}
+/**
+ * 获取 API 地址的选项接口
+ */
+interface GetApiUrlOptions {
+    /** 请求来源标识 */
+    from?: string;
+    [key: string]: any;
+}
+/**
+ * 错误处理选项接口
+ */
+interface HandleMsgOptions {
+    /** 是否使用 response.statusText 作为兜底 msg */
+    useStatusText?: boolean;
+}
+/**
+ * DataModel 类
+ * 用于封装常用的 CRUD 请求方法
+ */
+declare class DataModel<T = Record<string, any>> extends BaseDataModel<T> implements ICrudModel<T> {
+    /** 响应协议适配器（完整，已与 default 合并） */
+    responseAdapter: ResponseAdapter;
+    /** 请求的 axios 实例 */
+    axios: typeof axios;
+    /** axios 配置 */
+    axiosConf: AxiosConfig;
+    getListAxiosConf?: AxiosConfig;
+    getAxiosConf?: AxiosConfig;
+    createAxiosConf?: AxiosConfig;
+    updateAxiosConf?: AxiosConfig;
+    patchAxiosConf?: AxiosConfig;
+    deleteAxiosConf?: AxiosConfig;
+    multipleDeleteAxiosConf?: AxiosConfig;
+    /**
+     * @deprecated 旧写法字段；设置后 `handleRes` 走旧分支，否则走 `responseAdapter`。
+     */
+    handleResponse?: HandleResponseFunc;
+    /**
+     * @deprecated 旧写法字段；为 true 时直接 resolve 原始 response。
+     */
+    isResponse: boolean;
+    /**
+     * @deprecated 旧写法字段；为 true 时直接 resolve `response.data`（或 response）。
+     */
+    isResponseData: boolean;
+    /**
+     * 按 key 复用实例。二次调用忽略 options；改配置请用 `configure`。
+     */
+    static getInstance<T = Record<string, any>>(key: string, options?: DataModelOptions<T>): DataModel<T>;
+    static clearInstance(key: string): boolean;
+    static clearAllInstances(): void;
+    constructor(params?: DataModelOptions<T>);
+    configure(partial: Partial<DataModelOptions<T>>): this;
+    /**
+     * 获取请求 url 地址
+     */
+    getApiUrl(api: string | undefined, record?: JSONObject, ctx?: JSONObject, opt?: GetApiUrlOptions): string;
+    protected doGet(query: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T | null>;
+    protected doGetList(query: QueryParams, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<GetListResult<T>>;
+    protected doCreate(params?: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected doUpdate(params?: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected doPatch(params?: RequestData | FormData, ctx?: JSONObject, axiosConf?: AxiosConfig): Promise<T>;
+    protected doDelete(_config: ModelDeleteConfig, ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<unknown>;
+    protected doMultipleDelete(_config: ModelDeleteConfig, ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+    private settleRes;
+    private settleErr;
+    /**
+     * 处理响应结果（走 responseAdapter）
+     */
+    handleRes(response: ResponseData, resolve: (res: any) => void, reject: (err: ModelError) => void, opt?: {
+        fallbackData?: JSONObject;
+    }): void;
+    errorHandler(err: any | undefined, reject: (err: ModelError) => void): void;
+    handleMsg(response: any, opt?: HandleMsgOptions): string;
+    getNetworkErrMsg(errOrCode?: string | {
+        code?: string;
+    }): string;
+}
+
+/**
+ * getPublicUrl 选项接口
+ */
+interface GetPublicUrlOptions {
+    /** 是否返回完整路径 */
+    isFullPath?: boolean;
+}
+/**
+ * 获取 public 文件路径（自动拼接 hash 数据）
+ *
+ * 兼容旧写法；本仓 webpack-config 尚无 `public-utils`，先留在 core 兼容层。
+ * @param url 文件路径
+ * @param opt 选项
+ * @returns 完整的 public 文件路径
+ */
+declare function getPublicUrl(url: string | any, opt?: GetPublicUrlOptions): string | any;
+
+/**
+ * 共享查询协议类型（Array / IndexedDB / QueryEngine）。
+ * 与 pageNum / pageSize / sortKey / range / IN 约定一致。
+ */
+/**
+ * 分页信息
+ */
+interface Pagination {
+    /** 当前页码 */
+    current?: number;
+    /** 总条数 */
+    total: number;
+    /** 每页条数 */
+    pageSize?: number;
+}
+/**
+ * 列表查询结果
+ */
+interface FindListResult<T = Record<string, any>> {
+    /** 列表数据 */
+    list: T[];
+    /** 分页信息 */
+    pagination: Pagination;
+}
+/**
+ * 排序路径配置
+ */
+interface SortPathConfig {
+    /** 字段路径 */
+    path: string;
+    /** 字段类型 */
+    type?: string;
+    /** 自定义比较函数 */
+    customCompare?: (a: any, b: any, opt: any) => number;
+    /** 自定义值格式化函数 */
+    customFormat?: (val: any, data: any) => any;
+}
+/**
+ * 查询参数（分页 / 排序 + 任意过滤字段）
+ */
+interface ItemQuery {
+    /** 页码 */
+    pageNum?: number;
+    /** 每页条数 */
+    pageSize?: number;
+    /** 排序字段 */
+    sortKey?: string | string[] | SortPathConfig[];
+    /** 排序方式 */
+    sortType?: "asc" | "desc" | Record<string, "asc" | "desc">;
+    /**
+     * @deprecated 旧写法排序字段；QueryEngine 内部归一到 `sortKey`。
+     */
+    orderByColumn?: string | string[] | SortPathConfig[];
+    /**
+     * @deprecated 旧写法排序方式；QueryEngine 内部归一到 `sortType`（boolean：true=asc, false=desc）。
+     */
+    isAsc?: "asc" | "desc" | boolean;
+    /** 其他筛选条件 */
+    [key: string]: any;
+}
+/**
+ * 可替换的列表匹配函数（默认 includes / IN / 范围）
+ */
+type QueryMatcher = (item: Record<string, any>, query: Record<string, any>, options: QueryOptions) => boolean;
+/**
+ * 查询选项
+ */
+interface QueryOptions {
+    /** 字符串字段是否开启模糊匹配 */
+    fuzzy?: boolean;
+    /** 模糊匹配时是否忽略大小写 */
+    ignoreCase?: boolean;
+    /** 限制参与模糊匹配的字段；未设则对 query 中的字符串键生效 */
+    searchFields?: string[];
+    /** 自定义 matcher，传入则替换默认匹配逻辑 */
+    matcher?: QueryMatcher;
+}
+
+/**
+ * 默认 matcher：字段匹配（includes / IN / 范围）；支持 searchFields 限定模糊字段
+ */
+declare const defaultQueryMatcher: QueryMatcher;
+interface QueryEngine {
+    /** filter → sort → paginate */
+    run<T extends Record<string, any>>(source: T[], query?: ItemQuery, options?: QueryOptions): FindListResult<T>;
+    match(item: Record<string, any>, query: Record<string, any>, options?: QueryOptions): boolean;
+    filter<T extends Record<string, any>>(source: T[], query: Record<string, any>, options?: QueryOptions): T[];
+    sort<T extends Record<string, any>>(list: T[], sortKey?: string | string[] | SortPathConfig[], sortType?: "asc" | "desc" | Record<string, "asc" | "desc">): T[];
+}
+/**
+ * 创建共享查询引擎（Array 全量 / IDB 索引预筛后的 candidates 共用）
+ */
+declare function createQueryEngine(defaults?: QueryOptions): QueryEngine;
+/** 默认引擎（fuzzy 由调用方按场景传入） */
+declare const defaultQueryEngine: QueryEngine;
+
+/**
+ * 状态码枚举
+ */
+declare const STATE_CODE: {
+    /** 成功 */
+    readonly SUC: 200;
+    /** 未找到 */
+    readonly NOT_FOUND: 404;
+    /**
+     * @deprecated 旧写法拼写错误；等价 `NOT_FOUND`。
+     */
+    readonly NOT_FOUNT: 404;
+    /** 错误 */
+    readonly ERR: 500;
+    /** 缺少 ID 错误 */
+    readonly ERR_INPUT_ID: 501;
+};
+/**
+ * 状态码类型
+ */
+type StateCode = (typeof STATE_CODE)[keyof typeof STATE_CODE];
+/**
+ * ArrayUtils 构造函数参数接口
+ */
+interface ArrayUtilsOptions<T = Record<string, any>> {
+    /** 子项唯一标志字段 */
+    idKey?: string;
+    /** 列表数据 */
+    list?: T[];
+}
+/**
+ * 数组模拟数据库存储
+ * @template T - 列表项数据类型
+ */
+declare class ArrayUtils<T extends Record<string, any> = Record<string, any>> {
+    /** 子项唯一标志字段 */
+    protected _idKey: string;
+    /** 列表数据 */
+    protected _list: T[];
+    constructor(params?: ArrayUtilsOptions<T>);
+    /** 主键字段名（供组合方读取） */
+    get idKey(): string;
+    /**
+     * 通过 id 获取子项
+     * @param id 目标 ID
+     * @returns 匹配的子项或 null
+     */
+    findItemById(id: string | number): T | null;
+    /**
+     * 通过 query 获取子项
+     * @param query 查询条件
+     * @param options 查询选项
+     * @returns 匹配的子项或 null
+     */
+    findItem(query?: Record<string, any>, options?: QueryOptions): T | null;
+    /**
+     * 通过 query 筛选列表（支持多条件筛选、分页、排序）
+     * 委托共享 QueryEngine：filter → sort → paginate
+     */
+    findListByQuery(query?: ItemQuery, options?: QueryOptions): Promise<FindListResult<T>>;
+    /**
+     * 对目标数据进行多维度排序
+     */
+    getSortList(sortKey?: string | string[] | SortPathConfig[], sortType?: "asc" | "desc" | Record<string, "asc" | "desc">, customList?: T[]): T[];
+    /**
+     * 比较两个数据对象的排序顺序（支持多字段优先级排序）
+     */
+    compareData(dataA: T, dataB: T, opt: {
+        paths: (string | SortPathConfig)[];
+        pathIdx?: number;
+        sortType?: "asc" | "desc" | Record<string, "asc" | "desc">;
+    }): number;
+    /**
+     * 根据路径获取并处理字段值
+     */
+    handleValByKey(data: T, pathConfig: string | SortPathConfig | null | undefined): any;
+    /**
+     * 获取完整列表
+     */
+    findAllList(): T[];
+    /**
+     * 获取总数
+     */
+    getCount(): number;
+    /**
+     * push 数据
+     */
+    pushItem(data: Partial<T>): T;
+    pushItem(data: Partial<T>[]): T[];
+    /**
+     * unshift 数据
+     */
+    unshiftItem(data: Partial<T>): T;
+    /**
+     * 根据 id 更新子项——直接替换
+     */
+    replaceItem(data: T): T | StateCode;
+    /**
+     * 根据 id 更新子项——仅修改传入的数据
+     */
+    updateItemValue(data: Partial<T> & {
+        [key: string]: any;
+    }): T | StateCode;
+    /**
+     * 删除子项
+     */
+    delItem(id: any): StateCode;
+    /**
+     * 清空所有数据
+     */
+    clearAll(): StateCode;
+    /**
+     * 批量删除
+     */
+    deleteItems(ids: any[]): number;
+    /**
+     * 判断列表是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 获取指定范围的列表
+     */
+    slice(start?: number, end?: number): T[];
+    /**
+     * 检查单个 item 是否匹配所有 query 条件
+     */
+    protected _isItemMatchQuery(item: T, query: Record<string, any>, options?: QueryOptions): boolean;
+    /**
+     * 过滤空查询条件
+     */
+    protected _filterEmptyQuery(query: Record<string, any>): Record<string, any>;
+    /**
+     * 检查 ID 是否无效
+     */
+    protected _isInvalidId(id: any): boolean;
+    /**
+     * 子项没有 id 的时候自动添加
+     */
+    protected _setId(item: T): T;
+    /**
+     * 设置创建时间
+     */
+    protected _setCreateTime(item: T): void;
+    /**
+     * 设置更新时间
+     */
+    protected _setUpdateTime(item: T): void;
+}
+
+/**
+ * ArrayDataModel 构造函数参数接口
+ */
+interface ArrayDataModelOptions<T extends Record<string, any> = Record<string, any>> extends CrudModelOptions<T>, ArrayUtilsOptions<T> {
+    /** 查询选项 */
+    arrOptions?: ArrOptions;
+    /**
+     * 写操作模拟网络延迟（ms）。默认 `0`；demo 可设 `300` 等。
+     */
+    delayMs?: number;
+}
+/**
+ * 查询选项
+ */
+interface ArrOptions {
+    /** 字符串字段是否开启模糊匹配 */
+    fuzzy?: boolean;
+    /** 模糊匹配时是否忽略大小写 */
+    ignoreCase?: boolean;
+}
+/**
+ * handleRes 选项
+ */
+interface HandleResOptions {
+    /** 成功结果映射 */
+    resMap?: MapFunction<Record<string, any>>;
+    /** 成功时 resolve 的资源快照（create/update/patch） */
+    payload?: Record<string, any>;
+}
+/**
+ * ArrayDataModel 本地数据 DataModel（内存列表模拟 CRUD）。
+ *
+ * FormData：create/update/patch 入参若为 FormData，会先 `formDataToObj` 成普通对象再入库；
+ * 不转回 FormData（无 multipart）。其中的 File/Blob 仅保留内存引用，不落盘、不持久化。
+ * @template T - 数据类型
+ */
+declare class ArrayDataModel<T extends Record<string, any> = Record<string, any>> extends BaseDataModel<T> implements ICrudModel<T> {
+    /** 内存列表存储 */
+    private store;
+    /** 查询选项 */
+    private _arrOptions?;
+    /** 写操作延迟（ms） */
+    private delayMs;
+    static getInstance<T extends Record<string, any> = Record<string, any>>(key: string, options?: ArrayDataModelOptions<T>): ArrayDataModel<T>;
+    static clearInstance(key: string): boolean;
+    static clearAllInstances(): void;
+    constructor(params?: ArrayDataModelOptions<T>);
+    /**
+     * 更新配置。不允许通过 configure 替换整个 `list` 存储（易丢数据）；要重置用 `clearInstance`。
+     */
+    configure(partial: Partial<ArrayDataModelOptions<T>>): this;
+    private delay;
+    private rejectCode;
+    protected doGet(query: QueryParams, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T | null>;
+    protected doGetList(query: QueryParams, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<FindListResult<T>>;
+    protected doCreate(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    protected doUpdate(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    protected doPatch(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    protected doDelete(_config: ModelDeleteConfig, ctx?: Record<string, any>, _axiosConf?: AxiosConfig): Promise<Record<string, any>>;
+    protected doMultipleDelete(_config: ModelDeleteConfig, ctx?: Record<string, any>, _axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+    /**
+     * 处理响应结果（delete 等仍用状态码）
+     */
+    handleRes(res: number, resolve: (res: Record<string, any>) => void, reject: (err: ModelError) => void, opt?: HandleResOptions): void;
+}
+
+/**
+ * IndexedDB DataModel 业务状态码（含与 Array 对齐的码 + 冲突）
+ */
+declare const IDB_STATE_CODE: {
+    /** 主键 / 唯一约束冲突 */
+    readonly CONFLICT: 409;
+    readonly SUC: 200;
+    readonly NOT_FOUND: 404;
+    readonly NOT_FOUNT: 404;
+    readonly ERR: 500;
+    readonly ERR_INPUT_ID: 501;
+};
+type IdbStateCode = (typeof IDB_STATE_CODE)[keyof typeof IDB_STATE_CODE];
+/**
+ * IndexedDB 业务错误（`ModelError` 子类，文案仅 `_msg`）
+ */
+declare class IdbModelError extends ModelError {
+    code: number | string;
+    _msg: string;
+    constructor(code: number | string, message?: string, data?: unknown);
+}
+/** 是否为 IdbModelError */
+declare function isIdbModelError(err: unknown): err is IdbModelError;
+/** 是否为 IndexedDB 主键 / 唯一约束冲突 */
+declare function isIdbConstraintError(err: unknown): boolean;
+
+/**
+ * 跨 tab 同步变更动作
+ */
+type IdbSyncAction = "create" | "update" | "patch" | "delete" | "multipleDelete" | "gc";
+/**
+ * 跨 tab 同步消息（只广播变更通知，不推全量记录）
+ */
+interface IdbSyncMessage {
+    v: 1;
+    dbName: string;
+    storeName: string;
+    action: IdbSyncAction;
+    /** 受影响的主键列表（可知时带上） */
+    ids?: any[];
+    /** 发送方实例 id，用于忽略自发消息 */
+    tabId: string;
+    ts: number;
+}
+type IdbSyncListener = (message: IdbSyncMessage) => void;
+/**
+ * 跨 tab 同步选项
+ */
+interface IdbSyncOptions {
+    /** 是否启用，默认 true */
+    enabled?: boolean;
+    /**
+     * 通道名；默认 `data-model:idb:${dbName}`
+     * 同库多 store 共用 channel，接收方按 `storeName` 过滤
+     */
+    channelName?: string;
+    /** 无 BroadcastChannel 时是否用 localStorage 事件兜底，默认 true */
+    storageFallback?: boolean;
+}
+
+/**
+ * IndexedDB 业务 store 索引配置（在 `onupgradeneeded` 中创建）
+ */
+interface IdbIndexConfig {
+    /** 索引名 */
+    name: string;
+    /** 索引字段路径 */
+    keyPath: string | string[];
+    /** 是否唯一索引 */
+    unique?: boolean;
+}
+/**
+ * 业务记录中的文件引用（Blob 存在独立 files objectStore）
+ */
+interface FileRef {
+    /** files store 主键 */
+    fileId: string;
+    /** 原始文件名 */
+    name: string;
+    /** MIME type */
+    type: string;
+    /** 字节大小 */
+    size: number;
+}
+/**
+ * 对外文件记录（`getFile` 返回；始终带可消费的 `Blob`）
+ */
+interface FileRecord {
+    id: string;
+    blob: Blob;
+    name: string;
+    type: string;
+    size: number;
+    createdAt: number;
+    /** 来源业务 store，便于排查 / 清理 */
+    storeName?: string;
+}
+/**
+ * IndexedDbDataModel 构造参数。
+ * CRUD / maps 字段与 DataModel、ArrayDataModel 对齐；`*Api` 可不填（无 HTTP）。
+ */
+interface IndexedDbDataModelOptions<T extends Record<string, any> = Record<string, any>> extends CrudModelOptions<T> {
+    /** IndexedDB 数据库名 */
+    dbName: string;
+    /** 业务 objectStore 名 */
+    storeName: string;
+    /** 主键字段，默认 `id` */
+    idKey?: string;
+    /** 最低版本（可选，默认 1）；缺表/缺索引时会自动升 version，同库多 store 无需手工对齐 */
+    version?: number;
+    /** 业务 store 可选索引 */
+    indexes?: IdbIndexConfig[];
+    /** 文件 store 名，默认 `__files`（同库共享） */
+    filesStoreName?: string;
+    /**
+     * 跨 tab 同步：默认启用。
+     * - `false` 关闭
+     * - 对象可配 `channelName` / `storageFallback`
+     */
+    sync?: boolean | IdbSyncOptions;
+    /** 查询选项（模糊匹配、自定义 matcher 等） */
+    idbOptions?: QueryOptions;
+}
+/**
+ * 判断值是否为 `FileRef`（业务记录中的文件引用）
+ */
+declare function isFileRef(value: unknown): value is FileRef;
+
+/**
+ * IndexedDB 版 DataModel。
+ *
+ * 业务用法对齐 `DataModel` / `ArrayDataModel`：`get` / `getList` / `create` / `update` /
+ * `patch` / `delete` / `multipleDelete`，以及 `*ReqMap` / `*ResMap` 等（模板在 `BaseDataModel`）。
+ *
+ * - 数据持久化到 IndexedDB 业务 store
+ * - `File` / `Blob` 写入独立 files store，记录只保留 `FileRef`
+ * - 模糊搜索默认 includes，可通过 `idbOptions.matcher` 替换
+ *
+ * @template T - 业务记录类型
+ */
+declare class IndexedDbDataModel<T extends Record<string, any> = Record<string, any>> extends BaseDataModel<T> implements ICrudModel<T> {
+    /** IndexedDB 数据库名 */
+    dbName: string;
+    /** 业务 objectStore 名 */
+    storeName: string;
+    /** 文件 objectStore 名 */
+    filesStoreName: string;
+    /** 数据库版本 */
+    version: number;
+    /** 主键字段名 */
+    idKey: string;
+    /** 业务 store 索引配置 */
+    indexes?: IndexedDbDataModelOptions<T>["indexes"];
+    /** 模糊匹配等查询选项 */
+    idbOptions: QueryOptions;
+    /** 由本实例 `getFileUrl` 创建的 object URL，close / revokeAll 时统一释放 */
+    private objectUrls;
+    /** 跨 tab 同步总线（sync: false 时为 null） */
+    private syncBus;
+    /** 远程变更监听（含本页其它实例） */
+    private remoteListeners;
+    static getInstance<T extends Record<string, any> = Record<string, any>>(key: string, options: IndexedDbDataModelOptions<T>): IndexedDbDataModel<T>;
+    static clearInstance(key: string): boolean;
+    static clearAllInstances(): void;
+    constructor(params: IndexedDbDataModelOptions<T>);
+    /**
+     * 更新配置。不允许改 `dbName` / `storeName` / `indexes` / `version` / `filesStoreName`（已 open 的库）；
+     * 要换库用 `clearInstance` + 新 key。
+     */
+    configure(partial: Partial<IndexedDbDataModelOptions<T>>): this;
+    /** 广播本 store 变更（供其它 tab / 实例刷新） */
+    private publishSync;
+    /**
+     * 订阅其它 tab（或同页其它实例）对本 store 的写变更。
+     * 收到后通常重新 `getList` / `get`；不自动改本地内存。
+     * @returns 取消订阅函数
+     */
+    subscribe(listener: IdbSyncListener): () => void;
+    /** 供 db 层使用的打开配置 */
+    private get dbOpt();
+    /** 抛出 `IdbModelError`（带 code / _msg，且为 Error 子类） */
+    private rejectCode;
+    /**
+     * 预打开数据库连接（可选；CRUD 内部会自动 open）
+     */
+    ready(): Promise<IDBDatabase>;
+    /**
+     * 释放 object URL、断开同步总线，并关闭本库缓存连接
+     */
+    close(): Promise<void>;
+    /**
+     * 查询详情。有主键走 `store.get`；否则 getAll + 精确匹配取首条。找不到返回 `null`。
+     * ReqMap / ResMap 由模板处理；此处接收已 merge + ReqMap 的 query。
+     */
+    protected doGet(query: QueryParams, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T | null>;
+    /**
+     * 列表查询：索引预筛 + 内存过滤 / 模糊 / 排序 / 分页。
+     * getListFunc / ResMap 由模板处理。
+     */
+    protected doGetList(query: QueryParams, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<FindListResult<T>>;
+    /**
+     * 创建记录。缺主键时自动 `nanoid()`；`File`/`Blob` 写入 files store。
+     * ResMap 由模板处理。
+     */
+    protected doCreate(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    /**
+     * 整单替换更新（需带主键）。替换文件时删除旧 blob。ResMap 由模板处理。
+     */
+    protected doUpdate(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    /**
+     * 局部更新：先读后 merge 再 put。替换文件时删除旧 blob。ResMap 由模板处理。
+     */
+    protected doPatch(params: RequestData | FormData, _ctx?: JSONObject, _axiosConf?: AxiosConfig): Promise<T>;
+    /**
+     * 删除单条，并级联删除记录上的 FileRef 对应文件。
+     * deleteReqMap / deleteResMap 由模板处理。
+     */
+    protected doDelete(config: ModelDeleteConfig, ctx?: Record<string, any>, _axiosConf?: AxiosConfig): Promise<Record<string, any>>;
+    /**
+     * 批量删除。ids 可为数组或逗号分隔字符串；返回 `{ sucList, failList }`。
+     * ReqMap / ResMap 由模板处理；逐条走 `this.delete`。
+     */
+    protected doMultipleDelete(config: ModelDeleteConfig, ctx?: Record<string, any>, _axiosConf?: AxiosConfig): Promise<MultipleDeleteResult>;
+    /**
+     * 按 fileId 读取文件内容（含 Blob）
+     */
+    getFile(fileId: string): Promise<FileRecord | null>;
+    /**
+     * 按 fileId 生成 `blob:` URL，并由本实例托管；可用 `revokeFileUrl` / `close` 释放
+     */
+    getFileUrl(fileId: string): Promise<string | null>;
+    /**
+     * 释放单个由 `getFileUrl` 创建的 object URL
+     */
+    revokeFileUrl(url: string): void;
+    /**
+     * 释放本实例托管的全部 object URL
+     */
+    revokeAllFileUrls(): void;
+    /**
+     * 扫描本 store 记录，删除 files store 中未被引用且归属本 store 的孤儿文件。
+     * @returns 删除的文件数量
+     */
+    gcOrphanFiles(): Promise<number>;
+}
+
+/**
+ * useDataModel 选项接口
+ */
+interface UseDataModelOptions<T = any> {
+    /** 动态数据监听的目标 */
+    effectTargets?: any[];
+    /** 动态的 params 数据，包含了 query */
+    effectParams?: Partial<DataModelOptions<T>>;
+    /** 动态的 query 数据 */
+    effectQuery?: DataModelOptions<T>["query"];
+}
+/**
+ * 解决 hooks 重复实例化导致 query 丢失的问题
+ * @param {Object} initParams 初始参数
+ * @param {Object} opt
+ * @param {Object} opt.effectTargets 动态数据监听的目标
+ * @param {Object} opt.effectParams 动态的 params 数据，包含了 query
+ * @param {Object} opt.effectQuery 动态的 query 数据
+ * @returns DataModel 实例
+ */
+declare const useDataModel: <T = any>(initParams?: DataModelOptions<T>, opt?: UseDataModelOptions<T>) => DataModel<T>;
+
+export { type ApiError, type ArrOptions, ArrayDataModel, type ArrayDataModelOptions, ArrayUtils, type ArrayUtilsOptions, type AxiosConfig, type AxiosRequestConfigWithCache, type AxiosResponseCus, BaseDataModel, type CacheHitError, type CacheItem, type CacheOpt, type CrudModelOptions, DataModel, type DataModelMessages, type DataModelOptions, type FileRecord, type FileRef, type FindListResult, type GetApiUrlOptions, type GetListFunc, type GetListResult, type GetPublicUrlOptions, type GetTokenOptions, type HandleErrCbOptions, type HandleMsgOptions, type HandleResOptions, type HandleResponseFunc, type ICrudModel, IDB_STATE_CODE, type IdbIndexConfig, IdbModelError, type IdbStateCode, IndexedDbDataModel, type IndexedDbDataModelOptions, type ItemQuery, type JSONObject, type MapFunction, type ModelDeleteConfig, ModelError, type MultipleDeleteResult, type QueryEngine, type QueryMatcher, type QueryOptions, type QueryParams, type Req, RequestCache, type RequestCacheParams, type RequestData, type RequestMapFunction, type ResData, type ResponseAdapter, type ResponseData, STATE_CODE, type SetTokenOptions, type StateCode, TOKEN, type UseDataModelOptions, axios, createAbortController, createAxiosClient, createQueryEngine, DataModel as default, defaultQueryEngine, defaultQueryMatcher, defaultResponseAdapter, getCancelTokenSource, getDefaultAxios, getPublicUrl, getToken, handleErrCb, isCacheHitError, isCancel, isFileRef, isIdbConstraintError, isIdbModelError, isModelError, registerAxios, resolveResponseAdapter, setAxAuthorization, setAxBaseUrl, setAxDefaults, setAxHeaders, setAxRequest, setAxResponse, setAxTimeout, setAxios, setDataModelMessages, setDefaultAxios, setDefaultErrMsg, setNetworkErrMsg, setToken, temp, useDataModel };