@decaf-ts/for-angular 0.1.8 → 0.1.10

package/index.d.ts

@@ -1,16 +1,16 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Type, Injector, ElementRef, EnvironmentInjector, OnChanges, OnDestroy, WritableSignal, ChangeDetectorRef, Renderer2, EventEmitter, SimpleChanges, EnvironmentProviders, Provider, AfterViewInit, ViewContainerRef, TemplateRef, OnInit, ComponentMirror, ComponentRef, ModuleWithProviders } from '@angular/core';
-import { IonInput, IonSelect, IonTextarea, IonCheckbox, MenuController, SpinnerTypes, InfiniteScrollCustomEvent, RefresherCustomEvent } from '@ionic/angular';
-import { TextFieldTypes, SelectInterface, AutocompleteTypes, CheckboxCustomEvent, Color, PredefinedColors, OverlayEventDetail } from '@ionic/core';
+import { Type, Injector, ElementRef, EnvironmentInjector, InjectionToken, OnChanges, OnDestroy, WritableSignal, ChangeDetectorRef, Renderer2, EventEmitter, SimpleChanges, EnvironmentProviders, Provider, AfterViewInit, ViewContainerRef, TemplateRef, OnInit, ComponentMirror, ComponentRef, PipeTransform, ModuleWithProviders } from '@angular/core';
 import * as i2 from '@angular/forms';
 import { FormGroup, FormControl, FormArray, ControlValueAccessor, AbstractControl } from '@angular/forms';
 import { OrderDirection, AttributeOption, Observer, Condition, Paginator, Repository, Adapter } from '@decaf-ts/core';
