@decaf-ts/for-angular 0.0.73 → 0.0.76

package/index.d.ts

@@ -5,12 +5,12 @@ import { TextFieldTypes, SelectInterface, AutocompleteTypes, CheckboxCustomEvent
 import * as i2 from '@angular/forms';
 import { FormGroup, FormControl, FormArray, ControlValueAccessor, AbstractControl } from '@angular/forms';
 import { OrderDirection, Repository, Adapter, EventIds, AttributeOption, Observer, Paginator, Condition } from '@decaf-ts/core';
-import { FieldProperties, IPagedComponentProperties, CrudOperationKeys, UIFunctionLike, HTML5InputTypes, DecafComponent, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, UIElementMetadata, RenderingEngine, DecafEventHandler } from '@decaf-ts/ui-decorators';
+import { CrudOperationKeys, FieldProperties, IPagedComponentProperties, UIFunctionLike, HTML5InputTypes, DecafComponent, UIModelMetadata, FieldDefinition, UIMediaBreakPointsType, UIElementMetadata, RenderingEngine, DecafEventHandler } from '@decaf-ts/ui-decorators';
 import * as _decaf_ts_decorator_validation from '@decaf-ts/decorator-validation';
 import { VALIDATION_PARENT_KEY, Model, ModelConstructor } from '@decaf-ts/decorator-validation';
 import * as _ionic_angular_standalone from '@ionic/angular/standalone';
-import { ModalOptions, SelectCustomEvent, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
-import { RepositoryFlags, Context, CrudOperations, OperationKeys, IRepository } from '@decaf-ts/db-decorators';
+import { ModalOptions, LoadingOptions, SelectCustomEvent, ItemReorderEventDetail, IonModal } from '@ionic/angular/standalone';
+import { OperationKeys, RepositoryFlags, Context, CrudOperations, IRepository } from '@decaf-ts/db-decorators';
 import { Constructor } from '@decaf-ts/decoration';
 import { Router } from '@angular/router';
 import * as i1 from '@angular/common';
@@ -19,6 +19,7 @@ import * as i3 from '@ngx-translate/core';
 import { TranslateService, TranslateLoader, TranslationObject, TranslateParser, RootTranslateServiceConfig } from '@ngx-translate/core';
 import { Observable, Subject, Subscription } from 'rxjs';
 import { HttpClient } from '@angular/common/http';
+import { OverlayBaseController } from '@ionic/angular/common';
 import { SafeHtml, DomSanitizer, Title } from '@angular/platform-browser';
 import { NavigationOptions } from '@ionic/angular/common/providers/nav-controller';
 import { FunctionLike as FunctionLike$1 } from 'src/lib/engine';
@@ -49,6 +50,10 @@ declare const ActionRoles: {
     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";
@@ -667,6 +672,7 @@ interface I18nToken {
  */
 interface ICrudFormEvent extends IBaseCustomEvent {
     handlers?: Record<string, unknown>;
+    role: (typeof ActionRoles)[keyof typeof ActionRoles] & CrudOperationKeys;
 }
 /**
  * @description Pagination custom event
@@ -1598,6 +1604,17 @@ declare abstract class NgxComponentDirective extends DecafComponent implements O
      * @type {Location}
      */
     location: Location;
+    /**
+     * @description Ionic loading overlay manager available to derived components.
+     * @summary Provides convenient access to Ionic's LoadingController, enabling directive
+     * subclasses to create, present, and dismiss loading overlays without wiring the
+     * service themselves. Use this helper to surface async progress indicators tied to
+     * CRUD operations, navigation, or any long-running UI task.
+     * @type {LoadingController}
+     * @returns {OverlayBaseController<LoadingOptions, HTMLIonLoadingElement>}
+     * @memberOf module:lib/engine/NgxComponentDirective
+     */
+    protected loadingController: OverlayBaseController<LoadingOptions, HTMLIonLoadingElement>;
     /**
      * @description Flag indicating if the component is rendered as a child of a modal dialog.
      * @summary Determines whether this component instance is being displayed within a modal
@@ -1613,6 +1630,15 @@ declare abstract class NgxComponentDirective extends DecafComponent implements O
     isModalChild: boolean;
     protected handlers: Record<string, UIFunctionLike>;
     protected events: Record<string, UIFunctionLike>;
+    /**
+     * @description Custom parser invoked whenever the directive receives raw values.
+     * @summary Allows callers to inject a reusable parsing function that normalizes or
+     * coerces inbound component data (form inputs, handler payloads, etc.) before the
+     * directive consumes it. Use this hook to apply business rules or format conversions
+     * without modifying internal directive logic.
+     * @type {UIFunctionLike}
+     * @memberOf module:lib/engine/NgxComponentDirective
+     */
     valueParserFn: UIFunctionLike;
     /**
      * @description Indicates whether a refresh operation is in progress.
@@ -3046,7 +3072,6 @@ declare class CrudFieldComponent extends NgxFormFieldDirective implements OnInit
      * @memberOf CrudFieldComponent
      */
     translatable: boolean;
-    private loadingController;
     constructor();
     /**
      * @description Component initialization lifecycle method.
@@ -3417,6 +3442,7 @@ declare abstract class NgxFormDirective extends NgxParentComponentDirective impl
      */
     handleReset(): void;
     submit(event?: SubmitEvent, eventName?: string, componentName?: string): Promise<boolean | void>;
+    protected submitEventEmit(data: unknown, componentName?: string, eventName?: string, handlers?: Record<string, UIFunctionLike>): void;
     /**
     * @description Updates the active form group and children for the specified page.
     * @summary Extracts the FormGroup for the given page from the FormArray and filters
@@ -5521,7 +5547,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      * @returns {KeyValue} A mapper object that contains string values mapped to the
      * component's public keys.
      */
-    protected get _mapper(): KeyValue;
+    protected getMapper(): Promise<KeyValue>;
     /**
      * @description Refreshes the list data from the configured source.
      * @summary This method handles both initial data loading and subsequent refresh operations,
@@ -5580,13 +5606,13 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      * the appropriate list operations. This includes adding new items, updating existing
      * ones, or removing deleted items from the list display.
      *
-     * @param {string} table - The table/model name that changed
+     * @param {UIFunctionLike} clazz - The model instance that changed
      * @param {OperationKeys} event - The type of operation (CREATE, UPDATE, DELETE)
      * @param {string | number} uid - The unique identifier of the affected item
      * @returns {Promise<void>}
      * @memberOf ListComponent
      */
-    handleObserveEvent(table: string, event: OperationKeys, uid: string | number): Promise<void>;
+    handleObserveEvent(clazz: UIFunctionLike, event: OperationKeys, uid: string | number): Promise<void>;
     /**
      * @description Function for tracking items in the list.
      * @summary Provides a tracking function for the `*ngFor` directive in the component template.
@@ -5851,7 +5877,7 @@ declare class ListComponent extends NgxComponentDirective implements OnInit, OnD
      *
      * @memberOf ListComponent
      */
-    mapResults(data: KeyValue[]): KeyValue[];
+    mapResults(data: KeyValue[]): Promise<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; }; "searchbarPlaceholder": { "alias": "searchbarPlaceholder"; "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>;
@@ -8157,7 +8183,7 @@ declare class TableComponent extends ListComponent implements OnInit {
     ngOnInit(): Promise<void>;
     protected getFilterOptions(): Promise<void>;
     protected itemMapper(item: KeyValue, mapper: KeyValue, props?: KeyValue): KeyValue;
-    mapResults(data: KeyValue[]): KeyValue[];
+    mapResults(data: KeyValue[]): Promise<KeyValue[]>;
     handleAction(event: Event, action: CrudOperations, uid: string): Promise<void>;
     openFilterSelectOptions(event: Event): Promise<void>;
     handleFilterSelectClear(event: CustomEvent): Promise<void>;
@@ -9279,18 +9305,6 @@ declare abstract class NgxModelPageDirective extends NgxPageDirective {
      *  @memberOf ModelPage
      */
     modelName: string;
-    /**
-     * @description Array of operations allowed for the current model instance.
-     * @summary Dynamically determined list of operations that are permitted based on
-     * the current context and model state. Initially contains CREATE and READ operations,
-     * with UPDATE and DELETE added when a modelId is present. This controls which
-     * action buttons are displayed and which operations are accessible to the user.
-     *
-     * @type {OperationKeys[]}
-     * @default [OperationKeys.CREATE, OperationKeys.READ]
-     * @memberOf ModelPage
-     */
-    allowedOperations: OperationKeys[];
     /**
      * @description Current model data loaded from the repository.
      * @summary Stores the raw data object representing the current model instance retrieved

package/package.json

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