structra-ui 0.2.63 → 0.2.66

package/types/structra-ui.d.ts

@@ -1,12 +1,12 @@
 import * as _angular_core from '@angular/core';
-import { AfterViewInit, OnChanges, ElementRef, SimpleChanges, ChangeDetectorRef, Injector, DestroyRef, EventEmitter, OnInit, DoCheck, TemplateRef, OnDestroy, InjectionToken, AfterContentInit, QueryList, AfterViewChecked, Renderer2, Signal, ViewContainerRef, WritableSignal, Type, EnvironmentProviders, EffectRef, isDevMode } from '@angular/core';
+import { AfterViewInit, OnChanges, ElementRef, SimpleChanges, ChangeDetectorRef, Injector, DestroyRef, EventEmitter, OnInit, DoCheck, TemplateRef, OnDestroy, InjectionToken, AfterContentInit, QueryList, AfterViewChecked, Renderer2, Signal, ViewContainerRef, Provider, WritableSignal, Type, EnvironmentProviders, EffectRef, isDevMode } from '@angular/core';
 import * as _angular_forms from '@angular/forms';
-import { ControlValueAccessor, AbstractControl, NgControl, ValidatorFn, NgForm, FormGroup, FormBuilder, FormArray, FormControl } from '@angular/forms';
+import { ControlValueAccessor, AbstractControl, NgControl, ValidatorFn, NgForm, FormGroup, FormControl, FormBuilder, FormArray } from '@angular/forms';
 import { MatDatepicker } from '@angular/material/datepicker';
 import * as _angular_cdk_overlay from '@angular/cdk/overlay';
 import { ConnectedPosition, ScrollStrategy, OverlayRef, Overlay } from '@angular/cdk/overlay';
 import { SafeResourceUrl } from '@angular/platform-browser';
-import { ICellRendererParams, ColDef, GetRowIdParams, GridReadyEvent, RowClickedEvent } from 'ag-grid-community';
+import { ICellRendererParams, ColDef, GetRowIdParams, GridReadyEvent, ColumnMovedEvent, ColumnResizedEvent, ColumnVisibleEvent, ColumnPinnedEvent, RowClickedEvent } from 'ag-grid-community';
 import { ICellRendererAngularComp } from 'ag-grid-angular';
 import * as structra_ui from 'structra-ui';
 import { DialogRef } from '@angular/cdk/dialog';
