@seniorsistemas/angular-components 19.0.4 → 19.0.6

package/stepper/lib/stepper/stepper.component.d.ts

@@ -4,11 +4,30 @@ import { StepSelectionEvent } from './models/step-selection-event';
 import { StepState } from './models/step-state';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de progresso em etapas (stepper) com animações.
+ * Exibe uma linha do tempo horizontal de passos, permitindo navegar entre eles.
+ * Suporta passos ocultos e desabilitados. Também responde ao seletor legado `s-steps`.
+ *
+ * @example
+ * ```html
+ * <s-stepper
+ *   [steps]="etapas"
+ *   [activeIndex]="etapaAtiva"
+ *   (stepSelected)="onEtapaSelecionada($event)" />
+ * ```
+ *
+ * @category Structure
+ */
 export declare class StepperComponent {
     static nextId: number;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Lista de etapas exibidas no stepper. Campo obrigatório. */
     steps: Step[];
+    /** @description Índice (0-based) da etapa atualmente ativa. Campo obrigatório. */
     activeIndex: number;
+    /** @description Emitido quando o usuário clica em uma etapa não desabilitada. */
     stepSelected: EventEmitter<StepSelectionEvent>;
     get stepState(): typeof StepState;
     get visibledStep(): Step[];

package/structure/lib/structure/footer.component.d.ts

@@ -1,4 +1,14 @@
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de rodapé da estrutura da página. Projeta conteúdo via ng-content.
+ *
+ * @example
+ * ```html
+ * <s-footer>Rodapé da aplicação</s-footer>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class FooterComponent {
     static ɵfac: i0.ɵɵFactoryDeclaration<FooterComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FooterComponent, "s-footer", never, {}, {}, never, ["*"], false, never>;

package/switch/lib/switch/switch.component.d.ts

@@ -1,14 +1,34 @@
 import { ElementRef, EventEmitter } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de chave tipo switch (liga/desliga) que implementa
+ * `ControlValueAccessor` para uso em formulários Angular. Suporta rótulos
+ * personalizados para os estados verdadeiro e falso, além de modo somente leitura.
+ *
+ * @example
+ * ```html
+ * <s-switch formControlName="ativo" trueLabel="Ativo" falseLabel="Inativo" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SwitchComponent implements ControlValueAccessor {
+    /** @description Impede alterações pelo usuário sem desabilitar o campo. @default false */
     readonly: boolean;
+    /** @description Rótulo exibido quando o valor é `true`. */
     trueLabel?: string;
+    /** @description Rótulo exibido quando o valor é `false`. */
     falseLabel?: string;
+    /** @description `id` do elemento `<input>` interno para associação com `<label>`. */
     inputId?: string;
+    /** @description Atributo `name` do `<input>` interno. */
     inputName?: string;
+    /** @description Desabilita o componente, impedindo interação e alterações. @default false */
     disabled: boolean;
+    /** @description Emitido quando o valor do switch muda, com o novo estado booleano. */
     valueChanged: EventEmitter<boolean>;
+    /** @description Valor atual do switch. @default false */
     value: boolean;
     switchRef: ElementRef;
     private _onChange?;

package/table/lib/table/table-column/table-columns.component.d.ts

@@ -6,6 +6,18 @@ import { NumericService } from '@seniorsistemas/angular-components/numeric';
 import { IToken } from '@seniorsistemas/angular-components/token-list';
 import { Column, ColumnValues, TableColumnLocaleOptions } from './models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente interno que renderiza uma linha de colunas da tabela,
+ * aplicando formatação localizada (data, número, moeda, token, etc.) para cada coluna.
+ * Normalmente usado dentro do contexto de uma tabela PrimeNG.
+ *
+ * @example
+ * ```html
+ * <s-table-columns [columns]="colunas" [rowValue]="linha" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class TableColumnsComponent implements OnChanges {
     private readonly localeService;
     private readonly viewContainerRef;
@@ -13,8 +25,11 @@ export declare class TableColumnsComponent implements OnChanges {
     private readonly numericService;
     private readonly hostProjectConfigs;
     columnsTemplate: TemplateRef<any> | null;
+    /** @description Lista de configurações das colunas a serem renderizadas. @default [] */
     columns: Column[];
+    /** @description Objeto da linha com os valores a serem exibidos nas colunas. Campo obrigatório. */
     rowValue: any;
+    /** @description Opções de localização (calendário e número) usadas para formatação. @default null */
     locale: TableColumnLocaleOptions | null;
     cellsData: (CellData | null)[];
     formattedColumns: ColumnValues[];

package/table-header/lib/table-header/table-header-checkbox.component.d.ts

@@ -2,13 +2,31 @@ import { OnDestroy, OnInit } from '@angular/core';
 import { CheckboxListData, CheckboxListState } from '@seniorsistemas/angular-components/checkbox-list';
 import { Table, TableService } from 'primeng/table';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de checkbox de cabeçalho para tabelas PrimeNG.
+ * Integra-se automaticamente ao `TableService` para sincronizar o estado
+ * de seleção total/parcial com as linhas da tabela.
+ *
+ * @example
+ * ```html
+ * <th>
+ *   <s-table-header-checkbox [rowProps]="['id', 'name']" />
+ * </th>
+ * ```
+ *
+ * @category Data
+ */
 export declare class TableHeaderCheckboxComponent implements OnInit, OnDestroy {
     readonly table: Table;
     readonly tableService: TableService;
     static nextId: number;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Desabilita o checkbox de cabeçalho. @default false */
     disabled: boolean;
+    /** @description Lista de propriedades dos itens da linha usadas para identificação. */
     rowProps?: string[];
+    /** @description Quando `true`, usa o objeto completo da linha em vez de propriedades específicas. */
     useAllObject?: boolean;
     checkboxItems: CheckboxListData;
     checked: boolean;

package/tabs/lib/tab-item/tab-item.component.d.ts

@@ -1,14 +1,45 @@
 import { AfterViewInit, TemplateRef } from '@angular/core';
 import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de item de aba, utilizado como filho direto de `TabsComponent`.
+ * Define o rótulo, ícone e conteúdo de cada aba individualmente.
+ * Suporta templates customizados para cabeçalho e corpo via `TemplateDirective`.
+ *
+ * @example
+ * ```html
+ * <s-tab-item header="Detalhes" value="details" [disabled]="false">
+ *   Conteúdo da aba
+ * </s-tab-item>
+ * ```
+ *
+ * @category Navegação
+ */
 export declare class TabItemComponent implements AfterViewInit {
     readonly _template: import("@angular/core").Signal<TemplateRef<any> | undefined>;
     readonly headerTemplateDirectives: import("@angular/core").Signal<readonly TemplateDirective[]>;
     readonly templateContent: import("@angular/core").Signal<TemplateRef<any> | undefined>;
+    /** @description Classe de ícone exibida ao lado do rótulo da aba (ex: classe de Font Awesome. */
     icon: import("@angular/core").InputSignal<string | undefined>;
+    /** @description Texto do rótulo exibido na aba. */
     header: import("@angular/core").InputSignal<string | undefined>;
+    /**
+     * @description Quando `true`, a aba fica desabilitada e não pode ser selecionada pelo usuário.
+     *
+     * @default false
+     */
     disabled: import("@angular/core").InputSignal<boolean>;
+    /**
+     * @description Valor identificador único da aba, utilizado pelo `TabsComponent` para controlar a aba ativa.
+     * Quando não informado, é atribuído automaticamente o índice da aba (baseado em zero).
+     */
     value: import("@angular/core").ModelSignal<string | number | undefined>;
+    /**
+     * @description Quando `true`, destrói o conteúdo da aba ao escondê-la, liberando recursos.
+     * Exige que o conteúdo seja envolvido em um template com `sTemplate="body"`.
+     *
+     * @default false
+     */
     destroyOnHide: import("@angular/core").InputSignal<boolean>;
     template: import("@angular/core").Signal<TemplateRef<any> | undefined>;
     headerElement: import("@angular/core").Signal<TemplateRef<any> | undefined>;

package/tabs/lib/tabs/tabs.component.d.ts

@@ -1,12 +1,40 @@
 import { OnDestroy } from '@angular/core';
 import { TabItemComponent } from '../tab-item/tab-item.component';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de abas (tabs) que organiza o conteúdo em painéis acessíveis por rótulos clicáveis.
+ * Suporta layout horizontal e vertical, two-way binding da aba ativa e renderização condicional
+ * do conteúdo de cada aba via `TabItemComponent`.
+ *
+ * @example
+ * ```html
+ * <s-tabs [(activeTab)]="activeTab" layoutType="horizontal">
+ *   <s-tab-item header="Aba 1" value="tab1">Conteúdo 1</s-tab-item>
+ *   <s-tab-item header="Aba 2" value="tab2">Conteúdo 2</s-tab-item>
+ * </s-tabs>
+ * ```
+ *
+ * @category Navegação
+ */
 export declare class TabsComponent implements OnDestroy {
     private readonly onDestroy$;
     protected readonly tabItems: import("@angular/core").Signal<readonly TabItemComponent[]>;
     protected readonly activeTabComponent: import("@angular/core").Signal<import("@angular/core").TemplateRef<any> | undefined>;
     protected readonly keepAliveTabsContent: import("@angular/core").Signal<TabItemComponent[]>;
+    /**
+     * @description Valor da aba atualmente ativa. Suporta two-way binding via `[(activeTab)]`.
+     * Por padrão, ativa a primeira aba (índice `0`).
+     *
+     * @default 0
+     */
     activeTab: import("@angular/core").ModelSignal<string | number>;
+    /**
+     * @description Orientação visual das abas.
+     * - `'horizontal'`: abas exibidas em linha, acima do conteúdo (padrão).
+     * - `'vertical'`: abas exibidas em coluna, à esquerda do conteúdo.
+     *
+     * @default 'horizontal'
+     */
     layoutType: import("@angular/core").InputSignal<"horizontal" | "vertical">;
     constructor();
     ngOnDestroy(): void;

package/template/lib/template/template.directive.d.ts

@@ -1,6 +1,18 @@
 import { TemplateRef } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva estrutural que marca um `<ng-template>` com um alias nomeado,
+ * permitindo que componentes pai identifiquem e projetem templates específicos por nome.
+ *
+ * @example
+ * ```html
+ * <ng-template sTemplate="header">Conteúdo do cabeçalho</ng-template>
+ * ```
+ *
+ * @category Shared
+ */
 export declare class TemplateDirective {
+    /** @description Nome (alias) que identifica o template nomeado. Utilizado como valor do atributo `sTemplate`. */
     type: string;
     readonly template: TemplateRef<any>;
     static ɵfac: i0.ɵɵFactoryDeclaration<TemplateDirective, never>;

package/text-area/lib/text-area/text-area.component.d.ts

@@ -2,6 +2,23 @@ import { ChangeDetectorRef, ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import { KeyFilterPattern } from 'primeng/keyfilter';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de área de texto com suporte a reconhecimento de voz,
+ * filtro de teclas, comprimento máximo e integração com `ControlValueAccessor`.
+ * Renderiza condicionalmente o componente `SpeechRecognitionComponent` quando
+ * a flag `speechRecognition` está ativa.
+ *
+ * @example
+ * ```html
+ * <s-textarea
+ *   formControlName="descricao"
+ *   [rows]="6"
+ *   [maxLength]="500"
+ *   placeholder="Digite aqui..." />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class TextAreaComponent implements ControlValueAccessor {
     private readonly cdr;
     onChange: (value: string) => void;
@@ -11,17 +28,27 @@ export declare class TextAreaComponent implements ControlValueAccessor {
     private _textAreaElement;
     get textAreaElement(): ElementRef<HTMLTextAreaElement>;
     set textAreaElement(value: ElementRef<HTMLTextAreaElement>);
+    /** @description Identificador do elemento `<textarea>` no DOM. @default 'textarea-{random}' */
     inputId: string;
+    /** @description Número de linhas visíveis no textarea. @default 5 */
     rows: number;
+    /** @description Habilita o botão de reconhecimento de voz. @default false */
     speechRecognition: boolean;
+    /** @description Filtro de teclas aceitas, usando padrão ou expressão regular. */
     keyFilter: RegExp | KeyFilterPattern | null | undefined;
+    /** @description Quando `true`, mantém o contexto ao reiniciar o reconhecimento de voz. @default false */
     keepContext: boolean;
+    /** @description Placeholder exibido durante o reconhecimento de voz. @default '' */
     speechRecognitionPlaceholder: string;
+    /** @description Número máximo de caracteres aceitos. @default null (ilimitado) */
     maxLength: number | null;
+    /** @description Texto exibido quando o campo está vazio. */
     placeholder: string | undefined;
     private _inputStyle;
+    /** @description Estilos inline aplicados ao elemento `<textarea>` interno. @default `{ resize: 'vertical' }` */
     get inputStyle(): Partial<CSSStyleDeclaration>;
     set inputStyle(value: Partial<CSSStyleDeclaration>);
+    /** @description Coloca o textarea em modo somente leitura. @default false */
     readOnly: boolean;
     renderTextArea: boolean;
     constructor(cdr: ChangeDetectorRef);

package/thumbnail/lib/thumbnail/thumbnail.component.d.ts

@@ -2,21 +2,45 @@ import { AfterViewInit, ElementRef, OnDestroy } from '@angular/core';
 import { ThumbnailSize } from './thumbnail-size';
 import { ThumbnailService } from './thumbnail.service';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de miniatura de imagem com suporte a imagem de fallback,
+ * ícone de ação sobrepôsto, orientação automática e diferentes tamanhos predefinidos.
+ *
+ * @example
+ * ```html
+ * <s-thumbnail
+ *   [imageSource]="urlDaImagem"
+ *   size="large"
+ *   iconClass="fas fa-user" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class ThumbnailComponent implements AfterViewInit, OnDestroy {
     private readonly thumbnailService;
     static nextId: number;
     fallback: boolean;
     orientation: number;
     imgEl: ElementRef | null;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Tamanho da miniatura: `'small'`, `'medium'`, `'large'`, etc. @default 'medium' */
     size: ThumbnailSize;
+    /** @description URL da imagem principal. */
     imageSource?: string;
+    /** @description URL da imagem de fallback exibida quando a principal falha ao carregar. */
     imageFallback?: string;
+    /** @description Texto alternativo (atributo `alt`) da imagem. */
     imageAlt?: string;
+    /** @description Classe do ícone exibido quando não há imagem disponível. @default 'far fa-image' */
     iconClass: string;
+    /** @description Habilita a exibição de um botão de ação sobrepôsto. @default false */
     hasAction: boolean;
+    /** @description Classe do ícone do botão de ação. @default 'fas fa-camera' */
     actionIconClass: string;
+    /** @description Aplica estilo de tile ao thumbnail. @default false */
     isTile: boolean;
+    /** @description Aplica estilo de marca ao thumbnail. @default false */
     isBrand: boolean;
     private ngUnsubscribe;
     constructor(thumbnailService: ThumbnailService);

package/thumbnails/lib/thumbnails/thumbnails.component.d.ts

@@ -1,12 +1,37 @@
-import { EventEmitter } from "@angular/core";
-import { ThumbnailsItem } from "./models/thumbnails-item";
+import { EventEmitter } from '@angular/core';
+import { ThumbnailsItem } from './models/thumbnails-item';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de galeria de miniaturas com suporte a seleção múltipla
+ * e abertura de itens. Gerencia o estado de seleção internamente e emite eventos
+ * para o componente pai.
+ *
+ * @example
+ * ```html
+ * <s-thumbnails
+ *   [items]="miniaturas"
+ *   [selectable]="true"
+ *   [(selection)]="itensSelecionados"
+ *   (itemOpened)="onItemAberto($event)" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class ThumbnailsComponent {
+    /** @description Lista de itens exibidos na galeria. @default [] */
     items: ThumbnailsItem[];
+    /** @description Habilita a seleção de itens. @default true */
     selectable: boolean;
+    /** @description Quando `true`, combina o evento de checkbox com o de seleção. @default true */
     combineCheckboxEvent: boolean;
+    /**
+     * @description Lista de itens atualmente selecionados. Suporta two-way binding.
+     * @default []
+     */
     set selection(items: ThumbnailsItem[]);
+    /** @description Emitido quando a seleção de itens muda. */
     selectionChange: EventEmitter<ThumbnailsItem[]>;
+    /** @description Emitido quando o usuário abre um item (clique duplo ou ação de abrir). */
     itemOpened: EventEmitter<ThumbnailsItem>;
     private _selection;
     onItemOpened(item: ThumbnailsItem): void;

package/tiered-menu/lib/tiered-menu/components/tiered-menu/tiered-menu.component.d.ts

@@ -10,6 +10,7 @@ export declare class TieredMenuComponent implements OnInit, OnDestroy {
     private readonly _changeDetectorRef;
     readonly tieredMenuService: TieredMenuService;
     private readonly _tieredMenuEventService;
+    ariaLabel?: string;
     items: TieredMenuItemInternalData[];
     top: number;
     left: number;
@@ -24,6 +25,7 @@ export declare class TieredMenuComponent implements OnInit, OnDestroy {
     onKeydownHandler(event: KeyboardEvent): void;
     ngOnInit(): void;
     ngOnDestroy(): void;
+    private _focusCurrentItem;
     private _incrementCurItem;
     private _decrementCurItem;
     private _createMenu;
@@ -31,5 +33,5 @@ export declare class TieredMenuComponent implements OnInit, OnDestroy {
     private _setMenuPosition;
     private _subscribeEvents;
     static ɵfac: i0.ɵɵFactoryDeclaration<TieredMenuComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TieredMenuComponent, "s-tiered-menu", never, {}, { "destroyRequest": "destroyRequest"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TieredMenuComponent, "s-tiered-menu", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, { "destroyRequest": "destroyRequest"; }, never, never, false, never>;
 }

package/tiered-menu/lib/tiered-menu/tiered-menu.directive.d.ts

@@ -4,6 +4,19 @@ import { TieredMenuEventService } from './services/tiered-menu.event.service';
 import { TieredMenuGlobalService } from './services/tiered-menu.global.service';
 import { TieredMenuService } from './services/tiered-menu.service';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que anexa um menu multinível (tiered menu) a qualquer elemento do DOM.
+ * Ao disparar o evento configurado no elemento hospedeiro, exibe um painel flutuante
+ * com itens de menu hierárquicos, suportando submenus aninhados e divisores.
+ * Em telas estreitas (< 600px), o menu é exibido em modo aninhado fullscreen.
+ *
+ * @example
+ * ```html
+ * <s-button [sTieredMenu]="menuItems" triggerEvent="click">Abrir menu</s-button>
+ * ```
+ *
+ * @category Navegação
+ */
 export declare class TieredMenuDirective implements OnInit, OnChanges, OnDestroy {
     private readonly _elementRef;
     private readonly _appRef;
@@ -13,9 +26,26 @@ export declare class TieredMenuDirective implements OnInit, OnChanges, OnDestroy
     private readonly _tieredMenuService;
     private readonly _tieredMenuGlobalService;
     private readonly _changeDetectorRef;
+    /**
+     * @description Lista de itens exibidos no menu. Cada item pode conter um array de `children`
+     * para criar submenus aninhados, além de propriedades como `label`, `icon`,
+     * `disabled`, `command` e `divider`.
+     */
     items: TieredMenuItemData[];
+    /**
+     * @description Item que receberá o foco inicial ao abrir o menu.
+     * Útil para destacar uma opção pré-selecionada ou contextual.
+     */
     focusedItem: TieredMenuItemData | undefined;
+    /**
+     * @description Define o evento do elemento hospedeiro que dispara a abertura do menu.
+     * - `'click'`: abre o menu ao clicar no elemento (padrão).
+     * - `'hover'`: abre o menu ao passar o mouse sobre o elemento.
+     *
+     * @default 'click'
+     */
     triggerEvent: 'click' | 'hover';
+    ariaLabel?: string;
     private _componentRef;
     private _showTimeout?;
     private _isNested;
@@ -42,5 +72,5 @@ export declare class TieredMenuDirective implements OnInit, OnChanges, OnDestroy
     private _rebuildMenu;
     private _updateServiceItems;
     static ɵfac: i0.ɵɵFactoryDeclaration<TieredMenuDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<TieredMenuDirective, "[sTieredMenu]", never, { "items": { "alias": "items"; "required": false; }; "focusedItem": { "alias": "focusedItem"; "required": false; }; "triggerEvent": { "alias": "triggerEvent"; "required": false; }; }, {}, never, never, false, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<TieredMenuDirective, "[sTieredMenu]", never, { "items": { "alias": "items"; "required": false; }; "focusedItem": { "alias": "focusedItem"; "required": false; }; "triggerEvent": { "alias": "triggerEvent"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; }, {}, never, never, false, never>;
 }

package/tile/lib/tile/tile.component.d.ts

@@ -1,16 +1,41 @@
 import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Card clicável que representa uma opção ou destino de navegação,
+ * exibindo ícone (por classe ou imagem), rótulo e descrição opcional.
+ * Suporta navegação por teclado e exibe as iniciais do rótulo como fallback.
+ *
+ * @example
+ * ```html
+ * <s-tile
+ *   label="Relatórios"
+ *   iconClass="fas fa-chart-bar"
+ *   (clicked)="onTileClicado()" />
+ * ```
+ *
+ * @category Summary
+ */
 export declare class TileComponent {
     static nextId: number;
+    /** @description Identificador único do elemento no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Rótulo principal exibido no tile. Campo obrigatório. */
     label: string;
+    /** @description Texto descritivo exibido abaixo do rótulo. */
     description?: string;
+    /** @description Classe do ícone exibido no tile (ex.: `'fas fa-home'`). */
     iconClass?: string;
+    /** @description URL da imagem exibida no tile. */
     imageSource?: string;
+    /** @description Texto alternativo para a imagem (`alt`). */
     imageAlt?: string;
+    /** @description Desabilita o tile, removendo interações e aplicando estilo desativado. @default false */
     disabled: boolean;
+    /** @description `tabindex` do tile para navegação por teclado. @default 0 */
     tabIndex: number;
+    /** @description Exibe o thumbnail (miniatura) no tile. @default true */
     thumbnail: boolean;
+    /** @description Emitido quando o usuário clica ou pressiona Enter/Espaço no tile. */
     clicked: EventEmitter<any>;
     get initialLetter(): string;
     onKeyDown(event: any): void;

package/timeline/lib/timeline/timeline.component.d.ts

@@ -3,15 +3,39 @@ import { TimelineItem } from './models/timeline-item';
 import * as i0 from "@angular/core";
 declare const HORIZONTAL = "horizontal";
 declare const VERTICAL = "vertical";
+/**
+ * @description Componente de linha do tempo que renderiza itens de forma horizontal
+ * ou vertical (ou autodetectável por largura de tela). Suporta navegação entre
+ * etapas, destaque do item ativo e modo colapsável para muitos itens.
+ *
+ * @example
+ * ```html
+ * <s-timeline
+ *   [items]="etapas"
+ *   [activeIndex]="etapaAtiva"
+ *   direction="horizontal" />
+ * ```
+ *
+ * @category Structure
+ */
 export declare class TimelineComponent implements OnInit {
     private _innerWidth;
     private _items;
     get items(): TimelineItem[];
+    /**
+     * @description Lista de itens da linha do tempo. Campo obrigatório.
+     * IDs duplicados são rejeitados com exceção.
+     */
     set items(items: TimelineItem[]);
+    /** @description Índice ativo (0-based) que define o item em destaque. Campo obrigatório. */
     activeIndex: number;
+    /** @description Aplica destaque visual ao item ativo. @default true */
     highlightActiveItem: boolean;
+    /** @description Direção de renderização: `'horizontal'` ou `'vertical'`. @default 'horizontal' */
     direction: typeof HORIZONTAL | typeof VERTICAL;
+    /** @description Habilita o modo colapsável quando há muitos itens. @default true */
     collapsable: boolean;
+    /** @description Rótulo exibido no contador de itens colapsados. @default 'items' */
     counterLabel: string;
     ngOnInit(): void;
     onResize(_: any): void;

package/toast/lib/toast/toast.component.d.ts

@@ -1,8 +1,28 @@
-import { EventEmitter, OnDestroy, OnInit } from "@angular/core";
-import { Toast } from "./types/toast";
+import { EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { Toast } from './types/toast';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente individual de notificação (toast) que exibe uma mensagem temporária na tela.
+ * Gerencia automaticamente o timer de dismiss quando `toast.sticky` é `false`.
+ * Recomenda-se utilizar o `ToastService` para criar e empilhar toasts na aplicação.
+ *
+ * @example
+ * ```html
+ * <s-toast [toast]="toastData" (dismiss)="onDismiss()" />
+ * ```
+ *
+ * @category Feedback
+ */
 export declare class ToastComponent implements OnInit, OnDestroy {
+    /**
+     * @description Objeto com os dados da notificação a ser exibida.
+     * Inclui propriedades como `severity`, `summary`, `detail`, `duration` e `sticky`.
+     */
     toast: Toast;
+    /**
+     * @description Emitido quando a notificação é descartada, seja pelo timer automático
+     * (ao expirar `toast.duration`) ou pela ação manual do usuário.
+     */
     dismiss: EventEmitter<void>;
     isLeaving: boolean;
     private timer;

package/token-list/lib/token-list/token-list.component.d.ts

@@ -1,13 +1,34 @@
 import { EventEmitter } from '@angular/core';
 import { IToken } from './models/token';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de lista de tokens (etiquetas) clicáveis e opcionalmente
+ * removíveis. Emite eventos ao selecionar ou remover um token.
+ *
+ * @example
+ * ```html
+ * <s-token-list
+ *   [tokens]="listaDeTokens"
+ *   [removableTokens]="true"
+ *   (tokenSelected)="onTokenSelecionado($event)"
+ *   (tokenRemoved)="onTokenRemovido($event)" />
+ * ```
+ *
+ * @category Summary
+ */
 export declare class TokenListComponent {
     static nextId: number;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Lista de tokens exibidos. Campo obrigatório. */
     tokens: IToken[];
+    /** @description Exibe o botão de remoção em cada token. @default false */
     removableTokens: boolean;
+    /** @description Quando `true`, remove os eventos de ponteiro (hover/clique) dos tokens. @default false */
     hidePointerEvents: boolean;
+    /** @description Emitido quando o usuário clica em um token não desabilitado. */
     tokenSelected: EventEmitter<IToken>;
+    /** @description Emitido quando o usuário remove um token não desabilitado. */
     tokenRemoved: EventEmitter<IToken>;
     onTokenSelected(token: IToken): void;
     onTokenRemoved(token: IToken): void;