@mmlogic/components 0.4.0 → 0.4.1

package/dist/types/components/table/mrd-table/mrd-table.d.ts

@@ -5,6 +5,11 @@ export declare class MrdTable {
     el: HTMLElement;
     private pendingPages;
     private debounceTimer;
+    /** Timestamp of the last mrdLoadPage emission per outstanding page — drives stale-request detection. */
+    private requestedAt;
+    /** Retry count per page since it first became stale. */
+    private retryAttempts;
+    private staleCheckTimer;
     private outsideClickHandler;
     private keydownHandler;
     private createPickerClickHandler;
@@ -26,6 +31,9 @@ export declare class MrdTable {
     rowHeight: number;
     /** Height of the scroll container in px. */
     tableHeight: number;
+    /** Time (ms) to wait for setPage() before retrying a page request; after
+     *  MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages). */
+    requestTimeoutMs: number;
     /** Clamp renderEnd when totalElements shrinks (e.g. after a filter is applied). */
     totalElementsChanged(newVal: number): void;
     /** Reset to primary view when the item prop is replaced from outside. */
@@ -34,6 +42,8 @@ export declare class MrdTable {
     private activeViewIdx;
     loadedPages: Map<number, Record<string, any>[]>;
     requestedPages: Set<number>;
+    /** Pages that timed out MAX_RETRY_ATTEMPTS times — rendered as a retry row instead of shimmer. */
+    failedPages: Set<number>;
     renderStart: number;
     renderEnd: number;
     colWidths: number[];
@@ -78,6 +88,11 @@ export declare class MrdTable {
         path: string;
         qs: string;
     }>;
+    /** Fired when a page request timed out MAX_RETRY_ATTEMPTS times without setPage() being called.
+     *  Purely informational — the table shows its own retry row regardless of whether a host listens. */
+    mrdPageError: EventEmitter<{
+        page: number;
+    }>;
     /** Fired when a data row is clicked. Detail is the full row object including _links. */
     mrdRowClick: EventEmitter<Record<string, any>>;
     /** Fired when a toolbar action button is clicked.
@@ -105,6 +120,7 @@ export declare class MrdTable {
         aggQs: string;
     }>;
     componentWillLoad(): void;
+    componentDidLoad(): void;
     private applyDefaultSort;
     /**
      * Initialise (or reset) the virtual scroll.
@@ -159,10 +175,17 @@ export declare class MrdTable {
     private resetPages;
     private handleSortClick;
     private applySort;
+    /** Emits mrdLoadPage for a page and records the request timestamp for stale-request detection. */
+    private emitLoadPage;
     private emitPagesForWindow;
     private getRow;
     private requestPagesForWindow;
     private flushPendingPages;
+    /** Scans outstanding requests for staleness: retries up to MAX_RETRY_ATTEMPTS times,
+     *  then gives up and marks the page as failed (rendered as a retry row). */
+    private checkStalePages;
+    /** Manually retry a page the user gave up on (clicked the retry row). */
+    private retryPage;
     private handleScroll;
     private handleFilterToggle;
     private handleFilterOpen;

package/dist/types/components/table/mrd-table/virtual-scroll.d.ts

@@ -7,6 +7,10 @@ export declare const BUFFER = 10;
 /** Wait this long (ms) after the last scroll event before requesting pages,
  *  so pages the user quickly scrolls past are skipped. */
 export declare const REQUEST_DEBOUNCE_MS = 150;
+/** Default time (ms) to wait for setPage() before treating a request as stale and retrying. */
+export declare const REQUEST_TIMEOUT_MS = 15000;
+/** Max retries for a stale page request before giving up and showing a retry row. */
+export declare const MAX_RETRY_ATTEMPTS = 3;
 export declare function visibleCount(tableHeight: number, rowHeight: number): number;
 /** Render window (with buffer) for the given scroll offset. */
 export declare function computeWindow(scrollTop: number, rowHeight: number, tableHeight: number, total: number): {
@@ -24,3 +28,6 @@ export declare function getRowFromPages(pages: Map<number, Record<string, any>[]
 export declare function computeEffectiveTotal(loadedPages: Map<number, Record<string, any>[]>, pageSize: number, baseTotal: number): number;
 /** True when some loaded page was short — the exact total is then known. */
 export declare function isTotalKnownFromPages(loadedPages: Map<number, Record<string, any>[]>, pageSize: number): boolean;
+/** Pages whose request timestamp is older than timeoutMs — candidates for retry or failure.
+ *  Caller is expected to already exclude pages present in loadedPages. */
+export declare function getStalePages(requestedAt: Map<number, number>, now: number, timeoutMs: number): number[];

package/dist/types/components.d.ts

@@ -687,6 +687,11 @@ export namespace Components {
           * @default ''
          */
         "parentId": string;
+        /**
+          * Time (ms) to wait for setPage() before retrying a page request; after MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages).
+          * @default REQUEST_TIMEOUT_MS
+         */
+        "requestTimeoutMs": number;
         /**
           * Row height in px — used for spacer and scroll-position maths.
           * @default 36
@@ -1305,6 +1310,7 @@ declare global {
     };
     interface HTMLMrdTableElementEventMap {
         "mrdLoadPage": { page: number; sort: string; path: string; qs: string };
+        "mrdPageError": { page: number };
         "mrdRowClick": Record<string, any>;
         "mrdAction": { action: string; path?: string; qs?: string; dataClass?: string; parentPath?: string | null; basicType?: string };
         "mrdDownload": { href: string; fileName: string };
@@ -2175,6 +2181,10 @@ declare namespace LocalJSX {
           * Fired when a page needs to be fetched. Host fetches and calls setPage(). `sort` is the raw query-param value, e.g. "name" or "name,desc".
          */
         "onMrdLoadPage"?: (event: MrdTableCustomEvent<{ page: number; sort: string; path: string; qs: string }>) => void;
+        /**
+          * Fired when a page request timed out MAX_RETRY_ATTEMPTS times without setPage() being called. Purely informational — the table shows its own retry row regardless of whether a host listens.
+         */
+        "onMrdPageError"?: (event: MrdTableCustomEvent<{ page: number }>) => void;
         /**
           * Fired when a data row is clicked. Detail is the full row object including _links.
          */
@@ -2189,6 +2199,11 @@ declare namespace LocalJSX {
           * @default ''
          */
         "parentId"?: string;
+        /**
+          * Time (ms) to wait for setPage() before retrying a page request; after MAX_RETRY_ATTEMPTS retries the page is marked failed (see failedPages).
+          * @default REQUEST_TIMEOUT_MS
+         */
+        "requestTimeoutMs"?: number;
         /**
           * Row height in px — used for spacer and scroll-position maths.
           * @default 36
@@ -2456,6 +2471,7 @@ declare namespace LocalJSX {
         "pageSize": number;
         "rowHeight": number;
         "tableHeight": number;
+        "requestTimeoutMs": number;
     }
     interface MrdTextFieldAttributes {
         "name": string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmlogic/components",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Stencil.js web component library for dynamic forms and virtual-scroll data tables",
   "license": "MIT",
   "author": "Mosterd",