@tsi-developpement/tsi-shared-ui 1.9.13 → 1.10.0

package/lib/consts/app-providers.d.ts

@@ -3,4 +3,4 @@ import { FormStateService } from "../services/form/form-state.service";
 import { PresentationDesignerBaseService } from "../services/presentation-setting/presentation-designer-base.service";
 import { GenericValidationStateService } from "../services/validation/generic-validation-state.service";
 import { InputRegistryService } from "../services/validation/input-registry.service";
-export declare const appProviders: (typeof GenericValidationStateService | typeof InputRegistryService | typeof PresentationDesignerBaseService | typeof DynamicFormService | typeof FormStateService)[];
+export declare const appProviders: (typeof PresentationDesignerBaseService | typeof GenericValidationStateService | typeof InputRegistryService | typeof DynamicFormService | typeof FormStateService)[];

package/lib/functions/currency-state.functions.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Internal currency-state resolution shared by the four currency components
+ * (Tsi-Currency-Other-Input/Display, Tsi-Currency-Societe-Input/Display).
+ *
+ * This module is intentionally NOT re-exported from `functions/index.ts`, so it
+ * is an internal implementation detail and not part of the library public API.
+ *
+ * A currency "state" combines two independent checks:
+ *  1. Is the currency code a recognized ISO-4217 code?
+ *  2. Does the value carry more decimal places than the currency supports?
+ * The result drives a two-tier visual state in the components:
+ *  - `error`   → invalid/missing code, or (inputs) a value that exceeds the
+ *                currency's decimals and therefore cannot be safely edited;
+ *  - `warning` → (displays) a value that exceeds the currency's decimals, shown
+ *                raw so no precision is hidden.
+ */
+/**
+ * i18n keys resolved by the host app's `LocalizePipe`. Centralized here so the
+ * components and the backend translation files (FR/EN/AR) stay in sync.
+ */
+export declare const CurrencyStateKeys: {
+    readonly noCurrencySupplied: "sharedUi-currency-error-noCurrencySupplied";
+    readonly invalidCurrencySupplied: "sharedUi-currency-error-invalidCurrencySupplied";
+    readonly valueExceedsDecimalsError: "sharedUi-currency-error-valueExceedsDecimals";
+    readonly valueExceedsDecimalsWarning: "sharedUi-currency-warning-valueExceedsDecimals";
+};
+/**
+ * Placeholders replaced when building a message, so the currency and the decimal
+ * figures are named inline. Translations must include the tokens they need
+ * (see the FR/EN/AR translation files):
+ *  - `{devise}`   → the currency code
+ *  - `{decimals}` → the value's decimal-place count (mismatch messages only)
+ *  - `{allowed}`  → the decimals the currency allows (mismatch messages only)
+ */
+export declare const CurrencyPlaceholder = "{devise}";
+export declare const ValueDecimalsPlaceholder = "{decimals}";
+export declare const AllowedDecimalsPlaceholder = "{allowed}";
+export type CurrencyStateSeverity = 'ok' | 'error' | 'warning';
+export interface CurrencyState {
+    /** Overall severity of the current (code, value) pair. */
+    severity: CurrencyStateSeverity;
+    /** Whether the currency code itself is a recognized ISO-4217 code. */
+    isValid: boolean;
+    /** Translation key for the tooltip message (empty when severity === 'ok'). */
+    tooltipKey: string;
+    /** Fraction digits the currency supports (ISO/locale default); -1 if unknown. */
+    isoDecimals: number;
+    /** Decimal places the value carries; set only on a decimals mismatch. */
+    valueDecimals?: number;
+    /** Normalized (upper-cased) currency code, when one was supplied. */
+    currencyCode?: string;
+}
+/**
+ * Returns `true` when `code` is a recognized ISO-4217 currency code.
+ *
+ * Prefers the exact `Intl.supportedValuesOf('currency')` list; on older runtimes
+ * falls back to a 3-letter well-formedness check plus `Intl.NumberFormat`.
+ * Case-insensitive (the code is upper-cased before checking).
+ */
+export declare function isValidCurrency(code?: string): boolean;
+/**
+ * Resolves the display state for a (currency code, value) pair.
+ *
+ * @param code             ISO-4217 currency code supplied to the component.
+ * @param value            the monetary value being shown/edited.
+ * @param locale           locale used to derive the currency's fraction digits.
+ * @param mismatchSeverity severity applied when the value exceeds the currency's
+ *                         decimals: `'error'` for inputs (renders read-only),
+ *                         `'warning'` for displays (renders the raw value).
+ */
+export declare function resolveCurrencyState(code: string | undefined, value: number | null | undefined, locale: string, mismatchSeverity: 'error' | 'warning'): CurrencyState;
+/**
+ * Builds the tooltip message for a resolved state using the supplied `translate`
+ * callback (typically `LocalizePipe.transform`). Falls back to a built-in
+ * English message when the key resolves to itself (missing translation), so a
+ * raw key slug is never shown. Any {@link CurrencyPlaceholder} token in the
+ * message is replaced with the currency code, so the offending currency is named
+ * inline.
+ */
+export declare function localizeCurrencyState(state: CurrencyState, translate: (key: string) => string): string;

