structra-ui 0.1.78 → 0.1.80

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "structra-ui",
-  "version": "0.1.78",
+  "version": "0.1.80",
   "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';
@@ -12,13 +13,18 @@ import { Observable } from 'rxjs';
 /** Marcador de pacote publicado como `structra-ui`. */
 declare const STRUCTRA_UI: "structra-ui";
 
-declare enum BaseButtonVariant {
+declare enum ButtonVariant {
     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 {
+declare enum ButtonType {
     Button = "button",
     Submit = "submit",
     Reset = "reset"
@@ -29,7 +35,7 @@ declare enum BaseButtonType {
 declare class BaseButtonComponent {
     private nativeBtn?;
     /** `submit` envia o `<form>` ancestral; use `button` para ações sem submit. */
-    type: BaseButtonType;
+    type: ButtonType;
     disabled: boolean;
     /**
      * Não interage (como `disabled`), mas com aparência em cinza (tema somente leitura),
@@ -44,9 +50,9 @@ declare class BaseButtonComponent {
     /** Placeholder de carregamento (skeleton no lugar do rótulo). */
     loading: boolean;
     /** Estilo visual base; pode ser estendido no SCSS do projeto. */
-    variant: BaseButtonVariant;
+    variant: ButtonVariant;
     /** Alias de {@link variant} (nome comum em design systems). */
-    set appearance(value: BaseButtonVariant);
+    set appearance(value: ButtonVariant);
     get hostClasses(): string;
     /** Foca o `<button>` nativo (o host do componente não é focável). */
     focusNative(options?: FocusOptions): void;
@@ -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 ButtonType: typeof ButtonType;
+    readonly ButtonVariant: typeof ButtonVariant;
+    /** 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",
@@ -2353,8 +2540,8 @@ interface ConfirmDialogData {
 declare class ConfirmDialogComponent implements AfterViewInit {
     readonly ref: DialogRef<boolean, ConfirmDialogComponent>;
     readonly data: ConfirmDialogData;
-    readonly BaseButtonType: typeof BaseButtonType;
-    readonly BaseButtonVariant: typeof BaseButtonVariant;
+    readonly ButtonType: typeof ButtonType;
+    readonly ButtonVariant: typeof ButtonVariant;
     readonly titleId: string;
     readonly descId: string;
     private cancelBtn?;
@@ -3130,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, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, ButtonComponent, ButtonType, ButtonVariant, 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 };