@mmlogic/components 0.4.2 → 0.5.0

package/dist/types/components.d.ts

@@ -6,10 +6,12 @@
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
 import { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-import { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+import { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+import { ListNavigationContext } from "./utils/query-params";
 import { DistinctValue, DocRow } from "./components/documents/mrd-document-list/folder-tree";
 export { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-export { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+export { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+export { ListNavigationContext } from "./utils/query-params";
 export { DistinctValue, DocRow } from "./components/documents/mrd-document-list/folder-tree";
 export namespace Components {
     interface MrdBooleanField {
@@ -224,12 +226,17 @@ export namespace Components {
     }
     /**
      * Archetype-driven single-document view. Given a `commons.document` binding and a
-     * data record, renders the document recognisably — title, file preview/download,
+     * data record, renders the document recognisably — title, filename/download,
      * summary and date — plus a navigation link to the container (the dossier),
      * instead of a generic field form.
      * The component keys on the slot→field map (`archetype.slots`) to locate values:
      * value slots read `data[field]`; the `container` relation slot reads
      * `data._links[field]` (`{ href, name }`). Empty slots are omitted.
+     * This component never renders the file itself (no iframe/image preview) — it
+     * only ever exposes the file reference via `mrdAttachments`. The host resolves
+     * the href and decides how (or whether) to show it inline, so the preview can
+     * live anywhere in the host's own layout instead of being boxed into this
+     * component's DOM (see TASK-0165 / FINDING-0111).
      */
     interface MrdDocumentView {
         /**
@@ -245,16 +252,6 @@ export namespace Components {
           * @default navigator.language
          */
         "locale": 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.
-          * @default 640
-         */
-        "previewHeight": number;
-        /**
-          * 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.
-          * @default ''
-         */
-        "previewUrl": string;
     }
     interface MrdEmailField {
         /**
@@ -328,40 +325,6 @@ export namespace Components {
          */
         "value": unknown;
     }
-    /**
-     * 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.
-     */
-    interface MrdFilePreview {
-        /**
-          * Original file name — used for extension-based detection when `mimeType` is absent, and as alt/title text.
-          * @default ''
-         */
-        "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.
-          * @default ''
-         */
-        "href": string;
-        /**
-          * @default navigator.language
-         */
-        "locale": string;
-        /**
-          * Declared mime type (e.g. 'application/pdf', 'image/png'), when known. Authoritative over `fileName` when present.
-          * @default ''
-         */
-        "mimeType": string;
-        /**
-          * Signed URL to render.
-          * @default ''
-         */
-        "src": string;
-    }
     interface MrdForm {
         "layout": ClientLayout;
         /**
@@ -469,11 +432,6 @@ export namespace Components {
           * @default {}
          */
         "data": Record<string, unknown>;
-        /**
-          * 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.
-          * @default 640
-         */
-        "documentPreviewHeight": number;
         /**
           * Items from one layout entry in ClientDashboardMetadata.layouts[].
           * @default []
@@ -492,10 +450,6 @@ export namespace Components {
           * 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>;
         /**
           * Provide a resolved URL for an IMAGE field. Shows as thumbnail; clicking opens the lightbox.
          */
@@ -742,7 +696,7 @@ export namespace Components {
         "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
+          * @default 15000
          */
         "requestTimeoutMs": number;
         /**
@@ -901,10 +855,6 @@ export interface MrdFileFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdFileFieldElement;
 }
-export interface MrdFilePreviewCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLMrdFilePreviewElement;
-}
 export interface MrdFormCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdFormElement;
@@ -1034,7 +984,7 @@ declare global {
         "mrdLoadPage": { page: number; sort: string; path: string; qs: string; nodeId?: string };
         "mrdLoadDistinct": { nodeId: string; distinct: string; path: string; qs: string };
         "mrdLoadAggregations": { path: string; qs: string; aggQs: string };
-        "mrdNavigate": { href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour };
+        "mrdNavigate": { href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] };
         "mrdAction": { action: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string };
         "mrdUpdateObject": { href: string; values: Record<string, unknown> };
         "mrdUpload": { file: File };
@@ -1068,7 +1018,7 @@ declare global {
     interface HTMLMrdDocumentListElementEventMap {
         "mrdLoadDistinct": { nodeId: string; distinct: string; path: string; qs: string };
         "mrdLoadPage": { nodeId: string; page: number; sort: string; path: string; qs: string };
-        "mrdNavigate": { href?: string; label: string };
+        "mrdNavigate": { href?: string; label: string; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] };
         "mrdCanCreate": boolean;
         "mrdUpdateObject": { href: string; values: Record<string, unknown> };
         "mrdUpload": { file: File };
@@ -1106,16 +1056,21 @@ declare global {
     interface HTMLMrdDocumentViewElementEventMap {
         "mrdNavigate": { href?: string; label: string };
         "mrdDownload": { href: string; fileName: string };
-        "mrdLoadPreview": { href: string };
+        "mrdAttachments": { attachments: DocumentAttachment[] };
     }
     /**
      * Archetype-driven single-document view. Given a `commons.document` binding and a
-     * data record, renders the document recognisably — title, file preview/download,
+     * data record, renders the document recognisably — title, filename/download,
      * summary and date — plus a navigation link to the container (the dossier),
      * instead of a generic field form.
      * The component keys on the slot→field map (`archetype.slots`) to locate values:
      * value slots read `data[field]`; the `container` relation slot reads
      * `data._links[field]` (`{ href, name }`). Empty slots are omitted.
+     * This component never renders the file itself (no iframe/image preview) — it
+     * only ever exposes the file reference via `mrdAttachments`. The host resolves
+     * the href and decides how (or whether) to show it inline, so the preview can
+     * live anywhere in the host's own layout instead of being boxed into this
+     * component's DOM (see TASK-0165 / FINDING-0111).
      */
     interface HTMLMrdDocumentViewElement extends Components.MrdDocumentView, HTMLStencilElement {
         addEventListener<K extends keyof HTMLMrdDocumentViewElementEventMap>(type: K, listener: (this: HTMLMrdDocumentViewElement, ev: MrdDocumentViewCustomEvent<HTMLMrdDocumentViewElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -1189,32 +1144,6 @@ declare global {
         prototype: HTMLMrdFileFieldElement;
         new (): HTMLMrdFileFieldElement;
     };
-    interface HTMLMrdFilePreviewElementEventMap {
-        "mrdPreviewReload": void;
-        "mrdDownload": { href: string; fileName: string };
-    }
-    /**
-     * 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.
-     */
-    interface HTMLMrdFilePreviewElement extends Components.MrdFilePreview, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLMrdFilePreviewElementEventMap>(type: K, listener: (this: HTMLMrdFilePreviewElement, ev: MrdFilePreviewCustomEvent<HTMLMrdFilePreviewElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLMrdFilePreviewElementEventMap>(type: K, listener: (this: HTMLMrdFilePreviewElement, ev: MrdFilePreviewCustomEvent<HTMLMrdFilePreviewElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-    }
-    var HTMLMrdFilePreviewElement: {
-        prototype: HTMLMrdFilePreviewElement;
-        new (): HTMLMrdFilePreviewElement;
-    };
     interface HTMLMrdFormElementEventMap {
         "mrdSubmit": Record<string, unknown>;
         "mrdCancel": void;
@@ -1274,12 +1203,12 @@ declare global {
         new (): HTMLMrdImageFieldElement;
     };
     interface HTMLMrdLayoutSectionElementEventMap {
-        "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour };
+        "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] };
         "mrdSearch": { query: string; dataClass: string };
         "mrdDownload": { href: string; fileName: string };
         "mrdLoadViewPage": { name: string; page: number; sort: string; path: string; qs: string; nodeId?: string };
         "mrdLoadImage": { fieldName: string; href: string };
-        "mrdLoadDocumentPreview": { href: string };
+        "mrdAttachments": { attachments: DocumentAttachment[] };
         "mrdViewAction": { name: string; action: string; dataClass: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string };
         "mrdLoadViewAggregations": { name: string; dataClass: string; path: string; qs: string; aggQs: string };
         "mrdLoadViewDistinct": { name: string; nodeId: string; distinct: string; path: string; qs: string };
@@ -1396,7 +1325,7 @@ declare global {
     interface HTMLMrdTableElementEventMap {
         "mrdLoadPage": { page: number; sort: string; path: string; qs: string };
         "mrdPageError": { page: number };
-        "mrdRowClick": Record<string, any>;
+        "mrdRowClick": { row: Record<string, any>; listContext?: ListNavigationContext };
         "mrdAction": { action: string; path?: string; qs?: string; dataClass?: string; parentPath?: string | null; basicType?: string };
         "mrdDownload": { href: string; fileName: string };
         "mrdLoadAggregations": { path: string; qs: string; aggQs: string };
@@ -1480,7 +1409,6 @@ declare global {
         "mrd-email-field": HTMLMrdEmailFieldElement;
         "mrd-field": HTMLMrdFieldElement;
         "mrd-file-field": HTMLMrdFileFieldElement;
-        "mrd-file-preview": HTMLMrdFilePreviewElement;
         "mrd-form": HTMLMrdFormElement;
         "mrd-hyperlink-field": HTMLMrdHyperlinkFieldElement;
         "mrd-image-field": HTMLMrdImageFieldElement;
@@ -1665,9 +1593,9 @@ declare namespace LocalJSX {
          */
         "onMrdLoadPage"?: (event: MrdDocumentContainerCustomEvent<{ page: number; sort: string; path: string; qs: string; nodeId?: string }>) => void;
         /**
-          * 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.
+          * 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. `attachments` prefetches the clicked row's file slot (see TASK-0169).
          */
-        "onMrdNavigate"?: (event: MrdDocumentContainerCustomEvent<{ href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour }>) => void;
+        "onMrdNavigate"?: (event: MrdDocumentContainerCustomEvent<{ href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] }>) => void;
         /**
           * Generic "update an existing object" request, re-emitted from the folder tree (a document was dragged into another folder/container).
          */
@@ -1738,9 +1666,9 @@ declare namespace LocalJSX {
          */
         "onMrdLoadPage"?: (event: MrdDocumentListCustomEvent<{ nodeId: string; page: number; sort: string; path: string; qs: string }>) => void;
         /**
-          * A document row was clicked. Host routes to the document object page.
+          * A document row was clicked. Host routes to the document object page. `listContext` can be used to re-fetch this exact record (or its neighbours) via `{path}?{qs}&page={index}&size=1`. `attachments` is a prefetch of the clicked row's own file slot (derived from `archetype`) so the host can render a preview immediately, without waiting for the navigated-to page's own mrdAttachments — see TASK-0169 / FINDING-0111.
          */
-        "onMrdNavigate"?: (event: MrdDocumentListCustomEvent<{ href?: string; label: string }>) => void;
+        "onMrdNavigate"?: (event: MrdDocumentListCustomEvent<{ href?: string; label: string; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] }>) => void;
         /**
           * Generic "update an existing object" request — fired when a document is dragged into another folder/container. Host PATCHes `href` with `values` (no move/folder knowledge needed). `values` carries the new folder string (or null for the container root) and, on a cross-container move, the new container relation href.
          */
@@ -1757,12 +1685,17 @@ declare namespace LocalJSX {
     }
     /**
      * Archetype-driven single-document view. Given a `commons.document` binding and a
-     * data record, renders the document recognisably — title, file preview/download,
+     * data record, renders the document recognisably — title, filename/download,
      * summary and date — plus a navigation link to the container (the dossier),
      * instead of a generic field form.
      * The component keys on the slot→field map (`archetype.slots`) to locate values:
      * value slots read `data[field]`; the `container` relation slot reads
      * `data._links[field]` (`{ href, name }`). Empty slots are omitted.
+     * This component never renders the file itself (no iframe/image preview) — it
+     * only ever exposes the file reference via `mrdAttachments`. The host resolves
+     * the href and decides how (or whether) to show it inline, so the preview can
+     * live anywhere in the host's own layout instead of being boxed into this
+     * component's DOM (see TASK-0165 / FINDING-0111).
      */
     interface MrdDocumentView {
         /**
@@ -1779,27 +1712,17 @@ declare namespace LocalJSX {
          */
         "locale"?: string;
         /**
-          * Download the document file. Host resolves the href to a signed URL.
+          * The file(s) belonging to this document, fired once on load and again whenever the file slot's value changes (e.g. the overlay is reused for a different document via prev/next). The host resolves the href(s) itself and decides whether/how to render them (e.g. pdf.js next to the layout) — this component does not fetch or preview the file.
          */
-        "onMrdDownload"?: (event: MrdDocumentViewCustomEvent<{ href: string; fileName: string }>) => void;
+        "onMrdAttachments"?: (event: MrdDocumentViewCustomEvent<{ attachments: DocumentAttachment[] }>) => void;
         /**
-          * 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.
+          * Download the document file. Host resolves the href to a signed URL.
          */
-        "onMrdLoadPreview"?: (event: MrdDocumentViewCustomEvent<{ href: string }>) => void;
+        "onMrdDownload"?: (event: MrdDocumentViewCustomEvent<{ href: string; fileName: string }>) => void;
         /**
           * Navigate to the container (dossier). Host resolves the href and routes.
          */
         "onMrdNavigate"?: (event: MrdDocumentViewCustomEvent<{ href?: string; label: string }>) => void;
-        /**
-          * 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.
-          * @default 640
-         */
-        "previewHeight"?: number;
-        /**
-          * 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.
-          * @default ''
-         */
-        "previewUrl"?: string;
     }
     interface MrdEmailField {
         /**
@@ -1886,48 +1809,6 @@ declare namespace LocalJSX {
          */
         "value"?: unknown;
     }
-    /**
-     * 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.
-     */
-    interface MrdFilePreview {
-        /**
-          * Original file name — used for extension-based detection when `mimeType` is absent, and as alt/title text.
-          * @default ''
-         */
-        "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.
-          * @default ''
-         */
-        "href"?: string;
-        /**
-          * @default navigator.language
-         */
-        "locale"?: string;
-        /**
-          * Declared mime type (e.g. 'application/pdf', 'image/png'), when known. Authoritative over `fileName` when present.
-          * @default ''
-         */
-        "mimeType"?: string;
-        /**
-          * Download the file. Same shape as mrd-document-view / mrd-layout-section's mrdDownload — host resolves `href` to a signed URL.
-         */
-        "onMrdDownload"?: (event: MrdFilePreviewCustomEvent<{ href: string; fileName: string }>) => void;
-        /**
-          * 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.
-         */
-        "onMrdPreviewReload"?: (event: MrdFilePreviewCustomEvent<void>) => void;
-        /**
-          * Signed URL to render.
-          * @default ''
-         */
-        "src"?: string;
-    }
     interface MrdForm {
         "layout": ClientLayout;
         /**
@@ -2047,11 +1928,6 @@ declare namespace LocalJSX {
           * @default {}
          */
         "data"?: Record<string, unknown>;
-        /**
-          * 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.
-          * @default 640
-         */
-        "documentPreviewHeight"?: number;
         /**
           * Items from one layout entry in ClientDashboardMetadata.layouts[].
           * @default []
@@ -2066,15 +1942,15 @@ declare namespace LocalJSX {
           * @default navigator.language
          */
         "locale"?: string;
+        /**
+          * Re-emitted from an embedded mrd-document-view (commons.document single-object view) whenever its file slot's value changes. The component never renders the file itself — the host resolves the href(s) and decides how/whether to show them, e.g. in a panel next to this mrd-layout-section.
+         */
+        "onMrdAttachments"?: (event: MrdLayoutSectionCustomEvent<{ attachments: DocumentAttachment[] }>) => void;
         /**
           * Create a new document from an uploaded file; host POSTs `values` to `path`, then calls setViewCreatedObject(name, href) with the new object's href.
          */
         "onMrdCreateObject"?: (event: MrdLayoutSectionCustomEvent<{ name: string; path: string; values: Record<string, unknown> }>) => void;
         "onMrdDownload"?: (event: MrdLayoutSectionCustomEvent<{ href: string; fileName: string }>) => void;
-        /**
-          * 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().
-         */
-        "onMrdLoadDocumentPreview"?: (event: MrdLayoutSectionCustomEvent<{ href: string }>) => void;
         /**
           * Fired once on load for each IMAGE field that has an href; host resolves the URL and calls setImagePreview().
          */
@@ -2091,7 +1967,10 @@ declare namespace LocalJSX {
           * Re-emitted from an embedded mrd-table's or mrd-document-list's mrdLoadPage; host fetches the rows and calls setViewPage(). `nodeId` is present for a document-list folder load.
          */
         "onMrdLoadViewPage"?: (event: MrdLayoutSectionCustomEvent<{ name: string; page: number; sort: string; path: string; qs: string; nodeId?: string }>) => void;
-        "onMrdNavigate"?: (event: MrdLayoutSectionCustomEvent<{ href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour }>) => void;
+        /**
+          * `attachments`, when present, prefetches the clicked document row's file slot (see TASK-0169 / FINDING-0111) so the host can render a preview immediately, without waiting for the navigated-to page's own mrdAttachments. Only set for commons.document rows opened from an embedded document view.
+         */
+        "onMrdNavigate"?: (event: MrdLayoutSectionCustomEvent<{ href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] }>) => void;
         "onMrdSearch"?: (event: MrdLayoutSectionCustomEvent<{ query: string; dataClass: string }>) => void;
         /**
           * Generic "update an existing object" request from an embedded document view (a document dragged into another folder). Host PATCHes `href` with `values`.
@@ -2337,9 +2216,9 @@ declare namespace LocalJSX {
          */
         "onMrdPageError"?: (event: MrdTableCustomEvent<{ page: number }>) => void;
         /**
-          * Fired when a data row is clicked. Detail is the full row object including _links.
+          * Fired when a data row is clicked. `listContext` is included in paginated mode and can be used to re-fetch this exact record (or its neighbours) via `{path}?{qs}&page={index}&size=1` — omitted in non-paginated (`rows` prop) mode since the host already holds the full array.
          */
-        "onMrdRowClick"?: (event: MrdTableCustomEvent<Record<string, any>>) => void;
+        "onMrdRowClick"?: (event: MrdTableCustomEvent<{ row: Record<string, any>; listContext?: ListNavigationContext }>) => void;
         /**
           * Records per page (must match the API page size).
           * @default 20
@@ -2352,7 +2231,7 @@ declare namespace LocalJSX {
         "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
+          * @default 15000
          */
         "requestTimeoutMs"?: number;
         /**
@@ -2514,8 +2393,6 @@ declare namespace LocalJSX {
     }
     interface MrdDocumentViewAttributes {
         "locale": string;
-        "previewUrl": string;
-        "previewHeight": number;
     }
     interface MrdEmailFieldAttributes {
         "name": string;
@@ -2538,13 +2415,6 @@ declare namespace LocalJSX {
         "accept": string;
         "maxSize": number;
     }
-    interface MrdFilePreviewAttributes {
-        "src": string;
-        "mimeType": string;
-        "fileName": string;
-        "href": string;
-        "locale": string;
-    }
     interface MrdFormAttributes {
         "locale": string;
         "referenceHref": string;
@@ -2571,7 +2441,6 @@ declare namespace LocalJSX {
     }
     interface MrdLayoutSectionAttributes {
         "locale": string;
-        "documentPreviewHeight": number;
     }
     interface MrdListFieldAttributes {
         "name": string;
@@ -2672,7 +2541,6 @@ declare namespace LocalJSX {
         "mrd-email-field": Omit<MrdEmailField, keyof MrdEmailFieldAttributes> & { [K in keyof MrdEmailField & keyof MrdEmailFieldAttributes]?: MrdEmailField[K] } & { [K in keyof MrdEmailField & keyof MrdEmailFieldAttributes as `attr:${K}`]?: MrdEmailFieldAttributes[K] } & { [K in keyof MrdEmailField & keyof MrdEmailFieldAttributes as `prop:${K}`]?: MrdEmailField[K] };
         "mrd-field": Omit<MrdField, keyof MrdFieldAttributes> & { [K in keyof MrdField & keyof MrdFieldAttributes]?: MrdField[K] } & { [K in keyof MrdField & keyof MrdFieldAttributes as `attr:${K}`]?: MrdFieldAttributes[K] } & { [K in keyof MrdField & keyof MrdFieldAttributes as `prop:${K}`]?: MrdField[K] };
         "mrd-file-field": Omit<MrdFileField, keyof MrdFileFieldAttributes> & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes]?: MrdFileField[K] } & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes as `attr:${K}`]?: MrdFileFieldAttributes[K] } & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes as `prop:${K}`]?: MrdFileField[K] };
-        "mrd-file-preview": Omit<MrdFilePreview, keyof MrdFilePreviewAttributes> & { [K in keyof MrdFilePreview & keyof MrdFilePreviewAttributes]?: MrdFilePreview[K] } & { [K in keyof MrdFilePreview & keyof MrdFilePreviewAttributes as `attr:${K}`]?: MrdFilePreviewAttributes[K] } & { [K in keyof MrdFilePreview & keyof MrdFilePreviewAttributes as `prop:${K}`]?: MrdFilePreview[K] };
         "mrd-form": Omit<MrdForm, keyof MrdFormAttributes> & { [K in keyof MrdForm & keyof MrdFormAttributes]?: MrdForm[K] } & { [K in keyof MrdForm & keyof MrdFormAttributes as `attr:${K}`]?: MrdFormAttributes[K] } & { [K in keyof MrdForm & keyof MrdFormAttributes as `prop:${K}`]?: MrdForm[K] };
         "mrd-hyperlink-field": Omit<MrdHyperlinkField, keyof MrdHyperlinkFieldAttributes> & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes]?: MrdHyperlinkField[K] } & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes as `attr:${K}`]?: MrdHyperlinkFieldAttributes[K] } & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes as `prop:${K}`]?: MrdHyperlinkField[K] };
         "mrd-image-field": Omit<MrdImageField, keyof MrdImageFieldAttributes> & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes]?: MrdImageField[K] } & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes as `attr:${K}`]?: MrdImageFieldAttributes[K] } & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes as `prop:${K}`]?: MrdImageField[K] };
@@ -2726,26 +2594,22 @@ declare module "@stencil/core" {
             "mrd-document-list": LocalJSX.IntrinsicElements["mrd-document-list"] & JSXBase.HTMLAttributes<HTMLMrdDocumentListElement>;
             /**
              * Archetype-driven single-document view. Given a `commons.document` binding and a
-             * data record, renders the document recognisably — title, file preview/download,
+             * data record, renders the document recognisably — title, filename/download,
              * summary and date — plus a navigation link to the container (the dossier),
              * instead of a generic field form.
              * The component keys on the slot→field map (`archetype.slots`) to locate values:
              * value slots read `data[field]`; the `container` relation slot reads
              * `data._links[field]` (`{ href, name }`). Empty slots are omitted.
+             * This component never renders the file itself (no iframe/image preview) — it
+             * only ever exposes the file reference via `mrdAttachments`. The host resolves
+             * the href and decides how (or whether) to show it inline, so the preview can
+             * live anywhere in the host's own layout instead of being boxed into this
+             * component's DOM (see TASK-0165 / FINDING-0111).
              */
             "mrd-document-view": LocalJSX.IntrinsicElements["mrd-document-view"] & JSXBase.HTMLAttributes<HTMLMrdDocumentViewElement>;
             "mrd-email-field": LocalJSX.IntrinsicElements["mrd-email-field"] & JSXBase.HTMLAttributes<HTMLMrdEmailFieldElement>;
             "mrd-field": LocalJSX.IntrinsicElements["mrd-field"] & JSXBase.HTMLAttributes<HTMLMrdFieldElement>;
             "mrd-file-field": LocalJSX.IntrinsicElements["mrd-file-field"] & JSXBase.HTMLAttributes<HTMLMrdFileFieldElement>;
-            /**
-             * 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.
-             */
-            "mrd-file-preview": LocalJSX.IntrinsicElements["mrd-file-preview"] & JSXBase.HTMLAttributes<HTMLMrdFilePreviewElement>;
             "mrd-form": LocalJSX.IntrinsicElements["mrd-form"] & JSXBase.HTMLAttributes<HTMLMrdFormElement>;
             "mrd-hyperlink-field": LocalJSX.IntrinsicElements["mrd-hyperlink-field"] & JSXBase.HTMLAttributes<HTMLMrdHyperlinkFieldElement>;
             "mrd-image-field": LocalJSX.IntrinsicElements["mrd-image-field"] & JSXBase.HTMLAttributes<HTMLMrdImageFieldElement>;

package/dist/types/index.d.ts

@@ -1,2 +1,5 @@
 export * from './types';
 export type { AlternativeView, ColumnFilter, TableAction, TableColumn } from './utils/cell-renderer';
+export type { ListNavigationContext } from './utils/query-params';
+export { detectPreviewKind } from './utils/file-preview-kind';
+export type { FilePreviewKind } from './utils/file-preview-kind';

package/dist/types/stencil-public-runtime.d.ts

@@ -1070,6 +1070,7 @@ export declare namespace JSXBase {
         importance?: 'low' | 'auto' | 'high';
         height?: number | string;
         loading?: 'lazy' | 'auto' | 'eager';
+        referrerPolicy?: ReferrerPolicy;
         sizes?: string;
         src?: string;
         srcSet?: string;

package/dist/types/types/client-layout.d.ts

@@ -87,6 +87,14 @@ export interface RelationSearchResult {
     label: string;
     description?: string;
 }
+/** A single file belonging to a `commons.document`-archetype record. The host
+ *  resolves `href` to a signed URL and decides how (or whether) to render it
+ *  inline — the component only ever hands over the reference. */
+export interface DocumentAttachment {
+    href: string;
+    fileName: string;
+    mimeType?: string;
+}
 /**
  * A resolved archetype binding as published on a dashboard.
  * `archetype` is the platform-defined id (e.g. `commons.document`); `slots` maps

package/dist/types/utils/document-attachments.d.ts

@@ -0,0 +1,8 @@
+import { ClientArchetype, DocumentAttachment } from '../types/client-layout';
+/**
+ * Extract the `commons.document` archetype's file slot from a data record as a
+ * `DocumentAttachment[]` — empty when the slot is unmapped or has no value.
+ * Shared by mrd-document-view (on load/data-change) and mrd-document-container
+ * (row-click prefetch on mrdNavigate), so both report the exact same shape.
+ */
+export declare function attachmentsFromRecord(archetype: ClientArchetype | null | undefined, record: Record<string, unknown> | null | undefined): DocumentAttachment[];

package/dist/types/utils/file-preview-kind.d.ts

@@ -0,0 +1,9 @@
+/** Pure classification logic for deciding whether a file can be shown inline. */
+export type FilePreviewKind = 'pdf' | 'image' | 'unsupported';
+/**
+ * Decide how a file could be rendered 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/utils/query-params.d.ts

@@ -3,6 +3,20 @@ import { ViewFilter } from '../types/client-layout';
  * Shared path/query-param conventions for list requests,
  * used by mrd-table and mrd-document-list.
  */
+/** Enough context to re-fetch one specific record from the query that produced a list,
+ *  via `{path}?{qs}&page={index}&size=1` — used to drive prev/next navigation in a host
+ *  overlay. `qs` deliberately excludes the `page` param since it is page-independent
+ *  (filters/sort apply uniformly across all pages of the same query). */
+export interface ListNavigationContext {
+    /** Absolute position of the record within the query's result set. */
+    index: number;
+    /** Raw sort param value, e.g. "name,desc" or "" when unsorted. */
+    sort: string;
+    /** Relative data path (VIEW: /{dataClass}; RELATED_VIEW: /{fromClass}/{parentId}/{dataClass}). */
+    path: string;
+    /** Filter/type/view-filter/sort query string, without `page`. */
+    qs: string;
+}
 /** Applies the view-level static filters to `params` using the API operator conventions. */
 export declare function applyViewFilters(params: URLSearchParams, filters: ViewFilter[] | null | undefined): void;
 /** VIEW: `/{dataClass}`; RELATED_VIEW: `/{fromClass}/{parentId}/{dataClass}`. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmlogic/components",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Stencil.js web component library for dynamic forms and virtual-scroll data tables",
   "license": "MIT",
   "author": "Mosterd",
@@ -34,26 +34,24 @@
   "scripts": {
     "build": "stencil build --docs",
     "start": "stencil build --dev --watch --serve",
-    "test": "stencil test --spec --e2e",
-    "test.watch": "stencil test --spec --e2e --watchAll",
+    "test": "vitest run",
+    "test.watch": "vitest",
     "generate": "stencil generate"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@stencil/core": "^4.22.0",
+    "@stencil/core": "^4.43.5",
     "quill": "^2.0.3"
   },
   "devDependencies": {
-    "@stencil/angular-output-target": "^1.3.0",
-    "@stencil/sass": "^3.2.3",
-    "@types/jest": "^29.5.14",
+    "@stencil/angular-output-target": "^1.4.0",
+    "@stencil/sass": "3.2.3",
+    "@stencil/vitest": "^1.13.3",
     "@types/quill": "^2.0.14",
-    "jest": "^29.7.0",
-    "jest-cli": "^29.7.0",
-    "puppeteer": "^21.11.0",
-    "sass": "^1.69.7",
-    "typescript": "^5.3.3"
+    "sass": "^1.101.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   }
 }