@mmlogic/components 0.4.0 → 0.4.2

package/dist/mosterdcomponents/validation-DbEViuiw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-DbEViuiw.js","sources":["src/utils/validation.ts"],"sourcesContent":["import { ClientLayoutItemFieldDataType } from '../types';\n\nexport function validateRequired(value: unknown): boolean {\n  if (value === null || value === undefined) return false;\n  if (typeof value === 'string') return value.trim().length > 0;\n  if (Array.isArray(value)) return value.length > 0;\n  if (typeof value === 'object') {\n    // HyperlinkValue check\n    const hv = value as { href?: unknown };\n    if ('href' in hv) return typeof hv.href === 'string' && hv.href.trim().length > 0;\n    // CurrencyValue check\n    const cv = value as { amount?: unknown };\n    if ('amount' in cv) return cv.amount !== null && cv.amount !== undefined && cv.amount !== '';\n  }\n  return true;\n}\n\nexport function validateEmail(value: string): boolean {\n  if (!value) return true;\n  return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value);\n}\n\nexport function validateUrl(value: string): boolean {\n  if (!value) return true;\n  try {\n    const url = new URL(value);\n    return url.protocol === 'http:' || url.protocol === 'https:';\n  } catch {\n    return false;\n  }\n}\n\nexport function validateNumber(value: unknown, dataType: ClientLayoutItemFieldDataType): boolean {\n  if (value === null || value === undefined || value === '') return true;\n  const num = Number(value);\n  if (isNaN(num)) return false;\n  if (dataType === ClientLayoutItemFieldDataType.INTEGER) {\n    return Number.isInteger(num);\n  }\n  if (dataType === ClientLayoutItemFieldDataType.PERCENTAGE) {\n    return num >= 0 && num <= 100;\n  }\n  return true;\n}\n"],"names":[],"mappings":";;;AAEM,SAAU,gBAAgB,CAAC,KAAc,EAAA;AAC7C,IAAA,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;AAAE,QAAA,OAAO,KAAK;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;AAC7D,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC;AACjD,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;;QAE7B,MAAM,EAAE,GAAG,KAA2B;QACtC,IAAI,MAAM,IAAI,EAAE;AAAE,YAAA,OAAO,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;;QAEjF,MAAM,EAAE,GAAG,KAA6B;QACxC,IAAI,QAAQ,IAAI,EAAE;AAAE,YAAA,OAAO,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE;;AAE9F,IAAA,OAAO,IAAI;AACb;AAEM,SAAU,aAAa,CAAC,KAAa,EAAA;AACzC,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AACvB,IAAA,OAAO,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;AACjD;AAEM,SAAU,WAAW,CAAC,KAAa,EAAA;AACvC,IAAA,IAAI,CAAC,KAAK;AAAE,QAAA,OAAO,IAAI;AACvB,IAAA,IAAI;AACF,QAAA,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC;QAC1B,OAAO,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;;IAC5D,OAAA,EAAA,EAAM;AACN,QAAA,OAAO,KAAK;;AAEhB;AAEM,SAAU,cAAc,CAAC,KAAc,EAAE,QAAuC,EAAA;IACpF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;AAAE,QAAA,OAAO,IAAI;AACtE,IAAA,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,GAAG,CAAC;AAAE,QAAA,OAAO,KAAK;AAC5B,IAAA,IAAI,QAAQ,KAAK,6BAA6B,CAAC,OAAO,EAAE;AACtD,QAAA,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;;AAE9B,IAAA,IAAI,QAAQ,KAAK,6BAA6B,CAAC,UAAU,EAAE;AACzD,QAAA,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG;;AAE/B,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/types/components/documents/mrd-document-container/mrd-document-container.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { ClientArchetype, ClientLayoutItem } from '../../../types/client-layout';
+import { ClientArchetype, ClientLayoutItem, ClientLayoutNavigateBehaviour } from '../../../types/client-layout';
 /**
  * Owns a document collection view: a single toolbar (view switch + collection
  * actions like "New folder", and — later — upload / drag-drop) plus the two
@@ -49,10 +49,14 @@ export declare class MrdDocumentContainer {
         qs: string;
         aggQs: string;
     }>;
-    /** A row / document was activated. Host routes to the object page. */
+    /** A row / document was activated. Host routes to the object page. Documents
+     *  are always the "quick look" use case, so navigateBehaviour is hardcoded
+     *  to OVERLAY_PAGE here — unlike the generic VIEW/RELATED_VIEW table path in
+     *  mrd-layout-section, which takes it from the item's configuration. */
     mrdNavigate: EventEmitter<{
         href?: string;
         label: string;
+        navigateBehaviour?: ClientLayoutNavigateBehaviour;
     }>;
     /** A table toolbar action was triggered. */
     mrdAction: EventEmitter<{

package/dist/types/components/documents/mrd-document-view/mrd-document-view.d.ts

@@ -16,6 +16,15 @@ export declare class MrdDocumentView {
     /** The data record from the /data endpoint. Fields keyed by name; relations under `_links`. */
     data: Record<string, unknown>;
     locale: string;
+    /** Signed URL for the file's inline preview (mrd-file-preview), resolved by
+     *  the host in response to mrdLoadPreview. Empty while unresolved — the
+     *  preview area shows a loading state until the host injects a value. */
+    previewUrl: string;
+    /** Minimum height (px) of the inline preview area — it stretches to fill the
+     *  available row height in the wide side-by-side layout (see mrd-document-view.scss),
+     *  and falls back to this height when stacked. Overlay hosts typically pass a
+     *  smaller value than the full-page default to fit available chrome. */
+    previewHeight: number;
     /** Navigate to the container (dossier). Host resolves the href and routes. */
     mrdNavigate: EventEmitter<{
         href?: string;
@@ -26,11 +35,30 @@ export declare class MrdDocumentView {
         href: string;
         fileName: string;
     }>;
+    /** The file slot has an href and needs a signed URL for inline preview.
+     *  Fired once on load and again whenever the file href changes (e.g. the
+     *  overlay is reused for a different document via prev/next). Host resolves
+     *  it and calls back with `previewUrl` — the same pattern as mrdLoadImage /
+     *  setImagePreview on mrd-layout-section. */
+    mrdLoadPreview: EventEmitter<{
+        href: string;
+    }>;
+    /** Tracks the href a preview was last requested for, so componentDidLoad and
+     *  the data watcher don't emit duplicate requests for the same file. */
+    private lastPreviewHref;
+    componentDidLoad(): void;
+    dataChanged(): void;
+    private requestPreviewIfNeeded;
     /** Value of a value-slot: reads data[field] via the slot→field map. */
     private slotValue;
     /** Relation link for a relation-slot: reads data._links[field]. */
     private slotLink;
     private renderContainer;
-    private renderFile;
+    /** Filename + download button — part of the metadata column, not the preview
+     *  panel, so it stays next to the title/summary in the wide side-by-side layout. */
+    private renderFileMeta;
+    /** The preview panel itself (iframe/image/loading state) — its own grid
+     *  column in the wide layout, so it can take the full available height. */
+    private renderPreviewPanel;
     render(): any;
 }

package/dist/types/components/documents/mrd-file-preview/file-preview-kind.d.ts

@@ -0,0 +1,9 @@
+/** Pure classification logic for mrd-file-preview — no Stencil dependency. */
+export type FilePreviewKind = 'pdf' | 'image' | 'unsupported';
+/**
+ * Decide how to render a file given its declared mime type and/or file name.
+ * A declared mime type is authoritative when present (a mismatched file name
+ * extension is ignored); the file name extension is only consulted as a
+ * fallback when no mime type is known.
+ */
+export declare function detectPreviewKind(mimeType?: string | null, fileName?: string | null): FilePreviewKind;

package/dist/types/components/documents/mrd-file-preview/mrd-file-preview.d.ts

@@ -0,0 +1,41 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+/**
+ * Renders a signed URL inline as a PDF (native browser viewer, via `<iframe>`)
+ * or an image (`<img>`), picked from `mimeType`/`fileName`. Purely
+ * presentational: the signed URL is used directly as element `src` — a
+ * navigation, not a fetch/XHR, so no CORS handling is needed here. Fetching
+ * the signed URL itself is the host's responsibility, same as `mrdLoadImage` /
+ * `setImagePreview` on mrd-layout-section.
+ */
+export declare class MrdFilePreview {
+    /** Signed URL to render. */
+    src: string;
+    /** Declared mime type (e.g. 'application/pdf', 'image/png'), when known.
+     *  Authoritative over `fileName` when present. */
+    mimeType: string;
+    /** Original file name — used for extension-based detection when `mimeType`
+     *  is absent, and as alt/title text. */
+    fileName: string;
+    /** The file's own reference href (not the signed preview URL in `src`).
+     *  When set, an unsupported type falls back to the same download button
+     *  used elsewhere in the library, so hosts need no new wiring. */
+    href: string;
+    locale: string;
+    /** The image failed to load — most likely an expired signed URL. Host
+     *  should fetch a fresh signed URL and update `src`.
+     *  Note: this is only raised for images. Browsers don't reliably surface
+     *  HTTP-level failures (e.g. a 403 on an expired URL) through an iframe's
+     *  load/error events, so the same detection isn't available for PDFs. */
+    mrdPreviewReload: EventEmitter<void>;
+    /** Download the file. Same shape as mrd-document-view / mrd-layout-section's
+     *  mrdDownload — host resolves `href` to a signed URL. */
+    mrdDownload: EventEmitter<{
+        href: string;
+        fileName: string;
+    }>;
+    private imageFailed;
+    srcChanged(): void;
+    private onImageError;
+    private retry;
+    render(): any;
+}

package/dist/types/components/layout/mrd-layout-section/mrd-layout-section.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { ClientLayoutItem, ClientLayoutItemNavigate, ClientViewMetadata, ClientArchetype, RelationSearchResult } from '../../../types/client-layout';
+import { ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, ClientArchetype, RelationSearchResult } from '../../../types/client-layout';
 import { DistinctValue } from '../../documents/mrd-document-list/folder-tree';
 export declare class MrdLayoutSection {
     el: HTMLElement;
@@ -17,16 +17,23 @@ export declare class MrdLayoutSection {
     /** Top-level archetypes on the object dashboard. When it contains commons.document,
      *  the record is rendered as a single-document view instead of generic fields. */
     archetypes: ClientArchetype[];
+    /** Minimum height (px) of the commons.document inline file preview — it
+     *  stretches taller in the wide side-by-side layout. Pass a smaller value
+     *  when embedding the record in an overlay with limited height. */
+    documentPreviewHeight: number;
     private searchQueryMap;
     private searchResultsMap;
     private imagePreviewUrl;
     private imagePreviews;
     private openHistoryField;
+    /** Signed URL for the commons.document archetype's inline file preview. */
+    private documentPreviewUrl;
     private historyClickOutside;
     mrdNavigate: EventEmitter<{
         href?: string;
         label: string;
         navigate?: ClientLayoutItemNavigate;
+        navigateBehaviour?: ClientLayoutNavigateBehaviour;
     }>;
     mrdSearch: EventEmitter<{
         query: string;
@@ -51,6 +58,12 @@ export declare class MrdLayoutSection {
         fieldName: string;
         href: string;
     }>;
+    /** Re-emitted from an embedded mrd-document-view's mrdLoadPreview (commons.document
+     *  single-object view); host resolves the file href to a signed URL and calls
+     *  setDocumentPreviewUrl(). */
+    mrdLoadDocumentPreview: EventEmitter<{
+        href: string;
+    }>;
     /** Re-emitted from an embedded mrd-table's mrdAction; host builds the target URL from dataClass. */
     mrdViewAction: EventEmitter<{
         name: string;
@@ -125,6 +138,9 @@ export declare class MrdLayoutSection {
     setImagePreview(fieldName: string, url: string): Promise<void>;
     /** Open the lightbox directly with a URL (e.g. after mrdDownload on a FILE field). */
     openImagePreview(url: string): Promise<void>;
+    /** Provide a resolved signed URL for the commons.document archetype's inline
+     *  file preview, in response to mrdLoadDocumentPreview. */
+    setDocumentPreviewUrl(url: string): Promise<void>;
     private resolveSearchKey;
     private handleViewLoadPage;
     private handleSearchInput;

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[];