structra-ui 0.1.77 → 0.1.79

package/package.json

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

package/types/structra-ui.d.ts

@@ -4,6 +4,7 @@ import { ControlValueAccessor, AbstractControl, NgControl, ValidatorFn } from '@
 import { MatDatepicker } from '@angular/material/datepicker';
 import * as _angular_cdk_overlay from '@angular/cdk/overlay';
 import { ConnectedPosition, ScrollStrategy, OverlayRef } from '@angular/cdk/overlay';
+import { SafeResourceUrl } from '@angular/platform-browser';
 import { ICellRendererParams, ColDef, GetRowIdParams, GridReadyEvent } from 'ag-grid-community';
 import { ICellRendererAngularComp } from 'ag-grid-angular';
 import { DialogRef } from '@angular/cdk/dialog';
@@ -16,7 +17,12 @@ declare enum BaseButtonVariant {
     Primary = "primary",
     Secondary = "secondary",
     /** Texto/ícone sem caixa — navegação secundária, “link” com aparência de botão acessível. */
-    Ghost = "ghost"
+    Ghost = "ghost",
+    /**
+     * Ação destrutiva / apagar: tokens de erro do tema
+     * (`--app-color-error*`), mesmo padrão em toda a lib.
+     */
+    Danger = "danger"
 }
 declare enum BaseButtonType {
     Button = "button",
@@ -1237,6 +1243,187 @@ interface DropdownListBindings<T = unknown> {
     compareWith: (a: unknown, b: unknown) => boolean;
 }
 
+declare class FileUploadFieldComponent implements OnChanges, OnDestroy {
+    private readonly cdr;
+    private readonly confirmDialog;
+    label?: string | undefined;
+    hint?: string | undefined;
+    accept?: string | undefined;
+    /** Se definido, mostra-se no drop zone em vez do texto formatado a partir de `accept`. */
+    acceptLabel?: string | undefined;
+    maxSizeMb: number;
+    /**
+     * Limite de arquivos no total (só aplica com `multiple`).
+     * `0` = sem limite; ao exceder, o excedente é rejeitado e emite `fileRejected`.
+     */
+    maxFiles: number;
+    disabled: boolean;
+    multiple: boolean;
+    value: File | File[] | null;
+    /**
+     * `false` desativa o `pointer` e a emissão de `fileItemClick` na linha, mesmo com o
+     * evento ligado (ex. lista só com um ficheiro). Omissão = `true`.
+     */
+    fileItemRowClickable: boolean;
+    /**
+     * Botão «Download» em cada linha. Omissão = `true`. Use `false` para esconder (ex.: anexos no form exemplo).
+     */
+    showFileDownload: boolean;
+    readonly valueChange: EventEmitter<File | File[] | null>;
+    readonly fileRejected: EventEmitter<{
+        file: File;
+        reason: string;
+    }>;
+    /**
+     * Clique na linha da lista (ficheiro). Só aplica `cursor: pointer` com subscrição
+     * a este evento e `fileItemRowClickable !== false`.
+     */
+    readonly fileItemClick: EventEmitter<File>;
+    private fileInputRef?;
+    readonly fieldId: string;
+    isDragging: boolean;
+    hasHover: boolean;
+    private internalError;
+    /** `URL.createObjectURL` por `File` ativo; revogado ao trocar valor ou destruir. */
+    private readonly filePreviewObjectUrls;
+    ngOnChanges(c: SimpleChanges): void;
+    ngOnDestroy(): void;
+    get errorMessage(): string | null;
+    /** Texto de formatos na zona: `acceptLabel` (opcional) ou `formatAcceptForDisplay(accept)`. */
+    get acceptDisplayText(): string;
+    /**
+     * Linha clicável para o painel externo (ex. pré-visualização) quando a app liga
+     * `(fileItemClick)`; desligado, sem apontador nem emissão.
+     */
+    get fileItemClickActive(): boolean;
+    private get hasFileItemClickListeners();
+    onFileItemRowClick(event: MouseEvent, file: File): void;
+    /** `src` da miniatura, ou `null` se não for imagem / ainda sem URL. */
+    imageListPreviewUrl(file: File): string | null;
+    get filesList(): {
+        file: File;
+        name: string;
+        sizeLabel: string;
+        typeLabel: string;
+    }[];
+    get hasValue(): boolean;
+    /**
+     * «Limpar tudo» só com mais do que um ficheiro; com um só, basta «Remover» na linha.
+     */
+    get showClearAllButton(): boolean;
+    private get selectedFileCountForClearConfirm();
+    private resetInputValue;
+    openSelector(ev?: Event): void;
+    onZoneEnter(): void;
+    onZoneLeave(): void;
+    onZoneKeydown(ev: KeyboardEvent): void;
+    onDragOver(ev: DragEvent): void;
+    onDragLeave(ev: DragEvent): void;
+    onDrop(ev: DragEvent): void;
+    onNativeChange(ev: Event): void;
+    onRemoveFile(index: number, ev: Event): void;
+    onDownloadFile(file: File, event: Event): void;
+    clearAll(ev: Event): Promise<void>;
+    private clearInternal;
+    private msgAfterRejections;
+    private processPickedArray;
+    private allFilesInValue;
+    private syncFilePreviewObjectUrls;
+    private releaseAllFilePreviewObjectUrls;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FileUploadFieldComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FileUploadFieldComponent, "app-file-upload-field", never, { "label": { "alias": "label"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "accept": { "alias": "accept"; "required": false; }; "acceptLabel": { "alias": "acceptLabel"; "required": false; }; "maxSizeMb": { "alias": "maxSizeMb"; "required": false; }; "maxFiles": { "alias": "maxFiles"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "value": { "alias": "value"; "required": false; }; "fileItemRowClickable": { "alias": "fileItemRowClickable"; "required": false; }; "showFileDownload": { "alias": "showFileDownload"; "required": false; }; }, { "valueChange": "valueChange"; "fileRejected": "fileRejected"; "fileItemClick": "fileItemClick"; }, never, never, true, never>;
+    static ngAcceptInputType_maxSizeMb: unknown;
+    static ngAcceptInputType_maxFiles: unknown;
+    static ngAcceptInputType_disabled: unknown;
+    static ngAcceptInputType_multiple: unknown;
+    static ngAcceptInputType_fileItemRowClickable: unknown;
+}
+
+/**
+ * Valida se um arquivo corresponde a um atributo `accept` (HTML) simples.
+ * Ex.: `image/*`, `image/png`, `.pdf`, `image/*,.pdf`
+ */
+declare function fileMatchesAccept(file: File, accept: string | undefined | null): boolean;
+/**
+ * Diz se o ficheiro deve ser tratado como imagem (miniatura no upload).
+ * Usa `type` e, se vazio, a extensão (útil com MIME vazio nalguns browsers / SO).
+ */
+declare function fileIsLikelyImage(file: File): boolean;
+/** Indica o tipo de pré-visualização possível no painel a partir de um `File` local. */
+type FilePreviewKind = 'image' | 'pdf' | 'unsupported';
+declare const FILE_PREVIEW_UNAVAILABLE_MESSAGE = "N\u00E3o foi poss\u00EDvel abrir a pr\u00E9-visualiza\u00E7\u00E3o.";
+/**
+ * Fragmento URL para o leitor de PDF do browser em `<iframe>` (p.ex. blob:).
+ * Esconde o painel lateral (miniaturas), mantém a barra de cima e ajusta a área principal à largura
+ * (parâmetros de abertura alinhados ao leitor do Chromium; outros browsers podem interpretar de forma aproximada).
+ */
+declare const PDF_IFRAME_VIEWER_HASH = "navpanes=0&toolbar=1&view=FitH";
+/**
+ * Anexa ao fim de uma URL de recurso PDF o fragmento que pedia pré-visualização só com a área principal
+ * (sem barra lateral). Se já existir `#`, devolve a URL inalterada.
+ */
+declare function appendPdfIframeViewerParams(resourceUrl: string): string;
+declare function getFilePreviewKind(file: File): FilePreviewKind;
+declare function formatFileSizeBytes(bytes: number): string;
+/**
+ * Converte o valor do atributo `accept` (vírgulas, MIME, extensões) numa linha legível
+ * (ex.: «Imagens · PDF · Word»), usada no rótulo de formatos do drop zone.
+ */
+declare function formatAcceptForDisplay(accept: string | null | undefined): string;
+
+/**
+ * Painel reutilizável de pré-visualização (imagem, PDF com blob, URL remota, vazio
+ * ou aviso único se não for possível pré-visualizar).
+ */
+declare class ImagePreviewPanelComponent implements OnChanges, OnDestroy {
+    private readonly cdr;
+    private readonly sanitizer;
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    imageUrl?: string | null;
+    file?: File | null;
+    emptyText?: string | undefined;
+    loading: boolean;
+    rounded: boolean;
+    showImageActions: boolean;
+    objectFit: 'cover' | 'contain';
+    readonly remove: EventEmitter<void>;
+    readonly change: EventEmitter<void>;
+    readonly BaseButtonType: typeof BaseButtonType;
+    readonly BaseButtonVariant: typeof BaseButtonVariant;
+    /** Mensagem reutilizada: falha de carga, tipo não suportado, etc. */
+    readonly previewUnavailableMessage = "N\u00E3o foi poss\u00EDvel abrir a pr\u00E9-visualiza\u00E7\u00E3o.";
+    /** `blob:` a revogar ao trocar ou destruir. */
+    private fileObjectUrl;
+    /** Só `image` local ou `imageUrl` remota. */
+    displaySrc: string | null;
+    imageLoadError: boolean;
+    /** PDF a partir de `File` (URL sanitizada). */
+    safePdfUrl: SafeResourceUrl | null;
+    pdfLoadError: boolean;
+    /** `file` local: imagem, PDF ou não suportado; remoto vindo de `imageUrl` só. */
+    fileKind: FilePreviewKind | 'remote';
+    ngOnChanges(c: SimpleChanges): void;
+    ngOnDestroy(): void;
+    onImgError(): void;
+    onImgLoad(): void;
+    onPdfFrameError(): void;
+    onTrocar(): void;
+    onRemover(): void;
+    get showImage(): boolean;
+    get showPdf(): boolean;
+    get showPreviewFallback(): boolean;
+    get showEmpty(): boolean;
+    get showActions(): boolean;
+    private updateDisplaySource;
+    private revokeFileObjectUrl;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ImagePreviewPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImagePreviewPanelComponent, "app-image-preview-panel", never, { "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "imageUrl": { "alias": "imageUrl"; "required": false; }; "file": { "alias": "file"; "required": false; }; "emptyText": { "alias": "emptyText"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "rounded": { "alias": "rounded"; "required": false; }; "showImageActions": { "alias": "showImageActions"; "required": false; }; "objectFit": { "alias": "objectFit"; "required": false; }; }, { "remove": "remove"; "change": "change"; }, never, never, true, never>;
+    static ngAcceptInputType_loading: unknown;
+    static ngAcceptInputType_rounded: unknown;
+    static ngAcceptInputType_showImageActions: unknown;
+}
+
 /** Espaçamento entre itens da linha ou da pilha dentro de uma coluna. */
 declare enum FormLayoutGap {
     Xs = "xs",
@@ -1582,15 +1769,23 @@ interface ValidationSummaryItem {
     fieldId?: string;
 }
 
-declare class ValidationSummaryComponent implements OnChanges {
+declare class ValidationSummaryComponent implements OnChanges, OnDestroy {
     private static nextTitleUid;
     private static nextListRegionUid;
+    private static nextPanelDomId;
     /** Troca de aba (`beforeItemActivate`) + `queueMicrotask` no `app-form-tabs` — o alvo pode ficar em `[hidden]` até o próximo CD. */
     private readonly navigateToFieldMaxAttempts;
     private readonly appRef;
     private readonly cdr;
     private readonly injector;
+    private readonly document;
     private readonly hostRef;
+    /**
+     * Id estável do painel — quando o nó `pinned` passa a `document.body` (Safari iOS) o
+     * `getElementById` permite reintegrá-lo no host antes do `@if` o destruir.
+     */
+    readonly panelDomId: string;
+    private panelRootRef?;
     /** `id` único para `aria-labelledby` quando há vários resumos na página. */
     readonly titleElementId: string;
     /** `id` da região da lista (acessibilidade do botão recolher / expandir). */
@@ -1659,6 +1854,14 @@ declare class ValidationSummaryComponent implements OnChanges {
     private unpinnedScrollMeasureAttempts;
     get hostClass(): string;
     ngOnChanges(c: SimpleChanges): void;
+    ngOnDestroy(): void;
+    private getPanelElement;
+    private repatriatePinnedPanelToHost;
+    /**
+     * Safari iOS: `position: fixed` no painel, por baixo de scroll (`main`), fica abaixo do topbar
+     * a não ser com `z-index` ardiloso — o painel anexa-se a `body` (fora de qualquer overflow).
+     */
+    private syncPinnedBodyPlacement;
     get hostHidden(): true | null;
     get resolvedItems(): ValidationSummaryItem[];
     get isShown(): boolean;
@@ -3114,5 +3317,5 @@ declare class AppBreadcrumbComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<AppBreadcrumbComponent, "app-breadcrumb", never, { "items": { "alias": "items"; "required": true; }; }, {}, never, never, true, never>;
 }
 
-export { ADAPTIVE_DATA_VIEW_MOBILE_QUERY, APP_SIDEBAR_LABEL_REVEAL_LAG_MS, APP_SIDEBAR_LAYOUT_DURATION_MS, APP_SIDEBAR_NAV_REVEAL_TOTAL_MS, APP_THEME_IDS, ActionMenuComponent, AdaptiveDataViewComponent, AnchoredOverlayComponent, AppBreadcrumbComponent, AppDialogComponent, AppLibLightBlockScrollStrategy, AppShellComponent, AppShellSidebarTemplateDirective, AppShellSidebarToggleComponent, AppSidebarComponent, AppSidebarToolbarDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, BaseButtonType, BaseButtonVariant, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ConfirmDialogComponent, ConfirmDialogService, ContextMenuComponent, CpfCnpjFieldComponent, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, EmptyStateComponent, FormActionsAlign, FormActionsComponent, FormColComponent, FormGroupComponent, FormGroupVariant, FormLayoutGap, FormRowAlign, FormRowComponent, FormRowJustify, FormSectionComponent, FormTabComponent, FormTabsComponent, InputMaskFieldComponent, IntegerFieldComponent, LAYOUT_STACK_SIDE_BY_SIDE, LAYOUT_STACK_STACKED, LayoutStackAlign, LayoutStackComponent, LayoutStackDirection, LayoutStackItemAlign, LibDialogSize, ListItemComponent, LoadingDialogComponent, LoadingDialogService, MaskedTextFieldBase, MenuDividerComponent, MenuDropdownPlacement, MenuGroupComponent, MenuListComponent, MultiselectFieldComponent, NgControlFieldDirective, OverlayPlacement, PasswordFieldComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, STRUCTRA_UI, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, SwitchFieldComponent, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, ValidationSummaryComponent, anchoredOverlayPositions, applyPickedCalendarDate, buildDecimalBrDisplay, buildDecimalBrParseString, buildEmptyStateOverlayHtml, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, cepMaskCompleteValidator, cpfCnpjMaskCompleteValidator, escapeHtml, extractDecimalBrParts, fixedDigitsMaskCompleteValidator, formatDateTimePtBr, formatDecimalBr, formatIntegerThousandsBr, formatMaskDigits, formatUiFieldDateValue, libDialogPanelClasses, mapEstadosToOptions, maskDigitCount, normalizeFormDateValue, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, phoneBrMaskCompleteValidator, resolveControlAtPath, sanitizeDecimalBrInput, sanitizeIntegerDigits, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, stripToDigits, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid };
-export type { AdaptiveDataViewMode, AppThemeId, AppThemeOption, BreadcrumbItem, CardItemView, CardListDataMode, CardListMapFn, ConfirmDialogData, ConfirmDialogVariant, DataGridColumn, DataGridPaginationChangeEvent, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, FieldCommonInputs, FormTabsVariant, LoadingDialogData, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, UiSelectOption, ValidationSummaryItem, ValidationSummaryVariant };
+export { ADAPTIVE_DATA_VIEW_MOBILE_QUERY, APP_SIDEBAR_LABEL_REVEAL_LAG_MS, APP_SIDEBAR_LAYOUT_DURATION_MS, APP_SIDEBAR_NAV_REVEAL_TOTAL_MS, APP_THEME_IDS, ActionMenuComponent, AdaptiveDataViewComponent, AnchoredOverlayComponent, AppBreadcrumbComponent, AppDialogComponent, AppLibLightBlockScrollStrategy, AppShellComponent, AppShellSidebarTemplateDirective, AppShellSidebarToggleComponent, AppSidebarComponent, AppSidebarToolbarDirective, AppTheme, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, BaseButtonType, BaseButtonVariant, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, CardListComponent, CepFieldComponent, CheckboxFieldComponent, ConfirmDialogComponent, ConfirmDialogService, ContextMenuComponent, CpfCnpjFieldComponent, DashboardSectionComponent, DataCardComponent, DataGridComponent, DataListComponent, DataToolbarComponent, DateFieldComponent, DecimalFieldComponent, DetailsFieldComponent, DetailsViewComponent, DialogFooterDirective, DrawerComponent, DrawerSide, DrawerSize, DropdownBaseComponent, DropdownMenuComponent, DropdownMultiOptionFieldBase, DropdownOptionFieldBase, DropdownSearchFieldComponent, EmptyStateComponent, FILE_PREVIEW_UNAVAILABLE_MESSAGE, FileUploadFieldComponent, FormActionsAlign, FormActionsComponent, FormColComponent, FormGroupComponent, FormGroupVariant, FormLayoutGap, FormRowAlign, FormRowComponent, FormRowJustify, FormSectionComponent, FormTabComponent, FormTabsComponent, ImagePreviewPanelComponent, InputMaskFieldComponent, IntegerFieldComponent, LAYOUT_STACK_SIDE_BY_SIDE, LAYOUT_STACK_STACKED, LayoutStackAlign, LayoutStackComponent, LayoutStackDirection, LayoutStackItemAlign, LibDialogSize, ListItemComponent, LoadingDialogComponent, LoadingDialogService, MaskedTextFieldBase, MenuDividerComponent, MenuDropdownPlacement, MenuGroupComponent, MenuListComponent, MultiselectFieldComponent, NgControlFieldDirective, OverlayPlacement, PDF_IFRAME_VIEWER_HASH, PasswordFieldComponent, PhoneFieldComponent, PopoverBodyTemplateDirective, PopoverComponent, PopoverFooterTemplateDirective, PopoverTriggerDirective, STRUCTRA_UI, SelectFieldComponent, SkeletonBlockComponent, SkeletonCardComponent, SkeletonFieldShellComponent, SkeletonListComponent, SkeletonTableComponent, SkeletonTextComponent, StatCardComponent, StatusBadgeComponent, SwitchFieldComponent, TableEmptyStateComponent, TableToolbarComponent, TextFieldComponent, TextareaFieldComponent, ToastHostComponent, ToastService, TooltipComponent, TooltipPanelTemplateDirective, ValidationSummaryComponent, anchoredOverlayPositions, appendPdfIframeViewerParams, applyPickedCalendarDate, buildDecimalBrDisplay, buildDecimalBrParseString, buildEmptyStateOverlayHtml, caretIndexFromIntegerDigitCount, caretIndexFromSemantic, cepMaskCompleteValidator, cpfCnpjMaskCompleteValidator, escapeHtml, extractDecimalBrParts, fileIsLikelyImage, fileMatchesAccept, fixedDigitsMaskCompleteValidator, formatAcceptForDisplay, formatDateTimePtBr, formatDecimalBr, formatFileSizeBytes, formatIntegerThousandsBr, formatMaskDigits, formatUiFieldDateValue, getFilePreviewKind, libDialogPanelClasses, mapEstadosToOptions, maskDigitCount, normalizeFormDateValue, parseDecimalBr, parseIntegerString, parseUiFieldDateValue, phoneBrMaskCompleteValidator, resolveControlAtPath, sanitizeDecimalBrInput, sanitizeIntegerDigits, sectionHasVisibleInvalid, semanticCaretAt, semanticIntegerDigitCountLeft, stripToDigits, subscribeMarkForCheckOnInvalidUiRefresh, subtreeHasVisibleInvalid };
+export type { AdaptiveDataViewMode, AppThemeId, AppThemeOption, BreadcrumbItem, CardItemView, CardListDataMode, CardListMapFn, ConfirmDialogData, ConfirmDialogVariant, DataGridColumn, DataGridPaginationChangeEvent, DetailsViewItem, DropdownListBindings, DropdownSearchPageRequested, FieldCommonInputs, FilePreviewKind, FormTabsVariant, LoadingDialogData, MenuItemAction, MenuItemDivider, MenuItemGroup, MenuItemKind, MenuItemSubmenu, MenuLeafItem, MenuNodeItem, SelectPageRequested, SkeletonFieldShellVariant, StatCardDeltaTone, StatusBadgeSize, StatusBadgeVariant, ToastInstance, ToastShowOptions, ToastType, ToastVerticalPosition, UiSelectOption, ValidationSummaryItem, ValidationSummaryVariant };