bpm-core 0.0.126 → 0.0.128

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 } 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, 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, 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, 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,2 @@
+export type InputMapFn = (char: string, currentValue: string, nextValue: string) => string;
+export type InputFilterFn = (char: string, currentValue: string, nextValue: string, 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,82 @@ 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 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, event) => {
+     *   return /^[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

@@ -11,5 +11,5 @@ 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 TranslatePipe | typeof NgClass | typeof FormLabelComponent | typeof ReactiveFormsModule | typeof ValidationErrorsComponent | typeof InfoItemComponent)[];
+export declare const Shareds: (typeof NgClass | typeof ReactiveFormsModule | typeof TranslatePipe | typeof FormLabelComponent | typeof ValidationErrorsComponent | typeof InfoItemComponent)[];
 export declare const TextLanguageDirectives: (typeof EnOnlyDirective | typeof ArOnlyDirective)[];

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;
+    filterFn: 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,9 @@
 {
   "name": "bpm-core",
-  "version": "0.0.126",
+  "version": "0.0.128",
+  "bin": {
+    "bpm-core": "./cli/index.js"
+  },
   "peerDependencies": {
     "@angular/common": "^19.0.0",
     "@angular/core": "^19.0.0",