@acorex/platform 21.0.0-next.24 → 21.0.0-next.33

package/{layout/builder/index.d.ts → types/acorex-platform-layout-builder.d.ts}

@@ -1,14 +1,15 @@
-import * as _angular_core from '@angular/core';
+import * as i0 from '@angular/core';
 import { OnInit, EventEmitter } from '@angular/core';
 import * as i1 from '@angular/common';
 import { AXFormComponent } from '@acorex/components/form';
 import { AXValidationSummary } from '@acorex/core/validation';
-import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetCoreContextChangeEvent, AXPWidgetContainerComponent, AXPWidgetCoreElementAction } from '@acorex/platform/layout/widget-core';
+import { AXPWidgetNode, AXPWidgetRenderMode, AXPWidgetContainerComponent, AXPWidgetCoreElementAction } from '@acorex/platform/layout/widget-core';
 import { AXDataSource } from '@acorex/cdk/common';
 import { AXPopupSizeType } from '@acorex/components/popup';
 import { AXStepWizardLook } from '@acorex/components/step-wizard';
-import { AXPGridLayoutOptions, AXPExpression, AXPValidationRules, AXPOptionsData, AXPActionMenuItem } from '@acorex/platform/core';
+import { AXPMultiLanguageString, AXPGridLayoutOptions, AXPExpression, AXPValidationRules, AXPOptionsData, AXPActionMenuItem, AXPContextChangeEvent, AXPExecuteCommandResult } from '@acorex/platform/core';
 import { AXBasePageComponent } from '@acorex/components/page';
