structra-ui 0.1.4 → 0.1.6

package/app/form-layout/form-group/form-root-invalid-ui-refresh.util.d.ts

@@ -0,0 +1,8 @@
+import { ChangeDetectorRef, DestroyRef } from '@angular/core';
+import { AbstractControl } from '@angular/forms';
+/**
+ * Mantém ícones / getters que dependem do estado reactivo actualizados com OnPush.
+ * `markAllAsTouched()` pode não emitir `valueChanges` no raiz; o `submit` do `<form>` (após um tick)
+ * cobre o caso de submissão — alinhado a {@link FormGroupComponent} `setupFormPathInvalidTracking`.
+ */
+export declare function subscribeMarkForCheckOnInvalidUiRefresh(rootCtrl: AbstractControl, hostElement: HTMLElement, cdr: ChangeDetectorRef, destroyRef: DestroyRef): void;

package/app/form-layout/form-row/form-row.component.d.ts

@@ -0,0 +1,14 @@
+import { FormRowAlign, FormRowGap, FormRowJustify } from '../_models/form-layout.model';
+import * as i0 from "@angular/core";
+export declare class FormRowComponent {
+    gap: FormRowGap;
+    align: FormRowAlign;
+    justify: FormRowJustify;
+    wrap: boolean;
+    stackOnMobile: boolean;
+    get hostClass(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "app-form-row", never, { "gap": { "alias": "gap"; "required": false; }; "align": { "alias": "align"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; "wrap": { "alias": "wrap"; "required": false; }; "stackOnMobile": { "alias": "stackOnMobile"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_wrap: unknown;
+    static ngAcceptInputType_stackOnMobile: unknown;
+}

package/app/form-layout/form-section/form-section.component.d.ts

@@ -0,0 +1,13 @@
+import * as i0 from "@angular/core";
+export declare class FormSectionComponent {
+    titulo: string;
+    subtitulo: string;
+    dense: boolean;
+    withDivider: boolean;
+    get hostClass(): string;
+    get showHeader(): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormSectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormSectionComponent, "app-form-section", never, { "titulo": { "alias": "titulo"; "required": true; }; "subtitulo": { "alias": "subtitulo"; "required": false; }; "dense": { "alias": "dense"; "required": false; }; "withDivider": { "alias": "withDivider"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_dense: unknown;
+    static ngAcceptInputType_withDivider: unknown;
+}

package/app/form-layout/form-tab/form-tab.component.d.ts

@@ -0,0 +1,32 @@
+import { OnChanges, SimpleChanges } from '@angular/core';
+import * as i0 from "@angular/core";
+export declare class FormTabComponent implements OnChanges {
+    /** Sem `host: true`: o pai está no injetor normal (filho de `app-form-tabs`). */
+    private readonly tabs;
+    private readonly cdr;
+    key: string;
+    /**
+     * Texto do separador na lista de abas.
+     * Não usar o nome `title`: no host `<app-form-tab>` o atributo HTML `title` gera tooltip nativo
+     * sobre o painel (ex.: ao passar o mouse sobre o conteúdo).
+     */
+    tabTitle: string;
+    disabled: boolean;
+    warning: boolean;
+    ngOnChanges(changes: SimpleChanges): void;
+    get isActive(): boolean;
+    /**
+     * Com `[keepAlive]="false"` no `app-form-tabs` pai, painéis inactivos saem do DOM (menos
+     * custo acumulado em ecrãs com muitas abas ou conteúdo pesado).
+     */
+    get detachInactivePanel(): boolean;
+    /** Chamado por {@link FormTabsComponent} quando a aba ativa muda (OnPush). */
+    refreshActiveState(): void;
+    get hostClass(): string;
+    panelId(): string;
+    labelledById(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormTabComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormTabComponent, "app-form-tab", never, { "key": { "alias": "key"; "required": true; }; "tabTitle": { "alias": "tabTitle"; "required": true; }; "disabled": { "alias": "disabled"; "required": false; }; "warning": { "alias": "warning"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_warning: unknown;
+}

package/app/form-layout/form-tabs/form-tabs.component.d.ts

@@ -0,0 +1,44 @@
+import { AfterContentInit, EventEmitter, QueryList } from '@angular/core';
+import { FormTabComponent } from '../form-tab/form-tab.component';
+import type { FormTabsVariant } from '../_models/form-tabs.model';
+import * as i0 from "@angular/core";
+export declare class FormTabsComponent implements AfterContentInit {
+    private static nextUid;
+    private readonly cdr;
+    readonly uid: string;
+    tabQuery: QueryList<FormTabComponent>;
+    private _activeKey;
+    set activeKey(v: string | undefined | null);
+    get activeKey(): string;
+    readonly activeKeyChange: EventEmitter<string>;
+    /**
+     * `true` (padrão): todos os painéis permanecem no DOM; inactivos usam `[hidden]` (útil para
+     * preservar estado de UI puramente client-side dentro da aba).
+     * `false`: só o painel da aba activa é montado — menos DOM/CD ao alternar; o modelo reactivo
+     * (`FormGroup` no ascendente) mantém-se; ao voltar à aba, os campos remontam e religam-se.
+     */
+    keepAlive: boolean;
+    stretch: boolean;
+    variant: FormTabsVariant;
+    /** Rótulo acessível para a lista de separadores (ex.: “Seções do formulário”). */
+    tablistAriaLabel: string;
+    ngAfterContentInit(): void;
+    get tabs(): FormTabComponent[];
+    get hostClass(): string;
+    baseId(): string;
+    headerIdFor(key: string): string;
+    panelIdFor(key: string): string;
+    selectTab(key: string): void;
+    private refreshTabPanels;
+    /**
+     * Chamado por {@link FormTabComponent} quando inputs que afetam o tablist (ex.: `warning`, `tabTitle`)
+     * mudam — com OnPush o cabeçalho não voltava a desenhar só com alterações nos filhos projetados.
+     */
+    onTabHeaderStateChanged(): void;
+    isSelected(key: string): boolean;
+    private syncInitialActiveKey;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormTabsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormTabsComponent, "app-form-tabs", never, { "activeKey": { "alias": "activeKey"; "required": false; }; "keepAlive": { "alias": "keepAlive"; "required": false; }; "stretch": { "alias": "stretch"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "tablistAriaLabel": { "alias": "tablistAriaLabel"; "required": false; }; }, { "activeKeyChange": "activeKeyChange"; }, ["tabQuery"], ["app-form-tab"], true, never>;
+    static ngAcceptInputType_keepAlive: unknown;
+    static ngAcceptInputType_stretch: unknown;
+}

package/app/form-layout/index.d.ts

@@ -0,0 +1,14 @@
+export { LayoutStackComponent } from './layout-stack/layout-stack.component';
+export { FormActionsComponent } from './form-actions/form-actions.component';
+export { FormColComponent } from './form-col/form-col.component';
+export { FormGroupComponent } from './form-group/form-group.component';
+export { FormRowComponent } from './form-row/form-row.component';
+export { FormSectionComponent } from './form-section/form-section.component';
+export { ValidationSummaryComponent } from './validation-summary/validation-summary.component';
+export { FormTabsComponent } from './form-tabs/form-tabs.component';
+export { FormTabComponent } from './form-tab/form-tab.component';
+export { LayoutStackAlign, FormActionsAlign, FormGroupVariant, FormRowAlign, FormRowGap, FormRowJustify, } from './_models';
+export type { ValidationSummaryItem, ValidationSummaryVariant, FormTabsVariant, } from './_models';
+/** Utilitários de formulário reactivo (ícones de grupo, demos avançadas). API estável; não expõe estrutura interna de pastas. */
+export { subscribeMarkForCheckOnInvalidUiRefresh } from './form-group/form-root-invalid-ui-refresh.util';
+export { resolveControlAtPath, sectionHasVisibleInvalid, subtreeHasVisibleInvalid, } from './form-group/form-path.utils';

package/app/form-layout/layout-stack/layout-stack.component.d.ts

@@ -0,0 +1,25 @@
+import { LayoutStackAlign } from '../_models/form-layout.model';
+import * as i0 from "@angular/core";
+/** Faixa flexível com projeção de conteúdo (ex.: botões alinhados). */
+export declare class LayoutStackComponent {
+    /** Distribuição horizontal dos filhos (`justify-content`). */
+    align: LayoutStackAlign;
+    /**
+     * Em ecrãs estreitos, aplica ajustes leves (ex.: `gap`) mantendo fila + `wrap`.
+     * Por defeito `true`; não é necessário passar no template na maioria dos casos.
+     */
+    stackOnMobile: boolean;
+    /** Linha separadora acima da faixa. Nome explícito para evitar colisão com o esquema DOM em templates aninhados. */
+    stackDivider: boolean;
+    /**
+     * Quando `true` (por defeito), os filhos repartem a largura da faixa (ex.: um botão a 100%;
+     * vários com `flex` igual). Use `false` para faixas compactas (largura intrínseca).
+     */
+    stackFill: boolean;
+    get hostClass(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutStackComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LayoutStackComponent, "app-layout-stack", never, { "align": { "alias": "align"; "required": false; }; "stackOnMobile": { "alias": "stackOnMobile"; "required": false; }; "stackDivider": { "alias": "stackDivider"; "required": false; }; "stackFill": { "alias": "stackFill"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_stackOnMobile: unknown;
+    static ngAcceptInputType_stackDivider: unknown;
+    static ngAcceptInputType_stackFill: unknown;
+}

package/app/form-layout/validation-summary/validation-summary.component.d.ts

@@ -0,0 +1,105 @@
+import { EventEmitter, OnChanges, SimpleChanges } from '@angular/core';
+import type { ValidationSummaryItem, ValidationSummaryVariant } from '../_models/validation-summary.model';
+import * as i0 from "@angular/core";
+export declare class ValidationSummaryComponent implements OnChanges {
+    private static nextTitleUid;
+    private static nextListRegionUid;
+    /** Troca de aba (`beforeItemActivate`) + `queueMicrotask` no `app-form-tabs` — o alvo pode ficar em `[hidden]` até o próximo CD. */
+    private readonly navigateToFieldMaxAttempts;
+    private readonly appRef;
+    private readonly cdr;
+    private readonly injector;
+    private readonly hostRef;
+    /** `id` único para `aria-labelledby` quando há vários resumos na página. */
+    readonly titleElementId: string;
+    /** `id` da região da lista (acessibilidade do botão recolher / expandir). */
+    readonly listRegionId: string;
+    /** Lista simples (retrocompatível). Ignorada se {@link items} tiver entradas. */
+    messages: string[] | null;
+    /** Lista rica com `fieldId` opcional para navegação até o controle. */
+    items: ValidationSummaryItem[] | null;
+    /**
+     * Título do cabeçalho (`title="…"` no template).
+     * Não usar a propriedade `title` na classe: colide com `HTMLElement.title` no host e o
+     * browser pode desenhar tooltip nativo / comportamentos estranhos.
+     */
+    summaryHeading: string;
+    visible: boolean;
+    /**
+     * `false` (padrão): fluxo em documento (ex.: no topo do formulário) — o consumidor pode fazer scroll até o painel.
+     * `true`: painel `position: fixed` no topo do viewport, com fade-in **sem** reservar espaço no formulário
+     * nem alterar o scroll da página (útil em formulários muito longos).
+     */
+    pinned: boolean;
+    variant: ValidationSummaryVariant;
+    compact: boolean;
+    /**
+     * Altura máxima do painel da lista (ex.: `12rem`, `min(40vh, 14rem)`).
+     * Quando definido, a lista obtém scroll vertical interno.
+     */
+    panelMaxHeight: string | null;
+    /** Comportamento de scroll ao centrar o alvo na tela. */
+    scrollBehavior: ScrollBehavior;
+    /**
+     * Chamado antes de localizar o elemento por `fieldId` (ex.: ativar a aba onde está o campo).
+     * Mantém o contrato do resumo como fonte única de scroll/foco em `navigateToFieldId`.
+     */
+    beforeItemActivate?: (item: ValidationSummaryItem) => void;
+    /** Mostra botão que apenas fecha o painel (não altera validação nem o formulário). */
+    showCloseButton: boolean;
+    /**
+     * Mostra o botão com setas (recolher / expandir) ao lado do título para esconder só a lista
+     * e poupar espaço vertical sem fechar o painel.
+     */
+    showListCollapseToggle: boolean;
+    closeButtonLabel: string;
+    /** Texto da dica nativa (`title`) nas linhas com destino ao campo. */
+    fieldNavigateHint: string;
+    readonly panelClose: EventEmitter<void>;
+    /** Com `pinned`: breve fade-in após o painel passar a visível (sem deslocar o layout). */
+    pinnedOpen: boolean;
+    /** `true`: lista de erros visível; `false`: só cabeçalho + botões (menos altura). */
+    panelBodyExpanded: boolean;
+    private wasShown;
+    get hostClass(): string;
+    ngOnChanges(_changes: SimpleChanges): void;
+    get hostHidden(): true | null;
+    get resolvedItems(): ValidationSummaryItem[];
+    get isShown(): boolean;
+    onCloseClick(): void;
+    toggleListBody(): void;
+    /**
+     * Chave estável para `@for` — `track $index` reutiliza mal nós quando a lista muda ao vivo
+     * e o getter `resolvedItems` devolve novas referências a cada CD.
+     */
+    itemTrackKey(row: ValidationSummaryItem, index: number): string;
+    /**
+     * Clique na linha com destino: primeiro alinha a linha no `list-wrap` com scroll
+     * (itens parcialmente visíveis passam a ficar totalmente visíveis), depois navega.
+     */
+    onSummaryLinkActivate(ev: Event, item: ValidationSummaryItem): void;
+    /** Navegação até o controle com `fieldId` (chamado após {@link onSummaryLinkActivate}). */
+    onItemActivate(item: ValidationSummaryItem): void;
+    private navigateToFieldId;
+    /** Após `tick()`, garante um frame de pintura antes de scroll/foco (evita foco em ramo ainda oculto). */
+    private scheduleScrollAndFocusAfterDomFlush;
+    private isInsideCollapsedFormGroupBody;
+    private scrollAndFocusFieldById;
+    /**
+     * Dispara `ui-request-expand` em cada `app-form-group` colapsado do formulário que contém este resumo,
+     * para montar campos com `destroyOnCollapse` antes de `getElementById(fieldId)`.
+     * Ordem do DOM (pais antes dos filhos) alinha a expansão de grupos aninhados.
+     */
+    private expandCollapsedFormGroupsInNearestForm;
+    /** Expande do mais externo para o mais interno para o conteúdo ficar visível. */
+    private expandCollapsedFormGroupAncestors;
+    private resolveFocusable;
+    private isFocusableElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ValidationSummaryComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ValidationSummaryComponent, "app-validation-summary", never, { "messages": { "alias": "messages"; "required": false; }; "items": { "alias": "items"; "required": false; }; "summaryHeading": { "alias": "title"; "required": false; }; "visible": { "alias": "visible"; "required": false; }; "pinned": { "alias": "pinned"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "compact": { "alias": "compact"; "required": false; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; }; "scrollBehavior": { "alias": "scrollBehavior"; "required": false; }; "beforeItemActivate": { "alias": "beforeItemActivate"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; "showListCollapseToggle": { "alias": "showListCollapseToggle"; "required": false; }; "closeButtonLabel": { "alias": "closeButtonLabel"; "required": false; }; "fieldNavigateHint": { "alias": "fieldNavigateHint"; "required": false; }; }, { "panelClose": "panelClose"; }, never, never, true, never>;
+    static ngAcceptInputType_visible: unknown;
+    static ngAcceptInputType_pinned: unknown;
+    static ngAcceptInputType_compact: unknown;
+    static ngAcceptInputType_showCloseButton: unknown;
+    static ngAcceptInputType_showListCollapseToggle: unknown;
+}

package/app/loading/skeleton-loading/index.d.ts

@@ -0,0 +1,6 @@
+export { SkeletonBlockComponent } from './skeleton-block/skeleton-block.component';
+export { SkeletonTextComponent } from './skeleton-text/skeleton-text.component';
+export { SkeletonListComponent } from './skeleton-list/skeleton-list.component';
+export { SkeletonCardComponent } from './skeleton-card/skeleton-card.component';
+export { SkeletonTableComponent } from './skeleton-table/skeleton-table.component';
+export { SkeletonFieldShellComponent, type SkeletonFieldShellVariant, } from './skeleton-field-shell/skeleton-field-shell.component';

package/app/loading/skeleton-loading/skeleton-block/skeleton-block.component.d.ts

@@ -0,0 +1,15 @@
+import * as i0 from "@angular/core";
+/** Bloco genérico de skeleton (linhas, caixas, células). */
+export declare class SkeletonBlockComponent {
+    /** Largura CSS (ex.: `100%`, `6rem`, `40%`). */
+    width: string;
+    /** Altura CSS. */
+    height: string;
+    /** Raio de canto. */
+    radius: string;
+    animate: boolean;
+    get hostClass(): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonBlockComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonBlockComponent, "app-skeleton-block", never, { "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "radius": { "alias": "radius"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_animate: unknown;
+}

package/app/loading/skeleton-loading/skeleton-card/skeleton-card.component.d.ts

@@ -0,0 +1,10 @@
+import * as i0 from "@angular/core";
+/** Placeholder de cartão (avatar + texto + ações). */
+export declare class SkeletonCardComponent {
+    showActions: boolean;
+    animate: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonCardComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonCardComponent, "app-skeleton-card", never, { "showActions": { "alias": "showActions"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_showActions: unknown;
+    static ngAcceptInputType_animate: unknown;
+}

package/app/loading/skeleton-loading/skeleton-field-shell/skeleton-field-shell.component.d.ts

@@ -0,0 +1,21 @@
+import * as i0 from "@angular/core";
+/** Mantido por compatibilidade; o layout do skeleton é único para todos os campos. */
+export type SkeletonFieldShellVariant = 'text' | 'select';
+/**
+ * Placeholder de campo: barra de valor e, opcionalmente, quadrado à esquerda quando não há
+ * ícone Font Awesome na coluna de prefixo do `app-base-field`.
+ */
+export declare class SkeletonFieldShellComponent {
+    /** @deprecated Ignorado: todos os campos usam o mesmo layout. */
+    variant: SkeletonFieldShellVariant;
+    animate: boolean;
+    /**
+     * Quando `false`, não renderiza o quadrado à esquerda (o `app-base-field` já mostra o ícone
+     * de prefixo inerte na coluna correcta durante `loading`).
+     */
+    showLeadingIcon: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonFieldShellComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonFieldShellComponent, "app-skeleton-field-shell", never, { "variant": { "alias": "variant"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; "showLeadingIcon": { "alias": "showLeadingIcon"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_animate: unknown;
+    static ngAcceptInputType_showLeadingIcon: unknown;
+}

package/app/loading/skeleton-loading/skeleton-list/skeleton-list.component.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+/** Lista vertical de linhas (ex.: opções de dropdown). */
+export declare class SkeletonListComponent {
+    rows: number;
+    /** Mostra um “leading” à esquerda (círculo pequeno). */
+    leading: boolean;
+    rowGap: string;
+    /** Altura da barra por linha (alinhada às opções de select ~0,95rem / lh 1,35). */
+    lineHeight: string;
+    animate: boolean;
+    rowIndexes(): number[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonListComponent, "app-skeleton-list", never, { "rows": { "alias": "rows"; "required": false; }; "leading": { "alias": "leading"; "required": false; }; "rowGap": { "alias": "rowGap"; "required": false; }; "lineHeight": { "alias": "lineHeight"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_rows: unknown;
+    static ngAcceptInputType_leading: unknown;
+    static ngAcceptInputType_animate: unknown;
+}

package/app/loading/skeleton-loading/skeleton-table/skeleton-table.component.d.ts

@@ -0,0 +1,16 @@
+import * as i0 from "@angular/core";
+/** Placeholder tabular (cabeçalho + linhas + faixa de paginação). */
+export declare class SkeletonTableComponent {
+    columnCount: number;
+    rowCount: number;
+    showPager: boolean;
+    animate: boolean;
+    colIndexes(): number[];
+    rowIndexes(): number[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonTableComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonTableComponent, "app-skeleton-table", never, { "columnCount": { "alias": "columnCount"; "required": false; }; "rowCount": { "alias": "rowCount"; "required": false; }; "showPager": { "alias": "showPager"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_columnCount: unknown;
+    static ngAcceptInputType_rowCount: unknown;
+    static ngAcceptInputType_showPager: unknown;
+    static ngAcceptInputType_animate: unknown;
+}

package/app/loading/skeleton-loading/skeleton-text/skeleton-text.component.d.ts

@@ -0,0 +1,17 @@
+import * as i0 from "@angular/core";
+/** Várias linhas de texto placeholder. */
+export declare class SkeletonTextComponent {
+    lines: number;
+    /** Largura da última linha em % (1–100). */
+    lastLineWidthPct: number;
+    lineHeight: string;
+    gap: string;
+    animate: boolean;
+    lineIndexes(): number[];
+    widthForLine(i: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SkeletonTextComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SkeletonTextComponent, "app-skeleton-text", never, { "lines": { "alias": "lines"; "required": false; }; "lastLineWidthPct": { "alias": "lastLineWidthPct"; "required": false; }; "lineHeight": { "alias": "lineHeight"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "animate": { "alias": "animate"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_lines: unknown;
+    static ngAcceptInputType_lastLineWidthPct: unknown;
+    static ngAcceptInputType_animate: unknown;
+}

package/app/menus/_models/drawer-side.model.d.ts

@@ -0,0 +1,6 @@
+/** Lado de ancoragem do drawer. */
+export declare enum DrawerSide {
+    Left = "left",
+    Right = "right",
+    Bottom = "bottom"
+}

package/app/menus/_models/drawer-size.model.d.ts

@@ -0,0 +1,6 @@
+/** Larguras padronizadas do painel lateral (drawer). */
+export declare enum DrawerSize {
+    Sm = "sm",
+    Md = "md",
+    Lg = "lg"
+}

package/app/menus/_models/menu-dropdown-placement.model.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Posicionamento vertical preferido do dropdown em relação ao trigger.
+ * O CDK faz flip automático se não couber no viewport quando configurado com posições múltiplas.
+ */
+export declare enum MenuDropdownPlacement {
+    /** Abre por baixo do trigger (preferencial). */
+    Below = "below",
+    /** Abre por cima do trigger. */
+    Above = "above"
+}

package/app/menus/_models/menu-item.model.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Itens de menu partilhados por dropdown, context menu, action-menu e campos (`mostrarMenuContexto`).
+ * Discriminação por `kind` para renderização e navegação por teclado.
+ */
+export type MenuItemKind = 'item' | 'divider' | 'group' | 'submenu';
+export interface MenuItemAction<T = string> {
+    kind: 'item';
+    /** Identificador estável para o evento de selecção. */
+    id: T;
+    label: string;
+    description?: string;
+    /** Classes de ícone (ex.: Font Awesome), opcional. */
+    icon?: string;
+    disabled?: boolean;
+    /** Bloqueia interação e mostra indicador de carregamento (o pai atualiza o modelo). */
+    loading?: boolean;
+    /** Acção destrutiva (ex.: eliminar) — realce semântico sem quebrar o tema. */
+    danger?: boolean;
+}
+export interface MenuItemDivider {
+    kind: 'divider';
+}
+/**
+ * Submenu aninhado (qualquer profundidade em `items`).
+ * A navegação e o posicionamento são tratados em `menu-list` (lista recursiva + overlay CDK).
+ */
+export interface MenuItemSubmenu<T = string> {
+    kind: 'submenu';
+    /** Identificador estável (acessibilidade, rastreio). */
+    id: T;
+    label: string;
+    description?: string;
+    icon?: string;
+    disabled?: boolean;
+    items: readonly MenuNodeItem<T>[];
+}
+export interface MenuItemGroup<T = string> {
+    kind: 'group';
+    /** Rótulo da seção (opcional). */
+    label?: string;
+    /** Itens e submenus aninhados dentro do grupo. */
+    items: readonly MenuNodeItem<T>[];
+}
+/** Folha: ação ou divisor. */
+export type MenuLeafItem<T = string> = MenuItemAction<T> | MenuItemDivider;
+/** Nó de primeiro nível ou dentro de grupos (inclui submenus). */
+export type MenuNodeItem<T = string> = MenuLeafItem<T> | MenuItemGroup<T> | MenuItemSubmenu<T>;

package/app/menus/_utils/menu-connected-positions.util.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectedPosition } from '@angular/cdk/overlay';
+import { MenuDropdownPlacement } from '../_models/menu-dropdown-placement.model';
+/** Posições com flip vertical (preferência em baixo ou em cima). */
+export declare function menuConnectedPositions(placement: MenuDropdownPlacement): ConnectedPosition[];

package/app/menus/_utils/menu-rows.util.d.ts

@@ -0,0 +1,22 @@
+import type { MenuItemAction, MenuItemSubmenu, MenuNodeItem } from '../_models/menu-item.model';
+export interface MenuRowAction<T = string> {
+    kind: 'action';
+    item: MenuItemAction<T>;
+    /** Índice na navegação por teclado; `null` se desabilitado. */
+    focusIndex: number | null;
+}
+export interface MenuRowDivider {
+    kind: 'divider';
+}
+export interface MenuRowGroup {
+    kind: 'group';
+    label?: string;
+}
+export interface MenuRowSubmenu<T = string> {
+    kind: 'submenu';
+    item: MenuItemSubmenu<T>;
+    focusIndex: number | null;
+}
+export type MenuRow<T = string> = MenuRowAction<T> | MenuRowDivider | MenuRowGroup | MenuRowSubmenu<T>;
+export declare function buildMenuRows<T = string>(nodes: readonly MenuNodeItem<T>[]): MenuRow<T>[];
+export declare function focusableActionCount<T>(rows: readonly MenuRow<T>[]): number;

package/app/menus/_utils/submenu-connected-positions.util.d.ts

@@ -0,0 +1,5 @@
+import type { ConnectedPosition } from '@angular/cdk/overlay';
+/**
+ * Submenu ao lado do item (preferência à direita); o CDK `push` inverte se não couber.
+ */
+export declare function submenuConnectedPositions(): ConnectedPosition[];

package/app/menus/action-menu/action-menu.component.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from '@angular/core';
+import { MenuDropdownPlacement } from '../_models/menu-dropdown-placement.model';
+import type { MenuNodeItem } from '../_models/menu-item.model';
+import * as i0 from "@angular/core";
+/**
+ * Menu de ações padrão: mesmo comportamento do `dropdown-menu` com trigger «…» (overflow).
+ * Mantém a API de itens existente (`MenuNodeItem`).
+ */
+export declare class ActionMenuComponent<T = string> {
+    items: readonly MenuNodeItem<T>[];
+    placement: MenuDropdownPlacement;
+    minWidthPx: number;
+    menuId: string;
+    /** Texto acessível do botão de gatilho. */
+    triggerLabel: string;
+    /** O painel não segue a largura do botão (ícone estreito). */
+    matchTriggerWidth: boolean;
+    readonly itemSelect: EventEmitter<T>;
+    readonly openChange: EventEmitter<boolean>;
+    readonly MenuDropdownPlacement: typeof MenuDropdownPlacement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ActionMenuComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ActionMenuComponent<any>, "app-action-menu", never, { "items": { "alias": "items"; "required": true; }; "placement": { "alias": "placement"; "required": false; }; "minWidthPx": { "alias": "minWidthPx"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; "triggerLabel": { "alias": "triggerLabel"; "required": false; }; "matchTriggerWidth": { "alias": "matchTriggerWidth"; "required": false; }; }, { "itemSelect": "itemSelect"; "openChange": "openChange"; }, never, never, true, never>;
+    static ngAcceptInputType_matchTriggerWidth: unknown;
+}

package/app/menus/context-menu/context-menu.component.d.ts

@@ -0,0 +1,32 @@
+import { EventEmitter, OnDestroy, TemplateRef } from '@angular/core';
+import type { MenuNodeItem } from '../_models/menu-item.model';
+import * as i0 from "@angular/core";
+export declare class ContextMenuComponent<T = string> implements OnDestroy {
+    private readonly overlay;
+    private readonly vcr;
+    private readonly appTheme;
+    private readonly cdr;
+    items: readonly MenuNodeItem<T>[];
+    disabled: boolean;
+    menuId: string;
+    readonly itemSelect: EventEmitter<T>;
+    menuTpl: TemplateRef<unknown>;
+    private menuList?;
+    private overlayRef;
+    private escSub;
+    private readonly generatedId;
+    readonly panelThemeNgClass: import("@angular/core").Signal<{
+        [x: string]: boolean;
+        'app-library-theme': boolean;
+    }>;
+    get resolvedMenuId(): string;
+    ngOnDestroy(): void;
+    onContextMenu(ev: MouseEvent): void;
+    private openAt;
+    private disposeOverlay;
+    onItemSelect(id: T): void;
+    onCloseRequest(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ContextMenuComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ContextMenuComponent<any>, "app-context-menu", never, { "items": { "alias": "items"; "required": true; }; "disabled": { "alias": "disabled"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; }, { "itemSelect": "itemSelect"; }, never, ["*"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}

package/app/menus/drawer/drawer.component.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter, OnChanges, OnDestroy, SimpleChanges } from '@angular/core';
+import { DrawerSide } from '../_models/drawer-side.model';
+import { DrawerSize } from '../_models/drawer-size.model';
+import * as i0 from "@angular/core";
+export declare class DrawerComponent implements OnChanges, OnDestroy {
+    private readonly cdr;
+    private readonly injector;
+    private readonly hostEl;
+    open: boolean;
+    side: DrawerSide;
+    size: DrawerSize;
+    /** `title="…"` no template — evita colisão com `HTMLElement.title` no host. */
+    drawerHeading: string;
+    showCloseButton: boolean;
+    readonly openChange: EventEmitter<boolean>;
+    private panelRef?;
+    readonly DrawerSide: typeof DrawerSide;
+    readonly DrawerSize: typeof DrawerSize;
+    readonly titleId: string;
+    private focusPreOpen;
+    /** Igual ao `app-dialog`: backdrop + painel no `body` para `backdrop-filter` correcto. */
+    private bodyRestoreParent;
+    private bodyRestoreNext;
+    get panelClasses(): Record<string, boolean>;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    private attachHostToBody;
+    private detachHostFromBody;
+    onBackdropClick(): void;
+    onCloseClick(): void;
+    onPanelKeydown(ev: KeyboardEvent): void;
+    requestClose(): void;
+    private restoreFocus;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DrawerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DrawerComponent, "app-drawer", never, { "open": { "alias": "open"; "required": false; }; "side": { "alias": "side"; "required": false; }; "size": { "alias": "size"; "required": false; }; "drawerHeading": { "alias": "title"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; }, { "openChange": "openChange"; }, never, ["*", "[appDrawerFooter]"], true, never>;
+    static ngAcceptInputType_open: unknown;
+    static ngAcceptInputType_showCloseButton: unknown;
+}

package/app/menus/dropdown-menu/dropdown-menu.component.d.ts

@@ -0,0 +1,33 @@
+import { EventEmitter, TemplateRef } from '@angular/core';
+import { MenuDropdownPlacement } from '../_models/menu-dropdown-placement.model';
+import type { MenuNodeItem } from '../_models/menu-item.model';
+import * as i0 from "@angular/core";
+export declare class DropdownMenuComponent<T = string> {
+    private readonly host;
+    items: readonly MenuNodeItem<T>[];
+    placement: MenuDropdownPlacement;
+    /** Largura mínima do painel em px (o painel pode alargar ao conteúdo). */
+    minWidthPx: number;
+    /** Se `true`, a largura do painel segue a do trigger. */
+    matchTriggerWidth: boolean;
+    menuId: string;
+    readonly itemSelect: EventEmitter<T>;
+    readonly openChange: EventEmitter<boolean>;
+    panelTpl: TemplateRef<unknown>;
+    private menuList?;
+    open: boolean;
+    private readonly generatedId;
+    get resolvedMenuId(): string;
+    /** Largura do painel no overlay (mínimo garantido; pode igualar ao trigger). */
+    get effectivePanelWidth(): number;
+    get connectedPositions(): import("@angular/cdk/overlay").ConnectedPosition[];
+    onTriggerClick(ev: Event): void;
+    toggle(): void;
+    setOpen(next: boolean): void;
+    onBaseOpenChange(next: boolean): void;
+    onItemSelect(id: T): void;
+    onCloseRequest(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DropdownMenuComponent<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownMenuComponent<any>, "app-dropdown-menu", never, { "items": { "alias": "items"; "required": true; }; "placement": { "alias": "placement"; "required": false; }; "minWidthPx": { "alias": "minWidthPx"; "required": false; }; "matchTriggerWidth": { "alias": "matchTriggerWidth"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; }, { "itemSelect": "itemSelect"; "openChange": "openChange"; }, never, ["*"], true, never>;
+    static ngAcceptInputType_matchTriggerWidth: unknown;
+}