@seniorsistemas/angular-components 19.9.15 → 19.10.0-develop-ef29acb7

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
 

package/numeric-mask/lib/numeric-mask/numeric-mask.directive.d.ts

@@ -72,6 +72,25 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
      * @default 'preserve'
      */
     decimalRoundingMode: import("@angular/core").InputSignal<"preserve" | "truncate" | "roundUp" | "roundDown">;
+    /**
+     * Maximum number of significant digits accepted by the field (integer + decimal part).
+     * Opt-in: when left `undefined` (default), there is no total-digit limit, no native `maxLength`
+     * is applied, pasted values are never rejected, and `placeholder` is never auto-calculated —
+     * i.e. the directive behaves exactly as before this input existed.
+     */
+    precision: import("@angular/core").InputSignal<number | undefined>;
+    /**
+     * Placeholder text shown when the field is empty. When `precision` is set and this is left
+     * unset, it is auto-calculated from `minDecimalPlaces` (e.g. `0,00`); has no effect otherwise.
+     */
+    placeholder: import("@angular/core").ModelSignal<string | undefined>;
+    /**
+     * Emitted when a pasted value is rejected for exceeding `precision`. Only fires when
+     * `precision` is set; emits the rejected pasted text.
+     */
+    pasteRejected: import("@angular/core").OutputEmitterRef<string>;
+    /** Native `maxLength` attribute, auto-calculated from `precision` when it is set. */
+    maxLength: number | undefined;
     private readonly elementRef;
     private readonly renderer;
     private readonly localeService;
@@ -82,6 +101,11 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
     thousandSeparator: import("@angular/core").ModelSignal<string>;
     protected currentLocale: string;
     private lastModelValue;
+    /** `protected`: subclasses with their own deprecated separator aliases (e.g. `BignumberInputDirective`) set this directly. */
+    protected _decimalSeparatorExplicit: boolean;
+    /** `protected`: see `_decimalSeparatorExplicit`. */
+    protected _thousandSeparatorExplicit: boolean;
+    private _lastAutoPlaceholder;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
     /**
@@ -97,9 +121,16 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
      */
     onBlur(): void;
     /**
-     * Listener for paste events (clipboard)
+     * Listener for paste events (clipboard). When `precision` is set and the pasted value would
+     * exceed it, the paste is rejected outright (nothing is written) and `pasteRejected` fires.
      */
     onPaste(event: ClipboardEvent): void;
+    /**
+     * Whether a raw pasted string, once stripped of separators, has more significant digits
+     * than `precision` allows.
+     * @private
+     */
+    private exceedsPrecision;
     /**
      * Listener for special keys (+ and -)
      */
@@ -109,9 +140,24 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
      */
     onKeyPress(event: KeyboardEvent): void;
     /**
-     * Updates separators according to the locale
+     * Updates separators according to the locale. An explicitly bound `decimalSeparator`/
+     * `thousandSeparator` (tracked in `ngOnChanges`) is restored afterwards, so a locale
+     * change never silently overrides a value the consumer set on purpose.
      */
     protected updateSeparators(): void;
+    /**
+     * Auto-calculates the native `maxLength` from `precision`, sized for the current separators
+     * and `maxDecimalPlaces`. No-op (leaves `maxLength` unset) while `precision` is `undefined`.
+     * `protected`: subclasses that map their own deprecated inputs into `minDecimalPlaces`/
+     * `maxDecimalPlaces`/`thousandSeparator` outside of a tracked `changes` key call this directly.
+     */
+    protected calculateMaxLength(): void;
+    /**
+     * Auto-calculates `placeholder` (e.g. `0,00`) from `minDecimalPlaces`, without overwriting
+     * a value the consumer set explicitly. No-op while `precision` is `undefined`.
+     * `protected`: see `calculateMaxLength`.
+     */
+    protected updatePlaceholder(): void;
     /**
      * Processes input value and updates the input and model
      * @private
@@ -164,6 +210,21 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
      * @private
      */
     private parseStringToValue;
