@masterteam/client-components 0.0.84 → 0.0.86

package/fesm2022/masterteam-client-components-client-list.mjs

@@ -7,7 +7,7 @@ import { TranslocoService, TranslocoModule, TranslocoPipe } from '@jsverse/trans
 import { Button } from '@masterteam/components/button';
 import { RuntimeActionRunner, resolveActionLabel } from '@masterteam/components/runtime-action';
 import { HttpClient } from '@angular/common/http';
-import { switchMap, of, map, Observable, share, take } from 'rxjs';
+import { switchMap, map, of, Observable, share, take } from 'rxjs';
 import { resolveLocalizedLabel, serializeEntityRawValue, isSectionKey, EntitiesPreview } from '@masterteam/components/entities';
 import { Table, TableExportService, TableGroupingController, TableValueResolver, TableCaption } from '@masterteam/components/table';
 import * as i2 from 'primeng/skeleton';
@@ -23,22 +23,65 @@ import * as i3 from 'primeng/popover';
 import { PopoverModule } from 'primeng/popover';
 import { DashboardViewer } from '@masterteam/dashboard-builder';
 
-const DEFAULT_INCLUDE_STATE = ['escalation'];
+const CLIENT_LIST_RECORD_STATE_KEY = '__clientListRecordState';
+/** Record state every list request asks for. */
+const CLIENT_LIST_DEFAULT_INCLUDE_STATE = ['escalation'];
+/**
+ * `fetch/query` filter key that selects a single record by its own id. Reading
+ * one record back after a write filters on this, never on the list's scope
+ * filters alone — those match a whole page, not the row that just changed.
+ */
+const CLIENT_LIST_RECORD_ID_FILTER_KEY = 'id';
+
+const DEFAULT_INCLUDE_STATE = CLIENT_LIST_DEFAULT_INCLUDE_STATE;
 class ClientListApiService {
     http = inject(HttpClient);
     runtimeFetchBaseUrl = 'fetch/query';
     informativeBaseUrl = 'LevelData';
+    /**
+     * Fetches a table page. Resolves to the response **and** the `propertyKeys`
+     * the request carried, because a write that wants its record projected the
+     * same way has to repeat them and cannot recover them from the response.
+     */
     getRows(contextKey, query, filters = []) {
-        return this.resolveTablePropertyKeys(contextKey, query).pipe(switchMap((propertyKeys) => this.queryRuntime({
+        return this.resolveTablePropertyKeys(contextKey, query).pipe(switchMap((resolvedKeys) => {
+            const propertyKeys = resolvedKeys?.length ? resolvedKeys : undefined;
+            return this.queryRuntime({
+                contextKey,
+                projection: 'Table',
+                surfaceKey: 'table',
+                includeState: [...DEFAULT_INCLUDE_STATE],
+                propertyKeys,
+                filters,
+                page: this.toPage(query.skip, query.take),
+                pageSize: query.take,
+            }).pipe(map((response) => ({ response, propertyKeys })));
+        }));
+    }
+    /**
+     * Reads a single record back with the list's own query settings — the path
+     * taken when a write reports `recordProjectionStatus: 'Unavailable'`. The
+     * write itself already succeeded; this only reads, and must never be served
+     * by re-submitting.
+     */
+    getRecord(contextKey, request, filters) {
+        return this.queryRuntime({
             contextKey,
-            projection: 'Table',
-            surfaceKey: 'table',
-            includeState: [...DEFAULT_INCLUDE_STATE],
-            propertyKeys: propertyKeys?.length ? propertyKeys : undefined,
+            projection: request.projection,
+            surfaceKey: request.surfaceKey,
+            includeState: request.includeState
+                ? [...request.includeState]
+                : [...DEFAULT_INCLUDE_STATE],
+            propertyKeys: request.propertyKeys?.length
+                ? request.propertyKeys
+                : undefined,
             filters,
-            page: this.toPage(query.skip, query.take),
-            pageSize: query.take,
-        })));
+            page: 1,
+            pageSize: 1,
+            ...(request.projection === 'Card'
+                ? { display: { areas: ['card'] } }
+                : {}),
+        });
     }
     getCards(contextKey, filters = [], skip, take) {
         // `page` and `pageSize` must be sent together or not at all (fetch/query
@@ -108,8 +151,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
             args: [{ providedIn: 'root' }]
         }] });
 
-const CLIENT_LIST_RECORD_STATE_KEY = '__clientListRecordState';
-
 const UNSORTABLE_ENTITY_VIEW_TYPES = new Set([
     'Attachment',
     'Checkbox',
@@ -306,6 +347,146 @@ class ClientListStateService {
             },
         });
     }
