@decaf-ts/for-angular 0.0.54 → 0.0.56

package/index.d.ts

@@ -10,7 +10,7 @@ import * as _decaf_ts_decorator_validation from '@decaf-ts/decorator-validation'
 import { Model, VALIDATION_PARENT_KEY, ModelConstructor } from '@decaf-ts/decorator-validation';
 import { RepositoryFlags, Context, CrudOperations, OperationKeys, IRepository } from '@decaf-ts/db-decorators';
 import * as _ionic_angular_standalone from '@ionic/angular/standalone';
-import { ModalOptions, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
+import { ModalOptions, SelectCustomEvent, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
 import { Constructor } from '@decaf-ts/decoration';
 import { Router } from '@angular/router';
 import * as i1 from '@angular/common';
@@ -21,7 +21,7 @@ import { HttpClient } from '@angular/common/http';
 import { Observable, Subscription } from 'rxjs';
 import { SafeHtml, DomSanitizer, Title } from '@angular/platform-browser';
 import { InjectablesRegistry } from '@decaf-ts/injectable-decorators';
-import { Logger } from '@decaf-ts/logging';
+import { LoggedClass, Logger } from '@decaf-ts/logging';
 
 /**
  * @module lib/engine/interfaces
@@ -1095,6 +1095,7 @@ declare class NgxMediaService {
      * @return {Document} The global `document` object.
      */
     private get _document();
+    darkModeEnabled(): boolean;
     /**
      * @description Observes window resize events and emits the updated dimensions.
      * @summary
@@ -2421,7 +2422,22 @@ declare abstract class NgxFormFieldDirective extends NgxComponentDirective imple
      * @public
      */
     setValue(value: unknown): void;
-    handleModalChildChanges(): void;
+    /**
+     * @description Clears the current form control value as a response to a UI interact
+     * @summary Set field value as undefined and prevents event propagation.
+     * @param {Event} event - The value to set
+     * @return {void}
+     * @public
+     */
+    handleClearValue(event: Event): void;
+    /**
+     * @description Handles IonSelect change events emitted from modal child components.
+     * @summary Forces change detection when rendered inside a modal and synchronizes the select value with the directive state.
+     * @param {SelectCustomEvent<SelectChangeEventDetail>} event - IonSelect change event containing the selected value.
+     * @return {void}
+     * @public
+     */
+    handleModalChildChanges(event?: SelectCustomEvent): void;
     /**
      * @description Retrieves validation error messages for the field.
      * @summary Checks the form control for validation errors and returns formatted error messages.
@@ -3779,7 +3795,7 @@ declare class EmptyStateComponent extends CardComponent implements OnInit {
      *   - A Promise resolving to the navigation result if buttonLink is a URL
      * @memberOf EmptyStateComponent
      */
-    handleClick(): boolean | void | Promise<boolean> | FunctionLike;
+    handleClick(): Promise<void>;
     /**
       * @description Generates a localized and sanitized subtitle for search results.
       * @summary This method takes a content string, typically the subtitle, and processes it
@@ -4117,7 +4133,7 @@ declare class FieldsetComponent extends NgxFormDirective implements OnInit, Afte
      * @memberOf FieldsetComponent
      */
     ngAfterViewInit(): Promise<void>;
-    refresh(): Promise<void>;
+    refresh(operation: CrudOperationKeys): Promise<void>;
     /**
      * @description Handles removal of the fieldset with slide animation.
      * @summary Initiates the removal process for the fieldset with a smooth slide-up animation.
@@ -5175,7 +5191,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      * @type {string | KeyValue | undefined}
      * @memberOf ListComponent
      */
-    sortDirection: OrderDirection;
+    sortBy: string;
     /**
      * @description Sorting parameters for data fetching.
      * @summary Specifies how the fetched data should be sorted. This can be provided
@@ -5184,7 +5200,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      * @type {string | KeyValue | undefined}
      * @memberOf ListComponent
      */
-    sortBy: string;
+    sortDirection: OrderDirection;
     /**
      * @description Controls whether sorting functionality is disabled.
      * @summary When set to true, disables the sort controls and prevents users from
@@ -5735,7 +5751,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
     mapResults(data: KeyValue[]): KeyValue[];
     parseSearchValue(): string | IFilterQuery;
     static ɵfac: i0.ɵɵFactoryDeclaration<ListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ListComponent, "ngx-decaf-list", never, { "type": { "alias": "type"; "required": false; }; "showSearchbar": { "alias": "showSearchbar"; "required": false; }; "data": { "alias": "data"; "required": false; }; "source": { "alias": "source"; "required": false; }; "start": { "alias": "start"; "required": false; }; "limit": { "alias": "limit"; "required": false; }; "loadMoreData": { "alias": "loadMoreData"; "required": false; }; "lines": { "alias": "lines"; "required": false; }; "inset": { "alias": "inset"; "required": false; }; "scrollThreshold": { "alias": "scrollThreshold"; "required": false; }; "scrollPosition": { "alias": "scrollPosition"; "required": false; }; "loadingText": { "alias": "loadingText"; "required": false; }; "showRefresher": { "alias": "showRefresher"; "required": false; }; "createButton": { "alias": "createButton"; "required": false; }; "loadingSpinner": { "alias": "loadingSpinner"; "required": false; }; "enableFilter": { "alias": "enableFilter"; "required": false; }; "sortDirection": { "alias": "sortDirection"; "required": false; }; "sortBy": { "alias": "sortBy"; "required": false; }; "disableSort": { "alias": "disableSort"; "required": false; }; "empty": { "alias": "empty"; "required": false; }; }, { "clickEvent": "clickEvent"; }, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ListComponent, "ngx-decaf-list", never, { "type": { "alias": "type"; "required": false; }; "showSearchbar": { "alias": "showSearchbar"; "required": false; }; "data": { "alias": "data"; "required": false; }; "source": { "alias": "source"; "required": false; }; "start": { "alias": "start"; "required": false; }; "limit": { "alias": "limit"; "required": false; }; "loadMoreData": { "alias": "loadMoreData"; "required": false; }; "lines": { "alias": "lines"; "required": false; }; "inset": { "alias": "inset"; "required": false; }; "scrollThreshold": { "alias": "scrollThreshold"; "required": false; }; "scrollPosition": { "alias": "scrollPosition"; "required": false; }; "loadingText": { "alias": "loadingText"; "required": false; }; "showRefresher": { "alias": "showRefresher"; "required": false; }; "createButton": { "alias": "createButton"; "required": false; }; "loadingSpinner": { "alias": "loadingSpinner"; "required": false; }; "enableFilter": { "alias": "enableFilter"; "required": false; }; "sortBy": { "alias": "sortBy"; "required": false; }; "sortDirection": { "alias": "sortDirection"; "required": false; }; "disableSort": { "alias": "disableSort"; "required": false; }; "empty": { "alias": "empty"; "required": false; }; }, { "clickEvent": "clickEvent"; }, never, ["*"], true, never>;
 }
 
 /**
@@ -7242,6 +7258,16 @@ declare class ModalComponent extends NgxParentComponentDirective implements OnIn
  * @returns {Promise<IonModal>} - A promise that resolves with the modal instance.
  */
 declare function getNgxModalComponent(props?: Partial<ModalComponent>, modalProps?: Partial<ModalOptions>, injector?: EnvironmentInjector): Promise<IonModal>;
+/**
+ * @description Retrieves a modal component instance.
+ * @summary Creates and initializes a modal component with the provided properties and options.
+ *
+ * @param {Partial<ModalComponent>} [props={}] - Properties to initialize the modal component.
+ * @param {Partial<ModalOptions>} [modalProps={}] - Additional modal options.
+ * @param {EnvironmentInjector} [injector] - Optional environment injector for dependency injection.
+ * @returns {Promise<IonModal>} - A promise that resolves with the modal instance.
+ */
+declare function getNgxModalCrudComponent(model: Partial<Model>, props?: Partial<ModalComponent>, modalProps?: Partial<ModalOptions>, injector?: EnvironmentInjector): Promise<IonModal>;
 /**
  * @description Presents a lightbox modal with inline content.
  * @summary Displays a modal in lightbox mode with the specified content and properties.
@@ -7300,7 +7326,7 @@ declare class IconComponent implements OnInit {
     buttonShape: 'round' | 'default';
     width: string;
     size?: 'large' | 'small' | 'default';
-    type: 'image' | 'ionic';
+    type: 'image' | 'ionic' | 'icon';
     isSvg: boolean;
     initialized: boolean;
     inline: boolean;
@@ -8591,9 +8617,10 @@ declare class NgxFormService {
  */
 
 declare abstract class NgxEventHandler extends DecafEventHandler {
+    changeDetectorRef: ChangeDetectorRef;
     constructor();
-    refresh(args?: unknown[]): Promise<void>;
-    preview(args?: unknown[]): Promise<void>;
+    refresh(...args: unknown[]): Promise<void>;
+    preview(...args: unknown[]): Promise<void>;
 }
 
 /**
@@ -9253,12 +9280,23 @@ declare function isDarkMode(): Promise<boolean>;
  * @memberOf module:lib/helpers/utils
  */
 declare function filterString(original: string | string[], value: string, contain?: boolean): string;
+/**
+ * @summary Retrieves the icon associated with a menu item based on its label.
+ *
+ * @param {string} label - The label of the menu item to search for. The search is case-insensitive.
+ * @param {IMenuItem[]} menu - An array of menu items to search within.
+ * @returns {string} The icon associated with the menu item if found, otherwise an empty string.
+ */
+declare function getMenuIcon(label: string, menu: IMenuItem[]): string;
 
-declare class DecafFakerRepository<T extends Model> {
+declare class DecafFakerRepository<T extends Model> extends LoggedClass {
     protected model: string | Model;
     protected limit: number;
+    protected propFnMapper?: KeyValue;
     protected data: T[];
     protected _repository: DecafRepository<Model> | undefined;
+    protected pk: string | undefined;
+    protected pkType?: string;
     constructor(model: string | Model, limit?: number);
     protected get repository(): DecafRepository<Model>;
     initialize(): Promise<void>;
@@ -9395,6 +9433,7 @@ declare function provideDecafDbAdapter<DbAdapter extends {
  */
 declare const decafPageTransition: (baseEl: HTMLElement, opts?: KeyValue) => _ionic_angular_standalone.Animation;
 declare function provideDecafPageTransition(): EnvironmentProviders;
+declare function provideDecafDarkMode(): EnvironmentProviders;
 /**
  * @description Retrieves a logger instance for the given context.
  * @summary Creates or retrieves a namespaced logger instance using the Decaf logging system.
@@ -9560,5 +9599,5 @@ declare class I18nParser extends TranslateParser {
  */
 declare function provideDecafI18nConfig(config?: RootTranslateServiceConfig, resources?: I18nResourceConfigType, versionedSuffix?: boolean): AngularProvider[];
 
-export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentEventNames, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_PROVIDER, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, ElementPositions, ElementSizes, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, FormConstants, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, LayoutGridGaps, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, LoggerLevels, ModalComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SelectFieldInterfaces, SteppedFormComponent, WindowColorSchemes, cleanSpaces, dataMapper, decafPageTransition, filterString, formatDate, generateRandomValue, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxInlineModal, presentNgxLightBoxModal, provideDecafDbAdapter, provideDecafDynamicComponents, provideDecafI18nConfig, provideDecafI18nLoader, provideDecafPageTransition, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
+export { ActionRoles, AngularEngineKeys, BaseComponentProps, CPTKN, CardComponent, ComponentEventNames, ComponentRendererComponent, ComponentsTagNames, CrudFieldComponent, CrudFormComponent, CssClasses, DB_ADAPTER_PROVIDER, DB_ADAPTER_PROVIDER_TOKEN, DecafFakerRepository, DefaultFormReactiveOptions, DefaultListEmptyOptions, DefaultModalOptions, Dynamic, DynamicModule, ElementPositions, ElementSizes, EmptyStateComponent, FieldsetComponent, FileUploadComponent, FilterComponent, ForAngularCommonModule, ForAngularComponentsModule, FormConstants, I18N_CONFIG_TOKEN, I18nLoader, I18nLoaderFactory, I18nParser, IconComponent, LOCALE_ROOT_TOKEN, LayoutComponent, LayoutGridGaps, ListComponent, ListComponentsTypes, ListItemComponent, ListItemPositions, LoggerLevels, ModalComponent, ModelRendererComponent, NgxComponentDirective, NgxEventHandler, NgxFormDirective, NgxFormFieldDirective, NgxFormService, NgxMediaService, NgxModelPageDirective, NgxPageDirective, NgxParentComponentDirective, NgxRenderingEngine, NgxSvgDirective, PaginationComponent, RouteDirections, SearchbarComponent, SelectFieldInterfaces, SteppedFormComponent, WindowColorSchemes, cleanSpaces, dataMapper, decafPageTransition, filterString, formatDate, generateRandomValue, getFakerData, getInjectablesRegistry, getLocaleContext, getLocaleContextByKey, getLocaleFromClassName, getLocaleLanguage, getLogger, getMenuIcon, getModelAndRepository, getNgxInlineModal, getNgxModalComponent, getNgxModalCrudComponent, getNgxSelectOptionsModal, getOnWindow, getOnWindowDocument, getWindow, getWindowDocument, getWindowWidth, isDarkMode, isDevelopmentMode, isNotUndefined, isValidDate, itemMapper, parseToValidDate, presentNgxInlineModal, presentNgxLightBoxModal, provideDecafDarkMode, provideDecafDbAdapter, provideDecafDynamicComponents, provideDecafI18nConfig, provideDecafI18nLoader, provideDecafPageTransition, removeFocusTrap, setOnWindow, stringToBoolean, windowEventEmitter };
 export type { ActionRole, AngularDynamicOutput, AngularFieldDefinition, AngularProvider, CheckboxOption, ComponentMetadata, CrudFieldOption, DecafRepository, DecafRepositoryAdapter, ElementPosition, ElementSize, FieldUpdateMode, FlexPosition, FormParent, FormParentGroup, FormServiceControl, FormServiceControls, FunctionLike, HTML5InputType, HTMLFormTarget, I18nResourceConfig, I18nResourceConfigType, I18nToken, IBaseCustomEvent, IComponentConfig, IComponentHolder, IComponentProperties, ICrudFormEvent, ICrudFormOptions, IFieldSetItem, IFieldSetValidationEvent, IFileUploadError, IFilterQuery, IFilterQueryItem, IFormComponentProperties, IFormElement, IFormReactiveSubmitEvent, IListComponentRefreshEvent, IListEmptyOptions, IMenuItem, IModelComponentSubmitEvent, IPaginationCustomEvent, IRenderedModel, ISortObject, IWindowResizeEvent, InputOption, KeyValue, LayoutGridGap, ListItemCustomEvent, ListItemPosition, PossibleInputTypes, RadioOption, RawQuery, SelectOption, StringOrBoolean, WindowColorScheme };

package/package.json

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