@mmlogic/components 0.4.3 → 0.5.1

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, ClientLayoutNavigateBehaviour } from '../../../types/client-layout';
+import { ClientArchetype, ClientLayoutItem, ClientLayoutNavigateBehaviour, DocumentAttachment } from '../../../types/client-layout';
 import { ListNavigationContext } from '../../../utils/query-params';
 /**
  * Owns a document collection view: a single toolbar (view switch + collection
@@ -53,12 +53,14 @@ export declare class MrdDocumentContainer {
     /** 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. */
+     *  mrd-layout-section, which takes it from the item's configuration.
+     *  `attachments` prefetches the clicked row's file slot (see TASK-0169). */
     mrdNavigate: EventEmitter<{
         href?: string;
         label: string;
         navigateBehaviour?: ClientLayoutNavigateBehaviour;
         listContext?: ListNavigationContext;
+        attachments?: DocumentAttachment[];
     }>;
     /** A table toolbar action was triggered. */
     mrdAction: EventEmitter<{

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

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { ClientArchetype, ClientLayoutItem } from '../../../types/client-layout';
+import { ClientArchetype, ClientLayoutItem, DocumentAttachment } from '../../../types/client-layout';
 import { ListNavigationContext } from '../../../utils/query-params';
 import { DistinctValue, DocRow } from './folder-tree';
 /**
@@ -50,11 +50,15 @@ export declare class MrdDocumentList {
         qs: string;
     }>;
     /** 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`. */
+     *  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. */
     mrdNavigate: EventEmitter<{
         href?: string;
         label: string;
         listContext?: ListNavigationContext;
+        attachments?: DocumentAttachment[];
     }>;
     /** Emitted whenever the "can create a folder here" state changes, so a host
      *  toolbar (mrd-document-container) can enable/disable its New folder button. */

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

@@ -1,14 +1,21 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { ClientArchetype } from '../../../types/client-layout';
+import { ClientArchetype, DocumentAttachment } from '../../../types/client-layout';
 /**
  * Archetype-driven single-document view. Given a `commons.document` binding and a
- * data record, renders the document recognisably — title, file preview/download,
- * summary and date — plus a navigation link to the container (the dossier),
- * instead of a generic field form.
+ * data record, renders the document recognisably — title, date, a navigation
+ * link to the container (the dossier) presented like any other data-object link
+ * (primary-coloured text link), an optional muted folder path, a download button
+ * and summary — 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).
  */
 export declare class MrdDocumentView {
     /** Resolved `commons.document` binding: slot name → concrete field/relation name. */
@@ -16,15 +23,6 @@ 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;
@@ -35,30 +33,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;
+    /** 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. */
+    mrdAttachments: EventEmitter<{
+        attachments: DocumentAttachment[];
     }>;
-    /** 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;
+    /** Tracks the href attachments were last emitted for, so componentDidLoad and
+     *  the data watcher don't emit duplicate events for the same file. */
+    private lastAttachmentHref;
     componentDidLoad(): void;
     dataChanged(): void;
-    private requestPreviewIfNeeded;
+    private emitAttachmentsIfNeeded;
     /** 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;
+    /** Container link (styled like relation links in layout sections: primary text
+     *  link) plus a muted, non-interactive folder path when present. */
     private renderContainer;
-    /** 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. */
+    /** Download button — the only file-related UI this component owns; the filename
+     *  is deliberately not shown (rarely relevant, the title identifies the document)
+     *  and inline preview rendering is entirely the host's responsibility. */
     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/layout/mrd-layout-section/mrd-layout-section.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, ClientArchetype, RelationSearchResult } from '../../../types/client-layout';
+import { ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, ClientArchetype, RelationSearchResult, DocumentAttachment } from '../../../types/client-layout';
 import { DistinctValue } from '../../documents/mrd-document-list/folder-tree';
 import { ListNavigationContext } from '../../../utils/query-params';
 export declare class MrdLayoutSection {
@@ -18,24 +18,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;
+    /** `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. */
     mrdNavigate: EventEmitter<{
         href?: string;
         label: string;
         navigate?: ClientLayoutItemNavigate;
         navigateBehaviour?: ClientLayoutNavigateBehaviour;
         listContext?: ListNavigationContext;
+        attachments?: DocumentAttachment[];
     }>;
     mrdSearch: EventEmitter<{
         query: string;
@@ -60,11 +59,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-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. */
+    mrdAttachments: EventEmitter<{
+        attachments: DocumentAttachment[];
     }>;
     /** Re-emitted from an embedded mrd-table's mrdAction; host builds the target URL from dataClass. */
     mrdViewAction: EventEmitter<{
@@ -140,9 +140,6 @@ 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;