+    /**
+     * Groups an integer digit string (optionally signed) using `thousandSeparator`.
+     *
+     * Previously this used `Intl.NumberFormat(currentLocale)` and then tried to strip the
+     * locale's own grouping via `.split(decimalSeparator())`, which (a) ignored a custom
+     * `thousandSeparator` entirely — always falling back to the locale's own grouping
+     * character instead, e.g. `thousandSeparator=""` had no effect — and (b) corrupted the
+     * result whenever the locale's grouping character happened to equal `decimalSeparator`
+     * (e.g. a custom `decimalSeparator="."` under `pt-BR`, which groups thousands with `.`
+     * too): `"1.234".split('.')[0]` returned `"1"` instead of `"1234"`. Grouping the digits
+     * directly with the directive's own (already locale/explicit-resolved) `thousandSeparator`
+     * avoids the detour through `Intl.NumberFormat` and both bugs.
+     * @private
+     */
+    private groupIntegerDigits;
     /**
      * Formats a numeric value according to the locale
      * Truncates (never rounds) to maxDecimalPlaces and pads with zeros to minDecimalPlaces
@@ -193,11 +254,11 @@ export declare class NumericMaskDirective implements OnInit, OnChanges, ControlV
      * @private
      */
     private toggleSign;
-    writeValue(value: string | null): void;
+    writeValue(value: string | number | null): void;
     registerOnChange(fn: (value: string | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     validate(control: AbstractControl): ValidationErrors | null;
     static ɵfac: i0.ɵɵFactoryDeclaration<NumericMaskDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<NumericMaskDirective, "[sNumericMask]", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "minDecimalPlaces": { "alias": "minDecimalPlaces"; "required": false; "isSignal": true; }; "maxDecimalPlaces": { "alias": "maxDecimalPlaces"; "required": false; "isSignal": true; }; "allowNegative": { "alias": "allowNegative"; "required": false; "isSignal": true; }; "allowScientificNotation": { "alias": "allowScientificNotation"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "blockDecimalOverflow": { "alias": "blockDecimalOverflow"; "required": false; "isSignal": true; }; "decimalRoundingMode": { "alias": "decimalRoundingMode"; "required": false; "isSignal": true; }; "decimalSeparator": { "alias": "decimalSeparator"; "required": false; "isSignal": true; }; "thousandSeparator": { "alias": "thousandSeparator"; "required": false; "isSignal": true; }; }, { "decimalSeparator": "decimalSeparatorChange"; "thousandSeparator": "thousandSeparatorChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<NumericMaskDirective, "[sNumericMask]", never, { "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "minDecimalPlaces": { "alias": "minDecimalPlaces"; "required": false; "isSignal": true; }; "maxDecimalPlaces": { "alias": "maxDecimalPlaces"; "required": false; "isSignal": true; }; "allowNegative": { "alias": "allowNegative"; "required": false; "isSignal": true; }; "allowScientificNotation": { "alias": "allowScientificNotation"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "blockDecimalOverflow": { "alias": "blockDecimalOverflow"; "required": false; "isSignal": true; }; "decimalRoundingMode": { "alias": "decimalRoundingMode"; "required": false; "isSignal": true; }; "precision": { "alias": "precision"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "decimalSeparator": { "alias": "decimalSeparator"; "required": false; "isSignal": true; }; "thousandSeparator": { "alias": "thousandSeparator"; "required": false; "isSignal": true; }; }, { "placeholder": "placeholderChange"; "pasteRejected": "pasteRejected"; "decimalSeparator": "decimalSeparatorChange"; "thousandSeparator": "thousandSeparatorChange"; }, never, never, true, never>;
 }

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

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./numeric-mask.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `NumericMaskDirective` (de
+ * `@seniorsistemas/angular-components/numeric-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 CurrencyMaskModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<CurrencyMaskModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<CurrencyMaskModule, never, [typeof i1.NumericMaskDirective], [typeof i1.NumericMaskDirective]>;

package/object-card/README.md

@@ -19,10 +19,17 @@ Componente de card para exibição de um objeto de análise com cabeçalho princ
 ## Instalação
 
 ```typescript
-import { ObjectCardModule } from '@seniorsistemas/angular-components/object-card';
-
-@NgModule({ imports: [ObjectCardModule] })
-export class MeuModulo {}
+import {
+  ObjectCardComponent,
+  ObjectCardMainComponent,
+  ObjectCardFieldComponent,
+} from '@seniorsistemas/angular-components/object-card';
+
+@Component({
+  standalone: true,
+  imports: [ObjectCardComponent, ObjectCardMainComponent, ObjectCardFieldComponent],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/object-card/lib/object-card/object-card.module.d.ts

@@ -3,6 +3,17 @@ import * as i1 from "@seniorsistemas/angular-components/thumbnail";
 import * as i2 from "./object-card.component";
 import * as i3 from "./elements/main/object-card-main.component";
 import * as i4 from "./elements/field/object-card-field.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente os standalones `ObjectCardComponent`,
+ * `ObjectCardMainComponent` e `ObjectCardFieldComponent` (de
+ * `@seniorsistemas/angular-components/object-card`) no lugar deste módulo.
+ *
+ * Este módulo também reexportava `ThumbnailComponent` (`@seniorsistemas/angular-components/thumbnail`, usado
+ * em templates por `<s-thumbnail>`). 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 ObjectCardModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<ObjectCardModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<ObjectCardModule, never, [typeof i1.ThumbnailModule, typeof i2.ObjectCardComponent, typeof i3.ObjectCardMainComponent, typeof i4.ObjectCardFieldComponent], [typeof i1.ThumbnailModule, typeof i2.ObjectCardComponent, typeof i3.ObjectCardMainComponent, typeof i4.ObjectCardFieldComponent]>;

package/package.json

@@ -707,5 +707,5 @@
   "schematics": "./schematics/collection.json",
   "sideEffects": true,
   "typings": "index.d.ts",
-  "version": "19.9.15"
+  "version": "19.10.0-develop-ef29acb7"
 }

package/panel/README.md

@@ -19,10 +19,14 @@ Componente container com cabeçalho, corpo e rodapé opcionais. Suporta colapso
 ## Instalação
 
 ```typescript
-import { PanelModule } from '@seniorsistemas/angular-components/panel';
-
-@NgModule({ imports: [PanelModule] })
-export class MeuModulo {}
+import { PanelComponent } from '@seniorsistemas/angular-components/panel';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
+
+@Component({
+  standalone: true,
+  imports: [PanelComponent, TemplateDirective],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/panel/lib/panel/panel.module.d.ts

@@ -1,6 +1,16 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./panel.component";
 import * as i2 from "@seniorsistemas/angular-components/template";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `PanelComponent` (de
+ * `@seniorsistemas/angular-components/panel`) 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 PanelModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PanelModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<PanelModule, never, [typeof i1.PanelComponent], [typeof i1.PanelComponent, typeof i2.TemplateModule]>;

package/password-strength/README.md

@@ -18,10 +18,13 @@ Diretiva Angular que adiciona um indicador visual de força de senha a qualquer
 ## Instalação
 
 ```typescript
-import { PasswordStrengthModule } from '@seniorsistemas/angular-components/password-strength';
+import { PasswordStrengthDirective } from '@seniorsistemas/angular-components/password-strength';
 
-@NgModule({ imports: [PasswordStrengthModule] })
-export class MeuModulo {}
+@Component({
+  standalone: true,
+  imports: [PasswordStrengthDirective],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/password-strength/lib/password-strength/password-strength.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./password-strength.directive";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `PasswordStrengthDirective` (de
+ * `@seniorsistemas/angular-components/password-strength`) 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 PasswordStrengthModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PasswordStrengthModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<PasswordStrengthModule, never, [typeof i1.PasswordStrengthDirective], [typeof i1.PasswordStrengthDirective]>;

package/picklist/README.md

@@ -19,11 +19,14 @@ Componente para transferência de itens entre duas listas — disponíveis e sel
 ## Instalação
 
 ```typescript
-import { PicklistModule } from '@seniorsistemas/angular-components/picklist';
-import { TemplateModule } from '@seniorsistemas/angular-components/template';
-
-@NgModule({ imports: [PicklistModule, TemplateModule] })
-export class MeuModulo {}
+import { PicklistComponent } from '@seniorsistemas/angular-components/picklist';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
+
+@Component({
+  standalone: true,
+  imports: [PicklistComponent, TemplateDirective],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/picklist/lib/picklist/picklist.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./picklist.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `PicklistComponent` (de
+ * `@seniorsistemas/angular-components/picklist`) 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 PicklistModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PicklistModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<PicklistModule, never, [typeof i1.PicklistComponent], [typeof i1.PicklistComponent]>;

package/pin-code-field/lib/pin-code-field.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./pin-code-field/pin-code-field.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `PinCodeFieldComponent` (de
+ * `@seniorsistemas/angular-components/pin-code-field`) 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 PinCodeFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<PinCodeFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<PinCodeFieldModule, never, [typeof i1.PinCodeFieldComponent], [typeof i1.PinCodeFieldComponent]>;

package/product-header/README.md

@@ -12,7 +12,7 @@ O pacote `product-header` re-exporta `TopbarComponent` e `TopbarModule` do pacot
 
 ## Quando não usar
 
-- Em todo código novo — use `TopbarComponent` ou `TopbarModule` do pacote `@seniorsistemas/angular-components/topbar`
+- Em todo código novo — use `TopbarComponent` do pacote `@seniorsistemas/angular-components/topbar`
 
 ## Migração
 
@@ -21,7 +21,7 @@ O pacote `product-header` re-exporta `TopbarComponent` e `TopbarModule` do pacot
 import { ProductHeaderModule } from '@seniorsistemas/angular-components/product-header';
 
 // Depois (recomendado)
-import { TopbarModule } from '@seniorsistemas/angular-components/topbar';
+import { TopbarComponent } from '@seniorsistemas/angular-components/topbar';
 ```
 
 ```html

package/profile-picture-picker/README.md

@@ -19,10 +19,13 @@ Componente para seleção, recorte e gerenciamento de foto de perfil. Permite se
 ## Instalação
 
 ```typescript
-import { ProfilePicturePickerModule } from '@seniorsistemas/angular-components/profile-picture-picker';
+import { ProfilePicturePickerComponent } from '@seniorsistemas/angular-components/profile-picture-picker';
 
-@NgModule({ imports: [ProfilePicturePickerModule] })
-export class MeuModulo {}
+@Component({
+  standalone: true,
+  imports: [ProfilePicturePickerComponent],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/profile-picture-picker/lib/profile-picture-picker/profile-picture-picker.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./profile-picture-picker.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `ProfilePicturePickerComponent` (de
+ * `@seniorsistemas/angular-components/profile-picture-picker`) 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 ProfilePicturePickerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<ProfilePicturePickerModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<ProfilePicturePickerModule, never, [typeof i1.ProfilePicturePickerComponent], [typeof i1.ProfilePicturePickerComponent]>;

package/progressbar/README.md

@@ -19,10 +19,13 @@ Componente de barra de progresso para representar visualmente o avanço de uma o
 ## Instalação
 
 ```typescript
-import { ProgressBarModule } from '@seniorsistemas/angular-components/progressbar';
+import { ProgressBarComponent } from '@seniorsistemas/angular-components/progressbar';
 
-@NgModule({ imports: [ProgressBarModule] })
-export class MeuModulo {}
+@Component({
+  standalone: true,
+  imports: [ProgressBarComponent],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/progressbar/lib/progressbar/progressbar.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./progressbar.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `ProgressBarComponent` (de
+ * `@seniorsistemas/angular-components/progressbar`) 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 ProgressBarModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<ProgressBarModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<ProgressBarModule, never, [typeof i1.ProgressBarComponent], [typeof i1.ProgressBarComponent]>;

package/rating-scale/README.md

@@ -20,10 +20,13 @@ Componente de escala de avaliação que permite ao usuário selecionar um nó de
 ## Instalação
 
 ```typescript
-import { RatingScaleModule } from '@seniorsistemas/angular-components/rating-scale';
+import { RatingScaleComponent } from '@seniorsistemas/angular-components/rating-scale';
 
-@NgModule({ imports: [RatingScaleModule] })
-export class MeuModulo {}
+@Component({
+  standalone: true,
+  imports: [RatingScaleComponent],
+})
+export class MeuComponent {}
 ```
 
 ## Uso básico

package/rating-scale/lib/rating-scale/rating-scale.module.d.ts

@@ -1,5 +1,12 @@
 import * as i0 from "@angular/core";
 import * as i1 from "./rating-scale.component";
+/**
+ * @deprecated Será removido na v20. Importe diretamente o standalone `RatingScaleComponent` (de
+ * `@seniorsistemas/angular-components/rating-scale`) 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 RatingScaleModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<RatingScaleModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<RatingScaleModule, never, [typeof i1.RatingScaleComponent], [typeof i1.RatingScaleComponent]>;

package/schematics/collection.json

@@ -24,6 +24,46 @@
         "migrate-fieldset-body-template": {
             "description": "Envolve o conteúdo projetado do s-fieldset em <ng-template sTemplate=\"body\">, mantendo templates de slot como sTemplate=\"header\" fora do body, e garante o TemplateDirective no escopo do componente (standalone ou via NgModule)",
             "factory": "./migrations/migrate-fieldset-body-template/index#migrate"
+        },
+        "migrate-deprecated-selectors": {
+            "description": "Troca os selectors depreciados (removidos na v20) pelos novos em templates e estilos: s-sidebar→s-drawer, s-slide-panel→s-slide-in-bar, s-steps→s-stepper, s-product-header→s-topbar, s-ia-insight→s-insights, s-file-upload→s-file-picker, s-text-area-ia→s-content-generator, s-breadcrumb→s-dynamic-breadcrumb",
+            "factory": "./migrations/migrate-deprecated-selectors/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-deprecated-imports": {
+            "description": "Troca os pacotes alias depreciados (removidos na v20) e seus símbolos pelos novos: sidebar→drawer, slide-panel→slide-in-bar, steps→stepper, product-header→topbar, ia-insight→insights, text-area-ia→content-generator, file-upload→file-picker",
+            "factory": "./migrations/migrate-deprecated-imports/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-deprecated-apis": {
+            "description": "Migra APIs depreciadas com substituto direto: (onCodeChange)→(codeChange), (changedImage)→(imageChange), sNumberInput/sBignumberInput/sLocalizedNumberInput (e as respectivas *Directive/*Module)→sNumericMask/NumericMaskDirective com os defaults antigos explícitos, [scale]→[minDecimalPlaces]/[maxDecimalPlaces], [thousandsSeparator]→[thousandSeparator], remoção de [alignTo], NumberAlignmentOption→'left'/'right', pipes localizedNumber/localizedCurrency→localizedBignumber, icon→selectedIcon/unselectedIcon no rating-scale e BreadcrumbModule→DynamicBreadcrumbComponent. Avisa o que não dá para converter com segurança.",
+            "factory": "./migrations/migrate-deprecated-apis/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-deprecated-dynamic-form": {
+            "description": "Migra os tipos de campo e propriedades depreciados do dynamic-form: integer vira number (scale 0, sem negativos nem autoClear), textAreaIA vira contentGenerator, calendarLocaleOptions vira dateFormat/hourFormat, remove priority/appendTo e troca [fields] por [configs] (DynamicStructure[]). O tipo money é estável e não é migrado. Execute depois de migrate-dynamic-form.",
+            "factory": "./migrations/migrate-deprecated-dynamic-form/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-deprecated-datepicker": {
+            "description": "Remove o uso das diretivas depreciadas sCalendarMask (CalendarMaskDirective) e sDatepickerNoPeriodTab (DatepickerNoPeriodTabDirective) dos templates e dos imports, e avisa a troca de p-calendar por s-datepicker.",
+            "factory": "./migrations/migrate-deprecated-datepicker/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-modules-to-standalone": {
+            "description": "Troca os NgModules da biblioteca (ButtonModule, TableModule, LocaleModule etc.) pelos componentes, diretivas e pipes standalone que eles reexportam, e converte forRoot() em provideAngularComponents()/provideLocale().",
+            "factory": "./migrations/migrate-modules-to-standalone/index#migrate",
+            "schema": "./schema/scope.schema.json"
+        },
+        "migrate-app-to-standalone": {
+            "description": "Wrapper do schematic oficial do Angular (@angular/core:standalone): converte o app para standalone (convert-to-standalone, prune-ng-modules e standalone-bootstrap, nessa ordem). A migração é feita pelo Angular, não pelo angular-components.",
+            "factory": "./migrations/migrate-app-to-standalone/index#migrate",
+            "schema": "./schema/app-standalone.schema.json"
+        },
+        "migrate-v20": {
+            "description": "Prepara o projeto para a v20: pergunta quais migrações executar (com \"Marcar todos\") e roda seletores, pacotes alias, APIs depreciadas, dynamic-form, datepicker e módulos → standalone. Não pergunta sobre o app standalone: ao final avisa que existe o schematic migrate-app-to-standalone (migrações nativas do Angular, feitas pelo Angular). Aceita --all, --items, --skip, --path e --project para uso sem terminal interativo. Pelo ng generate, atualize a lib antes: o código migrado usa APIs novas (provideLocale, provideAngularComponents).",
+            "factory": "./migrations/migrate-v20/index#migrate",
+            "schema": "./schema/migrate-v20.schema.json"
         }
     }
 }

package/schematics/migrations/migrate-app-to-standalone/index.d.ts

@@ -0,0 +1,32 @@
+import { Rule } from '@angular-devkit/schematics';
+import { MigrationReport } from '../../utils/report';
+import { ScopeOptions } from '../../utils/scope';
+/**
+ * ATENÇÃO: este schematic é um **wrapper** do schematic oficial do Angular (`@angular/core:standalone`,
+ * documentado em https://angular.dev/reference/migrations/standalone). Quem faz a migração é o Angular;
+ * o angular-components apenas o chama com as opções escolhidas e na ordem recomendada.
+ */
+export declare const ITEM_ID = "app-standalone";
+export declare const OFFICIAL_MIGRATION_DOC = "https://angular.dev/reference/migrations/standalone";
+/** Modos do schematic oficial, na ordem em que o Angular recomenda executá-los. */
+export declare const STANDALONE_MODES: readonly ["convert-to-standalone", "prune-ng-modules", "standalone-bootstrap"];
+export type StandaloneMode = (typeof STANDALONE_MODES)[number];
+/** O que cada modo do schematic oficial do Angular faz (conforme a documentação do Angular). */
+export declare const STANDALONE_MODE_DESCRIPTIONS: Readonly<Record<StandaloneMode, string>>;
+/**
+ * Texto exibido ao final do `migrate-v20` (que não faz mais a pergunta): avisa que existe um schematic para as
+ * migrações nativas do Angular, lista tudo o que elas fazem e deixa claro de quem é a responsabilidade.
+ */
+export declare function standaloneNoticeLines(): string[];
+export interface AppStandaloneOptions extends ScopeOptions {
+    /** Modos a executar (lista ou separados por vírgula). Padrão: os três. */
+    mode?: string | string[];
+}
+export interface ResolvedModes {
+    modes: StandaloneMode[];
+    unknown: string[];
+}
+/** Normaliza `--mode`, descarta inválidos e devolve sempre na ordem recomendada pelo Angular. */
+export declare function resolveModes(raw: string | string[] | undefined): ResolvedModes;
+export declare function migrateAppToStandalone(options: AppStandaloneOptions, report: MigrationReport): Rule;
+export declare function migrate(options?: AppStandaloneOptions): Rule;