package/lib/pipes/tsi-currency.pipe.d.ts

@@ -1,10 +1,12 @@
-import { CurrencyPipe } from '@angular/common';
 import { PipeTransform } from '@angular/core';
 import * as i0 from "@angular/core";
 export declare class TsiCurrencyPipe implements PipeTransform {
-    private currencyPipe;
-    constructor(currencyPipe: CurrencyPipe);
-    transform(value: number | undefined, currencyCode: string, display?: 'code' | 'symbol' | 'symbol-narrow' | string, digitsInfo?: string, locale?: string): string | null;
+    private readonly _display;
+    private _locale;
+    private _localizationService;
+    private _currencyPipe;
+    constructor();
+    transform(value: number | undefined, currencyCode: string): string | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<TsiCurrencyPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<TsiCurrencyPipe, "tsiCurrency", false>;
 }

package/lib/providers/shared-ui-tsi.provider.d.ts

@@ -2,7 +2,7 @@ import { DynamicDialogConfig, DynamicDialogRef } from "primeng/dynamicdialog";
 import { TabView } from "primeng/tabview";
 import { JwtHelperService } from "@auth0/angular-jwt";
 import { ConfirmationService, MessageService } from "primeng/api";
-export declare const SharedUiTsiProviders: (typeof DynamicDialogRef | typeof DynamicDialogConfig | typeof JwtHelperService | typeof TabView | typeof MessageService | typeof ConfirmationService | {
+export declare const SharedUiTsiProviders: (typeof TabView | typeof DynamicDialogRef | typeof DynamicDialogConfig | typeof JwtHelperService | typeof MessageService | typeof ConfirmationService | {
     provide: import("@angular/core").InjectionToken<unknown>;
     useValue: import("@angular/core").InjectionToken<unknown>;
 })[];

package/lib/tsi-components/input-components/tsi-currency-other-input/tsi-currency-other-input.component.d.ts

@@ -1,18 +1,23 @@
-import { EventEmitter, OnInit } from '@angular/core';
+import { EventEmitter } from '@angular/core';
 import { TsiInputBase } from '../../../tsi-base/tsi-input-base/tsi-input-base.component';
-import { LocalizePipe } from '../../../pipes/localize.pipe';
+import { CurrencyState } from '../../../functions/currency-state.functions';
 import * as i0 from "@angular/core";
-export declare class TsiCurrencyOtherInputComponent extends TsiInputBase<number | undefined> implements OnInit {
-    private _localizationPipe;
-    numOfDecimal?: number;
-    currency?: string;
+export declare class TsiCurrencyOtherInputComponent extends TsiInputBase<number | undefined> {
+    protected currencyState: CurrencyState;
+    protected tooltipMessage: string;
+    private isValueChanged;
+    private _currency?;
+    get currency(): string | undefined;
+    set currency(value: string | undefined);
+    get inputField(): number | undefined;
+    set inputField(value: number | undefined);
     class: any;
     inputFieldChange: EventEmitter<number>;
-    private isValueChanged;
-    constructor(_localizationPipe: LocalizePipe);
+    private _localizePipe;
+    ngOnInit(): void;
     valueChanged(event: any): void;
     onChangeofOptions(): void;
-    ngOnInit(): void;
+    private updateCurrencyState;
     static ɵfac: i0.ɵɵFactoryDeclaration<TsiCurrencyOtherInputComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencyOtherInputComponent, "Tsi-Currency-Other-Input", never, { "numOfDecimal": { "alias": "numOfDecimal"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; "class": { "alias": "class"; "required": false; }; }, { "inputFieldChange": "inputFieldChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencyOtherInputComponent, "Tsi-Currency-Other-Input", never, { "currency": { "alias": "currency"; "required": false; }; "class": { "alias": "class"; "required": false; }; }, { "inputFieldChange": "inputFieldChange"; }, never, never, false, never>;
 }

package/lib/tsi-components/input-components/tsi-currency-societe-input/tsi-currency-societe-input.component.d.ts

@@ -1,21 +1,24 @@
-import { EventEmitter, OnInit } from '@angular/core';
+import { EventEmitter } from '@angular/core';
 import { TsiInputBase } from '../../../tsi-base/tsi-input-base/tsi-input-base.component';
-import { AppSettingsService } from '../../../services/settings/app-settings.service';
-import { LocalizePipe } from '../../../pipes/localize.pipe';
+import { CurrencyState } from '../../../functions/currency-state.functions';
 import * as i0 from "@angular/core";
-export declare class TsiCurrencySocieteInputComponent extends TsiInputBase<number | undefined> implements OnInit {
-    private appSettingsService;
-    private _localizationPipe;
-    currency: string;
-    protected numOfDecimal?: number;
+export declare class TsiCurrencySocieteInputComponent extends TsiInputBase<number | undefined> {
+    private isValueChanged;
+    protected currency: string;
+    protected currencyState: CurrencyState;
+    protected tooltipMessage: string;
     style: any;
+    get inputField(): number | undefined;
+    set inputField(value: number | undefined);
     class: any;
     inputFieldChange: EventEmitter<number>;
-    private isValueChanged;
-    constructor(appSettingsService: AppSettingsService, _localizationPipe: LocalizePipe);
+    private _appSettingsService;
+    private _localizePipe;
+    constructor();
     ngOnInit(): void;
     valueChanged(event: any): void;
     onChangeofOptions(): void;
+    private updateCurrencyState;
     static ɵfac: i0.ɵɵFactoryDeclaration<TsiCurrencySocieteInputComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencySocieteInputComponent, "Tsi-Currency-Societe-Input", never, { "class": { "alias": "class"; "required": false; }; }, { "inputFieldChange": "inputFieldChange"; }, never, never, false, never>;
 }

package/lib/tsi-components/output-components/tsi-currency-other-display/tsi-currency-other-display.component.d.ts

@@ -1,11 +1,21 @@
-import { LocaleCode } from '../../../enums/Language';
+import { OnInit } from '@angular/core';
+import { CurrencyState } from '../../../functions/currency-state.functions';
 import * as i0 from "@angular/core";
-export declare class TsiCurrencyOtherDisplayComponent {
+export declare class TsiCurrencyOtherDisplayComponent implements OnInit {
+    protected currencyState: CurrencyState;
+    protected tooltipMessage: string;
+    private _currency?;
+    private _inputData?;
+    get currency(): string | undefined;
+    get inputData(): number | undefined;
+    set currency(value: string | undefined);
+    set inputData(value: number | undefined);
+    private _localizePipe;
     private _localizationService;
-    protected locale: LocaleCode;
+    private readonly _locale;
     constructor();
-    inputData?: number;
-    currency?: string;
+    ngOnInit(): void;
+    private updateCurrencyState;
     static ɵfac: i0.ɵɵFactoryDeclaration<TsiCurrencyOtherDisplayComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencyOtherDisplayComponent, "Tsi-Currency-Other-Display", never, { "inputData": { "alias": "inputData"; "required": false; }; "currency": { "alias": "currency"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencyOtherDisplayComponent, "Tsi-Currency-Other-Display", never, { "currency": { "alias": "currency"; "required": false; }; "inputData": { "alias": "inputData"; "required": false; }; }, {}, never, never, false, never>;
 }

package/lib/tsi-components/output-components/tsi-currency-societe-display/tsi-currency-societe-display.component.d.ts

@@ -1,21 +1,20 @@
 import { OnInit } from '@angular/core';
-import { LocalizePipe } from '../../../pipes/localize.pipe';
-import { AppSettingsService } from '../../../services/settings/app-settings.service';
-import { LocaleCode } from '../../../enums/Language';
+import { CurrencyState } from '../../../functions/currency-state.functions';
 import * as i0 from "@angular/core";
 export declare class TsiCurrencySocieteDisplayComponent implements OnInit {
-    private localizationPipe;
-    private appSettingsService;
-    currency: string;
-    protected numOfDecimal?: number;
-    private _digitsInfo;
+    protected currency: string;
+    protected currencyState: CurrencyState;
+    protected tooltipMessage: string;
+    private _inputData?;
+    get inputData(): number | undefined;
+    set inputData(value: number | undefined);
+    private _appSettingsService;
+    private _localizePipe;
     private _localizationService;
-    protected locale: LocaleCode;
-    inputData?: number;
-    currencyTraductionKey: string;
-    constructor(localizationPipe: LocalizePipe, appSettingsService: AppSettingsService);
-    getDigitsInfo(): string;
+    private readonly _locale;
+    constructor();
     ngOnInit(): void;
+    private updateCurrencyState;
     static ɵfac: i0.ɵɵFactoryDeclaration<TsiCurrencySocieteDisplayComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<TsiCurrencySocieteDisplayComponent, "Tsi-Currency-Societe-Display", never, { "inputData": { "alias": "inputData"; "required": false; }; }, {}, never, never, false, never>;
 }

package/lib/tsi-components/poc/locale-poc/locale-poc.component.d.ts

@@ -1,49 +1,67 @@
+import { KeyValue } from '@angular/common';
 import * as i0 from "@angular/core";
 /**
- * POC component used to validate and demonstrate the library's
- * locale integration and numeric formatting behavior.
+ * Proof-of-concept (POC) component used to validate and demonstrate
+ * the library's locale handling and numeric formatting behavior.
  *
- * The page allows testers to:
- * - Enter values using the library input components
- * - Immediately observe the formatted output using display components
+ * This page allows testers and developers to:
+ * - Enter values through input components
+ * - Instantly observe formatted results via display components
  *
- * This component is intended for:
- * - manual QA testing
- * - locale formatting validation
- * - development debugging
+ * Main purposes:
+ * - Manual QA validation
+ * - Locale and formatting verification
+ * - Development and debugging support
  *
- * Tested formatting types:
+ * Covered formatting scenarios:
  * - Company currency
  * - External currency
  * - Decimal numbers
  * - Rates / percentages
- * - Integers
+ * - Integers (with grouping)
  */
 export declare class LocalePocComponent {
     /**
-     * Company currency value.
+     * Available currencies used for testing currency inputs and displays.
+     */
+    currencies: KeyValue<string, string>[];
+    /**
+     * Company currency code.
+     * Bound to the `Tsi-Currency-Societe-Input` component.
+     */
+    currencySocieteCode: string;
+    /**
+     * Company currency amount.
      * Bound to the `Tsi-Currency-Societe-Input` component.
      */
-    currencySociete: number;
+    currencySocieteValue: number;
+    /**
+     * External currency code.
+     * Bound to the `Tsi-Currency-Other-Input` component.
+     */
+    currencyOtherCode: string;
     /**
-     * External currency value.
+     * External currency amount.
      * Bound to the `Tsi-Currency-Other-Input` component.
      */
-    currencyOther: number;
+    currencyOtherValue: number;
     /**
-     * Decimal value used to validate locale-specific
-     * decimal separators and grouping behavior.
+     * Decimal value used to validate locale-specific:
+     * - decimal separators
+     * - digit grouping behavior
      */
-    decimal: number;
+    decimalValue: number;
     /**
      * Rate value used to test percentage / rate formatting.
      */
-    rate: number;
+    rateValue: number;
     /**
      * Integer value used to validate thousands grouping
-     * without decimal digits.
+     * without decimal precision.
      */
-    integer: number;
+    integerValue: number;
+    private _appSettingsService;
+    constructor();
     static ɵfac: i0.ɵɵFactoryDeclaration<LocalePocComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LocalePocComponent, "lib-locale-poc", never, {}, {}, never, never, false, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsi-developpement/tsi-shared-ui",
-  "version": "1.9.13",
+  "version": "1.10.0",
   "author": "TSI",
   "license": "MIT",
   "peerDependencies": {