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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/platform",
-  "version": "21.0.0-next.39",
+  "version": "21.0.0-next.40",
   "peerDependencies": {
     "@acorex/cdk": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0",
     "@acorex/core": "^19.0.0 || ^20.0.0 || ^21.0.0-next.0",

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

@@ -920,6 +920,17 @@ type AXPExpression = string;
  * `{ "en-US": "<p>Pick one</p>", "fa-IR": "<p>یکی را انتخاب کنید</p>" }`
  */
 type AXPMultiLanguageString = AXMultiLanguageString;
+/**
+ * Shared category descriptor for widgets, query catalog tooling, and other definition groupings.
+ */
+interface AXPDefinitionCategory {
+    name: string;
+    title: AXPMultiLanguageString;
+    order: number;
+    icon?: string;
+}
+/** Normalizes definition categories to an array for iteration and serialization. */
+declare function normalizeDefinitionCategories(categories?: AXPDefinitionCategory | AXPDefinitionCategory[]): AXPDefinitionCategory[];
 type AXPMetaData = Record<string, any>;
 type AXPOptionsData<T extends Record<string, unknown> = Record<string, any>> = T;
 interface AXPValueUnit {
@@ -2867,5 +2878,5 @@ declare function containsHtmlMarkup(value: string | null | undefined): boolean;
  */
 declare function generateKebabCase(title: string): string;
 
-export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPImageUrlLogoConfig, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, MODULE_MANIFESTS_DATASOURCE_NAME, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getSystemActions, objectKeyValueTransforms, provideLazyProvider, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, setSmart, sortByMultiLanguageString };
-export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPCommandMessage, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextState, AXPDataSource, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDataType, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPFileListItem, AXPFileSource, AXPFileStatus, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPISessionService, AXPLazyDataSource, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPMultiLanguageString, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOptionsData, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSortDefinition, AXPSortQuery, AXPStartUpTask, AXPStringValidationRules, AXPSystemAction, AXPTag, AXPTagFilterOptions, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetTrigger, AXPWidgetTriggers, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };
+export { AXHighlightService, AXPActivityLogProvider, AXPActivityLogService, AXPAppStartUpProvider, AXPAppStartUpService, AXPBroadcastEventService, AXPColorPaletteProvider, AXPColorPaletteService, AXPColumnWidthService, AXPComponentLogoConfig, AXPComponentSlot, AXPComponentSlotDirective, AXPComponentSlotModule, AXPComponentSlotRegistryService, AXPContentCheckerDirective, AXPContextChangeEvent, AXPContextStore, AXPCountdownPipe, AXPDataGenerator, AXPDataSourceDefinitionProviderService, AXPDblClickDirective, AXPDefaultColorPalettesProvider, AXPDeviceService, AXPDeviceType, AXPDistributedEventListenerService, AXPElementDataDirective, AXPExportTemplateToken, AXPExpressionEvaluatorScopeProviderContext, AXPExpressionEvaluatorScopeProviderService, AXPExpressionEvaluatorService, AXPFeatureDefinitionProviderContext, AXPGridLayoutDirective, AXPHookService, AXPIconLogoConfig, AXPImageUrlLogoConfig, AXPModuleManifestModule, AXPModuleManifestRegistry, AXPModuleManifestsDataSourceDefinition, AXPPlatformScope, AXPScreenSize, AXPSystemActionType, AXPSystemActions, AXPTagProvider, AXPTagService, AXP_ACTIVITY_LOG_PROVIDER, AXP_COLOR_PALETTE_PROVIDER, AXP_COLUMN_WIDTH_PROVIDER, AXP_DATASOURCE_DEFINITION_PROVIDER, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER, AXP_EXPRESSION_EVALUATOR_SCOPE_PROVIDER, AXP_FEATURE_DEFINITION_PROVIDER, AXP_MODULE_MANIFEST_PROVIDER, AXP_SESSION_SERVICE, AXP_TAG_PROVIDER, MODULE_MANIFESTS_DATASOURCE_NAME, applyFilterArray, applyPagination, applyQueryArray, applySortArray, applySystemActionDefault, cleanDeep, compareMultiLanguageStrings, containsHtmlMarkup, createProviderWithInjectionContext, defaultColumnWidthProvider, extractNestedFieldsWildcard, extractTextFromHtml, extractValue, generateKebabCase, getActionButton, getChangedPaths, getDetailedChanges, getEnumValues, getNestedKeys, getSmart, getSystemActions, normalizeDefinitionCategories, objectKeyValueTransforms, provideLazyProvider, resolveActionLook, resolvePlatformScopeKey, resolvePlatformScopeName, setSmart, sortByMultiLanguageString };
+export type { AXPActionMenuItem, AXPActivityLog, AXPActivityLogChange, AXPApplicationUserReference, AXPBackButton, AXPBadge, AXPBreadcrumbItem, AXPCategorizedEntity, AXPCategorizedEntityDto, AXPCategoryEntity, AXPCategoryEntityWithItems, AXPCategoryListItem, AXPColorPalette, AXPColorPaletteFilterOptions, AXPColumnQuery, AXPColumnWidthMatcher, AXPColumnWidthProvider, AXPCommandMessage, AXPComponentSlotConfig, AXPComponentSlotModuleConfigs, AXPContent, AXPContentDirection, AXPContentType, AXPContextData, AXPContextState, AXPDataSource, AXPDataSourceArray, AXPDataSourceDataFieldDefinition, AXPDataSourceDefinition, AXPDataSourceDefinitionProvider, AXPDataSourceSample, AXPDataSourceType, AXPDataSourceValue, AXPDataType, AXPDefinitionCategory, AXPDistributedEventListenerProvider, AXPDistributedEventListenerProviderToken, AXPEntityOp, AXPEntityReference, AXPEqualValidationRule, AXPExecuteCommand, AXPExecuteCommandResult, AXPExportCsvOptions, AXPExportExcelOptions, AXPExportOptions, AXPExportPdfOptions, AXPExportPrintOptions, AXPExpression, AXPExpressionEvaluatorScope, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviders, AXPFeatureDefinition, AXPFeatureDefinitionProvider, AXPFeatureName, AXPFileListItem, AXPFileSource, AXPFileStatus, AXPFilterClause, AXPFilterDefinition, AXPFilterQuery, AXPFilterTriggerDefinition, AXPFlowDirection, AXPGridLayoutOptions, AXPGridPlacement, AXPISessionService, AXPLazyDataSource, AXPLogoConfig, AXPMaxLengthValidationRule, AXPMaybePromise, AXPMetaData, AXPMiddlewareErrorResponse, AXPMinLengthValidationRule, AXPModuleFeatureDefinition, AXPModuleFeatureDefinitionWithKey, AXPModuleManifest, AXPMultiLanguageString, AXPNavigateActionCommand, AXPNavigateActionOptions, AXPOptionsData, AXPPageStatus, AXPPagedListResult, AXPPartialNested, AXPPlatformScopeKey, AXPProperty, AXPPropertyGroup, AXPPropertyInterface, AXPQueryFetchResult, AXPQueryRequest, AXPReqexValidationRule, AXPRequiredValidationRule, AXPSortDefinition, AXPSortQuery, AXPStartUpTask, AXPStringValidationRules, AXPSystemAction, AXPTag, AXPTagFilterOptions, AXPUserReference, AXPValidationRule, AXPValidationRules, AXPValueTransformerFunction, AXPValueTransformerFunctions, AXPValueUnit, AXPValueUnits, AXPViewBlockDefinition, AXPViewDefinition, AXPViewFieldDefinition, AXPViewQuery, AXPWidgetTrigger, AXPWidgetTriggers, ColumnNameMatcher, ColumnWidthValue, IColumnWithWidth, WidgetTypeMatcher };

