@ramathibodi/nuxt-commons 4.0.11 → 4.0.13

package/dist/runtime/components/model/iterator.vue.d.ts

@@ -29,6 +29,15 @@ interface Props extends /* @vue-ignore */ InstanceType<typeof VDataIterator['$pr
     api?: boolean;
     perPageStorageKey?: string;
     perPageStorageEnabled?: boolean;
+    autoRefresh?: number | boolean;
+    autoRefreshDefault?: number;
+    autoRefreshControl?: boolean;
+    importConcurrency?: number;
+    virtual?: boolean;
+    virtualThreshold?: number;
+    virtualHeight?: number | string;
+    virtualItemHeight?: number;
+    virtualItemsPerRow?: number;
 }
 /**
  * Public props accepted by ModelIterator.
@@ -39,17 +48,18 @@ declare function openDialog(item?: object): void;
 declare var __VLS_15: {
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
     page: number;
     itemsPerPage: number;
@@ -75,36 +85,55 @@ declare var __VLS_15: {
     item: import("vuetify/lib/components/VDataIterator/composables/items.mjs").DataIteratorItem<Record<string, any>>;
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
-}, __VLS_38: {
+}, __VLS_62: {
+    item: any;
+    operation: {
+        openDialog: typeof openDialog;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
+        canServerPageable: boolean;
+        canServerSearch: boolean;
+        canCreate: boolean;
+        canUpdate: boolean;
+        canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
+    };
+}, __VLS_65: {
     color: string | undefined;
     isActive: boolean;
-}, __VLS_58: {}, __VLS_66: {
+}, __VLS_85: {}, __VLS_93: {
     items: Record<string, any>[];
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
     page: number;
     itemsPerPage: number;
@@ -125,93 +154,138 @@ declare var __VLS_15: {
     toggleGroup: ReturnType<typeof import("vuetify/lib/components/VDataTable/composables/group.mjs").provideGroupBy>["toggleGroup"];
     itemsCount: number;
     groupedItems: readonly (import("vuetify/lib/components/VDataIterator/composables/items.mjs").DataIteratorItem<Record<string, any>> | import("vuetify/lib/components/VDataTable/composables/group.mjs").Group<import("vuetify/lib/components/VDataIterator/composables/items.mjs").DataIteratorItem<Record<string, any>>> | import("vuetify/lib/components/VDataTable/composables/group.mjs").GroupSummary<import("vuetify/lib/components/VDataIterator/composables/items.mjs").DataIteratorItem<Record<string, any>>>)[];
-}, __VLS_92: {
+}, __VLS_119: {
     reload: () => void;
-}, __VLS_108: {
+}, __VLS_129: {
+    enabled: import("vue").ComputedRef<boolean>;
+    isActive: import("vue").ComputedRef<boolean>;
+    isLoading: import("vue").ComputedRef<boolean>;
+    intervalSeconds: import("vue").ComputedRef<number>;
+    remainingSeconds: import("vue").Ref<number>;
+    isUserPaused: import("vue").Ref<boolean>;
+    togglePause: () => void;
+    reset: () => void;
+    reload: () => void | Promise<void>;
+}, __VLS_142: {
     items: Record<string, any>[];
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
-}, __VLS_121: {
+}, __VLS_155: {
     items: Record<string, any>[];
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
-}, __VLS_175: never, __VLS_176: {
+}, __VLS_209: never, __VLS_210: {
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
-}, __VLS_201: never, __VLS_202: {
+}, __VLS_235: never, __VLS_236: {
     operation: {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     };
-}, __VLS_270: any;
+}, __VLS_261: never, __VLS_262: {
+    operation: {
+        openDialog: typeof openDialog;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
+        canServerPageable: boolean;
+        canServerSearch: boolean;
+        canCreate: boolean;
+        canUpdate: boolean;
+        canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
+    };
+}, __VLS_330: any, __VLS_332: {
+    isImporting: boolean;
+    total: number;
+    processed: number;
+    succeeded: number;
+    failed: number;
+    percent: number;
+};
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_175>]?: (props: typeof __VLS_176) => any;
+    [K in NonNullable<typeof __VLS_209>]?: (props: typeof __VLS_210) => any;
+} & {
+    [K in NonNullable<typeof __VLS_235>]?: (props: typeof __VLS_236) => any;
 } & {
-    [K in NonNullable<typeof __VLS_201>]?: (props: typeof __VLS_202) => any;
+    [K in NonNullable<typeof __VLS_261>]?: (props: typeof __VLS_262) => any;
 } & {
     default?: (props: typeof __VLS_15) => any;
 } & {
     item?: (props: typeof __VLS_35) => any;
 } & {
-    loader?: (props: typeof __VLS_38) => any;
+    item?: (props: typeof __VLS_62) => any;
 } & {
-    loaderItem?: (props: typeof __VLS_58) => any;
+    loader?: (props: typeof __VLS_65) => any;
 } & {
-    header?: (props: typeof __VLS_66) => any;
+    loaderItem?: (props: typeof __VLS_85) => any;
 } & {
-    title?: (props: typeof __VLS_92) => any;
+    header?: (props: typeof __VLS_93) => any;
 } & {
-    search?: (props: typeof __VLS_108) => any;
+    title?: (props: typeof __VLS_119) => any;
 } & {
-    toolbarItems?: (props: typeof __VLS_121) => any;
+    autoRefreshControl?: (props: typeof __VLS_129) => any;
 } & {
-    form?: (props: typeof __VLS_270) => any;
+    search?: (props: typeof __VLS_142) => any;
+} & {
+    toolbarItems?: (props: typeof __VLS_155) => any;
+} & {
+    form?: (props: typeof __VLS_330) => any;
+} & {
+    importProgress?: (props: typeof __VLS_332) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
     noDataText: string;
@@ -235,48 +309,85 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     itemsPerPage: number;
     api: boolean;
     perPageStorageEnabled: boolean;
+    autoRefresh: boolean;
+    autoRefreshDefault: number;
+    autoRefreshControl: boolean;
+    importConcurrency: number;
+    virtual: undefined;
+    virtualThreshold: number;
+    virtualHeight: string;
+    virtualItemHeight: number;
+    virtualItemsPerRow: undefined;
 }>>, {
-    reload: () => void;
+    reload: (() => Promise<void> | undefined) | (() => Promise<void>);
     operation: import("vue").Ref<{
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     }, {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: import("vue").ComputedRef<boolean>;
         canServerSearch: import("vue").ComputedRef<boolean>;
         canCreate: import("vue").ComputedRef<boolean>;
         canUpdate: import("vue").ComputedRef<boolean>;
         canDelete: import("vue").ComputedRef<boolean>;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     } | {
         openDialog: typeof openDialog;
-        createItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>;
-        importItems: (importItemsList: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void;
-        updateItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        deleteItem: (item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>;
-        reload: () => void;
-        setSearch: (keyword: string) => void;
+        createItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback, importing?: boolean) => Promise<any>);
+        importItems: ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void) | ((importData: Record<string, any>[], callback?: import("../../types/formDialog.js").FormDialogCallback) => void);
+        updateItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<void>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        deleteItem: ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>) | ((item: Record<string, any>, callback?: import("../../types/formDialog.js").FormDialogCallback) => Promise<any>);
+        reload: (() => Promise<void> | undefined) | (() => Promise<void>);
+        setSearch: ((keyword: string) => void) | ((keyword: string) => void);
         canServerPageable: boolean;
         canServerSearch: boolean;
         canCreate: boolean;
         canUpdate: boolean;
         canDelete: boolean;
+        autoRefresh: import("vue").Raw<import("../../composables/autoRefresh.js").UseAutoRefreshHandle>;
     }>;
+    autoRefresh: import("../../composables/autoRefresh.js").UseAutoRefreshHandle;
+    importProgress: {
+        isImporting: import("vue").Ref<boolean, boolean>;
+        total: import("vue").Ref<number, number>;
+        processed: import("vue").Ref<number, number>;
+        succeeded: import("vue").Ref<number, number>;
+        failed: import("vue").Ref<number, number>;
+        errors: import("vue").Ref<{
+            index: number;
+            message: string;
+        }[], import("../../composables/importProgress.js").ImportError[] | {
+            index: number;
+            message: string;
+        }[]>;
+        percent: import("vue").ComputedRef<number>;
+        reset: () => void;
+        run: <T = any>(items: T[], worker: import("../../composables/importProgress.js").ImportWorker<T>, options?: {
+            concurrency
+            /**
+             * ModelIterator connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
+             * This doc block is consumed by vue-docgen for generated API documentation.
+             */
+            ?: number;
+        }) => Promise<import("../../composables/importProgress.js").ImportSummary>;
+    };
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
     noDataText: string;
     dialogFullscreen: boolean;
