mapa-library-ui 1.7.2 → 1.8.0

package/index.d.ts

@@ -1,7 +1,8 @@
 import { FormControl, NgModel, AbstractControl, FormGroup, ControlValueAccessor } from '@angular/forms';
 import * as i0 from '@angular/core';
-import { EventEmitter, AfterViewInit, ElementRef, OnChanges, OnDestroy, Renderer2, SimpleChanges, InjectionToken, Provider, PipeTransform, OnInit, ChangeDetectorRef, DoCheck, Injector, TemplateRef, ApplicationRef } from '@angular/core';
+import { EventEmitter, OnInit, AfterViewInit, ElementRef, OnChanges, OnDestroy, Renderer2, SimpleChanges, InjectionToken, Provider, PipeTransform, ChangeDetectorRef, DoCheck, Injector, TemplateRef, ApplicationRef } from '@angular/core';
 import { ApexAxisChartSeries, ApexChart, ApexTitleSubtitle, ApexXAxis, ApexStroke, ApexFill, ApexMarkers, ApexYAxis, ApexLegend, ApexResponsive } from 'ng-apexcharts';
+import { UrlTree, Params } from '@angular/router';
 import { MatInput } from '@angular/material/input';
 import { MatPaginator, MatPaginatorIntl, PageEvent } from '@angular/material/paginator';
 import * as rxjs from 'rxjs';
