structra-ui 0.2.12 → 0.2.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "structra-ui",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
   "homepage": "https://structralab.com/",
   "license": "MIT",

package/types/structra-ui.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { ChangeDetectorRef, Injector, DestroyRef, EventEmitter, OnChanges, OnInit, SimpleChanges, DoCheck, TemplateRef, OnDestroy, AfterContentInit, QueryList, AfterViewInit, Signal, ElementRef } from '@angular/core';
+import { ChangeDetectorRef, Injector, DestroyRef, EventEmitter, OnChanges, OnInit, SimpleChanges, DoCheck, AfterViewInit, TemplateRef, OnDestroy, AfterContentInit, QueryList, Signal, ElementRef } from '@angular/core';
 import { ControlValueAccessor, AbstractControl, NgControl, ValidatorFn } from '@angular/forms';
 import { MatDatepicker } from '@angular/material/datepicker';
 import * as _angular_cdk_overlay from '@angular/cdk/overlay';
@@ -13,6 +13,25 @@ import { Observable } from 'rxjs';
 /** Marcador de pacote publicado como `structra-ui`. */
 declare const STRUCTRA_UI: "structra-ui";
 
+type AlertType = 'error' | 'success' | 'warning' | 'info';
+/**
+ * Feedback visual inline (erro, sucesso, aviso, informação). Reutiliza tokens semânticos da lib.
+ */
+declare class AlertComponent {
+    type: AlertType;
+    message: string;
+    closable: boolean;
+    /** Quando `closable`, o alerta deixa de renderizar após fechar. */
+    protected readonly visible: i0.WritableSignal<boolean>;
+    protected get hasMessage(): boolean;
+    private readonly modifierByType;
+    protected get alertHostClass(): string;
+    protected onClose(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AlertComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AlertComponent, "app-alert", never, { "type": { "alias": "type"; "required": false; }; "message": { "alias": "message"; "required": false; }; "closable": { "alias": "closable"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_closable: unknown;
+}
+
 declare const ButtonVariant: {
     readonly Primary: "primary";
     readonly Secondary: "secondary";
@@ -81,8 +100,10 @@ declare class BaseButtonComponent {
     size: ButtonSize;
     /** Arredondamento semântico do botão (design system). */
     radius: ButtonRadius;
-    /** Placeholder de carregamento (skeleton no lugar do rótulo). */
+    /** Carregamento: spinner + `disabled` nativo + `aria-busy`; o rótulo projectado mantém-se visível. */
     loading: boolean;
+    /** `disabled` efectivo do `<button>` (inclui `readonly` e `loading`). */
+    get isDisabled(): boolean;
     /** Estilo visual base; pode ser estendido no SCSS do projeto. */
     variant: ButtonVariant;
     /** Alias de {@link variant} (nome comum em design systems). */
@@ -175,6 +196,11 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor {
     errorMessage: string;
     /** Se `true`, exibe o parágrafo de erro; por defeito `false` (só estado inválido na borda/label). */
     showErrorMessage: boolean;
+    /**
+     * Com campo inválido, aplica fundo semântico de erro (`--ui-field-invalid-input-bg`).
+     * Por defeito `false`: fundo igual ao válido (normal ou só leitura); só borda/foco/prefixo denunciam erro.
+     */
+    invalidThemed: boolean;
     required: boolean;
     /** Se `true` e `required`, exibe o asterisco no label (`BaseFieldComponent`); por defeito `false`. */
     showRequiredMark: boolean;
@@ -194,6 +220,11 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor {
     autocomplete: boolean;
     /** Placeholder de carregamento no `app-base-field` (skeleton). */
     loading: boolean;
+    /**
+     * Se `true`, foca o controlo nativo após a vista estar montada (ignora se `disabled`, `readonly` ou `loading`).
+     * Por defeito `false`.
+     */
+    autofocus: boolean;
     /**
      * Mostra botão «…» no sufixo que abre menu de ações (dropdown com os itens em {@link contextMenuItems}).
      * Por defeito `false`.
@@ -252,10 +283,16 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor {
     setDisabledState(isDisabled: boolean): void;
     protected emitModelValue(value: T | null): void;
     protected notifyTouched(): void;
+    /**
+     * Chamado em `ngAfterViewInit` dos campos concretos com o elemento focável (input, textarea, combobox, etc.).
+     */
+    protected applyAutofocusIfNeeded(resolve: () => HTMLElement | null | undefined): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseFieldDirective<any>, never>;
-    static ɵdir: i0.ɵɵ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; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "showErrorMessage": { "alias": "showErrorMessage"; "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; }; "mostrarMenuContexto": { "alias": "mostrarMenuContexto"; "required": false; }; "contextMenuItems": { "alias": "contextMenuItems"; "required": false; }; "contextMenuId": { "alias": "contextMenuId"; "required": false; }; }, { "contextMenuSelect": "contextMenuSelect"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵ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; }; "errorMessage": { "alias": "errorMessage"; "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_invalidThemed: unknown;
     static ngAcceptInputType_autocomplete: unknown;
     static ngAcceptInputType_loading: unknown;
+    static ngAcceptInputType_autofocus: unknown;
     static ngAcceptInputType_mostrarMenuContexto: unknown;
 }
 
@@ -334,14 +371,14 @@ declare class SkeletonTableComponent {
     static ngAcceptInputType_animate: unknown;
 }
 
-/** Mantido por compatibilidade; o layout do skeleton é único para todos os campos. */
-type SkeletonFieldShellVariant = 'text' | 'select';
+/** Layout do placeholder no `app-base-field` quando `loading` é `true`. */
+type SkeletonFieldShellVariant = 'text' | 'select' | 'textarea';
 /**
  * Placeholder de campo: barra de valor e, opcionalmente, quadrado à esquerda quando não há
  * ícone Font Awesome na coluna de prefixo do `app-base-field`.
  */
 declare class SkeletonFieldShellComponent {
-    /** @deprecated Ignorado: todos os campos usam o mesmo layout. */
+    /** `textarea`: várias barras (multilinha); restantes: uma barra estreita ao estilo «valor». */
     variant: SkeletonFieldShellVariant;
     animate: boolean;
     /**
@@ -366,6 +403,8 @@ declare class BaseFieldComponent implements OnChanges, OnInit {
     /** Asterisco visual do obrigatório no label (validação HTML `required` inalterada); por defeito `false`. */
     showRequiredMark: boolean;
     invalid: boolean;
+    /** Fundo semântico de erro no involúcro; só com `invalid` + este `true`. */
+    invalidThemed: boolean;
     filled: boolean;
     disabled: boolean;
     readonly: boolean;
@@ -407,7 +446,8 @@ declare class BaseFieldComponent implements OnChanges, OnInit {
     onClearClick(): void;
     onContextMenuItemSelect(id: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseFieldComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BaseFieldComponent, "app-base-field", never, { "label": { "alias": "label"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showRequiredMark": { "alias": "showRequiredMark"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "filled": { "alias": "filled"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "errorId": { "alias": "errorId"; "required": false; }; "showPrefixIcon": { "alias": "showPrefixIcon"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; }; "showSuffixSlot": { "alias": "showSuffixSlot"; "required": false; }; "valueAlignEnd": { "alias": "valueAlignEnd"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "skeletonVariant": { "alias": "skeletonVariant"; "required": false; }; "mostrarMenuContexto": { "alias": "mostrarMenuContexto"; "required": false; }; "contextMenuItems": { "alias": "contextMenuItems"; "required": false; }; "contextMenuId": { "alias": "contextMenuId"; "required": false; }; }, { "clear": "clear"; "contextMenuSelect": "contextMenuSelect"; }, never, ["[appFieldPrefix]", "*", "[appFieldSuffix]"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BaseFieldComponent, "app-base-field", never, { "label": { "alias": "label"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showRequiredMark": { "alias": "showRequiredMark"; "required": false; }; "invalid": { "alias": "invalid"; "required": false; }; "invalidThemed": { "alias": "invalidThemed"; "required": false; }; "filled": { "alias": "filled"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "inputId": { "alias": "inputId"; "required": false; }; "errorId": { "alias": "errorId"; "required": false; }; "showPrefixIcon": { "alias": "showPrefixIcon"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; }; "showSuffixSlot": { "alias": "showSuffixSlot"; "required": false; }; "valueAlignEnd": { "alias": "valueAlignEnd"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "skeletonVariant": { "alias": "skeletonVariant"; "required": false; }; "mostrarMenuContexto": { "alias": "mostrarMenuContexto"; "required": false; }; "contextMenuItems": { "alias": "contextMenuItems"; "required": false; }; "contextMenuId": { "alias": "contextMenuId"; "required": false; }; }, { "clear": "clear"; "contextMenuSelect": "contextMenuSelect"; }, never, ["[appFieldPrefix]", "*", "[appFieldSuffix]"], true, never>;
+    static ngAcceptInputType_invalidThemed: unknown;
     static ngAcceptInputType_loading: unknown;
     static ngAcceptInputType_mostrarMenuContexto: unknown;
 }
@@ -452,12 +492,14 @@ declare abstract class NgControlFieldDirective<T> extends BaseFieldDirective<T>
     static ɵdir: i0.ɵɵDirectiveDeclaration<NgControlFieldDirective<any>, never, never, {}, {}, never, never, true, never>;
 }
 
-declare class TextFieldComponent extends NgControlFieldDirective<string | null> {
+declare class TextFieldComponent extends NgControlFieldDirective<string | null> implements AfterViewInit {
+    private readonly nativeInputRef?;
     /** Limite de caracteres no valor do campo. */
     maxLength: number;
     inputText: string;
     filledUi: boolean;
     private refreshFilledUi;
+    ngAfterViewInit(): void;
     protected afterWriteValue(value: string | null): void;
     onNativeInput(event: Event): void;
     onBlur(): void;
@@ -467,7 +509,8 @@ declare class TextFieldComponent extends NgControlFieldDirective<string | null>
     static ngAcceptInputType_maxLength: unknown;
 }
 
-declare class PasswordFieldComponent extends NgControlFieldDirective<string | null> implements OnInit {
+declare class PasswordFieldComponent extends NgControlFieldDirective<string | null> implements AfterViewInit, OnInit {
+    private readonly nativeInputRef?;
     /** Password já nasce com ícone de chave no prefixo; pode ser sobrescrito via `prefixIcon`. */
     showPrefixIcon: boolean;
     prefixIcon: string;
@@ -488,6 +531,7 @@ declare class PasswordFieldComponent extends NgControlFieldDirective<string | nu
     toggleAriaLabelUi: string;
     toggleIconClassUi: string;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     private refreshFilledUi;
     private refreshPasswordToggleUi;
     protected afterWriteValue(value: string | null): void;
@@ -502,7 +546,8 @@ declare class PasswordFieldComponent extends NgControlFieldDirective<string | nu
     static ngAcceptInputType_maxLength: unknown;
 }
 
-declare class TextareaFieldComponent extends NgControlFieldDirective<string | null> implements OnChanges, OnInit {
+declare class TextareaFieldComponent extends NgControlFieldDirective<string | null> implements AfterViewInit, OnChanges, OnInit {
+    private readonly nativeInputRef?;
     get hostInvalidClass(): boolean;
     /** Limite de caracteres no valor do campo. `0` = sem limite explícito no DOM. */
     maxLength: number;
@@ -517,6 +562,7 @@ declare class TextareaFieldComponent extends NgControlFieldDirective<string | nu
     /** Altura CSS (evita getter chamado a cada CD). */
     textareaMaxHeightCss: string;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private updateTextareaHeight;
     private refreshFilledUi;
@@ -531,11 +577,13 @@ declare class TextareaFieldComponent extends NgControlFieldDirective<string | nu
     static ngAcceptInputType_maxResizeRows: unknown;
 }
 
-declare class IntegerFieldComponent extends NgControlFieldDirective<number | null> {
+declare class IntegerFieldComponent extends NgControlFieldDirective<number | null> implements AfterViewInit {
+    private readonly nativeInputRef?;
     /** Valor máximo permitido (inclusive). */
     max: number;
     inputText: string;
     filledUi: boolean;
+    ngAfterViewInit(): void;
     private refreshFilledUi;
     protected afterWriteValue(value: number | null): void;
     onBeforeInput(event: Event): void;
@@ -547,11 +595,13 @@ declare class IntegerFieldComponent extends NgControlFieldDirective<number | nul
     static ngAcceptInputType_max: unknown;
 }
 
-declare class DecimalFieldComponent extends NgControlFieldDirective<number | null> {
+declare class DecimalFieldComponent extends NgControlFieldDirective<number | null> implements AfterViewInit {
+    private readonly nativeInputRef?;
     /** Valor máximo permitido (inclusive), com até 2 casas decimais. */
     max: number;
     inputText: string;
     filledUi: boolean;
+    ngAfterViewInit(): void;
     private refreshFilledUi;
     protected afterWriteValue(value: number | null): void;
     onBeforeInput(event: Event): void;
@@ -563,7 +613,8 @@ declare class DecimalFieldComponent extends NgControlFieldDirective<number | nul
     static ngAcceptInputType_max: unknown;
 }
 
-declare class DateFieldComponent extends NgControlFieldDirective<string | null> implements OnChanges {
+declare class DateFieldComponent extends NgControlFieldDirective<string | null> implements AfterViewInit, OnChanges {
+    private readonly nativeInputRef?;
     picker?: MatDatepicker<Date>;
     /**
      * Se `true`, a formatação inclui hh:mm (24h) e, ao escolher no calendário,
@@ -584,6 +635,7 @@ declare class DateFieldComponent extends NgControlFieldDirective<string | null>
     onGhostInputKeydown(ev: KeyboardEvent): void;
     onPickedDate(next: Date | null): void;
     onBlur(): void;
+    ngAfterViewInit(): void;
     onClear(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DateFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DateFieldComponent, "app-date-field", never, { "showTimeHours": { "alias": "showTimeHours"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; }, {}, never, ["[appFieldPrefix]"], true, never>;
@@ -593,7 +645,8 @@ declare class DateFieldComponent extends NgControlFieldDirective<string | null>
 /**
  * Campo de texto com máscara visual; valor do modelo = **apenas dígitos** (string), sem máscara.
  */
-declare abstract class MaskedTextFieldBase extends NgControlFieldDirective<string | null> {
+declare abstract class MaskedTextFieldBase extends NgControlFieldDirective<string | null> implements AfterViewInit {
+    private readonly nativeInputRef?;
     /** Padrão com `#` para cada dígito (ex.: `#####-###`). Subclasses podem sobrescrever {@link pattern}. */
     maskPattern: string;
     inputText: string;
@@ -601,6 +654,7 @@ declare abstract class MaskedTextFieldBase extends NgControlFieldDirective<strin
     filledUi: boolean;
     /** Padrão efetivo (permite CEP/telefone fixarem máscaras em subclasses). */
     protected get pattern(): string;
+    ngAfterViewInit(): void;
     /**
      * 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).
@@ -752,6 +806,8 @@ interface FieldCommonInputs {
     autocomplete?: boolean;
     /** Skeleton no `app-base-field` enquanto dados externos carregam. */
     loading?: boolean;
+    /** Foco inicial no controlo nativo; padrão `false`. */
+    autofocus?: boolean;
     /** Botão «…» no sufixo com menu de ações; padrão `false` na `BaseFieldDirective`. */
     mostrarMenuContexto?: boolean;
     /** Itens do menu do sufixo; só mostra o botão se a lista tiver entradas. */
@@ -927,10 +983,12 @@ declare abstract class BooleanFieldDirective extends BaseFieldDirective<boolean
     static ɵdir: i0.ɵɵDirectiveDeclaration<BooleanFieldDirective, never, never, { "showErrorMessage": { "alias": "showErrorMessage"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-declare class CheckboxFieldComponent extends BooleanFieldDirective {
+declare class CheckboxFieldComponent extends BooleanFieldDirective implements AfterViewInit {
+    private readonly nativeInputRef?;
     /** `false` (padrão): host usa largura intrínseca. Com `true`, ocupa 100%. */
     fullWidth: boolean;
     get fullWidthClass(): boolean;
+    ngAfterViewInit(): void;
     onCheckboxClick(ev: MouseEvent): void;
     onNativeChange(event: Event): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxFieldComponent, never>;
@@ -938,8 +996,10 @@ declare class CheckboxFieldComponent extends BooleanFieldDirective {
     static ngAcceptInputType_fullWidth: unknown;
 }
 
-declare class SwitchFieldComponent extends BooleanFieldDirective {
+declare class SwitchFieldComponent extends BooleanFieldDirective implements AfterViewInit {
+    private readonly nativeInputRef?;
     get labelId(): string;
+    ngAfterViewInit(): void;
     toggle(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<SwitchFieldComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<SwitchFieldComponent, "app-switch-field", never, {}, {}, never, never, true, never>;
@@ -1094,7 +1154,7 @@ interface SelectPageRequested {
     pageSize: number;
 }
 
-declare class SelectFieldComponent extends DropdownOptionFieldBase implements OnDestroy, OnChanges {
+declare class SelectFieldComponent extends DropdownOptionFieldBase implements AfterViewInit, OnDestroy, OnChanges {
     private readonly hostRef;
     get hostInvalidClass(): boolean;
     pagination: boolean;
@@ -1106,9 +1166,11 @@ declare class SelectFieldComponent extends DropdownOptionFieldBase implements On
     readonly pageRequested: EventEmitter<SelectPageRequested>;
     optionsPanelTpl: TemplateRef<unknown>;
     private readonly dropdownTriggerRootRef;
+    private readonly nativeInputRef?;
     panelOpen: boolean;
     panelOverlayWidth: number;
     private scrollLoadTimer;
+    ngAfterViewInit(): void;
     protected afterWriteValue(value: unknown | null): void;
     get displayValue(): string;
     get optionsListId(): string;
@@ -1144,7 +1206,7 @@ declare class SelectFieldComponent extends DropdownOptionFieldBase implements On
     static ngAcceptInputType_pageSize: unknown;
 }
 
-declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase implements OnDestroy, OnChanges {
+declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase implements AfterViewInit, OnDestroy, OnChanges {
     private readonly hostRef;
     get hostInvalidClass(): boolean;
     /** Por omissão `true`: mesmo padrão do select com lista longa (`pageRequested` + scroll). */
@@ -1157,9 +1219,11 @@ declare class MultiselectFieldComponent extends DropdownMultiOptionFieldBase imp
     readonly pageRequested: EventEmitter<SelectPageRequested>;
     optionsPanelTpl: TemplateRef<unknown>;
     private readonly dropdownTriggerRootRef;
+    private readonly nativeInputRef?;
     panelOpen: boolean;
     panelOverlayWidth: number;
     private scrollLoadTimer;
+    ngAfterViewInit(): void;
     writeValue(value: unknown[] | null): void;
     protected afterWriteValue(_value: unknown[]): void;
     /** Texto numa linha: rótulos separados por vírgula + ellipsis no CSS. */
@@ -1215,12 +1279,14 @@ declare class DropdownSearchFieldComponent extends DropdownOptionFieldBase imple
     readonly pageRequested: EventEmitter<DropdownSearchPageRequested>;
     optionsPanelTpl: TemplateRef<unknown>;
     private readonly dropdownTriggerRootRef;
+    private readonly nativeInputRef?;
     searchQuery: string;
     committedQuery: string;
     panelOpen: boolean;
     panelOverlayWidth: number;
     private scrollLoadTimer;
     private searchDebounceTimer;
+    ngAfterViewInit(): void;
     protected afterWriteValue(value: unknown | null): void;
     get displayValue(): string;
     get optionsListId(): string;
@@ -1289,7 +1355,7 @@ interface DropdownListBindings<T = unknown> {
     compareWith: (a: unknown, b: unknown) => boolean;
 }
 
-declare class FileUploadFieldComponent implements OnChanges, OnDestroy {
+declare class FileUploadFieldComponent implements AfterViewInit, OnChanges, OnDestroy {
     private readonly cdr;
     private readonly confirmDialog;
     label?: string | undefined;
@@ -1305,6 +1371,10 @@ declare class FileUploadFieldComponent implements OnChanges, OnDestroy {
      */
     maxFiles: number;
     disabled: boolean;
+    /** Skeleton na zona de drop (sem interação até voltar a `false`). */
+    loading: boolean;
+    /** Foca o `<input type="file">` nativo quando a zona está visível (não em `loading`). */
+    autofocus: boolean;
     multiple: boolean;
     value: File | File[] | null;
     /**
@@ -1329,6 +1399,8 @@ declare class FileUploadFieldComponent implements OnChanges, OnDestroy {
     private fileInputRef?;
     private readonly autoId;
     get fieldId(): string;
+    get loadingAriaLabel(): string;
+    ngAfterViewInit(): void;
     get hostDataControlId(): string;
     isDragging: boolean;
     hasHover: boolean;
@@ -1380,10 +1452,12 @@ declare class FileUploadFieldComponent implements OnChanges, OnDestroy {
     private syncFilePreviewObjectUrls;
     private releaseAllFilePreviewObjectUrls;
     static ɵfac: i0.ɵɵFactoryDeclaration<FileUploadFieldComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FileUploadFieldComponent, "app-file-upload-field", never, { "label": { "alias": "label"; "required": false; }; "id": { "alias": "id"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; }; "maxFiles": { "alias": "maxFiles"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "fileItemRowClickable": { "alias": "fileItemRowClickable"; "required": false; }; "showFileDownload": { "alias": "showFileDownload"; "required": false; }; }, { "valueChange": "valueChange"; "fileRejected": "fileRejected"; "fileItemClick": "fileItemClick"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FileUploadFieldComponent, "app-file-upload-field", never, { "label": { "alias": "label"; "required": false; }; "id": { "alias": "id"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; }; "maxFiles": { "alias": "maxFiles"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "autofocus": { "alias": "autofocus"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "fileItemRowClickable": { "alias": "fileItemRowClickable"; "required": false; }; "showFileDownload": { "alias": "showFileDownload"; "required": false; }; }, { "valueChange": "valueChange"; "fileRejected": "fileRejected"; "fileItemClick": "fileItemClick"; }, never, never, true, never>;
     static ngAcceptInputType_maxSizeMb: unknown;
     static ngAcceptInputType_maxFiles: unknown;
     static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_loading: unknown;
+    static ngAcceptInputType_autofocus: unknown;
     static ngAcceptInputType_multiple: unknown;
     static ngAcceptInputType_fileItemRowClickable: unknown;
 }
@@ -3446,5 +3520,5 @@ declare class AppBreadcrumbComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<AppBreadcrumbComponent, "app-breadcrumb", never, { "items": { "alias": "items"; "required": true; }; }, {}, 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, AnchoredOverlayComponent, AppBreadcrumbComponent, AppDialogComponent, AppLibLightBlockScrollStrategy, AppShellComponent, AppShellSidebarTemplateDirective, AppShellSidebarToggleComponent, AppSidebarComponent, AppSidebarToolbarDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, ButtonRadius, ButtonSize, ButtonType, ButtonVariant, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ConfirmDialogComponent, ConfirmDialogService, ContextMenuComponent, CpfCnpjFieldComponent, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DividerComponent, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, EmptyStateComponent, FILE_PREVIEW_UNAVAILABLE_MESSAGE, FileUploadFieldComponent, FormActionsAlign, FormActionsComponent, FormColComponent, 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, NgControlFieldDirective, OverlayPlacement, PDF_IFRAME_VIEWER_HASH, PasswordFieldComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, STRUCTRA_THEME_IDS, STRUCTRA_UI, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, SwitchFieldComponent, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ThemeDirective, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, ValidationSummaryComponent, anchoredOverlayPositions, appendPdfIframeViewerParams, applyPickedCalendarDate, buildDecimalBrDisplay, buildDecimalBrParseString, buildEmptyStateOverlayHtml, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, cepMaskCompleteValidator, cpfCnpjMaskCompleteValidator, escapeHtml, extractDecimalBrParts, fileIsLikelyImage, fileMatchesAccept, fixedDigitsMaskCompleteValidator, formatAcceptForDisplay, formatDateTimePtBr, formatDecimalBr, formatFileSizeBytes, formatIntegerThousandsBr, formatMaskDigits, formatUiFieldDateValue, getFilePreviewKind, getThemeClass, getThemeClassList, getThemeTokenClass, libDialogPanelClasses, mapEstadosToOptions, maskDigitCount, normalizeFormDateValue, normalizeStructraTheme, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, phoneBrMaskCompleteValidator, resolveControlAtPath, sanitizeDecimalBrInput, sanitizeIntegerDigits, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, stripToDigits, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid };
-export type { AdaptiveDataViewMode, AppThemeId, AppThemeOption, BreadcrumbItem, CardItemView, CardListDataMode, CardListMapFn, ConfirmDialogData, ConfirmDialogVariant, DataGridColumn, DataGridPaginationChangeEvent, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, FieldCommonInputs, FilePreviewKind, FormTabsVariant, LoadingDialogData, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, StructraTheme, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, UiSelectOption, ValidationSummaryItem, ValidationSummaryVariant };
+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, AppSidebarComponent, AppSidebarToolbarDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, ButtonRadius, ButtonSize, ButtonType, ButtonVariant, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ConfirmDialogComponent, ConfirmDialogService, ContextMenuComponent, CpfCnpjFieldComponent, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DividerComponent, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, EmptyStateComponent, FILE_PREVIEW_UNAVAILABLE_MESSAGE, FileUploadFieldComponent, FormActionsAlign, FormActionsComponent, FormColComponent, 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, NgControlFieldDirective, OverlayPlacement, PDF_IFRAME_VIEWER_HASH, PasswordFieldComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, STRUCTRA_THEME_IDS, STRUCTRA_UI, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, SwitchFieldComponent, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ThemeDirective, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, ValidationSummaryComponent, anchoredOverlayPositions, appendPdfIframeViewerParams, applyPickedCalendarDate, buildDecimalBrDisplay, buildDecimalBrParseString, buildEmptyStateOverlayHtml, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, cepMaskCompleteValidator, cpfCnpjMaskCompleteValidator, escapeHtml, extractDecimalBrParts, fileIsLikelyImage, fileMatchesAccept, fixedDigitsMaskCompleteValidator, formatAcceptForDisplay, formatDateTimePtBr, formatDecimalBr, formatFileSizeBytes, formatIntegerThousandsBr, formatMaskDigits, formatUiFieldDateValue, getFilePreviewKind, getThemeClass, getThemeClassList, getThemeTokenClass, libDialogPanelClasses, mapEstadosToOptions, maskDigitCount, normalizeFormDateValue, normalizeStructraTheme, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, phoneBrMaskCompleteValidator, resolveControlAtPath, sanitizeDecimalBrInput, sanitizeIntegerDigits, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, stripToDigits, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid };
+export type { AdaptiveDataViewMode, AlertType, AppThemeId, AppThemeOption, BreadcrumbItem, CardItemView, CardListDataMode, CardListMapFn, ConfirmDialogData, ConfirmDialogVariant, DataGridColumn, DataGridPaginationChangeEvent, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, FieldCommonInputs, FilePreviewKind, FormTabsVariant, LoadingDialogData, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, StructraTheme, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, UiSelectOption, ValidationSummaryItem, ValidationSummaryVariant };