@mmlogic/components 0.3.5 → 0.3.9

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,73 @@ export namespace Components {
          */
         "value": 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;
+        /**
+          * Parent record id — required for RELATED_VIEW path building.
+          * @default ''
+         */
+        "parentId": string;
+        /**
+          * 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>;
+    }
+    /**
+     * 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 +216,7 @@ export namespace Components {
         "value": string;
     }
     interface MrdField {
-        "item": ClientLayoutItem;
+        "item": ClientLayoutItem1;
         /**
           * @default navigator.language
          */
@@ -283,6 +354,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 +368,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 +395,13 @@ 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 distinct values into an embedded mrd-document-list for a document view.
+         */
+        "setViewDistinct": (name: string, nodeId: string, values: DistinctValue1[]) => 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 +603,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 +750,14 @@ export interface MrdDatetimeFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdDatetimeFieldElement;
 }
+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 +895,67 @@ declare global {
         prototype: HTMLMrdDatetimeFieldElement;
         new (): HTMLMrdDatetimeFieldElement;
     };
+    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 };
+    }
+    /**
+     * 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 +1076,11 @@ 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 };
     }
     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 +1268,8 @@ declare global {
         "mrd-currency-field": HTMLMrdCurrencyFieldElement;
         "mrd-date-field": HTMLMrdDateFieldElement;
         "mrd-datetime-field": HTMLMrdDatetimeFieldElement;
+        "mrd-document-list": HTMLMrdDocumentListElement;
+        "mrd-document-view": HTMLMrdDocumentViewElement;
         "mrd-email-field": HTMLMrdEmailFieldElement;
         "mrd-field": HTMLMrdFieldElement;
         "mrd-file-field": HTMLMrdFileFieldElement;
@@ -1249,6 +1401,85 @@ declare namespace LocalJSX {
          */
         "value"?: 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;
+        /**
+          * 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;
+        /**
+          * 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 +1513,7 @@ declare namespace LocalJSX {
         "value"?: string;
     }
     interface MrdField {
-        "item": ClientLayoutItem;
+        "item": ClientLayoutItem1;
         /**
           * @default navigator.language
          */
@@ -1443,6 +1674,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 +1688,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 {}
@@ -1472,9 +1708,13 @@ 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().
+         */
+        "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 }>) => void;
+        "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;
         /**
@@ -1687,7 +1927,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 +2107,13 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "locale": string;
     }
+    interface MrdDocumentListAttributes {
+        "parentId": string;
+        "locale": string;
+    }
+    interface MrdDocumentViewAttributes {
+        "locale": string;
+    }
     interface MrdEmailFieldAttributes {
         "name": string;
         "label": string;
@@ -2007,6 +2254,8 @@ 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-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 +2282,32 @@ 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>;
+            /**
+             * 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>;

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

@@ -81,6 +81,26 @@ export interface RelationSearchResult {
     label: string;
     description?: string;
 }
+/**
+ * A resolved archetype binding as published on a dashboard.
+ * `archetype` is the platform-defined id (e.g. `commons.document`); `slots` maps
+ * each slot name to the concrete field/relation name on this type. The client
+ * keys on the archetype id and reads values from the data endpoint via the map;
+ * the slot kind (value vs relation) is known from the archetype id itself and is
+ * not published.
+ */
+export interface ClientArchetype {
+    archetype: string;
+    slots: Record<string, string>;
+}
+/** Well-known archetype ids the client renders specially. */
+export declare const ARCHETYPE_DOCUMENT = "commons.document";
+/**
+ * Find a binding for `archetypeId` in a published `archetypes` list.
+ * Returns `undefined` when the archetype is absent — callers fall back to the
+ * generic table/field rendering.
+ */
+export declare function resolveArchetype(archetypes: ClientArchetype[] | null | undefined, archetypeId: string): ClientArchetype | undefined;
 export interface ClientLayoutItemField {
     name: string;
     label: string;
@@ -162,6 +182,15 @@ export interface ClientLayoutItem {
     relatedView?: ClientLayoutItemRelatedView;
     relatedObject?: ClientLayoutItemRelatedObject;
     search?: ClientLayoutItemSearch;
+    /**
+     * Archetype bindings for this item. The API publishes them on the item itself
+     * (sibling of `view`), for two cases:
+     *  - object dashboard top-level: the type of the object itself → mrd-layout-section
+     *    renders a recognisable single-document view instead of generic fields;
+     *  - a VIEW / RELATED_VIEW item: → mrd-layout-section offers the document
+     *    collection view (folder tree) alongside the generic table.
+     */
+    archetypes?: ClientArchetype[];
     name?: string;
     showTitle?: boolean;
     /** Embedded alternative view configs (new flat format). */
@@ -229,9 +258,18 @@ export interface ClientViewMetadata {
     filterType?: string | null;
     singularLabel?: string;
     pluralLabel?: string;
+    /**
+     * Archetype bindings published on this VIEW / RELATED_VIEW item. When it
+     * contains `commons.document`, mrd-layout-section offers the document
+     * collection view (folder tree) alongside the generic table.
+     */
+    archetypes?: ClientArchetype[];
 }
 export interface ClientDashboardMetadata {
     layouts: ClientLayout[];
+    /** Top-level archetypes on an object dashboard (the object's own type). Drives the
+     *  single-document view; passed to the main layout's mrd-layout-section. */
+    archetypes?: ClientArchetype[];
     /** Legacy: view metadata map keyed by generated name. Absent in new flat format. */
     views?: Record<string, ClientViewMetadata>;
     layoutType: ClientLayoutType;

package/package.json

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