@mmlogic/components 0.4.0 → 0.4.2

package/dist/types/components.d.ts

@@ -6,10 +6,10 @@
  */
 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, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+import { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
 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, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+export { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
 export { DistinctValue, DocRow } from "./components/documents/mrd-document-list/folder-tree";
 export namespace Components {
     interface MrdBooleanField {
@@ -245,6 +245,16 @@ 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 {
         /**
@@ -318,6 +328,40 @@ 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;
         /**
@@ -425,6 +469,11 @@ 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 []
@@ -443,6 +492,10 @@ 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.
          */
@@ -687,6 +740,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
@@ -843,6 +901,10 @@ 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;
@@ -972,7 +1034,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 };
+        "mrdNavigate": { href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour };
         "mrdAction": { action: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string };
         "mrdUpdateObject": { href: string; values: Record<string, unknown> };
         "mrdUpload": { file: File };
@@ -1044,6 +1106,7 @@ declare global {
     interface HTMLMrdDocumentViewElementEventMap {
         "mrdNavigate": { href?: string; label: string };
         "mrdDownload": { href: string; fileName: string };
+        "mrdLoadPreview": { href: string };
     }
     /**
      * Archetype-driven single-document view. Given a `commons.document` binding and a
@@ -1126,6 +1189,32 @@ 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;
@@ -1185,11 +1274,12 @@ declare global {
         new (): HTMLMrdImageFieldElement;
     };
     interface HTMLMrdLayoutSectionElementEventMap {
-        "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate };
+        "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour };
         "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 };
         "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 };
@@ -1305,6 +1395,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 };
@@ -1389,6 +1480,7 @@ 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;
@@ -1573,9 +1665,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.
+          * 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.
          */
-        "onMrdNavigate"?: (event: MrdDocumentContainerCustomEvent<{ href?: string; label: string }>) => void;
+        "onMrdNavigate"?: (event: MrdDocumentContainerCustomEvent<{ href?: string; label: string; navigateBehaviour?: ClientLayoutNavigateBehaviour }>) => void;
         /**
           * Generic "update an existing object" request, re-emitted from the folder tree (a document was dragged into another folder/container).
          */
@@ -1690,10 +1782,24 @@ declare namespace LocalJSX {
           * Download the document file. Host resolves the href to a signed URL.
          */
         "onMrdDownload"?: (event: MrdDocumentViewCustomEvent<{ href: string; fileName: string }>) => 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.
+         */
+        "onMrdLoadPreview"?: (event: MrdDocumentViewCustomEvent<{ href: 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 {
         /**
@@ -1780,6 +1886,48 @@ 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;
         /**
@@ -1899,6 +2047,11 @@ 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 []
@@ -1918,6 +2071,10 @@ declare namespace LocalJSX {
          */
         "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().
          */
@@ -1934,7 +2091,7 @@ 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 }>) => void;
+        "onMrdNavigate"?: (event: MrdLayoutSectionCustomEvent<{ href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour }>) => 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`.
@@ -2175,6 +2332,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 +2350,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
@@ -2348,6 +2514,8 @@ declare namespace LocalJSX {
     }
     interface MrdDocumentViewAttributes {
         "locale": string;
+        "previewUrl": string;
+        "previewHeight": number;
     }
     interface MrdEmailFieldAttributes {
         "name": string;
@@ -2370,6 +2538,13 @@ 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;
@@ -2396,6 +2571,7 @@ declare namespace LocalJSX {
     }
     interface MrdLayoutSectionAttributes {
         "locale": string;
+        "documentPreviewHeight": number;
     }
     interface MrdListFieldAttributes {
         "name": string;
@@ -2456,6 +2632,7 @@ declare namespace LocalJSX {
         "pageSize": number;
         "rowHeight": number;
         "tableHeight": number;
+        "requestTimeoutMs": number;
     }
     interface MrdTextFieldAttributes {
         "name": string;
@@ -2495,6 +2672,7 @@ 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] };
@@ -2559,6 +2737,15 @@ declare module "@stencil/core" {
             "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/types/client-layout.d.ts

@@ -48,6 +48,12 @@ export declare enum ClientLayoutItemRelationEditBehavior {
     DROPDOWN = "DROPDOWN",
     CHECKBOX = "CHECKBOX"
 }
+/** How navigating from a row/document in this VIEW or RELATED_VIEW should open
+ *  its target: a full page navigation, or an overlay on top of the current page. */
+export declare enum ClientLayoutNavigateBehaviour {
+    PAGE = "PAGE",
+    OVERLAY_PAGE = "OVERLAY_PAGE"
+}
 /** A single sub-link within a multi-value relation link. */
 export interface DataObjectSubLink {
     href: string;
@@ -233,6 +239,10 @@ export interface ClientLayoutItem {
      *  the `commons.document` archetype's `container` slot, the view is a single
      *  container context (see mrd-document-list seeding). */
     inverseRelation?: string | null;
+    /** How navigating out of this VIEW/RELATED_VIEW opens its target. Defaults to
+     *  `PAGE` (full navigation) when absent. mrd-layout-section reads this off the
+     *  item and includes it in the mrdNavigate event detail it relays upward. */
+    navigateBehaviour?: ClientLayoutNavigateBehaviour;
     icon?: string | null;
     navigationType?: string | null;
     actionType?: string;

package/package.json

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