@decaf-ts/for-angular 0.0.17 → 0.0.18

package/assets/i18n/en.json

@@ -24,78 +24,6 @@
     "greaterThan": "This field must be greater than field {0}",
     "greaterThanOrEqual": "This field must be greater than or equal to field {0}"
   },
-  "login": {
-    "username": {
-      "label": "Username",
-      "placeholder": "Type your username"
-    },
-    "password": {
-      "label": "Password",
-      "placeholder": "Type your password"
-    }
-  },
-  "demo": {
-    "id": {
-      "label": "id",
-      "placeholder": "Type a number"
-    },
-    "name": {
-      "label": "Name",
-      "placeholder": "Type your name"
-    },
-    "birthdate": {
-      "label": "Birthdate"
-    },
-    "email": {
-      "label": "E-mail",
-      "placeholder": "Type your e-mail address"
-    },
-    "website": {
-      "label": "Website",
-      "placeholder": "Type your favorite website"
-    },
-    "password": {
-      "label": "Password",
-      "placeholder": "Type your password"
-    },
-    "gender": {
-      "label": "Select your gender"
-    },
-    "agree": {
-      "label": "I accept the terms and conditions."
-    }
-  },
-  "category": {
-    "name": {
-      "label": "Category name",
-      "placeholder": "Type the category"
-    },
-    "description": {
-      "label": "Category Description",
-      "placeholder": "Describe the category (optional)"
-    },
-    "created": {
-      "label": "Creation date",
-      "placeholder": "Select the creation date"
-    }
-  },
-  "employee": {
-    "name": {
-      "label": "Employee name",
-      "placeholder": "Type the employee name"
-    },
-    "occupation": {
-      "label": "Employee occupation"
-    }
-  },
-  "user": {
-    "secret": {
-      "label": "Password"
-    },
-    "username": {
-      "label": "Username"
-    }
-  },
   "component": {
     "fieldset": {
       "add": "Add another",
@@ -144,7 +72,9 @@
       "select": "Filter selection",
       "step1": "Select an index",
       "step2": "Select a condition",
-      "step3": "Type a value"
+      "step3": "Type a value",
+      "no_suggestions": "No suggestions",
+      "sort": "Sort by"
     }
   }
 }

package/assets/i18n/pt.json

@@ -24,83 +24,12 @@
     "greaterThan": "Este campo deve ser superior ao campo {0}",
     "greaterThanOrEqual": "Este campo deve ser superior ou igual ao campo {0}"
   },
-  "login": {
-    "username": {
-      "label": "Nome de utilizador",
-      "placeholder": "Escreva o seu nome de utilizador"
-    },
-    "password": {
-      "label": "Palavra-passe",
-      "placeholder": "Escreva a sua palavra-passe"
-    }
-  },
-  "demo": {
-    "id": {
-      "label": "ID",
-      "placeholder": "Escreva um número"
-    },
-    "name": {
-      "label": "Nome",
-      "placeholder": "Escreva o seu nome"
-    },
-    "birthdate": {
-      "label": "Data de nascimento"
-    },
-    "email": {
-      "label": "E-mail",
-      "placeholder": "Escreva o seu endereço de e-mail"
-    },
-    "website": {
-      "label": "Website",
-      "placeholder": "Escreva o seu website favorito"
-    },
-    "password": {
-      "label": "Palavra-passe",
-      "placeholder": "Escreva a sua palavra-passe"
-    },
-    "gender": {
-      "label": "Selecione o seu género"
-    },
-    "agree": {
-      "label": "Aceito os termos e condições."
-    }
-  },
-  "category": {
-    "name": {
-      "label": "Nome da categoria",
-      "placeholder": "Escreva a categoria"
-    },
-    "description": {
-      "label": "Descrição da categoria",
-      "placeholder": "Descreva a categoria (opcional)"
-    },
-    "created": {
-      "label": "Data de criação",
-      "placeholder": "Selecione a data de criação"
-    }
-  },
-  "employee": {
-    "name": {
-      "label": "Nome do funcionário",
-      "placeholder": "Escreva o nome do funcionário"
-    },
-    "occupation": {
-      "label": "Função do funcionário"
-    }
-  },
-  "user": {
-    "secret": {
-      "label": "Palavra-passe"
-    },
-    "username": {
-      "label": "Nome de utilizador"
-    }
-  },
   "component": {
     "fieldset": {
       "add": "Adicionar outro",
       "update": "Atualizar item",
-      "not_unique": "O valor introduzido já existe. Valor \"{{value}}\""
+      "not_unique": "O valor introduzido já existe. Valor \"{{value}}\".",
+      "cancel": "Cancelar"
     },
     "list": {
       "pagination": "A mostrar a página <span class=\"text-bold\">{{value0}} de {{value1}}</span>",
@@ -143,7 +72,9 @@
       "select": "Seleção de filtro",
       "step1": "Selecione um índice",
       "step2": "Selecione uma condição",
-      "step3": "Escreva um valor"
+      "step3": "Escreva um valor",
+      "no_suggestions": "Sem sugestões",
+      "sort": "Ordenar por"
     }
   }
 }

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

