@praxisui/list 10.0.0-rc.3 → 10.0.0-rc.30

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "@praxisui/list",
-  "version": "10.0.0-rc.3",
+  "version": "10.0.0-rc.30",
   "description": "List components and helpers for Praxis UI.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
+    "@angular/cdk": "^21.0.0",
     "@angular/material": "^21.0.0",
-    "@praxisui/dynamic-fields": "^10.0.0-rc.3",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.30",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.3",
-    "@praxisui/core": "^10.0.0-rc.3",
-    "@praxisui/rich-content": "^10.0.0-rc.3",
-    "@praxisui/settings-panel": "^10.0.0-rc.3"
+    "@praxisui/ai": "^10.0.0-rc.30",
+    "@praxisui/core": "^10.0.0-rc.30",
+    "@praxisui/rich-content": "^10.0.0-rc.30",
+    "@praxisui/settings-panel": "^10.0.0-rc.30"
   },
   "dependencies": {
     "tslib": "^2.3.0",

package/src/lib/praxis-list.json-api.md

@@ -534,18 +534,19 @@ interface PraxisListConfig {
 
 #### Layout API
 
-| Caminho                      | Status        | Observacao                         |
-| ---------------------------- | ------------- | ---------------------------------- |
-| `layout.variant`             | Active        | `list/cards/tiles`                 |
-| `layout.density`             | Active        | classe `density-*`                 |
-| `layout.itemSpacing`         | Active        | classe `item-spacing-*`            |
-| `layout.lines`               | Active        | linhas de texto + classe `lines-*` |
-| `layout.dividers`            | Active        | divisores no modo `list`           |
-| `layout.model`               | Active        | classe `model-*`                   |
-| `layout.groupBy`             | Active        | agrupamento em `sections$`         |
-| `layout.pageSize`            | Active        | page size inicial                  |
-| `layout.stickySectionHeader` | Declared-only | sem sticky runtime                 |
-| `layout.virtualScroll`       | Declared-only | sem virtual scroll runtime         |
+| Caminho                      | Status        | Observacao                                                 |
+| ---------------------------- | ------------- | ---------------------------------------------------------- |
+| `layout.variant`             | Active        | `list/cards/tiles`                                         |
+| `layout.density`             | Active        | classe `density-*`                                         |
+| `layout.itemSpacing`         | Active        | classe `item-spacing-*`                                    |
+| `layout.itemAppearance`      | Active        | `flat/card` (isola itens em cartões sob `variant: 'list'`) |
+| `layout.lines`               | Active        | linhas de texto + classe `lines-*`                         |
+| `layout.dividers`            | Active        | divisores no modo `list`                                   |
+| `layout.model`               | Active        | classe `model-*`                                           |
+| `layout.groupBy`             | Active        | agrupamento em `sections$`                                 |
+| `layout.pageSize`            | Active        | page size inicial                                          |
+| `layout.stickySectionHeader` | Declared-only | sem sticky runtime                                         |
+| `layout.virtualScroll`       | Declared-only | sem virtual scroll runtime                                 |
 
 #### Skin API
 
@@ -634,7 +635,7 @@ Slots suportados:
 
 Tipos funcionais no runtime:
 
-- `text`, `icon`, `image`, `chip`, `rating`, `currency`, `date`, `html`, `metric`, `compose`, `component`.
+- `text`, `icon`, `image`, `chip`, `rating`, `currency`, `date`, `datetime`, `relative`, `html`, `metric`, `compose`, `component`.
 
 Inferencia opcional:
 
@@ -765,15 +766,21 @@ Semantica de execucao:
 Suporte principal:
 
 - placeholders: `${item.campo}`;
-- pipes em placeholder: `bool`, `date`, `map`, `number`;
-- pipe top-level `bool` no expr completo.
+- coalescência em placeholders: `${item.displayName ?? item.name ?? item.id}`;
+- pipes em placeholder: `bool`, `date`, `datetime`, `relative`, `map`, `number`, `currency`;
+- pipes top-level pós-expressão: `|bool:True:False`, `|map:k=v`, `|relative:locale`, `|datetime:locale:style`, `|date:locale:style`.
 
 Exemplos validos:
 
 - `${item.active|bool:Ativo:Inativo}`
 - `${item.createdAt|date:pt-BR:short}`
+- `${item.occurredAt|datetime:pt-BR:short}`
+- `${item.occurredAt|relative:pt-BR}` (exibe *"há 5 minutos"*)
 - `${item.status|map:done=Concluido;pending=Pendente}`
 - `${item.total|number:pt-BR:compact}`
+- `${item.amount|currency:BRL:pt-BR}`
+- `${item.occurredAt}|relative:pt-BR` (pipe top-level)
+- `${item.createdAt}|datetime:pt-BR:short` (pipe top-level)
 
 ##### `actions[].showIf`
 
@@ -958,25 +965,142 @@ Recomendacao corporativa:
 ### Minimal valid
 
 ```json
-{}
+{
+  "layout": {
+    "variant": "list"
+  },
+  "templating": {
+    "primary": {
+      "type": "text",
+      "expr": "${item.name}"
+    }
+  }
+}
 ```
 
 ### Typical/common
 
 ```json
-{}
+{
+  "layout": {
+    "variant": "list",
+    "density": "comfortable",
+    "itemSpacing": "default"
+  },
+  "templating": {
+    "leading": {
+      "type": "icon",
+      "expr": "person"
+    },
+    "primary": {
+      "type": "text",
+      "expr": "${item.nomeCompleto}"
+    },
+    "secondary": {
+      "type": "text",
+      "expr": "${item.cargo} · ${item.departamento}"
+    },
+    "meta": {
+      "type": "date",
+      "expr": "${item.dataAdmissao}"
+    }
+  }
+}
 ```
 
 ### Advanced
 
 ```json
-{}
+{
+  "layout": {
+    "variant": "list",
+    "itemAppearance": "card",
+    "itemSpacing": "compact"
+  },
+  "skin": {
+    "type": "glass"
+  },
+  "templating": {
+    "leading": {
+      "type": "icon",
+      "expr": "${item.severidade|map:CRITICA=warning,ALTA=error_outline,MEDIA=info}",
+      "color": "${item.severidade|map:CRITICA=warn,ALTA=warn,MEDIA=primary}"
+    },
+    "primary": {
+      "type": "text",
+      "expr": "${item.titulo}"
+    },
+    "secondary": {
+      "type": "text",
+      "expr": "${item.localizacao} · Protocolo ${item.protocolo}"
+    },
+    "meta": {
+      "type": "relative",
+      "expr": "${item.abertoEm}"
+    },
+    "metaPlacement": "side"
+  },
+  "actions": [
+    {
+      "id": "dispatch",
+      "label": "Despachar",
+      "icon": "send",
+      "kind": "icon"
+    }
+  ]
+}
 ```
 
 ### Enterprise scenario
 
 ```json
-{}
+{
+  "dataSource": {
+    "resourcePath": "incidentes",
+    "sort": {
+      "field": "abertoEm",
+      "direction": "desc"
+    }
+  },
+  "layout": {
+    "variant": "list",
+    "itemAppearance": "card",
+    "pageSize": 20
+  },
+  "i18n": {
+    "locale": "pt-BR",
+    "currency": "BRL"
+  },
+  "selection": {
+    "mode": "multiple",
+    "compareBy": "id",
+    "return": "id"
+  },
+  "templating": {
+    "leading": {
+      "type": "chip",
+      "expr": "${item.codigo}",
+      "variant": "outlined"
+    },
+    "primary": {
+      "type": "text",
+      "expr": "${item.nome ?? item.titulo}"
+    },
+    "secondary": {
+      "type": "text",
+      "expr": "${item.resumo}"
+    },
+    "meta": {
+      "type": "datetime",
+      "expr": "${item.dataCriacao}|pt-BR:short"
+    }
+  },
+  "ui": {
+    "showSearch": true,
+    "searchField": "titulo",
+    "showSort": true
+  }
+}
 ```
 
 ## Known limitations and mismatches

package/types/praxisui-list.d.ts

@@ -4,13 +4,12 @@ import * as i0 from '@angular/core';
 import { OnInit, OnChanges, AfterViewInit, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
 import { MatPaginatorSelectConfig, PageEvent } from '@angular/material/paginator';
 import { FormGroup, FormControl } from '@angular/forms';
-import * as _praxisui_core from '@praxisui/core';
 import { PraxisExportFormat, PraxisExportScope, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, RichBlockHostCapabilities, SurfaceOpenActionEditorComponent, GlobalActionCatalogEntry, SurfaceOpenPayload, SettingsValueProvider as SettingsValueProvider$1, RichPresenterNode, RichComposeNode, ComponentDocMeta, AiCapabilityCategory, AiCapabilityCatalog, AiValueKind, ComponentAuthoringManifest } from '@praxisui/core';
 import { BaseAiAdapter, AiResponseCompileResult, PatchResult, PraxisAssistantTurnViewState, PraxisAssistantShellLayout, PraxisAssistantShellLabels, PraxisAssistantSessionSnapshot, PraxisAssistantShellQuickReply, PraxisAssistantShellMessage } from '@praxisui/ai';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import * as _praxisui_list from '@praxisui/list';
 
-type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'html' | 'slot' | 'metric' | 'compose' | 'component';
+type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'datetime' | 'relative' | 'html' | 'slot' | 'metric' | 'compose' | 'component';
 interface TemplateDef {
     type: TemplateType;
     expr?: string;
@@ -122,8 +121,11 @@ interface ListExpansionSectionDef {
 }
 type ListTemplatingSlot = 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'identity' | 'balance' | 'limit' | 'risk' | 'alerts' | 'owner';
 type ListRowLayoutSlot = ListTemplatingSlot | 'actions' | 'expand';
+type ListCardColumns = 'auto' | 1 | 2 | 3 | 4;
+type ListItemStateTone = 'neutral' | 'primary' | 'success' | 'warning' | 'danger' | 'muted';
 interface ListItemStyleEffect {
     kind?: 'item-style';
+    tone?: ListItemStateTone;
     class?: string;
     style?: string;
     border?: string;
@@ -147,6 +149,45 @@ interface ListSlotOverrideRule extends Omit<PraxisRuntimeConditionalEffectRule<L
     condition?: JsonLogicExpression | null;
     effects?: ListSlotOverrideEffect[];
 }
+interface PraxisListVirtualScrollConfig {
+    enabled: boolean;
+    itemSize?: number;
+    minBufferPx?: number;
+    maxBufferPx?: number;
+    viewportHeight?: string;
+}
+interface PraxisListItemAction {
+    id: string;
+    icon?: string;
+    label?: string;
+    color?: string;
+    tooltip?: string;
+    kind?: 'icon' | 'button' | 'menu-item';
+    buttonVariant?: 'stroked' | 'raised' | 'flat';
+    showIf?: JsonLogicExpression | null;
+    visibleWhen?: JsonLogicExpression | null;
+    disabledWhen?: JsonLogicExpression | null;
+    /**
+     * Condição HATEOAS canônica: se especificado, a ação só é exibida
+     * se o item possuir o link correspondente em `item._links[hateoasRel]` ou `item.links[hateoasRel]`.
+     */
+    hateoasRel?: string;
+    emitPayload?: 'item' | 'id' | 'value';
+    action?: 'surface.open' | string;
+    recordOpen?: ResourceRecordOpenRef;
+    globalAction?: GlobalActionRef;
+    command?: string;
+    params?: Record<string, unknown>;
+    emitLocal?: boolean;
+    showLoading?: boolean;
+    placement?: 'actions' | 'trailing' | 'menu';
+    confirmation?: {
+        title?: string;
+        message?: string;
+        type?: 'danger' | 'warning' | 'info';
+    };
+    requiresConfirmation?: boolean;
+}
 interface PraxisListConfig {
     id?: string;
     dataSource?: {
@@ -159,12 +200,25 @@ interface PraxisListConfig {
         variant?: 'list' | 'cards' | 'tiles';
         density?: 'default' | 'comfortable' | 'compact';
         itemSpacing?: 'none' | 'tight' | 'default' | 'relaxed';
+        itemAppearance?: 'flat' | 'card' | 'capsule';
         lines?: 1 | 2 | 3;
         dividers?: 'none' | 'between' | 'all';
         model?: 'standard' | 'media' | 'hotel';
+        /**
+         * Structured column count for cards/tiles grids without requiring raw CSS.
+         */
+        cardColumns?: ListCardColumns;
+        /**
+         * Minimum card/tile track width when cardColumns is 'auto' (e.g. '240px', '300px', '340px').
+         */
+        cardMinWidth?: string;
+        /**
+         * Minimum card surface height (e.g. 'auto', '148px', '188px', '220px').
+         */
+        cardMinHeight?: string;
         groupBy?: string;
         stickySectionHeader?: boolean;
-        virtualScroll?: boolean;
+        virtualScroll?: boolean | PraxisListVirtualScrollConfig;
         pageSize?: number;
         rowLayout?: {
             type?: 'grid' | 'flex';
@@ -284,27 +338,10 @@ interface PraxisListConfig {
             errorTemplate?: TemplateDef;
         };
     };
-    actions?: Array<{
-        id: string;
-        icon?: string;
-        label?: string;
-        color?: string;
-        kind?: 'icon' | 'button';
-        buttonVariant?: 'stroked' | 'raised' | 'flat';
-        showIf?: JsonLogicExpression | null;
-        emitPayload?: 'item' | 'id' | 'value';
-        action?: 'surface.open';
-        recordOpen?: ResourceRecordOpenRef;
-        globalAction?: GlobalActionRef;
-        emitLocal?: boolean;
-        showLoading?: boolean;
-        placement?: 'actions' | 'trailing';
-        confirmation?: {
-            title?: string;
-            message?: string;
-            type?: 'danger' | 'warning' | 'info';
-        };
-    }>;
+    /** Ações declarativas de item governadas (compatível com itemActions) */
+    actions?: PraxisListItemAction[];
+    /** Ações declarativas de item com HATEOAS e despacho canônico */
+    itemActions?: PraxisListItemAction[];
     i18n?: PraxisListI18nConfig;
     ui?: {
         showSearch?: boolean;
@@ -488,6 +525,8 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     form?: FormGroup | null;
     set enableCustomization(value: boolean);
     get enableCustomization(): boolean;
+    itemActions?: PraxisListItemAction[];
+    virtualScroll?: boolean | PraxisListVirtualScrollConfig;
     itemClick: EventEmitter<ListItemEvent>;
     actionClick: EventEmitter<ListActionEvent>;
     selectionChange: EventEmitter<ListSelectionEvent>;
@@ -669,27 +708,17 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     hasSkeleton(): boolean;
     skeletonCount(): number;
     skeletonItems(): any[];
-    visibleActions(item: any, placement?: 'actions' | 'trailing'): {
-        id: string;
-        icon?: string;
-        label?: string;
-        color?: string;
-        kind?: "icon" | "button";
-        buttonVariant?: "stroked" | "raised" | "flat";
-        showIf?: JsonLogicExpression | null;
-        emitPayload?: "item" | "id" | "value";
-        action?: "surface.open";
-        recordOpen?: ResourceRecordOpenRef;
-        globalAction?: GlobalActionRef;
-        emitLocal?: boolean;
-        showLoading?: boolean;
-        placement?: "actions" | "trailing";
-        confirmation?: {
-            title?: string;
-            message?: string;
-            type?: "danger" | "warning" | "info";
-        };
-    }[];
+    isVirtualScrollEnabled(): boolean;
+    virtualScrollItemSize(): number;
+    virtualScrollMinBufferPx(): number;
+    virtualScrollMaxBufferPx(): number;
+    virtualScrollViewportHeight(): string;
+    virtualScrollItems(sections: ListSection<any>[] | null | undefined, items: any[] | null | undefined): any[];
+    trackByVirtualItem: (index: number, item: any) => any;
+    private warnOnIncompatibleVirtualScroll;
+    effectiveActions(): PraxisListItemAction[];
+    hasHateoasLink(item: any, rel: string): boolean;
+    visibleActions(item: any, placement?: 'actions' | 'trailing' | 'menu'): PraxisListItemAction[];
     onItemClick(item: any, index: number, section?: string): void;
     onRowActivate(item: any, index: number, section?: string): void;
     onExpandToggle(event: Event, item: any, index: number): void;
@@ -844,6 +873,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private toBoolean;
     private prettyLabel;
     private mapDateStyle;
+    private mapDateTimeStyle;
     starIcon(index: number, ratingValue: string | number): string;
     isThemeColor(color?: string): boolean;
     chipStyle(color?: string, variant?: 'filled' | 'outlined'): string;
@@ -881,7 +911,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private normalizeExpansionItems;
     private normalizeKeyValueItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisList, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "exportAction": "exportAction"; "configPatchChange": "configPatchChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "configPersistenceStrategy": { "alias": "configPersistenceStrategy"; "required": false; }; "queryContext": { "alias": "queryContext"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "itemActions": { "alias": "itemActions"; "required": false; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; "exportAction": "exportAction"; "configPatchChange": "configPatchChange"; }, never, never, true, never>;
     static ngAcceptInputType_enableCustomization: unknown;
 }
 
@@ -1184,9 +1214,12 @@ type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'se
         lines: 1 | 2 | 3;
         dividers?: 'none' | 'between' | 'all';
         model?: 'standard' | 'media' | 'hotel';
+        cardColumns?: ListCardColumns;
+        cardMinWidth?: string;
+        cardMinHeight?: string;
         groupBy?: string;
         stickySectionHeader?: boolean;
-        virtualScroll?: boolean;
+        virtualScroll?: boolean | PraxisListVirtualScrollConfig;
         pageSize?: number;
         rowLayout?: NonNullable<PraxisListConfig['layout']>['rowLayout'];
     };
@@ -1413,6 +1446,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     queryJson: string;
     queryError: string;
     actionShowIfDrafts: Record<number, string>;
+    private stashedLocalData?;
     private crud;
     private readonly i18n;
     private resourcePathChanges;
@@ -1443,7 +1477,15 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private syncSortStateFromWorking;
     private resetVisualMappingState;
     private setupSchemaWatcher;
+    loadFieldsFromResource(resourcePath: string): void;
     onResourcePathChange(value: string): void;
+    hasRemoteResourcePath(): boolean;
+    getActiveDataSourceMode(): 'local' | 'remote' | 'empty';
+    getActiveDataSourceLabel(): string;
+    hasStashedLocalData(): boolean;
+    useRemoteResource(): void;
+    clearLocalData(): void;
+    restoreLocalData(): void;
     getLocalDataRows(): any[];
     getLocalDataSummary(): string;
     getLocalDataPrecedenceWarning(): string;
@@ -1565,6 +1607,19 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     ngDoCheck(): void;
     reset(): void;
     onLayoutChanged(): void;
+    virtualScrollEnabled(): boolean;
+    onVirtualScrollEnabledChange(enabled: boolean): void;
+    getVirtualScrollViewportHeight(): string;
+    onVirtualScrollViewportHeightChange(value: string): void;
+    getVirtualScrollItemSize(): number | undefined;
+    onVirtualScrollItemSizeChange(value: any): void;
+    getVirtualScrollMinBufferPx(): number | undefined;
+    onVirtualScrollMinBufferPxChange(value: any): void;
+    getVirtualScrollMaxBufferPx(): number | undefined;
+    onVirtualScrollMaxBufferPxChange(value: any): void;
+    getVirtualScrollCompatibilityWarning(): string;
+    private ensureVirtualScrollObjectDraft;
+    private collapseVirtualScrollDraftIfDefault;
     rowLayoutEnabled(): boolean;
     onRowLayoutEnabledChange(enabled: boolean): void;
     applyCorporateRowLayoutPreset(): void;
@@ -1642,6 +1697,49 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     onRuleConditionChanged(rule: {
         condition?: JsonLogicExpression | null;
     }, raw: string): void;
+    readonly cardColumnsOptions: readonly ListCardColumns[];
+    readonly ruleConditionOperators: readonly ["==", "!=", ">", ">=", "<", "<="];
+    readonly itemStateToneOptions: ReadonlyArray<{
+        value: ListItemStateTone;
+        label: string;
+        cssClass: string;
+        border: string;
+        background: string;
+    }>;
+    getCardColumnsModel(): ListCardColumns;
+    onCardColumnsChange(value: ListCardColumns): void;
+    applyCardWidthPreset(width: string): void;
+    applyCardHeightPreset(height: string): void;
+    onStatusPositionChange(position: 'inline' | 'top-right' | undefined): void;
+    applyStandardStatusColorMap(): void;
+    getSlotAnatomyItems(): Array<{
+        slot: 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'features';
+        label: string;
+        role: string;
+        mapped: boolean;
+        summary: string;
+    }>;
+    isSlotMapped(slot: 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'features'): boolean;
+    getSlotMappingSummary(slot: 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'features'): string;
+    applyDidacticSlotPreset(preset: 'operational-card' | 'executive-compact-card' | 'dense-list'): void;
+    applyItemStyleTonePreset(rule: ListItemStyleRule, tone: ListItemStateTone): void;
+    private parseSimpleRuleCondition;
+    getGuidedRuleConditionField(rule: {
+        condition?: JsonLogicExpression | null;
+    }): string;
+    getGuidedRuleConditionOperator(rule: {
+        condition?: JsonLogicExpression | null;
+    }): string;
+    getGuidedRuleConditionValue(rule: {
+        condition?: JsonLogicExpression | null;
+    }): string;
+    onGuidedRuleConditionChange(rule: {
+        condition?: JsonLogicExpression | null;
+    }, patch: {
+        field?: string;
+        operator?: string;
+        value?: string;
+    }): void;
     getItemStyleEffect(rule: ListItemStyleRule): ListItemStyleEffect | undefined;
     ensureItemStyleEffect(rule: ListItemStyleRule): void;
     clearItemStyleEffects(rule: ListItemStyleRule): void;
@@ -1694,6 +1792,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private insertIntoFeatureExpr;
     private updateFeatureExpr;
     private hydrateMappingFromTemplating;
+    private syncDirtyStateNow;
     markDirty(): void;
     private getMappingSnapshot;
     private updateMappingDirty;
@@ -1821,6 +1920,9 @@ declare function evaluateTemplate(def: TemplateDef | undefined, item: any, optio
         variant?: 'filled' | 'outlined';
     };
 } | null;
+declare function safeFormatDate(date: Date, format?: string, locale?: string, style?: string): string;
+declare function safeFormatDateTime(date: Date, format?: string, locale?: string, style?: string): string;
+declare function formatRelativeTime(date: Date, locale?: string, baseDate?: Date): string;
 
 type ListRichContentP0Node = RichPresenterNode | RichComposeNode;
 declare function isListTemplateSupportedByRichContentP0(template?: TemplateDef | null): boolean;
@@ -1828,6 +1930,7 @@ declare function mapListTemplateToRichContentP0(template?: TemplateDef | null):
 
 declare function adaptSelection(config: PraxisListConfig | undefined, items: any[]): ListSelectionEvent;
 
+declare const PRAXIS_LIST_INSERTION_PRESETS: NonNullable<ComponentDocMeta['insertionPresets']>;
 declare const PRAXIS_LIST_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisListMetadata(): Provider;
 
@@ -1986,9 +2089,13 @@ declare class PraxisListDocPageComponent {
                 model: "hotel";
                 groupBy: undefined;
                 itemSpacing?: "none" | "tight" | "default" | "relaxed";
+                itemAppearance?: "flat" | "card" | "capsule";
                 dividers?: "none" | "between" | "all";
+                cardColumns?: _praxisui_list.ListCardColumns;
+                cardMinWidth?: string;
+                cardMinHeight?: string;
                 stickySectionHeader?: boolean;
-                virtualScroll?: boolean;
+                virtualScroll?: boolean | _praxisui_list.PraxisListVirtualScrollConfig;
                 pageSize?: number;
                 rowLayout?: {
                     type?: "grid" | "flex";
@@ -2108,27 +2215,8 @@ declare class PraxisListDocPageComponent {
                     errorTemplate?: _praxisui_list.TemplateDef;
                 };
             };
-            actions?: Array<{
-                id: string;
-                icon?: string;
-                label?: string;
-                color?: string;
-                kind?: "icon" | "button";
-                buttonVariant?: "stroked" | "raised" | "flat";
-                showIf?: _praxisui_core.JsonLogicExpression | null;
-                emitPayload?: "item" | "id" | "value";
-                action?: "surface.open";
-                recordOpen?: _praxisui_core.ResourceRecordOpenRef;
-                globalAction?: _praxisui_core.GlobalActionRef;
-                emitLocal?: boolean;
-                showLoading?: boolean;
-                placement?: "actions" | "trailing";
-                confirmation?: {
-                    title?: string;
-                    message?: string;
-                    type?: "danger" | "warning" | "info";
-                };
-            }>;
+            actions?: _praxisui_list.PraxisListItemAction[];
+            itemActions?: _praxisui_list.PraxisListItemAction[];
             i18n?: _praxisui_list.PraxisListI18nConfig;
             ui?: {
                 showSearch?: boolean;
@@ -2224,6 +2312,14 @@ declare const PRAXIS_LIST_EN_US: {
     readonly Appearance: "Appearance";
     readonly 'Assistant-applied adjustments replace the entire configuration object.': "Assistant-applied adjustments replace the entire configuration object.";
     readonly 'applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.': "applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.";
+    readonly 'Configure how the list loads records: connect a remote API resource or keep local/sample items.': "Configure how the list loads records: connect a remote API resource or keep local/sample items.";
+    readonly 'When local/sample items (dataSource.data) are present, they take precedence over the remote API resource (resourcePath). Switch to the remote resource when you are ready to load live data.': "When local/sample items (dataSource.data) are present, they take precedence over the remote API resource (resourcePath). Switch to the remote resource when you are ready to load live data.";
+    readonly 'Active data source': "Active data source";
+    readonly 'Local / sample data': "Local / sample data";
+    readonly 'Remote resource (API)': "Remote resource (API)";
+    readonly 'No data source configured': "No data source configured";
+    readonly 'Use remote resource (remove local data)': "Use remote resource (remove local data)";
+    readonly 'Restore local data': "Restore local data";
     readonly 'Resource (API)': "Resource (API)";
     readonly 'List resource': "List resource";
     readonly 'Select resource': "Select resource";
@@ -2612,6 +2708,14 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly Appearance: "Aparência";
     readonly 'Assistant-applied adjustments replace the entire configuration object.': "Observação: ajustes aplicados pelo assistente substituem o objeto de configuração inteiro.";
     readonly 'applyConfigFromAdapter does not perform a deep merge. Make sure the adapter sends the full config.': "O applyConfigFromAdapter não faz merge profundo. Garanta que o adapter envie a configuração completa.";
+    readonly 'Configure how the list loads records: connect a remote API resource or keep local/sample items.': "Defina como a lista carrega os registros: conecte um recurso remoto (API) ou mantenha itens locais/de exemplo.";
+    readonly 'When local/sample items (dataSource.data) are present, they take precedence over the remote API resource (resourcePath). Switch to the remote resource when you are ready to load live data.': "Quando há itens locais/de exemplo (dataSource.data), eles têm precedência sobre o recurso remoto (resourcePath). Alterne para o recurso remoto quando quiser carregar dados reais da API.";
+    readonly 'Active data source': "Fonte ativa";
+    readonly 'Local / sample data': "Dados locais / de exemplo";
+    readonly 'Remote resource (API)': "Recurso remoto (API)";
+    readonly 'No data source configured': "Nenhuma fonte configurada";
+    readonly 'Use remote resource (remove local data)': "Usar recurso remoto (remover dados locais)";
+    readonly 'Restore local data': "Restaurar dados locais";
     readonly 'Resource (API)': "Recurso (API)";
     readonly 'List resource': "Recurso da lista";
     readonly 'Select resource': "Selecionar recurso";
@@ -2955,5 +3059,5 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly 'Advanced row CSS': "CSS avançado da linha";
 };
 
-export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_AUTHORING_MANIFEST, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, PraxisListWidgetConfigEditor, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListItemStyleEffect, ListItemStyleRule, ListProjectionContext, ListRemoteLoadError, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListSlotOverrideEffect, ListSlotOverrideRule, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, PraxisListWidgetEditorInputs, PraxisListWidgetEditorValue, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };
+export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_AUTHORING_MANIFEST, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_INSERTION_PRESETS, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, PraxisListWidgetConfigEditor, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, formatRelativeTime, inferListAuthoringDocument, inferTemplatingFromSchema, isListTemplateSupportedByRichContentP0, mapListTemplateToRichContentP0, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListI18n, providePraxisListMetadata, safeFormatDate, safeFormatDateTime, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
+export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, ExecutiveAlert, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListCardColumns, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, ListItemStateTone, ListItemStyleEffect, ListItemStyleRule, ListProjectionContext, ListRemoteLoadError, ListRichContentP0Node, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListSlotOverrideEffect, ListSlotOverrideRule, ListTemplatingSlot, ListValidationContext, PraxisListConfig, PraxisListExportConfig, PraxisListI18nConfig, PraxisListItemAction, PraxisListVirtualScrollConfig, PraxisListWidgetEditorInputs, PraxisListWidgetEditorValue, TemplateDef, TemplateEvaluatorOptions, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };