@decaf-ts/for-angular 0.0.16 → 0.0.18

package/components/crud-field/crud-field.component.d.ts

@@ -1,9 +1,9 @@
 import { AfterViewInit, ElementRef, OnDestroy, OnInit } from '@angular/core';
-import { FormControl, FormGroup } from '@angular/forms';
+import { FormArray, FormControl, FormGroup } from '@angular/forms';
 import { AutocompleteTypes, SelectInterface } from '@ionic/core';
 import { CrudOperations } from '@decaf-ts/db-decorators';
 import { NgxCrudFormField } from '../../engine/NgxCrudFormField';
-import { FieldUpdateMode, PossibleInputTypes, RadioOption, SelectOption, StringOrBoolean } from '../../engine/types';
+import { CrudFieldOption, FieldUpdateMode, PossibleInputTypes, StringOrBoolean } from '../../engine/types';
 import * as i0 from "@angular/core";
 /**
  * @description A dynamic form field component for CRUD operations.
@@ -86,6 +86,16 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      * @type {string}
      * @memberOf CrudFieldComponent
      */
+    /**
+     * @description The parent field path for nested field structures.
+     * @summary Specifies the full dot-delimited path of the parent field when this field
+     * is part of a nested structure. This is used for hierarchical form organization
+     * and proper form control resolution in complex form structures.
+     *
+     * @type {string}
+     * @default ''
+     * @memberOf CrudFieldComponent
+     */
     childOf: string;
     /**
      * @description The input type of the field.
@@ -225,38 +235,60 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      */
     step?: number;
     /**
-     * @description Field name for equals comparison.
-     * @type {string}
+     * @description Field name for equality validation comparison.
+     * @summary Specifies another field name that this field's value must be equal to for validation.
+     * This is commonly used for password confirmation fields or other scenarios where
+     * two fields must contain the same value.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     equals?: string;
     /**
-     * @description Field name for different comparison.
-     * @type {string}
+     * @description Field name for inequality validation comparison.
+     * @summary Specifies another field name that this field's value must be different from for validation.
+     * This is used to ensure that two fields do not contain the same value, which might be
+     * required for certain business rules or security constraints.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     different?: string;
     /**
-     * @description Field name for less than comparison.
-     * @type {string}
+     * @description Field name for less-than validation comparison.
+     * @summary Specifies another field name that this field's value must be less than for validation.
+     * This is commonly used for date ranges, numeric ranges, or other scenarios where
+     * one field must have a smaller value than another.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     lessThan?: string;
     /**
-     * @description Field name for less than or equal comparison.
-     * @type {string}
+     * @description Field name for less-than-or-equal validation comparison.
+     * @summary Specifies another field name that this field's value must be less than or equal to
+     * for validation. This provides inclusive upper bound validation for numeric or date comparisons.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     lessThanOrEqual?: string;
     /**
-     * @description Field name for greater than comparison.
-     * @type {string}
+     * @description Field name for greater-than validation comparison.
+     * @summary Specifies another field name that this field's value must be greater than for validation.
+     * This is commonly used for date ranges, numeric ranges, or other scenarios where
+     * one field must have a larger value than another.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     greaterThan?: string;
     /**
-     * @description Field name for greater than or equal comparison.
-     * @type {string}
+     * @description Field name for greater-than-or-equal validation comparison.
+     * @summary Specifies another field name that this field's value must be greater than or equal to
+     * for validation. This provides inclusive lower bound validation for numeric or date comparisons.
+     *
+     * @type {string | undefined}
      * @memberOf CrudFieldComponent
      */
     greaterThanOrEqual?: string;
@@ -328,10 +360,10 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      * @summary Provides the list of options for select or radio inputs. Each option can have a value and a label.
      * This is used to populate the dropdown or radio group with choices.
      *
-     * @type {SelectOption[] | RadioOption[]}
+     * @type {CrudFieldOption[]}
      * @memberOf CrudFieldComponent
      */
-    options: SelectOption[] | RadioOption[];
+    options: CrudFieldOption[];
     /**
      * @description Mode of the field.
      * @summary Specifies the visual mode of the field, such as 'ios' or 'md'.
@@ -418,7 +450,35 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      * @memberOf CrudFieldComponent
      */
     formGroup: FormGroup | undefined;