@@ -3,7 +3,7 @@ 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.
@@ -360,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'.
@@ -530,6 +530,15 @@ export declare class CrudFieldComponent extends NgxCrudFormField implements OnIn
      * @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.

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

@@ -36,6 +36,17 @@ export declare class CrudFormComponent implements OnInit, IFormElement, OnDestro
      * @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
@@ -157,6 +168,30 @@ export declare class CrudFormComponent implements OnInit, IFormElement, OnDestro
      * @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
@@ -248,19 +283,6 @@ export declare class CrudFormComponent implements OnInit, IFormElement, OnDestro
      * @memberOf CrudFormComponent
      */
     handleDelete(): void;
-    /**
-     * @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.
-     *
-     * @type {CrudOperations}
-     * @protected
-     * @readonly
-     * @memberOf CrudFormComponent
-     */
-    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()

package/components/fieldset/fieldset.component.d.ts

@@ -324,6 +324,15 @@ export declare class FieldsetComponent extends NgxBaseComponent implements OnIni
      * @memberOf FieldsetComponent
      */
     buttonLabel: string;
+    /**
+     * @description Localized label text for action buttons.
+     * @summary Dynamic button label that changes based on the current operation mode.
+     * Shows "Cancel" for update operations
+     *
+     * @type {string}
+     * @memberOf FieldsetComponent
+     */
+    buttonCancelLabel: string;
     /**
      * @description Component constructor that initializes the fieldset with icons and component name.
      * @summary Calls the parent NgxBaseComponent constructor with the component name and

package/components/filter/filter.component.d.ts

@@ -213,6 +213,15 @@ export declare class FilterComponent extends NgxBaseComponent implements OnInit,
      * @memberOf FilterComponent
      */
     windowResizeSubscription: Subscription;
+    /**
+     * @description Browsing mode (dark or light).
+     * @summary Indicates whether the dark mode theme is currently enabled.
+     * Defaults to `false`.
+     *
+     * @type {boolean}
+     * @memberOf FilterComponent
+     */
+    isDarkMode: boolean;
     /**
      * @description Event emitter for filter changes.
      * @summary Emits filter events when the user creates, modifies, or clears filters.
@@ -262,10 +271,10 @@ export declare class FilterComponent extends NgxBaseComponent implements OnInit,
      *   end
      *   F->>F: Call initialize()
      *
-     * @returns {void}
+     * @returns {Promise<void>}
      * @memberOf FilterComponent
      */
-    ngOnInit(): void;
+    ngOnInit(): Promise<void>;
     /**
      * @description Retrieves and configures available indexes for filtering and sorting.
      * @summary Extracts field indexes from the model if available and merges them with

package/engine/NgxBaseComponent.d.ts

@@ -260,7 +260,7 @@ export declare abstract class NgxBaseComponent implements OnChanges {
      * @summary Stores the automatically derived locale based on the component's class name.
      * This is determined during component initialization and serves as a fallback when no
      * explicit locale is provided via the locale input property. The derivation is handled
-     * by the getLocaleFromClassName utility function, which extracts a locale identifier
+     * by the getLocaleContext utility function, which extracts a locale identifier
      * from the component's class name.
      *
      * @type {string}
@@ -349,7 +349,7 @@ export declare abstract class NgxBaseComponent implements OnChanges {
      *   A->>C: new Component(instance)
      *   C->>B: super(instance)
      *   B->>B: Set componentName = instance
-     *   B->>U: getLocaleFromClassName(instance)
+     *   B->>U: getLocaleContext(instance)
      *   U-->>B: Return derived locale
      *   B->>B: Set componentLocale
      *   B->>L: getLogger(this)
@@ -358,7 +358,7 @@ export declare abstract class NgxBaseComponent implements OnChanges {
      *
      * @memberOf NgxBaseComponent
      */
-    protected constructor(instance: string, icons?: KeyValue);
+    protected constructor(instance: string);
     /**
      * @description Getter for the repository instance.
      * @summary Provides a connection to the data layer for retrieving and manipulating data.
@@ -374,42 +374,6 @@ export declare abstract class NgxBaseComponent implements OnChanges {
      * @memberOf NgxBaseComponent
      */
     protected get repository(): DecafRepository<Model>;
