@praxisui/list 10.0.0-rc.4 → 10.0.0-rc.41

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 { PraxisExportFormat, PraxisExportScope, ResourceQuickViewBinding, PraxisRuntimeConditionalEffectRule, JsonLogicExpression, RichContentDocument, ResourceRecordOpenRef, GlobalActionRef, LocalizationConfig, AiCapability, PraxisDataQueryContext, RichBlockNode, EmptyAction, RichBlockHostCapabilities, ApiEndpoint, ApiUrlEntry, SurfaceOpenActionEditorComponent, DiscoveredResourceOption, 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;
@@ -79,6 +78,10 @@ interface TemplateDef {
         color?: string;
         variant?: 'filled' | 'outlined';
     };
+    /**
+     * Binding declarativo de Quick View transversal para slots/nós de item da lista.
+     */
+    quickView?: ResourceQuickViewBinding;
 }
 interface ListFeatureDef {
     icon?: string;
@@ -122,8 +125,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 +153,49 @@ 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' | 'quickView.open' | string;
+    recordOpen?: ResourceRecordOpenRef;
+    /**
+     * Binding declarativo de Quick View transversal para ação de item da lista.
+     */
+    quickView?: ResourceQuickViewBinding;
+    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 +208,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';
@@ -201,6 +263,12 @@ interface PraxisListConfig {
     };
     selection?: {
         mode?: 'none' | 'single' | 'multiple';
+        /**
+         * Controls whether the explicit checkbox/radio control is rendered on each row.
+         * Defaults to `true` when selection is enabled. Set to `false` to allow row-click
+         * selection without displaying a trailing radio/checkbox control.
+         */
+        showControl?: boolean;
         formControlName?: string;
         formControlPath?: string;
         compareBy?: string;
@@ -284,27 +352,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;
@@ -478,6 +529,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private static nextSkinScopeId;
     private customizationEnabled;
     private readonly hostLocale;
+    private readonly quickViewService;
     config: PraxisListConfig;
     listId: string;
     componentInstanceId?: string;
@@ -488,6 +540,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>;
@@ -510,6 +564,8 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private lastQuery;
     private lastRuntimeQueryContextSignature;
     private search$;
+    activeSearchTerm: string;
+    private searchInputRef?;
     get layoutLines(): number;
     boundControl: FormControl<unknown | unknown[] | null>;
     private selectionControlSubscription?;
@@ -585,6 +641,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     isCardsVariant(): boolean;
     isTilesVariant(): boolean;
     isSelectionEnabled(): boolean;
+    shouldShowSelectionControl(): boolean;
     private setupSelectionBinding;
     private watchSelectionControl;
     leading: (item: any) => Record<string, any> | null;
@@ -669,27 +726,19 @@ 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";
-        };
-    }[];
+    private isVirtualScrollConfigured;
+    isVirtualScrollEnabled(): boolean;
+    hasBoundedScrollViewport(): 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;
@@ -697,6 +746,13 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     configEditorLabel(): string;
     expandToggleAriaLabel(item: any, index: number): string;
     expansionRegionAriaLabel(item: any): string;
+    hasCustomEmptyStateTemplate(): boolean;
+    hasActiveEmptyStateFilters(): boolean;
+    emptyStateIcon(): string;
+    emptyStateTitle(): string;
+    emptyStateDescription(): string;
+    emptyStatePrimaryAction(): EmptyAction | undefined;
+    emptyStateSecondaryActions(): EmptyAction[];
     emptyStateLabel(): string;
     selectionListAriaLabel(): string | null;
     selectionControlName(): string;
@@ -706,6 +762,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private selectionItemsEqual;
     isResourceConnectionMissing(): boolean;
     onActionClick(ev: MouseEvent, actionId: string, item: any, index: number): Promise<void>;
+    listQuickViewQueryContext(): Record<string, unknown> | null;
     private executeRecordOpenAction;
     private resolveRecordOpenService;
     private resolveActionFocusOrigin;
@@ -739,6 +796,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private getExportFileExtension;
     private getExportMimeType;
     private cloneForExportEvent;
+    openQuickConnect(): void;
     openConfigEditor(): void;
     private openConfigEditorPanel;
     openAiAssistant(): void;
@@ -774,6 +832,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     retryRemoteData(): void;
     private focusCollectionBeforeReload;
     onSearchInput(val: string): void;
+    clearSearch(): void;
     isRemoteDataMode(): boolean;
     activeSortValue(sort: string[] | undefined): string;
     hasSortOption(value: string): boolean;
@@ -798,6 +857,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     private storageKey;
     private componentKeyId;
     private readonly crud;
+    private readonly resourceDiscovery;
     private executeSchemaInferenceForPlan;
     private evalSlot;
     private resolveSlotTemplate;
