mgv-backoffice 1.44.0 → 1.45.0

package/dist/components/Pagination.vue.d.ts

@@ -7,6 +7,10 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         type: NumberConstructor;
         default: number;
     };
+    page: {
+        type: NumberConstructor;
+        default: undefined;
+    };
 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "page-changed": (...args: any[]) => void;
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -18,9 +22,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         type: NumberConstructor;
         default: number;
     };
+    page: {
+        type: NumberConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{
     "onPage-changed"?: ((...args: any[]) => any) | undefined;
 }>, {
+    page: number;
     itemsPerPage: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/composables/useLatestRequest.d.ts

@@ -0,0 +1,51 @@
+/** One begun request: its abort signal and whether it is still the latest. */
+export interface LatestRequestToken {
+    /** Pass to fetch(); aborted as soon as a newer request begins (or on cancel). */
+    signal: AbortSignal;
+    /**
+     * True while no newer begin() / cancel() has happened. Check it after every
+     * await before writing state, so a superseded response can never clobber
+     * the newer one's — and only the latest call clears its loading flag.
+     */
+    isLatest: () => boolean;
+}
+/**
+ * "Latest request wins" guard for views that refetch on every filter change,
+ * poll, or Refresh click. Each `begin()` aborts the previous in-flight request
+ * on the wire and hands back a fresh AbortSignal plus an `isLatest()` check
+ * (a monotonic request id), so a slow, stale response that still lands can be
+ * dropped instead of racing the fresh one.
+ *
+ * `cancel()` aborts the in-flight request and invalidates it without starting
+ * a new one (e.g. the selection was cleared). When called inside a component
+ * setup / effect scope, the in-flight request is cancelled automatically on
+ * unmount.
+ *
+ * ```ts
+ * const latest = useLatestRequest()
+ * async function load() {
+ *   const req = latest.begin()
+ *   loading.value = true
+ *   try {
+ *     const res = await fetchThings(req.signal)
+ *     if (!req.isLatest()) return
+ *     rows.value = res
+ *   } catch (e) {
+ *     if (!req.isLatest() || isAbortError(e)) return
+ *     error.value = String(e)
+ *   } finally {
+ *     if (req.isLatest()) loading.value = false
+ *   }
+ * }
+ * ```
+ */
+export declare function useLatestRequest(): {
+    begin: () => LatestRequestToken;
+    cancel: () => void;
+};
+/**
+ * True for the rejection an aborted fetch() produces (a DOMException — or, in
+ * some runtimes, a plain Error — named "AbortError"). Superseded / cancelled
+ * requests should be swallowed silently rather than shown as an error.
+ */
+export declare function isAbortError(e: unknown): boolean;

package/dist/index.d.ts

@@ -74,6 +74,8 @@ export { useFieldClasses } from './composables/useFieldClasses';
 export type { FieldClasses } from './composables/useFieldClasses';
 export { usePolling } from './composables/usePolling';
 export type { UsePollingOptions } from './composables/usePolling';
+export { useLatestRequest, isAbortError } from './composables/useLatestRequest';
+export type { LatestRequestToken } from './composables/useLatestRequest';
 export { AlertEnum } from './enums/AlertEnum';
 export { BaseBadgeEnum } from './enums/BaseBadgeEnum';
 export { BaseButtonEnum } from './enums/BaseButtonEnum';
@@ -101,7 +103,7 @@ export { methodBadgeSolid, methodBadgeBright, methodBadgeTinted, statusBadgeSoli
 export { rowKeyMissing, rowValueMissing } from './utils/kvRows';
 export type { KeyValueRowLike } from './utils/kvRows';
 export { sanitizeHtml, isSafeHref } from './utils/sanitizeHtml';
-export { fmtNumber, fmtDate, fmtDateTime, fmtDateTimeMs, fmtDateShort, fmtCalendarDate, fmtCalendarDateTime, fmtMsAsSeconds, fmtBytes, fmtPrice, fmtPct, fmtUsd, fmtDuration, formatJson, stringifyValue, } from './utils/format';
+export { fmtNumber, fmtDate, fmtDateTime, fmtDateTimeMs, fmtDateShort, fmtCalendarDate, fmtCalendarDateTime, fmtMsAsSeconds, fmtBytes, fmtPrice, fmtPct, fmtUsd, fmtMoney, fmtDuration, formatJson, stringifyValue, } from './utils/format';
 export { isValidAbsoluteUrl, isValidJson, isValidXml, isValidBase64, } from './utils/validate';
 export { buildSpecParams, firstInvalidNumericSpec } from './utils/specForm';
 export { humanizeEnum, humanizeTextVNodes } from './utils/humanize';