@acorex-platform/framework-client 2.0.0-next.24 → 2.0.0-next.26

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@acorex-platform/framework-client",
-  "version": "2.0.0-next.24",
+  "version": "2.0.0-next.26",
   "peerDependencies": {
-    "@acorex-platform/framework-shared": "2.0.0-next.24",
+    "@acorex-platform/framework-shared": "2.0.0-next.26",
     "@acorex/cdk": "^21.0.0 || ^22.0.0 || ^22.0.0-next.0 || ^22.1.0-next.0 || ^22.2.0-next.0 || ^22.2.0-next.0",
     "@acorex/charts": "^21.0.0 || ^22.0.0 || ^22.0.0-next.0 || ^22.1.0-next.0 || ^22.2.0-next.0 || ^22.2.0-next.0",
     "@acorex/components": "^21.0.0 || ^22.0.0 || ^22.0.0-next.0 || ^22.1.0-next.0 || ^22.2.0-next.0 || ^22.2.0-next.0",

package/types/acorex-platform-framework-client-layout-entity.d.ts

@@ -1223,6 +1223,28 @@ declare function ensureHierarchicalRootFilter(filter: AXDataSourceFilterOption |
  */
 declare function applyDataSourcePagingWithoutLoad(dataSource: AXDataSource, paging: AXPEntityListPagingState): void;
 declare function getDataSourcePageIndex(dataSource: AXDataSource): number;
+interface AXPDataSourceLoadWatch {
+    isLoading: boolean;
+    onChanged: {
+        subscribe: (handler: () => void) => {
+            unsubscribe: () => void;
+        };
+    };
+    onLoadingChanged: {
+        subscribe: (handler: (isLoading: boolean) => void) => {
+            unsubscribe: () => void;
+        };
+    };
+}
+/**
+ * Resolves when the next load cycle finishes.
+ * A `loading=false` from an older cycle is ignored until this watch sees `loading=true`.
+ * `stop` settles immediately (cache no-op, or a newer view switch owns the list).
+ */
+declare function watchNextDataSourceLoad(dataSource: AXPDataSourceLoadWatch, isCurrent?: () => boolean): {
+    promise: Promise<void>;
+    stop: () => void;
+};
 declare function normalizeListPaging(paging: Partial<AXPEntityListPagingState> | undefined, defaultTake: number): AXPEntityListPagingState;
 
 /** Shared contract for master and detail lists that host the identity-card grid. */
@@ -1230,6 +1252,10 @@ interface AXPEntityCardListHost {
     readonly entityDef: AXPEntity;
     readonly dataSource: AXDataSource;
     readonly selectedItems: WritableSignal<any[]>;
+    /** Master list sets this while a view-tab switch has dropped the previous rows. */
+    readonly listTransitionLoading?: WritableSignal<boolean>;
+    /** Epoch of the latest master-list view-tab switch. Detail lists omit it. */
+    viewSwitchEpoch?(): number;
     cardLayout(): AXPEntityCardLayout | undefined;
     cardFields(): AXPEntityListViewCardFieldViewModel[];
     activeListLayout(): AXPEntityMasterListLayoutType;
@@ -1519,6 +1545,13 @@ declare class AXPEntityMasterListViewModel {
     private readonly destroyed;
     private lastAppliedSortKey;
     private lastAppliedFilterKey;
+    /** Latest view-tab switch. Older `setView` / refresh continuations must not load. */
+    private viewSwitchEpochValue;
+    /** `reset()` dropped the in-flight rows; the next criteria apply must refresh even if the keys match. */
+    private listResultDiscarded;
+    private setViewChain;
+    /** True after a view switch discards rows, until that switch's own load finishes. */
+    readonly listTransitionLoading: _angular_core.WritableSignal<boolean>;
     private hasQueryParamsFilters;
     private routeQueryContextKey;
     readonly listInstanceId: _angular_core.WritableSignal<string>;
@@ -1614,7 +1647,24 @@ declare class AXPEntityMasterListViewModel {
      */
     resolveFieldStylingClass(rowData: unknown, fieldName: string): Promise<string | undefined>;
     private resolveTriggerName;
-    setView(viewName?: string | null): Promise<void>;
+    /**
+     * Marks every in-flight view switch as stale. Call only when the selected view name changes.
+     * Does not clear rows or start a request; {@link setView} does that once this epoch is still current.
+     */
+    beginViewSwitch(): number;
+    viewSwitchEpoch(): number;
+    isViewSwitchCurrent(epoch: number): boolean;
+    /** Clears the switch skeleton only for the load that still belongs to `epoch`. */
+    finishListTransition(epoch: number): void;
+    setView(viewName?: string | null, viewSwitchEpoch?: number): Promise<void>;
+    private isStaleViewSwitch;
+    /**
+     * Drops an in-flight list result so it cannot paint on the new view.
+     * Restores the current filter/sort because `AXDataSource.reset()` clears them.
+     * The replacement request starts later, after columns and filters for this view are ready.
+     */
+    private discardInFlightListPresentation;
+    private applySetView;
     dataSource: AXDataSource<any>;
     constructor(injector: Injector, config: AXPEntity);
     private syncShowRowIndexColumnSetting;
@@ -1779,6 +1829,8 @@ declare class AXPEntityMasterListViewModel {
     resetFilters(): void;
     applyFilterAndSort(options?: {
         resetPagination?: boolean;
+        viewSwitchEpoch?: number;
+        forceReload?: boolean;
     }): Promise<void>;
     /**
      * Toolbar filters stay in `filterQueries`. Category sidebar filters are applied
@@ -4690,6 +4742,8 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected customFilter: _angular_core.Signal<AXDataSourceFilterOption | null>;
     /** When false, an empty cascade filter does not lock the editor. Explicit `disabled` is independent. */
     protected waitForCascade: _angular_core.Signal<boolean>;
+    /** ax-tree-view only lazy-loads nodes with `childrenCount > 0`, so non-table tree modes always prefetch. */
+    protected prefetchChildrenCount: _angular_core.Signal<boolean>;
     /** Parent cascade with an empty value. Structurally empty filters and top-level not-in stay enabled. */
     protected hasPendingCascadeFilter: _angular_core.Signal<boolean>;
     protected isLookupDisabled: _angular_core.Signal<boolean>;
@@ -4719,6 +4773,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
      */
     protected lookupTreeSearchFields: _angular_core.Signal<string[]>;
     protected entityDataSource: _angular_core.Signal<AXDataSource<AXLookupItem> | null>;
+    /** New identity per filter so the table host drops its per-loader node cache. */
     protected entityTreeDataSource: _angular_core.Signal<AXTreeViewDataSource>;
     protected effectiveDataSource: _angular_core.Signal<AXDataSource<AXLookupItem> | null>;
     protected selectFilterDisplayValue: _angular_core.Signal<any>;
@@ -5412,5 +5467,5 @@ declare function dispatchEntityModifiedSideEffects(entityEvents: AXPEntityBroadc
  */
 declare function provideEntityRealtimeHandlers(): Provider[];
 
-export { ATTACHMENTS_PAGE_COMPONENT_KEY, AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPClientLocalPluginModule, AXPCreateEntityCommand, AXPDataSeederService, AXPDeleteEntityCommand, AXPDomainQueryEntityDefinitionLoader, AXPEditFileUploaderCommand, AXPEntityBulkPatchPerformService, AXPEntityCardComponent, AXPEntityCardFieldsResolver, AXPEntityCardSelectActionName, AXPEntityCardSkeletonComponent, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorRowActionsService, AXPEntityDataSelectorService, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletePerformService, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityFormBuilderService, AXPEntityLifecycleHookKeys, AXPEntityListPersistenceModeDefault, AXPEntityListTableService, AXPEntityListToolbarService, AXPEntityListViewCardFieldViewModel, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListCardSelectActionName, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddlewareSkipContext, AXPEntityModule, AXPEntityPreloadFiltersContainerComponent, AXPEntityPreloadFiltersViewModel, AXPEntityPreloadFiltersViewModelResolver, AXPEntityResolver, AXPEntityRuntimeAccessorService, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPFileListComponent, AXPFileUploaderLoadFilesQuery, AXPFileUploaderSaveFilesCommand, AXPFileUploaderWidget, AXPFileUploaderWidgetColumnComponent, AXPFileUploaderWidgetEditComponent, AXPFileUploaderWidgetService, AXPFileUploaderWidgetViewComponent, AXPGetEntityDetailsQuery, AXPLayoutOrderingConfigService, AXPLookupByKeyCacheService, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService as AXPMiddlewareEntityService, AXPMiddlewareEntityStorageService, AXPMultiSourceDefinitionProviderContext, AXPMultiSourceDefinitionProviderService, AXPMultiSourceFederatedSearchService, AXPMultiSourceSelectorComponent, AXPMultiSourceSelectorService, AXPMultiSourceSelectorWidget, AXPMultiSourceSelectorWidgetColumnComponent, AXPMultiSourceSelectorWidgetEditComponent, AXPMultiSourceSelectorWidgetViewComponent, AXPMultiSourceType, AXPOpenEntityDetailsCommand, AXPOpenEntityListCommand, AXPRelatedColumnEnrichmentService, AXPRelatedColumnMetadataResolver, AXPSelectorStructureWidget, AXPSelectorStructureWidgetColumnComponent, AXPSelectorStructureWidgetEditComponent, AXPSelectorStructureWidgetViewComponent, AXPShowFileUploaderPopupCommand, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPUpdateEntityStatusCommand, AXPViewEntityDetailsCommand, AXP_APPEARANCE_SECTION_ORDER, AXP_CATEGORY_TREE_ROOT_TITLE_I18N_KEY, AXP_CLASSIFICATION_SECTION_ORDER, AXP_CLIENT_LOCAL_DEFAULT_MAX_ITEMS, AXP_CLIENT_LOCAL_PLUGIN_NAME, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MIDDLEWARE, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_LOOKUP_FILTER_DEFAULT_OPERATOR, AXP_MULTI_SOURCE_DEFINITION_PROVIDER, DEFAULT_COLUMN_ORDER, DEFAULT_GROUP_SPAN_RULES, DEFAULT_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, ENTITY_FORM_ACTION_FIRST_STEP_CONTINUE, ENTITY_LIST_LAYOUT_META, ENTITY_LIST_ROUTE_CONTEXT_SESSION_KEY, ENTITY_MASTER_LIST_TRACE_NS, EntityBuilder, EntityDataAccessor, GALLERY_PAGE_COMPONENT_KEY, TREE_CHILDREN_QUERY_TAKE, actionExists, applyDataSourcePagingWithoutLoad, attachmentFieldCount, attachmentNeedsHydration, attachmentsPlugin, attachmentsSemanticallyEqual, axpBuildEntityListPageContextSnapshot, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, axpDeleteEntityCommandDefinition, axpOpenEntityListCommandDefinition, axpRunEntityListPageContextAction, axpShowFileUploaderPopupCommandDefinition, axpUpdateEntityStatusCommandDefinition, buildDataSourceTraceSnapshot, canPersistEntityListState, clientLocalPlugin, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, committedAttachments, composeEntityMiddlewares, composeEntityStorageMiddlewares, computeEntityAggregates, configureEntityListColumnsSettingsMigrateDrop, configureEntityListColumnsSettingsVersion, createColumnOrderingMiddlewareProvider, createEntityCardDisplayScope, createEntityCardLogicScope, createEntityMiddlewareContext, createEntityStorageContext, createLayoutOrderingMiddlewareProvider, defaultCardLayoutMiddleware, defaultCardLayoutMiddlewareProvider, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, defaultSortPresetsMiddleware, defaultSortPresetsMiddlewareProvider, detectEntityChanges, dispatchEntityModifiedSideEffects, ensureHierarchicalRootFilter, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityCreateBridgeMiddleware, entityDeleteBridgeMiddleware, entityGetOneBridgeMiddleware, entityListInstanceCurrentViewPath, entityListInstanceFilterPath, entityListStylingRulesPath, entityQueryBridgeMiddleware, entityStorageCreateBridgeMiddleware, entityStorageDeleteBridgeMiddleware, entityStorageGetOneBridgeMiddleware, entityStorageQueryBridgeMiddleware, entityStorageUpdateBridgeMiddleware, entityUpdateBridgeMiddleware, eventDispatchMiddleware, filterEntityMiddlewares, filterEntityStorageMiddlewares, filterSortEntityRows, filterTouchesParentKey, findEntityListRowDataInTree, fingerprintAttachmentItem, fingerprintAttachments, fireEntityLifecycleHook, formatLookupItemDisplay, formatLookupItemDisplayAsync, galleryPlugin, getDataSourcePageIndex, getEntityListColumnsSettingsMigrateDrop, getEntityListColumnsSettingsVersion, getEntityListRowId, getMasterInterfacePropertySortKey, hasFileUploaderTitleOrDescriptionFields, hydrateAttachmentFieldToFileList, isAXPMiddlewareAbortError, isAttachmentFieldPresentOnRow, isAttachmentListEntry, isAttachmentStorageRef, isCategoryEntity, isCategoryFilter, isFileListItem, isFileUploaderEditDialogAuto, isLegacyEntityDataSelectorOptions, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mapEntityStorageErrorToCommandResult, mapLegacyEntityDataSelectorOptions, mergeEntityListViewAndPersistedFilters, normalizeEntityCardHeaderDisplayValue, normalizeEntityDataSelectorColumnSpecs, normalizeEntityDataSelectorOptions, normalizeEntityFieldToFileList, normalizeEntityListPersistenceMode, normalizeListPaging, persistedAttachments, prefetchClientLocalRelated, provideEntity, provideEntityMiddlewareBridge, provideEntityRealtimeHandlers, provideEntityStorageMiddlewareBridge, provideLocalEntityCatalog, readLiveAttachmentValue, readPersistedEntityListInstanceCurrentView, readPersistedEntityListInstanceFilters, readPersistedEntityListStylingRules, resetPagingForTreeChildrenLoad, resolveAttachmentFieldPath, resolveEntityCardBadgeColorValue, resolveEntityCardHeaderValue, resolveEntityMasterFieldStylingClass, resolveEntityMasterRecordStylingClass, resolveEntityMasterStylingClass, resolveEntityPluginDetailPageOrder, resolveFileUploaderEditDialog, resolveFileUploaderEntityScope, resolveLookupDisplayField, resolveLookupDisplayTemplate, resolveLookupEntityCacheKey, resolveLookupEntityKey, resolveMasterInterfacePropertyOrder, restoreEntityListExpandedRows, runEntityMiddlewarePipeline, runEntityQuery, runEntityStorageMiddlewarePipeline, saveAttachmentsThroughEntityUpdate, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider, shouldLoadEntityListStateFromStorage, shouldResetEntityListStateOnRouteEntry, traceEntityMasterList };
+export { ATTACHMENTS_PAGE_COMPONENT_KEY, AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPClientLocalPluginModule, AXPCreateEntityCommand, AXPDataSeederService, AXPDeleteEntityCommand, AXPDomainQueryEntityDefinitionLoader, AXPEditFileUploaderCommand, AXPEntityBulkPatchPerformService, AXPEntityCardComponent, AXPEntityCardFieldsResolver, AXPEntityCardSelectActionName, AXPEntityCardSkeletonComponent, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorRowActionsService, AXPEntityDataSelectorService, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletePerformService, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityFormBuilderService, AXPEntityLifecycleHookKeys, AXPEntityListPersistenceModeDefault, AXPEntityListTableService, AXPEntityListToolbarService, AXPEntityListViewCardFieldViewModel, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListCardSelectActionName, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddlewareSkipContext, AXPEntityModule, AXPEntityPreloadFiltersContainerComponent, AXPEntityPreloadFiltersViewModel, AXPEntityPreloadFiltersViewModelResolver, AXPEntityResolver, AXPEntityRuntimeAccessorService, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPFileListComponent, AXPFileUploaderLoadFilesQuery, AXPFileUploaderSaveFilesCommand, AXPFileUploaderWidget, AXPFileUploaderWidgetColumnComponent, AXPFileUploaderWidgetEditComponent, AXPFileUploaderWidgetService, AXPFileUploaderWidgetViewComponent, AXPGetEntityDetailsQuery, AXPLayoutOrderingConfigService, AXPLookupByKeyCacheService, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService as AXPMiddlewareEntityService, AXPMiddlewareEntityStorageService, AXPMultiSourceDefinitionProviderContext, AXPMultiSourceDefinitionProviderService, AXPMultiSourceFederatedSearchService, AXPMultiSourceSelectorComponent, AXPMultiSourceSelectorService, AXPMultiSourceSelectorWidget, AXPMultiSourceSelectorWidgetColumnComponent, AXPMultiSourceSelectorWidgetEditComponent, AXPMultiSourceSelectorWidgetViewComponent, AXPMultiSourceType, AXPOpenEntityDetailsCommand, AXPOpenEntityListCommand, AXPRelatedColumnEnrichmentService, AXPRelatedColumnMetadataResolver, AXPSelectorStructureWidget, AXPSelectorStructureWidgetColumnComponent, AXPSelectorStructureWidgetEditComponent, AXPSelectorStructureWidgetViewComponent, AXPShowFileUploaderPopupCommand, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPUpdateEntityStatusCommand, AXPViewEntityDetailsCommand, AXP_APPEARANCE_SECTION_ORDER, AXP_CATEGORY_TREE_ROOT_TITLE_I18N_KEY, AXP_CLASSIFICATION_SECTION_ORDER, AXP_CLIENT_LOCAL_DEFAULT_MAX_ITEMS, AXP_CLIENT_LOCAL_PLUGIN_NAME, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MIDDLEWARE, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_LOOKUP_FILTER_DEFAULT_OPERATOR, AXP_MULTI_SOURCE_DEFINITION_PROVIDER, DEFAULT_COLUMN_ORDER, DEFAULT_GROUP_SPAN_RULES, DEFAULT_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, ENTITY_FORM_ACTION_FIRST_STEP_CONTINUE, ENTITY_LIST_LAYOUT_META, ENTITY_LIST_ROUTE_CONTEXT_SESSION_KEY, ENTITY_MASTER_LIST_TRACE_NS, EntityBuilder, EntityDataAccessor, GALLERY_PAGE_COMPONENT_KEY, TREE_CHILDREN_QUERY_TAKE, actionExists, applyDataSourcePagingWithoutLoad, attachmentFieldCount, attachmentNeedsHydration, attachmentsPlugin, attachmentsSemanticallyEqual, axpBuildEntityListPageContextSnapshot, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, axpDeleteEntityCommandDefinition, axpOpenEntityListCommandDefinition, axpRunEntityListPageContextAction, axpShowFileUploaderPopupCommandDefinition, axpUpdateEntityStatusCommandDefinition, buildDataSourceTraceSnapshot, canPersistEntityListState, clientLocalPlugin, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, committedAttachments, composeEntityMiddlewares, composeEntityStorageMiddlewares, computeEntityAggregates, configureEntityListColumnsSettingsMigrateDrop, configureEntityListColumnsSettingsVersion, createColumnOrderingMiddlewareProvider, createEntityCardDisplayScope, createEntityCardLogicScope, createEntityMiddlewareContext, createEntityStorageContext, createLayoutOrderingMiddlewareProvider, defaultCardLayoutMiddleware, defaultCardLayoutMiddlewareProvider, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, defaultSortPresetsMiddleware, defaultSortPresetsMiddlewareProvider, detectEntityChanges, dispatchEntityModifiedSideEffects, ensureHierarchicalRootFilter, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityCreateBridgeMiddleware, entityDeleteBridgeMiddleware, entityGetOneBridgeMiddleware, entityListInstanceCurrentViewPath, entityListInstanceFilterPath, entityListStylingRulesPath, entityQueryBridgeMiddleware, entityStorageCreateBridgeMiddleware, entityStorageDeleteBridgeMiddleware, entityStorageGetOneBridgeMiddleware, entityStorageQueryBridgeMiddleware, entityStorageUpdateBridgeMiddleware, entityUpdateBridgeMiddleware, eventDispatchMiddleware, filterEntityMiddlewares, filterEntityStorageMiddlewares, filterSortEntityRows, filterTouchesParentKey, findEntityListRowDataInTree, fingerprintAttachmentItem, fingerprintAttachments, fireEntityLifecycleHook, formatLookupItemDisplay, formatLookupItemDisplayAsync, galleryPlugin, getDataSourcePageIndex, getEntityListColumnsSettingsMigrateDrop, getEntityListColumnsSettingsVersion, getEntityListRowId, getMasterInterfacePropertySortKey, hasFileUploaderTitleOrDescriptionFields, hydrateAttachmentFieldToFileList, isAXPMiddlewareAbortError, isAttachmentFieldPresentOnRow, isAttachmentListEntry, isAttachmentStorageRef, isCategoryEntity, isCategoryFilter, isFileListItem, isFileUploaderEditDialogAuto, isLegacyEntityDataSelectorOptions, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, mapEntityStorageErrorToCommandResult, mapLegacyEntityDataSelectorOptions, mergeEntityListViewAndPersistedFilters, normalizeEntityCardHeaderDisplayValue, normalizeEntityDataSelectorColumnSpecs, normalizeEntityDataSelectorOptions, normalizeEntityFieldToFileList, normalizeEntityListPersistenceMode, normalizeListPaging, persistedAttachments, prefetchClientLocalRelated, provideEntity, provideEntityMiddlewareBridge, provideEntityRealtimeHandlers, provideEntityStorageMiddlewareBridge, provideLocalEntityCatalog, readLiveAttachmentValue, readPersistedEntityListInstanceCurrentView, readPersistedEntityListInstanceFilters, readPersistedEntityListStylingRules, resetPagingForTreeChildrenLoad, resolveAttachmentFieldPath, resolveEntityCardBadgeColorValue, resolveEntityCardHeaderValue, resolveEntityMasterFieldStylingClass, resolveEntityMasterRecordStylingClass, resolveEntityMasterStylingClass, resolveEntityPluginDetailPageOrder, resolveFileUploaderEditDialog, resolveFileUploaderEntityScope, resolveLookupDisplayField, resolveLookupDisplayTemplate, resolveLookupEntityCacheKey, resolveLookupEntityKey, resolveMasterInterfacePropertyOrder, restoreEntityListExpandedRows, runEntityMiddlewarePipeline, runEntityQuery, runEntityStorageMiddlewarePipeline, saveAttachmentsThroughEntityUpdate, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider, shouldLoadEntityListStateFromStorage, shouldResetEntityListStateOnRouteEntry, traceEntityMasterList, watchNextDataSourceLoad };
 export type { AXPClientLocalPluginOptions, AXPDataSeeder, AXPDeleteEntityCommandInput, AXPEntityAccessPort, AXPEntityActionPlugin, AXPEntityBulkPatchPerformInput, AXPEntityCardListHost, AXPEntityCardSecondaryActionItem, AXPEntityCardVariant, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityDataSelectorCategoryFilterOptions, AXPEntityDataSelectorCategoryOptions, AXPEntityDataSelectorCreateOptions, AXPEntityDataSelectorFilterOptions, AXPEntityDataSelectorGridOptions, AXPEntityDataSelectorOpenInput, AXPEntityDataSelectorOpenOptions, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDataSelectorRowActionsConfig, AXPEntityDataSelectorSearchOptions, AXPEntityDataSelectorSelectionOptions, AXPEntityDataSelectorSortOptions, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDeletePerformInput, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListExpandRowRef, AXPEntityListInput, AXPEntityListPagingState, AXPEntityListPersistenceMode, AXPEntityListToolbarConvertOptions, AXPEntityMasterListCardLayout, AXPEntityMasterListCardSecondaryActionItem, AXPEntityMasterListViewSortPropViewModel, AXPEntityMiddleware, AXPEntityMiddlewareContext, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityPreloadEntity, AXPEntityStorageBackend, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPFileListLook, AXPFileUploaderEditDialogFieldOptions, AXPFileUploaderEditDialogMode, AXPFileUploaderEditDialogOptions, AXPFileUploaderEntityFilesScope, AXPFileUploaderLoadFilesQueryInput, AXPFileUploaderLoadFilesQueryResult, AXPFileUploaderSaveFilesCommandInput, AXPFileUploaderSaveFilesCommandResult, AXPFileUploaderShowFileListEntityContext, AXPFileUploaderShowFileListOptions, AXPFileUploaderUploadActionDescriptor, AXPFileUploaderWidgetColumnOptions, AXPFileUploaderWidgetDesignerOptions, AXPFileUploaderWidgetEditOptions, AXPFileUploaderWidgetOptions, AXPFileUploaderWidgetPrintOptions, AXPFileUploaderWidgetViewOptions, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupDisplayEvalDeps, AXPMasterListColumnTreeNode, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPOpenEntityListCommandInput, AXPOpenEntityListCondition, AXPPageContextTitleResolver, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, AXPShowFileUploaderPopupCommandInput, AXPUpdateEntityStatusCommandInput, AttachmentsDisplayMode, AttachmentsPluginOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, EntityMasterListTraceArea, GalleryDisplayMode, GalleryPluginOptions, GroupSpanRule, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, RunEntityQueryAdapters, SectionOrderConfig, SkipEntityComponentPageRef };

package/types/acorex-platform-framework-client-layout-widgets.d.ts

@@ -2623,6 +2623,8 @@ declare class AXPDataListWidgetViewComponent extends AXPValueWidgetComponent<any
         [name: string]: unknown;
     })[];
     api(): AXPWidgetCoreElementAPI;
+    /** Skeleton rows so a refresh does not keep the previous view's rows or its empty state. */
+    showLoadingPlaceholders(): void;
     /**
      * Returns true when the data-table view child accepted the refresh.
      * Callers must retry while this is false (grid may not be ready yet after remount).

package/types/acorex-platform-framework-client-themes-default.d.ts

@@ -139,6 +139,7 @@ declare class AXPEntityDetailListViewComponent {
 }
 
 declare class AXPEntityMasterListCardListComponent {
+    #private;
     vm: _angular_core.InputSignal<AXPEntityCardListHost>;
     userStylingRules: _angular_core.InputSignal<readonly AXPEntityListUserStylingRule[]>;
     protected items: _angular_core.WritableSignal<Record<string, unknown>[]>;
@@ -197,9 +198,9 @@ declare class AXPEntityMasterListCardListComponent {
     protected onInfiniteScrollReached(): void;
     private loadMore;
     private loadPage;
+    private isListSwitchCurrent;
     private applyPageFromDataSource;
     private resolvePageSize;
-    private waitForDataSourceLoad;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMasterListCardListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityMasterListCardListComponent, "axp-entity-master-list-card-list", never, { "vm": { "alias": "vm"; "required": true; "isSignal": true; }; "userStylingRules": { "alias": "userStylingRules"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -372,6 +373,8 @@ declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponen
     private flushBackgroundListRefresh;
     private applyVisibleListRefresh;
     private reloadListData;
+    /** Skeleton rows so an empty previous result does not stay on screen while the next page loads. */
+    private showTableLoadingPlaceholders;
     /**
      * Manual-mode table gates the body on `isRefreshCalled` (set only by `grid.refresh()`).
      * Card loads use shared `dataSource.refresh()`, so rows/totalCount update while the gate stays closed.
@@ -379,10 +382,6 @@ declare class AXPEntityMasterListViewComponent extends AXPPageLayoutBaseComponen
      */
     private acknowledgeManualTableReady;
     private buildListHostTraceSnapshot;
-    /**
-     * Waits until a `refresh()` load cycle completes (loading started, then finished with data).
-     */
-    private waitForDataSourceLoad;
     private grid;
     /** Re-evaluates row and cell classes after personal highlight rules change. */
     repaintListStyling(): Promise<void>;