@seniorsistemas/angular-components 19.9.14 → 19.9.15-develop-11ab86f5

package/inline-edit/README.md

@@ -18,12 +18,13 @@ Componente de edição inline que renderiza dinamicamente campos editáveis a pa
 ## Instalação
 
 ```typescript
-import { InlineEditModule } from '@seniorsistemas/angular-components/inline-edit';
+import { InlineEditComponent } from '@seniorsistemas/angular-components/inline-edit';
 
-@NgModule({
-    imports: [InlineEditModule],
+@Component({
+    standalone: true,
+    imports: [InlineEditComponent],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/inline-edit/lib/inline-edit/inline-edit.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./inline-edit.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `InlineEditComponent` (de
+ * `@seniorsistemas/angular-components/inline-edit`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class InlineEditModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<InlineEditModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<InlineEditModule, never, [typeof i1.InlineEditComponent], [typeof i1.InlineEditComponent]>;

package/input-group/lib/input-group/input-group.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./input-group.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `InputGroupComponent` (de
+ * `@seniorsistemas/angular-components/input-group`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class InputGroupModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<InputGroupModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<InputGroupModule, never, [typeof i1.InputGroupComponent], [typeof i1.InputGroupComponent]>;

package/input-mask/lib/input-mask/input-mask.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./input-mask.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `InputMaskDirective` (de
+ * `@seniorsistemas/angular-components/input-mask`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class InputMaskModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<InputMaskModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<InputMaskModule, never, [typeof i1.InputMaskDirective], [typeof i1.InputMaskDirective]>;

package/input-text/lib/input-text/input-text.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./input-text.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `InputTextDirective` (de
+ * `@seniorsistemas/angular-components/input-text`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class InputTextModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<InputTextModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<InputTextModule, never, [typeof i1.InputTextDirective], [typeof i1.InputTextDirective]>;

package/insights/README.md

@@ -20,12 +20,14 @@ Componente de painel lateral de insights com IA. Exibe uma lista de itens de ins
 ## Instalação
 
 ```typescript
