@done-coding/admin-core 0.0.1-alpha.0 → 0.1.0

package/es/index.mjs

@@ -5,15 +5,15 @@ import { miscInstall as a } from "./components/misc/index.mjs";
 import { modalInstall as m } from "./components/modal/index.mjs";
 import { tableInstall as f } from "./components/table/index.mjs";
 import { listPageInstall as s } from "./components/list-page/index.mjs";
-import { default as F } from "./components/modal/DetailModal.vue.mjs";
-import { default as c } from "./components/form/FormMain.vue.mjs";
+import { default as E } from "./components/modal/DetailModal.vue.mjs";
+import { default as _ } from "./components/form/FormMain.vue.mjs";
 import { default as M } from "./components/form/FormRadioGroup.vue.mjs";
-import { default as T } from "./components/form/FormSelect.vue.mjs";
-import { default as D } from "./components/form/FormTree.vue.mjs";
-import { default as O } from "./components/form/FormVerifyCode.vue.mjs";
+import { default as S } from "./components/form/FormSelect.vue.mjs";
+import { default as L } from "./components/form/FormTree.vue.mjs";
+import { default as D } from "./components/form/FormVerifyCode.vue.mjs";
 import { default as P } from "./components/menu/MenuItemSub.vue.mjs";
-import { default as N } from "./components/menu/MenuTree.vue.mjs";
-import { default as h } from "./components/misc/TriggerAutoImport.vue.mjs";
+import { default as G } from "./components/menu/MenuTree.vue.mjs";
+import { default as b } from "./components/misc/TriggerAutoImport.vue.mjs";
 import { default as y } from "./components/display/WatchSize.vue.mjs";
 import { APP_API_LIST_MODEL_KEY_CONFIG as v } from "./config/list-model.mjs";
 import { BODY_CONTENT_VIEWPORT_HEIGHT as H } from "./inject/key.mjs";
@@ -24,16 +24,18 @@ import { default as le } from "./components/form/FormSearch.vue.mjs";
 import { default as ie } from "./components/form/FormVerifyImage.vue.mjs";
 import { default as ne } from "./components/list-page/ListPage.vue.mjs";
 import { ROUTE_MODULE_LEVEL as de } from "./config/route.mjs";
