@seniorsistemas/angular-components 19.0.4 → 19.0.6

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

@@ -3,17 +3,40 @@ import { ObjectCardFieldComponent } from './elements/field/object-card-field.com
 import { ObjectCardMainComponent } from './elements/main/object-card-main.component';
 import { BorderButtonOptions, Severities } from '@seniorsistemas/angular-components/shared';
 import * as i0 from "@angular/core";
+/**
+ * @description Card de exibição de objeto com setor principal, campos extras e
+ * painel expansível. Calcula automaticamente quantos campos cábem visíveis
+ * conforme a largura do container e suporta nível de severidade.
+ *
+ * @example
+ * ```html
+ * <s-object-card [severity]="'info'" [expanded]="false">
+ *   <s-object-card-main label="Nome" value="João" />
+ *   <s-object-card-field label="CPF" value="000.000.000-00" />
+ * </s-object-card>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class ObjectCardComponent implements AfterContentChecked {
     static readonly nextIdSeed = 0;
     private static _nextId;
     static getNextId(): number;
+    /** @description Identificador do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Define se o painel expansível está aberto. @default false */
     expanded: boolean;
+    /** @description Tooltip do botão de expandir. @default 'Abrir painel' */
     expandTooltip: string;
+    /** @description Tooltip do botão de colapsar. @default 'Fechar painel' */
     collapseTooltip: string;
+    /** @description Largura mínima em pixels de cada campo visível. @default 200 */
     fieldsMinWidth: number;
+    /** @description Nível de severidade que altera o estilo visual. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão de borda lateral. */
     borderButtonOptions?: BorderButtonOptions;
+    /** @description Emitido quando o estado de expansão muda, com o novo valor booleano. */
     expandedChange: EventEmitter<boolean>;
     main: ObjectCardMainComponent | null;
     fields: import("@angular/core").Signal<readonly ObjectCardFieldComponent[]>;

package/optional-fields/editor/editor-field.d.ts

@@ -1,10 +1,29 @@
 import { EnvironmentProviders } from '@angular/core';
 import { FieldConfig } from '@seniorsistemas/angular-components/dynamic-form';
