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

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

@@ -6,12 +6,13 @@ import { AXClickEvent } from '@acorex/cdk/common';
 import * as i1 from '@acorex/cdk/drawer';
 import { AXDrawerItemDirective } from '@acorex/cdk/drawer';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPActionMenuItem, AXPBreadcrumbItem, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
+import { AXPActionMenuItem, AXPBreadcrumbItem, AXPMultiLanguageString, AXPBadge, AXPPageStatus, AXPBackButton, AXPExecuteCommand, AXPDeviceService, AXPExecuteCommandResult, AXPExpressionEvaluatorScope, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXPCommandService, AXPPolicyEngineService } from '@acorex/platform/runtime';
 import { AXPWorkflowService } from '@acorex/platform/workflow';
+import * as _acorex_core_translation from '@acorex/core/translation';
+import { AXTranslationService } from '@acorex/core/translation';
 import { AXToastService } from '@acorex/components/toast';
 import { AXFormatService } from '@acorex/core/format';
-import { AXTranslationService } from '@acorex/core/translation';
 import { AXPSessionService } from '@acorex/platform/auth';
 import { AXPHomePageService } from '@acorex/platform/common';
 import { AXBasePageComponent } from '@acorex/components/page';
@@ -30,12 +31,12 @@ declare abstract class AXPPageLayoutBase {
     abstract hasSecondaryActions: Signal<boolean>;
     abstract hasActions: Signal<boolean>;
     abstract breadcrumbs: Signal<AXPBreadcrumbItem[]>;
-    abstract title: Signal<string>;
+    abstract title: Signal<AXPMultiLanguageString>;
     abstract titleIcon: Signal<string | null>;
     abstract hasTitle: Signal<boolean>;
     abstract hasTitleIcon: Signal<boolean>;
     abstract hasDescription: Signal<boolean>;
-    abstract description: Signal<string | null>;
+    abstract description: Signal<AXPMultiLanguageString | null>;
     abstract hasBreadcrumbs: Signal<boolean>;
     abstract hasBadge: Signal<boolean>;
     abstract badge: Signal<AXPBadge | null>;
@@ -176,15 +177,15 @@ declare abstract class AXPPageLayoutBaseComponent implements AXPPageLayoutBase {
     protected updateTrigger: _angular_core.Signal<number>;
     protected recompute(): void;
     ngOnInit(): Promise<void>;
-    title: _angular_core.WritableSignal<string>;
+    title: _angular_core.WritableSignal<_acorex_core_translation.AXMultiLanguageString>;
     titleIcon: _angular_core.WritableSignal<string | null>;
-    protected getPageTitle(): string | Promise<string>;
+    protected getPageTitle(): AXPMultiLanguageString | Promise<AXPMultiLanguageString>;
     protected getPageIcon(): string | null | Promise<string | null>;
     hasTitle: _angular_core.Signal<boolean>;
     hasTitleIcon: _angular_core.Signal<boolean>;
-    description: _angular_core.WritableSignal<string | null>;
+    description: _angular_core.WritableSignal<_acorex_core_translation.AXMultiLanguageString | null>;
     hasDescription: _angular_core.Signal<boolean>;
-    protected getPageDescription(): string | null | Promise<string | null>;
+    protected getPageDescription(): AXPMultiLanguageString | null | Promise<AXPMultiLanguageString | null>;
     private defaultBreadCrumbs;
     breadcrumbs: _angular_core.WritableSignal<AXPBreadcrumbItem[]>;
     hasBreadcrumbs: _angular_core.Signal<boolean>;
@@ -389,9 +390,9 @@ interface AXPLayoutDetailsViewTabItem {
 }
 interface AXPLayoutDetailsViewPage {
     id: string;
-    title: string;
-    label: string;
-    description?: string;
+    title: AXPMultiLanguageString;
+    label: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
     icon?: string;
     /**
      * Content can be either widget nodes or component references
@@ -431,9 +432,9 @@ interface AXPLayoutDetailsViewPage {
 }
 interface AXPLayoutDetailsViewAdapter {
     name: string;
-    title?: string;
-    label?: string;
-    description?: string;
+    title?: AXPMultiLanguageString;
+    label?: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
     icon?: string;
     actions?: AXPLayoutDetailsViewAction[];
     breadcrumbs?: AXPBreadcrumbItem[];
@@ -480,8 +481,6 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
     updateContext: (context: any) => void;
     updatePageSelectedRows: (rows: any[]) => void;
-    currentPageTitle: () => string | null;
-    currentPageDescription: () => string | null;
     currentPagePrimaryActions: () => Promise<any>;
     currentPageSecondaryActions: () => Promise<any>;
     currentPageContent: () => AXPWidgetNode[];
@@ -491,13 +490,16 @@ declare const AXPLayoutDetailsViewViewModel: _angular_core.Type<{
     getCurrentTabContent: () => AXPWidgetNode[];
     getRenderedTabContent: (tabId: string) => AXPWidgetNode[];
     clearPageTabCache: (pageId: string) => void;
-    title: () => string | null;
-    backButtonTitle: () => string | null;
-    description: () => string | null;
+    backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
+    getPageTitle: () => Promise<AXPMultiLanguageString>;
+    getPageDescription: () => Promise<AXPMultiLanguageString | null>;
+    getBackButton: () => Promise<AXPBackButton | null>;
+    getPageBadge: () => Promise<AXPBadge | null>;
+    getPageStatus: () => Promise<AXPPageStatus | null>;
     primaryActions: () => Promise<any>;
     secondaryActions: () => Promise<any>;
     breadcrumbs: () => Promise<{
-        title: string;
+        title: _acorex_core_translation.AXMultiLanguageString;
         name?: string;
         icon?: string;
         command?: AXPExecuteCommand;
@@ -561,8 +563,6 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         load: (adapter: AXPLayoutDetailsViewAdapter) => Promise<void>;
         updateContext: (context: any) => void;
         updatePageSelectedRows: (rows: any[]) => void;
-        currentPageTitle: () => string | null;
-        currentPageDescription: () => string | null;
         currentPagePrimaryActions: () => Promise<any>;
         currentPageSecondaryActions: () => Promise<any>;
         currentPageContent: () => _acorex_platform_layout_widget_core.AXPWidgetNode[];
@@ -572,13 +572,16 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
         getCurrentTabContent: () => _acorex_platform_layout_widget_core.AXPWidgetNode[];
         getRenderedTabContent: (tabId: string) => _acorex_platform_layout_widget_core.AXPWidgetNode[];
         clearPageTabCache: (pageId: string) => void;
-        title: () => string | null;
-        backButtonTitle: () => string | null;
-        description: () => string | null;
+        backButtonTitle: () => _acorex_core_translation.AXMultiLanguageString;
+        getPageTitle: () => Promise<AXPMultiLanguageString>;
+        getPageDescription: () => Promise<AXPMultiLanguageString | null>;
+        getBackButton: () => Promise<AXPBackButton | null>;
+        getPageBadge: () => Promise<AXPBadge | null>;
+        getPageStatus: () => Promise<AXPPageStatus | null>;
         primaryActions: () => Promise<any>;
         secondaryActions: () => Promise<any>;
         breadcrumbs: () => Promise<{
-            title: string;
+            title: _acorex_core_translation.AXMultiLanguageString;
             name?: string;
             icon?: string;
             command?: AXPExecuteCommand;
@@ -607,7 +610,6 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     protected route: ActivatedRoute;
     protected eventService: AXPBroadcastEventService;
     protected deviceService: AXPDeviceService;
-    private settingsService;
     private onSelectionChangeSubscription?;
     private readonly destroyed$;
     protected form: _angular_core.Signal<AXFormComponent | undefined>;
@@ -634,8 +636,8 @@ declare class AXPLayoutDetailsViewComponent extends AXPPageLayoutBaseComponent i
     getSecondaryMenuItems(): Promise<AXPActionMenuItem[]>;
     protected getFooterSecondaryActions(): Promise<AXPActionMenuItem[]>;
     protected getPageBreadcrumbs(): Promise<AXPBreadcrumbItem[]>;
-    protected getPageTitle(): Promise<string>;
-    getPageDescription(): Promise<string | null>;
+    protected getPageTitle(): Promise<AXPMultiLanguageString>;
+    getPageDescription(): Promise<AXPMultiLanguageString | null>;
     getBackButton(): Promise<AXPBackButton | null>;
     getPageBadge(): Promise<AXPBadge | null>;
     getPageStatus(): Promise<AXPPageStatus | null>;

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 } 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 {
@@ -189,20 +176,9 @@ interface AXPWidgetTypesMap {
     betweenValidation: 'between-validation';
     equalValidation: 'equal-validation';
     callbackValidation: 'callback-validation';
-    donutChart: 'donut-chart';
-    barChart: 'bar-chart';
-    lineChart: 'line-chart';
-    gaugeChart: 'gauge-chart';
-    stickyNote: 'sticky-note';
-    clockCalendar: 'clock-calendar';
-    analogClock: 'analog-clock';
-    weather: 'weather';
-    minimalWeather: 'minimal-weather';
-    advancedWeather: 'advanced-weather';
     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';
@@ -212,7 +188,6 @@ interface AXPWidgetTypesMap {
     themeColorChooser: 'theme-color-chooser';
     panel: 'panel';
     notification: 'notification';
-    taskBoard: 'task-board';
     comment: 'comment';
     list: 'list-editor';
     dataList: 'data-list';
@@ -227,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;
@@ -324,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;
@@ -370,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;
@@ -386,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;
@@ -522,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;
@@ -548,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>;
@@ -1070,17 +1082,34 @@ interface AXPMetaDataDefinition {
 
 declare const AXPWidgetsCatalog: AXPWidgetTypesMap;
 
-/**
- * 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, 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 };
+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

@@ -5,7 +5,7 @@ import { OnInit, WritableSignal, InjectionToken, EventEmitter, Signal, OnDestroy
 import { AXValueChangedEvent, AXDataSourceFilterOption, AXStyleColorType, AXClickEvent, AXStyleLookType, AXDataSource, AXDirection, AXButtonClickEvent } from '@acorex/cdk/common';
 import { AXBasePageComponent } from '@acorex/components/page';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPDeviceService, AXPContextChangeEvent, AXPFilterClause, AXPFilterDefinition, AXPValidationRule, AXPTag, AXPFileListItem, AXPExpressionEvaluatorService, AXPExecuteCommandResult, AXPMultiLanguageString, AXPActionMenuItem, AXPDataSourceDefinition } from '@acorex/platform/core';
+import { AXPDeviceService, AXPContextChangeEvent, AXPFilterClause, AXPFilterDefinition, AXPValidationRule, AXPTag, AXPFileListItem, AXPExpressionEvaluatorService, AXPExecuteCommandResult, AXPActionMenuItem, AXPDataSourceDefinition } from '@acorex/platform/core';
 import { AXSelectBoxComponent } from '@acorex/components/select-box';
 import { AXPClipBoardService, AXPLanguage, AXCFileUploaderCapabilities, AXCFileUploaderAction, AXPStatusDefinition, AXPStatusTransition, AXPStatusProvider } from '@acorex/platform/common';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
@@ -27,6 +27,7 @@ import { AXQrcodeLevel, AXQrcodeOutputType } from '@acorex/components/qrcode';
 import { AXSchedulerPickerValue, AXSchedulerPickerSettings } from '@acorex/components/scheduler-picker';
 import { AXPaintContainerComponent, AXPaintViewComponent } from '@acorex/components/paint';
 import { AXPopoverComponent } from '@acorex/components/popover';
+import * as _acorex_core_translation from '@acorex/core/translation';
 import { AXGridLayoutOptions, AXGridLayoutNode } from '@acorex/components/grid-layout-builder';
 import * as _acorex_platform_layout_widgets from '@acorex/platform/layout/widgets';
 import { AXStepWizardComponent } from '@acorex/components/step-wizard';
@@ -1183,7 +1184,6 @@ declare class AXPLargeTextWidgetEditComponent extends AXPValueWidgetComponent<st
     protected rows: _angular_core.Signal<number>;
     private popupService;
     private translationService;
-    private readonly mlResolver;
     private readonly currentLanguage;
     ngOnInit(): void;
     handleValueChange(e: AXValueChangedEvent): void;
@@ -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>;
@@ -1582,7 +1587,6 @@ declare class AXPRichTextWidgetEditComponent extends AXPValueWidgetComponent<str
     protected onWysiwygChanged(e: AXValueChangedEvent<string>): void;
     private popupService;
     private translationService;
-    private readonly mlResolver;
     currentLanguage: _angular_core.Signal<string>;
     ngOnInit(): void;
     protected getCurrentText: _angular_core.Signal<string>;
@@ -1595,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>;
@@ -1618,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;
@@ -1629,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 {
 }
@@ -2003,7 +2020,6 @@ declare class AXPTextBoxWidgetColumnComponent extends AXPColumnWidgetComponent<s
 declare class AXPTextBoxWidgetEditComponent extends AXPValueWidgetComponent<string | Record<string, string> | undefined> {
     private popupService;
     private translationService;
-    private readonly mlResolver;
     protected multiLanguage: _angular_core.Signal<boolean>;
     protected hasClearButton: _angular_core.Signal<boolean>;
     protected disabled: _angular_core.Signal<boolean>;
@@ -2542,7 +2558,7 @@ declare class AXPFileListComponent implements OnInit, OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPFileListComponent, "axp-file-list", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "fileEditable": { "alias": "fileEditable"; "required": false; "isSignal": true; }; "enableTitleDescription": { "alias": "enableTitleDescription"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "files": { "alias": "files"; "required": false; "isSignal": true; }; "plugins": { "alias": "plugins"; "required": false; "isSignal": true; }; "excludePlugins": { "alias": "excludePlugins"; "required": false; "isSignal": true; }; "capabilities": { "alias": "capabilities"; "required": false; "isSignal": true; }; }, { "onRemove": "onRemove"; "onRevert": "onRevert"; "onRename": "onRename"; }, never, never, true, never>;
 }
 
-declare class AXPFileUploaderWidgetColumnComponent extends AXPColumnWidgetComponent<string[]> {
+declare class AXPFileUploaderWidgetColumnComponent extends AXPColumnWidgetComponent<AXPFileListItem[]> {
     protected count: _angular_core.Signal<number>;
     private fileService;
     openFileList(): Promise<void>;
@@ -2667,7 +2683,7 @@ declare class AXPFileUploaderWidgetService {
     private popupService;
     private translate;
     showFileList(options?: {
-        files?: AXPFileListItem[] | string[];
+        files?: AXPFileListItem[];
         /** When true, user cannot add or change files (matches file-uploader widget options). */
         'readonly'?: boolean;
         multiple?: boolean;
@@ -3236,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[]>;
     /**
@@ -3250,6 +3268,7 @@ declare class AXPStatusChipComponent {
      * Load status provider when definitionKey changes
      */
     private loadProvider;
+    private syncDescriptionTooltip;
     /**
      * Open the popover
      */
@@ -3281,6 +3300,10 @@ declare class AXPStatusWidgetColumnComponent extends AXPColumnWidgetComponent<an
     private providerSignal;
     private loadProvider;
     protected definitionKey: _angular_core.Signal<string | null>;
+    /**
+     * When true, the grid cell is display-only (no transition popover). Default false preserves existing grids.
+     */
+    protected columnReadonly: _angular_core.Signal<boolean>;
     protected entityData: _angular_core.Signal<Record<string, any> | null>;
     private readonly resolvedStatuses;
     private readonly resolvedTransitions;
@@ -3302,6 +3325,8 @@ declare class AXPStatusWidgetEditComponent extends AXPValueWidgetComponent<any |
     protected statusChip: _angular_core.Signal<AXPStatusChipComponent | undefined>;
     private readonly statusService;
     protected definitionKey: _angular_core.Signal<string | null>;
+    /** When true, the chip is display-only (no transition popover). Set via interface options. */
+    protected isReadonly: _angular_core.Signal<boolean>;
     protected providerSignal: _angular_core.WritableSignal<AXPStatusProvider | undefined>;
     protected statuses: _angular_core.Signal<AXPStatusDefinition[]>;
     protected transitions: _angular_core.Signal<AXPStatusTransition[]>;
@@ -3323,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>;
@@ -3334,6 +3359,8 @@ declare class AXPStatusWidgetViewComponent extends AXPDataListWidgetComponent {
     protected statusChip: _angular_core.Signal<AXPStatusChipComponent | undefined>;
     private readonly statusService;
     protected definitionKey: _angular_core.Signal<string | null>;
+    /** When true, the chip is display-only (no transition popover). Set via interface options. */
+    protected isReadonly: _angular_core.Signal<boolean>;
     private providerSignal;
     private resolvedStatuses;
     private resolvedTransitions;
@@ -3439,7 +3466,7 @@ declare const AXPWidgetFieldConfiguratorWidget: AXPWidgetConfig;
 declare class AXPWidgetFieldConfiguratorWidgetEditComponent extends AXPValueWidgetComponent<AXPWidgetNode> {
     protected readonly: _angular_core.Signal<boolean>;
     protected fieldName: _angular_core.Signal<string>;
-    protected fieldTitle: _angular_core.Signal<AXPMultiLanguageString>;
+    protected fieldTitle: _angular_core.Signal<_acorex_core_translation.AXMultiLanguageString>;
     protected label: _angular_core.Signal<string>;
     protected isInitialized: _angular_core.WritableSignal<boolean>;
     protected widgetConfigModel: _angular_core.ModelSignal<AXPWidgetNode>;
@@ -3785,8 +3812,8 @@ interface AXPBlockWidgetOptions {
 }
 
 declare class AXPFieldsetWidgetDesignerComponent extends AXPLayoutBaseWidgetComponent {
-    protected title: _angular_core.Signal<AXPMultiLanguageString>;
-    protected description: _angular_core.Signal<AXPMultiLanguageString>;
+    protected title: _angular_core.Signal<_acorex_core_translation.AXMultiLanguageString>;
+    protected description: _angular_core.Signal<_acorex_core_translation.AXMultiLanguageString>;
     protected icon: _angular_core.Signal<string>;
     protected collapsible: _angular_core.Signal<boolean>;
     protected isOpen: _angular_core.WritableSignal<boolean>;
@@ -3801,8 +3828,8 @@ declare class AXPFieldsetWidgetDesignerComponent extends AXPLayoutBaseWidgetComp
 type AXPFieldsetWidgetLook = 'fieldset' | 'card' | 'group' | 'container';
 
 declare class AXPFieldsetWidgetViewComponent extends AXPLayoutBaseWidgetComponent {
-    protected title: _angular_core.Signal<AXPMultiLanguageString>;
-    protected description: _angular_core.Signal<AXPMultiLanguageString>;
+    protected title: _angular_core.Signal<_acorex_core_translation.AXMultiLanguageString>;
+    protected description: _angular_core.Signal<_acorex_core_translation.AXMultiLanguageString>;
     protected icon: _angular_core.Signal<string>;
     protected collapsible: _angular_core.Signal<boolean>;
     protected isOpen: _angular_core.WritableSignal<boolean>;
@@ -5382,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 {
@@ -5419,7 +5446,6 @@ interface AXPGetWidgetsForAIQuerySerializableWidget {
     designer?: AXPWidgetConfig['designer'];
     options?: AXPWidgetConfig['options'];
     defaultFilterWidgetName?: AXPWidgetConfig['defaultFilterWidgetName'];
-    aiCatalog?: AXPWidgetConfig['aiCatalog'];
 }
 interface AXPGetWidgetsForAIQuerySerializableComponents {
     designer?: {
@@ -5466,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;