@@ -844,10 +904,16 @@ 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;
+    private normalizeTemplatingMapKey;
+    private lookupTemplatingMapValue;
+    resolveSemanticTone(color?: string): 'info' | 'success' | 'warning' | 'danger' | 'neutral' | undefined;
+    private resolveSemanticBaseColor;
     chipStyle(color?: string, variant?: 'filled' | 'outlined'): string;
     iconStyle(color?: string): string;
+    leadingIconStyle(color?: string, extraStyle?: string): string;
     actionIconStyle(color?: string): string;
     buttonStyle(color?: string, variant?: 'stroked' | 'raised' | 'flat'): string;
     ratingMax(def?: any): number;
@@ -881,7 +947,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 +1250,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'];
     };
@@ -1210,6 +1279,7 @@ type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'se
         formControlPath?: string;
         compareBy?: string;
         return?: 'value' | 'item' | 'id';
+        showControl?: boolean;
     };
     i18n: {
         locale?: string;
@@ -1229,6 +1299,16 @@ type ExportPreviewRow = Record<string, string>;
 declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     config: PraxisListConfig;
     listId?: string;
+    /**
+     * Logical endpoint key used to scope catalog discovery and schema resolution
+     * in multi-module / multi-gateway hosts. Takes precedence over SETTINGS_PANEL_DATA when bound.
+     */
+    endpointKey?: ApiEndpoint;
+    /**
+     * Explicit API URL entry override used for catalog discovery and schema resolution.
+     * Takes precedence over SETTINGS_PANEL_DATA when bound.
+     */
+    apiUrlEntry?: ApiUrlEntry | null;
     document: ListAuthoringDocument;
     working: NormalizedListConfig;
     private readonly invalidSurfaceDrafts;
@@ -1248,8 +1328,28 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private initialJson;
     private lastJson;
     fields: string[];
+    fieldSearchQuery: string;
+    fieldMetaByName: Record<string, {
+        name: string;
+        label?: string;
+        type?: string;
+        description?: string;
+        enumValues?: string[];
+        optionLabels?: Record<string, string>;
+    }>;
+    selectedResourceOption: DiscoveredResourceOption | null;
+    schemaWarning: string;
     private lastResourcePath?;
     sortField?: string;
+    private normalizeFieldSearch;
+    onFieldSelectOpenedChange(_opened: boolean): void;
+    getFilteredFields(selected?: string | string[] | null): string[];
+    onDiscoveredResourceSelected(entry: DiscoveredResourceOption | null): void;
+    private extractFieldDomainMeta;
+    getFieldLabel(fieldName?: string | null): string;
+    getFieldTypeBadge(fieldName?: string | null): string;
+    getFieldDescription(fieldName?: string | null): string;
+    getFieldTriggerLabel(fieldName?: string | null): string;
     sortDir: 'asc' | 'desc';
     mappingPrimary: {
         field?: string;
@@ -1413,7 +1513,10 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     queryJson: string;
     queryError: string;
     actionShowIfDrafts: Record<number, string>;
+    private stashedLocalData?;
+    private stashedLocalTemplating?;
     private crud;
+    private readonly resourceDiscovery;
     private readonly i18n;
     private resourcePathChanges;
     constructor(injected?: any);
@@ -1442,8 +1545,21 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private snapshotCurrentDocument;
     private syncSortStateFromWorking;
     private resetVisualMappingState;
+    private buildDiscoveryOptions;
     private setupSchemaWatcher;
+    private shouldAutoInferSlots;
+    private pendingRemoteSlotInference;
+    private lastNonEmptyResourcePath;
+    syncSchemaFieldsFromWorking(immediate?: boolean): void;
+    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;
@@ -1457,6 +1573,16 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     applySalaryPreset(): void;
     applyPricePreset(): void;
     private applyCurrencyPreset;
+    private resolveStatusDomainField;
+    private inferSemanticStatusColor;
+    resolveDomainColorMapEntries(explicitField?: string): Array<{
+        key: string;
+        color: string;
+    }>;
+    resolveDomainLabelMapEntries(explicitField?: string): Array<{
+        key: string;
+        label: string;
+    }>;
     private defaultStatusColorMapEntries;
     previewData: {
         title: string;
@@ -1565,6 +1691,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 +1781,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 +1876,7 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private insertIntoFeatureExpr;
     private updateFeatureExpr;
     private hydrateMappingFromTemplating;
+    private syncDirtyStateNow;
     markDirty(): void;
     private getMappingSnapshot;
     private updateMappingDirty;
@@ -1708,6 +1891,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private looksLikeJsonPayload;
     private normalizeSurfaceOpenPayload;
     verify(): void;
+    private isGenericInferredChipColorMap;
+    private isGenericInferredChipLabelMap;
     inferFromFields(): void;
     generateFeaturesFromMetaComposition(): void;
     metaComposePreview(): string;
@@ -1720,13 +1905,15 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     private suggestIcon;
     getTypeIcon(type: string): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListConfigEditor, [{ optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListConfigEditor, "praxis-list-config-editor", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListConfigEditor, "praxis-list-config-editor", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; "endpointKey": { "alias": "endpointKey"; "required": false; }; "apiUrlEntry": { "alias": "apiUrlEntry"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 type PersistenceStrategy = 'input-first' | 'local-first' | 'volatile';
 interface PraxisListWidgetEditorInputs {
     config?: PraxisListConfig | null;
     listId?: string;
+    endpointKey?: ApiEndpoint;
+    apiUrlEntry?: ApiUrlEntry | null;
     [key: string]: unknown;
 }
 interface PraxisListWidgetEditorValue {
@@ -1735,6 +1922,7 @@ interface PraxisListWidgetEditorValue {
 declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, AfterViewInit, OnDestroy {
     inputs: PraxisListWidgetEditorInputs | null;
     widgetKey?: string;
+    context: Record<string, unknown>;
     listEditor?: PraxisListConfigEditor;
     readonly isDirty$: BehaviorSubject<boolean>;
     readonly isValid$: BehaviorSubject<boolean>;
@@ -1751,6 +1939,8 @@ declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, A
     private publishDirty;
     get config(): PraxisListConfig;
     get listId(): string | undefined;
+    get endpointKey(): ApiEndpoint | undefined;
+    get apiUrlEntry(): ApiUrlEntry | null | undefined;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     getSettingsValue(): PraxisListWidgetEditorValue;
@@ -1759,7 +1949,7 @@ declare class PraxisListWidgetConfigEditor implements SettingsValueProvider$1, A
     private initializeChildEditor;
     private buildValue;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListWidgetConfigEditor, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListWidgetConfigEditor, "praxis-list-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListWidgetConfigEditor, "praxis-list-widget-config-editor", never, { "inputs": { "alias": "inputs"; "required": false; }; "widgetKey": { "alias": "widgetKey"; "required": false; }; "context": { "alias": "context"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare function createListAuthoringDocument(source: {
@@ -1821,6 +2011,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 +2021,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;
 
@@ -1947,6 +2141,20 @@ interface DemoItem {
         title: string;
         meta: string;
         description: string;
+        badge?: string;
+        badgeTone?: string;
+        markerColor?: string;
+        icon?: string;
+        avatarText?: string;
+        children?: Array<{
+            label: string;
+            description: string;
+            meta?: string;
+            badge?: string;
+            badgeTone?: string;
+            markerColor?: string;
+            icon?: string;
+        }>;
     }>;
 }
 declare class PraxisListDocPageComponent {
@@ -1986,9 +2194,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 +2320,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;
@@ -2197,7 +2390,14 @@ declare const PRAXIS_LIST_EN_US: {
     readonly collapseDetails: "Collapse details";
     readonly itemDetails: "Item details";
     readonly emptyState: "No items available";
+    readonly emptyStateDescription: "There are no items to display right now.";
+    readonly emptyStateFilteredTitle: "No results found";
+    readonly emptyStateFilteredDescription: "Review the active filters or adjust the search term.";
+    readonly emptyStateClearSearchAction: "Clear search";
+    readonly emptyStateConnectResourceTitle: "Choose the list resource";
     readonly emptyStateConnectResource: "Connect this list to a resource to load items.";
+    readonly emptyStateConnectResourceAction: "Select resource";
+    readonly emptyStateConfigureAction: "Configure list";
     readonly recordOpenUnavailable: "Unable to open details for this item.";
     readonly 'selection.ariaLabel': "Selectable list";
     readonly 'selection.selectItem': "Select item";
@@ -2224,6 +2424,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";
@@ -2585,7 +2793,14 @@ declare const PRAXIS_LIST_PT_BR: {
     readonly collapseDetails: "Recolher detalhes";
     readonly itemDetails: "Detalhes do item";
     readonly emptyState: "Nenhum item disponível";
+    readonly emptyStateDescription: "Não há itens para exibir neste momento.";
+    readonly emptyStateFilteredTitle: "Nenhum resultado encontrado";
+    readonly emptyStateFilteredDescription: "Revise os filtros ou ajuste o termo de busca.";
+    readonly emptyStateClearSearchAction: "Limpar busca";
+    readonly emptyStateConnectResourceTitle: "Escolha o recurso da lista";
     readonly emptyStateConnectResource: "Conecte a lista a um recurso para carregar os itens.";
+    readonly emptyStateConnectResourceAction: "Selecionar recurso";
+    readonly emptyStateConfigureAction: "Configurar lista";
     readonly recordOpenUnavailable: "Não foi possível abrir os detalhes deste item.";
     readonly 'selection.ariaLabel': "Lista selecionável";
     readonly 'selection.selectItem': "Selecionar item";
@@ -2612,6 +2827,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 +3178,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 };