@@ -299,6 +410,15 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     itemsPerPage: number;
     api: boolean;
     perPageStorageEnabled: boolean;
+    autoRefresh: boolean;
+    autoRefreshDefault: number;
+    autoRefreshControl: boolean;
+    importConcurrency: number;
+    virtual: undefined;
+    virtualThreshold: number;
+    virtualHeight: string;
+    virtualItemHeight: number;
+    virtualItemsPerRow: undefined;
 }>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/runtime/composables/apiModel.d.ts

@@ -31,10 +31,29 @@ export declare function useApiModel<T extends ApiModelComposableProps>(props: T)
     canUpdate: import("vue").ComputedRef<boolean>;
     canDelete: import("vue").ComputedRef<boolean>;
     createItem: (item: Record<string, any>, callback?: FormDialogCallback, importing?: boolean) => Promise<any>;
-    importItems: (importItemsList: Record<string, any>[], callback?: FormDialogCallback) => void;
+    importItems: (importData: Record<string, any>[], callback?: FormDialogCallback) => void;
     updateItem: (item: Record<string, any>, callback?: FormDialogCallback) => Promise<any>;
     deleteItem: (item: Record<string, any>, callback?: FormDialogCallback) => Promise<any>;
-    loadItems: (options: any) => void;
-    reload: () => void;
+    loadItems: (options: any) => Promise<void>;
+    reload: () => Promise<void>;
     isLoading: import("vue").Ref<boolean, boolean>;