+/**
+ * Configuração fornecida ao instanciar um campo do tipo 'editor'.
+ * Utilizado para renderizar um editor de rich text (wysiwyg).
+ */
 export interface EditorFieldConfig extends FieldConfig {
+    /**
+     * Define o tipo único deste campo opcional.
+     */
     type: 'editor';
+    /**
+     * Formatos suportados pelo editor (ex: 'bold', 'italic').
+     */
     formats?: string[];
+    /**
+     * Define se o editor estará apenas em modo leitura.
+     */
     readonly?: boolean;
+    /**
+     * Módulos adicionais do QuillJS a serem ativados no editor.
+     */
     modules?: any;
+    /**
+     * Estilos customizados aplicados diretamente no container do editor.
+     */
     style?: {
         [klass: string]: unknown;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seniorsistemas/angular-components",
-  "version": "19.0.4",
+  "version": "19.0.6",
   "peerDependencies": {
     "@angular/cdk": "^18.2.14",
     "@angular/common": "^18.2.0",
@@ -53,18 +53,18 @@
       "esm": "./esm2022/autocomplete/seniorsistemas-angular-components-autocomplete.mjs",
       "default": "./fesm2022/seniorsistemas-angular-components-autocomplete.mjs"
     },
-    "./badge": {
-      "types": "./badge/index.d.ts",
-      "esm2022": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
-      "esm": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
-      "default": "./fesm2022/seniorsistemas-angular-components-badge.mjs"
-    },
     "./bignumber-input": {
       "types": "./bignumber-input/index.d.ts",
       "esm2022": "./esm2022/bignumber-input/seniorsistemas-angular-components-bignumber-input.mjs",
       "esm": "./esm2022/bignumber-input/seniorsistemas-angular-components-bignumber-input.mjs",
       "default": "./fesm2022/seniorsistemas-angular-components-bignumber-input.mjs"
     },
+    "./badge": {
+      "types": "./badge/index.d.ts",
+      "esm2022": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
+      "esm": "./esm2022/badge/seniorsistemas-angular-components-badge.mjs",
+      "default": "./fesm2022/seniorsistemas-angular-components-badge.mjs"
+    },
     "./breadcrumb": {
       "types": "./breadcrumb/index.d.ts",
       "esm2022": "./esm2022/breadcrumb/seniorsistemas-angular-components-breadcrumb.mjs",

package/paginator/lib/paginator/paginator.component.d.ts

@@ -1,10 +1,29 @@
 import { OnDestroy } from '@angular/core';
 import { PageChange, PaginatorInternalButton } from '../models/paginator.models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de paginação standalone que exibe botões de páginas,
+ * seletor de itens por página e navegação para primeira/última página.
+ * Emite `pageChange` a cada mudança de página ou tamanho de página.
+ *
+ * @example
+ * ```html
+ * <s-paginator
+ *   [totalRecords]="total"
+ *   [(rows)]="tamanhoPagina"
+ *   (pageChange)="onPaginaMudou($event)" />
+ * ```
+ *
+ * @category Structure
+ */
 export declare class PaginatorComponent implements OnDestroy {
+    /** @description Número total de registros. Campo obrigatório. */
     totalRecords: import("@angular/core").InputSignal<number>;
+    /** @description Número de itens por página. Suporta two-way binding. @default 10 */
     rows: import("@angular/core").ModelSignal<number>;
+    /** @description Opções do seletor de itens por página. @default [10, 20, 50, 100, 200] */
     rowsPerPageOptions: import("@angular/core").InputSignal<number[]>;
+    /** @description Emitido sempre que a página ou o número de itens por página muda. */
     pageChange: import("@angular/core").OutputEmitterRef<PageChange>;
     private readonly currentPageEffect;
     private readonly MAX_PAGE_BUTTONS;

package/panel/lib/panel/panel.component.d.ts

@@ -1,14 +1,35 @@
-import { AfterContentInit, EventEmitter, QueryList, TemplateRef } from "@angular/core";
-import { BorderButtonOptions, EnumSeverity, Severities } from "@seniorsistemas/angular-components/shared";
-import { TemplateDirective } from "@seniorsistemas/angular-components/template";
+import { AfterContentInit, EventEmitter, QueryList, TemplateRef } from '@angular/core';
+import { BorderButtonOptions, EnumSeverity, Severities } from '@seniorsistemas/angular-components/shared';
+import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de painel com cabeçalho, corpo e rodapé customizáveis
+ * via `TemplateDirective`. Suporta colapsar/expandir com animação, nível de
+ * severidade para estilo visual e botão de borda configurável.
+ *
+ * @example
+ * ```html
+ * <s-panel header="Título" [toggleable]="true" severity="info">
+ *   <p>Conteúdo</p>
+ * </s-panel>
+ * ```
+ *
+ * @category Data
+ */
 export declare class PanelComponent implements AfterContentInit {
+    /** @description Título exibido no cabeçalho do painel. */
     header?: string;
+    /** @description Habilita o botão de toggle para colapsar/expandir o painel. @default false */
     toggleable: boolean;
+    /** @description Define o estado inicial do painel como colapsado. @default false */
     collapsed: boolean;
+    /** @description Nível de severidade que altera o estilo visual do painel. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão de borda lateral do painel. */
     borderButtonOptions?: BorderButtonOptions;
+    /** @description Classes CSS adicionais aplicadas ao elemento raíz do painel. @default '' */
     class: string;
+    /** @description Emitido quando o estado de colapso muda, com o novo valor booleano. */
     collapsedChange: EventEmitter<boolean>;
     templates: QueryList<TemplateDirective> | null;
     headerTemplate: TemplateRef<unknown> | null;

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

@@ -3,11 +3,35 @@ import { TranslateService } from '@ngx-translate/core';
 import { PasswordStrengthPositions } from './types/password-positions';
 import { PasswordStrengths } from './types/password-strengths';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente interno que exibe visualmente os indicadores de força de senha.
+ * Utilizado em conjunto com a diretiva {@link PasswordStrengthDirective} para fornecer
+ * feedback em tempo real enquanto o usuário digita, mostrando três níveis de força
+ * (fraca, média e forte) com títulos e indicadores visuais configuráveis.
+ *
+ * @category Inputs
+ */
 export declare class PasswordStrengthComponent implements OnInit {
     private readonly translate;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como fraca.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.weak`.
+     */
     weakTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como média.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.medium`.
+     */
     mediumTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como forte.
+     * Se não informado, utiliza a tradução padrão do token `platform.angular_components.strong`.
+     */
     strongTitle?: string;
+    /**
+     * @description Descrição complementar exibida abaixo dos indicadores de força,
+     * orientando o usuário sobre os requisitos esperados para a senha. Campo obrigatório.
+     */
     description: string;
     title?: string;
     position: PasswordStrengthPositions;

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

@@ -2,17 +2,70 @@ import { ApplicationRef, ComponentFactoryResolver, ElementRef, Injector, OnInit
 import { PasswordStrengthPositions } from './types/password-positions';
 import { PasswordStrengths } from './types/password-strengths';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que adiciona o comportamento de verificação de força de senha
+ * a um campo de input existente. Ao receber foco ou a cada tecla digitada, exibe o
+ * componente {@link PasswordStrengthComponent} posicionado dinamicamente ao redor do campo,
+ * fornecendo feedback visual sobre a força da senha informada.
+ *
+ * @example
+ * ```html
+ * <input
+ *   type="password"
+ *   [sPasswordStrength]="true"
+ *   passwordStrengthDescription="A senha deve conter letras maiúsculas, números e caracteres especiais."
+ *   [passwordStrengthValidation]="myValidator" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class PasswordStrengthDirective implements OnInit {
     private readonly elementRef;
     private readonly appRef;
     private readonly componentFactoryResolver;
     private readonly injector;
+    /**
+     * @description Habilita ou desabilita o comportamento da diretiva.
+     * Quando `false`, o indicador de força não será exibido.
+     *
+     * @default true
+     */
     enabled: boolean;
+    /**
+     * @description Função customizada de validação da força da senha.
+     * Recebe o conteúdo atual do campo e deve retornar um valor do tipo {@link PasswordStrengths}
+     * (`'veryWeak'`, `'weak'`, `'medium'` ou `'strong'`).
+     * Se não informada, utiliza a validação padrão baseada em critérios de comprimento,
+     * letras maiúsculas/minúsculas, números e caracteres especiais.
+     */
     passwordStrengthValidation?: (content: string) => PasswordStrengths;
+    /**
+     * @description Posição preferencial onde o indicador de força será exibido em relação ao campo.
+     * Aceita `'right'`, `'left'` ou `'top'`. O componente tenta posicionar automaticamente
+     * em outro lado caso não haja espaço suficiente na posição especificada.
+     *
+     * @default 'right'
+     */
     passwordStrengthPosition: PasswordStrengthPositions;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como fraca.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthWeakTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como média.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthMediumTitle?: string;
+    /**
+     * @description Texto personalizado exibido quando a senha é classificada como forte.
+     * Se não informado, utiliza a tradução padrão.
+     */
     passwordStrengthStrongTitle?: string;
+    /**
+     * @description Descrição complementar exibida no indicador de força de senha,
+     * orientando o usuário sobre os requisitos da senha. Campo obrigatório.
+     */
     passwordStrengthDescription: string;
     private componentRef?;
     constructor(elementRef: ElementRef, appRef: ApplicationRef, componentFactoryResolver: ComponentFactoryResolver, injector: Injector);

package/picklist/lib/picklist/picklist.component.d.ts

@@ -9,21 +9,50 @@ interface InternalPicklistItem<T = any> extends PickListItem<T> {
 type CdkDragEvent = {
     source: CdkDrag<InternalPicklistItem<any>>;
 };
+/**
+ * @description Componente de lista de dupla seleção (picklist) com suporte a
+ * arrastar e soltar, filtro, checkboxes e template customizável para cada item.
+ * Emite eventos ao mover itens entre as listas.
+ *
+ * @example
+ * ```html
+ * <s-picklist
+ *   [itensToSelect]="itensDisponiveis"
+ *   [selectedItens]="itensSelecionados"
+ *   (selectedItensChange)="onSelecaoMudou($event)" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class PicklistComponent implements AfterViewInit, OnChanges {
     private cdr;
+    /** @description Lista de itens disponíveis para seleção (coluna esquerda). @default [] */
     itensToSelect: PickListItem<any>[];
+    /** @description Lista de itens já selecionados (coluna direita). @default [] */
     selectedItens: PickListItem<any>[];
+    /** @description Rótulo do título da lista de disponíveis. */
     availableItensLabel?: string;
+    /** @description Placeholder da busca na lista de disponíveis. */
     availableItensPlaceholder?: string;
+    /** @description Rótulo do botão de adicionar itens selecionados. */
     addSelectedItensLabel?: string;
+    /** @description Rótulo do botão de adicionar todos os itens. */
     addAllItensLabel?: string;
+    /** @description Rótulo do título da lista de selecionados. */
     selectedItensLabel?: string;
+    /** @description Placeholder da busca na lista de selecionados. */
     selectedItensPlaceholder?: string;
+    /** @description Rótulo do botão de remover itens selecionados. */
     removeSelectedItemsLabel?: string;
+    /** @description Rótulo do botão de remover todos os itens. */
     removeAllItemsLabel?: string;
+    /** @description Exibe checkbox nos itens das listas. @default false */
     showCheckbox: boolean;
+    /** @description Propriedade usada para filtrar os itens das listas. @default '' */
     filterBy: string;
+    /** @description Emitido quando a lista de selecionados muda. */
     selectedItensChange: EventEmitter<any[]>;
+    /** @description Emitido quando a lista de disponíveis muda. */
     itensToSelectChange: EventEmitter<any[]>;
     availableItensFilter: string;
     selectedItensFilter: string;

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

@@ -2,19 +2,18 @@ import { ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
 /**
- * Pin Code Field Component
+ * @description Componente de entrada de código PIN/OTP com campos individuais para cada dígito.
+ * Implementa {@link ControlValueAccessor} para integração nativa com Reactive Forms
+ * e Template-driven Forms do Angular.
  *
- * A flexible, accessible PIN code input component that implements {@link ControlValueAccessor}
- * for seamless integration with Angular Reactive Forms and Template-driven Forms.
- *
- * Features:
- * - Multiple input fields for PIN/OTP code entry
- * - Configurable code length and character validation
- * - Keyboard navigation (arrow keys, backspace)
- * - Paste support with automatic truncation
- * - Error state display via the `invalid` input
- * - Full accessibility support (ARIA labels, semantic roles)
- * - Signal-based state management
+ * Funcionalidades:
+ * - Campos separados e navegáveis para cada dígito do código
+ * - Comprimento configurável via input `length`
+ * - Suporte a entrada numérica ou alfanumérica
+ * - Navegação por teclado (setas, backspace)
+ * - Suporte a colar (paste) com truncamento automático ao tamanho definido
+ * - Estado de erro via input `invalid`
+ * - Acessibilidade completa com ARIA labels e roles semânticos
  *
  * @example
  * ```html
@@ -24,46 +23,42 @@ import * as i0 from "@angular/core";
  *     [length]="6"
  *     [alphanumeric]="false"
  *     [invalid]="(form.get('code')?.invalid && form.get('code')?.dirty) || false"
- *     helpText="Enter your 6-digit code"
+ *     helpText="Digite seu código de 6 dígitos"
  *     (codeFilled)="onCodeFilled($event)">
  *   </s-pin-code-field>
  * </form>
  * ```
  *
- * @example
- * ```typescript
- * form = this.fb.group({
- *   code: ['', [Validators.required]],
- * });
- * ```
+ * @category Inputs
  */
 export declare class PinCodeFieldComponent implements ControlValueAccessor {
     private static readonly LAST_INDEX_OFFSET;
     private static readonly EMPTY_VALUE;
     /**
-     * Number of input fields (PIN code length).
-     * Must be at least 1.
+     * @description Número de campos de entrada (comprimento do código PIN).
+     * Deve ser ao menos 1.
      *
      * @default 6
      */
     length: import("@angular/core").InputSignal<number>;
     /**
-     * Allows alphanumeric and special characters input.
-     * When false, only numeric input (0-9) is accepted.
+     * @description Permite entrada alfanumérica e de caracteres especiais.
+     * Quando `false`, aceita apenas dígitos numéricos (0–9).
      *
      * @default false
      */
     alphanumeric: import("@angular/core").InputSignal<boolean>;
     /**
-     * Help text displayed below the input fields.
+     * @description Texto de ajuda exibido abaixo dos campos de entrada,
+     * fornecendo instruções adicionais ao usuário.
      *
      * @default ''
      */
     helpText: import("@angular/core").InputSignal<string>;
     /**
-     * Controls the error state visualization of the component.
-     * When true, displays red border on input fields.
-     * Typically bound to FormControl's invalid and dirty state.
+     * @description Controla a visualização do estado de erro do componente.
+     * Quando `true`, exibe borda vermelha nos campos de entrada.
+     * Normalmente vinculado ao estado `invalid && dirty` do `FormControl`.
      *
      * @example
      * ```html
@@ -73,15 +68,15 @@ export declare class PinCodeFieldComponent implements ControlValueAccessor {
      */
     invalid: import("@angular/core").InputSignal<boolean>;
     /**
-     * Two-way binding for the disabled state of the component.
-     * Disables all input fields and prevents user interaction.
+     * @description Controla o estado desabilitado do componente via two-way binding.
+     * Quando `true`, todos os campos ficam desabilitados e a interação do usuário é bloqueada.
      *
      * @default false
      */
     disabled: import("@angular/core").ModelSignal<boolean>;
     /**
-     * Emitted when all PIN code fields are filled.
-     * Emits the complete PIN code as a string.
+     * @description Emitido quando todos os campos do código PIN são preenchidos.
+     * Emite o código completo como string.
      *
      * @example
      * ```html
@@ -90,8 +85,8 @@ export declare class PinCodeFieldComponent implements ControlValueAccessor {
      */
     codeFilled: import("@angular/core").OutputEmitterRef<string>;
     /**
-     * Signal containing the current values of each input field.
-     * Array length matches the `length` input value.
+     * @description Signal com os valores atuais de cada campo de entrada.
+     * O comprimento do array corresponde ao valor do input `length`.
      */
     inputs: import("@angular/core").WritableSignal<string[]>;
     /**

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

@@ -5,32 +5,116 @@ import { ConfirmationService } from 'primeng/api';
 import { ConfirmationTexts, CropperLabelsConfig, FileValidationErrors, ProfilePicturePickerData } from './models/index';
 import { ImageCropperService } from '@seniorsistemas/angular-components/image-cropper';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente para seleção, edição e remoção de foto de perfil do usuário.
+ * Permite ao usuário fazer upload de uma imagem, recortá-la com o {@link ImageCropperService}
+ * e confirmar ou remover a foto atual. Implementa {@link ControlValueAccessor} para uso
+ * em formulários reativos e template-driven do Angular.
+ *
+ * @example
+ * ```html
+ * <s-profile-picture-picker
+ *   formControlName="avatar"
+ *   subtitle="Formatos aceitos: JPG e PNG"
+ *   [maxFileSize]="2097152"
+ *   accept="image/jpeg,image/png"
+ *   (imageChange)="onImageChange($event)"
+ *   (removedImage)="onImageRemoved()" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class ProfilePicturePickerComponent implements OnInit, ControlValueAccessor {
     private readonly imageCropperService;
     private readonly confirmationService;
     private readonly translateService;
+    /**
+     * @description Título simples exibido quando nenhuma imagem está selecionada.
+     */
     simpleTitle: string;
+    /**
+     * @description Título de ação exibido como label principal do botão de upload.
+     */
     actionTitle: string;
+    /**
+     * @description Legenda exibida abaixo do título, descrevendo formatos suportados
+     * ou outras orientações para o usuário. Campo obrigatório.
+     */
     subtitle: string;
+    /**
+     * @description Proporção (aspect ratio) do recorte da imagem.
+     * Por exemplo, `1` para quadrado, `16/9` para widescreen.
+     *
+     * @default 1
+     */
     aspectRatio: number;
+    /**
+     * @description Configurações de rótulos exibidos no componente de recorte de imagem (cropper).
+     * Permite sobrescrever os textos padrão dos botões e instruções do cropper.
+     */
     cropperLabelsConfig?: CropperLabelsConfig;
+    /**
+     * @description Texto do botão de remoção da foto atual.
+     * Se não informado, utiliza o label padrão de remoção.
+     */
     removeButtonLabel?: string;
+    /**
+     * @description Texto do botão de troca da foto atual.
+     * Se não informado, utiliza o label padrão de alteração.
+     */
     changeButtonLabel?: string;
+    /**
+     * @description Textos personalizados exibidos no diálogo de confirmação
+     * ao remover ou substituir a foto. Permite sobrescrever título, mensagem e botões.
+     */
     confirmationTexts?: ConfirmationTexts;
+    /**
+     * @description Tamanho máximo permitido para o arquivo de imagem, em bytes.
+     * Quando o arquivo excede esse limite, o output `invalidFile` é emitido.
+     */
     maxFileSize?: number;
+    /**
+     * @description Tipos MIME aceitos pelo input de arquivo.
+     * Exemplo: `"image/jpeg,image/png"`.
+     */
     accept?: string;
+    /**
+     * @description Lista de extensões de arquivo aceitas para validação.
+     * Exemplo: `['.jpg', '.jpeg', '.png']`.
+     *
+     * @default []
+     */
     supportedExtensions: string[];
+    /**
+     * @description Imagem atual do componente. Pode ser uma string base64, um objeto
+     * {@link ProfilePicturePickerData} com metadados, ou `null` para sem imagem.
+     *
+     * @default null
+     */
     image: string | ProfilePicturePickerData | null;
     uploadPicture: ElementRef | null;
     info: ElementRef | null;
     thumbnail: ElementRef | null;
     fileInput: ElementRef | null;
     /**
-     * @deprecated Use imageChange instead.
+     * @deprecated Use `imageChange` em vez deste output.
+     * @description Emitido ao selecionar ou recortar uma nova imagem. Emite a string base64 da imagem.
      */
     changedImage: EventEmitter<string>;
+    /**
+     * @description Emitido ao selecionar, recortar ou alterar a imagem.
+     * Emite a string base64 ou um objeto {@link ProfilePicturePickerData} com os dados da imagem.
+     */
     imageChange: EventEmitter<string | ProfilePicturePickerData>;
+    /**
+     * @description Emitido quando o usuário confirma a remoção da foto atual.
+     */
     removedImage: EventEmitter<any>;
+    /**
+     * @description Emitido quando o arquivo selecionado não passa na validação.
+     * Emite um objeto {@link FileValidationErrors} descrevendo os erros encontrados
+     * (ex.: tamanho excedido, extensão inválida).
+     */
     invalidFile: EventEmitter<FileValidationErrors>;
     get imageBase64(): string;
     private _onChange?;

package/progressbar/lib/progressbar/progressbar.component.d.ts

@@ -1,14 +1,64 @@
 import { OnInit } from '@angular/core';
 import { ProgressBarColors, ProgressBarMode } from './types';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de barra de progresso que representa visualmente o avanço de uma tarefa.
+ * Suporta modo determinado (valor percentual) e indeterminado (progresso desconhecido),
+ * além de um valor-alvo para comparação.
+ *
+ * @example
+ * ```html
+ * <s-progressbar
+ *   [value]="75"
+ *   activeColor="blue"
+ *   label="Upload"
+ *   [showValue]="true"
+ * />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class ProgressBarComponent implements OnInit {
+    /**
+     * @description Valor atual do progresso, em percentual (0 a 100).
+     * Não utilizado quando `mode` é `'indeterminate'`.
+     * Lança erro se o valor estiver fora do intervalo permitido.
+     */
     value: number;
+    /**
+     * @description Cor ativa da barra de progresso. Campo obrigatório.
+     * Valores aceitos: `'blue'`, `'green'`, `'red'`, `'yellow'`.
+     */
     activeColor: ProgressBarColors;
+    /**
+     * @description Opções de formatação numérica utilizadas para exibir o valor percentual.
+     * Baseado na API `Intl.NumberFormat`.
+     *
+     * @default `{ style: 'decimal', minimumFractionDigits: 0, maximumFractionDigits: 2 }`
+     */
     numberFormatOptions: Intl.NumberFormatOptions;
+    /**
+     * @description Valor-alvo em percentual (0 a 100), exibido como marcador de referência na barra.
+     * Não utilizado quando `mode` é `'indeterminate'`.
+     */
     targetValue?: number;
+    /** @description Rótulo descritivo exibido ao lado da barra de progresso principal. */
     label?: string;
+    /** @description Rótulo descritivo exibido ao lado do marcador de valor-alvo. */
     targetLabel?: string;
+    /**
+     * @description Quando `true`, exibe o valor percentual atual sobre ou próximo da barra.
+     *
+     * @default true
+     */
     showValue: boolean;
+    /**
+     * @description Modo de operação da barra de progresso.
+     * - `'determinate'`: exibe o progresso baseado em `value` (padrão).
+     * - `'indeterminate'`: animação contínua sem valor definido; `value`, `targetValue` e `targetLabel` não devem ser usados.
+     *
+     * @default 'determinate'
+     */
     mode: ProgressBarMode;
     ngOnInit(): void;
     private validateInputs;