@nettyapps/ntybase 0.0.1 → 0.0.3

package/index.d.ts

@@ -1,15 +1,16 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy, OnInit, ElementRef } from '@angular/core';
+import { OnInit, OnChanges, SimpleChanges, DoCheck, OnDestroy, ElementRef } from '@angular/core';
 import { TranslateService } from '@ngx-translate/core';
 import { Observable, Subject } from 'rxjs';
 import { Theme as Theme$1, GridApi, GridOptions, StatusPanelDef, GridReadyEvent } from 'ag-grid-community';
+import { MatDialog, MatDialogRef } from '@angular/material/dialog';
 import { Router, ActivatedRoute, CanActivate, ActivatedRouteSnapshot, RouterStateSnapshot, CanDeactivate } from '@angular/router';
 import { MatSnackBar } from '@angular/material/snack-bar';
-import { MatDialog, MatDialogRef } from '@angular/material/dialog';
 import { HttpClient, HttpInterceptor, HttpRequest, HttpHandler, HttpEvent } from '@angular/common/http';
 import { EnvironmentProxy } from '@nettyapps/ntycontract';
+import { NgForm, FormGroup, FormControl } from '@angular/forms';
+import * as XLSX from 'xlsx';
 import { ICellRendererAngularComp } from 'ag-grid-angular';
-import { FormGroup, FormControl } from '@angular/forms';
 import { I18nService } from '@nettyapps/ntyi18n';
 import { MatAutocompleteTrigger, MatAutocompleteSelectedEvent } from '@angular/material/autocomplete';
 import { ErrorStateMatcher } from '@angular/material/core';