-import { InsightsModule } from '@seniorsistemas/angular-components/insights';
+import { InsightsComponent } from '@seniorsistemas/angular-components/insights';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 
-@NgModule({
-    imports: [InsightsModule],
+@Component({
+    standalone: true,
+    imports: [InsightsComponent, TemplateDirective],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/insights/lib/insights/insights.module.d.ts

@@ -1,6 +1,16 @@
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/template";
 import * as i2 from "./insights.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `InsightsComponent` (de
+ * `@seniorsistemas/angular-components/insights`) no lugar deste módulo.
+ *
+ * Este módulo também reexportava `TemplateDirective` (`@seniorsistemas/angular-components/template`, usado em
+ * templates por `[sTemplate]`). Se o seu template usa algum deles, importe-o diretamente.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class InsightsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<InsightsModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<InsightsModule, never, [typeof i1.TemplateModule, typeof i2.InsightsComponent], [typeof i2.InsightsComponent, typeof i1.TemplateModule]>;

package/kanban/README.md

@@ -18,12 +18,14 @@ Componente de quadro Kanban com suporte a arrastar e soltar colunas e itens. Per
 ## Instalação
 
 ```typescript
-import { KanbanModule } from '@seniorsistemas/angular-components/kanban';
+import { KanbanComponent } from '@seniorsistemas/angular-components/kanban';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 
-@NgModule({
-    imports: [KanbanModule],
+@Component({
+    standalone: true,
+    imports: [KanbanComponent, TemplateDirective],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/kanban/lib/kanban/kanban.module.d.ts

@@ -1,6 +1,16 @@
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/template";
 import * as i2 from "./kanban.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `KanbanComponent` (de
+ * `@seniorsistemas/angular-components/kanban`) no lugar deste módulo.
+ *
+ * Este módulo também reexportava `TemplateDirective` (`@seniorsistemas/angular-components/template`, usado em
+ * templates por `[sTemplate]`). Se o seu template usa algum deles, importe-o diretamente.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class KanbanModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<KanbanModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<KanbanModule, never, [typeof i1.TemplateModule, typeof i2.KanbanComponent], [typeof i2.KanbanComponent, typeof i1.TemplateModule]>;

package/label-value/README.md

@@ -18,12 +18,13 @@ Componente para exibição de pares label/valor em modo somente leitura. Suporta
 ## Instalação
 
 ```typescript
-import { LabelValueModule } from '@seniorsistemas/angular-components/label-value';
+import { LabelValueComponent } from '@seniorsistemas/angular-components/label-value';
 
-@NgModule({
-    imports: [LabelValueModule],
+@Component({
+    standalone: true,
+    imports: [LabelValueComponent],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/label-value/lib/label-value/label-value.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./label-value.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `LabelValueComponent` (de
+ * `@seniorsistemas/angular-components/label-value`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class LabelValueModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<LabelValueModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<LabelValueModule, never, [typeof i1.LabelValueComponent], [typeof i1.LabelValueComponent]>;

package/loading-state/README.md

@@ -19,12 +19,16 @@ Componente para exibir indicadores de carregamento sobre conteúdo enquanto oper
 ## Instalação
 
 ```typescript
-import { LoadingStateModule } from '@seniorsistemas/angular-components/loading-state';
-
-@NgModule({
-    imports: [LoadingStateModule],
+import {
+  LoadingStateComponent,
+  LoadingStateDirective,
+} from '@seniorsistemas/angular-components/loading-state';
+
+@Component({
+    standalone: true,
+    imports: [LoadingStateComponent, LoadingStateDirective],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/loading-state/lib/loading-state/loading-state.module.d.ts

@@ -1,6 +1,13 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./loading-state.component";
 import * as i2 from "./loading-state.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente os standalones `LoadingStateComponent` e
+ * `LoadingStateDirective` (de `@seniorsistemas/angular-components/loading-state`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class LoadingStateModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<LoadingStateModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<LoadingStateModule, never, [typeof i1.LoadingStateComponent, typeof i2.LoadingStateDirective], [typeof i1.LoadingStateComponent, typeof i2.LoadingStateDirective]>;

package/locale/lib/locale/locale.module.d.ts

@@ -9,6 +9,19 @@ import * as i6 from "./pipes/localized-date-impure.pipe";
 import * as i7 from "./pipes/localized-time-impure.pipe";
 import * as i8 from "./pipes/localized-bignumber.pipe";
 import * as i9 from "./pipes/localized-bignumber-impure.pipe";
+/**
+ * @deprecated Será removido na v20. Importe diretamente os standalones `LocalizedCurrencyPipe`,
+ * `LocalizedDatePipe`, `LocalizedTimePipe`, `LocalizedNumberPipe`, `LocalizedCurrencyImpurePipe`,
+ * `LocalizedDateImpurePipe`, `LocalizedTimeImpurePipe`, `LocalizedBignumberPipe` e
+ * `LocalizedBignumberImpurePipe` (de `@seniorsistemas/angular-components/locale`) no lugar deste módulo.
+ *
+ * Substitua `LocaleModule.forRoot()` por `provideLocale()` (de `@seniorsistemas/angular-components/locale`).
+ *
+ * `LocaleModule.forChild()` não tem equivalente e pode ser removido.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class LocaleModule {
     static forRoot(): ModuleWithProviders<LocaleModule>;
     static forChild(): ModuleWithProviders<LocaleModule>;

package/locale/lib/locale/pipes/localized-bignumber-impure.pipe.d.ts

@@ -1,8 +1,8 @@
 import { PipeTransform } from '@angular/core';
-import { LocalizedBignumberOptions, LocalizedBignumberPipe } from './localized-bignumber.pipe';
+import { LocalizedBignumberPipe, LocalizedBignumberPipeOptions } from './localized-bignumber.pipe';
 import * as i0 from "@angular/core";
 export declare class LocalizedBignumberImpurePipe extends LocalizedBignumberPipe implements PipeTransform {
-    transform(value?: any, options?: LocalizedBignumberOptions): any;
+    transform(value?: any, options?: LocalizedBignumberPipeOptions): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<LocalizedBignumberImpurePipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<LocalizedBignumberImpurePipe, "localizedBignumberImpure", true>;
 }

package/locale/lib/locale/pipes/localized-bignumber.pipe.d.ts

@@ -2,9 +2,28 @@ import { PipeTransform } from '@angular/core';
 import { LocalizedBignumberOptions } from '../apply-localized-mask';
 import * as i0 from "@angular/core";
 export type { LocalizedBignumberOptions };
+/**
+ * Opções do pipe `localizedBignumber`: as da máscara mais as de compatibilidade com os pipes depreciados
+ * `localizedNumber` e `localizedCurrency`, que formatavam valores vazios como `0`.
+ */
+export interface LocalizedBignumberPipeOptions extends LocalizedBignumberOptions {
+    /**
+     * Quando `true`, uma string vazia (ou só com espaços) é formatada como `0`, em vez de ficar vazia.
+     * É o comportamento dos pipes depreciados `localizedNumber` e `localizedCurrency` (`Number('')` é `0`).
+     * @default false
+     */
+    emptyAsZero?: boolean;
+    /**
+     * Quando `true`, `null` é formatado como `0`, em vez de ser devolvido como está.
+     * É o comportamento do pipe depreciado `localizedNumber` (`Number(null)` é `0`). `undefined` nunca é convertido.
+     * @default false
+     */
+    nullAsZero?: boolean;
+}
 export declare class LocalizedBignumberPipe implements PipeTransform {
     private localeService;
-    transform(value?: any, options?: LocalizedBignumberOptions): any;
+    transform(value?: any, options?: LocalizedBignumberPipeOptions): any;
+    private coerceEmpty;
     private applyMask;
     static ɵfac: i0.ɵɵFactoryDeclaration<LocalizedBignumberPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<LocalizedBignumberPipe, "localizedBignumber", true>;

package/locale/lib/locale/provide-locale.d.ts

@@ -0,0 +1,18 @@
+import { EnvironmentProviders } from '@angular/core';
+/**
+ * Registra o `LocaleService` e os pipes de localização como providers, para que possam ser injetados
+ * em classes (`inject(LocalizedDatePipe)`).
+ *
+ * Substitui `LocaleModule.forRoot()` e funciona em aplicações standalone (`app.config.ts`) e também
+ * em `NgModule.providers`. Para usar os pipes nos templates, importe os pipes standalone diretamente.
+ *
+ * @example
+ * ```typescript
+ * export const appConfig: ApplicationConfig = {
+ *     providers: [provideLocale()],
+ * };
+ * ```
+ *
+ * @returns Providers de ambiente para o injetor raiz.
+ */
+export declare function provideLocale(): EnvironmentProviders;

package/locale/public-api.d.ts

@@ -1,5 +1,6 @@
 export * from './lib/locale/options/index';
 export * from './lib/locale/locale.module';
+export * from './lib/locale/provide-locale';
 export * from './lib/locale/locale.service';
 export * from './lib/locale/apply-localized-mask';
 export * from './lib/locale/pipes/localized-bignumber-impure.pipe';

package/localized-number-input/README.md

@@ -1,11 +1,14 @@
 # LocalizedNumberInput
 
-![Status](https://img.shields.io/badge/status-stable-brightgreen)
+![Status](https://img.shields.io/badge/status-deprecated-red)
+
+> **Descontinuado** — Será removido na v20. Use a diretiva [`sNumericMask`](../numeric-mask/README.md) em novos projetos.
 
 Diretiva de validação para campos `<input>` que verifica se o valor digitado é um número localizado válido, considerando os separadores decimal e de milhar do locale ativo. Integra-se ao sistema de formulários Angular via `NG_VALIDATORS`, adicionando o erro `invalidNumber` quando o valor não é válido.
 
 ## Quando usar
 
+- Manutenção de formulários legados que já utilizam `sLocalizedNumberInput`
 - Campos de entrada numérica em formulários que precisam validar o formato localizado (ex: `1.234,56` em pt-BR)
 - Quando o usuário digita livremente e você precisa garantir que o valor é um número no formato correto antes de processar
 - Aplicações multi-locale onde os separadores podem variar
@@ -15,18 +18,39 @@ Diretiva de validação para campos `<input>` que verifica se o valor digitado
 - Quando você precisa de formatação visual automática enquanto o usuário digita — prefira uma máscara numérica
 - Para campos de valores inteiros sem casas decimais — use validação nativa do Angular Forms (`Validators.pattern`)
 
-## Instalação
+## Migração
+
+A `sNumericMask` já valida o formato conforme o locale e aplica a máscara enquanto o usuário digita, então
+a entrada de caracteres inválidos é impedida. O `precision` desta diretiva (casas decimais) corresponde ao
+`maxDecimalPlaces` da `sNumericMask`, e `thousandsSeparator` corresponde a `thousandSeparator`.
+
+```html
+<!-- Antes -->
+<input sLocalizedNumberInput [precision]="2" formControlName="valor" />
+
+<!-- Depois -->
+<input sNumericMask [maxDecimalPlaces]="2" formControlName="valor" />
+```
+
+> **Atenção:** o valor do `FormControl` passa a ser uma `string` em formato internacional (ex.: `'1234.56'`),
+> e o erro `invalidNumber` deixa de existir — a `sNumericMask` reporta erros próprios (ex.: `negativeNotAllowed`).
+> Para aceitar valores negativos, informe `[allowNegative]="true"`.
+
+O schematic `ng generate @seniorsistemas/angular-components:migrate-deprecated-apis` faz essa troca automaticamente.
+
+## Instalação (legado)
 
 ```typescript
-import { LocalizedNumberInputModule } from '@seniorsistemas/angular-components/localized-number-input';
+import { LocalizedNumberInputDirective } from '@seniorsistemas/angular-components/localized-number-input';
 
-@NgModule({
-    imports: [LocalizedNumberInputModule],
+@Component({
+    standalone: true,
+    imports: [LocalizedNumberInputDirective],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
-**Dependência:** Requer `LocaleModule.forRoot()` configurado no módulo raiz da aplicação.
+**Dependência:** Requer `provideLocale()` configurado nos providers da aplicação.
 
 ## Uso básico
 
@@ -125,4 +149,4 @@ export class MeuComponent {
 ## Componentes relacionados
 
 - [`NumericMask`](../numeric-mask/README.md) — máscara de entrada com formatação visual automática enquanto o usuário digita
-- [`BigNumberInput`](../bignumber-input/README.md) — máscara para números de grande precisão
+- [`BignumberInput`](../bignumber-input/README.md) — máscara para números de grande precisão

package/localized-number-input/lib/localized-number-input/localized-number-input.directive.d.ts

@@ -2,6 +2,10 @@ import { OnInit } from '@angular/core';
 import { AbstractControl, ValidationErrors, Validator } from '@angular/forms';
 import * as i0 from "@angular/core";
 /**
+ * @deprecated Será removido na v20. Utilize a diretiva `sNumericMask` ao invés desta.
+ * O `precision` desta diretiva (casas decimais) corresponde ao `maxDecimalPlaces` da `sNumericMask`.
+ * Migração automática: `ng generate @seniorsistemas/angular-components:migrate-deprecated-apis`
+ *
  * @description Diretiva de validação para campos `<input>` que verificam se o valor digitado
  * é um número localizado válido (considerando separadores decimal e de milhar do locale ativo).
  * Ao ser integrada ao `NG_VALIDATORS`, adiciona o erro `invalidNumber` ao control quando

package/localized-number-input/lib/localized-number-input/localized-number-input.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./localized-number-input.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `LocalizedNumberInputDirective` (de
+ * `@seniorsistemas/angular-components/localized-number-input`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class LocalizedNumberInputModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<LocalizedNumberInputModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<LocalizedNumberInputModule, never, [typeof i1.LocalizedNumberInputDirective], [typeof i1.LocalizedNumberInputDirective]>;

package/mask/lib/mask/mask-formatter.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./mask-formatter.pipe";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `MaskFormatterPipe` (de
+ * `@seniorsistemas/angular-components/mask`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class MaskFormatterModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MaskFormatterModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<MaskFormatterModule, never, [typeof i1.MaskFormatterPipe], [typeof i1.MaskFormatterPipe]>;

package/mouse-events/README.md

@@ -19,12 +19,13 @@ Módulo com duas diretivas para eventos de mouse avançados: `sLongPress` (press
 ## Instalação
 
 ```typescript
-import { MouseEventsModule } from '@seniorsistemas/angular-components/mouse-events';
+import { LongPressDirective, DoubleClickDirective } from '@seniorsistemas/angular-components/mouse-events';
 
-@NgModule({
-    imports: [MouseEventsModule],
+@Component({
+    standalone: true,
+    imports: [LongPressDirective, DoubleClickDirective],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/mouse-events/lib/mouse-events/mouse-events.module.d.ts

@@ -1,6 +1,13 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./double-click.directive";
 import * as i2 from "./long-press.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente os standalones `LongPressDirective` e
+ * `DoubleClickDirective` (de `@seniorsistemas/angular-components/mouse-events`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class MouseEventsModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<MouseEventsModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<MouseEventsModule, never, [typeof i1.DoubleClickDirective, typeof i2.LongPressDirective], [typeof i2.LongPressDirective, typeof i1.DoubleClickDirective]>;

package/navigation-button/README.md

@@ -18,12 +18,13 @@ Componente de navegação por etapas que exibe o passo atual com botões de avan
 ## Instalação
 
 ```typescript
-import { NavigationButtonModule } from '@seniorsistemas/angular-components/navigation-button';
+import { NavigationButtonComponent } from '@seniorsistemas/angular-components/navigation-button';
 
-@NgModule({
-    imports: [NavigationButtonModule],
+@Component({
+    standalone: true,
+    imports: [NavigationButtonComponent],
 })
-export class MeuModule {}
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/navigation-button/lib/navigation-button/navigation-button.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./navigation-button.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `NavigationButtonComponent` (de
+ * `@seniorsistemas/angular-components/navigation-button`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class NavigationButtonModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<NavigationButtonModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NavigationButtonModule, never, [typeof i1.NavigationButtonComponent], [typeof i1.NavigationButtonComponent]>;

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

@@ -8,7 +8,7 @@ export declare enum NumberAlignmentOption {
     LEFT = "left"
 }
 /**
- * @deprecated Use a diretiva `sNumericMask` em vez desta.
+ * @deprecated Use a diretiva `sBignumberInput` em vez desta.
  * @description Alias de `BignumberInputDirective` mantido por compatibilidade.
  * Todos os inputs e outputs são idênticos ao `sBignumberInput`.
  *

package/number-input/lib/number-input/number-input.module.d.ts

@@ -1,7 +1,14 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./number-input.directive";
 /**
- * @deprecated Should use 'BignumberInputModule' instead
+ * @deprecated Será removido na v20. Importe diretamente o standalone `BignumberInputDirective` (de
+ * `@seniorsistemas/angular-components/bignumber-input`) no lugar deste módulo.
+ *
+ * Atenção: o `sNumberInput` está depreciado em favor do `sNumericMask`; revise os templates (o schematic
+ * `migrate-deprecated-apis` faz essa troca e grava os defaults antigos de forma explícita).
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
  */
 export declare class NumberInputModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<NumberInputModule, never>;

package/numeric/README.md

@@ -18,15 +18,16 @@ Pipe e serviço Angular para formatação de valores numéricos de acordo com o
 ## Instalação
 
 ```typescript
-import { NumericModule } from '@seniorsistemas/angular-components/numeric';
+import { NumericPipe } from '@seniorsistemas/angular-components/numeric';
 
-@NgModule({
-  imports: [NumericModule, AsyncPipe],
+@Component({
+  standalone: true,
+  imports: [NumericPipe, AsyncPipe],
 })
-export class MeuModulo {}
+export class MeuComponent {}
 ```
 
-O `NumericModule` requer `LocaleModule.forRoot()` configurado no módulo raiz da aplicação.
+O `NumericPipe` requer `provideLocale()` configurado nos providers da aplicação.
 
 ## Uso básico
 

package/numeric/lib/numeric.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./numeric.pipe";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `NumericPipe` (de
+ * `@seniorsistemas/angular-components/numeric`) no lugar deste módulo.
+ *
+ * Migração automática (também executada pelo `ng update` na v20):
+ * `ng generate @seniorsistemas/angular-components:migrate-modules-to-standalone`
+ */
 export declare class NumericModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<NumericModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<NumericModule, never, [typeof i1.NumericPipe], [typeof i1.NumericPipe]>;

package/numeric-mask/README.md

@@ -58,15 +58,30 @@ export class MeuComponent {
 | `max`                     | `number \| undefined`                                  | `undefined`               |     Não     | Valor máximo permitido (validação de formulário)                                                                                                                  |
 | `blockDecimalOverflow`    | `boolean`                                              | `true`                    |     Não     | Bloqueia a digitação e a colagem de casas decimais além de `maxDecimalPlaces`. Quando `maxDecimalPlaces` é `0`, o próprio separador decimal não pode ser digitado |
 | `decimalRoundingMode`     | `'preserve' \| 'truncate' \| 'roundUp' \| 'roundDown'` | `'preserve'`              |     Não     | Estratégia aplicada no `blur` quando `blockDecimalOverflow` é `false`. Sem efeito enquanto `blockDecimalOverflow` for `true`                                      |
+| `precision`               | `number \| undefined`                                  | `undefined`               |     Não     | Opt-in: limite de dígitos significativos totais (parte inteira + decimal). Enquanto `undefined`, não há limite, `maxLength` nativo não é aplicado, colagens nunca são rejeitadas e `placeholder` nunca é calculado automaticamente |
+| `placeholder`             | `string \| undefined`                                  | `undefined`               |     Não     | Texto exibido com o campo vazio. Quando `precision` está definido e este input não é informado, é calculado automaticamente a partir de `minDecimalPlaces` (ex: `0,00`) |
+
+### Outputs
+
+| Evento          | Tipo                 | Descrição                                                                                     |
+| --------------- | -------------------- | ----------------------------------------------------------------------------------------------- |
+| `pasteRejected` | `EventEmitter<string>` | Emitido quando uma colagem é rejeitada por exceder `precision`. Só é emitido com `precision` definido; emite o texto colado rejeitado |
 
 ### Tipos
 
 ```typescript
-// O valor do modelo (ngModel / FormControl) é sempre string no formato decimal internacional
+// O valor emitido para o modelo (ngModel / FormControl) é sempre string no formato decimal internacional
 // Exemplo: "1234567.89" para o valor 1.234.567,89 em pt-BR
 type NumericMaskModelValue = string | null;
 ```
 
+O modelo também aceita `number` na entrada: um valor definido por código (por exemplo, `patchValue` com o DTO vindo do backend) é formatado e validado normalmente. Depois que o usuário edita o campo, o valor volta a ser emitido como `string`.
+
+```typescript
+form.patchValue({ valor: 1234.5 }); // exibe "1.234,50", controle válido
+// após o usuário digitar 1234,56: form.value.valor === '1234.56'
+```
+
 ### Erros de validação emitidos
 
 ```typescript
@@ -98,6 +113,14 @@ type NumericMaskModelValue = string | null;
         actual: number;
     }
 }
+
+// Dígitos significativos acima de `precision` (só quando `precision` está definido)
+{
+    exceedsPrecision: {
+        precision: number;
+        actual: number;
+    }
+}
 ```
 
 ## Comportamento de excesso de casas decimais
@@ -239,6 +262,25 @@ Desligando o bloqueio (`[blockDecimalOverflow]="false"`), a digitação volta a
 />
 ```
 
+### Campo com limite de dígitos significativos (`precision`, opt-in)
+
+Ao definir `precision`, o campo ganha um `maxLength` nativo calculado automaticamente, um `placeholder` auto-calculado (quando não informado) e passa a rejeitar colagens que excedam o limite, emitindo `pasteRejected`:
+
+```html
+<input
+    type="text"
+    sNumericMask
+    locale="pt-BR"
+    [minDecimalPlaces]="2"
+    [maxDecimalPlaces]="2"
+    [precision]="15"
+    (pasteRejected)="onPasteRejected($event)"
+    [(ngModel)]="valor"
+/>
+```
+
+Sem `precision` (o padrão), nada disso é aplicado — o comportamento é idêntico ao de antes desse input existir.
+
 ## Acessibilidade
 
 - Define automaticamente `inputmode="decimal"` no elemento host para exibir teclado numérico em dispositivos móveis
@@ -250,6 +292,7 @@ Desligando o bloqueio (`[blockDecimalOverflow]="false"`), a digitação volta a
 
 - [`NumericPipe`](../numeric/README.md) — formatação de valores numéricos para exibição somente leitura
 - [`NumberInput`](../number-input/src/lib/number-input/README.md) — diretiva descontinuada, use `sNumericMask` em seu lugar
+- [`BignumberInput`](../bignumber-input/README.md) — diretiva descontinuada que estende `NumericMaskDirective`; usa `precision`, `maxLength`, `placeholder` auto-calculado e `pasteRejected` sempre ativos (via `precision` com default `15`)
 
 ## Migração