+    /**
+     * Splices a canonical record into the data the list already holds, so a
+     * create or update lands without re-fetching the page.
+     *
+     * Tables replay the whole page through {@link setRowsResult}: for a table
+     * the rendered page *is* the raw response, so replaying it keeps the catalog
+     * lookup, the column build and the host `transformResult` hook on exactly
+     * one code path — a second mapper for single rows would drift from the one
+     * that built the rest of the table. Cards cannot replay: with infinite
+     * scroll `rawData` holds only the last page while `cards` holds every page,
+     * so a single card is built and merged into the accumulated set instead.
+     *
+     * Returns `false` when there is nothing to splice into — an informative
+     * dashboard, or a list that never completed a load. The caller then falls
+     * back to a real fetch rather than inventing state.
+     */
+    upsertRecord(key, record, config) {
+        const target = this.itemsByKey()[key];
+        if (!target || target.type !== 'form')
+            return false;
+        const raw = target.rawData;
+        if (!raw)
+            return false;
+        return target.areaType === 'cards'
+            ? this.upsertCardRecord(key, target, raw, record)
+            : this.upsertRowRecord(key, target, raw, record, config);
+    }
+    /**
+     * Drops a record the backend has deleted, without re-fetching. Returns
+     * `false` when the record is not in the loaded set, so the caller can decide
+     * whether a reload is warranted.
+     */
+    removeRecord(key, recordId, config) {
+        const target = this.itemsByKey()[key];
+        if (!target || target.type !== 'form')
+            return false;
+        const raw = target.rawData;
+        if (!raw)
+            return false;
+        const records = (raw.records ?? []).filter((item) => item.id !== recordId);
+        if (target.areaType === 'cards') {
+            const cards = target.cards.filter((card) => card.id !== recordId);
+            if (cards.length === target.cards.length)
+                return false;
+            this.patchItem(key, {
+                ...target,
+                cards,
+                totalCount: Math.max(0, target.totalCount - 1),
+                error: null,
+                rawData: this.withRecords(raw, records, -1),
+            });
+            return true;
+        }
+        if (records.length === (raw.records ?? []).length)
+            return false;
+        this.setRowsResult(key, this.withRecords(raw, records, -1), config, target.skip, target.take);
+        return true;
+    }
+    upsertRowRecord(key, target, raw, record, config) {
+        // No columns means no completed table load to splice into.
+        if (!target.columns.length)
+            return false;
+        const records = [...(raw.records ?? [])];
+        const index = records.findIndex((item) => item.id === record.id);
+        if (index >= 0) {
+            records[index] = this.mergeRecord(records[index], record);
+        }
+        else {
+            // The backend owns the real ordering and does not say where the new
+            // record landed, so it goes to the top of the page in view: the user
+            // has to see what they just created. The next real load puts it in its
+            // true place.
+            records.unshift(record);
+            // Keep the page the size the paginator promises — the row pushed off
+            // the end now lives on the next page.
+            if (config.isPaginated &&
+                target.take > 0 &&
+                records.length > target.take) {
+                records.length = target.take;
+            }
+        }
+        this.setRowsResult(key, this.withRecords(raw, records, index >= 0 ? 0 : 1), config, target.skip, target.take);
+        return true;
+    }
+    upsertCardRecord(key, target, raw, record) {
+        if (!raw.projectionMeta)
+            return false;
+        const previous = (raw.records ?? []).find((item) => item.id === record.id);
+        const merged = previous ? this.mergeRecord(previous, record) : record;
+        const [card] = this.toCards({ ...raw, records: [merged] });
+        if (!card)
+            return false;
+        const index = target.cards.findIndex((item) => item.id === card.id);
+        const isInsert = index < 0;
+        const cards = isInsert
+            ? [card, ...target.cards]
+            : target.cards.map((item, position) => position === index ? card : item);
+        const records = [...(raw.records ?? [])];
+        const recordIndex = records.findIndex((item) => item.id === merged.id);
+        if (recordIndex >= 0)
+            records[recordIndex] = merged;
+        else
+            records.unshift(merged);
+        this.patchItem(key, {
+            ...target,
+            cards,
+            totalCount: isInsert ? target.totalCount + 1 : target.totalCount,
+            error: null,
+            rawData: this.withRecords(raw, records, isInsert ? 1 : 0),
+        });
+        return true;
+    }
+    /**
+     * Overlays the written record on the one being replaced, key by key. A
+     * cleared property comes back explicitly (`{ raw: null, value: null }`) and
+     * overwrites; only a key the backend left out entirely keeps its previous
+     * cell, which beats blanking a value that did not actually change.
+     */
+    mergeRecord(previous, next) {
+        return {
+            ...previous,
+            ...next,
+            values: { ...previous.values, ...next.values },
+        };
+    }
+    withRecords(raw, records, totalCountDelta) {
+        return {
+            ...raw,
+            records,
+            pagination: raw.pagination
+                ? {
+                    ...raw.pagination,
+                    totalCount: Math.max(0, raw.pagination.totalCount + totalCountDelta),
+                }
+                : raw.pagination,
+        };
+    }
+    patchItem(key, next) {
+        this.itemsByKey.set({ ...this.itemsByKey(), [key]: next });
+    }
     /**
      * Appends `next` to `current`, dropping any card whose id is already
      * present. Ids are the grid's `@for` track key, so duplicates are a runtime
@@ -1618,7 +1799,7 @@ class ClientListCardsView {
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: ClientListCardsView, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: ClientListCardsView, isStandalone: true, selector: "mt-client-list-cards-view", inputs: { state: { classPropertyName: "state", publicName: "state", isSignal: true, isRequired: true, transformFunction: null }, rowActions: { classPropertyName: "rowActions", publicName: "rowActions", isSignal: true, isRequired: false, transformFunction: null }, rowActionsLoadingFn: { classPropertyName: "rowActionsLoadingFn", publicName: "rowActionsLoadingFn", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { lazyLoad: "lazyLoad", loadMore: "loadMore", cardClick: "cardClick", rowActionsRequested: "rowActionsRequested" }, providers: [MTDateFormatPipe], viewQueries: [{ propertyName: "loadMoreSentinel", first: true, predicate: ["loadMoreSentinel"], descendants: true, isSignal: true }], ngImport: i0, template: "<mt-table-caption\n  [generalSearch]=\"true\"\n  [showFilters]=\"true\"\n  filterMode=\"popover\"\n  [printable]=\"true\"\n  [groupable]=\"true\"\n  [exportable]=\"true\"\n  [columns]=\"columns()\"\n  [data]=\"rowRepresentations()\"\n  [groupColumns]=\"grouping.groupableColumns()\"\n  [actions]=\"toolbarActions()\"\n  [captionStart]=\"cardsState().config.toolbarStart ?? null\"\n  [captionEnd]=\"cardsState().config.toolbarEnd ?? null\"\n  [filters]=\"bucket().filters()\"\n  (filtersChange)=\"bucket().filters.set($event)\"\n  [filterTerm]=\"bucket().filterTerm()\"\n  (filterTermChange)=\"bucket().filterTerm.set($event)\"\n  [groupBy]=\"bucket().groupBy()\"\n  (groupByChange)=\"bucket().groupBy.set($event)\"\n  [activeTab]=\"bucket().activeTab()\"\n  (activeTabChange)=\"bucket().activeTab.set($event)\"\n  (exportRequested)=\"exportExcel()\"\n  (printRequested)=\"printPdf()\"\n/>\n\n@if (badgeLegend().length > 0) {\n  <!--\n    Decodes the coloured count pills on the cards below. Rendered once for the\n    whole board rather than per card, so it costs one line of vertical space\n    instead of repeating a key inside every tile (finding M-04).\n  -->\n  <div\n    class=\"mb-3 flex flex-wrap items-center gap-x-4 gap-y-2 px-1\"\n    role=\"list\"\n    [attr.aria-label]=\"\n      'components.clientComponents.list.badgeLegend' | transloco\n    \"\n  >\n    <span class=\"text-xs font-medium text-gray-500 dark:text-gray-400\">\n      {{ \"components.clientComponents.list.badgeLegend\" | transloco }}\n    </span>\n    @for (entry of badgeLegend(); track entry.key) {\n      <span class=\"flex items-center gap-1.5\" role=\"listitem\">\n        <span\n          class=\"inline-flex h-4 min-w-4 items-center justify-center rounded text-[10px] font-bold\"\n          [style.background-color]=\"entry.color\"\n          [style.color]=\"entry.textColor\"\n          aria-hidden=\"true\"\n        >\n          #\n        </span>\n        <span class=\"text-xs text-gray-600 dark:text-gray-300\">{{\n          entry.label\n        }}</span>\n      </span>\n    }\n  </div>\n}\n\n@if (cardsState().loading && cardsState().cards.length === 0) {\n  <div class=\"mt-cards-grid\">\n    @for (i of [1, 2, 3, 4, 5, 6]; track i) {\n      <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n    }\n  </div>\n} @else if (cardsState().error) {\n  <div class=\"rounded-lg border border-red-200 bg-red-50 p-6 text-red-600\">\n    {{ cardsState().error }}\n  </div>\n} @else if (visibleCards().length === 0) {\n  <!--\n    The same empty state the tables use, so a board and a list stop looking like\n    two products (finding H-12). A board narrowed by a search or a filter says\n    so and offers to clear it, instead of the bare grey \"No cards found.\"\n  -->\n  <mt-empty-state\n    [variant]=\"hasActiveCardFilters() ? 'filtered' : 'empty'\"\n    [title]=\"\n      hasActiveCardFilters()\n        ? ''\n        : ('components.clientComponents.list.noCardsFound' | transloco)\n    \"\n    [actionLabel]=\"\n      hasActiveCardFilters()\n        ? ('components.emptyState.clearFilters' | transloco)\n        : ''\n    \"\n    actionIcon=\"general.x-close\"\n    (actionClick)=\"clearCardFilters()\"\n  />\n} @else if (grouping.groupingActive()) {\n  <div class=\"flex flex-col gap-6\">\n    @for (group of groupedCards(); track group.key) {\n      <section class=\"flex flex-col gap-3\">\n        <header\n          class=\"flex items-center gap-3 px-2 py-2 bg-surface-50 dark:bg-surface-900 border-y border-surface-200 dark:border-surface-700 rounded\"\n          [style.--mt-group-accent]=\"group.accent ?? 'var(--p-primary-color)'\"\n        >\n          <span\n            class=\"inline-block w-1 h-5 rounded-full\"\n            [style.background]=\"'var(--mt-group-accent)'\"\n          ></span>\n          <span\n            class=\"text-xs uppercase tracking-wide text-gray-500 dark:text-gray-400\"\n          >\n            {{ group.columnLabel }}\n          </span>\n          <span class=\"text-sm font-semibold text-gray-900 dark:text-gray-100\">\n            {{ group.label }}\n          </span>\n          <span\n            class=\"ml-auto inline-flex items-center gap-1 text-xs px-2 py-0.5 rounded-full bg-primary-50 text-primary-700 dark:bg-primary-950 dark:text-primary-300\"\n          >\n            {{ group.count }}\n          </span>\n        </header>\n        <div class=\"mt-cards-grid\">\n          @for (card of group.cards; track card.id) {\n            <mt-card\n              class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n              (click)=\"cardClick.emit(card)\"\n            >\n              <ng-template #headless>\n                <ng-container\n                  [ngTemplateOutlet]=\"cardActionsMenu\"\n                  [ngTemplateOutletContext]=\"{ $implicit: card }\"\n                />\n                <mt-entities-preview\n                  [entities]=\"card.entities\"\n                  attachmentShape=\"compact\"\n                  [stackOnNarrow]=\"false\"\n                  [clickableKeys]=\"clickableEntityKeys()\"\n                  [activeKeys]=\"activeKeysForCard(card)\"\n                  [clickableTooltip]=\"filterByThisLabel()\"\n                  [activeTooltip]=\"clearFilterLabel()\"\n                  (entityClick)=\"onEntityFilterClick(card, $event)\"\n                />\n              </ng-template>\n            </mt-card>\n          }\n        </div>\n      </section>\n    }\n  </div>\n} @else {\n  <div class=\"mt-cards-grid\">\n    @for (card of visibleCards(); track card.id) {\n      @defer (on viewport) {\n        <mt-card\n          class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n          (click)=\"cardClick.emit(card)\"\n        >\n          <ng-template #headless>\n            <ng-container\n              [ngTemplateOutlet]=\"cardActionsMenu\"\n              [ngTemplateOutletContext]=\"{ $implicit: card }\"\n            />\n            <mt-entities-preview\n              [entities]=\"card.entities\"\n              attachmentShape=\"compact\"\n              [stackOnNarrow]=\"false\"\n              [clickableKeys]=\"clickableEntityKeys()\"\n              [activeKeys]=\"activeKeysForCard(card)\"\n              [clickableTooltip]=\"filterByThisLabel()\"\n              [activeTooltip]=\"clearFilterLabel()\"\n              (entityClick)=\"onEntityFilterClick(card, $event)\"\n            />\n          </ng-template>\n        </mt-card>\n      } @placeholder {\n        <div class=\"min-h-[20rem]\">\n          <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n        </div>\n      }\n    }\n  </div>\n}\n\n<!--\n  Infinite-scroll trigger. Deliberately outside the @if/@else chain above:\n  inside it the element would be torn down and rebuilt every time the view\n  swapped branch (error, empty filter result, group-by), and the observer\n  would be left watching a detached node. Kept in the DOM and hidden via CSS\n  when there is nothing left to load, so appending a page never recreates it.\n  It also has to sit outside so infinite scroll keeps working while a\n  group-by is active \u2014 grouping is a pure FE view over whatever has been\n  fetched, not a reason to stop fetching.\n-->\n<div\n  #loadMoreSentinel\n  class=\"mt-cards-grid py-4\"\n  [class.hidden]=\"!hasMoreCards()\"\n>\n  @for (i of [1, 2, 3]; track i) {\n    <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n  }\n</div>\n\n<!--\n  Per-card escalation marker and 3-dots actions menu. The compact corner cover\n  only indicates active escalation state; its preview action lives in the menu\n  so the marker never displaces or competes with the menu trigger.\n-->\n<ng-template #cardActionsMenu let-card>\n  @let escalationAction = escalationMarkerAction(card);\n  @if (escalationAction) {\n    <span\n      class=\"mt-escalation-marker absolute end-0 top-0 z-10 h-[18px] w-[20px]\"\n      role=\"img\"\n      tabindex=\"0\"\n      [attr.aria-label]=\"escalationLabel()\"\n      [mtTooltip]=\"escalationLabel()\"\n      tooltipPosition=\"top\"\n    ></span>\n  }\n  @if (rowActions().length > 0) {\n    <div\n      class=\"absolute end-2 top-2 z-20 flex items-center gap-1\"\n      (click)=\"$event.stopPropagation()\"\n    >\n      @for (action of inlineActionsForCard(card); track $index) {\n        <mt-button\n          [icon]=\"action.icon\"\n          [severity]=\"action.color\"\n          [variant]=\"action.variant\"\n          [size]=\"actionSize(action) || 'small'\"\n          [tooltip]=\"action.tooltip\"\n          [label]=\"action.label\"\n          [loading]=\"resolveActionLoading(action, card)\"\n          (onClick)=\"runCardAction($event, action, card)\"\n        />\n      }\n      @if (showCardActionsMenu(card)) {\n        <button\n          type=\"button\"\n          class=\"flex h-7 w-7 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-0 text-base text-gray-500 transition-colors hover:bg-gray-100 hover:text-gray-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-500 dark:text-gray-300 dark:hover:bg-surface-700 dark:hover:text-gray-100\"\n          [attr.aria-label]=\"actionsLabel()\"\n          [mtTooltip]=\"actionsLabel()\"\n          tooltipPosition=\"top\"\n          (click)=\"onCardActionsToggle($event, cardPopover, card)\"\n        >\n          <mt-icon icon=\"general.dots-vertical\" class=\"text-base\" />\n        </button>\n        <p-popover #cardPopover appendTo=\"body\">\n          <div class=\"flex min-w-44 flex-col gap-1 p-1\">\n            @if (isCardActionsLoading(card)) {\n              <div class=\"flex flex-col gap-2 p-1\">\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n              </div>\n            } @else {\n              @for (action of menuActionsForCard(card); track $index) {\n                @if (isFirstDestructiveCardAction(card, $index)) {\n                  <hr\n                    class=\"my-1 border-0 border-t border-surface-200 dark:border-surface-700\"\n                  />\n                }\n                <button\n                  type=\"button\"\n                  class=\"flex cursor-pointer items-center gap-2 rounded px-2 py-2 text-start text-sm transition-colors\"\n                  [class]=\"\n                    action.color === 'danger'\n                      ? 'text-red-600 hover:bg-red-50 dark:hover:bg-red-950'\n                      : action.color === 'warn'\n                        ? 'text-orange-600 hover:bg-orange-50 dark:text-orange-400 dark:hover:bg-orange-950'\n                        : 'text-gray-700 hover:bg-gray-100 dark:text-gray-200 dark:hover:bg-surface-700'\n                  \"\n                  (click)=\"\n                    runCardAction($event, action, card); cardPopover.hide()\n                  \"\n                >\n                  @if (action.icon) {\n                    <mt-icon [icon]=\"action.icon\" class=\"text-base\" />\n                  }\n                  <span>{{ action.label || action.tooltip }}</span>\n                </button>\n              }\n            }\n          </div>\n        </p-popover>\n      }\n    </div>\n  }\n</ng-template>\n", styles: [".mt-cards-grid{--mt-cards-gap: 1.25rem;--mt-cards-min: 380px;--mt-cards-track: max( var(--mt-cards-min), (100% - 4 * var(--mt-cards-gap)) / 5 );display:grid;gap:var(--mt-cards-gap);grid-template-columns:repeat(auto-fill,minmax(min(100%,var(--mt-cards-track)),1fr))}.mt-cards-grid.hidden,.mt-cards-grid[hidden]{display:none}.mt-escalation-marker{border-start-end-radius:.5rem;background:var(--p-button-text-warn-color, var(--p-orange-500, #f59e0b));clip-path:polygon(0 0,100% 0,100% 100%);transition:filter .15s ease}.mt-escalation-marker:dir(rtl){clip-path:polygon(0 0,100% 0,0 100%)}.mt-escalation-marker:hover{filter:brightness(.92)}.mt-escalation-marker:focus-visible{filter:brightness(.92) drop-shadow(0 0 2px var(--p-button-text-warn-color, #f59e0b));outline:none}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "ngmodule", type: TranslocoModule }, { kind: "component", type: Card, selector: "mt-card", inputs: ["class", "title", "paddingless"] }, { kind: "component", type: Button, selector: "mt-button", inputs: ["icon", "label", "tooltip", "class", "type", "styleClass", "severity", "badge", "variant", "badgeSeverity", "size", "iconPos", "autofocus", "fluid", "raised", "rounded", "text", "plain", "outlined", "link", "disabled", "loading", "pInputs", "ariaLabel"], outputs: ["onClick", "onFocus", "onBlur"] }, { kind: "directive", type: Tooltip, selector: "[mtTooltip]" }, { kind: "component", type: Icon, selector: "mt-icon", inputs: ["icon"] }, { kind: "component", type: EntitiesPreview, selector: "mt-entities-preview", inputs: ["entities", "attachmentShape", "stackOnNarrow", "clickableKeys", "activeKeys", "clickableTooltip", "activeTooltip"], outputs: ["entityClick"] }, { kind: "ngmodule", type: SkeletonModule }, { kind: "component", type: i2.Skeleton, selector: "p-skeleton", inputs: ["styleClass", "shape", "animation", "borderRadius", "size", "width", "height"] }, { kind: "ngmodule", type: PopoverModule }, { kind: "component", type: i3.Popover, selector: "p-popover", inputs: ["ariaLabel", "ariaLabelledBy", "dismissable", "style", "styleClass", "appendTo", "autoZIndex", "ariaCloseLabel", "baseZIndex", "focusOnShow", "showTransitionOptions", "hideTransitionOptions", "motionOptions"], outputs: ["onShow", "onHide"] }, { kind: "component", type: TableCaption, selector: "mt-table-caption", inputs: ["generalSearch", "showFilters", "filterMode", "exportable", "printable", "groupable", "columns", "data", "groupColumns", "tabs", "tabsOptionLabel", "tabsOptionValue", "actions", "captionStart", "captionEnd", "activeTab", "filters", "filterTerm", "groupBy"], outputs: ["activeTabChange", "filtersChange", "filterTermChange", "groupByChange", "exportRequested", "printRequested", "onTabChange", "searchChange", "filterApplied", "filterReset"] }, { kind: "component", type: EmptyState, selector: "mt-empty-state", inputs: ["variant", "illustration", "title", "description", "actionLabel", "actionIcon"], outputs: ["actionClick"] }, { kind: "pipe", type: i4.TranslocoPipe, name: "transloco" }], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [i1.NgTemplateOutlet, Card,
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: ClientListCardsView, isStandalone: true, selector: "mt-client-list-cards-view", inputs: { state: { classPropertyName: "state", publicName: "state", isSignal: true, isRequired: true, transformFunction: null }, rowActions: { classPropertyName: "rowActions", publicName: "rowActions", isSignal: true, isRequired: false, transformFunction: null }, rowActionsLoadingFn: { classPropertyName: "rowActionsLoadingFn", publicName: "rowActionsLoadingFn", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { lazyLoad: "lazyLoad", loadMore: "loadMore", cardClick: "cardClick", rowActionsRequested: "rowActionsRequested" }, providers: [MTDateFormatPipe], viewQueries: [{ propertyName: "loadMoreSentinel", first: true, predicate: ["loadMoreSentinel"], descendants: true, isSignal: true }], ngImport: i0, template: "<mt-table-caption\n  [generalSearch]=\"true\"\n  [showFilters]=\"true\"\n  filterMode=\"popover\"\n  [printable]=\"true\"\n  [groupable]=\"true\"\n  [exportable]=\"true\"\n  [columns]=\"columns()\"\n  [data]=\"rowRepresentations()\"\n  [groupColumns]=\"grouping.groupableColumns()\"\n  [actions]=\"toolbarActions()\"\n  [captionStart]=\"cardsState().config.toolbarStart ?? null\"\n  [captionEnd]=\"cardsState().config.toolbarEnd ?? null\"\n  [filters]=\"bucket().filters()\"\n  (filtersChange)=\"bucket().filters.set($event)\"\n  [filterTerm]=\"bucket().filterTerm()\"\n  (filterTermChange)=\"bucket().filterTerm.set($event)\"\n  [groupBy]=\"bucket().groupBy()\"\n  (groupByChange)=\"bucket().groupBy.set($event)\"\n  [activeTab]=\"bucket().activeTab()\"\n  (activeTabChange)=\"bucket().activeTab.set($event)\"\n  (exportRequested)=\"exportExcel()\"\n  (printRequested)=\"printPdf()\"\n/>\n\n@if (badgeLegend().length > 0) {\n  <!--\n    Decodes the coloured count pills on the cards below. Rendered once for the\n    whole board rather than per card, so it costs one line of vertical space\n    instead of repeating a key inside every tile (finding M-04).\n  -->\n  <div\n    class=\"mb-3 flex flex-wrap items-center gap-x-4 gap-y-2 px-1\"\n    role=\"list\"\n    [attr.aria-label]=\"\n      'components.clientComponents.list.badgeLegend' | transloco\n    \"\n  >\n    <span class=\"text-xs font-medium text-gray-500 dark:text-gray-400\">\n      {{ \"components.clientComponents.list.badgeLegend\" | transloco }}\n    </span>\n    @for (entry of badgeLegend(); track entry.key) {\n      <span class=\"flex items-center gap-1.5\" role=\"listitem\">\n        <span\n          class=\"inline-flex h-4 min-w-4 items-center justify-center rounded text-[10px] font-bold\"\n          [style.background-color]=\"entry.color\"\n          [style.color]=\"entry.textColor\"\n          aria-hidden=\"true\"\n        >\n          #\n        </span>\n        <span class=\"text-xs text-gray-600 dark:text-gray-300\">{{\n          entry.label\n        }}</span>\n      </span>\n    }\n  </div>\n}\n\n@if (cardsState().loading && cardsState().cards.length === 0) {\n  <div class=\"mt-cards-grid\">\n    @for (i of [1, 2, 3, 4, 5, 6]; track i) {\n      <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n    }\n  </div>\n} @else if (cardsState().error) {\n  <div class=\"rounded-lg border border-red-200 bg-red-50 p-6 text-red-600\">\n    {{ cardsState().error }}\n  </div>\n} @else if (visibleCards().length === 0) {\n  <!--\n    The same empty state the tables use, so a board and a list stop looking like\n    two products (finding H-12). A board narrowed by a search or a filter says\n    so and offers to clear it, instead of the bare grey \"No cards found.\"\n  -->\n  <mt-empty-state\n    [variant]=\"hasActiveCardFilters() ? 'filtered' : 'empty'\"\n    [title]=\"\n      hasActiveCardFilters()\n        ? ''\n        : ('components.clientComponents.list.noCardsFound' | transloco)\n    \"\n    [actionLabel]=\"\n      hasActiveCardFilters()\n        ? ('components.emptyState.clearFilters' | transloco)\n        : ''\n    \"\n    actionIcon=\"general.x-close\"\n    (actionClick)=\"clearCardFilters()\"\n  />\n} @else if (grouping.groupingActive()) {\n  <div class=\"flex flex-col gap-6\">\n    @for (group of groupedCards(); track group.key) {\n      <section class=\"flex flex-col gap-3\">\n        <header\n          class=\"flex items-center gap-3 px-2 py-2 bg-surface-50 dark:bg-surface-900 border-y border-surface-200 dark:border-surface-700 rounded\"\n          [style.--mt-group-accent]=\"group.accent ?? 'var(--p-primary-color)'\"\n        >\n          <span\n            class=\"inline-block w-1 h-5 rounded-full\"\n            [style.background]=\"'var(--mt-group-accent)'\"\n          ></span>\n          <span\n            class=\"text-xs uppercase tracking-wide text-gray-500 dark:text-gray-400\"\n          >\n            {{ group.columnLabel }}\n          </span>\n          <span class=\"text-sm font-semibold text-gray-900 dark:text-gray-100\">\n            {{ group.label }}\n          </span>\n          <span\n            class=\"ml-auto inline-flex items-center gap-1 text-xs px-2 py-0.5 rounded-full bg-primary-50 text-primary-700 dark:bg-primary-950 dark:text-primary-300\"\n          >\n            {{ group.count }}\n          </span>\n        </header>\n        <div class=\"mt-cards-grid\">\n          @for (card of group.cards; track card.id) {\n            <mt-card\n              class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n              (click)=\"cardClick.emit(card)\"\n            >\n              <ng-template #headless>\n                <ng-container\n                  [ngTemplateOutlet]=\"cardActionsMenu\"\n                  [ngTemplateOutletContext]=\"{ $implicit: card }\"\n                />\n                <mt-entities-preview\n                  [entities]=\"card.entities\"\n                  attachmentShape=\"compact\"\n                  [stackOnNarrow]=\"false\"\n                  [clickableKeys]=\"clickableEntityKeys()\"\n                  [activeKeys]=\"activeKeysForCard(card)\"\n                  [clickableTooltip]=\"filterByThisLabel()\"\n                  [activeTooltip]=\"clearFilterLabel()\"\n                  (entityClick)=\"onEntityFilterClick(card, $event)\"\n                />\n              </ng-template>\n            </mt-card>\n          }\n        </div>\n      </section>\n    }\n  </div>\n} @else {\n  <div class=\"mt-cards-grid\">\n    @for (card of visibleCards(); track card.id) {\n      @defer (on viewport) {\n        <mt-card\n          class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n          (click)=\"cardClick.emit(card)\"\n        >\n          <ng-template #headless>\n            <ng-container\n              [ngTemplateOutlet]=\"cardActionsMenu\"\n              [ngTemplateOutletContext]=\"{ $implicit: card }\"\n            />\n            <mt-entities-preview\n              [entities]=\"card.entities\"\n              attachmentShape=\"compact\"\n              [stackOnNarrow]=\"false\"\n              [clickableKeys]=\"clickableEntityKeys()\"\n              [activeKeys]=\"activeKeysForCard(card)\"\n              [clickableTooltip]=\"filterByThisLabel()\"\n              [activeTooltip]=\"clearFilterLabel()\"\n              (entityClick)=\"onEntityFilterClick(card, $event)\"\n            />\n          </ng-template>\n        </mt-card>\n      } @placeholder {\n        <div class=\"min-h-[20rem]\">\n          <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n        </div>\n      }\n    }\n  </div>\n}\n\n<!--\n  Infinite-scroll trigger. Deliberately outside the @if/@else chain above:\n  inside it the element would be torn down and rebuilt every time the view\n  swapped branch (error, empty filter result, group-by), and the observer\n  would be left watching a detached node. Kept in the DOM and hidden via CSS\n  when there is nothing left to load, so appending a page never recreates it.\n  It also has to sit outside so infinite scroll keeps working while a\n  group-by is active \u2014 grouping is a pure FE view over whatever has been\n  fetched, not a reason to stop fetching.\n-->\n<div\n  #loadMoreSentinel\n  class=\"mt-cards-grid py-4\"\n  [class.hidden]=\"!hasMoreCards()\"\n>\n  @for (i of [1, 2, 3]; track i) {\n    <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n  }\n</div>\n\n<!--\n  Per-card escalation marker and 3-dots actions menu. The compact corner cover\n  only indicates active escalation state; its preview action lives in the menu\n  so the marker never displaces or competes with the menu trigger.\n-->\n<ng-template #cardActionsMenu let-card>\n  @let escalationAction = escalationMarkerAction(card);\n  @if (escalationAction) {\n    <span\n      class=\"mt-escalation-marker absolute end-0 top-0 z-10 h-[18px] w-[20px]\"\n      role=\"img\"\n      tabindex=\"0\"\n      [attr.aria-label]=\"escalationLabel()\"\n      [mtTooltip]=\"escalationLabel()\"\n      tooltipPosition=\"top\"\n    ></span>\n  }\n  @if (rowActions().length > 0) {\n    <div\n      class=\"absolute end-2 top-2 z-20 flex items-center gap-1\"\n      (click)=\"$event.stopPropagation()\"\n    >\n      @for (action of inlineActionsForCard(card); track $index) {\n        <mt-button\n          [icon]=\"action.icon\"\n          [severity]=\"action.color\"\n          [variant]=\"action.variant\"\n          [size]=\"actionSize(action) || 'small'\"\n          [tooltip]=\"action.tooltip\"\n          [label]=\"action.label\"\n          [loading]=\"resolveActionLoading(action, card)\"\n          (onClick)=\"runCardAction($event, action, card)\"\n        />\n      }\n      @if (showCardActionsMenu(card)) {\n        <button\n          type=\"button\"\n          class=\"flex h-7 w-7 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-0 text-base text-gray-500 transition-colors hover:bg-gray-100 hover:text-gray-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-500 dark:text-gray-300 dark:hover:bg-surface-700 dark:hover:text-gray-100\"\n          [attr.aria-label]=\"actionsLabel()\"\n          [mtTooltip]=\"actionsLabel()\"\n          tooltipPosition=\"top\"\n          (click)=\"onCardActionsToggle($event, cardPopover, card)\"\n        >\n          <mt-icon icon=\"general.dots-vertical\" class=\"text-base\" />\n        </button>\n        <p-popover #cardPopover appendTo=\"body\">\n          <div class=\"flex min-w-44 flex-col gap-1 p-1\">\n            @if (isCardActionsLoading(card)) {\n              <div class=\"flex flex-col gap-2 p-1\">\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n              </div>\n            } @else {\n              @for (action of menuActionsForCard(card); track $index) {\n                @if (isFirstDestructiveCardAction(card, $index)) {\n                  <hr\n                    class=\"my-1 border-0 border-t border-surface-200 dark:border-surface-700\"\n                  />\n                }\n                <button\n                  type=\"button\"\n                  class=\"flex cursor-pointer items-center gap-2 rounded px-2 py-2 text-start text-sm transition-colors\"\n                  [class]=\"\n                    action.color === 'danger'\n                      ? 'text-red-600 hover:bg-red-50 dark:hover:bg-red-950'\n                      : action.color === 'warn'\n                        ? 'text-orange-600 hover:bg-orange-50 dark:text-orange-400 dark:hover:bg-orange-950'\n                        : 'text-gray-700 hover:bg-gray-100 dark:text-gray-200 dark:hover:bg-surface-700'\n                  \"\n                  (click)=\"\n                    runCardAction($event, action, card); cardPopover.hide()\n                  \"\n                >\n                  @if (action.icon) {\n                    <mt-icon [icon]=\"action.icon\" class=\"text-base\" />\n                  }\n                  <span>{{ action.label || action.tooltip }}</span>\n                </button>\n              }\n            }\n          </div>\n        </p-popover>\n      }\n    </div>\n  }\n</ng-template>\n", styles: [".mt-cards-grid{--mt-cards-gap: 1.25rem;--mt-cards-min: 380px;--mt-cards-track: max( var(--mt-cards-min), (100% - 3 * var(--mt-cards-gap)) / 4 );display:grid;gap:var(--mt-cards-gap);grid-template-columns:repeat(auto-fill,minmax(min(100%,var(--mt-cards-track)),1fr))}.mt-cards-grid.hidden,.mt-cards-grid[hidden]{display:none}.mt-escalation-marker{border-start-end-radius:.5rem;background:var(--p-button-text-warn-color, var(--p-orange-500, #f59e0b));clip-path:polygon(0 0,100% 0,100% 100%);transition:filter .15s ease}.mt-escalation-marker:dir(rtl){clip-path:polygon(0 0,100% 0,0 100%)}.mt-escalation-marker:hover{filter:brightness(.92)}.mt-escalation-marker:focus-visible{filter:brightness(.92) drop-shadow(0 0 2px var(--p-button-text-warn-color, #f59e0b));outline:none}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i1.NgTemplateOutlet, selector: "[ngTemplateOutlet]", inputs: ["ngTemplateOutletContext", "ngTemplateOutlet", "ngTemplateOutletInjector"] }, { kind: "ngmodule", type: TranslocoModule }, { kind: "component", type: Card, selector: "mt-card", inputs: ["class", "title", "paddingless"] }, { kind: "component", type: Button, selector: "mt-button", inputs: ["icon", "label", "tooltip", "class", "type", "styleClass", "severity", "badge", "variant", "badgeSeverity", "size", "iconPos", "autofocus", "fluid", "raised", "rounded", "text", "plain", "outlined", "link", "disabled", "loading", "pInputs", "ariaLabel"], outputs: ["onClick", "onFocus", "onBlur"] }, { kind: "directive", type: Tooltip, selector: "[mtTooltip]" }, { kind: "component", type: Icon, selector: "mt-icon", inputs: ["icon"] }, { kind: "component", type: EntitiesPreview, selector: "mt-entities-preview", inputs: ["entities", "attachmentShape", "stackOnNarrow", "clickableKeys", "activeKeys", "clickableTooltip", "activeTooltip"], outputs: ["entityClick"] }, { kind: "ngmodule", type: SkeletonModule }, { kind: "component", type: i2.Skeleton, selector: "p-skeleton", inputs: ["styleClass", "shape", "animation", "borderRadius", "size", "width", "height"] }, { kind: "ngmodule", type: PopoverModule }, { kind: "component", type: i3.Popover, selector: "p-popover", inputs: ["ariaLabel", "ariaLabelledBy", "dismissable", "style", "styleClass", "appendTo", "autoZIndex", "ariaCloseLabel", "baseZIndex", "focusOnShow", "showTransitionOptions", "hideTransitionOptions", "motionOptions"], outputs: ["onShow", "onHide"] }, { kind: "component", type: TableCaption, selector: "mt-table-caption", inputs: ["generalSearch", "showFilters", "filterMode", "exportable", "printable", "groupable", "columns", "data", "groupColumns", "tabs", "tabsOptionLabel", "tabsOptionValue", "actions", "captionStart", "captionEnd", "activeTab", "filters", "filterTerm", "groupBy"], outputs: ["activeTabChange", "filtersChange", "filterTermChange", "groupByChange", "exportRequested", "printRequested", "onTabChange", "searchChange", "filterApplied", "filterReset"] }, { kind: "component", type: EmptyState, selector: "mt-empty-state", inputs: ["variant", "illustration", "title", "description", "actionLabel", "actionIcon"], outputs: ["actionClick"] }, { kind: "pipe", type: i4.TranslocoPipe, name: "transloco" }], changeDetection: i0.ChangeDetectionStrategy.OnPush, deferBlockDependencies: [() => [i1.NgTemplateOutlet, Card,
                 EntitiesPreview]] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: ClientListCardsView, decorators: [{
@@ -1635,7 +1816,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
                         PopoverModule,
                         TableCaption,
                         EmptyState,
-                    ], providers: [MTDateFormatPipe], template: "<mt-table-caption\n  [generalSearch]=\"true\"\n  [showFilters]=\"true\"\n  filterMode=\"popover\"\n  [printable]=\"true\"\n  [groupable]=\"true\"\n  [exportable]=\"true\"\n  [columns]=\"columns()\"\n  [data]=\"rowRepresentations()\"\n  [groupColumns]=\"grouping.groupableColumns()\"\n  [actions]=\"toolbarActions()\"\n  [captionStart]=\"cardsState().config.toolbarStart ?? null\"\n  [captionEnd]=\"cardsState().config.toolbarEnd ?? null\"\n  [filters]=\"bucket().filters()\"\n  (filtersChange)=\"bucket().filters.set($event)\"\n  [filterTerm]=\"bucket().filterTerm()\"\n  (filterTermChange)=\"bucket().filterTerm.set($event)\"\n  [groupBy]=\"bucket().groupBy()\"\n  (groupByChange)=\"bucket().groupBy.set($event)\"\n  [activeTab]=\"bucket().activeTab()\"\n  (activeTabChange)=\"bucket().activeTab.set($event)\"\n  (exportRequested)=\"exportExcel()\"\n  (printRequested)=\"printPdf()\"\n/>\n\n@if (badgeLegend().length > 0) {\n  <!--\n    Decodes the coloured count pills on the cards below. Rendered once for the\n    whole board rather than per card, so it costs one line of vertical space\n    instead of repeating a key inside every tile (finding M-04).\n  -->\n  <div\n    class=\"mb-3 flex flex-wrap items-center gap-x-4 gap-y-2 px-1\"\n    role=\"list\"\n    [attr.aria-label]=\"\n      'components.clientComponents.list.badgeLegend' | transloco\n    \"\n  >\n    <span class=\"text-xs font-medium text-gray-500 dark:text-gray-400\">\n      {{ \"components.clientComponents.list.badgeLegend\" | transloco }}\n    </span>\n    @for (entry of badgeLegend(); track entry.key) {\n      <span class=\"flex items-center gap-1.5\" role=\"listitem\">\n        <span\n          class=\"inline-flex h-4 min-w-4 items-center justify-center rounded text-[10px] font-bold\"\n          [style.background-color]=\"entry.color\"\n          [style.color]=\"entry.textColor\"\n          aria-hidden=\"true\"\n        >\n          #\n        </span>\n        <span class=\"text-xs text-gray-600 dark:text-gray-300\">{{\n          entry.label\n        }}</span>\n      </span>\n    }\n  </div>\n}\n\n@if (cardsState().loading && cardsState().cards.length === 0) {\n  <div class=\"mt-cards-grid\">\n    @for (i of [1, 2, 3, 4, 5, 6]; track i) {\n      <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n    }\n  </div>\n} @else if (cardsState().error) {\n  <div class=\"rounded-lg border border-red-200 bg-red-50 p-6 text-red-600\">\n    {{ cardsState().error }}\n  </div>\n} @else if (visibleCards().length === 0) {\n  <!--\n    The same empty state the tables use, so a board and a list stop looking like\n    two products (finding H-12). A board narrowed by a search or a filter says\n    so and offers to clear it, instead of the bare grey \"No cards found.\"\n  -->\n  <mt-empty-state\n    [variant]=\"hasActiveCardFilters() ? 'filtered' : 'empty'\"\n    [title]=\"\n      hasActiveCardFilters()\n        ? ''\n        : ('components.clientComponents.list.noCardsFound' | transloco)\n    \"\n    [actionLabel]=\"\n      hasActiveCardFilters()\n        ? ('components.emptyState.clearFilters' | transloco)\n        : ''\n    \"\n    actionIcon=\"general.x-close\"\n    (actionClick)=\"clearCardFilters()\"\n  />\n} @else if (grouping.groupingActive()) {\n  <div class=\"flex flex-col gap-6\">\n    @for (group of groupedCards(); track group.key) {\n      <section class=\"flex flex-col gap-3\">\n        <header\n          class=\"flex items-center gap-3 px-2 py-2 bg-surface-50 dark:bg-surface-900 border-y border-surface-200 dark:border-surface-700 rounded\"\n          [style.--mt-group-accent]=\"group.accent ?? 'var(--p-primary-color)'\"\n        >\n          <span\n            class=\"inline-block w-1 h-5 rounded-full\"\n            [style.background]=\"'var(--mt-group-accent)'\"\n          ></span>\n          <span\n            class=\"text-xs uppercase tracking-wide text-gray-500 dark:text-gray-400\"\n          >\n            {{ group.columnLabel }}\n          </span>\n          <span class=\"text-sm font-semibold text-gray-900 dark:text-gray-100\">\n            {{ group.label }}\n          </span>\n          <span\n            class=\"ml-auto inline-flex items-center gap-1 text-xs px-2 py-0.5 rounded-full bg-primary-50 text-primary-700 dark:bg-primary-950 dark:text-primary-300\"\n          >\n            {{ group.count }}\n          </span>\n        </header>\n        <div class=\"mt-cards-grid\">\n          @for (card of group.cards; track card.id) {\n            <mt-card\n              class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n              (click)=\"cardClick.emit(card)\"\n            >\n              <ng-template #headless>\n                <ng-container\n                  [ngTemplateOutlet]=\"cardActionsMenu\"\n                  [ngTemplateOutletContext]=\"{ $implicit: card }\"\n                />\n                <mt-entities-preview\n                  [entities]=\"card.entities\"\n                  attachmentShape=\"compact\"\n                  [stackOnNarrow]=\"false\"\n                  [clickableKeys]=\"clickableEntityKeys()\"\n                  [activeKeys]=\"activeKeysForCard(card)\"\n                  [clickableTooltip]=\"filterByThisLabel()\"\n                  [activeTooltip]=\"clearFilterLabel()\"\n                  (entityClick)=\"onEntityFilterClick(card, $event)\"\n                />\n              </ng-template>\n            </mt-card>\n          }\n        </div>\n      </section>\n    }\n  </div>\n} @else {\n  <div class=\"mt-cards-grid\">\n    @for (card of visibleCards(); track card.id) {\n      @defer (on viewport) {\n        <mt-card\n          class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n          (click)=\"cardClick.emit(card)\"\n        >\n          <ng-template #headless>\n            <ng-container\n              [ngTemplateOutlet]=\"cardActionsMenu\"\n              [ngTemplateOutletContext]=\"{ $implicit: card }\"\n            />\n            <mt-entities-preview\n              [entities]=\"card.entities\"\n              attachmentShape=\"compact\"\n              [stackOnNarrow]=\"false\"\n              [clickableKeys]=\"clickableEntityKeys()\"\n              [activeKeys]=\"activeKeysForCard(card)\"\n              [clickableTooltip]=\"filterByThisLabel()\"\n              [activeTooltip]=\"clearFilterLabel()\"\n              (entityClick)=\"onEntityFilterClick(card, $event)\"\n            />\n          </ng-template>\n        </mt-card>\n      } @placeholder {\n        <div class=\"min-h-[20rem]\">\n          <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n        </div>\n      }\n    }\n  </div>\n}\n\n<!--\n  Infinite-scroll trigger. Deliberately outside the @if/@else chain above:\n  inside it the element would be torn down and rebuilt every time the view\n  swapped branch (error, empty filter result, group-by), and the observer\n  would be left watching a detached node. Kept in the DOM and hidden via CSS\n  when there is nothing left to load, so appending a page never recreates it.\n  It also has to sit outside so infinite scroll keeps working while a\n  group-by is active \u2014 grouping is a pure FE view over whatever has been\n  fetched, not a reason to stop fetching.\n-->\n<div\n  #loadMoreSentinel\n  class=\"mt-cards-grid py-4\"\n  [class.hidden]=\"!hasMoreCards()\"\n>\n  @for (i of [1, 2, 3]; track i) {\n    <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n  }\n</div>\n\n<!--\n  Per-card escalation marker and 3-dots actions menu. The compact corner cover\n  only indicates active escalation state; its preview action lives in the menu\n  so the marker never displaces or competes with the menu trigger.\n-->\n<ng-template #cardActionsMenu let-card>\n  @let escalationAction = escalationMarkerAction(card);\n  @if (escalationAction) {\n    <span\n      class=\"mt-escalation-marker absolute end-0 top-0 z-10 h-[18px] w-[20px]\"\n      role=\"img\"\n      tabindex=\"0\"\n      [attr.aria-label]=\"escalationLabel()\"\n      [mtTooltip]=\"escalationLabel()\"\n      tooltipPosition=\"top\"\n    ></span>\n  }\n  @if (rowActions().length > 0) {\n    <div\n      class=\"absolute end-2 top-2 z-20 flex items-center gap-1\"\n      (click)=\"$event.stopPropagation()\"\n    >\n      @for (action of inlineActionsForCard(card); track $index) {\n        <mt-button\n          [icon]=\"action.icon\"\n          [severity]=\"action.color\"\n          [variant]=\"action.variant\"\n          [size]=\"actionSize(action) || 'small'\"\n          [tooltip]=\"action.tooltip\"\n          [label]=\"action.label\"\n          [loading]=\"resolveActionLoading(action, card)\"\n          (onClick)=\"runCardAction($event, action, card)\"\n        />\n      }\n      @if (showCardActionsMenu(card)) {\n        <button\n          type=\"button\"\n          class=\"flex h-7 w-7 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-0 text-base text-gray-500 transition-colors hover:bg-gray-100 hover:text-gray-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-500 dark:text-gray-300 dark:hover:bg-surface-700 dark:hover:text-gray-100\"\n          [attr.aria-label]=\"actionsLabel()\"\n          [mtTooltip]=\"actionsLabel()\"\n          tooltipPosition=\"top\"\n          (click)=\"onCardActionsToggle($event, cardPopover, card)\"\n        >\n          <mt-icon icon=\"general.dots-vertical\" class=\"text-base\" />\n        </button>\n        <p-popover #cardPopover appendTo=\"body\">\n          <div class=\"flex min-w-44 flex-col gap-1 p-1\">\n            @if (isCardActionsLoading(card)) {\n              <div class=\"flex flex-col gap-2 p-1\">\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n              </div>\n            } @else {\n              @for (action of menuActionsForCard(card); track $index) {\n                @if (isFirstDestructiveCardAction(card, $index)) {\n                  <hr\n                    class=\"my-1 border-0 border-t border-surface-200 dark:border-surface-700\"\n                  />\n                }\n                <button\n                  type=\"button\"\n                  class=\"flex cursor-pointer items-center gap-2 rounded px-2 py-2 text-start text-sm transition-colors\"\n                  [class]=\"\n                    action.color === 'danger'\n                      ? 'text-red-600 hover:bg-red-50 dark:hover:bg-red-950'\n                      : action.color === 'warn'\n                        ? 'text-orange-600 hover:bg-orange-50 dark:text-orange-400 dark:hover:bg-orange-950'\n                        : 'text-gray-700 hover:bg-gray-100 dark:text-gray-200 dark:hover:bg-surface-700'\n                  \"\n                  (click)=\"\n                    runCardAction($event, action, card); cardPopover.hide()\n                  \"\n                >\n                  @if (action.icon) {\n                    <mt-icon [icon]=\"action.icon\" class=\"text-base\" />\n                  }\n                  <span>{{ action.label || action.tooltip }}</span>\n                </button>\n              }\n            }\n          </div>\n        </p-popover>\n      }\n    </div>\n  }\n</ng-template>\n", styles: [".mt-cards-grid{--mt-cards-gap: 1.25rem;--mt-cards-min: 380px;--mt-cards-track: max( var(--mt-cards-min), (100% - 4 * var(--mt-cards-gap)) / 5 );display:grid;gap:var(--mt-cards-gap);grid-template-columns:repeat(auto-fill,minmax(min(100%,var(--mt-cards-track)),1fr))}.mt-cards-grid.hidden,.mt-cards-grid[hidden]{display:none}.mt-escalation-marker{border-start-end-radius:.5rem;background:var(--p-button-text-warn-color, var(--p-orange-500, #f59e0b));clip-path:polygon(0 0,100% 0,100% 100%);transition:filter .15s ease}.mt-escalation-marker:dir(rtl){clip-path:polygon(0 0,100% 0,0 100%)}.mt-escalation-marker:hover{filter:brightness(.92)}.mt-escalation-marker:focus-visible{filter:brightness(.92) drop-shadow(0 0 2px var(--p-button-text-warn-color, #f59e0b));outline:none}\n"] }]
+                    ], providers: [MTDateFormatPipe], template: "<mt-table-caption\n  [generalSearch]=\"true\"\n  [showFilters]=\"true\"\n  filterMode=\"popover\"\n  [printable]=\"true\"\n  [groupable]=\"true\"\n  [exportable]=\"true\"\n  [columns]=\"columns()\"\n  [data]=\"rowRepresentations()\"\n  [groupColumns]=\"grouping.groupableColumns()\"\n  [actions]=\"toolbarActions()\"\n  [captionStart]=\"cardsState().config.toolbarStart ?? null\"\n  [captionEnd]=\"cardsState().config.toolbarEnd ?? null\"\n  [filters]=\"bucket().filters()\"\n  (filtersChange)=\"bucket().filters.set($event)\"\n  [filterTerm]=\"bucket().filterTerm()\"\n  (filterTermChange)=\"bucket().filterTerm.set($event)\"\n  [groupBy]=\"bucket().groupBy()\"\n  (groupByChange)=\"bucket().groupBy.set($event)\"\n  [activeTab]=\"bucket().activeTab()\"\n  (activeTabChange)=\"bucket().activeTab.set($event)\"\n  (exportRequested)=\"exportExcel()\"\n  (printRequested)=\"printPdf()\"\n/>\n\n@if (badgeLegend().length > 0) {\n  <!--\n    Decodes the coloured count pills on the cards below. Rendered once for the\n    whole board rather than per card, so it costs one line of vertical space\n    instead of repeating a key inside every tile (finding M-04).\n  -->\n  <div\n    class=\"mb-3 flex flex-wrap items-center gap-x-4 gap-y-2 px-1\"\n    role=\"list\"\n    [attr.aria-label]=\"\n      'components.clientComponents.list.badgeLegend' | transloco\n    \"\n  >\n    <span class=\"text-xs font-medium text-gray-500 dark:text-gray-400\">\n      {{ \"components.clientComponents.list.badgeLegend\" | transloco }}\n    </span>\n    @for (entry of badgeLegend(); track entry.key) {\n      <span class=\"flex items-center gap-1.5\" role=\"listitem\">\n        <span\n          class=\"inline-flex h-4 min-w-4 items-center justify-center rounded text-[10px] font-bold\"\n          [style.background-color]=\"entry.color\"\n          [style.color]=\"entry.textColor\"\n          aria-hidden=\"true\"\n        >\n          #\n        </span>\n        <span class=\"text-xs text-gray-600 dark:text-gray-300\">{{\n          entry.label\n        }}</span>\n      </span>\n    }\n  </div>\n}\n\n@if (cardsState().loading && cardsState().cards.length === 0) {\n  <div class=\"mt-cards-grid\">\n    @for (i of [1, 2, 3, 4, 5, 6]; track i) {\n      <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n    }\n  </div>\n} @else if (cardsState().error) {\n  <div class=\"rounded-lg border border-red-200 bg-red-50 p-6 text-red-600\">\n    {{ cardsState().error }}\n  </div>\n} @else if (visibleCards().length === 0) {\n  <!--\n    The same empty state the tables use, so a board and a list stop looking like\n    two products (finding H-12). A board narrowed by a search or a filter says\n    so and offers to clear it, instead of the bare grey \"No cards found.\"\n  -->\n  <mt-empty-state\n    [variant]=\"hasActiveCardFilters() ? 'filtered' : 'empty'\"\n    [title]=\"\n      hasActiveCardFilters()\n        ? ''\n        : ('components.clientComponents.list.noCardsFound' | transloco)\n    \"\n    [actionLabel]=\"\n      hasActiveCardFilters()\n        ? ('components.emptyState.clearFilters' | transloco)\n        : ''\n    \"\n    actionIcon=\"general.x-close\"\n    (actionClick)=\"clearCardFilters()\"\n  />\n} @else if (grouping.groupingActive()) {\n  <div class=\"flex flex-col gap-6\">\n    @for (group of groupedCards(); track group.key) {\n      <section class=\"flex flex-col gap-3\">\n        <header\n          class=\"flex items-center gap-3 px-2 py-2 bg-surface-50 dark:bg-surface-900 border-y border-surface-200 dark:border-surface-700 rounded\"\n          [style.--mt-group-accent]=\"group.accent ?? 'var(--p-primary-color)'\"\n        >\n          <span\n            class=\"inline-block w-1 h-5 rounded-full\"\n            [style.background]=\"'var(--mt-group-accent)'\"\n          ></span>\n          <span\n            class=\"text-xs uppercase tracking-wide text-gray-500 dark:text-gray-400\"\n          >\n            {{ group.columnLabel }}\n          </span>\n          <span class=\"text-sm font-semibold text-gray-900 dark:text-gray-100\">\n            {{ group.label }}\n          </span>\n          <span\n            class=\"ml-auto inline-flex items-center gap-1 text-xs px-2 py-0.5 rounded-full bg-primary-50 text-primary-700 dark:bg-primary-950 dark:text-primary-300\"\n          >\n            {{ group.count }}\n          </span>\n        </header>\n        <div class=\"mt-cards-grid\">\n          @for (card of group.cards; track card.id) {\n            <mt-card\n              class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n              (click)=\"cardClick.emit(card)\"\n            >\n              <ng-template #headless>\n                <ng-container\n                  [ngTemplateOutlet]=\"cardActionsMenu\"\n                  [ngTemplateOutletContext]=\"{ $implicit: card }\"\n                />\n                <mt-entities-preview\n                  [entities]=\"card.entities\"\n                  attachmentShape=\"compact\"\n                  [stackOnNarrow]=\"false\"\n                  [clickableKeys]=\"clickableEntityKeys()\"\n                  [activeKeys]=\"activeKeysForCard(card)\"\n                  [clickableTooltip]=\"filterByThisLabel()\"\n                  [activeTooltip]=\"clearFilterLabel()\"\n                  (entityClick)=\"onEntityFilterClick(card, $event)\"\n                />\n              </ng-template>\n            </mt-card>\n          }\n        </div>\n      </section>\n    }\n  </div>\n} @else {\n  <div class=\"mt-cards-grid\">\n    @for (card of visibleCards(); track card.id) {\n      @defer (on viewport) {\n        <mt-card\n          class=\"relative cursor-pointer p-5 shadow-sm transition-shadow hover:shadow-md\"\n          (click)=\"cardClick.emit(card)\"\n        >\n          <ng-template #headless>\n            <ng-container\n              [ngTemplateOutlet]=\"cardActionsMenu\"\n              [ngTemplateOutletContext]=\"{ $implicit: card }\"\n            />\n            <mt-entities-preview\n              [entities]=\"card.entities\"\n              attachmentShape=\"compact\"\n              [stackOnNarrow]=\"false\"\n              [clickableKeys]=\"clickableEntityKeys()\"\n              [activeKeys]=\"activeKeysForCard(card)\"\n              [clickableTooltip]=\"filterByThisLabel()\"\n              [activeTooltip]=\"clearFilterLabel()\"\n              (entityClick)=\"onEntityFilterClick(card, $event)\"\n            />\n          </ng-template>\n        </mt-card>\n      } @placeholder {\n        <div class=\"min-h-[20rem]\">\n          <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n        </div>\n      }\n    }\n  </div>\n}\n\n<!--\n  Infinite-scroll trigger. Deliberately outside the @if/@else chain above:\n  inside it the element would be torn down and rebuilt every time the view\n  swapped branch (error, empty filter result, group-by), and the observer\n  would be left watching a detached node. Kept in the DOM and hidden via CSS\n  when there is nothing left to load, so appending a page never recreates it.\n  It also has to sit outside so infinite scroll keeps working while a\n  group-by is active \u2014 grouping is a pure FE view over whatever has been\n  fetched, not a reason to stop fetching.\n-->\n<div\n  #loadMoreSentinel\n  class=\"mt-cards-grid py-4\"\n  [class.hidden]=\"!hasMoreCards()\"\n>\n  @for (i of [1, 2, 3]; track i) {\n    <p-skeleton height=\"20rem\" class=\"rounded-lg\" />\n  }\n</div>\n\n<!--\n  Per-card escalation marker and 3-dots actions menu. The compact corner cover\n  only indicates active escalation state; its preview action lives in the menu\n  so the marker never displaces or competes with the menu trigger.\n-->\n<ng-template #cardActionsMenu let-card>\n  @let escalationAction = escalationMarkerAction(card);\n  @if (escalationAction) {\n    <span\n      class=\"mt-escalation-marker absolute end-0 top-0 z-10 h-[18px] w-[20px]\"\n      role=\"img\"\n      tabindex=\"0\"\n      [attr.aria-label]=\"escalationLabel()\"\n      [mtTooltip]=\"escalationLabel()\"\n      tooltipPosition=\"top\"\n    ></span>\n  }\n  @if (rowActions().length > 0) {\n    <div\n      class=\"absolute end-2 top-2 z-20 flex items-center gap-1\"\n      (click)=\"$event.stopPropagation()\"\n    >\n      @for (action of inlineActionsForCard(card); track $index) {\n        <mt-button\n          [icon]=\"action.icon\"\n          [severity]=\"action.color\"\n          [variant]=\"action.variant\"\n          [size]=\"actionSize(action) || 'small'\"\n          [tooltip]=\"action.tooltip\"\n          [label]=\"action.label\"\n          [loading]=\"resolveActionLoading(action, card)\"\n          (onClick)=\"runCardAction($event, action, card)\"\n        />\n      }\n      @if (showCardActionsMenu(card)) {\n        <button\n          type=\"button\"\n          class=\"flex h-7 w-7 cursor-pointer items-center justify-center rounded-md border-0 bg-transparent p-0 text-base text-gray-500 transition-colors hover:bg-gray-100 hover:text-gray-700 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-500 dark:text-gray-300 dark:hover:bg-surface-700 dark:hover:text-gray-100\"\n          [attr.aria-label]=\"actionsLabel()\"\n          [mtTooltip]=\"actionsLabel()\"\n          tooltipPosition=\"top\"\n          (click)=\"onCardActionsToggle($event, cardPopover, card)\"\n        >\n          <mt-icon icon=\"general.dots-vertical\" class=\"text-base\" />\n        </button>\n        <p-popover #cardPopover appendTo=\"body\">\n          <div class=\"flex min-w-44 flex-col gap-1 p-1\">\n            @if (isCardActionsLoading(card)) {\n              <div class=\"flex flex-col gap-2 p-1\">\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n                <p-skeleton height=\"1.75rem\" />\n              </div>\n            } @else {\n              @for (action of menuActionsForCard(card); track $index) {\n                @if (isFirstDestructiveCardAction(card, $index)) {\n                  <hr\n                    class=\"my-1 border-0 border-t border-surface-200 dark:border-surface-700\"\n                  />\n                }\n                <button\n                  type=\"button\"\n                  class=\"flex cursor-pointer items-center gap-2 rounded px-2 py-2 text-start text-sm transition-colors\"\n                  [class]=\"\n                    action.color === 'danger'\n                      ? 'text-red-600 hover:bg-red-50 dark:hover:bg-red-950'\n                      : action.color === 'warn'\n                        ? 'text-orange-600 hover:bg-orange-50 dark:text-orange-400 dark:hover:bg-orange-950'\n                        : 'text-gray-700 hover:bg-gray-100 dark:text-gray-200 dark:hover:bg-surface-700'\n                  \"\n                  (click)=\"\n                    runCardAction($event, action, card); cardPopover.hide()\n                  \"\n                >\n                  @if (action.icon) {\n                    <mt-icon [icon]=\"action.icon\" class=\"text-base\" />\n                  }\n                  <span>{{ action.label || action.tooltip }}</span>\n                </button>\n              }\n            }\n          </div>\n        </p-popover>\n      }\n    </div>\n  }\n</ng-template>\n", styles: [".mt-cards-grid{--mt-cards-gap: 1.25rem;--mt-cards-min: 380px;--mt-cards-track: max( var(--mt-cards-min), (100% - 3 * var(--mt-cards-gap)) / 4 );display:grid;gap:var(--mt-cards-gap);grid-template-columns:repeat(auto-fill,minmax(min(100%,var(--mt-cards-track)),1fr))}.mt-cards-grid.hidden,.mt-cards-grid[hidden]{display:none}.mt-escalation-marker{border-start-end-radius:.5rem;background:var(--p-button-text-warn-color, var(--p-orange-500, #f59e0b));clip-path:polygon(0 0,100% 0,100% 100%);transition:filter .15s ease}.mt-escalation-marker:dir(rtl){clip-path:polygon(0 0,100% 0,0 100%)}.mt-escalation-marker:hover{filter:brightness(.92)}.mt-escalation-marker:focus-visible{filter:brightness(.92) drop-shadow(0 0 2px var(--p-button-text-warn-color, #f59e0b));outline:none}\n"] }]
         }], ctorParameters: () => [], propDecorators: { state: [{ type: i0.Input, args: [{ isSignal: true, alias: "state", required: true }] }], rowActions: [{ type: i0.Input, args: [{ isSignal: true, alias: "rowActions", required: false }] }], rowActionsLoadingFn: [{ type: i0.Input, args: [{ isSignal: true, alias: "rowActionsLoadingFn", required: false }] }], lazyLoad: [{ type: i0.Output, args: ["lazyLoad"] }], loadMore: [{ type: i0.Output, args: ["loadMore"] }], cardClick: [{ type: i0.Output, args: ["cardClick"] }], rowActionsRequested: [{ type: i0.Output, args: ["rowActionsRequested"] }], loadMoreSentinel: [{ type: i0.ViewChild, args: ['loadMoreSentinel', { isSignal: true }] }] } });
 
 function toDashboardExtraFilters(filters = []) {
@@ -1791,6 +1972,14 @@ class ClientList {
     inFlightRequestSignatures = new Map();
     fulfilledRequestSignatures = new Map();
     runtimeFilters = new Map();
+    /**
+     * The `propertyKeys` the last table request carried, per item. `undefined`
+     * means the request left the projection to the backend, which is a distinct
+     * state from "not loaded yet" — hence the map rather than a nullable field.
+     */
+    requestPropertyKeys = new Map();
+    /** Single-record read-backs, kept apart from the page loads they must not cancel. */
+    recordSubscriptions = new Map();
     constructor() {
         effect(() => {
             const configs = this.configurations();
@@ -1860,6 +2049,93 @@ class ClientList {
             return;
         this.loadItem(item, true);
     }
+    /**
+     * The query settings this list renders with, shaped as the `returnRecord`
+     * block of a `process-submit` payload. Send it with a create/update so the
+     * backend projects the written record the way this list reads records, then
+     * hand the response to {@link applyWriteResult} — that pair replaces the
+     * full page re-fetch a write used to cost.
+     *
+     * Returns `null` for an informative dashboard (no records to project) or an
+     * unknown key.
+     */
+    getReturnRecordRequest(itemKey) {
+        const item = this.state.itemsByKey()[itemKey];
+        if (!item || item.type !== 'form')
+            return null;
+        const includeState = [...CLIENT_LIST_DEFAULT_INCLUDE_STATE];
+        const culture = this.transloco.getActiveLang();
+        if (item.areaType === 'cards') {
+            return { projection: 'Card', includeState, culture };
+        }
+        const propertyKeys = this.requestPropertyKeys.get(itemKey);
+        return {
+            projection: 'Table',
+            surfaceKey: 'table',
+            includeState,
+            // Omitted, not empty, when the table let the backend pick the
+            // projection — an empty array would read as "no columns".
+            ...(propertyKeys?.length ? { propertyKeys } : {}),
+            culture,
+        };
+    }
+    /**
+     * Applies a create/update to the list in place, without re-fetching the
+     * page. Pass the `process-submit` response as-is.
+     *
+     * Three outcomes, in the order they are tried:
+     * - the write carried a usable record projection → splice it in, no request;
+     * - it did not (`recordProjectionStatus: 'Unavailable'`, or the list has
+     *   nothing to splice into) → read that one record back by id. The write
+     *   already succeeded; this only reads, and never re-submits;
+     * - nothing identifies the record at all → reload the page, as before.
+     *
+     * An approval-queued submit is a no-op: nothing has been written yet.
+     *
+     * Note that the list cannot know where the backend would have sorted a new
+     * record, so an insert lands at the top of the page in view.
+     */
+    applyWriteResult(itemKey, result) {
+        const item = this.state.itemsByKey()[itemKey];
+        if (!item || item.type !== 'form')
+            return;
+        if (this.isPendingApprovalWrite(result))
+            return;
+        const recordId = this.toFiniteNumber(result?.recordId);
+        const record = this.toWriteRecord(result, recordId);
+        if (record) {
+            // A failed splice means the list holds no page to splice into, so
+            // reading the record back would not help either.
+            if (this.state.upsertRecord(itemKey, record, item.config)) {
+                this.afterRecordApplied(itemKey);
+            }
+            else {
+                this.reloadByKey(itemKey);
+            }
+            return;
+        }
+        if (recordId != null) {
+            this.readRecordBack(item, recordId);
+            return;
+        }
+        this.reloadByKey(itemKey);
+    }
+    /**
+     * Drops a deleted record from the list in place. Falls back to a reload when
+     * the record is not part of the loaded set, so a stale list still corrects
+     * itself.
+     */
+    removeRecord(itemKey, recordId) {
+        const item = this.state.itemsByKey()[itemKey];
+        if (!item || item.type !== 'form')
+            return;
+        if (!this.state.removeRecord(itemKey, recordId, item.config)) {
+            this.reloadByKey(itemKey);
+            return;
+        }
+        this.runtimeActions.invalidateRow(itemKey, recordId);
+        this.afterRecordApplied(itemKey, { invalidateRuntimeActions: false });
+    }
     toggleExpanded(key) {
         this.state.toggleExpanded(key);
     }
@@ -2110,6 +2386,89 @@ class ClientList {
             config.onActionExecuted?.(action, ctx);
         }
     }
+    /**
+     * A submit that only queued an approval request has written nothing — the
+     * record it describes does not exist yet, so the list must not move.
+     */
+    isPendingApprovalWrite(result) {
+        return (String(result?.status ?? '')
+            .trim()
+            .toLowerCase() === 'pendingapproval');
+    }
+    /**
+     * The canonical record from a write response, or `null` when there is none
+     * to trust. A backend that has not shipped the canonical projection yet
+     * answers with neither `recordProjectionStatus: 'Available'` nor `values`,
+     * and falls through to the read-back path — which is why this is a plain
+     * shape check and not a parse of alternative record shapes.
+     */
+    toWriteRecord(result, recordId) {
+        if (result?.recordProjectionStatus !== 'Available')
+            return null;
+        const record = result.record;
+        if (!record?.values)
+            return null;
+        const id = this.toFiniteNumber(record.id) ?? recordId;
+        if (id == null)
+            return null;
+        return { ...record, id };
+    }
+    /**
+     * Reads one record back through `fetch/query` with this list's own settings.
+     * Taken when the write could not project the record itself — the write has
+     * already happened, so this reads and never re-submits.
+     */
+    readRecordBack(item, recordId) {
+        const config = item.config;
+        const request = this.getReturnRecordRequest(item.key);
+        if (!request || !this.hasValidIdentifiers(config)) {
+            this.reloadByKey(item.key);
+            return;
+        }
+        // The host's own scope filters plus the record id. Runtime filters (the
+        // search box, a column filter) are deliberately left out: a record the
+        // user just wrote should come back whether or not it matches whatever
+        // they happen to have typed into the list.
+        const filters = [
+            ...config.filters,
+            {
+                key: CLIENT_LIST_RECORD_ID_FILTER_KEY,
+                operator: 'Equals',
+                value: recordId,
+            },
+        ];
+        this.recordSubscriptions.get(item.key)?.unsubscribe();
+        const sub = this.api
+            .getRecord(config.contextKey, request, filters)
+            .subscribe({
+            next: (response) => {
+                this.recordSubscriptions.delete(item.key);
+                const record = response.data?.records?.[0];
+                if (!record || !this.state.upsertRecord(item.key, record, config)) {
+                    this.reloadByKey(item.key);
+                    return;
+                }
+                this.afterRecordApplied(item.key);
+            },
+            error: () => {
+                this.recordSubscriptions.delete(item.key);
+                this.reloadByKey(item.key);
+            },
+        });
+        this.recordSubscriptions.set(item.key, sub);
+    }
+    /**
+     * Runs the tail of a load for a list that changed without one: the row
+     * action cache is stale (a written record's available actions follow its new
+     * state), and hosts hang work off `dataLoaded` / `loaded`.
+     */
+    afterRecordApplied(itemKey, options) {
+        if (options?.invalidateRuntimeActions !== false) {
+            this.runtimeActions.invalidateList(itemKey);
+        }
+        this.notifyDataLoaded(itemKey);
+        this.loaded.emit(itemKey);
+    }
     toRuntimeActionsContext(item, row, config) {
         const recordId = this.resolveRecordId(config, row);
         if (recordId == null)
@@ -2147,6 +2506,9 @@ class ClientList {
     ngOnDestroy() {
         this.subscriptions.forEach((sub) => sub.unsubscribe());
         this.subscriptions.clear();
+        this.recordSubscriptions.forEach((sub) => sub.unsubscribe());
+        this.recordSubscriptions.clear();
+        this.requestPropertyKeys.clear();
         this.rowActionsLoadingFnCache.clear();
         this.runtimeActions.clearAll();
     }
@@ -2290,9 +2652,10 @@ class ClientList {
         this.state.setLoading(key, true);
         this.state.setError(key, null);
         const sub = this.api.getRows(config.contextKey, query, filters).subscribe({
-            next: (response) => {
+            next: ({ response, propertyKeys }) => {
                 let hasLoadedData = false;
                 if (response.data) {
+                    this.requestPropertyKeys.set(key, propertyKeys);
                     this.state.setRowsResult(key, response.data, config, query.skip, query.take);
                     this.fulfilledRequestSignatures.set(key, requestSignature);
                     hasLoadedData = true;
@@ -2563,11 +2926,22 @@ class ClientList {
                 this.fulfilledRequestSignatures.delete(key);
             }
         }
+        for (const [key, sub] of this.recordSubscriptions.entries()) {
+            if (!activeKeys.has(key)) {
+                sub.unsubscribe();
+                this.recordSubscriptions.delete(key);
+            }
+        }
         for (const key of this.runtimeFilters.keys()) {
             if (!activeKeys.has(key)) {
                 this.runtimeFilters.delete(key);
             }
         }
+        for (const key of this.requestPropertyKeys.keys()) {
+            if (!activeKeys.has(key)) {
+                this.requestPropertyKeys.delete(key);
+            }
+        }
         for (const key of this.rowActionsLoadingFnCache.keys()) {
             if (!activeKeys.has(key)) {
                 this.rowActionsLoadingFnCache.delete(key);
@@ -2694,5 +3068,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { CLIENT_LIST_RECORD_STATE_KEY, ClientList, ClientListApiService, ClientListRuntimeActionsService, ClientListStateService, ClientListToolbarService, defaultResolveRecordId };
+export { CLIENT_LIST_DEFAULT_INCLUDE_STATE, CLIENT_LIST_RECORD_ID_FILTER_KEY, CLIENT_LIST_RECORD_STATE_KEY, ClientList, ClientListApiService, ClientListRuntimeActionsService, ClientListStateService, ClientListToolbarService, defaultResolveRecordId };
 //# sourceMappingURL=masterteam-client-components-client-list.mjs.map