@mmlogic/components 0.5.1 → 0.5.3

package/dist/types/components.d.ts

@@ -5,14 +5,16 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-import { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+import { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue as ClientListValue1, CurrencyValue, RelationSearchResult } from "./types";
+import { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientListValue, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
 import { ListNavigationContext } from "./utils/query-params";
 import { DistinctValue, DocRow } from "./components/documents/mrd-document-list/folder-tree";
-export { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue, CurrencyValue, RelationSearchResult } from "./types";
-export { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
+import { FileEntry } from "./components/fields/file-upload-common";
+export { ClientLayout, ClientLayoutItem as ClientLayoutItem1, ClientLayoutItemFieldDataType, ClientLayoutItemRelationDisplayType, ClientLayoutItemRelationEditBehavior, ClientListValue as ClientListValue1, CurrencyValue, RelationSearchResult } from "./types";
+export { AggregationResult, ClientArchetype, ClientLayoutItem, ClientLayoutItemNavigate, ClientLayoutNavigateBehaviour, ClientListValue, ClientViewMetadata, DocumentAttachment, HyperlinkValue, RelationSearchResult as RelationSearchResult1 } from "./types/client-layout";
 export { ListNavigationContext } from "./utils/query-params";
 export { DistinctValue, DocRow } from "./components/documents/mrd-document-list/folder-tree";
+export { FileEntry } from "./components/fields/file-upload-common";
 export namespace Components {
     interface MrdBooleanField {
         /**
@@ -284,6 +286,32 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * Archetype-driven single-email view. Given a `commons.email` binding and a data
+     * record, renders the message the way an Outlook printout would — subject, a
+     * compact From/To/CC/Date header block, the body and attachments — instead of a
+     * generic field form. Fully read-only: emails arrive through other channels (mail
+     * ingestion gateways), never edited here.
+     * Like `mrd-document-view`/`mrd-invoice-view`, this component never resolves file
+     * hrefs itself — it only exposes attachment references via `mrdAttachments` (an
+     * email can have several) and plain download buttons; the host decides how/whether
+     * to render them.
+     */
+    interface MrdEmailView {
+        /**
+          * Resolved `commons.email` 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 MrdField {
         "item": ClientLayoutItem1;
         /**
@@ -313,6 +341,10 @@ export namespace Components {
           * @default 0
          */
         "maxSize": number;
+        /**
+          * @default false
+         */
+        "multiple": boolean;
         /**
           * @default ''
          */
@@ -347,7 +379,10 @@ export namespace Components {
           * @default ''
          */
         "referenceHref": string;
-        "setFieldValue": (name: string, value: unknown) => Promise<void>;
+        /**
+          * Inject a value from outside (e.g. after a file upload completes). `file` is optional and only meaningful for `multiple` FILE/IMAGE fields: when the field's current value is an array, mrd-form replaces the array entry that `=== file` with `value`, leaving other pending/resolved entries untouched — this is how mrd-file-field/mrd-image-field resolve concurrent per-file uploads. Pass the `file` from the originating mrdUpload event back unchanged.
+         */
+        "setFieldValue": (name: string, value: unknown, file?: File) => Promise<void>;
         /**
           * When true, a cancel button is shown next to the submit button.
           * @default false
@@ -409,6 +444,10 @@ export namespace Components {
           * @default 0
          */
         "maxSize": number;
+        /**
+          * @default false
+         */
+        "multiple": boolean;
         /**
           * @default ''
          */
@@ -422,6 +461,40 @@ export namespace Components {
          */
         "value": unknown;
     }
+    /**
+     * Archetype-driven single-invoice view. Given a `commons.invoice` binding and a data
+     * record, renders a clear, recognisable invoice summary — number, status, dates,
+     * customer/supplier, totals and attachments — instead of a generic field form.
+     * The line items (`lines` slot, the `commons.invoiceLine` sub-archetype) are NOT
+     * rendered here: this component only reserves a `slot="lines"` at the right spot in
+     * the layout. The host (`mrd-layout-section`) still owns all the actual RELATED_VIEW
+     * table data-loading/event wiring — via its existing `renderRelatedView()` — and
+     * projects the resulting `<mrd-table>` into that slot, so line editing keeps using
+     * the same generic create/edit-navigation mechanism every other relation already has.
+     * Like `mrd-document-view`, this component never resolves file hrefs itself — it only
+     * exposes the attachment references via `mrdAttachments` (now possibly more than one)
+     * and a plain download button; the host decides how/whether to render them.
+     */
+    interface MrdInvoiceView {
+        /**
+          * Resolved `commons.invoice` 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;
+        /**
+          * listItems of the FIELD bound to the `status` slot, resolved by mrd-layout-section from its own items array (archetype metadata does not publish listItems), so the status badge can get a real label/color instead of the raw stored key.
+          * @default null
+         */
+        "statusListItems": ClientListValue[] | null;
+    }
     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.
@@ -498,7 +571,7 @@ export namespace Components {
           * List items from the API. Each item has a `key` (stored value) and `label`.
           * @default []
          */
-        "listItems": ClientListValue[];
+        "listItems": ClientListValue1[];
         /**
           * @default navigator.language
          */
@@ -550,6 +623,57 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * Merges two DataObjects of the same basic type (FINDING-0114 / TASK-0177).
+     * Never performs network I/O itself: it emits `mrdSearch` (host searches and
+     * calls `setSearchResults()`, mirroring mrd-relation-field) and `mrdMerge`
+     * (host calls the merge endpoint — `POST {winnerHref}/merge` with
+     * `{ loser: loserHref, patch }`, per DataController.merge()).
+     * Has no exit/cancel affordance of its own — hosts show this inside their
+     * own overlay-page chrome (its close button), the same way mrd-layout-section
+     * never renders a page-level close button either.
+     */
+    interface MrdMergeView {
+        /**
+          * Dot-notation class, passed through on mrdSearch (host may use it to pick the right search endpoint).
+          * @default ''
+         */
+        "basicType": string;
+        /**
+          * Href of A (winner) — the object the merge screen was opened from.
+          * @default ''
+         */
+        "currentHref": string;
+        /**
+          * Display name for A, shown in the compare step's column header.
+          * @default ''
+         */
+        "currentLabel": string;
+        /**
+          * A's full raw record: flat fields + `_links`, the same row shape CellRenderer.render expects.
+          * @default {}
+         */
+        "currentRecord": Record<string, any>;
+        /**
+          * Flat FIELD/RELATION items describing the basic type's schema (host flattens SECTION/GROUP, same as mrd-table's `columns`).
+          * @default []
+         */
+        "fields": ClientLayoutItem[];
+        /**
+          * @default navigator.language
+         */
+        "locale": string;
+        /**
+          * URL segment for the search endpoint; falls back to basicType when absent.
+          * @default ''
+         */
+        "mostSignificantClass": string;
+        "setLoading": (loading: boolean) => Promise<void>;
+        /**
+          * Stores search results, filtering out A itself regardless of what the host's search returns — A must never appear as a mergeable candidate.
+         */
+        "setSearchResults": (records: Record<string, any>[]) => Promise<void>;
+    }
     interface MrdNumberField {
         /**
           * @default ClientLayoutItemFieldDataType.INTEGER
@@ -601,7 +725,7 @@ export namespace Components {
         /**
           * @default []
          */
-        "dropdownValues": ClientListValue[];
+        "dropdownValues": ClientListValue1[];
         "editBehavior"?: ClientLayoutItemRelationEditBehavior | null;
         /**
           * @default ''
@@ -848,6 +972,10 @@ export interface MrdEmailFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdEmailFieldElement;
 }
+export interface MrdEmailViewCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdEmailViewElement;
+}
 export interface MrdFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdFieldElement;
@@ -868,6 +996,10 @@ export interface MrdImageFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdImageFieldElement;
 }
+export interface MrdInvoiceViewCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdInvoiceViewElement;
+}
 export interface MrdLayoutSectionCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdLayoutSectionElement;
@@ -880,6 +1012,10 @@ export interface MrdLongtextFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdLongtextFieldElement;
 }
+export interface MrdMergeViewCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLMrdMergeViewElement;
+}
 export interface MrdNumberFieldCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLMrdNumberFieldElement;
@@ -1106,6 +1242,36 @@ declare global {
         prototype: HTMLMrdEmailFieldElement;
         new (): HTMLMrdEmailFieldElement;
     };
+    interface HTMLMrdEmailViewElementEventMap {
+        "mrdNavigate": { href?: string; label: string };
+        "mrdDownload": { href: string; fileName: string };
+        "mrdAttachments": { attachments: DocumentAttachment[] };
+    }
+    /**
+     * Archetype-driven single-email view. Given a `commons.email` binding and a data
+     * record, renders the message the way an Outlook printout would — subject, a
+     * compact From/To/CC/Date header block, the body and attachments — instead of a
+     * generic field form. Fully read-only: emails arrive through other channels (mail
+     * ingestion gateways), never edited here.
+     * Like `mrd-document-view`/`mrd-invoice-view`, this component never resolves file
+     * hrefs itself — it only exposes attachment references via `mrdAttachments` (an
+     * email can have several) and plain download buttons; the host decides how/whether
+     * to render them.
+     */
+    interface HTMLMrdEmailViewElement extends Components.MrdEmailView, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLMrdEmailViewElementEventMap>(type: K, listener: (this: HTMLMrdEmailViewElement, ev: MrdEmailViewCustomEvent<HTMLMrdEmailViewElementEventMap[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 HTMLMrdEmailViewElementEventMap>(type: K, listener: (this: HTMLMrdEmailViewElement, ev: MrdEmailViewCustomEvent<HTMLMrdEmailViewElementEventMap[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 HTMLMrdEmailViewElement: {
+        prototype: HTMLMrdEmailViewElement;
+        new (): HTMLMrdEmailViewElement;
+    };
     interface HTMLMrdFieldElementEventMap {
         "mrdChange": { name: string; value: unknown };
         "mrdBlur": { name: string; value: unknown };
@@ -1128,8 +1294,8 @@ declare global {
         new (): HTMLMrdFieldElement;
     };
     interface HTMLMrdFileFieldElementEventMap {
-        "mrdChange": { name: string; value: File | null };
-        "mrdBlur": { name: string; value: File | null };
+        "mrdChange": { name: string; value: FileEntry | FileEntry[] | null };
+        "mrdBlur": { name: string; value: FileEntry | FileEntry[] | null };
         "mrdUpload": { name: string; file: File };
     }
     interface HTMLMrdFileFieldElement extends Components.MrdFileField, HTMLStencilElement {
@@ -1186,8 +1352,8 @@ declare global {
         new (): HTMLMrdHyperlinkFieldElement;
     };
     interface HTMLMrdImageFieldElementEventMap {
-        "mrdChange": { name: string; value: File | null };
-        "mrdBlur": { name: string; value: File | null };
+        "mrdChange": { name: string; value: FileEntry | FileEntry[] | null };
+        "mrdBlur": { name: string; value: FileEntry | FileEntry[] | null };
         "mrdUpload": { name: string; file: File };
     }
     interface HTMLMrdImageFieldElement extends Components.MrdImageField, HTMLStencilElement {
@@ -1204,6 +1370,39 @@ declare global {
         prototype: HTMLMrdImageFieldElement;
         new (): HTMLMrdImageFieldElement;
     };
+    interface HTMLMrdInvoiceViewElementEventMap {
+        "mrdNavigate": { href?: string; label: string };
+        "mrdDownload": { href: string; fileName: string };
+        "mrdAttachments": { attachments: DocumentAttachment[] };
+    }
+    /**
+     * Archetype-driven single-invoice view. Given a `commons.invoice` binding and a data
+     * record, renders a clear, recognisable invoice summary — number, status, dates,
+     * customer/supplier, totals and attachments — instead of a generic field form.
+     * The line items (`lines` slot, the `commons.invoiceLine` sub-archetype) are NOT
+     * rendered here: this component only reserves a `slot="lines"` at the right spot in
+     * the layout. The host (`mrd-layout-section`) still owns all the actual RELATED_VIEW
+     * table data-loading/event wiring — via its existing `renderRelatedView()` — and
+     * projects the resulting `<mrd-table>` into that slot, so line editing keeps using
+     * the same generic create/edit-navigation mechanism every other relation already has.
+     * Like `mrd-document-view`, this component never resolves file hrefs itself — it only
+     * exposes the attachment references via `mrdAttachments` (now possibly more than one)
+     * and a plain download button; the host decides how/whether to render them.
+     */
+    interface HTMLMrdInvoiceViewElement extends Components.MrdInvoiceView, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLMrdInvoiceViewElementEventMap>(type: K, listener: (this: HTMLMrdInvoiceViewElement, ev: MrdInvoiceViewCustomEvent<HTMLMrdInvoiceViewElementEventMap[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 HTMLMrdInvoiceViewElementEventMap>(type: K, listener: (this: HTMLMrdInvoiceViewElement, ev: MrdInvoiceViewCustomEvent<HTMLMrdInvoiceViewElementEventMap[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 HTMLMrdInvoiceViewElement: {
+        prototype: HTMLMrdInvoiceViewElement;
+        new (): HTMLMrdInvoiceViewElement;
+    };
     interface HTMLMrdLayoutSectionElementEventMap {
         "mrdNavigate": { href?: string; label: string; navigate?: ClientLayoutItemNavigate; navigateBehaviour?: ClientLayoutNavigateBehaviour; listContext?: ListNavigationContext; attachments?: DocumentAttachment[] };
         "mrdSearch": { query: string; dataClass: string };
@@ -1268,6 +1467,34 @@ declare global {
         prototype: HTMLMrdLongtextFieldElement;
         new (): HTMLMrdLongtextFieldElement;
     };
+    interface HTMLMrdMergeViewElementEventMap {
+        "mrdSearch": { query: string; basicType: string; mostSignificantClass?: string };
+        "mrdMerge": { winnerHref: string; loserHref: string; patch: Record<string, unknown> };
+    }
+    /**
+     * Merges two DataObjects of the same basic type (FINDING-0114 / TASK-0177).
+     * Never performs network I/O itself: it emits `mrdSearch` (host searches and
+     * calls `setSearchResults()`, mirroring mrd-relation-field) and `mrdMerge`
+     * (host calls the merge endpoint — `POST {winnerHref}/merge` with
+     * `{ loser: loserHref, patch }`, per DataController.merge()).
+     * Has no exit/cancel affordance of its own — hosts show this inside their
+     * own overlay-page chrome (its close button), the same way mrd-layout-section
+     * never renders a page-level close button either.
+     */
+    interface HTMLMrdMergeViewElement extends Components.MrdMergeView, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLMrdMergeViewElementEventMap>(type: K, listener: (this: HTMLMrdMergeViewElement, ev: MrdMergeViewCustomEvent<HTMLMrdMergeViewElementEventMap[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 HTMLMrdMergeViewElementEventMap>(type: K, listener: (this: HTMLMrdMergeViewElement, ev: MrdMergeViewCustomEvent<HTMLMrdMergeViewElementEventMap[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 HTMLMrdMergeViewElement: {
+        prototype: HTMLMrdMergeViewElement;
+        new (): HTMLMrdMergeViewElement;
+    };
     interface HTMLMrdNumberFieldElementEventMap {
         "mrdChange": { name: string; value: number | null };
         "mrdBlur": { name: string; value: number | null };
@@ -1409,14 +1636,17 @@ declare global {
         "mrd-document-list": HTMLMrdDocumentListElement;
         "mrd-document-view": HTMLMrdDocumentViewElement;
         "mrd-email-field": HTMLMrdEmailFieldElement;
+        "mrd-email-view": HTMLMrdEmailViewElement;
         "mrd-field": HTMLMrdFieldElement;
         "mrd-file-field": HTMLMrdFileFieldElement;
         "mrd-form": HTMLMrdFormElement;
         "mrd-hyperlink-field": HTMLMrdHyperlinkFieldElement;
         "mrd-image-field": HTMLMrdImageFieldElement;
+        "mrd-invoice-view": HTMLMrdInvoiceViewElement;
         "mrd-layout-section": HTMLMrdLayoutSectionElement;
         "mrd-list-field": HTMLMrdListFieldElement;
         "mrd-longtext-field": HTMLMrdLongtextFieldElement;
+        "mrd-merge-view": HTMLMrdMergeViewElement;
         "mrd-number-field": HTMLMrdNumberFieldElement;
         "mrd-relation-field": HTMLMrdRelationFieldElement;
         "mrd-secret-field": HTMLMrdSecretFieldElement;
@@ -1759,6 +1989,44 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * Archetype-driven single-email view. Given a `commons.email` binding and a data
+     * record, renders the message the way an Outlook printout would — subject, a
+     * compact From/To/CC/Date header block, the body and attachments — instead of a
+     * generic field form. Fully read-only: emails arrive through other channels (mail
+     * ingestion gateways), never edited here.
+     * Like `mrd-document-view`/`mrd-invoice-view`, this component never resolves file
+     * hrefs itself — it only exposes attachment references via `mrdAttachments` (an
+     * email can have several) and plain download buttons; the host decides how/whether
+     * to render them.
+     */
+    interface MrdEmailView {
+        /**
+          * Resolved `commons.email` 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;
+        /**
+          * The file(s) belonging to this email, fired once on load and again whenever the attachments slot's value changes. The host resolves the href(s) itself.
+         */
+        "onMrdAttachments"?: (event: MrdEmailViewCustomEvent<{ attachments: DocumentAttachment[] }>) => void;
+        /**
+          * Download an attachment. Host resolves the href to a signed URL.
+         */
+        "onMrdDownload"?: (event: MrdEmailViewCustomEvent<{ href: string; fileName: string }>) => void;
+        /**
+          * Navigate to a sender/recipient or the container. Host resolves the href and routes.
+         */
+        "onMrdNavigate"?: (event: MrdEmailViewCustomEvent<{ href?: string; label: string }>) => void;
+    }
     interface MrdField {
         "item": ClientLayoutItem1;
         /**
@@ -1793,14 +2061,18 @@ declare namespace LocalJSX {
           * @default 0
          */
         "maxSize"?: number;
+        /**
+          * @default false
+         */
+        "multiple"?: boolean;
         /**
           * @default ''
          */
         "name"?: string;
-        "onMrdBlur"?: (event: MrdFileFieldCustomEvent<{ name: string; value: File | null }>) => void;
-        "onMrdChange"?: (event: MrdFileFieldCustomEvent<{ name: string; value: File | null }>) => void;
+        "onMrdBlur"?: (event: MrdFileFieldCustomEvent<{ name: string; value: FileEntry | FileEntry[] | null }>) => void;
+        "onMrdChange"?: (event: MrdFileFieldCustomEvent<{ name: string; value: FileEntry | FileEntry[] | null }>) => void;
         /**
-          * Emitted when a file is selected and needs to be uploaded. Host should upload the file and call form.setFieldValue(name, uri) with the result.
+          * Emitted once per selected/dropped file that needs to be uploaded. Host should upload the file and call form.setFieldValue(name, { href, fileName: file.name }, file) with the result — passing `file` back lets mrd-form resolve the right entry in a `multiple` field.
          */
         "onMrdUpload"?: (event: MrdFileFieldCustomEvent<{ name: string; file: File }>) => void;
         /**
@@ -1901,14 +2173,18 @@ declare namespace LocalJSX {
           * @default 0
          */
         "maxSize"?: number;
+        /**
+          * @default false
+         */
+        "multiple"?: boolean;
         /**
           * @default ''
          */
         "name"?: string;
-        "onMrdBlur"?: (event: MrdImageFieldCustomEvent<{ name: string; value: File | null }>) => void;
-        "onMrdChange"?: (event: MrdImageFieldCustomEvent<{ name: string; value: File | null }>) => void;
+        "onMrdBlur"?: (event: MrdImageFieldCustomEvent<{ name: string; value: FileEntry | FileEntry[] | null }>) => void;
+        "onMrdChange"?: (event: MrdImageFieldCustomEvent<{ name: string; value: FileEntry | FileEntry[] | null }>) => void;
         /**
-          * Emitted when an image is selected and needs to be uploaded. Host should upload the file and call form.setFieldValue(name, uri) with the result.
+          * Emitted once per selected/dropped image that needs to be uploaded. Host should upload the file and call form.setFieldValue(name, { href, fileName: file.name }, file) with the result — passing `file` back lets mrd-form resolve the right entry in a `multiple` field.
          */
         "onMrdUpload"?: (event: MrdImageFieldCustomEvent<{ name: string; file: File }>) => void;
         /**
@@ -1920,6 +2196,52 @@ declare namespace LocalJSX {
          */
         "value"?: unknown;
     }
+    /**
+     * Archetype-driven single-invoice view. Given a `commons.invoice` binding and a data
+     * record, renders a clear, recognisable invoice summary — number, status, dates,
+     * customer/supplier, totals and attachments — instead of a generic field form.
+     * The line items (`lines` slot, the `commons.invoiceLine` sub-archetype) are NOT
+     * rendered here: this component only reserves a `slot="lines"` at the right spot in
+     * the layout. The host (`mrd-layout-section`) still owns all the actual RELATED_VIEW
+     * table data-loading/event wiring — via its existing `renderRelatedView()` — and
+     * projects the resulting `<mrd-table>` into that slot, so line editing keeps using
+     * the same generic create/edit-navigation mechanism every other relation already has.
+     * Like `mrd-document-view`, this component never resolves file hrefs itself — it only
+     * exposes the attachment references via `mrdAttachments` (now possibly more than one)
+     * and a plain download button; the host decides how/whether to render them.
+     */
+    interface MrdInvoiceView {
+        /**
+          * Resolved `commons.invoice` 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;
+        /**
+          * The file(s) belonging to this invoice, fired once on load and again whenever the attachments slot's value changes. The host resolves the href(s) itself.
+         */
+        "onMrdAttachments"?: (event: MrdInvoiceViewCustomEvent<{ attachments: DocumentAttachment[] }>) => void;
+        /**
+          * Download an attachment. Host resolves the href to a signed URL.
+         */
+        "onMrdDownload"?: (event: MrdInvoiceViewCustomEvent<{ href: string; fileName: string }>) => void;
+        /**
+          * Navigate to the customer/supplier/container. Host resolves the href and routes.
+         */
+        "onMrdNavigate"?: (event: MrdInvoiceViewCustomEvent<{ href?: string; label: string }>) => void;
+        /**
+          * listItems of the FIELD bound to the `status` slot, resolved by mrd-layout-section from its own items array (archetype metadata does not publish listItems), so the status badge can get a real label/color instead of the raw stored key.
+          * @default null
+         */
+        "statusListItems"?: ClientListValue[] | null;
+    }
     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.
@@ -2006,7 +2328,7 @@ declare namespace LocalJSX {
           * List items from the API. Each item has a `key` (stored value) and `label`.
           * @default []
          */
-        "listItems"?: ClientListValue[];
+        "listItems"?: ClientListValue1[];
         /**
           * @default navigator.language
          */
@@ -2062,6 +2384,54 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * Merges two DataObjects of the same basic type (FINDING-0114 / TASK-0177).
+     * Never performs network I/O itself: it emits `mrdSearch` (host searches and
+     * calls `setSearchResults()`, mirroring mrd-relation-field) and `mrdMerge`
+     * (host calls the merge endpoint — `POST {winnerHref}/merge` with
+     * `{ loser: loserHref, patch }`, per DataController.merge()).
+     * Has no exit/cancel affordance of its own — hosts show this inside their
+     * own overlay-page chrome (its close button), the same way mrd-layout-section
+     * never renders a page-level close button either.
+     */
+    interface MrdMergeView {
+        /**
+          * Dot-notation class, passed through on mrdSearch (host may use it to pick the right search endpoint).
+          * @default ''
+         */
+        "basicType"?: string;
+        /**
+          * Href of A (winner) — the object the merge screen was opened from.
+          * @default ''
+         */
+        "currentHref"?: string;
+        /**
+          * Display name for A, shown in the compare step's column header.
+          * @default ''
+         */
+        "currentLabel"?: string;
+        /**
+          * A's full raw record: flat fields + `_links`, the same row shape CellRenderer.render expects.
+          * @default {}
+         */
+        "currentRecord"?: Record<string, any>;
+        /**
+          * Flat FIELD/RELATION items describing the basic type's schema (host flattens SECTION/GROUP, same as mrd-table's `columns`).
+          * @default []
+         */
+        "fields"?: ClientLayoutItem[];
+        /**
+          * @default navigator.language
+         */
+        "locale"?: string;
+        /**
+          * URL segment for the search endpoint; falls back to basicType when absent.
+          * @default ''
+         */
+        "mostSignificantClass"?: string;
+        "onMrdMerge"?: (event: MrdMergeViewCustomEvent<{ winnerHref: string; loserHref: string; patch: Record<string, unknown> }>) => void;
+        "onMrdSearch"?: (event: MrdMergeViewCustomEvent<{ query: string; basicType: string; mostSignificantClass?: string }>) => void;
+    }
     interface MrdNumberField {
         /**
           * @default ClientLayoutItemFieldDataType.INTEGER
@@ -2115,7 +2485,7 @@ declare namespace LocalJSX {
         /**
           * @default []
          */
-        "dropdownValues"?: ClientListValue[];
+        "dropdownValues"?: ClientListValue1[];
         "editBehavior"?: ClientLayoutItemRelationEditBehavior | null;
         /**
           * @default ''
@@ -2406,6 +2776,9 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "locale": string;
     }
+    interface MrdEmailViewAttributes {
+        "locale": string;
+    }
     interface MrdFieldAttributes {
         "locale": string;
     }
@@ -2417,6 +2790,7 @@ declare namespace LocalJSX {
         "locale": string;
         "accept": string;
         "maxSize": number;
+        "multiple": boolean;
     }
     interface MrdFormAttributes {
         "locale": string;
@@ -2441,6 +2815,10 @@ declare namespace LocalJSX {
         "locale": string;
         "accept": string;
         "maxSize": number;
+        "multiple": boolean;
+    }
+    interface MrdInvoiceViewAttributes {
+        "locale": string;
     }
     interface MrdLayoutSectionAttributes {
         "locale": string;
@@ -2463,6 +2841,13 @@ declare namespace LocalJSX {
         "disabled": boolean;
         "locale": string;
     }
+    interface MrdMergeViewAttributes {
+        "locale": string;
+        "basicType": string;
+        "mostSignificantClass": string;
+        "currentHref": string;
+        "currentLabel": string;
+    }
     interface MrdNumberFieldAttributes {
         "name": string;
         "label": string;
@@ -2542,14 +2927,17 @@ declare namespace LocalJSX {
         "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-email-view": Omit<MrdEmailView, keyof MrdEmailViewAttributes> & { [K in keyof MrdEmailView & keyof MrdEmailViewAttributes]?: MrdEmailView[K] } & { [K in keyof MrdEmailView & keyof MrdEmailViewAttributes as `attr:${K}`]?: MrdEmailViewAttributes[K] } & { [K in keyof MrdEmailView & keyof MrdEmailViewAttributes as `prop:${K}`]?: MrdEmailView[K] };
         "mrd-field": Omit<MrdField, keyof MrdFieldAttributes> & { [K in keyof MrdField & keyof MrdFieldAttributes]?: MrdField[K] } & { [K in keyof MrdField & keyof MrdFieldAttributes as `attr:${K}`]?: MrdFieldAttributes[K] } & { [K in keyof MrdField & keyof MrdFieldAttributes as `prop:${K}`]?: MrdField[K] };
         "mrd-file-field": Omit<MrdFileField, keyof MrdFileFieldAttributes> & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes]?: MrdFileField[K] } & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes as `attr:${K}`]?: MrdFileFieldAttributes[K] } & { [K in keyof MrdFileField & keyof MrdFileFieldAttributes as `prop:${K}`]?: MrdFileField[K] };
         "mrd-form": Omit<MrdForm, keyof MrdFormAttributes> & { [K in keyof MrdForm & keyof MrdFormAttributes]?: MrdForm[K] } & { [K in keyof MrdForm & keyof MrdFormAttributes as `attr:${K}`]?: MrdFormAttributes[K] } & { [K in keyof MrdForm & keyof MrdFormAttributes as `prop:${K}`]?: MrdForm[K] };
         "mrd-hyperlink-field": Omit<MrdHyperlinkField, keyof MrdHyperlinkFieldAttributes> & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes]?: MrdHyperlinkField[K] } & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes as `attr:${K}`]?: MrdHyperlinkFieldAttributes[K] } & { [K in keyof MrdHyperlinkField & keyof MrdHyperlinkFieldAttributes as `prop:${K}`]?: MrdHyperlinkField[K] };
         "mrd-image-field": Omit<MrdImageField, keyof MrdImageFieldAttributes> & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes]?: MrdImageField[K] } & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes as `attr:${K}`]?: MrdImageFieldAttributes[K] } & { [K in keyof MrdImageField & keyof MrdImageFieldAttributes as `prop:${K}`]?: MrdImageField[K] };
+        "mrd-invoice-view": Omit<MrdInvoiceView, keyof MrdInvoiceViewAttributes> & { [K in keyof MrdInvoiceView & keyof MrdInvoiceViewAttributes]?: MrdInvoiceView[K] } & { [K in keyof MrdInvoiceView & keyof MrdInvoiceViewAttributes as `attr:${K}`]?: MrdInvoiceViewAttributes[K] } & { [K in keyof MrdInvoiceView & keyof MrdInvoiceViewAttributes as `prop:${K}`]?: MrdInvoiceView[K] };
         "mrd-layout-section": Omit<MrdLayoutSection, keyof MrdLayoutSectionAttributes> & { [K in keyof MrdLayoutSection & keyof MrdLayoutSectionAttributes]?: MrdLayoutSection[K] } & { [K in keyof MrdLayoutSection & keyof MrdLayoutSectionAttributes as `attr:${K}`]?: MrdLayoutSectionAttributes[K] } & { [K in keyof MrdLayoutSection & keyof MrdLayoutSectionAttributes as `prop:${K}`]?: MrdLayoutSection[K] };
         "mrd-list-field": Omit<MrdListField, keyof MrdListFieldAttributes> & { [K in keyof MrdListField & keyof MrdListFieldAttributes]?: MrdListField[K] } & { [K in keyof MrdListField & keyof MrdListFieldAttributes as `attr:${K}`]?: MrdListFieldAttributes[K] } & { [K in keyof MrdListField & keyof MrdListFieldAttributes as `prop:${K}`]?: MrdListField[K] };
         "mrd-longtext-field": Omit<MrdLongtextField, keyof MrdLongtextFieldAttributes> & { [K in keyof MrdLongtextField & keyof MrdLongtextFieldAttributes]?: MrdLongtextField[K] } & { [K in keyof MrdLongtextField & keyof MrdLongtextFieldAttributes as `attr:${K}`]?: MrdLongtextFieldAttributes[K] } & { [K in keyof MrdLongtextField & keyof MrdLongtextFieldAttributes as `prop:${K}`]?: MrdLongtextField[K] };
+        "mrd-merge-view": Omit<MrdMergeView, keyof MrdMergeViewAttributes> & { [K in keyof MrdMergeView & keyof MrdMergeViewAttributes]?: MrdMergeView[K] } & { [K in keyof MrdMergeView & keyof MrdMergeViewAttributes as `attr:${K}`]?: MrdMergeViewAttributes[K] } & { [K in keyof MrdMergeView & keyof MrdMergeViewAttributes as `prop:${K}`]?: MrdMergeView[K] };
         "mrd-number-field": Omit<MrdNumberField, keyof MrdNumberFieldAttributes> & { [K in keyof MrdNumberField & keyof MrdNumberFieldAttributes]?: MrdNumberField[K] } & { [K in keyof MrdNumberField & keyof MrdNumberFieldAttributes as `attr:${K}`]?: MrdNumberFieldAttributes[K] } & { [K in keyof MrdNumberField & keyof MrdNumberFieldAttributes as `prop:${K}`]?: MrdNumberField[K] };
         "mrd-relation-field": Omit<MrdRelationField, keyof MrdRelationFieldAttributes> & { [K in keyof MrdRelationField & keyof MrdRelationFieldAttributes]?: MrdRelationField[K] } & { [K in keyof MrdRelationField & keyof MrdRelationFieldAttributes as `attr:${K}`]?: MrdRelationFieldAttributes[K] } & { [K in keyof MrdRelationField & keyof MrdRelationFieldAttributes as `prop:${K}`]?: MrdRelationField[K] };
         "mrd-secret-field": Omit<MrdSecretField, keyof MrdSecretFieldAttributes> & { [K in keyof MrdSecretField & keyof MrdSecretFieldAttributes]?: MrdSecretField[K] } & { [K in keyof MrdSecretField & keyof MrdSecretFieldAttributes as `attr:${K}`]?: MrdSecretFieldAttributes[K] } & { [K in keyof MrdSecretField & keyof MrdSecretFieldAttributes as `prop:${K}`]?: MrdSecretField[K] };
@@ -2612,14 +3000,52 @@ declare module "@stencil/core" {
              */
             "mrd-document-view": LocalJSX.IntrinsicElements["mrd-document-view"] & JSXBase.HTMLAttributes<HTMLMrdDocumentViewElement>;
             "mrd-email-field": LocalJSX.IntrinsicElements["mrd-email-field"] & JSXBase.HTMLAttributes<HTMLMrdEmailFieldElement>;
+            /**
+             * Archetype-driven single-email view. Given a `commons.email` binding and a data
+             * record, renders the message the way an Outlook printout would — subject, a
+             * compact From/To/CC/Date header block, the body and attachments — instead of a
+             * generic field form. Fully read-only: emails arrive through other channels (mail
+             * ingestion gateways), never edited here.
+             * Like `mrd-document-view`/`mrd-invoice-view`, this component never resolves file
+             * hrefs itself — it only exposes attachment references via `mrdAttachments` (an
+             * email can have several) and plain download buttons; the host decides how/whether
+             * to render them.
+             */
+            "mrd-email-view": LocalJSX.IntrinsicElements["mrd-email-view"] & JSXBase.HTMLAttributes<HTMLMrdEmailViewElement>;
             "mrd-field": LocalJSX.IntrinsicElements["mrd-field"] & JSXBase.HTMLAttributes<HTMLMrdFieldElement>;
             "mrd-file-field": LocalJSX.IntrinsicElements["mrd-file-field"] & JSXBase.HTMLAttributes<HTMLMrdFileFieldElement>;
             "mrd-form": LocalJSX.IntrinsicElements["mrd-form"] & JSXBase.HTMLAttributes<HTMLMrdFormElement>;
             "mrd-hyperlink-field": LocalJSX.IntrinsicElements["mrd-hyperlink-field"] & JSXBase.HTMLAttributes<HTMLMrdHyperlinkFieldElement>;
             "mrd-image-field": LocalJSX.IntrinsicElements["mrd-image-field"] & JSXBase.HTMLAttributes<HTMLMrdImageFieldElement>;
+            /**
+             * Archetype-driven single-invoice view. Given a `commons.invoice` binding and a data
+             * record, renders a clear, recognisable invoice summary — number, status, dates,
+             * customer/supplier, totals and attachments — instead of a generic field form.
+             * The line items (`lines` slot, the `commons.invoiceLine` sub-archetype) are NOT
+             * rendered here: this component only reserves a `slot="lines"` at the right spot in
+             * the layout. The host (`mrd-layout-section`) still owns all the actual RELATED_VIEW
+             * table data-loading/event wiring — via its existing `renderRelatedView()` — and
+             * projects the resulting `<mrd-table>` into that slot, so line editing keeps using
+             * the same generic create/edit-navigation mechanism every other relation already has.
+             * Like `mrd-document-view`, this component never resolves file hrefs itself — it only
+             * exposes the attachment references via `mrdAttachments` (now possibly more than one)
+             * and a plain download button; the host decides how/whether to render them.
+             */
+            "mrd-invoice-view": LocalJSX.IntrinsicElements["mrd-invoice-view"] & JSXBase.HTMLAttributes<HTMLMrdInvoiceViewElement>;
             "mrd-layout-section": LocalJSX.IntrinsicElements["mrd-layout-section"] & JSXBase.HTMLAttributes<HTMLMrdLayoutSectionElement>;
             "mrd-list-field": LocalJSX.IntrinsicElements["mrd-list-field"] & JSXBase.HTMLAttributes<HTMLMrdListFieldElement>;
             "mrd-longtext-field": LocalJSX.IntrinsicElements["mrd-longtext-field"] & JSXBase.HTMLAttributes<HTMLMrdLongtextFieldElement>;
+            /**
+             * Merges two DataObjects of the same basic type (FINDING-0114 / TASK-0177).
+             * Never performs network I/O itself: it emits `mrdSearch` (host searches and
+             * calls `setSearchResults()`, mirroring mrd-relation-field) and `mrdMerge`
+             * (host calls the merge endpoint — `POST {winnerHref}/merge` with
+             * `{ loser: loserHref, patch }`, per DataController.merge()).
+             * Has no exit/cancel affordance of its own — hosts show this inside their
+             * own overlay-page chrome (its close button), the same way mrd-layout-section
+             * never renders a page-level close button either.
+             */
+            "mrd-merge-view": LocalJSX.IntrinsicElements["mrd-merge-view"] & JSXBase.HTMLAttributes<HTMLMrdMergeViewElement>;
             "mrd-number-field": LocalJSX.IntrinsicElements["mrd-number-field"] & JSXBase.HTMLAttributes<HTMLMrdNumberFieldElement>;
             "mrd-relation-field": LocalJSX.IntrinsicElements["mrd-relation-field"] & JSXBase.HTMLAttributes<HTMLMrdRelationFieldElement>;
             "mrd-secret-field": LocalJSX.IntrinsicElements["mrd-secret-field"] & JSXBase.HTMLAttributes<HTMLMrdSecretFieldElement>;