@@ -220,7 +221,8 @@ interface DialogData {
 interface MenuActionItem {
     image?: string;
     icon?: string;
-    route?: string;
+    route?: string | unknown[] | UrlTree;
+    queryParams?: Params;
     showText?: boolean;
     svg?: string;
     text: string;
@@ -281,6 +283,50 @@ interface TableStatus {
     finished: boolean;
 }
 
+/**
+ * Mantém o FormControl em sincronia com `input.value` quando o valor foi escrito
+ * por algo que não é o usuário: autofill do navegador, gerenciador de senhas ou
+ * extensão (geradores de CPF/CNPJ).
+ *
+ * A NgxMaskDirective é o ControlValueAccessor de todo input com máscara desta
+ * biblioteca e só empurra valor para o modelo a partir do seu host listener de
+ * `input`. O handler de `blur` chama `onTouch()` mas nunca `onChange()`, e não
+ * existe listener de `change`. Um agente externo que atribui `element.value` sem
+ * disparar um evento `input` nativo deixa o controle no valor anterior, mantendo
+ * o erro `required` na tela até o usuário redigitar o campo.
+ *
+ * Esta diretiva detecta a divergência e reenvia o evento `input` que faltou,
+ * fazendo a NgxMaskDirective analisar, re-renderizar e emitir exatamente como se
+ * o usuário tivesse colado o valor. É no-op enquanto DOM e modelo concordam.
+ */
+declare class MapaMaskAutofillSyncDirective implements OnInit {
+    /** Permite desligar a reconciliação em um campo específico. */
+    mapaMaskAutofillSync: boolean;
+    private readonly elementRef;
+    private readonly destroyRef;
+    private readonly autofillMonitor;
+    private readonly maskDirective;
+    private readonly maskService;
+    private readonly ngControl;
+    private reconciling;
+    ngOnInit(): void;
+    /** Idempotente: não faz nada enquanto DOM e modelo concordam. */
+    reconcile(): void;
+    private isInSync;
+    /**
+     * Sem máscara, o texto renderizado e o valor de modelo são a mesma string. Com
+     * máscara eles diferem apenas pelos caracteres especiais, então limpar os dois
+     * lados com as regras da própria NgxMaskService vale tanto para
+     * `dropSpecialCharacters: true` quanto para `false`.
+     */
+    private toComparable;
+    private toModelValue;
+    private stringify;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MapaMaskAutofillSyncDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MapaMaskAutofillSyncDirective, "input[mask], textarea[mask]", ["mapaMaskAutofillSync"], { "mapaMaskAutofillSync": { "alias": "mapaMaskAutofillSync"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_mapaMaskAutofillSync: unknown;
+}
+
 declare class MatInputAutosizeDirective implements AfterViewInit {
     private childMatInput;
     private childNgModel;
@@ -476,6 +522,20 @@ declare function getDateInputMask(_locale?: MapaDateLocale): string;
 declare function formatDateForLocale(date: Date, locale?: MapaDateLocale): string;
 declare function parseLocaleDateValue(value: string, locale?: MapaDateLocale): Date | null;
 declare function parseDateValue(value: unknown, locale?: MapaDateLocale): Date | null;
+/**
+ * Parse estrito para o texto de um campo de data mascarado.
+ *
+ * Diferente de `parseDateValue`, não cai em `new Date(string)` para qualquer
+ * entrada. O motor de datas do V8 aceita fragmentos numéricos e devolve datas
+ * inventadas — `"2"` vira 01/02/2001 e `"251220"` vira o ano 251220 —, o que
+ * fazia os datepickers moverem o calendário a cada tecla enquanto o usuário
+ * ainda estava digitando.
+ *
+ * Aceita apenas uma data completa no formato do locale ativo (com validação de
+ * faixa de dia/mês) ou uma data ISO-8601, para não quebrar valores vindos de
+ * API que o consumidor grave direto no controle.
+ */
+declare function parseDateFieldValue(value: unknown, locale?: MapaDateLocale): Date | null;
 declare function isDateValue(value: unknown): boolean;
 declare function parseBrazilianDate(value: string): Date | null;
 declare function normalizeDateInput(value: DateInput$1): Date | null;
@@ -2049,5 +2109,5 @@ declare class MapaScaleParameterizationComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<MapaScaleParameterizationComponent, "mapa-scale-parameterization", never, { "data": { "alias": "data"; "required": false; }; "showProgressbar": { "alias": "showProgressbar"; "required": false; }; "showInterval": { "alias": "showInterval"; "required": false; }; "showDots": { "alias": "showDots"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { AIH_ESTADOS, AIH_TIPOS, BubblePaginationDirective, ButtonComponent, ButtonIconComponent, CEPRange, CID_NAME, CID_REGEX, CORES, CPFPipe, CapabilityClassificationService, CheckboxComponent, Datepicker, DatepickerRange, Dropdown, DropdownTree, ESTADOS, ESTADOS_SIGLA, ElementBase, FiltersComponent, HtmlSanitizerService, IPTUCREATE, IPTUMASKS, IPTUVALIDATE, IconComponent, InputText, LOCALIZACAO_BAIRROS, LOCALIZACAO_CIDADES, LOCALIZACAO_COMPLEMENTOS, LOCALIZACAO_ESTADOS, LOCALIZACAO_LOGRADOUROS, LOCALIZACAO_RUAS, LocaleDatePipe, LocaleDateTimePipe, MAPA_DATEPICKER_FORMATS, MAPA_UI_TEXTS, MASKSIE, MapaBenchmarkChartComponent, MapaBenchmarkIndicatorComponent, MapaBreadcrumbComponent, MapaCapabilityComparativeChartComponent, MapaCapabilityComparativeComponent, MapaCapabilityComparativeHeaderComponent, MapaCapabilityDetailComponent, MapaCapabilityDotComponent, MapaCapabilityExpandComponent, MapaCapabilityIndicatorChartComponent, MapaCapabilityIndicatorComponent, MapaCapabilityIndicatorListComponent, MapaCapabilityIntervalBarComponent, MapaCapabilityIntervalComponent, MapaChartComponent, MapaDatepicker, MapaDatepickerRange, MapaDetailsComponent, MapaDialogComponent, MapaDropdownComponent, MapaDropdownTreeComponent, MapaEmptyStateComponent, MapaFormComponent, MapaFormErrorsComponent, MapaGroupReportComponent, MapaI18nService, MapaInputComponent, MapaMenuComponent, MapaNavListComponent, MapaProgressbarComponent, MapaScaleComponent, MapaScaleParameterizationComponent, MapaSvgIconComponent, MapaTableComponent, MapaTextareaComponent, MapaTooltipComponent, MapaTooltipDirective, MapaWarningComponent, MatInputAutosizeDirective, PLACAS_INVALID, PLACAS_RANGE, RadioButton, RadioButtonComponent, ReportItemComponent, SafeHtmlPipe, SlideToggle, SlideToggleComponent, TagComponent, Textarea, ValidationMessageResolverService, addDays, addMonthsToDateValue, allNumbersAreSame, buildDetailedIndicatorSections, buildIndicatorCollections, cep_ranges, create_aih, create_cartaocredito, create_certidao, create_cnh, create_cnhespelho, create_cnpj, create_cns, create_cpf, create_ect, create_iptu, create_iptu_ctba, create_iptu_sp, create_pispasep, create_processo, create_renachestadual, create_renachseguranca, create_renavam, create_titulo, create_titulo_atual, creditCardValidator, currencyToNumber, customPaginatorFactory, faker_iptu, fillString, formatBrazilianDate, formatDateAsDayMonthYear, formatDateAsMonthDayYear, formatDateByLanguage, formatDateForLocale, formatDateTimeByLanguage, formatDateValue, formatLocaleDate, formatLocaleDateTime, generateInscricaoEstadual, getActiveDateFormat, getActiveDateLocale, getActiveMaterialDateFormat, getAllDigits, getAllWords, getDateFormatByLanguage, getDateInputMask, getDateTimeFormatByLanguage, getDayOfMonthFromDateValue, getDefaultDateRange, getMapaDatepickerRangeFormats, getRelativeDateRange, getSpecialProperty, getYearFromDateValue, isAfterDateValue, isArray, isDateValue, isMonthFirstDateLocale, isNil, isNumber, isPresent, isString, isValidDateByLanguage, isValidDateValue, makeGenericFaker, maskBr, mask_iptu, mergeMapaUiTexts, modulo11, modulo11Custom, modulo11a, normalizeDateInput, normalizeDateLocale, normalizeLookup, normalizeText, numberToCurrency, openDialog, parseBrazilianDate, parseDateByLanguage, parseDateValue, parseDateValueFns, parseLocaleDateValue, processCaretTraps, provideMapaUiTexts, rand, randArray, randomEstadoSigla, randomLetter, randomLetterOrNumber, randomNumber, reformatDateStringForLanguage, rg_rj, rg_sp, sanitizeHtmlContent, setTimeOnDateValue, slugify, toDatepickerLocale, toIsoDateByLanguage, toIsoDateByLanguageWithUtcTime, toIsoDateValue, toIsoDateValueWithTime, toIsoDateValueWithUtcTime, toUtcDayExclusiveEndIso, toUtcRangeEndIso, toUtcRangeStartIso, utilsBr, validateBr, validate_aih, validate_cartaocredito, validate_celular, validate_cep, validate_certidao, validate_chassi, validate_cnh, validate_cnhespelho, validate_cnpj, validate_cns, validate_cpf, validate_currency, validate_datahora, validate_datetime, validate_ect, validate_inscricaoestadual, validate_iptu, validate_iptu_contagem, validate_iptu_ctba, validate_iptu_sp, validate_number, validate_pispasep, validate_placa, validate_porcentagem, validate_processo, validate_renachestadual, validate_renachseguranca, validate_renavam, validate_rg, validate_sped, validate_telefone, validate_time, validate_titulo };
+export { AIH_ESTADOS, AIH_TIPOS, BubblePaginationDirective, ButtonComponent, ButtonIconComponent, CEPRange, CID_NAME, CID_REGEX, CORES, CPFPipe, CapabilityClassificationService, CheckboxComponent, Datepicker, DatepickerRange, Dropdown, DropdownTree, ESTADOS, ESTADOS_SIGLA, ElementBase, FiltersComponent, HtmlSanitizerService, IPTUCREATE, IPTUMASKS, IPTUVALIDATE, IconComponent, InputText, LOCALIZACAO_BAIRROS, LOCALIZACAO_CIDADES, LOCALIZACAO_COMPLEMENTOS, LOCALIZACAO_ESTADOS, LOCALIZACAO_LOGRADOUROS, LOCALIZACAO_RUAS, LocaleDatePipe, LocaleDateTimePipe, MAPA_DATEPICKER_FORMATS, MAPA_UI_TEXTS, MASKSIE, MapaBenchmarkChartComponent, MapaBenchmarkIndicatorComponent, MapaBreadcrumbComponent, MapaCapabilityComparativeChartComponent, MapaCapabilityComparativeComponent, MapaCapabilityComparativeHeaderComponent, MapaCapabilityDetailComponent, MapaCapabilityDotComponent, MapaCapabilityExpandComponent, MapaCapabilityIndicatorChartComponent, MapaCapabilityIndicatorComponent, MapaCapabilityIndicatorListComponent, MapaCapabilityIntervalBarComponent, MapaCapabilityIntervalComponent, MapaChartComponent, MapaDatepicker, MapaDatepickerRange, MapaDetailsComponent, MapaDialogComponent, MapaDropdownComponent, MapaDropdownTreeComponent, MapaEmptyStateComponent, MapaFormComponent, MapaFormErrorsComponent, MapaGroupReportComponent, MapaI18nService, MapaInputComponent, MapaMaskAutofillSyncDirective, MapaMenuComponent, MapaNavListComponent, MapaProgressbarComponent, MapaScaleComponent, MapaScaleParameterizationComponent, MapaSvgIconComponent, MapaTableComponent, MapaTextareaComponent, MapaTooltipComponent, MapaTooltipDirective, MapaWarningComponent, MatInputAutosizeDirective, PLACAS_INVALID, PLACAS_RANGE, RadioButton, RadioButtonComponent, ReportItemComponent, SafeHtmlPipe, SlideToggle, SlideToggleComponent, TagComponent, Textarea, ValidationMessageResolverService, addDays, addMonthsToDateValue, allNumbersAreSame, buildDetailedIndicatorSections, buildIndicatorCollections, cep_ranges, create_aih, create_cartaocredito, create_certidao, create_cnh, create_cnhespelho, create_cnpj, create_cns, create_cpf, create_ect, create_iptu, create_iptu_ctba, create_iptu_sp, create_pispasep, create_processo, create_renachestadual, create_renachseguranca, create_renavam, create_titulo, create_titulo_atual, creditCardValidator, currencyToNumber, customPaginatorFactory, faker_iptu, fillString, formatBrazilianDate, formatDateAsDayMonthYear, formatDateAsMonthDayYear, formatDateByLanguage, formatDateForLocale, formatDateTimeByLanguage, formatDateValue, formatLocaleDate, formatLocaleDateTime, generateInscricaoEstadual, getActiveDateFormat, getActiveDateLocale, getActiveMaterialDateFormat, getAllDigits, getAllWords, getDateFormatByLanguage, getDateInputMask, getDateTimeFormatByLanguage, getDayOfMonthFromDateValue, getDefaultDateRange, getMapaDatepickerRangeFormats, getRelativeDateRange, getSpecialProperty, getYearFromDateValue, isAfterDateValue, isArray, isDateValue, isMonthFirstDateLocale, isNil, isNumber, isPresent, isString, isValidDateByLanguage, isValidDateValue, makeGenericFaker, maskBr, mask_iptu, mergeMapaUiTexts, modulo11, modulo11Custom, modulo11a, normalizeDateInput, normalizeDateLocale, normalizeLookup, normalizeText, numberToCurrency, openDialog, parseBrazilianDate, parseDateByLanguage, parseDateFieldValue, parseDateValue, parseDateValueFns, parseLocaleDateValue, processCaretTraps, provideMapaUiTexts, rand, randArray, randomEstadoSigla, randomLetter, randomLetterOrNumber, randomNumber, reformatDateStringForLanguage, rg_rj, rg_sp, sanitizeHtmlContent, setTimeOnDateValue, slugify, toDatepickerLocale, toIsoDateByLanguage, toIsoDateByLanguageWithUtcTime, toIsoDateValue, toIsoDateValueWithTime, toIsoDateValueWithUtcTime, toUtcDayExclusiveEndIso, toUtcRangeEndIso, toUtcRangeStartIso, utilsBr, validateBr, validate_aih, validate_cartaocredito, validate_celular, validate_cep, validate_certidao, validate_chassi, validate_cnh, validate_cnhespelho, validate_cnpj, validate_cns, validate_cpf, validate_currency, validate_datahora, validate_datetime, validate_ect, validate_inscricaoestadual, validate_iptu, validate_iptu_contagem, validate_iptu_ctba, validate_iptu_sp, validate_number, validate_pispasep, validate_placa, validate_porcentagem, validate_processo, validate_renachestadual, validate_renachseguranca, validate_renavam, validate_rg, validate_sped, validate_telefone, validate_time, validate_titulo };
 export type { ActionButton, Benchmark, BenchmarkMark, BenchmarkingChart, Classification as BenchmarkingClassification, BigObject, Breadpiece, ButtonIcon, Candidate, Capability, CapabilityClassification, CapabilityComparative, CapabilityItem, ChartOptions, Classification$1 as Classification, Competence$1 as Competence, DataNode, DateFormatPattern, DateInput$1 as DateInput, DateTimeFormatPattern, DatepickerLocale, DetailedIndicatorItem, DetailedIndicatorSection, DialogData, Dimension$1 as Dimension, ElementOption, ElementSearch, ElementTreeNode, Errors, EstadosType, EvaluationBenchmarkResult, Dimension$2 as GroupReportDimension, GroupReportItem, IndicatorCollectionOptions, IndicatorCollections, Indicators, LocaleDateStyle, LowReliabilityReport, MapaDateFormat, MapaDateLocale, MapaDatepickerRangeComponent, MapaDatepickerRangeControlValue, MapaDatepickerRangeFormGroup, MapaUiTexts, MaskType, Masks, MasksIE, MenuActionEvent, MenuActionItem, MenuItem, ProgressBar$1 as ProgressBar, ReportItem, ReportItemMenuItem, RowClickEvent, Scale$1 as Scale, Competence as ScaleParameterizationCompetence, Dimension as ScaleParameterizationDimension, ProgressBar as ScaleParameterizationProgressBar, Scale as ScaleParameterizationScale, SelectedTableRow, Status, TableCellStyleClass, TableColumn, TableColumnStatus, TableEmptyState, TableRowData, TableStatus, Tag, ValidationMessageContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mapa-library-ui",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "peerDependencies": {
     "@angular/animations": "^20.3.0",
     "@angular/cdk": "^20.2.0",

package/src/lib/components/menu/index.d.ts

@@ -1,3 +1,4 @@
+import { UrlTree, Params } from '@angular/router';
 import * as i0 from '@angular/core';
 import { EventEmitter } from '@angular/core';
 import { MatMenuTrigger } from '@angular/material/menu';
@@ -5,7 +6,8 @@ import { MatMenuTrigger } from '@angular/material/menu';
 interface MenuActionItem {
     image?: string;
     icon?: string;
-    route?: string;
+    route?: string | unknown[] | UrlTree;
+    queryParams?: Params;
     showText?: boolean;
     svg?: string;
     text: string;

package/src/lib/components/report-item/index.d.ts

@@ -1,10 +1,12 @@
 import * as i0 from '@angular/core';
 import { OnChanges, EventEmitter, SimpleChanges } from '@angular/core';
+import { UrlTree, Params } from '@angular/router';
 
 interface MenuActionItem {
     image?: string;
     icon?: string;
-    route?: string;
+    route?: string | unknown[] | UrlTree;
+    queryParams?: Params;
     showText?: boolean;
     svg?: string;
     text: string;

package/src/lib/components/table/index.d.ts

@@ -1,6 +1,7 @@
 import * as i0 from '@angular/core';
 import { AfterViewInit, OnChanges, OnDestroy, EventEmitter, ElementRef, Renderer2, SimpleChanges, Injector, ChangeDetectorRef } from '@angular/core';
 import { MatPaginator, MatPaginatorIntl, PageEvent } from '@angular/material/paginator';
+import { UrlTree, Params } from '@angular/router';
 import * as rxjs from 'rxjs';
 import * as mapa_frontend_i18n from 'mapa-frontend-i18n';
 import { MapaUiTextGroups, ValidationContext, PartialMapaUiTexts } from 'mapa-frontend-i18n';
@@ -62,7 +63,8 @@ interface TableEmptyState {
 interface MenuActionItem {
     image?: string;
     icon?: string;
-    route?: string;
+    route?: string | unknown[] | UrlTree;
+    queryParams?: Params;
     showText?: boolean;
     svg?: string;
     text: string;

package/src/lib/core/utils/index.d.ts

@@ -52,6 +52,20 @@ declare function getDateInputMask(_locale?: MapaDateLocale): string;
 declare function formatDateForLocale(date: Date, locale?: MapaDateLocale): string;
 declare function parseLocaleDateValue(value: string, locale?: MapaDateLocale): Date | null;
 declare function parseDateValue(value: unknown, locale?: MapaDateLocale): Date | null;
+/**
+ * Parse estrito para o texto de um campo de data mascarado.
+ *
+ * Diferente de `parseDateValue`, não cai em `new Date(string)` para qualquer
+ * entrada. O motor de datas do V8 aceita fragmentos numéricos e devolve datas
+ * inventadas — `"2"` vira 01/02/2001 e `"251220"` vira o ano 251220 —, o que
+ * fazia os datepickers moverem o calendário a cada tecla enquanto o usuário
+ * ainda estava digitando.
+ *
+ * Aceita apenas uma data completa no formato do locale ativo (com validação de
+ * faixa de dia/mês) ou uma data ISO-8601, para não quebrar valores vindos de
+ * API que o consumidor grave direto no controle.
+ */
+declare function parseDateFieldValue(value: unknown, locale?: MapaDateLocale): Date | null;
 declare function isDateValue(value: unknown): boolean;
 declare function parseBrazilianDate(value: string): Date | null;
 declare function normalizeDateInput(value: DateInput): Date | null;
@@ -75,5 +89,5 @@ declare function toUtcRangeStartIso(value: DateInput): string | undefined;
 declare function toUtcRangeEndIso(value: DateInput): string | undefined;
 declare function toUtcDayExclusiveEndIso(value: DateInput): string | undefined;
 
-export { addDays, addMonthsToDateValue, formatBrazilianDate, formatDateAsDayMonthYear, formatDateAsMonthDayYear, formatDateByLanguage, formatDateForLocale, formatDateTimeByLanguage, formatDateValue, formatLocaleDate, formatLocaleDateTime, getActiveDateFormat, getActiveDateLocale, getActiveMaterialDateFormat, getDateFormatByLanguage, getDateInputMask, getDateTimeFormatByLanguage, getDayOfMonthFromDateValue, getDefaultDateRange, getRelativeDateRange, getYearFromDateValue, isAfterDateValue, isDateValue, isMonthFirstDateLocale, isValidDateByLanguage, isValidDateValue, normalizeDateInput, normalizeDateLocale, parseBrazilianDate, parseDateByLanguage, parseDateValue, parseDateValueFns, parseLocaleDateValue, reformatDateStringForLanguage, setTimeOnDateValue, toDatepickerLocale, toIsoDateByLanguage, toIsoDateByLanguageWithUtcTime, toIsoDateValue, toIsoDateValueWithTime, toIsoDateValueWithUtcTime, toUtcDayExclusiveEndIso, toUtcRangeEndIso, toUtcRangeStartIso };
+export { addDays, addMonthsToDateValue, formatBrazilianDate, formatDateAsDayMonthYear, formatDateAsMonthDayYear, formatDateByLanguage, formatDateForLocale, formatDateTimeByLanguage, formatDateValue, formatLocaleDate, formatLocaleDateTime, getActiveDateFormat, getActiveDateLocale, getActiveMaterialDateFormat, getDateFormatByLanguage, getDateInputMask, getDateTimeFormatByLanguage, getDayOfMonthFromDateValue, getDefaultDateRange, getRelativeDateRange, getYearFromDateValue, isAfterDateValue, isDateValue, isMonthFirstDateLocale, isValidDateByLanguage, isValidDateValue, normalizeDateInput, normalizeDateLocale, parseBrazilianDate, parseDateByLanguage, parseDateFieldValue, parseDateValue, parseDateValueFns, parseLocaleDateValue, reformatDateStringForLanguage, setTimeOnDateValue, toDatepickerLocale, toIsoDateByLanguage, toIsoDateByLanguageWithUtcTime, toIsoDateValue, toIsoDateValueWithTime, toIsoDateValueWithUtcTime, toUtcDayExclusiveEndIso, toUtcRangeEndIso, toUtcRangeStartIso };
 export type { DateFormatPattern, DateInput, DateTimeFormatPattern, DatepickerLocale, LocaleDateStyle, MapaDateFormat, MapaDateLocale };