@acorex/platform 21.0.0-next.39 → 21.0.0-next.40

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

@@ -84,6 +84,7 @@ declare const axpCreateEntityCommandDefinition: {
         summary: string;
         derivesFrom: string;
     };
+    capabilities: "ai"[];
     ai: {
         shortDescription: string;
         usage: {
@@ -102,6 +103,7 @@ declare const axpCreateEntityCommandDefinition: {
             };
         };
     };
+    categories: _acorex_platform_core.AXPDefinitionCategory[];
 };
 
 declare class AXPUpdateEntityCommand implements AXPCommand<any, any> {
@@ -160,6 +162,15 @@ declare class AXPEntityDetailPopoverComponent {
     protected entityDetails: _angular_core.WritableSignal<any>;
     protected isLoadingDetails: _angular_core.WritableSignal<boolean>;
     protected isDetailPopoverOpen: _angular_core.WritableSignal<boolean>;
+    /**
+     * Stable list of property widgets for the template. Must be a signal (computed), not a method:
+     * calling a method from the template rebuilds nodes every CD cycle and can make the widget renderer loop.
+     */
+    protected readonly entityPropertiesWithWidgets: _angular_core.Signal<{
+        name: string;
+        title: string;
+        node: AXPWidgetNode;
+    }[]>;
     /**
      * Show the entity detail popover
      */
@@ -185,11 +196,7 @@ declare class AXPEntityDetailPopoverComponent {
      * Name priority MUST come before widget-type priority.
      */
     private getNameImportanceScore;
-    protected getEntityPropertiesWithWidgets(): Array<{
-        name: string;
-        title: string;
-        node: AXPWidgetNode;
-    }>;
+    private buildEntityPropertiesWithWidgets;
     /**
      * Resolves the data path for a property. For lookups with expose, returns the expanded path
      * when data has it (e.g. personTitle). Otherwise returns property name (e.g. personTitleId).
@@ -563,6 +570,11 @@ declare class AXPEntityMasterListViewModel {
      * pre-fills categoryIds and categories for the create form.
      */
     private mergeDefaultCategoryForCreate;
+    /**
+     * Seeds create payloads with fixed list-view conditions (e.g. scope=T on the tenant dashboards view)
+     * so new rows match the view context and downstream queries (such as home dashboard) can find them.
+     */
+    private mergeViewConditionsForCreate;
     private evaluateExpressions;
     execute(command: AXPExecuteCommand): Promise<void>;
     destroy(): void;
@@ -734,6 +746,15 @@ declare const AXPEntityPreloadFiltersViewModelResolver: ResolveFn<Promise<AXPEnt
 
 interface AXPEntityModifierContext {
     readonly entity: AXPEntity;
+    plugins: {
+        list(): NonNullable<AXPEntity['plugins']>;
+        add(...items: NonNullable<AXPEntity['plugins']>): AXPEntityModifierContext;
+        remove(predicate: (p: NonNullable<AXPEntity['plugins']>[number]) => boolean): AXPEntityModifierContext;
+        find(name: string): {
+            get(): NonNullable<AXPEntity['plugins']>[number] | undefined;
+            update(updater: (p: NonNullable<AXPEntity['plugins']>[number]) => NonNullable<AXPEntity['plugins']>[number]): AXPEntityModifierContext;
+        };
+    };
     title: {
         get(): string;
         set(newTitle: string): AXPEntityModifierContext;
@@ -959,28 +980,71 @@ declare class AXPEntityDefinitionRegistryService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
 }
 
+/**
+ * One audit point in time for a record lifecycle event.
+ *
+ * Used inside {@link AXPRecordAuditInfo} (`created`, `updated`, `deleted`).
+ * Backends and mock middleware typically set `at` and `by`; `reason` and `source`
+ * (for example `api`, `system`, `import`) are optional diagnostic fields.
+ */
 interface AXPAuditEvent {
     at?: Date;
     by?: AXPUserReference;
+    /** Optional business or technical reason for the event. */
     reason?: string;
+    /** Optional origin of the change (for example `api`, `system`, `import`). */
     source?: string;
 }
+/**
+ * Aggregated audit trail for a persisted row.
+ *
+ * Filled by APIs or connectivity mock middleware when creating, updating, or
+ * soft-deleting records. UI surfaces may show these via the history plugin or
+ * custom columns. Version snapshot pipelines often **omit** this object from
+ * stored snapshots while still applying it to live payloads.
+ *
+ * @remarks Fields are optional today; callers should tolerate partial data.
+ */
 interface AXPRecordAuditInfo {
     created?: AXPAuditEvent;
     updated?: AXPAuditEvent;
     deleted?: AXPAuditEvent;
 }
+/**
+ * Cross-cutting flags that are not part of the domain schema but affect how a
+ * row is shown or edited (visibility, built-in/system rows, immutability).
+ *
+ * Module entity models sometimes expose only this slice (for example
+ * `stateInfo` on business units) when the rest of the row uses a bespoke shape.
+ *
+ * @remarks Entity list/detail flows should honor these flags where applicable.
+ */
 interface AXPRecordStateInfo {
     isHidden?: boolean;
     isSystem?: boolean;
     isImmutable?: boolean;
+    /** @deprecated Prefer explicit domain modeling over this flag. */
     isDistributed?: boolean;
 }
+/**
+ * Tenancy and actor scope for a row in a multi-tenant application.
+ *
+ * Used to associate a record with a tenant, application instance, or owning
+ * user when the API returns ownership metadata alongside domain fields.
+ */
 interface AXPRecordOwnershipInfo {
     tenantId?: string;
     applicationId?: string;
     userId?: string;
 }
+/**
+ * Base shape for **entity row** TypeScript models across modules: a stable
+ * identifier plus optional platform metadata.
+ *
+ * Module-specific interfaces extend this with domain properties
+ * (`extends AXPEntityModel<string>` / `AXPEntityModel<Id>`) while reusing
+ * `auditInfo`, `stateInfo`, and `ownershipInfo` when the backend sends them.
+ */
 interface AXPEntityModel<Id> {
     id: Id;
     auditInfo?: AXPRecordAuditInfo;
@@ -2225,6 +2289,11 @@ declare class AXPEntityListTableService {
      * Handle execution of a row command (shared by double-click and command handlers)
      */
     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.
+     */
+    private mergeRelatedListFormOptions;
     /**
      * Create default events
      */
@@ -2472,6 +2541,37 @@ declare abstract class LookupWidgetLookBase {
 }
 
 type AXPLookupWidgetLookType = 'select' | 'lookup';
+/**
+ * How the lookup column resolves related items for display in entity lists.
+ * - `hydrated`: titles (and optional ids) are already on the row; inline preview + overflow popover use row data only.
+ * - `idsWithCount`: ids and optional count live on the row; the cell shows a count summary and loads titles via entity `byKey` when the popover opens.
+ * - `countOnly`: only a count is on the row; the popover loads ids/titles via a registered `AXPQuery` when opened.
+ */
+type AXPLookupColumnResolveStrategy = 'hydrated' | 'idsWithCount' | 'countOnly';
+/**
+ * Column list only: controls how the lookup column loads and displays related items in grids.
+ * Omitted or empty strategy defaults to `hydrated` at runtime.
+ */
+interface AXPLookupColumnResolveOptions {
+    /** Default `hydrated` when omitted. */
+    strategy?: AXPLookupColumnResolveStrategy;
+    /** Lodash-style path on `rowData` for the displayed count (e.g. `rolesCount`). */
+    countFieldPath?: string;
+    /** Lodash-style path on `rowData` for the related id list (`idsWithCount`). If omitted, the column `rawValue` is used. */
+    idsPath?: string;
+    /** Registered query key for `AXPQueryExecutor.fetch` when using `countOnly`. */
+    queryKey?: string;
+    /**
+     * Maps query input property names to lodash-style paths on `rowData` (e.g. `{ "userId": "id" }`).
+     * May be a JSON string when set from the layout designer text field.
+     */
+    queryParams?: Record<string, string> | string;
+    /**
+     * Dot path into the named query result for the items array. Defaults to `items` when the result is an object.
+     * If the query returns an array directly, leave unset and handle at runtime.
+     */
+    queryResultItemsPath?: string;
+}
 interface AXPLookupWidgetOptions {
     disabled?: boolean | AXPExpression;
     readonly?: boolean | AXPExpression;
@@ -2480,6 +2580,8 @@ interface AXPLookupWidgetOptions {
     look?: AXPLookupWidgetLookType;
     allowClear?: boolean;
     displayFormat?: string;
+    /** Column list: lazy resolve and summary behavior. */
+    columnResolve?: AXPLookupColumnResolveOptions;
 }
 
 declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any> {
@@ -2535,9 +2637,12 @@ declare class AXPLookupWidgetEditComponent extends AXPValueWidgetComponent<any>
 
 declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<any> {
     private readonly entityDetailPopoverService;
-    private readonly mlResolver;
+    private readonly translation;
     private readonly formatService;
+    private readonly entityService;
+    private readonly queryExecutor;
     protected moreButton: _angular_core.Signal<ElementRef<any> | undefined>;
+    protected lazyTrigger: _angular_core.Signal<ElementRef<any> | undefined>;
     protected morePopover: _angular_core.Signal<AXPopoverComponent | undefined>;
     protected host: ElementRef<any>;
     protected valueField: string;
@@ -2547,21 +2652,50 @@ declare class AXPLookupWidgetColumnComponent extends AXPColumnWidgetComponent<an
     protected maxVisible: number;
     protected displayFormat: _angular_core.Signal<string | undefined>;
     protected displayField: _angular_core.Signal<string>;
+    protected columnResolve: _angular_core.Signal<AXPLookupColumnResolveOptions | undefined>;
+    protected resolveStrategy: _angular_core.Signal<AXPLookupColumnResolveStrategy>;
+    protected isHydratedStrategy: _angular_core.Signal<boolean>;
     protected isMorePopoverOpen: _angular_core.WritableSignal<boolean>;
     protected selectedItemIndex: _angular_core.WritableSignal<number>;
+    protected resolvedPopoverItems: _angular_core.WritableSignal<any[]>;
+    protected resolveStatus: _angular_core.WritableSignal<"error" | "idle" | "loading" | "ready">;
+    protected resolveError: _angular_core.WritableSignal<string | null>;
+    protected summaryLabel: _angular_core.WritableSignal<string>;
+    protected popoverHeader: _angular_core.WritableSignal<string>;
     protected displayItems: _angular_core.Signal<any[]>;
     protected allItems: _angular_core.Signal<any[]>;
     protected visibleItems: _angular_core.Signal<any[]>;
     protected hasMoreItems: _angular_core.Signal<boolean>;
-    protected remainingItemsCount: _angular_core.Signal<number>;
+    protected idsFromRow: _angular_core.Signal<any[]>;
+    protected displayCount: _angular_core.Signal<number>;
+    protected popoverListItems: _angular_core.Signal<any[]>;
+    /** Avoid resetting lazy cache on every CD when `rowData` is a new object reference for the same row. */
+    private previousLazyRowId;
+    constructor();
     protected showMoreItems(): void;
-    protected onMorePopoverOpenChange(event: any): void;
+    protected openLazyPopover(): void;
+    protected onPopoverOpenChange(event: unknown): void;
     protected showItemDetail(item: any, index: number): Promise<void>;
     protected handleItemClick(index: number): void;
-    private openMorePopover;
+    protected handleResolvedItemClick(index: number): void;
+    protected handlePopoverItemClick(index: number): void;
+    protected getDisplayRaw(item: any): string;
+    private refreshSummaryLabel;
+    private refreshPopoverHeader;
+    private resetLazyState;
+    private openPopoverFromRef;
     private closeMorePopover;
+    private ensureLazyItemsLoaded;
+    /**
+     * ax-popover may emit a boolean, CustomEvent with detail, or a DOM Event depending on version.
+     */
+    private coercePopoverOpenEvent;
+    private loadByIds;
+    private loadByNamedQuery;
+    private buildNamedQueryInput;
+    private parseQueryParamsMap;
+    private extractItemsFromQueryResult;
     private extractItem;
-    protected getDisplayRaw(item: any): string;
     private resolveDisplayValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLookupWidgetColumnComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLookupWidgetColumnComponent, "ng-component", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
@@ -3193,4 +3327,4 @@ declare class AXPShowListViewAction extends AXPWorkflowAction {
 declare const AXPShowListViewWorkflow: AXPWorkflow;
 
 export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCategoryTreeService, AXPCreateEntityCommand, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntitiesListDataSourceDefinition, AXPEntityApplyUpdatesAction, AXPEntityCategoryTreeSelectorComponent, AXPEntityCategoryWidget, AXPEntityCategoryWidgetColumnComponent, AXPEntityCategoryWidgetEditComponent, AXPEntityCategoryWidgetViewComponent, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDataSelectorService, AXPEntityDefinitionProviderWidget, AXPEntityDefinitionProviderWidgetEditComponent, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailPopoverComponent, AXPEntityDetailPopoverService, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityEventsKeys, AXPEntityFormBuilderService, AXPEntityListTableService, AXPEntityListToolbarService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityListWidget, AXPEntityListWidgetViewComponent, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityPreloadFiltersContainerComponent, AXPEntityPreloadFiltersViewModel, AXPEntityPreloadFiltersViewModelResolver, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPEntityUpdateViewSectionViewModel, AXPGetEntityDetailsQuery, AXPLayoutOrderingConfigService, AXPLookupWidget, AXPLookupWidgetColumnComponent, AXPLookupWidgetEditComponent, AXPLookupWidgetViewComponent, AXPMiddlewareAbortError, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPMultiSourceDefinitionProviderContext, AXPMultiSourceDefinitionProviderService, AXPMultiSourceFederatedSearchService, AXPMultiSourceSelectorComponent, AXPMultiSourceSelectorService, AXPMultiSourceSelectorWidget, AXPMultiSourceSelectorWidgetColumnComponent, AXPMultiSourceSelectorWidgetEditComponent, AXPMultiSourceSelectorWidgetViewComponent, AXPMultiSourceType, AXPOpenEntityDetailsCommand, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPRelatedColumnEnrichmentService, AXPRelatedColumnMetadataResolver, AXPSelectorStructureWidget, AXPSelectorStructureWidgetColumnComponent, AXPSelectorStructureWidgetEditComponent, AXPSelectorStructureWidgetViewComponent, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXPTruncatedBreadcrumbComponent, AXPUpdateEntityCommand, AXPViewEntityDetailsCommand, AXP_CATEGORY_TREE_ROOT_TITLE_I18N_KEY, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, AXP_MULTI_SOURCE_DEFINITION_PROVIDER, DEFAULT_COLUMN_ORDER, DEFAULT_PAIR_SPAN_RULES, DEFAULT_PROPERTY_ORDER, DEFAULT_SECTION_ORDER, EntityBuilder, EntityDataAccessor, actionExists, axpCreateEntityAiToolInputDefaults, axpCreateEntityCommandDefinition, cloneLayoutArrays, columnOrderingMiddleware, columnOrderingMiddlewareProvider, columnWidthMiddleware, columnWidthMiddlewareProvider, createColumnOrderingMiddlewareProvider, createLayoutOrderingMiddlewareProvider, createModifierContext, defaultMultiLanguageMiddleware, defaultMultiLanguageMiddlewareProvider, detectEntityChanges, ensureLayoutPropertyView, ensureLayoutSection, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware, getMasterInterfacePropertySortKey, isAXPMiddlewareAbortError, layoutOrderingMiddlewareFactory, layoutOrderingMiddlewareProvider, provideEntity, resolveEntityPluginDetailPageOrder, searchResultDescriptionMiddleware, searchResultDescriptionMiddlewareProvider };
-export type { AXPAuditEvent, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListToolbarConvertOptions, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, SectionOrderConfig, SkipEntityComponentPageRef };
+export type { AXPAuditEvent, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityCategoryWidgetOptions, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDataSelectorOptions, AXPEntityDataSelectorResult, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityDetailPopoverOptions, AXPEntityLayoutLike, AXPEntityLayoutPropertyLike, AXPEntityLayoutSectionLike, AXPEntityListEntry, AXPEntityListInput, AXPEntityListItemDto, AXPEntityListToolbarConvertOptions, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, AXPGetEntityDetailsQueryInput, AXPGetEntityDetailsQueryResult, AXPLookupColumnResolveOptions, AXPLookupColumnResolveStrategy, AXPLookupWidgetLookType, AXPLookupWidgetOptions, AXPMultiSourceDefinition, AXPMultiSourceDefinitionProvider, AXPMultiSourceItem, AXPMultiSourceRef, AXPMultiSourceSearchResult, AXPMultiSourceSearchResultItem, AXPMultiSourceSelectorOpenConfig, AXPMultiSourceSelectorResult, AXPMultiSourceSelectorWidgetOptions, AXPMultiSourceValue, AXPOpenEntityDetailsCommandInput, AXPRecordAuditInfo, AXPRecordOwnershipInfo, AXPRecordStateInfo, AXPRelatedColumnMetadata, AXPSelectorStructureFieldDef, AXPSelectorStructureIdentityDisplay, AXPSelectorStructurePresentationMode, AXPSelectorStructureSelectorMode, AXPSelectorStructureStructureMode, AXPSelectorStructureWidgetColumnOptions, AXPSelectorStructureWidgetDesignerOptions, AXPSelectorStructureWidgetEditOptions, AXPSelectorStructureWidgetOptions, AXPSelectorStructureWidgetPrintOptions, AXPSelectorStructureWidgetViewOptions, CategoryQueryEvent, CategoryQueryFunction, CategoryQueryResult, CategoryTreeConfig, CategoryTreeNodeData, EntityDetailPluginPageSlot, PairSpanRule, ResolveEntityPluginDetailPageOrderOptions, SectionOrderConfig, SkipEntityComponentPageRef };

package/types/acorex-platform-layout-widget-core.d.ts

@@ -3,7 +3,8 @@ import { Signal, InjectionToken, ComponentRef, OnInit, EventEmitter, TemplateRef
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPMultiLanguageString, AXPOptionsData, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPContextChangeEvent, AXPExpressionEvaluatorService, AXPProperty } from '@acorex/platform/core';
+import { AXPOptionsData, AXPMultiLanguageString, AXPDefinitionCategory, AXPDataType, AXPExpression, AXPWidgetTriggers, AXPMetaData, AXPValueTransformerFunctions, AXPValidationRules, AXPPartialNested, AXPProperty, AXPContextChangeEvent, AXPExpressionEvaluatorService } from '@acorex/platform/core';
+export { AXPDefinitionCategory, normalizeDefinitionCategories } from '@acorex/platform/core';
 import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { AXDataTableColumnComponent } from '@acorex/components/data-table';
@@ -91,22 +92,7 @@ declare class AXPWidgetCoreService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetCoreService>;
 }
 
-interface AXPWidgetCategory {
-    name: string;
-    title: AXPMultiLanguageString;
-    order: number;
-}
-/** Normalizes widget categories to an array for iteration and serialization. */
-declare function normalizeWidgetCategories(categories?: AXPWidgetCategory | AXPWidgetCategory[]): AXPWidgetCategory[];
-declare const AXP_WIDGETS_LAYOUT_CATEGORY: AXPWidgetCategory;
-declare const AXP_WIDGETS_EDITOR_CATEGORY: AXPWidgetCategory;
-declare const AXP_WIDGETS_ACTION_CATEGORY: AXPWidgetCategory;
-declare const AXP_WIDGETS_ADVANCE_CATEGORY: AXPWidgetCategory;
-/** Widgets exposed to AI assistants for structured rendering (see Widgets:GetForAI). */
-declare const AXP_WIDGETS_AI_CATEGORY: AXPWidgetCategory;
-declare const AXP_WIDGETS_CATEGORIES: AXPWidgetCategory[];
-
-type AXPWidgetGroup = 'form-element' | 'dashboard-widget' | 'form-template' | 'property-editor' | 'meta-data' | 'setting-widget' | 'entity-widget' | 'utility-widget';
+type AXPWidgetGroup = 'form-element' | 'dashboard-widget' | 'form-template' | 'property-editor' | 'meta-data' | 'setting-widget' | 'entity-widget' | 'utility-widget' | 'base-widget';
 declare enum AXPWidgetGroupEnum {
     FormElement = "form-element",
     DashboardWidget = "dashboard-widget",
@@ -115,7 +101,8 @@ declare enum AXPWidgetGroupEnum {
     MetaData = "meta-data",
     SettingWidget = "setting-widget",
     EntityWidget = "entity-widget",
-    UtilityWidget = "utility-widget"
+    UtilityWidget = "utility-widget",
+    BaseWidget = "base-widget"
 }
 
 interface AXPWidgetTypesMap {
@@ -192,7 +179,6 @@ interface AXPWidgetTypesMap {
     metaData: 'meta-data-editor';
     templateEditor: 'template-box-editor';
     templateContentEditor: 'template-content-editor';
-    themePaletteChooser: 'theme-palette-chooser';
     themeModeChooser: 'theme-mode-chooser';
     menuOrientationChooser: 'menu-orientation-chooser';
     fontStyleChooser: 'font-style-chooser';
@@ -216,8 +202,6 @@ interface AXPWidgetTypesMap {
     entityDefinitionProvider: 'entity-definition-provider-editor';
 }
 
-/** Inclusion mode for AI widget catalog queries (Widgets:GetForAI). */
-type AXPWidgetAiCatalogMode = 'include' | 'exclude' | 'inherit';
 interface AXPWidgetPropertyGroup {
     name: string;
     title: string;
@@ -313,6 +297,8 @@ interface AXPWidgetColumnNode {
     type: string;
     path: string;
     options?: AXPOptionsData;
+    /** Column header caption from data-table (`title || name`); often an i18n key. */
+    caption?: string;
 }
 interface AXPWidgetColumnNodeToken extends AXPWidgetColumnNode {
     config: AXPWidgetConfig;
@@ -359,7 +345,21 @@ interface AXPWidgetConfig<T = any> {
      * for structured output; unrelated to end-user UI copy.
      */
     aiDescription?: string | null;
-    categories?: AXPWidgetCategory | AXPWidgetCategory[];
+    /**
+     * Picker tabs and section headings in the widget gallery (when the widget is included in the picker list).
+     */
+    categories?: AXPDefinitionCategory | AXPDefinitionCategory[];
+    /**
+     * Optional sub-group within a parent category tab in the widget picker.
+     * Ignored on the "All" tab (widgets are grouped by parent category only).
+     */
+    subCategory?: AXPDefinitionCategory;
+    /**
+     * Which surfaces may offer this widget. The designer widget picker includes a widget only when this list
+     * intersects the requested groups (e.g. the layout designer requests `AXPWidgetGroupEnum.FormElement`).
+     * Use `AXPWidgetGroupEnum.BaseWidget` alone for types that must stay registered (filters, renderers, AI tools)
+     * but must not appear in form or dashboard pickers.
+     */
     groups?: AXPWidgetGroup[];
     properties?: AXPWidgetProperty[];
     components: AXPWidgetConfigComponents;
@@ -375,12 +375,6 @@ interface AXPWidgetConfig<T = any> {
      * If omitted, the default display is used.
      */
     historyLayout?: AXPWidgetNode;
-    /**
-     * Controls inclusion in AI-facing widget catalog queries (e.g. Widgets:GetForAI).
-     * `inherit` (default): include only when `categories` contains the AI category (`AXP_WIDGETS_AI_CATEGORY`).
-     * `include` / `exclude`: force include or exclude regardless of categories.
-     */
-    aiCatalog?: AXPWidgetAiCatalogMode;
 }
 interface AXPExtendedWidget {
     widget: AXPWidgetConfig;
@@ -511,6 +505,8 @@ declare abstract class AXPColumnWidgetComponent<T = any | null | void> {
     private readonly token;
     protected readonly path: string;
     protected readonly options: Record<string, any>;
+    /** Column header caption when rendered inside `axp-widget-column-renderer`. */
+    protected readonly columnCaption: string | undefined;
     protected readonly rawValue: T;
     protected readonly rowData: any;
     protected readonly nullText: any;
@@ -537,6 +533,33 @@ declare abstract class AXPBlockBaseLayoutWidgetComponent extends AXPBoxModelLayo
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPBlockBaseLayoutWidgetComponent>;
 }
 
+/**
+ * Maps a platform {@link AXPProperty} to a property viewer row model ({@link AXPWidgetProperty}).
+ * Kept in widget-core (not platform/core) to avoid a dependency cycle: widget-core already depends on platform/core.
+ */
+interface MapAXPPropertyToWidgetPropertyOptions {
+    group: AXPWidgetPropertyGroup;
+    order: number;
+    /**
+     * Dot path prefix for {@link AXPWidgetProperty.schema.interface.path}.
+     * Example: `input` → `input.requestId`; `properties` → `properties.message`.
+     */
+    valuePathPrefix: string;
+    /**
+     * Resolves a display title (supports multi-language strings on the source property).
+     */
+    resolveTitle: (property: AXPProperty) => string;
+    /**
+     * Optional description line for the viewer row.
+     */
+    resolveDescription?: (property: AXPProperty) => string | undefined;
+}
+/**
+ * Converts a domain {@link AXPProperty} into a {@link AXPWidgetProperty} row for
+ * the layout property viewer (`AXPPropertyViewerService` and `buildPropertyViewerTabsFromProperties`).
+ */
+declare function mapAXPPropertyToWidgetProperty(property: AXPProperty, options: MapAXPPropertyToWidgetPropertyOptions): AXPWidgetProperty;
+
 type AXPPropertyEditorSideValues = 'top' | 'left' | 'bottom' | 'right';
 type AXPPropertyEditorCornerValues = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 type AXPPropertyEditorSideGeneric<T extends string, U extends string | number = string> = Record<T, U>;
@@ -1059,44 +1082,34 @@ interface AXPMetaDataDefinition {
 
 declare const AXPWidgetsCatalog: AXPWidgetTypesMap;
 
-/**
- * Maps a platform {@link AXPProperty} to a property viewer row model ({@link AXPWidgetProperty}).
- * Kept in widget-core (not platform/core) to avoid a dependency cycle: widget-core already depends on platform/core.
- */
-interface MapAXPPropertyToWidgetPropertyOptions {
-    group: AXPWidgetPropertyGroup;
-    order: number;
-    /**
-     * Dot path prefix for {@link AXPWidgetProperty.schema.interface.path}.
-     * Example: `input` → `input.requestId`; `properties` → `properties.message`.
-     */
-    valuePathPrefix: string;
-    /**
-     * Resolves a display title (supports multi-language strings on the source property).
-     */
-    resolveTitle: (property: AXPProperty) => string;
-    /**
-     * Optional description line for the viewer row.
-     */
-    resolveDescription?: (property: AXPProperty) => string | undefined;
-}
-/**
- * Converts a domain {@link AXPProperty} into a {@link AXPWidgetProperty} row for
- * the layout property viewer (`AXPPropertyViewerService` and `buildPropertyViewerTabsFromProperties`).
- */
-declare function mapAXPPropertyToWidgetProperty(property: AXPProperty, options: MapAXPPropertyToWidgetPropertyOptions): AXPWidgetProperty;
-
-/**
- * True when the widget declares the AI category (see {@link AXP_WIDGETS_AI_CATEGORY}).
- */
-declare function hasAiWidgetCategory(config: AXPWidgetConfig): boolean;
-/**
- * Resolves AI catalog visibility using {@link AXPWidgetConfig.aiCatalog} and the AI widget category.
- * - `exclude`: never listed.
- * - `include`: always listed (override when the widget cannot declare the AI category yet).
- * - `inherit` / omitted: listed only if {@link hasAiWidgetCategory} is true.
- */
-declare function isWidgetAiCatalogIncluded(config: AXPWidgetConfig): boolean;
+declare const AXP_WIDGETS_EDITOR_SUB_TEXT_INPUTS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_NUMERIC: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_DATETIME: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_CHOICE: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_RICH: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_VISUAL: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_COMPOSITE: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_SUB_CONFIG: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_SHELL: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_GRID: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_SURFACES: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_TABS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_LISTS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_LAYOUT_SUB_UTILITY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ACTION_SUB_CONTROLS: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_MEDIA: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_INPUT: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_DATA: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_SUB_TOOLS: AXPDefinitionCategory;
+/** Normalizes widget categories to an array for iteration and serialization. */
+declare function normalizeWidgetCategories(categories?: AXPDefinitionCategory | AXPDefinitionCategory[]): AXPDefinitionCategory[];
+declare const AXP_WIDGETS_LAYOUT_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_EDITOR_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ACTION_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_ADVANCE_CATEGORY: AXPDefinitionCategory;
+/** AI category tab in the widget picker (metadata); unrelated to Widgets:GetForAI listing scope. */
+declare const AXP_WIDGETS_AI_CATEGORY: AXPDefinitionCategory;
+declare const AXP_WIDGETS_CATEGORIES: AXPDefinitionCategory[];
 
-export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPageStatus, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetGroupEnum, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXPWidgetStatus, AXPWidgetsCatalog, AXP_WIDGETS_ACTION_CATEGORY, AXP_WIDGETS_ADVANCE_CATEGORY, AXP_WIDGETS_AI_CATEGORY, AXP_WIDGETS_CATEGORIES, AXP_WIDGETS_EDITOR_CATEGORY, AXP_WIDGETS_LAYOUT_CATEGORY, AXP_WIDGET_COLUMN_TOKEN, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_TOKEN, buildWidgetRegistryMapFromProviders, cloneProperty, createBooleanProperty, createNumberProperty, createSelectProperty, createStringProperty, findNonEmptyBreakpoints, hasAiWidgetCategory, isWidgetAiCatalogIncluded, mapAXPPropertyToWidgetProperty, normalizeWidgetCategories };
-export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPExtendedWidget, AXPExtractWidgetConfig, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPLayoutBuilderStatusChangedEvent, AXPMetaDataDefinition, AXPMetaDataFeatures, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetAiCatalogMode, AXPWidgetCategory, AXPWidgetColumnNode, AXPWidgetColumnNodeToken, AXPWidgetComponentConfig, AXPWidgetConfig, AXPWidgetConfigComponents, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetDesignerOptionsMap, AXPWidgetGroup, AXPWidgetNode, AXPWidgetNodeToken, AXPWidgetProperty, AXPWidgetPropertyGroup, AXPWidgetRenderMode, AXPWidgetRendererDirectiveOptions, AXPWidgetTypesMap, AXPWidgetViewType, MapAXPPropertyToWidgetPropertyOptions };
+export { AXPBaseWidgetComponent, AXPBlockBaseLayoutWidgetComponent, AXPBoxModelLayoutWidgetComponent, AXPColumnWidgetComponent, AXPDataListWidgetComponent, AXPFlexBaseLayoutWidgetComponent, AXPFlexItemBaseLayoutWidgetComponent, AXPGridBaseLayoutWidgetComponent, AXPGridItemBaseLayoutWidgetComponent, AXPInlineBaseLayoutWidgetComponent, AXPLayoutBaseWidgetComponent, AXPPageStatus, AXPPropertyEditorHelper, AXPTableBaseLayoutWidgetComponent, AXPTableItemBaseLayoutWidgetComponent, AXPTableItemOpsBaseLayoutWidgetComponent, AXPValueWidgetComponent, AXPWidgetColumnRendererComponent, AXPWidgetContainerComponent, AXPWidgetCoreElement, AXPWidgetCoreModule, AXPWidgetCoreService, AXPWidgetGroupEnum, AXPWidgetRegistryService, AXPWidgetRendererDirective, AXPWidgetSerializationHelper, AXPWidgetStatus, AXPWidgetsCatalog, AXP_WIDGETS_ACTION_CATEGORY, AXP_WIDGETS_ACTION_SUB_CONTROLS, AXP_WIDGETS_ADVANCE_CATEGORY, AXP_WIDGETS_ADVANCE_SUB_DATA, AXP_WIDGETS_ADVANCE_SUB_INPUT, AXP_WIDGETS_ADVANCE_SUB_MEDIA, AXP_WIDGETS_ADVANCE_SUB_TOOLS, AXP_WIDGETS_AI_CATEGORY, AXP_WIDGETS_CATEGORIES, AXP_WIDGETS_EDITOR_CATEGORY, AXP_WIDGETS_EDITOR_SUB_CHOICE, AXP_WIDGETS_EDITOR_SUB_COMPOSITE, AXP_WIDGETS_EDITOR_SUB_CONFIG, AXP_WIDGETS_EDITOR_SUB_DATETIME, AXP_WIDGETS_EDITOR_SUB_NUMERIC, AXP_WIDGETS_EDITOR_SUB_RICH, AXP_WIDGETS_EDITOR_SUB_TEXT_INPUTS, AXP_WIDGETS_EDITOR_SUB_VISUAL, AXP_WIDGETS_LAYOUT_CATEGORY, AXP_WIDGETS_LAYOUT_SUB_GRID, AXP_WIDGETS_LAYOUT_SUB_LISTS, AXP_WIDGETS_LAYOUT_SUB_SHELL, AXP_WIDGETS_LAYOUT_SUB_SURFACES, AXP_WIDGETS_LAYOUT_SUB_TABS, AXP_WIDGETS_LAYOUT_SUB_UTILITY, AXP_WIDGET_COLUMN_TOKEN, AXP_WIDGET_DEFINITION_PROVIDER, AXP_WIDGET_TOKEN, buildWidgetRegistryMapFromProviders, cloneProperty, createBooleanProperty, createNumberProperty, createSelectProperty, createStringProperty, findNonEmptyBreakpoints, mapAXPPropertyToWidgetProperty, normalizeWidgetCategories };
+export type { AXPBorderBox, AXPBorderBoxString, AXPBreakpointValues, AXPBreakpoints, AXPClassMap, AXPExtendedWidget, AXPExtractWidgetConfig, AXPFlexBoxString, AXPFlexItemBoxString, AXPGridBoxString, AXPGridBreakpointValues, AXPGridItemBoxString, AXPLayoutBuilderStatusChangedEvent, AXPMetaDataDefinition, AXPMetaDataFeatures, AXPPropertyCorners, AXPPropertyEditorCornerValues, AXPPropertyEditorSideGeneric, AXPPropertyEditorSideValues, AXPPropertySides, AXPSpacingBox, AXPSpacingBoxString, AXPStyleMap, AXPWidgetColumnNode, AXPWidgetColumnNodeToken, AXPWidgetComponentConfig, AXPWidgetConfig, AXPWidgetConfigComponents, AXPWidgetCoreElementAPI, AXPWidgetCoreElementAction, AXPWidgetCoreModuleConfigs, AXPWidgetDefinitionProvider, AXPWidgetDesignerOptionsMap, AXPWidgetGroup, AXPWidgetNode, AXPWidgetNodeToken, AXPWidgetProperty, AXPWidgetPropertyGroup, AXPWidgetRenderMode, AXPWidgetRendererDirectiveOptions, AXPWidgetTypesMap, AXPWidgetViewType, MapAXPPropertyToWidgetPropertyOptions };

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

@@ -1567,6 +1567,11 @@ declare class AXPRichTextWidgetColumnComponent extends AXPColumnWidgetComponent<
     private platform;
     private readonly layoutBuilder;
     private readonly mlResolver;
+    /** Plain-text length threshold: above this, cell is clamped and clickable for full preview. */
+    protected previewMaxChars(): number;
+    /** Whether resolved HTML is long enough to warrant truncation + popup. */
+    protected isTruncatedPreview(resolvedHtml: string): boolean;
+    protected onExpandClick(event: AXClickEvent): void;
     protected openPopup(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRichTextWidgetColumnComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPRichTextWidgetColumnComponent, "axp-rich-text-widget-column", never, { "rawValue": { "alias": "rawValue"; "required": false; }; "rowData": { "alias": "rowData"; "required": false; }; }, {}, never, never, true, never>;
@@ -1594,8 +1599,12 @@ declare class AXPRichTextWidgetViewComponent extends AXPValueWidgetComponent<str
     private platform;
     private readonly layoutBuilder;
     private readonly mlResolver;
-    /** Resolved HTML for the preview dialog (same rules as the inline snippet). */
+    private readonly currentLanguage;
+    /** Resolved HTML for inline snippet and preview dialog. */
     protected displayHtml: _angular_core.Signal<string>;
+    /** Full-body preview (dialogs) vs truncated grid snippet. */
+    protected showFullContent: _angular_core.Signal<boolean>;
+    protected previewMaxHeightPx: _angular_core.Signal<number>;
     protected openPopup(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPRichTextWidgetViewComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPRichTextWidgetViewComponent, "axp-rich-text-widget-view", never, {}, {}, never, never, true, never>;
@@ -1617,6 +1626,10 @@ interface AXPRichTextWidgetDesignerOptions {
     fitLineCount?: boolean;
 }
 interface AXPRichTextWidgetViewOptions {
+    /** Scrollable full HTML in view mode (e.g. layout-builder preview dialogs). */
+    showFullContent?: boolean;
+    /** Max height in px when `showFullContent` is true; defaults to 400. */
+    height?: number;
 }
 interface AXPRichTextWidgetEditOptions {
     placeholder?: string;
@@ -1628,6 +1641,11 @@ interface AXPRichTextWidgetEditOptions {
     fitLineCount?: boolean;
 }
 interface AXPRichTextWidgetColumnOptions {
+    /**
+     * Plain-text length above which the grid cell is line-clamped and opens the preview dialog on click.
+     * @default 100
+     */
+    previewMaxChars?: number;
 }
 interface AXPRichTextWidgetPrintOptions {
 }
@@ -3234,6 +3252,8 @@ declare class AXPStatusChipComponent {
     protected isPopoverOpen: _angular_core.WritableSignal<boolean>;
     protected isUpdating: _angular_core.WritableSignal<boolean>;
     protected providerSignal: _angular_core.WritableSignal<AXPStatusProvider | undefined>;
+    /** Native tooltip from translated `AXPStatusDefinition.description` (i18n key). */
+    protected chipTooltip: _angular_core.WritableSignal<string | null>;
     protected statuses: _angular_core.Signal<AXPStatusDefinition[]>;
     protected transitions: _angular_core.Signal<AXPStatusTransition[]>;
     /**
@@ -3248,6 +3268,7 @@ declare class AXPStatusChipComponent {
      * Load status provider when definitionKey changes
      */
     private loadProvider;
+    private syncDescriptionTooltip;
     /**
      * Open the popover
      */
@@ -3327,7 +3348,7 @@ declare class AXPStatusWidgetEditComponent extends AXPValueWidgetComponent<any |
     protected onTransitionExecuted(transition: AXPStatusTransitionWithTarget): void;
     protected onTransitionError(error: Error): void;
     /**
-     * Get entity data for command execution context
+     * Build context for default `Entity:UpdateStatus` (entity key, record id, status field path).
      */
     protected getEntityData(): Record<string, any> | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPStatusWidgetEditComponent, never>;
@@ -5388,7 +5409,7 @@ declare class AXPWidgetsModule {
 }
 
 interface AXPGetWidgetsForAIQueryInput {
-    /** When set, returns full serializable metadata for that widget; otherwise returns the AI catalog list. */
+    /** When set, returns full serializable metadata for that widget; otherwise returns the full registry list (no filtering). */
     name?: string;
 }
 interface AXPGetWidgetsForAIQueryListItem {
@@ -5425,7 +5446,6 @@ interface AXPGetWidgetsForAIQuerySerializableWidget {
     designer?: AXPWidgetConfig['designer'];
     options?: AXPWidgetConfig['options'];
     defaultFilterWidgetName?: AXPWidgetConfig['defaultFilterWidgetName'];
-    aiCatalog?: AXPWidgetConfig['aiCatalog'];
 }
 interface AXPGetWidgetsForAIQuerySerializableComponents {
     designer?: {
@@ -5472,7 +5492,7 @@ type AXPGetWidgetsForAIQueryResult = {
     error: string;
 };
 /**
- * Read-only catalog of widgets suitable for AI structured rendering (Widgets:GetForAI).
+ * Read-only full widget registry (Widgets:GetForAI). Lists every registered widget.
  */
 declare class AXPGetWidgetsForAIQuery implements AXPQuery<AXPGetWidgetsForAIQueryInput | undefined, AXPGetWidgetsForAIQueryResult> {
     private readonly registry;