+import { AXPCommand } from '@acorex/platform/runtime';
 
 /**
  * Extended widget node properties (excluding type, path, name, options, children)
@@ -29,9 +30,9 @@ type AXPDynamicFormMode = 'view' | 'edit';
 type AXPDynamicFormDirection = 'vertical' | 'horizontal' | 'grid';
 interface AXPDynamicFormFieldDefinition {
     path: string;
-    title?: string;
+    title?: AXPMultiLanguageString;
     badge?: string;
-    description?: string;
+    description?: AXPMultiLanguageString;
     widget: AXPWidgetNode;
     /**
      * Optional per-field rendering mode. Takes precedence over section and form modes.
@@ -41,8 +42,8 @@ interface AXPDynamicFormFieldDefinition {
 }
 interface AXPDynamicFormGroupDefinition {
     name: string;
-    title?: string;
-    description?: string;
+    title?: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
     parameters: AXPDynamicFormFieldDefinition[];
     /**
      * Optional per-section rendering mode. Takes precedence over form mode and is overridden by field mode.
@@ -87,7 +88,7 @@ interface ValueWidgetOptions extends LayoutWidgetOptions {
     validations?: AXPValidationRules;
 }
 interface TextBoxOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     maxLength?: number;
     minLength?: number;
     prefix?: string;
@@ -98,14 +99,14 @@ interface NumberBoxOptions extends ValueWidgetOptions {
     min?: number;
     max?: number;
     step?: number;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     format?: string;
 }
 interface SelectBoxOptions extends ValueWidgetOptions {
     dataSource: any[] | (() => any[]) | (() => Promise<any[]>) | AXDataSource<any>;
     valueField?: string;
     textField?: string;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     multiple?: boolean;
     searchable?: boolean;
     clearButton?: boolean;
@@ -116,7 +117,7 @@ interface DateTimeBoxOptions extends ValueWidgetOptions {
     format?: string;
     min?: Date | string;
     max?: Date | string;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     clearButton?: boolean;
 }
 interface ToggleSwitchOptions extends ValueWidgetOptions {
@@ -128,7 +129,7 @@ interface LargeTextBoxOptions extends ValueWidgetOptions {
     rows?: number;
     maxLength?: number;
     minLength?: number;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     resizable?: boolean;
 }
 interface ColorBoxOptions extends ValueWidgetOptions {
@@ -242,12 +243,12 @@ interface AXPDialogContainerOptions extends LayoutWidgetOptions {
     context?: any;
 }
 interface RichTextOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     toolbar?: string[];
     readonly?: boolean;
 }
 interface PasswordBoxOptions extends ValueWidgetOptions {
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
     revealToggle?: boolean;
     maxLength?: number;
 }
@@ -269,7 +270,7 @@ interface SelectionListOptions extends ValueWidgetOptions {
     textField?: string;
     multiple?: boolean;
     searchable?: boolean;
-    placeholder?: string;
+    placeholder?: AXPMultiLanguageString;
 }
 interface AXPListWidgetColumn {
     name: string;
@@ -408,7 +409,9 @@ type DialogBuilderState = AXPWidgetNode & {
 interface IActionBuilder {
     cancel(text?: string): IActionBuilder;
     submit(text?: string): IActionBuilder;
-    custom(action: AXPActionMenuItem): IActionBuilder;
+    custom(action: AXPActionMenuItem & {
+        position?: 'prefix' | 'suffix';
+    }): IActionBuilder;
 }
 interface ILayoutBuilder {
     grid(delegate: (container: IGridContainerBuilder) => void): ILayoutBuilder;
@@ -508,6 +511,8 @@ interface IGridContainerBuilder extends IBaseContainerBuilder<IGridContainerBuil
     setBackgroundColor(color: string): IGridContainerBuilder;
     setPadding(padding: string): IGridContainerBuilder;
     setMargin(margin: string): IGridContainerBuilder;
+    /** Add a grid-item-layout child with optional placement; delegate builds the fieldset content. */
+    item(layoutOptions: Partial<AXPGridLayoutOptions> | null | undefined, delegate: (container: IFieldsetContainerBuilder) => void): IGridContainerBuilder;
 }
 interface IPanelContainerBuilder extends IBaseContainerBuilder<IPanelContainerBuilder>, ILayoutContainerBuilder<IPanelContainerBuilder>, IChildContainerBuilder<IPanelContainerBuilder>, IWidgetContainerBuilder<IPanelContainerBuilder> {
     setOptions(options: AXPPanelContainerOptions): IPanelContainerBuilder;
@@ -645,38 +650,38 @@ declare class AXPLayoutRendererComponent implements OnInit {
     /**
      * Form definition containing groups and fields OR widget tree
      */
-    layout: _angular_core.InputSignal<AXPWidgetNode | AXPDynamicFormDefinition>;
+    layout: i0.InputSignal<AXPWidgetNode | AXPDynamicFormDefinition>;
     /**
      * Form context/model data
      */
-    context: _angular_core.ModelSignal<any>;
+    context: i0.ModelSignal<any>;
     /**
      * Form appearance and density styling (normal, compact, spacious)
      */
-    look: _angular_core.InputSignal<AXPDynamicFormLook>;
+    look: i0.InputSignal<AXPDynamicFormLook>;
     /**
      * Default form mode. Can be overridden by section/group and field.
      */
-    mode: _angular_core.InputSignal<AXPDynamicFormMode>;
-    protected widgetTree: _angular_core.WritableSignal<AXPWidgetNode | null>;
+    mode: i0.InputSignal<AXPDynamicFormMode>;
+    protected widgetTree: i0.WritableSignal<AXPWidgetNode | null>;
     /**
      * Convert layout data to widget tree when inputs change
      */
-    conversionEffect: _angular_core.EffectRef;
+    conversionEffect: i0.EffectRef;
     /**
      * Emitted when context change is initiated
      */
-    contextInitiated: _angular_core.OutputEmitterRef<any>;
+    contextInitiated: i0.OutputEmitterRef<any>;
     /**
      * Emitted when form becomes valid/invalid
      */
-    validityChange: _angular_core.OutputEmitterRef<boolean>;
+    validityChange: i0.OutputEmitterRef<boolean>;
     private form;
     private container;
     /**
      * Internal context signal for reactivity
      */
-    protected internalContext: _angular_core.WritableSignal<any>;
+    protected internalContext: i0.WritableSignal<any>;
     /**
      * Initial context for reset functionality
      */
@@ -685,7 +690,7 @@ declare class AXPLayoutRendererComponent implements OnInit {
     /**
      * Handle context change events from widget container (optimized with RxJS)
      */
-    protected handleContextChanged(event: AXPWidgetCoreContextChangeEvent): void;
+    protected handleContextChanged(event: AXPContextChangeEvent): void;
     /**
      * Get the form component instance
      */
@@ -730,14 +735,14 @@ declare class AXPLayoutRendererComponent implements OnInit {
      * Type guard to check if the input is a widget node
      */
     private isWidgetNode;
-    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>;
+    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>;
 }
 
 declare class 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>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutBuilderModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<LayoutBuilderModule, never, [typeof i1.CommonModule, typeof AXPLayoutRendererComponent], [typeof AXPLayoutRendererComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<LayoutBuilderModule>;
 }
 
 declare class AXPLayoutBuilderService {
@@ -746,8 +751,8 @@ declare class AXPLayoutBuilderService {
      * Create a new layout builder
      */
     create(): ILayoutBuilder;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutBuilderService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutBuilderService>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPLayoutBuilderService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPLayoutBuilderService>;
 }
 
 declare class AXPLayoutConversionService {
@@ -812,8 +817,8 @@ declare class AXPLayoutConversionService {
      * Create a simple hash from a string
      */
     private createSimpleHash;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPLayoutConversionService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPLayoutConversionService>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPLayoutConversionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPLayoutConversionService>;
 }
 
 interface DialogRendererConfig {
@@ -844,12 +849,12 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private widgetCoreService;
     private expressionEvaluator;
     private dialogResult?;
-    context: _angular_core.WritableSignal<any>;
+    context: i0.WritableSignal<any>;
     callBack: (dialogRef: AXPDialogRef) => void;
     data: any;
     private isDialogLoading;
-    footerPrefix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
-    footerSuffix: _angular_core.WritableSignal<AXPWidgetCoreElementAction[]>;
+    footerPrefix: i0.WritableSignal<AXPWidgetCoreElementAction[]>;
+    footerSuffix: i0.WritableSignal<AXPWidgetCoreElementAction[]>;
     ngOnInit(): void;
     private layoutRenderer;
     private debounceTimer?;
@@ -860,6 +865,8 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     isFormLoading(): boolean;
     isSubmitting(): boolean;
     executeAction(action: AXPWidgetCoreElementAction): Promise<void>;
+    /** Resolves footer/widget action command to a string (e.g. `cancel`, `submit`, `widget:...`). */
+    private resolveActionCommandName;
     private parseWidgetCommand;
     private executeWidgetApi;
     close(result?: DialogRendererResult): Promise<void>;
@@ -869,9 +876,51 @@ declare class AXPDialogRendererComponent extends AXBasePageComponent implements
     private evaluatePredicates;
     private evalBool;
     private resolveApi;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPDialogRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXPDialogRendererComponent, "axp-dialog-renderer", never, {}, { "result": "result"; }, never, never, true, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPDialogRendererComponent, never>;
+    static ɵcmp: i0.ɵɵ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. */
+declare const AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY = "Widget:Preview";
+
+/** See `AXP_PREVIEW_WIDGET_FIELD_COMMAND_KEY` in `preview-widget-field.command.key.ts`. */
+interface AXPPreviewWidgetFieldCommandInput {
+    /** Widget node to render (same shape as `widget-field-configurator` model). */
+    widget?: AXPWidgetNode;
+    /**
+     * Alternate property name for the widget node (matches metadata definition `interface` field).
+     */
+    interface?: AXPWidgetNode | string;
+    fieldName?: string;
+    fieldTitle?: AXPMultiLanguageString;
+    name?: string;
+    title?: AXPMultiLanguageString;
+}
+type AXPPreviewWidgetFieldInvocation = AXPPreviewWidgetFieldCommandInput & {
+    __context__?: {
+        data?: Record<string, unknown>;
+        options?: Record<string, unknown>;
+    };
+};
+/**
+ * Opens a dialog that previews a widget configuration (same behavior as the preview button on
+ * `axp-widget-field-configurator`). Invoked from that component and from entity list actions.
+ */
+declare class AXPPreviewWidgetFieldCommand implements AXPCommand<AXPPreviewWidgetFieldCommandInput, void> {
+    private readonly formBuilderService;
+    private readonly widgetRegistry;
+    private readonly translationService;
+    private readonly mlResolver;
+    private readonly crudService;
+    execute(input: AXPPreviewWidgetFieldInvocation): Promise<AXPExecuteCommandResult<void>>;
+    private mergeInvocation;
+    private normalizeWidget;
+    private resolveFieldTitleLabel;
+    private isCancelDialogOutcome;
+    private resolveWidgetDisplayTitle;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPPreviewWidgetFieldCommand, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPPreviewWidgetFieldCommand>;
 }
 
-export { AXPDialogRendererComponent, AXPLayoutBuilderService, AXPLayoutConversionService, AXPLayoutRendererComponent, LayoutBuilderModule };
-export type { AXPDialogContainerOptions, AXPDialogRef, AXPDynamicFormDefinition, AXPDynamicFormDirection, AXPDynamicFormFieldDefinition, AXPDynamicFormGroupDefinition, AXPDynamicFormLook, AXPDynamicFormMode, AXPFieldsetContainerOptions, AXPFlexContainerOptions, AXPFormFieldOptions, AXPGridContainerOptions, AXPListWidgetColumn, AXPListWidgetOptions, AXPListWidgetRowCommand, AXPPageContainerOptions, AXPPanelContainerOptions, 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 { 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 };