structra-ui 0.1.42 → 0.1.44

package/package.json

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

package/types/structra-ui.d.ts

@@ -895,7 +895,6 @@ declare class DropdownBaseComponent {
      */
     readonly panelThemeNgClass: i0.Signal<{
         [x: string]: boolean;
-        'app-library-theme': boolean;
     }>;
     open: boolean;
     readonly openChange: EventEmitter<boolean>;
@@ -1222,8 +1221,8 @@ interface DropdownListBindings<T = unknown> {
     compareWith: (a: unknown, b: unknown) => boolean;
 }
 
-/** Espaçamento horizontal/vertical entre itens da linha. */
-declare enum FormRowGap {
+/** Espaçamento entre itens da linha ou da pilha dentro de uma coluna. */
+declare enum FormLayoutGap {
     Xs = "xs",
     Sm = "sm",
     Md = "md",
@@ -1310,7 +1309,8 @@ declare class FormActionsComponent {
 
 /**
  * Coluna no sistema de 12 trilhos da {@link FormRowComponent}.
- * Em viewports menores que `sm`, usa `xs` (por defeito largura total).
+ * Breakpoints (min-width): sm 40rem, md 48rem, lg 64rem, xl 80rem.
+ * Valores omitidos (ex.: só `xs` e `md`) propagam-se a partir do maior definido — ex.: `md` preenche `sm` quando `sm` não está definido.
  */
 declare class FormColComponent {
     /** Colunas ocupadas em &lt; `sm` (por defeito 12 = linha inteira). */
@@ -1320,14 +1320,25 @@ declare class FormColComponent {
     lg?: number;
     xl?: number;
     order?: number;
-    /** Quando `true`, a coluna pode crescer para ocupar espaço livre na linha (flex futuro / composição). */
+    /** Quando `true`, a coluna preenche o espaço horizontal restante na grelha (`auto / -1`). */
     grow: boolean;
+    /** Espaço entre elementos projectados na mesma coluna (pilha vertical). */
+    gap: FormLayoutGap;
+    align: FormRowAlign;
+    /** No eixo vertical da pilha (`justify-content`). */
+    justify: FormRowJustify;
     get hostClass(): string;
     get hostVars(): string;
+    /**
+     * Cada patamar herda do próximo **maior** explicitamente definido quando o intermédio falta
+     * (ex.: só `xs` + `md` → `sm` usa `md`, evitando faixa 40–48rem presa em `xs`).
+     */
+    private resolvedSpans;
+    private optionalSpan;
+    private firstDefined;
     private clampSpan;
-    private normalizeOptionalSpan;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormColComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FormColComponent, "app-form-col", never, { "xs": { "alias": "xs"; "required": false; }; "sm": { "alias": "sm"; "required": false; }; "md": { "alias": "md"; "required": false; }; "lg": { "alias": "lg"; "required": false; }; "xl": { "alias": "xl"; "required": false; }; "order": { "alias": "order"; "required": false; }; "grow": { "alias": "grow"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormColComponent, "app-form-col", never, { "xs": { "alias": "xs"; "required": false; }; "sm": { "alias": "sm"; "required": false; }; "md": { "alias": "md"; "required": false; }; "lg": { "alias": "lg"; "required": false; }; "xl": { "alias": "xl"; "required": false; }; "order": { "alias": "order"; "required": false; }; "grow": { "alias": "grow"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "align": { "alias": "align"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; }, {}, never, ["*"], true, never>;
     static ngAcceptInputType_xs: unknown;
     static ngAcceptInputType_order: unknown;
     static ngAcceptInputType_grow: unknown;
@@ -1457,14 +1468,17 @@ declare class FormGroupComponent implements OnChanges, OnInit, DoCheck {
 }
 
 declare class FormRowComponent {
-    gap: FormRowGap;
+    gap: FormLayoutGap;
     align: FormRowAlign;
     justify: FormRowJustify;
+    /** Filhos sem `app-form-col` ocupam a linha inteira; `app-form-col` com `[grow]` preenche o espaço restante na grelha. */
+    grow: boolean;
     wrap: boolean;
     stackOnMobile: boolean;
     get hostClass(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "app-form-row", never, { "gap": { "alias": "gap"; "required": false; }; "align": { "alias": "align"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; "wrap": { "alias": "wrap"; "required": false; }; "stackOnMobile": { "alias": "stackOnMobile"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "app-form-row", never, { "gap": { "alias": "gap"; "required": false; }; "align": { "alias": "align"; "required": false; }; "justify": { "alias": "justify"; "required": false; }; "grow": { "alias": "grow"; "required": false; }; "wrap": { "alias": "wrap"; "required": false; }; "stackOnMobile": { "alias": "stackOnMobile"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ngAcceptInputType_grow: unknown;
     static ngAcceptInputType_wrap: unknown;
     static ngAcceptInputType_stackOnMobile: unknown;
 }
@@ -2258,15 +2272,26 @@ interface AppThemeOption {
     readonly label: string;
 }
 /**
- * Estado global do tema da library: classe CSS `theme-*` em conjunto com `.app-library-theme`.
- * Os tokens `--app-color-*` são definidos em `src/app/_theme/`; paletas em `_theme-palettes.scss`.
+ * Estado global do tema da library: **sempre** `.app-library-theme` + `theme-*` juntos.
+ * Os tokens de paleta em `_theme-palettes.scss` usam o selector `.app-library-theme.theme-*`.
  */
 declare class AppThemeService {
     private readonly activeId;
     /** Identificador do tema activo (`blue`, `green`, …). */
     readonly activeThemeId: i0.Signal<"blue" | "green" | "purple" | "orange" | "white" | "gray" | "sepia" | "black">;
-    /** Classe CSS do tema (ex.: `theme-green`) para `[ngClass]` no host tematizado. */
+    /**
+     * 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.
+     */
     readonly themeClass: i0.Signal<string>;
+    /** Mapa para `[ngClass]` com chaves dinâmicas (painéis overlay). */
+    readonly themeClassMap: i0.Signal<{
+        [x: string]: boolean;
+    }>;
     /** Lista fixa de temas suportados pela library. */
     readonly themeOptions: readonly AppThemeOption[];
     setTheme(id: AppThemeId): void;
@@ -2430,7 +2455,6 @@ declare class ContextMenuComponent<T = string> implements OnDestroy {
     private readonly generatedId;
     readonly panelThemeNgClass: i0.Signal<{
         [x: string]: boolean;
-        'app-library-theme': boolean;
     }>;
     get resolvedMenuId(): string;
     ngOnDestroy(): void;
@@ -2547,7 +2571,6 @@ declare class MenuListComponent<T = string> implements OnChanges {
     readonly submenuPositions: _angular_cdk_overlay.ConnectedPosition[];
     readonly panelThemeNgClass: i0.Signal<{
         [x: string]: boolean;
-        'app-library-theme': boolean;
     }>;
     overlayPanelClasses(): string[];
     onNestedItemSelect(id: T): void;
@@ -2658,7 +2681,6 @@ declare class AnchoredOverlayComponent {
     readonly overlayPanelClasses: i0.Signal<string[]>;
     readonly panelThemeNgClass: i0.Signal<{
         [x: string]: boolean;
-        'app-library-theme': boolean;
     }>;
     readonly defaultScrollStrategy: _angular_cdk_overlay.RepositionScrollStrategy;
     get effectiveScrollStrategy(): ScrollStrategy;
@@ -2979,5 +3001,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, FormRowAlign, FormRowComponent, FormRowGap, FormRowJustify, FormSectionComponent, FormTabComponent, FormTabsComponent, InputMaskFieldComponent, IntegerFieldComponent, LayoutStackAlign, LayoutStackComponent, 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, 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, LayoutStackAlign, LayoutStackComponent, 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 };