+    /**
+     * @description Angular FormControl instance for this field.
+     * @summary The specific FormControl instance that manages this field's state, validation,
+     * and value. This provides direct access to Angular's reactive forms functionality
+     * for this individual field within the broader form structure.
+     *
+     * @type {FormControl}
+     * @memberOf CrudFieldComponent
+     */
     formControl: FormControl;
+    /**
+     * @description Indicates if this field supports multiple values.
+     * @summary When true, this field can handle multiple values, typically used in
+     * multi-select scenarios or when the field is part of a form array structure
+     * that allows multiple entries of the same field type.
+     *
+     * @type {boolean}
+     * @default false
+     * @memberOf CrudFieldComponent
+     */
+    multiple: boolean;
+    /**
+     * @description Unique identifier for the current record.
+     * @summary A unique identifier for the current record being displayed or manipulated.
+     * This is typically used in conjunction with the primary key for operations on specific records.
+     *
+     * @type {string | number}
+     */
+    uid: string;
     /**
      * @description Translatability of field labels.
      * @summary Indicates whether the field labels should be translated based on the current language settings.
@@ -430,16 +490,120 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      */
     translatable: StringOrBoolean;
     /**
-     * @description Unique identifier for the current record.
-     * @summary A unique identifier for the current record being displayed or manipulated.
-     * This is typically used in conjunction with the primary key for operations on specific records.
+     * @description Index of the currently active form group in a form array.
+     * @summary When working with multiple form groups (form arrays), this indicates
+     * which form group is currently active or being edited. This is used to manage
+     * focus and data binding in multi-entry scenarios.
      *
-     * @type {string | number}
+     * @type {number}
+     * @default 0
+     * @memberOf CrudFieldComponent
+     */
+    activeFormGroup: number;
+    /**
+     * @description FormArray containing multiple form groups for this field.
+     * @summary When this field is part of a multi-entry structure, this FormArray
+     * contains all the form groups. This enables management of multiple instances
+     * of the same field structure within a single form.
+     *
+     * @type {FormArray}
+     * @memberOf CrudFieldComponent
+     */
+    formGroupArray: FormArray;
+    /**
+     * @description Primary key field name for uniqueness validation.
+     * @summary Specifies the field name that serves as the primary key for uniqueness
+     * validation within form arrays. This is used to prevent duplicate entries
+     * and ensure data integrity in multi-entry forms.
+     *
+     * @type {string}
+     * @memberOf CrudFieldComponent
+     */
+    pk: string;
+    /**
+     * @description Gets the currently active form group based on context.
+     * @summary Returns the appropriate FormGroup based on whether this field supports
+     * multiple values. For single-value fields, returns the main form group.
+     * For multi-value fields, returns the form group at the active index from the parent FormArray.
+     *
+     * @returns {FormGroup} The currently active FormGroup for this field
+     * @memberOf CrudFieldComponent
+     */
+    get getActiveFormGroup(): FormGroup;
+    /**
+     * Returns a list of options for select or radio inputs, with their `text` property
+     * localized if it does not already include the word 'options'. The localization key
+     * is generated from the component's label, replacing 'label' with 'options'.
+     *
+     * @returns {CrudFieldOption[]} The array of parsed and localized options.
+     * @memberOf CrudFieldComponent
+     */
+    get parsedOptions(): CrudFieldOption[];
+    /**
+     * @description Component initialization lifecycle method.
+     * @summary Initializes the field component based on the operation type and field configuration.
+     * For READ and DELETE operations, removes the form group to make fields read-only.
+     * For other operations, sets up icons, configures multi-value support if needed,
+     * and sets default values for radio buttons if no value is provided.
+     *
+     * @returns {void}
+     * @memberOf CrudFieldComponent
      */
-    uid: string | number | undefined;
     ngOnInit(): void;
