@unipin/angular-applet 21.3.0 → 21.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unipin/angular-applet",
-  "version": "21.3.0",
+  "version": "21.3.1",
   "peerDependencies": {
     "@angular/cdk": "21.x.x",
     "@angular/common": "21.x.x",

package/types/unipin-angular-applet-forms.d.ts

@@ -1,12 +1,66 @@
+import { FormGroup, ValidatorFn, NgControl, AbstractControl, NgForm, FormGroupDirective, ControlValueAccessor } from '@angular/forms';
 import * as _angular_core from '@angular/core';
 import { Signal, DoCheck, Injector, Renderer2, ElementRef, WritableSignal, InputSignal, ModelSignal, OutputEmitterRef, OnInit, OnDestroy } from '@angular/core';
 import { ClassValue } from 'clsx';
-import { NgControl, AbstractControl, NgForm, FormGroupDirective, ControlValueAccessor, FormGroup, ValidatorFn } from '@angular/forms';
 import { Subscription, Observable, Subject } from 'rxjs';
 import { Country, Currency } from '@unipin/graphql-schema';
 import { CountryService, CurrencyService, RateGroupCodeService } from '@unipin/angular-applet/common';
 import { SingleDate, RangeDate } from '@unipin/angular-applet/calendar';
 
+type TimeValue = {
+    hour: number;
+    minute: number;
+};
+
+declare function setValidator(form: FormGroup, keys: string[], validators: ValidatorFn | ValidatorFn[]): void;
+
+declare function toggleFormControls(form: FormGroup, keys: string[], mode: 'enable' | 'disable'): void;
+
+/**
+ * Range validator for number and date values.
+ * @param {string} fromKey - The "from" control name
+ * @param {string} toKey - The "to" control name
+ * @returns {ValidatorFn} Throw error message when fromKey is greater than toKey
+ *
+ * Usage:
+ * this.form = new FormGroup({
+ *   agingFrom: new FormControl(),
+ *   agingTo: new FormControl(),
+ * }, { validators: rangeValidator('agingFrom', 'agingTo') });
+ */
+declare function validRangeValidator(fromKey: string, toKey: string): ValidatorFn;
+
+/**
+ * Validator that requires all specified form controls to have the same value.
+ *
+ * @param {string[]} controlNames - The names of the controls that must match
+ * @param {string} [message] - Optional custom error message
+ * @returns {ValidatorFn} A validator function producing an `isEqual` error if values do not match
+ *
+ * @example
+ * this.form = new FormGroup({
+ *   password: new FormControl(''),
+ *   confirmPassword: new FormControl(''),
+ * }, { validators: isEqualValidator(['password', 'confirmPassword']) });
+ */
+declare function isEqualValidator(controlNames: string[], message?: string): ValidatorFn;
+
+/**
+ * Validator that requires all specified form controls to have different values.
+ *
+ * @param {string[]} controlNames - The names of the controls that must all be unique
+ * @param {string} [message] - Optional custom error message
+ * @returns {ValidatorFn} A validator function producing an `isNotEqual` error if duplicate values exist
+ *
+ * @example
+ * this.form = new FormGroup({
+ *   primaryEmail: new FormControl(''),
+ *   secondaryEmail: new FormControl(''),
+ *   backupEmail: new FormControl(''),
+ * }, { validators: isNotEqualValidator(['primaryEmail', 'secondaryEmail', 'backupEmail']) });
+ */
+declare function isNotEqualValidator(controlNames: string[], message?: string): ValidatorFn;
+
 declare abstract class UpFieldControl {
     abstract readonly error: Signal<string>;
     abstract readonly ngControl: NgControl | AbstractControl | null;
@@ -435,11 +489,6 @@ declare class UpDateRangePickerComponent extends UpFieldControlComponent impleme
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UpDateRangePickerComponent, "up-date-range-picker", never, { "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "inlineClass": { "alias": "class"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "format"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type TimeValue = {
-    hour: number;
-    minute: number;
-};
-
 declare class UpTimeComponent {
     readonly hoursScroll: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
     readonly minutesScroll: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
@@ -551,53 +600,5 @@ declare class UpImagePickerComponent extends UpFieldControlComponent implements
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UpImagePickerComponent, "up-image-picker", never, { "ratio": { "alias": "ratio"; "required": false; "isSignal": true; }; "imgSrc": { "alias": "src"; "required": false; "isSignal": true; }; "inlineClass": { "alias": "class"; "required": false; "isSignal": true; }; }, { "imgSrc": "srcChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
-declare function setValidator(form: FormGroup, keys: string[], validators: ValidatorFn | ValidatorFn[]): void;
-
-declare function toggleFormControls(form: FormGroup, keys: string[], mode: 'enable' | 'disable'): void;
-
-/**
- * Range validator for number and date values.
- * @param {string} fromKey - The "from" control name
- * @param {string} toKey - The "to" control name
- * @returns {ValidatorFn} Throw error message when fromKey is greater than toKey
- *
- * Usage:
- * this.form = new FormGroup({
- *   agingFrom: new FormControl(),
- *   agingTo: new FormControl(),
- * }, { validators: rangeValidator('agingFrom', 'agingTo') });
- */
-declare function validRangeValidator(fromKey: string, toKey: string): ValidatorFn;
-
-/**
- * Validator that requires all specified form controls to have the same value.
- *
- * @param {string[]} controlNames - The names of the controls that must match
- * @param {string} [message] - Optional custom error message
- * @returns {ValidatorFn} A validator function producing an `isEqual` error if values do not match
- *
- * @example
- * this.form = new FormGroup({
- *   password: new FormControl(''),
- *   confirmPassword: new FormControl(''),
- * }, { validators: isEqualValidator(['password', 'confirmPassword']) });
- */
-declare function isEqualValidator(controlNames: string[], message?: string): ValidatorFn;
-
-/**
- * Validator that requires all specified form controls to have different values.
- *
- * @param {string[]} controlNames - The names of the controls that must all be unique
- * @param {string} [message] - Optional custom error message
- * @returns {ValidatorFn} A validator function producing an `isNotEqual` error if duplicate values exist
- *
- * @example
- * this.form = new FormGroup({
- *   primaryEmail: new FormControl(''),
- *   secondaryEmail: new FormControl(''),
- *   backupEmail: new FormControl(''),
- * }, { validators: isNotEqualValidator(['primaryEmail', 'secondaryEmail', 'backupEmail']) });
- */
-declare function isNotEqualValidator(controlNames: string[], message?: string): ValidatorFn;
-
 export { UpCheckboxDirective, UpCountrySelectComponent, UpCurrencySelectComponent, UpDateRangePickerComponent, UpDatepickerComponent, UpFieldControl, UpFieldControlComponent, UpFormFieldComponent, UpImagePickerComponent, UpInputDirective, UpNumberDirective, UpOptionComponent, UpPasswordComponent, UpRadioDirective, UpRateGroupCodeSelectComponent, UpSearchableSelectComponent, UpSelectComponent, UpSwitchComponent, UpTimeComponent, UpTimepickerComponent, isEqualValidator, isNotEqualValidator, setValidator, toggleFormControls, validRangeValidator };
+export type { TimeValue };