package/types/acorex-platform-domain.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, Type, EnvironmentProviders } from '@angular/core';
-import { AXPExpression, AXPMetaData, AXPDataType, AXPOptionsData, AXPValidationRules } from '@acorex/platform/core';
+import { AXPExpression, AXPMetaData, AXPDataType, AXPOptionsData, AXPDefinitionCategory, AXPValidationRules } from '@acorex/platform/core';
 import * as i1 from '@acorex/platform/runtime';
 
 /**
@@ -307,6 +307,8 @@ interface AXPCommandRegistryRecord {
      * Omitted or empty means no declared surface; consumers may still apply legacy rules (e.g. AI `ai-tool` tag).
      */
     capabilities?: AXPCommandCapability[];
+    /** Optional grouping from build-time command metadata (`categories` on `defineCommand`). */
+    categories?: AXPDefinitionCategory[];
 }
 
 /**
@@ -334,6 +336,22 @@ interface AXPQueryRegistryRecord {
      * Omitted or empty means no declared surface; consumers may still apply legacy rules (e.g. AI `ai-tool` tag).
      */
     capabilities?: AXPCommandCapability[];
+    /** Optional grouping from build-time query metadata (`categories` on `defineQuery`). */
+    categories?: AXPDefinitionCategory[];
+}
+
+/**
+ * Persisted layout-widget catalog row (Dexie/Firestore via AXPEntityDefinitionCrudService).
+ * `name` is the widget registry name from build-time `defineWidget` metadata; `metadataJson` holds the full payload.
+ */
+interface AXPWidgetCatalogRecord {
+    name: string;
+    active: boolean;
+    description?: string;
+    /** Localized / catalog title from metadata `title`. */
+    catalogTitle?: string;
+    /** Pretty-printed JSON of full widget metadata (`defineWidget` sidecar). */
+    metadataJson?: string;
 }
 
 /**
@@ -437,6 +455,14 @@ interface AXPEntityDefinitionCrudService {
     createQuery(id: string, definition: AXPQueryRegistryRecord): Promise<void>;
     updateQuery(id: string, definition: AXPQueryRegistryRecord): Promise<void>;
     deleteQuery(id: string): Promise<void>;
+    listWidgets(): Promise<Array<{
+        id: string;
+        definition: AXPWidgetCatalogRecord;
+    }>>;
+    getWidget(id: string): Promise<AXPWidgetCatalogRecord | null>;
+    createWidget(id: string, definition: AXPWidgetCatalogRecord): Promise<void>;
+    updateWidget(id: string, definition: AXPWidgetCatalogRecord): Promise<void>;
+    deleteWidget(id: string): Promise<void>;
 }
 declare const AXP_ENTITY_DEFINITION_CRUD_SERVICE: InjectionToken<AXPEntityDefinitionCrudService | null>;
 
@@ -2350,4 +2376,4 @@ declare function provideDomainMiddleware(config: {
 }): EnvironmentProviders;
 
 export { AXPAggregateModel, AXPDomainActionSide, AXPDomainMiddlewareContext, AXPDomainModule, AXPDomainRegistry, AXPDomainService, AXPEntityCommandScope, AXPEntityFieldModel, AXPEntityModel, AXPEntityType, AXPModuleHelper, AXPModuleModel, AXPPropertyMiddlewareContext, AXPPropertyModel, AXPPropertyRegistry, AXPPropertyService, AXPRelationModel, AXPRelationshipCardinality, AXPRelationshipKind, AXP_AGGREGATE_MIDDLEWARE_SETUP, AXP_ENTITY_CRUD_SETUP, AXP_ENTITY_DEFINITION_CRUD_SERVICE, AXP_ENTITY_MIDDLEWARE_SETUP, AXP_MODULE_MIDDLEWARE_SETUP, AXP_PROPERTY_EXTENSION, AXP_PROPERTY_LOADER_SETUP, AXP_PROPERTY_MIDDLEWARE_SETUP, AXP_PROPERTY_SETUP, provideAggregateMiddleware, provideDomainLoader, provideDomainLoaders, provideDomainMiddleware, provideEntityMiddleware, provideModuleMiddleware, providePropertiesFromFactory, provideProperty, providePropertyLoaders, providePropertyMiddleware, providePropertySetups, toPropertyDefinition };
-export type { AXPAggregateDefinition, AXPAggregateEntityList, AXPCommandCapability, AXPCommandRegistryRecord, AXPDomainAction, AXPDomainDefinition, AXPDomainLoader, AXPDomainLoaderConfig, AXPDomainMiddleware, AXPDomainPathInfo, AXPDomainRealtedModuleEntity, AXPEntityDefinition, AXPEntityDefinitionCrudService, AXPEntityPropertyDefinition, AXPEntityPropertyFeatures, AXPInterfaceCategory, AXPInterfaceDefinition, AXPInterfaceDefinitionValue, AXPMenuDefinitionEntityListRef, AXPMenuDefinitionRecord, AXPMenuDefinitionStoredCommand, AXPModuleDefinition, AXPPermissionDefinitionRecord, AXPPermissionGroupDefinitionRecord, AXPPermissionLeafRecord, AXPPluginDefinition, AXPPluginDefinitionValue, AXPPropertyDefinition, AXPPropertyEntry, AXPPropertyFeatures, AXPPropertyLoader, AXPPropertyLoaderConfig, AXPPropertyMiddleware, AXPPropertyMiddlewareEntry, AXPPropertyRegistrationOptions, AXPQueryRegistryRecord, AXPRegisteredProperty, AXPRelationDefinition, AXPValidationRuleDefinition, AXPValidationRuleValue, AXPValidationRunAt };
+export type { AXPAggregateDefinition, AXPAggregateEntityList, AXPCommandCapability, AXPCommandRegistryRecord, AXPDomainAction, AXPDomainDefinition, AXPDomainLoader, AXPDomainLoaderConfig, AXPDomainMiddleware, AXPDomainPathInfo, AXPDomainRealtedModuleEntity, AXPEntityDefinition, AXPEntityDefinitionCrudService, AXPEntityPropertyDefinition, AXPEntityPropertyFeatures, AXPInterfaceCategory, AXPInterfaceDefinition, AXPInterfaceDefinitionValue, AXPMenuDefinitionEntityListRef, AXPMenuDefinitionRecord, AXPMenuDefinitionStoredCommand, AXPModuleDefinition, AXPPermissionDefinitionRecord, AXPPermissionGroupDefinitionRecord, AXPPermissionLeafRecord, AXPPluginDefinition, AXPPluginDefinitionValue, AXPPropertyDefinition, AXPPropertyEntry, AXPPropertyFeatures, AXPPropertyLoader, AXPPropertyLoaderConfig, AXPPropertyMiddleware, AXPPropertyMiddlewareEntry, AXPPropertyRegistrationOptions, AXPQueryRegistryRecord, AXPRegisteredProperty, AXPRelationDefinition, AXPValidationRuleDefinition, AXPValidationRuleValue, AXPValidationRunAt, AXPWidgetCatalogRecord };

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

@@ -1,4 +1,4 @@
-import * as i0 from '@angular/core';
+import * as _angular_core from '@angular/core';
 import { OnInit, EventEmitter } from '@angular/core';
 import * as i1 from '@angular/common';
 import { AXFormComponent } from '@acorex/components/form';
@@ -231,9 +231,14 @@ interface AXPFieldsetContainerOptions extends LayoutWidgetOptions {
     showHeader?: boolean;
     cols?: number;
 }
+/** How optional `hint` text is rendered in `form-field` layout widgets. */
+type AXPFormFieldHintDisplayMode = 'icon' | 'note';
 interface AXPFormFieldOptions extends LayoutWidgetOptions {
     label?: string;
     showLabel?: boolean;
+    /** Translated/helper copy; pairing with {@link hintDisplayMode}. */
+    hint?: AXPMultiLanguageString;
+    hintDisplayMode?: AXPFormFieldHintDisplayMode;
 }
 interface AXPDialogContainerOptions extends LayoutWidgetOptions {
     title?: string;
@@ -246,6 +251,10 @@ interface RichTextOptions extends ValueWidgetOptions {
     placeholder?: AXPMultiLanguageString;
     toolbar?: string[];
     readonly?: boolean;
+    /** Max height (px) for scrollable full preview when `showFullContent` is true. */
+    height?: number;
+    /** When true, view mode renders full HTML in a scrollable area instead of a truncated snippet. */
+    showFullContent?: boolean;
 }
 interface PasswordBoxOptions extends ValueWidgetOptions {
     placeholder?: AXPMultiLanguageString;
@@ -650,38 +659,43 @@ declare class AXPLayoutRendererComponent implements OnInit {
     /**
      * Form definition containing groups and fields OR widget tree
      */
-    layout: i0.InputSignal<AXPWidgetNode | AXPDynamicFormDefinition>;
+    layout: _angular_core.InputSignal<AXPWidgetNode | AXPDynamicFormDefinition>;
     /**
      * Form context/model data
      */
-    context: i0.ModelSignal<any>;
+    context: _angular_core.ModelSignal<any>;
     /**
      * Form appearance and density styling (normal, compact, spacious)
      */
-    look: i0.InputSignal<AXPDynamicFormLook>;
+    look: _angular_core.InputSignal<AXPDynamicFormLook>;
     /**
      * Default form mode. Can be overridden by section/group and field.
      */
-    mode: i0.InputSignal<AXPDynamicFormMode>;
-    protected widgetTree: i0.WritableSignal<AXPWidgetNode | null>;
+    mode: _angular_core.InputSignal<AXPDynamicFormMode>;
+    protected widgetTree: _angular_core.WritableSignal<AXPWidgetNode | null>;
+    /**
+     * Prefer explicit {@link AXPWidgetNode.mode} on the root node (e.g. dialog flex `mode('view')`)
+     * so nested widgets resolve view vs edit correctly; fall back to the layout `mode` input.
+     */
+    protected effectiveRenderMode: _angular_core.Signal<"view" | "edit" | "column" | "designer" | "print" | "filter">;
     /**
      * Convert layout data to widget tree when inputs change
      */
-    conversionEffect: i0.EffectRef;
+    conversionEffect: _angular_core.EffectRef;
     /**
      * Emitted when context change is initiated
      */
-    contextInitiated: i0.OutputEmitterRef<any>;
+    contextInitiated: _angular_core.OutputEmitterRef<any>;
     /**
      * Emitted when form becomes valid/invalid
      */
-    validityChange: i0.OutputEmitterRef<boolean>;
+    validityChange: _angular_core.OutputEmitterRef<boolean>;
     private form;
     private container;
     /**
      * Internal context signal for reactivity
      */
-    protected internalContext: i0.WritableSignal<any>;
+    protected internalContext: _angular_core.WritableSignal<any>;
     /**
      * Initial context for reset functionality
      */
@@ -735,14 +749,14 @@ declare class AXPLayoutRendererComponent implements OnInit {
      * Type guard to check if the input is a widget node
      */
     private isWidgetNode;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPLayoutRendererComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXPLayoutRendererComponent, "axp-layout-renderer", never, { "layout": { "alias": "layout"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "context": "contextChange"; "contextInitiated": "contextInitiated"; "validityChange": "validityChange"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutRendererComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutRendererComponent, "axp-layout-renderer", never, { "layout": { "alias": "layout"; "required": true; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; }, { "context": "contextChange"; "contextInitiated": "contextInitiated"; "validityChange": "validityChange"; }, never, never, true, never>;
 }
 
 declare class LayoutBuilderModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutBuilderModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<LayoutBuilderModule, never, [typeof i1.CommonModule, typeof AXPLayoutRendererComponent], [typeof AXPLayoutRendererComponent]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<LayoutBuilderModule>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutBuilderModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<LayoutBuilderModule, never, [typeof i1.CommonModule, typeof AXPLayoutRendererComponent], [typeof AXPLayoutRendererComponent]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<LayoutBuilderModule>;
 }
 
 declare class AXPLayoutBuilderService {
@@ -751,8 +765,8 @@ declare class AXPLayoutBuilderService {
      * Create a new layout builder
      */
     create(): ILayoutBuilder;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPLayoutBuilderService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPLayoutBuilderService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutBuilderService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutBuilderService>;
 }
 
 declare class AXPLayoutConversionService {
@@ -817,8 +831,8 @@ declare class AXPLayoutConversionService {
      * Create a simple hash from a string
      */
     private createSimpleHash;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPLayoutConversionService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPLayoutConversionService>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutConversionService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutConversionService>;
 }
 
 interface DialogRendererConfig {
@@ -849,12 +863,12 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private widgetCoreService;
     private expressionEvaluator;
     private dialogResult?;
-    context: i0.WritableSignal<any>;
+    context: _angular_core.WritableSignal<any>;
     callBack: (dialogRef: AXPDialogRef) => void;
     data: any;
     private isDialogLoading;
-    footerPrefix: i0.WritableSignal<AXPWidgetCoreElementAction[]>;
-    footerSuffix: i0.WritableSignal<AXPWidgetCoreElementAction[]>;
+    footerPrefix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
+    footerSuffix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
     ngOnInit(): void;
     private layoutRenderer;
     private debounceTimer?;
@@ -876,8 +890,8 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private evaluatePredicates;
     private evalBool;
     private resolveApi;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDialogRendererComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXPDialogRendererComponent, "axp-dialog-renderer", never, {}, { "result": "result"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDialogRendererComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDialogRendererComponent, "axp-dialog-renderer", never, {}, { "result": "result"; }, never, never, true, never>;
 }
 
 /** Registration key for {@link AXPPreviewWidgetFieldCommand}; lives alone so `LayoutBuilderModule` can reference it without static-importing the command implementation. */
@@ -917,9 +931,9 @@ declare class AXPPreviewWidgetFieldCommand implements AXPCommand<AXPPreviewWidge
     private resolveFieldTitleLabel;
     private isCancelDialogOutcome;
     private resolveWidgetDisplayTitle;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXPPreviewWidgetFieldCommand, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXPPreviewWidgetFieldCommand>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPPreviewWidgetFieldCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPPreviewWidgetFieldCommand>;
 }
 
 export { AXPDialogRendererComponent, AXPLayoutBuilderService, AXPLayoutConversionService, AXPLayoutRendererComponent, AXPPreviewWidgetFieldCommand, AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY, LayoutBuilderModule };
-export type { AXPDialogContainerOptions, AXPDialogRef, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPFieldsetContainerOptions, AXPFlexContainerOptions, AXPFormFieldOptions, AXPGridContainerOptions, AXPListWidgetColumn, AXPListWidgetOptions, AXPListWidgetRowCommand, AXPPageContainerOptions, AXPPanelContainerOptions, AXPPreviewWidgetFieldCommandInput, AXPStepDefinition, AXPStepWizardContainerOptions, AXPStepWizardDefinition, AXPStepWizardGuardPayload, AXPStepWizardStatus, AXPTabsetContainerOptions, AXPWidgetConfiguration, AXPWidgetNodeExtendedProperties, AXPWizardActionDefinition, AXPWizardActions, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, DialogRendererConfig, DialogRendererResult, FormFieldBuilderState, IActionBuilder, IBaseContainerBuilder, IChildContainerBuilder, IDialogBuilder, IFieldsetContainerBuilder, IFlexContainerBuilder, IFormFieldBuilder, IGridContainerBuilder, ILayoutBuilder, ILayoutContainerBuilder, IListWidgetBuilder, IPageContainerBuilder, IPanelContainerBuilder, IStepBuilder, IStepWizardBuilder, ITabsetContainerBuilder, IWidgetBuilder, IWidgetContainerBuilder, InheritanceContext, InheritedProperties, LargeTextBoxOptions, LayoutBuilderState, LayoutWidgetOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, TextBoxOptions, ToggleSwitchOptions, ValueWidgetOptions, WidgetBuilderState };
+export type { AXPDialogContainerOptions, AXPDialogRef, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPFieldsetContainerOptions, AXPFlexContainerOptions, AXPFormFieldHintDisplayMode, AXPFormFieldOptions, AXPGridContainerOptions, AXPListWidgetColumn, AXPListWidgetOptions, AXPListWidgetRowCommand, AXPPageContainerOptions, AXPPanelContainerOptions, AXPPreviewWidgetFieldCommandInput, AXPStepDefinition, AXPStepWizardContainerOptions, AXPStepWizardDefinition, AXPStepWizardGuardPayload, AXPStepWizardStatus, AXPTabsetContainerOptions, AXPWidgetConfiguration, AXPWidgetNodeExtendedProperties, AXPWizardActionDefinition, AXPWizardActions, ColorBoxOptions, DateTimeBoxOptions, DialogBuilderState, DialogRendererConfig, DialogRendererResult, FormFieldBuilderState, IActionBuilder, IBaseContainerBuilder, IChildContainerBuilder, IDialogBuilder, IFieldsetContainerBuilder, IFlexContainerBuilder, IFormFieldBuilder, IGridContainerBuilder, ILayoutBuilder, ILayoutContainerBuilder, IListWidgetBuilder, IPageContainerBuilder, IPanelContainerBuilder, IStepBuilder, IStepWizardBuilder, ITabsetContainerBuilder, IWidgetBuilder, IWidgetContainerBuilder, InheritanceContext, InheritedProperties, LargeTextBoxOptions, LayoutBuilderState, LayoutWidgetOptions, LookupBoxOptions, NumberBoxOptions, PasswordBoxOptions, RichTextOptions, SelectBoxOptions, SelectionListOptions, TextBoxOptions, ToggleSwitchOptions, ValueWidgetOptions, WidgetBuilderState };

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

@@ -3,12 +3,12 @@ import * as _angular_core from '@angular/core';
 import { EventEmitter, OnChanges, OnDestroy, WritableSignal, NgZone, ComponentRef, SimpleChanges } from '@angular/core';
 import { AXBasePageComponent } from '@acorex/components/page';
 import { AXTabStripChangedEvent } from '@acorex/components/tabs';
+import { AXPMultiLanguageString, AXPDefinitionCategory, AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXPWidgetItemData, AXPWidgetItemClickEvent } from '@acorex/platform/layout/components';
 import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/widget-core';
-import { AXPWidgetConfig, AXPWidgetCategory, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent } from '@acorex/platform/layout/widget-core';
+import { AXPWidgetConfig, AXPWidgetGroupEnum, AXPWidgetNode, AXPBaseWidgetComponent, AXPWidgetRegistryService, AXPLayoutBaseWidgetComponent } from '@acorex/platform/layout/widget-core';
 import { AXMenuItem } from '@acorex/components/menu';
 import { Subject } from 'rxjs';
-import { AXPBroadcastEventService, AXPContextChangeEvent } from '@acorex/platform/core';
 import { AXUnsubscriber } from '@acorex/core/utils';
 import { AXPClipBoardService, AXPSettingsService } from '@acorex/platform/common';
 
@@ -72,53 +72,93 @@ declare class AXPDesignerGridDrawerComponent {
 interface AXPDisplayWidgetConfig extends AXPWidgetConfig {
     pinned: boolean;
 }
+interface AXPWidgetPickerSection {
+    trackKey: string;
+    title: AXPMultiLanguageString | null;
+    widgetItems: AXPWidgetItemData[];
+}
 declare class AXPDesignerWidgetPickerComponent extends AXBasePageComponent {
+    private readonly injector;
     private settingsService;
     private readonly mlResolver;
     private readonly pinnedSettingKey;
+    /** Keeps the line indicator in sync when the selected index is set programmatically (e.g. restored tab). */
+    private readonly tabsHost;
+    constructor();
     protected readonly i18n: {
         readonly searchPlaceholder: "@form-template-management:designer.components.widget-picker.search-placeholder";
         readonly selectedCount: "@form-template-management:designer.components.widget-picker.selected-count";
         readonly tabAll: "@form-template-management:designer.components.widget-picker.tab-all";
+        readonly pinnedSectionTitle: "@form-template-management:designer.components.widget-picker.pinned-section-title";
     };
     protected searchTerm: _angular_core.ModelSignal<string>;
+    /** Populated by popup `data.tabPersistenceContext` (optional for tests). */
+    tabPersistenceContext?: string;
     private widgets;
     private allWidgets;
     private pinnedWidgets;
-    private displayWidgets;
     protected selectedWidgets: _angular_core.WritableSignal<AXPDisplayWidgetConfig[]>;
+    protected currentTabIndex: _angular_core.WritableSignal<number>;
+    /** Avoid persisting spurious tab events before restore + first paint complete. */
+    private allowTabPersistence;
+    private displayWidgets;
     private orderedList;
     protected pinnedList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected regularList: _angular_core.Signal<AXPDisplayWidgetConfig[]>;
     protected pinnedWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected regularWidgetItems: _angular_core.Signal<AXPWidgetItemData[]>;
-    protected categories: _angular_core.Signal<AXPWidgetCategory[]>;
-    protected tabs: _angular_core.Signal<AXPWidgetCategory[]>;
+    protected regularGroupedSections: _angular_core.Signal<AXPWidgetPickerSection[]>;
+    protected categories: _angular_core.Signal<AXPDefinitionCategory[]>;
+    protected tabs: _angular_core.Signal<AXPDefinitionCategory[]>;
     protected maxVisibleWidgets: _angular_core.Signal<number>;
-    protected currentTabIndex: _angular_core.WritableSignal<number>;
-    protected selectedTab: _angular_core.Signal<AXPWidgetCategory>;
+    protected selectedTab: _angular_core.Signal<AXPDefinitionCategory>;
+    protected pickerShellClass: _angular_core.Signal<string>;
     protected ngOnInit(): Promise<void>;
-    protected handleTabChange(event: AXTabStripChangedEvent): void;
+    private lastTabSettingKey;
+    private restoreLastTabFromSettings;
+    /**
+     * `ax-tab-item` [active] updates labels, but `ax-tabs` keeps the underline from its own index until `select` runs.
+     */
+    private syncTabsStripToIndex;
+    private persistTabSelection;
+    /**
+     * Picks the primary parent category for the "All" tab (lowest `order` wins).
+     */
+    private primaryCategory;
+    private buildAllTabSections;
+    private buildCategoryTabSections;
+    protected handleTabChange(event: AXTabStripChangedEvent): Promise<void>;
     protected handleWidgetClick(clickEvent: AXPWidgetItemClickEvent): void;
     protected handleWidgetPinClick(clickEvent: AXPWidgetItemClickEvent): Promise<void>;
+    protected handleConfirmSelection(): void;
     protected isWidgetSelected(widget: AXPDisplayWidgetConfig): boolean;
     protected isWidgetItemSelected(widgetItem: AXPWidgetItemData): boolean;
-    protected handleConfirmSelection(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDesignerWidgetPickerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDesignerWidgetPickerComponent, "ng-component", never, { "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
 }
 
+interface AXPWidgetPickerShowOptions {
+    groups: AXPWidgetGroupEnum[];
+    /** User-scoped last tab; unique per picker host (use `AXP_WIDGET_PICKER_TAB_CONTEXT`). */
+    tabPersistenceContext: string;
+}
 declare class AXPWidgetPickerService {
     private popupService;
     private widgetRegistryService;
     private translationService;
-    showPicker(options: {
-        groups: AXPWidgetGroupEnum[];
-    }): Promise<AXPWidgetNode[]>;
+    showPicker(options: AXPWidgetPickerShowOptions): Promise<AXPWidgetNode[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPWidgetPickerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPWidgetPickerService>;
 }
 
+/**
+ * Suffixes for `forms:widgets:picker:last-tab:{id}` user settings keys.
+ * Use one id per distinct widget-picker host (different tab strips / widget sets).
+ */
+declare const AXP_WIDGET_PICKER_TAB_CONTEXT: {
+    readonly layoutDesignerFormElements: "layout-designer-form-elements";
+    readonly dashboardHome: "dashboard-home";
+};
+
 type AXPDesignerMode = {
     id: 'designer';
     title: 'Designer';
@@ -424,5 +464,5 @@ declare class AXPLayoutDesignerPreviewComponent extends AXBasePageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPLayoutDesignerPreviewComponent, "axp-layout-preview", never, {}, {}, never, never, true, never>;
 }
 
-export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, cloneWidgetMenu };
-export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig };
+export { AXPDesignerAddWidgetButtonComponent, AXPDesignerAddWidgetLineButtonComponent, AXPDesignerAddWidgetMiniButtonComponent, AXPDesignerConnector, AXPDesignerFlexDrawerComponent, AXPDesignerGridDrawerComponent, AXPDesignerMessageKeys, AXPDesignerModes, AXPDesignerService, AXPDesignerWidgetPickerComponent, AXPLayoutDesignerComponent, AXPLayoutDesignerPreviewComponent, AXPLayoutDesignerPreviewViewerComponent, AXPTemplateLoadingStrategy, AXPWidgetDesignerRendererDirective, AXPWidgetPickerService, AXP_DESIGNER_ADD_WIDGET_MENU, AXP_DESIGNER_CLONE_MENU, AXP_DESIGNER_COPY_MENU, AXP_DESIGNER_CUT_MENU, AXP_DESIGNER_DELETE_WIDGET_MENU, AXP_DESIGNER_PASTE_MENU, AXP_DESIGNER_SAVE_AS_WIDGET_MENU, AXP_DESIGNER_SELECT_WIDGET_MENU, AXP_WIDGET_PICKER_TAB_CONTEXT, cloneWidgetMenu };
+export type { AXPDesignerAddNodeCommand, AXPDesignerAddNodeEvent, AXPDesignerContent, AXPDesignerFocusCommand, AXPDesignerFocusEvent, AXPDesignerMode, AXPDesignerPreviewMessage, AXPDesignerPreviewSize, AXPDesignerRefreshCommand, AXPDesignerRefreshEvent, AXPDesignerRegisterCommand, AXPDesignerSaveFormMessage, AXPDesignerSelectCommand, AXPDesignerSelectEvent, AXPDesignerUpdateCommand, AXPDesignerUpdateEvent, AXPDesignerWidgetComponent, AXPDisplayWidgetConfig, AXPWidgetPickerShowOptions };