structra-ui 0.1.4 → 0.1.5

package/app/data-display/card-list/card-list.component.d.ts

@@ -0,0 +1,70 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import type { CardItemView, CardListMapFn } from '../_models/card-item-view.model';
+import * as i0 from "@angular/core";
+/**
+ * - **memory**: `items` tem a lista completa (ex.: 500 em memória); só se mostram
+ *   `scrollBatchSize` de cada vez até o usuário fazer scroll (fatia local).
+ * - **remote**: `items` são só as linhas já devolvidas pela API; ao fim do scroll
+ *   emite `loadMore` para pedir a próxima página (SQL OFFSET/FETCH no backend).
+ */
+export type CardListDataMode = 'memory' | 'remote';
+export declare class CardListComponent<T = unknown> implements OnChanges {
+    private readonly cdr;
+    items: T[];
+    loading: boolean;
+    /**
+     * Com itens já visíveis: mostra **um** skeleton no fundo (próxima página remota)
+     * para não saltar o scroll nem ocupar altura de vários cartões. O carregamento inicial
+     * continua a usar só {@link loading} (lista vazia ou refresh completo com `loading` e sem `loadingMore`).
+     */
+    loadingMore: boolean;
+    emptyMessage: string;
+    variant: 'default';
+    mapItem: CardListMapFn<T>;
+    showItemActions: boolean;
+    trackByProp: keyof T | string;
+    dataMode: CardListDataMode;
+    /** Em modo `memory`: quantos itens revelar por cada passo de scroll. Por omissão `10`. */
+    scrollBatchSize: number;
+    scrollLoadThresholdPx: number;
+    /** Mostra o rodapé com o resumo (“X de Y”) e dica. Por omissão `true`; com `false` oculta o footer. */
+    showFooter: boolean;
+    scrollMaxHeight: string | null;
+    /**
+     * Modo **remote**: total de registros no servidor (ex.: COUNT SQL), para o texto “X de Y”.
+     * Se `null`, usa `items.length`.
+     */
+    totalCountRemote: number | null;
+    /** Modo **remote**: existe página seguinte para pedir ao backend. */
+    hasNextPage: boolean;
+    /** Modo **remote**: pedido de mais dados (próxima página). */
+    readonly loadMore: EventEmitter<void>;
+    readonly edit: EventEmitter<T>;
+    readonly remove: EventEmitter<T>;
+    /** Modo memory: quantos cartões renderizar (fatia inicial = scrollBatchSize). */
+    visibleCount: number;
+    private loadMorePending;
+    /** Skeleton que ocupa a lista inteira (carregamento inicial / refresh com `loading`). */
+    get showFullSkeleton(): boolean;
+    ngOnChanges(changes: SimpleChanges): void;
+    get totalItemCount(): number;
+    /** Total para o rodapé “X de Y”. */
+    get totalForStatus(): number;
+    get visibleItems(): T[];
+    get scrollStatusLabel(): string;
+    get scrollAreaStyle(): Record<string, string>;
+    /** Há mais linhas para mostrar (memória) ou para pedir à API (remote). */
+    get hasMoreToReveal(): boolean;
+    viewFor(item: T): CardItemView;
+    skeletonCardIndices(): number[];
+    /** Um único cartão skeleton no fundo durante `loadingMore` (mantém o scroll estável). */
+    skeletonTailIndices(): number[];
+    trackFn: (index: number, item: T) => unknown;
+    onScroll(ev: Event): void;
+    private requestRemotePage;
+    private loadMoreMemoryChunk;
+    private resetVisibleWindow;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CardListComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CardListComponent<any>, "app-card-list", never, { "items": { "alias": "items"; "required": true; }; "loading": { "alias": "loading"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "mapItem": { "alias": "mapItem"; "required": true; }; "showItemActions": { "alias": "showItemActions"; "required": false; }; "trackByProp": { "alias": "trackByProp"; "required": false; }; "dataMode": { "alias": "dataMode"; "required": false; }; "scrollBatchSize": { "alias": "scrollBatchSize"; "required": false; }; "scrollLoadThresholdPx": { "alias": "scrollLoadThresholdPx"; "required": false; }; "showFooter": { "alias": "showFooter"; "required": false; }; "scrollMaxHeight": { "alias": "scrollMaxHeight"; "required": false; }; "totalCountRemote": { "alias": "totalCountRemote"; "required": false; }; "hasNextPage": { "alias": "hasNextPage"; "required": false; }; }, { "loadMore": "loadMore"; "edit": "edit"; "remove": "remove"; }, never, never, true, never>;
+    static ngAcceptInputType_loadingMore: unknown;
+}

package/app/data-display/dashboard-section/dashboard-section.component.d.ts

@@ -0,0 +1,12 @@
+import * as i0 from "@angular/core";
+/**
+ * Bloco de dashboard: título, ações opcionais e conteúdo (stat-cards, listas, grades).
+ * Superfície alinhada aos cartões da lib.
+ */
+export declare class DashboardSectionComponent {
+    title: string;
+    subtitle: string;
+    readonly titleId: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DashboardSectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DashboardSectionComponent, "app-dashboard-section", never, { "title": { "alias": "title"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; }, {}, never, ["[dashboard-section-actions]", "*"], true, never>;
+}

package/app/data-display/data-card/data-card.component.d.ts

@@ -0,0 +1,16 @@
+import { EventEmitter } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class DataCardComponent {
+    title: string;
+    subtitle?: string;
+    /** 1–2 caracteres para o círculo de iniciais. */
+    avatarText?: string;
+    variant: 'default';
+    showActions: boolean;
+    readonly edit: EventEmitter<void>;
+    readonly remove: EventEmitter<void>;
+    onEditClick(ev: Event): void;
+    onRemoveClick(ev: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataCardComponent, "app-data-card", never, { "title": { "alias": "title"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; "avatarText": { "alias": "avatarText"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "showActions": { "alias": "showActions"; "required": false; }; }, { "edit": "edit"; "remove": "remove"; }, never, never, true, never>;
+}

package/app/data-display/data-grid/data-grid-actions-cell-renderer.component.d.ts

@@ -0,0 +1,21 @@
+import type { ICellRendererAngularComp } from 'ag-grid-angular';
+import type { ICellRendererParams } from 'ag-grid-community';
+import * as i0 from "@angular/core";
+/** Contexto injetado pelo {@link DataGridComponent} (não exportado para consumidores). */
+export interface DataGridActionsContext<T = unknown> {
+    onEditRow: (row: T) => void;
+    onRemoveRow: (row: T) => void;
+}
+export declare class DataGridActionsCellRendererComponent implements ICellRendererAngularComp {
+    params: ICellRendererParams & {
+        context?: DataGridActionsContext;
+    };
+    agInit(params: ICellRendererParams): void;
+    refresh(): boolean;
+    /** `params.context` nem sempre vem preenchido; o grid guarda o mesmo objeto em `gridOptions.context`. */
+    private get actionsContext();
+    edit(): void;
+    remove(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataGridActionsCellRendererComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataGridActionsCellRendererComponent, "app-data-grid-actions-cell-renderer", never, {}, {}, never, never, true, never>;
+}

package/app/data-display/data-grid/data-grid.component.d.ts

@@ -0,0 +1,76 @@
+import { EventEmitter, OnChanges, OnDestroy, OnInit, SimpleChanges } from '@angular/core';
+import type { ColDef, GetRowIdParams, GridReadyEvent } from 'ag-grid-community';
+import type { DataGridColumn } from '../_models/data-grid-column.model';
+import { DataGridActionsCellRendererComponent, type DataGridActionsContext } from './data-grid-actions-cell-renderer.component';
+import * as i0 from "@angular/core";
+/** Emitido quando o usuário muda de página ou tamanho de página na grade paginada. */
+export interface DataGridPaginationChangeEvent {
+    /** Índice 0-based da página atual (API ag-Grid). */
+    currentPage: number;
+    newPage: boolean;
+    newPageSize: boolean;
+}
+export declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDestroy {
+    private readonly ngZone;
+    private gridApi;
+    private paginationChangedListener?;
+    rows: T[];
+    columns: DataGridColumn<T>[];
+    pageSize: number;
+    loading: boolean;
+    /**
+     * Após remontar a grade (ex.: skeleton), volta a esta página (0-based).
+     * Só aplicado em `gridReady` e quando o valor muda com a API já disponível.
+     */
+    initialPaginationPage: number;
+    height: string | null;
+    emptyMessage: string;
+    pagination: boolean;
+    /** Se `false`, omite colunas com `type: 'actions'` (editar/remover). Por omissão `true`. */
+    showActionsColumn: boolean;
+    readonly edit: EventEmitter<T>;
+    readonly remove: EventEmitter<T>;
+    /** Reservado para evolução (seleção de linhas); não ligado na v1 para manter a UI minimal. */
+    readonly selectionChange: EventEmitter<T[]>;
+    /** Paginação interna do ag-Grid: mudança de página ou de `pageSize`. */
+    readonly paginationChanged: EventEmitter<DataGridPaginationChangeEvent>;
+    readonly frameworkComponents: {
+        dataGridActions: typeof DataGridActionsCellRendererComponent;
+    };
+    readonly paginationPageSizeChoices: number[];
+    /**
+     * O AG Grid avisa se `paginationPageSize` não está em `paginationPageSizeSelector`.
+     * Junta `pageSize` às opções base quando o consumidor usa um valor fora da lista (ex.: 8).
+     */
+    get effectivePaginationPageSizeSelector(): number[];
+    get skeletonColumnCount(): number;
+    get skeletonRowCount(): number;
+    readonly defaultColDef: ColDef<T>;
+    /**
+     * O AG Grid corre muitos callbacks fora da `NgZone`; sem `run()`, o pai com `OnPush`
+     * não volta a renderizar e editar/remover parece “morto”.
+     */
+    readonly actionsContext: DataGridActionsContext<T>;
+    agColumnDefs: ColDef<T>[];
+    ngOnInit(): void;
+    /**
+     * IDs estáveis por linha (evita `''` duplicado quando não existe `id` nos dados).
+     * Tenta `id`, depois `sku` (comum em grades de produto), senão impressão digital do objeto.
+     */
+    readonly getRowId: (params: GetRowIdParams<T>) => string;
+    /** Identificador determinístico e curto para linhas sem chave explícita. */
+    private stableRowFingerprint;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    get emptyOverlayTemplate(): string;
+    get hostHeight(): string;
+    onGridReady(ev: GridReadyEvent<T>): void;
+    private applyInitialPaginationPage;
+    /** Evita `removeEventListener` na API depois do grid destruído (ex.: `@if (loading)` remove o DOM). */
+    private detachPaginationListenerIfLive;
+    private columnsForGrid;
+    private mapColumnsToColDef;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataGridComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataGridComponent<any>, "app-data-grid", never, { "rows": { "alias": "rows"; "required": true; }; "columns": { "alias": "columns"; "required": true; }; "pageSize": { "alias": "pageSize"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "initialPaginationPage": { "alias": "initialPaginationPage"; "required": false; }; "height": { "alias": "height"; "required": false; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "showActionsColumn": { "alias": "showActionsColumn"; "required": false; }; }, { "edit": "edit"; "remove": "remove"; "selectionChange": "selectionChange"; "paginationChanged": "paginationChanged"; }, never, never, true, never>;
+    static ngAcceptInputType_initialPaginationPage: unknown;
+}

package/app/data-display/data-list/data-list.component.d.ts

@@ -0,0 +1,18 @@
+import * as i0 from "@angular/core";
+/**
+ * Lista vertical de registros com estados de loading e vazio padronizados.
+ * O conteúdo de cada linha deve usar `app-list-item` (ou composição equivalente).
+ */
+export declare class DataListComponent {
+    loading: boolean;
+    empty: boolean;
+    emptyTitle: string;
+    emptyDescription: string;
+    emptyIconClass: string;
+    /** Linhas de skeleton em modo loading. */
+    skeletonRows: number;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataListComponent, "app-data-list", never, { "loading": { "alias": "loading"; "required": false; }; "empty": { "alias": "empty"; "required": false; }; "emptyTitle": { "alias": "emptyTitle"; "required": false; }; "emptyDescription": { "alias": "emptyDescription"; "required": false; }; "emptyIconClass": { "alias": "emptyIconClass"; "required": false; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_loading: unknown;
+    static ngAcceptInputType_empty: unknown;
+}

package/app/data-display/data-toolbar/data-toolbar.component.d.ts

@@ -0,0 +1,6 @@
+import * as i0 from "@angular/core";
+/** Barra de consulta: pesquisa, filtros, ações e contador (slots `toolbar-start` / `toolbar-end`). */
+export declare class DataToolbarComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataToolbarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataToolbarComponent, "app-data-toolbar", never, {}, {}, never, ["[toolbar-start]", "[toolbar-end]"], true, never>;
+}

package/app/data-display/details-field/details-field.component.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+/**
+ * Uma linha chave → valor para usar **dentro** de `app-details-view` (projeção).
+ * O host usa `display: contents` para manter `<dl>` > `<dt>`/`<dd>` válidos.
+ */
+export declare class DetailsFieldComponent {
+    label: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DetailsFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DetailsFieldComponent, "app-details-field", never, { "label": { "alias": "label"; "required": true; }; }, {}, never, ["*"], true, never>;
+}

package/app/data-display/details-view/details-view.component.d.ts

@@ -0,0 +1,26 @@
+import type { DetailsViewItem } from '../_models/data-display.models';
+import * as i0 from "@angular/core";
+/**
+ * Lista de descrição (chave → valor) para detalhes, drawer ou resumo.
+ * Modo **lista**: `[items]`; modo **composto**: projectar `app-details-field` no conteúdo.
+ */
+export declare class DetailsViewComponent {
+    items: readonly DetailsViewItem[];
+    /**
+     * Se `true`, ignora `items` e renderiza só `<ng-content />` dentro de um `<dl>`
+     * (usar com `app-details-field` para valores ricos).
+     */
+    projectionOnly: boolean;
+    /** `2` ativa grade em dois tempos em telas largas. */
+    columns: 1 | 2;
+    loading: boolean;
+    /** Texto quando `items` está vazio, sem `loading` e sem `projectionOnly`. */
+    emptyMessage: string;
+    readonly emDash = "\u2014";
+    /** Linhas de skeleton em modo loading. */
+    readonly skeletonPairs: number[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<DetailsViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DetailsViewComponent, "app-details-view", never, { "items": { "alias": "items"; "required": false; }; "projectionOnly": { "alias": "projectionOnly"; "required": false; }; "columns": { "alias": "columns"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_projectionOnly: unknown;
+    static ngAcceptInputType_loading: unknown;
+}

package/app/data-display/empty-state/empty-state-overlay.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * HTML injetado no AG Grid (`overlayNoRowsTemplate`) — manter alinhado ao markup de {@link EmptyStateComponent}.
+ */
+export declare function escapeHtml(text: string): string;
+export declare function buildEmptyStateOverlayHtml(message: string): string;

package/app/data-display/empty-state/empty-state.component.d.ts

@@ -0,0 +1,13 @@
+import * as i0 from "@angular/core";
+export declare class EmptyStateComponent {
+    message: string;
+    description?: string;
+    /** Classe Font Awesome do ícone (ex.: `fa-solid fa-inbox`). */
+    iconClass: string;
+    variant: 'default';
+    /** Padding reduzido (ex.: células de tabela, listas densas). */
+    embed: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EmptyStateComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<EmptyStateComponent, "app-empty-state", never, { "message": { "alias": "message"; "required": true; }; "description": { "alias": "description"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "embed": { "alias": "embed"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_embed: unknown;
+}

package/app/data-display/index.d.ts

@@ -0,0 +1,20 @@
+export { DataGridComponent, type DataGridPaginationChangeEvent, } from './data-grid/data-grid.component';
+export { DataToolbarComponent } from './data-toolbar/data-toolbar.component';
+export { AdaptiveDataViewComponent, ADAPTIVE_DATA_VIEW_MOBILE_QUERY, type AdaptiveDataViewMode, } from './adaptive-data-view/adaptive-data-view.component';
+export { DataCardComponent } from './data-card/data-card.component';
+export { CardListComponent, type CardListDataMode, } from './card-list/card-list.component';
+export { EmptyStateComponent } from './empty-state/empty-state.component';
+export { buildEmptyStateOverlayHtml, escapeHtml, } from './empty-state/empty-state-overlay.util';
+export type { DataGridColumn, CardItemView, CardListMapFn } from './_models';
+export { StatusBadgeComponent } from './status-badge/status-badge.component';
+export { DetailsViewComponent } from './details-view/details-view.component';
+export { DetailsFieldComponent } from './details-field/details-field.component';
+export { StatCardComponent } from './stat-card/stat-card.component';
+export { ListItemComponent } from './list-item/list-item.component';
+export { DataListComponent } from './data-list/data-list.component';
+export { DashboardSectionComponent } from './dashboard-section/dashboard-section.component';
+export { TableToolbarComponent } from './table-toolbar/table-toolbar.component';
+export { TableEmptyStateComponent } from './table-empty-state/table-empty-state.component';
+export type { StatusBadgeVariant, StatusBadgeSize, DetailsViewItem, StatCardDeltaTone, } from './_models/data-display.models';
+/** Blocos de skeleton reutilizáveis (ver `src/app/loading/skeleton-loading`). */
+export { SkeletonBlockComponent, SkeletonTextComponent, SkeletonListComponent, SkeletonCardComponent, SkeletonTableComponent, SkeletonFieldShellComponent, type SkeletonFieldShellVariant, } from '../loading/skeleton-loading';

package/app/data-display/list-item/list-item.component.d.ts

@@ -0,0 +1,22 @@
+import { EventEmitter } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Linha base para listas (`app-data-list`): texto, área de estado e ações projetadas.
+ * Estrutura preparada para selecção futura (`selectable` apenas aplica classe visual).
+ */
+export declare class ListItemComponent {
+    title: string;
+    subtitle: string;
+    clickable: boolean;
+    /**
+     * Reserva visual para selecção futura (sem lógica de modelo).
+     */
+    selectable: boolean;
+    readonly itemActivate: EventEmitter<void>;
+    onKeydown(ev: KeyboardEvent): void;
+    onClick(ev: MouseEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ListItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ListItemComponent, "app-list-item", never, { "title": { "alias": "title"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; "clickable": { "alias": "clickable"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; }, { "itemActivate": "itemActivate"; }, never, ["*", "[list-item-status]", "[list-item-actions]"], true, never>;
+    static ngAcceptInputType_clickable: unknown;
+    static ngAcceptInputType_selectable: unknown;
+}

package/app/data-display/stat-card/stat-card.component.d.ts

@@ -0,0 +1,23 @@
+import { EventEmitter } from '@angular/core';
+import type { StatCardDeltaTone } from '../_models/data-display.models';
+import * as i0 from "@angular/core";
+/**
+ * Cartão de métrica (KPI) com a **mesma superfície** que `app-data-card` (mixin SCSS `data-card-shell`).
+ * Não usa o selector `app-data-card` (esse componente é para linhas de lista com ações).
+ */
+export declare class StatCardComponent {
+    title: string;
+    value: string;
+    description: string;
+    icon: string;
+    /** Texto curto (ex.: +12% ou −3%). */
+    delta: string;
+    deltaTone: StatCardDeltaTone;
+    clickable: boolean;
+    readonly cardActivate: EventEmitter<void>;
+    onActivate(ev: Event): void;
+    onKeydown(ev: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StatCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<StatCardComponent, "app-stat-card", never, { "title": { "alias": "title"; "required": true; }; "value": { "alias": "value"; "required": true; }; "description": { "alias": "description"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "delta": { "alias": "delta"; "required": false; }; "deltaTone": { "alias": "deltaTone"; "required": false; }; "clickable": { "alias": "clickable"; "required": false; }; }, { "cardActivate": "cardActivate"; }, never, never, true, never>;
+    static ngAcceptInputType_clickable: unknown;
+}

package/app/data-display/status-badge/status-badge.component.d.ts

@@ -0,0 +1,17 @@
+import type { StatusBadgeSize, StatusBadgeVariant } from '../_models/data-display.models';
+import * as i0 from "@angular/core";
+/**
+ * Etiqueta de estado (Ativo, Pendente, etc.) com fundo suave e cor semântica.
+ */
+export declare class StatusBadgeComponent {
+    label: string;
+    variant: StatusBadgeVariant;
+    /** Classes Font Awesome (ex.: `fa-solid fa-check`). */
+    icon: string;
+    size: StatusBadgeSize;
+    bordered: boolean;
+    readonly variantClassMap: Record<StatusBadgeVariant, string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<StatusBadgeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<StatusBadgeComponent, "app-status-badge", never, { "label": { "alias": "label"; "required": true; }; "variant": { "alias": "variant"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "size": { "alias": "size"; "required": false; }; "bordered": { "alias": "bordered"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_bordered: unknown;
+}

package/app/data-display/table-empty-state/table-empty-state.component.d.ts

@@ -0,0 +1,14 @@
+import * as i0 from "@angular/core";
+/**
+ * Estado vazio para tabelas ou listas densas — reutiliza {@link EmptyStateComponent}
+ * e permite uma ação opcional (ex.: limpar filtros).
+ */
+export declare class TableEmptyStateComponent {
+    title: string;
+    description: string;
+    iconClass: string;
+    embed: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableEmptyStateComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TableEmptyStateComponent, "app-table-empty-state", never, { "title": { "alias": "title"; "required": true; }; "description": { "alias": "description"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; "embed": { "alias": "embed"; "required": false; }; }, {}, never, ["[tableEmptyAction]"], true, never>;
+    static ngAcceptInputType_embed: unknown;
+}

package/app/data-display/table-toolbar/table-toolbar.component.d.ts

@@ -0,0 +1,11 @@
+import * as i0 from "@angular/core";
+/**
+ * Barra auxiliar para tabelas / grades: envolve {@link DataToolbarComponent}
+ * com áreas para pesquisa, contagem e ações.
+ */
+export declare class TableToolbarComponent {
+    /** Ex.: `128 resultados` ou `Nenhum resultado`. */
+    resultCountLabel: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableToolbarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TableToolbarComponent, "app-table-toolbar", never, { "resultCountLabel": { "alias": "resultCountLabel"; "required": false; }; }, {}, never, ["[tableToolbarSearch]", "[tableToolbarFilters]", "[tableToolbarActions]"], true, never>;
+}

package/app/dialogs/_models/lib-dialog-size.model.d.ts

@@ -0,0 +1,6 @@
+/** Largura máxima do painel `app-dialog` (conteúdo responsivo). */
+export declare enum LibDialogSize {
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg"
+}

package/app/dialogs/_utils/lib-dialog-panel-classes.d.ts

@@ -0,0 +1,3 @@
+import { AppThemeService } from '../../theme';
+/** Classes aplicadas ao painel CDK Dialog + tema da app. */
+export declare function libDialogPanelClasses(theme: AppThemeService, extra?: string | string[]): string[];

package/app/dialogs/app-dialog/app-dialog.component.d.ts

@@ -0,0 +1,52 @@
+import { EventEmitter, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { LibDialogSize } from '../_models/lib-dialog-size.model';
+import * as i0 from "@angular/core";
+/**
+ * Diálogo modal declarativo com `[(open)]`, projeção de corpo e rodapé opcional (`[appDialogFooter]`).
+ * Bloqueio de scroll alinhado ao CDK (`cdk-global-scrollblock`), como no `ConfirmDialogService`.
+ */
+export declare class AppDialogComponent implements OnChanges, OnDestroy {
+    private readonly hostEl;
+    open: boolean;
+    readonly openChange: EventEmitter<boolean>;
+    title: string;
+    /** Texto de apoio abaixo do título (opcional); liga `aria-describedby` no painel. */
+    description: string;
+    /**
+     * Rótulo acessível quando não há `title` (evita diálogo sem nome).
+     * Ignorado se `title` tiver texto.
+     */
+    ariaLabel: string;
+    size: LibDialogSize;
+    /**
+     * Quando `false`, a tecla Escape e o clique no backdrop não fecham o diálogo
+     * (botão ✕, `[(open)]` e `requestClose()` continuam disponíveis).
+     * Omisso: `true`.
+     */
+    allowOverlayDismiss: boolean;
+    showCloseButton: boolean;
+    readonly LibDialogSize: typeof LibDialogSize;
+    readonly titleId: string;
+    readonly descriptionId: string;
+    /**
+     * O modal fica no fim de `document.body` enquanto aberto, para o `backdrop-filter`
+     * não ficar «preso» a ancestrais com `overflow: auto` (ex.: `app-shell__content`).
+     */
+    private bodyRestoreParent;
+    private bodyRestoreNext;
+    private previousActive;
+    private scrollLock;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    private attachHostToBody;
+    private detachHostFromBody;
+    onDocumentKeydown(ev: KeyboardEvent): void;
+    onBackdropClick(): void;
+    requestClose(): void;
+    private restoreFocus;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AppDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AppDialogComponent, "app-dialog", never, { "open": { "alias": "open"; "required": false; }; "title": { "alias": "title"; "required": false; }; "description": { "alias": "description"; "required": false; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; }; "size": { "alias": "size"; "required": false; }; "allowOverlayDismiss": { "alias": "allowOverlayDismiss"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; }, { "openChange": "openChange"; }, never, ["*", "[appDialogFooter]"], true, never>;
+    static ngAcceptInputType_open: unknown;
+    static ngAcceptInputType_allowOverlayDismiss: unknown;
+    static ngAcceptInputType_showCloseButton: unknown;
+}

package/app/dialogs/app-dialog/dialog-footer.directive.d.ts

@@ -0,0 +1,6 @@
+import * as i0 from "@angular/core";
+/** Marca o conteúdo projectado no rodapé de `app-dialog`. */
+export declare class DialogFooterDirective {
+    static ɵfac: i0.ɵɵFactoryDeclaration<DialogFooterDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DialogFooterDirective, "[appDialogFooter]", never, {}, {}, never, never, true, never>;
+}

package/app/dialogs/confirm-dialog/confirm-dialog-data.model.d.ts

@@ -0,0 +1,13 @@
+export type ConfirmDialogVariant = 'default' | 'danger';
+export interface ConfirmDialogData {
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    variant?: ConfirmDialogVariant;
+    /**
+     * Se `true`, Escape e clique fora **não** fecham o diálogo (apenas botões do rodapé).
+     * Omisso: `false` — permite dispensar com Esc ou backdrop (emite `undefined` no `closed`).
+     */
+    blockOverlayDismiss?: boolean;
+}

package/app/dialogs/confirm-dialog/confirm-dialog.component.d.ts

@@ -0,0 +1,20 @@
+import { AfterViewInit } from '@angular/core';
+import { DialogRef } from '@angular/cdk/dialog';
+import { BaseButtonType, BaseButtonVariant } from '../../buttons';
+import type { ConfirmDialogData } from './confirm-dialog-data.model';
+import * as i0 from "@angular/core";
+export declare class ConfirmDialogComponent implements AfterViewInit {
+    readonly ref: DialogRef<boolean, ConfirmDialogComponent>;
+    readonly data: ConfirmDialogData;
+    readonly BaseButtonType: typeof BaseButtonType;
+    readonly BaseButtonVariant: typeof BaseButtonVariant;
+    readonly titleId: string;
+    readonly descId: string;
+    private cancelBtn?;
+    private static seq;
+    ngAfterViewInit(): void;
+    onConfirm(): void;
+    onCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConfirmDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfirmDialogComponent, "app-confirm-dialog", never, {}, {}, never, never, true, never>;
+}

package/app/dialogs/confirm-dialog/confirm-dialog.service.d.ts

@@ -0,0 +1,17 @@
+import { Observable } from 'rxjs';
+import type { ConfirmDialogData } from './confirm-dialog-data.model';
+import * as i0 from "@angular/core";
+export declare class ConfirmDialogService {
+    private readonly dialog;
+    private readonly theme;
+    /**
+     * Abre o diálogo de confirmação (CDK Dialog + `ConfirmDialogComponent`).
+     * Emite `true` se confirmar, `false` se cancelar, `undefined` se fechar sem resultado (Esc/backdrop, quando permitido).
+     * Por defeito permite dispensar com Esc e clique fora; use `data.blockOverlayDismiss` para exigir só botões.
+     */
+    open(data: ConfirmDialogData): Observable<boolean | undefined>;
+    /** Confirmação como Promise (adequado a `async`/`await`). */
+    confirm(data: ConfirmDialogData): Promise<boolean>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ConfirmDialogService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ConfirmDialogService>;
+}

package/app/dialogs/index.d.ts

@@ -0,0 +1,13 @@
+export { AppDialogComponent } from './app-dialog/app-dialog.component';
+export { DialogFooterDirective } from './app-dialog/dialog-footer.directive';
+export { LibDialogSize } from './_models/lib-dialog-size.model';
+export { ConfirmDialogComponent } from './confirm-dialog/confirm-dialog.component';
+export { ConfirmDialogService } from './confirm-dialog/confirm-dialog.service';
+export type { ConfirmDialogData, ConfirmDialogVariant, } from './confirm-dialog/confirm-dialog-data.model';
+export { libDialogPanelClasses } from './_utils/lib-dialog-panel-classes';
+export { ToastService } from './toast/toast.service';
+export { ToastHostComponent } from './toast/toast-host.component';
+export type { ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, } from './toast/toast.models';
+export { LoadingDialogComponent } from './loading-dialog/loading-dialog.component';
+export { LoadingDialogService } from './loading-dialog/loading-dialog.service';
+export type { LoadingDialogData } from './loading-dialog/loading-dialog-data.model';

package/app/dialogs/loading-dialog/loading-dialog-data.model.d.ts

@@ -0,0 +1,7 @@
+export interface LoadingDialogData {
+    /**
+     * Texto sob o indicador de progresso.
+     * Omisso: mensagem por defeito da lib (`A carregar…`).
+     */
+    message?: string;
+}

package/app/dialogs/loading-dialog/loading-dialog.component.d.ts

@@ -0,0 +1,9 @@
+import * as i0 from "@angular/core";
+export declare class LoadingDialogComponent {
+    private readonly data;
+    readonly titleId: string;
+    readonly message: string;
+    private static seq;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LoadingDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LoadingDialogComponent, "app-loading-dialog", never, {}, {}, never, never, true, never>;
+}

package/app/dialogs/loading-dialog/loading-dialog.service.d.ts

@@ -0,0 +1,15 @@
+import { DialogRef } from '@angular/cdk/dialog';
+import { LoadingDialogComponent } from './loading-dialog.component';
+import type { LoadingDialogData } from './loading-dialog-data.model';
+import * as i0 from "@angular/core";
+export declare class LoadingDialogService {
+    private readonly dialog;
+    private readonly theme;
+    /**
+     * Abre o diálogo de carregamento.
+     * `disableClose: true` — não fecha com Escape nem clique fora; use `ref.close()` quando terminar.
+     */
+    open(data?: LoadingDialogData): DialogRef<void, LoadingDialogComponent>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LoadingDialogService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LoadingDialogService>;
+}

package/app/dialogs/toast/toast-host.component.d.ts

@@ -0,0 +1,13 @@
+import { AppThemeService } from '../../theme';
+import { ToastService } from './toast.service';
+import * as i0 from "@angular/core";
+export declare class ToastHostComponent {
+    readonly toastService: ToastService;
+    readonly theme: AppThemeService;
+    readonly topToasts: import("@angular/core").Signal<import("structra-ui").ToastInstance[]>;
+    readonly bottomToasts: import("@angular/core").Signal<import("structra-ui").ToastInstance[]>;
+    dismiss(id: string): void;
+    action(id: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ToastHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ToastHostComponent, "app-toast-host", never, {}, {}, never, never, true, never>;
+}