mgv-backoffice 1.44.0 → 1.46.0

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

@@ -0,0 +1,26 @@
+import { ChecklistGroup } from '../types/checklist';
+interface Props {
+    groups: ChecklistGroup[];
+    modelValue: string[];
+    /** Text of the master checkbox; group checkboxes read "<allLabel> <group>". */
+    allLabel?: string;
+    allAriaLabel?: string;
+    /** Accessible name per item checkbox (defaults to the item itself). */
+    itemAriaLabel?: (item: string) => string;
+    /** Render item labels in a monospace font (tickers, ids). */
+    mono?: boolean;
+    maxHeightClass?: string;
+}
+declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: string[]) => any;
+}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+}>, {
+    maxHeightClass: string;
+    mono: boolean;
+    allLabel: string;
+    allAriaLabel: string;
+    itemAriaLabel: (item: string) => string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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/useDirtyState.d.ts

@@ -0,0 +1,24 @@
+import { ComputedRef } from 'vue';
+/**
+ * JSON-serialise a value with object keys sorted at every depth, so two
+ * structurally equal values always produce the same string regardless of
+ * key insertion order (arrays keep their order).
+ */
+export declare function stableStringify(value: unknown): string;
+/**
+ * Unsaved-changes tracking for an edit form. `snapshot` returns the form's
+ * current state (read reactively); `dirty` is true whenever it differs from
+ * the last clean baseline. Call `markClean()` after loading or saving to make
+ * the current state the new baseline. Comparison is structural (key order is
+ * ignored), so a server echo that reorders keys never reads as an edit.
+ *
+ * ```ts
+ * const form = reactive({ name: '', params: {} })
+ * const { dirty, markClean } = useDirtyState(() => form)
+ * // …load → assign form → markClean(); Save enabled while dirty.value
+ * ```
+ */
+export declare function useDirtyState(snapshot: () => unknown): {
+    dirty: ComputedRef<boolean>;
+    markClean: () => void;
+};

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

@@ -44,6 +44,7 @@ export { default as BaseFilterChip } from './components/BaseFilterChip.vue';
 export { default as BaseCredentialsForm } from './components/BaseCredentialsForm.vue';
 export { default as BasePillPickerModal } from './components/BasePillPickerModal.vue';
 export { default as BaseBarDistribution } from './components/BaseBarDistribution.vue';
+export { default as BaseGroupedChecklist } from './components/BaseGroupedChecklist.vue';
 export type { CredentialsView, CredentialsUpdate } from './components/BaseCredentialsForm.vue';
 export { default as BaseDateTimePicker } from './components/BaseDateTimePicker.vue';
 export type { DateTimePickerMode } from './components/BaseDateTimePicker.vue';
@@ -74,6 +75,9 @@ 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 { useDirtyState, stableStringify } from './composables/useDirtyState';
+export type { LatestRequestToken } from './composables/useLatestRequest';
 export { AlertEnum } from './enums/AlertEnum';
 export { BaseBadgeEnum } from './enums/BaseBadgeEnum';
 export { BaseButtonEnum } from './enums/BaseButtonEnum';
@@ -96,12 +100,13 @@ export type { SpecField, SpecFieldType, SpecFieldValue } from './types/specField
 export type { StatBreakdownItem } from './types/statBreakdown';
 export type { PillPickerItem } from './types/pillPicker';
 export type { DistributionBar } from './types/distribution';
+export type { ChecklistGroup } from './types/checklist';
 export { getBaseColor, getBaseColorOf } from './utils/util';
 export { methodBadgeSolid, methodBadgeBright, methodBadgeTinted, statusBadgeSolid, statusBadgeTinted, statusBadgeSoft, } from './utils/httpColors';
 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';

package/dist/types/checklist.d.ts

@@ -0,0 +1,6 @@
+/** One group of a BaseGroupedChecklist: a heading plus its selectable item ids. */
+export interface ChecklistGroup {
+    key: string;
+    label: string;
+    items: string[];
+}