@acorex-platform/framework-client 2.0.0-next.3 → 2.0.0-next.31

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

@@ -20,7 +20,7 @@ export { AXPEntityDefinitionCrudService, AXP_ENTITY_DEFINITION_CRUD_SERVICE } fr
 import * as i4 from '@acorex-platform/framework-client/layout/widget-core';
 import { AXPColumnWidgetComponent, AXPValueWidgetComponent, AXPWidgetCoreElementAPI, AXPWidgetCoreService, AXPWidgetRendererDirective } from '@acorex-platform/framework-client/layout/widget-core';
 import * as _acorex_platform_framework_client_layout_widgets from '@acorex-platform/framework-client/layout/widgets';
-import { AXPProviderSelectWidgetEditBase, AXPDataListWidgetComponentOptions } from '@acorex-platform/framework-client/layout/widgets';
+import { AXPDataListWidgetComponentOptions } from '@acorex-platform/framework-client/layout/widgets';
 import { ParamMap, ResolveFn, RedirectCommand } from '@angular/router';
 import * as rxjs from 'rxjs';
 import { Subject } from 'rxjs';
@@ -410,6 +410,8 @@ declare class AXPFileUploaderWidgetEditComponent extends AXPValueWidgetComponent
     private readonly chooserService;
     private readonly settingsService;
     private readonly commandExecutor;
+    private readonly queryExecutor;
+    private readonly debug;
     private readonly toastService;
     private readonly translateService;
     private readonly dirtyChangeSubject;
@@ -422,8 +424,15 @@ declare class AXPFileUploaderWidgetEditComponent extends AXPValueWidgetComponent
     /** Status before soft-delete; used for restore when baseline was not synced (section layout). */
     private readonly statusBeforeDelete;
     private readonly autoBaselineSynced;
+    private entityFilesHydrateGeneration;
+    private hydratedScopeKey;
     /** Sync baseline from context when not wired by a deferred-save page (section layout). */
     private readonly baselineInitEffect;
+    /**
+     * Storage refs (including `reference:edms-lazy`) are not file rows.
+     * Load them through FileUploader:LoadFiles without marking the form dirty.
+     */
+    private readonly entityFilesHydrateEffect;
     protected multiple: _angular_core.Signal<boolean>;
     private readonly acceptOverride;
     protected accept: _angular_core.Signal<string>;
@@ -447,6 +456,7 @@ declare class AXPFileUploaderWidgetEditComponent extends AXPValueWidgetComponent
     protected readonly chooserContext: _angular_core.Signal<AXPFileChooserContext>;
     ngOnInit(): void;
     private applyChooserPlatformSettings;
+    private hydrateEntityFiles;
     setValue(value: AXPFileListItem[] | null | undefined): void;
     /** Align dirty baseline with persisted attachments (call when record loads or after discard remount). */
     syncBaseline(saved: AXPFileListItem[] | undefined): void;
@@ -763,6 +773,7 @@ declare class AXPOpenEntityDetailsCommand implements AXPCommand<AXPOpenEntityDet
     private readonly router;
     private readonly sessionService;
     private readonly detailsAccess;
+    private readonly excludeSession;
     /**
      * Execute the command to navigate to entity details
      * @param input - Command input containing entity and data information
@@ -1022,6 +1033,10 @@ declare class AXPEntityDetailPopoverComponent {
     entityId: _angular_core.InputSignal<string | number>;
     requestClose: _angular_core.InputSignal<(() => void) | undefined>;
     breadcrumb: _angular_core.InputSignal<string | null>;
+    /** When set, replaces the entity card field list for this popover only. */
+    popoverFields: _angular_core.InputSignal<readonly string[] | null>;
+    /** Names removed from this popover after `popoverFields` is applied. */
+    popoverExclude: _angular_core.InputSignal<readonly string[] | null>;
     protected entityDefinition: _angular_core.WritableSignal<AXPEntity | null>;
     protected entityData: _angular_core.WritableSignal<Record<string, unknown> | null>;
     protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