+    /**
+     * @description Component after view initialization lifecycle method.
+     * @summary Calls the parent afterViewInit method for READ and DELETE operations.
+     * This ensures proper initialization of read-only fields that don't require
+     * form functionality but still need view setup.
+     *
+     * @returns {void}
+     * @memberOf CrudFieldComponent
+     */
     ngAfterViewInit(): void;
+    /**
+     * @description Component cleanup lifecycle method.
+     * @summary Performs cleanup operations for READ and DELETE operations by calling
+     * the parent onDestroy method. This ensures proper resource cleanup for
+     * read-only field components.
+     *
+     * @returns {void}
+     * @memberOf CrudFieldComponent
+     */
     ngOnDestroy(): void;
+    /**
+     * @description Handles fieldset group creation events from parent fieldsets.
+     * @summary Processes events triggered when a new group needs to be added to a fieldset.
+     * Validates the current form group, checks for uniqueness if applicable, and either
+     * creates a new group or provides validation feedback. Updates the active form group
+     * and resets the field for new input after successful creation.
+     *
+     * @param {CustomEvent} event - The fieldset create group event containing group details
+     * @returns {void}
+     * @memberOf CrudFieldComponent
+     */
+    handleFieldsetCreateGroupEvent(event: CustomEvent): void;
+    /**
+     * @description Handles fieldset group update events from parent fieldsets.
+     * @summary Processes events triggered when an existing group needs to be updated.
+     * Updates the active form group index and refreshes the form group and form control
+     * references to point to the group being edited.
+     *
+     * @param {CustomEvent} event - The fieldset update group event containing update details
+     * @returns {void}
+     * @memberOf CrudFieldComponent
+     */
+    handleFieldsetUpdateGroupEvent(event: CustomEvent): void;
+    /**
+     * @description Handles fieldset group removal events from parent fieldsets.
+     * @summary Processes events triggered when a group needs to be removed from a fieldset.
+     * Removes the specified group from the form array, updates the active form group index,
+     * and refreshes the form references. Dispatches a confirmation event back to the component.
+     *
+     * @param {CustomEvent} event - The fieldset remove group event containing removal details
+     * @returns {void}
+     * @memberOf CrudFieldComponent
+     */
+    handleFieldsetRemoveGroupEvent(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; }; "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; }; "cols": { "alias": "cols"; "required": false; }; "rows": { "alias": "rows"; "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; }; "translatable": { "alias": "translatable"; "required": false; }; "uid": { "alias": "uid"; "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; }; "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; }; "cols": { "alias": "cols"; "required": false; }; "rows": { "alias": "rows"; "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; }; "translatable": { "alias": "translatable"; "required": false; }; "activeFormGroup": { "alias": "activeFormGroup"; "required": false; }; "pk": { "alias": "pk"; "required": false; }; }, {}, never, never, true, never>;
 }

package/components/crud-form/crud-form.component.d.ts

@@ -1,7 +1,7 @@
 import { ElementRef, EventEmitter, OnDestroy, OnInit } from '@angular/core';
 import { FormGroup } from '@angular/forms';
-import { FormElement } from '../../interfaces';
-import { CrudFormEvent, FieldUpdateMode, HTMLFormTarget, RenderedModel } from '../../engine';
+import { IFormElement } from '../../engine/interfaces';
+import { CrudFormEvent, FieldUpdateMode, HandlerLike, HTMLFormTarget, RenderedModel } from '../../engine';
 import { CrudFormOptions } from './types';
 import { CrudOperations, OperationKeys } from '@decaf-ts/db-decorators';
 import { Model } from '@decaf-ts/decorator-validation';
@@ -26,23 +26,120 @@ import * as i0 from "@angular/core";
  * @param {string} target - The target
  * @param {string} method - The method
  */
