@mmlogic/components 0.3.8 → 0.3.10

package/dist/types/components.d.ts

@@ -5,10 +5,14 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { ClientLayout, ClientLayoutItem, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-import { AggregationResult, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemNavigate, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
-export { ClientLayout, ClientLayoutItem, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-export { AggregationResult, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemNavigate, ClientViewMetadata, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+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 { DistinctValue, DocRow } from "./components/mrd-document-list/mrd-document-list";
+import { DistinctValue as DistinctValue1 } from "./components/mrd-document-list/mrd-document-list";
+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 { DistinctValue, DocRow } from "./components/mrd-document-list/mrd-document-list";
+export { DistinctValue as DistinctValue1 } from "./components/mrd-document-list/mrd-document-list";
 export namespace Components {
     interface MrdBooleanField {
         /**
@@ -114,6 +118,121 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * Owns a document collection view: a single toolbar (view switch + collection
+     * actions like "New folder", and — later — upload / drag-drop) plus the two
+     * interchangeable bodies, the folder tree (`mrd-document-list`) and the flat
+     * table (`mrd-table`).
+     * `mrd-layout-section` renders one of these per document VIEW / RELATED_VIEW and
+     * forwards the re-emitted load/navigate/action events to the host. The embedded
+     * table/list keep their `data-view` / `data-doclist` attributes so the host's
+     * existing `setViewPage` / `setViewDistinct` / `setViewAggregations` lookups
+     * (recursive querySelector) still resolve them unchanged.
+     */
+    interface MrdDocumentContainer {
+        /**
+          * Resolved `commons.document` archetype binding for the folder tree.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * The VIEW or RELATED_VIEW layout item (dataClass, fromClass, view config).
+          * @default null
+         */
+        "item": ClientLayoutItem | null;
+        /**
+          * @default navigator.language
+         */
+        "locale": string;
+        /**
+          * Parent record id — required for RELATED_VIEW path building.
+          * @default ''
+         */
+        "parentId": string;
+        /**
+          * Lookup key used for the embedded `data-doclist` / `data-view` attributes.
+          * @default ''
+         */
+        "viewKey": string;
+    }
+    /**
+     * Archetype-driven document collection view. Renders documents as a lazy,
+     * file-explorer-style folder tree, grouped by the `commons.document` archetype's
+     * `container` (dossier, the top folder) and `folder` (a path string like
+     * `/draft documents/may 2020`, the sub-path beneath it).
+     * Loading is lazy per level, mirroring the /distinct endpoint (FINDING-0106):
+     *  - on load → `mrdLoadDistinct` for the `container` relation → top folders;
+     *  - on expanding a container → `mrdLoadDistinct` for the `folder` field, filtered
+     *    by `{containerField}_href` → all folder path strings for that container
+     *    (the client splits them on `/` and builds the sub-tree locally);
+     *  - on expanding a node that holds documents → `mrdLoadPage` (a plain filtered list
+     *    load, the same one a table page uses), filtered by container + exact folder string.
+     * When exactly one container exists (e.g. a dossier detail page) the container
+     * level is hidden and its folder tree is shown directly at the root.
+     */
+    interface MrdDocumentList {
+        /**
+          * Resolved `commons.document` binding: slot name → concrete field/relation name.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * Start creating a folder under the current target. Called by the host toolbar (mrd-document-container). No-op when there is no valid target.
+         */
+        "createFolder": () => Promise<void>;
+        /**
+          * The VIEW or RELATED_VIEW layout item (dataClass, fromClass, view config).
+          * @default null
+         */
+        "item": ClientLayoutItem | null;
+        /**
+          * @default navigator.language
+         */
+        "locale": string;
+        /**
+          * Parent record id — required for RELATED_VIEW path building.
+          * @default ''
+         */
+        "parentId": string;
+        /**
+          * Host callback with the created document's self href, so the optimistic row becomes navigable without waiting for a reload.
+         */
+        "setCreatedHref": (href: string) => Promise<void>;
+        /**
+          * Inject distinct values for a node. `nodeId` is the sentinel root (containers) or a container node id (folders).
+         */
+        "setDistinct": (nodeId: string, values: DistinctValue[]) => Promise<void>;
+        /**
+          * Inject the documents loaded for one folder node.
+         */
+        "setDocuments": (nodeId: string, docs: DocRow[]) => Promise<void>;
+        /**
+          * Host callback with the uploaded file reference. Builds the create payload from the archetype slots and requests the new document.
+         */
+        "setFileReference": (uri: string) => Promise<void>;
+    }
+    /**
+     * 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.
+     * 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.
+     */
+    interface MrdDocumentView {
+        /**
+          * Resolved `commons.document` binding: slot name → concrete field/relation name.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * The data record from the /data endpoint. Fields keyed by name; relations under `_links`.
+          * @default {}
+         */
+        "data": Record<string, unknown>;
+        /**
+          * @default navigator.language
+         */
+        "locale": string;
+    }
     interface MrdEmailField {
         /**
           * @default false
@@ -145,7 +264,7 @@ export namespace Components {
         "value": string;
     }
     interface MrdField {
-        "item": ClientLayoutItem;
+        "item": ClientLayoutItem1;
         /**
           * @default navigator.language
          */
@@ -283,6 +402,11 @@ export namespace Components {
         "value": unknown;
     }
     interface 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.
+          * @default []
+         */
+        "archetypes": ClientArchetype[];
         /**
           * Record data object; keys are field names, _links holds relation and related-view links.
           * @default {}
@@ -292,7 +416,7 @@ export namespace Components {
           * Items from one layout entry in ClientDashboardMetadata.layouts[].
           * @default []
          */
-        "items": ClientLayoutItem1[];
+        "items": ClientLayoutItem[];
         /**
           * Legacy: top-level _links from ClientDashboardMetadata. Not needed in new flat format.
           * @default {}
@@ -319,9 +443,21 @@ export namespace Components {
          */
         "setViewAggregations": (name: string, data: any) => Promise<void>;
         /**
-          * Inject data into an embedded mrd-table for a RELATED_VIEW or VIEW item. Pass totalElements to update the pagination total (safe to pass on every page). Pass hasNext (from _links.next presence) so the table can decide whether to emit aggregations.
+          * Inject the created document's href after a file-drop create, so the optimistic row becomes navigable (see mrdCreateObject).
+         */
+        "setViewCreatedObject": (name: string, href: string) => Promise<void>;
+        /**
+          * Inject distinct values into an embedded mrd-document-list for a document view.
+         */
+        "setViewDistinct": (name: string, nodeId: string, values: DistinctValue1[]) => Promise<void>;
+        /**
+          * Inject the uploaded file reference for a dropped file, so the document view can request creation of the new document (see mrdViewUpload).
+         */
+        "setViewFileReference": (name: string, uri: string) => Promise<void>;
+        /**
+          * Inject rows for a VIEW / RELATED_VIEW item. - Table view: injects the page into the embedded mrd-table (pass totalElements/hasNext). - Document view: pass `nodeId` to route the rows to that folder node in the embedded   mrd-document-list. Folder loading is just a filtered list load, so it reuses this method.
          */
-        "setViewPage": (name: string, page: number, rows: any[], totalElements?: number, hasNext?: boolean) => Promise<void>;
+        "setViewPage": (name: string, page: number, rows: any[], totalElements?: number, hasNext?: boolean, nodeId?: string) => Promise<void>;
         /**
           * Legacy: view metadata map (ClientDashboardMetadata.views). Not needed in new flat format.
           * @default {}
@@ -523,7 +659,7 @@ export namespace Components {
           * The VIEW or RELATED_VIEW layout item. Contains view config, dataClass, fromClass, actions etc.
           * @default null
          */
-        "item": ClientLayoutItem1 | null;
+        "item": ClientLayoutItem | null;
         /**
           * @default navigator.language
          */
@@ -670,6 +806,18 @@ export interface MrdDatetimeFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdDatetimeFieldElement;
 }
+export interface MrdDocumentContainerCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdDocumentContainerElement;
+}
+export interface MrdDocumentListCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdDocumentListElement;
+}
+export interface MrdDocumentViewCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdDocumentViewElement;
+}
 export interface MrdEmailFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdEmailFieldElement;
@@ -807,6 +955,106 @@ declare global {
         prototype: HTMLMrdDatetimeFieldElement;
         new (): HTMLMrdDatetimeFieldElement;
     };
+    interface HTMLMrdDocumentContainerElementEventMap {
+        "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 };
+        "mrdAction": { action: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string };
+        "mrdUpdateObject": { href: string; values: Record<string, unknown> };
+        "mrdUpload": { file: File };
+        "mrdCreateObject": { path: string; values: Record<string, unknown> };
+    }
+    /**
+     * Owns a document collection view: a single toolbar (view switch + collection
+     * actions like "New folder", and — later — upload / drag-drop) plus the two
+     * interchangeable bodies, the folder tree (`mrd-document-list`) and the flat
+     * table (`mrd-table`).
+     * `mrd-layout-section` renders one of these per document VIEW / RELATED_VIEW and
+     * forwards the re-emitted load/navigate/action events to the host. The embedded
+     * table/list keep their `data-view` / `data-doclist` attributes so the host's
+     * existing `setViewPage` / `setViewDistinct` / `setViewAggregations` lookups
+     * (recursive querySelector) still resolve them unchanged.
+     */
+    interface HTMLMrdDocumentContainerElement extends Components.MrdDocumentContainer, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLMrdDocumentContainerElementEventMap>(type: K, listener: (this: HTMLMrdDocumentContainerElement, ev: MrdDocumentContainerCustomEvent<HTMLMrdDocumentContainerElementEventMap[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 HTMLMrdDocumentContainerElementEventMap>(type: K, listener: (this: HTMLMrdDocumentContainerElement, ev: MrdDocumentContainerCustomEvent<HTMLMrdDocumentContainerElementEventMap[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 HTMLMrdDocumentContainerElement: {
+        prototype: HTMLMrdDocumentContainerElement;
+        new (): HTMLMrdDocumentContainerElement;
+    };
+    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 };
+        "mrdCanCreate": boolean;
+        "mrdUpdateObject": { href: string; values: Record<string, unknown> };
+        "mrdUpload": { file: File };
+        "mrdCreateObject": { path: string; values: Record<string, unknown> };
+    }
+    /**
+     * Archetype-driven document collection view. Renders documents as a lazy,
+     * file-explorer-style folder tree, grouped by the `commons.document` archetype's
+     * `container` (dossier, the top folder) and `folder` (a path string like
+     * `/draft documents/may 2020`, the sub-path beneath it).
+     * Loading is lazy per level, mirroring the /distinct endpoint (FINDING-0106):
+     *  - on load → `mrdLoadDistinct` for the `container` relation → top folders;
+     *  - on expanding a container → `mrdLoadDistinct` for the `folder` field, filtered
+     *    by `{containerField}_href` → all folder path strings for that container
+     *    (the client splits them on `/` and builds the sub-tree locally);
+     *  - on expanding a node that holds documents → `mrdLoadPage` (a plain filtered list
+     *    load, the same one a table page uses), filtered by container + exact folder string.
+     * When exactly one container exists (e.g. a dossier detail page) the container
+     * level is hidden and its folder tree is shown directly at the root.
+     */
+    interface HTMLMrdDocumentListElement extends Components.MrdDocumentList, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLMrdDocumentListElementEventMap>(type: K, listener: (this: HTMLMrdDocumentListElement, ev: MrdDocumentListCustomEvent<HTMLMrdDocumentListElementEventMap[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 HTMLMrdDocumentListElementEventMap>(type: K, listener: (this: HTMLMrdDocumentListElement, ev: MrdDocumentListCustomEvent<HTMLMrdDocumentListElementEventMap[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 HTMLMrdDocumentListElement: {
+        prototype: HTMLMrdDocumentListElement;
+        new (): HTMLMrdDocumentListElement;
+    };
+    interface HTMLMrdDocumentViewElementEventMap {
+        "mrdNavigate": { href?: string; label: string };
+        "mrdDownload": { href: string; fileName: string };
+    }
+    /**
+     * 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.
+     * 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.
+     */
+    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;
+        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 HTMLMrdDocumentViewElementEventMap>(type: K, listener: (this: HTMLMrdDocumentViewElement, ev: MrdDocumentViewCustomEvent<HTMLMrdDocumentViewElementEventMap[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 HTMLMrdDocumentViewElement: {
+        prototype: HTMLMrdDocumentViewElement;
+        new (): HTMLMrdDocumentViewElement;
+    };
     interface HTMLMrdEmailFieldElementEventMap {
         "mrdChange": { name: string; value: string };
         "mrdBlur": { name: string; value: string };
@@ -927,10 +1175,14 @@ declare global {
         "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate };
         "mrdSearch": { query: string; dataClass: string };
         "mrdDownload": { href: string; fileName: string };
-        "mrdLoadViewPage": { name: string; page: number; sort: string; path: string; qs: string };
+        "mrdLoadViewPage": { name: string; page: number; sort: string; path: string; qs: string; nodeId?: string };
         "mrdLoadImage": { fieldName: string; 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 };
+        "mrdUpdateObject": { href: string; values: Record<string, unknown> };
+        "mrdViewUpload": { name: string; file: File };
+        "mrdCreateObject": { name: string; path: string; values: Record<string, unknown> };
     }
     interface HTMLMrdLayoutSectionElement extends Components.MrdLayoutSection, HTMLStencilElement {
         addEventListener<K extends keyof HTMLMrdLayoutSectionElementEventMap>(type: K, listener: (this: HTMLMrdLayoutSectionElement, ev: MrdLayoutSectionCustomEvent<HTMLMrdLayoutSectionElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -1118,6 +1370,9 @@ declare global {
         "mrd-currency-field": HTMLMrdCurrencyFieldElement;
         "mrd-date-field": HTMLMrdDateFieldElement;
         "mrd-datetime-field": HTMLMrdDatetimeFieldElement;
+        "mrd-document-container": HTMLMrdDocumentContainerElement;
+        "mrd-document-list": HTMLMrdDocumentListElement;
+        "mrd-document-view": HTMLMrdDocumentViewElement;
         "mrd-email-field": HTMLMrdEmailFieldElement;
         "mrd-field": HTMLMrdFieldElement;
         "mrd-file-field": HTMLMrdFileFieldElement;
@@ -1249,6 +1504,169 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * Owns a document collection view: a single toolbar (view switch + collection
+     * actions like "New folder", and — later — upload / drag-drop) plus the two
+     * interchangeable bodies, the folder tree (`mrd-document-list`) and the flat
+     * table (`mrd-table`).
+     * `mrd-layout-section` renders one of these per document VIEW / RELATED_VIEW and
+     * forwards the re-emitted load/navigate/action events to the host. The embedded
+     * table/list keep their `data-view` / `data-doclist` attributes so the host's
+     * existing `setViewPage` / `setViewDistinct` / `setViewAggregations` lookups
+     * (recursive querySelector) still resolve them unchanged.
+     */
+    interface MrdDocumentContainer {
+        /**
+          * Resolved `commons.document` archetype binding for the folder tree.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * The VIEW or RELATED_VIEW layout item (dataClass, fromClass, view config).
+          * @default null
+         */
+        "item"?: ClientLayoutItem | null;
+        /**
+          * @default navigator.language
+         */
+        "locale"?: string;
+        /**
+          * A table toolbar action was triggered.
+         */
+        "onMrdAction"?: (event: MrdDocumentContainerCustomEvent<{ action: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string }>) => void;
+        /**
+          * Create a new document from an uploaded file; host POSTs `values` to `path`.
+         */
+        "onMrdCreateObject"?: (event: MrdDocumentContainerCustomEvent<{ path: string; values: Record<string, unknown> }>) => void;
+        /**
+          * Re-emitted from the embedded table.
+         */
+        "onMrdLoadAggregations"?: (event: MrdDocumentContainerCustomEvent<{ path: string; qs: string; aggQs: string }>) => void;
+        /**
+          * Re-emitted from the embedded folder tree.
+         */
+        "onMrdLoadDistinct"?: (event: MrdDocumentContainerCustomEvent<{ nodeId: string; distinct: string; path: string; qs: string }>) => void;
+        /**
+          * Re-emitted from the embedded list/table. `nodeId` present for a folder load.
+         */
+        "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.
+         */
+        "onMrdNavigate"?: (event: MrdDocumentContainerCustomEvent<{ href?: string; label: string }>) => void;
+        /**
+          * Generic "update an existing object" request, re-emitted from the folder tree (a document was dragged into another folder/container).
+         */
+        "onMrdUpdateObject"?: (event: MrdDocumentContainerCustomEvent<{ href: string; values: Record<string, unknown> }>) => void;
+        /**
+          * An external file was dropped on a folder; host uploads and calls back.
+         */
+        "onMrdUpload"?: (event: MrdDocumentContainerCustomEvent<{ file: File }>) => void;
+        /**
+          * Parent record id — required for RELATED_VIEW path building.
+          * @default ''
+         */
+        "parentId"?: string;
+        /**
+          * Lookup key used for the embedded `data-doclist` / `data-view` attributes.
+          * @default ''
+         */
+        "viewKey"?: string;
+    }
+    /**
+     * Archetype-driven document collection view. Renders documents as a lazy,
+     * file-explorer-style folder tree, grouped by the `commons.document` archetype's
+     * `container` (dossier, the top folder) and `folder` (a path string like
+     * `/draft documents/may 2020`, the sub-path beneath it).
+     * Loading is lazy per level, mirroring the /distinct endpoint (FINDING-0106):
+     *  - on load → `mrdLoadDistinct` for the `container` relation → top folders;
+     *  - on expanding a container → `mrdLoadDistinct` for the `folder` field, filtered
+     *    by `{containerField}_href` → all folder path strings for that container
+     *    (the client splits them on `/` and builds the sub-tree locally);
+     *  - on expanding a node that holds documents → `mrdLoadPage` (a plain filtered list
+     *    load, the same one a table page uses), filtered by container + exact folder string.
+     * When exactly one container exists (e.g. a dossier detail page) the container
+     * level is hidden and its folder tree is shown directly at the root.
+     */
+    interface MrdDocumentList {
+        /**
+          * Resolved `commons.document` binding: slot name → concrete field/relation name.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * The VIEW or RELATED_VIEW layout item (dataClass, fromClass, view config).
+          * @default null
+         */
+        "item"?: ClientLayoutItem | null;
+        /**
+          * @default navigator.language
+         */
+        "locale"?: string;
+        /**
+          * Emitted whenever the "can create a folder here" state changes, so a host toolbar (mrd-document-container) can enable/disable its New folder button.
+         */
+        "onMrdCanCreate"?: (event: MrdDocumentListCustomEvent<boolean>) => void;
+        /**
+          * Fired once the dropped file is uploaded — requests creation of a new document. Host POSTs `values` to `path` (on a 400 it can open the create form itself).
+         */
+        "onMrdCreateObject"?: (event: MrdDocumentListCustomEvent<{ path: string; values: Record<string, unknown> }>) => void;
+        /**
+          * Request distinct values for a field/relation. Host fetches `{path}?{qs}` and calls `setDistinct(nodeId, values)`.
+         */
+        "onMrdLoadDistinct"?: (event: MrdDocumentListCustomEvent<{ nodeId: string; distinct: string; path: string; qs: string }>) => void;
+        /**
+          * Request the documents in one folder — the same filtered list load a table does. Host fetches `{path}?{qs}` and calls `setDocuments(nodeId, docs)` (via setViewPage).
+         */
+        "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.
+         */
+        "onMrdNavigate"?: (event: MrdDocumentListCustomEvent<{ href?: string; label: string }>) => 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.
+         */
+        "onMrdUpdateObject"?: (event: MrdDocumentListCustomEvent<{ href: string; values: Record<string, unknown> }>) => void;
+        /**
+          * An external file was dropped onto a folder/container. Same flow as mrd-form: host uploads the file and calls `setFileReference(uri)` with the result.
+         */
+        "onMrdUpload"?: (event: MrdDocumentListCustomEvent<{ file: File }>) => void;
+        /**
+          * Parent record id — required for RELATED_VIEW path building.
+          * @default ''
+         */
+        "parentId"?: string;
+    }
+    /**
+     * 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.
+     * 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.
+     */
+    interface MrdDocumentView {
+        /**
+          * Resolved `commons.document` binding: slot name → concrete field/relation name.
+         */
+        "archetype": ClientArchetype;
+        /**
+          * The data record from the /data endpoint. Fields keyed by name; relations under `_links`.
+          * @default {}
+         */
+        "data"?: Record<string, unknown>;
+        /**
+          * @default navigator.language
+         */
+        "locale"?: string;
+        /**
+          * Download the document file. Host resolves the href to a signed URL.
+         */
+        "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;
+    }
     interface MrdEmailField {
         /**
           * @default false
@@ -1282,7 +1700,7 @@ declare namespace LocalJSX {
         "value"?: string;
     }
     interface MrdField {
-        "item": ClientLayoutItem;
+        "item": ClientLayoutItem1;
         /**
           * @default navigator.language
          */
@@ -1443,6 +1861,11 @@ declare namespace LocalJSX {
         "value"?: unknown;
     }
     interface 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.
+          * @default []
+         */
+        "archetypes"?: ClientArchetype[];
         /**
           * Record data object; keys are field names, _links holds relation and related-view links.
           * @default {}
@@ -1452,7 +1875,7 @@ declare namespace LocalJSX {
           * Items from one layout entry in ClientDashboardMetadata.layouts[].
           * @default []
          */
-        "items"?: ClientLayoutItem1[];
+        "items"?: ClientLayoutItem[];
         /**
           * Legacy: top-level _links from ClientDashboardMetadata. Not needed in new flat format.
           * @default {}
@@ -1462,6 +1885,10 @@ declare namespace LocalJSX {
           * @default navigator.language
          */
         "locale"?: string;
+        /**
+          * 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;
         /**
           * Fired once on load for each IMAGE field that has an href; host resolves the URL and calls setImagePreview().
@@ -1472,15 +1899,27 @@ declare namespace LocalJSX {
          */
         "onMrdLoadViewAggregations"?: (event: MrdLayoutSectionCustomEvent<{ name: string; dataClass: string; path: string; qs: string; aggQs: string }>) => void;
         /**
-          * Re-emitted from an embedded mrd-table's mrdLoadPage; host fetches the next page and calls setViewPage().
+          * Re-emitted from an embedded mrd-document-list's mrdLoadDistinct; host fetches distinct values and calls setViewDistinct().
          */
-        "onMrdLoadViewPage"?: (event: MrdLayoutSectionCustomEvent<{ name: string; page: number; sort: string; path: string; qs: string }>) => void;
+        "onMrdLoadViewDistinct"?: (event: MrdLayoutSectionCustomEvent<{ name: string; nodeId: string; distinct: string; path: string; qs: string }>) => void;
+        /**
+          * 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;
         "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`.
+         */
+        "onMrdUpdateObject"?: (event: MrdLayoutSectionCustomEvent<{ href: string; values: Record<string, unknown> }>) => void;
         /**
           * Re-emitted from an embedded mrd-table's mrdAction; host builds the target URL from dataClass.
          */
         "onMrdViewAction"?: (event: MrdLayoutSectionCustomEvent<{ name: string; action: string; dataClass: string; path?: string; qs?: string; parentPath?: string | null; basicType?: string }>) => void;
+        /**
+          * An external file was dropped on a document view; host uploads and calls setViewFileReference(name, uri).
+         */
+        "onMrdViewUpload"?: (event: MrdLayoutSectionCustomEvent<{ name: string; file: File }>) => void;
         /**
           * Legacy: view metadata map (ClientDashboardMetadata.views). Not needed in new flat format.
           * @default {}
@@ -1687,7 +2126,7 @@ declare namespace LocalJSX {
           * The VIEW or RELATED_VIEW layout item. Contains view config, dataClass, fromClass, actions etc.
           * @default null
          */
-        "item"?: ClientLayoutItem1 | null;
+        "item"?: ClientLayoutItem | null;
         /**
           * @default navigator.language
          */
@@ -1867,6 +2306,18 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "locale": string;
     }
+    interface MrdDocumentContainerAttributes {
+        "parentId": string;
+        "viewKey": string;
+        "locale": string;
+    }
+    interface MrdDocumentListAttributes {
+        "parentId": string;
+        "locale": string;
+    }
+    interface MrdDocumentViewAttributes {
+        "locale": string;
+    }
     interface MrdEmailFieldAttributes {
         "name": string;
         "label": string;
@@ -2007,6 +2458,9 @@ declare namespace LocalJSX {
         "mrd-currency-field": Omit<MrdCurrencyField, keyof MrdCurrencyFieldAttributes> & { [K in keyof MrdCurrencyField & keyof MrdCurrencyFieldAttributes]?: MrdCurrencyField[K] } & { [K in keyof MrdCurrencyField & keyof MrdCurrencyFieldAttributes as `attr:${K}`]?: MrdCurrencyFieldAttributes[K] } & { [K in keyof MrdCurrencyField & keyof MrdCurrencyFieldAttributes as `prop:${K}`]?: MrdCurrencyField[K] };
         "mrd-date-field": Omit<MrdDateField, keyof MrdDateFieldAttributes> & { [K in keyof MrdDateField & keyof MrdDateFieldAttributes]?: MrdDateField[K] } & { [K in keyof MrdDateField & keyof MrdDateFieldAttributes as `attr:${K}`]?: MrdDateFieldAttributes[K] } & { [K in keyof MrdDateField & keyof MrdDateFieldAttributes as `prop:${K}`]?: MrdDateField[K] };
         "mrd-datetime-field": Omit<MrdDatetimeField, keyof MrdDatetimeFieldAttributes> & { [K in keyof MrdDatetimeField & keyof MrdDatetimeFieldAttributes]?: MrdDatetimeField[K] } & { [K in keyof MrdDatetimeField & keyof MrdDatetimeFieldAttributes as `attr:${K}`]?: MrdDatetimeFieldAttributes[K] } & { [K in keyof MrdDatetimeField & keyof MrdDatetimeFieldAttributes as `prop:${K}`]?: MrdDatetimeField[K] };
+        "mrd-document-container": Omit<MrdDocumentContainer, keyof MrdDocumentContainerAttributes> & { [K in keyof MrdDocumentContainer & keyof MrdDocumentContainerAttributes]?: MrdDocumentContainer[K] } & { [K in keyof MrdDocumentContainer & keyof MrdDocumentContainerAttributes as `attr:${K}`]?: MrdDocumentContainerAttributes[K] } & { [K in keyof MrdDocumentContainer & keyof MrdDocumentContainerAttributes as `prop:${K}`]?: MrdDocumentContainer[K] };
+        "mrd-document-list": Omit<MrdDocumentList, keyof MrdDocumentListAttributes> & { [K in keyof MrdDocumentList & keyof MrdDocumentListAttributes]?: MrdDocumentList[K] } & { [K in keyof MrdDocumentList & keyof MrdDocumentListAttributes as `attr:${K}`]?: MrdDocumentListAttributes[K] } & { [K in keyof MrdDocumentList & keyof MrdDocumentListAttributes as `prop:${K}`]?: MrdDocumentList[K] };
+        "mrd-document-view": Omit<MrdDocumentView, keyof MrdDocumentViewAttributes> & { [K in keyof MrdDocumentView & keyof MrdDocumentViewAttributes]?: MrdDocumentView[K] } & { [K in keyof MrdDocumentView & keyof MrdDocumentViewAttributes as `attr:${K}`]?: MrdDocumentViewAttributes[K] } & { [K in keyof MrdDocumentView & keyof MrdDocumentViewAttributes as `prop:${K}`]?: MrdDocumentView[K] };
         "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] };
@@ -2033,6 +2487,44 @@ declare module "@stencil/core" {
             "mrd-currency-field": LocalJSX.IntrinsicElements["mrd-currency-field"] & JSXBase.HTMLAttributes<HTMLMrdCurrencyFieldElement>;
             "mrd-date-field": LocalJSX.IntrinsicElements["mrd-date-field"] & JSXBase.HTMLAttributes<HTMLMrdDateFieldElement>;
             "mrd-datetime-field": LocalJSX.IntrinsicElements["mrd-datetime-field"] & JSXBase.HTMLAttributes<HTMLMrdDatetimeFieldElement>;
+            /**
+             * Owns a document collection view: a single toolbar (view switch + collection
+             * actions like "New folder", and — later — upload / drag-drop) plus the two
+             * interchangeable bodies, the folder tree (`mrd-document-list`) and the flat
+             * table (`mrd-table`).
+             * `mrd-layout-section` renders one of these per document VIEW / RELATED_VIEW and
+             * forwards the re-emitted load/navigate/action events to the host. The embedded
+             * table/list keep their `data-view` / `data-doclist` attributes so the host's
+             * existing `setViewPage` / `setViewDistinct` / `setViewAggregations` lookups
+             * (recursive querySelector) still resolve them unchanged.
+             */
+            "mrd-document-container": LocalJSX.IntrinsicElements["mrd-document-container"] & JSXBase.HTMLAttributes<HTMLMrdDocumentContainerElement>;
+            /**
+             * Archetype-driven document collection view. Renders documents as a lazy,
+             * file-explorer-style folder tree, grouped by the `commons.document` archetype's
+             * `container` (dossier, the top folder) and `folder` (a path string like
+             * `/draft documents/may 2020`, the sub-path beneath it).
+             * Loading is lazy per level, mirroring the /distinct endpoint (FINDING-0106):
+             *  - on load → `mrdLoadDistinct` for the `container` relation → top folders;
+             *  - on expanding a container → `mrdLoadDistinct` for the `folder` field, filtered
+             *    by `{containerField}_href` → all folder path strings for that container
+             *    (the client splits them on `/` and builds the sub-tree locally);
+             *  - on expanding a node that holds documents → `mrdLoadPage` (a plain filtered list
+             *    load, the same one a table page uses), filtered by container + exact folder string.
+             * When exactly one container exists (e.g. a dossier detail page) the container
+             * level is hidden and its folder tree is shown directly at the root.
+             */
+            "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,
+             * 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.
+             */
+            "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>;