@praxisui/list 10.0.0-rc.25 → 10.0.0-rc.26

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/list",
-  "version": "10.0.0-rc.25",
+  "version": "10.0.0-rc.26",
   "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.25",
+    "@praxisui/dynamic-fields": "^10.0.0-rc.26",
     "rxjs": ">=7 <9",
     "@angular/forms": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^10.0.0-rc.25",
-    "@praxisui/core": "^10.0.0-rc.25",
-    "@praxisui/rich-content": "^10.0.0-rc.25",
-    "@praxisui/settings-panel": "^10.0.0-rc.25"
+    "@praxisui/ai": "^10.0.0-rc.26",
+    "@praxisui/core": "^10.0.0-rc.26",
+    "@praxisui/rich-content": "^10.0.0-rc.26",
+    "@praxisui/settings-panel": "^10.0.0-rc.26"
   },
   "dependencies": {
     "tslib": "^2.3.0",

package/types/praxisui-list.d.ts

@@ -121,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;
@@ -201,6 +204,18 @@ interface PraxisListConfig {
         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 | PraxisListVirtualScrollConfig;
@@ -1199,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'];
     };
@@ -1589,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;
@@ -1666,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;
@@ -2017,6 +2091,9 @@ declare class PraxisListDocPageComponent {
                 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 | _praxisui_list.PraxisListVirtualScrollConfig;
                 pageSize?: number;
@@ -2983,4 +3060,4 @@ declare const PRAXIS_LIST_PT_BR: {
 };
 
 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, ListExpansionSectionDef, ListExpansionSectionType, ListFeatureDef, ListItemEvent, 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 };
+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 };