@messaia/cdk 21.1.0-rc.8 → 21.1.0

package/types/messaia-cdk.d.ts

@@ -12,7 +12,7 @@ import { Router, ActivatedRoute, ActivatedRouteSnapshot, CanDeactivate, RouterSt
 import { Observable, Subscription, BehaviorSubject, Subject } from 'rxjs';
 import { ComponentType, CdkPortal } from '@angular/cdk/portal';
 import * as i2 from '@angular/forms';
-import { ValidatorFn, AsyncValidatorFn, AbstractControlOptions, AbstractControl, FormGroup, FormArray, NgForm, AsyncValidator, ValidationErrors, Validator, FormControl, ControlValueAccessor, NgControl, NgModel, FormGroupDirective } from '@angular/forms';
+import { ValidatorFn, AsyncValidatorFn, AbstractControlOptions, AbstractControl, FormGroup, FormArray, NgForm, ValidationErrors, AsyncValidator, Validator, FormControl, ControlValueAccessor, NgControl, NgModel, FormGroupDirective } from '@angular/forms';
 import { SortDirection, MatSort } from '@angular/material/sort';
 import { MatPaginator, MatPaginatorIntl } from '@angular/material/paginator';
 import { MatMenuTrigger, MatMenu } from '@angular/material/menu';
@@ -2647,7 +2647,18 @@ declare class RxFormBuilder extends BaseFormBuilder {
      */
     private isNestedBinding;
     /**
-     * Private method: Gets the instance container based on the instance function and entity object.
+     * Private method: Resolves effective validators for a property.
+     *
+     * If the same annotation type appears multiple times (for example, inherited + overridden),
+     * only the first occurrence is kept and later duplicates are ignored.
+     *
+     * @param propertyValidators The complete list of validator decorator configurations.
+     * @param isAsync Indicates whether async or sync validators should be resolved.
+     * @returns The effective validator decorator configurations for the requested validator kind.
+     */
+    private getEffectivePropertyValidators;
+    /**
+     * Private method: Gets the instance container for the given instance function and entity object.
      *
      * @param instanceFunc The function to provide an instance from.
      * @param entityObject The entity object to use.
@@ -2762,7 +2773,7 @@ declare class RxFormBuilder extends BaseFormBuilder {
      */
     private applyAllPropValidator;
     /**
-      * Checks if dynamic validation should be applied to a property.
+    * Checks whether dynamic validation should be applied to a property.
       *
       * @param propName The name of the property to check.
       * @param validatorConfig The configuration for property validation.
@@ -2770,7 +2781,7 @@ declare class RxFormBuilder extends BaseFormBuilder {
       */
     private dynamicValidationPropCheck;
     /**
-     * Checks if the given value is not an object.
+    * Checks whether the given value is not an object.
      *
      * @param value The value to check.
      * @returns A boolean indicating whether the value is not an object.
@@ -3149,6 +3160,12 @@ declare class EnumMetadata {
      * @type {string}
      */
     display?: string;
+    /**
+     * @property Hint
+     * @description An optional hint string associated with the enum value. This string can be used to provide additional information or guidance in the UI.
+     * @type {string}
+     */
+    hint?: string;
     /**
      * @property Icon
      * @description An optional icon associated with the enum value. This can be used to visually represent the enum value in the UI.
@@ -3303,6 +3320,18 @@ declare class TableColumn<TEntity = any> {
      * @property
      */
     filterOptionText?: string;
+    /**
+     * @property filterTooltip
+     * @description Tooltip for the filter input.
+     * @type {(ctx?: IGenericListComponent<TEntity>) => any}
+     */
+    filterTooltip?: (ctx?: IGenericListComponent<TEntity>) => any;
+    /**
+     * @property filterTooltipClass
+     * @description CSS class for the filter tooltip.
+     * @type {string}
+     */
+    filterTooltipClass?: string;
     /**
      * The header text for the column.
      * @property
@@ -3475,169 +3504,273 @@ declare class TableColumn<TEntity = any> {
 declare class GenericService<T extends any> {
     endpoint?: string | undefined;
     /**
-     * Http client
+     * Injected Angular HttpClient instance
      */
     http: HttpClient;
     /**
-     * List of entities
+     * BehaviorSubject holding the current list of entities
      */
     list: BehaviorSubject<any[]>;
     /**
      * Constructor
-     *
-     * @param http
+     * @param endpoint Optional API endpoint for the service
      */
     constructor(endpoint?: string | undefined);
     /**
-     * Gets a single entity
-     *
-     * @param id The id of the entity or relative path
-     * @param params Adds query params to the request
-     * @param headers Adds headers to the request
+     * Retrieves a single entity by ID or relative path
+     * @param id The entity ID or relative path
+     * @param params Optional query parameters
+     * @param headers Optional HTTP headers
+     * @param handleError Whether to handle errors (default: true)
+     * @param observeResponse Whether to observe the full response (default: false)
      */
     get<T>(id: string | number, params?: Object | null, headers?: Object, handleError?: boolean, observeResponse?: boolean): Observable<any>;
     /**
-     * Counts entities
-     *
-     * @param params Adds query params to the request
-     * @param path A relative path to the action
-     * @param headers Adds headers to the request
-     * @param handleError Handle errors
+     * Asynchronously retrieves a single entity by ID or relative path
+     * @param id The entity ID or relative path
+     * @param params Optional query parameters
+     * @returns Promise resolving to the entity
+     */
+    getAsync<T>(id: string | number, params?: Object | null): Promise<T>;
+    /**
+     * Counts entities on the server
+     * @param params Optional query parameters
+     * @param path Optional relative path to the count action
+     * @param headers Optional HTTP headers
+     * @param handleError Whether to handle errors (default: true)
      */
     count(params?: Object, path?: string | null, headers?: Object, handleError?: boolean): Observable<number>;
     /**
-     * Gets a list of entities.
-     *
-     * @param params Optional. Adds query params to the request.
-     * @param path Optional. A relative path to the action.
-     * @param headers Optional. Adds headers to the request.
-     * @returns An Observable with the response data.
+     * Asynchronously counts entities on the server
+     * @param params Optional query parameters
+     * @param path Optional relative path to the count action
+     * @returns Promise resolving to the count
+     */
+    countAsync(params?: Object, path?: string | null): Promise<number>;
+    /**
+     * Retrieves a list of entities
+     * @param params Optional query parameters
+     * @param path Optional relative path to the action
+     * @param headers Optional HTTP headers
+     * @returns Observable with the response data
      */
     getList(params?: HttpParams | Object | null, path?: string | null, headers?: Object | null): Observable<any>;
     /**
-     * Loads data
-     * @param params Adds query params to the request
-     * @param path A relative path to the action
-     * @param headers Adds headers to the request
+     * Asynchronously retrieves a list of entities
+     * @param params Optional query parameters
+     * @param path Optional relative path to the action
+     * @param headers Optional HTTP headers
+     * @returns Promise resolving to the response data
+     */
+    getListAsync(params?: HttpParams | Object | null, path?: string | null, headers?: Object | null): Promise<any>;
+    /**
+     * Loads data into the BehaviorSubject list
+     * @param params Optional query parameters
+     * @param path Optional relative path to the action
+     * @param headers Optional HTTP headers
      */
     loadList(params?: Object | null, path?: string | null, headers?: Object): void;
     /**
-     * Gets result list as Observable
+     * Loads data into the BehaviorSubject list asynchronously
+     * @param params Optional query parameters
+     * @param path Optional relative path to the action
+     * @param headers Optional HTTP headers
+     */
+    /**
+     * Asynchronously loads data into the BehaviorSubject list
+     * @param params Optional query parameters
+     * @param path Optional relative path to the action
+     * @param headers Optional HTTP headers
+     */
+    loadListAsync(params?: Object | null, path?: string | null, headers?: Object): Promise<void>;
+    /**
+     * Returns the list BehaviorSubject as an Observable
      */
     getListAsObservable(): Observable<any>;
     /**
-     * Creates an entity
-     *
+     * Creates a new entity
      * @param entity The entity to create
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     create<T>(entity: any, path?: string | null, httpOptions?: Object, handleError?: boolean): Observable<T>;
     /**
-     * Updates an entity
-     *
-     * @param entity The entity to update
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * Asynchronously creates a new entity
+     * @param entity The entity to create
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the created entity
+     */
+    createAsync<T>(entity: any, path?: string | null, httpOptions?: Object): Promise<T>;
+    /**
+     * Updates an existing entity asynchronously
+     * @param id The ID of the entity to update
+     * @param entity The updated entity data
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     update(id: string | number, entity: any, path?: string | null, httpOptions?: Object, handleError?: boolean): Observable<any>;
     /**
-     * Patches an entity
-     *
-     * @param id id The id of the item to patch
-     * @param body The body
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * Asynchronously updates an existing entity
+     * @param id The ID of the entity to update
+     * @param entity The updated entity data
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the updated entity
+     */
+    updateAsync(id: string | number, entity: any, path?: string | null, httpOptions?: Object): Promise<any>;
+    /**
+     * Applies a JSON Patch to an entity
+     * @param id The ID of the item to patch
+     * @param body The patch body
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     patch(id: string | number, body: any, path?: string | null, httpOptions?: any, handleError?: boolean): Observable<any>;
     /**
-     * Patches multiple entities
-     *
-     * @param ids The ids of the items to patch
-     * @param body The body
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * Asynchronously applies a JSON Patch to an entity
+     * @param id The ID of the item to patch
+     * @param body The patch body
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the patched entity
+     */
+    patchAsync(id: string | number, body: any, path?: string | null, httpOptions?: any): Promise<any>;
+    /**
+     * Applies a JSON Patch to multiple entities
+     * @param ids The IDs of the items to patch
+     * @param body The patch body
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     patchList(ids: string[] | number[], body: any, path?: string | null, httpOptions?: Object, handleError?: boolean): Observable<any>;
     /**
-     * Deletes an entity.
-     *
-     * @param id The id of the item to delete
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * Asynchronously applies a JSON Patch to multiple entities
+     * @param ids The IDs of the items to patch
+     * @param body The patch body
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the patched entities
+     */
+    patchListAsync(ids: string[] | number[], body: any, path?: string | null, httpOptions?: Object): Promise<any>;
+    /**
+     * Deletes an entity by ID
+     * @param id The ID of the item to delete
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     delete(id: string | number, path?: string | null, httpOptions?: Object, handleError?: boolean): Observable<any>;
     /**
-     * Deletes multiple entities.
-     *
-     * @param ids The ids of the items to delete
-     * @param path A relative path to the action
-     * @param httpOptions Additional http options, like headers and so on
-     * @param handleError Handle errors
+     * Asynchronously deletes an entity by ID
+     * @param id The ID of the item to delete
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the delete result
+     */
+    deleteAsync(id: string | number, path?: string | null, httpOptions?: Object): Promise<any>;
+    /**
+     * Deletes multiple entities by IDs
+     * @param ids The IDs of the items to delete
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @param handleError Whether to handle errors (default: true)
      */
     deleteList(ids: string[] | number[], path?: string | null, httpOptions?: Object, handleError?: boolean): Observable<any>;
     /**
-     * Downloads a file
-     *
-     * @param path A relative path to the action
-     * @param params Some query params
+     * Asynchronously deletes multiple entities by IDs
+     * @param ids The IDs of the items to delete
+     * @param path Optional relative path to the action
+     * @param httpOptions Optional HTTP options (headers, etc.)
+     * @returns Promise resolving to the delete result
+     */
+    deleteListAsync(ids: string[] | number[], path?: string | null, httpOptions?: Object): Promise<any>;
+    /**
+     * Downloads a file from the server
+     * @param path Relative path to the download action
+     * @param params Optional query parameters
+     * @param handleError Whether to handle errors (default: true)
      */
     download(path: string, params?: Object, handleError?: boolean): Observable<any>;
     /**
-     * Duplicates a record
-     * @param id
+     * Asynchronously downloads a file from the server
+     * @param path Relative path to the download action
+     * @param params Optional query parameters
+     * @returns Promise resolving to the download result
+     */
+    downloadAsync(path: string, params?: Object): Promise<any>;
+    /**
+     * Duplicates a record by ID
+     * @param id The ID of the record to duplicate
      */
     duplicate(id: number): Observable<any>;
     /**
-     * Uploads a file
-     *
+     * Asynchronously duplicates a record by ID
+     * @param id The ID of the record to duplicate
+     * @returns Promise resolving to the duplicated record
+     */
+    duplicateAsync(id: number): Promise<any>;
+    /**
+     * Uploads a file to the server
      * @param file The file to upload
-     * @param path A relative path to the action
+     * @param path Optional relative path to the upload action (default: 'upload')
+     * @param extraData Optional extra form data to include
+     * @returns Observable of HttpEvent for upload progress tracking
      */
     upload(file: File, path?: string, extraData?: any): Observable<any>;
     /**
-     * Convert Object to FromData
-     *
-     * @param body
+     * Asynchronously uploads a file to the server
+     * @param file The file to upload
+     * @param path Optional relative path to the upload action (default: 'upload')
+     * @param extraData Optional extra form data to include
+     * @returns Promise resolving to the upload result
+     */
+    uploadAsync(file: File, path?: string, extraData?: any): Promise<any>;
+    /**
+     * Converts an object to FormData
+     * @param body The object to convert
+     * @returns FormData instance
      */
     protected toFormData(body: any): FormData;
     /**
-     * Convert Object to HttpHeaders
-     *
-     * @param body
+     * Converts an object to HttpHeaders
+     * @param body The object to convert
+     * @returns HttpHeaders instance
      */
     protected toHttpHeaders(body?: Object | null): HttpHeaders;
     /**
-     * Gets file name from Httpheaders: Content-Disposition
-     * @param disposition
+     * Normalizes the 'projection' parameter in query parameters
+     * @param params The query parameters (HttpParams or object)
+     * @returns Normalized query parameters with 'projection' formatted
+     */
+    protected normalizeProjectionParam(params?: HttpParams | Object | null): HttpParams | Object | null | undefined;
+    /**
+     * Extracts file name from Content-Disposition header
+     * @param headers HttpHeaders containing Content-Disposition
+     * @returns The extracted file name or empty string
      */
     protected getFileNameFromHeaders(headers: HttpHeaders): string;
     /**
      * Handles an HTTP operation that failed.
-     * Allows the application to continue by throwing a parsed error.
-     *
-     * @template T The type of the observable result.
-     * @param operation The name of the operation that failed. Defaults to 'operation'.
-     * @param result An optional value to return as the observable result.
-     * @returns A function that processes the error and returns an observable.
+     * Throws a parsed error for the application to handle.
+     * @param operation The name of the operation that failed (for logging)
+     * @returns A function that processes the error and returns an observable
      */
     protected handleError(operation?: string): (error: any) => Observable<any>;
     /**
-     * Return distinct message for sent, upload progress, & response events
-     *
-     * @param event The response event
-     * @param file The file beeing uploaded
+     * Returns a distinct message for upload events
+     * @param event The HttpEvent from the upload
+     * @param file The file being uploaded
+     * @returns A user-friendly status message
      */
     protected getEventMessage(event: HttpEvent<any>, file: File): string;
     /**
-     * Shows upload progress.
-     *
-     * @param message
+     * Logs upload progress messages to the console
+     * @param message The message to log
      */
     protected showProgress(message: string): void;
 }
@@ -5793,6 +5926,7 @@ declare class FormFieldDefinition<TEntity = any, TProperty = any> {
     triggerMapper?: (x: TProperty, y?: TEntity, f?: FormGroup, ctx?: IGenericFormBaseComponent<TEntity>) => any;
     /**
      * Mode of the trigger (e.g., chip).
+     * @deprecated This property is no longer used and will be removed in a future version.
      */
     triggerMode?: 'chip';
     /**
@@ -6020,7 +6154,7 @@ declare abstract class GenericFormBaseComponent<TEntity extends IEntity, TServic
      * Emitted when the form has been fully initialized
      * and is ready to be accessed or modified.
      */
-    formInitialized: EventEmitter<FormGroup<any> | NgForm>;
+    formInitialized: EventEmitter<NgForm | FormGroup<any>>;
     /**
      * The current date.
      */
@@ -6226,21 +6360,14 @@ declare abstract class GenericFormBaseComponent<TEntity extends IEntity, TServic
      * This method traverses the form controls and marks any invalid controls as dirty and touched to trigger validation messages in the UI.
      * @param container The form group, array, or control to traverse.
      */
-    private markControlsAsInvalid;
+    protected markControlsAsInvalid(container: FormGroup | FormArray | AbstractControl): void;
     /**
      * Recursively parses the form to collect error messages from the DOM.
      * This method traverses the form controls and attempts to find associated error messages in the DOM, collecting them into an array.
      * @param container The form group, array, or control to traverse.
      * @param errors The array to collect error messages into.
      */
-    private collectErrors;
-    /**
-     * Checks if the form is valid.
-     * This method validates the form, marks invalid controls, and shows error messages if any.
-     * @param form The form to check for validity.
-     * @returns A boolean indicating whether the form is valid.
-     */
-    isFormValidOld(form?: NgForm | FormGroup): boolean;
+    protected collectErrors(container: FormGroup | FormArray | AbstractControl, errors: string[]): void;
     /**
      * Resets form controls.
      * This method marks all controls in the form as pristine, untouched, and updates their validity.
@@ -6352,6 +6479,17 @@ declare abstract class GenericFormBaseComponent<TEntity extends IEntity, TServic
      * such as disabling form controls if the form is set to be disabled.
      */
     protected onAfterFormBuild(): void;
+    /**
+     * Event emitted when the form is invalid.
+     * This method allows performing operations when the form is found to be invalid.
+     * @param errors The validation errors found in the form.
+     */
+    protected onAfterFormInvalid(errors: ValidationErrors | null): void;
+    /**
+     * Event emitted when the form is valid.
+     * This method allows performing operations when the form is found to be valid.
+     */
+    protected onAfterFormValid(): void;
     /**
      * Event emitted when the entity has been created.
      */
@@ -9004,6 +9142,59 @@ interface ICanDisable {
 /** Mixin to augment a component or directive with a `disabled` property. */
 declare function mixinDisabled<T extends Constructor$1<{}>>(base: T): Constructor$1<ICanDisable> & T;
 
+declare class MsaEnumDisplayComponent {
+    /**
+     * The numeric value of the enum to convert.
+     */
+    readonly value: i0.InputSignal<number | null | undefined>;
+    /**
+     * The enum type (as an object) that defines the mapping of values to their string representations.
+     * @type {any}
+     */
+    readonly enumType: any;
+    /**
+     * Optional metadata for the enum values, which can be used to provide additional display information.
+     * This can be either a string prefix or an object containing EnumMetadata for each enum value.
+     */
+    readonly metadata: i0.InputSignal<string | {
+        [key: number]: EnumMetadata;
+    } | undefined>;
+    /**
+     * Determines whether to display the icon alongside the text.
+     * Defaults to false (hidden).
+     */
+    readonly showIcon: i0.InputSignal<boolean>;
+    /**
+     * Optional entity context passed down to evaluate dynamic icon functions.
+     */
+    readonly entity: i0.InputSignal<any>;
+    /**
+     * Optional execution context passed down to evaluate dynamic icon functions.
+     */
+    readonly context: i0.InputSignal<any>;
+    /**
+     * Extracts the current metadata object if it exists for the given value.
+     */
+    private readonly currentMetadata;
+    /**
+     * Dynamically evaluates the Icon configuration properties based on whether they are static values or context functions.
+     */
+    readonly resolvedIcon: i0.Signal<{
+        matIcon: any;
+        svgIcon: any;
+        fontIcon: any;
+        fontSet: string;
+        color: any;
+        cssClass: any;
+    } | null>;
+    /**
+     * Resolves the text to display based on metadata or enum lookup.
+     */
+    readonly resolvedText: i0.Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MsaEnumDisplayComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MsaEnumDisplayComponent, "msa-enum-display", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "enumType": { "alias": "enumType"; "required": false; "isSignal": true; }; "metadata": { "alias": "metadata"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "entity": { "alias": "entity"; "required": false; "isSignal": true; }; "context": { "alias": "context"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare const headerMetadataKey = "customer:vdHeader";
 declare const endpointMetadataKey = "customer:vdEndpoint";
 
@@ -9139,15 +9330,17 @@ declare enum Salutation {
 }
 
 /**
- * Property decorator to add display name to a property
- * @param name
- * @returns
+ * Property decorator to define a display name for a class property.
+ * This decorator can be applied to a class property to specify its display name, which can be used in UI components or other contexts.
+ * @param name The display name to associate with the property.
+ * @returns A property decorator function.
  */
 declare function Display(name: string): Function;
 /**
- * Class decorator to add endpoint to an entity
- * @param endpoint
- * @returns
+ * Class decorator to define an API endpoint for a given class.
+ * This decorator can be applied to a class to specify the API endpoint associated with it, which can be used for data retrieval or other operations.
+ * @param endpoint The API endpoint to associate with the class.
+ * @returns A class decorator function.
  */
 declare function Api(endpoint: string): Function;
 
@@ -9166,6 +9359,13 @@ declare function getEndpoint(origin: object): string;
  */
 declare function getDisplay(origin: object): string;
 
+/**
+ * @method graphql
+ * @description A tag function that tells IDEs (VS Code/WebStorm)
+ * to provide GraphQL syntax highlighting without adding runtime dependencies.
+ */
+declare function graphql(strings: TemplateStringsArray, ...values: any[]): string;
+
 declare class Utils {
     /**
      * Month names
@@ -9653,7 +9853,7 @@ declare class EnumPipe implements PipeTransform {
      * @returns The formatted string representation of the enum value, including any specified prefixes or suffixes,
      *          or undefined if the value is not recognized in the provided enum type.
      */
-    transform(value: number, enumType: any, prefixOrMetadata?: string | {
+    transform(value: number | null | undefined, enumType: any, prefixOrMetadata?: string | {
         [key: number]: EnumMetadata;
     }, suffix?: string): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<EnumPipe, never>;
@@ -10094,6 +10294,14 @@ declare const Templates: {
     idTitleTemplate: (x: any) => string;
 };
 
+/**
+ * @method parseProjectionString
+ * @description Parses projection input (string, string array, or raw multi-line string) into a flattened API-friendly projection string.
+ * @param {string | string[]} projection The raw selection input
+ * @returns {string} The formatted comma-separated string with no whitespace
+ */
+declare const parseProjectionString: (projection: string | string[]) => string;
+
 declare class VdDialogTitleDirective {
     static ɵfac: i0.ɵɵFactoryDeclaration<VdDialogTitleDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<VdDialogTitleDirective, "vd-dialog-title", never, {}, {}, never, never, true, never>;
@@ -10356,6 +10564,59 @@ declare class DatePickerHeaderComponent<D> implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerHeaderComponent<any>, "vd-datepicker-header", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * @component EditFormActionsComponent
+ * @description
+ * Reusable action row for edit forms.
+ * Uses the provided form context to derive button states and trigger
+ * standard form actions (save, apply, cancel/back).
+ */
+declare class MsaEditFormActionsComponent {
+    /**
+     * Reference to the generic form context used by this action row.
+     * @type {IGenericFormBaseComponent<any>}
+     */
+    context: IGenericFormBaseComponent<any>;
+    /**
+     * Determines if the save action is disabled.
+     * Save is disabled while saving is in progress or when form is readonly.
+     * @type {boolean}
+     */
+    get isSaveDisabled(): boolean;
+    /**
+     * Determines whether the apply button should be displayed.
+     * Apply is only visible when the form is in edit mode.
+     * @type {boolean}
+     */
+    get isApplyVisible(): boolean;
+    /**
+     * Determines if the apply action is disabled.
+     * Apply is disabled while saving is in progress or when form is readonly.
+     * @type {boolean}
+     */
+    get isApplyDisabled(): boolean;
+    /**
+     * Determines if the cancel action is disabled.
+     * Cancel remains enabled by default.
+     * @type {boolean}
+     */
+    get isCancelDisabled(): boolean;
+    /**
+     * Triggers the context save action.
+     */
+    onSave(): void;
+    /**
+     * Triggers the context apply action.
+     */
+    onApply(): void;
+    /**
+     * Triggers the context back action.
+     */
+    onCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MsaEditFormActionsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MsaEditFormActionsComponent, "[msa-edit-form-actions]", never, { "context": { "alias": "context"; "required": false; }; }, {}, never, never, true, never>;
+}
+
 /**
  * VdGenericFormCustomFieldDirective class
  */
@@ -10378,6 +10639,18 @@ declare class VdGenericFormCustomFieldDirective extends CdkPortal {
     static ɵdir: i0.ɵɵDirectiveDeclaration<VdGenericFormCustomFieldDirective, "[vd-generic-form-custom-field]ng-template", never, { "row": { "alias": "row"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * @interface VdGenericFormModifyEvent
+ * @description The `VdGenericFormModifyEvent` interface defines the structure of the event emitted
+ * by the `VdGenericFormComponent` when the form is initialized. It allows parent components to modify
+ * the form group, field rows, or fields before dynamic subscriptions are attached.
+ */
+interface VdGenericFormInitEvent {
+    formGroup?: FormGroup;
+    fieldRows?: FormFieldDefinition[][];
+    fields?: FormFieldDefinition[];
+    context?: any;
+}
 /**
  * @class VdEditorDirective
  * @description The `VdEditorDirective` is a custom directive that attaches a `CdkPortal`
@@ -10512,6 +10785,13 @@ declare class VdGenericFormComponent implements OnInit {
      * @type {boolean}
      */
     readonly?: boolean;
+    /**
+     * @property onInit
+     * @description Emitted after fields are built and filtered, allowing parent components to mutate `formGroup`,
+     * `fieldRows`, or `fields` before dynamic subscriptions are attached.
+     * @type {EventEmitter<VdGenericFormInitEvent>}
+     */
+    onInit: EventEmitter<VdGenericFormInitEvent>;
     /**
      * @property Key codes used for separating input values.
      * @description The `separatorKeysCodes` is an array of key codes (e.g., for comma or enter) used for
@@ -10678,7 +10958,7 @@ declare class VdGenericFormComponent implements OnInit {
      */
     log(message: any, ...optionalParams: any[]): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<VdGenericFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<VdGenericFormComponent, "vd-generic-form", never, { "formGroup": { "alias": "formGroup"; "required": false; }; "classType": { "alias": "classType"; "required": false; }; "formDefinition": { "alias": "formDefinition"; "required": false; }; "fieldGroups": { "alias": "fieldGroups"; "required": false; }; "groupName": { "alias": "groupName"; "required": false; }; "fieldSets": { "alias": "fieldSets"; "required": false; }; "context": { "alias": "context"; "required": false; }; "debugValue": { "alias": "debugValue"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "separatorKeysCodes": { "alias": "separatorKeysCodes"; "required": false; }; }, {}, ["editorTemplate", "codeTemplate", "fileTemplate", "customTemplate", "bottom", "customFields", "customFieldsTemplates"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VdGenericFormComponent, "vd-generic-form", never, { "formGroup": { "alias": "formGroup"; "required": false; }; "classType": { "alias": "classType"; "required": false; }; "formDefinition": { "alias": "formDefinition"; "required": false; }; "fieldGroups": { "alias": "fieldGroups"; "required": false; }; "groupName": { "alias": "groupName"; "required": false; }; "fieldSets": { "alias": "fieldSets"; "required": false; }; "context": { "alias": "context"; "required": false; }; "debugValue": { "alias": "debugValue"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "separatorKeysCodes": { "alias": "separatorKeysCodes"; "required": false; }; }, { "onInit": "init"; }, ["editorTemplate", "codeTemplate", "fileTemplate", "customTemplate", "bottom", "customFields", "customFieldsTemplates"], never, true, never>;
 }
 
 declare const formDefinitionMetadataKey = "custom:vdFormDefinition";
@@ -11119,15 +11399,17 @@ declare class RemoveWhitespaceDirective {
 }
 
 /**
- * Class decorator to create a form
- * @param formDefinition
- * @returns
+ * Class decorator to define a form definition for a given class.
+ * This decorator can be applied to a class to specify its form configuration, including endpoint, projection, actions, and field groups.
+ * @param formDefinition Optional partial configuration to customize the resulting FormDefinition.
+ * @returns A class decorator function.
  */
 declare function Form<T = any>(formDefinition?: Partial<FormDefinition<T>>): Function;
 /**
- * Property decorator to create form fields
- * @param args
- * @returns
+ * Property decorator to create and register form fields.
+ * This decorator can be applied to a class property to automatically generate and register form fields based on the provided arguments.
+ * @param args Partial arguments to customize the resulting FormFieldDefinition.
+ * @returns A property decorator function.
  */
 declare function FormField<TEntity = any, TProperty = any>(args: Partial<FormFieldDefinition<TEntity, TProperty>>): Function;
 /**
@@ -13123,11 +13405,6 @@ declare class VdSelectComponent extends AbstractSelectFormField<any> implements
      */
     get triggerCssClass(): string | undefined;
     set triggerCssClass(triggerCssClass: string | undefined);
-    /**
-     * Mode of the trigger.
-     */
-    get triggerMode(): string | undefined;
-    set triggerMode(triggerMode: 'chip' | undefined);
     /**
      * Gets the display values of the selected options for the trigger.
      *
@@ -13181,7 +13458,7 @@ declare class VdSelectComponent extends AbstractSelectFormField<any> implements
      */
     handleFilter($event?: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<VdSelectComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<VdSelectComponent, "vd-select", never, { "triggerCssClass": { "alias": "triggerCssClass"; "required": false; }; "triggerMode": { "alias": "triggerMode"; "required": false; }; }, {}, ["optionTemplate", "triggerTemplate"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<VdSelectComponent, "vd-select", never, { "triggerCssClass": { "alias": "triggerCssClass"; "required": false; }; }, {}, ["optionTemplate", "triggerTemplate"], never, true, never>;
 }
 
 declare class FilterClearComponent {
@@ -13972,5 +14249,5 @@ declare class TableStaticDataSource<TEntity> extends MatTableDataSource<TEntity>
     getSelected: <TType>(key?: string) => TType[];
 }
 
-export { AbstractMatFormField, AbstractSelectFormField, ActionItem, Api, ApiResponse, AppEvent, AppEventType, AppSetting, AppStorage, AsyncValidationDirective, AuditEntity, AuditUser, AuthHelper, AuthUser, AutofocusDirective, BaseComponent, BaseDirective, BaseEntity, BaseInterceptor, BaseService, BindPipe, CachingInterceptor, Column, ColumnObject, Common, CommonError, CommonHandlerContext, ConfirmExitGuard, ContextHelper, DIALOG_PROVIDER, DIALOG_PROVIDER_FACTORY, DataSourceFilterDirective, DataSourcePipe, DatePickerHeaderComponent, DisableControlDirective, Display, DisplayNameNumberProjection, DisplayNameProjection, DynamicBuilder, DynamicComponentCompiler, EXPORT_DIALOG_COMPONENT, EmptyStringResetDirective, EnumMetadata, EnumPipe, EnumService, EqualValidator, ErrorMessageBindingStrategy, EventQueueService, Facet, FacetValue, FieldFuncPipe, FileControlDirective, FileService, FileSizePipe, FilterClearComponent, FilterDateComponent, FilterGlue, FilterInputComponent, FilterOperator, FilterPipe, FilterSelectComponent, FirstLetterPipe, Form, FormArrayPipe, FormBuilderConfiguration, FormControlPipe, FormDefinition, FormField, FormFieldDefinition, FormFieldGroup, FormFieldGroupDefinition, FormFieldType, FormGroupPipe, FuncPipe, GenericEmbeddedListComponent, GenericFormBaseComponent, GenericFormComponent, GenericListComponent, GenericReactiveFormComponent, GenericService, GlobalRoles, Grid, GroupFilterPipe, HtmlControlTemplateDirective, IAbstractControl, Icon, ImageFileControlDirective, IpVersion, KeyValue, KeysPipe, LayoutToggle, LoadingScreenInterceptor, LoadingScreenService, MEDIA_PROVIDER, MEDIA_PROVIDER_FACTORY, MatFormFieldEditorDirective, MatFormFieldRadioDirective, MatFormFieldReadonlyDirective, Menu, MenuClient, MenuDepartment, MenuFormIncludesResolve, MenuItem, MenuItemClient, MenuItemDepartment, MenuItemFormIncludesResolve, MenuItemService, MenuItemTarget, MenuListProjectionResolve, MenuResolve, MenuScope, MenuSettings, MenuSettingsResolve, MessageType, ModifiableEntity, MonthNamePipe, NameNumberProjection, NameProjection, NativeElementInjectorDirective, NumericValueType, OnlyNumberDirective, OrderPipe, Pagination, PaginatorIntl, ParseDecimalDirective, Permission, PlaceholderPipe, PrefixDirective, PrintService, PropertyJoinPipe, ReactiveFormConfig, ReactiveTypedFormsModule, RemoveWhitespaceDirective, ResetFormType, RxFormArray, RxFormBuilder, RxFormControl, RxFormControlDirective, RxFormGroup, RxReactiveFormsModule, RxwebFormDirective, RxwebValidators, SafeHtmlPipe, Salutation, SaveAction, SplitPipe, SubMenuResolve, SuffixButton, Table, TableColumn, TableColumnConfig, TableColumnType, TableConfig, TableDataSource, TableDefinition, TableQueryConfig, TableStaticDataSource, TaskDialogData, Templates, TimePipe, TitleCase, TitleProjection, TruncatePipe, TypedForm, TypedFormBuilder, UniqueValidatorDirective, UrlValidationType, Utils, ValidationAlphabetLocale, ValueAccessorBase, ValuesPipe, VdAlertDialogComponent, VdChipsComponent, VdCodeDirective, VdConfirmDialogComponent, VdCustomDirective, VdDelayedHoverDirective, VdDialogActionsDirective, VdDialogComponent, VdDialogContentDirective, VdDialogHeaderActionsComponent, VdDialogHeaderComponent, VdDialogMaximizeDirective, VdDialogService, VdDialogTitleDirective, VdDynamicMenuComponent, VdDynamicTableComponent, VdDynamicTableConfigDialogComponent, VdEditorDirective, VdFileDirective, VdFileInputComponent, VdFileModule, VdFilterOptionDirective, VdGenericFormComponent, VdGenericFormCustomFieldDirective, VdLayoutCardOverComponent, VdLayoutCloseDirective, VdLayoutCompactComponent, VdLayoutComponent, VdLayoutFooterComponent, VdLayoutManageListCloseDirective, VdLayoutManageListComponent, VdLayoutManageListOpenDirective, VdLayoutManageListToggleDirective, VdLayoutNavComponent, VdLayoutNavListCloseDirective, VdLayoutNavListComponent, VdLayoutNavListOpenDirective, VdLayoutNavListToggleDirective, VdLayoutOpenDirective, VdLayoutToggleDirective, VdListOptionDirective, VdListToolbarComponent, VdMediaService, VdMediaToggleDirective, VdMenuComponent, VdNavigationDrawerComponent, VdNavigationDrawerMenuDirective, VdNavigationDrawerToolbarDirective, VdPromptDialogComponent, VdSelectComponent, VdSelectOptionDirective, VdSelectTriggerDirective, VdTableFieldDirective, VdTaskDialogComponent, allOf, allOfAsync, alpha, alphaAsync, alphaNumeric, alphaNumericAsync, and, ascii, async, blacklist, choice, choiceAsync, compare, compose, contains, containsAsync, creditCard, creditCardAsync, cusip, custom, customAsync, dataUri, date, dateAsync, different, digit, disable, elementClass, email, endpointMetadataKey, endsWith, endsWithAsync, error, escape, even, extension, extensionAsync, factor, factorAsync, file, fileAsync, fileSize, fileSizeAsync, formDefinitionMetadataKey, formFieldGroupsMetadataKey, formFieldsMetadataKey, getDisplay, getEndpoint, getFormDefinition, getFormGroups, getTableDefinition, greaterThan, greaterThanAsync, greaterThanEqualTo, greaterThanEqualToAsync, grid, headerMetadataKey, hexColor, iban, ibanAsync, image, imageAsync, json, latLong, latitude, leapYear, lessThan, lessThanAsync, lessThanEqualTo, lessThanEqualToAsync, longitude, lowerCase, ltrim, mac, mask, maxDate, maxDateAsync, maxLength, maxLengthAsync, maxNumber, maxNumberAsync, maxTime, maxTimeAsync, minDate, minDateAsync, minLength, minLengthAsync, minNumber, minNumberAsync, minTime, minTimeAsync, mixinDisableRipple, mixinDisabled, model, noneOf, noneOfAsync, not, notEmpty, numeric, numericAsync, odd, oneOf, oneOfAsync, or, password, passwordAsync, pattern, patternAsync, port, prefix, primeNumber, prop, propArray, propObject, range, rangeAsync, required, requiredTrue, rtrim, rule, sanitize, startsWith, startsWithAsync, stripLow, suffix, tableColumnsMetadataKey, tableDefinitionMetadataKey, time, timeAsync, toBoolean, toDate, toDouble, toFloat, toInt, toString, trim, unique, updateOn, upperCase, url, urlAsync, vdCollapseAnimation, whitelist };
-export type { AppFormGroup, CanComponentDeactivate, Constructor$1 as Constructor, Delegate, DialogButtonConfig, EditorChange, EnumItem, Filter, FilterField, FormGroupExtension, IAlertConfig, IBaseComponent, ICanDisable, ICanDisableRipple, ICollapseAnimation, ICommonHandlerContext, IConfirmConfig, IDialogConfig, IEntity, IFormGroup, IGenericFormBaseComponent, IGenericListComponent, IGenericReactiveFormBaseComponent, ILayoutTogglable, IPromptConfig, Options, ShowConfirmationDialog, ShowTaskDialog };
+export { AbstractMatFormField, AbstractSelectFormField, ActionItem, Api, ApiResponse, AppEvent, AppEventType, AppSetting, AppStorage, AsyncValidationDirective, AuditEntity, AuditUser, AuthHelper, AuthUser, AutofocusDirective, BaseComponent, BaseDirective, BaseEntity, BaseInterceptor, BaseService, BindPipe, CachingInterceptor, Column, ColumnObject, Common, CommonError, CommonHandlerContext, ConfirmExitGuard, ContextHelper, DIALOG_PROVIDER, DIALOG_PROVIDER_FACTORY, DataSourceFilterDirective, DataSourcePipe, DatePickerHeaderComponent, DisableControlDirective, Display, DisplayNameNumberProjection, DisplayNameProjection, DynamicBuilder, DynamicComponentCompiler, EXPORT_DIALOG_COMPONENT, EmptyStringResetDirective, EnumMetadata, EnumPipe, EnumService, EqualValidator, ErrorMessageBindingStrategy, EventQueueService, Facet, FacetValue, FieldFuncPipe, FileControlDirective, FileService, FileSizePipe, FilterClearComponent, FilterDateComponent, FilterGlue, FilterInputComponent, FilterOperator, FilterPipe, FilterSelectComponent, FirstLetterPipe, Form, FormArrayPipe, FormBuilderConfiguration, FormControlPipe, FormDefinition, FormField, FormFieldDefinition, FormFieldGroup, FormFieldGroupDefinition, FormFieldType, FormGroupPipe, FuncPipe, GenericEmbeddedListComponent, GenericFormBaseComponent, GenericFormComponent, GenericListComponent, GenericReactiveFormComponent, GenericService, GlobalRoles, Grid, GroupFilterPipe, HtmlControlTemplateDirective, IAbstractControl, Icon, ImageFileControlDirective, IpVersion, KeyValue, KeysPipe, LayoutToggle, LoadingScreenInterceptor, LoadingScreenService, MEDIA_PROVIDER, MEDIA_PROVIDER_FACTORY, MatFormFieldEditorDirective, MatFormFieldRadioDirective, MatFormFieldReadonlyDirective, Menu, MenuClient, MenuDepartment, MenuFormIncludesResolve, MenuItem, MenuItemClient, MenuItemDepartment, MenuItemFormIncludesResolve, MenuItemService, MenuItemTarget, MenuListProjectionResolve, MenuResolve, MenuScope, MenuSettings, MenuSettingsResolve, MessageType, ModifiableEntity, MonthNamePipe, MsaEditFormActionsComponent, MsaEnumDisplayComponent, NameNumberProjection, NameProjection, NativeElementInjectorDirective, NumericValueType, OnlyNumberDirective, OrderPipe, Pagination, PaginatorIntl, ParseDecimalDirective, Permission, PlaceholderPipe, PrefixDirective, PrintService, PropertyJoinPipe, ReactiveFormConfig, ReactiveTypedFormsModule, RemoveWhitespaceDirective, ResetFormType, RxFormArray, RxFormBuilder, RxFormControl, RxFormControlDirective, RxFormGroup, RxReactiveFormsModule, RxwebFormDirective, RxwebValidators, SafeHtmlPipe, Salutation, SaveAction, SplitPipe, SubMenuResolve, SuffixButton, Table, TableColumn, TableColumnConfig, TableColumnType, TableConfig, TableDataSource, TableDefinition, TableQueryConfig, TableStaticDataSource, TaskDialogData, Templates, TimePipe, TitleCase, TitleProjection, TruncatePipe, TypedForm, TypedFormBuilder, UniqueValidatorDirective, UrlValidationType, Utils, ValidationAlphabetLocale, ValueAccessorBase, ValuesPipe, VdAlertDialogComponent, VdChipsComponent, VdCodeDirective, VdConfirmDialogComponent, VdCustomDirective, VdDelayedHoverDirective, VdDialogActionsDirective, VdDialogComponent, VdDialogContentDirective, VdDialogHeaderActionsComponent, VdDialogHeaderComponent, VdDialogMaximizeDirective, VdDialogService, VdDialogTitleDirective, VdDynamicMenuComponent, VdDynamicTableComponent, VdDynamicTableConfigDialogComponent, VdEditorDirective, VdFileDirective, VdFileInputComponent, VdFileModule, VdFilterOptionDirective, VdGenericFormComponent, VdGenericFormCustomFieldDirective, VdLayoutCardOverComponent, VdLayoutCloseDirective, VdLayoutCompactComponent, VdLayoutComponent, VdLayoutFooterComponent, VdLayoutManageListCloseDirective, VdLayoutManageListComponent, VdLayoutManageListOpenDirective, VdLayoutManageListToggleDirective, VdLayoutNavComponent, VdLayoutNavListCloseDirective, VdLayoutNavListComponent, VdLayoutNavListOpenDirective, VdLayoutNavListToggleDirective, VdLayoutOpenDirective, VdLayoutToggleDirective, VdListOptionDirective, VdListToolbarComponent, VdMediaService, VdMediaToggleDirective, VdMenuComponent, VdNavigationDrawerComponent, VdNavigationDrawerMenuDirective, VdNavigationDrawerToolbarDirective, VdPromptDialogComponent, VdSelectComponent, VdSelectOptionDirective, VdSelectTriggerDirective, VdTableFieldDirective, VdTaskDialogComponent, allOf, allOfAsync, alpha, alphaAsync, alphaNumeric, alphaNumericAsync, and, ascii, async, blacklist, choice, choiceAsync, compare, compose, contains, containsAsync, creditCard, creditCardAsync, cusip, custom, customAsync, dataUri, date, dateAsync, different, digit, disable, elementClass, email, endpointMetadataKey, endsWith, endsWithAsync, error, escape, even, extension, extensionAsync, factor, factorAsync, file, fileAsync, fileSize, fileSizeAsync, formDefinitionMetadataKey, formFieldGroupsMetadataKey, formFieldsMetadataKey, getDisplay, getEndpoint, getFormDefinition, getFormGroups, getTableDefinition, graphql, greaterThan, greaterThanAsync, greaterThanEqualTo, greaterThanEqualToAsync, grid, headerMetadataKey, hexColor, iban, ibanAsync, image, imageAsync, json, latLong, latitude, leapYear, lessThan, lessThanAsync, lessThanEqualTo, lessThanEqualToAsync, longitude, lowerCase, ltrim, mac, mask, maxDate, maxDateAsync, maxLength, maxLengthAsync, maxNumber, maxNumberAsync, maxTime, maxTimeAsync, minDate, minDateAsync, minLength, minLengthAsync, minNumber, minNumberAsync, minTime, minTimeAsync, mixinDisableRipple, mixinDisabled, model, noneOf, noneOfAsync, not, notEmpty, numeric, numericAsync, odd, oneOf, oneOfAsync, or, parseProjectionString, password, passwordAsync, pattern, patternAsync, port, prefix, primeNumber, prop, propArray, propObject, range, rangeAsync, required, requiredTrue, rtrim, rule, sanitize, startsWith, startsWithAsync, stripLow, suffix, tableColumnsMetadataKey, tableDefinitionMetadataKey, time, timeAsync, toBoolean, toDate, toDouble, toFloat, toInt, toString, trim, unique, updateOn, upperCase, url, urlAsync, vdCollapseAnimation, whitelist };
+export type { AppFormGroup, CanComponentDeactivate, Constructor$1 as Constructor, Delegate, DialogButtonConfig, EditorChange, EnumItem, Filter, FilterField, FormGroupExtension, IAlertConfig, IBaseComponent, ICanDisable, ICanDisableRipple, ICollapseAnimation, ICommonHandlerContext, IConfirmConfig, IDialogConfig, IEntity, IFormGroup, IGenericFormBaseComponent, IGenericListComponent, IGenericReactiveFormBaseComponent, ILayoutTogglable, IPromptConfig, Options, ShowConfirmationDialog, ShowTaskDialog, VdGenericFormInitEvent };