-import { UIFunctionLike, CrudOperationKeys, FieldProperties, IPagedComponentProperties, DecafTranslateService, DecafComponent, HTML5InputTypes, ElementSizes, LayoutGridGaps, ElementPositions, UIEventProperty, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, RenderingEngine, DecafEventHandler } from '@decaf-ts/ui-decorators';
-import { VALIDATION_PARENT_KEY, Model, ModelConstructor, ComparisonValidationKeys } from '@decaf-ts/decorator-validation';
+import { PrimaryKeyType, OperationKeys, IRepository, CrudOperations, RepositoryFlags, Context } from '@decaf-ts/db-decorators';
+import { Constructor } from '@decaf-ts/decoration';
+import { Model, VALIDATION_PARENT_KEY, ModelConstructor, ComparisonValidationKeys } from '@decaf-ts/decorator-validation';
+import { UIFunctionLike, CrudOperationKeys, FieldProperties, IPagedComponentProperties, DecafTranslateService, DecafComponent, HTML5InputTypes, ElementPositions, ElementSizes, LayoutGridGaps, UIEventProperty, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, RenderingEngine, DecafEventHandler } from '@decaf-ts/ui-decorators';
+import { IonInput, IonSelect, IonTextarea, IonCheckbox, MenuController, SpinnerTypes, InfiniteScrollCustomEvent, RefresherCustomEvent } from '@ionic/angular';
+import { TextFieldTypes, SelectInterface, AutocompleteTypes, CheckboxCustomEvent, Color, PredefinedColors, OverlayEventDetail } from '@ionic/core';
 import * as _ionic_angular_standalone from '@ionic/angular/standalone';
 import { ModalOptions, LoadingOptions, SelectCustomEvent, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
-import { OperationKeys, PrimaryKeyType, IRepository, CrudOperations, RepositoryFlags, Context } from '@decaf-ts/db-decorators';
-import { Constructor } from '@decaf-ts/decoration';
 import * as i1 from '@angular/common';
 import { Location } from '@angular/common';
 import { Router } from '@angular/router';
@@ -18,410 +18,126 @@ import { OverlayBaseController } from '@ionic/angular/common';
 import { HttpClient } from '@angular/common/http';
 import { Observable, Subject, Subscription } from 'rxjs';
 import * as i3 from '@ngx-translate/core';
-import { InterpolationParameters, Translation, InterpolatableTranslationObject, TranslateLoader, TranslationObject, TranslateParser, RootTranslateServiceConfig } from '@ngx-translate/core';
+import { InterpolationParameters, Translation, InterpolatableTranslationObject, Language, TranslateService, TranslateLoader, TranslationObject, TranslateParser, RootTranslateServiceConfig } from '@ngx-translate/core';
 import { Title, SafeHtml, DomSanitizer } from '@angular/platform-browser';
 import { sf, Logger, LoggedClass } from '@decaf-ts/logging';
 import { NavigationOptions } from '@ionic/angular/common/providers/nav-controller';
 import { InjectablesRegistry } from '@decaf-ts/injectable-decorators';
 
-declare const DB_ADAPTER_FLAVOUR_TOKEN = "DbAdapterFlavour";
 /**
- * Maps validation keys for password, email, and URL to their corresponding regex patterns.
- * These patterns are used to validate field values against standard format requirements.
+ * @module lib/engine/interfaces
+ * @description Type and interface definitions used by the Angular rendering engine.
+ * @summary Exposes interfaces for component input metadata, rendering outputs, form events,
+ * and supporting types used across the engine and components.
  */
+
 /**
- * Maps validation keys for password, email, and URL to their corresponding regex patterns.
- * These patterns are used to validate field values against standard format requirements.
+ * @description Interface for models that can be rendered
+ * @summary Defines the basic structure for models that can be rendered by the engine.
+ * Contains an optional rendererId that uniquely identifies the rendered instance.
+ * @interface IRenderedModel
+ * @property {string} [rendererId] - Optional unique ID for the rendered model instance
+ * @memberOf module:engine
  */
-declare const patternValidators: Record<string, RegExp>;
+interface IRenderedModel {
+    rendererId?: string;
+}
 /**
- * @description Injection token for registering the database adapter provider.
- * @summary Used to inject the database adapter instance that implements DecafRepositoryAdapter.
- * This token allows the framework to locate and use the application's specific database implementation.
- * @const {InjectionToken<DecafRepositoryAdapter>}
- * @memberOf module:lib/for-angular-common.module
+ * @description Interface for components that hold an ElementRef
+ * @summary Defines a component holder interface that provides access to the underlying DOM element through ElementRef
+ * @interface IComponentHolder
+ * @memberOf module:engine
  */
-declare const DB_ADAPTER_PROVIDER_TOKEN: InjectionToken<DecafRepositoryAdapter>;
+interface IComponentHolder {
+    /**
+     * @description Reference to the component's DOM element
+     * @property {ElementRef} component - The ElementRef instance providing access to the native DOM element
+     */
+    component: ElementRef;
+}
 /**
- * @description Injection token for the root path of locale translation files.
- * @summary Used to configure the base path where i18n translation files are located.
- * This allows the translation loader to locate JSON files for different languages.
- * @const {InjectionToken<string>}
- * @memberOf module:lib/for-angular-common.module
- * @example
- * // Typical usage when providing the token
- * { provide: LOCALE_ROOT_TOKEN, useValue: './assets/i18n/' }
+ * @description Interface for form components that hold both an ElementRef and a FormGroup
+ * @summary Extends IComponentHolder to include a FormGroup for form handling capabilities
+ * @interface IFormElement
+ * @memberOf module:engine
  */
-declare const LOCALE_ROOT_TOKEN: InjectionToken<string>;
+interface IFormElement extends IComponentHolder {
+    /**
+     * @description The Angular FormGroup associated with this form element
+     * @property {FormGroup|undefined} formGroup - The form group instance for managing form controls and validation
+     */
+    formGroup: FormParent | undefined;
+}
 /**
- * @description Generic injection token for providing arbitrary values to constructors.
- * @summary Used to inject classes, strings, or any other value into component or service constructors.
- * This is a flexible token that can be used to provide any type of dependency when more specific
- * tokens are not appropriate. The actual type and purpose of the injected value is determined by
- * the provider configuration.
- * @const {InjectionToken<unknown>}
- * @memberOf module:lib/for-angular-common.module
- * @example
- * // Inject a string value
- * { provide: CPTKN, useValue: 'some-config-value' }
- *
- * // Inject a class
- * { provide: CPTKN, useClass: MyService }
- *
- * // Inject any arbitrary value
- * { provide: CPTKN, useValue: { key: 'value', data: [1, 2, 3] } }
+ * @description Interface for fieldset item representation in the UI.
+ * @summary Defines the structure for items displayed in the reorderable list within the fieldset.
+ * Each item represents a value added to the fieldset with display properties for the UI.
+ * @memberOf module:engine
  */
-declare const CPTKN: InjectionToken<unknown>;
+interface IFieldSetItem {
+    /** @description Sequential index number for ordering items in the list */
+    index: number;
+    /** @description Primary display text for the item */
+    title: string;
+    /** @description Optional secondary text providing additional item details */
+    description?: string;
+}
 /**
- * @description Injection token for i18n resource configuration.
- * @summary Used to provide configuration for internationalization resources, including
- * translation file locations and supported languages. This token configures how the
- * application loads and manages translation resources.
- * @const {InjectionToken<I18nToken>}
- * @memberOf module:lib/for-angular-common.module
+ * @description Interface for fieldset validation event data.
+ * @summary Defines the structure of validation events emitted when form validation occurs.
+ * Used for communication between form components and the fieldset container.
+ * @memberOf module:engine
  */
-declare const I18N_CONFIG_TOKEN: InjectionToken<I18nToken>;
+interface IFieldSetValidationEvent {
+    /** @description The FormGroup containing the validated form controls */
+    formGroup: FormArray | FormGroup;
+    /** @description The current form value being validated */
+    value: unknown;
+    /** @description Whether the form validation passed or failed */
+    isValid: boolean;
+}
 /**
- * @description Default options for empty list state display.
- * @summary Provides default configuration for displaying empty state in list components
- * when no data is available. Includes default text for title and subtitle, icon name,
- * button text and visibility settings. These defaults can be overridden by individual
- * list component implementations to customize the empty state presentation.
- * @type {IListEmptyOptions}
- * @property {string} title - Default translation key for empty list title
- * @property {string} subtitle - Default translation key for empty list subtitle
- * @property {boolean} showButton - Whether to show action button in empty state
- * @property {string} icon - Default Ionic icon name for empty state
- * @property {string} buttonText - Default translation key for button text
- * @property {string} link - Default navigation link (empty string)
- * @const DefaultListEmptyOptions
- * @memberOf module:lib/engine/constants
+ * @description Interface for individual filter query items
+ * @summary Defines the structure of a single filter criterion in a filter query.
+ * Each item represents one condition to be applied to the data, consisting of
+ * an index (field name), a condition (comparison operator), and a value to compare against.
+ * @interface IFilterQueryItem
+ * @property {string} [index] - Optional field name or index to filter on
+ * @property {string} [condition] - Optional comparison condition (e.g., 'Equal', 'Contains', 'Greater Than')
+ * @property {string} [value] - Optional value to compare the field against
+ * @memberOf module:engine
  */
-declare const DefaultListEmptyOptions: IListEmptyOptions;
-declare const DefaultModalOptions: ModalOptions;
-declare const ActionRoles: {
-    readonly cancel: "cancel";
-    readonly confirm: "confirm";
-    readonly submit: "submit";
-    readonly clear: "clear";
-    readonly back: "back";
-    readonly create: OperationKeys.CREATE;
-    readonly read: OperationKeys.READ;
-    readonly update: OperationKeys.UPDATE;
-    readonly delete: OperationKeys.DELETE;
-};
-declare const WindowColorSchemes: {
-    readonly light: "light";
-    readonly dark: "dark";
-    readonly undefined: "undefined";
-};
-declare const ListItemPositions: {
-    readonly uid: "uid";
-    readonly title: "title";
-    readonly description: "description";
-    readonly info: "info";
-    readonly subinfo: "subinfo";
-};
+interface IFilterQueryItem {
+    index?: string;
+    condition?: string;
+    value?: string | null | undefined;
+}
 /**
- * @description Angular engine key constants.
- * @summary Contains key strings used by the Angular rendering engine for reflection,
- * dynamic component creation, and other engine operations. These constants provide
- * consistent naming for metadata keys, DOM attributes, and component identification
- * throughout the rendering system.
- * @typedef {Object} AngularEngineKeys
- * @property {string} REFLECT - Prefix for reflection metadata keys
- * @property {string} DYNAMIC - Key for dynamic component identification
- * @property {string} ANNOTATIONS - Key for component annotations
- * @property {string} ECMP - Key for embedded components
- * @property {string} NG_REFLECT - Prefix for Angular reflection attributes
- * @property {string} RENDERED - Prefix for rendered component markers
- * @property {string} MAPPER - Key for property mappers
- * @property {string} CHILDREN - Key for child components
- * @property {string} LISTABLE - Key for listable components
- * @property {string} RENDER - Key for renderable components
- * @property {string} RENDERED_ID - Template for rendered component IDs
- * @property {string} PARENT - Key for comparison decorators and validators
- * @property {string} VALIDATION_PARENT_KEY - Key for validation parent reference
- * @property {string} FLAVOUR - Identifier for the Angular engine flavor
- * @const AngularEngineKeys
- * @memberOf module:lib/engine/constants
+ * @description Interface for sorting configuration objects
+ * @summary Defines the structure for specifying sort criteria including the field
+ * to sort by and the direction of the sort (ascending or descending).
+ * @interface ISortObject
+ * @property {string} value - The field name or property to sort by
+ * @property {OrderDirection} direction - The sort direction (ASC or DSC)
+ * @memberOf module:engine
  */
-declare const AngularEngineKeys: {
-    readonly REFLECT: "angular";
-    readonly DYNAMIC: "dynamic-component";
-    readonly ANNOTATIONS: "__annotations__";
-    readonly ECMP: "ecmp";
-    readonly NG_REFLECT: "ng-reflect-";
-    readonly RENDERED: "rendered-as-";
-    readonly MAPPER: "mapper";
-    readonly CHILDREN: "children";
-    readonly ERRORS: "errors";
-    readonly LISTABLE: "listable";
-    readonly RENDER: "render";
-    readonly RENDERED_ID: "rendered-as-{0}";
-    readonly PARENT: "_parent";
-    readonly VALIDATION_PARENT_KEY: typeof VALIDATION_PARENT_KEY;
-    readonly FLAVOUR: "angular";
-    readonly LOADED: "engineLoaded";
-    readonly DARK_PALETTE_CLASS: "dcf-palette-dark";
-};
+interface ISortObject {
+    value: string;
+    direction: OrderDirection;
+}
 /**
- * @description Route direction constants.
- * @summary Defines the possible navigation directions in the application.
- * Used for controlling navigation flow and animation directions during route transitions.
- * These constants help maintain consistent navigation behavior throughout the app.
- * @enum {string}
- * @readonly
- * @property {string} BACK - Navigate back to the previous page
- * @property {string} FORWARD - Navigate forward to the next page
- * @property {string} ROOT - Navigate to the root/home page
- * @memberOf module:lib/engine/constants
+ * @description Interface for complete filter query configuration
+ * @summary Defines the complete structure for filter and sort operations.
+ * Combines multiple filter criteria with sorting configuration to provide
+ * comprehensive data filtering and ordering capabilities.
+ * @interface IFilterQuery
+ * @property {IFilterQueryItem[] | undefined} query - Array of filter criteria or undefined for no filtering
+ * @property {ISortObject} sort - Sorting configuration specifying field and direction
+ * @memberOf module:engine
  */
-declare enum RouteDirections {
-    BACK = "back",
-    FORWARD = "forward",
-    ROOT = "root"
-}
-/**
- * @description Component tag name constants.
- * @summary Defines the custom HTML tag names for specialized components used in the application.
- * These tag names are registered with Angular and used for component rendering and identification.
- * Each constant represents the selector for a specific custom component type.
- * @enum {string}
- * @readonly
- * @property {string} LIST_ITEM - Tag name for list item component
- * @property {string} LIST_INFINITE - Tag name for infinite scrolling list component
- * @property {string} LIST_PAGINATED - Tag name for paginated list component
- * @property {string} CRUD_FIELD - Tag name for CRUD form field component
- * @property {string} LAYOUT_COMPONENT - Tag name for layout container component
- * @memberOf module:lib/engine/constants
- */
-declare enum ComponentsTagNames {
-    LIST_ITEM = "ngx-decaf-list-item",
-    LIST_INFINITE = "ngx-decaf-list-infinite",
-    LIST_PAGINATED = "ngx-decaf-list-paginated",
-    CRUD_FIELD = "ngx-decaf-crud-field",
-    LAYOUT_COMPONENT = "ngx-decaf-layout"
-}
-/**
- * @description Base component property name constants.
- * @summary Defines the standard property names used by base components throughout the application.
- * These constants ensure consistent property naming across components and facilitate
- * property access, validation, and data binding. Used primarily for component input
- * properties and change detection.
- * @enum {string}
- * @readonly
- * @property {string} MODEL - Property name for the component's data model
- * @property {string} LOCALE - Property name for localization settings
- * @property {string} LOCALE_ROOT - Property name for the locale root identifier
- * @property {string} PK - Property name for primary key
- * @property {string} ITEMS - Property name for collection items
- * @property {string} ROUTE - Property name for routing information
- * @property {string} OPERATIONS - Property name for available operations
- * @property {string} UID - Property name for unique identifier
- * @property {string} TRANSLATABLE - Property name for translation flag
- * @property {string} MAPPER - Property name for property mapper
- * @property {string} INITIALIZED - Property name for initialization state
- * @property {string} COMPONENT_NAME - Property name for component identifier
- * @property {string} PARENT_FORM - Property name for parent component reference
- * @property {string} FORM_GROUP_COMPONENT_PROPS - Property name for form group component properties
- * @memberOf module:lib/engine/constants
- */
-declare enum BaseComponentProps {
-    MODEL_ID = "modelId",
-    MODEL = "model",
-    HANDLERS = "handlers",
-    LOCALE = "locale",
-    LOCALE_ROOT = "locale_root",
-    PK = "pk",
-    ITEMS = "items",
-    ROUTE = "route",
-    OPERATION = "operation",
-    OPERATIONS = "operations",
-    UID = "uid",
-    TRANSLATABLE = "translatable",
-    MAPPER = "mapper",
-    INITIALIZED = "initialized",
-    COMPONENT_NAME = "componentName",
-    PARENT_FORM = "parentForm",
-    FORM_GROUP_COMPONENT_PROPS = "componentProps"
-}
-/**
- * @description List component type constants.
- * @summary Defines the available types for list components, determining their
- * pagination and scrolling behavior. Used to configure list rendering strategies.
- * @enum {string}
- * @readonly
- * @property {string} INFINITE - Infinite scroll list type
- * @property {string} PAGINATED - Paginated list type with page navigation
- * @memberOf module:lib/engine/constants
- */
-declare enum ListComponentsTypes {
-    INFINITE = "infinite",
-    PAGINATED = "paginated"
-}
-/**
- * @description CSS class name constants.
- * @summary Contains predefined CSS class names used for consistent styling
- * across components. These constants help maintain a unified visual language
- * and make it easier to apply standard styles.
- * @typedef {Object} CssClasses
- * @property {string} BUTTONS_CONTAINER - CSS class for button container elements
- * @const CssClasses
- * @memberOf module:lib/engine/constants
- */
-declare const CssClasses: {
-    BUTTONS_CONTAINER: string;
-};
-/**
- * @description Default options for reactive CRUD forms.
- * @summary Provides default configuration for form buttons in CRUD operations.
- * Includes default text labels for submit and clear buttons, which can be
- * overridden by individual form implementations.
- * @type {ICrudFormOptions}
- * @property {Object} buttons - Configuration for form action buttons
- * @property {Object} buttons.submit - Submit button configuration
- * @property {string} buttons.submit.text - Default text for submit button
- * @property {Object} buttons.clear - Clear button configuration
- * @property {string} buttons.clear.text - Default text for clear button
- * @const DefaultFormReactiveOptions
- * @memberOf module:lib/engine/constants
- */
-declare const DefaultFormReactiveOptions: ICrudFormOptions;
-/**
- * @description Mapping of select field interface types used in Ionic components.
- * @summary Provides a set of supported select interface types for Ionic select fields,
- * mapping human-readable keys to their corresponding `SelectInterface` string values.
- * This allows for consistent usage and reference of select interface types throughout the application.
- * @type {Record<string, SelectInterface>}
- * @property {string} PopOver - Represents the 'popover' select interface.
- * @property {string} Alert - Represents the 'alert' select interface.
- * @property {string} ActionSheet - Represents the 'action-sheet' select interface.
- * @property {string} modal - Represents the 'modal' select interface.
- * @const SelectFieldInterfaces
- * @memberOf module:lib/engine/constants
- */
-declare const SelectFieldInterfaces: {
-    readonly POPOVER: "popover";
-    readonly ALERT: "alert";
-    readonly ACTION_SHEET: "action-sheet";
-    readonly MODAL: "modal";
-};
-
-/**
- * @module lib/engine/interfaces
- * @description Type and interface definitions used by the Angular rendering engine.
- * @summary Exposes interfaces for component input metadata, rendering outputs, form events,
- * and supporting types used across the engine and components.
- */
-
-/**
- * @description Interface for models that can be rendered
- * @summary Defines the basic structure for models that can be rendered by the engine.
- * Contains an optional rendererId that uniquely identifies the rendered instance.
- * @interface IRenderedModel
- * @property {string} [rendererId] - Optional unique ID for the rendered model instance
- * @memberOf module:engine
- */
-interface IRenderedModel {
-    rendererId?: string;
-}
-/**
- * @description Interface for components that hold an ElementRef
- * @summary Defines a component holder interface that provides access to the underlying DOM element through ElementRef
- * @interface IComponentHolder
- * @memberOf module:engine
- */
-interface IComponentHolder {
-    /**
-     * @description Reference to the component's DOM element
-     * @property {ElementRef} component - The ElementRef instance providing access to the native DOM element
-     */
-    component: ElementRef;
-}
-/**
- * @description Interface for form components that hold both an ElementRef and a FormGroup
- * @summary Extends IComponentHolder to include a FormGroup for form handling capabilities
- * @interface IFormElement
- * @memberOf module:engine
- */
-interface IFormElement extends IComponentHolder {
-    /**
-     * @description The Angular FormGroup associated with this form element
-     * @property {FormGroup|undefined} formGroup - The form group instance for managing form controls and validation
-     */
-    formGroup: FormParent | undefined;
-}
-/**
- * @description Interface for fieldset item representation in the UI.
- * @summary Defines the structure for items displayed in the reorderable list within the fieldset.
- * Each item represents a value added to the fieldset with display properties for the UI.
- * @memberOf module:engine
- */
-interface IFieldSetItem {
-    /** @description Sequential index number for ordering items in the list */
-    index: number;
-    /** @description Primary display text for the item */
-    title: string;
-    /** @description Optional secondary text providing additional item details */
-    description?: string;
-}
-/**
- * @description Interface for fieldset validation event data.
- * @summary Defines the structure of validation events emitted when form validation occurs.
- * Used for communication between form components and the fieldset container.
- * @memberOf module:engine
- */
-interface IFieldSetValidationEvent {
-    /** @description The FormGroup containing the validated form controls */
-    formGroup: FormArray | FormGroup;
-    /** @description The current form value being validated */
-    value: unknown;
-    /** @description Whether the form validation passed or failed */
-    isValid: boolean;
-}
-/**
- * @description Interface for individual filter query items
- * @summary Defines the structure of a single filter criterion in a filter query.
- * Each item represents one condition to be applied to the data, consisting of
- * an index (field name), a condition (comparison operator), and a value to compare against.
- * @interface IFilterQueryItem
- * @property {string} [index] - Optional field name or index to filter on
- * @property {string} [condition] - Optional comparison condition (e.g., 'Equal', 'Contains', 'Greater Than')
- * @property {string} [value] - Optional value to compare the field against
- * @memberOf module:engine
- */
-interface IFilterQueryItem {
-    index?: string;
-    condition?: string;
-    value?: string | null | undefined;
-}
-/**
- * @description Interface for sorting configuration objects
- * @summary Defines the structure for specifying sort criteria including the field
- * to sort by and the direction of the sort (ascending or descending).
- * @interface ISortObject
- * @property {string} value - The field name or property to sort by
- * @property {OrderDirection} direction - The sort direction (ASC or DSC)
- * @memberOf module:engine
- */
-interface ISortObject {
-    value: string;
-    direction: OrderDirection;
-}
-/**
- * @description Interface for complete filter query configuration
- * @summary Defines the complete structure for filter and sort operations.
- * Combines multiple filter criteria with sorting configuration to provide
- * comprehensive data filtering and ordering capabilities.
- * @interface IFilterQuery
- * @property {IFilterQueryItem[] | undefined} query - Array of filter criteria or undefined for no filtering
- * @property {ISortObject} sort - Sorting configuration specifying field and direction
- * @memberOf module:engine
- */
-interface IFilterQuery {
-    query: IFilterQueryItem[] | undefined;
-    sort?: ISortObject;
+interface IFilterQuery {
+    query: IFilterQueryItem[] | undefined;
+    sort?: ISortObject;
 }
 /**
  * @description Component input properties
@@ -624,150 +340,434 @@ interface I18nToken {
     versionedSuffix: boolean;
 }
 /**
- * @description CRUD form event type
- * @summary Extends IBaseCustomEvent to include optional handlers for CRUD form operations.
- * This event type is used for form-related actions like create, read, update, and delete operations.
- * @interface ICrudFormEvent
- * @property {Record<string, unknown>} [handlers] - Optional handlers for form operations
- * @property {string} name - The name of the event (inherited from IBaseCustomEvent)
- * @property {string} [component] - The component that triggered the event (inherited from IBaseCustomEvent)
- * @property {unknown} [data] - The data associated with the event (inherited from IBaseCustomEvent)
- * @property {HTMLElement} [target] - The target element (inherited from IBaseCustomEvent)
- * @memberOf module:engine
+ * @description CRUD form event type
+ * @summary Extends IBaseCustomEvent to include optional handlers for CRUD form operations.
+ * This event type is used for form-related actions like create, read, update, and delete operations.
+ * @interface ICrudFormEvent
+ * @property {Record<string, unknown>} [handlers] - Optional handlers for form operations
+ * @property {string} name - The name of the event (inherited from IBaseCustomEvent)
+ * @property {string} [component] - The component that triggered the event (inherited from IBaseCustomEvent)
+ * @property {unknown} [data] - The data associated with the event (inherited from IBaseCustomEvent)
+ * @property {HTMLElement} [target] - The target element (inherited from IBaseCustomEvent)
+ * @memberOf module:engine
+ */
+interface ICrudFormEvent extends IBaseCustomEvent {
+    handler?: UIFunctionLike;
+    handlers?: Record<string, UIFunctionLike>;
+    modelId?: PrimaryKeyType;
+    role: (typeof ActionRoles)[keyof typeof ActionRoles] & CrudOperationKeys;
+}
+/**
+ * @description Pagination custom event
+ * @summary Event emitted by pagination components to signal page navigation.
+ * Extends IBaseCustomEvent and carries a payload with the target page number and navigation direction.
+ * @interface IPaginationCustomEvent
+ * @property {Object} data - The pagination data payload
+ * @property {number} data.page - The target page number
+ * @property {'next' | 'previous'} data.direction - The navigation direction
+ * @memberOf module:engine
+ */
+interface IPaginationCustomEvent extends IBaseCustomEvent {
+    data: {
+        page: number;
+        direction: 'next' | 'previous';
+    };
+}
+/**
+ * @description Menu item definition
+ * @summary Represents a single item in a navigation or contextual menu.
+ * Includes the visible label and optional metadata such as accessibility title, target URL, icon, and color.
+ * @interface IMenuItem
+ * @property {string} label - The visible text label for the menu item
+ * @property {string} [title] - Optional accessibility title or tooltip text
+ * @property {string} [url] - Optional target URL for navigation
+ * @property {string} [icon] - Optional icon identifier to display with the menu item
+ * @property {string} [color] - Optional color theme for the menu item
+ * @memberOf module:engine
+ */
+interface IMenuItem {
+    label: string;
+    title?: string;
+    url?: string;
+    icon?: string;
+    color?: string;
+}
+/**
+ * @description CRUD form options configuration
+ * @summary Defines the configuration options for CRUD form buttons including submit and clear buttons.
+ * Each button can be customized with text, icon, and icon position.
+ * @interface ICrudFormOptions
+ * @property {Object} buttons - Configuration for form action buttons
+ * @property {Object} buttons.submit - Submit button configuration
+ * @property {string} [buttons.submit.icon] - Optional icon for the submit button
+ * @property {'start' | 'end'} [buttons.submit.iconSlot] - Position of the icon relative to text
+ * @property {string} [buttons.submit.text] - Text label for the submit button
+ * @property {Object} [buttons.clear] - Optional clear button configuration
+ * @property {string} [buttons.clear.icon] - Optional icon for the clear button
+ * @property {'start' | 'end'} [buttons.clear.iconSlot] - Position of the icon relative to text
+ * @property {string} [buttons.clear.text] - Text label for the clear button
+ * @memberOf module:engine
+ */
+interface ICrudFormOptions {
+    buttons: {
+        submit: {
+            icon?: string;
+            iconSlot?: 'start' | 'end';
+            text?: string;
+        };
+        clear?: {
+            icon?: string;
+            iconSlot?: 'start' | 'end';
+            text?: string;
+        };
+    };
+}
+/**
+ * @description Empty list display options
+ * @summary Defines the configuration for displaying an empty state in list components
+ * when no data is available. Includes text, button, icon, and link settings.
+ * @interface IListEmptyOptions
+ * @property {string} title - Title text or translation key for empty state
+ * @property {string} subtitle - Subtitle text or translation key for empty state
+ * @property {boolean} showButton - Whether to show an action button in empty state
+ * @property {string} buttonText - Button text or translation key
+ * @property {string} link - Navigation link for the button
+ * @property {string} icon - Icon identifier for the empty state
+ * @memberOf module:engine
+ */
+interface IListEmptyOptions {
+    title: string;
+    subtitle: string;
+    showButton: boolean;
+    buttonText: string;
+    link: string;
+    icon: string;
+}
+/**
+ * @description Event emitted when the viewport/window size changes.
+ * @summary Provides the new width and height in pixels for responsive handlers.
+ *
+ * Typical usage: subscribed by UI layout services or components to react to
+ * window resizing and adjust layouts or trigger reflows.
+ *
+ * @example
+ * const e: IWindowResizeEvent = { width: window.innerWidth, height: window.innerHeight };
+ */
+interface IWindowResizeEvent {
+    /** The new width of the window (innerWidth) in pixels */
+    width: number;
+    /** The new height of the window (innerHeight) in pixels */
+    height: number;
+}
+interface IFileUploadError {
+    name: string;
+    size?: number;
+    error: string;
+}
+interface ITabItem {
+    title?: string;
+    description?: string;
+    url?: string;
+    value?: string;
+    icon?: string;
+}
+interface IRepositoryModelProps<M extends Model> {
+    repository: DecafRepository<M>;
+    model: M;
+    modelName?: string;
+    pk: string;
+    pkType: string;
+}
+interface ILayoutModelContext {
+    context: IRepositoryModelProps<Model> & {
+        data: KeyValue;
+    };
+    models: IRepositoryModelProps<Model>[];
+}
+
+declare const DB_ADAPTER_FLAVOUR_TOKEN = "DbAdapterFlavour";
+/**
+ * Maps validation keys for password, email, and URL to their corresponding regex patterns.
+ * These patterns are used to validate field values against standard format requirements.
+ */
+/**
+ * Maps validation keys for password, email, and URL to their corresponding regex patterns.
+ * These patterns are used to validate field values against standard format requirements.
+ */
+declare const patternValidators: Record<string, RegExp>;
+/**
+ * @description Injection token for registering the database adapter provider.
+ * @summary Used to inject the database adapter instance that implements DecafRepositoryAdapter.
+ * This token allows the framework to locate and use the application's specific database implementation.
+ * @const {InjectionToken<DecafRepositoryAdapter>}
+ * @memberOf module:lib/for-angular-common.module
+ */
+declare const DB_ADAPTER_PROVIDER_TOKEN: InjectionToken<DecafRepositoryAdapter>;
+/**
+ * @description Injection token for the root path of locale translation files.
+ * @summary Used to configure the base path where i18n translation files are located.
+ * This allows the translation loader to locate JSON files for different languages.
+ * @const {InjectionToken<string>}
+ * @memberOf module:lib/for-angular-common.module
+ * @example
+ * // Typical usage when providing the token
+ * { provide: LOCALE_ROOT_TOKEN, useValue: './assets/i18n/' }
+ */
+declare const LOCALE_ROOT_TOKEN: InjectionToken<string>;
+/**
+ * @description Generic injection token for providing arbitrary values to constructors.
+ * @summary Used to inject classes, strings, or any other value into component or service constructors.
+ * This is a flexible token that can be used to provide any type of dependency when more specific
+ * tokens are not appropriate. The actual type and purpose of the injected value is determined by
+ * the provider configuration.
+ * @const {InjectionToken<unknown>}
+ * @memberOf module:lib/for-angular-common.module
+ * @example
+ * // Inject a string value
+ * { provide: CPTKN, useValue: 'some-config-value' }
+ *
+ * // Inject a class
+ * { provide: CPTKN, useClass: MyService }
+ *
+ * // Inject any arbitrary value
+ * { provide: CPTKN, useValue: { key: 'value', data: [1, 2, 3] } }
+ */
+declare const CPTKN: InjectionToken<unknown>;
+/**
+ * @description Injection token for i18n resource configuration.
+ * @summary Used to provide configuration for internationalization resources, including
+ * translation file locations and supported languages. This token configures how the
+ * application loads and manages translation resources.
+ * @const {InjectionToken<I18nToken>}
+ * @memberOf module:lib/for-angular-common.module
+ */
+declare const I18N_CONFIG_TOKEN: InjectionToken<I18nToken>;
+/**
+ * @description Default options for empty list state display.
+ * @summary Provides default configuration for displaying empty state in list components
+ * when no data is available. Includes default text for title and subtitle, icon name,
+ * button text and visibility settings. These defaults can be overridden by individual
+ * list component implementations to customize the empty state presentation.
+ * @type {IListEmptyOptions}
+ * @property {string} title - Default translation key for empty list title
+ * @property {string} subtitle - Default translation key for empty list subtitle
+ * @property {boolean} showButton - Whether to show action button in empty state
+ * @property {string} icon - Default Ionic icon name for empty state
+ * @property {string} buttonText - Default translation key for button text
+ * @property {string} link - Default navigation link (empty string)
+ * @const DefaultListEmptyOptions
+ * @memberOf module:lib/engine/constants
+ */
+declare const DefaultListEmptyOptions: IListEmptyOptions;
+declare const DefaultModalOptions: ModalOptions;
+declare const ActionRoles: {
+    readonly cancel: "cancel";
+    readonly confirm: "confirm";
+    readonly submit: "submit";
+    readonly clear: "clear";
+    readonly back: "back";
+    readonly create: OperationKeys.CREATE;
+    readonly read: OperationKeys.READ;
+    readonly update: OperationKeys.UPDATE;
+    readonly delete: OperationKeys.DELETE;
+};
+declare const WindowColorSchemes: {
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly undefined: "undefined";
+};
+declare const ListItemPositions: {
+    readonly uid: "uid";
+    readonly title: "title";
+    readonly description: "description";
+    readonly info: "info";
+    readonly subinfo: "subinfo";
+};
+/**
+ * @description Angular engine key constants.
+ * @summary Contains key strings used by the Angular rendering engine for reflection,
+ * dynamic component creation, and other engine operations. These constants provide
+ * consistent naming for metadata keys, DOM attributes, and component identification
+ * throughout the rendering system.
+ * @typedef {Object} AngularEngineKeys
+ * @property {string} REFLECT - Prefix for reflection metadata keys
+ * @property {string} DYNAMIC - Key for dynamic component identification
+ * @property {string} ANNOTATIONS - Key for component annotations
+ * @property {string} ECMP - Key for embedded components
+ * @property {string} NG_REFLECT - Prefix for Angular reflection attributes
+ * @property {string} RENDERED - Prefix for rendered component markers
+ * @property {string} MAPPER - Key for property mappers
+ * @property {string} CHILDREN - Key for child components
+ * @property {string} LISTABLE - Key for listable components
+ * @property {string} RENDER - Key for renderable components
+ * @property {string} RENDERED_ID - Template for rendered component IDs
+ * @property {string} PARENT - Key for comparison decorators and validators
+ * @property {string} VALIDATION_PARENT_KEY - Key for validation parent reference
+ * @property {string} FLAVOUR - Identifier for the Angular engine flavor
+ * @const AngularEngineKeys
+ * @memberOf module:lib/engine/constants
+ */
+declare const AngularEngineKeys: {
+    readonly REFLECT: "angular";
+    readonly DYNAMIC: "dynamic-component";
+    readonly ANNOTATIONS: "__annotations__";
+    readonly ECMP: "ecmp";
+    readonly NG_REFLECT: "ng-reflect-";
+    readonly RENDERED: "rendered-as-";
+    readonly MAPPER: "mapper";
+    readonly CHILDREN: "children";
+    readonly ERRORS: "errors";
+    readonly LISTABLE: "listable";
+    readonly RENDER: "render";
+    readonly RENDERED_ID: "rendered-as-{0}";
+    readonly PARENT: "_parent";
+    readonly VALIDATION_PARENT_KEY: typeof VALIDATION_PARENT_KEY;
+    readonly FLAVOUR: "angular";
+    readonly LOADED: "engineLoaded";
+    readonly DARK_PALETTE_CLASS: "dcf-palette-dark";
+};
+/**
+ * @description Route direction constants.
+ * @summary Defines the possible navigation directions in the application.
+ * Used for controlling navigation flow and animation directions during route transitions.
+ * These constants help maintain consistent navigation behavior throughout the app.
+ * @enum {string}
+ * @readonly
+ * @property {string} BACK - Navigate back to the previous page
+ * @property {string} FORWARD - Navigate forward to the next page
+ * @property {string} ROOT - Navigate to the root/home page
+ * @memberOf module:lib/engine/constants
+ */
+declare enum RouteDirections {
+    BACK = "back",
+    FORWARD = "forward",
+    ROOT = "root"
+}
+/**
+ * @description Component tag name constants.
+ * @summary Defines the custom HTML tag names for specialized components used in the application.
+ * These tag names are registered with Angular and used for component rendering and identification.
+ * Each constant represents the selector for a specific custom component type.
+ * @enum {string}
+ * @readonly
+ * @property {string} LIST_ITEM - Tag name for list item component
+ * @property {string} LIST_INFINITE - Tag name for infinite scrolling list component
+ * @property {string} LIST_PAGINATED - Tag name for paginated list component
+ * @property {string} CRUD_FIELD - Tag name for CRUD form field component
+ * @property {string} LAYOUT_COMPONENT - Tag name for layout container component
+ * @memberOf module:lib/engine/constants
  */
-interface ICrudFormEvent extends IBaseCustomEvent {
-    handler?: UIFunctionLike;
-    handlers?: Record<string, UIFunctionLike>;
-    modelId?: PrimaryKeyType;
-    role: (typeof ActionRoles)[keyof typeof ActionRoles] & CrudOperationKeys;
+declare enum ComponentsTagNames {
+    LIST_ITEM = "ngx-decaf-list-item",
+    LIST_INFINITE = "ngx-decaf-list-infinite",
+    LIST_PAGINATED = "ngx-decaf-list-paginated",
+    CRUD_FIELD = "ngx-decaf-crud-field",
+    LAYOUT_COMPONENT = "ngx-decaf-layout"
 }
 /**
- * @description Pagination custom event
- * @summary Event emitted by pagination components to signal page navigation.
- * Extends IBaseCustomEvent and carries a payload with the target page number and navigation direction.
- * @interface IPaginationCustomEvent
- * @property {Object} data - The pagination data payload
- * @property {number} data.page - The target page number
- * @property {'next' | 'previous'} data.direction - The navigation direction
- * @memberOf module:engine
+ * @description Base component property name constants.
+ * @summary Defines the standard property names used by base components throughout the application.
+ * These constants ensure consistent property naming across components and facilitate
+ * property access, validation, and data binding. Used primarily for component input
+ * properties and change detection.
+ * @enum {string}
+ * @readonly
+ * @property {string} MODEL - Property name for the component's data model
+ * @property {string} LOCALE - Property name for localization settings
+ * @property {string} LOCALE_ROOT - Property name for the locale root identifier
+ * @property {string} PK - Property name for primary key
+ * @property {string} ITEMS - Property name for collection items
+ * @property {string} ROUTE - Property name for routing information
+ * @property {string} OPERATIONS - Property name for available operations
+ * @property {string} UID - Property name for unique identifier
+ * @property {string} TRANSLATABLE - Property name for translation flag
+ * @property {string} MAPPER - Property name for property mapper
+ * @property {string} INITIALIZED - Property name for initialization state
+ * @property {string} COMPONENT_NAME - Property name for component identifier
+ * @property {string} PARENT_FORM - Property name for parent component reference
+ * @property {string} FORM_GROUP_COMPONENT_PROPS - Property name for form group component properties
+ * @memberOf module:lib/engine/constants
  */
-interface IPaginationCustomEvent extends IBaseCustomEvent {
-    data: {
-        page: number;
-        direction: 'next' | 'previous';
-    };
+declare enum BaseComponentProps {
+    MODEL_ID = "modelId",
+    MODEL = "model",
+    HANDLERS = "handlers",
+    LOCALE = "locale",
+    LOCALE_ROOT = "locale_root",
+    PK = "pk",
+    ITEMS = "items",
+    ROUTE = "route",
+    OPERATION = "operation",
+    OPERATIONS = "operations",
+    UID = "uid",
+    TRANSLATABLE = "translatable",
+    MAPPER = "mapper",
+    INITIALIZED = "initialized",
+    COMPONENT_NAME = "componentName",
+    PARENT_FORM = "parentForm",
+    FORM_GROUP_COMPONENT_PROPS = "componentProps"
 }
 /**
- * @description Menu item definition
- * @summary Represents a single item in a navigation or contextual menu.
- * Includes the visible label and optional metadata such as accessibility title, target URL, icon, and color.
- * @interface IMenuItem
- * @property {string} label - The visible text label for the menu item
- * @property {string} [title] - Optional accessibility title or tooltip text
- * @property {string} [url] - Optional target URL for navigation
- * @property {string} [icon] - Optional icon identifier to display with the menu item
- * @property {string} [color] - Optional color theme for the menu item
- * @memberOf module:engine
+ * @description List component type constants.
+ * @summary Defines the available types for list components, determining their
+ * pagination and scrolling behavior. Used to configure list rendering strategies.
+ * @enum {string}
+ * @readonly
+ * @property {string} INFINITE - Infinite scroll list type
+ * @property {string} PAGINATED - Paginated list type with page navigation
+ * @memberOf module:lib/engine/constants
  */
-interface IMenuItem {
-    label: string;
-    title?: string;
-    url?: string;
-    icon?: string;
-    color?: string;
+declare enum ListComponentsTypes {
+    INFINITE = "infinite",
+    PAGINATED = "paginated"
 }
 /**
- * @description CRUD form options configuration
- * @summary Defines the configuration options for CRUD form buttons including submit and clear buttons.
- * Each button can be customized with text, icon, and icon position.
- * @interface ICrudFormOptions
- * @property {Object} buttons - Configuration for form action buttons
- * @property {Object} buttons.submit - Submit button configuration
- * @property {string} [buttons.submit.icon] - Optional icon for the submit button
- * @property {'start' | 'end'} [buttons.submit.iconSlot] - Position of the icon relative to text
- * @property {string} [buttons.submit.text] - Text label for the submit button
- * @property {Object} [buttons.clear] - Optional clear button configuration
- * @property {string} [buttons.clear.icon] - Optional icon for the clear button
- * @property {'start' | 'end'} [buttons.clear.iconSlot] - Position of the icon relative to text
- * @property {string} [buttons.clear.text] - Text label for the clear button
- * @memberOf module:engine
+ * @description CSS class name constants.
+ * @summary Contains predefined CSS class names used for consistent styling
+ * across components. These constants help maintain a unified visual language
+ * and make it easier to apply standard styles.
+ * @typedef {Object} CssClasses
+ * @property {string} BUTTONS_CONTAINER - CSS class for button container elements
+ * @const CssClasses
+ * @memberOf module:lib/engine/constants
  */
-interface ICrudFormOptions {
-    buttons: {
-        submit: {
-            icon?: string;
-            iconSlot?: 'start' | 'end';
-            text?: string;
-        };
-        clear?: {
-            icon?: string;
-            iconSlot?: 'start' | 'end';
-            text?: string;
-        };
-    };
-}
+declare const CssClasses: {
+    BUTTONS_CONTAINER: string;
+};
 /**
- * @description Empty list display options
- * @summary Defines the configuration for displaying an empty state in list components
- * when no data is available. Includes text, button, icon, and link settings.
- * @interface IListEmptyOptions
- * @property {string} title - Title text or translation key for empty state
- * @property {string} subtitle - Subtitle text or translation key for empty state
- * @property {boolean} showButton - Whether to show an action button in empty state
- * @property {string} buttonText - Button text or translation key
- * @property {string} link - Navigation link for the button
- * @property {string} icon - Icon identifier for the empty state
- * @memberOf module:engine
+ * @description Default options for reactive CRUD forms.
+ * @summary Provides default configuration for form buttons in CRUD operations.
+ * Includes default text labels for submit and clear buttons, which can be
+ * overridden by individual form implementations.
+ * @type {ICrudFormOptions}
+ * @property {Object} buttons - Configuration for form action buttons
+ * @property {Object} buttons.submit - Submit button configuration
+ * @property {string} buttons.submit.text - Default text for submit button
+ * @property {Object} buttons.clear - Clear button configuration
+ * @property {string} buttons.clear.text - Default text for clear button
+ * @const DefaultFormReactiveOptions
+ * @memberOf module:lib/engine/constants
  */
-interface IListEmptyOptions {
-    title: string;
-    subtitle: string;
-    showButton: boolean;
-    buttonText: string;
-    link: string;
-    icon: string;
-}
+declare const DefaultFormReactiveOptions: ICrudFormOptions;
 /**
- * @description Event emitted when the viewport/window size changes.
- * @summary Provides the new width and height in pixels for responsive handlers.
- *
- * Typical usage: subscribed by UI layout services or components to react to
- * window resizing and adjust layouts or trigger reflows.
- *
- * @example
- * const e: IWindowResizeEvent = { width: window.innerWidth, height: window.innerHeight };
+ * @description Mapping of select field interface types used in Ionic components.
+ * @summary Provides a set of supported select interface types for Ionic select fields,
+ * mapping human-readable keys to their corresponding `SelectInterface` string values.
+ * This allows for consistent usage and reference of select interface types throughout the application.
+ * @type {Record<string, SelectInterface>}
+ * @property {string} PopOver - Represents the 'popover' select interface.
+ * @property {string} Alert - Represents the 'alert' select interface.
+ * @property {string} ActionSheet - Represents the 'action-sheet' select interface.
+ * @property {string} modal - Represents the 'modal' select interface.
+ * @const SelectFieldInterfaces
+ * @memberOf module:lib/engine/constants
  */
-interface IWindowResizeEvent {
-    /** The new width of the window (innerWidth) in pixels */
-    width: number;
-    /** The new height of the window (innerHeight) in pixels */
-    height: number;
-}
-interface IFileUploadError {
-    name: string;
-    size?: number;
-    error: string;
-}
-interface ITabItem {
-    title?: string;
-    description?: string;
-    url?: string;
-    value?: string;
-    icon?: string;
-}
-interface IRepositoryModelProps<M extends Model> {
-    repository: DecafRepository<M>;
-    model: M;
-    modelName?: string;
-    pk: string;
-    pkType: string;
-}
-interface ILayoutModelContext {
-    context: IRepositoryModelProps<Model> & {
-        data: KeyValue;
-    };
-    models: IRepositoryModelProps<Model>[];
-}
+declare const SelectFieldInterfaces: {
+    readonly POPOVER: "popover";
+    readonly ALERT: "alert";
+    readonly ACTION_SHEET: "action-sheet";
+    readonly MODAL: "modal";
+};
 
 /**
  * @module NgxMediaService
@@ -1012,6 +1012,8 @@ declare class NgxTranslateService extends DecafTranslateService implements Decaf
     get(key: string | string[], params?: InterpolationParameters | string): Promise<string>;
     use(lang: string): void;
     setFallbackLang(lang: string): Observable<InterpolatableTranslationObject>;
+    getCurrentLang(): Language;
+    getOnCache(lang?: string): Translation;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxTranslateService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NgxTranslateService>;
 }
@@ -2092,6 +2094,7 @@ type CrudEvent<M extends Model> = IBaseCustomEvent & ICrudFormEvent & CustomEven
     data: M;
     role?: CrudOperations;
 };
+type FilterCondition = 'Equal' | 'Contains' | 'Not Contains' | 'Greater Than' | 'Less Than' | 'Not Equal';
 
 /**
  * @module lib/engine/NgxPageDirective
@@ -4896,7 +4899,7 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * @default []
      * @memberOf FilterComponent
      */
-    conditions: string[];
+    conditions: FilterCondition[];
     /**
      * @description Available sorting options for the filtered data.
      * @summary Defines the list of field names that can be used for sorting the filtered results.
@@ -4907,7 +4910,10 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * @default []
      * @memberOf FilterComponent
      */
-    sortOptions: string[];
+    sortOptions: {
+        label: string;
+        value: string;
+    }[];
     /**
      * @description Controls whether sorting functionality is disabled.
      * @summary When set to true, prevents the automatic merging of sort and indexes arrays,
@@ -5084,7 +5090,7 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * @returns {void}
      * @memberOf FilterComponent
      */
-    getIndexes(): string[];
+    getSortOptions(): Promise<string[]>;
     /**
      * @description Cleanup method called when the component is destroyed.
      * @summary Unsubscribes from window resize events to prevent memory leaks.
@@ -5191,11 +5197,11 @@ declare class FilterComponent extends NgxComponentDirective implements OnInit, O
      * Only value options can be removed individually; index and condition options are part
      * of the complete filter structure and cannot be removed separately.
      *
-     * @param {string} option - The filter option text to check
+     * @param {FilterCondition} option - The filter option to check
      * @returns {boolean} True if the option can be cleared individually, false otherwise
      * @memberOf FilterComponent
      */
-    allowClear(option: string): boolean;
+    allowClear(option: FilterCondition): boolean;
     /**
      * @description Removes a complete filter from the collection based on filter value.
      * @summary Removes a complete filter by matching the provided value against filter values
@@ -6757,6 +6763,15 @@ declare class PaginationComponent extends NgxComponentDirective implements OnIni
      * @memberOf PaginationComponent
      */
     last: number;
+    /**
+     * @description Determines whether to truncate the displayed pages in the pagination.
+     * @summary If true, the pagination component will display a subset of pages with ellipses to indicate skipped pages. If false, all pages will be displayed.
+     *
+     * @type {boolean}
+     * @default false
+     * @memberOf PaginationComponent
+     */
+    truncatePages: boolean;
     /**
      * @description Event emitter for pagination navigation events.
      * @summary Emits a custom event when users navigate between pages, either by clicking
@@ -9973,6 +9988,16 @@ declare class DecafFakerRepository<T extends Model> extends LoggedClass {
 }
 declare function getFakerData<T extends Model>(limit: number | undefined, data: Record<string, FunctionLike>, model?: string): T[];
 
+/**
+ * @module module:lib/i18n/Loader
+ * @description Internationalization loader and helpers for the for-angular package.
+ * @summary Provides an implementation of TranslateLoader (I18nLoader) and helper factories
+ * to load translation resources. Also exposes locale utilities used by components to resolve
+ * localized keys.
+ *
+ * @link {@link I18nLoader}
+ */
+
 /**
  * @description Retrieves the locale context for a given class, object, or string.
  * @summary Resolves the locale context by extracting the class name or using the provided suffix.
@@ -10028,6 +10053,8 @@ declare class I18nLoader implements TranslateLoader {
     private http;
     private resources;
     private versionedSuffix;
+    static enabled: boolean;
+    static cache: Record<string, TranslationObject>;
     /**
      * @param {HttpClient} http - The HTTP client used to fetch translation resources.
      * @param {I18nResourceConfig[]} [resources=[]] - The translation resources to be loaded.
@@ -10075,7 +10102,13 @@ declare class I18nParser extends TranslateParser {
  * @param {boolean} [versionedSuffix=false] - Whether to append a versioned suffix to resource URLs.
  * @returns {AngularProvider[]} - An array of providers for the translation service and loader.
  */
-declare function provideDecafI18nConfig(config?: RootTranslateServiceConfig, resources?: I18nResourceConfigType, versionedSuffix?: boolean): AngularProvider[];
+declare function provideDecafI18nConfig(config?: RootTranslateServiceConfig, resources?: I18nResourceConfigType, versionedSuffix?: boolean, enabled?: boolean): AngularProvider[];
+declare class DecafTranslatePipe implements PipeTransform {
+    translate: TranslateService;
+    transform(value: string, ...args: []): unknown;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DecafTranslatePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<DecafTranslatePipe, "translate", true>;
+}
 
 /**
  * @module lib/for-angular-common.module
@@ -10129,5 +10162,5 @@ declare class ForAngularCommonModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<ForAngularCommonModule>;
 }
 
-export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_FLAVOUR_TOKEN, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, ModalComponent, ModalConfirmComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxRouterService, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SelectFieldInterfaces, SteppedFormComponent, TableComponent, WindowColorSchemes, cleanSpaces, dataMapper, decafPageTransition, filterString, formatDate, generateRandomValue, getDbAdapterFlavour, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getMenuIcon, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxModalCrudComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, patternValidators, presentModalConfirm, presentNgxInlineModal, presentNgxLightBoxModal, provideDecafDarkMode, provideDecafDbAdapter, provideDecafDynamicComponents, provideDecafI18nConfig, provideDecafI18nLoader, provideDecafPageTransition, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
-export type { ActionRole, AngularDynamicOutput, AngularFieldDefinition, AngularProvider, CheckboxOption, ComparisonValidationKey, ComponentMetadata, CrudEvent, CrudFieldOption, DecafComponentConstructor, 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, ILayoutModelContext, IListComponentRefreshEvent, IListEmptyOptions, IListItemCustomEvent, IMenuItem, IModelComponentSubmitEvent, IPaginationCustomEvent, IRenderedModel, IRepositoryModelProps, ISortObject, ITabItem, IWindowResizeEvent, InputOption, KeyValue, LayoutGridGap, ListItemPosition, PossibleInputTypes, PropsMapperFn, RadioOption, RawQuery, SelectOption, StringOrBoolean, WindowColorScheme };
+export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_FLAVOUR_TOKEN, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DecafTranslatePipe, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, ModalComponent, ModalConfirmComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxRouterService, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SelectFieldInterfaces, SteppedFormComponent, TableComponent, WindowColorSchemes, cleanSpaces, dataMapper, decafPageTransition, filterString, formatDate, generateRandomValue, getDbAdapterFlavour, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getMenuIcon, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxModalCrudComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, patternValidators, presentModalConfirm, presentNgxInlineModal, presentNgxLightBoxModal, provideDecafDarkMode, provideDecafDbAdapter, provideDecafDynamicComponents, provideDecafI18nConfig, provideDecafI18nLoader, provideDecafPageTransition, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
+export type { ActionRole, AngularDynamicOutput, AngularFieldDefinition, AngularProvider, CheckboxOption, ComparisonValidationKey, ComponentMetadata, CrudEvent, CrudFieldOption, DecafComponentConstructor, DecafRepository, DecafRepositoryAdapter, ElementPosition, ElementSize, FieldUpdateMode, FilterCondition, FlexPosition, FormParent, FormParentGroup, FormServiceControl, FormServiceControls, FunctionLike, HTML5InputType, HTMLFormTarget, I18nResourceConfig, I18nResourceConfigType, I18nToken, IBaseCustomEvent, IComponentConfig, IComponentHolder, IComponentProperties, ICrudFormEvent, ICrudFormOptions, IFieldSetItem, IFieldSetValidationEvent, IFileUploadError, IFilterQuery, IFilterQueryItem, IFormComponentProperties, IFormElement, ILayoutModelContext, IListComponentRefreshEvent, IListEmptyOptions, IListItemCustomEvent, IMenuItem, IModelComponentSubmitEvent, IPaginationCustomEvent, IRenderedModel, IRepositoryModelProps, ISortObject, ITabItem, IWindowResizeEvent, InputOption, KeyValue, LayoutGridGap, ListItemPosition, PossibleInputTypes, PropsMapperFn, RadioOption, RawQuery, SelectOption, StringOrBoolean, WindowColorScheme };