@acorex/modules 21.0.0-next.15 → 21.0.0-next.17

package/assessment-management/README.md

@@ -63,12 +63,23 @@ Assessment template with embedded sections and questions (value objects).
 
 - Multiple assessment types (questionnaire, survey, checklist, test, evaluation)
 - Embedded sections and items (not separate entities)
+- **Pre-questionnaire**: Welcome screen before questions (rich text, multi-language)
+- **Post-questionnaire**: Review step before submit, summary screen after submit
 - Scoring profiles (cumulative, weighted, formula)
 - Grading scales (A-F, custom)
 - Timer and navigation settings
 - Question randomization
 - Progress bar configuration
 
+**Pre/Post Summary Placeholders** (for `postSummaryContent`):
+
+| Placeholder       | Description                    |
+|:------------------|:-------------------------------|
+| `{{score}}`       | Score percentage (0-100)       |
+| `{{passFail}}`    | Pass/fail label                |
+| `{{totalQuestions}}` | Total question count      |
+| `{{answeredCount}}`  | Number of answered questions |
+
 **Value Objects**:
 
 - **Sections**: Logical grouping with visibility conditions and scoring weights

package/assessment-management/index.d.ts

@@ -8,6 +8,7 @@ import * as _acorex_platform_layout_widget_core from '@acorex/platform/layout/wi
 import { AXPWidgetNode, AXPWidgetContainerComponent, AXPValueWidgetComponent } from '@acorex/platform/layout/widget-core';
 import * as _ngrx_signals from '@ngrx/signals';
 import { AXFormComponent } from '@acorex/components/form';
+import * as _acorex_modules_assessment_management from '@acorex/modules/assessment-management';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
 import { ActivatedRoute } from '@angular/router';
 
