@praxisui/list 10.0.0-rc.8 → 10.0.0-rc.9

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-10-12T02:00:03.764Z",
+  "generatedAt": "2026-10-12T12:49:05.370Z",
   "packageName": "@praxisui/list",
-  "packageVersion": "10.0.0-rc.8",
+  "packageVersion": "10.0.0-rc.9",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 1,

package/fesm2022/praxisui-list.mjs

@@ -9312,6 +9312,9 @@ class PraxisList {
         if (changes['queryContext']) {
             this.applyRuntimeQueryContext();
         }
+        if (changes['virtualScroll']) {
+            this.warnOnIncompatibleVirtualScroll();
+        }
         if (shouldApplyPersistence) {
             this.applyPersistence();
         }
@@ -10230,6 +10233,23 @@ class PraxisList {
         return [];
     }
     trackByVirtualItem = (index, item) => this.trackByItem(index, item);
+    warnOnIncompatibleVirtualScroll() {
+        if (!isDevMode() || !this.isVirtualScrollEnabled())
+            return;
+        const variant = this.config?.layout?.variant || 'list';
+        if (variant !== 'list') {
+            this.logger.warnOnce(`[PraxisList] virtualScroll is only supported with layout.variant 'list' (current variant is '${variant}'). Virtual scrolling may produce unexpected layout or scrolling artifacts.`, this.buildLogOptions({ variant, virtualScroll: this.virtualScroll ?? this.config?.layout?.virtualScroll }, {
+                dedupeKey: `praxis-list:vs-incompatible-variant:${this.listId || 'anonymous'}:${variant}`,
+                throttleKey: 'praxis-list:vs-incompatible-variant',
+            }));
+        }
+        if (this.isExpandable() || this.config?.interaction?.expandable) {
+            this.logger.warnOnce(`[PraxisList] virtualScroll is incompatible with row expansion. Dynamic row heights are not supported by fixed-size virtual scroll viewports and may lead to visual overlap or clipping.`, this.buildLogOptions({ expandable: true, virtualScroll: this.virtualScroll ?? this.config?.layout?.virtualScroll }, {
+                dedupeKey: `praxis-list:vs-incompatible-expansion:${this.listId || 'anonymous'}`,
+                throttleKey: 'praxis-list:vs-incompatible-expansion',
+            }));
+        }
+    }
     effectiveActions() {
         const directItemActions = this.itemActions || [];
         const configActions = this.config?.actions || [];
@@ -10464,7 +10484,8 @@ class PraxisList {
             if (action?.showLoading)
                 delete this.actionLoadingState[loadingKey];
         }
-        const emitLocal = action?.emitLocal ?? (!recordOpenIntent && !globalAction?.actionId);
+        const hasGlobalDispatch = Boolean(globalAction?.actionId || commandName || recordOpenIntent);
+        const emitLocal = action?.emitLocal ?? !hasGlobalDispatch;
         if (emitLocal) {
             this.actionClick.emit({ actionId, item, index });
         }
@@ -11329,6 +11350,7 @@ class PraxisList {
             saveConfig: persist,
         });
         this.executeListEditorApplyPlan(plan, doc, trigger);
+        this.warnOnIncompatibleVirtualScroll();
     }
     applyRuntimeQueryContext() {
         this.initializeDataStreams();

package/package.json

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

package/types/praxisui-list.d.ts

@@ -700,6 +700,7 @@ declare class PraxisList implements OnInit, OnChanges, AfterViewInit, OnDestroy
     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[];