@seniorsistemas/angular-components 19.0.4 → 19.0.6

package/tooltip/lib/tooltip/tooltip.directive.d.ts

@@ -4,21 +4,86 @@ import { MobileBehavior } from './models/mobile-behavior';
 import { TooltipEvent } from './models/tooltip-event';
 import { TooltipPositions } from './models/tooltip-position';
 import * as i0 from "@angular/core";
+/**
+ * @description Diretiva que exibe um tooltip (dica de ferramenta) flutuante ao interagir com o elemento hospedeiro.
+ * Posiciona-se automaticamente considerando o espaço disponível na tela.
+ * Suporta eventos de hover, click e focus, além de comportamentos customizados para mobile.
+ *
+ * @example
+ * ```html
+ * <button sTooltip="Clique aqui" tooltipPosition="top">Ação</button>
+ * ```
+ *
+ * @category Overlay
+ */
 export declare class TooltipDirective implements OnInit, OnDestroy {
     private readonly elementRef;
     private readonly appRef;
     private readonly debounceUtils;
     private readonly renderer;
     private readonly viewContainerRef;
+    /**
+     * @description Texto exibido no tooltip. Quando vazio ou `undefined`, o tooltip não é renderizado.
+     */
     tooltip?: string;
+    /**
+     * @description Posição preferencial do tooltip em relação ao elemento hospedeiro.
+     * O tooltip se reposiciona automaticamente se não houver espaço suficiente.
+     *
+     * @default 'top'
+     */
     tooltipPosition: TooltipPositions;
+    /**
+     * @description Tempo em milissegundos antes do tooltip aparecer após o evento de ativação.
+     *
+     * @default 500
+     */
     showDelay: number;
+    /**
+     * @description Tempo em milissegundos que o tooltip permanece visível após aparecer.
+     * Quando não informado, o tooltip permanece até o usuário sair do elemento.
+     */
     displayTime?: number;
+    /**
+     * @description Evento do elemento hospedeiro que dispara a exibição do tooltip.
+     * - `'hover'`: exibe ao passar o mouse (padrão).
+     * - `'click'`: exibe ao clicar.
+     * - `'focus'`: exibe ao focar no elemento.
+     *
+     * @default 'hover'
+     */
     tooltipEvent: TooltipEvent;
+    /**
+     * @description Quando `true`, o conteúdo HTML do tooltip é escapado antes de ser renderizado.
+     *
+     * @default false
+     */
     escape: boolean;
+    /**
+     * @description Quando `false`, o tooltip nunca é exibido, mesmo que haja interação do usuário.
+     * Útil para desabilitar tooltips dinamicamente.
+     *
+     * @default true
+     */
     visible: boolean;
+    /**
+     * @description Comportamento do tooltip em dispositivos móveis (touch).
+     * - `'pressing'`: exibe ao pressionar e manter o toque (padrão).
+     * - `'none'`: desabilita o tooltip em dispositivos táteis.
+     *
+     * @default 'pressing'
+     */
     mobileBehavior: MobileBehavior;
+    /**
+     * @description Referência a um input HTML para sincronizar a exibição do tooltip com o foco no campo.
+     */
     focusedInputRef: HTMLInputElement | null;
+    /**
+     * @description Quando `true`, o tooltip só é exibido se o texto do elemento estiver truncado (overflow).
+     * Útil para cells de tabela ou elementos com `text-overflow: ellipsis`.
+     *
+     * @default false
+     */
     checkTruncatedText: import("@angular/core").InputSignal<boolean>;
     private componentRef;
     private showTimeout?;

package/topbar/lib/topbar/topbar.component.d.ts

@@ -1,13 +1,30 @@
 import { AfterViewInit, ElementRef } from '@angular/core';
 import * as i0 from "@angular/core";
 import * as i1 from "@seniorsistemas/angular-components/common/deprecated-selector";
+/**
+ * @description Componente de barra superior (topbar) com título e suporte a
+ * conteúdo transclusão. Também responde ao seletor legado `s-product-header`.
+ *
+ * @example
+ * ```html
+ * <s-topbar header="Minha Aplicação">
+ *   <!-- ações e menus -->
+ * </s-topbar>
+ * ```
+ *
+ * @category Structure
+ */
 export declare class TopbarComponent implements AfterViewInit {
     static readonly nextIdSeed = 0;
     private static _nextId;
     static getNextId(): number;
+    /** @description Identificador único do componente no DOM. Gerado automaticamente se não informado. */
     id: string;
+    /** @description Título exibido na barra superior. Campo obrigatório. */
     header: string;
+    /** @description Z-index base aplicado ao componente. @default 0 */
     baseZIndex: number;
+    /** @description Quando `true`, aplica borda inferior; quando `false`, aplica borda superior. @default true */
     isHeaderFrame: boolean;
     container: ElementRef | null;
     ngAfterViewInit(): void;

package/tree/lib/tree/tree.component.d.ts

@@ -1,19 +1,46 @@
 import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
 import { InternalTreeNodeItem, TreeNodeEdit, TreeNodeItem } from './Models/tree.models';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de árvore hierárquica com suporte a seleção única ou múltipla,
+ * checkboxes, noós expansíveis e edição inline de rótulos. Gerencia o estado interno
+ * dos nós e emite eventos na seleção, expansão, colapso e edição.
+ *
+ * @example
+ * ```html
+ * <s-tree
+ *   [treeData]="nos"
+ *   selectionMode="multiple"
+ *   [showCheckbox]="true"
+ *   (selectedChange)="onSelecaoMudou($event)" />
+ * ```
+ *
+ * @category Data
+ */
 export declare class TreeComponent implements OnChanges {
+    /** @description Lista de nós raíz da árvore. @default [] */
     treeData: TreeNodeItem[];
     private _selected;
+    /** @description Nó(s) selecionado(s). Suporta array ou item único dependendo de `selectionMode`. @default [] */
     get selected(): TreeNodeItem[];
     set selected(value: TreeNodeItem[] | TreeNodeItem | undefined);
+    /** @description Exibe indicador de carregamento nos nós. @default false */
     loading: boolean;
+    /** @description Modo de seleção: `'single'` ou `'multiple'`. @default 'single' */
     selectionMode: 'single' | 'multiple';
+    /** @description Exibe checkboxes nos nós para seleção visual. @default false */
     showCheckbox: boolean;
+    /** @description Expão todos os nós inicialmente. @default false */
     allExpanded: boolean;
+    /** @description Emitido quando a seleção muda, com o(s) nó(s) selecionado(s). */
     selectedChange: EventEmitter<TreeNodeItem[] | TreeNodeItem>;
+    /** @description Emitido quando o usuário clica em um nó da árvore. */
     treeNodeItemClicked: EventEmitter<TreeNodeItem>;
+    /** @description Emitido após uma edição inline de rótulo de nó. */
     treeNodeEdit: EventEmitter<TreeNodeEdit>;
+    /** @description Emitido quando um nó é expandido pelo usuário. */
     nodeExpanded: EventEmitter<TreeNodeItem>;
+    /** @description Emitido quando um nó é colapsado pelo usuário. */
     nodeCollapsed: EventEmitter<TreeNodeItem>;
     ngOnChanges(changes: SimpleChanges): void;
     onTreeNodeItemClicked({ item }: {

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

@@ -1,14 +1,60 @@
 import { ChangeDetectorRef, ElementRef, EventEmitter, OnInit, QueryList } from '@angular/core';
 import { Workspace } from './models/workspace';
 import * as i0 from "@angular/core";
+/**
+ * @description Componente de seleção de workspace exibe um dropdown com a lista de espaços de trabalho
+ * disponíveis, permitindo ao usuário alternar entre eles. Suporta navegação por teclado
+ * (setas, Enter, Escape), estado desabilitado e um botão de ação customizável no rodapé.
+ *
+ * @example
+ * ```html
+ * <s-workspace-switch
+ *   [workspaces]="workspaces"
+ *   footerButtonLabel="Criar workspace"
+ *   (selected)="onWorkspaceSelect($event)"
+ *   (footerButtonClicked)="onCreate()"
+ * />
+ * ```
+ *
+ * @category Navegação
+ */
 export declare class WorkspaceSwitchComponent implements OnInit {
     private readonly eRef;
     private readonly changeDetectorRef;
+    /**
+     * @description Lista de workspaces disponíveis para seleção. Campo obrigatório.
+     * Cada item deve implementar a interface `Workspace`.
+     * Lança um erro em runtime se a lista estiver vazia.
+     */
     workspaces: Workspace[];
+    /**
+     * @description Rótulo exibido no botão de ação localizado no rodapé do dropdown.
+     *
+     * @default 'Adicionar'
+     */
     footerButtonLabel: string;
+    /**
+     * @description Controla a visibilidade do botão de ação no rodapé do dropdown.
+     * Quando `false`, o botão não é renderizado.
+     *
+     * @default true
+     */
     showFooterButton: boolean;
+    /**
+     * @description Quando `true`, o componente fica desabilitado: não abre o dropdown,
+     * não emite eventos e fica inacessível via teclado (`tabindex = -1`).
+     *
+     * @default false
+     */
     disabled: boolean;
+    /**
+     * @description Emitido quando o usuário clica no botão de ação do rodapé do dropdown.
+     */
     footerButtonClicked: EventEmitter<any>;
+    /**
+     * @description Emitido quando o usuário seleciona um workspace da lista.
+     * Retorna o objeto `Workspace` selecionado.
+     */
     selected: EventEmitter<Workspace>;
     listItems: QueryList<ElementRef> | null;
     get open(): boolean;

package/breadcrumb/lib/breadcrumb/breadcrumb.module.d.ts

@@ -1,10 +0,0 @@
-import * as i0 from "@angular/core";
-import * as i1 from "./breadcrumb.component";
-import * as i2 from "@angular/common";
-import * as i3 from "primeng/breadcrumb";
-import * as i4 from "@angular/router";
-export declare class BreadcrumbModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<BreadcrumbModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<BreadcrumbModule, [typeof i1.BreadcrumbComponent], [typeof i2.CommonModule, typeof i3.BreadcrumbModule, typeof i4.RouterModule], [typeof i1.BreadcrumbComponent, typeof i4.RouterModule]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<BreadcrumbModule>;
-}

package/esm2022/breadcrumb/lib/breadcrumb/breadcrumb.module.mjs

@@ -1,20 +0,0 @@
-import { NgModule } from '@angular/core';
-import { CommonModule } from '@angular/common';
-import { BreadcrumbModule as PrimeBreadcrumbModule } from 'primeng/breadcrumb';
-import { BreadcrumbComponent } from './breadcrumb.component';
-import { RouterModule } from '@angular/router';
-import * as i0 from "@angular/core";
-export class BreadcrumbModule {
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: BreadcrumbModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
-    static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "18.2.14", ngImport: i0, type: BreadcrumbModule, declarations: [BreadcrumbComponent], imports: [CommonModule, PrimeBreadcrumbModule, RouterModule], exports: [BreadcrumbComponent, RouterModule] });
-    static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: BreadcrumbModule, imports: [CommonModule, PrimeBreadcrumbModule, RouterModule, RouterModule] });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.2.14", ngImport: i0, type: BreadcrumbModule, decorators: [{
-            type: NgModule,
-            args: [{
-                    imports: [CommonModule, PrimeBreadcrumbModule, RouterModule],
-                    declarations: [BreadcrumbComponent],
-                    exports: [BreadcrumbComponent, RouterModule],
-                }]
-        }] });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJlYWRjcnVtYi5tb2R1bGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9hbmd1bGFyLWNvbXBvbmVudHMvYnJlYWRjcnVtYi9zcmMvbGliL2JyZWFkY3J1bWIvYnJlYWRjcnVtYi5tb2R1bGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDL0MsT0FBTyxFQUFFLGdCQUFnQixJQUFJLHFCQUFxQixFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFL0UsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDN0QsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLGlCQUFpQixDQUFDOztBQU8vQyxNQUFNLE9BQU8sZ0JBQWdCO3dHQUFoQixnQkFBZ0I7eUdBQWhCLGdCQUFnQixpQkFIVixtQkFBbUIsYUFEeEIsWUFBWSxFQUFFLHFCQUFxQixFQUFFLFlBQVksYUFFakQsbUJBQW1CLEVBQUUsWUFBWTt5R0FFbEMsZ0JBQWdCLFlBSmYsWUFBWSxFQUFFLHFCQUFxQixFQUFFLFlBQVksRUFFNUIsWUFBWTs7NEZBRWxDLGdCQUFnQjtrQkFMNUIsUUFBUTttQkFBQztvQkFDTixPQUFPLEVBQUUsQ0FBQyxZQUFZLEVBQUUscUJBQXFCLEVBQUUsWUFBWSxDQUFDO29CQUM1RCxZQUFZLEVBQUUsQ0FBQyxtQkFBbUIsQ0FBQztvQkFDbkMsT0FBTyxFQUFFLENBQUMsbUJBQW1CLEVBQUUsWUFBWSxDQUFDO2lCQUMvQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IE5nTW9kdWxlIH0gZnJvbSAnQGFuZ3VsYXIvY29yZSc7XG5pbXBvcnQgeyBDb21tb25Nb2R1bGUgfSBmcm9tICdAYW5ndWxhci9jb21tb24nO1xuaW1wb3J0IHsgQnJlYWRjcnVtYk1vZHVsZSBhcyBQcmltZUJyZWFkY3J1bWJNb2R1bGUgfSBmcm9tICdwcmltZW5nL2JyZWFkY3J1bWInO1xuXG5pbXBvcnQgeyBCcmVhZGNydW1iQ29tcG9uZW50IH0gZnJvbSAnLi9icmVhZGNydW1iLmNvbXBvbmVudCc7XG5pbXBvcnQgeyBSb3V0ZXJNb2R1bGUgfSBmcm9tICdAYW5ndWxhci9yb3V0ZXInO1xuXG5ATmdNb2R1bGUoe1xuICAgIGltcG9ydHM6IFtDb21tb25Nb2R1bGUsIFByaW1lQnJlYWRjcnVtYk1vZHVsZSwgUm91dGVyTW9kdWxlXSxcbiAgICBkZWNsYXJhdGlvbnM6IFtCcmVhZGNydW1iQ29tcG9uZW50XSxcbiAgICBleHBvcnRzOiBbQnJlYWRjcnVtYkNvbXBvbmVudCwgUm91dGVyTW9kdWxlXSxcbn0pXG5leHBvcnQgY2xhc3MgQnJlYWRjcnVtYk1vZHVsZSB7fVxuIl19