-export declare class CrudFormComponent implements OnInit, FormElement, OnDestroy, RenderedModel {
+export declare class CrudFormComponent implements OnInit, IFormElement, OnDestroy, RenderedModel {
     /**
      * @description Repository model for data operations.
      * @summary The data model repository that this component will use for CRUD operations.
      * This provides a connection to the data layer for retrieving and manipulating data.
      *
      * @type {Model| undefined}
+     * @memberOf CrudFormComponent
      */
     model: Model | undefined;
+    /**
+     * @description The primary data model used for CRUD operations.
+     * @summary This input provides the main Model instance that the form interacts with for
+     * creating, reading, updating, or deleting records. It serves as the source of schema
+     * and validation rules for the form fields, and is required for most operations except
+     * for certain read or delete scenarios.
+     *
+     * @type {Model | undefined}
+     * @memberOf CrudFormComponent
+     */
+    modelId: Model | undefined;
+    /**
+     * @description Field update trigger mode for form validation.
+     * @summary Determines when form field validation should be triggered. Options include
+     * 'change', 'blur', or 'submit'. This affects the user experience by controlling
+     * when validation feedback is shown to the user during form interaction.
+     *
+     * @type {FieldUpdateMode}
+     * @default 'change'
+     * @memberOf CrudFormComponent
+     */
     updateOn: FieldUpdateMode;
+    /**
+     * @description Reference to the reactive form DOM element.
+     * @summary ViewChild reference that provides direct access to the form's DOM element.
+     * This enables programmatic manipulation of the form element and access to native
+     * HTML form properties and methods when needed.
+     *
+     * @type {ElementRef}
+     * @memberOf CrudFormComponent
+     */
     component: ElementRef;
+    /**
+     * @description Form submission target specification.
+     * @summary Specifies where to display the response after form submission, similar
+     * to the HTML form target attribute. Options include '_self', '_blank', '_parent',
+     * '_top', or a named frame. Controls the browser behavior for form responses.
+     *
+     * @type {HTMLFormTarget}
+     * @default '_self'
+     * @memberOf CrudFormComponent
+     */
     target: HTMLFormTarget;
+    /**
+     * @description HTTP method or submission strategy for the form.
+     * @summary Defines how the form should be submitted. 'get' and 'post' correspond
+     * to standard HTTP methods for traditional form submission, while 'event' uses
+     * Angular event-driven submission for single-page application workflows.
+     *
+     * @type {'get' | 'post' | 'event'}
+     * @default 'event'
+     * @memberOf CrudFormComponent
+     */
     method: 'get' | 'post' | 'event';
+    /**
+     * @description Configuration options for the CRUD form behavior.
+     * @summary Contains various configuration settings that control form rendering,
+     * validation, and behavior. These options are merged with default settings
+     * during component initialization to customize the form's functionality.
+     *
+     * @type {CrudFormOptions}
+     * @memberOf CrudFormComponent
+     */
     options: CrudFormOptions;
+    /**
+     * @description Optional action identifier for form submission context.
+     * @summary Specifies a custom action name that will be included in the submit event.
+     * If not provided, defaults to the standard submit event constant. Used to
+     * distinguish between different types of form submissions within the same component.
+     *
+     * @type {string | undefined}
+     * @memberOf CrudFormComponent
+     */
     action?: string;
+    /**
+     * @description The current CRUD operation being performed.
+     * @summary Specifies the type of operation this form is handling (CREATE, READ, UPDATE, DELETE).
+     * This is a required input that determines form behavior, validation rules, and available actions.
+     * The operation affects form state, button visibility, and submission logic.
+     *
+     * @type {CrudOperations}
+     * @required
+     * @memberOf CrudFormComponent
+     */
     operation: CrudOperations;
-    handlers: Record<string, (...args: unknown[]) => unknown | Promise<unknown>>;
+    /**
+     * @description Custom event handlers for form actions.
+     * @summary A record of event handler functions keyed by event names that can be
+     * triggered during form operations. These handlers provide extensibility for
+     * custom business logic and can be invoked for various form events and actions.
+     *
+     * @type {HandlerLike}
+     * @memberOf CrudFormComponent
+     */
+    handlers: HandlerLike;
+    /**
+     * @description Angular reactive FormGroup for form state management.
+     * @summary The FormGroup instance that manages all form controls, validation,
+     * and form state. This is the main interface for accessing form values and
+     * controlling form behavior. May be undefined for read-only operations.
+     *
+     * @type {FormGroup | undefined}
+     * @memberOf CrudFormComponent
+     */
     formGroup: FormGroup | undefined;
     /**
      * @description Path to the parent FormGroup, if nested.
@@ -52,6 +149,15 @@ export declare class CrudFormComponent implements OnInit, FormElement, OnDestroy
      * @memberOf CrudFormComponent
      */
     childOf?: string;
+    /**
+     * @description Unique identifier for the form renderer.
+     * @summary A unique string identifier used to register and manage this form
+     * instance within the NgxFormService. This ID is also used as the HTML id
+     * attribute for the form element, enabling DOM queries and form management.
+     *
+     * @type {string}
+     * @memberOf CrudFormComponent
+     */
     rendererId: string;
     /**
      * @description Unique identifier for the current record.
@@ -59,8 +165,42 @@ export declare class CrudFormComponent implements OnInit, FormElement, OnDestroy
      * This is typically used in conjunction with the primary key for operations on specific records.
      *
      * @type {string | number}
+     * @memberOf CrudFormComponent
+     */
+    uid: string;
+    /**
+     * @description Unique identifier for the current record instance.
+     * @summary This property holds a unique string value that identifies the specific record being managed by the form.
+     * It is automatically generated if not provided, ensuring each form instance has a distinct identifier.
+     * The uid is used for tracking, referencing, and emitting events related to the current record, and may be used
+     * in conjunction with the primary key for CRUD operations.
+     *
+     * @type {string}
+     * @default Randomly generated 12-character string
+     * @memberOf CrudFormComponent
+     */
+    allowClear: boolean;
+    /**
+     * @description Reference to CRUD operation constants for template usage.
+     * @summary Exposes the OperationKeys enum to the component template, enabling
+     * conditional rendering and behavior based on operation types. This protected
+     * readonly property ensures that template logic can access operation constants
+     * while maintaining encapsulation and preventing accidental modification.
+     *
+     * @protected
+     * @readonly
+     * @memberOf CrudFormComponent
+     */
+    protected readonly OperationKeys: typeof OperationKeys;
+    /**
+     * @description Event emitter for form submission events.
+     * @summary Emits CrudFormEvent objects when the form is submitted, providing
+     * form data, component information, and any associated handlers to parent
+     * components. This enables decoupled handling of form submission logic.
+     *
+     * @type {EventEmitter<CrudFormEvent>}
+     * @memberOf CrudFormComponent
      */
-    uid: string | number | undefined;
     submitEvent: EventEmitter<CrudFormEvent>;
     /**
      * @description Logger instance for the component.
@@ -88,15 +228,61 @@ export declare class CrudFormComponent implements OnInit, FormElement, OnDestroy
      * @memberOf CrudFormComponent
      */
     private location;
+    /**
+     * @description Component initialization lifecycle method.
+     * @summary Initializes the component by setting up the logger, configuring form state
+     * based on the operation type, and merging configuration options. For READ and DELETE
+     * operations, the formGroup is set to undefined since these operations don't require
+     * form input. Configuration options are merged with default settings.
+     *
+     * @returns {Promise<void>}
+     * @memberOf CrudFormComponent
+     */
     ngOnInit(): Promise<void>;
+    /**
+     * @description Component cleanup lifecycle method.
+     * @summary Performs cleanup operations when the component is destroyed.
+     * Unregisters the FormGroup from the NgxFormService to prevent memory leaks
+     * and ensure proper resource cleanup.
+     *
+     * @returns {void}
+     * @memberOf CrudFormComponent
+     */
     ngOnDestroy(): void;
     /**
-     * @param  {SubmitEvent} event
+     * @description Handles form submission with validation and event emission.
+     * @summary Processes form submission by first preventing default browser behavior,
+     * then validating all form fields using NgxFormService. If validation passes,
+     * extracts form data and emits a submitEvent with the data, component information,
+     * and any associated handlers. Returns false if validation fails.
+     *
+     * @param {SubmitEvent} event - The browser's native form submit event
+     * @returns {Promise<boolean | void>} Returns false if validation fails, void if successful
+     * @memberOf CrudFormComponent
      */
     submit(event: SubmitEvent): Promise<boolean | void>;
+    /**
+     * @description Handles form reset or navigation back functionality.
+     * @summary Provides different reset behavior based on the current operation.
+     * For CREATE and UPDATE operations, resets the form to its initial state.
+     * For READ and DELETE operations, navigates back in the browser history
+     * since these operations don't have modifiable form data to reset.
+     *
+     * @returns {void}
+     * @memberOf CrudFormComponent
+     */
     handleReset(): void;
+    /**
+     * @description Handles delete operations by emitting delete events.
+     * @summary Processes delete requests by emitting a submit event with the
+     * record's unique identifier as data. This allows parent components to
+     * handle the actual deletion logic while maintaining separation of concerns.
+     * The event includes the uid and standard component identification.
+     *
+     * @returns {void}
+     * @memberOf CrudFormComponent
+     */
     handleDelete(): void;
-    protected readonly OperationKeys: typeof OperationKeys;
     static ɵfac: i0.ɵɵFactoryDeclaration<CrudFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFormComponent, "ngx-decaf-crud-form", never, { "model": { "alias": "model"; "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; }; "childOf": { "alias": "childOf"; "required": false; }; "rendererId": { "alias": "rendererId"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; }, { "submitEvent": "submitEvent"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CrudFormComponent, "ngx-decaf-crud-form", never, { "model": { "alias": "model"; "required": false; }; "modelId": { "alias": "modelId"; "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; }; "childOf": { "alias": "childOf"; "required": false; }; "rendererId": { "alias": "rendererId"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "allowClear": { "alias": "allowClear"; "required": false; }; }, { "submitEvent": "submitEvent"; }, never, ["*"], true, never>;
 }

package/components/empty-state/empty-state.component.d.ts

@@ -1,5 +1,4 @@
 import { OnInit } from '@angular/core';
-import { Color, PredefinedColors } from '@ionic/core';
 import { StringOrBoolean } from '../../engine';
 import { NgxBaseComponent } from '../../engine/NgxBaseComponent';
 import { SafeHtml } from '@angular/platform-browser';
@@ -23,14 +22,14 @@ import * as i0 from "@angular/core";
  *     +StringOrBoolean showIcon
  *     +string icon
  *     +string iconSize
- *     +PredefinedColors iconColor
+ *     +string iconColor
  *     +string|Function buttonLink
  *     +string buttonText
  *     +string buttonFill
- *     +Color buttonColor
+ *     +string buttonColor
  *     +string buttonSize
  *     +string searchValue
- *     -NavController navController
+ *     -Router Router
  *     +ngOnInit()
  *     +handleClick()
  *   }
@@ -125,7 +124,7 @@ export declare class EmptyStateComponent extends NgxBaseComponent implements OnI
      * @default 'medium'
      * @memberOf EmptyStateComponent
      */
-    iconColor?: PredefinedColors;
+    iconColor?: string;
     /**
      * @description The navigation target or action for the button.
      * @summary Specifies where the button should navigate to when clicked or what function
@@ -162,11 +161,11 @@ export declare class EmptyStateComponent extends NgxBaseComponent implements OnI
      * @summary Specifies the color for the button using Ionic's color system.
      * This allows the button to match the application's color scheme.
      *
-     * @type {Color}
+     * @type {string}
      * @default 'primary'
      * @memberOf EmptyStateComponent
      */
-    buttonColor: Color;
+    buttonColor: string;
     /**
      * @description The size of the action button.
      * @summary Controls the size of the button shown in the empty state.
@@ -193,10 +192,10 @@ export declare class EmptyStateComponent extends NgxBaseComponent implements OnI
      * This service is used when the buttonLink is a string URL to navigate to that location.
      *
      * @private
-     * @type {NavController}
+     * @type {Router}
      * @memberOf EmptyStateComponent
      */
-    private navController;
+    private router;
     private sanitizer;
     private translate;
     searchSubtitle: SafeHtml;
@@ -249,7 +248,7 @@ export declare class EmptyStateComponent extends NgxBaseComponent implements OnI
      * sequenceDiagram
      *   participant U as User
      *   participant E as EmptyStateComponent
-     *   participant N as NavController
+     *   participant N as Router
      *
      *   U->>E: Click action button
      *   E->>E: handleClick()