@seniorsistemas/angular-components 19.1.1 → 19.3.0

package/bignumber-input/lib/bignumber-input/bignumber-input.directive.d.ts

@@ -1,9 +1,9 @@
-import { ElementRef, EventEmitter, KeyValueDiffers, OnChanges, OnInit, SimpleChanges } from '@angular/core';
-import { CurrencyMaskDirective } from 'ng2-currency-mask';
-import { LocaleService } from '@seniorsistemas/angular-components/locale';
+import { OnInit, OnChanges, SimpleChanges } from '@angular/core';
+import { AbstractControl, ValidationErrors } from '@angular/forms';
+import { NumericMaskDirective } from '@seniorsistemas/angular-components/numeric-mask';
 import * as i0 from "@angular/core";
 /**
- * @deprecated Should use 'AlignmentOptions' from @seniorsistemas/ng2-currency-mask instead
+ * @deprecated Este enum não tem mais efeito. O alinhamento do campo é sempre `'right'`.
  */
 export declare enum BignumberAlignmentOption {
     RIGHT = "right",
@@ -22,66 +22,99 @@ export declare enum BignumberAlignmentOption {
  *
  * @category Inputs
  */
-export declare class BignumberInputDirective extends CurrencyMaskDirective implements OnInit, OnChanges {
-    private readonly localeService;
+export declare class BignumberInputDirective extends NumericMaskDirective implements OnInit, OnChanges {
     /**
-     * @description Número total de dígitos significativos aceitos pelo campo.
+     * @description Número total de dígitos significativos aceitos pelo campo (parte inteira + parte decimal).
+     *
+     * Durante a digitação, o campo limita fisicamente o número de caracteres via `maxLength`.
+     * Ao colar um valor que ultrapasse o limite, o evento `pasteRejected` é emitido e a colagem é cancelada.
+     * Após sair do campo (blur) ou ao submeter o formulário, se o valor ultrapassar `precision`,
+     * o campo ficará inválido com o erro `exceedsPrecision: { precision, actual }`.
      *
      * @default 15
      */
-    precision: number;
+    precision: import("@angular/core").InputSignal<number>;
     /**
+     * @deprecated Use `minDecimalPlaces` e `maxDecimalPlaces` ao invés deste.
      * @description Número de casas decimais exibidas e aceitas pelo campo.
+     * Quando informado, repassa o valor para `minDecimalPlaces` e `maxDecimalPlaces`.
+     *
+     * @default 0
+     */
+    scale: import("@angular/core").InputSignal<number>;
+    /**
+     * @description Número mínimo de casas decimais exibidas.
+     *
+     * @default 0
+     */
+    minDecimalPlaces: import("@angular/core").ModelSignal<number>;
+    /**
+     * @description Número máximo de casas decimais aceitas.
      *
      * @default 0
      */
-    scale: number;
+    maxDecimalPlaces: import("@angular/core").ModelSignal<number>;
     /**
      * @description Separador decimal personalizado. Quando não informado,
      * utiliza o separador definido pelo locale ativo da aplicação.
      */
-    decimalSeparator?: string;
+    decimalSeparator: import("@angular/core").ModelSignal<string>;
+    /**
+     * @deprecated Use `thousandSeparator` ao invés deste.
+     * @description Separador de milhar personalizado. Recomenda-se migrar para `thousandSeparator`.
+     */
+    thousandsSeparator: import("@angular/core").InputSignal<string | undefined>;
     /**
      * @description Separador de milhar personalizado. Quando não informado,
      * utiliza o separador definido pelo locale ativo da aplicação.
      */
-    thousandsSeparator?: string;
+    thousandSeparator: import("@angular/core").ModelSignal<string>;
     /**
-     * @description Alinhamento do conteúdo do campo. Aceita `'left'` ou `'right'`.
-     *
-     * @default 'left'
+     * @deprecated Este input não tem mais efeito e pode ser removido.
+     * O alinhamento do campo é sempre `'right'`, conforme o comportamento padrão da máscara numérica.
      */
-    alignTo: 'left' | 'right';
+    alignTo: import("@angular/core").InputSignal<"right" | "left">;
     /**
      * @description Permite a entrada de valores negativos.
      *
      * @default true
      */
-    allowNegative: boolean;
+    allowNegative: import("@angular/core").InputSignal<boolean>;
     /**
      * @description Texto de placeholder exibido quando o campo está vazio.
      */
-    placeholder?: string;
+    placeholder: import("@angular/core").ModelSignal<string | undefined>;
     maxLength?: number;
     /**
-     * @description Emitido quando uma colé (paste) é rejeitada pela validação do campo.
+     * @description Emitido quando uma colagem (paste) é rejeitada pela validação do campo.
      * Emite a string colada que foi recusada.
      */
-    pasteRejected: EventEmitter<string>;
-    private readonly regex;
-    constructor(_elementRef: ElementRef, _keyValueDiffers: KeyValueDiffers, localeService: LocaleService);
+    pasteRejected: import("@angular/core").OutputEmitterRef<string>;
+    private _decimalSeparatorExplicit;
+    private _thousandSeparatorExplicit;
+    constructor();
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    /**
+     * Overrides base paste handler to add precision validation.
+     * If the pasted value exceeds `precision` digits, the paste is rejected.
+     */
     onPaste(event: ClipboardEvent): void;
     /**
-     * Update the options values according to the directive input values.
+     * Overrides locale-derived separators with explicitly set inputs, if provided.
+     * If no explicit separator is set, the locale-derived value is used.
+     */
+    protected updateSeparators(): void;
+    /**
+     * Overrides base validator to add precision validation.
+     * If the total number of significant digits exceeds `precision`, returns an `exceedsPrecision` error.
      */
-    private updateVariables;
+    validate(control: AbstractControl): ValidationErrors | null;
     /**
      * Responsible to calculate the field maximum length considering the separators.
      */
     private calculateMaxLength;
-    private onLocaleService;
+    private updatePlaceholder;
     static ɵfac: i0.ɵɵFactoryDeclaration<BignumberInputDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<BignumberInputDirective, "input[sBignumberInput]", never, { "precision": { "alias": "precision"; "required": false; }; "scale": { "alias": "scale"; "required": false; }; "decimalSeparator": { "alias": "decimalSeparator"; "required": false; }; "thousandsSeparator": { "alias": "thousandsSeparator"; "required": false; }; "alignTo": { "alias": "alignTo"; "required": false; }; "allowNegative": { "alias": "allowNegative"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; }, { "pasteRejected": "pasteRejected"; }, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<BignumberInputDirective, "input[sBignumberInput]", never, { "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "scale": { "alias": "scale"; "required": false; "isSignal": true; }; "minDecimalPlaces": { "alias": "minDecimalPlaces"; "required": false; "isSignal": true; }; "maxDecimalPlaces": { "alias": "maxDecimalPlaces"; "required": false; "isSignal": true; }; "decimalSeparator": { "alias": "decimalSeparator"; "required": false; "isSignal": true; }; "thousandsSeparator": { "alias": "thousandsSeparator"; "required": false; "isSignal": true; }; "thousandSeparator": { "alias": "thousandSeparator"; "required": false; "isSignal": true; }; "alignTo": { "alias": "alignTo"; "required": false; "isSignal": true; }; "allowNegative": { "alias": "allowNegative"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "minDecimalPlaces": "minDecimalPlacesChange"; "maxDecimalPlaces": "maxDecimalPlacesChange"; "decimalSeparator": "decimalSeparatorChange"; "thousandSeparator": "thousandSeparatorChange"; "placeholder": "placeholderChange"; "pasteRejected": "pasteRejected"; }, never, never, false, never>;
 }

package/dynamic-form/dynamic-form/components/lookup/lookup.component.d.ts

@@ -1,14 +1,12 @@
 import { ChangeDetectorRef, EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor, FormGroup } from '@angular/forms';
 import { TranslateService } from '@ngx-translate/core';
-import { MaskConfig } from '@seniorsistemas/ng2-currency-mask';
+import { LoadingStateIndicators } from '@seniorsistemas/angular-components/loading-state';
+import { LocalizedBignumberOptions } from '@seniorsistemas/angular-components/locale';
 import { HotkeysService } from 'angular2-hotkeys';
 import { SortMeta } from 'primeng/api';
 import { AutoComplete, AutoCompleteCompleteEvent } from 'primeng/autocomplete';
 import { Table, TableLazyLoadEvent } from 'primeng/table';
-import { DefaultFilter } from './types/default-filter';
-import { LabelOptions } from './types/label-options';
-import { LoadingStateIndicators } from '@seniorsistemas/angular-components/loading-state';
 import { DynamicStructure } from '../../configurations/structure/structure';
 import { BignumberFieldConfig } from '../../form-field/configurations/fields/bignumber-field';
 import { CurrencyFieldConfig } from '../../form-field/configurations/fields/currency-field';
@@ -17,6 +15,8 @@ import { NumberFieldConfig } from '../../form-field/configurations/fields/number
 import { SelectFieldConfig } from '../../form-field/configurations/fields/select-field';
 import { TextFieldConfig } from '../../form-field/configurations/fields/text-field';
 import { LookupSearchRequest } from './models/lookup-api.model';
+import { DefaultFilter } from './types/default-filter';
+import { LabelOptions } from './types/label-options';
 import * as i0 from "@angular/core";
 export declare class LookupComponent implements ControlValueAccessor, OnChanges, OnInit, OnDestroy {
     private readonly hotkeysService;
@@ -128,10 +128,10 @@ export declare class LookupComponent implements ControlValueAccessor, OnChanges,
     getColWidth(label: string): string;
     getScale(scale: any): number;
     private isFunction;
-    getDoubleMaskConfig(col: NumberFieldConfig | BignumberFieldConfig): MaskConfig;
-    getMoneyMaskConfig(col: CurrencyFieldConfig): MaskConfig;
-    getIntegerMaskConfig(col: BignumberFieldConfig | NumberFieldConfig): MaskConfig;
-    getNumberMaskConfig(col: NumberFieldConfig | BignumberFieldConfig): MaskConfig;
+    getDoubleMaskConfig(col: NumberFieldConfig | BignumberFieldConfig): LocalizedBignumberOptions;
+    getMoneyMaskConfig(col: CurrencyFieldConfig): LocalizedBignumberOptions;
+    getIntegerMaskConfig(col: BignumberFieldConfig | NumberFieldConfig): LocalizedBignumberOptions;
+    getNumberMaskConfig(col: NumberFieldConfig | BignumberFieldConfig): LocalizedBignumberOptions;
     parseValueMaskValue(col: DynamicType, rowData: any): any;
     fieldHasMask(field: DynamicType): field is NumberFieldConfig | BignumberFieldConfig | TextFieldConfig;
     onTableRowDoubleClick(rowData: any): void;

package/dynamic-form/dynamic-form/dynamic-form.directive.d.ts

@@ -17,12 +17,15 @@ export declare class DynamicFormDirective implements OnInit, OnChanges, OnDestro
     });
     component: ComponentRef<any> | null;
     private readonly viewContainerRef;
+    private readonly spotlightTourService;
     ngOnInit(): void;
     ngOnChanges(): void;
     ngOnDestroy(): void;
     private isField;
     private isStructure;
     private get getType();
+    private registerSpotlightStep;
+    private unregisterSpotlightStep;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicFormDirective, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<DynamicFormDirective, "[sDynamicForm]", never, { "sDynamicForm": { "alias": "sDynamicForm"; "required": false; }; }, {}, never, never, true, never>;
 }

package/dynamic-form/dynamic-form/form-field/configurations/fields/field.d.ts

@@ -53,6 +53,13 @@ export interface FieldConfig {
      * Útil para garantir que o tooltip apareça próximo ao campo correto em layouts complexos.
      */
     useInfoSignFocusedInputRef?: boolean;
+    /**
+     * ID do passo do Spotlight Tour associado a este campo.
+     * Quando definido, o campo é automaticamente registrado no `SpotlightTourService`
+     * e pode ser usado como alvo de um passo de tour ou destaque.
+     * @example 'produto-nome'
+     */
+    spotlightStepId?: string;
 }
 export interface FieldTypeMap {
 }

package/dynamic-form/public-api.d.ts

@@ -6,8 +6,8 @@ export { LookupComponent } from './dynamic-form/components/lookup/lookup.compone
 export type { LookupSearchRequest } from './dynamic-form/components/lookup/models/lookup-api.model';
 export type { BaseFieldComponentConfig } from './dynamic-form/form-field/fields/base-field-component';
 export { type ExpandedDynamicType } from './dynamic-form/configurations/structure/row';
-export * from './dynamic-form/dynamic-form.component';
-export * from './dynamic-form/dynamic-form.directive';
+export { DynamicFormComponent, dynamicTypeToDynamicStructure } from './dynamic-form/dynamic-form.component';
+export { DynamicFormDirective } from './dynamic-form/dynamic-form.directive';
 export * from './dynamic-form/dynamic-form.module';
 export type { AutocompleteFieldConfig } from './dynamic-form/form-field/configurations/fields/autocomplete-field';
 export { type BignumberFieldConfig } from './dynamic-form/form-field/configurations/fields/bignumber-field';
@@ -28,7 +28,6 @@ export { RationButtonOption, type RadioButtonFieldConfig, } from './dynamic-form
 export { type SelectFieldConfig, type SelectOption, } from './dynamic-form/form-field/configurations/fields/select-field';
 export { type SliderFieldConfig } from './dynamic-form/form-field/configurations/fields/slider-field';
 export { type StarRatingFieldConfig } from './dynamic-form/form-field/configurations/fields/star-rating-field';
-export * from './dynamic-form/form-field/configurations/fields/text-area-field';
 export { type TextAreaFieldConfig } from './dynamic-form/form-field/configurations/fields/text-area-field';
 export { type ContentGeneratorFieldConfig } from './dynamic-form/form-field/configurations/fields/content-generator-field';
 export { type TextFieldConfig } from './dynamic-form/form-field/configurations/fields/text-field';