@praxisui/list 1.0.0-beta.64 → 1.0.0-beta.65

package/index.d.ts

@@ -1,6 +1,6 @@
 import * as rxjs from 'rxjs';
 import { BehaviorSubject, Observable } from 'rxjs';
-import * as _angular_core from '@angular/core';
+import * as i0 from '@angular/core';
 import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, ChangeDetectorRef, DoCheck, Provider } from '@angular/core';
 import { MatSelectionListChange } from '@angular/material/list';
 import { FormGroup, FormControl } from '@angular/forms';
@@ -8,10 +8,10 @@ import { BaseAiAdapter, Capability as Capability$1, PatchResult } from '@praxisu
 import { SettingsValueProvider } from '@praxisui/settings-panel';
 import { GlobalActionCatalogEntry, ComponentDocMeta, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 
-type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'html' | 'slot';
+type TemplateType = 'text' | 'icon' | 'image' | 'chip' | 'rating' | 'currency' | 'date' | 'html' | 'slot' | 'metric' | 'compose' | 'component';
 interface TemplateDef {
     type: TemplateType;
-    expr: string;
+    expr?: string;
     class?: string;
     style?: string;
     color?: string;
@@ -22,6 +22,54 @@ interface TemplateDef {
             size?: number;
             color?: string;
         };
+        metric?: {
+            label?: string;
+            valueExpr?: string;
+            caption?: string;
+            subcaption?: string;
+            captionPosition?: 'below-value' | 'below-progress';
+            icon?: string;
+            iconExpr?: string;
+            tone?: string;
+            toneExpr?: string;
+            layout?: 'value-only' | 'value+caption' | 'icon+value+caption' | 'stacked-center';
+            align?: 'start' | 'center' | 'end';
+            progress?: {
+                valueExpr?: string;
+                max?: number;
+                mode?: 'determinate' | 'indeterminate';
+                color?: string;
+                colorExpr?: string;
+                trackColor?: string;
+            };
+            valueClass?: string;
+            valueStyle?: string;
+            showBar?: boolean;
+            barValueExpr?: string;
+            barColor?: string;
+            barVariant?: 'determinate' | 'indeterminate';
+            legendExpr?: string;
+            iconPosition?: 'left' | 'right' | 'top';
+            iconColorExpr?: string;
+        };
+        compose?: {
+            items?: TemplateDef[];
+            direction?: 'row' | 'column';
+            align?: 'start' | 'center' | 'end';
+            gap?: string;
+            wrap?: boolean;
+            class?: string;
+            style?: string;
+            nodes?: TemplateDef[];
+            separator?: string;
+            orientation?: 'horizontal' | 'vertical';
+        };
+        component?: {
+            id: string;
+            inputs?: Record<string, any>;
+            class?: string;
+            style?: string;
+        };
     };
     imageAlt?: string;
     badge?: {
@@ -36,6 +84,38 @@ interface ListFeatureDef {
     class?: string;
     style?: string;
 }
+interface TemplateFeatureDef extends TemplateDef {
+    icon?: string;
+}
+type TemplatingFeatureDef = ListFeatureDef | TemplateFeatureDef;
+type ListExpansionSectionType = 'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component';
+interface ListExpansionSectionDef {
+    id: string;
+    title?: string;
+    type: ListExpansionSectionType;
+    itemsExpr?: string;
+    emptyLabel?: string;
+    metadata?: {
+        orientation?: 'horizontal' | 'vertical';
+        columns?: 1 | 2 | 3;
+        gap?: string;
+        keyClass?: string;
+        valueClass?: string;
+        keyStyle?: string;
+        valueStyle?: string;
+    };
+    component?: {
+        id: string;
+        inputs?: Record<string, any>;
+        class?: string;
+        style?: string;
+    };
+    class?: string;
+    style?: string;
+    showIf?: string;
+}
+type ListTemplatingSlot = 'leading' | 'primary' | 'secondary' | 'meta' | 'trailing' | 'identity' | 'balance' | 'limit' | 'risk' | 'alerts' | 'owner';
+type ListRowLayoutSlot = ListTemplatingSlot | 'actions' | 'expand';
 interface PraxisListConfig {
     id?: string;
     dataSource?: {
@@ -47,6 +127,7 @@ interface PraxisListConfig {
     layout?: {
         variant?: 'list' | 'cards' | 'tiles';
         density?: 'default' | 'comfortable' | 'compact';
+        itemSpacing?: 'none' | 'tight' | 'default' | 'relaxed';
         lines?: 1 | 2 | 3;
         dividers?: 'none' | 'between' | 'all';
         model?: 'standard' | 'media' | 'hotel';
@@ -54,6 +135,24 @@ interface PraxisListConfig {
         stickySectionHeader?: boolean;
         virtualScroll?: boolean;
         pageSize?: number;
+        rowLayout?: {
+            type?: 'grid' | 'flex';
+            columns?: Array<{
+                slot: ListRowLayoutSlot;
+                width?: string;
+                minWidth?: string;
+                maxWidth?: string;
+                align?: 'start' | 'center' | 'end';
+                justify?: 'start' | 'center' | 'end' | 'stretch';
+                class?: string;
+                style?: string;
+            }>;
+            gap?: string;
+            align?: 'start' | 'center' | 'end' | 'stretch';
+            itemAlignY?: 'start' | 'center' | 'end' | 'stretch';
+            class?: string;
+            style?: string;
+        };
     };
     skin?: {
         type?: 'pill-soft' | 'gradient-tile' | 'glass' | 'elevated' | 'outline' | 'flat' | 'neumorphism' | 'custom';
@@ -76,19 +175,31 @@ interface PraxisListConfig {
         compareBy?: string;
         return?: 'value' | 'item' | 'id';
     };
+    interaction?: {
+        expandable?: boolean;
+        expandTrigger?: 'row' | 'icon' | 'row+icon';
+        expandMode?: 'single' | 'multiple';
+        expandPlacement?: 'expand' | 'trailing';
+    };
     templating?: {
         leading?: TemplateDef;
         primary?: TemplateDef;
         secondary?: TemplateDef;
         meta?: TemplateDef;
         trailing?: TemplateDef;
+        identity?: TemplateDef;
+        balance?: TemplateDef;
+        limit?: TemplateDef;
+        risk?: TemplateDef;
+        alerts?: TemplateDef;
+        owner?: TemplateDef;
         metaPlacement?: 'side' | 'line';
         metaPrefixIcon?: string;
         statusPosition?: 'inline' | 'top-right';
         chipColorMap?: Record<string, string>;
         chipLabelMap?: Record<string, string>;
         iconColorMap?: Record<string, string>;
-        features?: ListFeatureDef[];
+        features?: TemplatingFeatureDef[];
         featuresVisible?: boolean;
         featuresMode?: 'icons+labels' | 'icons-only' | 'labels-only';
         sectionHeader?: TemplateDef;
@@ -97,6 +208,65 @@ interface PraxisListConfig {
             count?: number;
         };
     };
+    rules?: {
+        itemStyles?: Array<{
+            id: string;
+            condition?: string;
+            class?: string;
+            style?: string;
+            border?: string;
+            background?: string;
+        }>;
+        slotOverrides?: Array<{
+            id: string;
+            slot: ListTemplatingSlot;
+            condition?: string;
+            template?: TemplateDef;
+            class?: string;
+            style?: string;
+            hide?: boolean;
+        }>;
+    };
+    expansion?: {
+        sections?: ListExpansionSectionDef[];
+        dataSource?: {
+            mode?: 'inline' | 'resource' | 'resourcePath';
+            resource?: {
+                kind: string;
+                id: string;
+                version: string;
+            };
+            resourcePath?: {
+                path: string;
+                method?: 'GET' | 'POST';
+                paramsMap?: Record<string, string>;
+            };
+            resourceAllowList?: string[];
+            fallbackMode?: 'none' | 'inline' | 'resource';
+            cache?: {
+                enabled?: boolean;
+            };
+            cancelOnCollapse?: boolean;
+        };
+        schemaContract?: {
+            kind: 'praxis.detail.schema';
+            version: string;
+            allowedNodes?: Array<'info-list' | 'chip-list' | 'timeline' | 'key-value' | 'metadata' | 'component'>;
+            maxSections?: number;
+            maxItemsPerSection?: number;
+            requireSectionIds?: boolean;
+        };
+        rendering?: {
+            shell?: 'attached' | 'detached' | 'modal';
+            columns?: 1 | 2 | 3;
+            gap?: string;
+            padding?: string;
+            class?: string;
+            style?: string;
+            loadingTemplate?: TemplateDef;
+            errorTemplate?: TemplateDef;
+        };
+    };
     actions?: Array<{
         id: string;
         icon?: string;
@@ -110,6 +280,7 @@ interface PraxisListConfig {
         globalPayload?: any;
         emitLocal?: boolean;
         showLoading?: boolean;
+        placement?: 'actions' | 'trailing';
         confirmation?: {
             title?: string;
             message?: string;
@@ -197,8 +368,8 @@ declare class ListDataService<T = any> {
     private safeSerialize;
     private warnFilterFallbackOnce;
     private buildLogOptions;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListDataService<any>, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ListDataService<any>>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListDataService<any>, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ListDataService<any>>;
 }
 
 declare class ListAiAdapter extends BaseAiAdapter<PraxisListConfig> {
@@ -217,6 +388,16 @@ declare class ListAiAdapter extends BaseAiAdapter<PraxisListConfig> {
     private cloneConfig;
 }
 
+interface ListRowLayoutColumnViewModel {
+    slot: ListRowLayoutSlot;
+    width?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    align?: 'start' | 'center' | 'end';
+    justify?: 'start' | 'center' | 'end' | 'stretch';
+    class?: string;
+    style?: string;
+}
 declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private static nextSkinScopeId;
     config: PraxisListConfig;
@@ -256,6 +437,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly cdr;
     private readonly componentKeys;
     private readonly logger;
+    private readonly i18n;
     private readonly logContext;
     private readonly route;
     private readonly globalActions;
@@ -267,8 +449,11 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private externalConfigRevision;
     private nextActionItemObjectId;
     private readonly actionItemObjectIds;
+    private nextExpansionItemObjectId;
+    private readonly expansionItemObjectIds;
     private readonly destroy$;
     actionLoadingState: Record<string, boolean>;
+    private expandedItemKeys;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -282,20 +467,69 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     isTilesVariant(): boolean;
     isSelectionEnabled(): boolean;
     private setupSelectionBinding;
-    leading: (item: any) => any;
-    primary: (item: any) => any;
-    secondary: (item: any) => any;
-    meta: (item: any) => any;
-    trailing: (item: any) => any;
-    sectionHeaderTemplate: (key: string) => any;
-    emptyStateTemplate: () => any;
-    featureLabel(item: any, expr: string): string;
+    leading: (item: any) => Record<string, any> | null;
+    primary: (item: any) => Record<string, any> | null;
+    secondary: (item: any) => Record<string, any> | null;
+    meta: (item: any) => Record<string, any> | null;
+    trailing: (item: any) => Record<string, any> | null;
+    identity: (item: any) => Record<string, any> | null;
+    balance: (item: any) => Record<string, any> | null;
+    limit: (item: any) => Record<string, any> | null;
+    risk: (item: any) => Record<string, any> | null;
+    alerts: (item: any) => Record<string, any> | null;
+    owner: (item: any) => Record<string, any> | null;
+    sectionHeaderTemplate: (key: string) => Record<string, any>;
+    emptyStateTemplate: () => Record<string, any>;
+    itemRuleClass(item: any): string | undefined;
+    itemRuleStyle(item: any): string | undefined;
+    rowLayoutItemStyle(item: any): string | undefined;
+    rowLayoutItemClass(item: any): string | undefined;
+    hasRowLayoutGrid(): boolean;
+    rowLayoutColumns(): ListRowLayoutColumnViewModel[];
+    rowLayoutTrackColumn(index: number, column: ListRowLayoutColumnViewModel): string;
+    rowLayoutContentStyle(): string | undefined;
+    rowLayoutContentClass(): string | undefined;
+    rowLayoutColumnClass(column: ListRowLayoutColumnViewModel): string | undefined;
+    rowLayoutColumnStyle(column: ListRowLayoutColumnViewModel): string | undefined;
+    rowLayoutSlot(item: any, slot: string): Record<string, any> | null;
+    rowLayoutHasSlot(slot: ListRowLayoutSlot): boolean;
+    rowLayoutImageAlt(slot: string): string;
+    rowLayoutAlignItems(): 'start' | 'center' | 'end' | 'stretch';
+    private rowLayoutTemplateColumns;
+    private rowLayoutColumnWidth;
+    private rowLayoutTextAlign;
+    private cssVar;
+    private sanitizeCssToken;
+    featureLabel(item: any, expr?: string): string;
+    plainText(value: string | null | undefined): string | null;
+    itemAriaLabel(item: any): string | null;
+    private accessibleItemLabel;
+    private slotAriaLabel;
+    private nodeAriaLabel;
+    featureLabelLines(item: any, expr?: string): string[];
+    featureSemanticClass(item: any, expr?: string, featureClass?: string): string | null;
+    featureProgressPercent(item: any, expr?: string, featureClass?: string): number | null;
+    private metricText;
+    private metricToken;
+    private buildMetricView;
+    private buildComposeView;
+    private buildMetricProgress;
+    private metricLayout;
+    private metricAlign;
+    private metricIconPosition;
+    private metricToneClass;
+    private metricToneStyle;
+    private metricColorStyle;
+    private metricCssVar;
+    private resolveMetricColor;
+    private joinStyles;
+    private joinClasses;
     featuresVisible(): boolean;
     featuresMode(): 'icons+labels' | 'icons-only' | 'labels-only';
     hasSkeleton(): boolean;
     skeletonCount(): number;
     skeletonItems(): any[];
-    visibleActions(item: any): {
+    visibleActions(item: any, placement?: 'actions' | 'trailing'): {
         id: string;
         icon?: string;
         label?: string;
@@ -308,6 +542,7 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
         globalPayload?: any;
         emitLocal?: boolean;
         showLoading?: boolean;
+        placement?: "actions" | "trailing";
         confirmation?: {
             title?: string;
             message?: string;
@@ -315,7 +550,14 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
         };
     }[];
     onItemClick(item: any, index: number, section?: string): void;
+    onRowActivate(item: any, index: number, section?: string): void;
+    onRowSpaceActivate(event: Event, clickable: boolean, item: any, index: number, section?: string): void;
+    onExpandToggle(event: Event, item: any, index: number): void;
     onActionKeydown(ev: Event): void;
+    configEditorLabel(): string;
+    expandToggleAriaLabel(item: any, index: number): string;
+    expansionRegionAriaLabel(item: any): string;
+    emptyStateLabel(): string;
     onActionClick(ev: MouseEvent, actionId: string, item: any, index: number): Promise<void>;
     private isGlobalCommand;
     private resolveActionPayload;
@@ -349,6 +591,33 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     private readonly crud;
     private executeSchemaInferenceForPlan;
     private evalSlot;
+    private resolveSlotTemplate;
+    private evaluateTemplateNode;
+    private buildUnsupportedComposeNode;
+    private buildRuntimeComponentView;
+    private resolveComponentInputs;
+    private resolveComponentInputValue;
+    private resolveComponentStringInput;
+    isExpandable(): boolean;
+    expandableByRow(): boolean;
+    expansionOwnedByRow(): boolean;
+    expansionOwnedByIcon(): boolean;
+    showExpandIcon(placement?: 'expand' | 'trailing'): boolean;
+    expandPlacement(): 'expand' | 'trailing';
+    private actionPlacement;
+    isExpanded(item: any, index: number): boolean;
+    expandRegionId(item: any, index: number): string;
+    expansionSections(): ListExpansionSectionDef[];
+    expansionSectionItems(item: any, section: ListExpansionSectionDef, index?: number): any[];
+    expansionSectionHasContent(item: any, section: ListExpansionSectionDef, index?: number): boolean;
+    expansionItemLabel(value: any): string;
+    expansionInfoTitle(value: any): string;
+    expansionInfoValue(value: any): string;
+    expansionTimelineTitle(value: any): string;
+    expansionTimelineMeta(value: any): string;
+    expansionTimelineDescription(value: any): string;
+    expansionKeyValueKey(value: any): string;
+    expansionKeyValueValue(value: any): string;
     private splitPipe;
     private splitPipeName;
     private evalString;
@@ -369,15 +638,225 @@ declare class PraxisList implements OnInit, OnChanges, OnDestroy {
     trackByItem: (i: number, it: any) => any;
     isActionLoading(actionId: string, item: any, index: number): boolean;
     private evaluateActionVisibility;
-    private resolveShowIfOperand;
+    private evaluateRuntimeCondition;
+    private normalizeConditionExpression;
+    private resolveConditionOperand;
     private looseEquals;
-    private warnInvalidShowIfOnce;
+    private warnInvalidConditionOnce;
+    private cloneTemplateDef;
+    private mergeTemplateDefs;
+    private mergePlainObjects;
     private buildActionLoadingKey;
     private ensureActionItemObjectId;
     private warnGlobalCommandUnavailableOnce;
     private buildLogOptions;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisList, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisList, "praxis-list", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; }, never, never, true, never>;
+    private toggleExpanded;
+    private syncExpansionState;
+    private itemExpansionKey;
+    private t;
+    private ensureExpansionItemObjectId;
+    private sanitizeDomId;
+    private evaluateExpansionExpr;
+    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; }; "form": { "alias": "form"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, { "itemClick": "itemClick"; "actionClick": "actionClick"; "selectionChange": "selectionChange"; }, never, never, true, never>;
+}
+
+/**
+ * Executive badge component for displaying account segment classification.
+ *
+ * This component replaces legacy HTML string-based badges with a type-safe,
+ * encapsulated solution that bypasses Angular's DomSanitizer restrictions.
+ *
+ * @remarks
+ * - Fully WCAG 2.1 AA compliant with proper ARIA attributes
+ * - Uses OnPush change detection for optimal performance
+ * - Supports three segment variants: enterprise, corporate, middle
+ * - Colors follow corporate branding guidelines
+ * - Input validation prevents invalid runtime values
+ *
+ * @example Basic usage
+ * ```html
+ * <praxis-executive-badge variant="enterprise">
+ *   Enterprise
+ * </praxis-executive-badge>
+ * ```
+ *
+ * @example Dynamic variant with custom label
+ * ```html
+ * <praxis-executive-badge
+ *   [variant]="account.segmentType"
+ *   [ariaLabel]="'Account segment: ' + account.segmentLabel">
+ *   {{ account.segmentLabel }}
+ * </praxis-executive-badge>
+ * ```
+ *
+ * @see {@link ExecutiveAlertsComponent} for related alert component
+ * @see WCAG 2.1 Level AA - Guideline 4.1.2 (Name, Role, Value)
+ *
+ * @public
+ */
+declare class ExecutiveBadgeComponent {
+    /**
+     * Custom ARIA label for screen readers.
+     * If not provided, defaults to "Segment badge: {variant}"
+     */
+    ariaLabel?: string;
+    private _variant;
+    /**
+     * Badge variant type with runtime validation.
+     * Valid values: 'enterprise', 'corporate', 'middle'
+     * Invalid values will default to 'enterprise' with console warning.
+     */
+    set variant(value: 'enterprise' | 'corporate' | 'middle');
+    get variant(): 'enterprise' | 'corporate' | 'middle';
+    get variantClass(): string;
+    /**
+     * Computed ARIA label for accessibility.
+     * Uses custom ariaLabel if provided, otherwise generates default.
+     */
+    get computedAriaLabel(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExecutiveBadgeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExecutiveBadgeComponent, "praxis-executive-badge", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; }, {}, never, ["*"], true, never>;
+}
+
+/**
+ * Alert data interface for executive alerts component.
+ *
+ * @property type - Alert severity level (warning or critical)
+ * @property count - Number of alerts of this type (must be >= 0)
+ */
+interface ExecutiveAlert {
+    type: 'warning' | 'critical';
+    count: number;
+}
+/**
+ * Executive alerts component for displaying warning and critical account flags.
+ *
+ * This component replaces legacy HTML string-based alerts with a fully
+ * accessible, WCAG 2.1 AA compliant solution.
+ *
+ * @remarks
+ * **Accessibility Features:**
+ * - WCAG 1.3.1: Semantic structure with proper roles
+ * - WCAG 1.4.1: Does not rely on color alone (uses icons + text)
+ * - WCAG 4.1.3: Status messages properly announced to screen readers
+ * - aria-live regions for dynamic updates
+ * - Screen-reader only text for full context
+ *
+ * **Performance:**
+ * - OnPush change detection strategy
+ * - Input validation prevents invalid data
+ * - Optimized trackBy function
+ *
+ * @example Basic usage
+ * ```html
+ * <praxis-executive-alerts [alerts]="[
+ *   { type: 'warning', count: 1 },
+ *   { type: 'critical', count: 2 }
+ * ]"></praxis-executive-alerts>
+ * ```
+ *
+ * @example Empty state (renders nothing)
+ * ```html
+ * <praxis-executive-alerts [alerts]="[]"></praxis-executive-alerts>
+ * ```
+ *
+ * @see WCAG 2.1 Level AA - Guidelines 1.3.1, 1.4.1, 4.1.3
+ * @public
+ */
+declare class ExecutiveAlertsComponent implements OnChanges {
+    alerts: ExecutiveAlert[];
+    /**
+     * Validated and filtered alerts.
+     * Only valid alerts (correct type and count >= 0) are included.
+     */
+    validAlerts: ExecutiveAlert[];
+    ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Validates alerts array and filters out invalid entries.
+     * Logs warnings for invalid data in development mode.
+     */
+    private validateAndFilterAlerts;
+    /**
+     * TrackBy function for optimal rendering performance.
+     * Uses combination of type and count for unique identification.
+     */
+    trackByAlert(index: number, alert: ExecutiveAlert): string;
+    /**
+     * Generates ARIA label for alert badge.
+     * Provides concise description for screen readers.
+     */
+    getAlertAriaLabel(alert: ExecutiveAlert): string;
+    /**
+     * Generates detailed description for screen readers.
+     * Provides full context including severity and actionability.
+     */
+    getAlertDescription(alert: ExecutiveAlert): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExecutiveAlertsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExecutiveAlertsComponent, "praxis-executive-alerts", never, { "alerts": { "alias": "alerts"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Executive owner component displaying account owner with accessible avatar.
+ *
+ * This component replaces legacy HTML string-based owner displays with a
+ * fully accessible, WCAG 2.1 AA compliant solution featuring an inline SVG avatar.
+ *
+ * @remarks
+ * **Accessibility Features:**
+ * - WCAG 1.1.1: Non-text content has text alternative (SVG with role and aria-label)
+ * - SVG includes <title> element for tooltips
+ * - Handles empty/undefined names gracefully
+ * - Screen reader announces owner information clearly
+ *
+ * **Performance:**
+ * - OnPush change detection strategy
+ * - Input validation for name
+ * - Lightweight inline SVG (no external dependencies)
+ *
+ * @example Basic usage
+ * ```html
+ * <praxis-executive-owner name="Ana Carolina"></praxis-executive-owner>
+ * ```
+ *
+ * @example With empty name (shows fallback)
+ * ```html
+ * <praxis-executive-owner name=""></praxis-executive-owner>
+ * <!-- Displays: "Unassigned" -->
+ * ```
+ *
+ * @see WCAG 2.1 Level AA - Guideline 1.1.1 (Non-text Content)
+ * @public
+ */
+declare class ExecutiveOwnerComponent {
+    private _name;
+    /**
+     * Owner name with automatic validation and sanitization.
+     * - Empty strings default to "Unassigned"
+     * - Trimmed and limited to 50 characters
+     * - Null/undefined converted to empty string
+     */
+    set name(value: string);
+    get name(): string;
+    /**
+     * Display name with fallback for empty values.
+     * Returns "Unassigned" if name is empty.
+     */
+    get displayName(): string;
+    /**
+     * ARIA label for SVG avatar.
+     * Provides context for screen readers.
+     */
+    get avatarAriaLabel(): string;
+    /**
+     * SVG title element content for tooltip.
+     * Shows on hover in most browsers.
+     */
+    get avatarTitle(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExecutiveOwnerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExecutiveOwnerComponent, "praxis-executive-owner", never, { "name": { "alias": "name"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 interface EditorDocument<TConfig, TBindings = unknown> {
@@ -472,8 +951,8 @@ declare class PraxisListJsonConfigEditorComponent implements OnInit, OnChanges,
     private updateValidationState;
     private syncJsonText;
     private hasUnsavedLocalChanges;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisListJsonConfigEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisListJsonConfigEditorComponent, "praxis-list-json-config-editor", never, { "document": { "alias": "document"; "required": false; }; }, { "documentChange": "documentChange"; "validationChange": "validationChange"; "editorEvent": "editorEvent"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListJsonConfigEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListJsonConfigEditorComponent, "praxis-list-json-config-editor", never, { "document": { "alias": "document"; "required": false; }; }, { "documentChange": "documentChange"; "validationChange": "validationChange"; "editorEvent": "editorEvent"; }, never, never, true, never>;
 }
 
 type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'selection' | 'skin' | 'i18n'> & {
@@ -486,6 +965,7 @@ type NormalizedListConfig = Omit<PraxisListConfig, 'dataSource' | 'layout' | 'se
     layout: {
         variant: 'list' | 'cards' | 'tiles';
         density?: 'default' | 'comfortable' | 'compact';
+        itemSpacing?: 'none' | 'tight' | 'default' | 'relaxed';
         lines: 1 | 2 | 3;
         dividers?: 'none' | 'between' | 'all';
         model?: 'standard' | 'media' | 'hotel';
@@ -853,8 +1333,8 @@ declare class PraxisListConfigEditor implements SettingsValueProvider, DoCheck {
     isRatingMaxInvalid(value?: number): boolean;
     private suggestIcon;
     getTypeIcon(type: string): string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisListConfigEditor, [{ optional: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisListConfigEditor, "praxis-list-config-editor", never, { "config": { "alias": "config"; "required": false; }; "listId": { "alias": "listId"; "required": false; }; }, {}, never, never, true, never>;
+    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>;
 }
 
 declare function createListAuthoringDocument(source: {
@@ -884,8 +1364,8 @@ declare class ListSkinService {
     toHostClasses(config?: PraxisListConfig): string[];
     toCssVars(config?: PraxisListConfig): Record<string, string>;
     toInlineStyle(config?: PraxisListConfig, rootSelector?: string, includeVars?: boolean): string;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListSkinService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ListSkinService>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListSkinService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ListSkinService>;
 }
 
 /**
@@ -944,7 +1424,7 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const LIST_AI_CAPABILITIES: CapabilityCatalog;
 
-type DemoScenario = 'operations' | 'catalog' | 'empty';
+type DemoScenario = 'operations' | 'executive-expansion' | 'catalog' | 'empty';
 type DemoVariant = 'list' | 'cards' | 'tiles';
 type DemoDensity = 'default' | 'comfortable' | 'compact';
 type DemoFeaturesMode = 'icons+labels' | 'icons-only' | 'labels-only';
@@ -1003,21 +1483,46 @@ interface DemoItem {
     city: string;
     trend: string;
     cover: string;
+    accountCode?: string;
+    balanceDisplay?: string;
+    limitDisplay?: string;
+    usageLabel?: string;
+    usagePercent?: number;
+    riskDisplay?: string;
+    riskLabel?: string;
+    segmentVariant?: 'enterprise' | 'corporate' | 'middle';
+    segmentLabel?: string;
+    accountType?: string;
+    since?: number;
+    alertsData?: ExecutiveAlert[];
+    ownerName?: string;
+    executiveMarkerIcon?: string;
+    riskIcon?: string;
+    alerts?: Array<{
+        title: string;
+        value: string;
+    }>;
+    products?: string[];
+    events?: Array<{
+        title: string;
+        meta: string;
+        description: string;
+    }>;
 }
 declare class PraxisListDocPageComponent {
     readonly form: FormGroup<{
         selectedItems: FormControl<unknown>;
     }>;
-    readonly scenario: _angular_core.WritableSignal<DemoScenario>;
-    readonly variant: _angular_core.WritableSignal<DemoVariant>;
-    readonly density: _angular_core.WritableSignal<DemoDensity>;
-    readonly lines: _angular_core.WritableSignal<1 | 2 | 3>;
-    readonly skin: _angular_core.WritableSignal<DemoSkin>;
-    readonly featuresMode: _angular_core.WritableSignal<DemoFeaturesMode>;
-    readonly selectionMode: _angular_core.WritableSignal<DemoSelectionMode>;
-    readonly customizationEnabled: _angular_core.WritableSignal<boolean>;
-    readonly activeTab: _angular_core.WritableSignal<CodeTab>;
-    readonly eventLog: _angular_core.WritableSignal<EventLogEntry[]>;
+    readonly scenario: i0.WritableSignal<DemoScenario>;
+    readonly variant: i0.WritableSignal<DemoVariant>;
+    readonly density: i0.WritableSignal<DemoDensity>;
+    readonly lines: i0.WritableSignal<1 | 2 | 3>;
+    readonly skin: i0.WritableSignal<DemoSkin>;
+    readonly featuresMode: i0.WritableSignal<DemoFeaturesMode>;
+    readonly selectionMode: i0.WritableSignal<DemoSelectionMode>;
+    readonly customizationEnabled: i0.WritableSignal<boolean>;
+    readonly activeTab: i0.WritableSignal<CodeTab>;
+    readonly eventLog: i0.WritableSignal<EventLogEntry[]>;
     private nextLogId;
     readonly scenarioOptions: ReadonlyArray<ScenarioOption>;
     readonly variantOptions: ReadonlyArray<VariantOption>;
@@ -1027,11 +1532,11 @@ declare class PraxisListDocPageComponent {
     readonly skinOptions: ReadonlyArray<SkinOption>;
     readonly codeTabs: ReadonlyArray<CodeTabOption>;
     readonly featureCoverage: ReadonlyArray<CoverageTopic>;
-    readonly liveItems: _angular_core.Signal<DemoItem[]>;
-    readonly activeScenarioMeta: _angular_core.Signal<ScenarioOption | null>;
-    readonly liveConfig: _angular_core.Signal<PraxisListConfig>;
+    readonly liveItems: i0.Signal<DemoItem[]>;
+    readonly activeScenarioMeta: i0.Signal<ScenarioOption | null>;
+    readonly liveConfig: i0.Signal<PraxisListConfig>;
     readonly skinPreviewItems: DemoItem[];
-    readonly skinPreviewConfigs: _angular_core.Signal<{
+    readonly skinPreviewConfigs: i0.Signal<{
         type: DemoSkin;
         config: {
             layout: {
@@ -1040,10 +1545,29 @@ declare class PraxisListDocPageComponent {
                 density: "compact";
                 model: "hotel";
                 groupBy: undefined;
+                itemSpacing?: "none" | "tight" | "default" | "relaxed";
                 dividers?: "none" | "between" | "all";
                 stickySectionHeader?: boolean;
                 virtualScroll?: boolean;
                 pageSize?: number;
+                rowLayout?: {
+                    type?: "grid" | "flex";
+                    columns?: Array<{
+                        slot: ListRowLayoutSlot;
+                        width?: string;
+                        minWidth?: string;
+                        maxWidth?: string;
+                        align?: "start" | "center" | "end";
+                        justify?: "start" | "center" | "end" | "stretch";
+                        class?: string;
+                        style?: string;
+                    }>;
+                    gap?: string;
+                    align?: "start" | "center" | "end" | "stretch";
+                    itemAlignY?: "start" | "center" | "end" | "stretch";
+                    class?: string;
+                    style?: string;
+                };
             };
             selection: {
                 mode: "none";
@@ -1066,19 +1590,31 @@ declare class PraxisListDocPageComponent {
                 inlineStyle?: string;
             } | undefined;
             id?: string;
+            interaction?: {
+                expandable?: boolean;
+                expandTrigger?: "row" | "icon" | "row+icon";
+                expandMode?: "single" | "multiple";
+                expandPlacement?: "expand" | "trailing";
+            };
             templating?: {
                 leading?: TemplateDef;
                 primary?: TemplateDef;
                 secondary?: TemplateDef;
                 meta?: TemplateDef;
                 trailing?: TemplateDef;
+                identity?: TemplateDef;
+                balance?: TemplateDef;
+                limit?: TemplateDef;
+                risk?: TemplateDef;
+                alerts?: TemplateDef;
+                owner?: TemplateDef;
                 metaPlacement?: "side" | "line";
                 metaPrefixIcon?: string;
                 statusPosition?: "inline" | "top-right";
                 chipColorMap?: Record<string, string>;
                 chipLabelMap?: Record<string, string>;
                 iconColorMap?: Record<string, string>;
-                features?: ListFeatureDef[];
+                features?: TemplatingFeatureDef[];
                 featuresVisible?: boolean;
                 featuresMode?: "icons+labels" | "icons-only" | "labels-only";
                 sectionHeader?: TemplateDef;
@@ -1087,6 +1623,65 @@ declare class PraxisListDocPageComponent {
                     count?: number;
                 };
             };
+            rules?: {
+                itemStyles?: Array<{
+                    id: string;
+                    condition?: string;
+                    class?: string;
+                    style?: string;
+                    border?: string;
+                    background?: string;
+                }>;
+                slotOverrides?: Array<{
+                    id: string;
+                    slot: ListTemplatingSlot;
+                    condition?: string;
+                    template?: TemplateDef;
+                    class?: string;
+                    style?: string;
+                    hide?: boolean;
+                }>;
+            };
+            expansion?: {
+                sections?: ListExpansionSectionDef[];
+                dataSource?: {
+                    mode?: "inline" | "resource" | "resourcePath";
+                    resource?: {
+                        kind: string;
+                        id: string;
+                        version: string;
+                    };
+                    resourcePath?: {
+                        path: string;
+                        method?: "GET" | "POST";
+                        paramsMap?: Record<string, string>;
+                    };
+                    resourceAllowList?: string[];
+                    fallbackMode?: "none" | "inline" | "resource";
+                    cache?: {
+                        enabled?: boolean;
+                    };
+                    cancelOnCollapse?: boolean;
+                };
+                schemaContract?: {
+                    kind: "praxis.detail.schema";
+                    version: string;
+                    allowedNodes?: Array<"info-list" | "chip-list" | "timeline" | "key-value" | "metadata" | "component">;
+                    maxSections?: number;
+                    maxItemsPerSection?: number;
+                    requireSectionIds?: boolean;
+                };
+                rendering?: {
+                    shell?: "attached" | "detached" | "modal";
+                    columns?: 1 | 2 | 3;
+                    gap?: string;
+                    padding?: string;
+                    class?: string;
+                    style?: string;
+                    loadingTemplate?: TemplateDef;
+                    errorTemplate?: TemplateDef;
+                };
+            };
             actions?: Array<{
                 id: string;
                 icon?: string;
@@ -1100,6 +1695,7 @@ declare class PraxisListDocPageComponent {
                 globalPayload?: any;
                 emitLocal?: boolean;
                 showLoading?: boolean;
+                placement?: "actions" | "trailing";
                 confirmation?: {
                     title?: string;
                     message?: string;
@@ -1132,8 +1728,8 @@ declare class PraxisListDocPageComponent {
             };
         };
     }[]>;
-    readonly configPreview: _angular_core.Signal<string>;
-    readonly selectedSnippet: _angular_core.Signal<string>;
+    readonly configPreview: i0.Signal<string>;
+    readonly selectedSnippet: i0.Signal<string>;
     readonly templateSnippet = "<praxis-list-doc-page></praxis-list-doc-page>";
     readonly tsSnippet = "import { Component } from '@angular/core';\nimport { PraxisListDocPageComponent } from '@praxisui/list';\n\n@Component({\n  selector: 'app-list-doc',\n  standalone: true,\n  imports: [PraxisListDocPageComponent],\n  template: '<praxis-list-doc-page />',\n})\nexport class ListDocHostComponent {}";
     readonly remoteSnippet = "const config = {\n  id: 'employees-remote',\n  dataSource: {\n    resourcePath: 'employees',\n    query: { active: true },\n    sort: ['updatedAt,desc']\n  },\n  layout: { variant: 'list', pageSize: 12, lines: 2 },\n  templating: {\n    primary: { type: 'text', expr: '${item.name}' },\n    secondary: { type: 'text', expr: '${item.role}' },\n    meta: { type: 'date', expr: '${item.updatedAt}|pt-BR:short' },\n    trailing: { type: 'chip', expr: '${item.status}' }\n  },\n  ui: {\n    showSearch: true,\n    searchField: 'name',\n    showSort: true,\n    sortOptions: [{ label: 'Nome A-Z', value: 'name,asc' }]\n  }\n} as const;";
@@ -1150,12 +1746,32 @@ declare class PraxisListDocPageComponent {
     handleItemClick(event: ListItemEvent): void;
     handleActionClick(event: ListActionEvent): void;
     handleSelectionChange(event: ListSelectionEvent): void;
+    isExecutiveExpansionScenario(): boolean;
     private buildSkinConfig;
     private buildTemplatingConfig;
     private pushLog;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PraxisListDocPageComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PraxisListDocPageComponent, "praxis-list-doc-page", never, {}, {}, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisListDocPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisListDocPageComponent, "praxis-list-doc-page", never, {}, {}, never, never, true, never>;
 }
 
-export { LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_COMPONENT_METADATA, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, normalizeListActionPayloads, normalizeListAuthoringDocument, normalizeListConfig, parseLegacyOrListDocument, projectListAuthoringDocument, providePraxisListMetadata, serializeListAuthoringDocument, toCanonicalListConfig, validateListAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, EditorDiagnostic, EditorDocument, JsonEditorEvent, JsonValidationResult, ListActionEvent, ListApplyPlan, ListAuthoringDocument, ListFeatureDef, ListItemEvent, ListProjectionContext, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListValidationContext, PraxisListConfig, TemplateDef, TemplateType, ValueKind };
+declare const PRAXIS_LIST_EN_US: {
+    readonly configEdit: "Edit configuration";
+    readonly expandDetails: "Expand details";
+    readonly collapseDetails: "Collapse details";
+    readonly itemDetails: "Item details";
+    readonly emptyState: "No items available";
+};
+
+declare const PRAXIS_LIST_I18N_NAMESPACE = "praxis-list";
+declare function providePraxisListI18n(): i0.Provider;
+
+declare const PRAXIS_LIST_PT_BR: {
+    readonly configEdit: "Editar configurações";
+    readonly expandDetails: "Expandir detalhes";
+    readonly collapseDetails: "Recolher detalhes";
+    readonly itemDetails: "Detalhes do item";
+    readonly emptyState: "Nenhum item disponível";
+};
+
+export { ExecutiveAlertsComponent, ExecutiveBadgeComponent, ExecutiveOwnerComponent, LIST_AI_CAPABILITIES, ListDataService, ListSkinService, PRAXIS_LIST_COMPONENT_METADATA, PRAXIS_LIST_EN_US, PRAXIS_LIST_I18N_NAMESPACE, PRAXIS_LIST_PT_BR, PraxisList, PraxisListConfigEditor, PraxisListDocPageComponent, PraxisListJsonConfigEditorComponent, adaptSelection, buildListApplyPlan, createListAuthoringDocument, evalExpr, evaluateTemplate, inferListAuthoringDocument, inferTemplatingFromSchema, 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, ListProjectionContext, ListRowLayoutSlot, ListRuntimeContext, ListSchemaInferencePlan, ListSection, ListSelectionEvent, ListTemplatingSlot, ListValidationContext, PraxisListConfig, TemplateDef, TemplateFeatureDef, TemplateType, TemplatingFeatureDef, ValueKind };