@@ -56,23 +56,42 @@ declare function resolveStructraShellScrollContainer(host: HTMLElement, pageHost
 declare const STRUCTRA_DEDICATED_BACK_TO_TOP_SELECTOR = ".structra-consulta-page-host, .structra-cadastro-page-host, .cadastro-metadata-shell-page";
 
 type AlertType = 'error' | 'success' | 'warning' | 'info';
+/** Botão opcional alinhado à direita dentro do banner. */
+interface AlertAction {
+    label: string;
+    icon?: string;
+}
 /**
  * Feedback visual inline (erro, sucesso, aviso, informação). Reutiliza tokens semânticos da lib.
  */
 declare class AlertComponent {
+    protected readonly ButtonVariant: {
+        readonly Primary: "primary";
+        readonly Secondary: "secondary";
+        readonly Ghost: "ghost";
+        readonly Link: "link";
+        readonly Danger: "danger";
+        readonly Warning: "warning";
+        readonly Success: "success";
+    };
     /** Remove o host do fluxo ao fechar (evita faixa em branco com `display: block` vazio). */
     protected get hostHidden(): boolean;
     type: AlertType;
     message: string;
     closable: boolean;
+    /** Ação opcional (rótulo + ícone) renderizada à direita do texto. */
+    action: AlertAction | null;
+    readonly actionClick: _angular_core.OutputEmitterRef<void>;
     /** Quando `closable`, o alerta deixa de renderizar após fechar. */
     protected readonly visible: _angular_core.WritableSignal<boolean>;
     protected get hasMessage(): boolean;
+    protected get hasAction(): boolean;
     private readonly modifierByType;
     protected get alertHostClass(): string;
     protected onClose(): void;
+    protected onActionClick(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "app-alert", never, { "type": { "alias": "type"; "required": false; }; "message": { "alias": "message"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "app-alert", never, { "type": { "alias": "type"; "required": false; }; "message": { "alias": "message"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; "action": { "alias": "action"; "required": false; }; }, { "actionClick": "actionClick"; }, never, ["*"], true, never>;
     static ngAcceptInputType_closable: unknown;
 }
 
@@ -259,6 +278,13 @@ type MenuLeafItem<T = string> = MenuItemAction<T> | MenuItemDivider;
 /** Nó de primeiro nível ou dentro de grupos (inclui submenus). */
 type MenuNodeItem<T = string> = MenuLeafItem<T> | MenuItemGroup<T> | MenuItemSubmenu<T>;
 
+interface NativeInputAutofillSyncOptions {
+    getBoundText: () => string;
+    refreshFilledUi: () => void;
+    /** Autofill / `change` sem `input`: DOM tem valor diferente do estado Angular. */
+    onDomValueChanged?: (domValue: string) => void;
+}
+
 /**
  * Escala do campo (design system).
  * - **`sm`** — compacto (barras laterais, filtros).
@@ -373,7 +399,7 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor, On
     get hostDataControlId(): string;
     protected get autoIdPrefix(): string;
     /** Valor do atributo HTML `autocomplete` derivado de {@link autocomplete}. */
-    get autocompleteAttr(): 'on' | 'off';
+    get autocompleteAttr(): string;
     /**
      * Mensagem exibida quando inválido: `errorMessage` se preenchido;
      * senão, se obrigatório, o padrão "Campo obrigatório".
@@ -426,6 +452,13 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor, On
      * após pintura / timeout curto para o teclado virtual aparecer com mais fiabilidade após o layout do painel.
      */
     protected applyAutofocusIfNeeded(resolve: () => HTMLElement | null | undefined): void;
+    /** Sincroniza autofill do browser com `filledUi` e modelo (autofill não dispara `input`). */
+    protected attachNativeInputAutofillSync(input: HTMLInputElement | HTMLTextAreaElement | null | undefined, options: NativeInputAutofillSyncOptions): void;
+    /**
+     * Search-select / combobox: regista tipografia inline sem o fluxo completo de autofill.
+     * Inputs de texto já entram via {@link attachNativeInputAutofillSync}.
+     */
+    protected bindNativeInputTypographyViewport(input: HTMLInputElement | HTMLTextAreaElement | null | undefined): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BaseFieldDirective<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BaseFieldDirective<any>, never, never, { "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "size": { "alias": "size"; "required": false; }; "tamanhoCampoMobile": { "alias": "tamanhoCampoMobile"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "showErrorMessage": { "alias": "showErrorMessage"; "required": false; }; "invalidThemed": { "alias": "invalidThemed"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showRequiredMark": { "alias": "showRequiredMark"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "showPrefixIcon": { "alias": "showPrefixIcon"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "iconLeft": { "alias": "iconLeft"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "mostrarMenuContexto": { "alias": "mostrarMenuContexto"; "required": false; }; "contextMenuItems": { "alias": "contextMenuItems"; "required": false; }; "contextMenuId": { "alias": "contextMenuId"; "required": false; }; }, { "contextMenuSelect": "contextMenuSelect"; }, never, never, true, never>;
     static ngAcceptInputType_tamanhoCampoMobile: unknown;
@@ -496,6 +529,17 @@ declare class SkeletonCardComponent {
     static ngAcceptInputType_animate: unknown;
 }
 
+/** Placeholder de cartão totalizador (`app-stat-card`) — painéis de consulta e dashboard. */
+declare class SkeletonStatCardComponent {
+    animate: boolean;
+    /** Espelha `app-stat-card` com linha de descrição (ex.: dashboard Oficina). */
+    withDescription: boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkeletonStatCardComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonStatCardComponent, "app-skeleton-stat-card", never, { "animate": { "alias": "animate"; "required": false; }; "withDescription": { "alias": "withDescription"; "required": false; }; }, {}, never, never, true, never>;
+    static ngAcceptInputType_animate: unknown;
+    static ngAcceptInputType_withDescription: unknown;
+}
+
 /** Placeholder tabular (cabeçalho + linhas + faixa de paginação). */
 declare class SkeletonTableComponent {
     columnCount: number;
@@ -671,10 +715,13 @@ declare class TextFieldComponent extends NgControlFieldDirective<string | null>
     nativeInputType: 'text' | 'email';
     inputText: string;
     filledUi: boolean;
+    /** Login/cadastro: `username` ou `email` em vez de `on` genérico. */
+    get autocompleteAttr(): string;
     /** FormControl por vezes escreve número/object (metadata dinâmica); normalizar antes de slice/trim. */
     private static valueAsTrimmedString;
     private refreshFilledUi;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     protected afterWriteValue(value: string | null): void;
     onNativeInput(event: Event): void;
     onBlur(): void;
@@ -734,6 +781,7 @@ declare class PasswordFieldComponent extends NgControlFieldDirective<string | nu
     toggleIconClassUi: string;
     ngOnInit(): void;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     private refreshFilledUi;
     private refreshPasswordToggleUi;
     protected afterWriteValue(value: string | null): void;
@@ -765,6 +813,7 @@ declare class TextareaFieldComponent extends NgControlFieldDirective<string | nu
     textareaMaxHeightCss: string;
     ngOnInit(): void;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     ngOnChanges(changes: SimpleChanges): void;
     private updateTextareaHeight;
     private refreshFilledUi;
@@ -820,6 +869,7 @@ declare class IntegerFieldComponent extends NgControlFieldDirective<number | nul
     inputText: string;
     filledUi: boolean;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     private refreshFilledUi;
     protected afterWriteValue(value: number | null): void;
     onBeforeInput(event: Event): void;
@@ -850,6 +900,7 @@ declare class DecimalFieldComponent extends NgControlFieldDirective<number | nul
     /** Valor mostrado no `<input>`: `prefixo + número` ou só o número. */
     get displayValue(): string;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     private composeFullDisplay;
     /** Comprimento do segmento `«prefixo» ` em caracteres (0 se não há prefixo). */
     private prefixSegmentLen;
@@ -923,6 +974,7 @@ declare abstract class MaskedTextFieldBase extends NgControlFieldDirective<strin
     /** Padrão efetivo (permite CEP/telefone fixarem máscaras em subclasses). */
     protected get pattern(): string;
     ngAfterViewInit(): void;
+    private syncAutofillFromDom;
     /**
      * Padrão de formatação para o valor digitado (só dígitos).
      * Sobrescrever para máscara dinâmica (ex.: CPF até 11 dígitos, CNPJ depois).
@@ -1347,7 +1399,7 @@ declare class DropdownBaseComponent {
      * As classes de tema no painel interno seguem o tema activo sempre.
      */
     readonly panelThemeNgClass: _angular_core.Signal<{
-        [x: string]: boolean;
+        [k: string]: boolean;
     }>;
     open: boolean;
     readonly openChange: EventEmitter<boolean>;
@@ -1591,6 +1643,8 @@ declare class SelectFieldComponent extends DropdownOptionFieldBase implements Af
 declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase implements AfterViewInit, OnDestroy, OnChanges {
     private readonly hostRef;
     get hostInvalidClass(): boolean;
+    /** Campo de pesquisa no painel para filtrar opções (consulta / filtros com listas longas). */
+    searchable: boolean;
     /** Por omissão `true`: mesmo padrão do select com lista longa (`pageRequested` + scroll). */
     pagination: boolean;
     /**
@@ -1652,6 +1706,7 @@ declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase imp
     private readonly dropdownBase?;
     panelOpen: boolean;
     panelOverlayWidth: number;
+    panelSearchQuery: string;
     private scrollLoadTimer;
     private keyboardLoadMoreTimer;
     private loadMoreInFlight;
@@ -1666,6 +1721,11 @@ declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase imp
     /** Texto numa linha: rótulos separados por vírgula + ellipsis no CSS. */
     get displaySummary(): string;
     get optionsListId(): string;
+    get panelSearchInputId(): string;
+    /** Filtra {@link DropdownMultiOptionFieldBase.listOptions} quando {@link searchable} está activo. */
+    get listOptions(): ReadonlyArray<UiSelectOption<unknown>>;
+    onPanelSearchInput(ev: Event): void;
+    onPanelSearchKeydown(ev: KeyboardEvent): void;
     private getOptionsListElement;
     private scrollActiveOptionIntoView;
     private scheduleMaybeLoadMoreFromKeyboard;
@@ -1696,7 +1756,8 @@ declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase imp
     /** Escape com foco no limpar/prefixo do `base-field` (não passa pelo div da origem do overlay). */
     onDropdownHostEscape(ev: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiselectFieldComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiselectFieldComponent, "app-multiselect-field", never, { "pagination": { "alias": "pagination"; "required": false; }; "useCache": { "alias": "useCache"; "required": false; }; "pageableInput": { "alias": "pageable"; "required": false; }; "showSuffixSlot": { "alias": "showSuffixSlot"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "hasMore": { "alias": "hasMore"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "defaultValue": { "alias": "defaultValue"; "required": false; }; "defaultValueLabel": { "alias": "defaultValueLabel"; "required": false; }; "maxSelected": { "alias": "maxSelected"; "required": false; }; }, { "pageRequested": "pageRequested"; }, never, ["[appFieldPrefix]", "[appMultiselectTriggerSuffix]", "[appFieldSuffix]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiselectFieldComponent, "app-multiselect-field", never, { "searchable": { "alias": "searchable"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "useCache": { "alias": "useCache"; "required": false; }; "pageableInput": { "alias": "pageable"; "required": false; }; "showSuffixSlot": { "alias": "showSuffixSlot"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "hasMore": { "alias": "hasMore"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "defaultValue": { "alias": "defaultValue"; "required": false; }; "defaultValueLabel": { "alias": "defaultValueLabel"; "required": false; }; "maxSelected": { "alias": "maxSelected"; "required": false; }; }, { "pageRequested": "pageRequested"; }, never, ["[appFieldPrefix]", "[appMultiselectTriggerSuffix]", "[appFieldSuffix]"], true, never>;
+    static ngAcceptInputType_searchable: unknown;
     static ngAcceptInputType_pagination: unknown;
     static ngAcceptInputType_useCache: unknown;
     static ngAcceptInputType_pageableInput: unknown;
@@ -2934,6 +2995,105 @@ declare class FormTabsComponent implements AfterContentInit, OnChanges {
     static ngAcceptInputType_validationLinkActive: unknown;
 }
 
+declare class PermissionGroupTabComponent implements OnChanges {
+    private readonly tabs;
+    private readonly cdr;
+    readonly panelTpl: TemplateRef<unknown>;
+    key: string;
+    tabTitle: string;
+    /** Chave estável do grupo vertical (ex.: `cadastros`, `sistema`). */
+    groupKey: string;
+    /** Rótulo exibido no cabeçalho do grupo. */
+    groupLabel: string;
+    /** Ordem do grupo na coluna vertical. */
+    groupOrder: number | null;
+    disabled: boolean;
+    ngOnChanges(changes: SimpleChanges): void;
+    get isActive(): boolean;
+    get detachInactivePanel(): boolean;
+    refreshActiveState(): void;
+    get hostClass(): string;
+    panelId(): string;
+    labelledById(): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PermissionGroupTabComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PermissionGroupTabComponent, "app-permission-group-tab", never, { "key": { "alias": "key"; "required": true; }; "tabTitle": { "alias": "tabTitle"; "required": true; }; "groupKey": { "alias": "groupKey"; "required": false; }; "groupLabel": { "alias": "groupLabel"; "required": false; }; "groupOrder": { "alias": "groupOrder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_disabled: unknown;
+}
+
+/** Grupo vertical de telas de permissão (alinhado ao menu lateral). */
+interface PermissionGroupTabGroup {
+    readonly key: string;
+    readonly label: string;
+    readonly order: number;
+}
+/** Metadados mínimos de uma tela dentro de um grupo (útil fora do ContentChildren). */
+interface PermissionGroupTabDescriptor {
+    readonly key: string;
+    readonly tabTitle: string;
+    readonly groupKey?: string | null;
+    readonly groupLabel?: string | null;
+    readonly groupOrder?: number | null;
+}
+declare const PERMISSION_GROUP_OUTROS_KEY = "outros";
+declare const PERMISSION_GROUP_OUTROS_LABEL = "Outros";
+declare const PERMISSION_GROUP_OUTROS_ORDER = 999;
+
+interface PermissionGroupTabBucket<T extends PermissionGroupTabDescriptor = PermissionGroupTabDescriptor> {
+    readonly group: PermissionGroupTabGroup;
+    readonly tabs: readonly T[];
+}
+/** Agrupa telas por `groupKey`; telas sem grupo caem em OUTROS quando existir metadata em alguma tela. */
+declare function agruparPermissionTabs<T extends PermissionGroupTabDescriptor>(tabs: readonly T[]): PermissionGroupTabBucket<T>[];
+/** `true` quando nenhuma tela declara grupo — layout plano (retrocompatível com tabs horizontais). */
+declare function permissionTabsUsamGruposVerticais(tabs: readonly PermissionGroupTabDescriptor[]): boolean;
+
+declare class PermissionGroupTabsComponent implements AfterContentInit, OnChanges {
+    private static nextUid;
+    private readonly cdr;
+    readonly uid: string;
+    tabQuery: QueryList<PermissionGroupTabComponent>;
+    private _activeKey;
+    set activeKey(v: string | undefined | null);
+    get activeKey(): string;
+    readonly activeKeyChange: EventEmitter<string>;
+    keepAlive: boolean;
+    /** Rótulo acessível da lista de chips de telas. */
+    tablistAriaLabel: string;
+    /** Grupos recolhidos (`true` = fechado). Omissão = expandido. */
+    readonly gruposRecolhidos: _angular_core.WritableSignal<Readonly<Record<string, boolean>>>;
+    /** Tela selecionada por grupo vertical (permite múltiplos conteúdos abertos). */
+    readonly selectedTabByGroup: _angular_core.WritableSignal<Readonly<Record<string, string>>>;
+    private gruposCollapsePadraoAplicado;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngAfterContentInit(): void;
+    get tabs(): PermissionGroupTabComponent[];
+    get usaGruposVerticais(): boolean;
+    get grupos(): PermissionGroupTabBucket<PermissionGroupTabComponent>[];
+    baseId(): string;
+    chipIdFor(key: string): string;
+    panelIdFor(key: string): string;
+    sectionHeaderIdFor(groupKey: string): string;
+    isSelected(key: string): boolean;
+    isGroupCollapsed(groupKey: string): boolean;
+    toggleGroup(groupKey: string): void;
+    selectTab(key: string): void;
+    isTabPanelVisible(tab: PermissionGroupTabComponent): boolean;
+    shouldMountTabPanel(tab: PermissionGroupTabComponent): boolean;
+    getSelectedTabKeyForGroup(groupKey: string, tabsInGroup: readonly PermissionGroupTabComponent[]): string;
+    onTabHeaderStateChanged(): void;
+    private refreshTabPanels;
+    private syncSelectedTabForGroup;
+    private resolveGroupKey;
+    private syncInitialActiveKey;
+    private syncActiveKeyFromInput;
+    private expandGroupForActiveKey;
+    /** Recolhe todos os grupos verticais exceto o padrão (`visao-geral`). */
+    private applyDefaultGroupCollapseState;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PermissionGroupTabsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PermissionGroupTabsComponent, "app-permission-group-tabs", never, { "activeKey": { "alias": "activeKey"; "required": false; }; "keepAlive": { "alias": "keepAlive"; "required": false; }; "tablistAriaLabel": { "alias": "tablistAriaLabel"; "required": false; }; }, { "activeKeyChange": "activeKeyChange"; }, ["tabQuery"], never, true, never>;
+    static ngAcceptInputType_keepAlive: unknown;
+}
+
 /**
  * Configuração por aba: ordem no array define prioridade em
  * {@link pickTabKeyLinkedToSummaryItems} (primeira aba com intersecção vence).
@@ -3027,6 +3187,11 @@ interface DataGridColumn<T = unknown> {
      * Ordenação/filtro continuam a usar o campo bruto da linha.
      */
     enumOptions?: readonly DataGridEnumOption[];
+    /**
+     * Campo da linha com nome de classe CSS a aplicar na célula (ex.: cor por status).
+     * Combinado com classes de alinhamento (`align`).
+     */
+    cellClassField?: keyof T | string;
 }
 
 /** Contexto injetado pelo {@link DataGridComponent} (não exportado para consumidores). */
@@ -3034,14 +3199,24 @@ interface DataGridActionsContext<T = unknown> {
     onEditRow: (row: T) => void;
     onRemoveRow: (row: T) => void;
     onDuplicateRow?: (row: T) => void;
+    onPrintRow?: (row: T) => void;
     /** Quando `false`, o botão «Alterar» não é mostrado. */
     showEditAction?: boolean;
     /** Quando `false`, o botão «Remover» não é mostrado. */
     showRemoveAction?: boolean;
     /** Quando `true`, mostra «Duplicar» (requer `onDuplicateRow`). */
     showDuplicateAction?: boolean;
+    /** Quando `true`, mostra «Imprimir» (requer `onPrintRow`). */
+    showPrintAction?: boolean;
     /** Tooltip/aria do botão de abrir registo; omisso ⇒ «Alterar». */
     editActionLabel?: string;
+    /**
+     * Classe Font Awesome do ícone do botão editar/transmitir (ex.: `fa-paper-plane`).
+     * Omisso ⇒ `fa-pen-to-square`.
+     */
+    editActionIconClass?: string;
+    /** Tooltip/aria do botão imprimir; omisso ⇒ «Imprimir». */
+    printActionLabel?: string;
 }
 declare class DataGridActionsCellRendererComponent implements ICellRendererAngularComp {
     params: ICellRendererParams & {
@@ -3050,11 +3225,19 @@ declare class DataGridActionsCellRendererComponent implements ICellRendererAngul
     agInit(params: ICellRendererParams): void;
     refresh(): boolean;
     protected get isPlaceholderRow(): boolean;
+    /** Linha pode ocultar ações via `__hideEditAction` / `__hidePrintAction` (ex.: NF já autorizada). */
+    protected get rowData(): Record<string, unknown> | undefined;
+    protected get showEditButton(): boolean;
+    protected get showPrintButton(): boolean;
+    /** Botão textual (ex.: «Transmitir NFS-e») em vez do ícone «Alterar». */
+    protected get editAsTextButton(): boolean;
+    protected get editActionIcon(): string;
     /** `params.context` nem sempre vem preenchido; o grid guarda o mesmo objeto em `gridOptions.context`. */
     protected get actionsContext(): DataGridActionsContext | undefined;
     edit(): void;
     remove(): void;
     duplicate(): void;
+    print(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataGridActionsCellRendererComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataGridActionsCellRendererComponent, "app-data-grid-actions-cell-renderer", never, {}, {}, never, never, true, never>;
 }
@@ -3112,6 +3295,9 @@ interface DataGridPaginationChangeEvent {
 declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDestroy {
     private readonly ngZone;
     private readonly cdr;
+    private readonly destroyRef;
+    private readonly hostRef;
+    private readonly gridLayoutService;
     private gridApi;
     /**
      * Alinhar com `data-grid.host-theme.scss`: `--ag-grid-size: 7px`, cabeçalho e linha = ×8.
@@ -3168,10 +3354,16 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     showEditAction: boolean;
     /** Tooltip e aria-label do botão de edição na coluna Ações. Omisso ⇒ «Alterar». */
     editActionLabel: string;
+    /** Ícone Font Awesome do botão editar (ex.: `fa-paper-plane`). Omisso ⇒ `fa-pen-to-square`. */
+    editActionIconClass: string;
     /** Se `false`, a coluna de ações não mostra «Remover». Por omissão `true`. */
     showRemoveAction: boolean;
     /** Se `true`, mostra «Duplicar» na coluna de ações (requer handler no contexto). */
     showDuplicateAction: boolean;
+    /** Se `true`, mostra «Imprimir» na coluna de ações (requer handler no contexto). */
+    showPrintAction: boolean;
+    /** Tooltip e aria-label do botão imprimir na coluna Ações. Omisso ⇒ «Imprimir». */
+    printActionLabel: string;
     /**
      * Se `true`, não emite {@link rowClick} (ex.: coleção com edição só pelos botões da coluna de acções, como na consulta).
      */
@@ -3188,8 +3380,36 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     highlightedRowMatch: number | null;
     /** Campo em {@link rows} a comparar com {@link highlightedRowMatch}. Omisso: `__rowArrayIndex`. */
     highlightMatchField: string;
+    /**
+     * Chave da tela para persistência de layout (tenant + tela + grid).
+     * Omisso: não persiste nem restaura colunas.
+     */
+    layoutTelaKey: string | null;
+    /** Chave do grid na mesma tela. Omisso: `consulta-principal`. */
+    layoutGridKey: string;
+    private isApplyingSavedLayout;
+    private savedLayoutApplied;
+    private layoutUserChangeSaveEnabled;
+    /** Impressão digital do columnState já aplicado nesta instância (evita re-apply idêntico). */
+    private appliedLayoutFingerprint;
+    /** Estado em cache lido de forma síncrona antes do gridReady. */
+    private pendingSavedColumnState;
+    private layoutApplyRetryTimer;
+    private layoutApplyRetryAttempts;
+    private layoutCacheUpdatedUnsub;
+    /** Detecta transição bootstrap (só «Ações») → colunas de dados do metadata (F5). */
+    private lastKnownDataColumnCount;
+    /**
+     * Oculta a faixa horizontal do AG Grid durante reflow/remount (cache de rota / revisit de consulta).
+     * O skeleton na 1.ª carga já tapa o viewport; aqui evita flash quando há linhas visíveis.
+     */
+    suppressHorizontalScrollFlicker: boolean;
+    private layoutStabilizeTimer;
+    private layoutStabilizeRaf;
+    constructor();
     readonly edit: EventEmitter<T>;
     readonly duplicate: EventEmitter<T>;
+    readonly print: EventEmitter<T>;
     readonly remove: EventEmitter<T>;
     /** Clique na linha de dados (útil para selecção fora da coluna de acções). */
     readonly rowClick: EventEmitter<T>;
@@ -3224,6 +3444,12 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     get effectivePaginationPageSizeSelector(): number[];
     /** Repasse ao `ag-grid-angular`: `false` omite o selector (documentação AG Grid). */
     get paginationPageSizeSelectorInput(): number[] | boolean;
+    /**
+     * Skeleton só na carga inicial (lista vazia). Refresh com linhas visíveis mantém a grelha — evita flash com cache.
+     */
+    get showViewportSkeleton(): boolean;
+    /** Só esvazia `rowData` durante loading quando ainda não há linhas a mostrar. */
+    private get clearRowDataWhileLoading();
     /**
      * Empty state **fora** do AG Grid: o overlay nativo falha na 1.ª carga (skeleton + `suppressNoRowsOverlay` / v35).
      */
@@ -3236,6 +3462,8 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     get skeletonRowCount(): number;
     /** Área entre cabeçalho da grelha e barra de paginação (overlay do skeleton), em px quando {@link hostHeight} é valor `NNpx`. */
     private estimateSkeletonViewportBodyPx;
+    /** Desactiva animação de reordenação enquanto o layout persistido não foi aplicado. */
+    get suppressColumnMoveAnimation(): boolean;
     readonly defaultColDef: ColDef<T>;
     /**
      * O AG Grid corre muitos callbacks fora da `NgZone`; sem `run()`, o pai com `OnPush`
@@ -3259,12 +3487,46 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     ngOnDestroy(): void;
     get hostHeight(): string;
     onGridReady(ev: GridReadyEvent<T>): void;
+    private onGridReadyApplyLayoutThenData;
+    onLayoutColumnMoved(ev: ColumnMovedEvent<T>): void;
+    onLayoutColumnResized(ev: ColumnResizedEvent<T>): void;
+    onLayoutColumnVisible(_ev: ColumnVisibleEvent<T>): void;
+    onLayoutColumnPinned(_ev: ColumnPinnedEvent<T>): void;
+    private hydrateLayoutFromCacheSync;
+    /** Dispara GET em background na 1.ª visita para aquecer cache antes do gridReady. */
+    private prefetchLayoutIfNeeded;
+    private onExternalLayoutCacheUpdated;
+    private tryApplySavedLayout;
+    private countDataColumns;
+    private shouldKeepTryingLayoutApply;
+    /** Só activa gravação automática quando colunas de dados existem (evita sobrescrever layout no F5). */
+    private canEnableLayoutSaveGrace;
+    private cancelLayoutApplyRetry;
+    private scheduleLayoutApplyRetry;
+    private applySavedLayoutBeforeFirstPaint;
+    /** Dois frames após `agColumnDefs` mudar — AG Grid precisa materializar colunas antes de `applyColumnState`. */
+    private yieldForGridColumnDefsSync;
+    /** Colunas de dados existem no input e já estão materializadas na API do AG Grid. */
+    private gridReadyForLayoutApply;
+    private verifyLayoutStateApplied;
+    private applyColumnStateToGrid;
+    private enableLayoutSaveAfterGrace;
+    private persistColumnLayoutIfAllowed;
     onRowClicked(ev: RowClickedEvent<T>): void;
     private rowClassForHighlight;
     private applyRowHighlightClass;
     private applyInitialPaginationPage;
     /** Evita `removeEventListener` na API depois do grid destruído. */
     private detachPaginationListenerIfLive;
+    private setupHorizontalScrollStabilizingObservers;
+    private beginHorizontalScrollStabilizing;
+    private scheduleEndHorizontalScrollStabilizing;
+    private tryFinishHorizontalScrollStabilizing;
+    /**
+     * `true` se o viewport central transborda; `false` se não; `null` se ainda não mensurável (largura 0).
+     */
+    private centerViewportNeedsHorizontalScroll;
+    private clearLayoutStabilizingTimers;
     private columnsForGrid;
     /** Classes BEM em `data-grid.host-theme.scss` para alinhamento declarativo nas colunas. */
     private static alignmentCellHeaderClasses;
@@ -3280,7 +3542,7 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     get suppressCellFocusBinding(): boolean;
     private mapColumnsToColDef;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataGridComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵ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; }; "fitPaginationHeight": { "alias": "fitPaginationHeight"; "required": false; }; "fitPaginationMinEmptyRows": { "alias": "fitPaginationMinEmptyRows"; "required": false; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "paginationPanelPlacement": { "alias": "paginationPanelPlacement"; "required": false; }; "paginationStripOnly": { "alias": "paginationStripOnly"; "required": false; }; "suppressPaginationPageSizeSelector": { "alias": "suppressPaginationPageSizeSelector"; "required": false; }; "showActionsColumn": { "alias": "showActionsColumn"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; }; "suppressRowClick": { "alias": "suppressRowClick"; "required": false; }; "inlineCellEditing": { "alias": "inlineCellEditing"; "required": false; }; "highlightedRowMatch": { "alias": "highlightedRowMatch"; "required": false; }; "highlightMatchField": { "alias": "highlightMatchField"; "required": false; }; }, { "edit": "edit"; "duplicate": "duplicate"; "remove": "remove"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "paginationChanged": "paginationChanged"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵ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; }; "fitPaginationHeight": { "alias": "fitPaginationHeight"; "required": false; }; "fitPaginationMinEmptyRows": { "alias": "fitPaginationMinEmptyRows"; "required": false; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "paginationPanelPlacement": { "alias": "paginationPanelPlacement"; "required": false; }; "paginationStripOnly": { "alias": "paginationStripOnly"; "required": false; }; "suppressPaginationPageSizeSelector": { "alias": "suppressPaginationPageSizeSelector"; "required": false; }; "showActionsColumn": { "alias": "showActionsColumn"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "editActionIconClass": { "alias": "editActionIconClass"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; }; "showPrintAction": { "alias": "showPrintAction"; "required": false; }; "printActionLabel": { "alias": "printActionLabel"; "required": false; }; "suppressRowClick": { "alias": "suppressRowClick"; "required": false; }; "inlineCellEditing": { "alias": "inlineCellEditing"; "required": false; }; "highlightedRowMatch": { "alias": "highlightedRowMatch"; "required": false; }; "highlightMatchField": { "alias": "highlightMatchField"; "required": false; }; "layoutTelaKey": { "alias": "layoutTelaKey"; "required": false; }; "layoutGridKey": { "alias": "layoutGridKey"; "required": false; }; }, { "edit": "edit"; "duplicate": "duplicate"; "print": "print"; "remove": "remove"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; "paginationChanged": "paginationChanged"; }, never, never, true, never>;
     static ngAcceptInputType_initialPaginationPage: unknown;
     static ngAcceptInputType_fitPaginationHeight: unknown;
     static ngAcceptInputType_fitPaginationMinEmptyRows: unknown;
@@ -3289,6 +3551,7 @@ declare class DataGridComponent<T = unknown> implements OnInit, OnChanges, OnDes
     static ngAcceptInputType_showEditAction: unknown;
     static ngAcceptInputType_showRemoveAction: unknown;
     static ngAcceptInputType_showDuplicateAction: unknown;
+    static ngAcceptInputType_showPrintAction: unknown;
     static ngAcceptInputType_suppressRowClick: unknown;
     static ngAcceptInputType_inlineCellEditing: unknown;
 }
@@ -3349,6 +3612,7 @@ declare class CardListComponent<T = unknown> implements OnChanges {
     /** Repasse ao `app-data-card`: botão «Alterar» quando {@link showItemActions} é `true`. */
     showEditAction: boolean;
     editActionLabel: string;
+    editActionIconClass: string;
     /** Repasse ao `app-data-card`: botão «Remover» quando {@link showItemActions} é `true`. */
     showRemoveAction: boolean;
     /** Repasse ao `app-data-card`: clique no cartão emite `edit` (exceto nos botões). */
@@ -3416,13 +3680,14 @@ declare class CardListComponent<T = unknown> implements OnChanges {
     skeletonCardIndices(): number[];
     /** Um único cartão skeleton no fundo durante `loadingMore` (mantém o scroll estável). */
     skeletonTailIndices(): number[];
+    hideEditActionForItem(item: T): boolean;
     trackFn: (index: number, item: T) => unknown;
     onScroll(ev: Event): void;
     private requestRemotePage;
     private loadMoreMemoryChunk;
     private resetVisibleWindow;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardListComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵ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; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "cardOpenOnClick": { "alias": "cardOpenOnClick"; "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; }; "headerPosition": { "alias": "headerPosition"; "required": false; }; "scrollMaxHeight": { "alias": "scrollMaxHeight"; "required": false; }; "cardsPerRow": { "alias": "cardsPerRow"; "required": false; }; "totalCountRemote": { "alias": "totalCountRemote"; "required": false; }; "hasNextPage": { "alias": "hasNextPage"; "required": false; }; }, { "loadMore": "loadMore"; "edit": "edit"; "remove": "remove"; "booleanFieldChange": "booleanFieldChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵ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; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "editActionIconClass": { "alias": "editActionIconClass"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "cardOpenOnClick": { "alias": "cardOpenOnClick"; "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; }; "headerPosition": { "alias": "headerPosition"; "required": false; }; "scrollMaxHeight": { "alias": "scrollMaxHeight"; "required": false; }; "cardsPerRow": { "alias": "cardsPerRow"; "required": false; }; "totalCountRemote": { "alias": "totalCountRemote"; "required": false; }; "hasNextPage": { "alias": "hasNextPage"; "required": false; }; }, { "loadMore": "loadMore"; "edit": "edit"; "remove": "remove"; "booleanFieldChange": "booleanFieldChange"; }, never, never, true, never>;
     static ngAcceptInputType_loadingMore: unknown;
     static ngAcceptInputType_showEditAction: unknown;
     static ngAcceptInputType_showRemoveAction: unknown;
@@ -3466,6 +3731,8 @@ declare class AdaptiveDataViewComponent<T = unknown> implements OnInit, OnChange
     showCardItemActions: boolean;
     /** Tooltip/aria do botão de abrir registo na coluna Ações ou no cartão. Omisso ⇒ «Alterar». */
     editActionLabel: string;
+    /** Ícone Font Awesome do botão editar (ex.: `fa-paper-plane`). Omisso ⇒ `fa-pen-to-square`. */
+    editActionIconClass: string;
     /** Lista em cartões: clique no cartão dispara `edit` (como «Alterar»); botões mantêm-se independentes. */
     cardOpenOnClick: boolean;
     scrollBatchSize: number;
@@ -3498,16 +3765,25 @@ declare class AdaptiveDataViewComponent<T = unknown> implements OnInit, OnChange
     /** Vista quando a tela é maior. Por padrão `grid`. */
     desktopView: AdaptiveDataViewMode;
     showDuplicateAction: boolean;
+    showPrintAction: boolean;
+    printActionLabel: string;
     showEditAction: boolean;
     showRemoveAction: boolean;
+    /** Chave da tela para persistência de layout AG Grid (repasse ao `app-data-grid`). */
+    layoutTelaKey: string | null;
+    /** Chave do grid na mesma tela. Omisso: `consulta-principal`. */
+    layoutGridKey: string;
     readonly edit: EventEmitter<T>;
     readonly duplicate: EventEmitter<T>;
+    readonly print: EventEmitter<T>;
     readonly remove: EventEmitter<T>;
     readonly loadMore: EventEmitter<void>;
     /** Corresponde ao breakpoint mobile. */
     isMobileLayout: boolean;
     /** Valor efectivo reposto ao grid / lista (respeita {@link loadingSkeletonMinMs}). */
     displayLoading: boolean;
+    /** Skeleton só quando `loading` e a lista ainda está vazia (cache / refresh mantém dados visíveis). */
+    private shouldShowLoadingSkeleton;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -3522,13 +3798,14 @@ declare class AdaptiveDataViewComponent<T = unknown> implements OnInit, OnChange
     get effectiveCardScrollMaxHeight(): string | null;
     get resultCountDisplay(): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdaptiveDataViewComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdaptiveDataViewComponent<any>, "app-adaptive-data-view", never, { "items": { "alias": "items"; "required": true; }; "gridColumns": { "alias": "gridColumns"; "required": true; }; "mapItem": { "alias": "mapItem"; "required": true; }; "pageSize": { "alias": "pageSize"; "required": false; }; "gridHeight": { "alias": "gridHeight"; "required": false; }; "cardScrollMaxHeight": { "alias": "cardScrollMaxHeight"; "required": false; }; "gridFitPaginationHeight": { "alias": "gridFitPaginationHeight"; "required": false; }; "gridFitPaginationMinEmptyRows": { "alias": "gridFitPaginationMinEmptyRows"; "required": false; }; "emptyMessageGrid": { "alias": "emptyMessageGrid"; "required": false; }; "emptyMessageCard": { "alias": "emptyMessageCard"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "showActionsColumn": { "alias": "showActionsColumn"; "required": false; }; "showCardItemActions": { "alias": "showCardItemActions"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "cardOpenOnClick": { "alias": "cardOpenOnClick"; "required": false; }; "scrollBatchSize": { "alias": "scrollBatchSize"; "required": false; }; "showCardFooter": { "alias": "showCardFooter"; "required": false; }; "headerPosition": { "alias": "headerPosition"; "required": false; }; "cardsPerRow": { "alias": "cardsPerRow"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "loadingSkeletonMinMs": { "alias": "loadingSkeletonMinMs"; "required": false; }; "showResultCount": { "alias": "showResultCount"; "required": false; }; "resultCountTemplate": { "alias": "resultCountTemplate"; "required": false; }; "mobileView": { "alias": "mobileView"; "required": false; }; "desktopView": { "alias": "desktopView"; "required": false; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; }, { "edit": "edit"; "duplicate": "duplicate"; "remove": "remove"; "loadMore": "loadMore"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdaptiveDataViewComponent<any>, "app-adaptive-data-view", never, { "items": { "alias": "items"; "required": true; }; "gridColumns": { "alias": "gridColumns"; "required": true; }; "mapItem": { "alias": "mapItem"; "required": true; }; "pageSize": { "alias": "pageSize"; "required": false; }; "gridHeight": { "alias": "gridHeight"; "required": false; }; "cardScrollMaxHeight": { "alias": "cardScrollMaxHeight"; "required": false; }; "gridFitPaginationHeight": { "alias": "gridFitPaginationHeight"; "required": false; }; "gridFitPaginationMinEmptyRows": { "alias": "gridFitPaginationMinEmptyRows"; "required": false; }; "emptyMessageGrid": { "alias": "emptyMessageGrid"; "required": false; }; "emptyMessageCard": { "alias": "emptyMessageCard"; "required": false; }; "pagination": { "alias": "pagination"; "required": false; }; "showActionsColumn": { "alias": "showActionsColumn"; "required": false; }; "showCardItemActions": { "alias": "showCardItemActions"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "editActionIconClass": { "alias": "editActionIconClass"; "required": false; }; "cardOpenOnClick": { "alias": "cardOpenOnClick"; "required": false; }; "scrollBatchSize": { "alias": "scrollBatchSize"; "required": false; }; "showCardFooter": { "alias": "showCardFooter"; "required": false; }; "headerPosition": { "alias": "headerPosition"; "required": false; }; "cardsPerRow": { "alias": "cardsPerRow"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "loadingSkeletonMinMs": { "alias": "loadingSkeletonMinMs"; "required": false; }; "showResultCount": { "alias": "showResultCount"; "required": false; }; "resultCountTemplate": { "alias": "resultCountTemplate"; "required": false; }; "mobileView": { "alias": "mobileView"; "required": false; }; "desktopView": { "alias": "desktopView"; "required": false; }; "showDuplicateAction": { "alias": "showDuplicateAction"; "required": false; }; "showPrintAction": { "alias": "showPrintAction"; "required": false; }; "printActionLabel": { "alias": "printActionLabel"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "layoutTelaKey": { "alias": "layoutTelaKey"; "required": false; }; "layoutGridKey": { "alias": "layoutGridKey"; "required": false; }; }, { "edit": "edit"; "duplicate": "duplicate"; "print": "print"; "remove": "remove"; "loadMore": "loadMore"; }, never, never, true, never>;
     static ngAcceptInputType_gridFitPaginationHeight: unknown;
     static ngAcceptInputType_gridFitPaginationMinEmptyRows: unknown;
     static ngAcceptInputType_cardOpenOnClick: unknown;
     static ngAcceptInputType_cardsPerRow: unknown;
     static ngAcceptInputType_loadingSkeletonMinMs: unknown;
     static ngAcceptInputType_showDuplicateAction: unknown;
+    static ngAcceptInputType_showPrintAction: unknown;
     static ngAcceptInputType_showEditAction: unknown;
     static ngAcceptInputType_showRemoveAction: unknown;
 }
@@ -3552,8 +3829,11 @@ declare class DataCardComponent implements OnChanges {
     /** Omisso / `true`: mostra o botão «Alterar» quando {@link showActions} é `true`. */
     showEditAction: boolean;
     editActionLabel: string;
+    editActionIconClass: string;
     /** Omisso / `true`: mostra o botão «Remover» quando {@link showActions} é `true`. */
     showRemoveAction: boolean;
+    /** Quando `true`, omite o botão «Alterar» neste cartão (ex.: ação por linha na consulta). */
+    hideEditAction: boolean;
     /**
      * Clique na superfície do cartão (fora dos botões de ação) emite {@link edit}, como o botão «Alterar».
      */
@@ -3564,15 +3844,17 @@ declare class DataCardComponent implements OnChanges {
         fieldKey: string;
         checked: boolean;
     }>;
+    protected get editActionIcon(): string;
     onCardShellClick(ev: MouseEvent): void;
     onEditClick(ev: Event): void;
     onRemoveClick(ev: Event): void;
     onBooleanFieldChange(field: CardItemBooleanField, ev: Event): void;
     onThumbError(ev: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataCardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataCardComponent, "app-data-card", never, { "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "avatarText": { "alias": "avatarText"; "required": false; }; "imageUrl": { "alias": "imageUrl"; "required": false; }; "metaFields": { "alias": "metaFields"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "showActions": { "alias": "showActions"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "openOnClick": { "alias": "openOnClick"; "required": false; }; }, { "edit": "edit"; "remove": "remove"; "booleanFieldChange": "booleanFieldChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataCardComponent, "app-data-card", never, { "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "avatarText": { "alias": "avatarText"; "required": false; }; "imageUrl": { "alias": "imageUrl"; "required": false; }; "metaFields": { "alias": "metaFields"; "required": false; }; "variant": { "alias": "variant"; "required": false; }; "showActions": { "alias": "showActions"; "required": false; }; "showEditAction": { "alias": "showEditAction"; "required": false; }; "editActionLabel": { "alias": "editActionLabel"; "required": false; }; "editActionIconClass": { "alias": "editActionIconClass"; "required": false; }; "showRemoveAction": { "alias": "showRemoveAction"; "required": false; }; "hideEditAction": { "alias": "hideEditAction"; "required": false; }; "openOnClick": { "alias": "openOnClick"; "required": false; }; }, { "edit": "edit"; "remove": "remove"; "booleanFieldChange": "booleanFieldChange"; }, never, never, true, never>;
     static ngAcceptInputType_showEditAction: unknown;
     static ngAcceptInputType_showRemoveAction: unknown;
+    static ngAcceptInputType_hideEditAction: unknown;
     static ngAcceptInputType_openOnClick: unknown;
 }
 
@@ -3715,12 +3997,15 @@ declare class StatCardComponent {
     delta: string;
     deltaTone: StatCardDeltaTone;
     clickable: boolean;
+    /** Destaque visual quando o cartão representa o filtro activo (ex.: totalizadores de consulta). */
+    selected: boolean;
     readonly cardActivate: EventEmitter<void>;
     onActivate(ev: Event): void;
     onKeydown(ev: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatCardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵ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 ɵcmp: _angular_core.ɵɵ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; }; "selected": { "alias": "selected"; "required": false; }; }, { "cardActivate": "cardActivate"; }, never, never, true, never>;
     static ngAcceptInputType_clickable: unknown;
+    static ngAcceptInputType_selected: unknown;
 }
 
 /**
@@ -3766,12 +4051,29 @@ declare class DataListComponent {
  * Bloco de dashboard: título, ações opcionais e conteúdo (stat-cards, listas, grades).
  * Superfície alinhada aos cartões da lib.
  */
-declare class DashboardSectionComponent {
+declare class DashboardSectionComponent implements OnChanges {
     title: string;
     subtitle: string;
+    /** Quando `true`, o cabeçalho exibe chevron e alterna aberto/fechado. */
+    collapsible: boolean;
+    /** Com `collapsible`: `true` = seção fechada (só cabeçalho), `false` = aberta. */
+    collapsed: boolean;
+    readonly collapsedChange: EventEmitter<boolean>;
     readonly titleId: string;
+    private collapsedInternal;
+    get hostCollapsible(): boolean;
+    get hostCollapsed(): boolean;
+    get hostExpanded(): boolean;
+    ngOnChanges(changes: SimpleChanges): void;
+    get isCollapsed(): boolean;
+    get headerInteractive(): boolean;
+    onHeaderClick(event: MouseEvent): void;
+    onHeaderKeydown(event: KeyboardEvent): void;
+    private toggleCollapsed;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DashboardSectionComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DashboardSectionComponent, "app-dashboard-section", never, { "title": { "alias": "title"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; }, {}, never, ["[dashboard-section-actions]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DashboardSectionComponent, "app-dashboard-section", never, { "title": { "alias": "title"; "required": true; }; "subtitle": { "alias": "subtitle"; "required": false; }; "collapsible": { "alias": "collapsible"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; }, { "collapsedChange": "collapsedChange"; }, never, ["[dashboard-section-actions]", "*"], true, never>;
+    static ngAcceptInputType_collapsible: unknown;
+    static ngAcceptInputType_collapsed: unknown;
 }
 
 /**
@@ -3862,6 +4164,12 @@ declare class TreeViewComponent implements OnChanges, OnInit, OnDestroy {
     filterSearchable: boolean;
     /** Placeholder do campo de filtro. */
     filterPlaceholder: string;
+    /** Título do empty state quando a pesquisa não encontra itens. */
+    filterEmptyMessage: string;
+    /** Subtítulo do empty state de pesquisa vazia. */
+    filterEmptyDescription: string;
+    /** Ícone Font Awesome do empty state de pesquisa vazia. */
+    filterEmptyIconClass: string;
     /**
      * Mostra ícone à esquerda do rótulo em ramos (pastas).
      * Omisso / `true`: ícone de pasta (ou `node.iconClass`); `false`: só caret + rótulo (mantém espaço com spacer).
@@ -3872,6 +4180,11 @@ declare class TreeViewComponent implements OnChanges, OnInit, OnDestroy {
      * Omisso / `true`: ícone por omissão (ou `node.iconClass`); `false`: spacer alinhado às linhas com ícone.
      */
     showLeafIcons: boolean;
+    /**
+     * Chave externa para repor `expandedIds` a partir de `node.expanded`, mesmo quando `nodes` não muda.
+     * Útil ao reentrar numa rota com reuse ou ao remontar a árvore sem substituir os nós.
+     */
+    expansionStateKey: unknown;
     readonly selectedIdChange: EventEmitter<string | null>;
     readonly nodeSelect: EventEmitter<TreeViewSelectEvent>;
     /** IDs de ramos expandidos. */
@@ -3903,7 +4216,7 @@ declare class TreeViewComponent implements OnChanges, OnInit, OnDestroy {
     private refreshExpandedForSearch;
     private expandAllBranchesRecursive;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeViewComponent, "app-tree-view", never, { "nodes": { "alias": "nodes"; "required": true; }; "title": { "alias": "title"; "required": false; }; "titleIconClass": { "alias": "titleIconClass"; "required": false; }; "folderIconClass": { "alias": "folderIconClass"; "required": false; }; "leafIconClass": { "alias": "leafIconClass"; "required": false; }; "selectedId": { "alias": "selectedId"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "mobileScrollCollapse": { "alias": "mobileScrollCollapse"; "required": false; }; "filterSearchable": { "alias": "filterSearchable"; "required": false; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; }; "showBranchIcons": { "alias": "showBranchIcons"; "required": false; }; "showLeafIcons": { "alias": "showLeafIcons"; "required": false; }; }, { "selectedIdChange": "selectedIdChange"; "nodeSelect": "nodeSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeViewComponent, "app-tree-view", never, { "nodes": { "alias": "nodes"; "required": true; }; "title": { "alias": "title"; "required": false; }; "titleIconClass": { "alias": "titleIconClass"; "required": false; }; "folderIconClass": { "alias": "folderIconClass"; "required": false; }; "leafIconClass": { "alias": "leafIconClass"; "required": false; }; "selectedId": { "alias": "selectedId"; "required": false; }; "maxHeight": { "alias": "maxHeight"; "required": false; }; "mobileScrollCollapse": { "alias": "mobileScrollCollapse"; "required": false; }; "filterSearchable": { "alias": "filterSearchable"; "required": false; }; "filterPlaceholder": { "alias": "filterPlaceholder"; "required": false; }; "filterEmptyMessage": { "alias": "filterEmptyMessage"; "required": false; }; "filterEmptyDescription": { "alias": "filterEmptyDescription"; "required": false; }; "filterEmptyIconClass": { "alias": "filterEmptyIconClass"; "required": false; }; "showBranchIcons": { "alias": "showBranchIcons"; "required": false; }; "showLeafIcons": { "alias": "showLeafIcons"; "required": false; }; "expansionStateKey": { "alias": "expansionStateKey"; "required": false; }; }, { "selectedIdChange": "selectedIdChange"; "nodeSelect": "nodeSelect"; }, never, never, true, never>;
     static ngAcceptInputType_filterSearchable: unknown;
     static ngAcceptInputType_showBranchIcons: unknown;
     static ngAcceptInputType_showLeafIcons: unknown;
@@ -4082,6 +4395,8 @@ declare class ConfirmDialogService {
 }
 
 declare const STRUCTRA_THEME_IDS: readonly ["blue", "green", "purple", "orange", "white", "gray", "sepia", "black"];
+/** Classe CSS do modo escuro (combinada com paleta `theme-*`). */
+declare const STRUCTRA_THEME_DARK_CLASS = "theme-dark";
 type StructraTheme = (typeof STRUCTRA_THEME_IDS)[number];
 
 /** Identificadores de paleta suportados pela library (uso em `AppThemeService.setTheme`). */
@@ -4108,12 +4423,15 @@ interface AppThemeOption {
  */
 declare class AppThemeService {
     private readonly activeId;
+    private readonly darkMode;
     /** Identificador do tema activo (`blue`, `green`, …). */
     readonly activeThemeId: _angular_core.Signal<"blue" | "green" | "purple" | "orange" | "white" | "gray" | "sepia" | "black">;
+    /** Modo escuro (superfícies/texto); a primária vem da paleta activa. */
+    readonly isDarkMode: _angular_core.Signal<boolean>;
     /**
      * Classes separadas (ex.: CDK `panelClass` — uma string com espaço quebra `classList.add`).
      */
-    readonly themeClassList: _angular_core.Signal<readonly [string, string]>;
+    readonly themeClassList: _angular_core.Signal<readonly string[]>;
     /**
      * As duas classes numa string — útil para `[class]`, `[ngClass]` com string, ou hosts HTML.
      * Ex.: `<div [ngClass]="libTheme.getTheme()">` aplica paleta completa no consumidor.
@@ -4121,7 +4439,7 @@ declare class AppThemeService {
     readonly getTheme: _angular_core.Signal<string>;
     /** Mapa para `[ngClass]` com chaves dinâmicas (painéis overlay). */
     readonly themeClassMap: _angular_core.Signal<{
-        [x: string]: boolean;
+        [k: string]: boolean;
     }>;
     /** Lista fixa de temas suportados pela library. */
     readonly themeOptions: readonly AppThemeOption[];
@@ -4131,6 +4449,7 @@ declare class AppThemeService {
      */
     readonly themePrimaryColorLabelPtBr: _angular_core.Signal<string>;
     setTheme(id: AppThemeId): void;
+    setDarkMode(enabled: boolean): void;
     isActive(id: AppThemeId): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppThemeService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AppThemeService>;
@@ -4148,21 +4467,25 @@ declare class ThemeDirective implements OnChanges {
     private readonly renderer;
     private readonly themeService;
     private _theme;
+    private _darkMode;
     set appTheme(value: StructraTheme | AppTheme | string | null | undefined);
     get appTheme(): StructraTheme | AppTheme;
+    /** Modo escuro combinado com a paleta de `appTheme`. */
+    set appThemeDark(value: boolean | string | null | undefined);
     private readonly themeTokenClasses;
     constructor(elementRef: ElementRef<HTMLElement>, renderer: Renderer2, themeService: AppThemeService);
     ngOnChanges(changes: SimpleChanges): void;
     private applyTheme;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ThemeDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ThemeDirective, "[appTheme]", never, { "appTheme": { "alias": "appTheme"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ThemeDirective, "[appTheme]", never, { "appTheme": { "alias": "appTheme"; "required": false; }; "appThemeDark": { "alias": "appThemeDark"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare const APP_THEME_BASE_CLASS = "app-library-theme";
+declare function isLegacyDarkThemeId(theme: string | null | undefined): boolean;
 declare function normalizeStructraTheme(theme: StructraTheme | string): StructraTheme;
 declare function getThemeTokenClass(theme: StructraTheme | string): string;
-declare function getThemeClassList(theme: StructraTheme | string): readonly [string, string];
-declare function getThemeClass(theme: StructraTheme | string): string;
+declare function getThemeClassList(theme: StructraTheme | string, darkMode?: boolean): readonly string[];
+declare function getThemeClass(theme: StructraTheme | string, darkMode?: boolean): string;
 
 /**
  * Tema efectivo para hosts/overlays: valor de `[appTheme]` quando definido; caso contrário
@@ -4172,9 +4495,9 @@ declare function injectEffectiveThemeId(appTheme: Signal<StructraTheme | AppThem
 
 /**
  * Remove classes de tema do host e, se `explicitTheme` estiver definido, aplica `.app-library-theme`
- * + `theme-*`. Caso contrário deixa o host sem paleta própria (herda do ancestral / wrapper).
+ * + `theme-*` (+ `theme-dark` opcional). Caso contrário deixa o host sem paleta própria.
  */
-declare function applyOptionalThemeHostClasses(renderer: Renderer2, element: HTMLElement, explicitTheme: StructraTheme | AppTheme | string | undefined | null): void;
+declare function applyOptionalThemeHostClasses(renderer: Renderer2, element: HTMLElement, explicitTheme: StructraTheme | AppTheme | string | undefined | null, darkMode?: boolean): void;
 
 /** Classes aplicadas ao painel CDK Dialog + tema da app. */
 declare function libDialogPanelClasses(theme: AppThemeService, extra?: string | string[]): string[];
@@ -4283,6 +4606,61 @@ declare class LoadingDialogService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<LoadingDialogService>;
 }
 
+interface OnboardingChecklistStep {
+    id: string;
+    title: string;
+    description: string;
+    route?: string;
+    completed: boolean;
+    actionLabel?: string;
+}
+interface OnboardingChecklistProgress {
+    completedCount: number;
+    totalSteps: number;
+    progressPercent: number;
+    currentStepId: string | null;
+}
+
+declare class OnboardingChecklistComponent {
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string>;
+    readonly badgeLabel: _angular_core.InputSignal<string>;
+    readonly badgeIcon: _angular_core.InputSignal<string>;
+    readonly steps: _angular_core.InputSignal<OnboardingChecklistStep[]>;
+    readonly loading: _angular_core.InputSignal<boolean>;
+    /** Sobrescreve a etapa corrente; se omitido, usa a primeira incompleta. */
+    readonly currentStepId: _angular_core.InputSignal<string | null | undefined>;
+    /** Quando omitido, exibe o rodapé enquanto houver etapas incompletas. */
+    readonly showFooter: _angular_core.InputSignal<boolean | undefined>;
+    readonly skipLabel: _angular_core.InputSignal<string>;
+    readonly continueLabel: _angular_core.InputSignal<string | undefined>;
+    readonly startLabel: _angular_core.InputSignal<string>;
+    /**
+     * Quando `false`, Escape e clique no backdrop não disparam `close`.
+     * Omisso: `true`.
+     */
+    readonly allowOverlayDismiss: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Exibe o botão ✕ no canto superior direito. Omisso: `false`. */
+    readonly showCloseButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly stepClick: _angular_core.OutputEmitterRef<OnboardingChecklistStep>;
+    readonly close: _angular_core.OutputEmitterRef<void>;
+    readonly skip: _angular_core.OutputEmitterRef<void>;
+    readonly continue: _angular_core.OutputEmitterRef<void>;
+    readonly progress: _angular_core.Signal<OnboardingChecklistProgress>;
+    readonly footerVisible: _angular_core.Signal<boolean>;
+    readonly resolvedContinueLabel: _angular_core.Signal<string>;
+    readonly loadingSkeletonRows: number[];
+    actionLabel(step: OnboardingChecklistStep): string;
+    onStepAction(step: OnboardingChecklistStep): void;
+    onClose(): void;
+    onDocumentKeydown(ev: KeyboardEvent): void;
+    onBackdropClick(): void;
+    onSkip(): void;
+    onContinue(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<OnboardingChecklistComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<OnboardingChecklistComponent, "app-onboarding-checklist", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "badgeLabel": { "alias": "badgeLabel"; "required": false; "isSignal": true; }; "badgeIcon": { "alias": "badgeIcon"; "required": false; "isSignal": true; }; "steps": { "alias": "steps"; "required": true; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "currentStepId": { "alias": "currentStepId"; "required": false; "isSignal": true; }; "showFooter": { "alias": "showFooter"; "required": false; "isSignal": true; }; "skipLabel": { "alias": "skipLabel"; "required": false; "isSignal": true; }; "continueLabel": { "alias": "continueLabel"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "allowOverlayDismiss": { "alias": "allowOverlayDismiss"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; }, { "stepClick": "stepClick"; "close": "close"; "skip": "skip"; "continue": "continue"; }, never, never, true, never>;
+}
+
 /**
  * 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.
@@ -4304,6 +4682,8 @@ declare class DropdownMenuComponent<T = string> {
     minWidthPx: number;
     /** Se `true`, a largura do painel segue a do trigger. */
     matchTriggerWidth: boolean;
+    /** Se `false`, o menu permanece aberto após selecionar um item (ex.: exportação assíncrona). */
+    closeOnSelect: boolean;
     menuId: string;
     readonly itemSelect: EventEmitter<T>;
     readonly openChange: EventEmitter<boolean>;
@@ -4323,8 +4703,9 @@ declare class DropdownMenuComponent<T = string> {
     onItemSelect(id: T): void;
     onCloseRequest(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownMenuComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵ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 ɵcmp: _angular_core.ɵɵ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; }; "closeOnSelect": { "alias": "closeOnSelect"; "required": false; }; "menuId": { "alias": "menuId"; "required": false; }; }, { "itemSelect": "itemSelect"; "openChange": "openChange"; }, never, ["*"], true, never>;
     static ngAcceptInputType_matchTriggerWidth: unknown;
+    static ngAcceptInputType_closeOnSelect: unknown;
 }
 
 declare class ContextMenuComponent<T = string> implements OnDestroy {
@@ -4560,7 +4941,7 @@ declare class AnchoredOverlayComponent {
     scrollStrategy: ScrollStrategy | null;
     readonly overlayPanelClasses: _angular_core.Signal<string[]>;
     readonly panelThemeNgClass: _angular_core.Signal<{
-        [x: string]: boolean;
+        [k: string]: boolean;
     }>;
     readonly defaultScrollStrategy: _angular_cdk_overlay.RepositionScrollStrategy;
     get effectiveScrollStrategy(): ScrollStrategy;
@@ -5034,6 +5415,65 @@ declare class AppShellSidebarToggleComponent {
     static ngAcceptInputType_collapsed: unknown;
 }
 
+/** Utilizador exibido no painel da sidebar administrativa. */
+interface StructraSidebarUserView {
+    id?: string;
+    nome?: string;
+    email?: string;
+    login?: string;
+    profileName?: string;
+}
+/** Contexto mínimo de empresa/plano para badge na sidebar (consumidor pode enviar mais campos). */
+interface StructraSidebarEmpresaContext {
+    planoNome?: string | null;
+}
+
+declare class StructraSidebarUserPanelComponent {
+    readonly panelTooltip: _angular_core.InputSignal<string>;
+    readonly user: _angular_core.InputSignal<StructraSidebarUserView | null>;
+    readonly empresa: _angular_core.InputSignal<StructraSidebarEmpresaContext | null>;
+    readonly collapsed: _angular_core.InputSignal<boolean>;
+    readonly panelClick: _angular_core.OutputEmitterRef<void>;
+    readonly displayName: _angular_core.Signal<string>;
+    readonly initials: _angular_core.Signal<string>;
+    readonly planName: _angular_core.Signal<string | null>;
+    onPanelClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraSidebarUserPanelComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraSidebarUserPanelComponent, "structra-sidebar-user-panel, app-admin-sidebar-user-panel", never, { "panelTooltip": { "alias": "panelTooltip"; "required": false; "isSignal": true; }; "user": { "alias": "user"; "required": false; "isSignal": true; }; "empresa": { "alias": "empresa"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; }, { "panelClick": "panelClick"; }, never, never, true, never>;
+}
+
+/** Rodapé institucional (login e área autenticada): textos via DI ou input `parts`. */
+declare class StructraPageFooterComponent {
+    private readonly configuredParts;
+    /** Sobrescreve partes do rodapé (omisso: {@link STRUCTRA_PAGE_FOOTER_PARTS} ou fallback genérico). */
+    readonly partsInput: _angular_core.InputSignal<readonly string[] | null>;
+    readonly parts: _angular_core.Signal<readonly string[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraPageFooterComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraPageFooterComponent, "structra-page-footer, app-page-footer", never, { "partsInput": { "alias": "parts"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Configuração declarativa do rodapé institucional (login e área autenticada). */
+interface StructraPageFooterConfig {
+    /** Nome do produto exibido no copyright (ex.: ErpTemplate). */
+    productName: string;
+    /** Versão exibida (ex.: 1.0.0). Omisso: omite a linha «Versão …». */
+    version?: string;
+    /** Ano do copyright. Omisso: ano corrente no cliente. */
+    copyrightYear?: number;
+    /** Partes extras após copyright e versão. */
+    extraParts?: readonly string[];
+}
+/** Partes literais do rodapé — alternativa à {@link StructraPageFooterConfig}. */
+declare const STRUCTRA_PAGE_FOOTER_PARTS: InjectionToken<readonly string[]>;
+/**
+ * Monta partes padrão: `© {ano} {produto}` e, se informado, `Versão {versão}`.
+ */
+declare function buildStructraPageFooterParts(config: StructraPageFooterConfig): readonly string[];
+/** Provider único no `app.config` — substitui `footer-meta.ts` por consumidor. */
+declare function provideStructraPageFooter(config: StructraPageFooterConfig): Provider;
+/** @deprecated Alias legado — preferir {@link provideStructraPageFooter}. */
+declare const provideAppPageFooter: typeof provideStructraPageFooter;
+
 /**
  * Barra superior com zonas de projeção: início, título, **subtítulo (opcional)** e fim.
  * Sem `[appTopbarSubtitle]` o bloco do subtítulo não ocupa espaço.
@@ -5117,6 +5557,78 @@ declare class AppBreadcrumbComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppBreadcrumbComponent, "app-breadcrumb", never, { "items": { "alias": "items"; "required": true; }; }, {}, never, never, true, never>;
 }
 
+/** Textos e mídia exibidos no shell de login administrativo (white-label). */
+interface AdminLoginShellConfig {
+    loginTitulo: string;
+    loginTextoDestaque: string;
+    loginSubtitulo: string;
+    loginTituloFormulario: string;
+    loginTextoBotaoEntrar: string;
+    loginMostrarEsqueciSenha: boolean;
+    loginMostrarCriarConta: boolean;
+    textoEsqueciSenha: string;
+    textoCriarConta: string;
+    heroImageSrc: string | null;
+    brandLogoSrc: string | null;
+}
+
+declare class AdminLoginShellComponent {
+    formGroup: FormGroup;
+    config: AdminLoginShellConfig;
+    loading: boolean;
+    error: string | null;
+    tenantInexistente: boolean;
+    tenantInexistenteMessage: string;
+    showFooter: boolean;
+    readonly submitted: EventEmitter<void>;
+    readonly brandLogoError: EventEmitter<void>;
+    readonly forgotPasswordClicked: EventEmitter<void>;
+    readonly createAccountClicked: EventEmitter<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminLoginShellComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdminLoginShellComponent, "structra-admin-login-shell", never, { "formGroup": { "alias": "formGroup"; "required": true; }; "config": { "alias": "config"; "required": true; }; "loading": { "alias": "loading"; "required": false; }; "error": { "alias": "error"; "required": false; }; "tenantInexistente": { "alias": "tenantInexistente"; "required": false; }; "tenantInexistenteMessage": { "alias": "tenantInexistenteMessage"; "required": false; }; "showFooter": { "alias": "showFooter"; "required": false; }; }, { "submitted": "submitted"; "brandLogoError": "brandLogoError"; "forgotPasswordClicked": "forgotPasswordClicked"; "createAccountClicked": "createAccountClicked"; }, never, ["[loginFields]", "[loginFooter]"], true, never>;
+}
+
+/** Payload emitido ao submeter o formulário de login administrativo. */
+interface AdminLoginSubmitPayload {
+    loginOuEmail: string;
+    senha: string;
+}
+
+declare class AdminLoginPageComponent implements OnChanges {
+    private readonly formBuilder;
+    private readonly cdr;
+    config: AdminLoginShellConfig;
+    loading: boolean;
+    error: string | null;
+    tenantInexistente: boolean;
+    tenantInexistenteMessage: string;
+    emailLabel: string;
+    emailErrorMessage: string;
+    passwordLabel: string;
+    passwordErrorMessage: string;
+    submitDisabled: boolean;
+    autocomplete: boolean;
+    /** Incremente para resetar campos do formulário (ex.: ao voltar para a rota de login). */
+    surfaceResetTrigger: number;
+    readonly loginSubmit: EventEmitter<AdminLoginSubmitPayload>;
+    readonly brandLogoError: EventEmitter<void>;
+    readonly forgotPasswordClicked: EventEmitter<void>;
+    readonly createAccountClicked: EventEmitter<void>;
+    private readonly brandLogoFailed;
+    readonly loginForm: _angular_forms.FormGroup<{
+        email: FormControl<string | null>;
+        password: FormControl<string | null>;
+    }>;
+    get effectiveShellConfig(): AdminLoginShellConfig;
+    ngOnChanges(changes: SimpleChanges): void;
+    onBrandLogoError(): void;
+    onSubmit(): void;
+    /** Reseta campos do formulário (loading/erro permanecem sob controle do consumidor). */
+    resetSurface(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AdminLoginPageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AdminLoginPageComponent, "structra-admin-login-page", never, { "config": { "alias": "config"; "required": true; }; "loading": { "alias": "loading"; "required": false; }; "error": { "alias": "error"; "required": false; }; "tenantInexistente": { "alias": "tenantInexistente"; "required": false; }; "tenantInexistenteMessage": { "alias": "tenantInexistenteMessage"; "required": false; }; "emailLabel": { "alias": "emailLabel"; "required": false; }; "emailErrorMessage": { "alias": "emailErrorMessage"; "required": false; }; "passwordLabel": { "alias": "passwordLabel"; "required": false; }; "passwordErrorMessage": { "alias": "passwordErrorMessage"; "required": false; }; "submitDisabled": { "alias": "submitDisabled"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "surfaceResetTrigger": { "alias": "surfaceResetTrigger"; "required": false; }; }, { "loginSubmit": "loginSubmit"; "brandLogoError": "brandLogoError"; "forgotPasswordClicked": "forgotPasswordClicked"; "createAccountClicked": "createAccountClicked"; }, never, ["[loginExtraContent]", "[loginFooter]"], true, never>;
+}
+
 /** Alinhado ao backend (`DynamicConsultaWhereBuilder`): operadores em minúsculas. */
 type ConsultaValorTipo = 'string' | 'bool' | 'datetime' | 'number';
 interface ConsultaCampoDef {
@@ -5162,7 +5674,7 @@ interface ConsultaFiltroPreset<TColuna extends string = string> {
 declare const OPS_TEXTO: readonly ConsultaOperadorOption[];
 declare const OPS_BOOL: readonly ConsultaOperadorOption[];
 declare const OPS_DATA: readonly ConsultaOperadorOption[];
-/** Campos com multi-seleção no metadata (ex.: categorias — operador fixo `inlist` no servidor; rótulo «Contém» na UI). */
+/** Campos com multi-seleção no metadata (operador fixo `inlist` no servidor). */
 declare const OPS_TEXTO_MULTISELECT: readonly ConsultaOperadorOption[];
 /**
  * Colunas `datetime`: usar `app-date-field` para qualquer operador excepto `between`
@@ -6272,6 +6784,17 @@ interface ConsultaPageRuntime {
          * Omissão: não normaliza operadores (retrocompat).
          */
         valorTipoPorColuna?: (coluna: string) => ConsultaValorTipo;
+        /**
+         * Montagem de filtros avulsos em tempo de execução (ex.: override de {@link montarFiltrosListaConsulta} na página).
+         * Omissão: usa o montador interno do runtime builder.
+         */
+        montarFiltrosListaConsulta?: (preset: ConsultaFiltroPreset<string> | undefined, valores: Record<string, string>, boolColumnIds: readonly string[], valorTipoPorColuna?: (coluna: string) => ConsultaValorTipo) => Array<{
+            campo: string;
+            operador: string;
+            valor: string;
+            valorAte: string;
+            juncao: string;
+        }>;
     }) => Promise<{
         itens: unknown[];
         total: number;
@@ -6291,6 +6814,13 @@ interface ConsultaPageRuntime {
      * Omissão na página base: 15.
      */
     consultaListaCacheMaxPaginas?: number;
+    /**
+     * Chave da tela para persistência de layout AG Grid (tenant + tela + grid).
+     * Omisso: usa {@link consultaListaCacheNamespace} quando definido.
+     */
+    layoutTelaKey?: string;
+    /** Chave do grid na consulta. Omisso: `consulta-principal`. */
+    layoutGridKey?: string;
     /**
      * Monta os mesmos `filtrosAvulsos` que o fluxo servidor usa em {@link carregarListaComConsulta}.
      * Obrigatório para activar cache quando {@link consultaListaCacheNamespace} está definido.
@@ -6312,9 +6842,14 @@ interface ConsultaPageRuntime {
     itemPassaConsulta: (item: unknown, itens: ConsultaFiltroItem<string>[], valoresPorItemId: Record<string, string>) => boolean;
     editar?: (row: Record<string, unknown>) => void;
     duplicar?: (row: Record<string, unknown>) => void;
+    imprimir?: (row: Record<string, unknown>) => void;
     remover?: (row: Record<string, unknown>) => Promise<void> | void;
     /** `true` quando `[DuplicateConfig(Enabled = true)]` no layout da página. */
     showDuplicateAction?: boolean;
+    /** `true` quando a página define ação «Imprimir» por linha. */
+    showPrintAction?: boolean;
+    /** Tooltip/aria do botão imprimir na coluna Ações. Omisso ⇒ «Imprimir». */
+    printActionLabel?: string;
     /**
      * Após {@link remover} com sucesso, em vez de retirar a linha da lista, actualiza-a com `ativo: false`
      * (inativação local alinhada ao soft-delete no servidor). Omissão: remove a linha pelo `id`.
@@ -6339,6 +6874,8 @@ interface ConsultaPageRuntime {
     novoRouterLink?: string | unknown[];
     /** Coluna Ações: tooltip/aria do botão de abrir registo. */
     editActionLabel: string;
+    /** Coluna Ações: ícone Font Awesome do botão editar (ex.: `fa-paper-plane`). */
+    editActionIconClass?: string;
     novoAriaLabel?: string;
     toastTitleLista: string;
     /** Avisos na consulta (ex. validação de filtros) — omissão: {@link toastTitleLista}. */
@@ -6369,6 +6906,110 @@ interface ConsultaPageRuntime {
         title: string;
         message: (nome: string) => string;
     };
+    /**
+     * Quando `true`, a página base não altera título/subtítulo/end da topbar da shell
+     * (ex.: consulta embutida na página de relatórios).
+     */
+    omitirTopbarShellOverride?: boolean;
+}
+
+/** Separador interno entre scope e chave lógica. */
+declare const STRUCTRA_PAGE_CACHE_SCOPE_SEP = "\u001F";
+interface StructraPageCacheGetOrLoadOptions {
+    ttlMs?: number;
+    force?: boolean;
+    scope?: string;
+}
+interface StructraPageCacheSetOptions {
+    ttlMs?: number;
+    scope?: string;
+}
+/**
+ * Cache genérico em memória para páginas/rotas administrativas.
+ * Suporta TTL opcional, isolamento por scope (rota/tenant) e deduplicação de loaders simultâneos.
+ * Perdido ao recarregar a aplicação (F5).
+ */
+declare class StructraPageCacheService {
+    private readonly entries;
+    private readonly inFlight;
+    getOrLoad<T>(key: string, loader: () => Observable<T>, options?: StructraPageCacheGetOrLoadOptions): Observable<T>;
+    get<T>(key: string, scope?: string): T | null;
+    set<T>(key: string, value: T, options?: StructraPageCacheSetOptions): void;
+    invalidate(key: string, scope?: string): void;
+    invalidateScope(scope: string): void;
+    clear(): void;
+    /** Presença bruta (ignora TTL) — útil para testes. */
+    hasEntry(key: string, scope?: string): boolean;
+    private buildScopedKey;
+    private readEntry;
+    private writeEntry;
+    private deleteEntry;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraPageCacheService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<StructraPageCacheService>;
+}
+/**
+ * Monta scope estável para cache por rota administrativa (ex.: `/home/personalizacao`).
+ * Quando informado, inclui tenant/empresa para isolar sessões multi-tenant.
+ */
+declare function buildStructraPageCacheRouteScope(routePath: string, tenantId?: string | null): string;
+/** Chave lógica para cache de `initCadastro` por entidade e id de rota. */
+declare function buildStructraPageCacheCadastroInitKey(entityKey: string, routeId: string): string;
+/** Scope efectivo combinando scope extra (tenant) com a rota do cadastro. */
+declare function resolveStructraPageCacheCadastroScope(routePath: string, pageCacheScope?: string, tenantId?: string | null): string;
+
+/** Prefixo lógico para chaves de redirect administrativo em {@link StructraPageCacheService}. */
+declare const STRUCTRA_ADMIN_ROUTE_REDIRECT_CACHE_PREFIX = "admin-route-redirect";
+/** Chave típica para redirect de personalização/login (`login-id`). */
+declare const STRUCTRA_ADMIN_ROUTE_REDIRECT_LOGIN_ID_CACHE_KEY: string;
+declare function buildStructraAdminRouteRedirectCacheKey(logicalKey: string): string;
+declare function normalizeStructraAdminPath(url: string): string;
+/**
+ * Evita navegação redundante quando o utilizador clica de novo no mesmo item de menu
+ * (ex.: já está em `/home/personalizacao/:id` e o menu aponta para `/home/personalizacao`).
+ */
+declare function shouldSkipStructraAdminMenuNavigation(menuUrl: string, currentPath: string): boolean;
+interface ResolveStructraAdminMenuUrlOptions {
+    /** Quando o menu aponta para rota “vazia” que redireciona (ex.: personalização), usa destino já resolvido. */
+    resolveCachedChildPath?: () => string | null | undefined;
+}
+/** Resolve URL final do menu, preferindo destino filho em cache quando disponível. */
+declare function resolveStructraAdminMenuUrl(menuUrl: string, options?: ResolveStructraAdminMenuUrlOptions): string;
+interface StructraAdminRouteRedirectCacheOptions {
+    cacheKey: string;
+    routePath: string;
+    tenantId?: string | null;
+}
+/** Lê destino de redirect já resolvido (sem ir à rede). */
+declare function readStructraAdminRouteRedirectTarget(pageCache: StructraPageCacheService, options: StructraAdminRouteRedirectCacheOptions): string | null;
+/** Monta URL filha padrão (`/base/:id`) a partir do id em cache. */
+declare function buildStructraAdminRouteRedirectChildUrl(routePath: string, targetId: string | null | undefined): string | null;
+interface StructraAdminRouteRedirectLoadOptions extends StructraAdminRouteRedirectCacheOptions {
+    loader: () => Observable<string | null>;
+    force?: boolean;
+}
+/** Carrega destino de redirect com cache em memória (dedupe + TTL opcional). */
+declare function loadStructraAdminRouteRedirectTarget(pageCache: StructraPageCacheService, options: StructraAdminRouteRedirectLoadOptions): Observable<string | null>;
+
+/**
+ * Base para páginas vazias que resolvem um id via backend e redirecionam para rota filha.
+ * O resultado fica em {@link StructraPageCacheService} — reabrir o menu não refaz a RPC.
+ */
+declare abstract class StructraAdminRouteRedirectPageBase implements OnInit {
+    protected readonly router: Router;
+    protected readonly pageCache: StructraPageCacheService;
+    /** Rota base do redirect (ex.: `/home/personalizacao`). */
+    protected abstract readonly redirectRoutePath: string;
+    /** Chave lógica em cache (ex.: {@link STRUCTRA_ADMIN_ROUTE_REDIRECT_LOGIN_ID_CACHE_KEY}). */
+    protected abstract readonly redirectCacheKey: string;
+    protected abstract readonly fallbackNavigateUrl: string;
+    /** Loader que devolve o id de destino (ou null quando inválido). */
+    protected abstract loadRedirectTarget(): Observable<string | null>;
+    /** Scope multi-tenant opcional para isolar cache por empresa. */
+    protected resolveRedirectTenantId(): string | null | undefined;
+    ngOnInit(): void;
+    protected runRedirect(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraAdminRouteRedirectPageBase, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<StructraAdminRouteRedirectPageBase, never, never, {}, {}, never, never, true, never>;
 }
 
 /** Separador entre namespace da consulta e corpo JSON estável da chave composta. */
@@ -6473,6 +7114,115 @@ declare class ConsultaListaMemoriaCacheService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ConsultaListaMemoriaCacheService>;
 }
 
+/** Payload persistido em `str_layout_json` (versão + estado de colunas AG Grid). */
+interface GridLayoutConsultaPersistedPayload {
+    version: number;
+    columnState: unknown[];
+    savedAt: string;
+}
+interface GridLayoutConsultaApiDto {
+    tela: string;
+    grid: string;
+    layoutJson: string;
+}
+type StructraGridLayoutTenantResolverFn = () => string | null | undefined;
+type StructraGridLayoutApiBaseResolverFn = () => string;
+type StructraGridLayoutAuthHeadersResolverFn = () => Record<string, string>;
+/**
+ * Tenant atual para chave de cache em memória (`tenant:tela:grid`).
+ * A app deve fornecer (ex.: `SessionContextService.tenantAtualId`).
+ */
+declare const STRUCTRA_GRID_LAYOUT_TENANT_RESOLVER: InjectionToken<StructraGridLayoutTenantResolverFn>;
+/** Base URL da API REST (sem barra final). Omisso: `window.location.origin`. */
+declare const STRUCTRA_GRID_LAYOUT_API_BASE_RESOLVER: InjectionToken<StructraGridLayoutApiBaseResolverFn>;
+/** Headers de autenticação para GET/PUT do layout (ex.: JWT). */
+declare const STRUCTRA_GRID_LAYOUT_AUTH_HEADERS_RESOLVER: InjectionToken<StructraGridLayoutAuthHeadersResolverFn>;
+
+declare class GridLayoutConsultaService {
+    private readonly http;
+    private readonly tenantResolver;
+    private readonly apiBaseResolver;
+    private readonly authHeadersResolver;
+    private readonly memoryCache;
+    /** Incrementado a cada gravação local — impede GET async de apagar layout mais recente. */
+    private readonly layoutRevisionByKey;
+    /** Chaves já consultadas no backend nesta sessão (evita GET repetido ao navegar). */
+    private readonly backendFetchedKeys;
+    private readonly inFlightByKey;
+    private saveTimer;
+    private tenantRetryTimer;
+    /** Re-tenta GET quando o tenant ainda não hidratou (F5) e sessionStorage não tinha layout. */
+    private tenantRetryGetLayoutTimer;
+    private pendingGetLayout;
+    private pendingSave;
+    /** Detecta transição `_` → tenant real para migrar cache e retomar PUT pendente. */
+    private resolvedTenantForCache;
+    /** Ouve quando layout entra em cache (GET backend / migração tenant) — grelha reaplica no F5. */
+    private readonly layoutCacheUpdatedListeners;
+    /** Subscrição para reaplicar layout quando o GET async concluir (ex.: F5 com tenant a hidratar). */
+    onLayoutCacheUpdated(listener: (cacheKey: string) => void): () => void;
+    /**
+     * Leitura síncrona: memória → sessionStorage. Não dispara HTTP.
+     * Usar antes do primeiro paint da grelha para aplicar colunas sem flicker.
+     */
+    getCachedLayout(tela: string, grid?: string): GridLayoutConsultaPersistedPayload | null;
+    /** Indica se o backend já foi consultado nesta sessão para `tenant:tela:grid`. */
+    hasFetchedFromBackend(tela: string, grid?: string): boolean;
+    /** Compara chave interna `tenant:tela:grid` com tela/grid visíveis ao consumidor (ex.: listener do data-grid). */
+    cacheKeyMatchesTelaGrid(cacheKey: string, tela: string, grid?: string): boolean;
+    getLayout(tela: string, grid?: string): Promise<GridLayoutConsultaPersistedPayload | null>;
+    saveLayout(tela: string, grid: string, layoutJson: string): void;
+    saveLayoutFromColumnState(tela: string, grid: string, columnState: unknown[]): void;
+    private fetchLayoutFromBackend;
+    /**
+     * Após GET async: preserva layout local/gravação pendente se o utilizador alterou colunas entretanto.
+     * `undefined` = aplicar resposta remota normalmente.
+     */
+    private resolveLocalLayoutAfterFetch;
+    private isRemoteLayoutNewer;
+    private bumpLayoutRevision;
+    private getLayoutRevision;
+    private markBackendFetched;
+    private storeLayout;
+    private notifyLayoutCacheUpdated;
+    private scheduleDebouncedSave;
+    private flushSave;
+    /** Re-tenta GET quando sessionStorage estava vazio e o tenant ainda não hidratou (F5). */
+    private scheduleTenantRetryGetLayout;
+    /** Re-tenta PUT quando o tenant ainda não hidratou (F5) ou após falha transitória. */
+    private scheduleTenantRetryFlush;
+    private normalizeKeys;
+    private buildCacheKey;
+    private resolveTenantIdForCache;
+    private tenantReadyForBackend;
+    private noteTenantResolution;
+    /**
+     * Migra entradas gravadas com tenant `_` para o tenant real quando a sessão hidrata (F5).
+     * Preserva layout em memória/sessionStorage e retoma PUT pendente.
+     */
+    private migratePlaceholderCacheToRealTenant;
+    private persistLastTenantId;
+    private readLastTenantId;
+    private sessionStorageKey;
+    /**
+     * Lê layout em sessionStorage pela chave exacta ou, em F5, por sufixo `:tela:grid`
+     * quando o tenant ainda não estava disponível na 1.ª leitura.
+     */
+    private readSessionStorageForLayout;
+    private scanSessionStorageByTelaGrid;
+    /**
+     * `undefined` = ausente em sessionStorage; `null` = layout vazio persistido.
+     */
+    private readSessionStorage;
+    private writeSessionStorage;
+    private removeSessionStorage;
+    private apiUrl;
+    private authHeaders;
+    private parseLayoutJson;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridLayoutConsultaService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<GridLayoutConsultaService>;
+}
+
 /**
  * Vista unificada da metadata da página (consulta + títulos/layout + snapshot opcional do cadastro declarativo).
  * Piloto: Pessoa — outras entidades podem omitir {@link ConsultaPageMetadataUnified.cadastro}.
@@ -6640,8 +7390,11 @@ interface ConsultaCrudAdapterConfig<TItem, TRow extends Record<string, unknown>,
     itemPassaConsulta?: ConsultaPageRuntime['itemPassaConsulta'];
     editar?: (row: Record<string, unknown>) => void;
     duplicar?: (row: Record<string, unknown>) => void;
+    imprimir?: (row: Record<string, unknown>) => void;
     remover?: (row: Record<string, unknown>) => Promise<void> | void;
     showDuplicateAction?: boolean;
+    showPrintAction?: boolean;
+    printActionLabel?: string;
     confirmDuplicarLinha?: ConsultaPageRuntime['confirmDuplicarLinha'];
     duplicateSuccessMessage?: string;
     /**
@@ -6655,6 +7408,8 @@ interface ConsultaCrudAdapterConfig<TItem, TRow extends Record<string, unknown>,
     showNovoButton?: boolean;
     /** Omissão: `'Alterar'` (ou `grid_config.edit_action_label` na factory padrão). */
     editActionLabel?: string;
+    /** Omissão: `fa-pen-to-square`. */
+    editActionIconClass?: string;
     /** Omissão: `'Novo registro'`. */
     novoAriaLabel?: string;
     /** Omissão: `'Consulta'`. */
@@ -6902,7 +7657,7 @@ interface ConsultaCatalogBundleConfig<TMetadataReply, TFiltroPreset> {
     chaveConsulta: string;
     ensureAuth: () => Promise<void>;
     getMetadata: () => Promise<TMetadataReply>;
-    /** `SELECT COUNT(*)` em cabeçalhos `filtro` (sem `filtro_item`). */
+    /** `SELECT COUNT(*)` em cabeçalhos `tbl_filtro` (sem `tbl_filtro_item`). */
     contarFiltrosCabecalhos: () => Promise<number>;
     listarFiltros: () => Promise<{
         filtros?: FiltroSalvo[];
@@ -7070,6 +7825,8 @@ declare class ConsultaCadastroFiltroDialogComponent {
     readonly itemDraftSearchSelectOpcoesMescladas: _angular_core.Signal<UiSelectOption<string>[]>;
     /** `null`: usar {@link itemDraftSearchSelectOpcoesMescladas}; senão lista já filtrada pela pesquisa. */
     readonly itemDraftSearchSelectOpcoesPainel: _angular_core.WritableSignal<UiSelectOption<string>[] | null>;
+    /** Descarta respostas obsoletas quando abertura e pesquisa correm em paralelo no draft. */
+    private draftSearchSelectPageReqGen;
     readonly itemDraftSearchSelectOpcoesParaTemplate: _angular_core.Signal<UiSelectOption<string>[]>;
     private itemDraftColunaLimpezaProgramatica;
     readonly dialogCadastroValidationItems: _angular_core.WritableSignal<ValidationSummaryItem[]>;
@@ -7117,6 +7874,7 @@ declare class ConsultaCadastroFiltroDialogComponent {
     isFilterSelectColuna(col: string | null | undefined): boolean;
     isSearchSelectColuna(col: string | null | undefined): boolean;
     onDraftSearchSelectPageRequested(ev: DropdownSearchPageRequested): Promise<void>;
+    private opcoesRemotasCampoJaCarregadas;
     onDraftMultiselectPageRequested(ev: SelectPageRequested): Promise<void>;
     isNumeroColuna(col: string | null | undefined): boolean;
     isDatetimeColuna(col: string | null | undefined): boolean;
@@ -7161,7 +7919,7 @@ declare class ConsultaBasePageComponent implements OnInit, AfterViewInit, OnDest
     private readonly confirm;
     private readonly toast;
     private readonly topbarSlot;
-    private readonly topbarTitleSkeleton;
+    protected readonly topbarTitleSkeleton: _angular_core.WritableSignal<boolean>;
     private readonly listaMemoriaCache;
     private readonly router;
     private readonly routeReuse;
@@ -7189,6 +7947,10 @@ declare class ConsultaBasePageComponent implements OnInit, AfterViewInit, OnDest
      * Opções mostradas no painel do `search_select` por id do critério do preset (filtradas localmente pela query).
      */
     private readonly consultaSearchSelectOpcoesPainelPorItemId;
+    /** Descarta respostas obsoletas quando abertura (query vazia) e pesquisa (query com texto) correm em paralelo. */
+    private readonly searchSelectPageReqGenByItemId;
+    private readonly multiselectRemotoLoadGenByCampo;
+    private readonly multiselectRemotoLoadPromiseByCampo;
     readonly consultaSearchSelectPageSize = 96;
     /** Runtime com filtros/grelha alinhados ao metadata quando disponível. */
     readonly runtimeConsulta: _angular_core.Signal<ConsultaPageRuntime>;
@@ -7289,12 +8051,17 @@ declare class ConsultaBasePageComponent implements OnInit, AfterViewInit, OnDest
     isFilterSelectColuna(col: string | null | undefined): boolean;
     isSearchSelectColuna(col: string | null | undefined): boolean;
     private limparOpcoesPainelSearchSelectConsulta;
-    /** Opções do dropdown com pesquisa (painel filtrado ou lista mesclada por defeito). */
+    /**
+     * Opções do painel do `search_select`.
+     * Sem overlay explícito, não devolve a lista remota completa (pré-carga) — evita flash de todas as marcas
+     * antes da primeira `pageRequested`; com valor seleccionado mantém merge para o rótulo no input.
+     */
     consultaSearchSelectOpcoesPainel(it: ConsultaFiltroItem<string>): UiSelectOption<string>[];
     onConsultaSearchSelectPageRequested(it: ConsultaFiltroItem<string>, ev: DropdownSearchPageRequested): Promise<void>;
     onConsultaMultiselectPageRequested(coluna: string, ev: SelectPageRequested): Promise<void>;
     /** Repasse ao diálogo de filtro: mesmo carregamento remoto que no painel principal. */
     readonly recarregarOpcoesMultiselectCampo: (campo: string) => Promise<void>;
+    private opcoesRemotasCampoJaCarregadas;
     private aplicarOpcoesMultiselectRemotasCampo;
     private precarregarOpcoesMultiselectRemotasInicial;
     /** Critérios numéricos no metadata (`decimal`, `integer`, …) — input decimal + operadores de comparação. */
@@ -7372,6 +8139,11 @@ declare class ConsultaBasePageComponent implements OnInit, AfterViewInit, OnDest
      * para respostas muito rápidas não «saltarem» o estado de carregamento.
      */
     private yieldForSkeletonPaint;
+    /**
+     * Activa loading explícito e esvazia a grelha para o skeleton (Structra: overlay só com lista vazia).
+     * Painel de filtros e chrome permanecem visíveis.
+     */
+    private iniciarLoadingGrelhaComSkeleton;
     /** Respeita {@link CONSULTA_LISTA_SKELETON_MIN_MS} após mostrar skeleton dos critérios de filtro. */
     private yieldUntilMinFiltroSkeletonMs;
     /** Pesquisa válida: skeleton na grelha + nova leitura do servidor e só então aplica o preset consultado. */
@@ -7379,6 +8151,7 @@ declare class ConsultaBasePageComponent implements OnInit, AfterViewInit, OnDest
     carregarTodos(): Promise<void>;
     editar(row: Record<string, unknown>): void;
     duplicar(row: Record<string, unknown>): Promise<void>;
+    imprimir(row: Record<string, unknown>): void;
     excluirUsuario(row: Record<string, unknown>): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ConsultaBasePageComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ConsultaBasePageComponent, "app-consulta-base-page", never, { "runtime": { "alias": "runtime"; "required": true; "isSignal": true; }; "topbarEndExtraTemplate": { "alias": "topbarEndExtraTemplate"; "required": false; "isSignal": true; }; "tooltipBotaoPesquisar": { "alias": "tooltipBotaoPesquisar"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -7448,8 +8221,11 @@ interface CreateConsultaPadraoRuntimeOptions<TItem, TRow extends Record<string,
     mapGridRow?: (item: TItem) => TRow;
     mapCard?: CardListMapFn<TRow>;
     editar?: ConsultaCrudAdapterConfig<TItem, TRow, TPreset>['editar'];
+    imprimir?: ConsultaCrudAdapterConfig<TItem, TRow, TPreset>['imprimir'];
     remover?: ConsultaCrudAdapterConfig<TItem, TRow, TPreset>['remover'];
     removerActualizaAtivoEmVezDeRetirar?: boolean;
+    showPrintAction?: boolean;
+    printActionLabel?: string;
     novoRouterLink?: string | unknown[];
     toastTitleLista?: string;
     confirmRemoverLinha?: ConsultaPageRuntime['confirmRemoverLinha'];
@@ -7650,6 +8426,12 @@ interface CadastroValidationUi {
      */
     readonly beforeSummaryItemActivate?: ((item: ValidationSummaryItem) => void) | null;
 }
+/** Acção opcional à esquerda de Salvar/Novo na topbar ou toolbar interna do cadastro. */
+interface CadastroHeaderSecondaryAction {
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+}
 type CadastroModo = 'novo' | 'editar';
 interface CadastroPageRuntime<TResponse = unknown> {
     modo: Signal<CadastroModo>;
@@ -8023,6 +8805,8 @@ interface BuildCadastroPageRuntimeOptions {
      * Omisso: `id` vem de `ActivatedRoute`. Em dialog de referência, passar o id explícito (`novo` ou guid).
      */
     entityIdFromContext?: Signal<string | null | undefined>;
+    /** Invalida cache de `initCadastro` após gravar/excluir (Structra page cache). */
+    invalidateCadastroInitPageCache?: (routeId: string) => void;
 }
 /**
  * Constrói o runtime de uma página de cadastro (novo/editar): carregamento, salvar, cancelar, excluir opcional,
@@ -8920,6 +9704,17 @@ interface CadastroMetadataPageStateConfig<TInit, TDto, TSalvar> {
      * em vez do próprio `init`.
      */
     sourceKey?: string;
+    /**
+     * Scope opcional para {@link StructraPageCacheService} (ex.: tenant/empresa).
+     * Omisso: scope derivado da rota do cadastro.
+     */
+    pageCacheScope?: string;
+    /** Desliga cache de `initCadastro` entre navegações pelo menu (por defeito activo). */
+    cadastroInitPageCacheDisabled?: boolean;
+    /** TTL do cache de init (ms). Omisso: sem expiração até invalidação ou F5. */
+    cadastroInitCacheTtlMs?: number;
+    /** Identificador lógico da entidade na chave de cache de init. Omisso: rota ou `sourceKey`. */
+    cadastroInitCacheEntityKey?: string;
     /** Referências inline (dropdown + rascunho + resultado); a base orquestra ciclo de vida. */
     referenciasInline?: readonly CadastroInlineReferencePart[];
     /**
@@ -9230,6 +10025,10 @@ declare abstract class CadastroMetadataPageStateBase<TInit, TDto, TSalvar> {
     protected resolveLeafActivatedRoute(): ActivatedRoute;
     /** Path do cadastro anfitrião para rascunhos inline; modal sobrescreve com {@link CADASTRO_REFERENCIA_DIALOG_CONTEXT}. */
     protected resolveHostPathCadastroForInlineDraft(): string;
+    protected resolveCadastroInitPageCacheEntityKey(): string;
+    protected resolveCadastroInitPageCacheScope(): string;
+    protected invalidateCadastroInitPageCache(routeId: string): void;
+    protected loadCadastroInitForRouteId(id: string): Observable<TInit>;
     protected static isCadastroLeafSegment(leafPath: string | undefined): boolean;
     /**
      * Regresso de RotaReferência com instância ainda em memória (`RouteReuseStrategy` + `data.reuse`):
@@ -9342,6 +10141,9 @@ declare class CadastroMetadataPageComponent {
     readonly embeddedInPageShell: _angular_core.InputSignal<boolean>;
     readonly salvarSubmit: _angular_core.OutputEmitterRef<void>;
     readonly toolbarButtonClick: _angular_core.OutputEmitterRef<CadastroToolbarButtonDto>;
+    readonly headerSecondaryAction: _angular_core.InputSignal<CadastroHeaderSecondaryAction | null>;
+    readonly headerSecondaryActionClick: _angular_core.OutputEmitterRef<void>;
+    protected readonly headerSecondaryActionVisible: _angular_core.Signal<boolean>;
     readonly tituloSection: _angular_core.InputSignal<string | null>;
     readonly subtituloSection: _angular_core.InputSignal<string | null>;
     /** Metadata efectiva: input da shell ou bundle vindo do {@link CadastroMetadataView}. */
@@ -9369,7 +10171,7 @@ declare class CadastroMetadataPageComponent {
     sectionTitulo(c: CadastroMetadataPageCadastro): string;
     sectionSubtitulo(c: CadastroMetadataPageCadastro): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CadastroMetadataPageComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroMetadataPageComponent, "app-cadastro-metadata-page", never, { "entityName": { "alias": "entityName"; "required": true; "isSignal": true; }; "entityLabel": { "alias": "entityLabel"; "required": true; "isSignal": true; }; "cadastro": { "alias": "cadastro"; "required": false; "isSignal": true; }; "initError": { "alias": "initError"; "required": false; "isSignal": true; }; "initLoading": { "alias": "initLoading"; "required": false; "isSignal": true; }; "validationUi": { "alias": "validationUi"; "required": false; "isSignal": true; }; "searchSelectBindings": { "alias": "searchSelectBindings"; "required": false; "isSignal": true; }; "listSelectBindings": { "alias": "listSelectBindings"; "required": false; "isSignal": true; }; "multiselectBindings": { "alias": "multiselectBindings"; "required": false; "isSignal": true; }; "metadataCamposReply": { "alias": "metadataCamposReply"; "required": false; "isSignal": true; }; "redirectReturnUrl": { "alias": "redirectReturnUrl"; "required": false; "isSignal": true; }; "painelMaxWidthHint": { "alias": "painelMaxWidthHint"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "corpoCentralizado": { "alias": "corpoCentralizado"; "required": false; "isSignal": true; }; "cabecalhoPaginaVisivel": { "alias": "cabecalhoPaginaVisivel"; "required": false; "isSignal": true; }; "toolbarInterno": { "alias": "toolbarInterno"; "required": false; "isSignal": true; }; "embeddedInReferenciaDialog": { "alias": "embeddedInReferenciaDialog"; "required": false; "isSignal": true; }; "suppressInternalPageTabs": { "alias": "suppressInternalPageTabs"; "required": false; "isSignal": true; }; "externalShellTabKey": { "alias": "externalShellTabKey"; "required": false; "isSignal": true; }; "embeddedInPageShell": { "alias": "embeddedInPageShell"; "required": false; "isSignal": true; }; "tituloSection": { "alias": "tituloSection"; "required": false; "isSignal": true; }; "subtituloSection": { "alias": "subtituloSection"; "required": false; "isSignal": true; }; }, { "salvarSubmit": "salvarSubmit"; "toolbarButtonClick": "toolbarButtonClick"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroMetadataPageComponent, "app-cadastro-metadata-page", never, { "entityName": { "alias": "entityName"; "required": true; "isSignal": true; }; "entityLabel": { "alias": "entityLabel"; "required": true; "isSignal": true; }; "cadastro": { "alias": "cadastro"; "required": false; "isSignal": true; }; "initError": { "alias": "initError"; "required": false; "isSignal": true; }; "initLoading": { "alias": "initLoading"; "required": false; "isSignal": true; }; "validationUi": { "alias": "validationUi"; "required": false; "isSignal": true; }; "searchSelectBindings": { "alias": "searchSelectBindings"; "required": false; "isSignal": true; }; "listSelectBindings": { "alias": "listSelectBindings"; "required": false; "isSignal": true; }; "multiselectBindings": { "alias": "multiselectBindings"; "required": false; "isSignal": true; }; "metadataCamposReply": { "alias": "metadataCamposReply"; "required": false; "isSignal": true; }; "redirectReturnUrl": { "alias": "redirectReturnUrl"; "required": false; "isSignal": true; }; "painelMaxWidthHint": { "alias": "painelMaxWidthHint"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "corpoCentralizado": { "alias": "corpoCentralizado"; "required": false; "isSignal": true; }; "cabecalhoPaginaVisivel": { "alias": "cabecalhoPaginaVisivel"; "required": false; "isSignal": true; }; "toolbarInterno": { "alias": "toolbarInterno"; "required": false; "isSignal": true; }; "embeddedInReferenciaDialog": { "alias": "embeddedInReferenciaDialog"; "required": false; "isSignal": true; }; "suppressInternalPageTabs": { "alias": "suppressInternalPageTabs"; "required": false; "isSignal": true; }; "externalShellTabKey": { "alias": "externalShellTabKey"; "required": false; "isSignal": true; }; "embeddedInPageShell": { "alias": "embeddedInPageShell"; "required": false; "isSignal": true; }; "headerSecondaryAction": { "alias": "headerSecondaryAction"; "required": false; "isSignal": true; }; "tituloSection": { "alias": "tituloSection"; "required": false; "isSignal": true; }; "subtituloSection": { "alias": "subtituloSection"; "required": false; "isSignal": true; }; }, { "salvarSubmit": "salvarSubmit"; "toolbarButtonClick": "toolbarButtonClick"; "headerSecondaryActionClick": "headerSecondaryActionClick"; }, never, never, true, never>;
 }
 
 interface CadastroMetadataPageShellCallbacks {
@@ -9396,6 +10198,8 @@ interface CadastroMetadataShellRuntime {
     readonly painelMaxWidthHint: string | null;
     readonly onSalvarSubmit: () => void;
     readonly onToolbarButtonClick?: (btn: CadastroToolbarButtonDto) => void;
+    readonly headerSecondaryAction?: CadastroHeaderSecondaryAction | null;
+    readonly onHeaderSecondaryActionClick?: () => void;
     readonly metadataCamposReply?: CadastroMetadataCamposReplyLike | null;
     /**
      * Quando `vm.entityName` vem vazio, replica o padrão `[entityName]="metadataPageVm().entityName || '…'"`.
@@ -9421,6 +10225,8 @@ interface BuildCadastroMetadataShellRuntimeOptions {
     readonly painelMaxWidthHint: string | null;
     readonly onSalvarSubmit: () => void;
     readonly onToolbarButtonClick?: (btn: CadastroToolbarButtonDto) => void;
+    readonly headerSecondaryAction?: CadastroHeaderSecondaryAction | null;
+    readonly onHeaderSecondaryActionClick?: () => void;
     readonly metadataCamposReply?: CadastroMetadataCamposReplyLike | null;
     readonly entityNameFallback?: string;
     readonly entityLabelFallback?: string;
@@ -9447,6 +10253,12 @@ declare abstract class CadastroMetadataPageBase<TInit, TDto, TSalvar> extends Ca
     protected readonly autoPageShellCallbacks: CadastroMetadataPageShellCallbacks;
     constructor();
     protected cadastroMetadataShellExtras(): Partial<BuildCadastroMetadataShellRuntimeOptions>;
+    /**
+     * Botão opcional à esquerda de Salvar/Novo na topbar. Omisso / `null` ⇒ nada é renderizado.
+     */
+    protected cadastroHeaderSecondaryAction(): CadastroHeaderSecondaryAction | null;
+    /** Clique no botão de {@link cadastroHeaderSecondaryAction}. */
+    protected onCadastroHeaderSecondaryActionClick(): void;
     /** `public` explícito: templates com `strictTemplates` / consumidores da lib veem o membro herdado. */
     readonly cadastroRuntime: _angular_core.Signal<structra_ui.CadastroMetadataShellRuntime>;
     protected resolveFormLayoutForShell(): CadastroFormPageLayout | null;
@@ -9957,7 +10769,11 @@ declare function cadastroCampoScriptEditorLanguage(campo: CadastroCampoMetadataD
  * Em mobile a grelha colapsa para uma coluna — o campo já fica em largura total.
  */
 declare function cadastroCampoBooleanOcupaLinhaInteira(campo: CadastroCampoMetadataDto, layoutMobile?: boolean): boolean;
-/** Largura «ao conteúdo» vinda da metadata (ex.: <c>FullWidth = false</c> no servidor ⇒ <c>max-content</c>). */
+/** Largura fixa declarada na metadata (px, rem, etc.) — não <c>100%</c> nem <c>max-content</c>. */
+declare function cadastroCampoMetadataLarguraFixaCss(campo: CadastroCampoMetadataDto): string | null;
+/**
+ * Campo estreito na grelha multi-coluna: <c>max-content</c> ou largura fixa com <c>FullWidth = false</c>.
+ */
 declare function cadastroCampoMetadataLarguraCompacta(campo: CadastroCampoMetadataDto): boolean;
 /** Largura efectiva do wrapper do campo na grelha metadata (respeita `FullWidth` / `width` do servidor). */
 declare function cadastroCampoWrapperWidthCss(campo: CadastroCampoMetadataDto, opts: {
@@ -10404,6 +11220,13 @@ declare class CadastroBasePageComponent implements AfterContentInit {
     readonly validationUi: _angular_core.InputSignal<CadastroValidationUi | null>;
     /** Resumo de validação fixo ao topo do ecrã ao revelar erros (Structra `pinned`). */
     readonly validationSummaryPinned: _angular_core.InputSignal<boolean>;
+    /**
+     * Botão opcional à esquerda de Salvar/Novo (topbar da shell ou toolbar interna).
+     * Omisso ou sem `label` ⇒ nada é renderizado.
+     */
+    readonly headerSecondaryAction: _angular_core.InputSignal<CadastroHeaderSecondaryAction | null>;
+    readonly headerSecondaryActionClick: _angular_core.OutputEmitterRef<void>;
+    protected readonly headerSecondaryActionVisible: _angular_core.Signal<boolean>;
     /**
      * Prioridade: {@link CadastroValidationUi.validationSummaryPinned} quando definido (metadata com flags);
      * senão {@link validationSummaryPinned}.
@@ -10426,6 +11249,9 @@ declare class CadastroBasePageComponent implements AfterContentInit {
     protected readonly validationSummaryLive: _angular_core.WritableSignal<boolean>;
     constructor();
     ngAfterContentInit(): void;
+    /** Instâncias em cache (`data.reuse`) continuam vivas — só sincronizar quando esta rota está activa na shell. */
+    private isActiveShellTopbarRoute;
+    private releaseShellTopbarSlot;
     /** Alterna slot da shell entre botões invisíveis (init) e template da página (carregado). */
     private syncShellTopbarEndSlot;
     /**
@@ -10444,7 +11270,7 @@ declare class CadastroBasePageComponent implements AfterContentInit {
     /** Remove painéis `pinned` do Structra órfãos no `body` (ids internos `structra-vsum-p-*`). */
     private removeStructraPinnedValidationPanelsFromBody;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CadastroBasePageComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroBasePageComponent, "app-cadastro-base-page", never, { "runtime": { "alias": "runtime"; "required": false; "isSignal": true; }; "cadastroInitError": { "alias": "cadastroInitError"; "required": false; "isSignal": true; }; "cadastroInitLoading": { "alias": "cadastroInitLoading"; "required": false; "isSignal": true; }; "skeletonPanelMaxWidth": { "alias": "skeletonPanelMaxWidth"; "required": false; "isSignal": true; }; "toolbarInterno": { "alias": "toolbarInterno"; "required": false; "isSignal": true; }; "embeddedInReferenciaDialog": { "alias": "embeddedInReferenciaDialog"; "required": false; "isSignal": true; }; "corpoCentralizado": { "alias": "corpoCentralizado"; "required": false; "isSignal": true; }; "cabecalhoPaginaVisivel": { "alias": "cabecalhoPaginaVisivel"; "required": false; "isSignal": true; }; "validationUi": { "alias": "validationUi"; "required": false; "isSignal": true; }; "validationSummaryPinned": { "alias": "validationSummaryPinned"; "required": false; "isSignal": true; }; "validationSummaryTitle": { "alias": "validationSummaryTitle"; "required": false; "isSignal": true; }; "shellTopbarReserveDuplicar": { "alias": "shellTopbarReserveDuplicar"; "required": false; "isSignal": true; }; }, {}, ["projectedFormDir", "shellTopbarEndProjectedTpl"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroBasePageComponent, "app-cadastro-base-page", never, { "runtime": { "alias": "runtime"; "required": false; "isSignal": true; }; "cadastroInitError": { "alias": "cadastroInitError"; "required": false; "isSignal": true; }; "cadastroInitLoading": { "alias": "cadastroInitLoading"; "required": false; "isSignal": true; }; "skeletonPanelMaxWidth": { "alias": "skeletonPanelMaxWidth"; "required": false; "isSignal": true; }; "toolbarInterno": { "alias": "toolbarInterno"; "required": false; "isSignal": true; }; "embeddedInReferenciaDialog": { "alias": "embeddedInReferenciaDialog"; "required": false; "isSignal": true; }; "corpoCentralizado": { "alias": "corpoCentralizado"; "required": false; "isSignal": true; }; "cabecalhoPaginaVisivel": { "alias": "cabecalhoPaginaVisivel"; "required": false; "isSignal": true; }; "validationUi": { "alias": "validationUi"; "required": false; "isSignal": true; }; "validationSummaryPinned": { "alias": "validationSummaryPinned"; "required": false; "isSignal": true; }; "headerSecondaryAction": { "alias": "headerSecondaryAction"; "required": false; "isSignal": true; }; "validationSummaryTitle": { "alias": "validationSummaryTitle"; "required": false; "isSignal": true; }; "shellTopbarReserveDuplicar": { "alias": "shellTopbarReserveDuplicar"; "required": false; "isSignal": true; }; }, { "headerSecondaryActionClick": "headerSecondaryActionClick"; }, ["projectedFormDir", "shellTopbarEndProjectedTpl"], ["*"], true, never>;
 }
 
 /**
@@ -10535,6 +11361,8 @@ declare class CadastroFieldRendererComponent {
     larguraWrapperUi(c: CadastroCampoMetadataDto): string;
     protected scriptEditorMinHeightUi(c: CadastroCampoMetadataDto): string;
     protected scriptEditorLanguageUi(c: CadastroCampoMetadataDto): ScriptEditorLanguage;
+    /** Botão «+» (cadastro inline) só em campos editáveis — metadata `readOnly` ou controlo desactivado. */
+    mostrarRedirectSuffixUi(c: CadastroCampoMetadataDto): boolean;
     requiredMarkUi(c: CadastroCampoMetadataDto): boolean;
     campoShowErrorMessageUi(c: CadastroCampoMetadataDto): boolean;
     /** Só `monetary === true` usa prefixo `R$`; omisso/false ⇒ decimal simples (ex. m²). */
@@ -10813,6 +11641,11 @@ declare class FormCollectionComponent {
     gridTemplateColumnsParaItemEditorViewport(sec: CadastroMetadataSecao): string | null;
     itemEditorGridColumnSpanParaCampo(sec: CadastroMetadataSecao, campo: CadastroCampoMetadataDto, index: number): string | null;
     private computeCollectionEmbuteNoFormGroupPai;
+    /**
+     * Repõe o rascunho do editor a partir da linha seleccionada (botão «Alterar»).
+     * `patchValue` marca `dirty`; limpa estado de validação até o utilizador editar ou «Adicionar»/«Alterar».
+     */
+    private hydrateItemEditorFromSelectedRow;
     /** Remove `dirty`/`touched` em todos os níveis (ex.: após `patchValue` no rascunho «Adicionar»). */
     private repristineItemEditorDraft;
     private resetItemEditorDefaults;
@@ -11002,6 +11835,17 @@ declare class CadastroMetadataShellPageComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroMetadataShellPageComponent, "app-cadastro-metadata-shell-page", never, { "runtime": { "alias": "runtime"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Skeleton de arranque do cadastro — mesma aparência de {@link CadastroBasePageComponent}. */
+declare class CadastroFormLoadingSkeletonComponent {
+    readonly corpoCentralizado: _angular_core.InputSignal<boolean>;
+    readonly panelMaxWidth: _angular_core.InputSignal<string | null>;
+    readonly fieldCount: _angular_core.InputSignal<number>;
+    protected readonly skeletonPanelMaxWidthCss: _angular_core.Signal<string | undefined>;
+    protected readonly fieldIndexes: _angular_core.Signal<number[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CadastroFormLoadingSkeletonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CadastroFormLoadingSkeletonComponent, "app-cadastro-form-loading-skeleton", never, { "corpoCentralizado": { "alias": "corpoCentralizado"; "required": false; "isSignal": true; }; "panelMaxWidth": { "alias": "panelMaxWidth"; "required": false; "isSignal": true; }; "fieldCount": { "alias": "fieldCount"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 declare class StructraPageComponentRegistry {
     private readonly components;
     register(tag: string, component: Type<unknown>): void;
@@ -11217,5 +12061,251 @@ declare function mergeDocumentoFmtNaLinhaConsulta(item: Record<string, unknown>)
 declare function mapListarItensParaMultiselectOpcoes(itens: readonly unknown[], optionsValueField: string, optionsLabelField: string, optionsOnlyActive: boolean): UiSelectOption<string>[];
 declare function carregarOpcoesMultiselectViaSpec(injector: Injector, spec: ConsultaMultiselectOpcoesRemotasSpec): Promise<readonly UiSelectOption<string>[]>;
 
-export { ADAPTIVE_DATA_VIEW_MOBILE_QUERY, APP_SIDEBAR_LABEL_REVEAL_LAG_MS, APP_SIDEBAR_LAYOUT_DURATION_MS, APP_SIDEBAR_NAV_REVEAL_TOTAL_MS, APP_THEME_BASE_CLASS, APP_THEME_IDS, ActionMenuComponent, AdaptiveDataViewComponent, AlertComponent, AnchoredOverlayComponent, AppBreadcrumbComponent, AppDialogComponent, AppLibLightBlockScrollStrategy, AppShellComponent, AppShellSidebarTemplateDirective, AppShellSidebarToggleComponent, AppSidebarBottomActionsSlotDirective, AppSidebarBottomActionsTemplateDirective, AppSidebarBrandDirective, AppSidebarComponent, AppSidebarFooterSlotDirective, AppSidebarFooterTemplateDirective, AppSidebarHeaderSlotDirective, AppSidebarHeaderTemplateDirective, AppSidebarToolbarDirective, AppSidebarUserInfoSlotDirective, AppSidebarUserInfoTemplateDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, ButtonType as BaseButtonType, ButtonVariant as BaseButtonVariant, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, ButtonRadius, ButtonSize, ButtonType, ButtonVariant, CADASTRO_COLLAPSIBLE_REMOTE_LOAD_DELAY_MS, CADASTRO_DUPLICATE_FLAG_STATE, CADASTRO_DUPLICATE_SOURCE_ID_STATE, CADASTRO_FOCO_COLUNA_APOS_RESUMO_MS, CADASTRO_FORM_COLLECTION_REMOVE_ITEM_CONFIRM, CADASTRO_INVALIDATE_ROUTE_SNAPSHOT, CADASTRO_PAGE_SUBTITULO_PADRAO, CADASTRO_PAGE_TITULO_NOVO_PADRAO, CADASTRO_PESSOA_INLINE_DESTINO_URL_FRAGMENTS, CADASTRO_REFERENCIA_DIALOG_CONTEXT, CADASTRO_REFERENCIA_DIALOG_PAGE_CONFIG, CADASTRO_REFERENCIA_ROUTE_ACCESS, CADASTRO_REFERENCIA_ROUTE_ACCESS_PERMISSIVE, CADASTRO_RESUMO_FIELD_NAVIGATE_DEFER_MS, CADASTRO_TOAST_TITLE_PADRAO, CADASTRO_VALIDATION_SUMMARY_PINNED, CADASTRO_VALIDATION_SUMMARY_STATIC, CATEGORIAS_NAV_ID_EXCLUIDO, CATEGORIAS_NAV_LINHA_GRAVADA, CATEGORIAS_NAV_VOLTAR_SEM_RECARREGAR, CLIENTES_NAV_ID_EXCLUIDO, CLIENTES_NAV_LINHA_GRAVADA, CLIENTES_NAV_VOLTAR_SEM_RECARREGAR, CONSULTA_DATETIME_KEYS_ISO_PARA_FMT, CONSULTA_DOCUMENTO_GRID_KEYS_ISO_PARA_FMT, CONSULTA_FILTROS_SESSAO_USER, CONSULTA_GRID_OPTS_DATAS_PADRAO, CONSULTA_LISTA_CACHE_MAX_PAGINAS_DEFAULT, CONSULTA_LISTA_CACHE_NS_SEP, CONSULTA_LISTA_CACHE_TTL_MS_DEFAULT, CONSULTA_MOBILE_LAYOUT_MEDIA_QUERY, CONSULTA_MULTISELECT_LABEL_STUB, CONSULTA_OPTIONS_LISTAR_RESOLVER, CONSULTA_PEDIDOS_GRID_OPTS, CONSULTA_PHONE_GRID_KEYS_ISO_PARA_FMT, CONSULTA_PRESET_SELECT_EMPTY_OPTIONS_MESSAGE_DESKTOP, CONSULTA_PRESET_SELECT_EMPTY_OPTIONS_MESSAGE_MOBILE, CONSULTA_PRODUTOS_GRID_OPTS, CONSULTA_ROUTE_REUSE, CONSULTA_SERVIDOR_LISTA_QUERY_DEFAULTS, CONSULTA_TOPBAR_SLOT, CadastroBasePageComponent, CadastroCollectionGridColumnFormat, CadastroCollectionReferenciaHostService, CadastroCollectionRuntime, CadastroEnumOptionsRegistry, CadastroFieldRendererComponent, CadastroFieldRuntime, CadastroFieldsBaseComponent, CadastroFormDraftCacheService, CadastroMetadataPageBase, CadastroMetadataPageComponent, CadastroMetadataPageServiceBase, CadastroMetadataPageShellLayoutComponent, CadastroMetadataPageStateBase, CadastroMetadataShellPageComponent, CadastroPadraoPageBase, CadastroReferenceRegistry, CadastroReferenciaDialogBridgeRegistry, CadastroReferenciaDialogHostComponent, CadastroReferenciaDialogService, CadastroReferenciaOpenMode, CadastroRuntime, CadastroRuntimeRegistry, CadastroSectionPanelLayout, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ColorPickerFieldComponent, ComponentType, ConfirmDialogComponent, ConfirmDialogService, ConsoleLogComponent, ConsultaBasePageComponent, ConsultaCadastroFiltroDialogComponent, ConsultaCardCampoPapel, ConsultaCardFieldFormat, ConsultaCatalogBundleHelper, ConsultaFiltroPresetToolbarComponent, ConsultaFiltrosSessaoService, ConsultaGridColumnFormat, ConsultaGridOrderDirection, ConsultaListaMemoriaCacheService, ConsultaPadraoPageBase, ConsultaPageCache, ContainerLayoutSize, ContextMenuComponent, CpfCnpjFieldComponent, DEFAULT_STRUCTRA_SHELL_SCROLL_RESTORATION_OPTIONS, DROPDOWN_SEARCH_LOCAL_PAGE_SIZE, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DividerComponent, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, ENM_STATUS_OPCOES_SELECT, EmptyStateComponent, EnmStatus, FIELD_MOBILE_LAYOUT_QUERY, FILE_PREVIEW_UNAVAILABLE_MESSAGE, FORM_CONTAINER_STATE_STORAGE_PREFIX, FORNECEDORES_NAV_ID_EXCLUIDO, FORNECEDORES_NAV_LINHA_GRAVADA, FORNECEDORES_NAV_VOLTAR_SEM_RECARREGAR, FieldCadastroRedirectButtonComponent, FileUploadFieldComponent, FileUploadType, FormActionsAlign, FormActionsComponent, FormColComponent, FormCollectionComponent, FormCollectionLayout, FormGroupComponent, FormGroupVariant, FormLayoutGap, FormRowAlign, FormRowComponent, FormRowJustify, FormSectionAlign, FormSectionComponent, FormSectionRadius, FormSectionVariant, FormTabComponent, FormTabsComponent, ImagePreviewPanelComponent, InputMaskFieldComponent, IntegerFieldComponent, LAYOUT_STACK_SIDE_BY_SIDE, LAYOUT_STACK_STACKED, LayoutStackAlign, LayoutStackComponent, LayoutStackDirection, LayoutStackItemAlign, LibDialogSize, ListItemComponent, LoadingDialogComponent, LoadingDialogService, MaskedTextFieldBase, MenuDividerComponent, MenuDropdownPlacement, MenuGroupComponent, MenuListComponent, MultiselectFieldComponent, NO_OP_CONSULTA_ROUTE_REUSE, NO_OP_CONSULTA_TOPBAR_SLOT, NgControlFieldDirective, OPS_BOOL, OPS_DATA, OPS_TEXTO, OPS_TEXTO_MULTISELECT, ORIGEM_CADASTRO_INLINE_PESSOA, OverlayPlacement, PDF_IFRAME_VIEWER_HASH, PEDIDOS_NAV_ID_EXCLUIDO, PEDIDOS_NAV_LINHA_GRAVADA, PEDIDOS_NAV_VOLTAR_SEM_RECARREGAR, PESSOAS_NAV_LINHA_GRAVADA, PESSOAS_NAV_VOLTAR_SEM_RECARREGAR, PHONE_BR_LANDLINE_MASK, PHONE_BR_MOBILE_MASK, PRODUTOS_NAV_ID_EXCLUIDO, PRODUTOS_NAV_LINHA_GRAVADA, PRODUTOS_NAV_VOLTAR_SEM_RECARREGAR, PasswordFieldComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, ReferenceOptionPreset, STRUCTRA_CADASTRO_INLINE_RESULT_KEY, STRUCTRA_CADASTRO_INLINE_RETURN_KEY, STRUCTRA_CONSULTA_FORCE_REFRESH_KEY, STRUCTRA_DEDICATED_BACK_TO_TOP_SELECTOR, STRUCTRA_INLINE_FORM_DRAFT_PENDING_PREFIX, STRUCTRA_MIDIA_PUBLIC_BASE_RESOLVER, STRUCTRA_MIDIA_UPLOAD_TRANSPORT, STRUCTRA_PAGE_STATE_ACTIVE_TAB_PREFIX, STRUCTRA_SHELL_SCROLL_RESTORATION_OPTIONS, STRUCTRA_SHELL_TOPBAR_TITLE_SKELETON, STRUCTRA_SIMULATED_LOADING_DELAY_MS, STRUCTRA_THEME_IDS, STRUCTRA_UI, ScriptEditorFieldComponent, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, StructraBackToTopButtonComponent, StructraPageComponentOutletComponent, StructraPageComponentRegistry, StructraPageStateCacheService, StructraProgressOverlayComponent, ScriptEditorFieldComponent as StructraScriptEditorComponent, StructraShellScrollRestorationService, StructraShellTopbarSlotService, AppSidebarBottomActionsTemplateDirective as StructraSidebarBottomActionsDirective, AppSidebarFooterTemplateDirective as StructraSidebarFooterDirective, AppSidebarHeaderTemplateDirective as StructraSidebarHeaderDirective, AppSidebarUserInfoTemplateDirective as StructraSidebarUserInfoDirective, SwitchFieldComponent, THEME_PRIMARY_COLOR_LABEL_PT_BR, TOAST_REGISTRO_EXCLUIDO_SUCESSO, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ThemeDirective, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, TreeViewComponent, USUARIOS_CONSULTA_GRID_OPTS, USUARIOS_NAV_ID_EXCLUIDO, USUARIOS_NAV_LINHA_GRAVADA, USUARIOS_NAV_VOLTAR_SEM_RECARREGAR, VENDEDORES_NAV_ID_EXCLUIDO, VENDEDORES_NAV_LINHA_GRAVADA, VENDEDORES_NAV_VOLTAR_SEM_RECARREGAR, ValidationSummaryComponent, agruparCamposMetadataPorSecao, anchoredOverlayPositions, aplicarNormalizacaoMultiselectIdsNoPartial, aplicarProdutoDtoNoFormulario, appendCadastroPageActiveTabQuery, appendPdfIframeViewerParams, applyCadastroCollectionArrayValidators, applyCadastroModoSenhaNovos, applyCollectionValidationSummaryNavigation, applyCollectionValueToFormArray, applyEntityToCadastroFormByMetadata, applyOptionalThemeHostClasses, applyPickedCalendarDate, buildCadastroFiltroDialogItensGridRows, buildCadastroMetadataShellRuntime, buildCadastroPageActiveTabPageKey, buildCadastroPageActiveTabPageKeyFromLayout, buildCadastroPageRuntime, buildCadastroRedirectReturnUrl, buildCadastroReferenciaDialogContext, buildCatalogoStubConsultaRuntime, buildConsultaConfirmDuplicarLinhaFromLayout, buildConsultaConfirmRemoverLinhaFromLayout, buildConsultaDefaultIsItemGuard, buildConsultaListaCacheKey, buildConsultaPageMetadataUnified, buildConsultaPageRuntime, buildDecimalBrDisplay, buildDecimalBrParseString, buildDefaultConsultaMapCardFromColunasGrid, buildEmptyStateOverlayHtml, buildFormContainerStateStorageKey, buildFormGroupFromCadastroCampos, buildHistoryStateAfterReturningFromNestedInlineChild, buildInlineReturnStateForChildCadastro, buildNovoFormDefaultsFromCampos, buildRouteReuseKeyFromAppPathname, buildRouteReuseKeyFromNovoRouterLink, buildStructraSidebarTemplateContext, buildValidationMetaFromCadastroCampos, cadastroBuildImageUploadMetadata, cadastroCampoBlocoEditorOcupaLinhaInteira, cadastroCampoBooleanOcupaLinhaInteira, cadastroCampoMetadataDtoFromPartial, cadastroCampoMetadataEhBoolean, cadastroCampoMetadataLarguraCompacta, cadastroCampoReferenciaMetadataDtoFromPartial, cadastroCampoRuleMaxLength, cadastroCampoScriptEditorLanguage, cadastroCampoScriptEditorMinHeight, cadastroCampoValidacaoDtoFromPartial, cadastroCampoWrapperWidthCss, cadastroCollectionEditorGridColumns, cadastroCollectionMaxItemsValidator, cadastroCollectionMinItemsValidator, cadastroConfirmExcluirPartialFromLayout, cadastroContainerLayoutSizeDoRecord, cadastroContainerPathJoin, cadastroCrudMessagesDoFormLayout, cadastroDeclarativeSnapshotDtoFromPartial, cadastroEnsureSingleBooleanInCollection, cadastroFieldsPerRowDoRecord, cadastroFlattenContainerRaw, cadastroFormDraftEnabledDoLayout, cadastroFormGridColumns, cadastroFormLayoutComoRecord, cadastroFormLayoutDoBundle, cadastroFormLayoutDoRuntime, cadastroFormLayoutPreserveActiveTab, cadastroFormPageLayoutFromPartial, cadastroGcd, cadastroGetCollectionItemControl, cadastroGridColumnSpanForFieldIndex, cadastroGridDenominadorTracks, cadastroGridTemplateColumnsLinhaUnicaSeAplicavel, cadastroInferExtensaoArquivo, cadastroInferImageContentType, cadastroLcm, cadastroMetadataDtoParaValidacaoLike, cadastroNavKeysStructra, cadastroNomeArquivoDaUploadUrl, cadastroNormalizarUploadUrlPorPrefixo, cadastroPageActionDtoFromPartial, cadastroPageActionsPorRegiao, cadastroPageActiveTabToRestore, cadastroPageComponentDtoFromPartial, cadastroPageComponentsPorRegiao, cadastroPageIdentityDoFormLayout, cadastroPageOverlayDtoFromPartial, cadastroPageShellAtivo, cadastroPageShellTabsKeepAliveFromLayout, cadastroPageTabDtoFromPartial, cadastroPageTabsOrdenados, cadastroPainelMaxWidthCss, cadastroRawBooleanDeep, cadastroRawNumber, cadastroRawString, cadastroReferenceEntryFromListarService, cadastroReferenciaOpenModeFromWire, cadastroReindexarCollectionOrdem, cadastroResolveId, cadastroSecaoFormGroupDense, cadastroSecaoPersisteExpandedState, cadastroSecaoRenderizaInlineDentroDoPai, cadastroSecaoSegmentosIntercalados, cadastroSecaoSegmentosParaRender, cadastroSecaoUsaFormGroup, cadastroSecaoUsaFormGroupComoBlocoVisual, cadastroSecaoUsaSuperficieDeclarativa, cadastroSingleBooleanCollectionBinding, cadastroTitulosEfectivosDoFormLayout, cadastroToastTitleEfectivoDoFormLayout, cadastroToolbarButtonDtoFromPartial, cadastroToolbarVisibilityDoFormLayout, cadastroUseBackToTopButtonFromLayout, cadastroValidationSummaryFlagsDoRecord, cadastroValidationSummaryPinnedFromFlags, cadastroWireCollectionOrdemReindexOnAdd, cadastroWireCollectionOrdemReindexOnAddRemove, cadastroWireCollectionOrdemReindexOnRemove, campoMetadataVisivelNoModo, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, carregarOpcoesMultiselectViaSpec, cepMaskCompleteValidator, clearRequiredValidatorsOnReadOnlyCadastroFields, clearStructraCadastroInlineReturnSessionCacheForTests, clearStructraCadastroSessionStorageOnLogout, coerceDecimalPtBr, collectValidationSummaryItems, colunasGridTemFormatacaoDeclarativa, computeReferenciaHasMore, consoleLogLevelClass, consultaCampoMetadataDtoFromPartial, consultaCardCampoDtoFromPartial, consultaFiltroValorDataSomenteDia, consultaGridColunaDtoFromPartial, consultaGridColunaKeyParaCampoLinha, consultaGridConfigDtoFromPartial, consultaPassaItem, consultaPassaTodosItens, consultaUsuariosMetadataReplyFromPartial, consumeCadastroInlineFormDraftPendingRestore, consumirResultadoCadastroInlineCampoPessoaId, consumirResultadoCadastroInlineCampoReferencia, cpfCnpjMaskCompleteValidator, createCadastroDialogActivatedRoute, createCadastroMetadataPageConfig, createCadastroPadraoConfig, createCadastroRuntime, createCollectionFormArray, createCollectionItemFormGroup, createConsultaListaItemGuardFromFiltroUi, createConsultaOptionsListarResolver, createConsultaPadraoRuntime, createConsultaPresetSelectEmptyOptionsMessageSignal, createConsultaPresetStorageApi, createGrpcSaveRequestMapper, createInlineHostNavigation, createMapCardFromConsultaColunasGrid, createMapGridRowFromConsultaColunasGrid, createSaveRequestFromPartialMapper, criarDraftInlinePessoa, decimalPtBrNaoNegativoValidator, decimalPtBrToNullableNumber, defaultIsConsultaListItemMinimo, defaultParseLinhaGravadaJson, deleteConfirmPageConfigFromPartial, deriveCadastroTituloEditar, deriveConsultaListaItemGuardPropsFromFiltroUi, duplicateConfigFromLayout, duplicatePageConfigFromPartial, enrichCadastroReferenciaDialogPageConfig, ensureCadastroCollectionMinItems, ensureCadastroFormControlsFromMetadata, escapeHtml, evaluateStructraPageVisibleExpression, executarConsultaServidorComPreset, extractConsultaListaCacheNamespace, extractDecimalBrParts, fileIsLikelyImage, fileMatchesAccept, filtrarSecoesMetadataPorModo, filtrarUiSelectOptionsPainelComValorPersistente, filtrarUiSelectOptionsPorQuery, findCadastroCampoByKey, fixedDigitsMaskCompleteValidator, flattenCadastroMetadataSecoes, fmtDataPt, fmtDocumentoCelulaConsultaGrid, formatAcceptForDisplay, formatDateTimePtBr, formatDecimalBr, formatDocumentoPessoaParaExibicao, formatFileSizeBytes, formatIntegerThousandsBr, formatMaskDigits, formatPhoneBr, formatUiFieldDateValue, getFilePreviewKind, getStructraActionsByGroup, getThemeClass, getThemeClassList, getThemePrimaryColorLabelPtBr, getThemeTokenClass, hexParaColorInput, inferCadastroItemFieldsFromPlainRows, inferCadastroListaUrlFallback, initialCadastroControlValue, injectEffectiveThemeId, isCadastroDuplicateNavigation, isCollectionField, isCollectionLikeField, isConsultaCardAutoSubtitleExcluded, isLegacyFormContainerStateStorageKey, isLegacyNomeDocumentoReferencePreset, isReadonlyCollectionField, isValidPhoneBr, libDialogPanelClasses, listaUrlFromRotaCadastro, listarItensCadastroReferencia, listarTodosPaginado, loadPresetsJson, mapCadastroFormRawToPayload, mapConsultaGridColunasParaDataGrid, mapConsultaMetadataParaFiltroUi, mapErroTransporteParaMensagem as mapErroListaDefault, mapErroTransporteParaMensagem, mapEstadosToOptions, mapFiltroSalvoParaConsultaPreset, mapListarItensParaMultiselectOpcoes, markCadastroInlineFormDraftPendingRestore, maskDigitCount, mergeCadastroConfirmExcluir, mergeConsultaGridRowFormattingFromColunasGrid, mergeConsultaMultiselectOpcoesComSeleccionados, mergeDocumentoFmtNaLinhaConsulta, mergeMapConsultaGridColunasOptsComColumnFormat, mergeNovoIdEmListaSelecionada, mergeStructraShellScrollRestorationOptions, metadataCampoParaChaveLinhaCliente, modoPermissaoReferenciaFromWire, montarFiltrosGrpcPreset, montarFiltrosServidorPreset, montarHierarquiaSecoesMetadata, multiselectIdListRequiredValidator, multiselectMaxItemsValidator, navegarVoltarLista, navegarVoltarListaComIdRemovido, navegarVoltarListaComLinha, navigateCadastroDuplicate, navigateCommandsFromRotaAlterar, navigateCommandsFromRotaNovo, nomeSalvarParaPayloadComPessoa, normalizarArvoreSecoesMetadata, normalizarHexCor, normalizarItensParaGravarServidorCadastro, normalizarListaIdsMultiselect, normalizarOperadorConsultaParaEnvioServidor, normalizarRotaReferencia, normalizarStructraAction, normalizarStructraActionGroup, normalizarStructraActionGroups, normalizeCadastroAppPath, normalizeCadastroCampoMetadataWire, normalizeCadastroInitRouteIdParam, normalizeCadastroItemEditorDecimalControls, normalizeCadastroReferenciaDialogRotaKey, normalizeCadastroRouteForContainerState, normalizeConsoleLogLevel, normalizeFormDateValue, normalizePhoneBr, normalizeStructraTheme, novoPathCommandsFromRota, onlyDigits, operadorConsultaComValorUnicoComparacao, operadorConsultaDatetimeUsaDatePicker, operadoresConsultaCampo, operadoresPorTipo, ordenarFiltroItens, ordenarStructraActions, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, patchFormFromEntidadeRecord, permissoesReferenciaMetadata, phoneBrDynamicMaskCompleteValidator, phoneBrMaskCompleteValidator, phoneBrMaskFromDigits, pickCadastroPageActiveTabExplicit, pickTabKeyLinkedToSummaryItems, precisaValor, precisaValorFinal, provideStructraCadastroReferenciaDialogRoot, provideStructraShellScrollRestoration, qtdCriteriosPresetParaSkeleton, readCadastroDuplicateSourceId, readCadastroPageActiveTabFromNavigationState, readCadastroPageActiveTabFromUrl, readFormContainerCollapsedFromStorage, readStructraCadastroInlineReturn, referenciaAbreEmDialog, referenciaOpenModeRaw, referenciaUsesLegacyRegistryMapper, registerCadastroReferenceEntries, registerCadastroReferenceListSources, registerCadastroReferenciaDialogBridges, registerStructraBuiltinPageComponents, replaceProdutoCadastroFormControls, resetStructraCadastroReferenciaDialogRootForTests, resolveCadastroCollectionMinItems, resolveCadastroListaUrlParaNavegacao, resolveCadastroPageActiveTabKey, resolveCadastroReferenciaMapOptions, resolveConsultaEditActionLabelFromGridConfig, resolveConsultaListaQuerySliceFromGridConfig, resolveConsultaNavKeysFromPageLayout, resolveConsultaNovoRouterLinkFromLayout, resolveConsultaRouteEditBaseFromLayout, resolveConsultaToastTitleLista, resolveControlAtPath, resolveFormContainerCollapsed, resolveReferenciaOpcaoLabel, resolveStructraPageInputExpression, resolveStructraPageInputs, resolveStructraShellScrollContainer, resolverAcoesReferenciaPorRota, resolverValorOpcaoPorRotuloNormalizado, resumoValorMultiselectFiltro, rotaListaReferencia, rotuloEnmStatus, rotuloNomeDocumentoLista, rotuloOperadorConsulta, rotuloPessoaLista, runStructraSimulatedLoadingDelay, sanitizeDecimalBrInput, sanitizeIntegerDigits, sanitizeRecordForCadastroDuplicate, savePresetsJson, scheduleRemoteCollectionHydrationAfterSectionExpand, secaoMetadataEhContainerPlain, secaoTemConteudoVisivel, secaoTemCorpoParaRender, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, serializeCollectionFormArray, shouldDeferInitialRemoteCollectionLoad, shouldSkipCadastroPageActiveTabCacheWrite, stripStructraCadastroInlineResultFromHistory, stripToDigits, structraActionButtonVariant, structraCadastroInlineResultTemIdSalvo, structraCadastroInlineResultTemReferenciaExcluida, structraElementScrolls, structraHasValue, structraIsFilledString, structraIsFormGroup, structraIsValidPort, structraParseNumberOrNull, structraReadFormValue, structraReadNestedValue, structraTrimString, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid, syncStructraCadastroInlineReturnSessionCache, tabWarningFromLinkedSummaryItems, tipoCampoMetadataParaUi, tipoValorApi, toCadastroReferenceListPageResult, toConsoleLogLineView, toConsoleLogLineViews, toUiSelectOptionsFromMetadata, uiSelectOpcaoIdNomeDocumento, uiSelectOpcoesDePessoas, validationLikeFromCampoMetadata, validatorsFromCampo, writeFormContainerCollapsedToStorage };
-export type { AdaptiveDataViewMode, AlertType, AppThemeId, AppThemeOption, ApplyCadastroModoSenhaOptions, BreadcrumbItem, BuildCadastroMetadataShellRuntimeOptions, BuildCadastroPageRuntimeOptions, CadastroActionStateDto$1 as CadastroActionStateDto, CadastroAutoMapFormValueConfig, CadastroCampoContaNaGrelhaFn, CadastroCampoMetadataDto, CadastroCampoMetadataMergeInput, CadastroCampoReferenciaMetadataDto, CadastroCampoSelectOptionDto, CadastroCampoValidacaoDto, CadastroCampoValidacaoLike, CadastroCollectionBinding, CadastroCollectionBridge, CadastroCollectionEditingItemControlsChangeEvent, CadastroCollectionEditingItemControlsChangeOptions, CadastroCollectionItemEvent, CadastroCollectionItemFieldsChangeEvent, CadastroCollectionItemFieldsChangeOptions, CadastroCollectionItemsChangeEvent, CadastroCollectionPageReplyWire, CadastroCollectionPageRequestWire, CadastroCollectionPagingPort, CadastroCollectionPagingUi, CadastroCollectionSaveHandler, CadastroCollectionStateDto, CadastroConfirmExcluirPartial, CadastroCrudMessagesResolved, CadastroDeclarativeSnapshotDto, CadastroDuplicateActionConfig, CadastroEnsureSingleBooleanInCollectionOptions, CadastroFieldChangeEvent, CadastroFieldEventBase, CadastroFieldKey, CadastroFieldRegistration, CadastroFieldSelectEvent, CadastroFieldSimpleEvent, CadastroFiltroDialogRuntimeSlice, CadastroFormPageLayout, CadastroImageUploadMetadata, CadastroImageUploadMetadataOptions, CadastroInferExtensaoArquivoOptions, CadastroInferImageContentTypeOptions, CadastroInlineHostNavigationConfig, CadastroListSelectBinding, CadastroMetadataCamposReplyLike, CadastroMetadataPageCadastro, CadastroMetadataPageServiceConfig, CadastroMetadataPageShellCallbacks, CadastroMetadataPageStateConfig, CadastroMetadataPageVm, CadastroMetadataSecao, CadastroMetadataServiceConfig, CadastroMetadataServicePort, CadastroMetadataShellRuntime, CadastroMetadataView, CadastroModo, CadastroMultiselectBinding, CadastroPadraoGrpcService, CadastroPageActionDto, CadastroPageActiveTabResolveInput, CadastroPageComponentDto, CadastroPageConfig, CadastroPageIdentityFallback, CadastroPageNavKeysConfig, CadastroPageOverlayDto, CadastroPageRuntime, CadastroPageSenhaConfig, CadastroPageTabDto, CadastroPessoaOpcaoMin, CadastroRawBooleanDeepOptions, CadastroReferenceListPageParams, CadastroReferenceListPageResult, CadastroReferenceListarService, CadastroReferenceRegistryEntry, CadastroReferenciaAcoesPermitidas, CadastroReferenciaDialogBridgeEntry, CadastroReferenciaDialogBridgeFactory, CadastroReferenciaDialogCloseReason, CadastroReferenciaDialogCompletePayload, CadastroReferenciaDialogContext, CadastroReferenciaDialogOpenOptions, CadastroReferenciaDialogOpenRequest, CadastroReferenciaOpenModeWireRef, CadastroReferenciaPermissoesMetadata, CadastroReferenciaRouteAccess, CadastroReindexarCollectionOrdemOptions, CadastroRuntimeDeps, CadastroRuntimeOptions, CadastroSearchSelectBinding, CadastroSearchSelectRedirectSuffix, CadastroSearchSelectReferenciaDialog, CadastroSecaoSegmento, CadastroSingleBooleanCollectionBindingOptions, CadastroTitulosFallback, CadastroToolbarButtonDto, CadastroToolbarVisibilityResolved, CadastroValidationUi, CardItemBooleanField, CardItemMetaField, CardItemView, CardListDataMode, CardListHeaderPosition, CardListMapFn, CatalogoStubConsultaConfig, CatalogoStubListaItem, ConfirmDialogData, ConfirmDialogVariant, ConsoleLogLevel, ConsoleLogLine, ConsoleLogLineView, ConsultaBaseConfig, ConsultaCampoDef, ConsultaCampoMetadataDto, ConsultaCardCampoDto, ConsultaCatalogBundleConfig, ConsultaCatalogBundleSessaoPort, ConsultaCatalogEntityBindings, ConsultaCatalogInitCarregada, ConsultaCrudAdapterConfig, ConsultaEnumSelectOptionDto, ConsultaFiltroCampo, ConsultaFiltroItem, ConsultaFiltroMatchAdapters, ConsultaFiltroPreset, ConsultaFiltroSalvoDto, ConsultaFiltroSalvoItemDto, ConsultaFiltroUiFragment, ConsultaFiltroValorTipo, ConsultaFiltrosBundleSessao, ConsultaFiltrosChromeVolatil, ConsultaFiltrosSessaoConsultaPadraoApi, ConsultaFiltrosSessaoUserLike, ConsultaFiltrosSessaoVolatilApi, ConsultaFiltrosVolatilHandlers, ConsultaGridColunaDto, ConsultaGridColunaDtoLike, ConsultaGridConfigDto, ConsultaInitCarregada, ConsultaListaCacheKeyParts, ConsultaListaCachePayload, ConsultaListaMemoriaCacheStoreOpts, ConsultaListaQueryParamsLike, ConsultaListaResultadoLike, ConsultaListaServidorQuerySlice, ConsultaMapCardLinha, ConsultaMetadataCampo, ConsultaMetadataReplyLike, ConsultaMetadataServicePort, ConsultaMultiselectOpcoesRemotasSpec, ConsultaOperadorOption, ConsultaOptionsListarContrato, ConsultaOptionsListarResolver, ConsultaPadraoGrpcServiceLike, ConsultaPadraoNavigateLike, ConsultaPadraoToastLike, ConsultaPageCacheEntry, ConsultaPageMetadataUnified, ConsultaPageRuntime, ConsultaPageRuntimeDeps, ConsultaRouteReusePort, ConsultaServidorExecutorOpts, ConsultaServidorListaReply, ConsultaServidorPort, ConsultaServidorQueryParams, ConsultaTopbarSlotPort, ConsultaUsuariosMetadataReply, ConsultaValorTipo, CreateCadastroMetadataPageConfigOptions, CreateCadastroPadraoConfigOptions, CreateConsultaPadraoRuntimeOptions, CreateGrpcSaveRequestMapperOptions, CreateSaveRequestFromPartialMapperOptions, CrudConsultaServicePort, DataGridColumn, DataGridPaginationChangeEvent, DeleteConfirmPageConfig, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, DuplicatePageConfig, FieldCommonInputs, FieldSize, FilePreviewKind, FiltroItemEntrada, FiltroItemEntradaGenerico, FiltroItemGridRow, FiltroItemSalvoDto, FiltroSalvo, FormContainerStateKeyParts, FormTabValidationLinkConfig, FormTabsVariant, GrpcSaveRequestFactory, InitConsultaReply, ListarTodosPaginadoParams, LoadingDialogData, MapConsultaGridColunasOpts, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, ModoPermissaoReferencia, MontarFiltrosGrpcPresetOptions, MontarFiltrosServidorPresetOptions, OptionsSourceServicePort, PatchFormFromEntidadeOptions, SalvarFiltroConsultaRequest, SalvarFiltroPresetAsyncArgs, SaveRequestFromPartialFactory, ScriptEditorLanguage, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, StructraAction, StructraActionButtonVariant, StructraActionGroup, StructraActionGroupWire, StructraActionId, StructraActionVariant, StructraActionWire, StructraCadastroInlineResultState, StructraCadastroInlineReturnState, StructraFormValueSource, StructraMidiaUploadResult, StructraMidiaUploadTransportContext, StructraMidiaUploadTransportFn, StructraPageInputContext, StructraShellScrollRestorationMergedOptions, StructraShellScrollRestorationOptions, StructraSidebarContext, StructraSidebarTemplateContext, StructraTheme, TitulosFromMetadataConfig, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, TreeViewNode, TreeViewSelectEvent, UiFieldInputTextAlign, UiSelectOption, ValidationFieldMeta, ValidationSummaryItem, ValidationSummarySize, ValidationSummaryVariant, ValoresConsultaPresetUi };
+/** Itens por página na pré-visualização de relatórios (pesquisa paginada na tela). */
+declare const STRUCTRA_REPORT_DEFAULT_PAGE_SIZE = 15;
+interface ReportTreeNode {
+    id: string;
+    label: string;
+    icon?: string | null;
+    leaf?: boolean;
+    expanded?: boolean;
+    children?: ReportTreeNode[];
+}
+interface ReportFilterMeta {
+    id: string;
+    label: string;
+    tipo: 'text' | 'bool' | 'date' | 'number' | string;
+    operador?: string;
+    global?: boolean;
+    obrigatorio?: boolean;
+}
+interface ReportColumnMeta {
+    id: string;
+    label: string;
+    formato?: string;
+    width?: string | null;
+    minWidth?: string | null;
+    maxWidth?: string | null;
+}
+type ReportColumnWidthFields = Pick<ReportColumnMeta, 'width' | 'minWidth' | 'maxWidth'>;
+declare function reportColumnWidthStyle(col: ReportColumnWidthFields | null | undefined): Record<string, string | null>;
+declare function reportTableHasFixedWidths(colunas: readonly ReportColumnWidthFields[]): boolean;
+declare function isReportNowrapColumn(col: Pick<ReportColumnMeta, 'formato' | 'id'> | null | undefined): boolean;
+/** Coluna booleana declarada pelo metadata do relatório (`formato: boolean`). */
+declare function isReportBooleanColumn(col: Pick<ReportColumnMeta, 'formato'> | null | undefined): boolean;
+/** Converte valor de célula booleana (tipado ou legado Sim/Não) quando a coluna é boolean. */
+declare function coerceReportBoolean(value: unknown): boolean;
+interface ReportMetadata {
+    key: string;
+    titulo: string;
+    filtros: ReportFilterMeta[];
+    colunas: ReportColumnMeta[];
+}
+/** Critério avulso no mesmo formato da consulta base (gRPC `FiltroItemEntrada`). */
+interface ReportFiltroItemEntrada {
+    campo: string;
+    operador: string;
+    valor: string;
+    valorAte?: string;
+    juncao?: string;
+}
+interface ReportPesquisarRequest {
+    /** Formato legado (metadata fixa por campo do relatório). */
+    filtros?: Record<string, string | null | undefined>;
+    /** Preset + valores montados pela consulta base (`montarFiltrosServidorPreset`). */
+    filtrosAvulsos?: ReportFiltroItemEntrada[];
+    /** Página (1-based). Omisso ⇒ 1. */
+    page?: number;
+    /** Tamanho da página na tela. Omisso ⇒ default do servidor. */
+    pageSize?: number;
+    /** Exportação PDF: busca todos os registros filtrados. */
+    exportAll?: boolean;
+}
+interface ReportHeader {
+    titulo: string;
+    subtitulo?: string | null;
+    geradoEm?: string;
+}
+interface ReportTotal {
+    label: string;
+    valor: string;
+}
+interface ReportSectionColumn {
+    id: string;
+    label: string;
+    formato?: string;
+    width?: string | null;
+    minWidth?: string | null;
+    maxWidth?: string | null;
+}
+interface ReportSectionTable {
+    title: string;
+    colunas: ReportSectionColumn[];
+    linhas: Array<Record<string, string | null | undefined>>;
+    emptyMessage?: string | null;
+}
+interface ReportSection {
+    title: string;
+    subtitle?: string | null;
+    tabelas: ReportSectionTable[];
+    totais?: ReportTotal[];
+}
+interface ReportResult {
+    header: ReportHeader;
+    filtrosAplicados: Record<string, string | null | undefined>;
+    colunas: ReportColumnMeta[];
+    linhas: Array<Record<string, unknown>>;
+    sections?: ReportSection[];
+    totais?: ReportTotal[];
+    footer?: string | null;
+    totalRegistros: number;
+    page?: number;
+    pageSize?: number;
+    totalPages?: number;
+}
+interface StructraReportTransport {
+    obterArvore(): Promise<ReportTreeNode[]>;
+    obterMetadata(key: string): Promise<ReportMetadata>;
+    pesquisar(key: string, request: ReportPesquisarRequest): Promise<ReportResult>;
+}
+declare const STRUCTRA_REPORT_TRANSPORT: InjectionToken<StructraReportTransport>;
+declare function findFirstReportLeafId(nodes: ReportTreeNode[]): string | null;
+declare function findReportTreeLabel(id: string, nodes: ReportTreeNode[]): string | null;
+declare function mapReportTreeToTreeViewNodes(nodes: ReportTreeNode[]): TreeViewNode[];
+
+declare class StructraReportTreeComponent {
+    nodes: TreeViewNode[];
+    selectedId: string | null;
+    title: string;
+    titleIconClass: string;
+    expansionStateKey: unknown;
+    loading: boolean;
+    selectedIdChange: EventEmitter<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportTreeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportTreeComponent, "structra-report-tree", never, { "nodes": { "alias": "nodes"; "required": true; }; "selectedId": { "alias": "selectedId"; "required": false; }; "title": { "alias": "title"; "required": false; }; "titleIconClass": { "alias": "titleIconClass"; "required": false; }; "expansionStateKey": { "alias": "expansionStateKey"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; }, { "selectedIdChange": "selectedIdChange"; }, never, never, true, never>;
+    static ngAcceptInputType_loading: unknown;
+}
+
+/** Placeholders da árvore de relatórios enquanto a lista carrega (layout alinhado ao tree-view). */
+declare class StructraReportTreeSkeletonComponent {
+    rows: number;
+    /** Larguras relativas das linhas (simula pastas/folhas com indentação). */
+    readonly rowWidths: string[];
+    get skeletonRows(): number[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportTreeSkeletonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportTreeSkeletonComponent, "structra-report-tree-skeleton", never, { "rows": { "alias": "rows"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class StructraReportFilterPanelComponent {
+    readonly ngModelStandalone: {
+        standalone: boolean;
+    };
+    titulo: string;
+    subtitulo: string;
+    filtros: ReportFilterMeta[];
+    valores: Record<string, string>;
+    collapsed: boolean;
+    pesquisando: boolean;
+    collapsedChange: EventEmitter<boolean>;
+    valorChange: EventEmitter<{
+        id: string;
+        value: string;
+    }>;
+    pesquisar: EventEmitter<void>;
+    readonly boolOptions: UiSelectOption<string>[];
+    compareStr: (a: unknown, b: unknown) => boolean;
+    patchValor(id: string, value: string | null | undefined): void;
+    valorAtual(id: string): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportFilterPanelComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportFilterPanelComponent, "structra-report-filter-panel", never, { "titulo": { "alias": "titulo"; "required": true; }; "subtitulo": { "alias": "subtitulo"; "required": false; }; "filtros": { "alias": "filtros"; "required": true; }; "valores": { "alias": "valores"; "required": true; }; "collapsed": { "alias": "collapsed"; "required": false; }; "pesquisando": { "alias": "pesquisando"; "required": false; }; }, { "collapsedChange": "collapsedChange"; "valorChange": "valorChange"; "pesquisar": "pesquisar"; }, never, never, true, never>;
+}
+
+declare class StructraReportTableComponent {
+    colunas: ReportColumnMeta[];
+    linhas: Array<Record<string, unknown>>;
+    totalRegistros: number;
+    readonly isBooleanColumn: typeof isReportBooleanColumn;
+    readonly isNowrapColumn: typeof isReportNowrapColumn;
+    readonly columnWidthStyle: typeof reportColumnWidthStyle;
+    hasFixedColumnWidths(): boolean;
+    cellValue(linha: Record<string, unknown>, coluna: ReportColumnMeta): string;
+    booleanChecked(linha: Record<string, unknown>, coluna: ReportColumnMeta): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportTableComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportTableComponent, "structra-report-table", never, { "colunas": { "alias": "colunas"; "required": true; }; "linhas": { "alias": "linhas"; "required": true; }; "totalRegistros": { "alias": "totalRegistros"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class StructraReportPaginatorComponent {
+    page: number;
+    totalPages: number;
+    totalRegistros: number;
+    pageSize: number;
+    disabled: boolean;
+    pageChange: EventEmitter<number>;
+    get podeAnterior(): boolean;
+    get podeProxima(): boolean;
+    irAnterior(): void;
+    irProxima(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportPaginatorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportPaginatorComponent, "structra-report-paginator", never, { "page": { "alias": "page"; "required": true; }; "totalPages": { "alias": "totalPages"; "required": true; }; "totalRegistros": { "alias": "totalRegistros"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+}
+
+declare class StructraReportEmptyStateComponent {
+    message: string;
+    description: string;
+    iconClass: string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportEmptyStateComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportEmptyStateComponent, "structra-report-empty-state", never, { "message": { "alias": "message"; "required": false; }; "description": { "alias": "description"; "required": false; }; "iconClass": { "alias": "iconClass"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class StructraReportLoadingSkeletonComponent {
+    rows: number;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportLoadingSkeletonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportLoadingSkeletonComponent, "structra-report-loading-skeleton", never, { "rows": { "alias": "rows"; "required": false; }; }, {}, never, never, true, never>;
+}
+
+declare class StructraReportViewerComponent {
+    metadata: ReportMetadata | null;
+    result: ReportResult | null;
+    filtrosValores: Record<string, string>;
+    loadingMetadata: boolean;
+    loadingResult: boolean;
+    collapsed: boolean;
+    filtrosValoresChange: EventEmitter<Record<string, string>>;
+    collapsedChange: EventEmitter<boolean>;
+    pesquisar: EventEmitter<void>;
+    onValorChange(event: {
+        id: string;
+        value: string;
+    }): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportViewerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportViewerComponent, "structra-report-viewer", never, { "metadata": { "alias": "metadata"; "required": false; }; "result": { "alias": "result"; "required": false; }; "filtrosValores": { "alias": "filtrosValores"; "required": true; }; "loadingMetadata": { "alias": "loadingMetadata"; "required": false; }; "loadingResult": { "alias": "loadingResult"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; }, { "filtrosValoresChange": "filtrosValoresChange"; "collapsedChange": "collapsedChange"; "pesquisar": "pesquisar"; }, never, never, true, never>;
+}
+
+declare class StructraReportPageComponent {
+    private readonly transport;
+    autoSelectFirst: boolean;
+    autoPesquisarOnSelect: boolean;
+    reportSelected: EventEmitter<string | null>;
+    reportLoaded: EventEmitter<ReportResult | null>;
+    readonly treeNodes: _angular_core.WritableSignal<ReportTreeNode[]>;
+    readonly selectedReportId: _angular_core.WritableSignal<string | null>;
+    readonly metadata: _angular_core.WritableSignal<ReportMetadata | null>;
+    readonly result: _angular_core.WritableSignal<ReportResult | null>;
+    readonly filtrosValores: _angular_core.WritableSignal<Record<string, string>>;
+    readonly loadingTree: _angular_core.WritableSignal<boolean>;
+    readonly loadingMetadata: _angular_core.WritableSignal<boolean>;
+    readonly loadingResult: _angular_core.WritableSignal<boolean>;
+    readonly painelFiltroRecolhido: _angular_core.WritableSignal<boolean>;
+    readonly treeViewNodes: _angular_core.Signal<structra_ui.TreeViewNode[]>;
+    constructor();
+    carregarArvore(): Promise<void>;
+    onReportSelected(id: string | null): void;
+    private carregarMetadata;
+    pesquisar(): Promise<void>;
+    patchFiltrosValores(next: Record<string, string>): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<StructraReportPageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<StructraReportPageComponent, "structra-report-page", never, { "autoSelectFirst": { "alias": "autoSelectFirst"; "required": false; }; "autoPesquisarOnSelect": { "alias": "autoPesquisarOnSelect"; "required": false; }; }, { "reportSelected": "reportSelected"; "reportLoaded": "reportLoaded"; }, never, never, true, never>;
+}
+
+export { ADAPTIVE_DATA_VIEW_MOBILE_QUERY, APP_SIDEBAR_LABEL_REVEAL_LAG_MS, APP_SIDEBAR_LAYOUT_DURATION_MS, APP_SIDEBAR_NAV_REVEAL_TOTAL_MS, APP_THEME_BASE_CLASS, APP_THEME_IDS, ActionMenuComponent, AdaptiveDataViewComponent, AdminLoginPageComponent, AdminLoginShellComponent, StructraSidebarUserPanelComponent as AdminSidebarUserPanelComponent, AlertComponent, AnchoredOverlayComponent, AppBreadcrumbComponent, AppDialogComponent, AppLibLightBlockScrollStrategy, AppShellComponent, AppShellSidebarTemplateDirective, AppShellSidebarToggleComponent, AppSidebarBottomActionsSlotDirective, AppSidebarBottomActionsTemplateDirective, AppSidebarBrandDirective, AppSidebarComponent, AppSidebarFooterSlotDirective, AppSidebarFooterTemplateDirective, AppSidebarHeaderSlotDirective, AppSidebarHeaderTemplateDirective, AppSidebarToolbarDirective, AppSidebarUserInfoSlotDirective, AppSidebarUserInfoTemplateDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, ButtonType as BaseButtonType, ButtonVariant as BaseButtonVariant, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, ButtonRadius, ButtonSize, ButtonType, ButtonVariant, CADASTRO_COLLAPSIBLE_REMOTE_LOAD_DELAY_MS, CADASTRO_DUPLICATE_FLAG_STATE, CADASTRO_DUPLICATE_SOURCE_ID_STATE, CADASTRO_FOCO_COLUNA_APOS_RESUMO_MS, CADASTRO_FORM_COLLECTION_REMOVE_ITEM_CONFIRM, CADASTRO_INVALIDATE_ROUTE_SNAPSHOT, CADASTRO_PAGE_SUBTITULO_PADRAO, CADASTRO_PAGE_TITULO_NOVO_PADRAO, CADASTRO_PESSOA_INLINE_DESTINO_URL_FRAGMENTS, CADASTRO_REFERENCIA_DIALOG_CONTEXT, CADASTRO_REFERENCIA_DIALOG_PAGE_CONFIG, CADASTRO_REFERENCIA_ROUTE_ACCESS, CADASTRO_REFERENCIA_ROUTE_ACCESS_PERMISSIVE, CADASTRO_RESUMO_FIELD_NAVIGATE_DEFER_MS, CADASTRO_TOAST_TITLE_PADRAO, CADASTRO_VALIDATION_SUMMARY_PINNED, CADASTRO_VALIDATION_SUMMARY_STATIC, CATEGORIAS_NAV_ID_EXCLUIDO, CATEGORIAS_NAV_LINHA_GRAVADA, CATEGORIAS_NAV_VOLTAR_SEM_RECARREGAR, CLIENTES_NAV_ID_EXCLUIDO, CLIENTES_NAV_LINHA_GRAVADA, CLIENTES_NAV_VOLTAR_SEM_RECARREGAR, CONSULTA_DATETIME_KEYS_ISO_PARA_FMT, CONSULTA_DOCUMENTO_GRID_KEYS_ISO_PARA_FMT, CONSULTA_FILTROS_SESSAO_USER, CONSULTA_GRID_OPTS_DATAS_PADRAO, CONSULTA_LISTA_CACHE_MAX_PAGINAS_DEFAULT, CONSULTA_LISTA_CACHE_NS_SEP, CONSULTA_LISTA_CACHE_TTL_MS_DEFAULT, CONSULTA_MOBILE_LAYOUT_MEDIA_QUERY, CONSULTA_MULTISELECT_LABEL_STUB, CONSULTA_OPTIONS_LISTAR_RESOLVER, CONSULTA_PEDIDOS_GRID_OPTS, CONSULTA_PHONE_GRID_KEYS_ISO_PARA_FMT, CONSULTA_PRESET_SELECT_EMPTY_OPTIONS_MESSAGE_DESKTOP, CONSULTA_PRESET_SELECT_EMPTY_OPTIONS_MESSAGE_MOBILE, CONSULTA_PRODUTOS_GRID_OPTS, CONSULTA_ROUTE_REUSE, CONSULTA_SERVIDOR_LISTA_QUERY_DEFAULTS, CONSULTA_TOPBAR_SLOT, CadastroBasePageComponent, CadastroCollectionGridColumnFormat, CadastroCollectionReferenciaHostService, CadastroCollectionRuntime, CadastroEnumOptionsRegistry, CadastroFieldRendererComponent, CadastroFieldRuntime, CadastroFieldsBaseComponent, CadastroFormDraftCacheService, CadastroFormLoadingSkeletonComponent, CadastroMetadataPageBase, CadastroMetadataPageComponent, CadastroMetadataPageServiceBase, CadastroMetadataPageShellLayoutComponent, CadastroMetadataPageStateBase, CadastroMetadataShellPageComponent, CadastroPadraoPageBase, CadastroReferenceRegistry, CadastroReferenciaDialogBridgeRegistry, CadastroReferenciaDialogHostComponent, CadastroReferenciaDialogService, CadastroReferenciaOpenMode, CadastroRuntime, CadastroRuntimeRegistry, CadastroSectionPanelLayout, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ColorPickerFieldComponent, ComponentType, ConfirmDialogComponent, ConfirmDialogService, ConsoleLogComponent, ConsultaBasePageComponent, ConsultaCadastroFiltroDialogComponent, ConsultaCardCampoPapel, ConsultaCardFieldFormat, ConsultaCatalogBundleHelper, ConsultaFiltroPresetToolbarComponent, ConsultaFiltrosSessaoService, ConsultaGridColumnFormat, ConsultaGridOrderDirection, ConsultaListaMemoriaCacheService, ConsultaPadraoPageBase, ConsultaPageCache, ContainerLayoutSize, ContextMenuComponent, CpfCnpjFieldComponent, DEFAULT_STRUCTRA_SHELL_SCROLL_RESTORATION_OPTIONS, DROPDOWN_SEARCH_LOCAL_PAGE_SIZE, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DividerComponent, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, ENM_STATUS_OPCOES_SELECT, EmptyStateComponent, EnmStatus, FIELD_MOBILE_LAYOUT_QUERY, FILE_PREVIEW_UNAVAILABLE_MESSAGE, FORM_CONTAINER_STATE_STORAGE_PREFIX, FORNECEDORES_NAV_ID_EXCLUIDO, FORNECEDORES_NAV_LINHA_GRAVADA, FORNECEDORES_NAV_VOLTAR_SEM_RECARREGAR, FieldCadastroRedirectButtonComponent, FileUploadFieldComponent, FileUploadType, FormActionsAlign, FormActionsComponent, FormColComponent, FormCollectionComponent, FormCollectionLayout, FormGroupComponent, FormGroupVariant, FormLayoutGap, FormRowAlign, FormRowComponent, FormRowJustify, FormSectionAlign, FormSectionComponent, FormSectionRadius, FormSectionVariant, FormTabComponent, FormTabsComponent, GridLayoutConsultaService, ImagePreviewPanelComponent, InputMaskFieldComponent, IntegerFieldComponent, LAYOUT_STACK_SIDE_BY_SIDE, LAYOUT_STACK_STACKED, LayoutStackAlign, LayoutStackComponent, LayoutStackDirection, LayoutStackItemAlign, LibDialogSize, ListItemComponent, LoadingDialogComponent, LoadingDialogService, MaskedTextFieldBase, MenuDividerComponent, MenuDropdownPlacement, MenuGroupComponent, MenuListComponent, MultiselectFieldComponent, NO_OP_CONSULTA_ROUTE_REUSE, NO_OP_CONSULTA_TOPBAR_SLOT, NgControlFieldDirective, OPS_BOOL, OPS_DATA, OPS_TEXTO, OPS_TEXTO_MULTISELECT, ORIGEM_CADASTRO_INLINE_PESSOA, OnboardingChecklistComponent, OverlayPlacement, PDF_IFRAME_VIEWER_HASH, PEDIDOS_NAV_ID_EXCLUIDO, PEDIDOS_NAV_LINHA_GRAVADA, PEDIDOS_NAV_VOLTAR_SEM_RECARREGAR, PERMISSION_GROUP_OUTROS_KEY, PERMISSION_GROUP_OUTROS_LABEL, PERMISSION_GROUP_OUTROS_ORDER, PESSOAS_NAV_LINHA_GRAVADA, PESSOAS_NAV_VOLTAR_SEM_RECARREGAR, PHONE_BR_LANDLINE_MASK, PHONE_BR_MOBILE_MASK, PRODUTOS_NAV_ID_EXCLUIDO, PRODUTOS_NAV_LINHA_GRAVADA, PRODUTOS_NAV_VOLTAR_SEM_RECARREGAR, StructraPageFooterComponent as PageFooterComponent, PasswordFieldComponent, PermissionGroupTabComponent, PermissionGroupTabsComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, ReferenceOptionPreset, STRUCTRA_ADMIN_ROUTE_REDIRECT_CACHE_PREFIX, STRUCTRA_ADMIN_ROUTE_REDIRECT_LOGIN_ID_CACHE_KEY, STRUCTRA_CADASTRO_INLINE_RESULT_KEY, STRUCTRA_CADASTRO_INLINE_RETURN_KEY, STRUCTRA_CONSULTA_FORCE_REFRESH_KEY, STRUCTRA_DEDICATED_BACK_TO_TOP_SELECTOR, STRUCTRA_GRID_LAYOUT_API_BASE_RESOLVER, STRUCTRA_GRID_LAYOUT_AUTH_HEADERS_RESOLVER, STRUCTRA_GRID_LAYOUT_TENANT_RESOLVER, STRUCTRA_INLINE_FORM_DRAFT_PENDING_PREFIX, STRUCTRA_MIDIA_PUBLIC_BASE_RESOLVER, STRUCTRA_MIDIA_UPLOAD_TRANSPORT, STRUCTRA_PAGE_CACHE_SCOPE_SEP, STRUCTRA_PAGE_FOOTER_PARTS, STRUCTRA_PAGE_STATE_ACTIVE_TAB_PREFIX, STRUCTRA_REPORT_DEFAULT_PAGE_SIZE, STRUCTRA_REPORT_TRANSPORT, STRUCTRA_SHELL_SCROLL_RESTORATION_OPTIONS, STRUCTRA_SHELL_TOPBAR_TITLE_SKELETON, STRUCTRA_SIMULATED_LOADING_DELAY_MS, STRUCTRA_THEME_DARK_CLASS, STRUCTRA_THEME_IDS, STRUCTRA_UI, ScriptEditorFieldComponent, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonStatCardComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, StructraAdminRouteRedirectPageBase, StructraBackToTopButtonComponent, StructraPageCacheService, StructraPageComponentOutletComponent, StructraPageComponentRegistry, StructraPageFooterComponent, StructraPageStateCacheService, StructraProgressOverlayComponent, StructraReportEmptyStateComponent, StructraReportFilterPanelComponent, StructraReportLoadingSkeletonComponent, StructraReportPageComponent, StructraReportPaginatorComponent, StructraReportTableComponent, StructraReportTreeComponent, StructraReportTreeSkeletonComponent, StructraReportViewerComponent, ScriptEditorFieldComponent as StructraScriptEditorComponent, StructraShellScrollRestorationService, StructraShellTopbarSlotService, AppSidebarBottomActionsTemplateDirective as StructraSidebarBottomActionsDirective, AppSidebarFooterTemplateDirective as StructraSidebarFooterDirective, AppSidebarHeaderTemplateDirective as StructraSidebarHeaderDirective, AppSidebarUserInfoTemplateDirective as StructraSidebarUserInfoDirective, StructraSidebarUserPanelComponent, SwitchFieldComponent, THEME_PRIMARY_COLOR_LABEL_PT_BR, TOAST_REGISTRO_EXCLUIDO_SUCESSO, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ThemeDirective, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, TreeViewComponent, USUARIOS_CONSULTA_GRID_OPTS, USUARIOS_NAV_ID_EXCLUIDO, USUARIOS_NAV_LINHA_GRAVADA, USUARIOS_NAV_VOLTAR_SEM_RECARREGAR, VENDEDORES_NAV_ID_EXCLUIDO, VENDEDORES_NAV_LINHA_GRAVADA, VENDEDORES_NAV_VOLTAR_SEM_RECARREGAR, ValidationSummaryComponent, agruparCamposMetadataPorSecao, agruparPermissionTabs, anchoredOverlayPositions, aplicarNormalizacaoMultiselectIdsNoPartial, aplicarProdutoDtoNoFormulario, appendCadastroPageActiveTabQuery, appendPdfIframeViewerParams, applyCadastroCollectionArrayValidators, applyCadastroModoSenhaNovos, applyCollectionValidationSummaryNavigation, applyCollectionValueToFormArray, applyEntityToCadastroFormByMetadata, applyOptionalThemeHostClasses, applyPickedCalendarDate, buildCadastroFiltroDialogItensGridRows, buildCadastroMetadataShellRuntime, buildCadastroPageActiveTabPageKey, buildCadastroPageActiveTabPageKeyFromLayout, buildCadastroPageRuntime, buildCadastroRedirectReturnUrl, buildCadastroReferenciaDialogContext, buildCatalogoStubConsultaRuntime, buildConsultaConfirmDuplicarLinhaFromLayout, buildConsultaConfirmRemoverLinhaFromLayout, buildConsultaDefaultIsItemGuard, buildConsultaListaCacheKey, buildConsultaPageMetadataUnified, buildConsultaPageRuntime, buildDecimalBrDisplay, buildDecimalBrParseString, buildDefaultConsultaMapCardFromColunasGrid, buildEmptyStateOverlayHtml, buildFormContainerStateStorageKey, buildFormGroupFromCadastroCampos, buildHistoryStateAfterReturningFromNestedInlineChild, buildInlineReturnStateForChildCadastro, buildNovoFormDefaultsFromCampos, buildRouteReuseKeyFromAppPathname, buildRouteReuseKeyFromNovoRouterLink, buildStructraAdminRouteRedirectCacheKey, buildStructraAdminRouteRedirectChildUrl, buildStructraPageCacheCadastroInitKey, buildStructraPageCacheRouteScope, buildStructraPageFooterParts, buildStructraSidebarTemplateContext, buildValidationMetaFromCadastroCampos, cadastroBuildImageUploadMetadata, cadastroCampoBlocoEditorOcupaLinhaInteira, cadastroCampoBooleanOcupaLinhaInteira, cadastroCampoMetadataDtoFromPartial, cadastroCampoMetadataEhBoolean, cadastroCampoMetadataLarguraCompacta, cadastroCampoMetadataLarguraFixaCss, cadastroCampoReferenciaMetadataDtoFromPartial, cadastroCampoRuleMaxLength, cadastroCampoScriptEditorLanguage, cadastroCampoScriptEditorMinHeight, cadastroCampoValidacaoDtoFromPartial, cadastroCampoWrapperWidthCss, cadastroCollectionEditorGridColumns, cadastroCollectionMaxItemsValidator, cadastroCollectionMinItemsValidator, cadastroConfirmExcluirPartialFromLayout, cadastroContainerLayoutSizeDoRecord, cadastroContainerPathJoin, cadastroCrudMessagesDoFormLayout, cadastroDeclarativeSnapshotDtoFromPartial, cadastroEnsureSingleBooleanInCollection, cadastroFieldsPerRowDoRecord, cadastroFlattenContainerRaw, cadastroFormDraftEnabledDoLayout, cadastroFormGridColumns, cadastroFormLayoutComoRecord, cadastroFormLayoutDoBundle, cadastroFormLayoutDoRuntime, cadastroFormLayoutPreserveActiveTab, cadastroFormPageLayoutFromPartial, cadastroGcd, cadastroGetCollectionItemControl, cadastroGridColumnSpanForFieldIndex, cadastroGridDenominadorTracks, cadastroGridTemplateColumnsLinhaUnicaSeAplicavel, cadastroInferExtensaoArquivo, cadastroInferImageContentType, cadastroLcm, cadastroMetadataDtoParaValidacaoLike, cadastroNavKeysStructra, cadastroNomeArquivoDaUploadUrl, cadastroNormalizarUploadUrlPorPrefixo, cadastroPageActionDtoFromPartial, cadastroPageActionsPorRegiao, cadastroPageActiveTabToRestore, cadastroPageComponentDtoFromPartial, cadastroPageComponentsPorRegiao, cadastroPageIdentityDoFormLayout, cadastroPageOverlayDtoFromPartial, cadastroPageShellAtivo, cadastroPageShellTabsKeepAliveFromLayout, cadastroPageTabDtoFromPartial, cadastroPageTabsOrdenados, cadastroPainelMaxWidthCss, cadastroRawBooleanDeep, cadastroRawNumber, cadastroRawString, cadastroReferenceEntryFromListarService, cadastroReferenciaOpenModeFromWire, cadastroReindexarCollectionOrdem, cadastroResolveId, cadastroSecaoFormGroupDense, cadastroSecaoPersisteExpandedState, cadastroSecaoRenderizaInlineDentroDoPai, cadastroSecaoSegmentosIntercalados, cadastroSecaoSegmentosParaRender, cadastroSecaoUsaFormGroup, cadastroSecaoUsaFormGroupComoBlocoVisual, cadastroSecaoUsaSuperficieDeclarativa, cadastroSingleBooleanCollectionBinding, cadastroTitulosEfectivosDoFormLayout, cadastroToastTitleEfectivoDoFormLayout, cadastroToolbarButtonDtoFromPartial, cadastroToolbarVisibilityDoFormLayout, cadastroUseBackToTopButtonFromLayout, cadastroValidationSummaryFlagsDoRecord, cadastroValidationSummaryPinnedFromFlags, cadastroWireCollectionOrdemReindexOnAdd, cadastroWireCollectionOrdemReindexOnAddRemove, cadastroWireCollectionOrdemReindexOnRemove, campoMetadataVisivelNoModo, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, carregarOpcoesMultiselectViaSpec, cepMaskCompleteValidator, clearRequiredValidatorsOnReadOnlyCadastroFields, clearStructraCadastroInlineReturnSessionCacheForTests, clearStructraCadastroSessionStorageOnLogout, coerceDecimalPtBr, coerceReportBoolean, collectValidationSummaryItems, colunasGridTemFormatacaoDeclarativa, computeReferenciaHasMore, consoleLogLevelClass, consultaCampoMetadataDtoFromPartial, consultaCardCampoDtoFromPartial, consultaFiltroValorDataSomenteDia, consultaGridColunaDtoFromPartial, consultaGridColunaKeyParaCampoLinha, consultaGridConfigDtoFromPartial, consultaPassaItem, consultaPassaTodosItens, consultaUsuariosMetadataReplyFromPartial, consumeCadastroInlineFormDraftPendingRestore, consumirResultadoCadastroInlineCampoPessoaId, consumirResultadoCadastroInlineCampoReferencia, cpfCnpjMaskCompleteValidator, createCadastroDialogActivatedRoute, createCadastroMetadataPageConfig, createCadastroPadraoConfig, createCadastroRuntime, createCollectionFormArray, createCollectionItemFormGroup, createConsultaListaItemGuardFromFiltroUi, createConsultaOptionsListarResolver, createConsultaPadraoRuntime, createConsultaPresetSelectEmptyOptionsMessageSignal, createConsultaPresetStorageApi, createGrpcSaveRequestMapper, createInlineHostNavigation, createMapCardFromConsultaColunasGrid, createMapGridRowFromConsultaColunasGrid, createSaveRequestFromPartialMapper, criarDraftInlinePessoa, decimalPtBrNaoNegativoValidator, decimalPtBrToNullableNumber, defaultIsConsultaListItemMinimo, defaultParseLinhaGravadaJson, deleteConfirmPageConfigFromPartial, deriveCadastroTituloEditar, deriveConsultaListaItemGuardPropsFromFiltroUi, duplicateConfigFromLayout, duplicatePageConfigFromPartial, enrichCadastroReferenciaDialogPageConfig, ensureCadastroCollectionMinItems, ensureCadastroFormControlsFromMetadata, escapeHtml, evaluateStructraPageVisibleExpression, executarConsultaServidorComPreset, extractConsultaListaCacheNamespace, extractDecimalBrParts, fileIsLikelyImage, fileMatchesAccept, filtrarSecoesMetadataPorModo, filtrarUiSelectOptionsPainelComValorPersistente, filtrarUiSelectOptionsPorQuery, findCadastroCampoByKey, findFirstReportLeafId, findReportTreeLabel, fixedDigitsMaskCompleteValidator, flattenCadastroMetadataSecoes, fmtDataPt, fmtDocumentoCelulaConsultaGrid, formatAcceptForDisplay, formatDateTimePtBr, formatDecimalBr, formatDocumentoPessoaParaExibicao, formatFileSizeBytes, formatIntegerThousandsBr, formatMaskDigits, formatPhoneBr, formatUiFieldDateValue, getFilePreviewKind, getStructraActionsByGroup, getThemeClass, getThemeClassList, getThemePrimaryColorLabelPtBr, getThemeTokenClass, hexParaColorInput, inferCadastroItemFieldsFromPlainRows, inferCadastroListaUrlFallback, initialCadastroControlValue, injectEffectiveThemeId, isCadastroDuplicateNavigation, isCollectionField, isCollectionLikeField, isConsultaCardAutoSubtitleExcluded, isLegacyDarkThemeId, isLegacyFormContainerStateStorageKey, isLegacyNomeDocumentoReferencePreset, isReadonlyCollectionField, isReportBooleanColumn, isReportNowrapColumn, isValidPhoneBr, libDialogPanelClasses, listaUrlFromRotaCadastro, listarItensCadastroReferencia, listarTodosPaginado, loadPresetsJson, loadStructraAdminRouteRedirectTarget, mapCadastroFormRawToPayload, mapConsultaGridColunasParaDataGrid, mapConsultaMetadataParaFiltroUi, mapErroTransporteParaMensagem as mapErroListaDefault, mapErroTransporteParaMensagem, mapEstadosToOptions, mapFiltroSalvoParaConsultaPreset, mapListarItensParaMultiselectOpcoes, mapReportTreeToTreeViewNodes, markCadastroInlineFormDraftPendingRestore, maskDigitCount, mergeCadastroConfirmExcluir, mergeConsultaGridRowFormattingFromColunasGrid, mergeConsultaMultiselectOpcoesComSeleccionados, mergeDocumentoFmtNaLinhaConsulta, mergeMapConsultaGridColunasOptsComColumnFormat, mergeNovoIdEmListaSelecionada, mergeStructraShellScrollRestorationOptions, metadataCampoParaChaveLinhaCliente, modoPermissaoReferenciaFromWire, montarFiltrosGrpcPreset, montarFiltrosServidorPreset, montarHierarquiaSecoesMetadata, multiselectIdListRequiredValidator, multiselectMaxItemsValidator, navegarVoltarLista, navegarVoltarListaComIdRemovido, navegarVoltarListaComLinha, navigateCadastroDuplicate, navigateCommandsFromRotaAlterar, navigateCommandsFromRotaNovo, nomeSalvarParaPayloadComPessoa, normalizarArvoreSecoesMetadata, normalizarHexCor, normalizarItensParaGravarServidorCadastro, normalizarListaIdsMultiselect, normalizarOperadorConsultaParaEnvioServidor, normalizarRotaReferencia, normalizarStructraAction, normalizarStructraActionGroup, normalizarStructraActionGroups, normalizeCadastroAppPath, normalizeCadastroCampoMetadataWire, normalizeCadastroInitRouteIdParam, normalizeCadastroItemEditorDecimalControls, normalizeCadastroReferenciaDialogRotaKey, normalizeCadastroRouteForContainerState, normalizeConsoleLogLevel, normalizeFormDateValue, normalizePhoneBr, normalizeStructraAdminPath, normalizeStructraTheme, novoPathCommandsFromRota, onlyDigits, operadorConsultaComValorUnicoComparacao, operadorConsultaDatetimeUsaDatePicker, operadoresConsultaCampo, operadoresPorTipo, ordenarFiltroItens, ordenarStructraActions, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, patchFormFromEntidadeRecord, permissionTabsUsamGruposVerticais, permissoesReferenciaMetadata, phoneBrDynamicMaskCompleteValidator, phoneBrMaskCompleteValidator, phoneBrMaskFromDigits, pickCadastroPageActiveTabExplicit, pickTabKeyLinkedToSummaryItems, precisaValor, precisaValorFinal, provideAppPageFooter, provideStructraCadastroReferenciaDialogRoot, provideStructraPageFooter, provideStructraShellScrollRestoration, qtdCriteriosPresetParaSkeleton, readCadastroDuplicateSourceId, readCadastroPageActiveTabFromNavigationState, readCadastroPageActiveTabFromUrl, readFormContainerCollapsedFromStorage, readStructraAdminRouteRedirectTarget, readStructraCadastroInlineReturn, referenciaAbreEmDialog, referenciaOpenModeRaw, referenciaUsesLegacyRegistryMapper, registerCadastroReferenceEntries, registerCadastroReferenceListSources, registerCadastroReferenciaDialogBridges, registerStructraBuiltinPageComponents, replaceProdutoCadastroFormControls, reportColumnWidthStyle, reportTableHasFixedWidths, resetStructraCadastroReferenciaDialogRootForTests, resolveCadastroCollectionMinItems, resolveCadastroListaUrlParaNavegacao, resolveCadastroPageActiveTabKey, resolveCadastroReferenciaMapOptions, resolveConsultaEditActionLabelFromGridConfig, resolveConsultaListaQuerySliceFromGridConfig, resolveConsultaNavKeysFromPageLayout, resolveConsultaNovoRouterLinkFromLayout, resolveConsultaRouteEditBaseFromLayout, resolveConsultaToastTitleLista, resolveControlAtPath, resolveFormContainerCollapsed, resolveReferenciaOpcaoLabel, resolveStructraAdminMenuUrl, resolveStructraPageCacheCadastroScope, resolveStructraPageInputExpression, resolveStructraPageInputs, resolveStructraShellScrollContainer, resolverAcoesReferenciaPorRota, resolverValorOpcaoPorRotuloNormalizado, resumoValorMultiselectFiltro, rotaListaReferencia, rotuloEnmStatus, rotuloNomeDocumentoLista, rotuloOperadorConsulta, rotuloPessoaLista, runStructraSimulatedLoadingDelay, sanitizeDecimalBrInput, sanitizeIntegerDigits, sanitizeRecordForCadastroDuplicate, savePresetsJson, scheduleRemoteCollectionHydrationAfterSectionExpand, secaoMetadataEhContainerPlain, secaoTemConteudoVisivel, secaoTemCorpoParaRender, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, serializeCollectionFormArray, shouldDeferInitialRemoteCollectionLoad, shouldSkipCadastroPageActiveTabCacheWrite, shouldSkipStructraAdminMenuNavigation, stripStructraCadastroInlineResultFromHistory, stripToDigits, structraActionButtonVariant, structraCadastroInlineResultTemIdSalvo, structraCadastroInlineResultTemReferenciaExcluida, structraElementScrolls, structraHasValue, structraIsFilledString, structraIsFormGroup, structraIsValidPort, structraParseNumberOrNull, structraReadFormValue, structraReadNestedValue, structraTrimString, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid, syncStructraCadastroInlineReturnSessionCache, tabWarningFromLinkedSummaryItems, tipoCampoMetadataParaUi, tipoValorApi, toCadastroReferenceListPageResult, toConsoleLogLineView, toConsoleLogLineViews, toUiSelectOptionsFromMetadata, uiSelectOpcaoIdNomeDocumento, uiSelectOpcoesDePessoas, validationLikeFromCampoMetadata, validatorsFromCampo, writeFormContainerCollapsedToStorage };
+export type { AdaptiveDataViewMode, AdminLoginShellConfig, AdminLoginSubmitPayload, StructraSidebarEmpresaContext as AdminSidebarEmpresaContext, StructraSidebarUserView as AdminSidebarUserView, AlertAction, AlertType, AppThemeId, AppThemeOption, ApplyCadastroModoSenhaOptions, BreadcrumbItem, BuildCadastroMetadataShellRuntimeOptions, BuildCadastroPageRuntimeOptions, CadastroActionStateDto$1 as CadastroActionStateDto, CadastroAutoMapFormValueConfig, CadastroCampoContaNaGrelhaFn, CadastroCampoMetadataDto, CadastroCampoMetadataMergeInput, CadastroCampoReferenciaMetadataDto, CadastroCampoSelectOptionDto, CadastroCampoValidacaoDto, CadastroCampoValidacaoLike, CadastroCollectionBinding, CadastroCollectionBridge, CadastroCollectionEditingItemControlsChangeEvent, CadastroCollectionEditingItemControlsChangeOptions, CadastroCollectionItemEvent, CadastroCollectionItemFieldsChangeEvent, CadastroCollectionItemFieldsChangeOptions, CadastroCollectionItemsChangeEvent, CadastroCollectionPageReplyWire, CadastroCollectionPageRequestWire, CadastroCollectionPagingPort, CadastroCollectionPagingUi, CadastroCollectionSaveHandler, CadastroCollectionStateDto, CadastroConfirmExcluirPartial, CadastroCrudMessagesResolved, CadastroDeclarativeSnapshotDto, CadastroDuplicateActionConfig, CadastroEnsureSingleBooleanInCollectionOptions, CadastroFieldChangeEvent, CadastroFieldEventBase, CadastroFieldKey, CadastroFieldRegistration, CadastroFieldSelectEvent, CadastroFieldSimpleEvent, CadastroFiltroDialogRuntimeSlice, CadastroFormPageLayout, CadastroHeaderSecondaryAction, CadastroImageUploadMetadata, CadastroImageUploadMetadataOptions, CadastroInferExtensaoArquivoOptions, CadastroInferImageContentTypeOptions, CadastroInlineHostNavigationConfig, CadastroListSelectBinding, CadastroMetadataCamposReplyLike, CadastroMetadataPageCadastro, CadastroMetadataPageServiceConfig, CadastroMetadataPageShellCallbacks, CadastroMetadataPageStateConfig, CadastroMetadataPageVm, CadastroMetadataSecao, CadastroMetadataServiceConfig, CadastroMetadataServicePort, CadastroMetadataShellRuntime, CadastroMetadataView, CadastroModo, CadastroMultiselectBinding, CadastroPadraoGrpcService, CadastroPageActionDto, CadastroPageActiveTabResolveInput, CadastroPageComponentDto, CadastroPageConfig, CadastroPageIdentityFallback, CadastroPageNavKeysConfig, CadastroPageOverlayDto, CadastroPageRuntime, CadastroPageSenhaConfig, CadastroPageTabDto, CadastroPessoaOpcaoMin, CadastroRawBooleanDeepOptions, CadastroReferenceListPageParams, CadastroReferenceListPageResult, CadastroReferenceListarService, CadastroReferenceRegistryEntry, CadastroReferenciaAcoesPermitidas, CadastroReferenciaDialogBridgeEntry, CadastroReferenciaDialogBridgeFactory, CadastroReferenciaDialogCloseReason, CadastroReferenciaDialogCompletePayload, CadastroReferenciaDialogContext, CadastroReferenciaDialogOpenOptions, CadastroReferenciaDialogOpenRequest, CadastroReferenciaOpenModeWireRef, CadastroReferenciaPermissoesMetadata, CadastroReferenciaRouteAccess, CadastroReindexarCollectionOrdemOptions, CadastroRuntimeDeps, CadastroRuntimeOptions, CadastroSearchSelectBinding, CadastroSearchSelectRedirectSuffix, CadastroSearchSelectReferenciaDialog, CadastroSecaoSegmento, CadastroSingleBooleanCollectionBindingOptions, CadastroTitulosFallback, CadastroToolbarButtonDto, CadastroToolbarVisibilityResolved, CadastroValidationUi, CardItemBooleanField, CardItemMetaField, CardItemView, CardListDataMode, CardListHeaderPosition, CardListMapFn, CatalogoStubConsultaConfig, CatalogoStubListaItem, ConfirmDialogData, ConfirmDialogVariant, ConsoleLogLevel, ConsoleLogLine, ConsoleLogLineView, ConsultaBaseConfig, ConsultaCampoDef, ConsultaCampoMetadataDto, ConsultaCardCampoDto, ConsultaCatalogBundleConfig, ConsultaCatalogBundleSessaoPort, ConsultaCatalogEntityBindings, ConsultaCatalogInitCarregada, ConsultaCrudAdapterConfig, ConsultaEnumSelectOptionDto, ConsultaFiltroCampo, ConsultaFiltroItem, ConsultaFiltroMatchAdapters, ConsultaFiltroPreset, ConsultaFiltroSalvoDto, ConsultaFiltroSalvoItemDto, ConsultaFiltroUiFragment, ConsultaFiltroValorTipo, ConsultaFiltrosBundleSessao, ConsultaFiltrosChromeVolatil, ConsultaFiltrosSessaoConsultaPadraoApi, ConsultaFiltrosSessaoUserLike, ConsultaFiltrosSessaoVolatilApi, ConsultaFiltrosVolatilHandlers, ConsultaGridColunaDto, ConsultaGridColunaDtoLike, ConsultaGridConfigDto, ConsultaInitCarregada, ConsultaListaCacheKeyParts, ConsultaListaCachePayload, ConsultaListaMemoriaCacheStoreOpts, ConsultaListaQueryParamsLike, ConsultaListaResultadoLike, ConsultaListaServidorQuerySlice, ConsultaMapCardLinha, ConsultaMetadataCampo, ConsultaMetadataReplyLike, ConsultaMetadataServicePort, ConsultaMultiselectOpcoesRemotasSpec, ConsultaOperadorOption, ConsultaOptionsListarContrato, ConsultaOptionsListarResolver, ConsultaPadraoGrpcServiceLike, ConsultaPadraoNavigateLike, ConsultaPadraoToastLike, ConsultaPageCacheEntry, ConsultaPageMetadataUnified, ConsultaPageRuntime, ConsultaPageRuntimeDeps, ConsultaRouteReusePort, ConsultaServidorExecutorOpts, ConsultaServidorListaReply, ConsultaServidorPort, ConsultaServidorQueryParams, ConsultaTopbarSlotPort, ConsultaUsuariosMetadataReply, ConsultaValorTipo, CreateCadastroMetadataPageConfigOptions, CreateCadastroPadraoConfigOptions, CreateConsultaPadraoRuntimeOptions, CreateGrpcSaveRequestMapperOptions, CreateSaveRequestFromPartialMapperOptions, CrudConsultaServicePort, DataGridColumn, DataGridPaginationChangeEvent, DeleteConfirmPageConfig, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, DuplicatePageConfig, FieldCommonInputs, FieldSize, FilePreviewKind, FiltroItemEntrada, FiltroItemEntradaGenerico, FiltroItemGridRow, FiltroItemSalvoDto, FiltroSalvo, FormContainerStateKeyParts, FormTabValidationLinkConfig, FormTabsVariant, GridLayoutConsultaApiDto, GridLayoutConsultaPersistedPayload, GrpcSaveRequestFactory, InitConsultaReply, ListarTodosPaginadoParams, LoadingDialogData, MapConsultaGridColunasOpts, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, ModoPermissaoReferencia, MontarFiltrosGrpcPresetOptions, MontarFiltrosServidorPresetOptions, OnboardingChecklistProgress, OnboardingChecklistStep, OptionsSourceServicePort, PatchFormFromEntidadeOptions, PermissionGroupTabBucket, PermissionGroupTabDescriptor, PermissionGroupTabGroup, ReportColumnMeta, ReportColumnWidthFields, ReportFilterMeta, ReportFiltroItemEntrada, ReportHeader, ReportMetadata, ReportPesquisarRequest, ReportResult, ReportSection, ReportSectionColumn, ReportSectionTable, ReportTotal, ReportTreeNode, ResolveStructraAdminMenuUrlOptions, SalvarFiltroConsultaRequest, SalvarFiltroPresetAsyncArgs, SaveRequestFromPartialFactory, ScriptEditorLanguage, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, StructraAction, StructraActionButtonVariant, StructraActionGroup, StructraActionGroupWire, StructraActionId, StructraActionVariant, StructraActionWire, StructraAdminRouteRedirectCacheOptions, StructraAdminRouteRedirectLoadOptions, StructraCadastroInlineResultState, StructraCadastroInlineReturnState, StructraFormValueSource, StructraGridLayoutApiBaseResolverFn, StructraGridLayoutAuthHeadersResolverFn, StructraGridLayoutTenantResolverFn, StructraMidiaUploadResult, StructraMidiaUploadTransportContext, StructraMidiaUploadTransportFn, StructraPageCacheGetOrLoadOptions, StructraPageCacheSetOptions, StructraPageFooterConfig, StructraPageInputContext, StructraReportTransport, StructraShellScrollRestorationMergedOptions, StructraShellScrollRestorationOptions, StructraSidebarContext, StructraSidebarEmpresaContext, StructraSidebarTemplateContext, StructraSidebarUserView, StructraTheme, TitulosFromMetadataConfig, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, TreeViewNode, TreeViewSelectEvent, UiFieldInputTextAlign, UiSelectOption, ValidationFieldMeta, ValidationSummaryItem, ValidationSummarySize, ValidationSummaryVariant, ValoresConsultaPresetUi };