-import { default as ge } from "./components/table/TableMain.vue.mjs";
-import { createGenerateRouteMetaRawTree as Fe } from "./helpers/route.mjs";
-import { createStorageWithNamespace as ce } from "./helpers/storage.mjs";
-import { createUseState as Me } from "./helpers/state.mjs";
-import { flatRouteMetaResolveRaw as Te, getRoutePermissionKey as Re } from "./utils/router.mjs";
-import { getId as Le } from "./utils/id.mjs";
-import { timeCountDown as Ae } from "./utils/time.mjs";
-import { useActivated as Ge, useActivatedEvent as Ne, useActivatedExec as be } from "./hooks/activated.mjs";
-import { useFeelSize as we } from "./hooks/feel-size.mjs";
-import { useMenusDataDispatch as Ve } from "./hooks/menus-dispatch.mjs";
+import { default as ce } from "./components/table/TableMain.vue.mjs";
+import { countAll as Ee, createListApi as Fe, fetchListAll as _e } from "./helpers/list-helper.mjs";
+import { createGenerateRouteMetaRawTree as Me } from "./helpers/route.mjs";
+import { createStorageWithNamespace as Se } from "./helpers/storage.mjs";
+import { createUseState as Le } from "./helpers/state.mjs";
+import { flatRouteMetaResolveRaw as De, getRoutePermissionKey as Oe } from "./utils/router.mjs";
+import { getId as he } from "./utils/id.mjs";
+import { timeCountDown as Ne } from "./utils/time.mjs";
+import { useActivated as we, useActivatedEvent as ye, useActivatedExec as Ve } from "./hooks/activated.mjs";
+import { useFeelSize as Ue } from "./hooks/feel-size.mjs";
+import { useMenusDataDispatch as We } from "./hooks/menus-dispatch.mjs";
+import { useTimeout as Be } from "./hooks/timeout.mjs";
 const I = {
   install(e) {
     e.use(t), e.use(o), e.use(r), e.use(a), e.use(m), e.use(f), e.use(s);
@@ -43,37 +45,40 @@ export {
   v as APP_API_LIST_MODEL_KEY_CONFIG,
   H as BODY_CONTENT_VIEWPORT_HEIGHT,
   z as ConfirmModal,
-  F as DetailModal,
+  E as DetailModal,
   K as FORM_CONFIG_SELECT_ALL_VALUE,
   J as FORM_ITEM_CHANGE_LOADING,
-  c as FormMain,
+  _ as FormMain,
   M as FormRadioGroup,
   le as FormSearch,
-  T as FormSelect,
-  D as FormTree,
-  O as FormVerifyCode,
+  S as FormSelect,
+  L as FormTree,
+  D as FormVerifyCode,
   ie as FormVerifyImage,
   ne as ListPage,
   P as MenuItemSub,
-  N as MenuTree,
+  G as MenuTree,
   de as ROUTE_MODULE_LEVEL,
-  ge as TableMain,
-  h as TriggerAutoImport,
+  ce as TableMain,
+  b as TriggerAutoImport,
   y as WatchSize,
-  Fe as createGenerateRouteMetaRawTree,
-  ce as createStorageWithNamespace,
-  Me as createUseState,
+  Ee as countAll,
+  Me as createGenerateRouteMetaRawTree,
+  Fe as createListApi,
+  Se as createStorageWithNamespace,
+  Le as createUseState,
   r as displayInstall,
-  Te as flatRouteMetaResolveRaw,
+  _e as fetchListAll,
+  De as flatRouteMetaResolveRaw,
   t as formInstall,
   Q as generateFormData,
   X as getBlurSubmit,
   Z as getChangeSubmit,
   Y as getConfirmPasswordRule,
   $ as getEnterSubmit,
-  Le as getId,
+  he as getId,
   ee as getPlaceholder,
-  Re as getRoutePermissionKey,
+  Oe as getRoutePermissionKey,
   te as getVModelSugar,
   I as installComponents,
   s as listPageInstall,
@@ -88,10 +93,11 @@ export {
   me as stringifyFormData,
   fe as swiftFormItemConfig,
   f as tableInstall,
-  Ae as timeCountDown,
-  Ge as useActivated,
-  Ne as useActivatedEvent,
-  be as useActivatedExec,
-  we as useFeelSize,
-  Ve as useMenusDataDispatch
+  Ne as timeCountDown,
+  we as useActivated,
+  ye as useActivatedEvent,
+  Ve as useActivatedExec,
+  Ue as useFeelSize,
+  We as useMenusDataDispatch,
+  Be as useTimeout
 };

package/es/style.css

@@ -1 +1 @@
-.form-item-tip[data-v-e889a0ed]{text-align:left;line-height:1.5;font-size:12px}.form-search_show[data-v-8896356d]{margin-bottom:10px}.form-search .btn-box[data-v-8896356d]{padding-left:20px}.form-search[data-v-8896356d] .el-col{padding-left:14px}.form-verify-image[data-v-a4baf877] .el-input__suffix-inner *{margin:0}.form-verify-image-suffix[data-v-a4baf877]{position:absolute;height:100%;border-radius:var(--el-input-border-radius, var(--el-border-radius-base));top:50%;transform:translateY(-50%);overflow:hidden;cursor:pointer}.form-verify-image-suffix-main[data-v-a4baf877]{position:absolute;left:0;top:0;width:100%;height:100%;background-color:#f4f4f4}.confirm-dialog .content[data-v-2f0c870e]{overflow-x:hidden;overflow-y:auto;max-height:calc(100vh - 200px)}.confirm-dialog .btn[data-v-2f0c870e]{width:150px;height:40px;border-radius:4px}.confirm-dialog .main[data-v-2f0c870e]{position:relative;text-align:center}.confirm-dialog .main .close-box[data-v-2f0c870e]{position:absolute;top:0;right:0;cursor:pointer;z-index:2}.confirm-dialog .main .shim[data-v-2f0c870e]{position:relative;z-index:1}.confirm-dialog .main .shim .title[data-v-2f0c870e]{font-size:18px;font-weight:500}.confirm-dialog .main .shim .content[data-v-2f0c870e]{font-size:16px;margin-top:15px}.confirm-dialog .main .shim .footer[data-v-2f0c870e]{display:flex;justify-content:center;align-items:center;padding-top:5px}.confirm-dialog .main .shim .footer>.btn[data-v-2f0c870e]:not(:last-child){margin-right:30px}.confirm-dialog .main .shim .footer[reverse=true][data-v-2f0c870e]{flex-direction:row-reverse}.confirm-dialog .main .shim .footer[reverse=true]>.btn[data-v-2f0c870e]:not(:last-child){margin-right:0;margin-left:30px}.confirm-dialog .el-dialog__header,.confirm-dialog .el-dialog__body{padding:0;background-color:transparent}.table-main-table[data-v-173e1cb3]{--el-table-header-bg-color: var(--v2c344d25)}.table-main-pagination[data-v-173e1cb3]{margin-top:10px;display:flex;justify-content:flex-end}.list-page[data-v-167d5788]{min-height:var(--v20e95162)}.list-page-operation[data-v-167d5788]{margin-bottom:10px}.list-page[data-v-167d5788] .el-loading-mask{left:-10px;top:-10px;right:-10px;bottom:-10px}
+.form-item-tip[data-v-e889a0ed]{text-align:left;line-height:1.5;font-size:12px}.form-search_show[data-v-8896356d]{margin-bottom:10px}.form-search .btn-box[data-v-8896356d]{padding-left:20px}.form-search[data-v-8896356d] .el-col{padding-left:14px}.form-verify-image[data-v-a4baf877] .el-input__suffix-inner *{margin:0}.form-verify-image-suffix[data-v-a4baf877]{position:absolute;height:100%;border-radius:var(--el-input-border-radius, var(--el-border-radius-base));top:50%;transform:translateY(-50%);overflow:hidden;cursor:pointer}.form-verify-image-suffix-main[data-v-a4baf877]{position:absolute;left:0;top:0;width:100%;height:100%;background-color:#f4f4f4}.confirm-dialog .content[data-v-2f0c870e]{overflow-x:hidden;overflow-y:auto;max-height:calc(100vh - 200px)}.confirm-dialog .btn[data-v-2f0c870e]{width:150px;height:40px;border-radius:4px}.confirm-dialog .main[data-v-2f0c870e]{position:relative;text-align:center}.confirm-dialog .main .close-box[data-v-2f0c870e]{position:absolute;top:0;right:0;cursor:pointer;z-index:2}.confirm-dialog .main .shim[data-v-2f0c870e]{position:relative;z-index:1}.confirm-dialog .main .shim .title[data-v-2f0c870e]{font-size:18px;font-weight:500}.confirm-dialog .main .shim .content[data-v-2f0c870e]{font-size:16px;margin-top:15px}.confirm-dialog .main .shim .footer[data-v-2f0c870e]{display:flex;justify-content:center;align-items:center;padding-top:5px}.confirm-dialog .main .shim .footer>.btn[data-v-2f0c870e]:not(:last-child){margin-right:30px}.confirm-dialog .main .shim .footer[reverse=true][data-v-2f0c870e]{flex-direction:row-reverse}.confirm-dialog .main .shim .footer[reverse=true]>.btn[data-v-2f0c870e]:not(:last-child){margin-right:0;margin-left:30px}.confirm-dialog .el-dialog__header,.confirm-dialog .el-dialog__body{padding:0;background-color:transparent}.table-toolbar[data-v-d2a1aea9]{display:flex;justify-content:flex-end;align-items:center;padding-bottom:8px}.table-toolbar-right[data-v-d2a1aea9]{display:flex;align-items:center;gap:8px}.table-toolbar-label[data-v-d2a1aea9]{font-size:13px;color:var(--el-text-color-regular)}.table-toolbar-interval[data-v-d2a1aea9]{width:80px}.table-toolbar-icon--rotating[data-v-d2a1aea9]{animation:table-toolbar-rotating-d2a1aea9 1s linear infinite}@keyframes table-toolbar-rotating-d2a1aea9{0%{transform:rotate(0)}to{transform:rotate(360deg)}}.table-main-table[data-v-08dc9d04]{--el-table-header-bg-color: var(--v1961e86c)}.table-main-pagination[data-v-08dc9d04]{margin-top:10px;display:flex;justify-content:flex-end}.list-page[data-v-767c1592]{min-height:var(--v036568fb)}.list-page-operation[data-v-767c1592]{margin-bottom:10px}.list-page[data-v-767c1592] .el-loading-mask{left:-10px;top:-10px;right:-10px;bottom:-10px}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@done-coding/admin-core",
-  "version": "0.0.1-alpha.0",
+  "version": "0.1.0",
   "description": "后台管理核心",
   "private": false,
   "main": "lib/index.cjs",
@@ -26,7 +26,7 @@
     "predev": "dc-inject",
     "dev": "vite build -w -m hotBuild",
     "prebuild": "dc-inject",
-    "build": "vite build && vue-tsc && vite build",
+    "build": "vue-tsc && vite build",
     "prepack": "pnpm build",
     "test": "vitest",
     "coverage": "vitest run --coverage"
@@ -77,5 +77,5 @@
     "node": ">=18.0.0",
     "pnpm": ">=9.0.0"
   },
-  "gitHead": "b8b80e9c323b5b8e73ac989d41c59e71a09e9779"
+  "gitHead": "c36a32fd56c54e6450e2abd2124bdc1642c8bb80"
 }

package/types/components/form/FormMain.vue.d.ts

@@ -49,3 +49,6 @@ declare const _default: <PO extends Record<string, any>, SO extends Record<strin
     __ctx?: Awaited<typeof __VLS_setup>;
 };
 export default _default;
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/types/components/form/types.d.ts

@@ -149,6 +149,7 @@ export interface FormMainProps<PO extends Record<string, any>, SO extends Record
     list: FormItemConfigList<PO, SO>;
     data: PO;
     layout?: Partial<ColProps>;
+    rowGutter?: number;
 }
 /** FormSearch props */
 export interface FormSearchProps<PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>> extends FormMainProps<PO, SO> {

package/types/components/list-page/ListPage.vue.d.ts

@@ -3,7 +3,14 @@ import { TableMainInstance } from '../table';
 import { ListPageInnerInjectInfo, ListPageInstance } from './types';
 
 declare const _default: <T extends Record<string, any>, PO extends Record<string, any>, SO extends Record<string, any>, SQ extends Record<string, any>, F extends Record<string, any>>(__VLS_props: Awaited<typeof __VLS_setup>["props"], __VLS_ctx?: __VLS_Prettify<Pick<Awaited<typeof __VLS_setup>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{} & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & (Partial<Pick<import('../form').FormSearchProps<PO, SO, {}>, "staticQuery">> & {
+    props: __VLS_Prettify<__VLS_OmitKeepDiscriminatedUnion<(Partial<{}> & Omit<{
+        readonly onDataChange?: ((data: T[]) => any) | undefined;
+        readonly onPageInfoChange?: ((info: {
+            pageSize: number;
+            currentPage: number;
+            total: number;
+        }) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & (Partial<Pick<import('../form').FormSearchProps<PO, SO, {}>, "staticQuery">> & {
         formSearchProps?: Partial<Omit<import('../form').FormSearchProps<PO, SO, {}>, "list" | "staticQuery">> | undefined;
     } & Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainRequiredKey> & Partial<Pick<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey>> & {
         tableMainProps?: Partial<Omit<import('../table').TableMainProps<T, import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>> & SQ, ListPageInnerInjectInfo<PO, F>>, import('./types').TableMainOptionsKey | import('./types').TableMainRewriteKey>> | undefined;
@@ -15,6 +22,8 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
         injectInfo?: F | undefined;
         beforeSearch?: ((data: import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>, type: FormSearchSearchType) => import('../form').ExcludeNeverProperties<import('../form').ExtractFormStringifyRawFromObject<PO, SO>>) | undefined;
         clearTableFilterOnReset?: boolean;
+    } & {
+        isAutoRefresh?: boolean;
     }), keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
     expose(exposed: import('vue').ShallowUnwrapRef<ListPageInstance<PO>>): void;
     attrs: any;
@@ -34,7 +43,14 @@ declare const _default: <T extends Record<string, any>, PO extends Record<string
     }) => any>> & {
         operation?(_: {}): any;
     }>;
-    emit: typeof __VLS_emit;
+    emit: {
+        (e: "dataChange", data: T[]): void;
+        (e: "pageInfoChange", info: {
+            pageSize: number;
+            currentPage: number;
+            total: number;
+        }): void;
+    };
 }>) => import('vue').VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/types/components/modal/types.d.ts

@@ -30,4 +30,6 @@ SO extends Record<string, any>> {
     formLayout?: FormMainProps<PO, SO>["layout"];
     /** elForm其他属性 */
     formProps?: Partial<FormProps>;
+    /** 表单行 gutter，透传给 FormMain */
+    formRowGutter?: number;
 }

package/types/components/table/TableMain.vue.d.ts

@@ -6,7 +6,14 @@ declare const _default: <T extends Record<string, any>, SQ extends Record<string
         readonly onPageChange?: ((value: number) => any) | undefined;
         readonly onPageSizeChange?: ((value: number) => any) | undefined;
         readonly onDataChange?: ((data: T[]) => any) | undefined;
-    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & TableMainProps<T, SQ, F>, keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
+        readonly onPageInfoChange?: ((info: {
+            pageSize: number;
+            currentPage: number;
+            total: number;
+        }) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>) & (TableMainProps<T, SQ, F> & {
+        isAutoRefresh?: boolean;
+    }), keyof import('vue').VNodeProps | keyof import('vue').AllowedComponentProps>> & {} & (import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps);
     expose(exposed: import('vue').ShallowUnwrapRef<TableMainInstance>): void;
     attrs: any;
     slots: ReturnType<() => Partial<Record<NonNullable<Uppercase<string> | Extract<keyof T, string> | undefined>, (_: {
@@ -25,6 +32,11 @@ declare const _default: <T extends Record<string, any>, SQ extends Record<string
         (e: "pageChange" | "pageSizeChange", value: number): void;
         (e: "dataChange", data: T[]): void;
         (e: "loadingChange", value: boolean): void;
+        (e: "pageInfoChange", info: {
+            pageSize: number;
+            currentPage: number;
+            total: number;
+        }): void;
     };
 }>) => import('vue').VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;

package/types/components/table/TableToolbar.vue.d.ts

@@ -0,0 +1,43 @@
+import { TableMainInstance } from './types';
+
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+    isAutoRefresh: import('vue').PropType<boolean>;
+    loading: {
+        type: globalThis.PropType<boolean>;
+        required: true;
+    };
+    features: {
+        type: globalThis.PropType<import('./types').TableToolbarFeature[]>;
+        default: () => string[];
+    };
+    refreshInterval: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
+    tableExpose: {
+        type: globalThis.PropType<TableMainInstance>;
+        required: true;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
+    isAutoRefresh: import('vue').PropType<boolean>;
+    loading: {
+        type: globalThis.PropType<boolean>;
+        required: true;
+    };
+    features: {
+        type: globalThis.PropType<import('./types').TableToolbarFeature[]>;
+        default: () => string[];
+    };
+    refreshInterval: {
+        type: globalThis.PropType<number>;
+        default: number;
+    };
+    tableExpose: {
+        type: globalThis.PropType<TableMainInstance>;
+        required: true;
+    };
+}>> & Readonly<{}>, {
+    features: import('./types').TableToolbarFeature[];
+    refreshInterval: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/types/components/table/types.d.ts

@@ -22,6 +22,20 @@ export interface TableMainInstance {
     reload: (slice?: boolean) => void;
     getTableInstance: () => TableInstance | undefined;
 }
+/** toolbar 可配置功能列表 */
+export type TableToolbarFeature = "refresh" | "autoRefresh";
+/** toolbar 可配置项（通过 TableMain 的 toolbar prop 传入） */
+export interface TableToolbarConfig {
+    /**
+     * 功能列表。
+     * - undefined（默认）：显示所有功能
+     * - []（空数组）：不渲染 toolbar
+     * - 枚举子集：仅显示指定功能
+     */
+    features?: TableToolbarFeature[];
+    /** 自动刷新默认间隔（秒），默认 30 */
+    refreshInterval?: number;
+}
 /** 表格列默认作用域 */
 export interface TableColumnDefaultScope<T extends Record<string, any>, F extends Record<string, any>> {
     row: T;
@@ -66,6 +80,10 @@ SQ extends Record<string, any>,
 F extends Record<string, any>> {
     /** 展示分页器 */
     showPager?: boolean;
+    /** 是否显示 toolbar（顶层开关，默认 true，优先级高于 toolbar.features） */
+    showToolbar?: boolean;
+    /** toolbar 配置 */
+    toolbar?: TableToolbarConfig;
     /** 参数 */
     query?: SQ;
     /** 每页条数 */

package/types/helpers/index.d.ts

@@ -2,3 +2,5 @@ export * from './form';
 export * from './storage';
 export * from './state';
 export * from './route';
+export * from './types';
+export * from './list-helper';

package/types/helpers/list-helper.d.ts

@@ -0,0 +1,36 @@
+import { TableApiParams, TableApiResult } from '../components/table/types';
+
+export interface FetchListAllOptions {
+    /** 单页大小,默认 200,范围 [1, 1000] */
+    pageSize?: number;
+    /** 累计抓取上限,默认 10000;totalRecord > limit 则 throw */
+    limit?: number;
+}
+/**
+ * 全量翻页拉取(串行,提前终止)
+ * ---
+ * @param api  原始分页 api 函数(签名同 TableMain :api prop)
+ * @param baseParams 业务侧固定参数,会透传到每页 api 调用(不被改写)
+ * @param opts pageSize / limit 覆盖
+ * @returns 全量 items 数组
+ *
+ * 行为:
+ * - totalRecord = 0 → 直接 [] 返回(仅调 1 次)
+ * - 单页 items.length < pageSize → 视为末页提前终止
+ * - 任一页 reject → 整体 reject 透传原错误
+ * - totalRecord > limit → throw 兜底
+ */
+export declare function fetchListAll<T extends Record<string, any>, P extends Record<string, any> = {}>(api: (params: TableApiParams<P>) => Promise<TableApiResult<T>>, baseParams?: P, opts?: FetchListAllOptions): Promise<T[]>;
+export type ListApiSource<T> = T[] | (() => T[]) | (() => Promise<T[]>);
+/**
+ * 用本地数组 / 同步函数 / 异步函数生成符合 TableMain :api prop 签名的 api
+ * ---
+ * 内部识别 source 类型 + 分页切片;无缓存,每次调用 source 重新求值
+ */
+export declare function createListApi<T extends Record<string, any>>(source: ListApiSource<T>): (params: TableApiParams<{}>) => Promise<TableApiResult<T>>;
+/**
+ * countAll: 仅探测列表总记录数,不拉数据。
+ * 1 次 api 调用 page=1/pageSize=1,返回 totalRecord。
+ * 用于"探测是否有数据 / 数据计数 / 存在性判断"等场景,替代手工 pageSize: 9999 hack。
+ */
+export declare function countAll<P extends Record<string, any> = {}>(api: (params: TableApiParams<P>) => Promise<TableApiResult<any>>, baseParams?: P): Promise<number>;

package/types/helpers/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 深度递归 Partial(函数类型保持不变,object 类型字段递归可选)
+ * ---
+ * 应用场景:SDK 请求参数嵌套结构的可选化(如 PagingInput)
+ */
+export type DeepPartial<T> = T extends (...args: any[]) => any ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/**
+ * 分页请求参数的可选包装
+ * ---
+ * 与 SDK 1.1.40 嵌套契约耦合:业务侧手包 list api wrapper 时
+ * 常以 PagingInput<RawApiParams> 作为入参类型,兜底字段缺失
+ */
+export type PagingInput<T> = DeepPartial<T>;

package/types/hooks/index.d.ts

@@ -1,3 +1,4 @@
 export * from './activated';
 export * from './feel-size';
 export * from './menus-dispatch';
+export * from './timeout';

package/types/hooks/timeout.d.ts

@@ -0,0 +1,7 @@
+export type ClearTimer = () => void;
+export type SetTimer = (handler: () => void, timeout: number) => void;
+/**
+ * 使用定时器
+ * @param autoClear 是否在生命周期结束前自动清除定时器
+ */
+export declare const useTimeout: (autoClear?: boolean) => [SetTimer, ClearTimer];