+    importProgress: {
+        isImporting: import("vue").Ref<boolean, boolean>;
+        total: import("vue").Ref<number, number>;
+        processed: import("vue").Ref<number, number>;
+        succeeded: import("vue").Ref<number, number>;
+        failed: import("vue").Ref<number, number>;
+        errors: import("vue").Ref<{
+            index: number;
+            message: string;
+        }[], import("./importProgress.js").ImportError[] | {
+            index: number;
+            message: string;
+        }[]>;
+        percent: import("vue").ComputedRef<number>;
+        reset: () => void;
+        run: <T_1 = any>(items: T_1[], worker: import("./importProgress.js").ImportWorker<T_1>, options?: {
+            concurrency?: number;
+        }) => Promise<import("./importProgress.js").ImportSummary>;
+    };
 };

package/dist/runtime/composables/apiModel.js

@@ -3,7 +3,7 @@ import { watchDebounced } from "@vueuse/core";
 import { useAlert } from "./alert.js";
 import { useApiModelOperation } from "./apiModelOperation.js";
 import { arrayWrap } from "../utils/array.js";
-import pLimit from "p-limit";
+import { useImportProgress } from "./importProgress.js";
 export function stripModelByQualifier(modelName) {
   return modelName.split("By")[0].trim();
 }
@@ -20,6 +20,7 @@ export function useApiModel(props) {
   const search = ref();
   const currentOptions = ref();
   const isLoading = ref(false);
+  const importProgress = useImportProgress();
   function setSearch(keyword) {
     search.value = keyword;
   }
@@ -60,27 +61,33 @@ export function useApiModel(props) {
       if (callback && callback.setData) callback.setData(result);
       return result;
     }).catch((error) => {
+      if (importing) throw error;
       alert?.addAlert({ alertType: "error", message: error?.message || String(error) });
     }).finally(() => {
       if (!importing) isLoading.value = false;
       if (callback) callback.done();
     });
   }