@@ -440,6 +441,7 @@ declare class AXMQuestionnaireViewerComponent {
             description?: string;
             answer: any;
             isRequired?: boolean;
+            question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionId: string) => number;
         submit: () => Promise<{
@@ -567,6 +569,7 @@ declare class AXMQuestionnaireViewerComponent {
             description?: string;
             answer: any;
             isRequired?: boolean;
+            question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionId: string) => number;
         submit: () => Promise<{
@@ -662,7 +665,13 @@ declare class AXMQuestionnaireViewerComponent {
         description?: string;
         answer: any;
         isRequired?: boolean;
+        question: QuestionnaireViewerQuestion;
     }[];
+    /**
+     * Get context data for review step (answers at widget paths).
+     * Must be called before transitioning to review while viewer is still rendered.
+     */
+    getReviewContext(): Record<string, any>;
     /**
      * Submit questionnaire
      * Validates all questions before submitting
@@ -738,11 +747,53 @@ declare class AXMQuestionBankItemServiceImpl extends AXMQuestionBankItemService
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMQuestionBankItemServiceImpl>;
 }
 
+/**
+ * Pre-questionnaire content (welcome/intro).
+ * When multiLanguage is used, value is Record<locale, string>.
+ */
+type PrePostContentValue = string | Record<string, string>;
+/**
+ * Pre-questionnaire configuration (shown before questions).
+ */
+interface PreQuestionnaireConfig {
+    enabled: boolean;
+    /** Rich text content. Supports multi-language: Record<locale, string>. */
+    content?: PrePostContentValue;
+}
+/**
+ * Post-questionnaire configuration (review before submit, summary after submit).
+ * Summary content supports placeholders: {{score}}, {{passFail}}, {{totalQuestions}}, {{answeredCount}}.
+ */
+interface PostQuestionnaireConfig {
+    /** Show review step before submit (all answers, edit/submit). */
+    reviewEnabled: boolean;
+    /** Show summary screen after submit. */
+    summaryEnabled: boolean;
+    /** Rich text content for summary. Supports multi-language and placeholders. */
+    summaryContent?: PrePostContentValue;
+}
+/**
+ * Pre/post questionnaire configuration for viewer flow.
+ * Extracted from questionnaire entity or passed explicitly.
+ */
+interface PrePostConfig {
+    preEnabled?: boolean;
+    preContent?: PrePostContentValue;
+    postReviewEnabled?: boolean;
+    postSummaryEnabled?: boolean;
+    postSummaryContent?: PrePostContentValue;
+    passingScore?: number;
+}
 interface AXMAssessmentManagementQuestionnaireEntityModel extends AXPEntityModel<string> {
     title: string;
     description?: string;
     type: 'questionnaire' | 'survey' | 'checklist' | 'test' | 'evaluation';
     structure?: QuestionnaireBuilderValue;
+    preEnabled?: boolean;
+    preContent?: PrePostContentValue;
+    postReviewEnabled?: boolean;
+    postSummaryEnabled?: boolean;
+    postSummaryContent?: PrePostContentValue;
     scoringType?: 'none' | 'cumulative' | 'weighted' | 'formula';
     passingScore?: number;
     scoringFormula?: string;
@@ -754,6 +805,10 @@ interface AXMAssessmentManagementQuestionnaireEntityModel extends AXPEntityModel
     tags?: string[];
     color?: string;
 }
+/**
+ * Extract PrePostConfig from questionnaire entity.
+ */
+declare function toPrePostConfig(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): PrePostConfig | null;
 
 declare abstract class AXMQuestionnaireService extends AXMEntityCrudServiceImpl<string, AXMAssessmentManagementQuestionnaireEntityModel> {
 }
@@ -812,6 +867,25 @@ declare class AXMAssessmentSessionServiceImpl extends AXMAssessmentSessionServic
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMAssessmentSessionServiceImpl>;
 }
 
+/**
+ * Placeholder values for post-questionnaire summary content.
+ */
+interface SummaryPlaceholderValues {
+    score?: number;
+    passFail?: string;
+    totalQuestions?: number;
+    answeredCount?: number;
+}
+
+interface QuestionWithAnswer {
+    questionId: string;
+    title: string;
+    answer: unknown;
+    /** Full question with interface for widget rendering in view mode. */
+    question?: QuestionnaireViewerQuestion;
+}
+
+type FlowStep$1 = 'pre' | 'questions' | 'review' | 'summary';
 declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseComponent {
     protected readonly route: ActivatedRoute;
     private readonly router;
@@ -820,13 +894,24 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
     private readonly assessmentSessionService;
     private readonly authSession;
     protected readonly structure: _angular_core.WritableSignal<QuestionnaireBuilderValue | null>;
+    protected readonly questionnaire: _angular_core.WritableSignal<AXMAssessmentManagementQuestionnaireEntityModel | null>;
     protected readonly initialAnswers: _angular_core.WritableSignal<Record<string, any>>;
     protected readonly viewerConfig: _angular_core.WritableSignal<QuestionnaireViewerConfig | undefined>;
+    protected readonly prePostConfig: _angular_core.WritableSignal<_acorex_modules_assessment_management.PrePostConfig | null>;
     protected readonly isLoading: _angular_core.WritableSignal<boolean>;
     protected readonly loadError: _angular_core.WritableSignal<string | null>;
-    protected readonly isSubmitting: _angular_core.WritableSignal<boolean>;
     protected readonly currentSessionId: _angular_core.WritableSignal<string | null>;
-    protected readonly questionnaireViewer: _angular_core.Signal<AXMQuestionnaireViewerComponent | undefined>;
+    protected readonly flowStep: _angular_core.WritableSignal<FlowStep$1>;
+    protected readonly reviewSnapshot: _angular_core.WritableSignal<QuestionWithAnswer[]>;
+    protected readonly reviewContext: _angular_core.WritableSignal<Record<string, any> | null>;
+    protected readonly submitResult: _angular_core.WritableSignal<SummaryPlaceholderValues | null>;
+    protected readonly isSubmitting: _angular_core.WritableSignal<boolean>;
+    protected readonly canNavigatePrevious: _angular_core.WritableSignal<boolean>;
+    protected readonly canNavigateNext: _angular_core.WritableSignal<boolean>;
+    protected readonly showNavigationButtons: _angular_core.WritableSignal<boolean>;
+    protected readonly isLastStep: _angular_core.WritableSignal<boolean>;
+    protected readonly areAllRequiredQuestionsAnswered: _angular_core.WritableSignal<boolean>;
+    protected readonly viewer: _angular_core.Signal<AXMQuestionnaireViewerComponent | undefined>;
     protected readonly viewerViewModel: _angular_core.Signal<({
         questionnaireData: _angular_core.Signal<QuestionnaireViewerData | null>;
         structure: _angular_core.Signal<QuestionnaireBuilderValue | null>;
@@ -890,6 +975,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
             description?: string;
             answer: any;
             isRequired?: boolean;
+            question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionId: string) => number;
         submit: () => Promise<{
@@ -922,46 +1008,56 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
     protected readonly showProgressBar: _angular_core.Signal<boolean>;
     protected readonly answeredQuestionsCount: _angular_core.Signal<number>;
     protected readonly isReadonly: _angular_core.Signal<boolean>;
-    protected readonly canNavigatePrevious: _angular_core.WritableSignal<boolean>;
-    protected readonly canNavigateNext: _angular_core.WritableSignal<boolean>;
-    protected readonly showNavigationButtons: _angular_core.WritableSignal<boolean>;
-    protected readonly isLastStep: _angular_core.WritableSignal<boolean>;
-    protected readonly areAllRequiredQuestionsAnswered: _angular_core.WritableSignal<boolean>;
+    protected readonly showReviewButton: _angular_core.Signal<boolean>;
+    /** Use answers from review context when returning from review; otherwise use initial answers. */
+    protected readonly effectiveInitialAnswers: _angular_core.Signal<Record<string, any>>;
+    constructor();
+    ngOnInit(): Promise<void>;
+    private loadData;
+    private saveSessionAndGetSummary;
     getPageTitle(): Promise<string>;
     getPageBreadcrumbs(): ReturnType<AXPPageLayoutBaseComponent['getPageBreadcrumbs']>;
     getBackButton(): Promise<{
         title: string;
     } | null>;
     onBackButtonClick(): void;
-    constructor();
-    ngOnInit(): Promise<void>;
-    private loadData;
     private getCasesListPath;
     private calculateProgress;
     protected handleAnswersChanged(_answers: Record<string, any>): void;
+    protected handleReviewClick(): void;
+    protected handleReviewSubmit(): Promise<void>;
     protected handlePreviousClick(): Promise<void>;
     protected handleNextClick(): Promise<void>;
     protected handleSubmitClick(): Promise<void>;
+    protected handleDone(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMQuestionnaireViewerPageComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMQuestionnaireViewerPageComponent, "axm-questionnaire-viewer-page", never, {}, {}, never, never, true, never>;
 }
 
-/**
- * Standalone questionnaire viewer page for external access (e.g. shareable links).
- * Renders full-screen without app shell (no sidebar, no main header).
- */
+type FlowStep = 'pre' | 'questions' | 'review' | 'summary';
 declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
     private readonly route;
     private readonly sessionService;
     private readonly caseService;
     private readonly questionnaireService;
     protected readonly structure: _angular_core.WritableSignal<QuestionnaireBuilderValue | null>;
+    protected readonly questionnaire: _angular_core.WritableSignal<any>;
     protected readonly initialAnswers: _angular_core.WritableSignal<Record<string, any>>;
+    protected readonly prePostConfig: _angular_core.WritableSignal<_acorex_modules_assessment_management.PrePostConfig | null>;
     protected readonly viewerConfig: _angular_core.WritableSignal<QuestionnaireViewerConfig | undefined>;
     protected readonly isLoading: _angular_core.WritableSignal<boolean>;
     protected readonly loadError: _angular_core.WritableSignal<string | null>;
     protected readonly isSubmitting: _angular_core.WritableSignal<boolean>;
-    protected readonly questionnaireViewer: _angular_core.Signal<AXMQuestionnaireViewerComponent | undefined>;
+    protected readonly flowStep: _angular_core.WritableSignal<FlowStep>;
+    protected readonly reviewSnapshot: _angular_core.WritableSignal<QuestionWithAnswer[]>;
+    protected readonly reviewContext: _angular_core.WritableSignal<Record<string, any> | null>;
+    protected readonly submitResult: _angular_core.WritableSignal<SummaryPlaceholderValues | null>;
+    protected readonly canNavigatePrevious: _angular_core.WritableSignal<boolean>;
+    protected readonly canNavigateNext: _angular_core.WritableSignal<boolean>;
+    protected readonly showNavigationButtons: _angular_core.WritableSignal<boolean>;
+    protected readonly isLastStep: _angular_core.WritableSignal<boolean>;
+    protected readonly areAllRequiredQuestionsAnswered: _angular_core.WritableSignal<boolean>;
+    protected readonly viewer: _angular_core.Signal<AXMQuestionnaireViewerComponent | undefined>;
     protected readonly viewerViewModel: _angular_core.Signal<({
         questionnaireData: _angular_core.Signal<QuestionnaireViewerData | null>;
         structure: _angular_core.Signal<QuestionnaireBuilderValue | null>;
@@ -1025,6 +1121,7 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
             description?: string;
             answer: any;
             isRequired?: boolean;
+            question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionId: string) => number;
         submit: () => Promise<{
@@ -1050,28 +1147,29 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
         validationErrors: QuestionnaireValidationError[];
     }>) | undefined>;
     protected readonly totalQuestionsCount: _angular_core.Signal<number>;
-    protected readonly totalSectionsCount: _angular_core.Signal<number>;
     protected readonly showTimer: _angular_core.Signal<boolean>;
     protected readonly timerTimeLimit: _angular_core.Signal<number | undefined>;
     protected readonly timerElapsed: _angular_core.Signal<number>;
     protected readonly showProgressBar: _angular_core.Signal<boolean>;
     protected readonly answeredQuestionsCount: _angular_core.Signal<number>;
     protected readonly isReadonly: _angular_core.Signal<boolean>;
-    protected readonly canNavigatePrevious: _angular_core.WritableSignal<boolean>;
-    protected readonly canNavigateNext: _angular_core.WritableSignal<boolean>;
-    protected readonly showNavigationButtons: _angular_core.WritableSignal<boolean>;
-    protected readonly isLastStep: _angular_core.WritableSignal<boolean>;
-    protected readonly areAllRequiredQuestionsAnswered: _angular_core.WritableSignal<boolean>;
+    protected readonly showReviewButton: _angular_core.Signal<boolean>;
+    /** Use answers from review context when returning from review; otherwise use initial answers. */
+    protected readonly effectiveInitialAnswers: _angular_core.Signal<Record<string, any>>;
     constructor();
     ngOnInit(): void;
     private loadData;
-    protected handleAnswersChanged(_answers: Record<string, any>): void;
+    private saveSessionAndGetSummary;
+    private calculateProgress;
+    protected handleReviewClick(): void;
+    protected handleReviewSubmit(): Promise<void>;
     protected handlePreviousClick(): Promise<void>;
     protected handleNextClick(): Promise<void>;
     protected handleSubmitClick(): Promise<void>;
+    protected handleDone(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMQuestionnaireViewerStandalonePageComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMQuestionnaireViewerStandalonePageComponent, "axm-questionnaire-viewer-standalone-page", never, {}, {}, never, never, true, never>;
 }
 
-export { AXMAssessmentCaseService, AXMAssessmentCaseServiceImpl, AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMAssessmentSessionService, AXMAssessmentSessionServiceImpl, AXMQuestionBankItemService, AXMQuestionBankItemServiceImpl, AXMQuestionnaireService, AXMQuestionnaireServiceImpl, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, RootConfig };
-export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentSessionRole, AXMAssessmentSessionStatus };
+export { AXMAssessmentCaseService, AXMAssessmentCaseServiceImpl, AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMAssessmentSessionService, AXMAssessmentSessionServiceImpl, AXMQuestionBankItemService, AXMQuestionBankItemServiceImpl, AXMQuestionnaireService, AXMQuestionnaireServiceImpl, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, RootConfig, toPrePostConfig };
+export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentSessionRole, AXMAssessmentSessionStatus, PostQuestionnaireConfig, PrePostConfig, PrePostContentValue, PreQuestionnaireConfig };

package/common/index.d.ts

@@ -403,6 +403,11 @@ declare class AXMUnlockConfirmWorkflowAction extends AXPWorkflowAction {
 }
 declare const AXMUnlockConfirmWorkflow: AXPWorkflow;
 
+/** Options for the disable plugin. */
+interface DisablePluginOptions {
+    /** Name of the boolean field used for disabled state. Defaults to `'isDisabled'`. */
+    fieldName?: string;
+}
 declare const disablePlugin: AXPEntityActionPlugin;
 
 interface UniqueFieldsPluginOptions {
@@ -594,4 +599,4 @@ declare class StateStatusProvider extends AXPStatusProvider {
 }
 
 export { AXMCommonModule, AXMLockPopupWorkflow, AXMLockPopupWorkflowAction, AXMMenuProvider, AXMSettingProvider, AXMUnlockConfirmWorkflow, AXMUnlockConfirmWorkflowAction, AXPCommonFeatureDefinitionProvider, AXPCommonFeatureKeys, AXPCommonMenuKeys, AXPDisablePluginModule, AXPGlobalSearchModule, AXPGlobalSearchViewModel, AXPStatusPluginModule, AXPUniqueFieldsPluginModule, AXPValidationRulesModule, AXPVersionHistoryModule, AXPWidgetsList, AXP_GLOBAL_SEARCH_CONFIG_TOKEN, ApprovalStatusProvider, CommonManifest, RootConfig, StateStatusProvider, TaskStatusProvider, VARIABLE_NAME_VALIDATION_PATTERN, VariableNameValidationRule, disablePlugin, getActiveStatuses, getFinalStatuses, getInitialStatuses, getStatusByName, getTransitionsFromStatus, getTransitionsToStatus, isValidTransition, statusPlugin, uniqueFieldsPlugin };
-export type { AXPGlobalSearchConfigs, AXPStatusPluginGenerateOptions, AXPStatusPluginGenerateViewsOptions, AXPStatusPluginOptions, AXVariableNameValidationRuleOptions, UniqueFieldsPluginOptions };
+export type { AXPGlobalSearchConfigs, AXPStatusPluginGenerateOptions, AXPStatusPluginGenerateViewsOptions, AXPStatusPluginOptions, AXVariableNameValidationRuleOptions, DisablePluginOptions, UniqueFieldsPluginOptions };

package/data-management/index.d.ts

@@ -3,14 +3,15 @@ import { Injector, InjectionToken } from '@angular/core';
 import * as i1 from '@acorex/platform/layout/widget-core';
 import { AXPWidgetConfig, AXPValueWidgetComponent, AXPWidgetNode, AXPWidgetCoreContextChangeEvent, AXPMetaDataDefinition } from '@acorex/platform/layout/widget-core';
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext } from '@acorex/platform/common';
-import { AXPEntityModel, AXMEntityCrudServiceImpl, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityPreloadEntity, AXPEntityDefinitionRegistryService, AXPEntityActionPlugin } from '@acorex/platform/layout/entity';
+import { AXPEntityModel, AXMEntityCrudServiceImpl, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityPreloadEntity, AXPEntityService, AXPEntityDefinitionRegistryService, AXPEntityActionPlugin } from '@acorex/platform/layout/entity';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPFilterDefinition, AXPDataSourceDefinition, AXPFilterClause, AXPDataSourceDataFieldDefinition, AXPOptionsData, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext, AXPTagProvider, AXPTag } from '@acorex/platform/core';
+import { AXPFilterDefinition, AXPDataSourceDefinition, AXPFilterClause, AXPDataSourceDataFieldDefinition, AXPExecuteCommandResult, AXPOptionsData, AXPExpressionEvaluatorScopeProvider, AXPExpressionEvaluatorScopeProviderContext, AXPTagProvider, AXPTag } from '@acorex/platform/core';
 import { AXDataSource, AXDataSourceOperator, AXFilterLogic } from '@acorex/cdk/common';
 import { AXDropListDroppedEvent } from '@acorex/cdk/drag-drop';
 import * as _acorex_modules_data_management from '@acorex/modules/data-management';
+import { AXPDynamicFormDefinition, AXPLayoutRendererComponent, AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
 import { AXTranslationService } from '@acorex/core/translation';
-import { AXPLayoutBuilderService, AXPDynamicFormDefinition } from '@acorex/platform/layout/builder';
+import { AXPCommand } from '@acorex/platform/runtime';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { AXDialogService } from '@acorex/components/dialog';
 import { AXPDataSelectorService, AXPWidgetPropertyViewerService } from '@acorex/platform/layout/components';
@@ -1791,6 +1792,120 @@ declare const AXP_DEFAULT_DATABASE_TYPE_PROVIDER: {
     multi: boolean;
 };
 
+declare const META_DATA_SELECTOR_FIELD = "metaDataList";
+declare const META_DATA_FORM_FIELD = "metaDataForm";
+
+declare const AXPMetaDataFormWidget: AXPWidgetConfig<AXPMetaDataFormWidgetConfigType>;
+type AXPMetaDataFormWidgetConfigType = {
+    type: 'editor';
+    metadataDefinitions: any[];
+    layoutLook?: 'normal' | 'compact' | 'borderless';
+    layoutDirection?: 'vertical' | 'horizontal' | 'grid';
+    groupByCategory?: boolean;
+    showCategoryHeaders?: boolean;
+};
+
+declare class AXPMetaDataFormWidgetEditComponent extends AXPValueWidgetComponent {
+    #private;
+    /**
+     * Groups structure from meta-data-selector or evaluated expression
+     */
+    groups: _angular_core.Signal<any[]>;
+    /**
+     * Check if there are any valid metadata definitions available
+     */
+    hasDefinitions: _angular_core.Signal<boolean>;
+    /**
+     * Emitted when form context changes
+     */
+    contextChange: _angular_core.OutputEmitterRef<any>;
+    /**
+     * Emitted when form validity changes
+     */
+    validityChange: _angular_core.OutputEmitterRef<boolean>;
+    private layoutRenderer;
+    /**
+     * Form definition signal that only updates when structure actually changes
+     */
+    protected formDefinition: _angular_core.WritableSignal<AXPDynamicFormDefinition>;
+    /**
+     * Handle context change from dynamic form
+     */
+    protected onContextChange(context: any): void;
+    /**
+     * Handle validity change from dynamic form
+     */
+    protected onValidityChange(isValid: boolean): void;
+    /**
+     * Initialize form definition based on current inputs
+     */
+    private initializeFormDefinition;
+    /**
+     * Convert groups structure from meta-data-selector to form definition
+     * Each metadata group becomes a separate form group with visual separation (card look)
+     */
+    private convertGroupsToFormDefinition;
+    /**
+     * Convert single metadata definition to field definition
+     */
+    private convertMetadataToFieldDefinition;
+    /**
+     * Parse interface configuration from metadata
+     */
+    private parseInterfaceConfig;
+    /**
+     * Parse validations from interface configuration
+     */
+    private parseValidations;
+    /**
+     * Sanitize group name for use as identifier
+     */
+    private sanitizeGroupName;
+    /**
+     * Get the layout renderer component instance
+     */
+    getLayoutRenderer(): AXPLayoutRendererComponent | undefined;
+    /**
+     * Validate the form
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Get current form context
+     */
+    getContext(): any;
+    /**
+     * Update form context programmatically
+     */
+    updateContext(context: any): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMetaDataFormWidgetEditComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMetaDataFormWidgetEditComponent, "axp-meta-data-form-widget-edit", never, {}, { "contextChange": "contextChange"; "validityChange": "validityChange"; }, never, never, true, never>;
+}
+
+interface ShowMetaDataFormPopupInput {
+    entity: string;
+    id: string;
+    field?: string;
+    title?: string;
+    path: string;
+}
+declare class ShowMetaDataFormPopupCommand implements AXPCommand<ShowMetaDataFormPopupInput, any> {
+    protected readonly layoutBuilder: AXPLayoutBuilderService;
+    protected readonly translationService: AXTranslationService;
+    protected readonly entityService: AXPEntityService;
+    protected readonly entityRegistry: AXPEntityDefinitionRegistryService;
+    execute(input: ShowMetaDataFormPopupInput | any): Promise<AXPExecuteCommandResult<any>>;
+    /**
+     * Loads a record by entity and id. Override to use custom data sources or key handling.
+     */
+    protected findRecord(entity: string, id: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Persists meta-data form changes. Override to use custom persistence or validation.
+     */
+    protected updateRecord(entity: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShowMetaDataFormPopupCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ShowMetaDataFormPopupCommand>;
+}
+
 declare const AXPMetaDataSelectorWidget: AXPWidgetConfig<AXPMetaDataSelectorWidgetConfigType>;
 type AXPMetaDataSelectorWidgetConfigType = {
     type: 'editor';
@@ -2005,6 +2120,44 @@ declare class AXPMetaDataSelectorWidgetEditComponent extends AXPValueWidgetCompo
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMetaDataSelectorWidgetEditComponent, "axp-meta-data-selector-widget-edit", never, {}, {}, never, never, true, never>;
 }
 
+/** Display configuration for section (selector shown inline in entity views) */
+type MetaDataSelectorSectionConfig = {
+    enabled?: boolean;
+    title?: string;
+    order?: number;
+};
+/** Display configuration for popup (action opens selector in dialog) */
+type MetaDataSelectorPopupConfig = {
+    enabled?: boolean;
+    title?: string;
+    order?: number;
+};
+/** Flexible display configuration object for the meta-data-selector */
+type MetaDataSelectorDisplayConfig = {
+    section?: MetaDataSelectorSectionConfig;
+    popup?: MetaDataSelectorPopupConfig;
+};
+/** Display option - where to show the meta-data-selector: section, popup, or both */
+type MetaDataSelectorDisplay = MetaDataSelectorDisplayConfig | 'section' | 'popup' | 'both';
+type MetaDataSelectorPluginOptions = {
+    /** Field and group title */
+    title?: string;
+    /** How to display the meta-data-selector: section (inline), popup (button opens dialog), or both */
+    display?: MetaDataSelectorDisplay;
+    /** If true, each metadata group becomes a separate entity section (TODO) */
+    renderGroupsAsSections?: boolean;
+};
+/**
+ * meta-data-selector plugin
+ *
+ * Dynamic behavior:
+ * - Creates a single property for metadata selector configuration
+ * - Dynamically generates entity groups and meta-data-form widgets based on configured groups
+ * - Each metadata group becomes a separate entity section with its own meta-data-form widget
+ * - Reads group configuration at runtime from the field value
+ */
+declare const metaDataSelectorPlugin: AXPEntityActionPlugin;
+
 declare class AXPMetaDataSelectorWidgetViewComponent extends AXPValueWidgetComponent<any> {
     /**
      * Returns a comma-separated list of selected meta titles.
@@ -2017,20 +2170,33 @@ declare class AXPMetaDataSelectorWidgetViewComponent extends AXPValueWidgetCompo
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPMetaDataSelectorWidgetViewComponent, "axp-meta-data-selector-widget-view", never, {}, {}, never, never, true, never>;
 }
 
-type MetaDataSelectorPluginOptions = {
+interface ShowMetaDataSelectorPopupInput {
+    entity: string;
+    id: string;
+    /** Selector field name (default: META_DATA_SELECTOR_FIELD) */
+    field?: string;
     title?: string;
-    renderGroupsAsSections?: boolean;
-};
+}
 /**
- * meta-data-selector plugin
- *
- * Dynamic behavior:
- * - Creates a single property for metadata selector configuration
- * - Dynamically generates entity groups and meta-data-form widgets based on configured groups
- * - Each metadata group becomes a separate entity section with its own meta-data-form widget
- * - Reads group configuration at runtime from the field value
+ * Opens the meta-data-selector (configuration UI for groups/fields) in a popup.
+ * Used when meta-data-selector plugin has display: 'popup' or 'both'.
  */
-declare const metaDataSelectorPlugin: AXPEntityActionPlugin;
+declare class ShowMetaDataSelectorPopupCommand implements AXPCommand<ShowMetaDataSelectorPopupInput, any> {
+    protected readonly layoutBuilder: AXPLayoutBuilderService;
+    protected readonly translationService: AXTranslationService;
+    protected readonly entityService: AXPEntityService;
+    execute(input: ShowMetaDataSelectorPopupInput | any): Promise<AXPExecuteCommandResult<any>>;
+    /**
+     * Loads a record by entity and id. Override to use custom data sources or key handling.
+     */
+    protected findRecord(entity: string, id: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Persists meta-data changes. Override to use custom persistence or validation.
+     */
+    protected updateRecord(entity: string, id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShowMetaDataSelectorPopupCommand, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ShowMetaDataSelectorPopupCommand>;
+}
 
 /**
  * Metadata Evaluator Scope Provider
@@ -2053,9 +2219,6 @@ declare class AXMMetadataEvaluatorScopeProvider implements AXPExpressionEvaluato
     private mergeInterfaceOverrides;
 }
 
-declare const META_DATA_SELECTOR_FIELD = "metaDataList";
-declare const META_DATA_FORM_FIELD = "metaDataForm";
-
 /**
  * Default system tag provider
  * Provides readonly system-level tags
@@ -2104,5 +2267,5 @@ declare const AXMPermissionsKeys: {
     };
 };
 
-export { AXMColumnFilterSelectorWidget, AXMColumnFilterSelectorWidgetColumnComponent, AXMColumnFilterSelectorWidgetEditComponent, AXMColumnFilterSelectorWidgetFilterComponent, AXMColumnFilterSelectorWidgetPrintComponent, AXMColumnFilterSelectorWidgetViewComponent, AXMDataManagementFeatureKeys, AXMDataManagementModule, AXMDataSourceEntityModule, AXMDataSourceOutputType, AXMDataSourceService, AXMDataSourceServiceImpl, AXMDataSourceType, AXMDefaultAggregateFunctionProvider, AXMDefaultDatabaseTypeProvider, AXMEntityProvider, AXMMenuProvider, AXMMetaDataDefinitionEntityModule, AXMMetaDataDefinitionService, AXMMetaDataFeatureModule, AXMMetadataEvaluatorScopeProvider, AXMPMetaDataDefinitionServiceImpl, AXMPermissionsKeys, AXMQueryEntityModule, AXMQueryService, AXMQueryServiceImpl, AXMTagEntityModule, AXMTagEntityService, AXMTagsFeatureModule, AXM_COLUMN_DEF_WIDGET, AXM_FILTER_DEF_WIDGET, AXPAggregateBuilderComponent, AXPAggregateFunctionService, AXPAggregateFunctionsRegistry, AXPColumnsBuilderComponent, AXPDataManagementMenuKeys, AXPDatabaseTypeService, AXPGroupByBuilderComponent, AXPMetaDataSelectorWidget, AXPMetaDataSelectorWidgetEditComponent, AXPMetaDataSelectorWidgetViewComponent, AXPQueryBuilderComponent, AXPQueryBuilderWidget, AXPQueryBuilderWidgetColumnComponent, AXPQueryBuilderWidgetDesignerComponent, AXPQueryBuilderWidgetEditComponent, AXPQueryBuilderWidgetViewComponent, AXPRawQueryBuilderComponent, AXPSortBuilderComponent, AXPSystemTagProvider, AXPWhereBuilderComponent, AXP_AGGREGATE_FUNCTION_PROVIDER, AXP_DATABASE_TYPE_PROVIDER, AXP_DEFAULT_AGGREGATE_FUNCTION_PROVIDER, AXP_DEFAULT_DATABASE_TYPE_PROVIDER, META_DATA_FORM_FIELD, META_DATA_SELECTOR_FIELD, RootConfig, convertStateToValue, convertValueToState, createDefaultGroup, dataSourceEntityFactory, equipmentFactory, factory, metaDataDefinitionFactory, metaDataSelectorPlugin, queryFactory, tagsPlugin };
-export type { AXMColumnFilterSelectorWidgetConfigType, AXMDataManagementEquipmentEntityModel, AXMDataManagementQueryEntityModel, AXMDataSourceEntityModel, AXMDataSourceFilter, AXMDataSourceOutputTypeOption, AXMDataSourceTypeOption, AXMMetaDataDefinitionEntityModel, AXMMetaDataSelectorField, AXMMetaDataSelectorGroup, AXMMetaDataSelectorState, AXMMetaDataSelectorValue, AXMQueryEntityModel, AXMTag, AXPAggregateCategory, AXPAggregateFunctionDefinition, AXPAggregateFunctionProvider, AXPAggregateFunctionProviderToken, AXPAggregateOperation, AXPDatabaseType, AXPDatabaseTypeDefinition, AXPDatabaseTypeProvider, AXPDatabaseTypeProviderToken, AXPMetaDataSelectorWidgetConfigType, AXPQueryBuilderData, AXPQueryBuilderWidgetConfigType, AXPQueryExecutionResult, AXPQueryOutputType, AXPQuerySortRule, AXPTagPluginOptions, ColumnFilterValue, MetaDataSelectorPluginOptions };
+export { AXMColumnFilterSelectorWidget, AXMColumnFilterSelectorWidgetColumnComponent, AXMColumnFilterSelectorWidgetEditComponent, AXMColumnFilterSelectorWidgetFilterComponent, AXMColumnFilterSelectorWidgetPrintComponent, AXMColumnFilterSelectorWidgetViewComponent, AXMDataManagementFeatureKeys, AXMDataManagementModule, AXMDataSourceEntityModule, AXMDataSourceOutputType, AXMDataSourceService, AXMDataSourceServiceImpl, AXMDataSourceType, AXMDefaultAggregateFunctionProvider, AXMDefaultDatabaseTypeProvider, AXMEntityProvider, AXMMenuProvider, AXMMetaDataDefinitionEntityModule, AXMMetaDataDefinitionService, AXMMetaDataFeatureModule, AXMMetadataEvaluatorScopeProvider, AXMPMetaDataDefinitionServiceImpl, AXMPermissionsKeys, AXMQueryEntityModule, AXMQueryService, AXMQueryServiceImpl, AXMTagEntityModule, AXMTagEntityService, AXMTagsFeatureModule, AXM_COLUMN_DEF_WIDGET, AXM_FILTER_DEF_WIDGET, AXPAggregateBuilderComponent, AXPAggregateFunctionService, AXPAggregateFunctionsRegistry, AXPColumnsBuilderComponent, AXPDataManagementMenuKeys, AXPDatabaseTypeService, AXPGroupByBuilderComponent, AXPMetaDataFormWidget, AXPMetaDataFormWidgetEditComponent, AXPMetaDataSelectorWidget, AXPMetaDataSelectorWidgetEditComponent, AXPMetaDataSelectorWidgetViewComponent, AXPQueryBuilderComponent, AXPQueryBuilderWidget, AXPQueryBuilderWidgetColumnComponent, AXPQueryBuilderWidgetDesignerComponent, AXPQueryBuilderWidgetEditComponent, AXPQueryBuilderWidgetViewComponent, AXPRawQueryBuilderComponent, AXPSortBuilderComponent, AXPSystemTagProvider, AXPWhereBuilderComponent, AXP_AGGREGATE_FUNCTION_PROVIDER, AXP_DATABASE_TYPE_PROVIDER, AXP_DEFAULT_AGGREGATE_FUNCTION_PROVIDER, AXP_DEFAULT_DATABASE_TYPE_PROVIDER, META_DATA_FORM_FIELD, META_DATA_SELECTOR_FIELD, RootConfig, ShowMetaDataFormPopupCommand, ShowMetaDataSelectorPopupCommand, convertStateToValue, convertValueToState, createDefaultGroup, dataSourceEntityFactory, equipmentFactory, factory, metaDataDefinitionFactory, metaDataSelectorPlugin, queryFactory, tagsPlugin };
+export type { AXMColumnFilterSelectorWidgetConfigType, AXMDataManagementEquipmentEntityModel, AXMDataManagementQueryEntityModel, AXMDataSourceEntityModel, AXMDataSourceFilter, AXMDataSourceOutputTypeOption, AXMDataSourceTypeOption, AXMMetaDataDefinitionEntityModel, AXMMetaDataSelectorField, AXMMetaDataSelectorGroup, AXMMetaDataSelectorState, AXMMetaDataSelectorValue, AXMQueryEntityModel, AXMTag, AXPAggregateCategory, AXPAggregateFunctionDefinition, AXPAggregateFunctionProvider, AXPAggregateFunctionProviderToken, AXPAggregateOperation, AXPDatabaseType, AXPDatabaseTypeDefinition, AXPDatabaseTypeProvider, AXPDatabaseTypeProviderToken, AXPMetaDataFormWidgetConfigType, AXPMetaDataSelectorWidgetConfigType, AXPQueryBuilderData, AXPQueryBuilderWidgetConfigType, AXPQueryExecutionResult, AXPQueryOutputType, AXPQuerySortRule, AXPTagPluginOptions, ColumnFilterValue, MetaDataSelectorDisplay, MetaDataSelectorDisplayConfig, MetaDataSelectorPluginOptions, MetaDataSelectorPopupConfig, MetaDataSelectorSectionConfig, ShowMetaDataFormPopupInput, ShowMetaDataSelectorPopupInput };