structra-ui 0.1.49 → 0.1.51

package/package.json

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

package/types/structra-ui.d.ts

@@ -23,6 +23,9 @@ declare enum BaseButtonType {
     Submit = "submit",
     Reset = "reset"
 }
+/**
+ * Base do botão; **não** exposta no barrel público `buttons`. Use `ButtonComponent` (`app-button`).
+ */
 declare class BaseButtonComponent {
     private nativeBtn?;
     /** `submit` envia o `<form>` ancestral; use `button` para ações sem submit. */
@@ -55,6 +58,15 @@ declare class BaseButtonComponent {
     static ngAcceptInputType_loading: unknown;
 }
 
+/**
+ * Botão público da library (`app-button`). Comportamento e API iguais a {@link BaseButtonComponent};
+ * use sempre este componente em templates — a base permanece interna ao pacote.
+ */
+declare class ButtonComponent extends BaseButtonComponent {
+    static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "app-button", never, {}, {}, never, ["*"], true, never>;
+}
+
 /**
  * Itens de menu partilhados por dropdown, context menu, action-menu e campos (`mostrarMenuContexto`).
  * Discriminação por `kind` para renderização e navegação por teclado.
@@ -135,8 +147,8 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor {
     clearable: boolean;
     clearAriaLabel: string;
     /**
-     * Se `true`, o navegador pode exibir sugestões de preenchimento automático.
-     * Padrão `false` (`autocomplete="off"` em todos os campos).
+     * Se `true`, o atributo HTML fica `autocomplete="on"` (sugestões do browser).
+     * `false` → `autocomplete="off"`. Padrão `true`.
      */
     autocomplete: boolean;
     /** Placeholder de carregamento no `app-base-field` (skeleton). */
@@ -198,6 +210,7 @@ declare abstract class BaseFieldDirective<T> implements ControlValueAccessor {
     protected notifyTouched(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<BaseFieldDirective<any>, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<BaseFieldDirective<any>, never, never, { "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "showErrorMessage": { "alias": "showErrorMessage"; "required": false; }; "required": { "alias": "required"; "required": false; }; "showRequiredMark": { "alias": "showRequiredMark"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "showPrefixIcon": { "alias": "showPrefixIcon"; "required": false; }; "prefixIcon": { "alias": "prefixIcon"; "required": false; }; "iconLeft": { "alias": "iconLeft"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; }; "autocomplete": { "alias": "autocomplete"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "mostrarMenuContexto": { "alias": "mostrarMenuContexto"; "required": false; }; "contextMenuItems": { "alias": "contextMenuItems"; "required": false; }; "contextMenuId": { "alias": "contextMenuId"; "required": false; }; }, { "contextMenuSelect": "contextMenuSelect"; }, never, never, true, never>;
+    static ngAcceptInputType_autocomplete: unknown;
     static ngAcceptInputType_loading: unknown;
     static ngAcceptInputType_mostrarMenuContexto: unknown;
 }
@@ -415,7 +428,10 @@ declare class PasswordFieldComponent extends NgControlFieldDirective<string | nu
     /** Por defeito `false`: o botão de limpar compete com o toggle de visibilidade. */
     clearable: boolean;
     maxLength: number;
-    /** Atributo HTML `autocomplete` (senha actual vs. nova senha). */
+    /**
+     * Com o input `autocomplete` da base a `true`, define o atributo HTML
+     * (`current-password` / `new-password`). Com `autocomplete` a `false`, aplica-se `off`.
+     */
     autoComplete: 'off' | 'current-password' | 'new-password';
     /** `false` = caracteres ocultos (ícone olho aberto para revelar). */
     passwordVisible: boolean;
@@ -684,7 +700,7 @@ interface FieldCommonInputs {
     iconLeft?: string;
     clearable?: boolean;
     clearAriaLabel?: string;
-    /** `true` = sugestões do navegador; padrão nos componentes é `false`. */
+    /** `true` = `autocomplete="on"`; `false` = desliga; padrão na base é `true`. */
     autocomplete?: boolean;
     /** Skeleton no `app-base-field` enquanto dados externos carregam. */
     loading?: boolean;
@@ -2314,7 +2330,18 @@ declare class ConfirmDialogService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ConfirmDialogService>;
 }
 
-declare const APP_THEME_IDS: readonly ["blue", "green", "purple", "orange", "white", "gray", "sepia", "black"];
+/** Identificadores de paleta suportados pela library (uso em `AppThemeService.setTheme`). */
+declare enum AppTheme {
+    Blue = "blue",
+    Green = "green",
+    Purple = "purple",
+    Orange = "orange",
+    White = "white",
+    Gray = "gray",
+    Sepia = "sepia",
+    Black = "black"
+}
+declare const APP_THEME_IDS: readonly [AppTheme.Blue, AppTheme.Green, AppTheme.Purple, AppTheme.Orange, AppTheme.White, AppTheme.Gray, AppTheme.Sepia, AppTheme.Black];
 type AppThemeId = (typeof APP_THEME_IDS)[number];
 /** Opção de tema para UI (selector, documentação). */
 interface AppThemeOption {
@@ -2328,16 +2355,16 @@ interface AppThemeOption {
 declare class AppThemeService {
     private readonly activeId;
     /** Identificador do tema activo (`blue`, `green`, …). */
-    readonly activeThemeId: i0.Signal<"blue" | "green" | "purple" | "orange" | "white" | "gray" | "sepia" | "black">;
+    readonly activeThemeId: i0.Signal<AppTheme>;
     /**
      * Classes separadas (ex.: CDK `panelClass` — uma string com espaço quebra `classList.add`).
      */
     readonly themeClassList: i0.Signal<readonly [string, string]>;
     /**
      * As duas classes numa string — útil para `[class]`, `[ngClass]` com string, ou hosts HTML.
-     * Ex.: `<div [ngClass]="libTheme.themeClass()">` aplica paleta completa no consumidor.
+     * Ex.: `<div [ngClass]="libTheme.getTheme()">` aplica paleta completa no consumidor.
      */
-    readonly themeClass: i0.Signal<string>;
+    readonly getTheme: i0.Signal<string>;
     /** Mapa para `[ngClass]` com chaves dinâmicas (painéis overlay). */
     readonly themeClassMap: i0.Signal<{
         [x: string]: boolean;
@@ -3051,5 +3078,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, AppThemeService, AppTopbarComponent, AppUserMenuComponent, BR_ESTADOS_NOME_SIGLA, BaseButtonComponent, BaseButtonType, BaseButtonVariant, BaseFieldComponent, BaseFieldDirective, BooleanFieldDirective, 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 { 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 };