-    /**
-     * @description Parses and applies properties from the props object to the component instance.
-     * @summary This method iterates through the properties of the provided instance object
-     * and applies any matching properties from the component's props configuration to the
-     * component instance. This allows for dynamic property assignment based on configuration
-     * stored in the props object, enabling flexible component customization without requiring
-     * explicit property binding for every possible configuration option.
-     *
-     * The method performs a safe property assignment by checking if each key from the instance
-     * exists in the props object before applying it. This prevents accidental property
-     * overwriting and ensures only intended properties are modified.
-     *
-     * @param {KeyValue} instance - The component instance object to process
-     * @return {void}
-     *
-     * @mermaid
-     * sequenceDiagram
-     *   participant C as Component
-     *   participant B as NgxBaseComponent
-     *   participant P as Props Object
-     *
-     *   C->>B: parseProps(instance)
-     *   B->>B: Get Object.keys(instance)
-     *   loop For each key in instance
-     *     B->>P: Check if key exists in this.props
-     *     alt Key exists in props
-     *       B->>B: Set this[key] = this.props[key]
-     *     else Key not in props
-     *       Note over B: Skip this key
-     *     end
-     *   end
-     *
-     * @protected
-     * @memberOf NgxBaseComponent
-     */
-    protected parseProps(instance: KeyValue): void;
     /**
      * @description Handles changes to component inputs
      * @summary This Angular lifecycle hook is called when input properties change.
@@ -536,6 +500,42 @@ export declare abstract class NgxBaseComponent implements OnChanges {
      * @memberOf NgxBaseComponent
      */
     trackItemFn(index: number, item: KeyValue | string | number): string | number;
+    /**
+     * @description Parses and applies properties from the props object to the component instance.
+     * @summary This method iterates through the properties of the provided instance object
+     * and applies any matching properties from the component's props configuration to the
+     * component instance. This allows for dynamic property assignment based on configuration
+     * stored in the props object, enabling flexible component customization without requiring
+     * explicit property binding for every possible configuration option.
+     *
+     * The method performs a safe property assignment by checking if each key from the instance
+     * exists in the props object before applying it. This prevents accidental property
+     * overwriting and ensures only intended properties are modified.
+     *
+     * @param {KeyValue} instance - The component instance object to process
+     * @return {void}
+     *
+     * @mermaid
+     * sequenceDiagram
+     *   participant C as Component
+     *   participant B as NgxBaseComponent
+     *   participant P as Props Object
+     *
+     *   C->>B: parseProps(instance)
+     *   B->>B: Get Object.keys(instance)
+     *   loop For each key in instance
+     *     B->>P: Check if key exists in this.props
+     *     alt Key exists in props
+     *       B->>B: Set this[key] = this.props[key]
+     *     else Key not in props
+     *       Note over B: Skip this key
+     *     end
+     *   end
+     *
+     * @protected
+     * @memberOf NgxBaseComponent
+     */
+    protected parseProps(instance: KeyValue): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxBaseComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<NgxBaseComponent, "ng-component", never, { "rendererId": { "alias": "rendererId"; "required": false; }; "model": { "alias": "model"; "required": false; }; "props": { "alias": "props"; "required": false; }; "item": { "alias": "item"; "required": false; }; "pk": { "alias": "pk"; "required": false; }; "route": { "alias": "route"; "required": false; }; "operations": { "alias": "operations"; "required": false; }; "uid": { "alias": "uid"; "required": false; }; "mapper": { "alias": "mapper"; "required": false; }; "locale": { "alias": "locale"; "required": false; }; "translatable": { "alias": "translatable"; "required": false; }; "className": { "alias": "className"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "renderChild": { "alias": "renderChild"; "required": false; }; }, { "listenEvent": "listenEvent"; }, never, never, true, never>;
 }

package/engine/NgxCrudFormField.d.ts

@@ -3,6 +3,7 @@ import { PossibleInputTypes } from './types';
 import { CrudOperations } from '@decaf-ts/db-decorators';
 import { ControlValueAccessor, FormControl, FormGroup } from '@angular/forms';
 import { ElementRef } from '@angular/core';
