@praxisui/files-upload 1.0.0-beta.60 → 1.0.0-beta.63

package/fesm2022/praxisui-files-upload.mjs

@@ -1,44 +1,70 @@
 import * as i0 from '@angular/core';
 import { Injectable, inject, signal, Inject, Component, InjectionToken, Optional, EventEmitter, ViewChild, Output, Input, ChangeDetectionStrategy, ENVIRONMENT_INITIALIZER } from '@angular/core';
 import { ActivatedRoute } from '@angular/router';
-import * as i7 from '@angular/common';
+import * as i9 from '@angular/common';
 import { CommonModule } from '@angular/common';
 import * as i1$1 from '@angular/forms';
 import { ReactiveFormsModule, FormsModule, FormControl } from '@angular/forms';
-import * as i9 from '@angular/material/button';
+import * as i11 from '@angular/material/button';
 import { MatButtonModule } from '@angular/material/button';
 import * as i10 from '@angular/material/icon';
 import { MatIconModule } from '@angular/material/icon';
-import * as i11$1 from '@angular/material/progress-bar';
+import * as i13 from '@angular/material/progress-bar';
 import { MatProgressBarModule } from '@angular/material/progress-bar';
-import * as i3$1 from '@angular/material/menu';
+import * as i14 from '@angular/material/menu';
 import { MatMenuModule } from '@angular/material/menu';
 import * as i1 from '@angular/common/http';
-import { HttpHeaders, HttpEventType, HttpErrorResponse } from '@angular/common/http';
-import { ComponentKeyService, ASYNC_CONFIG_STORAGE, PraxisIconDirective, ComponentMetadataRegistry } from '@praxisui/core';
+import { HttpHeaders, HttpEventType, HttpResponse, HttpErrorResponse } from '@angular/common/http';
+import * as i1$2 from '@praxisui/core';
+import { providePraxisI18n, ComponentKeyService, ASYNC_CONFIG_STORAGE, PraxisIconDirective, PraxisI18nService, ComponentMetadataRegistry } from '@praxisui/core';
 import * as i4 from '@angular/material/tabs';
 import { MatTabsModule } from '@angular/material/tabs';
 import * as i5 from '@angular/material/form-field';
 import { MatFormFieldModule } from '@angular/material/form-field';
 import * as i6 from '@angular/material/input';
 import { MatInputModule } from '@angular/material/input';
-import * as i7$1 from '@angular/material/checkbox';
+import * as i7 from '@angular/material/checkbox';
 import { MatCheckboxModule } from '@angular/material/checkbox';
 import * as i8 from '@angular/material/select';
 import { MatSelectModule } from '@angular/material/select';
-import * as i11 from '@angular/material/tooltip';
+import * as i11$1 from '@angular/material/tooltip';
 import { MatTooltipModule } from '@angular/material/tooltip';
 import * as i2 from '@angular/material/snack-bar';
 import { MatSnackBarModule } from '@angular/material/snack-bar';
 import { toObservable, takeUntilDestroyed } from '@angular/core/rxjs-interop';
-import { of, throwError, BehaviorSubject, map as map$1, startWith, retry, debounceTime } from 'rxjs';
-import * as i1$2 from '@praxisui/settings-panel';
+import { of, throwError, BehaviorSubject, map as map$1, startWith, retry, debounceTime, from } from 'rxjs';
+import * as i1$3 from '@praxisui/settings-panel';
 import { SETTINGS_PANEL_DATA } from '@praxisui/settings-panel';
-import { map, catchError, take } from 'rxjs/operators';
+import { map, catchError, take, concatMap, toArray, tap, filter, defaultIfEmpty } from 'rxjs/operators';
 import { TemplatePortal } from '@angular/cdk/portal';
 import * as i3 from '@angular/cdk/overlay';
+import { CdkConnectedOverlay, CdkOverlayOrigin } from '@angular/cdk/overlay';
 import { SimpleBaseInputComponent } from '@praxisui/dynamic-fields';
 