@@ -1042,7 +1057,7 @@ declare class AXPEntityDetailPopoverComponent {
     loadDetails(): Promise<void>;
     protected navigateToDetails(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDetailPopoverComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDetailPopoverComponent, "axp-entity-detail-popover", never, { "entity": { "alias": "entity"; "required": true; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": true; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": false; "isSignal": true; }; "breadcrumb": { "alias": "breadcrumb"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDetailPopoverComponent, "axp-entity-detail-popover", never, { "entity": { "alias": "entity"; "required": true; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": true; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": false; "isSignal": true; }; "breadcrumb": { "alias": "breadcrumb"; "required": false; "isSignal": true; }; "popoverFields": { "alias": "popoverFields"; "required": false; "isSignal": true; }; "popoverExclude": { "alias": "popoverExclude"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface AXPEntityDetailPopoverOptions {
@@ -1056,6 +1071,13 @@ interface AXPEntityDetailPopoverOptions {
     /** @deprecated Unused; the shared entity card resolves the title from the card layout. */
     displayTitle?: string;
     breadcrumb?: string;
+    /**
+     * When set, the popover shows only these card fields, in this order.
+     * Omit to keep the entity card. Does not change list cards.
+     */
+    fields?: readonly string[];
+    /** Card field or property names removed from this popover after `fields` is applied. */
+    exclude?: readonly string[];
 }
 declare class AXPEntityDetailPopoverService {
     private readonly overlayService;
@@ -1201,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. */
@@ -1208,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;
@@ -1408,6 +1456,10 @@ declare class AXPEntityCreateViewElementViewModel {
     description: _angular_core.WritableSignal<string | undefined>;
     editable: _angular_core.Signal<boolean>;
     isVisible: _angular_core.Signal<string | boolean>;
+    private readonly liveRequired;
+    /** `disabled` values of `required` rules, so the page label can follow the same expression as the editor. */
+    requiredDisabledSources(): Array<boolean | string | undefined>;
+    setLiveRequired(value: boolean): void;
     isRequired: _angular_core.Signal<boolean>;
     layout: _angular_core.Signal<AXPEntityPropertyLayoutConfig>;
     node: _angular_core.Signal<AXPWidgetNode>;
@@ -1483,6 +1535,7 @@ declare class AXPEntityMasterListViewModel {
     private readonly commandService;
     private readonly queryExecutor;
     private readonly filterOperatorMiddleware;
+    private readonly filterDefaultOperators;
     private readonly entityDefinitionRegistry;
     private readonly cardFieldsResolver;
     private readonly columnFooterLoader;
@@ -1492,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>;
@@ -1587,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;
@@ -1752,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
@@ -1984,6 +2063,10 @@ declare class AXPEntityMasterUpdateElementViewModel {
     description: _angular_core.WritableSignal<string | undefined>;
     editable: _angular_core.Signal<boolean>;
     isVisible: _angular_core.Signal<string | boolean>;
+    private readonly liveRequired;
+    /** `disabled` values of `required` rules, so the page label can follow the same expression as the editor. */
+    requiredDisabledSources(): Array<boolean | string | undefined>;
+    setLiveRequired(value: boolean): void;
     isRequired: _angular_core.Signal<boolean>;
     layout: _angular_core.Signal<AXPEntityPropertyLayoutConfig>;
     node: _angular_core.Signal<AXPWidgetNode>;
@@ -2407,6 +2490,7 @@ declare class AXPEntityPreloadFiltersViewModel {
     private config;
     readonly entityDef: AXPEntity;
     private readonly widgetResolver;
+    private readonly filterDefaultOperators;
     private readonly entityRegistry;
     filterDefinitions: _angular_core.WritableSignal<AXPEntityListFilterDefinition[]>;
     constructor(injector: Injector, config: AXPEntity);
@@ -2988,6 +3072,23 @@ interface PairSpanRule {
     secondSpan: number;
     breakpoints?: readonly ('sm' | 'md' | 'lg')[];
 }
+/**
+ * Col spans for a priority list of properties in one section.
+ * Only names that are actually present are laid out, in {@link GroupSpanRule.names} order.
+ * The span comes from how many of those names are in the section.
+ */
+interface GroupSpanRule {
+    /** Priority order. Missing names are skipped. */
+    names: readonly string[];
+    /**
+     * Col span for each present name, keyed by how many of {@link names} are in the section.
+     * Example: `{ 1: 6, 2: 6, 3: 4 }`.
+     */
+    spanByCount: Readonly<Record<number, number>>;
+    /** Layout order for each name, same length as {@link names}. */
+    orders?: readonly number[];
+    breakpoints?: readonly ('sm' | 'md' | 'lg')[];
+}
 interface SectionOrderConfig {
     sections: Record<string, number>;
     properties: Record<string, number>;
@@ -2998,15 +3099,29 @@ interface SectionOrderConfig {
      * - `[...]` + spread `DEFAULT_PAIR_SPAN_RULES` when you want to append custom pairs
      */
     pairSpanRules?: PairSpanRule[] | false;
+    /**
+     * Width for a priority list of fields in one section, based on how many are present.
+     * - `undefined`: use {@link DEFAULT_GROUP_SPAN_RULES}
+     * - `false`: do not apply group spans
+     * - `[...]`: replace the defaults
+     */
+    groupSpanRules?: GroupSpanRule[] | false;
 }
 /**
- * Default shipped rules: narrow identifier + wider title on `md` / `lg`.
+ * Classification row: scope, then category, then tags.
+ * One field is 6 columns, two fields are 6 + 6, three fields are 4 + 4 + 4.
  */
+declare const DEFAULT_GROUP_SPAN_RULES: readonly GroupSpanRule[];
+/** Default shipped rules: narrow identifier + wider title on `md` / `lg`. */
 declare const DEFAULT_PAIR_SPAN_RULES: readonly PairSpanRule[];
 declare const DEFAULT_SECTION_ORDER: Record<string, number>;
 declare const DEFAULT_PROPERTY_ORDER: Record<string, number>;
 declare const layoutOrderingMiddlewareFactory: (config: SectionOrderConfig) => AXPEntityModifier;
 declare const createLayoutOrderingMiddlewareProvider: (config?: Partial<SectionOrderConfig>, entityName?: string | RegExp) => AXPEntityModifierProvider;
+/**
+ * Runs after entity plugins (tags, category, catalog-scope) so their layout
+ * views exist before default spans and section order are applied.
+ */
 declare const layoutOrderingMiddlewareProvider: AXPEntityModifierProvider;
 
 /**
@@ -3789,34 +3904,38 @@ declare module '@acorex-platform/framework-shared/widget-core' {
     }
 }
 
-declare class AXPEntityDefinitionProviderWidgetEditComponent extends AXPProviderSelectWidgetEditBase {
+interface EntityKeyRow {
+    value: string;
+    /** Original title or i18n key. The row template translates it. */
+    title: string;
+    /** Translated label plus key, used for search and sort. */
+    searchText: string;
+}
+/**
+ * Picks a registered entity key (`module.name`).
+ * Does not use the data-list widget base: that base writes `options.dataSource`
+ * while the property dialog is opening and remounts the dialog until the browser hangs.
+ */
+declare class AXPEntityDefinitionProviderWidgetEditComponent extends AXPValueWidgetComponent<string> {
     private readonly entityRegistry;
+    private readonly entityResolver;
+    private readonly translationService;
     /**
-     * Last applied module filter (from context) to avoid redundant reloads.
-     */
-    private readonly lastModuleFilterKey;
-    /**
-     * Reloads entity options when `filterModuleField` changes in form context (not only via `widget.refresh()`).
-     */
-    private readonly reloadWhenModuleContextChanges;
-    /**
-     * Options:
-     * - `filterModuleField`: sibling context field name (e.g. `entityListModule`); when set, only entities in that module are listed.
-     * - `valueFormat`: `fullKey` (`module.name`, default) or `entityName` (short name only, for menus that store `entityListRef.entity`).
-     */
-    protected loadDataSourceRows(): Promise<Array<{
-        value: string;
-        title: string;
-    }>>;
-    refresh(): void;
-    /**
-     * Reads sibling field from context store data (same shape as `lodash/get` paths).
-     */
-    private readModuleFromContext;
-    /**
-     * Resolves a sibling field path relative to the current widget's parent path.
-     */
-    private resolveSiblingContextPath;
+     * Replaced after {@link AXPEntityResolver.listAll}. `getAll()` only has entities
+     * already opened in this session, so the dropdown would hide the rest.
+     */
+    private rows;
+    /** Bumped when {@link rows} is replaced so the selected label can resolve. */
+    private readonly rowsVersion;
+    /** Drops the lookup's initial value echo so the property dialog is not rebuilt. */
+    private acceptSelection;
+    protected readonly rowHeight = 40;
+    protected readonly dataSource: AXDataSource<EntityKeyRow>;
+    protected readonly selectedKey: _angular_core.Signal<string | null>;
+    protected readonly selectedItems: _angular_core.Signal<EntityKeyRow[]>;
+    ngOnInit(): Promise<void>;
+    protected onLookupValueChanged(event: AXValueChangedEvent): void;
+    private toRows;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionProviderWidgetEditComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPEntityDefinitionProviderWidgetEditComponent, "axp-entity-definition-provider-widget-edit", never, {}, {}, never, never, true, never>;
 }
@@ -3864,8 +3983,8 @@ declare class AXPEntityListTableService {
      */
     private handleRowCommand;
     /**
-     * When a related entity list declares `excludeProperties`, row commands bypass the details page
-     * `execute()` merge — apply the same exclusions for embedded create/update commands.
+     * Related-list `excludeProperties` are not on the row action itself.
+     * Merge them into create, edit, view, and details commands. Values stay in the form context.
      */
     private mergeRelatedListFormOptions;
     /**
@@ -3885,6 +4004,7 @@ interface AXPEntityListToolbarConvertOptions {
 }
 declare class AXPEntityListToolbarService {
     private readonly widgetResolver;
+    private readonly filterDefaultOperators;
     private readonly entityRegistry;
     /**
      * Convert Entity to Toolbar Options
@@ -4311,6 +4431,8 @@ interface AXPEntityDataSelectorCreateOptions {
      * When set, replaces the default `Create {entity title}` header.
      */
     title?: string;
+    /** Command to run instead of `Entity:Create`, when set. */
+    command?: string;
 }
 /** Nested options for {@link AXPEntityDataSelectorService.open}. */
 interface AXPEntityDataSelectorOpenOptions {
@@ -4414,7 +4536,7 @@ declare class AXPEntityDataSelectorService {
      * Execute Entity:Create and return created item.
      * Used by lookup widget and data selector for inline create.
      */
-    executeEntityCreate(entity: AXPEntity, mode: 'full' | 'quick', initialData?: Record<string, unknown>, title?: string): Promise<any | null>;
+    executeEntityCreate(entity: AXPEntity, mode: 'full' | 'quick', initialData?: Record<string, unknown>, title?: string, commandName?: string): Promise<any | null>;
     /**
      * Normalize item's phones/emails for expose/display.
      * Call this when receiving items from any source (create, API, selector).
@@ -4454,6 +4576,11 @@ declare class AXPEntityDataSelectorService {
      * Execute Entity:Create and return created item
      */
     private executeCreate;
+    /**
+     * Runs a named create command (for example Create New Location) and returns the created row.
+     * `initialData` is sent as both `data` and `options.process.data` so party/owner seeds resolve.
+     */
+    private executeNamedCreate;
     /**
      * Normalize phones/emails from repeater form to plain arrays of { value: string }.
      * Repeater/ContactBox can return nested structure: { value: { label: "", value: "101010" } }
@@ -4555,6 +4682,14 @@ declare class AXPLookupWidgetTableHostComponent extends NXValueComponent {
     protected handleTableItemClick(event: LookupWidgetTableItemClickEvent): void;
     /** Closes the inline lookup dropdown. */
     close(): void;
+    /**
+     * Reload multi-column / tree grid rows (e.g. after cascade filter context is ready).
+     * When the popover is closed, defers the network load until the user opens the lookup.
+     */
+    refreshTableData(options?: {
+        immediate?: boolean;
+    }): void;
+    isPanelExpanded(): boolean;
     /** Clears the selection. Used by projected `ax-clear-button`. */
     reset(_isUserInteraction?: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetTableHostComponent, never>;
@@ -4569,6 +4704,7 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected readonly entityDataSelectorService: AXPEntityDataSelectorService;
     private readonly mlsResolver;
     private readonly filterOperatorMiddleware;
+    private readonly filterDefaults;
     private readonly formatService;
     private readonly expressionEvaluator;
     private readonly contextEvalFactory;
@@ -4589,8 +4725,12 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     private readonly shouldFocus;
     /** Skips one {@link findByValue} pass after inline create when selection is already hydrated. */
     private skipFindByValueOnce;
+    /** Ignores host `valueChange` echoes while open-form hydration is writing context. */
+    private hostValueCommitSuppressDepth;
     /** Latest {@link findByValue} run; older in-flight runs must not overwrite its result. */
     private findByValueRequestId;
+    /** Allows explicit {@link refresh} to load list data while the popover is closed. */
+    private forceLookupListQueryDepth;
     private lastEditorLocaleKey;
     protected expose: _angular_core.Signal<string | any[] | undefined>;
     protected entity: _angular_core.Signal<string>;
@@ -4600,6 +4740,10 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected textField: _angular_core.Signal<string>;
     protected hasClearButton: _angular_core.Signal<boolean>;
     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>;
@@ -4629,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>;
@@ -4645,6 +4790,8 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     /** Rows picked in the open popup; used to resolve keys before datasource cache is queried. */
     private readonly pickedItems;
     private readonly editorLocaleChanged;
+    /** Multi-column-tree loads only while the lookup popover is open. */
+    private shouldRunLookupListQuery;
     protected handleItemRowAction(event: AXClickEvent, commandName: string, item: AXLookupItem): Promise<void>;
     protected handleLookupItemRowActionMouseDown(event: Event): void;
     protected handleLookupItemSelected(e: AXItemSelectedEvent<AXLookupItem>): void;
@@ -4659,6 +4806,9 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     protected openPopupSelector(): Promise<void>;
     private hasValue;
     private findByValue;
+    /** Ignores the editor echo while context is applied from outside the control. */
+    private holdHostValueCommit;
+    private resolveLookupSelection;
     private getHydrationOptions;
     private resolveEditorLocaleKey;
     private rerenderEditor;
@@ -4666,6 +4816,8 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
     private executeCreate;
     /** @param syncContext When false, only updates UI (hydration/revert); skips context writes. */
     protected setItems: (items: any[], syncContext?: boolean) => void;
+    /** Fills empty expose targets from the resolved row without running triggers. */
+    private exposeHydratedSelection;
     /**
      * Writes expose targets into context using per-path updates.
      * Avoids `contextService.patch()` with nested objects: patch shallow-merges top-level keys only,
@@ -5315,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_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 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, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, RunEntityQueryAdapters, SectionOrderConfig, SkipEntityComponentPageRef };
+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-views.d.ts

@@ -253,6 +253,7 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected readonly unsavedChangesConfirm: AXPUnsavedChangesConfirmService;
     protected readonly browserTitleService: AXPBrowserTitleService;
     protected readonly router: Router;
+    private readonly pageLayoutRoute;
     private readonly navTrailService;
     private readonly pageLayoutDestroyRef;
     private _updateTrigger;
@@ -261,6 +262,15 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected updateTrigger: _angular_core.Signal<number>;
     protected recompute(): void;
     ngOnInit(): Promise<void>;
+    /**
+     * Follows the scoped tab when this instance is the active route (settings scope changes).
+     * Cached background pages keep the key captured at init.
+     */
+    private syncOwnedPageTabKey;
+    /** True when this page's route snapshot is in the active router tree. */
+    private isOwningActiveRoute;
+    /** True when this page may publish chrome onto its route tab. */
+    private canPublishActiveTabChrome;
     /** Maps the home-page route to the pinned home tab key instead of a path-based key. */
     private resolvePageTabKey;
     /** Stable tab key for this cached page instance (tabular mode). */
@@ -294,6 +304,11 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     /** True when this cached page should publish crumbs for details-to-details wayfinding. */
     private isActivePageForNavTrail;
     protected getPageBreadcrumbs(): AXPBreadcrumbItem[] | Promise<AXPBreadcrumbItem[]>;
+    /**
+     * Route-tab label for this page. Return a scope title when child routes are internal
+     * (settings groups). Null keeps the breadcrumb / page-title fallback.
+     */
+    protected getRouteTabTitle(): string | string[] | null | Promise<string | string[] | null>;
     /** Collects resolved breadcrumb labels (Home excluded upstream) for tab chrome. */
     protected resolveBreadcrumbTabTitleSegments(pageBreadcrumbs: AXPBreadcrumbItem[]): Promise<string[]>;
     /** Joins breadcrumb segments as the stored tab title string. */