+import { TranslateService } from '@ngx-translate/core';
 /**
  * @class NgxCrudFormField
  * @implements {FieldProperties}
@@ -52,7 +53,7 @@ export declare abstract class NgxCrudFormField implements ControlValueAccessor,
     greaterThanOrEqual?: string;
     value: string | number | Date;
     multiple: boolean;
-    private translateService;
+    protected translateService: TranslateService;
     private validationErrorEventDispateched;
     /**
      * @summary Parent HTML element

package/engine/NgxRenderingEngine.d.ts

@@ -39,35 +39,63 @@ import { ComponentMirror, ComponentRef, Injector, TemplateRef, Type, ViewContain
  */
 export declare class NgxRenderingEngine extends RenderingEngine<AngularFieldDefinition, AngularDynamicOutput> {
     /**
-     * @description Registry of registered components
-     * @summary Static registry that maps component names to their constructors.
-     * This allows the engine to look up components by name when rendering.
+     * @description Registry of components available for rendering
+     * @summary Static registry that stores all registered components indexed by their selector name.
+     * Each component entry contains a constructor reference that can be used to instantiate
+     * the component during the rendering process. This registry is shared across all instances
+     * of the rendering engine and is populated through the registerComponent method.
+     *
+     * @private
+     * @static
      * @type {Record<string, { constructor: Constructor<unknown> }>}
      */
     private static _components;
     /**
-     * @description Collection of child component outputs
-     * @summary Stores the outputs of child components during rendering.
-     * @type {AngularDynamicOutput[]}
-     */
-    private _childs;
-    /**
-     * @description Current model being rendered
-     * @summary Reference to the model currently being processed by the rendering engine.
+     * @description Currently active model being rendered
+     * @summary Stores a reference to the model instance that is currently being processed
+     * by the rendering engine. This property is set during the render method execution
+     * and is used throughout the rendering lifecycle to access model data and metadata.
+     * The definite assignment assertion (!) is used because this property is always
+     * initialized before use within the render method.
+     *
+     * @private
      * @type {Model}
      */
     private _model;
+    /**
+     * @description Current operation context for component visibility control
+     * @summary Static property that stores the current operation being performed,
+     * which is used to determine component visibility through the 'hidden' property.
+     * Components can specify operations where they should be hidden, and this property
+     * provides the context for those visibility checks. The value is typically extracted
+     * from the global properties during the rendering process.
+     *
+     * @private
+     * @static
+     * @type {string | undefined}
+     */
     private static _operation;
     /**
-     * @description Static reference to the current instance
-     * @summary Singleton instance reference for the rendering engine.
+     * @description Reference to the currently active component instance
+     * @summary Static property that maintains a reference to the most recently created
+     * component instance. This is used internally for component lifecycle management
+     * and can be cleared through the destroy method. The reference allows access to
+     * the active component instance for operations that need to interact with the
+     * currently rendered component.
+     *
+     * @private
+     * @static
      * @type {Type<unknown> | undefined}
      */
     private static _instance;
     /**
-     * @description Creates a new instance of NgxRenderingEngine
-     * @summary Initializes the rendering engine with the 'angular' engine type.
-     * This constructor sets up the base configuration needed for Angular-specific rendering.
+     * @description Constructs a new NgxRenderingEngine instance
+     * @summary Initializes a new instance of the Angular rendering engine by calling the parent
+     * constructor with the 'angular' engine type identifier. This constructor sets up the base
+     * rendering engine functionality with Angular-specific configurations and prepares the
+     * instance for component registration and rendering operations.
+     *
+     * @constructor
      */
     constructor();
     /**

package/engine/interfaces.d.ts

@@ -259,3 +259,13 @@ export interface BaseCustomEvent {
     data?: unknown;
     target?: HTMLElement;
 }
+/**
+ * Configuration for internationalization (i18n) resource file paths.
+ *
+ * @property prefix - The prefix to be used for the resource file path.
+ * @property suffix - The suffix to be appended to the resource file path.
+ */
+export interface I18nResourceConfig {
+    prefix: string;
+    suffix: string;
+}

package/engine/types.d.ts

@@ -106,6 +106,14 @@ export type AngularFieldDefinition = Omit<IonInput, 'ionInput' | 'ionFocus' | 'i
  * @memberOf module:engine
  */
 export type StringOrBoolean = 'true' | 'false' | boolean;
+/**
+ * @description Option type for CRUD field inputs
+ * @summary Represents a union type that can be either a SelectOption or RadioOption.
+ * This is used for defining options in form fields that support both select and radio input types.
+ * @typedef {(SelectOption|RadioOption)} CrudFieldOption
+ * @memberOf module:engine
+ */
+export type CrudFieldOption = SelectOption | RadioOption;
 /**
  * @description Option type for select inputs
  * @summary Extends the InputOption interface with a selected property to indicate