@seniorsistemas/angular-components 19.0.5 → 19.0.6

package/shared/lib/shared/border-button/border-button.component.d.ts

@@ -1,8 +1,16 @@
-import { BorderButtonOptions } from "../models/border-button-options";
-import { Severities } from "../models/severities";
+import { BorderButtonOptions } from '../models/border-button-options';
+import { Severities } from '../models/severities';
 import * as i0 from "@angular/core";
+/**
+ * @description Botão com borda que varia de estilo de acordo com a severidade informada.
+ * Utilizado internamente por outros componentes da biblioteca.
+ *
+ * @category Shared
+ */
 export declare class BorderButtonComponent {
+    /** @description Nível de severidade que define a cor e estilo do botão. @default 'default' */
     severity: Severities;
+    /** @description Opções de configuração do botão (rótulo, ação, etc.). */
     options?: BorderButtonOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<BorderButtonComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<BorderButtonComponent, "s-border-button", never, { "severity": { "alias": "severity"; "required": false; }; "options": { "alias": "options"; "required": false; }; }, {}, never, never, false, never>;

package/sidebar/lib/sidebar/sidebar.component.d.ts

@@ -1,15 +1,68 @@
 import { AfterContentInit, OnDestroy, QueryList, TemplateRef } from '@angular/core';
 import { TemplateDirective } from '@seniorsistemas/angular-components/template';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de painel lateral deslizante (sidebar) que aparece sobre o conteúdo
+ * vindo do lado direito da tela. Suporta templates customizados para cabeçalho, corpo e rodapé
+ * via `sTemplate`, bloqueio de scroll automático e confirmação de fechamento.
+ *
+ * @example
+ * ```html
+ * <s-sidebar [(visible)]="sidebarOpen" header="Filtros" [closable]="true">
+ *   <ng-template sTemplate="body">Conteúdo</ng-template>
+ * </s-sidebar>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class SidebarComponent implements AfterContentInit, OnDestroy {
     templates: QueryList<TemplateDirective> | null;
+    /**
+     * @description Controla a visibilidade da sidebar. Suporta two-way binding via `[(visible)]`.
+     *
+     * @default false
+     */
     visible: import("@angular/core").ModelSignal<boolean>;
+    /**
+     * @description Quando `true`, exibe o botão de fechar (X) no cabeçalho da sidebar.
+     *
+     * @default true
+     */
     closable: boolean;
+    /**
+     * @description Quando `true`, clicar no backdrop (área escurecida fora da sidebar) fecha o painel.
+     *
+     * @default true
+     */
     dismissible: boolean;
+    /**
+     * @description Quando `true`, pressionar a tecla Escape fecha a sidebar.
+     *
+     * @default true
+     */
     closeOnEscape: boolean;
+    /**
+     * @description Texto exibido no cabeçalho padrão da sidebar.
+     * Pode ser substituído por um template customizado via `sTemplate="header"`.
+     */
     header?: string;
+    /**
+     * @description Quando `true`, aumenta a largura da sidebar para acomodar mais conteúdo.
+     *
+     * @default false
+     */
     largeSized: boolean;
+    /**
+     * @description Quando `true`, mantém o conteúdo da sidebar no DOM mesmo quando oculta,
+     * preservando o estado interno dos componentes filhos.
+     *
+     * @default false
+     */
     cache: boolean;
+    /**
+     * @description Função de confirmação chamada antes de fechar a sidebar.
+     * Quando retornar `false`, o fechamento é bloqueado. Útil para validar formulários não salvos.
+     */
     set registerConfirmClose(fn: () => boolean);
     headerTemplate: TemplateRef<unknown> | null;
     bodyTemplate: TemplateRef<unknown> | null;

package/slide-in-bar/lib/slide-in-bar/slide-in-bar.component.d.ts

@@ -1,17 +1,68 @@
-import { AfterViewChecked, AfterViewInit, EventEmitter, OnDestroy, OnInit } from "@angular/core";
-import { SlideInBarService } from "./slide-in-bar.service";
+import { AfterViewChecked, AfterViewInit, EventEmitter, OnDestroy, OnInit } from '@angular/core';
+import { SlideInBarService } from './slide-in-bar.service';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de painel deslizante lateral que expande/colapsa ao clicar em um botão de toggle.
+ * Em telas pequenas (≤ 420px), o painel entra em modo overlay, sobrepondo o conteúdo.
+ * Substitui o seletor `s-slide-panel` (deprecado desde v20.0.0).
+ *
+ * @example
+ * ```html
+ * <s-slide-in-bar [cache]="true" (panelOpened)="onOpen()">
+ *   <p>Conteúdo lateral</p>
+ * </s-slide-in-bar>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class SlideInBarComponent implements OnInit, AfterViewChecked, AfterViewInit, OnDestroy {
     private readonly slidePanelService;
     static nextId: number;
+    /**
+     * @description Identificador único do painel. Gerado automaticamente se não informado.
+     * Usado internamente pelo `SlideInBarService` para comunicação entre painéis.
+     */
     id: string;
+    /**
+     * @description Classe de ícone exibida no botão de abertura do painel.
+     *
+     * @default 'fas fa-chevron-right'
+     */
     openIcon: string;
+    /**
+     * @description Classe de ícone exibida no botão de fechamento do painel.
+     *
+     * @default 'fas fa-chevron-left'
+     */
     closeIcon: string;
+    /**
+     * @description Quando `true`, mantém o conteúdo do painel no DOM mesmo quando fechado,
+     * preservando o estado interno dos componentes filhos.
+     *
+     * @default false
+     */
     cache: boolean;
+    /**
+     * @description Quando `true`, o painel é iniciado já aberto.
+     *
+     * @default false
+     */
     createOpen: boolean;
+    /**
+     * @description Quando `true`, o painel não sobrepõe o conteúdo ao expandir,
+     * empurrando o layout adjacente.
+     *
+     * @default false
+     */
     noOverlap: boolean;
+    /**
+     * @description Emitido quando o painel é aberto pelo usuário.
+     */
     panelOpened: EventEmitter<void>;
+    /**
+     * @description Emitido quando o painel é fechado pelo usuário.
+     */
     panelClosed: EventEmitter<void>;
     isOpen: boolean;
     isSlideOver: boolean;

package/slider/lib/slider/slider.component.d.ts

@@ -1,20 +1,92 @@
 import { AfterViewInit, ElementRef, EventEmitter, OnChanges, OnInit, SimpleChanges } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de controle deslizante (slider) para seleção de valores numéricos
+ * dentro de um intervalo definido. Suporta modo simples (um valor) e modo de intervalo
+ * (dois valores: início e fim). Implementa {@link ControlValueAccessor} para integração
+ * com Reactive Forms e Template-driven Forms do Angular.
+ *
+ * @example
+ * ```html
+ * <!-- Slider simples -->
+ * <s-slider formControlName="volume" [min]="0" [max]="100" [step]="5" />
+ *
+ * <!-- Slider de intervalo -->
+ * <s-slider formControlName="faixa" [multiple]="true" [min]="0" [max]="1000" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SliderComponent implements OnInit, AfterViewInit, ControlValueAccessor, OnChanges {
     private readonly MAX_RANGE_VALUE;
     private readonly MIN_RANGE_VALUE;
     track: ElementRef;
+    /**
+     * @description Habilita o modo de intervalo, permitindo selecionar um valor mínimo e máximo.
+     * Quando `true`, o valor do componente é um array `[inicio, fim]`.
+     *
+     * @default false
+     */
     multiple: boolean;
+    /**
+     * @description Valor atual do slider. No modo simples é um número; no modo de
+     * intervalo (`multiple: true`) é um array `[inicio, fim]`.
+     *
+     * @default 0
+     */
     value: number | [number, number];
+    /**
+     * @description Emitido sempre que o valor do slider é alterado pelo usuário.
+     * Emite o novo valor (número ou array de dois números no modo de intervalo).
+     */
     valueChange: EventEmitter<number | [number, number]>;
+    /**
+     * @description Incremento aplicado a cada movimento do thumb do slider.
+     *
+     * @default 1
+     */
     step: number;
+    /**
+     * @description Oculta visualmente o thumb (botão arrastável) do slider.
+     * Útil para visualizações onde apenas a faixa de progresso deve ser exibida.
+     *
+     * @default false
+     */
     hiddenThumb: boolean;
+    /**
+     * @description Desabilita a interação do usuário com o slider.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * @description Valor mínimo permitido no slider.
+     *
+     * @default 0
+     */
     min: number;
+    /**
+     * @description Valor máximo permitido no slider.
+     *
+     * @default 100
+     */
     max: number;
+    /**
+     * @description Label exibido abaixo ou ao lado do valor mínimo do slider.
+     * Útil para indicar semanticamente os extremos do intervalo.
+     */
     minValueLabel?: string;
+    /**
+     * @description Label exibido abaixo ou ao lado do valor máximo do slider.
+     * Útil para indicar semanticamente os extremos do intervalo.
+     */
     maxValueLabel?: string;
+    /**
+     * @description Índice de tabulação do elemento, controlando a ordem de foco via teclado.
+     *
+     * @default 0
+     */
     tabindex: number;
     startValue: number;
     endValue: number;

package/speech-recognition/lib/speech-recognition/speech-recognition/speech-recognition.component.d.ts

@@ -3,13 +3,30 @@ import { TranslateService } from '@ngx-translate/core';
 import { SpeechRecognitionService } from '../speech-recognition.service';
 import { TextToSpeechService } from '../text-to-speech.service';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de reconhecimento de voz que integra a Web Speech API para
+ * transcrever a fala do usuário em texto, inserída diretamente em um `<textarea>` fornecido.
+ * Suporta também text-to-speech para leitura em voz alta do conteúdo do campo.
+ *
+ * @example
+ * ```html
+ * <s-speech-recognition
+ *   [textAreaElement]="textAreaRef.nativeElement"
+ *   (recognizedText)="onTextoReconhecido($event)" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     private readonly speechRecognitionService;
     private readonly textToSpeechService;
     private readonly translateService;
     private static TOOLBAR_ACTIVE;
+    /** @description Referência ao elemento `<textarea>` nativo que receberá o texto transcrito. Campo obrigatório. */
     textAreaElement: HTMLTextAreaElement;
+    /** @description Quando `true`, mantém o texto existente no campo ao iniciar novo reconhecimento. @default false */
     keepContext: boolean;
+    /** @description Placeholder exibido no textarea durante o reconhecimento de voz. @default '' */
     speechRecognitionPlaceholder: string;
     private _recognizedText;
     private originalTextAreaElementText;
@@ -28,6 +45,7 @@ export declare class SpeechRecognitionComponent implements OnInit, OnDestroy {
     canRenderAprove: boolean;
     canRenderTextToSpeechToolbar: boolean;
     isPlayingTextToSpeech: boolean;
+    /** @description Emitido quando o reconhecimento de voz é concluído, com o texto transcrito. */
     recognizedText: EventEmitter<string>;
     constructor(speechRecognitionService: SpeechRecognitionService, textToSpeechService: TextToSpeechService, translateService: TranslateService);
     ngOnInit(): void;

package/split-button/lib/split-button/split-button.component.d.ts

@@ -2,13 +2,35 @@ import { EventEmitter, ElementRef } from '@angular/core';
 import { SplitButtonOption } from './models/split-button-option';
 import { SplitButtonType } from './models/split-button-type';
 import * as i0 from "@angular/core";
+/**
+ * @description Botão composto com ação principal e dropdown de opções adicionais.
+ * Ao clicar no botão principal emite `buttonClicked`; ao clicar no ícone de seta
+ * abre/fecha o dropdown com a lista de `options`.
+ *
+ * @example
+ * ```html
+ * <s-split-button
+ *   label="Salvar"
+ *   iconClass="fas fa-save"
+ *   [options]="menuOpcoes"
+ *   (buttonClicked)="onSalvar()" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class SplitButtonComponent {
     private readonly _eRef;
+    /** @description Desabilita o botão principal e o dropdown. @default false */
     disabled: boolean;
+    /** @description Classe do ícone exibido no botão principal. Campo obrigatório. */
     iconClass: string;
+    /** @description Rótulo do botão principal. Campo obrigatório. */
     label: string;
+    /** @description Estilo visual do botão (`'primary'` ou `'secondary'`). @default 'primary' */
     type: SplitButtonType;
+    /** @description Lista de opções exibidas no dropdown. Campo obrigatório. */
     options: SplitButtonOption[];
+    /** @description Emitido quando o usuário clica no botão principal (não no dropdown). */
     buttonClicked: EventEmitter<any>;
     open: boolean;
     constructor(_eRef: ElementRef);

package/star-rating/star-rating/star-rating.component.d.ts

@@ -1,12 +1,28 @@
 import { ControlValueAccessor } from '@angular/forms';
 import { JustifyTypes } from './star-rating-models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de avaliação por estrelas com suporte a `ControlValueAccessor`
+ * para integração com formulários Angular. Permite configurar o número de estrelas,
+ * alinhamento e estado desabilitado. Clicar na estrela já selecionada a deseleciona.
+ *
+ * @example
+ * ```html
+ * <s-star-rating [starsRange]="5" formControlName="avaliacao" />
+ * ```
+ *
+ * @category Inputs
+ */
 export declare class StarRatingComponent implements ControlValueAccessor {
     onChange: (value: number) => void;
     onTouched: (value: number) => void;
+    /** @description Índice da estrela atualmente selecionada (1-based). @default 0 */
     selectedStar: import("@angular/core").ModelSignal<number>;
+    /** @description Número total de estrelas exibidas. @default 5 */
     starsRange: import("@angular/core").InputSignal<number>;
+    /** @description Alinhamento horizontal das estrelas. @default 'center' */
     justifyContent: import("@angular/core").InputSignal<JustifyTypes>;
+    /** @description Desabilita a seleção de estrelas. @default false */
     disabled: import("@angular/core").ModelSignal<boolean>;
     protected readonly elementsRender: import("@angular/core").Signal<number[]>;
     writeValue(obj: number): void;

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

@@ -1,17 +1,44 @@
 import { EventEmitter } from '@angular/core';
 import * as i0 from "@angular/core";
+/**
+ * @description Card de estatística que exibe um valor numérico com ícone,
+ * rótulo e animação de contagem. Suporta diferentes estilos visuais
+ * (borda, versão leve) e pode emitir evento ao ser clicado.
+ *
+ * @example
+ * ```html
+ * <s-stats-card
+ *   label="Vendas"
+ *   [value]="'1.234'"
+ *   iconClass="fas fa-shopping-cart"
+ *   color="#3399ff" />
+ * ```
+ *
+ * @category Summary
+ */
 export declare class StatsCardComponent {
     static nextId: number;
+    /** @description Identificador único do card no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Rótulo descritivo da estatística exibida. Campo obrigatório. */
     label: string;
+    /** @description Exibe borda mesmo quando o card não está em destaque. @default false */
     alwaysWithBorder: boolean;
+    /** @description Ativa a versão visual leve (sem sombra e com fundo claro). @default false */
     lightVersion: boolean;
+    /** @description Ativa o modo de cores claras para o card. @default true */
     lightMode: boolean;
+    /** @description Classe do ícone exibido no card. @default 'fa fa-bar-chart' */
     iconClass: string;
+    /** @description Cor de destaque do card em formato CSS. @default '#339966' */
     color: string;
+    /** @description Habilita a animação de contagem ao atualizar o valor. @default true */
     animateNumbers: boolean;
+    /** @description Habilita o cursor de ponteiro e o evento de clique. @default false */
     clickable: boolean;
+    /** @description Texto do tooltip exibido ao passar o mouse sobre o card. @default '' */
     tooltip: string;
+    /** @description Emitido quando o usuário clica no card (requer `clickable = true`). */
     clicked: EventEmitter<MouseEvent>;
     displayValue?: string;
     private _ANIMATION_DURATION_MS;
@@ -20,6 +47,7 @@ export declare class StatsCardComponent {
     private _intervalId;
     private _value;
     get value(): string;
+    /** @description Valor numérico exibido no card. Quando `animateNumbers` está ativo, a contagem é animada. */
     set value(value: string);
     replaceNumericPositions(value: string, newValue?: BigNumber): string;
     private _updateDisplayValue;

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>;