@mmlogic/components 0.4.2 → 0.5.0

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

@@ -1,5 +1,6 @@
 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
  * actions like "New folder", and — later — upload / drag-drop) plus the two
@@ -52,11 +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,6 @@
 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';
 /**
  * Archetype-driven document collection view. Renders documents as a lazy,
@@ -48,10 +49,16 @@ export declare class MrdDocumentList {
         path: string;
         qs: string;
     }>;
-    /** 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. */
     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. */
@@ -143,6 +150,10 @@ export declare class MrdDocumentList {
     private baseParams;
     private emitContainerDistinct;
     private emitFolderDistinct;
+    /** Filter qs scoping a folder's documents: view-level filters + container/folder match.
+     *  Shared by emitDocuments() (the fetch) and openDoc() (prev/next list context), so both
+     *  always agree on exactly what query a document belongs to. */
+    private buildDocQs;
     private emitDocuments;
     /** Inject distinct values for a node. `nodeId` is the sentinel root (containers)
      *  or a container node id (folders). */

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

@@ -14,7 +14,7 @@ export interface TreeViewContext {
     on: {
         toggleContainer: (node: TreeNode) => void;
         toggleFolder: (container: TreeNode, node: TreeNode) => void;
-        openDoc: (doc: DocRow) => void;
+        openDoc: (doc: DocRow, node: TreeNode, container: TreeNode) => void;
         docDragStart: (e: DragEvent, doc: DocRow, node: TreeNode) => void;
         docDragEnd: () => void;
         nodeDragOver: (e: DragEvent, node: TreeNode) => void;

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

@@ -1,14 +1,20 @@
 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,
+ * 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).
  */
 export declare class MrdDocumentView {
     /** Resolved `commons.document` binding: slot name → concrete field/relation name. */
@@ -16,15 +22,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 +32,27 @@ 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;
     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. */
+    /** Filename + download button — the only file-related UI this component owns;
+     *  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,6 +1,7 @@
 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 {
     el: HTMLElement;
     /** Items from one layout entry in ClientDashboardMetadata.layouts[]. */
@@ -17,23 +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;
@@ -58,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<{
@@ -138,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;

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

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
 import { ColumnFilter } from '../../../utils/cell-renderer';
 import { AggregationResult, ClientLayoutItem } from '../../../types/client-layout';
+import { ListNavigationContext } from '../../../utils/query-params';
 export declare class MrdTable {
     el: HTMLElement;
     private pendingPages;
@@ -93,8 +94,13 @@ export declare class MrdTable {
     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 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. */
+    mrdRowClick: EventEmitter<{
+        row: Record<string, any>;
+        listContext?: ListNavigationContext;
+    }>;
     /** Fired when a toolbar action button is clicked.
      *  For 'export': includes `path` (relative excel path) and `qs` (current sort+filter params).
      *  For 'create': includes `dataClass` (target type) and `parentPath` (e.g. /buyers/123 for RELATED_VIEW). */