-  function importItems(importItemsList, callback) {
+  function importItems(importData, callback) {
+    if (importProgress.isImporting.value) return;
+    if (importData.length === 0) {
+      if (callback) callback.done();
+      return;
+    }
     isLoading.value = true;
-    const limit = pLimit(50);
-    const importPromises = importItemsList.map(
-      (item) => limit(
-        () => (item[props.modelKey || "id"] ? updateItem(item, void 0).then((result) => {
-          if (!result) {
-            return createItem(Object.assign({}, props.initialData, item), void 0, true);
-          }
-        }) : createItem(Object.assign({}, props.initialData, item), void 0, true)).catch((error) => {
-          alert?.addAlert({ alertType: "error", message: error?.message || String(error) });
-        })
-      )
-    );
-    Promise.all(importPromises).finally(() => {
+    const worker = (item) => {
+      const createAsNew = () => createItem(Object.assign({}, props.initialData, item), void 0, true);
+      return item[props.modelKey || "id"] ? updateItem(item, void 0).then((result) => {
+        if (!result) return createAsNew();
+      }) : createAsNew();
+    };
+    importProgress.run(importData, worker, { concurrency: props.importConcurrency }).then(({ succeeded, failed }) => {
+      if (failed > 0) {
+        alert?.addAlert({ alertType: "warning", message: `\u0E19\u0E33\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E33\u0E40\u0E23\u0E47\u0E08 ${succeeded} \u0E23\u0E32\u0E22\u0E01\u0E32\u0E23, \u0E25\u0E49\u0E21\u0E40\u0E2B\u0E25\u0E27 ${failed} \u0E23\u0E32\u0E22\u0E01\u0E32\u0E23` });
+      } else {
+        alert?.addAlert({ alertType: "success", message: `\u0E19\u0E33\u0E40\u0E02\u0E49\u0E32\u0E2A\u0E33\u0E40\u0E23\u0E47\u0E08 ${succeeded} \u0E23\u0E32\u0E22\u0E01\u0E32\u0E23` });
+      }
+    }).finally(() => {
       isLoading.value = false;
       reload();
       if (callback) callback.done();
@@ -119,7 +126,7 @@ export function useApiModel(props) {
   function loadItems(options) {
     currentOptions.value = options;
     isLoading.value = true;
-    ops.value.readPageable(
+    return ops.value.readPageable(
       fields.value,
       props.modelBy,
       {
@@ -140,10 +147,10 @@ export function useApiModel(props) {
   }
   function reload() {
     if (currentOptions.value) {
-      loadItems(currentOptions.value);
+      return loadItems(currentOptions.value);
     } else {
       isLoading.value = true;
-      ops.value.read(
+      return ops.value.read(
         fields.value,
         props.modelBy
       ).then((result) => {
@@ -180,6 +187,7 @@ export function useApiModel(props) {
     deleteItem,
     loadItems,
     reload,
-    isLoading
+    isLoading,
+    importProgress
   };
 }

package/dist/runtime/composables/autoRefresh.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Auto-refresh composable: drives a countdown that fires a `reload()` at a configurable
+ * interval (in seconds), with four pause sources — document visibility, external paused
+ * ref, in-flight loading, and user toggle. Designed for `<ModelTable>` and
+ * `<ModelIterator>` but composable-shaped so any consumer can use it.
+ */
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
+export interface UseAutoRefreshOptions {
+    /** Polling interval. Number ⇒ seconds. `true` ⇒ `defaultSeconds`. Falsy ⇒ disabled. */
+    interval: MaybeRefOrGetter<number | boolean | undefined>;
+    /**
+     * Function called when a tick fires. If it returns a Promise it is awaited before the
+     * countdown resets, so the next cycle starts only after the reload has settled (rather
+     * than restarting while data is still in flight). Overlapping reloads are prevented by the
+     * `isLoading` gate below, which freezes ticks for as long as a request is in flight — wire
+     * it for that guarantee, since the per-second timer itself keeps ticking during a slow reload.
+     */
+    reload: () => void | Promise<void>;
+    /**
+     * Optional. While true the countdown freezes and ticks are suppressed. Wire this to the
+     * model's loading flag. Note: a model that never clears `isLoading` (e.g. an error path
+     * that leaves it set) will halt polling — by design, since polling-while-loading is the
+     * thing this gate prevents.
+     */
+    isLoading?: Ref<boolean>;
+    /** Optional external pause signal (e.g. dialog open). */
+    paused?: Ref<boolean>;
+    /** Seconds used when `interval === true`. Defaults to 60. */
+    defaultSeconds?: number;
+}
+export interface UseAutoRefreshHandle {
+    enabled: ComputedRef<boolean>;
+    isActive: ComputedRef<boolean>;
+    isLoading: ComputedRef<boolean>;
+    intervalSeconds: ComputedRef<number>;
+    remainingSeconds: Ref<number>;
+    isUserPaused: Ref<boolean>;
+    togglePause: () => void;
+    reset: () => void;
+    reload: () => void | Promise<void>;
+}
+export declare function useAutoRefresh(opts: UseAutoRefreshOptions): UseAutoRefreshHandle;