@@ -120,13 +121,26 @@ declare class CommonService {
     private location;
     private datePipe;
     private alertService;
+    protected dialog: MatDialog;
     rightSidenavOpen: _angular_core.WritableSignal<boolean>;
     toggleRightSidenav(open: boolean): void;
+    /**
+     * Normalizes Turkish text for search and comparison operations by converting
+     * Turkish special characters to their English equivalents and lowercasing.
+     *
+     */
     normalizeTurkish(text: string): string;
     /**
      * Gets the clean URL path without fragments or query params
      */
     getCleanUrlPath(): string;
+    /**
+     * Clears the right sidenav outlet and resets the UI state.
+     * Removes the right sidenav route while keeping the main content and query parameters.
+     * Also collapses the sidenav and closes any open dialogs.
+     */
+    clearOutlet(): void;
+    ngOnDestroy(): void;
     /** Merge columns with the given seperator
      *
      * @param columns string array to merge
@@ -174,11 +188,11 @@ declare class CommonService {
     /** Read-only Signal for external components to observe updates */
     updates: _angular_core.Signal<{
         type: string;
-        action: "add" | "update" | "delete";
+        action: "add" | "update";
         data: any;
     } | null>;
     /** Broadcasts grid data changes to subscribers */
-    notifyUpdate(type: string, action: 'add' | 'update' | 'delete', data: any): void;
+    notifyUpdate(type: string, action: 'add' | 'update', data: any): void;
     /** User is not allowed to access the page
      *
      */
@@ -196,7 +210,7 @@ declare class AlertService {
     showAlert(message: string, action?: string, duration?: number): void;
     showConfirm(message: string): Promise<boolean>;
     showSuccess(message: string, duration?: number): void;
-    showError(message: string, duration?: number): void;
+    showError(error: any, duration?: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AlertService>;
 }
@@ -226,11 +240,12 @@ declare class SysfunctionProxy {
 
 declare abstract class AgGridBase<T extends {
     [key: string]: any;
-}> {
+}> implements OnInit, OnChanges {
     readOnly: _angular_core.InputSignal<boolean>;
     popupFilterValid: _angular_core.InputSignal<boolean>;
     popupValid: _angular_core.InputSignal<boolean>;
     params: _angular_core.InputSignal<any>;
+    parameters: _angular_core.InputSignal<string>;
     protected authenticationList: Array<NettySecurity>;
     protected accessRightsProcessed: _angular_core.WritableSignal<boolean>;
     allowAdd: _angular_core.WritableSignal<boolean>;
@@ -276,6 +291,14 @@ declare abstract class AgGridBase<T extends {
     statusBar: {
         statusPanels: StatusPanelDef[];
     };
+    /**
+     * Component initialization lifecycle hook
+     */
+    ngOnInit(): Promise<void>;
+    /**
+     * Handle input changes for route parameters
+     */
+    ngOnChanges(changes: SimpleChanges): void;
     protected onGridReady(params: GridReadyEvent): void;
     onFirstDataRendered(params: any): void;
     saveGrid(params: any): void;
@@ -285,8 +308,6 @@ declare abstract class AgGridBase<T extends {
      * Handle back button click
      */
     backClicked(): void;
-    deleteSelected(): Promise<void>;
-    refreshData(): Promise<void>;
     gotoURL(routePrefix: string[], rightSidenav: string[] | undefined, parameters: string, type?: string, isNewTab?: boolean, embedded?: boolean, dialogComponent?: any): void;
     popupGotoURL(urlSegments: string[]): void;
     /**
@@ -304,34 +325,34 @@ declare abstract class AgGridBase<T extends {
      * @param idField The field name that serves as unique identifier (default: 'id')
      */
     protected updateRowInGrid(rowData: T, idField?: string): void;
-    /**
-     * Delete a row from the grid
-     * @param rowData The row to delete
-     */
-    protected deleteRowFromGrid(rowData: T): void;
+    deleteSelected(): Promise<void>;
+    refreshData(): Promise<void>;
     setAccessRights(): Promise<boolean>;
-    protected abstract loadData(): void;
+    protected abstract loadData(filter?: string): void;
+    protected abstract initAgGrid(): void;
     protected onBtnClick?(e: T): void;
-    protected abstract loadFreshData(): Promise<T[]>;
-    protected abstract deleteRows(rows: T[]): void;
+    protected deleteRows?(rows: T[]): void;
     protected getEntityType?(): string;
+    protected selectedData?(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AgGridBase<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AgGridBase<any>, "ntybase-ag-grid-base", never, { "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "popupFilterValid": { "alias": "popupFilterValid"; "required": false; "isSignal": true; }; "popupValid": { "alias": "popupValid"; "required": false; "isSignal": true; }; "params": { "alias": "params"; "required": false; "isSignal": true; }; "filterField": { "alias": "filterField"; "required": false; "isSignal": true; }; "filterFieldValue": { "alias": "filterFieldValue"; "required": false; "isSignal": true; }; "filterFieldNumeric": { "alias": "filterFieldNumeric"; "required": false; "isSignal": true; }; "filterFieldEquality": { "alias": "filterFieldEquality"; "required": false; "isSignal": true; }; }, { "selectedElement": "selectedElement"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AgGridBase<any>, "ntybase-ag-grid-base", never, { "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "popupFilterValid": { "alias": "popupFilterValid"; "required": false; "isSignal": true; }; "popupValid": { "alias": "popupValid"; "required": false; "isSignal": true; }; "params": { "alias": "params"; "required": false; "isSignal": true; }; "parameters": { "alias": "parameters"; "required": false; "isSignal": true; }; "filterField": { "alias": "filterField"; "required": false; "isSignal": true; }; "filterFieldValue": { "alias": "filterFieldValue"; "required": false; "isSignal": true; }; "filterFieldNumeric": { "alias": "filterFieldNumeric"; "required": false; "isSignal": true; }; "filterFieldEquality": { "alias": "filterFieldEquality"; "required": false; "isSignal": true; }; }, { "selectedElement": "selectedElement"; }, never, never, true, never>;
 }
 
 type UserViewMode = 'fullscreen' | 'sidenav' | 'dialog';
-declare abstract class AgGridSaveBase<T> {
+declare abstract class AgGridSaveBase<T> implements DoCheck {
     protected router: Router;
     protected route: ActivatedRoute;
     protected commonService: CommonService;
     protected alertService: AlertService;
+    viewMode: _angular_core.WritableSignal<UserViewMode>;
+    parameters: _angular_core.InputSignal<string>;
+    embedded: _angular_core.InputSignal<boolean>;
     currentItem: _angular_core.WritableSignal<T>;
     initialItem: T;
     formChanged: boolean;
-    viewMode: _angular_core.WritableSignal<UserViewMode>;
+    saveForm: NgForm;
     protected dialogRef: MatDialogRef<any, any> | null;
     protected dialogData: any;
-    embedded: _angular_core.InputSignal<boolean>;
     closeAfterSave: _angular_core.ModelSignal<boolean>;
     setCloseAfterSave(value: boolean): void;
     updateValid: _angular_core.WritableSignal<boolean>;
@@ -340,6 +361,15 @@ declare abstract class AgGridSaveBase<T> {
      * Determine view mode based on current route
      */
     protected determineViewMode(): void;
+    /**
+     * Set data to the form while preserving any unsaved changes
+     * @param item - Data object of type T to populate the form
+     */
+    protected initializeFormData(item: T): void;
+    /**
+     * @param data - Data to populate the new instance
+     */
+    protected createItemInstance(data: Partial<T>): T;
     /**
      * Check for form changes
      */
@@ -349,13 +379,30 @@ declare abstract class AgGridSaveBase<T> {
      * Check if can deactivate component
      */
     canDeactivate(): Promise<boolean>;
+    protected getGuidFromParameters(): string;
+    ngOnChanges(changes: SimpleChanges): void;
     /**
      * Close sidenav or navigate back
      */
     closeSidenav(): void;
     backClicked(): void;
+    protected abstract loadDetailData(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AgGridSaveBase<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AgGridSaveBase<any>, "ntybase-ag-grid-save-base", never, { "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; "closeAfterSave": { "alias": "closeAfterSave"; "required": false; "isSignal": true; }; }, { "closeAfterSave": "closeAfterSaveChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AgGridSaveBase<any>, "ntybase-ag-grid-save-base", never, { "parameters": { "alias": "parameters"; "required": false; "isSignal": true; }; "embedded": { "alias": "embedded"; "required": false; "isSignal": true; }; "closeAfterSave": { "alias": "closeAfterSave"; "required": false; "isSignal": true; }; }, { "closeAfterSave": "closeAfterSaveChange"; }, never, never, true, never>;
+}
+
+type AOA = string[][];
+declare abstract class ExcelImportBase extends AgGridBase<any> {
+    protected dataList: AOA;
+    protected wopts: XLSX.WritingOptions;
+    protected fileName: string;
+    protected isDataValidated: boolean;
+    /*******************************
+     *** EXCEL UPLOAD FUNCTIONS  ***
+     *******************************/
+    onFileChange(evt: any): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ExcelImportBase, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ExcelImportBase, "ntybase-excel-import-base", never, {}, {}, never, never, true, never>;
 }
 
 declare class ButtonRenderer implements ICellRendererAngularComp {
@@ -736,7 +783,7 @@ declare class LeftSidenav implements OnInit {
 }
 
 interface AppTheme {
-    name: 'light' | 'dark' | 'system';
+    name: 'light' | 'dark';
     icon: string;
 }
 declare class Theme {
@@ -744,7 +791,7 @@ declare class Theme {
     private themes;
     selectedTheme: _angular_core.Signal<AppTheme | undefined>;
     getThemes(): AppTheme[];
-    setTheme(theme: 'light' | 'dark' | 'system'): void;
+    setTheme(theme: 'light' | 'dark'): void;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Theme, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<Theme>;
@@ -867,6 +914,11 @@ declare class Guid {
     static emptyWhenNull(guid: any): any;
 }
 
+declare class Filter {
+    value: any;
+    text: any;
+}
+
 declare class NettyMenuService {
     private http;
     private environmentProxy;
@@ -878,5 +930,5 @@ declare class NettyMenuService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<NettyMenuService>;
 }
 
-export { AgGridBase, AgGridSaveBase, AlertService, AuthenticationGuard, AuthenticationInterceptor, AuthenticationService, AutoComplete, ButtonRenderer, CanDeactivateGuard, CheckboxRenderer, ColorPalette, CommonService, ConfirmDialog, CredentialsService, CurrentUserPreference, ForgotPassword, Guid, HttpError403, HttpError404, LeftSidenav, Login, LoginDto, MFACodeDto, MfaLogin, NettyAgGridService, NettyHelper, NettyMenuService, Ntybase, NtybaseModule, SelectionItem, Theme, Toolbar, UrlHelperService };
+export { AgGridBase, AgGridSaveBase, AlertService, AuthenticationGuard, AuthenticationInterceptor, AuthenticationService, AutoComplete, ButtonRenderer, CanDeactivateGuard, CheckboxRenderer, ColorPalette, CommonService, ConfirmDialog, CredentialsService, CurrentUserPreference, ExcelImportBase, Filter, ForgotPassword, Guid, HttpError403, HttpError404, LeftSidenav, Login, LoginDto, MFACodeDto, MfaLogin, NettyAgGridService, NettyHelper, NettyMenuService, Ntybase, NtybaseModule, SelectionItem, Theme, Toolbar, UrlHelperService };
 export type { AppTheme, CanComponentDeactivate, ColorTheme, Credentials, LoginContext, MFACodeContext, UserViewMode };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@nettyapps/ntybase",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "peerDependencies": {
-    "@angular/common": "^20.0.0",
-    "@angular/core": "^20.0.0"
+    "@angular/common": "^20.1.7",
+    "@angular/core": "^20.1.7"
   },
   "dependencies": {
     "tslib": "^2.3.0"