bpm-core 0.0.125 → 0.0.127

package/lib/components/shared-components/action-buttons/action-buttons.component.d.ts

@@ -36,7 +36,7 @@ export declare class ActionButtonsComponent implements AfterViewInit {
     onSubmit(action: string): void;
     submitForm(action: string, section: Section): void;
     success(response: any): void;
-    buttonShape(item: any): "" | "outline";
+    buttonShape(item: any): "outline" | "";
     buttonColor(item: any): "" | "red";
     static ɵfac: i0.ɵɵFactoryDeclaration<ActionButtonsComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ActionButtonsComponent, "lib-action-buttons", never, { "lovOptions": { "alias": "lovOptions"; "required": false; }; "lovType": { "alias": "lovType"; "required": false; }; "fieldsForm": { "alias": "fieldsForm"; "required": false; }; "form": { "alias": "form"; "required": false; }; "section": { "alias": "section"; "required": false; }; "sections": { "alias": "sections"; "required": false; }; "showApprovalCycle": { "alias": "showApprovalCycle"; "required": false; }; "customCall": { "alias": "customCall"; "required": false; }; }, { "resetFormEmit": "resetFormEmit"; "customCallEmit": "customCallEmit"; }, never, never, true, never>;

package/lib/components/shared-components/form-field/attachment-section/attachment-section.component.d.ts

@@ -4,7 +4,10 @@ import { ControlValueAccessorDirective } from "../control-value-accessor.directi
 import { MatDialog } from "@angular/material/dialog";
 import { MatPaginator } from "@angular/material/paginator";
 import { MatTableDataSource } from "@angular/material/table";
+import { MatPaginatorIntl } from '@angular/material/paginator';
+import { CoreI18nService } from '../../../../services/i18n.service';
 import * as i0 from "@angular/core";
+export declare function getPaginatorIntl(i18nService: CoreI18nService): MatPaginatorIntl;
 export declare class AttachmentSectionComponent extends ControlValueAccessorDirective<any> implements AfterViewInit {
     className: string;
     downloadActionClicked: EventEmitter<any>;

package/lib/components/shared-components/form-field/doc-uploader/docs-uploader.component.d.ts

@@ -123,7 +123,7 @@ export declare class DocsUploaderComponent<Type> extends ControlValueAccessorDir
     private deleteFileContents;
     private reset;
     static ɵfac: i0.ɵɵFactoryDeclaration<DocsUploaderComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DocsUploaderComponent<any>, "app-file-uploader", never, { "useCrop": { "alias": "useCrop"; "required": false; }; "formKey": { "alias": "formKey"; "required": false; }; "showLabel": { "alias": "showLabel"; "required": false; }; "downloadLink": { "alias": "downloadLink"; "required": false; }; "showActions": { "alias": "showActions"; "required": false; }; "styleHeight": { "alias": "styleHeight"; "required": false; }; "fileInputHeight": { "alias": "fileInputHeight"; "required": false; }; "styleWidth": { "alias": "styleWidth"; "required": false; }; "hints": { "alias": "hints"; "required": false; }; "allowedExtensions": { "alias": "allowedExtensions"; "required": false; }; "callApi": { "alias": "callApi"; "required": false; }; "display": { "alias": "display"; "required": false; }; "attachType": { "alias": "attachType"; "required": false; }; "error": { "alias": "error"; "required": false; }; "displayedFiles": { "alias": "displayedFiles"; "required": false; }; "getDataFromTemplate": { "alias": "getDataFromTemplate"; "required": false; }; "allowFileContentsWithMultiAttachments": { "alias": "allowFileContentsWithMultiAttachments"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "allAttachments": { "alias": "allAttachments"; "required": false; }; "signType": { "alias": "signType"; "required": false; }; "customDownload": { "alias": "customDownload"; "required": false; }; "showSignButton": { "alias": "showSignButton"; "required": false; }; "printType": { "alias": "printType"; "required": false; }; "showPrintButton": { "alias": "showPrintButton"; "required": false; }; "downloadType": { "alias": "downloadType"; "required": false; }; "showDownloadButton": { "alias": "showDownloadButton"; "required": false; }; "preventFileContents": { "alias": "preventFileContents"; "required": false; }; "maxSize": { "alias": "maxSize"; "required": false; }; }, { "selectedTemplateAttachment": "selectedTemplateAttachment"; "addSignatureClicked": "addSignatureClicked"; "printActionClicked": "printActionClicked"; "emitedValue": "emitedValue"; "downloadActionClicked": "downloadActionClicked"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DocsUploaderComponent<any>, "app-file-uploader", never, { "useCrop": { "alias": "useCrop"; "required": false; }; "formKey": { "alias": "formKey"; "required": false; }; "showLabel": { "alias": "showLabel"; "required": false; }; "downloadLink": { "alias": "downloadLink"; "required": false; }; "showActions": { "alias": "showActions"; "required": false; }; "styleHeight": { "alias": "styleHeight"; "required": false; }; "fileInputHeight": { "alias": "fileInputHeight"; "required": false; }; "styleWidth": { "alias": "styleWidth"; "required": false; }; "hints": { "alias": "hints"; "required": false; }; "allowedExtensions": { "alias": "allowedExtensions"; "required": false; }; "callApi": { "alias": "callApi"; "required": false; }; "display": { "alias": "display"; "required": false; }; "attachType": { "alias": "attachType"; "required": false; }; "error": { "alias": "error"; "required": false; }; "displayedFiles": { "alias": "displayedFiles"; "required": false; }; "getDataFromTemplate": { "alias": "getDataFromTemplate"; "required": false; }; "allowFileContentsWithMultiAttachments": { "alias": "allowFileContentsWithMultiAttachments"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "allAttachments": { "alias": "allAttachments"; "required": false; }; "signType": { "alias": "signType"; "required": false; }; "customDownload": { "alias": "customDownload"; "required": false; }; "showSignButton": { "alias": "showSignButton"; "required": false; }; "printType": { "alias": "printType"; "required": false; }; "showPrintButton": { "alias": "showPrintButton"; "required": false; }; "downloadType": { "alias": "downloadType"; "required": false; }; "showDownloadButton": { "alias": "showDownloadButton"; "required": false; }; "preventFileContents": { "alias": "preventFileContents"; "required": false; }; "maxSize": { "alias": "maxSize"; "required": false; }; "maxLength": { "alias": "maxLength"; "required": false; }; }, { "selectedTemplateAttachment": "selectedTemplateAttachment"; "addSignatureClicked": "addSignatureClicked"; "printActionClicked": "printActionClicked"; "emitedValue": "emitedValue"; "downloadActionClicked": "downloadActionClicked"; }, never, never, true, never>;
 }
 declare class FileInfo {
     fileName: string;

package/lib/components/shared-components/form-field/index.d.ts

@@ -6,6 +6,7 @@ export * from './date-range-picker/date-range-picker.component';
 export * from './form-label/form-label.component';
 export * from './info-item/info-item.component';
 export * from './input/input.component';
+export * from './input/input-map-filter';
 export * from './input-number/input-number.component';
 export * from './input-email/input-email.component';
 export * from './input-mask/input-mask.component';

package/lib/components/shared-components/form-field/input/input-map-filter/index.d.ts

@@ -0,0 +1,4 @@
+export * from './input-filters';
+export * from './input-map-filter.directive';
+export * from './input-mappers';
+export * from './types';

package/lib/components/shared-components/form-field/input/input-map-filter/input-filters.d.ts

@@ -0,0 +1,63 @@
+import { InputFilterFn, InputKeyType } from "./types";
+export declare class InputFilters {
+    /**
+     * A filter that allows only Arabic characters (letters, punctuation) and Arabic-Indic digits (٠–٩),
+     * as well as basic common symbols and spaces.
+     *
+     * @returns `true` if the character should be allowed; otherwise, `false`
+     */
+    static arabicOnly(char: string, current: string, next: string, keyType: InputKeyType, event: KeyboardEvent | ClipboardEvent | DragEvent): boolean;
+    /**
+     * A filter that allows only English letters (A–Z, a–z), digits (0–9), common symbols, and space.
+     *
+     * @returns `true` if the character should be allowed; otherwise, `false`
+     */
+    static englishOnly(char: string, current: string, next: string, keyType: InputKeyType, event: KeyboardEvent | ClipboardEvent | DragEvent): boolean;
+    /**
+     * A filter that allows only digits (0–9).
+     *
+     * @returns `true` if the character is a digit; otherwise, `false`
+     */
+    static digitsOnly(char: string, current: string, next: string, keyType: InputKeyType, event: KeyboardEvent | ClipboardEvent | DragEvent): boolean;
+    /**
+     * Creates a new `PatternBuilder` instance for building a custom input filter.
+     *
+     * The builder allows chaining methods like `.allowArabicAlphabets()`, `.allowDigits()`, `.allowSpace()`, etc.
+     * Once configured, call `.build()` to generate the `InputFilterFn`.
+     *
+     * @example
+     * ```ts
+     * this.filterFn = InputFilters.buildPattern()
+     *   .allowArabicAlphabets()
+     *   .allowArabicDigits()
+     *   .allowSpace()
+     *   .build();
+     * ```
+     *
+     * @returns An instance of `PatternBuilder` for building a custom filter
+     */
+    static buildPattern(): PatternBuilder;
+}
+declare class PatternBuilder {
+    private patternParts;
+    /**
+     * Allow Arabic letters and Arabic symbols (e.g., Tatweel, diacritics, Arabic punctuation).
+     */
+    allowArabicAlphabets(): this;
+    /**
+     * Allow Arabic-Indic digits: ٠١٢٣٤٥٦٧٨٩
+     */
+    allowArabicDigits(): this;
+    /**
+     * Allow English letters A–Z (uppercase/lowercase).
+     */
+    allowEnglishAlphabets(): this;
+    allowDigits(): this;
+    allowSpace(): this;
+    allowSymbols(): this;
+    /**
+     * Builds and returns the filter function.
+     */
+    build(): InputFilterFn;
+}
+export {};

package/lib/components/shared-components/form-field/input/input-map-filter/input-map-filter.directive.d.ts

@@ -0,0 +1,15 @@
+import { NgControl } from "@angular/forms";
+import type { InputFilterFn, InputMapFn } from "./types";
+import * as i0 from "@angular/core";
+export declare class InputMapFilterDirective {
+    private ngControl;
+    mapFn: InputMapFn;
+    filterFn: InputFilterFn;
+    constructor(ngControl: NgControl);
+    handleKeydown(event: KeyboardEvent): boolean;
+    handlePaste(event: ClipboardEvent): void;
+    handleDrop(event: DragEvent): void;
+    private updateValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<InputMapFilterDirective, [{ optional: true; self: true; }]>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<InputMapFilterDirective, "[inputMapFilter]", never, { "mapFn": { "alias": "mapFn"; "required": false; }; "filterFn": { "alias": "filterFn"; "required": false; }; }, {}, never, never, true, never>;
+}

package/lib/components/shared-components/form-field/input/input-map-filter/input-mappers.d.ts

@@ -0,0 +1,10 @@
+export declare class InputMappers {
+    /**
+     * A mapping function that transforms all input to UPPERCASE.
+     */
+    static toUpperCase(char: string, currentValue: string, nextValue: string): string;
+    /**
+     * A mapping function that transforms all input to lowercase.
+     */
+    static toLowerCase(char: string, currentValue: string, nextValue: string): string;
+}

package/lib/components/shared-components/form-field/input/input-map-filter/types.d.ts

@@ -0,0 +1,3 @@
+export type InputKeyType = 'character' | 'backspace' | 'delete' | 'modifier' | 'non-printable' | 'null';
+export type InputMapFn = (char: string, currentValue: string, nextValue: string) => string;
+export type InputFilterFn = (char: string, currentValue: string, nextValue: string, keyType: InputKeyType, event: KeyboardEvent | ClipboardEvent | DragEvent) => boolean;

package/lib/components/shared-components/form-field/input/input.component.d.ts

@@ -1,5 +1,6 @@
 import { EventEmitter, DestroyRef } from '@angular/core';
 import { ControlValueAccessorDirective } from '../control-value-accessor.directive';
+import type { InputMapFn, InputFilterFn } from './input-map-filter/types';
 import * as i0 from "@angular/core";
 export declare class InputComponent<Type> extends ControlValueAccessorDirective<Type> {
     floatLabel: any;
@@ -7,8 +8,88 @@ export declare class InputComponent<Type> extends ControlValueAccessorDirective<
     iconPrefixName: string;
     iconSuffixName: string;
     emitedChangedValue1: EventEmitter<any>;
+    /**
+     * A mapping function that modifies the input value during typing, pasting, or dropping text.
+     * You can use it to modify the full input value **before it appears** (e.g., for auto-capitalization,
+     * formatting, or custom replacements).
+     *
+     * This function is called:
+     * - On each **key press**, to determine how the input value should change when a character is typed.
+     * - On **paste**, to transform the pasted content before it’s applied.
+     * - On **drop**, to transform the dropped text before it’s applied.
+     *
+     * **Built-in mappers are available via the `InputMappers` utility class:**
+     *
+     * - `InputMappers.toUpperCase` — Transforms all input to UPPERCASE.
+     * - `InputMappers.toLowerCase` — Transforms all input to lowercase.
+     *
+     * @param char - The character(s) being inserted. This is:
+     *   - A single character (e.g., `'a'`) during typing.
+     *   - The full pasted string during paste events.
+     *   - The full dropped string during drop events.
+     * @param currentValue - The current value of the input **before** the change is applied.
+     * @param nextValue - The simulated value of the input **after** the character, paste, or drop is inserted, but before transformation.
+     *
+     * @returns The final string to use as the new input value.
+     *
+     * @example
+     * // Use a built-in mapper to force UPPERCASE input:
+     * this.mapFn = InputMappers.toUpperCase;
+     *
+     * @example
+     * // Custom mapper: Capitalize the first letter of each word
+     * this.mapFn = (char, current, next) =>
+     *   typeof next === 'string' ? next.replace(/\b\w/g, c => c.toUpperCase()) : next;
+     */
+    mapFn: InputMapFn;
+    /**
+     * A filtering function that determines whether a character or string should be allowed into the input.
+     *
+     * This function is called during:
+     * - **Typing**: When a key is pressed to decide if the character should be accepted.
+     * - **Paste**: When text is pasted to decide if the entire pasted string should be accepted.
+     * - **Drop**: When text is dropped into the input to decide if it should be allowed.
+     *
+     * You can use it to reject unwanted characters (e.g. numbers, symbols) or block input entirely based
+     * on the current or predicted value.
+     *
+     * **Built-in filters are available via the `InputFilters` utility class:**
+     *
+     * - `InputFilters.arabicOnly` — Allows Arabic letters and digits, as well as common symbols.
+     * - `InputFilters.englishOnly` — Allows English letters and digits, as well as common symbols.
+     * - `InputFilters.digitsOnly` — Allows digits only (`0–9`), no letters or symbols.
+     * - You can also use `InputFilters.buildPattern()` to define a custom filter.
+     *
+     * @param char - The character(s) being inserted:
+     *   - A single typed character (e.g., `'a'`) during key presses
+     *   - The full pasted or dropped string during paste/drop
+     * @param currentValue - The current value of the input before the character or string is applied.
+     * @param nextValue - The simulated next value if the character or string were applied.
+     * @param keyType - The kind of input interaction:
+     *   - `'character'` for printable characters
+     *   - `'backspace'` or `'delete'` for those keys
+     *   - `'modifier'` for Ctrl/Alt/Meta combinations
+     *   - `'non-printable'` for arrows, tab, escape, etc.
+     *   - `'null'` for paste/drop (non-keyboard text input)
+     * @param event - The originating event triggering the input change. This can be a
+     *   `KeyboardEvent` (for typing), `ClipboardEvent` (for paste), or `DragEvent` (for drop).
+     *
+     * @returns `true` to allow the input, or `false` to block it.
+     *
+     *
+     * @example
+     * // Use a built-in filter to restrict to digits only
+     * this.filterFn = InputFilters.digitsOnly;
+     *
+     * @example
+     * // Custom filter: Allow only letters (no numbers or symbols)
+     * this.filterFn = (char, current, next, keyType, event) => {
+     *   return keyType !== 'character' || /^[a-zA-Z]+$/.test(char);
+     * };
+     */
+    filterFn: InputFilterFn;
     destroyRef: DestroyRef;
     ngOnInit(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<InputComponent<any>, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<InputComponent<any>, "app-input", never, { "floatLabel": { "alias": "floatLabel"; "required": false; }; "className": { "alias": "className"; "required": false; }; "iconPrefixName": { "alias": "iconPrefixName"; "required": false; }; "iconSuffixName": { "alias": "iconSuffixName"; "required": false; }; "emitedChangedValue1": { "alias": "emitedChangedValue1"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<InputComponent<any>, "app-input", never, { "floatLabel": { "alias": "floatLabel"; "required": false; }; "className": { "alias": "className"; "required": false; }; "iconPrefixName": { "alias": "iconPrefixName"; "required": false; }; "iconSuffixName": { "alias": "iconSuffixName"; "required": false; }; "emitedChangedValue1": { "alias": "emitedChangedValue1"; "required": false; }; "mapFn": { "alias": "mapFn"; "required": false; }; "filterFn": { "alias": "filterFn"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/components/shared-components/form-field/shared-imports.d.ts

@@ -10,6 +10,6 @@ import { ArOnlyDirective } from "../../../directives/ar.directive";
 import { NgClass } from "@angular/common";
 import { TranslatePipe } from "../../../pipes/translate.pipe";
 export declare const MatDatePickerImports: (typeof MatDatepickerInput | typeof MatDatepickerToggle | typeof MatDatepickerModule)[];
-export declare const MatFormImports: (typeof MatInput | typeof MatFormFieldModule | typeof MatFormField)[];
-export declare const Shareds: (typeof NgClass | typeof ReactiveFormsModule | typeof TranslatePipe | typeof FormLabelComponent | typeof ValidationErrorsComponent | typeof InfoItemComponent)[];
+export declare const MatFormImports: (typeof MatFormFieldModule | typeof MatFormField | typeof MatInput)[];
+export declare const Shareds: (typeof NgClass | typeof ValidationErrorsComponent | typeof ReactiveFormsModule | typeof FormLabelComponent | typeof InfoItemComponent | typeof TranslatePipe)[];
 export declare const TextLanguageDirectives: (typeof EnOnlyDirective | typeof ArOnlyDirective)[];

package/lib/i18n/ar.d.ts

@@ -175,7 +175,6 @@ declare const _default: {
     year: string;
     status: string;
     downloadAll: string;
-    itemsPerPage: string;
     startDate: string;
     endDate: string;
     textArea: string;

package/lib/i18n/en.d.ts

@@ -179,7 +179,6 @@ declare const _default: {
     year: string;
     status: string;
     downloadAll: string;
-    itemsPerPage: string;
     startDate: string;
     endDate: string;
     textArea: string;

package/lib/testComponent/request-details-section/request-details-section.component.d.ts

@@ -2,6 +2,7 @@ import { DestroyRef, OnInit } from '@angular/core';
 import { Form, Section } from "../../interfaces";
 import { ActionStateService, CoreI18nService } from "../../services";
 import { FormBuilder, FormGroup, ValidatorFn } from "@angular/forms";
+import { InputMappers } from '../../components/shared-components/form-field/input/input-map-filter/input-mappers';
 import * as i0 from "@angular/core";
 export declare class RequestDetailsSectionComponent implements OnInit {
     i18n: CoreI18nService;
@@ -67,6 +68,8 @@ export declare class RequestDetailsSectionComponent implements OnInit {
     customCallSubmit(action: string): void;
     resetForm(): void;
     pageChanged(event: any): void;
+    mapFn: typeof InputMappers.toLowerCase;
+    arOnly: import("../../components/shared-components").InputFilterFn;
     static ɵfac: i0.ɵɵFactoryDeclaration<RequestDetailsSectionComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<RequestDetailsSectionComponent, "app-request-details-section", never, { "isReadOnly": { "alias": "isReadOnly"; "required": false; }; "section": { "alias": "section"; "required": false; }; "form": { "alias": "form"; "required": false; }; "lov": { "alias": "lov"; "required": false; }; "className": { "alias": "className"; "required": false; }; }, {}, never, never, true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bpm-core",
-  "version": "0.0.125",
+  "version": "0.0.127",
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0",