@decaf-ts/for-angular 0.0.45 → 0.0.47

package/index.d.ts

@@ -5,20 +5,21 @@ import { TextFieldTypes, SelectInterface, AutocompleteTypes, CheckboxCustomEvent
 import * as i2 from '@angular/forms';
 import { FormGroup, FormControl, FormArray, ControlValueAccessor, AbstractControl } from '@angular/forms';
 import { OrderDirection, Repository, Adapter, EventIds, Paginator, Condition } from '@decaf-ts/core';
-import { FieldProperties, IPagedComponentProperties, CrudOperationKeys, HTML5InputTypes, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, RenderingEngine } from '@decaf-ts/ui-decorators';
+import { FieldProperties, IPagedComponentProperties, CrudOperationKeys, UIFunctionLike, HTML5InputTypes, DecafComponent, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, RenderingEngine } from '@decaf-ts/ui-decorators';
 import * as _decaf_ts_decorator_validation from '@decaf-ts/decorator-validation';
-import { Model, VALIDATION_PARENT_KEY, Constructor, ModelConstructor } from '@decaf-ts/decorator-validation';
-import { RepositoryFlags, Context, CrudOperations, OperationKeys } from '@decaf-ts/db-decorators';
+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 { Constructor } from '@decaf-ts/decoration';
 import { Router } from '@angular/router';
 import * as i1 from '@angular/common';
 import { Location } from '@angular/common';
 import * as i3 from '@ngx-translate/core';
 import { TranslateService, TranslateLoader, TranslationObject, TranslateParser, RootTranslateServiceConfig } from '@ngx-translate/core';
-import { LoggedClass, Logger } from '@decaf-ts/logging';
 import { HttpClient } from '@angular/common/http';
 import { Observable, Subscription } from 'rxjs';
 import { SafeHtml, DomSanitizer, Title } from '@angular/platform-browser';
+import { LoggedClass, Logger } from '@decaf-ts/logging';
 import { InjectablesRegistry } from '@decaf-ts/injectable-decorators';
 
 /**
@@ -490,7 +491,7 @@ interface IFileUploadError {
  * @memberOf module:lib/engine/constants
  */
 declare const AngularEngineKeys: {
-    readonly REFLECT: `${string}.angular.`;
+    readonly REFLECT: "angular";
     readonly DYNAMIC: "dynamic-component";
     readonly ANNOTATIONS: "__annotations__";
     readonly ECMP: "ecmp";
@@ -769,7 +770,6 @@ declare const ListItemPositions: {
  * @link {@link KeyValue}
  */
 
-type HandlerLike = Record<string, (...args: unknown[]) => unknown | Promise<unknown>>;
 interface RawQuery<M extends Model> {
     select: undefined | (keyof M)[];
     from: Constructor<M>;
@@ -796,7 +796,7 @@ type KeyValue = Record<string, any>;
  * @typedef FunctionLike
  * @memberOf module:engine
  */
-type FunctionLike = (...args: any[]) => any;
+type FunctionLike = UIFunctionLike;
 /**
  * @description Element size options for UI components
  * @summary Defines the possible size values that can be applied to UI elements.
@@ -804,7 +804,7 @@ type FunctionLike = (...args: any[]) => any;
  * @typedef ElementSize
  * @memberOf module:engine
  */
-type ElementSize = typeof ElementSizes[keyof typeof ElementSizes];
+type ElementSize = (typeof ElementSizes)[keyof typeof ElementSizes];
 /**
  * @description Basic position options for UI elements
  * @summary Defines the possible position values that can be applied to UI elements.
@@ -812,7 +812,7 @@ type ElementSize = typeof ElementSizes[keyof typeof ElementSizes];
  * @typedef {('left'|'center'|'right'|'top'|'bottom')} ElementPosition
  * @memberOf module:engine
  */
-type ElementPosition = typeof ElementPositions[keyof typeof ElementPositions];
+type ElementPosition = (typeof ElementPositions)[keyof typeof ElementPositions];
 /**
  * @description Extended position options for flex layouts
  * @summary Extends the basic ElementPosition with additional flex-specific position values.
@@ -831,7 +831,7 @@ type FlexPosition = ElementPosition | 'stretch' | 'middle' | 'around' | 'between
  * @memberOf module:engine
  */
 type FieldUpdateMode = 'change' | 'blur' | 'submit';
-type HTML5InputType = typeof HTML5InputTypes[keyof typeof HTML5InputTypes];
+type HTML5InputType = (typeof HTML5InputTypes)[keyof typeof HTML5InputTypes];
 /**
  * @description Possible input types for form fields
  * @summary Defines the possible input types that can be used in form fields.
@@ -945,28 +945,28 @@ type I18nResourceConfigType = I18nResourceConfig | I18nResourceConfig[];
  * @typedef {typeof WindowColorSchemes[keyof typeof WindowColorSchemes]} WindowColorScheme
  * @memberOf module:lib/engine/types
  */
-type WindowColorScheme = typeof WindowColorSchemes[keyof typeof WindowColorSchemes];
+type WindowColorScheme = (typeof WindowColorSchemes)[keyof typeof WindowColorSchemes];
 /**
  * @description Represents the possible roles for an action.
  * @summary This type is derived from the `ActionRoles` constant, allowing only its defined keys as values.
  * @typedef {typeof ActionRoles[keyof typeof ActionRoles]} ActionRole
  * @memberOf module:lib/engine/types
  */
-type ActionRole = typeof ActionRoles[keyof typeof ActionRoles];
+type ActionRole = (typeof ActionRoles)[keyof typeof ActionRoles];
 /**
  * @description Represents the possible grid gap values for a layout.
  * @summary This type is derived from the `LayoutGridGaps` constant, allowing only its defined keys as values.
  * @typedef {typeof LayoutGridGaps[keyof typeof LayoutGridGaps]} LayoutGridGap
  * @memberOf module:lib/engine/types
  */
-type LayoutGridGap = typeof LayoutGridGaps[keyof typeof LayoutGridGaps];
+type LayoutGridGap = (typeof LayoutGridGaps)[keyof typeof LayoutGridGaps];
 /**
  * @description Represents the possible positions for a list item.
  * @summary This type is derived from the `ListItemPositions` constant, allowing only its defined keys as values.
  * @typedef {typeof ListItemPositions[keyof typeof ListItemPositions]} ListItemPosition
  * @memberOf module:lib/engine/types
  */
-type ListItemPosition = typeof ListItemPositions[keyof typeof ListItemPositions];
+type ListItemPosition = (typeof ListItemPositions)[keyof typeof ListItemPositions];
 
 /**
  * @module NgxMediaService
@@ -1225,7 +1225,7 @@ declare class NgxMediaService {
  * @implements {OnChanges}
  * @memberOf module:lib/engine/NgxComponentDirective
  */
-declare abstract class NgxComponentDirective extends LoggedClass implements OnChanges, OnDestroy {
+declare abstract class NgxComponentDirective extends DecafComponent implements OnChanges, OnDestroy {
     /**
      * @description Reference to the component's native DOM element.
      * @summary Provides direct access to the native DOM element of the component through Angular's
@@ -1325,11 +1325,11 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @summary Defines how fields from the data model should be mapped to properties used by the component.
      * This allows for flexible data binding between the model and the component's display logic. Can be
      * provided as a static object mapping or as a function for dynamic mapping transformations.
-     * @type {Record<string, string> | FunctionLike}
+     * @type {Record<string, string> | FunctionLike | Record<string, FunctionLike>}
      * @default {}
      * @memberOf module:lib/engine/NgxComponentDirective
      */
-    mapper: Record<string, string> | FunctionLike;
+    mapper: Record<string, string> | FunctionLike | Record<string, FunctionLike>;
     /**
      * @description Available CRUD operations for this component instance.
      * @summary Defines which CRUD operations (Create, Read, Update, Delete) are available
@@ -1383,17 +1383,6 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @memberOf module:lib/engine/NgxComponentDirective
      */
     className: string;
-    /**
-     * @description Repository instance for data layer operations.
-     * @summary Provides a connection to the data layer for retrieving and manipulating data.
-     * This is an instance of the DecafRepository class, initialized lazily in the repository getter.
-     * The repository is used to perform CRUD (Create, Read, Update, Delete) operations on the
-     * data model and provides methods for querying and filtering data based on specific criteria.
-     * @type {DecafRepository<Model>}
-     * @private
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    protected _repository?: DecafRepository<Model>;
     /**
      * @description Angular change detection service for manual change detection control.
      * @summary Injected service that provides manual control over change detection cycles.
@@ -1438,17 +1427,6 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @memberOf module:lib/engine/NgxComponentDirective
      */
     protected translateService: TranslateService;
-    /**
-     * @description Logger instance for structured component logging.
-     * @summary Provides logging capabilities for the component, allowing for consistent
-     * and structured logging of information, warnings, and errors. This logger is inherited
-     * from the LoggedClass and provides access to structured logging functionality.
-     * The logger is used throughout the component to record important events, debug information,
-     * and potential issues, facilitating easier debugging and maintenance.
-     * @type {Logger}
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    logger: Logger;
     /**
      * @description Event emitter for custom component events.
      * @summary Emits custom events that occur within child components or the component itself.
@@ -1486,7 +1464,7 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * and other properties needed to render list items correctly. The tag property
      * identifies which component should be used to render each item in a list.
      * Additional properties can be included to customize the rendering behavior.
-     * @type {Record<string, unknown>}
+     * @type {Record<string, FieldDefinition>}
      * @default {tag: ""}
      * @memberOf module:lib/engine/NgxComponentDirective
      */
@@ -1513,16 +1491,6 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @memberOf module:lib/engine/NgxComponentDirective
      */
     route?: string;
-    /**
-     * @description Initialization status flag for the component.
-     * @summary Tracks whether the component has completed its initialization process.
-     * This flag is used to prevent duplicate initialization and to determine if
-     * certain operations that require initialization can be performed.
-     * @type {boolean}
-     * @default false
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    initialized: boolean;
     /**
      * @description Controls whether borders are displayed around the component.
      * @summary Boolean flag that determines if the component should be visually outlined with borders.
@@ -1532,42 +1500,14 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @default false
      */
     borders: boolean;
-    /**
-     * @description Component name identifier for logging and localization contexts.
-     * @summary Stores the component's name which is used as a key for logging contexts
-     * and as a base for locale resolution. Can be injected via the CPTKN token or defaults
-     * to "NgxComponentDirective" if not provided.
-     * @protected
-     * @type {string | undefined}
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    protected componentName?: string;
-    /**
-     * @description Root key for component locale context resolution.
-     * @summary Defines the base key used to resolve localization contexts for this component.
-     * If not explicitly provided, it defaults to the component's name. This key is used to
-     * load appropriate translation resources and locale-specific configurations.
-     * @protected
-     * @type {string | undefined}
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    protected localeRoot?: string;
-    /**
-     * @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 module:lib/engine/NgxComponentDirective
-     */
-    protected readonly OperationKeys: typeof OperationKeys;
     /**
      * @description Angular Location service.
-     * @summary Injected service that provides access to the browser's URL and history.
-     * This service is used for interacting with the browser's history API, allowing
-     * for back navigation and URL manipulation outside of Angular's router.
+     * @summary Injected service that provides direct access to the browser's URL and history.
+     * Unlike the Router, Location allows for low-level manipulation of the browser's history stack
+     * and URL path, such as programmatically navigating back or forward, or updating the URL without
+     * triggering a route change. This is useful for scenarios where you need to interact with the
+     * browser history or URL outside of Angular's routing system, such as closing modals, handling
+     * popstate events, or supporting custom navigation logic.
      *
      * @private
      * @type {Location}
@@ -1586,6 +1526,8 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @memberOf module:lib/engine/NgxComponentDirective
      */
     isModalChild: boolean;
+    protected handlers: Record<string, UIFunctionLike>;
+    protected events: Record<string, UIFunctionLike>;
     /**
      * @description Constructor for NgxComponentDirective.
      * @summary Initializes the directive by setting up the component name, locale root,
@@ -1624,7 +1566,7 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @throws {InternalError} If repository initialization fails
      * @memberOf module:lib/engine/NgxComponentDirective
      */
-    protected get repository(): DecafRepository<Model>;
+    protected get repository(): DecafRepository<Model> | undefined;
     /**
      * @description Angular lifecycle hook for handling input property changes.
      * @summary Responds to changes in component input properties, specifically monitoring changes
@@ -1635,7 +1577,7 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @return {void}
      * @memberOf module:lib/engine/NgxComponentDirective
      */
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(changes: SimpleChanges): Promise<void>;
     /**
      * @description Translates text phrases using the translation service.
      * @summary Provides a promise-based wrapper around the translation service to translate
@@ -1649,18 +1591,6 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      * @memberOf module:lib/engine/NgxComponentDirective
      */
     protected translate(phrase: string | string[], params?: object | string): Promise<string>;
-    /**
-     * @description Initializes the component asynchronously with custom logic.
-     * @summary Abstract initialization method that can be overridden by child components to perform
-     * custom initialization logic. By default, it simply sets the initialized flag to true.
-     * Child components can extend this method to load data, configure settings, or perform
-     * other setup operations required before the component is fully functional.
-     * @protected
-     * @param {...unknown[]} args - Variable number of arguments that can be used by child implementations
-     * @return {Promise<void>} A promise that resolves when initialization is complete
-     * @memberOf module:lib/engine/NgxComponentDirective
-     */
-    protected initialize(...args: unknown[]): Promise<void>;
     protected checkDarkMode(): void;
     /**
      * @description Retrieves or sets the locale context for the component.
@@ -1845,7 +1775,7 @@ declare abstract class NgxComponentDirective extends LoggedClass implements OnCh
      */
     changeOperation(operation: string, id?: string): Promise<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxComponentDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxComponentDirective, never, never, { "enableDarkMode": { "alias": "enableDarkMode"; "required": false; }; "isDarkMode": { "alias": "isDarkMode"; "required": false; }; "name": { "alias": "name"; "required": false; }; "childOf": { "alias": "childOf"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "model": { "alias": "model"; "required": false; }; "modelId": { "alias": "modelId"; "required": false; }; "pk": { "alias": "pk"; "required": false; }; "mapper": { "alias": "mapper"; "required": false; }; "operations": { "alias": "operations"; "required": false; }; "operation": { "alias": "operation"; "required": false; }; "row": { "alias": "row"; "required": false; }; "col": { "alias": "col"; "required": false; }; "className": { "alias": "className"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "item": { "alias": "item"; "required": false; }; "props": { "alias": "props"; "required": false; }; "route": { "alias": "route"; "required": false; }; "borders": { "alias": "borders"; "required": false; }; "isModalChild": { "alias": "isModalChild"; "required": false; }; }, { "listenEvent": "listenEvent"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NgxComponentDirective, never, never, { "enableDarkMode": { "alias": "enableDarkMode"; "required": false; }; "isDarkMode": { "alias": "isDarkMode"; "required": false; }; "name": { "alias": "name"; "required": false; }; "childOf": { "alias": "childOf"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "model": { "alias": "model"; "required": false; }; "modelId": { "alias": "modelId"; "required": false; }; "pk": { "alias": "pk"; "required": false; }; "mapper": { "alias": "mapper"; "required": false; }; "operations": { "alias": "operations"; "required": false; }; "operation": { "alias": "operation"; "required": false; }; "row": { "alias": "row"; "required": false; }; "col": { "alias": "col"; "required": false; }; "className": { "alias": "className"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "item": { "alias": "item"; "required": false; }; "props": { "alias": "props"; "required": false; }; "route": { "alias": "route"; "required": false; }; "borders": { "alias": "borders"; "required": false; }; "isModalChild": { "alias": "isModalChild"; "required": false; }; "handlers": { "alias": "handlers"; "required": false; }; "events": { "alias": "events"; "required": false; }; }, { "listenEvent": "listenEvent"; }, never, never, true, never>;
 }
 
 declare class NgxRenderableComponentDirective extends NgxComponentDirective implements OnChanges, OnDestroy, IRenderedModel {
@@ -2414,7 +2344,7 @@ declare abstract class NgxFormFieldDirective extends NgxComponentDirective imple
      * @return {void}
      * @public
      */
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(changes: SimpleChanges): Promise<void>;
     /**
      * @description Cleanup logic when the component is destroyed.
      * @summary Unregisters the form group from the form service to prevent memory leaks
@@ -2667,7 +2597,7 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
      * @type {boolean}
      * @memberOf CrudFieldComponent
      */
-    readonly?: boolean;
+    readonly: boolean;
     /**
      * @description Whether the field is required.
      * @summary When true, the field must have a value for the form to be valid.
@@ -2951,10 +2881,10 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
      * This ensures proper initialization of read-only fields that don't require
      * form functionality but still need view setup.
      *
-     * @returns {void}
+     * @returns {Promise<void>}
      * @memberOf CrudFieldComponent
      */
-    ngAfterViewInit(): void;
+    ngAfterViewInit(): Promise<void>;
     /**
      * @description Component cleanup lifecycle method.
      * @summary Performs cleanup operations for READ and DELETE operations by calling
@@ -3004,12 +2934,12 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
  */
 declare class NgxParentComponentDirective extends NgxComponentDirective implements OnInit {
     /**
-   * @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}
-   */
+     * @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}
+     */
     page: number;
     /**
      * @description Unique identifier for the current record.
@@ -3238,9 +3168,9 @@ declare abstract class NgxFormDirective extends NgxParentComponentDirective impl
      * triggered during form operations. These handlers provide extensibility for
      * custom business logic and can be invoked for various form events and actions.
      *
-     * @type {HandlerLike}
+     * @type {Record<string, UIFunctionLike>}
      */
-    handlers: HandlerLike;
+    handlers: Record<string, UIFunctionLike>;
     /**
      * @description Angular reactive FormGroup for form state management.
      * @summary The FormGroup instance that manages all form controls, validation,
@@ -3292,7 +3222,7 @@ declare abstract class NgxFormDirective extends NgxParentComponentDirective impl
     * @returns {Promise<void>}
     */
     ngOnInit(model?: Model | string): Promise<void>;
-    ngAfterViewInit(): void;
+    ngAfterViewInit(): Promise<void>;
     /**
      * @description Component cleanup lifecycle method.
      * @summary Performs cleanup operations when the component is destroyed.
@@ -3394,10 +3324,10 @@ declare class CrudFormComponent extends NgxFormDirective {
  * @param {string} title - Primary title text displayed in the card header.
  * @param {('small'|'default'|'blank')} body - Body size preset controlling padding/typography; defaults to 'default'.
  * @param {string} subtitle - Optional subtitle rendered under the title.
- * @param {import('@ionic/core').Color} color - Ionic color token applied to the card header/title.
+ * @param {Color} color - Ionic color token applied to the card header/title.
  * @param {boolean} separator - When true, renders a divider between header and body.
  * @param {boolean} borders - Controls whether borders are rendered; defaults to true.
- * @param {string|import('@angular/platform-browser').SafeHtml} inlineContent - Inline HTML/SafeHtml to render inside the body.
+ * @param {string|SafeHtml} inlineContent - Inline HTML/SafeHtml to render inside the body.
  * @param {('top'|'bottom')} inlineContentPosition - Where to render `inlineContent` relative to the body; defaults to 'bottom'.
  * @return {void}
  * @class CardComponent
@@ -3457,7 +3387,7 @@ declare class CardComponent extends NgxComponentDirective implements OnInit {
     /**
      * @description Ionic color token applied to the card.
      * @summary When provided, the color token (for example 'primary' or 'tertiary') is applied to title/header elements where supported.
-     * @type {import('@ionic/core').Color}
+     * @type {Color}
      * @default ''
      */
     color: Color;
@@ -3478,7 +3408,7 @@ declare class CardComponent extends NgxComponentDirective implements OnInit {
     /**
      * @description Inline HTML or SafeHtml content to render inside the card body.
      * @summary Useful for short snippets of rich content provided by the consumer. When passing raw HTML prefer `SafeHtml` to avoid sanitization issues.
-     * @type {string|import('@angular/platform-browser').SafeHtml}
+     * @type {string|SafeHtml}
      */
     inlineContent?: string | SafeHtml;
     /**
@@ -4122,35 +4052,35 @@ declare class FieldsetComponent extends NgxFormDirective implements OnInit, Afte
      */
     ngOnInit(): Promise<void>;
     /**
-    * @description Initializes the component state after view and child components are rendered.
-    * @summary This lifecycle hook implements intelligent auto-state management based on the current
-    * CRUD operation. For READ and DELETE operations, the fieldset automatically opens to provide
-    * immediate access to information, while CREATE and UPDATE operations keep it closed to maintain
-    * a clean initial interface. The method directly manipulates the DOM to ensure proper accordion
-    * synchronization and triggers change detection to reflect the programmatic state changes.
-    *
-    * @mermaid
-    * sequenceDiagram
-    *   participant A as Angular Lifecycle
-    *   participant F as FieldsetComponent
-    *   participant D as DOM
-    *   participant C as ChangeDetector
-    *
-    *   A->>F: ngAfterViewInit()
-    *   alt operation is READ or DELETE
-    *     F->>F: Set isOpen = true
-    *     F->>D: Query ion-accordion-group element
-    *     alt accordion element exists
-    *       F->>D: Set value attribute to 'open'
-    *     end
-    *   end
-    *   F->>C: detectChanges()
-    *   C->>F: Update view with new state
-    *
-    * @returns {void}
-    * @memberOf FieldsetComponent
-    */
-    ngAfterViewInit(): void;
+     * @description Initializes the component state after view and child components are rendered.
+     * @summary This lifecycle hook implements intelligent auto-state management based on the current
+     * CRUD operation. For READ and DELETE operations, the fieldset automatically opens to provide
+     * immediate access to information, while CREATE and UPDATE operations keep it closed to maintain
+     * a clean initial interface. The method directly manipulates the DOM to ensure proper accordion
+     * synchronization and triggers change detection to reflect the programmatic state changes.
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant A as Angular Lifecycle
+     *   participant F as FieldsetComponent
+     *   participant D as DOM
+     *   participant C as ChangeDetector
+     *
+     *   A->>F: ngAfterViewInit()
+     *   alt operation is READ or DELETE
+     *     F->>F: Set isOpen = true
+     *     F->>D: Query ion-accordion-group element
+     *     alt accordion element exists
+     *       F->>D: Set value attribute to 'open'
+     *     end
+     *   end
+     *   F->>C: detectChanges()
+     *   C->>F: Update view with new state
+     *
+     * @returns {Promise<void>}
+     * @memberOf FieldsetComponent
+     */
+    ngAfterViewInit(): Promise<void>;
     /**
      * @description Handles removal of the fieldset with slide animation.
      * @summary Initiates the removal process for the fieldset with a smooth slide-up animation.
@@ -6027,7 +5957,7 @@ declare class ListItemComponent extends NgxComponentDirective implements OnInit,
      * @memberOf ListItemComponent
      */
     ngOnInit(): Promise<void>;
-    ngAfterViewInit(): void;
+    ngAfterViewInit(): Promise<void>;
     /**
      * @description Handles user interactions and actions performed on the list item.
      * @summary This method is the central action handler for list item interactions. It manages
@@ -6234,7 +6164,7 @@ declare class ModelRendererComponent<M extends Model> extends NgxRenderableCompo
      * @description Lifecycle hook that is called when data-bound properties of a directive change
      * @param {SimpleChanges} changes - Object containing changes
      */
-    ngOnChanges(changes: SimpleChanges): void;
+    ngOnChanges(changes: SimpleChanges): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<ModelRendererComponent<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ModelRendererComponent<any>, "ngx-decaf-model-renderer", never, { "projectable": { "alias": "projectable"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -7303,7 +7233,7 @@ declare function presentNgxLightBoxModal(inlineContent: string | SafeHtml, props
  */
 declare function getNgxSelectOptionsModal(options: SelectOption[], injector?: EnvironmentInjector): Promise<IonModal>;
 
-declare class IconComponent implements OnInit, AfterViewInit {
+declare class IconComponent implements OnInit {
     /** @description Reference to the component's native DOM element.
      * @summary Provides direct access to the native DOM element of the component through Angular's
      * ViewChild decorator. This reference can be used to manipulate the DOM element directly,
@@ -7329,7 +7259,6 @@ declare class IconComponent implements OnInit, AfterViewInit {
     mediaService: NgxMediaService;
     constructor();
     ngOnInit(): void;
-    ngAfterViewInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<IconComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<IconComponent, "ngx-decaf-icon", never, { "name": { "alias": "name"; "required": false; }; "color": { "alias": "color"; "required": false; }; "slot": { "alias": "slot"; "required": false; }; "button": { "alias": "button"; "required": false; }; "buttonFill": { "alias": "buttonFill"; "required": false; }; "buttonShape": { "alias": "buttonShape"; "required": false; }; "width": { "alias": "width"; "required": false; }; "size": { "alias": "size"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; }, {}, never, never, true, never>;
 }
@@ -7719,7 +7648,7 @@ declare class ForAngularComponentsModule {
  *   end
  * @category Decorators
  */
-declare function Dynamic(): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor) => void;
+declare function Dynamic(): (target: object, propertyKey?: string | symbol | unknown, descriptor?: PropertyDescriptor | number) => void;
 
 /**
  * @description Abstract base class for dynamic Angular modules
@@ -8001,18 +7930,6 @@ declare class NgxRenderingEngine extends RenderingEngine<AngularFieldDefinition,
      * @memberOf module:lib/engine/NgxRenderingEngine
      */
     static components(selector?: string): object | string[];
-    /**
-     * @description Generates a key for reflection metadata storage.
-     * @summary This static method generates a key for reflection metadata by prefixing the input key
-     * with the Angular engine's reflection prefix. This is used for storing and retrieving
-     * metadata in a namespaced way to avoid conflicts with other metadata.
-     * @param {string} key - The base key to prefix
-     * @return {string} The prefixed key for reflection metadata
-     * @static
-     * @override
-     * @memberOf module:lib/engine/NgxRenderingEngine
-     */
-    static key(key: string): string;
     /**
      * @description Sets input properties on a component instance.
      * @summary This static utility method sets input properties on a component instance
@@ -8847,7 +8764,7 @@ declare abstract class NgxModelPageDirective extends NgxPageDirective {
      *
      * @throws {InternalError} When the model is not found in the registry
      */
-    protected get repository(): DecafRepository<Model>;
+    protected get repository(): DecafRepository<Model> | undefined;
     /**
      * @description Angular lifecycle hook for component initialization.
      * @summary Initializes the component by setting up the logger instance using the getLogger
@@ -8897,7 +8814,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): 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.
@@ -9481,15 +9398,18 @@ declare function provideDynamicComponents(...components: Constructor<unknown>[])
  * @memberOf module:lib/for-angular-common.module
  * @example
  * // Get repository by model class
- * const userRepo = getModelRepository(User);
+ * const userRepo = getModelAndRepository(User);
  *
  * // Get repository by model name
- * const productRepo = getModelRepository('Product');
+ * const productRepo = getModelAndRepository('Product');
  *
  * // Use repository for queries
  * const users = await userRepo.findAll();
  */
-declare function getModelRepository(model: Model | string): DecafRepository<Model>;
+declare function getModelAndRepository(model: Model | string): {
+    repository: DecafRepository<Model>;
+    model: Model;
+} | undefined;
 /**
  * @description Provides a database adapter for dependency injection.
  * @summary Creates an Angular provider that registers a database adapter instance. This function
@@ -9576,5 +9496,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, getModelRepository, getNgxModalComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxLightBoxModal, provideDbAdapter, 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, HandlerLike, 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 };
+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, getNgxModalComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxLightBoxModal, provideDbAdapter, 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.45",
+  "version": "0.0.47",
   "author": "Tiago Venceslau and Contributors",
   "license": "MPL-2.0 OR AGPL-3.0",
   "repository": {
@@ -20,14 +20,13 @@
     "@angular/platform-browser": "^20.2.4",
     "@angular/platform-browser-dynamic": "^20.2.4",
     "@angular/router": "^20.2.4",
-    "@decaf-ts/core": "0.5.45",
+    "@decaf-ts/core": "latest",
     "@decaf-ts/db-decorators": "latest",
     "@decaf-ts/decoration": "latest",
     "@decaf-ts/decorator-validation": "latest",
     "@decaf-ts/for-http": "latest",
     "@decaf-ts/injectable-decorators": "latest",
-    "@decaf-ts/logging": "^0.9.1",
-    "@decaf-ts/reflection": "latest",
+    "@decaf-ts/logging": "latest",
     "@decaf-ts/styles": "latest",
     "@decaf-ts/transactional-decorators": "latest",
     "@decaf-ts/ui-decorators": "latest",