@decaf-ts/for-angular 0.0.50 → 0.0.51

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { Type, Injector, ElementRef, EnvironmentInjector, OnChanges, OnDestroy, ChangeDetectorRef, Renderer2, EventEmitter, SimpleChanges, ViewContainerRef, TemplateRef, OnInit, AfterViewInit, ComponentMirror, ComponentRef, InjectionToken, Provider, ModuleWithProviders } from '@angular/core';
+import { Type, Injector, ElementRef, EnvironmentInjector, OnChanges, OnDestroy, ChangeDetectorRef, Renderer2, EventEmitter, SimpleChanges, ViewContainerRef, TemplateRef, OnInit, AfterViewInit, ComponentMirror, ComponentRef, InjectionToken, Provider, EnvironmentProviders, ModuleWithProviders } from '@angular/core';
 import { IonInput, IonSelect, IonTextarea, IonCheckbox, SpinnerTypes, InfiniteScrollCustomEvent, RefresherCustomEvent, MenuController } from '@ionic/angular';
 import { TextFieldTypes, SelectInterface, AutocompleteTypes, CheckboxCustomEvent, Color, PredefinedColors, OverlayEventDetail } from '@ionic/core';
 import * as i2 from '@angular/forms';
@@ -9,7 +9,8 @@ import { FieldProperties, IPagedComponentProperties, CrudOperationKeys, UIFuncti
 import * as _decaf_ts_decorator_validation from '@decaf-ts/decorator-validation';
 import { Model, VALIDATION_PARENT_KEY, ModelConstructor } from '@decaf-ts/decorator-validation';
 import { RepositoryFlags, Context, CrudOperations, OperationKeys, IRepository } from '@decaf-ts/db-decorators';
-import { ModalOptions, IonAccordionGroup, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
+import * as _ionic_angular_standalone from '@ionic/angular/standalone';
+import { ModalOptions, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
 import { Constructor } from '@decaf-ts/decoration';
 import { Router } from '@angular/router';
 import * as i1 from '@angular/common';
@@ -466,6 +467,69 @@ interface IFileUploadError {
     error: string;
 }
 
+/**
+ * @description Default options for empty list state display.
+ * @summary Provides default configuration for displaying empty state in list components
+ * when no data is available. Includes default text for title and subtitle, icon name,
+ * button text and visibility settings. These defaults can be overridden by individual
+ * list component implementations to customize the empty state presentation.
+ * @type {IListEmptyOptions}
+ * @property {string} title - Default translation key for empty list title
+ * @property {string} subtitle - Default translation key for empty list subtitle
+ * @property {boolean} showButton - Whether to show action button in empty state
+ * @property {string} icon - Default Ionic icon name for empty state
+ * @property {string} buttonText - Default translation key for button text
+ * @property {string} link - Default navigation link (empty string)
+ * @const DefaultListEmptyOptions
+ * @memberOf module:lib/engine/constants
+ */
+declare const DefaultListEmptyOptions: IListEmptyOptions;
+declare const DefaultModalOptions: ModalOptions;
+declare const ActionRoles: {
+    readonly cancel: "cancel";
+    readonly confirm: "confirm";
+    readonly submit: "submit";
+    readonly clear: "clear";
+    readonly back: "back";
+};
+declare const WindowColorSchemes: {
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly undefined: "undefined";
+};
+declare const ElementSizes: {
+    readonly xsmall: "xsmall";
+    readonly small: "small";
+    readonly medium: "medium";
+    readonly default: "default";
+    readonly large: "large";
+    readonly xLarge: "xlarge";
+    readonly '2xLarge': "2xlarge";
+    readonly auto: "auto";
+    readonly expand: "expand";
+    readonly block: "block";
+};
+declare const ElementPositions: {
+    readonly left: "left";
+    readonly center: "center";
+    readonly right: "right";
+    readonly top: "top";
+    readonly bottom: "bottom";
+};
+declare const LayoutGridGaps: {
+    readonly small: "small";
+    readonly medium: "medium";
+    readonly large: "large";
+    readonly collapse: "collapse";
+    readonly none: "";
+};
+declare const ListItemPositions: {
+    readonly uid: "uid";
+    readonly title: "title";
+    readonly description: "description";
+    readonly info: "info";
+    readonly subinfo: "subinfo";
+};
 /**
  * @description Angular engine key constants.
  * @summary Contains key strings used by the Angular rendering engine for reflection,
@@ -697,69 +761,6 @@ declare const CssClasses: {
  * @memberOf module:lib/engine/constants
  */
 declare const DefaultFormReactiveOptions: ICrudFormOptions;
-/**
- * @description Default options for empty list state display.
- * @summary Provides default configuration for displaying empty state in list components
- * when no data is available. Includes default text for title and subtitle, icon name,
- * button text and visibility settings. These defaults can be overridden by individual
- * list component implementations to customize the empty state presentation.
- * @type {IListEmptyOptions}
- * @property {string} title - Default translation key for empty list title
- * @property {string} subtitle - Default translation key for empty list subtitle
- * @property {boolean} showButton - Whether to show action button in empty state
- * @property {string} icon - Default Ionic icon name for empty state
- * @property {string} buttonText - Default translation key for button text
- * @property {string} link - Default navigation link (empty string)
- * @const DefaultListEmptyOptions
- * @memberOf module:lib/engine/constants
- */
-declare const DefaultListEmptyOptions: IListEmptyOptions;
-declare const DefaultModalOptions: ModalOptions;
-declare const ActionRoles: {
-    readonly cancel: "cancel";
-    readonly confirm: "confirm";
-    readonly submit: "submit";
-    readonly clear: "clear";
-    readonly back: "back";
-};
-declare const WindowColorSchemes: {
-    readonly light: "light";
-    readonly dark: "dark";
-    readonly undefined: "undefined";
-};
-declare const ElementSizes: {
-    readonly xsmall: "xsmall";
-    readonly small: "small";
-    readonly medium: "medium";
-    readonly default: "default";
-    readonly large: "large";
-    readonly xLarge: "xlarge";
-    readonly '2xLarge': "2xlarge";
-    readonly auto: "auto";
-    readonly expand: "expand";
-    readonly block: "block";
-};
-declare const ElementPositions: {
-    readonly left: "left";
-    readonly center: "center";
-    readonly right: "right";
-    readonly top: "top";
-    readonly bottom: "bottom";
-};
-declare const LayoutGridGaps: {
-    readonly small: "small";
-    readonly medium: "medium";
-    readonly large: "large";
-    readonly collapse: "collapse";
-    readonly none: "";
-};
-declare const ListItemPositions: {
-    readonly uid: "uid";
-    readonly title: "title";
-    readonly description: "description";
-    readonly info: "info";
-    readonly subinfo: "subinfo";
-};
 
 /**
  * @module module:lib/engine/types
@@ -1753,7 +1754,7 @@ declare abstract class NgxComponentDirective extends DecafComponent implements O
      *   end
      * @memberOf module:lib/engine/NgxComponentDirective
      */
-    handleEvent(event: IBaseCustomEvent | ICrudFormEvent | CustomEvent, repository?: DecafRepository<Model>): Promise<void>;
+    handleEvent(event: IBaseCustomEvent | ICrudFormEvent | CustomEvent): Promise<void>;
     /**
      * @description Determines if a specific operation is allowed in the current context.
      * @summary This method checks if an operation is included in the list of available
@@ -2778,6 +2779,16 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
      * @memberOf CrudFieldComponent
      */
     spellcheck: boolean;
+    /**
+     * @description Spellcheck attribute for text inputs.
+     * @summary Enables or disables spellchecking for text inputs.
+     * When true, the browser will check the spelling of the input text.
+     *
+     * @type {boolean}
+     * @default false
+     * @memberOf CrudFieldComponent
+     */
+    startEmpty: boolean;
     /**
      * @description Input mode for text inputs.
      * @summary Hints at the type of data that might be entered by the user while editing the element.
@@ -2905,6 +2916,18 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
     * @memberOf CrudFieldComponent
     */
     getOptions(): Promise<CrudFieldOption[]>;
+    /**
+     * Handles the opening of select options based on the specified interface type.
+     * If the `selectInterface` is 'modal', it prevents the default event behavior,
+     * stops propagation, and opens a modal to display the select options.
+     * Once the modal is dismissed, it sets the selected value if the action role
+     * is confirmed and the selected value differs from the current value.
+     *
+     * @param {Event} event - The event triggered by the user interaction.
+     * @param {SelectInterface} selectInterface - The interface type for displaying select options.
+     * Currently supports 'modal'.
+     * @returns {Promise<void>} A promise that resolves when the operation is complete.
+     */
     openSelectOptions(event: Event, selectInterface: SelectInterface): Promise<void>;
     /**
      * @description Component after view initialization lifecycle method.
@@ -2940,7 +2963,7 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
      */
     handleFieldsetUpdateGroupEvent(event: CustomEvent): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CrudFieldComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFieldComponent, "ngx-decaf-crud-field", never, { "operation": { "alias": "operation"; "required": true; }; "name": { "alias": "name"; "required": true; }; "className": { "alias": "className"; "required": false; }; "path": { "alias": "path"; "required": true; }; "childOf": { "alias": "childOf"; "required": false; }; "type": { "alias": "type"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": true; }; "placeholder": { "alias": "placeholder"; "required": false; }; "format": { "alias": "format"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "max": { "alias": "max"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "min": { "alias": "min"; "required": false; }; "minlength": { "alias": "minlength"; "required": false; }; "pattern": { "alias": "pattern"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "step": { "alias": "step"; "required": false; }; "equals": { "alias": "equals"; "required": false; }; "different": { "alias": "different"; "required": false; }; "lessThan": { "alias": "lessThan"; "required": false; }; "lessThanOrEqual": { "alias": "lessThanOrEqual"; "required": false; }; "greaterThan": { "alias": "greaterThan"; "required": false; }; "greaterThanOrEqual": { "alias": "greaterThanOrEqual"; "required": false; }; "alignment": { "alias": "alignment"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; "cancelText": { "alias": "cancelText"; "required": false; }; "interface": { "alias": "interface"; "required": false; }; "options": { "alias": "options"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "spellcheck": { "alias": "spellcheck"; "required": false; }; "inputmode": { "alias": "inputmode"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "fill": { "alias": "fill"; "required": false; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; }; "updateOn": { "alias": "updateOn"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "formControl": { "alias": "formControl"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "page": { "alias": "page"; "required": false; }; "translatable": { "alias": "translatable"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFieldComponent, "ngx-decaf-crud-field", never, { "operation": { "alias": "operation"; "required": true; }; "name": { "alias": "name"; "required": true; }; "className": { "alias": "className"; "required": false; }; "path": { "alias": "path"; "required": true; }; "childOf": { "alias": "childOf"; "required": false; }; "type": { "alias": "type"; "required": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "label": { "alias": "label"; "required": true; }; "placeholder": { "alias": "placeholder"; "required": false; }; "format": { "alias": "format"; "required": false; }; "hidden": { "alias": "hidden"; "required": false; }; "max": { "alias": "max"; "required": false; }; "maxlength": { "alias": "maxlength"; "required": false; }; "min": { "alias": "min"; "required": false; }; "minlength": { "alias": "minlength"; "required": false; }; "pattern": { "alias": "pattern"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "required": { "alias": "required"; "required": false; }; "step": { "alias": "step"; "required": false; }; "equals": { "alias": "equals"; "required": false; }; "different": { "alias": "different"; "required": false; }; "lessThan": { "alias": "lessThan"; "required": false; }; "lessThanOrEqual": { "alias": "lessThanOrEqual"; "required": false; }; "greaterThan": { "alias": "greaterThan"; "required": false; }; "greaterThanOrEqual": { "alias": "greaterThanOrEqual"; "required": false; }; "alignment": { "alias": "alignment"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; "cancelText": { "alias": "cancelText"; "required": false; }; "interface": { "alias": "interface"; "required": false; }; "options": { "alias": "options"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "spellcheck": { "alias": "spellcheck"; "required": false; }; "startEmpty": { "alias": "startEmpty"; "required": false; }; "inputmode": { "alias": "inputmode"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "fill": { "alias": "fill"; "required": false; }; "labelPlacement": { "alias": "labelPlacement"; "required": false; }; "updateOn": { "alias": "updateOn"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "formControl": { "alias": "formControl"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "page": { "alias": "page"; "required": false; }; "translatable": { "alias": "translatable"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -3111,21 +3134,7 @@ declare abstract class NgxFormDirective extends NgxParentComponentDirective impl
      * @type {FormGroup}
      */
     parentFormId: string;
-    /**
-     * @description Indicates whether this form is being used inside a modal dialog.
-     * @summary When true, the form may alter its submit/reset behavior to integrate
-     * with modal lifecycle (for example, emitting cancel events instead of
-     * navigating back). Useful for components rendered inside Ionic/Angular
-     * modal containers where navigation/back behavior differs from standard pages.
-     *
-     * Typical effects:
-     * - `handleReset` will emit a cancel event instead of performing a navigation
-     * - `ngAfterViewInit` checks for modal context to adjust change detection
-     *
-     * @type {boolean}
-     * @default false
-     */
-    modalForm: boolean;
+    deepMerge: boolean;
     /**
      * @description Reference to the reactive form DOM element.
      * @summary ViewChild reference that provides direct access to the form's DOM element.
@@ -3302,7 +3311,7 @@ declare abstract class NgxFormDirective extends NgxParentComponentDirective impl
     */
     protected getActivePage(page: number): UIModelMetadata | UIModelMetadata[] | FieldDefinition | undefined;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxFormDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxFormDirective, never, never, { "parentFormId": { "alias": "parentFormId"; "required": false; }; "modalForm": { "alias": "modalForm"; "required": false; }; "updateOn": { "alias": "updateOn"; "required": false; }; "target": { "alias": "target"; "required": false; }; "method": { "alias": "method"; "required": false; }; "options": { "alias": "options"; "required": false; }; "action": { "alias": "action"; "required": false; }; "operation": { "alias": "operation"; "required": true; }; "handlers": { "alias": "handlers"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "rendererId": { "alias": "rendererId"; "required": false; }; "allowClear": { "alias": "allowClear"; "required": false; }; "match": { "alias": "match"; "required": false; }; }, { "submitEvent": "submitEvent"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxFormDirective, never, never, { "parentFormId": { "alias": "parentFormId"; "required": false; }; "deepMerge": { "alias": "deepMerge"; "required": false; }; "updateOn": { "alias": "updateOn"; "required": false; }; "target": { "alias": "target"; "required": false; }; "method": { "alias": "method"; "required": false; }; "options": { "alias": "options"; "required": false; }; "action": { "alias": "action"; "required": false; }; "operation": { "alias": "operation"; "required": true; }; "handlers": { "alias": "handlers"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "rendererId": { "alias": "rendererId"; "required": false; }; "allowClear": { "alias": "allowClear"; "required": false; }; "match": { "alias": "match"; "required": false; }; }, { "submitEvent": "submitEvent"; }, never, never, true, never>;
 }
 
 declare class CrudFormComponent extends NgxFormDirective {
@@ -3330,7 +3339,7 @@ declare class CrudFormComponent extends NgxFormDirective {
      */
     handleDelete(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CrudFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFormComponent, "ngx-decaf-crud-form", never, {}, {}, never, ["*", "*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFormComponent, "ngx-decaf-crud-form", never, {}, {}, never, ["*"], true, never>;
 }
 
 /**
@@ -3844,17 +3853,6 @@ declare class EmptyStateComponent extends CardComponent implements OnInit {
  * @memberOf FieldsetComponent
  */
 declare class FieldsetComponent extends NgxFormDirective implements OnInit, AfterViewInit {
-    /**
-     * @description Reference to the ion-accordion-group component for programmatic control.
-     * @summary ViewChild reference that provides direct access to the Ionic accordion group component.
-     * This enables programmatic control over the accordion's expand/collapse state, allowing
-     * the component to open/close the accordion based on validation errors, CRUD operations,
-     * or other business logic requirements.
-     *
-     * @type {IonAccordionGroup}
-     * @memberOf FieldsetComponent
-     */
-    accordionComponent: IonAccordionGroup;
     /**
      * @description The display name or title of the fieldset section.
      * @summary Sets the legend or header text that appears in the accordion header. This text
@@ -3877,16 +3875,6 @@ declare class FieldsetComponent extends NgxFormDirective implements OnInit, Afte
      * @default 'Child'
      * @memberOf FieldsetComponent
      */
-    collapsable: boolean;
-    /**
-     * @description Custom type definitions for specialized fieldset behavior.
-     * @summary Defines custom data types or validation rules that should be applied to this fieldset.
-     * Can be a single type string or array of types that determine how the fieldset handles
-     * data validation, formatting, and display behavior for specialized use cases.
-     *
-     * @type {string | string[]}
-     * @memberOf FieldsetComponent
-     */
     customTypes: string | string[];
     /**
      * @description Primary title text for the fieldset content.
@@ -4215,18 +4203,6 @@ declare class FieldsetComponent extends NgxFormDirective implements OnInit, Afte
      *
      * @memberOf FieldsetComponent
      */
-    /**
-     * @description Handles accordion toggle functionality with validation error consideration.
-     * @summary Manages the expand/collapse state of the accordion while respecting validation error states.
-     * When validation errors are present, the accordion cannot be collapsed to ensure users can see
-     * and address the errors. When no errors exist, users can freely toggle the accordion state.
-     * This method also stops event propagation to prevent unwanted side effects.
-     *
-     * @param {CustomEvent} [event] - Optional event object from user interaction
-     * @returns {void}
-     * @memberOf FieldsetComponent
-     */
-    handleAccordionToggle(event?: CustomEvent): void;
     /**
      * @description Handles validation error events from child form fields.
      * @summary Processes validation error events dispatched by form fields within the fieldset.
@@ -4263,7 +4239,7 @@ declare class FieldsetComponent extends NgxFormDirective implements OnInit, Afte
      */
     private getMapper;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldsetComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FieldsetComponent, "ngx-decaf-fieldset", never, { "formControl": { "alias": "formControl"; "required": false; }; "collapsable": { "alias": "collapsable"; "required": false; }; "customTypes": { "alias": "customTypes"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "borders": { "alias": "borders"; "required": false; }; "max": { "alias": "max"; "required": false; }; "required": { "alias": "required"; "required": false; }; "ordenable": { "alias": "ordenable"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldsetComponent, "ngx-decaf-fieldset", never, { "formControl": { "alias": "formControl"; "required": false; }; "customTypes": { "alias": "customTypes"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "borders": { "alias": "borders"; "required": false; }; "max": { "alias": "max"; "required": false; }; "required": { "alias": "required"; "required": false; }; "ordenable": { "alias": "ordenable"; "required": false; }; "editable": { "alias": "editable"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -4339,6 +4315,14 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * @memberOf FilterComponent
      */
     indexes: string[];
+    /**
+     * @description Allows multiple filters to be added.
+     * @summary When true, users can add multiple filters; when false, only one filter is allowed.
+     *
+     * @type {boolean}
+     * @default true
+     * @memberOf FilterComponent
+     */
     multiple: boolean;
     /**
      * @description Available comparison conditions for filters.
@@ -4503,6 +4487,7 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * @memberOf FilterComponent
      */
     searchEvent: EventEmitter<string>;
+    inputElement: HTMLInputElement;
     /**
      * @description Constructor for FilterComponent.
      * @summary Initializes a new instance of the FilterComponent.
@@ -5691,7 +5676,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      *
      * @memberOf ListComponent
      */
-    protected parseResult(result: KeyValue[] | Paginator<any>): Promise<KeyValue[]>;
+    protected parseResult(result: KeyValue[] | Paginator<Model>): Promise<KeyValue[]>;
     /**
      * @description Updates pagination state based on data length.
      * @summary Calculates whether more data is available and how many pages exist
@@ -7501,9 +7486,9 @@ declare class FileUploadComponent extends NgxFormFieldDirective implements OnIni
      * @summary Sets up the component by enabling directory mode if specified, formatting the accepted file types,
      * and converting the maximum file size from megabytes to bytes.
      *
-     * @returns {void}
+     * @returns {Promise<void>}
      */
-    ngOnInit(): void;
+    ngOnInit(): Promise<void>;
     initialize(): Promise<void>;
     /**
      * @description Lifecycle hook that is called when a directive, pipe, or service is destroyed.
@@ -7526,9 +7511,9 @@ declare class FileUploadComponent extends NgxFormFieldDirective implements OnIni
      * This method is triggered when the user selects files using the file input element.
      *
      * @param {Event} event - The file selection event.
-     * @returns {void}
+     * @returns {Promise<void> }
      */
-    handleSelection(event: Event): void;
+    handleSelection(event: Event): Promise<void>;
     /**
      * @description Handles the drop event for drag-and-drop file uploads.
      * @summary Processes the files dropped by the user, validates them, and updates the file list.
@@ -8578,6 +8563,15 @@ declare class NgxFormService {
     static reset(formGroup: FormGroup | FormControl): void;
 }
 
+/**
+ * @module module:lib/engine/NgxEventHandler
+ * @description Event handler base class used by Decaf components.
+ * @summary Defines NgxEventHandler which standardizes event handling logic and provides
+ * logging support for handlers that process custom events emitted by components.
+ *
+ * @link {@link NgxEventHandler}
+ */
+
 declare abstract class NgxEventHandler extends DecafEventHandler {
     constructor();
     refresh(args?: unknown[]): Promise<void>;
@@ -8856,7 +8850,7 @@ declare abstract class NgxModelPageDirective extends NgxPageDirective {
      * @param {string} uid - The unique identifier of the model instance to retrieve
      * @return {Promise<Model | undefined>} Promise resolving to the model instance or undefined
      */
-    handleGet(uid?: EventIds, repository?: IRepository<any>, modelName?: string): Promise<Model | undefined>;
+    handleGet(uid?: EventIds, repository?: IRepository<Model>, modelName?: string): Promise<Model | undefined>;
     /**
      * @description Parses and transforms form data for repository operations.
      * @summary Converts raw form data into the appropriate format for repository operations.
@@ -9357,15 +9351,6 @@ declare function provideI18n(config?: RootTranslateServiceConfig, resources?: I1
     };
 } | i0.Provider[])[];
 
-/**
- * @module lib/for-angular-common.module
- * @description Core Angular module and providers for Decaf's for-angular package.
- * @summary Provides the shared Angular module, injection tokens and helper functions used
- * by the for-angular integration. This module wires up common imports (forms, translation)
- * and exposes helper providers such as DB adapter registration and logger utilities.
- * @link {@link ForAngularCommonModule}
- */
-
 declare const DB_ADAPTER_PROVIDER = "DB_ADAPTER_PROVIDER";
 /**
  * @description Injection token for registering the database adapter provider.
@@ -9478,6 +9463,23 @@ declare function getModelAndRepository(model: Model | string): {
 declare function provideDbAdapter<DbAdapter extends {
     flavour: string;
 }>(clazz: Constructor<DbAdapter>, options?: KeyValue, flavour?: string): Provider;
+/**
+ * Creates a custom page transition animation using the Ionic `AnimationController`.
+ *
+ * @param baseEl - The base HTML element for the animation.
+ * @param opts - Optional parameters for the animation, including:
+ *   - `enteringEl`: The HTML element that is entering the view.
+ *   - `leavingEl`: The HTML element that is leaving the view.
+ *
+ * @returns An object containing the `navAnimation`, which is a composed animation
+ *          of the entering and leaving animations.
+ *
+ * The entering animation fades in and slides the element upwards, while the leaving
+ * animation fades out and slides the element downwards. Both animations use a cubic-bezier
+ * easing function for smooth transitions.
+ */
+declare const decafPageTransition: (baseEl: HTMLElement, opts?: KeyValue) => _ionic_angular_standalone.Animation;
+declare function provideDecafPageTransition(): EnvironmentProviders;
 /**
  * @description Retrieves a logger instance for the given context.
  * @summary Creates or retrieves a namespaced logger instance using the Decaf logging system.
@@ -9539,5 +9541,5 @@ declare class ForAngularCommonModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<ForAngularCommonModule>;
 }
 
-export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentEventNames, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_PROVIDER, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, ElementPositions, ElementSizes, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, FormConstants, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, LayoutGridGaps, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, LoggerLevels, ModalComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SteppedFormComponent, WindowColorSchemes, cleanSpaces, dataMapper, filterString, formatDate, generateRandomValue, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxInlineModal, presentNgxLightBoxModal, provideDbAdapter, provideDynamicComponents, provideI18n, provideI18nLoader, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
+export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentEventNames, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_PROVIDER, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, ElementPositions, ElementSizes, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, FormConstants, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, LayoutGridGaps, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, LoggerLevels, ModalComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SteppedFormComponent, WindowColorSchemes, cleanSpaces, dataMapper, decafPageTransition, filterString, formatDate, generateRandomValue, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxInlineModal, presentNgxLightBoxModal, provideDbAdapter, provideDecafPageTransition, provideDynamicComponents, provideI18n, provideI18nLoader, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
 export type { ActionRole, AngularDynamicOutput, AngularFieldDefinition, CheckboxOption, ComponentMetadata, CrudFieldOption, DecafRepository, DecafRepositoryAdapter, ElementPosition, ElementSize, FieldUpdateMode, FlexPosition, FormParent, FormParentGroup, FormServiceControl, FormServiceControls, FunctionLike, HTML5InputType, HTMLFormTarget, I18nResourceConfig, I18nResourceConfigType, I18nToken, IBaseCustomEvent, IComponentConfig, IComponentHolder, IComponentProperties, ICrudFormEvent, ICrudFormOptions, IFieldSetItem, IFieldSetValidationEvent, IFileUploadError, IFilterQuery, IFilterQueryItem, IFormComponentProperties, IFormElement, IFormReactiveSubmitEvent, IListComponentRefreshEvent, IListEmptyOptions, IMenuItem, IModelPageCustomEvent, IPaginationCustomEvent, IRenderedModel, ISortObject, IWindowResizeEvent, InputOption, KeyValue, LayoutGridGap, ListItemCustomEvent, ListItemPosition, PossibleInputTypes, RadioOption, RawQuery, SelectOption, StringOrBoolean, WindowColorScheme };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/for-angular",
-  "version": "0.0.50",
+  "version": "0.0.51",
   "author": "Tiago Venceslau and Contributors",
   "license": "MPL-2.0 OR AGPL-3.0",
   "repository": {