+function isStructuredErrorItem(value) {
+    return !!value && typeof value === 'object' && 'code' in value && 'message' in value;
+}
+function isErrorEnvelope(value) {
+    return !!value && typeof value === 'object' && 'status' in value;
+}
+/** Resolves the primary structured error item from the backend error payload. */
+function getPrimaryErrorItem(error) {
+    if (!error) {
+        return undefined;
+    }
+    if (isStructuredErrorItem(error) && !isErrorEnvelope(error)) {
+        return error;
+    }
+    if (!isErrorEnvelope(error)) {
+        return undefined;
+    }
+    const structured = error.errors?.[0];
+    if (structured) {
+        return structured;
+    }
+    return undefined;
+}
+
 var ErrorCode;
 (function (ErrorCode) {
     ErrorCode["INVALID_FILE_TYPE"] = "INVALID_FILE_TYPE";
@@ -433,7 +459,7 @@ class PraxisFilesUploadConfigEditor {
                 dense: [false],
                 accept: [''],
                 showMetadataForm: [false],
-                // NOVO: grupos específicos
+                // Grupos específicos de UI
                 dropzone: this.fb.group({
                     expandOnDragProximity: [true],
                     proximityPx: [64],
@@ -454,18 +480,18 @@ class PraxisFilesUploadConfigEditor {
                 maxFileSizeBytes: [null],
                 maxFilesPerBulk: [null],
                 maxBulkSizeBytes: [null],
+            }),
+            options: this.fb.group({
                 defaultConflictPolicy: ['RENAME'],
-                failFast: [false],
                 strictValidation: [true],
                 maxUploadSizeMb: [50],
-            }),
-            options: this.fb.group({
                 allowedExtensions: [''],
                 acceptMimeTypes: [''],
                 targetDirectory: [''],
                 enableVirusScanning: [false],
             }),
             bulk: this.fb.group({
+                failFast: [false],
                 parallelUploads: [1],
                 retryCount: [0],
                 retryBackoffMs: [0],
@@ -483,7 +509,7 @@ class PraxisFilesUploadConfigEditor {
             headers: this.fb.group({
                 tenantHeader: ['X-Tenant-Id'],
                 userHeader: ['X-User-Id'],
-                // novos campos: valores para consulta do servidor
+                // Valores usados nas consultas de configuração do servidor
                 tenantValue: [''],
                 userValue: [''],
             }),
@@ -537,7 +563,7 @@ class PraxisFilesUploadConfigEditor {
             if (patch.ui?.accept) {
                 patch.ui = { ...patch.ui, accept: patch.ui.accept.join(',') };
             }
-            // NOVO: normalizar lista de detalhes para CSV
+            // Normalizar lista de detalhes para CSV
             if (patch.ui?.list?.detailsFields) {
                 patch.ui = {
                     ...patch.ui,
@@ -570,22 +596,18 @@ class PraxisFilesUploadConfigEditor {
     applyServerConfig(cfg) {
         if (!cfg)
             return;
-        // Options mapeadas para "Validações" e "Opções"
+        // Configuração efetiva do backend separada em validações locais, opções
+        // de backend e execução de lote.
         const options = cfg.options ?? {};
         const bulk = cfg.bulk ?? {};
-        // limits
+        // Validações locais alimentadas pelo backend
         this.limitsGroup.patchValue({
-            defaultConflictPolicy: options.nameConflictPolicy ?? null,
-            strictValidation: options.strictValidation ?? null,
-            maxUploadSizeMb: options.maxUploadSizeMb ?? null,
-            // failFast padrão do servidor pode influenciar a UI de validação em lote
-            failFast: bulk.failFastModeDefault ?? false,
-            // preencher máx. arquivos por lote a partir do backend
+            // Preencher máx. arquivos por lote a partir do backend
             maxFilesPerBulk: typeof bulk.maxFilesPerBatch === 'number'
                 ? bulk.maxFilesPerBatch
                 : null,
         }, { emitEvent: false });
-        // options (normalizar arrays em string CSV)
+        // Opções de backend (normalizar arrays em string CSV)
         const allowed = Array.isArray(options.allowedExtensions)
             ? options.allowedExtensions.join(',')
             : '';
@@ -593,13 +615,17 @@ class PraxisFilesUploadConfigEditor {
             ? options.acceptMimeTypes.join(',')
             : '';
         this.optionsGroup.patchValue({
+            defaultConflictPolicy: options.nameConflictPolicy ?? null,
+            strictValidation: options.strictValidation ?? null,
+            maxUploadSizeMb: options.maxUploadSizeMb ?? null,
             allowedExtensions: allowed,
             acceptMimeTypes: mimes,
             targetDirectory: options.targetDirectory ?? '',
             enableVirusScanning: !!options.enableVirusScanning,
         }, { emitEvent: false });
-        // bulk (UI)
+        // Execução de lote
         this.bulkGroup.patchValue({
+            failFast: bulk.failFastModeDefault ?? false,
             parallelUploads: typeof bulk.maxConcurrentUploads === 'number'
                 ? bulk.maxConcurrentUploads
                 : 1,
@@ -725,10 +751,165 @@ class PraxisFilesUploadConfigEditor {
     refetchServerConfig() {
         this.state.refetch();
     }
+    get summaryStrategyTitle() {
+        const strategy = this.form.get('strategy')?.value;
+        if (strategy === 'presign')
+            return 'Upload com URL pré-assinada';
+        if (strategy === 'auto')
+            return 'Seleção automática da estratégia';
+        return 'Upload direto ao backend';
+    }
+    get summaryStrategyDetail() {
+        const strategy = this.form.get('strategy')?.value;
+        if (strategy === 'presign') {
+            return 'Depende de endpoint de presign e costuma reduzir carga direta no servidor principal.';
+        }
+        if (strategy === 'auto') {
+            return 'Tenta presign primeiro e volta ao fluxo direto quando necessário.';
+        }
+        return 'Fluxo mais simples de integrar e diagnosticar em ambientes controlados.';
+    }
+    get summaryExperienceTitle() {
+        const ui = this.uiGroup.value;
+        if (ui?.manualUpload)
+            return 'Revisão manual antes do envio';
+        if (ui?.showDropzone === false)
+            return 'Seleção orientada por campo compacto';
+        return 'Envio imediato com dropzone visível';
+    }
+    get summaryExperienceDetail() {
+        const ui = this.uiGroup.value;
+        const tokens = [
+            ui?.showProgress ? 'progresso visível' : 'sem barra de progresso',
+            ui?.showConflictPolicySelector
+                ? 'escolha de conflito disponível'
+                : 'política de conflito escondida',
+            ui?.showMetadataForm ? 'metadados editáveis na UI' : 'sem formulário extra',
+        ];
+        return tokens.join(' • ');
+    }
+    get summaryLimitsTitle() {
+        const maxFile = this.optionsGroup.get('maxUploadSizeMb')?.value;
+        const maxBulk = this.limitsGroup.get('maxFilesPerBulk')?.value;
+        return `${maxFile || '—'} MB por arquivo • ${maxBulk || '—'} itens por lote`;
+    }
+    get summaryLimitsDetail() {
+        const parallel = this.bulkGroup.get('parallelUploads')?.value;
+        const failFast = this.bulkGroup.get('failFast')?.value;
+        return `${parallel || 1} upload(s) paralelos • ${failFast ? 'fail-fast ativo' : 'falhas parciais permitidas'}`;
+    }
+    get summaryServerTitle() {
+        const conflict = this.optionsGroup.get('defaultConflictPolicy')?.value || 'RENAME';
+        return `Conflito padrão: ${conflict}`;
+    }
+    get summaryServerDetail() {
+        const strict = this.optionsGroup.get('strictValidation')?.value;
+        const virus = this.optionsGroup.get('enableVirusScanning')?.value;
+        return `${strict ? 'validação rigorosa ligada' : 'validação rígida desativada'} • ${virus ? 'antivírus forçado' : 'antivírus opcional/inativo'}`;
+    }
+    get activeRisks() {
+        const risks = [];
+        if (this.optionsGroup.get('defaultConflictPolicy')?.value === 'OVERWRITE') {
+            risks.push({
+                title: 'Sobrescrita habilitada',
+                detail: 'Arquivos existentes podem ser substituídos silenciosamente se o backend aceitar a operação.',
+            });
+        }
+        if (this.optionsGroup.get('enableVirusScanning')?.value === true) {
+            risks.push({
+                title: 'Antivírus pode elevar latência',
+                detail: 'Ativar varredura forçada melhora segurança, mas pode impactar throughput e tempo de resposta.',
+            });
+        }
+        if (this.bulkGroup.get('failFast')?.value === true) {
+            risks.push({
+                title: 'Lote para no primeiro erro',
+                detail: 'Usuários podem precisar reenviar itens válidos quando o primeiro erro interromper o restante do lote.',
+            });
+        }
+        if ((this.rateLimitGroup.get('maxAutoRetry')?.value ?? 0) >= 5) {
+            risks.push({
+                title: 'Retry automático agressivo',
+                detail: 'Muitas tentativas automáticas podem aumentar tempo de espera percebido e ruído operacional.',
+            });
+        }
+        if (this.uiGroup.get('manualUpload')?.value === true) {
+            risks.push({
+                title: 'Fluxo exige ação manual',
+                detail: 'Adequado para revisão, mas aumenta passos no envio e pode reduzir taxa de conclusão em cenários simples.',
+            });
+        }
+        return risks;
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisFilesUploadConfigEditor, deps: [{ token: i1$1.FormBuilder }, { token: SETTINGS_PANEL_DATA }, { token: i2.MatSnackBar }, { token: i0.DestroyRef }], target: i0.ɵɵFactoryTarget.Component });
     static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PraxisFilesUploadConfigEditor, isStandalone: true, selector: "praxis-files-upload-config-editor", ngImport: i0, template: `
+    <div class="editor-layout">
+      <aside class="summary-panel" aria-label="Resumo executivo da configuração">
+        <h3>Resumo executivo</h3>
+        <p class="summary-intro">
+          Revise aqui o impacto operacional antes de percorrer todos os grupos
+          de configuração.
+        </p>
+
+        <div class="summary-grid">
+          <section class="summary-card">
+            <span class="eyebrow">Estratégia</span>
+            <strong>{{ summaryStrategyTitle }}</strong>
+            <p>{{ summaryStrategyDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Experiência</span>
+            <strong>{{ summaryExperienceTitle }}</strong>
+            <p>{{ summaryExperienceDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Limites</span>
+            <strong>{{ summaryLimitsTitle }}</strong>
+            <p>{{ summaryLimitsDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Servidor</span>
+            <strong>{{ summaryServerTitle }}</strong>
+            <p>{{ summaryServerDetail }}</p>
+          </section>
+        </div>
+
+        <section class="risk-panel" [class.safe]="activeRisks.length === 0">
+          <h4>
+            <mat-icon aria-hidden="true">{{
+              activeRisks.length === 0 ? 'verified' : 'warning'
+            }}</mat-icon>
+            Riscos e atenção
+          </h4>
+          <div *ngIf="activeRisks.length > 0; else noRiskState" class="risk-list">
+            <article class="risk-item" *ngFor="let risk of activeRisks">
+              <strong>{{ risk.title }}</strong>
+              <p>{{ risk.detail }}</p>
+            </article>
+          </div>
+          <ng-template #noRiskState>
+            <p class="safe-copy">
+              Nenhum risco operacional evidente na configuração atual.
+            </p>
+          </ng-template>
+        </section>
+      </aside>
+
+      <div class="editor-main">
     <mat-tab-group>
       <mat-tab label="Comportamento">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Estratégia e cadência do envio</h3>
+          <p>
+            Defina aqui como o usuário inicia o upload e como o lote se
+            comporta em termos de paralelismo e retentativa.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="form">
           <mat-form-field appearance="fill">
             <mat-label>Estratégia de envio <span class="opt-tag">opcional</span></mat-label>
@@ -751,11 +932,18 @@ class PraxisFilesUploadConfigEditor {
             </button>
           </mat-form-field>
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="bulkGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">build</mat-icon>
             Opções configuráveis — Lote
           </h4>
+          <p class="section-note">
+            Use paralelismo e retries com moderação. Em ambientes corporativos,
+            esses controles afetam throughput, experiência percebida e carga no
+            backend.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Uploads paralelos <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="parallelUploads" />
@@ -799,13 +987,28 @@ class PraxisFilesUploadConfigEditor {
             </button>
           </mat-form-field>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Interface">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Experiência visível para o usuário</h3>
+          <p>
+            Configure densidade, dropzone, metadados e detalhes da lista.
+            Priorize clareza operacional antes de habilitar recursos avançados.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="uiGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Interface
           </h4>
+          <p class="section-note">
+            Esta seção controla a ergonomia do componente. Mudanças aqui afetam
+            descoberta, esforço de uso e taxa de conclusão do envio.
+          </p>
           <mat-checkbox formControlName="showDropzone"
             >Exibir área de soltar</mat-checkbox
           >
@@ -919,13 +1122,28 @@ class PraxisFilesUploadConfigEditor {
             </mat-form-field>
           </fieldset>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Validações">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Regras de aceite e comportamento operacional</h3>
+          <p>
+            Separe mentalmente o que é validação de UX local do que é regra
+            efetiva de backend. Revise com atenção as opções destrutivas.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="limitsGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">build</mat-icon>
             Opções configuráveis — Validações
           </h4>
+          <p class="section-note">
+            Limites locais melhoram feedback imediato, mas não substituem a
+            política efetiva do servidor.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Tamanho máximo do arquivo (bytes) <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="maxFileSizeBytes" />
@@ -948,6 +1166,19 @@ class PraxisFilesUploadConfigEditor {
             <mat-label>Tamanho máximo do lote (bytes) <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="maxBulkSizeBytes" />
           </mat-form-field>
+        </form>
+        </section>
+        <section class="config-section">
+        <form [formGroup]="optionsGroup">
+          <h4 class="section-subtitle">
+            <mat-icon aria-hidden="true">tune</mat-icon>
+            Opções configuráveis — Backend
+          </h4>
+          <p class="section-note">
+            Estas opções têm impacto direto no contrato com o servidor e em
+            governança operacional. Trate alterações aqui como decisão de
+            política, não apenas de interface.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Política de conflito (padrão) <span class="opt-tag">opcional</span></mat-label>
             <mat-select formControlName="defaultConflictPolicy">
@@ -967,14 +1198,11 @@ class PraxisFilesUploadConfigEditor {
             >
               <mat-icon>help_outline</mat-icon>
             </button>
-            <div class="warn" *ngIf="limitsGroup.get('defaultConflictPolicy')?.value === 'OVERWRITE'">
+            <div class="warn" *ngIf="optionsGroup.get('defaultConflictPolicy')?.value === 'OVERWRITE'">
               <mat-icon color="warn" aria-hidden="true">warning</mat-icon>
               Atenção: OVERWRITE pode sobrescrever arquivos existentes.
             </div>
           </mat-form-field>
-          <mat-checkbox formControlName="failFast"
-            >Parar no primeiro erro (fail-fast)</mat-checkbox
-          >
           <mat-checkbox formControlName="strictValidation"
             >Validação rigorosa (backend)</mat-checkbox
           >
@@ -992,12 +1220,6 @@ class PraxisFilesUploadConfigEditor {
               <mat-icon>help_outline</mat-icon>
             </button>
           </mat-form-field>
-        </form>
-        <form [formGroup]="optionsGroup">
-          <h4 class="section-subtitle">
-            <mat-icon aria-hidden="true">tune</mat-icon>
-            Opções configuráveis — Avançado
-          </h4>
           <mat-form-field appearance="fill">
             <mat-label>Extensões permitidas <span class="opt-tag">opcional</span></mat-label>
             <input
@@ -1050,6 +1272,8 @@ class PraxisFilesUploadConfigEditor {
             Pode impactar desempenho e latência de upload.
           </div>
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="quotasGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
@@ -1062,11 +1286,17 @@ class PraxisFilesUploadConfigEditor {
             >Bloquear ao exceder cota</mat-checkbox
           >
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="rateLimitGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Rate Limit (UI)
           </h4>
+          <p class="section-note">
+            Prefira poucos retries automáticos. Mais tentativas aliviam atrito
+            imediato, mas podem mascarar gargalos reais do ambiente.
+          </p>
           <mat-checkbox formControlName="showBannerOn429"
             >Exibir banner quando atingir o limite</mat-checkbox
           >
@@ -1082,13 +1312,40 @@ class PraxisFilesUploadConfigEditor {
             <input matInput type="number" formControlName="baseBackoffMs" />
           </mat-form-field>
         </form>
+        </section>
+        <section class="config-section">
+        <form [formGroup]="bulkGroup">
+          <h4 class="section-subtitle">
+            <mat-icon aria-hidden="true">bolt</mat-icon>
+            Opções configuráveis — Execução do lote
+          </h4>
+          <mat-checkbox formControlName="failFast"
+            >Parar no primeiro erro (fail-fast)</mat-checkbox
+          >
+        </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Mensagens">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Mensagens orientadas à operação</h3>
+          <p>
+            Ajuste o texto exibido ao usuário final. Priorize clareza,
+            consistência e linguagem acionável.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="messagesGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Mensagens (UI)
           </h4>
+          <p class="section-note">
+            Mensagens curtas e objetivas funcionam melhor em contextos de alta
+            frequência. Use este grupo para adequar a voz da interface ao seu
+            ambiente.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Sucesso (individual) <span class="opt-tag">opcional</span></mat-label>
             <input
@@ -1115,8 +1372,19 @@ class PraxisFilesUploadConfigEditor {
             </ng-container>
           </div>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Cabeçalhos">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Contexto de tenant e usuário</h3>
+          <p>
+            Use cabeçalhos para consultar configuração efetiva do servidor no
+            mesmo contexto que o componente usará em produção.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="headersGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
@@ -1151,8 +1419,19 @@ class PraxisFilesUploadConfigEditor {
             <input matInput formControlName="userValue" placeholder="ex.: 42" />
           </mat-form-field>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Servidor">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Contrato efetivo retornado pelo backend</h3>
+          <p>
+            Esta aba é a fonte de verdade do ambiente ativo. Compare o resumo
+            do servidor com o que foi configurado nos formulários anteriores.
+          </p>
+        </section>
+        <section class="config-section">
         <div class="server-tab">
           <div class="toolbar">
             <h4 class="section-subtitle ro">
@@ -1244,17 +1523,36 @@ class PraxisFilesUploadConfigEditor {
             </ng-template>
           </ng-template>
         </div>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="JSON">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Modo avançado</h3>
+          <p>
+            Edite o payload bruto apenas quando precisar de controle fino.
+            Alterações aqui exigem mais rigor de revisão e validação.
+          </p>
+        </section>
+        <div class="advanced-note">
+          O JSON é uma visão de baixo nível da configuração. Prefira as abas
+          guiadas sempre que possível para reduzir erro humano e manter a
+          configuração auditável.
+        </div>
         <textarea
+          class="json-textarea"
           rows="10"
           [ngModel]="form.value | json"
           (ngModelChange)="onJsonChange($event)"
         ></textarea>
         <div class="error" *ngIf="jsonError">{{ jsonError }}</div>
+        </div>
       </mat-tab>
     </mat-tab-group>
-  `, isInline: true, styles: [".help-icon-button{--mdc-icon-button-state-layer-size: 28px;--mdc-icon-button-icon-size: 18px;width:28px;height:28px;padding:0;display:inline-flex;align-items:center;justify-content:center;margin-right:-4px}.help-icon-button mat-icon{font-size:18px;width:18px;height:18px}.mat-mdc-form-field-icon-suffix{align-self:center}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i7.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i7.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.ɵNgNoValidate, selector: "form:not([ngNoForm]):not([ngNativeValidate])" }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.NumberValueAccessor, selector: "input[type=number][formControlName],input[type=number][formControl],input[type=number][ngModel]" }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1$1.RequiredValidator, selector: ":not([type=checkbox])[required][formControlName],:not([type=checkbox])[required][formControl],:not([type=checkbox])[required][ngModel]", inputs: ["required"] }, { kind: "directive", type: i1$1.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: i1$1.FormControlName, selector: "[formControlName]", inputs: ["formControlName", "disabled", "ngModel"], outputs: ["ngModelChange"] }, { kind: "ngmodule", type: MatTabsModule }, { kind: "component", type: i4.MatTab, selector: "mat-tab", inputs: ["disabled", "label", "aria-label", "aria-labelledby", "labelClass", "bodyClass", "id"], exportAs: ["matTab"] }, { kind: "component", type: i4.MatTabGroup, selector: "mat-tab-group", inputs: ["color", "fitInkBarToContent", "mat-stretch-tabs", "mat-align-tabs", "dynamicHeight", "selectedIndex", "headerPosition", "animationDuration", "contentTabIndex", "disablePagination", "disableRipple", "preserveContent", "backgroundColor", "aria-label", "aria-labelledby"], outputs: ["selectedIndexChange", "focusChange", "animationDone", "selectedTabChange"], exportAs: ["matTabGroup"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i5.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i5.MatLabel, selector: "mat-label" }, { kind: "directive", type: i5.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "directive", type: i5.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i6.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatCheckboxModule }, { kind: "component", type: i7$1.MatCheckbox, selector: "mat-checkbox", inputs: ["aria-label", "aria-labelledby", "aria-describedby", "aria-expanded", "aria-controls", "aria-owns", "id", "required", "labelPosition", "name", "value", "disableRipple", "tabIndex", "color", "disabledInteractive", "checked", "disabled", "indeterminate"], outputs: ["change", "indeterminateChange"], exportAs: ["matCheckbox"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i8.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i8.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i9.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "ngmodule", type: MatSnackBarModule }, { kind: "ngmodule", type: FormsModule }, { kind: "directive", type: i1$1.NgModel, selector: "[ngModel]:not([formControlName]):not([formControl])", inputs: ["name", "disabled", "ngModel", "ngModelOptions"], outputs: ["ngModelChange"], exportAs: ["ngModel"] }, { kind: "pipe", type: i7.JsonPipe, name: "json" }] });
+      </div>
+    </div>
+  `, isInline: true, styles: [".editor-layout{display:grid;grid-template-columns:minmax(260px,320px) minmax(0,1fr);gap:16px;align-items:start}.summary-panel{position:sticky;top:0;display:flex;flex-direction:column;gap:12px;padding:16px;border:1px solid var(--pfx-surface-border, #d8d8d8);border-radius:16px;background:linear-gradient(180deg,#fafbfc,#fff)}.summary-panel h3{margin:0;font-size:1rem;font-weight:600}.summary-panel .summary-intro{margin:0;color:#000000a6;line-height:1.4;font-size:.88rem}.summary-grid{display:grid;gap:10px}.summary-card{padding:12px;border-radius:12px;background:#fff;border:1px solid #e7e9ee}.summary-card .eyebrow{display:block;margin-bottom:4px;font-size:.72rem;font-weight:700;letter-spacing:.04em;text-transform:uppercase;color:#5f6b7a}.summary-card strong{display:block;margin-bottom:4px;font-size:.95rem}.summary-card p{margin:0;font-size:.85rem;line-height:1.45;color:#000000b8}.risk-panel{padding:12px;border-radius:12px;background:#fff8e8;border:1px solid #f0d29a}.risk-panel.safe{background:#f4fbf6;border-color:#b8ddc1}.risk-panel h4{display:flex;align-items:center;gap:6px;margin:0 0 8px;font-size:.92rem}.risk-list{display:grid;gap:8px}.risk-item{padding:10px;border-radius:10px;background:#ffffffb8}.risk-item strong{display:block;margin-bottom:2px;font-size:.84rem}.risk-item p,.risk-panel .safe-copy{margin:0;font-size:.82rem;line-height:1.4;color:#000000b8}.editor-main{min-width:0}.tab-panel{display:grid;gap:16px;padding-top:8px}.tab-intro{padding:16px 18px;border:1px solid #e5e8ef;border-radius:16px;background:linear-gradient(180deg,#fff,#f7f9fc)}.tab-intro h3{margin:0 0 6px;font-size:1rem;font-weight:600}.tab-intro p{margin:0;font-size:.9rem;line-height:1.5;color:#000000b8}.config-section{padding:18px;border:1px solid #e5e8ef;border-radius:16px;background:#fff}.config-section+.config-section{margin-top:0}.section-note{margin:0 0 16px;color:#000000b3;font-size:.88rem;line-height:1.45}.advanced-note{padding:14px 16px;border-radius:14px;border:1px solid #f0d29a;background:#fff8e8;color:#000000c7;font-size:.88rem;line-height:1.45}.json-textarea{width:100%;min-height:280px;padding:14px 16px;border-radius:14px;border:1px solid #d7dce5;background:#0f172a;color:#e5eefc;font:500 .84rem/1.55 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;resize:vertical}.server-tab{display:grid;gap:16px}.toolbar{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.summary{display:grid;gap:8px;padding-left:18px}.summary li{line-height:1.45}details{margin-top:12px;padding:14px 16px;border:1px solid #e5e8ef;border-radius:14px;background:#fbfcfe}details pre{white-space:pre-wrap;word-break:break-word}@media(max-width:1100px){.editor-layout{grid-template-columns:1fr}.summary-panel{position:static}}.help-icon-button{--mdc-icon-button-state-layer-size: 28px;--mdc-icon-button-icon-size: 18px;width:28px;height:28px;padding:0;display:inline-flex;align-items:center;justify-content:center;margin-right:-4px}.help-icon-button mat-icon{font-size:18px;width:18px;height:18px}.mat-mdc-form-field-icon-suffix{align-self:center}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i9.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i9.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.ɵNgNoValidate, selector: "form:not([ngNoForm]):not([ngNativeValidate])" }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.NumberValueAccessor, selector: "input[type=number][formControlName],input[type=number][formControl],input[type=number][ngModel]" }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.NgControlStatusGroup, selector: "[formGroupName],[formArrayName],[ngModelGroup],[formGroup],form:not([ngNoForm]),[ngForm]" }, { kind: "directive", type: i1$1.RequiredValidator, selector: ":not([type=checkbox])[required][formControlName],:not([type=checkbox])[required][formControl],:not([type=checkbox])[required][ngModel]", inputs: ["required"] }, { kind: "directive", type: i1$1.FormGroupDirective, selector: "[formGroup]", inputs: ["formGroup"], outputs: ["ngSubmit"], exportAs: ["ngForm"] }, { kind: "directive", type: i1$1.FormControlName, selector: "[formControlName]", inputs: ["formControlName", "disabled", "ngModel"], outputs: ["ngModelChange"] }, { kind: "ngmodule", type: MatTabsModule }, { kind: "component", type: i4.MatTab, selector: "mat-tab", inputs: ["disabled", "label", "aria-label", "aria-labelledby", "labelClass", "bodyClass", "id"], exportAs: ["matTab"] }, { kind: "component", type: i4.MatTabGroup, selector: "mat-tab-group", inputs: ["color", "fitInkBarToContent", "mat-stretch-tabs", "mat-align-tabs", "dynamicHeight", "selectedIndex", "headerPosition", "animationDuration", "contentTabIndex", "disablePagination", "disableRipple", "preserveContent", "backgroundColor", "aria-label", "aria-labelledby"], outputs: ["selectedIndexChange", "focusChange", "animationDone", "selectedTabChange"], exportAs: ["matTabGroup"] }, { kind: "ngmodule", type: MatFormFieldModule }, { kind: "component", type: i5.MatFormField, selector: "mat-form-field", inputs: ["hideRequiredMarker", "color", "floatLabel", "appearance", "subscriptSizing", "hintLabel"], exportAs: ["matFormField"] }, { kind: "directive", type: i5.MatLabel, selector: "mat-label" }, { kind: "directive", type: i5.MatHint, selector: "mat-hint", inputs: ["align", "id"] }, { kind: "directive", type: i5.MatSuffix, selector: "[matSuffix], [matIconSuffix], [matTextSuffix]", inputs: ["matTextSuffix"] }, { kind: "ngmodule", type: MatInputModule }, { kind: "directive", type: i6.MatInput, selector: "input[matInput], textarea[matInput], select[matNativeControl],      input[matNativeControl], textarea[matNativeControl]", inputs: ["disabled", "id", "placeholder", "name", "required", "type", "errorStateMatcher", "aria-describedby", "value", "readonly", "disabledInteractive"], exportAs: ["matInput"] }, { kind: "ngmodule", type: MatCheckboxModule }, { kind: "component", type: i7.MatCheckbox, selector: "mat-checkbox", inputs: ["aria-label", "aria-labelledby", "aria-describedby", "aria-expanded", "aria-controls", "aria-owns", "id", "required", "labelPosition", "name", "value", "disableRipple", "tabIndex", "color", "disabledInteractive", "checked", "disabled", "indeterminate"], outputs: ["change", "indeterminateChange"], exportAs: ["matCheckbox"] }, { kind: "ngmodule", type: MatSelectModule }, { kind: "component", type: i8.MatSelect, selector: "mat-select", inputs: ["aria-describedby", "panelClass", "disabled", "disableRipple", "tabIndex", "hideSingleSelectionIndicator", "placeholder", "required", "multiple", "disableOptionCentering", "compareWith", "value", "aria-label", "aria-labelledby", "errorStateMatcher", "typeaheadDebounceInterval", "sortComparator", "id", "panelWidth", "canSelectNullableOptions"], outputs: ["openedChange", "opened", "closed", "selectionChange", "valueChange"], exportAs: ["matSelect"] }, { kind: "component", type: i8.MatOption, selector: "mat-option", inputs: ["value", "id", "disabled"], outputs: ["onSelectionChange"], exportAs: ["matOption"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i11.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11$1.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "ngmodule", type: MatSnackBarModule }, { kind: "ngmodule", type: FormsModule }, { kind: "directive", type: i1$1.NgModel, selector: "[ngModel]:not([formControlName]):not([formControl])", inputs: ["name", "disabled", "ngModel", "ngModelOptions"], outputs: ["ngModelChange"], exportAs: ["ngModel"] }, { kind: "pipe", type: i9.JsonPipe, name: "json" }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisFilesUploadConfigEditor, decorators: [{
             type: Component,
@@ -1272,8 +1570,73 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                         MatSnackBarModule,
                         FormsModule,
                     ], template: `
+    <div class="editor-layout">
+      <aside class="summary-panel" aria-label="Resumo executivo da configuração">
+        <h3>Resumo executivo</h3>
+        <p class="summary-intro">
+          Revise aqui o impacto operacional antes de percorrer todos os grupos
+          de configuração.
+        </p>
+
+        <div class="summary-grid">
+          <section class="summary-card">
+            <span class="eyebrow">Estratégia</span>
+            <strong>{{ summaryStrategyTitle }}</strong>
+            <p>{{ summaryStrategyDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Experiência</span>
+            <strong>{{ summaryExperienceTitle }}</strong>
+            <p>{{ summaryExperienceDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Limites</span>
+            <strong>{{ summaryLimitsTitle }}</strong>
+            <p>{{ summaryLimitsDetail }}</p>
+          </section>
+
+          <section class="summary-card">
+            <span class="eyebrow">Servidor</span>
+            <strong>{{ summaryServerTitle }}</strong>
+            <p>{{ summaryServerDetail }}</p>
+          </section>
+        </div>
+
+        <section class="risk-panel" [class.safe]="activeRisks.length === 0">
+          <h4>
+            <mat-icon aria-hidden="true">{{
+              activeRisks.length === 0 ? 'verified' : 'warning'
+            }}</mat-icon>
+            Riscos e atenção
+          </h4>
+          <div *ngIf="activeRisks.length > 0; else noRiskState" class="risk-list">
+            <article class="risk-item" *ngFor="let risk of activeRisks">
+              <strong>{{ risk.title }}</strong>
+              <p>{{ risk.detail }}</p>
+            </article>
+          </div>
+          <ng-template #noRiskState>
+            <p class="safe-copy">
+              Nenhum risco operacional evidente na configuração atual.
+            </p>
+          </ng-template>
+        </section>
+      </aside>
+
+      <div class="editor-main">
     <mat-tab-group>
       <mat-tab label="Comportamento">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Estratégia e cadência do envio</h3>
+          <p>
+            Defina aqui como o usuário inicia o upload e como o lote se
+            comporta em termos de paralelismo e retentativa.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="form">
           <mat-form-field appearance="fill">
             <mat-label>Estratégia de envio <span class="opt-tag">opcional</span></mat-label>
@@ -1296,11 +1659,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             </button>
           </mat-form-field>
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="bulkGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">build</mat-icon>
             Opções configuráveis — Lote
           </h4>
+          <p class="section-note">
+            Use paralelismo e retries com moderação. Em ambientes corporativos,
+            esses controles afetam throughput, experiência percebida e carga no
+            backend.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Uploads paralelos <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="parallelUploads" />
@@ -1344,13 +1714,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             </button>
           </mat-form-field>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Interface">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Experiência visível para o usuário</h3>
+          <p>
+            Configure densidade, dropzone, metadados e detalhes da lista.
+            Priorize clareza operacional antes de habilitar recursos avançados.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="uiGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Interface
           </h4>
+          <p class="section-note">
+            Esta seção controla a ergonomia do componente. Mudanças aqui afetam
+            descoberta, esforço de uso e taxa de conclusão do envio.
+          </p>
           <mat-checkbox formControlName="showDropzone"
             >Exibir área de soltar</mat-checkbox
           >
@@ -1464,13 +1849,28 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             </mat-form-field>
           </fieldset>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Validações">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Regras de aceite e comportamento operacional</h3>
+          <p>
+            Separe mentalmente o que é validação de UX local do que é regra
+            efetiva de backend. Revise com atenção as opções destrutivas.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="limitsGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">build</mat-icon>
             Opções configuráveis — Validações
           </h4>
+          <p class="section-note">
+            Limites locais melhoram feedback imediato, mas não substituem a
+            política efetiva do servidor.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Tamanho máximo do arquivo (bytes) <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="maxFileSizeBytes" />
@@ -1493,6 +1893,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             <mat-label>Tamanho máximo do lote (bytes) <span class="opt-tag">opcional</span></mat-label>
             <input matInput type="number" formControlName="maxBulkSizeBytes" />
           </mat-form-field>
+        </form>
+        </section>
+        <section class="config-section">
+        <form [formGroup]="optionsGroup">
+          <h4 class="section-subtitle">
+            <mat-icon aria-hidden="true">tune</mat-icon>
+            Opções configuráveis — Backend
+          </h4>
+          <p class="section-note">
+            Estas opções têm impacto direto no contrato com o servidor e em
+            governança operacional. Trate alterações aqui como decisão de
+            política, não apenas de interface.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Política de conflito (padrão) <span class="opt-tag">opcional</span></mat-label>
             <mat-select formControlName="defaultConflictPolicy">
@@ -1512,14 +1925,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             >
               <mat-icon>help_outline</mat-icon>
             </button>
-            <div class="warn" *ngIf="limitsGroup.get('defaultConflictPolicy')?.value === 'OVERWRITE'">
+            <div class="warn" *ngIf="optionsGroup.get('defaultConflictPolicy')?.value === 'OVERWRITE'">
               <mat-icon color="warn" aria-hidden="true">warning</mat-icon>
               Atenção: OVERWRITE pode sobrescrever arquivos existentes.
             </div>
           </mat-form-field>
-          <mat-checkbox formControlName="failFast"
-            >Parar no primeiro erro (fail-fast)</mat-checkbox
-          >
           <mat-checkbox formControlName="strictValidation"
             >Validação rigorosa (backend)</mat-checkbox
           >
@@ -1537,12 +1947,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
               <mat-icon>help_outline</mat-icon>
             </button>
           </mat-form-field>
-        </form>
-        <form [formGroup]="optionsGroup">
-          <h4 class="section-subtitle">
-            <mat-icon aria-hidden="true">tune</mat-icon>
-            Opções configuráveis — Avançado
-          </h4>
           <mat-form-field appearance="fill">
             <mat-label>Extensões permitidas <span class="opt-tag">opcional</span></mat-label>
             <input
@@ -1595,6 +1999,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             Pode impactar desempenho e latência de upload.
           </div>
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="quotasGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
@@ -1607,11 +2013,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             >Bloquear ao exceder cota</mat-checkbox
           >
         </form>
+        </section>
+        <section class="config-section">
         <form [formGroup]="rateLimitGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Rate Limit (UI)
           </h4>
+          <p class="section-note">
+            Prefira poucos retries automáticos. Mais tentativas aliviam atrito
+            imediato, mas podem mascarar gargalos reais do ambiente.
+          </p>
           <mat-checkbox formControlName="showBannerOn429"
             >Exibir banner quando atingir o limite</mat-checkbox
           >
@@ -1627,13 +2039,40 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             <input matInput type="number" formControlName="baseBackoffMs" />
           </mat-form-field>
         </form>
+        </section>
+        <section class="config-section">
+        <form [formGroup]="bulkGroup">
+          <h4 class="section-subtitle">
+            <mat-icon aria-hidden="true">bolt</mat-icon>
+            Opções configuráveis — Execução do lote
+          </h4>
+          <mat-checkbox formControlName="failFast"
+            >Parar no primeiro erro (fail-fast)</mat-checkbox
+          >
+        </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Mensagens">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Mensagens orientadas à operação</h3>
+          <p>
+            Ajuste o texto exibido ao usuário final. Priorize clareza,
+            consistência e linguagem acionável.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="messagesGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
             Opções configuráveis — Mensagens (UI)
           </h4>
+          <p class="section-note">
+            Mensagens curtas e objetivas funcionam melhor em contextos de alta
+            frequência. Use este grupo para adequar a voz da interface ao seu
+            ambiente.
+          </p>
           <mat-form-field appearance="fill">
             <mat-label>Sucesso (individual) <span class="opt-tag">opcional</span></mat-label>
             <input
@@ -1660,8 +2099,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             </ng-container>
           </div>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Cabeçalhos">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Contexto de tenant e usuário</h3>
+          <p>
+            Use cabeçalhos para consultar configuração efetiva do servidor no
+            mesmo contexto que o componente usará em produção.
+          </p>
+        </section>
+        <section class="config-section">
         <form [formGroup]="headersGroup">
           <h4 class="section-subtitle">
             <mat-icon aria-hidden="true">edit</mat-icon>
@@ -1696,8 +2146,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             <input matInput formControlName="userValue" placeholder="ex.: 42" />
           </mat-form-field>
         </form>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="Servidor">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Contrato efetivo retornado pelo backend</h3>
+          <p>
+            Esta aba é a fonte de verdade do ambiente ativo. Compare o resumo
+            do servidor com o que foi configurado nos formulários anteriores.
+          </p>
+        </section>
+        <section class="config-section">
         <div class="server-tab">
           <div class="toolbar">
             <h4 class="section-subtitle ro">
@@ -1789,22 +2250,272 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             </ng-template>
           </ng-template>
         </div>
+        </section>
+        </div>
       </mat-tab>
       <mat-tab label="JSON">
+        <div class="tab-panel">
+        <section class="tab-intro">
+          <h3>Modo avançado</h3>
+          <p>
+            Edite o payload bruto apenas quando precisar de controle fino.
+            Alterações aqui exigem mais rigor de revisão e validação.
+          </p>
+        </section>
+        <div class="advanced-note">
+          O JSON é uma visão de baixo nível da configuração. Prefira as abas
+          guiadas sempre que possível para reduzir erro humano e manter a
+          configuração auditável.
+        </div>
         <textarea
+          class="json-textarea"
           rows="10"
           [ngModel]="form.value | json"
           (ngModelChange)="onJsonChange($event)"
         ></textarea>
         <div class="error" *ngIf="jsonError">{{ jsonError }}</div>
+        </div>
       </mat-tab>
     </mat-tab-group>
-  `, styles: [".help-icon-button{--mdc-icon-button-state-layer-size: 28px;--mdc-icon-button-icon-size: 18px;width:28px;height:28px;padding:0;display:inline-flex;align-items:center;justify-content:center;margin-right:-4px}.help-icon-button mat-icon{font-size:18px;width:18px;height:18px}.mat-mdc-form-field-icon-suffix{align-self:center}\n"] }]
+      </div>
+    </div>
+  `, styles: [".editor-layout{display:grid;grid-template-columns:minmax(260px,320px) minmax(0,1fr);gap:16px;align-items:start}.summary-panel{position:sticky;top:0;display:flex;flex-direction:column;gap:12px;padding:16px;border:1px solid var(--pfx-surface-border, #d8d8d8);border-radius:16px;background:linear-gradient(180deg,#fafbfc,#fff)}.summary-panel h3{margin:0;font-size:1rem;font-weight:600}.summary-panel .summary-intro{margin:0;color:#000000a6;line-height:1.4;font-size:.88rem}.summary-grid{display:grid;gap:10px}.summary-card{padding:12px;border-radius:12px;background:#fff;border:1px solid #e7e9ee}.summary-card .eyebrow{display:block;margin-bottom:4px;font-size:.72rem;font-weight:700;letter-spacing:.04em;text-transform:uppercase;color:#5f6b7a}.summary-card strong{display:block;margin-bottom:4px;font-size:.95rem}.summary-card p{margin:0;font-size:.85rem;line-height:1.45;color:#000000b8}.risk-panel{padding:12px;border-radius:12px;background:#fff8e8;border:1px solid #f0d29a}.risk-panel.safe{background:#f4fbf6;border-color:#b8ddc1}.risk-panel h4{display:flex;align-items:center;gap:6px;margin:0 0 8px;font-size:.92rem}.risk-list{display:grid;gap:8px}.risk-item{padding:10px;border-radius:10px;background:#ffffffb8}.risk-item strong{display:block;margin-bottom:2px;font-size:.84rem}.risk-item p,.risk-panel .safe-copy{margin:0;font-size:.82rem;line-height:1.4;color:#000000b8}.editor-main{min-width:0}.tab-panel{display:grid;gap:16px;padding-top:8px}.tab-intro{padding:16px 18px;border:1px solid #e5e8ef;border-radius:16px;background:linear-gradient(180deg,#fff,#f7f9fc)}.tab-intro h3{margin:0 0 6px;font-size:1rem;font-weight:600}.tab-intro p{margin:0;font-size:.9rem;line-height:1.5;color:#000000b8}.config-section{padding:18px;border:1px solid #e5e8ef;border-radius:16px;background:#fff}.config-section+.config-section{margin-top:0}.section-note{margin:0 0 16px;color:#000000b3;font-size:.88rem;line-height:1.45}.advanced-note{padding:14px 16px;border-radius:14px;border:1px solid #f0d29a;background:#fff8e8;color:#000000c7;font-size:.88rem;line-height:1.45}.json-textarea{width:100%;min-height:280px;padding:14px 16px;border-radius:14px;border:1px solid #d7dce5;background:#0f172a;color:#e5eefc;font:500 .84rem/1.55 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;resize:vertical}.server-tab{display:grid;gap:16px}.toolbar{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.summary{display:grid;gap:8px;padding-left:18px}.summary li{line-height:1.45}details{margin-top:12px;padding:14px 16px;border:1px solid #e5e8ef;border-radius:14px;background:#fbfcfe}details pre{white-space:pre-wrap;word-break:break-word}@media(max-width:1100px){.editor-layout{grid-template-columns:1fr}.summary-panel{position:static}}.help-icon-button{--mdc-icon-button-state-layer-size: 28px;--mdc-icon-button-icon-size: 18px;width:28px;height:28px;padding:0;display:inline-flex;align-items:center;justify-content:center;margin-right:-4px}.help-icon-button mat-icon{font-size:18px;width:18px;height:18px}.mat-mdc-form-field-icon-suffix{align-self:center}\n"] }]
         }], ctorParameters: () => [{ type: i1$1.FormBuilder }, { type: undefined, decorators: [{
                     type: Inject,
                     args: [SETTINGS_PANEL_DATA]
                 }] }, { type: i2.MatSnackBar }, { type: i0.DestroyRef }] });
 
+const FILES_UPLOAD_EN_US = {
+    'praxis.filesUpload.settingsAriaLabel': 'Open settings',
+    'praxis.filesUpload.dropzoneLabel': 'Drag files or',
+    'praxis.filesUpload.dropzoneButton': 'select',
+    'praxis.filesUpload.conflictPolicyLabel': 'Conflict policy',
+    'praxis.filesUpload.metadataLabel': 'Metadata (JSON)',
+    'praxis.filesUpload.progressAriaLabel': 'Upload progress',
+    'praxis.filesUpload.rateLimitBanner': 'Rate limit exceeded. Try again at',
+    'praxis.filesUpload.settingsTitle': 'Files Upload Configuration',
+    'praxis.filesUpload.statusSuccess': 'Uploaded',
+    'praxis.filesUpload.statusError': 'Error',
+    'praxis.filesUpload.invalidMetadata': 'Invalid metadata.',
+    'praxis.filesUpload.genericUploadError': 'File upload error.',
+    'praxis.filesUpload.acceptError': 'File type not allowed.',
+    'praxis.filesUpload.maxFileSizeError': 'File exceeds the maximum size.',
+    'praxis.filesUpload.maxFilesPerBulkError': 'Too many files selected.',
+    'praxis.filesUpload.maxBulkSizeError': 'Total files size exceeded.',
+    'praxis.filesUpload.serviceUnavailable': 'Upload service unavailable.',
+    'praxis.filesUpload.baseUrlMissing': 'Base URL not configured. Provide [baseUrl] to enable uploads.',
+    'praxis.filesUpload.selectFiles': 'Select file(s)',
+    'praxis.filesUpload.remove': 'Remove',
+    'praxis.filesUpload.moreActions': 'More actions',
+    'praxis.filesUpload.policySummaryAction': 'Information about upload policies',
+    'praxis.filesUpload.retry': 'Retry',
+    'praxis.filesUpload.download': 'Download',
+    'praxis.filesUpload.copyLink': 'Copy link',
+    'praxis.filesUpload.details': 'Details',
+    'praxis.filesUpload.detailsMetadata': 'Metadata',
+    'praxis.filesUpload.dropzoneHint': 'Drag and drop files here or click to select',
+    'praxis.filesUpload.dropzoneProximityHint': 'Drop here to upload',
+    'praxis.filesUpload.placeholder': 'Select or drop files…',
+    'praxis.filesUpload.partialUploadError': 'Partial upload completed with failures in part of the batch.',
+    'praxis.filesUpload.presignMetadataMissing': 'Presigned upload completed without file metadata.',
+    'praxis.filesUpload.fieldChipAria': 'Additional files selected',
+    'praxis.filesUpload.fieldPendingCountSuffix': 'file(s) selected',
+    'praxis.filesUpload.removePendingFile': 'Remove selected file',
+    'praxis.filesUpload.fieldPolicyTypes': 'Types',
+    'praxis.filesUpload.fieldPolicyMaxPerFile': 'Max/file',
+    'praxis.filesUpload.fieldPolicyMaxItems': 'Max/items',
+    'praxis.filesUpload.fieldPolicyNotConfigured': 'Not configured',
+    'praxis.filesUpload.sizeUnitBytes': 'Bytes',
+    'praxis.filesUpload.sizeUnitKB': 'KB',
+    'praxis.filesUpload.sizeUnitMB': 'MB',
+    'praxis.filesUpload.sizeUnitGB': 'GB',
+    'praxis.filesUpload.sizeUnitTB': 'TB',
+    'praxis.filesUpload.errors.INVALID_FILE_TYPE': 'Invalid file type.',
+    'praxis.filesUpload.errors.FILE_TOO_LARGE': 'File is too large.',
+    'praxis.filesUpload.errors.NOT_FOUND': 'File not found.',
+    'praxis.filesUpload.errors.UNAUTHORIZED': 'Unauthorized request.',
+    'praxis.filesUpload.errors.RATE_LIMIT_EXCEEDED': 'Request limit exceeded.',
+    'praxis.filesUpload.errors.INTERNAL_ERROR': 'Internal server error.',
+    'praxis.filesUpload.errors.QUOTA_EXCEEDED': 'Quota exceeded.',
+    'praxis.filesUpload.errors.SEC_VIRUS_DETECTED': 'Virus detected in file.',
+    'praxis.filesUpload.errors.SEC_MALICIOUS_CONTENT': 'Malicious content detected.',
+    'praxis.filesUpload.errors.SEC_DANGEROUS_TYPE': 'Dangerous file type.',
+    'praxis.filesUpload.errors.FMT_MAGIC_MISMATCH': 'File content does not match the declared format.',
+    'praxis.filesUpload.errors.FMT_CORRUPTED': 'Corrupted file.',
+    'praxis.filesUpload.errors.FMT_UNSUPPORTED': 'Unsupported file format.',
+    'praxis.filesUpload.errors.SYS_STORAGE_ERROR': 'Storage error.',
+    'praxis.filesUpload.errors.SYS_SERVICE_DOWN': 'Service unavailable.',
+    'praxis.filesUpload.errors.SYS_RATE_LIMIT': 'Request limit exceeded.',
+    'praxis.filesUpload.errors.ARQUIVO_MUITO_GRANDE': 'File is too large.',
+    'praxis.filesUpload.errors.TIPO_ARQUIVO_INVALIDO': 'Invalid file type.',
+    'praxis.filesUpload.errors.TIPO_MIDIA_NAO_SUPORTADO': 'Unsupported media type.',
+    'praxis.filesUpload.errors.CAMPO_OBRIGATORIO_AUSENTE': 'Required field is missing.',
+    'praxis.filesUpload.errors.OPCOES_JSON_INVALIDAS': 'Invalid JSON options.',
+    'praxis.filesUpload.errors.ARGUMENTO_INVALIDO': 'Invalid argument.',
+    'praxis.filesUpload.errors.NAO_AUTORIZADO': 'Authentication required.',
+    'praxis.filesUpload.errors.ERRO_INTERNO': 'Internal server error.',
+    'praxis.filesUpload.errors.LIMITE_TAXA_EXCEDIDO': 'Rate limit exceeded.',
+    'praxis.filesUpload.errors.COTA_EXCEDIDA': 'Quota exceeded.',
+    'praxis.filesUpload.errors.ARQUIVO_JA_EXISTE': 'File already exists.',
+    'praxis.filesUpload.errors.INVALID_JSON_OPTIONS': 'Invalid JSON options.',
+    'praxis.filesUpload.errors.EMPTY_FILENAME': 'File name is required.',
+    'praxis.filesUpload.errors.FILE_EXISTS': 'File already exists.',
+    'praxis.filesUpload.errors.PATH_TRAVERSAL': 'Path traversal detected.',
+    'praxis.filesUpload.errors.INSUFFICIENT_STORAGE': 'Insufficient storage.',
+    'praxis.filesUpload.errors.UPLOAD_TIMEOUT': 'Upload timed out.',
+    'praxis.filesUpload.errors.BULK_UPLOAD_TIMEOUT': 'Bulk upload timed out.',
+    'praxis.filesUpload.errors.BULK_UPLOAD_CANCELLED': 'Bulk upload cancelled.',
+    'praxis.filesUpload.errors.USER_CANCELLED': 'Upload cancelled by user.',
+    'praxis.filesUpload.errors.UNKNOWN_ERROR': 'Unknown error.',
+    'praxis.filesUpload.fieldPendingSummary': 'Files ready to upload',
+    'praxis.filesUpload.fieldSelectedSummary': 'Selected file',
+    'praxis.filesUpload.fieldSelectedPlural': 'files attached',
+    'praxis.filesUpload.fieldEmptySummary': 'No file selected',
+    'praxis.filesUpload.fieldErrorSummary': 'Fix the error to continue',
+    'praxis.filesUpload.fieldActionUpload': 'Upload selected files',
+    'praxis.filesUpload.fieldActionUploadShort': 'Upload',
+    'praxis.filesUpload.fieldActionCancel': 'Cancel current selection',
+    'praxis.filesUpload.fieldActionCancelShort': 'Cancel',
+    'praxis.filesUpload.fieldActionSelect': 'Select file(s)',
+    'praxis.filesUpload.fieldActionClear': 'Clear',
+    'praxis.filesUpload.fieldInfoAction': 'Information',
+    'praxis.filesUpload.fieldMoreActions': 'More actions',
+    'praxis.filesUpload.fieldPendingAriaSuffix': 'files ready to upload',
+    'praxis.filesUpload.selectedOverlayAriaLabel': 'Selected files',
+    'praxis.filesUpload.selectedOverlayTitle': 'Selected',
+    'praxis.filesUpload.bulkSummaryTotal': 'Total',
+    'praxis.filesUpload.bulkSummarySuccess': 'Success',
+    'praxis.filesUpload.bulkSummaryFailed': 'Failed',
+    'praxis.filesUpload.resultMetaIdLabel': 'ID',
+    'praxis.filesUpload.resultMetaTypeLabel': 'Type',
+    'praxis.filesUpload.resultMetaSizeLabel': 'Size',
+    'praxis.filesUpload.resultMetaUploadedAtLabel': 'Uploaded at',
+    'praxis.filesUpload.policySummaryAny': 'any',
+    'praxis.filesUpload.policySummaryNotConfigured': '—',
+    'praxis.filesUpload.policySummaryTypesLabel': 'Types',
+    'praxis.filesUpload.policySummaryMaxPerFileLabel': 'Max. per file',
+    'praxis.filesUpload.policySummaryQuantityLabel': 'Qty',
+    'praxis.filesUpload.showAll': 'Show all',
+    'praxis.filesUpload.showLess': 'Show less',
+};
+
+const FILES_UPLOAD_PT_BR = {
+    'praxis.filesUpload.settingsAriaLabel': 'Abrir configurações',
+    'praxis.filesUpload.dropzoneLabel': 'Arraste arquivos ou',
+    'praxis.filesUpload.dropzoneButton': 'selecionar',
+    'praxis.filesUpload.conflictPolicyLabel': 'Política de conflito',
+    'praxis.filesUpload.metadataLabel': 'Metadados (JSON)',
+    'praxis.filesUpload.progressAriaLabel': 'Progresso do upload',
+    'praxis.filesUpload.rateLimitBanner': 'Limite de requisições excedido. Tente novamente às',
+    'praxis.filesUpload.settingsTitle': 'Configuração de Upload de Arquivos',
+    'praxis.filesUpload.statusSuccess': 'Enviado',
+    'praxis.filesUpload.statusError': 'Erro',
+    'praxis.filesUpload.invalidMetadata': 'Metadados inválidos.',
+    'praxis.filesUpload.genericUploadError': 'Erro no envio de arquivo.',
+    'praxis.filesUpload.acceptError': 'Tipo de arquivo não permitido.',
+    'praxis.filesUpload.maxFileSizeError': 'Arquivo excede o tamanho máximo.',
+    'praxis.filesUpload.maxFilesPerBulkError': 'Quantidade de arquivos excedida.',
+    'praxis.filesUpload.maxBulkSizeError': 'Tamanho total dos arquivos excedido.',
+    'praxis.filesUpload.serviceUnavailable': 'Serviço de upload indisponível.',
+    'praxis.filesUpload.baseUrlMissing': 'Base URL não configurada. Informe [baseUrl] para habilitar o envio.',
+    'praxis.filesUpload.selectFiles': 'Selecionar arquivo(s)',
+    'praxis.filesUpload.remove': 'Remover',
+    'praxis.filesUpload.moreActions': 'Mais ações',
+    'praxis.filesUpload.policySummaryAction': 'Informações sobre políticas de upload',
+    'praxis.filesUpload.retry': 'Reenviar',
+    'praxis.filesUpload.download': 'Baixar',
+    'praxis.filesUpload.copyLink': 'Copiar link',
+    'praxis.filesUpload.details': 'Detalhes',
+    'praxis.filesUpload.detailsMetadata': 'Metadados',
+    'praxis.filesUpload.dropzoneHint': 'Arraste e solte arquivos aqui ou clique para selecionar',
+    'praxis.filesUpload.dropzoneProximityHint': 'Solte aqui para enviar',
+    'praxis.filesUpload.placeholder': 'Selecione ou solte arquivos…',
+    'praxis.filesUpload.partialUploadError': 'Upload parcial concluído com falhas em parte do lote.',
+    'praxis.filesUpload.presignMetadataMissing': 'Upload assinado concluído sem metadados do arquivo.',
+    'praxis.filesUpload.fieldChipAria': 'Arquivos adicionais selecionados',
+    'praxis.filesUpload.fieldPendingCountSuffix': 'arquivo(s) selecionado(s)',
+    'praxis.filesUpload.removePendingFile': 'Remover arquivo selecionado',
+    'praxis.filesUpload.fieldPolicyTypes': 'Tipos',
+    'praxis.filesUpload.fieldPolicyMaxPerFile': 'Máx/arquivo',
+    'praxis.filesUpload.fieldPolicyMaxItems': 'Máx/itens',
+    'praxis.filesUpload.fieldPolicyNotConfigured': 'Não configurado',
+    'praxis.filesUpload.sizeUnitBytes': 'Bytes',
+    'praxis.filesUpload.sizeUnitKB': 'KB',
+    'praxis.filesUpload.sizeUnitMB': 'MB',
+    'praxis.filesUpload.sizeUnitGB': 'GB',
+    'praxis.filesUpload.sizeUnitTB': 'TB',
+    'praxis.filesUpload.errors.INVALID_FILE_TYPE': 'Tipo de arquivo inválido.',
+    'praxis.filesUpload.errors.FILE_TOO_LARGE': 'Arquivo muito grande.',
+    'praxis.filesUpload.errors.NOT_FOUND': 'Arquivo não encontrado.',
+    'praxis.filesUpload.errors.UNAUTHORIZED': 'Requisição não autorizada.',
+    'praxis.filesUpload.errors.RATE_LIMIT_EXCEEDED': 'Limite de requisições excedido.',
+    'praxis.filesUpload.errors.INTERNAL_ERROR': 'Erro interno do servidor.',
+    'praxis.filesUpload.errors.QUOTA_EXCEEDED': 'Cota excedida.',
+    'praxis.filesUpload.errors.SEC_VIRUS_DETECTED': 'Vírus detectado no arquivo.',
+    'praxis.filesUpload.errors.SEC_MALICIOUS_CONTENT': 'Conteúdo malicioso detectado.',
+    'praxis.filesUpload.errors.SEC_DANGEROUS_TYPE': 'Tipo de arquivo perigoso.',
+    'praxis.filesUpload.errors.FMT_MAGIC_MISMATCH': 'Conteúdo do arquivo incompatível.',
+    'praxis.filesUpload.errors.FMT_CORRUPTED': 'Arquivo corrompido.',
+    'praxis.filesUpload.errors.FMT_UNSUPPORTED': 'Formato de arquivo não suportado.',
+    'praxis.filesUpload.errors.SYS_STORAGE_ERROR': 'Erro de armazenamento.',
+    'praxis.filesUpload.errors.SYS_SERVICE_DOWN': 'Serviço indisponível.',
+    'praxis.filesUpload.errors.SYS_RATE_LIMIT': 'Limite de requisições excedido.',
+    // Aliases PT-BR do backend e códigos adicionais
+    'praxis.filesUpload.errors.ARQUIVO_MUITO_GRANDE': 'Arquivo muito grande.',
+    'praxis.filesUpload.errors.TIPO_ARQUIVO_INVALIDO': 'Tipo de arquivo inválido.',
+    'praxis.filesUpload.errors.TIPO_MIDIA_NAO_SUPORTADO': 'Tipo de mídia não suportado.',
+    'praxis.filesUpload.errors.CAMPO_OBRIGATORIO_AUSENTE': 'Campo obrigatório ausente.',
+    'praxis.filesUpload.errors.OPCOES_JSON_INVALIDAS': 'JSON de opções inválido.',
+    'praxis.filesUpload.errors.ARGUMENTO_INVALIDO': 'Argumento inválido.',
+    'praxis.filesUpload.errors.NAO_AUTORIZADO': 'Autenticação necessária.',
+    'praxis.filesUpload.errors.ERRO_INTERNO': 'Erro interno do servidor.',
+    'praxis.filesUpload.errors.LIMITE_TAXA_EXCEDIDO': 'Limite de taxa excedido.',
+    'praxis.filesUpload.errors.COTA_EXCEDIDA': 'Cota excedida.',
+    'praxis.filesUpload.errors.ARQUIVO_JA_EXISTE': 'Arquivo já existe.',
+    // Outros possíveis códigos mapeados no catálogo
+    'praxis.filesUpload.errors.INVALID_JSON_OPTIONS': 'JSON de opções inválido.',
+    'praxis.filesUpload.errors.EMPTY_FILENAME': 'Nome do arquivo obrigatório.',
+    'praxis.filesUpload.errors.FILE_EXISTS': 'Arquivo já existe.',
+    'praxis.filesUpload.errors.PATH_TRAVERSAL': 'Path traversal detectado.',
+    'praxis.filesUpload.errors.INSUFFICIENT_STORAGE': 'Sem espaço em disco.',
+    'praxis.filesUpload.errors.UPLOAD_TIMEOUT': 'Tempo esgotado no upload.',
+    'praxis.filesUpload.errors.BULK_UPLOAD_TIMEOUT': 'Tempo esgotado no upload em lote.',
+    'praxis.filesUpload.errors.BULK_UPLOAD_CANCELLED': 'Upload em lote cancelado.',
+    'praxis.filesUpload.errors.USER_CANCELLED': 'Upload cancelado pelo usuário.',
+    'praxis.filesUpload.errors.UNKNOWN_ERROR': 'Erro desconhecido.',
+    'praxis.filesUpload.fieldPendingSummary': 'Arquivos prontos para envio',
+    'praxis.filesUpload.fieldSelectedSummary': 'Arquivo selecionado',
+    'praxis.filesUpload.fieldSelectedPlural': 'arquivos vinculados',
+    'praxis.filesUpload.fieldEmptySummary': 'Nenhum arquivo selecionado',
+    'praxis.filesUpload.fieldErrorSummary': 'Corrija o erro para continuar',
+    'praxis.filesUpload.fieldActionUpload': 'Enviar arquivos selecionados',
+    'praxis.filesUpload.fieldActionUploadShort': 'Enviar',
+    'praxis.filesUpload.fieldActionCancel': 'Cancelar seleção atual',
+    'praxis.filesUpload.fieldActionCancelShort': 'Cancelar',
+    'praxis.filesUpload.fieldActionSelect': 'Selecionar arquivo(s)',
+    'praxis.filesUpload.fieldActionClear': 'Limpar',
+    'praxis.filesUpload.fieldInfoAction': 'Informações',
+    'praxis.filesUpload.fieldMoreActions': 'Mais ações',
+    'praxis.filesUpload.fieldPendingAriaSuffix': 'arquivos prontos para envio',
+    'praxis.filesUpload.selectedOverlayAriaLabel': 'Arquivos selecionados',
+    'praxis.filesUpload.selectedOverlayTitle': 'Selecionados',
+    'praxis.filesUpload.bulkSummaryTotal': 'Total',
+    'praxis.filesUpload.bulkSummarySuccess': 'Sucesso',
+    'praxis.filesUpload.bulkSummaryFailed': 'Falhas',
+    'praxis.filesUpload.resultMetaIdLabel': 'ID',
+    'praxis.filesUpload.resultMetaTypeLabel': 'Tipo',
+    'praxis.filesUpload.resultMetaSizeLabel': 'Tamanho',
+    'praxis.filesUpload.resultMetaUploadedAtLabel': 'Enviado em',
+    'praxis.filesUpload.policySummaryAny': 'qualquer',
+    'praxis.filesUpload.policySummaryNotConfigured': '—',
+    'praxis.filesUpload.policySummaryTypesLabel': 'Tipos',
+    'praxis.filesUpload.policySummaryMaxPerFileLabel': 'Máx. por arquivo',
+    'praxis.filesUpload.policySummaryQuantityLabel': 'Qtde',
+    'praxis.filesUpload.showAll': 'Ver todos',
+    'praxis.filesUpload.showLess': 'Ver menos',
+};
+
+/** @deprecated Transitional compatibility token. Prefer PraxisI18nService. */
 const FILES_UPLOAD_TEXTS = new InjectionToken('FILES_UPLOAD_TEXTS', {
     providedIn: 'root',
     factory: () => ({
@@ -1817,97 +2528,62 @@ const FILES_UPLOAD_TEXTS = new InjectionToken('FILES_UPLOAD_TEXTS', {
         rateLimitBanner: 'Limite de requisições excedido. Tente novamente às',
     }),
 });
-
+/** @deprecated Transitional compatibility token. Prefer PraxisI18nService. */
 const TRANSLATE_LIKE = new InjectionToken('TRANSLATE_LIKE');
-const FILES_UPLOAD_ERROR_MESSAGES = new InjectionToken('FILES_UPLOAD_ERROR_MESSAGES');
-const DEFAULT_MESSAGES = {
-    INVALID_FILE_TYPE: 'Tipo de arquivo inválido.',
-    FILE_TOO_LARGE: 'Arquivo muito grande.',
-    NOT_FOUND: 'Arquivo não encontrado.',
-    UNAUTHORIZED: 'Requisição não autorizada.',
-    RATE_LIMIT_EXCEEDED: 'Limite de requisições excedido.',
-    INTERNAL_ERROR: 'Erro interno do servidor.',
-    QUOTA_EXCEEDED: 'Cota excedida.',
-    SEC_VIRUS_DETECTED: 'Vírus detectado no arquivo.',
-    SEC_MALICIOUS_CONTENT: 'Conteúdo malicioso detectado.',
-    SEC_DANGEROUS_TYPE: 'Tipo de arquivo perigoso.',
-    FMT_MAGIC_MISMATCH: 'Conteúdo do arquivo incompatível.',
-    FMT_CORRUPTED: 'Arquivo corrompido.',
-    FMT_UNSUPPORTED: 'Formato de arquivo não suportado.',
-    SYS_STORAGE_ERROR: 'Erro de armazenamento.',
-    SYS_SERVICE_DOWN: 'Serviço indisponível.',
-    SYS_RATE_LIMIT: 'Limite de requisições excedido.',
-    // aliases em português vindos do backend
-    ARQUIVO_MUITO_GRANDE: 'Arquivo muito grande.',
-    TIPO_ARQUIVO_INVALIDO: 'Tipo de arquivo inválido.',
-    TIPO_MIDIA_NAO_SUPORTADO: 'Tipo de mídia não suportado.',
-    CAMPO_OBRIGATORIO_AUSENTE: 'Campo obrigatório ausente.',
-    OPCOES_JSON_INVALIDAS: 'JSON de opções inválido.',
-    ARGUMENTO_INVALIDO: 'Argumento inválido.',
-    NAO_AUTORIZADO: 'Autenticação necessária.',
-    ERRO_INTERNO: 'Erro interno do servidor.',
-    LIMITE_TAXA_EXCEDIDO: 'Limite de taxa excedido.',
-    COTA_EXCEDIDA: 'Cota excedida.',
-    ARQUIVO_JA_EXISTE: 'Arquivo já existe.',
-};
-class ErrorMapperService {
-    customMessages;
-    translate;
-    constructor(customMessages, translate) {
-        this.customMessages = customMessages;
-        this.translate = translate;
-    }
-    map(error, headers) {
-        const code = String(error.code || 'UNKNOWN_ERROR');
-        const key = `praxis.filesUpload.errors.${code}`;
-        const translated = this.translate?.instant(key);
-        const message = (translated && translated !== key ? translated : undefined) ??
-            this.customMessages?.[code] ??
-            DEFAULT_MESSAGES[code] ??
-            error.message ??
-            'Erro desconhecido.';
-        // metadados do catálogo
-        const meta = getErrorMeta(code);
-        const mapped = {
-            message,
-            title: meta.title,
-            severity: meta.severity,
-            category: meta.category,
-            phase: meta.phase,
-            userAction: meta.userAction,
-        };
-        const isRateLimit = code === 'LIMITE_TAXA_EXCEDIDO' ||
-            code === 'RATE_LIMIT_EXCEEDED' ||
-            code === 'SYS_RATE_LIMIT';
-        if (isRateLimit) {
-            const limit = Number(headers?.get('X-RateLimit-Limit'));
-            const remaining = Number(headers?.get('X-RateLimit-Remaining'));
-            const resetEpochSeconds = Number(headers?.get('X-RateLimit-Reset'));
-            if (!Number.isNaN(limit) &&
-                !Number.isNaN(remaining) &&
-                !Number.isNaN(resetEpochSeconds)) {
-                mapped.rateLimit = { limit, remaining, resetEpochSeconds };
-            }
+function createPraxisFilesUploadI18nConfig(options = {}) {
+    const dictionaries = {
+        'pt-BR': {
+            ...FILES_UPLOAD_PT_BR,
+            ...(options.dictionaries?.['pt-BR'] ?? {}),
+        },
+        'en-US': {
+            ...FILES_UPLOAD_EN_US,
+            ...(options.dictionaries?.['en-US'] ?? {}),
+        },
+    };
+    for (const [locale, dictionary] of Object.entries(options.dictionaries ?? {})) {
+        if (locale === 'pt-BR' || locale === 'en-US') {
+            continue;
         }
-        return mapped;
+        dictionaries[locale] = {
+            ...(dictionaries[locale] ?? {}),
+            ...dictionary,
+        };
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, deps: [{ token: FILES_UPLOAD_ERROR_MESSAGES, optional: true }, { token: TRANSLATE_LIKE, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, providedIn: 'root' });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, decorators: [{
-            type: Injectable,
-            args: [{ providedIn: 'root' }]
-        }], ctorParameters: () => [{ type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [FILES_UPLOAD_ERROR_MESSAGES]
-                }] }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [TRANSLATE_LIKE]
-                }] }] });
+    return {
+        locale: options.locale,
+        fallbackLocale: options.fallbackLocale ?? 'pt-BR',
+        dictionaries,
+    };
+}
+function providePraxisFilesUploadI18n(options = {}) {
+    return providePraxisI18n(createPraxisFilesUploadI18nConfig(options));
+}
+function resolvePraxisFilesUploadText(i18n, key, fallback, legacyTexts, legacyTranslate) {
+    const namespacedKey = key.startsWith('praxis.filesUpload.')
+        ? key
+        : `praxis.filesUpload.${key}`;
+    const coreTranslation = i18n.t(namespacedKey, undefined, '');
+    if (coreTranslation) {
+        return coreTranslation;
+    }
+    const legacyText = legacyTexts?.[key];
+    if (legacyText) {
+        return legacyText;
+    }
+    const translatedByLegacyService = legacyTranslate?.t?.(namespacedKey, undefined, '') ||
+        legacyTranslate?.t?.(key, undefined, '') ||
+        resolveLegacyInstantTranslation(legacyTranslate, namespacedKey) ||
+        resolveLegacyInstantTranslation(legacyTranslate, key);
+    if (translatedByLegacyService) {
+        return translatedByLegacyService;
+    }
+    return fallback;
+}
+function resolveLegacyInstantTranslation(legacyTranslate, key) {
+    const translated = legacyTranslate?.instant?.(key);
+    return translated && translated !== key ? translated : '';
+}
 
 function toError(key, info) {
     return { [key]: info };
@@ -2044,9 +2720,7 @@ class FilesApiClient {
     constructor(http) {
         this.http = http;
     }
-    /**
-     * Upload a single file com metadata/conflictPolicy (compat) e/ou options JSON.
-     */
+    /** Upload de um único arquivo com metadata/conflictPolicy e options JSON. */
     upload(baseUrl, file, options = {}) {
         const formData = new FormData();
         formData.append('file', file);
@@ -2063,9 +2737,7 @@ class FilesApiClient {
         })
             .pipe(retry(options.retryCount ?? 0));
     }
-    /**
-     * Upload múltiplo com arrays de metadata/conflictPolicy (compat) e/ou options JSON.
-     */
+    /** Upload múltiplo com arrays de metadata/conflictPolicy e options JSON. */
     bulkUpload(baseUrl, files, options = {}) {
         const formData = new FormData();
         files.forEach((f) => {
@@ -2073,10 +2745,9 @@ class FilesApiClient {
         });
         if (options.optionsJson)
             formData.append('options', options.optionsJson);
-        // Suporte a failFast/failFastMode
-        const ff = options.failFast ?? options.failFastMode;
-        if (ff !== undefined)
-            formData.append('failFast', String(ff));
+        if (options.failFast !== undefined) {
+            formData.append('failFastMode', String(options.failFast));
+        }
         // Arrays de metadata/políticas quando presentes
         const metas = files.map((f) => f.metadata ?? null);
         if (metas.some((m) => m !== null)) {
@@ -2114,13 +2785,23 @@ class PresignedUploaderService {
     /**
      * Uploads a file to a presigned URL and retries when configured.
      */
-    upload(target, file, retryCount = 0) {
+    upload(target, file, options = {}, retryCount = 0) {
         const formData = new FormData();
         if (target.fields) {
             Object.entries(target.fields).forEach(([key, value]) => {
                 formData.append(key, value);
             });
         }
+        if (this.shouldAppendPraxisFields(target.uploadUrl)) {
+            if (options.optionsJson)
+                formData.append('options', options.optionsJson);
+            if (options.metadata) {
+                formData.append('metadata', JSON.stringify(options.metadata));
+            }
+            if (options.conflictPolicy) {
+                formData.append('conflictPolicy', options.conflictPolicy);
+            }
+        }
         formData.append('file', file);
         return this.http
             .post(target.uploadUrl, formData, {
@@ -2131,6 +2812,18 @@ class PresignedUploaderService {
         })
             .pipe(retry(retryCount));
     }
+    shouldAppendPraxisFields(uploadUrl) {
+        if (!uploadUrl)
+            return false;
+        if (uploadUrl.startsWith('/'))
+            return true;
+        try {
+            return new URL(uploadUrl, window.location.origin).origin === window.location.origin;
+        }
+        catch {
+            return false;
+        }
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PresignedUploaderService, deps: [{ token: i1.HttpClient }], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PresignedUploaderService, providedIn: 'root' });
 }
@@ -2139,38 +2832,123 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [{ type: i1.HttpClient }] });
 
+const FILES_UPLOAD_ERROR_MESSAGES = new InjectionToken('FILES_UPLOAD_ERROR_MESSAGES');
+const DEFAULT_MESSAGES = {
+    INVALID_FILE_TYPE: 'Tipo de arquivo inválido.',
+    FILE_TOO_LARGE: 'Arquivo muito grande.',
+    NOT_FOUND: 'Arquivo não encontrado.',
+    UNAUTHORIZED: 'Requisição não autorizada.',
+    RATE_LIMIT_EXCEEDED: 'Limite de requisições excedido.',
+    INTERNAL_ERROR: 'Erro interno do servidor.',
+    QUOTA_EXCEEDED: 'Cota excedida.',
+    SEC_VIRUS_DETECTED: 'Vírus detectado no arquivo.',
+    SEC_MALICIOUS_CONTENT: 'Conteúdo malicioso detectado.',
+    SEC_DANGEROUS_TYPE: 'Tipo de arquivo perigoso.',
+    FMT_MAGIC_MISMATCH: 'Conteúdo do arquivo incompatível.',
+    FMT_CORRUPTED: 'Arquivo corrompido.',
+    FMT_UNSUPPORTED: 'Formato de arquivo não suportado.',
+    SYS_STORAGE_ERROR: 'Erro de armazenamento.',
+    SYS_SERVICE_DOWN: 'Serviço indisponível.',
+    SYS_RATE_LIMIT: 'Limite de requisições excedido.',
+    // aliases em português vindos do backend
+    ARQUIVO_MUITO_GRANDE: 'Arquivo muito grande.',
+    TIPO_ARQUIVO_INVALIDO: 'Tipo de arquivo inválido.',
+    TIPO_MIDIA_NAO_SUPORTADO: 'Tipo de mídia não suportado.',
+    CAMPO_OBRIGATORIO_AUSENTE: 'Campo obrigatório ausente.',
+    OPCOES_JSON_INVALIDAS: 'JSON de opções inválido.',
+    ARGUMENTO_INVALIDO: 'Argumento inválido.',
+    NAO_AUTORIZADO: 'Autenticação necessária.',
+    ERRO_INTERNO: 'Erro interno do servidor.',
+    LIMITE_TAXA_EXCEDIDO: 'Limite de taxa excedido.',
+    COTA_EXCEDIDA: 'Cota excedida.',
+    ARQUIVO_JA_EXISTE: 'Arquivo já existe.',
+};
+class ErrorMapperService {
+    i18n;
+    customMessages;
+    legacyTranslate;
+    constructor(i18n, customMessages, legacyTranslate) {
+        this.i18n = i18n;
+        this.customMessages = customMessages;
+        this.legacyTranslate = legacyTranslate;
+    }
+    map(error, headers) {
+        const primary = getPrimaryErrorItem(error);
+        const code = String(primary?.code || 'UNKNOWN_ERROR');
+        const translatedMessage = resolvePraxisFilesUploadText(this.i18n, `errors.${code}`, '', undefined, this.legacyTranslate);
+        const defaultMessage = DEFAULT_MESSAGES[code] ??
+            primary?.message ??
+            (isErrorEnvelope(error) ? error.message : undefined) ??
+            'Erro desconhecido.';
+        const configuredMessage = this.customMessages?.[code];
+        const message = configuredMessage ??
+            (translatedMessage || defaultMessage);
+        // metadados do catálogo
+        const meta = getErrorMeta(code);
+        const mapped = {
+            message,
+            title: meta.title,
+            severity: meta.severity,
+            category: meta.category,
+            phase: meta.phase,
+            userAction: meta.userAction,
+        };
+        const isRateLimit = code === 'LIMITE_TAXA_EXCEDIDO' ||
+            code === 'RATE_LIMIT_EXCEEDED' ||
+            code === 'SYS_RATE_LIMIT';
+        if (isRateLimit) {
+            const limit = Number(headers?.get('X-RateLimit-Limit'));
+            const remaining = Number(headers?.get('X-RateLimit-Remaining'));
+            const resetEpochSeconds = Number(headers?.get('X-RateLimit-Reset'));
+            if (!Number.isNaN(limit) &&
+                !Number.isNaN(remaining) &&
+                !Number.isNaN(resetEpochSeconds)) {
+                mapped.rateLimit = { limit, remaining, resetEpochSeconds };
+            }
+        }
+        return mapped;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, deps: [{ token: i1$2.PraxisI18nService }, { token: FILES_UPLOAD_ERROR_MESSAGES, optional: true }, { token: TRANSLATE_LIKE, optional: true }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: ErrorMapperService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }], ctorParameters: () => [{ type: i1$2.PraxisI18nService }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [FILES_UPLOAD_ERROR_MESSAGES]
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
+                    type: Inject,
+                    args: [TRANSLATE_LIKE]
+                }] }] });
+
+let nextPraxisFilesUploadA11yId = 0;
 class PraxisFilesUpload {
     settingsPanel;
     dragProx;
-    defaultTexts;
     overlay;
     viewContainerRef;
     cdr;
     configStorage;
+    i18n;
+    legacyTexts;
+    legacyTranslate;
+    configService;
     api;
     presign;
     errors;
-    translate;
     config = null;
     _filesUploadId = '';
-    _uploadId = '';
     set filesUploadId(value) {
         this._filesUploadId = value ?? '';
-        if (!this._uploadId)
-            this._uploadId = this._filesUploadId;
     }
     get filesUploadId() {
         return this._filesUploadId;
     }
-    set uploadId(value) {
-        const v = value ?? '';
-        this._uploadId = v;
-        if (!this._filesUploadId)
-            this._filesUploadId = v;
-    }
-    get uploadId() {
-        return this._uploadId;
-    }
     componentInstanceId;
     baseUrl;
     displayMode = 'full';
@@ -2182,15 +2960,15 @@ class PraxisFilesUpload {
     rateLimited = new EventEmitter();
     uploadStart = new EventEmitter();
     uploadProgress = new EventEmitter();
-    uploadError = new EventEmitter();
     // Novos outputs Sub-issue 4
     retry = new EventEmitter();
     download = new EventEmitter();
     copyLink = new EventEmitter();
     detailsOpened = new EventEmitter();
     detailsClosed = new EventEmitter();
-    pendingFilesChange = new EventEmitter();
+    pendingStateChange = new EventEmitter();
     proximityChange = new EventEmitter();
+    readinessChange = new EventEmitter();
     fileInput;
     hostRef;
     overlayTmpl;
@@ -2217,6 +2995,8 @@ class PraxisFilesUpload {
     currentFiles = [];
     // Config efetiva do servidor para fallbacks
     serverEffective;
+    readinessState = 'idle';
+    readinessSource = 'local';
     // Proximidade/overlay
     showProximityOverlay = false;
     proxSub;
@@ -2241,19 +3021,31 @@ class PraxisFilesUpload {
     selectedOverlayRef;
     // Lista: colapso
     showAllResults = false;
-    constructor(settingsPanel, dragProx, defaultTexts, overlay, viewContainerRef, cdr, configStorage, api, presign, errors, translate) {
+    initialized = false;
+    generatedA11yId = `files-upload-${++nextPraxisFilesUploadA11yId}`;
+    constructor(settingsPanel, dragProx, overlay, viewContainerRef, cdr, configStorage, i18n, legacyTexts, legacyTranslate, configService, api, presign, errors) {
         this.settingsPanel = settingsPanel;
         this.dragProx = dragProx;
-        this.defaultTexts = defaultTexts;
         this.overlay = overlay;
         this.viewContainerRef = viewContainerRef;
         this.cdr = cdr;
         this.configStorage = configStorage;
+        this.i18n = i18n;
+        this.legacyTexts = legacyTexts;
+        this.legacyTranslate = legacyTranslate;
+        this.configService = configService;
         this.api = api;
         this.presign = presign;
         this.errors = errors;
-        this.translate = translate;
-        this.texts = defaultTexts;
+        this.texts = {
+            settingsAriaLabel: '',
+            dropzoneLabel: '',
+            dropzoneButton: '',
+            conflictPolicyLabel: '',
+            metadataLabel: '',
+            progressAriaLabel: '',
+            rateLimitBanner: '',
+        };
     }
     componentKeys = inject(ComponentKeyService);
     route = (() => { try {
@@ -2263,6 +3055,18 @@ class PraxisFilesUpload {
         return undefined;
     } })();
     warnedMissingId = false;
+    requireApiClient() {
+        if (!this.api) {
+            throw new Error('FilesApiClient is not available.');
+        }
+        return this.api;
+    }
+    requireBaseUrl() {
+        if (!this.baseUrl) {
+            throw new Error(this.t('baseUrlMissing', 'Base URL não configurada. Informe [baseUrl] para habilitar o envio.'));
+        }
+        return this.baseUrl;
+    }
     // Helpers de UI
     get showProgress() {
         return this.uploading;
@@ -2280,6 +3084,24 @@ class PraxisFilesUpload {
     get pendingCount() {
         return this.currentFiles.length;
     }
+    get a11yBaseId() {
+        return this.filesUploadId || this.componentInstanceId || this.generatedA11yId;
+    }
+    get messageRegionId() {
+        return `${this.a11yBaseId}-messages`;
+    }
+    get progressRegionId() {
+        return `${this.a11yBaseId}-progress`;
+    }
+    get conflictPolicyInputId() {
+        return `${this.a11yBaseId}-conflict-policy`;
+    }
+    get metadataInputId() {
+        return `${this.a11yBaseId}-metadata`;
+    }
+    get selectedOverlayTitleId() {
+        return `${this.a11yBaseId}-selected-title`;
+    }
     get hasLastResults() {
         return Array.isArray(this.lastResults) && this.lastResults.length > 0;
     }
@@ -2290,7 +3112,7 @@ class PraxisFilesUpload {
         }
     }
     // Expor método público para pais (wrapper) abrirem o seletor
-    triggerSelect() {
+    openFileDialog() {
         const el = this.fileInput?.nativeElement;
         if (el)
             this.openFile(el);
@@ -2301,9 +3123,15 @@ class PraxisFilesUpload {
     }
     formatBytes(bytes) {
         const b = typeof bytes === 'number' ? bytes : 0;
-        if (b < 1024)
-            return `${b} B`;
-        const units = ['KB', 'MB', 'GB', 'TB'];
+        if (b < 1024) {
+            return `${b} ${this.t('sizeUnitBytes', 'Bytes')}`;
+        }
+        const units = [
+            this.t('sizeUnitKB', 'KB'),
+            this.t('sizeUnitMB', 'MB'),
+            this.t('sizeUnitGB', 'GB'),
+            this.t('sizeUnitTB', 'TB'),
+        ];
         let v = b / 1024;
         let i = 0;
         while (v >= 1024 && i < units.length - 1) {
@@ -2336,6 +3164,8 @@ class PraxisFilesUpload {
         const key = this.storageKey();
         this.applyConfig(this.config ?? {});
         this.resolveTexts();
+        this.loadServerEffectiveConfig();
+        this.initialized = true;
         if (key) {
             this.configStorage.loadConfig(key).pipe(take(1)).subscribe((stored) => {
                 if (stored) {
@@ -2345,8 +3175,13 @@ class PraxisFilesUpload {
                 }
             });
         }
-        // Nota: carregamento da configuração efetiva do servidor foi desabilitado aqui
-        // para evitar dependência de HttpClient em testes. O fallback permanece opcional.
+    }
+    ngOnChanges() {
+        this.applyConfig(this.config ?? {});
+        this.resolveTexts();
+        if (this.initialized) {
+            this.loadServerEffectiveConfig();
+        }
     }
     ngAfterViewInit() {
         // Calcular retângulo do host
@@ -2553,24 +3388,38 @@ class PraxisFilesUpload {
         if (this.showProximityOverlay) {
             this.showProximityOverlay = false;
             this.manageOverlay();
+            this.proximityChange.emit(false);
         }
     }
     // Helpers de configuração e armazenamento
     resolveTexts() {
         this.texts = {
-            settingsAriaLabel: this.t('settingsAriaLabel', this.defaultTexts.settingsAriaLabel),
-            dropzoneLabel: this.t('dropzoneLabel', this.defaultTexts.dropzoneLabel),
-            dropzoneButton: this.t('dropzoneButton', this.defaultTexts.dropzoneButton),
-            conflictPolicyLabel: this.t('conflictPolicyLabel', this.defaultTexts.conflictPolicyLabel),
-            metadataLabel: this.t('metadataLabel', this.defaultTexts.metadataLabel),
-            progressAriaLabel: this.t('progressAriaLabel', this.defaultTexts.progressAriaLabel),
-            rateLimitBanner: this.t('rateLimitBanner', this.defaultTexts.rateLimitBanner),
+            settingsAriaLabel: this.t('settingsAriaLabel', 'Abrir configurações'),
+            dropzoneLabel: this.t('dropzoneLabel', 'Arraste arquivos ou'),
+            dropzoneButton: this.t('dropzoneButton', 'selecionar'),
+            conflictPolicyLabel: this.t('conflictPolicyLabel', 'Política de conflito'),
+            metadataLabel: this.t('metadataLabel', 'Metadados (JSON)'),
+            progressAriaLabel: this.t('progressAriaLabel', 'Progresso do upload'),
+            rateLimitBanner: this.t('rateLimitBanner', 'Limite de requisições excedido. Tente novamente às'),
         };
     }
     t(key, fallback) {
-        const k = `praxis.filesUpload.${key}`;
-        const v = this.translate?.instant(k);
-        return v && v !== k ? v : fallback;
+        return resolvePraxisFilesUploadText(this.i18n, key, fallback, this.legacyTexts, this.legacyTranslate);
+    }
+    get selectFilesAriaLabel() {
+        return this.t('selectFiles', 'Selecionar arquivo(s)');
+    }
+    get policySummaryAriaLabel() {
+        return this.t('policySummaryAction', 'Informacoes sobre politicas de upload');
+    }
+    pendingFileRemoveAriaLabel(file) {
+        return `${this.t('removePendingFile', 'Remover arquivo selecionado')}: ${file.name}`;
+    }
+    pendingFileMoreActionsAriaLabel(file) {
+        return `${this.t('moreActions', 'Mais ações')}: ${file.name}`;
+    }
+    resultActionAriaLabel(actionKey, fallback, fileName) {
+        return `${this.t(actionKey, fallback)}: ${fileName}`;
     }
     openSettings() {
         if (!this.editModeEnabled)
@@ -2601,11 +3450,42 @@ class PraxisFilesUpload {
     }
     applyConfig(cfg) {
         this.config = { ...cfg };
-        this.conflictPolicy.setValue((cfg.limits?.defaultConflictPolicy ?? 'RENAME'));
+        this.conflictPolicy.setValue((cfg.options?.defaultConflictPolicy ?? 'RENAME'));
         this.allowMultiple = (cfg.limits?.maxFilesPerBulk ?? 1) > 1;
         const acc = cfg.ui?.accept ?? [];
         this.acceptString = acc.includes('*') ? '' : acc.join(',');
     }
+    loadServerEffectiveConfig() {
+        if (!this.configService || !this.baseUrl) {
+            this.setReadinessState('ready', 'local');
+            return;
+        }
+        this.setReadinessState('loading', 'server');
+        this.configService
+            .getEffectiveConfig(this.baseUrl)
+            .pipe(take(1))
+            .subscribe({
+            next: (cfg) => {
+                this.serverEffective = cfg;
+                this.setReadinessState('ready', 'server');
+            },
+            error: () => {
+                // Fallback local segue válido quando a consulta de config falha.
+                this.setReadinessState('ready', 'fallback');
+            },
+        });
+    }
+    setReadinessState(state, source) {
+        this.readinessState = state;
+        this.readinessSource = source;
+        this.readinessChange.emit({
+            state,
+            source,
+            filesUploadId: this.filesUploadId || undefined,
+            baseUrl: this.baseUrl,
+        });
+        this.cdr.markForCheck();
+    }
     storageKey() {
         const id = this.componentKeyId();
         return id ? `files-upload-config:${id}` : null;
@@ -2627,7 +3507,7 @@ class PraxisFilesUpload {
         if (this.warnedMissingId)
             return;
         this.warnedMissingId = true;
-        console.warn('[PraxisFilesUpload] filesUploadId ou uploadId sao necessarios para persistencia de configuracao.');
+        console.warn('[PraxisFilesUpload] filesUploadId e necessario para persistencia de configuracao.');
     }
     onDragOver(evt) {
         evt.preventDefault();
@@ -2645,7 +3525,7 @@ class PraxisFilesUpload {
             if (this.config?.ui?.manualUpload) {
                 this.currentFiles = files;
                 this.manageSelectedOverlay();
-                this.pendingFilesChange.emit(this.currentFiles);
+                this.emitPendingState();
             }
             else {
                 this.startUpload(files);
@@ -2659,7 +3539,7 @@ class PraxisFilesUpload {
             if (this.config?.ui?.manualUpload) {
                 this.currentFiles = files;
                 this.manageSelectedOverlay();
-                this.pendingFilesChange.emit(this.currentFiles);
+                this.emitPendingState();
             }
             else {
                 this.startUpload(files);
@@ -2667,24 +3547,32 @@ class PraxisFilesUpload {
             input.value = '';
         }
     }
-    triggerUpload() {
+    submitPendingFiles() {
         if (this.currentFiles.length) {
             this.hideSelectedOverlay();
             this.startUpload(this.currentFiles);
         }
     }
-    clearSelection() {
+    resetPendingFiles() {
         this.currentFiles = [];
-        this.pendingFilesChange.emit(this.currentFiles);
+        this.emitPendingState();
         this.errorMessage = '';
         this.hideSelectedOverlay();
     }
     // Remoção individual dentro do overlay de seleção
     removePendingFile(file) {
         this.currentFiles = this.currentFiles.filter((f) => f !== file);
-        this.pendingFilesChange.emit(this.currentFiles);
+        this.emitPendingState();
         this.manageSelectedOverlay();
     }
+    emitPendingState() {
+        const files = [...this.currentFiles];
+        this.pendingStateChange.emit({
+            files,
+            count: files.length,
+            hasPending: files.length > 0,
+        });
+    }
     startUpload(files) {
         if (!this.baseUrl ||
             (this.quotaExceeded && this.config?.quotas?.blockOnExceed)) {
@@ -2727,36 +3615,11 @@ class PraxisFilesUpload {
             files,
             mode: files.length > 1 && this.allowMultiple ? 'bulk' : 'single',
             strategy,
-            uploadId: this.uploadId || this.filesUploadId,
+            filesUploadId: this.filesUploadId || undefined,
             baseUrl: this.baseUrl,
         });
         if (files.length > 1 && this.allowMultiple) {
-            const policy = this.conflictPolicy.value || 'RENAME';
-            const bulkFiles = files.map((f) => ({
-                file: f,
-                metadata: metadataObj,
-                conflictPolicy: policy,
-            }));
-            this.api.bulkUpload(this.baseUrl, bulkFiles, {
-                optionsJson,
-                failFastMode: this.config?.limits?.failFast,
-                retryCount: this.config?.bulk?.retryCount,
-            }).subscribe({
-                next: (event) => {
-                    if (event.type === HttpEventType.Response) {
-                        const resp = event.body;
-                        this.bulkComplete.emit(resp);
-                        // Preenche estados ricos
-                        this.lastResults = resp?.results ?? null;
-                        this.lastStats = resp?.stats ?? null;
-                        this.finishUpload(true, undefined, resp.results);
-                    }
-                    else {
-                        this.handleProgress(event);
-                    }
-                },
-                error: (err) => this.handleError(err),
-            });
+            this.uploadMultipleFiles(files, strategy, metadataObj, optionsJson);
         }
         else if (strategy === 'presign' || strategy === 'auto') {
             const file = files[0];
@@ -2768,20 +3631,29 @@ class PraxisFilesUpload {
                 });
                 return;
             }
-            this.api.presign(this.baseUrl, file.name).subscribe({
+            const api = this.requireApiClient();
+            const baseUrl = this.requireBaseUrl();
+            api.presign(baseUrl, file.name).subscribe({
                 next: (target) => {
-                    this.presign.upload(target, file, this.config?.bulk?.retryCount ?? 0).subscribe({
+                    const uploadOptions = {
+                        optionsJson,
+                        metadata: metadataObj,
+                        conflictPolicy: this.conflictPolicy.value || 'RENAME',
+                    };
+                    this.presign.upload(target, file, uploadOptions, this.config?.bulk?.retryCount ?? 0).subscribe({
                         next: (event) => {
                             if (event.type === HttpEventType.Response) {
-                                this.finishUpload(true, {
-                                    id: '',
-                                    fileName: file.name,
-                                    contentType: file.type,
-                                    fileSize: file.size,
-                                    uploadedAt: new Date().toISOString(),
-                                    tenantId: '',
-                                    scanStatus: ScanStatus.PENDING,
-                                });
+                                const responseEvent = event;
+                                const response = responseEvent.body instanceof HttpResponse
+                                    ? responseEvent.body.body
+                                    : responseEvent.body;
+                                const meta = this.mapUploadResponseToFileMetadata(response);
+                                if (meta?.id) {
+                                    this.finishUpload(true, meta);
+                                }
+                                else {
+                                    this.handleError(new Error('Presigned upload completed without file metadata.'));
+                                }
                             }
                             else {
                                 this.handleProgress(event);
@@ -2824,11 +3696,77 @@ class PraxisFilesUpload {
         }
     }
     directUpload(file, options) {
-        this.api.upload(this.baseUrl, file, options).subscribe({
+        const api = this.requireApiClient();
+        const baseUrl = this.requireBaseUrl();
+        api.upload(baseUrl, file, options).subscribe({
             next: (event) => {
                 if (event.type === HttpEventType.Response) {
                     const resp = event.body;
-                    this.finishUpload(true, resp.file);
+                    const meta = this.mapUploadResponseToFileMetadata(resp);
+                    this.finishUpload(true, meta);
+                }
+                else {
+                    this.handleProgress(event);
+                }
+            },
+            error: (err) => this.handleError(err),
+        });
+    }
+    uploadMultipleFiles(files, strategy, metadataObj, optionsJson) {
+        if (strategy === 'direct') {
+            this.uploadMultipleFilesDirect(files, optionsJson, metadataObj);
+            return;
+        }
+        from(files)
+            .pipe(concatMap((file) => this.uploadSingleFileByStrategy(file, strategy, metadataObj, optionsJson)), toArray())
+            .subscribe({
+            next: (results) => {
+                const responseData = this.buildBulkResponseData(results);
+                this.bulkComplete.emit(responseData);
+                this.lastResults = results.length ? results : null;
+                this.lastStats = {
+                    total: responseData.totalProcessed,
+                    succeeded: responseData.totalSuccess,
+                    failed: responseData.totalFailed,
+                };
+                if (responseData.totalSuccess === 0 && responseData.totalFailed > 0) {
+                    const firstError = results.find((result) => result.error)?.error;
+                    const mappedError = firstError ? this.mapErrorFull(firstError) : null;
+                    this.errorMessage =
+                        mappedError?.message ||
+                            this.t('genericUploadError', 'Erro no envio de arquivo.');
+                }
+                this.finishUpload(true, undefined, results);
+            },
+        });
+    }
+    uploadMultipleFilesDirect(files, optionsJson, metadataObj) {
+        const api = this.requireApiClient();
+        const baseUrl = this.requireBaseUrl();
+        const policy = this.conflictPolicy.value || 'RENAME';
+        const bulkFiles = files.map((f) => ({
+            file: f,
+            metadata: metadataObj,
+            conflictPolicy: policy,
+        }));
+        api.bulkUpload(baseUrl, bulkFiles, {
+            optionsJson,
+            failFast: this.config?.bulk?.failFast,
+            retryCount: this.config?.bulk?.retryCount,
+        }).subscribe({
+            next: (event) => {
+                if (event.type === HttpEventType.Response) {
+                    const responseData = event.body.data;
+                    this.bulkComplete.emit(responseData);
+                    const results = responseData.results;
+                    const stats = {
+                        total: responseData.totalProcessed,
+                        succeeded: responseData.totalSuccess,
+                        failed: responseData.totalFailed,
+                    };
+                    this.lastResults = results.length ? results : null;
+                    this.lastStats = stats;
+                    this.finishUpload(true, undefined, results);
                 }
                 else {
                     this.handleProgress(event);
@@ -2837,17 +3775,132 @@ class PraxisFilesUpload {
             error: (err) => this.handleError(err),
         });
     }
+    uploadSingleFileByStrategy(file, strategy, metadataObj, optionsJson) {
+        if (!this.presign) {
+            return this.uploadSingleFileDirectResult(file, metadataObj, optionsJson);
+        }
+        const api = this.requireApiClient();
+        const baseUrl = this.requireBaseUrl();
+        const uploadOptions = {
+            optionsJson,
+            metadata: metadataObj,
+            conflictPolicy: this.conflictPolicy.value || 'RENAME',
+            retryCount: this.config?.bulk?.retryCount,
+        };
+        return api
+            .presign(baseUrl, file.name)
+            .pipe(concatMap((target) => this.presign.upload(target, file, uploadOptions, this.config?.bulk?.retryCount ?? 0)), tap((event) => {
+            if (event.type !== HttpEventType.Response) {
+                this.handleProgress(event);
+            }
+        }), filter((event) => event.type === HttpEventType.Response), take(1), map((event) => {
+            const responseEvent = event;
+            const meta = this.mapUploadResponseToFileMetadata(responseEvent.body instanceof HttpResponse
+                ? responseEvent.body.body
+                : responseEvent.body);
+            if (!meta?.id) {
+                return this.buildBulkFailureResult(file, this.createOperationalError('PRESIGN_METADATA_MISSING', this.t('presignMetadataMissing', 'Upload assinado concluído sem metadados do arquivo.')));
+            }
+            return this.buildBulkSuccessResult(file, meta);
+        }), catchError((err) => {
+            if (strategy === 'auto') {
+                return this.uploadSingleFileDirectResult(file, metadataObj, optionsJson);
+            }
+            return of(this.buildBulkFailureResult(file, this.normalizeBulkError(err)));
+        }), defaultIfEmpty(this.buildBulkFailureResult(file, this.createOperationalError('UPLOAD_RESPONSE_MISSING', this.t('genericUploadError', 'Erro no envio de arquivo.')))));
+    }
+    uploadSingleFileDirectResult(file, metadataObj, optionsJson) {
+        const api = this.requireApiClient();
+        const baseUrl = this.requireBaseUrl();
+        return api
+            .upload(baseUrl, file, {
+            optionsJson,
+            retryCount: this.config?.bulk?.retryCount,
+            metadata: metadataObj,
+            conflictPolicy: this.conflictPolicy.value || 'RENAME',
+        })
+            .pipe(tap((event) => {
+            if (event.type !== HttpEventType.Response) {
+                this.handleProgress(event);
+            }
+        }), filter((event) => event.type === HttpEventType.Response), take(1), map((event) => {
+            const responseEvent = event;
+            const meta = this.mapUploadResponseToFileMetadata(responseEvent.body);
+            if (!meta?.id) {
+                return this.buildBulkFailureResult(file, this.createOperationalError('UPLOAD_RESPONSE_MISSING', this.t('genericUploadError', 'Erro no envio de arquivo.')));
+            }
+            return this.buildBulkSuccessResult(file, meta);
+        }), catchError((err) => of(this.buildBulkFailureResult(file, this.normalizeBulkError(err)))), defaultIfEmpty(this.buildBulkFailureResult(file, this.createOperationalError('UPLOAD_RESPONSE_MISSING', this.t('genericUploadError', 'Erro no envio de arquivo.')))));
+    }
+    buildBulkResponseData(results) {
+        const totalSuccess = results.filter((result) => result.status === BulkUploadResultStatus.SUCCESS).length;
+        const totalFailed = results.length - totalSuccess;
+        return {
+            totalProcessed: results.length,
+            totalSuccess,
+            totalFailed,
+            overallSuccess: totalFailed === 0,
+            results,
+        };
+    }
+    buildBulkSuccessResult(file, meta) {
+        return {
+            fileName: file.name,
+            status: BulkUploadResultStatus.SUCCESS,
+            file: meta,
+        };
+    }
+    buildBulkFailureResult(file, error) {
+        return {
+            fileName: file.name,
+            status: BulkUploadResultStatus.FAILED,
+            error,
+        };
+    }
+    normalizeBulkError(err) {
+        if (err instanceof HttpErrorResponse && err.error) {
+            return err.error;
+        }
+        return this.createOperationalError('UPLOAD_OPERATION_FAILED', this.t('genericUploadError', 'Erro no envio de arquivo.'), err);
+    }
+    createOperationalError(code, message, details) {
+        return {
+            code,
+            message,
+            details,
+        };
+    }
+    normalizeErrorEnvelope(err) {
+        if (err &&
+            typeof err === 'object' &&
+            'status' in err &&
+            'message' in err &&
+            'errors' in err) {
+            return err;
+        }
+        const message = err instanceof Error && err.message
+            ? err.message
+            : this.t('genericUploadError', 'Erro no envio de arquivo.');
+        return {
+            status: 'failure',
+            message,
+            errors: [
+                this.createOperationalError('UPLOAD_OPERATION_FAILED', message, err),
+            ],
+            timestamp: new Date().toISOString(),
+        };
+    }
     buildOptionsJson(customMeta) {
         const effective = this.serverEffective?.options;
         const nameConflictPolicy = this.conflictPolicy.value ||
-            this.config?.limits?.defaultConflictPolicy ||
+            this.config?.options?.defaultConflictPolicy ||
             effective?.nameConflictPolicy ||
             'RENAME';
         const limits = this.config?.limits ?? {};
         const advanced = this.config?.options ?? {};
         // Garantir maxUploadSizeMb positivo usando fallback do servidor ou default 50
-        const maxUploadSizeMb = typeof limits.maxUploadSizeMb === 'number'
-            ? limits.maxUploadSizeMb
+        const maxUploadSizeMb = typeof advanced.maxUploadSizeMb === 'number'
+            ? advanced.maxUploadSizeMb
             : typeof effective?.maxUploadSizeMb === 'number'
                 ? effective?.maxUploadSizeMb
                 : 50;
@@ -2856,8 +3909,8 @@ class PraxisFilesUpload {
             options.maxUploadSizeMb = maxUploadSizeMb;
         }
         // strictValidation: fallback para server
-        if (typeof limits.strictValidation === 'boolean') {
-            options.strictValidation = limits.strictValidation;
+        if (typeof advanced.strictValidation === 'boolean') {
+            options.strictValidation = advanced.strictValidation;
         }
         else if (typeof effective?.strictValidation === 'boolean') {
             options.strictValidation = effective.strictValidation;
@@ -2926,8 +3979,8 @@ class PraxisFilesUpload {
             this.currentFiles = [];
         }
         if (err instanceof HttpErrorResponse && err.error) {
-            const mapped = this.errors?.map(err.error, err.headers) ||
-                err.error;
+            const errorPayload = err.error;
+            const mapped = this.errors?.map(errorPayload, err.headers) || err.error;
             this.errorMessage =
                 mapped.message ||
                     this.t('genericUploadError', 'Erro no envio de arquivo.');
@@ -2935,17 +3988,17 @@ class PraxisFilesUpload {
                 this.rateLimit = mapped.rateLimit;
                 this.rateLimited.emit(mapped.rateLimit);
             }
-            const code = String(err.error.code || '');
+            const primary = getPrimaryErrorItem(errorPayload);
+            const code = String(primary?.code || '');
             if (code === 'QUOTA_EXCEEDED' || code === 'COTA_EXCEDIDA') {
                 this.quotaExceeded = true;
             }
-            this.error.emit(err.error);
-            this.uploadError.emit(err.error);
+            this.error.emit(errorPayload);
         }
         else {
-            this.errorMessage = this.t('genericUploadError', 'Erro no envio de arquivo.');
-            this.error.emit(err);
-            this.uploadError.emit(err);
+            const normalizedError = this.normalizeErrorEnvelope(err);
+            this.errorMessage = normalizedError.message;
+            this.error.emit(normalizedError);
         }
     }
     finishUpload(success, meta, results) {
@@ -2954,8 +4007,7 @@ class PraxisFilesUpload {
         if (success) {
             if (meta) {
                 this.uploadedFiles.push({ fileName: meta.fileName, success: true });
-                this.uploadSuccess.emit({ file: meta });
-                // Opcional: preencher lista rica também para single
+                this.uploadSuccess.emit(meta);
                 this.lastResults = [
                     {
                         fileName: meta.fileName,
@@ -2966,7 +4018,6 @@ class PraxisFilesUpload {
                 this.lastStats = { total: 1, succeeded: 1, failed: 0 };
             }
             if (results) {
-                // Mantém lista simples para compatibilidade
                 for (const r of results) {
                     if (r.status === BulkUploadResultStatus.SUCCESS) {
                         this.uploadedFiles.push({ fileName: r.fileName, success: true });
@@ -2975,7 +4026,6 @@ class PraxisFilesUpload {
                         this.uploadedFiles.push({ fileName: r.fileName, success: false });
                     }
                 }
-                // Se stats não vieram do servidor, calcula minimamente
                 if (!this.lastStats) {
                     const succeeded = results.filter((r) => r.status === BulkUploadResultStatus.SUCCESS).length;
                     const failed = results.length - succeeded;
@@ -2996,6 +4046,31 @@ class PraxisFilesUpload {
         this.hideSelectedOverlay();
         this.cdr.markForCheck();
     }
+    mapUploadResponseToFileMetadata(resp) {
+        const payload = resp?.data;
+        if (!payload) {
+            return undefined;
+        }
+        return {
+            id: payload.fileId || '',
+            fileName: payload.originalFilename,
+            contentType: payload.mimeType || '',
+            fileSize: payload.fileSize,
+            uploadedAt: payload.uploadTimestamp,
+            tenantId: '',
+            scanStatus: ScanStatus.PENDING,
+        };
+    }
+    primaryErrorCode(error) {
+        return getPrimaryErrorItem(error)?.code ?? 'UNKNOWN_ERROR';
+    }
+    traceIdOf(error) {
+        if (!error || typeof error !== 'object' || !('traceId' in error)) {
+            return undefined;
+        }
+        const traceId = error.traceId;
+        return typeof traceId === 'string' ? traceId : undefined;
+    }
     // Lista rica - helpers/ações
     get visibleResults() {
         if (!this.lastResults)
@@ -3104,7 +4179,6 @@ class PraxisFilesUpload {
                         this.t('maxBulkSizeError', 'Tamanho total dos arquivos excedido.');
             }
             this.error.emit(errors);
-            this.uploadError.emit(errors);
             return false;
         }
         return true;
@@ -3113,12 +4187,12 @@ class PraxisFilesUpload {
     get policiesSummary() {
         const acc = this.config?.ui?.accept?.length
             ? this.config.ui.accept.join(', ')
-            : this.acceptString || 'qualquer';
+            : this.acceptString || this.t('policySummaryAny', 'qualquer');
         const maxFile = this.config?.limits?.maxFileSizeBytes
             ? this.formatBytes(this.config.limits.maxFileSizeBytes)
-            : '—';
+            : this.t('policySummaryNotConfigured', '—');
         const maxCount = this.config?.limits?.maxFilesPerBulk ?? (this.allowMultiple ? 99 : 1);
-        return `Tipos: ${acc} • Máx. por arquivo: ${maxFile} • Qtde: ${maxCount}`;
+        return `${this.t('policySummaryTypesLabel', 'Tipos')}: ${acc} • ${this.t('policySummaryMaxPerFileLabel', 'Máx. por arquivo')}: ${maxFile} • ${this.t('policySummaryQuantityLabel', 'Qtde')}: ${maxCount}`;
     }
     resolveTemplateString(value) {
         if (!this.context || !value.includes('${'))
@@ -3137,29 +4211,37 @@ class PraxisFilesUpload {
             return acc[key];
         }, context);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisFilesUpload, deps: [{ token: i1$2.SettingsPanelService }, { token: DragProximityService }, { token: FILES_UPLOAD_TEXTS }, { token: i3.Overlay }, { token: i0.ViewContainerRef }, { token: i0.ChangeDetectorRef }, { token: ASYNC_CONFIG_STORAGE }, { token: FilesApiClient, optional: true }, { token: PresignedUploaderService, optional: true }, { token: ErrorMapperService, optional: true }, { token: TRANSLATE_LIKE, optional: true }], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PraxisFilesUpload, isStandalone: true, selector: "praxis-files-upload", inputs: { config: "config", filesUploadId: "filesUploadId", uploadId: "uploadId", componentInstanceId: "componentInstanceId", baseUrl: "baseUrl", displayMode: "displayMode", context: "context", editModeEnabled: "editModeEnabled" }, outputs: { uploadSuccess: "uploadSuccess", bulkComplete: "bulkComplete", error: "error", rateLimited: "rateLimited", uploadStart: "uploadStart", uploadProgress: "uploadProgress", uploadError: "uploadError", retry: "retry", download: "download", copyLink: "copyLink", detailsOpened: "detailsOpened", detailsClosed: "detailsClosed", pendingFilesChange: "pendingFilesChange", proximityChange: "proximityChange" }, viewQueries: [{ propertyName: "fileInput", first: true, predicate: ["fileInput"], descendants: true }, { propertyName: "hostRef", first: true, predicate: ["host"], descendants: true, static: true }, { propertyName: "overlayTmpl", first: true, predicate: ["proximityOverlayTmpl"], descendants: true }, { propertyName: "selectedOverlayTmpl", first: true, predicate: ["selectedOverlayTmpl"], descendants: true }], ngImport: i0, template: `
-    <div class="praxis-files-upload" [class.dense]="config?.ui?.dense" #host>
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisFilesUpload, deps: [{ token: i1$3.SettingsPanelService }, { token: DragProximityService }, { token: i3.Overlay }, { token: i0.ViewContainerRef }, { token: i0.ChangeDetectorRef }, { token: ASYNC_CONFIG_STORAGE }, { token: i1$2.PraxisI18nService }, { token: FILES_UPLOAD_TEXTS, optional: true }, { token: TRANSLATE_LIKE, optional: true }, { token: ConfigService, optional: true }, { token: FilesApiClient, optional: true }, { token: PresignedUploaderService, optional: true }, { token: ErrorMapperService, optional: true }], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PraxisFilesUpload, isStandalone: true, selector: "praxis-files-upload", inputs: { config: "config", filesUploadId: "filesUploadId", componentInstanceId: "componentInstanceId", baseUrl: "baseUrl", displayMode: "displayMode", context: "context", editModeEnabled: "editModeEnabled" }, outputs: { uploadSuccess: "uploadSuccess", bulkComplete: "bulkComplete", error: "error", rateLimited: "rateLimited", uploadStart: "uploadStart", uploadProgress: "uploadProgress", retry: "retry", download: "download", copyLink: "copyLink", detailsOpened: "detailsOpened", detailsClosed: "detailsClosed", pendingStateChange: "pendingStateChange", proximityChange: "proximityChange", readinessChange: "readinessChange" }, providers: [providePraxisFilesUploadI18n()], viewQueries: [{ propertyName: "fileInput", first: true, predicate: ["fileInput"], descendants: true }, { propertyName: "hostRef", first: true, predicate: ["host"], descendants: true, static: true }, { propertyName: "overlayTmpl", first: true, predicate: ["proximityOverlayTmpl"], descendants: true }, { propertyName: "selectedOverlayTmpl", first: true, predicate: ["selectedOverlayTmpl"], descendants: true }], usesOnChanges: true, ngImport: i0, template: `
+    <div
+      class="praxis-files-upload"
+      [class.dense]="config?.ui?.dense"
+      [attr.data-files-upload-id]="a11yBaseId"
+      [attr.data-ready-state]="readinessState"
+      [attr.data-ready-source]="readinessSource"
+      [attr.aria-busy]="readinessState === 'loading' ? 'true' : 'false'"
+      #host
+    >
       <!-- Proximity overlay inline (fallback quando expandMode === 'inline') -->
-      <div
-        class="proximity-overlay"
+        <div
+          class="proximity-overlay"
         *ngIf="
           showProximityOverlay &&
           (config?.ui?.dropzone?.expandMode ?? 'overlay') === 'inline'
         "
         [style.height.px]="config?.ui?.dropzone?.expandHeight ?? 200"
         aria-hidden="true"
-      >
-        <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
-        <p class="dz-title">{{ texts.dropzoneLabel }}</p>
-        <p class="dz-hint">Solte aqui para enviar</p>
-      </div>
+        >
+          <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
+          <p class="dz-title">{{ texts.dropzoneLabel }}</p>
+          <p class="dz-hint">{{ t('dropzoneProximityHint', 'Solte aqui para enviar') }}</p>
+        </div>
       <!-- Template do overlay de proximidade (renderizado via CDK Overlay) -->
       <ng-template #proximityOverlayTmpl>
         <div class="proximity-overlay" aria-hidden="true">
           <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
           <p class="dz-title">{{ texts.dropzoneLabel }}</p>
-          <p class="dz-hint">Solte aqui para enviar</p>
+          <p class="dz-hint">{{ t('dropzoneProximityHint', 'Solte aqui para enviar') }}</p>
         </div>
       </ng-template>
 
@@ -3168,22 +4250,22 @@ class PraxisFilesUpload {
         <ng-template #selectedOverlayTmpl>
           <div
             class="selected-overlay"
-            role="dialog"
-            aria-label="Arquivos selecionados"
+            role="region"
+            [attr.aria-labelledby]="selectedOverlayTitleId"
           >
             <header class="sel-header">
-              <span class="title">Selecionados ({{ pendingCount }})</span>
+              <span class="title" [id]="selectedOverlayTitleId">{{ t('selectedOverlayTitle', 'Selecionados') }} ({{ pendingCount }})</span>
               <span class="spacer"></span>
               <button
                 mat-stroked-button
                 color="primary"
-                (click)="triggerUpload()"
+                (click)="submitPendingFiles()"
                 [disabled]="!baseUrl || isUploading"
               >
-                Enviar
+                {{ t('fieldActionUploadShort', 'Enviar') }}
               </button>
-              <button mat-button type="button" (click)="clearSelection()">
-                Cancelar
+              <button mat-button type="button" (click)="resetPendingFiles()">
+                {{ t('fieldActionCancelShort', 'Cancelar') }}
               </button>
             </header>
             <ul class="sel-list">
@@ -3204,7 +4286,7 @@ class PraxisFilesUpload {
                   class="remove-btn"
                   [matTooltip]="t('remove', 'Remover')"
                   (click)="removePendingFile(f)"
-                  [attr.aria-label]="t('remove', 'Remover')"
+                  [attr.aria-label]="pendingFileRemoveAriaLabel(f)"
                 >
                   <mat-icon [praxisIcon]="'close'"></mat-icon>
                 </button>
@@ -3215,7 +4297,7 @@ class PraxisFilesUpload {
                   [matMenuTriggerData]="{ file: f }"
                   aria-haspopup="menu"
                   [matTooltip]="t('moreActions', 'Mais ações')"
-                  [attr.aria-label]="t('moreActions', 'Mais ações')"
+                  [attr.aria-label]="pendingFileMoreActionsAriaLabel(f)"
                 >
                   <mat-icon [praxisIcon]="'more_horiz'"></mat-icon>
                 </button>
@@ -3256,6 +4338,9 @@ class PraxisFilesUpload {
       <div
         class="rate-limit-banner"
         *ngIf="rateLimit && config?.rateLimit?.showBannerOn429 !== false"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
       >
         {{ texts.rateLimitBanner }}
         {{ rateLimit.resetEpochSeconds * 1000 | date: 'shortTime' }}.
@@ -3263,32 +4348,34 @@ class PraxisFilesUpload {
       <div
         class="quota-banner"
         *ngIf="quotaExceeded && config?.quotas?.showQuotaWarnings !== false"
+        [id]="messageRegionId"
+        role="status"
+        aria-live="polite"
       >
         {{ errorMessage }}
       </div>
-      <div class="error" *ngIf="errorMessage && !quotaExceeded">
+      <div
+        class="error"
+        *ngIf="errorMessage && !quotaExceeded"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
+      >
         {{ errorMessage }}
       </div>
-      <div class="error" *ngIf="!baseUrl">
-        Base URL não configurada. Informe [baseUrl] para habilitar o envio.
+      <div
+        class="error"
+        *ngIf="!baseUrl"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
+      >
+        {{ t('baseUrlMissing', 'Base URL not configured. Provide [baseUrl] to enable uploads.') }}
       </div>
       <div
         class="dropzone"
         *ngIf="config?.ui?.showDropzone !== false"
-        [attr.role]="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : 'button'
-        "
-        [attr.tabindex]="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? -1
-            : 0
-        "
+        role="group"
         [class.dragover]="isDragging"
         [class.disabled]="
           !baseUrl ||
@@ -3302,39 +4389,18 @@ class PraxisFilesUpload {
             ? 'true'
             : 'false'
         "
-        [attr.aria-label]="texts.dropzoneLabel + ' ' + texts.dropzoneButton"
-        (click)="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
+        [attr.aria-label]="texts.dropzoneLabel"
+        [attr.aria-describedby]="messageRegionId"
         (drop)="onDrop($event)"
         (dragover)="onDragOver($event)"
         (dragleave)="onDragLeave($event)"
-        (keydown.enter)="
-          $event.preventDefault();
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
-        (keydown.space)="
-          $event.preventDefault();
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
       >
         <!-- Ações internas (ícones) -->
         <div class="field-actions" aria-hidden="false">
           <button
             mat-icon-button
-            [matTooltip]="'Selecionar arquivo(s)'"
+            [matTooltip]="t('selectFiles', 'Select file(s)')"
+            [attr.aria-label]="selectFilesAriaLabel"
             (click)="$event.stopPropagation(); openFile(fileInput)"
             [disabled]="!baseUrl || isUploading"
           >
@@ -3343,6 +4409,7 @@ class PraxisFilesUpload {
           <button
             mat-icon-button
             [matTooltip]="policiesSummary"
+            [attr.aria-label]="policySummaryAriaLabel"
             (click)="$event.stopPropagation()"
             [disabled]="false"
           >
@@ -3353,9 +4420,15 @@ class PraxisFilesUpload {
         <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
         <p class="dz-title">{{ texts.dropzoneLabel }}</p>
         <p class="dz-hint">
-          Arraste e solte arquivos aqui ou clique para selecionar
+          {{ t('dropzoneHint', 'Arraste e solte arquivos aqui ou clique para selecionar') }}
         </p>
-        <button type="button" mat-stroked-button (click)="openFile(fileInput)">
+        <button
+          type="button"
+          mat-stroked-button
+          [disabled]="!baseUrl || isUploading"
+          [attr.aria-describedby]="messageRegionId"
+          (click)="openFile(fileInput)"
+        >
           {{ texts.dropzoneButton }}
         </button>
       </div>
@@ -3375,8 +4448,8 @@ class PraxisFilesUpload {
         class="conflict-policy"
         *ngIf="config?.ui?.showConflictPolicySelector"
       >
-        <label for="conflictPolicy">{{ texts.conflictPolicyLabel }}</label>
-        <select id="conflictPolicy" [formControl]="conflictPolicy">
+        <label [for]="conflictPolicyInputId">{{ texts.conflictPolicyLabel }}</label>
+        <select [id]="conflictPolicyInputId" [formControl]="conflictPolicy">
           <option *ngFor="let p of conflictPolicies" [value]="p">
             {{ p }}
           </option>
@@ -3384,18 +4457,27 @@ class PraxisFilesUpload {
       </div>
 
       <div class="metadata" *ngIf="config?.ui?.showMetadataForm">
-        <label for="metadata">{{ texts.metadataLabel }}</label>
-        <textarea id="metadata" [formControl]="metadata"></textarea>
+        <label [for]="metadataInputId">{{ texts.metadataLabel }}</label>
+        <textarea [id]="metadataInputId" [formControl]="metadata"></textarea>
         <div class="error" *ngIf="metadataError">{{ metadataError }}</div>
       </div>
 
-      <div class="progress" *ngIf="showProgress">
+      <div
+        class="progress"
+        *ngIf="showProgress"
+        [id]="progressRegionId"
+        role="status"
+        aria-live="polite"
+      >
         <mat-progress-bar
           mode="determinate"
           [value]="uploadProgressValue"
           [attr.aria-label]="texts.progressAriaLabel"
+          [attr.aria-valuemin]="0"
+          [attr.aria-valuemax]="100"
+          [attr.aria-valuenow]="uploadProgressValue"
         ></mat-progress-bar>
-        <span class="sr-only">{{ uploadProgressValue }}%</span>
+        <span class="sr-only">{{ texts.progressAriaLabel }} {{ uploadProgressValue }}%</span>
       </div>
 
       <ul class="file-feedback" *ngIf="hasUploadedFiles">
@@ -3410,17 +4492,17 @@ class PraxisFilesUpload {
       <section class="bulk-results" *ngIf="hasLastResults">
         <header class="bulk-summary" *ngIf="lastStats">
           <div class="stat">
-            <span class="label">Total</span>
+            <span class="label">{{ t('bulkSummaryTotal', 'Total') }}</span>
             <span class="value">{{ lastStats.total }}</span>
           </div>
           <div class="stat success">
             <mat-icon [praxisIcon]="'check_circle'"></mat-icon>
-            <span class="label">Sucesso</span>
+            <span class="label">{{ t('bulkSummarySuccess', 'Sucesso') }}</span>
             <span class="value">{{ lastStats.succeeded }}</span>
           </div>
           <div class="stat failed">
             <mat-icon [praxisIcon]="'error'"></mat-icon>
-            <span class="label">Falhas</span>
+            <span class="label">{{ t('bulkSummaryFailed', 'Falhas') }}</span>
             <span class="value">{{ lastStats.failed }}</span>
           </div>
         </header>
@@ -3451,19 +4533,24 @@ class PraxisFilesUpload {
                 >
               </div>
               <div class="meta" *ngIf="r.file">
-                <span *ngIf="r.file.id">ID: {{ r.file.id }}</span>
+                <span *ngIf="r.file.id"
+                  >{{ t('resultMetaIdLabel', 'ID') }}: {{ r.file.id }}</span
+                >
                 <span *ngIf="r.file.contentType"
-                  >Tipo: {{ r.file.contentType }}</span
+                  >{{ t('resultMetaTypeLabel', 'Tipo') }}:
+                  {{ r.file.contentType }}</span
                 >
                 <span *ngIf="r.file.fileSize"
-                  >Tamanho: {{ formatBytes(r.file.fileSize) }}</span
+                  >{{ t('resultMetaSizeLabel', 'Tamanho') }}:
+                  {{ formatBytes(r.file.fileSize) }}</span
                 >
                 <span *ngIf="r.file.uploadedAt"
-                  >Enviado em: {{ r.file.uploadedAt | date: 'short' }}</span
+                  >{{ t('resultMetaUploadedAtLabel', 'Enviado em') }}:
+                  {{ r.file.uploadedAt | date: 'short' }}</span
                 >
               </div>
               <div class="error" *ngIf="r.error as e">
-                <span class="code">{{ e.code }}</span>
+                <span class="code">{{ primaryErrorCode(e) }}</span>
                 <ng-container *ngIf="mapErrorFull(e) as me">
                   <span class="title" *ngIf="me.title">{{ me.title }}:</span>
                   <span class="msg">{{ me.message }}</span>
@@ -3471,13 +4558,13 @@ class PraxisFilesUpload {
                     — {{ me.userAction }}</span
                   >
                 </ng-container>
-                <span class="trace" *ngIf="e.traceId"
-                  >(trace {{ e.traceId }})</span
+                <span class="trace" *ngIf="traceIdOf(e) as traceId"
+                  >(trace {{ traceId }})</span
                 >
               </div>
               <div class="extra" *ngIf="r.file?.metadata as m">
                 <details (toggle)="onDetailsToggle($event, r)">
-                  <summary>Metadados</summary>
+                  <summary>{{ t('detailsMetadata', 'Metadados') }}</summary>
                   <pre>{{ m | json }}</pre>
                 </details>
               </div>
@@ -3485,14 +4572,16 @@ class PraxisFilesUpload {
             <div class="item-actions">
               <button
                 mat-icon-button
-                [matTooltip]="'Detalhes'"
+                [matTooltip]="t('details', 'Detalhes')"
+                [attr.aria-label]="resultActionAriaLabel('details', 'Detalhes', r.fileName)"
                 (click)="toggleDetailsFor(r)"
               >
                 <mat-icon [praxisIcon]="'info'"></mat-icon>
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Reenviar'"
+                [matTooltip]="t('retry', 'Reenviar')"
+                [attr.aria-label]="resultActionAriaLabel('retry', 'Reenviar', r.fileName)"
                 (click)="onRetry(r)"
                 [disabled]="isUploading"
               >
@@ -3500,7 +4589,8 @@ class PraxisFilesUpload {
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Baixar'"
+                [matTooltip]="t('download', 'Baixar')"
+                [attr.aria-label]="resultActionAriaLabel('download', 'Baixar', r.fileName)"
                 (click)="onDownload(r)"
                 [disabled]="r.status !== BulkUploadResultStatus.SUCCESS"
               >
@@ -3508,7 +4598,8 @@ class PraxisFilesUpload {
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Copiar link'"
+                [matTooltip]="t('copyLink', 'Copiar link')"
+                [attr.aria-label]="resultActionAriaLabel('copyLink', 'Copiar link', r.fileName)"
                 (click)="onCopyLink(r)"
                 [disabled]="r.status !== BulkUploadResultStatus.SUCCESS"
               >
@@ -3516,7 +4607,8 @@ class PraxisFilesUpload {
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Remover'"
+                [matTooltip]="t('remove', 'Remover')"
+                [attr.aria-label]="resultActionAriaLabel('remove', 'Remover', r.fileName)"
                 (click)="removeResult(r)"
               >
                 <mat-icon [praxisIcon]="'close'"></mat-icon>
@@ -3533,7 +4625,7 @@ class PraxisFilesUpload {
           "
         >
           <button mat-button type="button" (click)="showAllResults = true">
-            Ver todos
+            {{ t('showAll', 'Ver todos') }}
           </button>
         </div>
         <div
@@ -3546,18 +4638,18 @@ class PraxisFilesUpload {
           "
         >
           <button mat-button type="button" (click)="showAllResults = false">
-            Ver menos
+            {{ t('showLess', 'Ver menos') }}
           </button>
         </div>
       </section>
 
       <ng-content></ng-content>
     </div>
-  `, isInline: true, styles: ["@charset \"UTF-8\";.praxis-files-upload{position:relative}.praxis-files-upload .settings-btn{position:absolute;top:.5rem;right:.5rem}.praxis-files-upload .rate-limit-banner,.praxis-files-upload .quota-banner,.praxis-files-upload .error{margin:.5rem 0;padding:.5rem 1rem;border-radius:var(--md-sys-shape-corner-small, 4px)}.praxis-files-upload .rate-limit-banner{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .quota-banner{background:var(--md-sys-color-tertiary-container);color:var(--md-sys-color-on-tertiary-container)}.praxis-files-upload .dropzone{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:2rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-low);color:var(--md-sys-color-on-surface);text-align:center;cursor:pointer;transition:background-color .2s;width:100%;min-height:160px;margin:.5rem 0;gap:.5rem;position:relative}.praxis-files-upload .dropzone:focus,.praxis-files-upload .dropzone:hover{outline:none;background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.dragover{background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.disabled{opacity:.6;cursor:not-allowed;pointer-events:none}.praxis-files-upload .dropzone p{margin:0 0 .5rem}.praxis-files-upload .dropzone .dz-icon{font-size:40px;color:var(--md-sys-color-primary);margin-bottom:.25rem}.praxis-files-upload .dropzone .dz-title{font-weight:600}.praxis-files-upload .dropzone .dz-hint{margin:0;opacity:.8;font-size:.9rem}.praxis-files-upload .dropzone .field-actions{position:absolute;top:.25rem;right:.25rem;display:flex;gap:.25rem;pointer-events:auto}.praxis-files-upload .dropzone .field-actions button[mat-icon-button]{width:32px;height:32px}.praxis-files-upload .dropzone .field-actions mat-icon{font-size:20px}.praxis-files-upload .progress{margin-top:1rem}.praxis-files-upload .sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);border:0}.praxis-files-upload .bulk-results{margin-top:1rem}.praxis-files-upload .bulk-results .bulk-summary{display:flex;gap:1rem;align-items:center;margin-bottom:.5rem}.praxis-files-upload .bulk-results .bulk-summary .stat{display:flex;align-items:center;gap:.35rem;padding:.25rem .5rem;border-radius:6px;background:var(--md-sys-color-surface-container-low)}.praxis-files-upload .bulk-results .bulk-summary .stat.success{color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .bulk-summary .stat.failed{color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .bulk-summary .stat .label{opacity:.9}.praxis-files-upload .bulk-results .bulk-summary .stat .value{font-weight:600}.praxis-files-upload .bulk-results .results-list{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.5rem}.praxis-files-upload .bulk-results .result-item{display:flex;gap:.75rem;padding:.5rem .75rem;border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;background:var(--md-sys-color-surface-container-lowest)}.praxis-files-upload .bulk-results .result-item.ok{border-color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .result-item.err{border-color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .result-item .status-icon{align-self:flex-start;color:currentColor}.praxis-files-upload .bulk-results .result-item .main{flex:1;min-width:0}.praxis-files-upload .bulk-results .result-item .title{display:flex;align-items:center;gap:.5rem}.praxis-files-upload .bulk-results .result-item .name{font-weight:600}.praxis-files-upload .bulk-results .result-item .badge{font-size:.75rem;padding:.1rem .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.praxis-files-upload .bulk-results .result-item .badge.err{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .bulk-results .result-item .meta,.praxis-files-upload .bulk-results .result-item .error{display:flex;flex-wrap:wrap;gap:.5rem 1rem;margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .error .code{font-weight:600}.praxis-files-upload .bulk-results .result-item .extra{margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .item-actions{display:flex;align-items:center;gap:.25rem}.praxis-files-upload .bulk-results .list-footer{margin-top:.5rem;display:flex;justify-content:center}.praxis-files-upload .proximity-overlay{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:.5rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-high);color:var(--md-sys-color-on-surface);text-align:center;z-index:2;pointer-events:none}.praxis-files-upload .proximity-overlay .dz-icon{font-size:40px;color:var(--md-sys-color-primary)}.praxis-files-upload .proximity-overlay .dz-title{font-weight:600}.praxis-files-upload .proximity-overlay .dz-hint{opacity:.85}.praxis-files-upload .selected-overlay{background:var(--md-sys-color-surface);color:var(--md-sys-color-on-surface);border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;box-shadow:var(--md-sys-elevation-level2, 0 2px 6px rgba(0, 0, 0, .15));max-height:260px;overflow:auto;padding:.5rem}.praxis-files-upload .selected-overlay .sel-header{position:sticky;top:0;z-index:1;background:var(--md-sys-color-surface);display:flex;align-items:center;gap:.5rem;padding-bottom:.25rem;margin-bottom:.25rem}.praxis-files-upload .selected-overlay .sel-header .title{font-weight:600}.praxis-files-upload .selected-overlay .sel-header .spacer{flex:1}.praxis-files-upload .selected-overlay .sel-list{list-style:none;margin:0;padding:0}.praxis-files-upload .selected-overlay .sel-list .sel-item{display:flex;align-items:center;gap:.75rem;padding:.5rem .75rem;border-bottom:1px solid var(--md-sys-color-outline-variant, #ccc);transition:background-color .12s ease}.praxis-files-upload .selected-overlay .sel-list .sel-item .file-icon{opacity:.9;color:var(--md-sys-color-primary, #1976d2)}.praxis-files-upload .selected-overlay .sel-list .sel-item .info{flex:1;min-width:0}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .name{font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .meta{font-size:.8rem;opacity:.7}.praxis-files-upload .selected-overlay .sel-list .sel-item .remove-btn{color:var(--md-sys-color-error, #b00020)}.praxis-files-upload .selected-overlay .sel-list .sel-item .more-btn{margin-left:.25rem}.praxis-files-upload .selected-overlay .sel-list .sel-item:hover{background:var(--md-sys-color-surface-container-low)}:host ::ng-deep .praxis-files-upload-overlay-panel{pointer-events:none}:host ::ng-deep .praxis-files-selected-overlay-panel{pointer-events:auto;z-index:3}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i7.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i7.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.NgSelectOption, selector: "option", inputs: ["ngValue", "value"] }, { kind: "directive", type: i1$1.ɵNgSelectMultipleOption, selector: "option", inputs: ["ngValue", "value"] }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.SelectControlValueAccessor, selector: "select:not([multiple])[formControlName],select:not([multiple])[formControl],select:not([multiple])[ngModel]", inputs: ["compareWith"] }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i9.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i9.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i11$1.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatMenuModule }, { kind: "component", type: i3$1.MatMenu, selector: "mat-menu", inputs: ["backdropClass", "aria-label", "aria-labelledby", "aria-describedby", "xPosition", "yPosition", "overlapTrigger", "hasBackdrop", "class", "classList"], outputs: ["closed", "close"], exportAs: ["matMenu"] }, { kind: "component", type: i3$1.MatMenuItem, selector: "[mat-menu-item]", inputs: ["role", "disabled", "disableRipple"], exportAs: ["matMenuItem"] }, { kind: "directive", type: i3$1.MatMenuTrigger, selector: "[mat-menu-trigger-for], [matMenuTriggerFor]", inputs: ["mat-menu-trigger-for", "matMenuTriggerFor", "matMenuTriggerData", "matMenuTriggerRestoreFocus"], outputs: ["menuOpened", "onMenuOpen", "menuClosed", "onMenuClose"], exportAs: ["matMenuTrigger"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "pipe", type: i7.JsonPipe, name: "json" }, { kind: "pipe", type: i7.DatePipe, name: "date" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+  `, isInline: true, styles: ["@charset \"UTF-8\";.praxis-files-upload{position:relative}.praxis-files-upload .settings-btn{position:absolute;top:.5rem;right:.5rem}.praxis-files-upload .rate-limit-banner,.praxis-files-upload .quota-banner,.praxis-files-upload .error{margin:.5rem 0;padding:.5rem 1rem;border-radius:var(--md-sys-shape-corner-small, 4px)}.praxis-files-upload .rate-limit-banner{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .quota-banner{background:var(--md-sys-color-tertiary-container);color:var(--md-sys-color-on-tertiary-container)}.praxis-files-upload .dropzone{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:2rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-low);color:var(--md-sys-color-on-surface);text-align:center;transition:background-color .2s;width:100%;min-height:160px;margin:.5rem 0;gap:.5rem;position:relative}.praxis-files-upload .dropzone:hover{outline:none;background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.dragover{background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.disabled{opacity:.6;cursor:not-allowed;pointer-events:none}.praxis-files-upload .dropzone p{margin:0 0 .5rem}.praxis-files-upload .dropzone .dz-icon{font-size:40px;color:var(--md-sys-color-primary);margin-bottom:.25rem}.praxis-files-upload .dropzone .dz-title{font-weight:600}.praxis-files-upload .dropzone .dz-hint{margin:0;opacity:.8;font-size:.9rem}.praxis-files-upload .dropzone .field-actions{position:absolute;top:.25rem;right:.25rem;display:flex;gap:.25rem;pointer-events:auto}.praxis-files-upload .dropzone .field-actions button[mat-icon-button]{width:32px;height:32px}.praxis-files-upload .dropzone .field-actions mat-icon{font-size:20px}.praxis-files-upload .progress{margin-top:1rem}.praxis-files-upload .sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);border:0}.praxis-files-upload .bulk-results{margin-top:1rem}.praxis-files-upload .bulk-results .bulk-summary{display:flex;gap:1rem;align-items:center;margin-bottom:.5rem}.praxis-files-upload .bulk-results .bulk-summary .stat{display:flex;align-items:center;gap:.35rem;padding:.25rem .5rem;border-radius:6px;background:var(--md-sys-color-surface-container-low)}.praxis-files-upload .bulk-results .bulk-summary .stat.success{color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .bulk-summary .stat.failed{color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .bulk-summary .stat .label{opacity:.9}.praxis-files-upload .bulk-results .bulk-summary .stat .value{font-weight:600}.praxis-files-upload .bulk-results .results-list{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.5rem}.praxis-files-upload .bulk-results .result-item{display:flex;gap:.75rem;padding:.5rem .75rem;border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;background:var(--md-sys-color-surface-container-lowest)}.praxis-files-upload .bulk-results .result-item.ok{border-color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .result-item.err{border-color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .result-item .status-icon{align-self:flex-start;color:currentColor}.praxis-files-upload .bulk-results .result-item .main{flex:1;min-width:0}.praxis-files-upload .bulk-results .result-item .title{display:flex;align-items:center;gap:.5rem}.praxis-files-upload .bulk-results .result-item .name{font-weight:600}.praxis-files-upload .bulk-results .result-item .badge{font-size:.75rem;padding:.1rem .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.praxis-files-upload .bulk-results .result-item .badge.err{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .bulk-results .result-item .meta,.praxis-files-upload .bulk-results .result-item .error{display:flex;flex-wrap:wrap;gap:.5rem 1rem;margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .error .code{font-weight:600}.praxis-files-upload .bulk-results .result-item .extra{margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .item-actions{display:flex;align-items:center;gap:.25rem}.praxis-files-upload .bulk-results .list-footer{margin-top:.5rem;display:flex;justify-content:center}.praxis-files-upload .proximity-overlay{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:.5rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-high);color:var(--md-sys-color-on-surface);text-align:center;z-index:2;pointer-events:none}.praxis-files-upload .proximity-overlay .dz-icon{font-size:40px;color:var(--md-sys-color-primary)}.praxis-files-upload .proximity-overlay .dz-title{font-weight:600}.praxis-files-upload .proximity-overlay .dz-hint{opacity:.85}.praxis-files-upload .selected-overlay{background:var(--md-sys-color-surface);color:var(--md-sys-color-on-surface);border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;box-shadow:var(--md-sys-elevation-level2, 0 2px 6px rgba(0, 0, 0, .15));max-height:260px;overflow:auto;padding:.5rem}.praxis-files-upload .selected-overlay .sel-header{position:sticky;top:0;z-index:1;background:var(--md-sys-color-surface);display:flex;align-items:center;gap:.5rem;padding-bottom:.25rem;margin-bottom:.25rem}.praxis-files-upload .selected-overlay .sel-header .title{font-weight:600}.praxis-files-upload .selected-overlay .sel-header .spacer{flex:1}.praxis-files-upload .selected-overlay .sel-list{list-style:none;margin:0;padding:0}.praxis-files-upload .selected-overlay .sel-list .sel-item{display:flex;align-items:center;gap:.75rem;padding:.5rem .75rem;border-bottom:1px solid var(--md-sys-color-outline-variant, #ccc);transition:background-color .12s ease}.praxis-files-upload .selected-overlay .sel-list .sel-item .file-icon{opacity:.9;color:var(--md-sys-color-primary, #1976d2)}.praxis-files-upload .selected-overlay .sel-list .sel-item .info{flex:1;min-width:0}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .name{font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .meta{font-size:.8rem;opacity:.7}.praxis-files-upload .selected-overlay .sel-list .sel-item .remove-btn{color:var(--md-sys-color-error, #b00020)}.praxis-files-upload .selected-overlay .sel-list .sel-item .more-btn{margin-left:.25rem}.praxis-files-upload .selected-overlay .sel-list .sel-item:hover{background:var(--md-sys-color-surface-container-low)}:host ::ng-deep .praxis-files-upload-overlay-panel{pointer-events:none}:host ::ng-deep .praxis-files-selected-overlay-panel{pointer-events:auto;z-index:3}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i9.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i9.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "ngmodule", type: ReactiveFormsModule }, { kind: "directive", type: i1$1.NgSelectOption, selector: "option", inputs: ["ngValue", "value"] }, { kind: "directive", type: i1$1.ɵNgSelectMultipleOption, selector: "option", inputs: ["ngValue", "value"] }, { kind: "directive", type: i1$1.DefaultValueAccessor, selector: "input:not([type=checkbox])[formControlName],textarea[formControlName],input:not([type=checkbox])[formControl],textarea[formControl],input:not([type=checkbox])[ngModel],textarea[ngModel],[ngDefaultControl]" }, { kind: "directive", type: i1$1.SelectControlValueAccessor, selector: "select:not([multiple])[formControlName],select:not([multiple])[formControl],select:not([multiple])[ngModel]", inputs: ["compareWith"] }, { kind: "directive", type: i1$1.NgControlStatus, selector: "[formControlName],[ngModel],[formControl]" }, { kind: "directive", type: i1$1.FormControlDirective, selector: "[formControl]", inputs: ["formControl", "disabled", "ngModel"], outputs: ["ngModelChange"], exportAs: ["ngForm"] }, { kind: "ngmodule", type: MatButtonModule }, { kind: "component", type: i11.MatButton, selector: "    button[matButton], a[matButton], button[mat-button], button[mat-raised-button],    button[mat-flat-button], button[mat-stroked-button], a[mat-button], a[mat-raised-button],    a[mat-flat-button], a[mat-stroked-button]  ", inputs: ["matButton"], exportAs: ["matButton", "matAnchor"] }, { kind: "component", type: i11.MatIconButton, selector: "button[mat-icon-button], a[mat-icon-button], button[matIconButton], a[matIconButton]", exportAs: ["matButton", "matAnchor"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "directive", type: PraxisIconDirective, selector: "mat-icon[praxisIcon]", inputs: ["praxisIcon"] }, { kind: "ngmodule", type: MatProgressBarModule }, { kind: "component", type: i13.MatProgressBar, selector: "mat-progress-bar", inputs: ["color", "value", "bufferValue", "mode"], outputs: ["animationEnd"], exportAs: ["matProgressBar"] }, { kind: "ngmodule", type: MatMenuModule }, { kind: "component", type: i14.MatMenu, selector: "mat-menu", inputs: ["backdropClass", "aria-label", "aria-labelledby", "aria-describedby", "xPosition", "yPosition", "overlapTrigger", "hasBackdrop", "class", "classList"], outputs: ["closed", "close"], exportAs: ["matMenu"] }, { kind: "component", type: i14.MatMenuItem, selector: "[mat-menu-item]", inputs: ["role", "disabled", "disableRipple"], exportAs: ["matMenuItem"] }, { kind: "directive", type: i14.MatMenuTrigger, selector: "[mat-menu-trigger-for], [matMenuTriggerFor]", inputs: ["mat-menu-trigger-for", "matMenuTriggerFor", "matMenuTriggerData", "matMenuTriggerRestoreFocus"], outputs: ["menuOpened", "onMenuOpen", "menuClosed", "onMenuClose"], exportAs: ["matMenuTrigger"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11$1.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "pipe", type: i9.JsonPipe, name: "json" }, { kind: "pipe", type: i9.DatePipe, name: "date" }], changeDetection: i0.ChangeDetectionStrategy.OnPush });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PraxisFilesUpload, decorators: [{
             type: Component,
-            args: [{ selector: 'praxis-files-upload', standalone: true, imports: [
+            args: [{ selector: 'praxis-files-upload', standalone: true, providers: [providePraxisFilesUploadI18n()], imports: [
                         CommonModule,
                         ReactiveFormsModule,
                         MatButtonModule,
@@ -3567,27 +4659,35 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                         MatMenuModule,
                         MatTooltipModule,
                     ], changeDetection: ChangeDetectionStrategy.OnPush, template: `
-    <div class="praxis-files-upload" [class.dense]="config?.ui?.dense" #host>
+    <div
+      class="praxis-files-upload"
+      [class.dense]="config?.ui?.dense"
+      [attr.data-files-upload-id]="a11yBaseId"
+      [attr.data-ready-state]="readinessState"
+      [attr.data-ready-source]="readinessSource"
+      [attr.aria-busy]="readinessState === 'loading' ? 'true' : 'false'"
+      #host
+    >
       <!-- Proximity overlay inline (fallback quando expandMode === 'inline') -->
-      <div
-        class="proximity-overlay"
+        <div
+          class="proximity-overlay"
         *ngIf="
           showProximityOverlay &&
           (config?.ui?.dropzone?.expandMode ?? 'overlay') === 'inline'
         "
         [style.height.px]="config?.ui?.dropzone?.expandHeight ?? 200"
         aria-hidden="true"
-      >
-        <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
-        <p class="dz-title">{{ texts.dropzoneLabel }}</p>
-        <p class="dz-hint">Solte aqui para enviar</p>
-      </div>
+        >
+          <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
+          <p class="dz-title">{{ texts.dropzoneLabel }}</p>
+          <p class="dz-hint">{{ t('dropzoneProximityHint', 'Solte aqui para enviar') }}</p>
+        </div>
       <!-- Template do overlay de proximidade (renderizado via CDK Overlay) -->
       <ng-template #proximityOverlayTmpl>
         <div class="proximity-overlay" aria-hidden="true">
           <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
           <p class="dz-title">{{ texts.dropzoneLabel }}</p>
-          <p class="dz-hint">Solte aqui para enviar</p>
+          <p class="dz-hint">{{ t('dropzoneProximityHint', 'Solte aqui para enviar') }}</p>
         </div>
       </ng-template>
 
@@ -3596,22 +4696,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         <ng-template #selectedOverlayTmpl>
           <div
             class="selected-overlay"
-            role="dialog"
-            aria-label="Arquivos selecionados"
+            role="region"
+            [attr.aria-labelledby]="selectedOverlayTitleId"
           >
             <header class="sel-header">
-              <span class="title">Selecionados ({{ pendingCount }})</span>
+              <span class="title" [id]="selectedOverlayTitleId">{{ t('selectedOverlayTitle', 'Selecionados') }} ({{ pendingCount }})</span>
               <span class="spacer"></span>
               <button
                 mat-stroked-button
                 color="primary"
-                (click)="triggerUpload()"
+                (click)="submitPendingFiles()"
                 [disabled]="!baseUrl || isUploading"
               >
-                Enviar
+                {{ t('fieldActionUploadShort', 'Enviar') }}
               </button>
-              <button mat-button type="button" (click)="clearSelection()">
-                Cancelar
+              <button mat-button type="button" (click)="resetPendingFiles()">
+                {{ t('fieldActionCancelShort', 'Cancelar') }}
               </button>
             </header>
             <ul class="sel-list">
@@ -3632,7 +4732,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                   class="remove-btn"
                   [matTooltip]="t('remove', 'Remover')"
                   (click)="removePendingFile(f)"
-                  [attr.aria-label]="t('remove', 'Remover')"
+                  [attr.aria-label]="pendingFileRemoveAriaLabel(f)"
                 >
                   <mat-icon [praxisIcon]="'close'"></mat-icon>
                 </button>
@@ -3643,7 +4743,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                   [matMenuTriggerData]="{ file: f }"
                   aria-haspopup="menu"
                   [matTooltip]="t('moreActions', 'Mais ações')"
-                  [attr.aria-label]="t('moreActions', 'Mais ações')"
+                  [attr.aria-label]="pendingFileMoreActionsAriaLabel(f)"
                 >
                   <mat-icon [praxisIcon]="'more_horiz'"></mat-icon>
                 </button>
@@ -3684,6 +4784,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
       <div
         class="rate-limit-banner"
         *ngIf="rateLimit && config?.rateLimit?.showBannerOn429 !== false"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
       >
         {{ texts.rateLimitBanner }}
         {{ rateLimit.resetEpochSeconds * 1000 | date: 'shortTime' }}.
@@ -3691,32 +4794,34 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
       <div
         class="quota-banner"
         *ngIf="quotaExceeded && config?.quotas?.showQuotaWarnings !== false"
+        [id]="messageRegionId"
+        role="status"
+        aria-live="polite"
       >
         {{ errorMessage }}
       </div>
-      <div class="error" *ngIf="errorMessage && !quotaExceeded">
+      <div
+        class="error"
+        *ngIf="errorMessage && !quotaExceeded"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
+      >
         {{ errorMessage }}
       </div>
-      <div class="error" *ngIf="!baseUrl">
-        Base URL não configurada. Informe [baseUrl] para habilitar o envio.
+      <div
+        class="error"
+        *ngIf="!baseUrl"
+        [id]="messageRegionId"
+        role="alert"
+        aria-live="assertive"
+      >
+        {{ t('baseUrlMissing', 'Base URL not configured. Provide [baseUrl] to enable uploads.') }}
       </div>
       <div
         class="dropzone"
         *ngIf="config?.ui?.showDropzone !== false"
-        [attr.role]="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : 'button'
-        "
-        [attr.tabindex]="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? -1
-            : 0
-        "
+        role="group"
         [class.dragover]="isDragging"
         [class.disabled]="
           !baseUrl ||
@@ -3730,39 +4835,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             ? 'true'
             : 'false'
         "
-        [attr.aria-label]="texts.dropzoneLabel + ' ' + texts.dropzoneButton"
-        (click)="
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
+        [attr.aria-label]="texts.dropzoneLabel"
+        [attr.aria-describedby]="messageRegionId"
         (drop)="onDrop($event)"
         (dragover)="onDragOver($event)"
         (dragleave)="onDragLeave($event)"
-        (keydown.enter)="
-          $event.preventDefault();
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
-        (keydown.space)="
-          $event.preventDefault();
-          !baseUrl ||
-          (quotaExceeded && config?.quotas?.blockOnExceed) ||
-          isUploading
-            ? null
-            : openFile(fileInput)
-        "
       >
         <!-- Ações internas (ícones) -->
         <div class="field-actions" aria-hidden="false">
           <button
             mat-icon-button
-            [matTooltip]="'Selecionar arquivo(s)'"
+            [matTooltip]="t('selectFiles', 'Select file(s)')"
+            [attr.aria-label]="selectFilesAriaLabel"
             (click)="$event.stopPropagation(); openFile(fileInput)"
             [disabled]="!baseUrl || isUploading"
           >
@@ -3771,6 +4855,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
           <button
             mat-icon-button
             [matTooltip]="policiesSummary"
+            [attr.aria-label]="policySummaryAriaLabel"
             (click)="$event.stopPropagation()"
             [disabled]="false"
           >
@@ -3781,9 +4866,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         <mat-icon class="dz-icon" aria-hidden="true" [praxisIcon]="'cloud_upload'"></mat-icon>
         <p class="dz-title">{{ texts.dropzoneLabel }}</p>
         <p class="dz-hint">
-          Arraste e solte arquivos aqui ou clique para selecionar
+          {{ t('dropzoneHint', 'Arraste e solte arquivos aqui ou clique para selecionar') }}
         </p>
-        <button type="button" mat-stroked-button (click)="openFile(fileInput)">
+        <button
+          type="button"
+          mat-stroked-button
+          [disabled]="!baseUrl || isUploading"
+          [attr.aria-describedby]="messageRegionId"
+          (click)="openFile(fileInput)"
+        >
           {{ texts.dropzoneButton }}
         </button>
       </div>
@@ -3803,8 +4894,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
         class="conflict-policy"
         *ngIf="config?.ui?.showConflictPolicySelector"
       >
-        <label for="conflictPolicy">{{ texts.conflictPolicyLabel }}</label>
-        <select id="conflictPolicy" [formControl]="conflictPolicy">
+        <label [for]="conflictPolicyInputId">{{ texts.conflictPolicyLabel }}</label>
+        <select [id]="conflictPolicyInputId" [formControl]="conflictPolicy">
           <option *ngFor="let p of conflictPolicies" [value]="p">
             {{ p }}
           </option>
@@ -3812,18 +4903,27 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
       </div>
 
       <div class="metadata" *ngIf="config?.ui?.showMetadataForm">
-        <label for="metadata">{{ texts.metadataLabel }}</label>
-        <textarea id="metadata" [formControl]="metadata"></textarea>
+        <label [for]="metadataInputId">{{ texts.metadataLabel }}</label>
+        <textarea [id]="metadataInputId" [formControl]="metadata"></textarea>
         <div class="error" *ngIf="metadataError">{{ metadataError }}</div>
       </div>
 
-      <div class="progress" *ngIf="showProgress">
+      <div
+        class="progress"
+        *ngIf="showProgress"
+        [id]="progressRegionId"
+        role="status"
+        aria-live="polite"
+      >
         <mat-progress-bar
           mode="determinate"
           [value]="uploadProgressValue"
           [attr.aria-label]="texts.progressAriaLabel"
+          [attr.aria-valuemin]="0"
+          [attr.aria-valuemax]="100"
+          [attr.aria-valuenow]="uploadProgressValue"
         ></mat-progress-bar>
-        <span class="sr-only">{{ uploadProgressValue }}%</span>
+        <span class="sr-only">{{ texts.progressAriaLabel }} {{ uploadProgressValue }}%</span>
       </div>
 
       <ul class="file-feedback" *ngIf="hasUploadedFiles">
@@ -3838,17 +4938,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
       <section class="bulk-results" *ngIf="hasLastResults">
         <header class="bulk-summary" *ngIf="lastStats">
           <div class="stat">
-            <span class="label">Total</span>
+            <span class="label">{{ t('bulkSummaryTotal', 'Total') }}</span>
             <span class="value">{{ lastStats.total }}</span>
           </div>
           <div class="stat success">
             <mat-icon [praxisIcon]="'check_circle'"></mat-icon>
-            <span class="label">Sucesso</span>
+            <span class="label">{{ t('bulkSummarySuccess', 'Sucesso') }}</span>
             <span class="value">{{ lastStats.succeeded }}</span>
           </div>
           <div class="stat failed">
             <mat-icon [praxisIcon]="'error'"></mat-icon>
-            <span class="label">Falhas</span>
+            <span class="label">{{ t('bulkSummaryFailed', 'Falhas') }}</span>
             <span class="value">{{ lastStats.failed }}</span>
           </div>
         </header>
@@ -3879,19 +4979,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 >
               </div>
               <div class="meta" *ngIf="r.file">
-                <span *ngIf="r.file.id">ID: {{ r.file.id }}</span>
+                <span *ngIf="r.file.id"
+                  >{{ t('resultMetaIdLabel', 'ID') }}: {{ r.file.id }}</span
+                >
                 <span *ngIf="r.file.contentType"
-                  >Tipo: {{ r.file.contentType }}</span
+                  >{{ t('resultMetaTypeLabel', 'Tipo') }}:
+                  {{ r.file.contentType }}</span
                 >
                 <span *ngIf="r.file.fileSize"
-                  >Tamanho: {{ formatBytes(r.file.fileSize) }}</span
+                  >{{ t('resultMetaSizeLabel', 'Tamanho') }}:
+                  {{ formatBytes(r.file.fileSize) }}</span
                 >
                 <span *ngIf="r.file.uploadedAt"
-                  >Enviado em: {{ r.file.uploadedAt | date: 'short' }}</span
+                  >{{ t('resultMetaUploadedAtLabel', 'Enviado em') }}:
+                  {{ r.file.uploadedAt | date: 'short' }}</span
                 >
               </div>
               <div class="error" *ngIf="r.error as e">
-                <span class="code">{{ e.code }}</span>
+                <span class="code">{{ primaryErrorCode(e) }}</span>
                 <ng-container *ngIf="mapErrorFull(e) as me">
                   <span class="title" *ngIf="me.title">{{ me.title }}:</span>
                   <span class="msg">{{ me.message }}</span>
@@ -3899,13 +5004,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                     — {{ me.userAction }}</span
                   >
                 </ng-container>
-                <span class="trace" *ngIf="e.traceId"
-                  >(trace {{ e.traceId }})</span
+                <span class="trace" *ngIf="traceIdOf(e) as traceId"
+                  >(trace {{ traceId }})</span
                 >
               </div>
               <div class="extra" *ngIf="r.file?.metadata as m">
                 <details (toggle)="onDetailsToggle($event, r)">
-                  <summary>Metadados</summary>
+                  <summary>{{ t('detailsMetadata', 'Metadados') }}</summary>
                   <pre>{{ m | json }}</pre>
                 </details>
               </div>
@@ -3913,14 +5018,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
             <div class="item-actions">
               <button
                 mat-icon-button
-                [matTooltip]="'Detalhes'"
+                [matTooltip]="t('details', 'Detalhes')"
+                [attr.aria-label]="resultActionAriaLabel('details', 'Detalhes', r.fileName)"
                 (click)="toggleDetailsFor(r)"
               >
                 <mat-icon [praxisIcon]="'info'"></mat-icon>
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Reenviar'"
+                [matTooltip]="t('retry', 'Reenviar')"
+                [attr.aria-label]="resultActionAriaLabel('retry', 'Reenviar', r.fileName)"
                 (click)="onRetry(r)"
                 [disabled]="isUploading"
               >
@@ -3928,7 +5035,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Baixar'"
+                [matTooltip]="t('download', 'Baixar')"
+                [attr.aria-label]="resultActionAriaLabel('download', 'Baixar', r.fileName)"
                 (click)="onDownload(r)"
                 [disabled]="r.status !== BulkUploadResultStatus.SUCCESS"
               >
@@ -3936,7 +5044,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Copiar link'"
+                [matTooltip]="t('copyLink', 'Copiar link')"
+                [attr.aria-label]="resultActionAriaLabel('copyLink', 'Copiar link', r.fileName)"
                 (click)="onCopyLink(r)"
                 [disabled]="r.status !== BulkUploadResultStatus.SUCCESS"
               >
@@ -3944,7 +5053,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
               </button>
               <button
                 mat-icon-button
-                [matTooltip]="'Remover'"
+                [matTooltip]="t('remove', 'Remover')"
+                [attr.aria-label]="resultActionAriaLabel('remove', 'Remover', r.fileName)"
                 (click)="removeResult(r)"
               >
                 <mat-icon [praxisIcon]="'close'"></mat-icon>
@@ -3961,7 +5071,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
           "
         >
           <button mat-button type="button" (click)="showAllResults = true">
-            Ver todos
+            {{ t('showAll', 'Ver todos') }}
           </button>
         </div>
         <div
@@ -3974,37 +5084,39 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
           "
         >
           <button mat-button type="button" (click)="showAllResults = false">
-            Ver menos
+            {{ t('showLess', 'Ver menos') }}
           </button>
         </div>
       </section>
 
       <ng-content></ng-content>
     </div>
-  `, styles: ["@charset \"UTF-8\";.praxis-files-upload{position:relative}.praxis-files-upload .settings-btn{position:absolute;top:.5rem;right:.5rem}.praxis-files-upload .rate-limit-banner,.praxis-files-upload .quota-banner,.praxis-files-upload .error{margin:.5rem 0;padding:.5rem 1rem;border-radius:var(--md-sys-shape-corner-small, 4px)}.praxis-files-upload .rate-limit-banner{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .quota-banner{background:var(--md-sys-color-tertiary-container);color:var(--md-sys-color-on-tertiary-container)}.praxis-files-upload .dropzone{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:2rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-low);color:var(--md-sys-color-on-surface);text-align:center;cursor:pointer;transition:background-color .2s;width:100%;min-height:160px;margin:.5rem 0;gap:.5rem;position:relative}.praxis-files-upload .dropzone:focus,.praxis-files-upload .dropzone:hover{outline:none;background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.dragover{background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.disabled{opacity:.6;cursor:not-allowed;pointer-events:none}.praxis-files-upload .dropzone p{margin:0 0 .5rem}.praxis-files-upload .dropzone .dz-icon{font-size:40px;color:var(--md-sys-color-primary);margin-bottom:.25rem}.praxis-files-upload .dropzone .dz-title{font-weight:600}.praxis-files-upload .dropzone .dz-hint{margin:0;opacity:.8;font-size:.9rem}.praxis-files-upload .dropzone .field-actions{position:absolute;top:.25rem;right:.25rem;display:flex;gap:.25rem;pointer-events:auto}.praxis-files-upload .dropzone .field-actions button[mat-icon-button]{width:32px;height:32px}.praxis-files-upload .dropzone .field-actions mat-icon{font-size:20px}.praxis-files-upload .progress{margin-top:1rem}.praxis-files-upload .sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);border:0}.praxis-files-upload .bulk-results{margin-top:1rem}.praxis-files-upload .bulk-results .bulk-summary{display:flex;gap:1rem;align-items:center;margin-bottom:.5rem}.praxis-files-upload .bulk-results .bulk-summary .stat{display:flex;align-items:center;gap:.35rem;padding:.25rem .5rem;border-radius:6px;background:var(--md-sys-color-surface-container-low)}.praxis-files-upload .bulk-results .bulk-summary .stat.success{color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .bulk-summary .stat.failed{color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .bulk-summary .stat .label{opacity:.9}.praxis-files-upload .bulk-results .bulk-summary .stat .value{font-weight:600}.praxis-files-upload .bulk-results .results-list{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.5rem}.praxis-files-upload .bulk-results .result-item{display:flex;gap:.75rem;padding:.5rem .75rem;border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;background:var(--md-sys-color-surface-container-lowest)}.praxis-files-upload .bulk-results .result-item.ok{border-color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .result-item.err{border-color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .result-item .status-icon{align-self:flex-start;color:currentColor}.praxis-files-upload .bulk-results .result-item .main{flex:1;min-width:0}.praxis-files-upload .bulk-results .result-item .title{display:flex;align-items:center;gap:.5rem}.praxis-files-upload .bulk-results .result-item .name{font-weight:600}.praxis-files-upload .bulk-results .result-item .badge{font-size:.75rem;padding:.1rem .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.praxis-files-upload .bulk-results .result-item .badge.err{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .bulk-results .result-item .meta,.praxis-files-upload .bulk-results .result-item .error{display:flex;flex-wrap:wrap;gap:.5rem 1rem;margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .error .code{font-weight:600}.praxis-files-upload .bulk-results .result-item .extra{margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .item-actions{display:flex;align-items:center;gap:.25rem}.praxis-files-upload .bulk-results .list-footer{margin-top:.5rem;display:flex;justify-content:center}.praxis-files-upload .proximity-overlay{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:.5rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-high);color:var(--md-sys-color-on-surface);text-align:center;z-index:2;pointer-events:none}.praxis-files-upload .proximity-overlay .dz-icon{font-size:40px;color:var(--md-sys-color-primary)}.praxis-files-upload .proximity-overlay .dz-title{font-weight:600}.praxis-files-upload .proximity-overlay .dz-hint{opacity:.85}.praxis-files-upload .selected-overlay{background:var(--md-sys-color-surface);color:var(--md-sys-color-on-surface);border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;box-shadow:var(--md-sys-elevation-level2, 0 2px 6px rgba(0, 0, 0, .15));max-height:260px;overflow:auto;padding:.5rem}.praxis-files-upload .selected-overlay .sel-header{position:sticky;top:0;z-index:1;background:var(--md-sys-color-surface);display:flex;align-items:center;gap:.5rem;padding-bottom:.25rem;margin-bottom:.25rem}.praxis-files-upload .selected-overlay .sel-header .title{font-weight:600}.praxis-files-upload .selected-overlay .sel-header .spacer{flex:1}.praxis-files-upload .selected-overlay .sel-list{list-style:none;margin:0;padding:0}.praxis-files-upload .selected-overlay .sel-list .sel-item{display:flex;align-items:center;gap:.75rem;padding:.5rem .75rem;border-bottom:1px solid var(--md-sys-color-outline-variant, #ccc);transition:background-color .12s ease}.praxis-files-upload .selected-overlay .sel-list .sel-item .file-icon{opacity:.9;color:var(--md-sys-color-primary, #1976d2)}.praxis-files-upload .selected-overlay .sel-list .sel-item .info{flex:1;min-width:0}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .name{font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .meta{font-size:.8rem;opacity:.7}.praxis-files-upload .selected-overlay .sel-list .sel-item .remove-btn{color:var(--md-sys-color-error, #b00020)}.praxis-files-upload .selected-overlay .sel-list .sel-item .more-btn{margin-left:.25rem}.praxis-files-upload .selected-overlay .sel-list .sel-item:hover{background:var(--md-sys-color-surface-container-low)}:host ::ng-deep .praxis-files-upload-overlay-panel{pointer-events:none}:host ::ng-deep .praxis-files-selected-overlay-panel{pointer-events:auto;z-index:3}\n"] }]
-        }], ctorParameters: () => [{ type: i1$2.SettingsPanelService }, { type: DragProximityService }, { type: undefined, decorators: [{
+  `, styles: ["@charset \"UTF-8\";.praxis-files-upload{position:relative}.praxis-files-upload .settings-btn{position:absolute;top:.5rem;right:.5rem}.praxis-files-upload .rate-limit-banner,.praxis-files-upload .quota-banner,.praxis-files-upload .error{margin:.5rem 0;padding:.5rem 1rem;border-radius:var(--md-sys-shape-corner-small, 4px)}.praxis-files-upload .rate-limit-banner{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .quota-banner{background:var(--md-sys-color-tertiary-container);color:var(--md-sys-color-on-tertiary-container)}.praxis-files-upload .dropzone{display:flex;flex-direction:column;align-items:center;justify-content:center;padding:2rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-low);color:var(--md-sys-color-on-surface);text-align:center;transition:background-color .2s;width:100%;min-height:160px;margin:.5rem 0;gap:.5rem;position:relative}.praxis-files-upload .dropzone:hover{outline:none;background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.dragover{background:var(--md-sys-color-surface-container-high);border-color:var(--md-sys-color-primary)}.praxis-files-upload .dropzone.disabled{opacity:.6;cursor:not-allowed;pointer-events:none}.praxis-files-upload .dropzone p{margin:0 0 .5rem}.praxis-files-upload .dropzone .dz-icon{font-size:40px;color:var(--md-sys-color-primary);margin-bottom:.25rem}.praxis-files-upload .dropzone .dz-title{font-weight:600}.praxis-files-upload .dropzone .dz-hint{margin:0;opacity:.8;font-size:.9rem}.praxis-files-upload .dropzone .field-actions{position:absolute;top:.25rem;right:.25rem;display:flex;gap:.25rem;pointer-events:auto}.praxis-files-upload .dropzone .field-actions button[mat-icon-button]{width:32px;height:32px}.praxis-files-upload .dropzone .field-actions mat-icon{font-size:20px}.praxis-files-upload .progress{margin-top:1rem}.praxis-files-upload .sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);border:0}.praxis-files-upload .bulk-results{margin-top:1rem}.praxis-files-upload .bulk-results .bulk-summary{display:flex;gap:1rem;align-items:center;margin-bottom:.5rem}.praxis-files-upload .bulk-results .bulk-summary .stat{display:flex;align-items:center;gap:.35rem;padding:.25rem .5rem;border-radius:6px;background:var(--md-sys-color-surface-container-low)}.praxis-files-upload .bulk-results .bulk-summary .stat.success{color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .bulk-summary .stat.failed{color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .bulk-summary .stat .label{opacity:.9}.praxis-files-upload .bulk-results .bulk-summary .stat .value{font-weight:600}.praxis-files-upload .bulk-results .results-list{list-style:none;padding:0;margin:0;display:flex;flex-direction:column;gap:.5rem}.praxis-files-upload .bulk-results .result-item{display:flex;gap:.75rem;padding:.5rem .75rem;border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;background:var(--md-sys-color-surface-container-lowest)}.praxis-files-upload .bulk-results .result-item.ok{border-color:var(--md-sys-color-primary)}.praxis-files-upload .bulk-results .result-item.err{border-color:var(--md-sys-color-error)}.praxis-files-upload .bulk-results .result-item .status-icon{align-self:flex-start;color:currentColor}.praxis-files-upload .bulk-results .result-item .main{flex:1;min-width:0}.praxis-files-upload .bulk-results .result-item .title{display:flex;align-items:center;gap:.5rem}.praxis-files-upload .bulk-results .result-item .name{font-weight:600}.praxis-files-upload .bulk-results .result-item .badge{font-size:.75rem;padding:.1rem .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.praxis-files-upload .bulk-results .result-item .badge.err{background:var(--md-sys-color-error-container);color:var(--md-sys-color-on-error-container)}.praxis-files-upload .bulk-results .result-item .meta,.praxis-files-upload .bulk-results .result-item .error{display:flex;flex-wrap:wrap;gap:.5rem 1rem;margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .error .code{font-weight:600}.praxis-files-upload .bulk-results .result-item .extra{margin-top:.25rem}.praxis-files-upload .bulk-results .result-item .item-actions{display:flex;align-items:center;gap:.25rem}.praxis-files-upload .bulk-results .list-footer{margin-top:.5rem;display:flex;justify-content:center}.praxis-files-upload .proximity-overlay{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:.5rem;border:2px dashed var(--md-sys-color-outline);border-radius:var(--md-sys-shape-corner-medium, 4px);background:var(--md-sys-color-surface-container-high);color:var(--md-sys-color-on-surface);text-align:center;z-index:2;pointer-events:none}.praxis-files-upload .proximity-overlay .dz-icon{font-size:40px;color:var(--md-sys-color-primary)}.praxis-files-upload .proximity-overlay .dz-title{font-weight:600}.praxis-files-upload .proximity-overlay .dz-hint{opacity:.85}.praxis-files-upload .selected-overlay{background:var(--md-sys-color-surface);color:var(--md-sys-color-on-surface);border:1px solid var(--md-sys-color-outline-variant);border-radius:8px;box-shadow:var(--md-sys-elevation-level2, 0 2px 6px rgba(0, 0, 0, .15));max-height:260px;overflow:auto;padding:.5rem}.praxis-files-upload .selected-overlay .sel-header{position:sticky;top:0;z-index:1;background:var(--md-sys-color-surface);display:flex;align-items:center;gap:.5rem;padding-bottom:.25rem;margin-bottom:.25rem}.praxis-files-upload .selected-overlay .sel-header .title{font-weight:600}.praxis-files-upload .selected-overlay .sel-header .spacer{flex:1}.praxis-files-upload .selected-overlay .sel-list{list-style:none;margin:0;padding:0}.praxis-files-upload .selected-overlay .sel-list .sel-item{display:flex;align-items:center;gap:.75rem;padding:.5rem .75rem;border-bottom:1px solid var(--md-sys-color-outline-variant, #ccc);transition:background-color .12s ease}.praxis-files-upload .selected-overlay .sel-list .sel-item .file-icon{opacity:.9;color:var(--md-sys-color-primary, #1976d2)}.praxis-files-upload .selected-overlay .sel-list .sel-item .info{flex:1;min-width:0}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .name{font-weight:500;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.praxis-files-upload .selected-overlay .sel-list .sel-item .info .meta{font-size:.8rem;opacity:.7}.praxis-files-upload .selected-overlay .sel-list .sel-item .remove-btn{color:var(--md-sys-color-error, #b00020)}.praxis-files-upload .selected-overlay .sel-list .sel-item .more-btn{margin-left:.25rem}.praxis-files-upload .selected-overlay .sel-list .sel-item:hover{background:var(--md-sys-color-surface-container-low)}:host ::ng-deep .praxis-files-upload-overlay-panel{pointer-events:none}:host ::ng-deep .praxis-files-selected-overlay-panel{pointer-events:auto;z-index:3}\n"] }]
+        }], ctorParameters: () => [{ type: i1$3.SettingsPanelService }, { type: DragProximityService }, { type: i3.Overlay }, { type: i0.ViewContainerRef }, { type: i0.ChangeDetectorRef }, { type: undefined, decorators: [{
+                    type: Inject,
+                    args: [ASYNC_CONFIG_STORAGE]
+                }] }, { type: i1$2.PraxisI18nService }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
                     type: Inject,
                     args: [FILES_UPLOAD_TEXTS]
-                }] }, { type: i3.Overlay }, { type: i0.ViewContainerRef }, { type: i0.ChangeDetectorRef }, { type: undefined, decorators: [{
+                }] }, { type: undefined, decorators: [{
+                    type: Optional
+                }, {
                     type: Inject,
-                    args: [ASYNC_CONFIG_STORAGE]
+                    args: [TRANSLATE_LIKE]
+                }] }, { type: ConfigService, decorators: [{
+                    type: Optional
                 }] }, { type: FilesApiClient, decorators: [{
                     type: Optional
                 }] }, { type: PresignedUploaderService, decorators: [{
                     type: Optional
                 }] }, { type: ErrorMapperService, decorators: [{
                     type: Optional
-                }] }, { type: undefined, decorators: [{
-                    type: Optional
-                }, {
-                    type: Inject,
-                    args: [TRANSLATE_LIKE]
                 }] }], propDecorators: { config: [{
                 type: Input
             }], filesUploadId: [{
                 type: Input
-            }], uploadId: [{
-                type: Input
             }], componentInstanceId: [{
                 type: Input
             }], baseUrl: [{
@@ -4027,8 +5139,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 type: Output
             }], uploadProgress: [{
                 type: Output
-            }], uploadError: [{
-                type: Output
             }], retry: [{
                 type: Output
             }], download: [{
@@ -4039,10 +5149,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
                 type: Output
             }], detailsClosed: [{
                 type: Output
-            }], pendingFilesChange: [{
+            }], pendingStateChange: [{
                 type: Output
             }], proximityChange: [{
                 type: Output
+            }], readinessChange: [{
+                type: Output
             }], fileInput: [{
                 type: ViewChild,
                 args: ['fileInput']
@@ -4061,22 +5173,49 @@ class PdxFilesUploadFieldComponent extends SimpleBaseInputComponent {
     config = null;
     valueMode = 'metadata';
     baseUrl;
+    uploadSuccess = new EventEmitter();
+    bulkComplete = new EventEmitter();
+    error = new EventEmitter();
     uploadError = null;
     uploader;
+    pendingTrigger;
+    pendingPanel;
     // Estado para UI de seleção manual
     pendingFiles = [];
+    pendingPanelOpen = false;
+    pendingOverlayPositions = [
+        {
+            originX: 'start',
+            originY: 'bottom',
+            overlayX: 'start',
+            overlayY: 'top',
+            offsetY: 8,
+        },
+        {
+            originX: 'start',
+            originY: 'top',
+            overlayX: 'start',
+            overlayY: 'bottom',
+            offsetY: -8,
+        },
+    ];
     // Ações para UI de seleção manual
     onTriggerUpload() {
-        this.uploader?.triggerUpload();
+        this.closePendingPanel(false);
+        this.uploader?.submitPendingFiles();
     }
     onClearSelection() {
-        this.uploader?.clearSelection();
+        this.closePendingPanel(false);
+        this.uploader?.resetPendingFiles();
     }
     // Recebe o estado do componente filho
-    handlePendingFiles(files) {
-        this.pendingFiles = files;
-        if (files.length > 0) {
-            this.control().markAsTouched(); // Garante que validação de 'required' seja reavaliada
+    handlePendingState(state) {
+        this.pendingFiles = state.files;
+        if (state.hasPending) {
+            this.control().markAsTouched();
+        }
+        else {
+            this.closePendingPanel(false);
         }
     }
     // Estado visual do campo compacto
@@ -4084,48 +5223,102 @@ class PdxFilesUploadFieldComponent extends SimpleBaseInputComponent {
     batchCount = 0;
     isProximityActive = false;
     errors = inject(ErrorMapperService);
-    translate = inject(TRANSLATE_LIKE, { optional: true }) ?? null;
+    filesUploadI18n = inject(PraxisI18nService);
+    legacyTexts = inject(FILES_UPLOAD_TEXTS, { optional: true });
+    legacyTranslate = inject(TRANSLATE_LIKE, { optional: true });
     get showUploadError() {
         const c = this.control();
-        return c.touched && c.invalid;
+        return (!!this.uploadError &&
+            c.touched &&
+            (c.hasError('upload') || c.hasError('uploadPartial')));
     }
-    t(key, fallback) {
-        const k = `praxis.filesUpload.${key}`;
-        const v = this.translate?.instant(k);
-        return v && v !== k ? v : fallback;
+    resolveSingleValue(file) {
+        if (this.valueMode === 'id')
+            return file.id;
+        if (this.valueMode === 'metadata[]')
+            return [file];
+        if (this.valueMode === 'id[]')
+            return [file.id];
+        return file;
+    }
+    resolveBulkValue(files) {
+        if (files.length === 0)
+            return null;
+        if (this.valueMode === 'metadata[]')
+            return files;
+        if (this.valueMode === 'id[]')
+            return files.map((file) => file.id);
+        return this.resolveSingleValue(files[0]);
     }
-    onUploadSuccess(event) {
-        const value = this.valueMode === 'id' ? event.file.id : event.file;
+    applyResolvedValue(file) {
+        const value = this.resolveSingleValue(file);
         this.setValue(value);
-        this.control().setErrors(null);
+        this.lastFileName = file.fileName || null;
+        this.control().markAsTouched();
+        this.control().markAsDirty();
+    }
+    clearUploadState() {
+        this.updateUploadValidationState();
         this.uploadError = null;
-        // Atualiza visual
-        this.lastFileName = event.file.fileName || null;
+    }
+    applyUploadErrorState(message, validationKey) {
+        this.updateUploadValidationState(validationKey);
+        this.control().markAsTouched();
+        this.control().markAsDirty();
+        this.uploadError = message;
+    }
+    t(key, fallback) {
+        return resolvePraxisFilesUploadText(this.filesUploadI18n, key, fallback, this.legacyTexts ?? undefined, this.legacyTranslate ?? undefined);
+    }
+    get additionalFilesChipAriaLabel() {
+        const extraFiles = Math.max(this.batchCount - 1, 0);
+        return `${extraFiles} ${this.t('fieldChipAria', 'arquivos adicionais selecionados')}`;
+    }
+    onUploadSuccess(file) {
+        this.applyResolvedValue(file);
+        this.clearUploadState();
         this.batchCount = 1;
+        this.uploadSuccess.emit(file);
     }
-    onBulkComplete(resp) {
-        // Atualiza contador e último nome (primeiro sucesso se houver)
-        const total = Array.isArray(resp?.results) ? resp.results.length : 0;
-        this.batchCount = total;
-        const firstOk = resp?.results?.find((r) => r?.file?.fileName)?.file?.fileName;
-        if (firstOk) {
-            this.lastFileName = String(firstOk);
+    onBulkComplete(data) {
+        const results = data.results;
+        const successfulResults = results.filter((r) => r?.file?.id || r?.file?.fileName);
+        const failedResults = results.filter((r) => !r?.file?.id && !r?.file?.fileName);
+        const successfulFiles = successfulResults
+            .map((result) => result?.file)
+            .filter((file) => !!file);
+        this.batchCount = successfulFiles.length;
+        if (successfulFiles.length > 0) {
+            const value = this.resolveBulkValue(successfulFiles);
+            this.setValue(value);
+            this.lastFileName = successfulFiles[0]?.fileName || null;
+        }
+        if (failedResults.length > 0) {
+            this.applyUploadErrorState(this.t('partialUploadError', 'Upload parcial concluído com falhas em parte do lote.'), 'uploadPartial');
+        }
+        else if (successfulResults.length > 0) {
+            this.clearUploadState();
         }
+        this.bulkComplete.emit(data);
     }
     // When an error occurs, mark the control invalid and show message
     onUploadError(event) {
-        this.control().setErrors({ upload: true });
-        this.control().markAsTouched();
-        this.control().markAsDirty();
-        if (event && typeof event === 'object' && 'code' in event) {
-            this.uploadError = this.errors.map(event).message;
+        let message;
+        if (event &&
+            typeof event === 'object' &&
+            ('code' in event ||
+                'errors' in event ||
+                'status' in event)) {
+            message = this.errors.map(event).message;
         }
         else if (event && typeof event.message === 'string') {
-            this.uploadError = event.message;
+            message = event.message;
         }
         else {
-            this.uploadError = this.t('genericUploadError', 'Erro no envio de arquivo.');
+            message = this.t('genericUploadError', 'Erro no envio de arquivo.');
         }
+        this.applyUploadErrorState(message, 'upload');
+        this.error.emit(event);
     }
     isShellDisabled() {
         try {
@@ -4135,13 +5328,92 @@ class PdxFilesUploadFieldComponent extends SimpleBaseInputComponent {
             return false;
         }
     }
+    isUploadingState() {
+        return !!this.uploader?.isUploading;
+    }
+    get shellAriaLabel() {
+        const base = this.lastFileName
+            ? `${this.t('fieldSelectedSummary', 'Arquivo selecionado')}: ${this.lastFileName}`
+            : this.t('placeholder', 'Selecione ou solte arquivos…');
+        if (this.pendingFiles.length > 0) {
+            return `${this.pendingFiles.length} ${this.t('fieldPendingAriaSuffix', 'arquivos prontos para envio')}`;
+        }
+        return `${base}. ${this.statusSummary}`;
+    }
+    get statusSummary() {
+        if (this.showUploadError) {
+            return this.t('fieldErrorSummary', 'Corrija o erro para continuar');
+        }
+        if (this.pendingFiles.length > 0) {
+            return this.t('fieldPendingSummary', 'Arquivos prontos para envio');
+        }
+        if (this.batchCount > 1) {
+            return `${this.batchCount} ${this.t('fieldSelectedPlural', 'arquivos vinculados')}`;
+        }
+        if (this.lastFileName) {
+            return this.t('fieldSelectedSummary', 'Arquivo selecionado');
+        }
+        return this.t('fieldEmptySummary', 'Nenhum arquivo selecionado');
+    }
     onProximityChange(isActive) {
         this.isProximityActive = isActive;
     }
     openFromShell() {
         if (this.isShellDisabled())
             return;
-        this.uploader?.triggerSelect();
+        this.uploader?.openFileDialog();
+    }
+    get pendingPanelId() {
+        return `${this.componentId()}-pending-panel`;
+    }
+    togglePendingPanel() {
+        if (!this.pendingFiles.length) {
+            this.closePendingPanel(false);
+            return;
+        }
+        if (this.pendingPanelOpen) {
+            this.closePendingPanel();
+            return;
+        }
+        this.pendingPanelOpen = true;
+        this.focusPendingPanelSoon();
+    }
+    closePendingPanel(restoreFocus = true) {
+        if (!this.pendingPanelOpen) {
+            if (restoreFocus) {
+                this.pendingTrigger?.nativeElement.focus();
+            }
+            return;
+        }
+        this.pendingPanelOpen = false;
+        if (restoreFocus) {
+            this.pendingTrigger?.nativeElement.focus();
+        }
+    }
+    onPendingTriggerKeydown(event) {
+        if (event.key === 'ArrowDown' && this.pendingFiles.length > 0) {
+            event.preventDefault();
+            if (!this.pendingPanelOpen) {
+                this.pendingPanelOpen = true;
+            }
+            this.focusPendingPanelSoon();
+        }
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            this.closePendingPanel();
+        }
+    }
+    onPendingPanelKeydown(event) {
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            this.closePendingPanel();
+        }
+    }
+    onPendingOverlayDetach() {
+        if (this.pendingPanelOpen) {
+            this.pendingPanelOpen = false;
+            this.pendingTrigger?.nativeElement.focus();
+        }
     }
     // Ações dos ícones (placeholders para próxima sub-issue)
     onOpenInfo() { }
@@ -4150,117 +5422,215 @@ class PdxFilesUploadFieldComponent extends SimpleBaseInputComponent {
         this.lastFileName = null;
         this.batchCount = 0;
         this.uploadError = null;
+        this.pendingFiles = [];
+        this.uploader?.resetPendingFiles();
         try {
             this.setValue(null);
             const c = this.control();
             c.markAsPristine();
             c.markAsUntouched();
-            c.setErrors(null);
+            this.updateUploadValidationState();
         }
         catch { }
     }
     get policySummary() {
-        const a = this.config?.ui?.accept?.length ? this.config.ui.accept.join(', ') : '—';
-        const maxB = this.config?.limits?.maxFileSizeBytes;
-        const maxMb = maxB ? `${(maxB / 1024 / 1024).toFixed(1)} MB` : '—';
-        const maxN = this.config?.limits?.maxFilesPerBulk ?? 1;
-        return `Tipos: ${a} • Máx/arquivo: ${maxMb} • Máx/itens: ${maxN}`;
+        const accepts = this.config?.ui?.accept?.length
+            ? this.config.ui.accept.join(', ')
+            : this.t('fieldPolicyNotConfigured', 'Não configurado');
+        const maxBytes = this.config?.limits?.maxFileSizeBytes;
+        const maxPerFile = maxBytes
+            ? this.formatBytes(maxBytes)
+            : this.t('fieldPolicyNotConfigured', 'Não configurado');
+        const maxItems = this.config?.limits?.maxFilesPerBulk ?? 1;
+        return [
+            `${this.t('fieldPolicyTypes', 'Tipos')}: ${accepts}`,
+            `${this.t('fieldPolicyMaxPerFile', 'Máx/arquivo')}: ${maxPerFile}`,
+            `${this.t('fieldPolicyMaxItems', 'Máx/itens')}: ${maxItems}`,
+        ].join(' • ');
     }
     onRemovePendingFile(file, event) {
-        event.stopPropagation(); // Impede que o menu feche ao clicar no botão
+        event.stopPropagation();
         this.uploader?.removePendingFile(file);
     }
+    pendingFileSummary(file) {
+        return `${file.name} ${this.formatBytes(file.size)}`;
+    }
     formatBytes(bytes) {
-        if (bytes === 0)
-            return '0 Bytes';
+        if (bytes === 0) {
+            return `0 ${this.t('sizeUnitBytes', 'Bytes')}`;
+        }
         const k = 1024;
-        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+        const sizes = [
+            this.t('sizeUnitBytes', 'Bytes'),
+            this.t('sizeUnitKB', 'KB'),
+            this.t('sizeUnitMB', 'MB'),
+            this.t('sizeUnitGB', 'GB'),
+            this.t('sizeUnitTB', 'TB'),
+        ];
         const i = Math.floor(Math.log(bytes) / Math.log(k));
         return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
     }
+    focusPendingPanelSoon() {
+        setTimeout(() => {
+            this.pendingPanel?.nativeElement.focus();
+        });
+    }
+    updateUploadValidationState(validationKey) {
+        const currentErrors = { ...(this.control().errors ?? {}) };
+        delete currentErrors.upload;
+        delete currentErrors.uploadPartial;
+        if (validationKey) {
+            currentErrors[validationKey] = true;
+        }
+        this.control().setErrors(Object.keys(currentErrors).length ? currentErrors : null);
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PdxFilesUploadFieldComponent, deps: null, target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PdxFilesUploadFieldComponent, isStandalone: true, selector: "pdx-material-files-upload", inputs: { config: "config", valueMode: "valueMode", baseUrl: "baseUrl" }, host: { properties: { "class": "componentCssClasses()", "attr.data-field-type": "\"files-upload\"", "attr.data-field-name": "metadata()?.name", "attr.data-component-id": "componentId()" } }, viewQueries: [{ propertyName: "uploader", first: true, predicate: ["uploader"], descendants: true }], usesInheritance: true, ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "20.3.17", type: PdxFilesUploadFieldComponent, isStandalone: true, selector: "pdx-material-files-upload", inputs: { config: "config", valueMode: "valueMode", baseUrl: "baseUrl" }, outputs: { uploadSuccess: "uploadSuccess", bulkComplete: "bulkComplete", error: "error" }, host: { properties: { "class": "componentCssClasses()", "attr.data-field-type": "\"files-upload\"", "attr.data-field-name": "metadata()?.name", "attr.data-component-id": "componentId()" } }, providers: [providePraxisFilesUploadI18n()], viewQueries: [{ propertyName: "uploader", first: true, predicate: ["uploader"], descendants: true }, { propertyName: "pendingTrigger", first: true, predicate: ["pendingTrigger"], descendants: true }, { propertyName: "pendingPanel", first: true, predicate: ["pendingPanel"], descendants: true }], usesInheritance: true, ngImport: i0, template: `
     <!-- Casca compacta tipo input -->
     <div class="pdx-upload-field-shell"
-         role="button"
-         tabindex="0"
-         [attr.aria-describedby]="componentId() + '-messages'"
+         role="group"
          [class.error]="showUploadError"
          [class.disabled]="isShellDisabled()"
-         [attr.aria-disabled]="isShellDisabled() ? 'true' : null"
          [class.proximity-active]="isProximityActive"
-         (click)="pendingFiles.length === 0 && openFromShell()"
-         (keydown.enter)="pendingFiles.length === 0 && openFromShell(); $event.preventDefault()"
-         (keydown.space)="pendingFiles.length === 0 && openFromShell(); $event.preventDefault()">
+         [attr.aria-busy]="isUploadingState()"
+         [attr.aria-invalid]="showUploadError"
+         [attr.aria-label]="shellAriaLabel">
       <mat-icon class="prefix" aria-hidden="true">attach_file</mat-icon>
       <div class="content">
         <!-- ESTADO 1: Sem arquivos pendentes -->
-        <ng-container *ngIf="pendingFiles.length === 0; else pendingState">
-          <span class="placeholder" *ngIf="!lastFileName">{{ t('placeholder','Selecione ou solte arquivos…') }}</span>
-          <span class="value" *ngIf="lastFileName" [title]="lastFileName">{{ lastFileName }}</span>
-          <span class="chip" *ngIf="batchCount > 1">+{{ batchCount - 1 }}</span>
+        <ng-container *ngIf="pendingFiles.length === 0">
+          <button
+            type="button"
+            class="shell-main-btn"
+            [disabled]="isShellDisabled()"
+            [attr.aria-describedby]="componentId() + '-messages'"
+            (click)="openFromShell()"
+          >
+            <span class="text-stack">
+              <span class="placeholder" *ngIf="!lastFileName">{{ t('placeholder','Selecione ou solte arquivos…') }}</span>
+              <span class="value" *ngIf="lastFileName" [title]="lastFileName">{{ lastFileName }}</span>
+              <span class="meta">{{ statusSummary }}</span>
+            </span>
+            <span class="chip" *ngIf="batchCount > 1" [attr.aria-label]="additionalFilesChipAriaLabel">+{{ batchCount - 1 }}</span>
+          </button>
         </ng-container>
 
         <!-- ESTADO 2: Com arquivos pendentes -->
-        <ng-template #pendingState>
-          <button type="button" class="pending-text-btn" [matMenuTriggerFor]="pendingFilesMenu">
-            <span>{{ pendingFiles.length }} arquivo(s) selecionado(s)</span>
-            <mat-icon>arrow_drop_down</mat-icon>
+        <ng-container *ngIf="pendingFiles.length > 0">
+          <button
+            #pendingTrigger
+            type="button"
+            class="pending-text-btn"
+            [attr.aria-describedby]="componentId() + '-messages'"
+            [attr.aria-controls]="pendingPanelId"
+            [attr.aria-expanded]="pendingPanelOpen"
+            cdkOverlayOrigin
+            #pendingOverlayOrigin="cdkOverlayOrigin"
+            (click)="togglePendingPanel()"
+            (keydown)="onPendingTriggerKeydown($event)"
+          >
+            <span class="text-stack">
+              <span class="value">{{ pendingFiles.length }} {{ t('fieldPendingCountSuffix','file(s) selected') }}</span>
+              <span class="meta">{{ t('fieldPendingSummary','Arquivos prontos para envio') }}</span>
+            </span>
+            <mat-icon aria-hidden="true">arrow_drop_down</mat-icon>
           </button>
-        </ng-template>
+          <ng-template
+            cdkConnectedOverlay
+            [cdkConnectedOverlayOrigin]="pendingOverlayOrigin"
+            [cdkConnectedOverlayOpen]="pendingPanelOpen"
+            [cdkConnectedOverlayHasBackdrop]="true"
+            cdkConnectedOverlayBackdropClass="cdk-overlay-transparent-backdrop"
+            [cdkConnectedOverlayPositions]="pendingOverlayPositions"
+            (backdropClick)="closePendingPanel()"
+            (detach)="onPendingOverlayDetach()"
+          >
+            <div
+              #pendingPanel
+              class="pending-files-overlay"
+              [id]="pendingPanelId"
+              role="list"
+              tabindex="-1"
+              [attr.aria-label]="t('fieldPendingSummary','Arquivos prontos para envio')"
+              (keydown)="onPendingPanelKeydown($event)"
+            >
+              <div
+                class="pending-file-item"
+                *ngFor="let file of pendingFiles"
+                role="listitem"
+                [attr.aria-label]="pendingFileSummary(file)"
+              >
+                <div class="file-info" [title]="file.name">
+                  <span class="file-name">{{ file.name }}</span>
+                  <span class="file-size">({{ formatBytes(file.size) }})</span>
+                </div>
+                <span class="spacer"></span>
+                <button
+                  type="button"
+                  mat-icon-button
+                  class="remove-pending-btn"
+                  (click)="onRemovePendingFile(file, $event)"
+                  [attr.aria-label]="t('removePendingFile','Remove selected file') + ': ' + file.name"
+                >
+                  <mat-icon>close</mat-icon>
+                </button>
+              </div>
+            </div>
+          </ng-template>
+        </ng-container>
       </div>
       <div class="suffixes">
         <!-- Ações para arquivos pendentes -->
         <ng-container *ngIf="pendingFiles.length > 0">
-          <button type="button" class="icon-btn" color="primary" title="Enviar" aria-label="Enviar" (click)="onTriggerUpload(); $event.stopPropagation()">
-            <mat-icon>upload</mat-icon>
+          <button
+            type="button"
+            class="action-btn primary"
+            [attr.aria-label]="t('fieldActionUpload','Enviar arquivos selecionados')"
+            (click)="onTriggerUpload(); $event.stopPropagation()"
+          >
+            <mat-icon aria-hidden="true">upload</mat-icon>
+            <span>{{ t('fieldActionUploadShort','Enviar') }}</span>
           </button>
-          <button type="button" class="icon-btn" color="warn" title="Cancelar Seleção" aria-label="Cancelar Seleção" (click)="onClearSelection(); $event.stopPropagation()">
-            <mat-icon>cancel</mat-icon>
+          <button
+            type="button"
+            class="action-btn"
+            [attr.aria-label]="t('fieldActionCancel','Cancelar seleção atual')"
+            (click)="onClearSelection(); $event.stopPropagation()"
+          >
+            <mat-icon aria-hidden="true">cancel</mat-icon>
+            <span>{{ t('fieldActionCancelShort','Cancelar') }}</span>
           </button>
         </ng-container>
 
         <!-- Ações padrão -->
-        <button type="button" class="icon-btn" title="Informações" aria-label="Informações" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matTooltip]="policySummary">
+        <button type="button" class="icon-btn" [attr.title]="t('fieldInfoAction','Informações')" [attr.aria-label]="t('fieldInfoAction','Informações')" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matTooltip]="policySummary">
           <mat-icon>info</mat-icon>
         </button>
-        <button type="button" class="icon-btn" title="Mais ações" aria-label="Mais ações" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matMenuTriggerFor]="moreMenu">
+        <button type="button" class="icon-btn" [attr.title]="t('fieldMoreActions','Mais ações')" [attr.aria-label]="t('fieldMoreActions','Mais ações')" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matMenuTriggerFor]="moreMenu">
           <mat-icon>more_horiz</mat-icon>
         </button>
         <mat-menu #moreMenu="matMenu">
           <button mat-menu-item (click)="openFromShell()">
             <mat-icon>upload_file</mat-icon>
-            <span>Selecionar arquivo(s)</span>
+            <span>{{ t('fieldActionSelect','Selecionar arquivo(s)') }}</span>
           </button>
           <button mat-menu-item (click)="onClear()" [disabled]="!lastFileName && batchCount === 0">
             <mat-icon>clear</mat-icon>
-            <span>Limpar</span>
+            <span>{{ t('fieldActionClear','Limpar') }}</span>
           </button>
         </mat-menu>
       </div>
     </div>
 
-    <!-- Menu para exibir arquivos pendentes -->
-    <mat-menu #pendingFilesMenu="matMenu" class="pending-files-menu">
-      <ng-template matMenuContent>
-        <button mat-menu-item *ngFor="let file of pendingFiles" (click)="$event.stopPropagation(); $event.preventDefault();" [title]="file.name">
-          <div class="pending-file-item">
-            <div class="file-info">
-              <span class="file-name">{{ file.name }}</span>
-              <span class="file-size">({{ formatBytes(file.size) }})</span>
-            </div>
-            <span class="spacer"></span>
-            <button mat-icon-button class="remove-pending-btn" (click)="onRemovePendingFile(file, $event)" [attr.aria-label]="'Remover ' + file.name">
-              <mat-icon>close</mat-icon>
-            </button>
-          </div>
-        </button>
-      </ng-template>
-    </mat-menu>
-
     <!-- Mensagens do campo (hint/erro) -->
-    <div class="field-messages" [id]="componentId() + '-messages'">
+    <div
+      class="field-messages"
+      [id]="componentId() + '-messages'"
+      [attr.role]="showUploadError ? 'alert' : 'status'"
+      [attr.aria-live]="showUploadError ? 'assertive' : 'polite'"
+    >
       <div class="hint" *ngIf="metadata()?.hint && !showUploadError">{{ metadata()?.hint }}</div>
+      <div class="hint" *ngIf="!metadata()?.hint && !showUploadError">{{ statusSummary }}</div>
       <div class="error" *ngIf="showUploadError">{{ uploadError || t('genericUploadError','Erro no envio de arquivo.') }}</div>
     </div>
 
@@ -4275,94 +5645,167 @@ class PdxFilesUploadFieldComponent extends SimpleBaseInputComponent {
       (uploadSuccess)="onUploadSuccess($event)"
       (bulkComplete)="onBulkComplete($event)"
       (error)="onUploadError($event)"
-      (pendingFilesChange)="handlePendingFiles($event)"
+      (proximityChange)="onProximityChange($event)"
+      (pendingStateChange)="handlePendingState($event)"
     />
-  `, isInline: true, styles: [":host{position:relative}.pdx-upload-field-shell{display:flex;align-items:center;gap:.5rem;padding:.5rem .75rem;border:1px solid var(--pfx-surface-border, #ccc);border-radius:8px;background:var(--pfx-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface);min-height:40px;cursor:pointer}.pdx-upload-field-shell:focus-within{outline:2px solid var(--md-sys-color-primary,#1976d2);outline-offset:2px}.pdx-upload-field-shell.error{border-color:var(--md-sys-color-error,#b00020)}.pdx-upload-field-shell.disabled{opacity:.6;cursor:not-allowed}.pdx-upload-field-shell .prefix{color:var(--md-sys-color-primary,#1976d2)}.pdx-upload-field-shell .content{flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}.pdx-upload-field-shell .placeholder{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .value{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .chip{font-size:.75rem;padding:0 .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.pdx-upload-field-shell .suffixes{display:flex;align-items:center;gap:.25rem}.pdx-upload-field-shell .icon-btn{border:0;background:transparent;padding:.25rem;border-radius:6px;cursor:pointer;color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .icon-btn:hover{background:#ffffff0d}.pdx-upload-field-shell.disabled .icon-btn{cursor:not-allowed}.field-messages{font-size:.82rem;margin-top:.25rem}.field-messages .hint{opacity:.8}.field-messages .error{color:var(--md-sys-color-error,#b00020)}.pending-text-btn{display:flex;align-items:center;gap:.25rem;background:0;border:0;color:var(--md-sys-color-on-surface);font-family:inherit;font-size:inherit;padding:0;margin:0;cursor:pointer}.pending-text-btn span,.pending-text-btn mat-icon{color:inherit}.pending-files-menu .mat-mdc-menu-content{padding:0}.pending-file-item{display:flex;align-items:center;width:100%;gap:.5rem;padding:8px 16px}.pending-file-item .file-info{flex:1;min-width:0;text-align:left}.pending-file-item .file-name{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pending-file-item .file-size{font-size:.8rem;opacity:.7}.pending-file-item .spacer{flex:1 1 auto}.pending-file-item .remove-pending-btn{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell.proximity-active{border-style:dashed;border-color:var(--md-sys-color-primary);transform:scale(1.02);background:var(--md-sys-color-surface-container-low);transition:all .2s ease-in-out}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i7.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i7.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "component", type: PraxisFilesUpload, selector: "praxis-files-upload", inputs: ["config", "filesUploadId", "uploadId", "componentInstanceId", "baseUrl", "displayMode", "context", "editModeEnabled"], outputs: ["uploadSuccess", "bulkComplete", "error", "rateLimited", "uploadStart", "uploadProgress", "uploadError", "retry", "download", "copyLink", "detailsOpened", "detailsClosed", "pendingFilesChange", "proximityChange"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatMenuModule }, { kind: "component", type: i3$1.MatMenu, selector: "mat-menu", inputs: ["backdropClass", "aria-label", "aria-labelledby", "aria-describedby", "xPosition", "yPosition", "overlapTrigger", "hasBackdrop", "class", "classList"], outputs: ["closed", "close"], exportAs: ["matMenu"] }, { kind: "component", type: i3$1.MatMenuItem, selector: "[mat-menu-item]", inputs: ["role", "disabled", "disableRipple"], exportAs: ["matMenuItem"] }, { kind: "directive", type: i3$1.MatMenuContent, selector: "ng-template[matMenuContent]" }, { kind: "directive", type: i3$1.MatMenuTrigger, selector: "[mat-menu-trigger-for], [matMenuTriggerFor]", inputs: ["mat-menu-trigger-for", "matMenuTriggerFor", "matMenuTriggerData", "matMenuTriggerRestoreFocus"], outputs: ["menuOpened", "onMenuOpen", "menuClosed", "onMenuClose"], exportAs: ["matMenuTrigger"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }] });
+  `, isInline: true, styles: [":host{position:relative}.pdx-upload-field-shell{display:flex;align-items:center;gap:.5rem;padding:.5rem .75rem;border:1px solid var(--pfx-surface-border, #ccc);border-radius:8px;background:var(--pfx-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface);min-height:40px}.pdx-upload-field-shell:focus-within{outline:2px solid var(--md-sys-color-primary,#1976d2);outline-offset:2px}.pdx-upload-field-shell.error{border-color:var(--md-sys-color-error,#b00020)}.pdx-upload-field-shell.disabled{opacity:.6;cursor:not-allowed}.pdx-upload-field-shell .prefix{color:var(--md-sys-color-primary,#1976d2)}.pdx-upload-field-shell .content{flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}.pdx-upload-field-shell .shell-main-btn{display:flex;align-items:center;gap:.75rem;flex:1;min-width:0;padding:0;border:0;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer}.pdx-upload-field-shell .shell-main-btn:disabled{cursor:not-allowed}.pdx-upload-field-shell .text-stack{display:flex;flex-direction:column;min-width:0;gap:.125rem}.pdx-upload-field-shell .placeholder{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .value{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .meta{font-size:.78rem;color:var(--md-sys-color-on-surface-variant);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .chip{font-size:.75rem;padding:0 .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.pdx-upload-field-shell .suffixes{display:flex;align-items:center;gap:.375rem}.pdx-upload-field-shell .action-btn{display:inline-flex;align-items:center;gap:.35rem;border:1px solid var(--pfx-surface-border, #ccc);background:transparent;padding:.35rem .6rem;border-radius:999px;cursor:pointer;color:var(--md-sys-color-on-surface);font:inherit}.pdx-upload-field-shell .action-btn.primary{background:var(--md-sys-color-primary);border-color:var(--md-sys-color-primary);color:var(--md-sys-color-on-primary)}.pdx-upload-field-shell .action-btn mat-icon{font-size:18px;width:18px;height:18px}.pdx-upload-field-shell .icon-btn{border:0;background:transparent;padding:.25rem;border-radius:6px;cursor:pointer;color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .icon-btn:hover{background:#ffffff0d}.pdx-upload-field-shell.disabled .icon-btn,.pdx-upload-field-shell.disabled .action-btn{cursor:not-allowed}.field-messages{font-size:.82rem;margin-top:.25rem}.field-messages .hint{opacity:.8}.field-messages .error{color:var(--md-sys-color-error,#b00020)}.pending-text-btn{display:flex;align-items:center;gap:.5rem;background:0;border:0;color:var(--md-sys-color-on-surface);font-family:inherit;font-size:inherit;padding:0;margin:0;cursor:pointer;min-width:0;text-align:left}.pending-text-btn span,.pending-text-btn mat-icon{color:inherit}.pending-files-overlay{display:flex;flex-direction:column;min-width:min(320px,calc(100vw - 32px));max-width:min(480px,calc(100vw - 32px));max-height:240px;overflow:auto;padding:.25rem 0;border:1px solid var(--pfx-surface-border, #ccc);border-radius:12px;background:var(--pfx-surface, var(--md-sys-color-surface));box-shadow:0 12px 30px #0000002e;outline:none}.pending-file-item{display:flex;align-items:center;width:100%;gap:.5rem;padding:8px 16px}.pending-file-item .file-info{flex:1;min-width:0;text-align:left}.pending-file-item .file-name{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pending-file-item .file-size{font-size:.8rem;opacity:.7}.pending-file-item .spacer{flex:1 1 auto}.pending-file-item .remove-pending-btn{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell.proximity-active{border-style:dashed;border-color:var(--md-sys-color-primary);transform:scale(1.02);background:var(--md-sys-color-surface-container-low);transition:all .2s ease-in-out}\n"], dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: i9.NgForOf, selector: "[ngFor][ngForOf]", inputs: ["ngForOf", "ngForTrackBy", "ngForTemplate"] }, { kind: "directive", type: i9.NgIf, selector: "[ngIf]", inputs: ["ngIf", "ngIfThen", "ngIfElse"] }, { kind: "component", type: PraxisFilesUpload, selector: "praxis-files-upload", inputs: ["config", "filesUploadId", "componentInstanceId", "baseUrl", "displayMode", "context", "editModeEnabled"], outputs: ["uploadSuccess", "bulkComplete", "error", "rateLimited", "uploadStart", "uploadProgress", "retry", "download", "copyLink", "detailsOpened", "detailsClosed", "pendingStateChange", "proximityChange", "readinessChange"] }, { kind: "ngmodule", type: MatIconModule }, { kind: "component", type: i10.MatIcon, selector: "mat-icon", inputs: ["color", "inline", "svgIcon", "fontSet", "fontIcon"], exportAs: ["matIcon"] }, { kind: "ngmodule", type: MatMenuModule }, { kind: "component", type: i14.MatMenu, selector: "mat-menu", inputs: ["backdropClass", "aria-label", "aria-labelledby", "aria-describedby", "xPosition", "yPosition", "overlapTrigger", "hasBackdrop", "class", "classList"], outputs: ["closed", "close"], exportAs: ["matMenu"] }, { kind: "component", type: i14.MatMenuItem, selector: "[mat-menu-item]", inputs: ["role", "disabled", "disableRipple"], exportAs: ["matMenuItem"] }, { kind: "directive", type: i14.MatMenuTrigger, selector: "[mat-menu-trigger-for], [matMenuTriggerFor]", inputs: ["mat-menu-trigger-for", "matMenuTriggerFor", "matMenuTriggerData", "matMenuTriggerRestoreFocus"], outputs: ["menuOpened", "onMenuOpen", "menuClosed", "onMenuClose"], exportAs: ["matMenuTrigger"] }, { kind: "ngmodule", type: MatTooltipModule }, { kind: "directive", type: i11$1.MatTooltip, selector: "[matTooltip]", inputs: ["matTooltipPosition", "matTooltipPositionAtOrigin", "matTooltipDisabled", "matTooltipShowDelay", "matTooltipHideDelay", "matTooltipTouchGestures", "matTooltip", "matTooltipClass"], exportAs: ["matTooltip"] }, { kind: "directive", type: CdkConnectedOverlay, selector: "[cdk-connected-overlay], [connected-overlay], [cdkConnectedOverlay]", inputs: ["cdkConnectedOverlayOrigin", "cdkConnectedOverlayPositions", "cdkConnectedOverlayPositionStrategy", "cdkConnectedOverlayOffsetX", "cdkConnectedOverlayOffsetY", "cdkConnectedOverlayWidth", "cdkConnectedOverlayHeight", "cdkConnectedOverlayMinWidth", "cdkConnectedOverlayMinHeight", "cdkConnectedOverlayBackdropClass", "cdkConnectedOverlayPanelClass", "cdkConnectedOverlayViewportMargin", "cdkConnectedOverlayScrollStrategy", "cdkConnectedOverlayOpen", "cdkConnectedOverlayDisableClose", "cdkConnectedOverlayTransformOriginOn", "cdkConnectedOverlayHasBackdrop", "cdkConnectedOverlayLockPosition", "cdkConnectedOverlayFlexibleDimensions", "cdkConnectedOverlayGrowAfterOpen", "cdkConnectedOverlayPush", "cdkConnectedOverlayDisposeOnNavigation"], outputs: ["backdropClick", "positionChange", "attach", "detach", "overlayKeydown", "overlayOutsideClick"], exportAs: ["cdkConnectedOverlay"] }, { kind: "directive", type: CdkOverlayOrigin, selector: "[cdk-overlay-origin], [overlay-origin], [cdkOverlayOrigin]", exportAs: ["cdkOverlayOrigin"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImport: i0, type: PdxFilesUploadFieldComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'pdx-material-files-upload', standalone: true, imports: [CommonModule, PraxisFilesUpload, MatIconModule, MatMenuModule, MatTooltipModule], template: `
+            args: [{ selector: 'pdx-material-files-upload', standalone: true, providers: [providePraxisFilesUploadI18n()], imports: [
+                        CommonModule,
+                        PraxisFilesUpload,
+                        MatIconModule,
+                        MatMenuModule,
+                        MatTooltipModule,
+                        CdkConnectedOverlay,
+                        CdkOverlayOrigin,
+                    ], template: `
     <!-- Casca compacta tipo input -->
     <div class="pdx-upload-field-shell"
-         role="button"
-         tabindex="0"
-         [attr.aria-describedby]="componentId() + '-messages'"
+         role="group"
          [class.error]="showUploadError"
          [class.disabled]="isShellDisabled()"
-         [attr.aria-disabled]="isShellDisabled() ? 'true' : null"
          [class.proximity-active]="isProximityActive"
-         (click)="pendingFiles.length === 0 && openFromShell()"
-         (keydown.enter)="pendingFiles.length === 0 && openFromShell(); $event.preventDefault()"
-         (keydown.space)="pendingFiles.length === 0 && openFromShell(); $event.preventDefault()">
+         [attr.aria-busy]="isUploadingState()"
+         [attr.aria-invalid]="showUploadError"
+         [attr.aria-label]="shellAriaLabel">
       <mat-icon class="prefix" aria-hidden="true">attach_file</mat-icon>
       <div class="content">
         <!-- ESTADO 1: Sem arquivos pendentes -->
-        <ng-container *ngIf="pendingFiles.length === 0; else pendingState">
-          <span class="placeholder" *ngIf="!lastFileName">{{ t('placeholder','Selecione ou solte arquivos…') }}</span>
-          <span class="value" *ngIf="lastFileName" [title]="lastFileName">{{ lastFileName }}</span>
-          <span class="chip" *ngIf="batchCount > 1">+{{ batchCount - 1 }}</span>
+        <ng-container *ngIf="pendingFiles.length === 0">
+          <button
+            type="button"
+            class="shell-main-btn"
+            [disabled]="isShellDisabled()"
+            [attr.aria-describedby]="componentId() + '-messages'"
+            (click)="openFromShell()"
+          >
+            <span class="text-stack">
+              <span class="placeholder" *ngIf="!lastFileName">{{ t('placeholder','Selecione ou solte arquivos…') }}</span>
+              <span class="value" *ngIf="lastFileName" [title]="lastFileName">{{ lastFileName }}</span>
+              <span class="meta">{{ statusSummary }}</span>
+            </span>
+            <span class="chip" *ngIf="batchCount > 1" [attr.aria-label]="additionalFilesChipAriaLabel">+{{ batchCount - 1 }}</span>
+          </button>
         </ng-container>
 
         <!-- ESTADO 2: Com arquivos pendentes -->
-        <ng-template #pendingState>
-          <button type="button" class="pending-text-btn" [matMenuTriggerFor]="pendingFilesMenu">
-            <span>{{ pendingFiles.length }} arquivo(s) selecionado(s)</span>
-            <mat-icon>arrow_drop_down</mat-icon>
+        <ng-container *ngIf="pendingFiles.length > 0">
+          <button
+            #pendingTrigger
+            type="button"
+            class="pending-text-btn"
+            [attr.aria-describedby]="componentId() + '-messages'"
+            [attr.aria-controls]="pendingPanelId"
+            [attr.aria-expanded]="pendingPanelOpen"
+            cdkOverlayOrigin
+            #pendingOverlayOrigin="cdkOverlayOrigin"
+            (click)="togglePendingPanel()"
+            (keydown)="onPendingTriggerKeydown($event)"
+          >
+            <span class="text-stack">
+              <span class="value">{{ pendingFiles.length }} {{ t('fieldPendingCountSuffix','file(s) selected') }}</span>
+              <span class="meta">{{ t('fieldPendingSummary','Arquivos prontos para envio') }}</span>
+            </span>
+            <mat-icon aria-hidden="true">arrow_drop_down</mat-icon>
           </button>
-        </ng-template>
+          <ng-template
+            cdkConnectedOverlay
+            [cdkConnectedOverlayOrigin]="pendingOverlayOrigin"
+            [cdkConnectedOverlayOpen]="pendingPanelOpen"
+            [cdkConnectedOverlayHasBackdrop]="true"
+            cdkConnectedOverlayBackdropClass="cdk-overlay-transparent-backdrop"
+            [cdkConnectedOverlayPositions]="pendingOverlayPositions"
+            (backdropClick)="closePendingPanel()"
+            (detach)="onPendingOverlayDetach()"
+          >
+            <div
+              #pendingPanel
+              class="pending-files-overlay"
+              [id]="pendingPanelId"
+              role="list"
+              tabindex="-1"
+              [attr.aria-label]="t('fieldPendingSummary','Arquivos prontos para envio')"
+              (keydown)="onPendingPanelKeydown($event)"
+            >
+              <div
+                class="pending-file-item"
+                *ngFor="let file of pendingFiles"
+                role="listitem"
+                [attr.aria-label]="pendingFileSummary(file)"
+              >
+                <div class="file-info" [title]="file.name">
+                  <span class="file-name">{{ file.name }}</span>
+                  <span class="file-size">({{ formatBytes(file.size) }})</span>
+                </div>
+                <span class="spacer"></span>
+                <button
+                  type="button"
+                  mat-icon-button
+                  class="remove-pending-btn"
+                  (click)="onRemovePendingFile(file, $event)"
+                  [attr.aria-label]="t('removePendingFile','Remove selected file') + ': ' + file.name"
+                >
+                  <mat-icon>close</mat-icon>
+                </button>
+              </div>
+            </div>
+          </ng-template>
+        </ng-container>
       </div>
       <div class="suffixes">
         <!-- Ações para arquivos pendentes -->
         <ng-container *ngIf="pendingFiles.length > 0">
-          <button type="button" class="icon-btn" color="primary" title="Enviar" aria-label="Enviar" (click)="onTriggerUpload(); $event.stopPropagation()">
-            <mat-icon>upload</mat-icon>
+          <button
+            type="button"
+            class="action-btn primary"
+            [attr.aria-label]="t('fieldActionUpload','Enviar arquivos selecionados')"
+            (click)="onTriggerUpload(); $event.stopPropagation()"
+          >
+            <mat-icon aria-hidden="true">upload</mat-icon>
+            <span>{{ t('fieldActionUploadShort','Enviar') }}</span>
           </button>
-          <button type="button" class="icon-btn" color="warn" title="Cancelar Seleção" aria-label="Cancelar Seleção" (click)="onClearSelection(); $event.stopPropagation()">
-            <mat-icon>cancel</mat-icon>
+          <button
+            type="button"
+            class="action-btn"
+            [attr.aria-label]="t('fieldActionCancel','Cancelar seleção atual')"
+            (click)="onClearSelection(); $event.stopPropagation()"
+          >
+            <mat-icon aria-hidden="true">cancel</mat-icon>
+            <span>{{ t('fieldActionCancelShort','Cancelar') }}</span>
           </button>
         </ng-container>
 
         <!-- Ações padrão -->
-        <button type="button" class="icon-btn" title="Informações" aria-label="Informações" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matTooltip]="policySummary">
+        <button type="button" class="icon-btn" [attr.title]="t('fieldInfoAction','Informações')" [attr.aria-label]="t('fieldInfoAction','Informações')" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matTooltip]="policySummary">
           <mat-icon>info</mat-icon>
         </button>
-        <button type="button" class="icon-btn" title="Mais ações" aria-label="Mais ações" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matMenuTriggerFor]="moreMenu">
+        <button type="button" class="icon-btn" [attr.title]="t('fieldMoreActions','Mais ações')" [attr.aria-label]="t('fieldMoreActions','Mais ações')" (click)="$event.stopPropagation()" [disabled]="isShellDisabled()" [matMenuTriggerFor]="moreMenu">
           <mat-icon>more_horiz</mat-icon>
         </button>
         <mat-menu #moreMenu="matMenu">
           <button mat-menu-item (click)="openFromShell()">
             <mat-icon>upload_file</mat-icon>
-            <span>Selecionar arquivo(s)</span>
+            <span>{{ t('fieldActionSelect','Selecionar arquivo(s)') }}</span>
           </button>
           <button mat-menu-item (click)="onClear()" [disabled]="!lastFileName && batchCount === 0">
             <mat-icon>clear</mat-icon>
-            <span>Limpar</span>
+            <span>{{ t('fieldActionClear','Limpar') }}</span>
           </button>
         </mat-menu>
       </div>
     </div>
 
-    <!-- Menu para exibir arquivos pendentes -->
-    <mat-menu #pendingFilesMenu="matMenu" class="pending-files-menu">
-      <ng-template matMenuContent>
-        <button mat-menu-item *ngFor="let file of pendingFiles" (click)="$event.stopPropagation(); $event.preventDefault();" [title]="file.name">
-          <div class="pending-file-item">
-            <div class="file-info">
-              <span class="file-name">{{ file.name }}</span>
-              <span class="file-size">({{ formatBytes(file.size) }})</span>
-            </div>
-            <span class="spacer"></span>
-            <button mat-icon-button class="remove-pending-btn" (click)="onRemovePendingFile(file, $event)" [attr.aria-label]="'Remover ' + file.name">
-              <mat-icon>close</mat-icon>
-            </button>
-          </div>
-        </button>
-      </ng-template>
-    </mat-menu>
-
     <!-- Mensagens do campo (hint/erro) -->
-    <div class="field-messages" [id]="componentId() + '-messages'">
+    <div
+      class="field-messages"
+      [id]="componentId() + '-messages'"
+      [attr.role]="showUploadError ? 'alert' : 'status'"
+      [attr.aria-live]="showUploadError ? 'assertive' : 'polite'"
+    >
       <div class="hint" *ngIf="metadata()?.hint && !showUploadError">{{ metadata()?.hint }}</div>
+      <div class="hint" *ngIf="!metadata()?.hint && !showUploadError">{{ statusSummary }}</div>
       <div class="error" *ngIf="showUploadError">{{ uploadError || t('genericUploadError','Erro no envio de arquivo.') }}</div>
     </div>
 
@@ -4377,83 +5820,38 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.17", ngImpo
       (uploadSuccess)="onUploadSuccess($event)"
       (bulkComplete)="onBulkComplete($event)"
       (error)="onUploadError($event)"
-      (pendingFilesChange)="handlePendingFiles($event)"
+      (proximityChange)="onProximityChange($event)"
+      (pendingStateChange)="handlePendingState($event)"
     />
   `, host: {
                         '[class]': 'componentCssClasses()',
                         '[attr.data-field-type]': '"files-upload"',
                         '[attr.data-field-name]': 'metadata()?.name',
                         '[attr.data-component-id]': 'componentId()',
-                    }, styles: [":host{position:relative}.pdx-upload-field-shell{display:flex;align-items:center;gap:.5rem;padding:.5rem .75rem;border:1px solid var(--pfx-surface-border, #ccc);border-radius:8px;background:var(--pfx-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface);min-height:40px;cursor:pointer}.pdx-upload-field-shell:focus-within{outline:2px solid var(--md-sys-color-primary,#1976d2);outline-offset:2px}.pdx-upload-field-shell.error{border-color:var(--md-sys-color-error,#b00020)}.pdx-upload-field-shell.disabled{opacity:.6;cursor:not-allowed}.pdx-upload-field-shell .prefix{color:var(--md-sys-color-primary,#1976d2)}.pdx-upload-field-shell .content{flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}.pdx-upload-field-shell .placeholder{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .value{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .chip{font-size:.75rem;padding:0 .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.pdx-upload-field-shell .suffixes{display:flex;align-items:center;gap:.25rem}.pdx-upload-field-shell .icon-btn{border:0;background:transparent;padding:.25rem;border-radius:6px;cursor:pointer;color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .icon-btn:hover{background:#ffffff0d}.pdx-upload-field-shell.disabled .icon-btn{cursor:not-allowed}.field-messages{font-size:.82rem;margin-top:.25rem}.field-messages .hint{opacity:.8}.field-messages .error{color:var(--md-sys-color-error,#b00020)}.pending-text-btn{display:flex;align-items:center;gap:.25rem;background:0;border:0;color:var(--md-sys-color-on-surface);font-family:inherit;font-size:inherit;padding:0;margin:0;cursor:pointer}.pending-text-btn span,.pending-text-btn mat-icon{color:inherit}.pending-files-menu .mat-mdc-menu-content{padding:0}.pending-file-item{display:flex;align-items:center;width:100%;gap:.5rem;padding:8px 16px}.pending-file-item .file-info{flex:1;min-width:0;text-align:left}.pending-file-item .file-name{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pending-file-item .file-size{font-size:.8rem;opacity:.7}.pending-file-item .spacer{flex:1 1 auto}.pending-file-item .remove-pending-btn{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell.proximity-active{border-style:dashed;border-color:var(--md-sys-color-primary);transform:scale(1.02);background:var(--md-sys-color-surface-container-low);transition:all .2s ease-in-out}\n"] }]
+                    }, styles: [":host{position:relative}.pdx-upload-field-shell{display:flex;align-items:center;gap:.5rem;padding:.5rem .75rem;border:1px solid var(--pfx-surface-border, #ccc);border-radius:8px;background:var(--pfx-surface, var(--md-sys-color-surface));color:var(--md-sys-color-on-surface);min-height:40px}.pdx-upload-field-shell:focus-within{outline:2px solid var(--md-sys-color-primary,#1976d2);outline-offset:2px}.pdx-upload-field-shell.error{border-color:var(--md-sys-color-error,#b00020)}.pdx-upload-field-shell.disabled{opacity:.6;cursor:not-allowed}.pdx-upload-field-shell .prefix{color:var(--md-sys-color-primary,#1976d2)}.pdx-upload-field-shell .content{flex:1;min-width:0;display:flex;align-items:center;gap:.5rem}.pdx-upload-field-shell .shell-main-btn{display:flex;align-items:center;gap:.75rem;flex:1;min-width:0;padding:0;border:0;background:transparent;color:inherit;font:inherit;text-align:left;cursor:pointer}.pdx-upload-field-shell .shell-main-btn:disabled{cursor:not-allowed}.pdx-upload-field-shell .text-stack{display:flex;flex-direction:column;min-width:0;gap:.125rem}.pdx-upload-field-shell .placeholder{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .value{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .meta{font-size:.78rem;color:var(--md-sys-color-on-surface-variant);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pdx-upload-field-shell .chip{font-size:.75rem;padding:0 .4rem;border-radius:999px;background:var(--md-sys-color-primary-container);color:var(--md-sys-color-on-primary-container)}.pdx-upload-field-shell .suffixes{display:flex;align-items:center;gap:.375rem}.pdx-upload-field-shell .action-btn{display:inline-flex;align-items:center;gap:.35rem;border:1px solid var(--pfx-surface-border, #ccc);background:transparent;padding:.35rem .6rem;border-radius:999px;cursor:pointer;color:var(--md-sys-color-on-surface);font:inherit}.pdx-upload-field-shell .action-btn.primary{background:var(--md-sys-color-primary);border-color:var(--md-sys-color-primary);color:var(--md-sys-color-on-primary)}.pdx-upload-field-shell .action-btn mat-icon{font-size:18px;width:18px;height:18px}.pdx-upload-field-shell .icon-btn{border:0;background:transparent;padding:.25rem;border-radius:6px;cursor:pointer;color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell .icon-btn:hover{background:#ffffff0d}.pdx-upload-field-shell.disabled .icon-btn,.pdx-upload-field-shell.disabled .action-btn{cursor:not-allowed}.field-messages{font-size:.82rem;margin-top:.25rem}.field-messages .hint{opacity:.8}.field-messages .error{color:var(--md-sys-color-error,#b00020)}.pending-text-btn{display:flex;align-items:center;gap:.5rem;background:0;border:0;color:var(--md-sys-color-on-surface);font-family:inherit;font-size:inherit;padding:0;margin:0;cursor:pointer;min-width:0;text-align:left}.pending-text-btn span,.pending-text-btn mat-icon{color:inherit}.pending-files-overlay{display:flex;flex-direction:column;min-width:min(320px,calc(100vw - 32px));max-width:min(480px,calc(100vw - 32px));max-height:240px;overflow:auto;padding:.25rem 0;border:1px solid var(--pfx-surface-border, #ccc);border-radius:12px;background:var(--pfx-surface, var(--md-sys-color-surface));box-shadow:0 12px 30px #0000002e;outline:none}.pending-file-item{display:flex;align-items:center;width:100%;gap:.5rem;padding:8px 16px}.pending-file-item .file-info{flex:1;min-width:0;text-align:left}.pending-file-item .file-name{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.pending-file-item .file-size{font-size:.8rem;opacity:.7}.pending-file-item .spacer{flex:1 1 auto}.pending-file-item .remove-pending-btn{color:var(--md-sys-color-on-surface-variant)}.pdx-upload-field-shell.proximity-active{border-style:dashed;border-color:var(--md-sys-color-primary);transform:scale(1.02);background:var(--md-sys-color-surface-container-low);transition:all .2s ease-in-out}\n"] }]
         }], propDecorators: { config: [{
                 type: Input
             }], valueMode: [{
                 type: Input
             }], baseUrl: [{
                 type: Input
+            }], uploadSuccess: [{
+                type: Output
+            }], bulkComplete: [{
+                type: Output
+            }], error: [{
+                type: Output
             }], uploader: [{
                 type: ViewChild,
                 args: ['uploader']
+            }], pendingTrigger: [{
+                type: ViewChild,
+                args: ['pendingTrigger']
+            }], pendingPanel: [{
+                type: ViewChild,
+                args: ['pendingPanel']
             }] } });
 
-const FILES_UPLOAD_PT_BR = {
-    'praxis.filesUpload.settingsAriaLabel': 'Abrir configurações',
-    'praxis.filesUpload.dropzoneLabel': 'Arraste arquivos ou',
-    'praxis.filesUpload.dropzoneButton': 'selecionar',
-    'praxis.filesUpload.conflictPolicyLabel': 'Política de conflito',
-    'praxis.filesUpload.metadataLabel': 'Metadados (JSON)',
-    'praxis.filesUpload.progressAriaLabel': 'Progresso do upload',
-    'praxis.filesUpload.rateLimitBanner': 'Limite de requisições excedido. Tente novamente às',
-    'praxis.filesUpload.settingsTitle': 'Configuração de Upload de Arquivos',
-    'praxis.filesUpload.statusSuccess': 'Enviado',
-    'praxis.filesUpload.statusError': 'Erro',
-    'praxis.filesUpload.invalidMetadata': 'Metadados inválidos.',
-    'praxis.filesUpload.genericUploadError': 'Erro no envio de arquivo.',
-    'praxis.filesUpload.acceptError': 'Tipo de arquivo não permitido.',
-    'praxis.filesUpload.maxFileSizeError': 'Arquivo excede o tamanho máximo.',
-    'praxis.filesUpload.maxFilesPerBulkError': 'Quantidade de arquivos excedida.',
-    'praxis.filesUpload.maxBulkSizeError': 'Tamanho total dos arquivos excedido.',
-    'praxis.filesUpload.errors.INVALID_FILE_TYPE': 'Tipo de arquivo inválido.',
-    'praxis.filesUpload.errors.FILE_TOO_LARGE': 'Arquivo muito grande.',
-    'praxis.filesUpload.errors.NOT_FOUND': 'Arquivo não encontrado.',
-    'praxis.filesUpload.errors.UNAUTHORIZED': 'Requisição não autorizada.',
-    'praxis.filesUpload.errors.RATE_LIMIT_EXCEEDED': 'Limite de requisições excedido.',
-    'praxis.filesUpload.errors.INTERNAL_ERROR': 'Erro interno do servidor.',
-    'praxis.filesUpload.errors.QUOTA_EXCEEDED': 'Cota excedida.',
-    'praxis.filesUpload.errors.SEC_VIRUS_DETECTED': 'Vírus detectado no arquivo.',
-    'praxis.filesUpload.errors.SEC_MALICIOUS_CONTENT': 'Conteúdo malicioso detectado.',
-    'praxis.filesUpload.errors.SEC_DANGEROUS_TYPE': 'Tipo de arquivo perigoso.',
-    'praxis.filesUpload.errors.FMT_MAGIC_MISMATCH': 'Conteúdo do arquivo incompatível.',
-    'praxis.filesUpload.errors.FMT_CORRUPTED': 'Arquivo corrompido.',
-    'praxis.filesUpload.errors.FMT_UNSUPPORTED': 'Formato de arquivo não suportado.',
-    'praxis.filesUpload.errors.SYS_STORAGE_ERROR': 'Erro de armazenamento.',
-    'praxis.filesUpload.errors.SYS_SERVICE_DOWN': 'Serviço indisponível.',
-    'praxis.filesUpload.errors.SYS_RATE_LIMIT': 'Limite de requisições excedido.',
-    // Aliases PT-BR do backend e códigos adicionais
-    'praxis.filesUpload.errors.ARQUIVO_MUITO_GRANDE': 'Arquivo muito grande.',
-    'praxis.filesUpload.errors.TIPO_ARQUIVO_INVALIDO': 'Tipo de arquivo inválido.',
-    'praxis.filesUpload.errors.TIPO_MIDIA_NAO_SUPORTADO': 'Tipo de mídia não suportado.',
-    'praxis.filesUpload.errors.CAMPO_OBRIGATORIO_AUSENTE': 'Campo obrigatório ausente.',
-    'praxis.filesUpload.errors.OPCOES_JSON_INVALIDAS': 'JSON de opções inválido.',
-    'praxis.filesUpload.errors.ARGUMENTO_INVALIDO': 'Argumento inválido.',
-    'praxis.filesUpload.errors.NAO_AUTORIZADO': 'Autenticação necessária.',
-    'praxis.filesUpload.errors.ERRO_INTERNO': 'Erro interno do servidor.',
-    'praxis.filesUpload.errors.LIMITE_TAXA_EXCEDIDO': 'Limite de taxa excedido.',
-    'praxis.filesUpload.errors.COTA_EXCEDIDA': 'Cota excedida.',
-    'praxis.filesUpload.errors.ARQUIVO_JA_EXISTE': 'Arquivo já existe.',
-    // Outros possíveis códigos mapeados no catálogo
-    'praxis.filesUpload.errors.INVALID_JSON_OPTIONS': 'JSON de opções inválido.',
-    'praxis.filesUpload.errors.EMPTY_FILENAME': 'Nome do arquivo obrigatório.',
-    'praxis.filesUpload.errors.FILE_EXISTS': 'Arquivo já existe.',
-    'praxis.filesUpload.errors.PATH_TRAVERSAL': 'Path traversal detectado.',
-    'praxis.filesUpload.errors.INSUFFICIENT_STORAGE': 'Sem espaço em disco.',
-    'praxis.filesUpload.errors.UPLOAD_TIMEOUT': 'Tempo esgotado no upload.',
-    'praxis.filesUpload.errors.BULK_UPLOAD_TIMEOUT': 'Tempo esgotado no upload em lote.',
-    'praxis.filesUpload.errors.BULK_UPLOAD_CANCELLED': 'Upload em lote cancelado.',
-    'praxis.filesUpload.errors.USER_CANCELLED': 'Upload cancelado pelo usuário.',
-    'praxis.filesUpload.errors.UNKNOWN_ERROR': 'Erro desconhecido.',
-};
-
 const PRAXIS_FILES_UPLOAD_COMPONENT_METADATA = {
     id: 'praxis-files-upload',
     selector: 'praxis-files-upload',
@@ -4474,12 +5872,6 @@ const PRAXIS_FILES_UPLOAD_COMPONENT_METADATA = {
             label: 'Upload ID',
             description: 'Identificador logico do upload para persistencia e rastreamento.',
         },
-        {
-            name: 'uploadId',
-            type: 'string',
-            label: 'Upload ID (alias)',
-            description: 'Alias funcional de filesUploadId para compatibilidade com hosts.',
-        },
         {
             name: 'componentInstanceId',
             type: 'string',
@@ -4516,13 +5908,13 @@ const PRAXIS_FILES_UPLOAD_COMPONENT_METADATA = {
     outputs: [
         {
             name: 'uploadSuccess',
-            type: '{ file: FileMetadata }',
+            type: 'FileMetadata',
             label: 'Upload concluido',
             description: 'Disparado quando o upload e finalizado com sucesso.',
         },
         {
             name: 'bulkComplete',
-            type: 'BulkUploadResponse',
+            type: 'BulkUploadResponseData',
             label: 'Upload em lote concluido',
             description: 'Disparado quando o upload em lote e finalizado.',
         },
@@ -4550,12 +5942,6 @@ const PRAXIS_FILES_UPLOAD_COMPONENT_METADATA = {
             label: 'Progresso',
             description: 'Disparado conforme o progresso de upload.',
         },
-        {
-            name: 'uploadError',
-            type: 'ErrorResponse',
-            label: 'Erro no upload',
-            description: 'Disparado quando ocorre erro durante o upload.',
-        },
         {
             name: 'retry',
             type: 'BulkUploadFileResult',
@@ -4587,10 +5973,10 @@ const PRAXIS_FILES_UPLOAD_COMPONENT_METADATA = {
             description: 'Disparado quando os detalhes do item sao fechados.',
         },
         {
-            name: 'pendingFilesChange',
-            type: 'File[]',
+            name: 'pendingStateChange',
+            type: 'PendingFilesState',
             label: 'Arquivos pendentes',
-            description: 'Disparado quando a lista de arquivos pendentes muda.',
+            description: 'Disparado quando o estado de selecao pendente muda.',
         },
         {
             name: 'proximityChange',
@@ -4728,7 +6114,7 @@ const FILES_UPLOAD_AI_CAPABILITIES = {
     notes: [
         'limits.maxFileSizeBytes and limits.maxBulkSizeBytes are bytes (e.g., 10485760 for 10MB).',
         'options.allowedExtensions is enforced by backend validation; ui.accept is only a client hint.',
-        'Use limits.defaultConflictPolicy to control name collisions on upload.',
+        'Use options.defaultConflictPolicy to control name collisions on upload.',
     ],
     capabilities: [
         { path: 'strategy', category: 'strategy', valueKind: 'enum', allowedValues: ENUMS.strategy, description: 'Upload strategy.' },
@@ -4759,11 +6145,10 @@ const FILES_UPLOAD_AI_CAPABILITIES = {
         { path: 'limits.maxFileSizeBytes', category: 'limits', valueKind: 'number', description: 'Max file size (bytes).' },
         { path: 'limits.maxFilesPerBulk', category: 'limits', valueKind: 'number', description: 'Max files per bulk upload.' },
         { path: 'limits.maxBulkSizeBytes', category: 'limits', valueKind: 'number', description: 'Max bulk size (bytes).' },
-        { path: 'limits.defaultConflictPolicy', category: 'limits', valueKind: 'enum', allowedValues: ENUMS.conflictPolicy, description: 'Default conflict policy.' },
-        { path: 'limits.failFast', category: 'limits', valueKind: 'boolean', description: 'Abort on first error.' },
-        { path: 'limits.strictValidation', category: 'limits', valueKind: 'boolean', description: 'Strict client validation.' },
-        { path: 'limits.maxUploadSizeMb', category: 'limits', valueKind: 'number', description: 'Max upload size in MB.' },
         { path: 'options', category: 'options', valueKind: 'object', description: 'Backend options sent as JSON.' },
+        { path: 'options.defaultConflictPolicy', category: 'options', valueKind: 'enum', allowedValues: ENUMS.conflictPolicy, description: 'Default conflict policy.' },
+        { path: 'options.strictValidation', category: 'options', valueKind: 'boolean', description: 'Strict backend validation.' },
+        { path: 'options.maxUploadSizeMb', category: 'options', valueKind: 'number', description: 'Max upload size in MB.' },
         { path: 'options.allowedExtensions', category: 'options', valueKind: 'array', description: 'Allowed file extensions.' },
         { path: 'options.allowedExtensions[]', category: 'options', valueKind: 'string', description: 'Single extension (e.g., pdf).' },
         { path: 'options.acceptMimeTypes', category: 'options', valueKind: 'array', description: 'Allowed mime types.' },
@@ -4771,6 +6156,7 @@ const FILES_UPLOAD_AI_CAPABILITIES = {
         { path: 'options.targetDirectory', category: 'options', valueKind: 'string', description: 'Target directory on backend.' },
         { path: 'options.enableVirusScanning', category: 'options', valueKind: 'boolean', description: 'Enable virus scanning.' },
         { path: 'bulk', category: 'bulk', valueKind: 'object', description: 'Bulk upload tuning.' },
+        { path: 'bulk.failFast', category: 'bulk', valueKind: 'boolean', description: 'Abort on first error.' },
         { path: 'bulk.parallelUploads', category: 'bulk', valueKind: 'number', description: 'Parallel uploads count.' },
         { path: 'bulk.retryCount', category: 'bulk', valueKind: 'number', description: 'Retry count.' },
         { path: 'bulk.retryBackoffMs', category: 'bulk', valueKind: 'number', description: 'Retry backoff (ms).' },
@@ -4799,5 +6185,5 @@ const FILES_UPLOAD_AI_CAPABILITIES = {
  * Generated bundle index. Do not edit.
  */
 
-export { BulkUploadResultStatus, ErrorCode, ErrorMapperService, FILES_UPLOAD_AI_CAPABILITIES, FILES_UPLOAD_ERROR_MESSAGES, FILES_UPLOAD_PT_BR, FILES_UPLOAD_TEXTS, FilesApiClient, PRAXIS_FILES_UPLOAD_COMPONENT_METADATA, PdxFilesUploadFieldComponent, PraxisFilesUpload, PraxisFilesUploadConfigEditor, PresignedUploaderService, ScanStatus, TRANSLATE_LIKE, acceptValidator, maxBulkSizeValidator, maxFileSizeValidator, maxFilesPerBulkValidator, providePraxisFilesUploadMetadata };
+export { BulkUploadResultStatus, ErrorCode, ErrorMapperService, FILES_UPLOAD_AI_CAPABILITIES, FILES_UPLOAD_EN_US, FILES_UPLOAD_ERROR_MESSAGES, FILES_UPLOAD_PT_BR, FILES_UPLOAD_TEXTS, FilesApiClient, PRAXIS_FILES_UPLOAD_COMPONENT_METADATA, PdxFilesUploadFieldComponent, PraxisFilesUpload, PraxisFilesUploadConfigEditor, PresignedUploaderService, ScanStatus, TRANSLATE_LIKE, acceptValidator, createPraxisFilesUploadI18nConfig, getPrimaryErrorItem, isErrorEnvelope, maxBulkSizeValidator, maxFileSizeValidator, maxFilesPerBulkValidator, providePraxisFilesUploadI18n, providePraxisFilesUploadMetadata, resolvePraxisFilesUploadText };
 //# sourceMappingURL=praxisui-files-upload.mjs.map