@govbr-ds/webcomponents 2.5.0 → 2.6.0

package/dist/types/components/table/table-row/table-row.d.ts

@@ -1,77 +1,136 @@
 import { type EventEmitter } from '../../../stencil-public-runtime';
-import type { TableAlignment, TableOverflow, TableTooltipMode, TableTooltipState } from '../table-types';
+import type { TableAlignment, TableOverflow, TableRowExpansion, TableTooltipMode, TableTooltipState } from '../table.types';
 /**
- * Linha horizontal (`<tr>`) da tabela. Use dentro de `br-table-header` ou `br-table-body`.
+ * ## Design System
  *
- * Use `selected` para indicar que a linha está selecionada.
+ * Para a documentação completa de design, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/table?tab=designer).
  *
- * @part row - Wrapper da linha da tabela.
+ * Representa uma linha de dados e sua área opcional de conteúdo expandido.
+ * É uma peça declarativa de `br-table-body` ou `br-table-header`, coordenada por
+ * `br-table`. Recebe células de dados ou cabeçalho conforme o pai. `rowGroup`
+ * identifica linhas contíguas que devem permanecer juntas; use-o apenas no corpo.
+ * Em grupos, os detalhes expandidos são apresentados após as linhas do grupo.
+ *
+ * @slot default - Células de dados da linha.
+ * @slot expanded-content - Conteúdo arbitrário exibido abaixo da linha.
+ * @part row - Contêiner estrutural da linha.
+ * @part expanded-content - Área de conteúdo expandido.
+ * @fires brAlignmentChange - Quando um alinhamento herdável muda.
+ * @fires brOverflowChange - Quando a estratégia de overflow muda.
  */
 export declare class TableRow {
+    el: HTMLBrTableRowElement;
     /**
-     * Referência ao elemento host do componente.
-     * Utilize esta propriedade para acessar e manipular o elemento do DOM associado ao componente.
+     * Identifica um grupo contíguo de linhas com chave exclusiva, preservado como unidade na ordenação,
+     * paginação e virtualização. Vazio ou omitido mantém a linha independente.
+     * A seleção continua sendo individual por linha.
+     * @default undefined
      */
-    el: HTMLBrTableRowElement;
+    rowGroup?: string;
     /**
-     * Define o alinhamento horizontal das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.
+     * Alinhamento horizontal herdado pelas células da linha.
+     *
+     * @default undefined
      */
     horizontalAlignment?: TableAlignment;
     /**
-     * Define o alinhamento vertical das células dentro da linha, permitindo a herança de alinhamento para as células filhas com base no valor definido.
+     * Alinhamento vertical herdado pelas células da linha.
+     *
+     * @default undefined
      */
     verticalAlignment?: TableAlignment;
     /**
-     * Define se o conteúdo dentro das células da linha deve ser truncado, permitindo a herança dessa configuração para as células filhas com base no valor definido.
+     * Estratégia de overflow herdada pelas células da linha.
+     *
+     * @default undefined
      */
     overflow?: TableOverflow;
     /**
-     * Define o estado semântico do tooltip nas células desta linha.
+     * Estado visual herdado pelos tooltips da linha.
+     *
+     * @default undefined
      */
     tooltipState?: TableTooltipState;
     /**
-     * Define o modo de resolução do tooltip nas células desta linha.
+     * Modo de exibição herdado pelos tooltips da linha.
+     *
+     * @default undefined
      */
     tooltipMode?: TableTooltipMode;
-    private validateProps;
     /**
-     * Observa mudanças nos tokens de alinhamento horizontal e vertical, emitindo um evento para notificar que o alinhamento foi alterado, permitindo que as células reajam dinamicamente a essas mudanças.
+     * Indica se a linha está selecionada.
+     *
+     * @default false
      */
-    protected handleAlignmentChange(): void;
+    selected: boolean;
     /**
-     * Observa mudanças no token de overflow, emitindo um evento para notificar que a configuração de overflow foi alterada, permitindo que as células reajam dinamicamente a essa mudança.
+     * Controla se a expansão é habilitada, desabilitada ou herdada da tabela.
+     *
+     * @default 'inherit'
      */
-    protected handleOverflowChange(): void;
+    rowExpansion: TableRowExpansion;
     /**
-     * Evento customizado emitido quando o alinhamento é alterado, permitindo que as células reajam dinamicamente a mudanças nos tokens de alinhamento.
+     * Altura visível da área expandida desta linha, em pixels.
+     *
+     * @remarks Quando omitida, herda `virtualExpandedContentHeight` de `br-table`.
+     * @default null
+     */
+    virtualExpandedContentHeight?: number | null;
+    /**
+     * Indica se o conteúdo adicional da linha está visível.
+     *
+     * @default false
+     */
+    expanded: boolean;
+    /**
+     * Emitido quando uma propriedade de alinhamento da linha muda.
      */
     brAlignmentChange: EventEmitter<void>;
     /**
-     * Evento customizado emitido quando a configuração de overflow é alterada, permitindo que as células reajam dinamicamente a mudanças no token de overflow.
+     * Emitido quando a estratégia de overflow da linha muda.
      */
     brOverflowChange: EventEmitter<void>;
     /**
-     * Gatilho do ciclo de vida do componente que é chamado após o componente ser carregado, garantindo que o alinhamento inicial seja aplicado às células da linha.
+     * Retorna a maior altura das células desta linha somada à área de expansão, em pixels.
+     *
+     * @returns Altura medida das células diretamente pertencentes à linha e do conteúdo expandido renderizado.
      */
+    getMeasuredHeight(): Promise<number>;
+    /**
+     * Sincroniza as propriedades herdáveis após a primeira renderização.
+     */
+    connectedCallback(): void;
     componentDidLoad(): void;
+    private scrollShadows?;
+    private expandedViewport?;
+    private syncScrollShadows;
+    componentDidRender(): void;
+    disconnectedCallback(): void;
+    /**
+     * Notifica a tabela para recalcular os alinhamentos das células.
+     */
+    protected handleAlignmentChange(): void;
     /**
-     * Notifica que o alinhamento foi alterado, emitindo o evento customizado correspondente.
+     * Notifica a tabela para recalcular o overflow das células.
+     */
+    protected handleOverflowChange(): void;
+    /**
+     * Publica a solicitação de recálculo de alinhamento.
      */
     private notifyAlignmentChange;
     /**
-     * Observa mudanças no token de overflow, emitindo um evento para notificar que a configuração de overflow foi alterada, permitindo que as células reajam dinamicamente a essa mudança.
+     * Publica a solicitação de recálculo de overflow.
      */
     private notifyOverflowChange;
+    /** Sincroniza o override local de altura da área expandida. */
+    protected handleVirtualExpandedContentHeightChange(): void;
+    private applyExpandedContentHeight;
     /**
-     * Retorna o mapa de classes base do componente.
-     *
-     * @returns Um objeto representando as classes CSS a serem aplicadas ao elemento da linha da tabela.
+     * Indica se a linha está elegível para exibir expansão.
      */
-    private getRowCssClassMap;
+    private isExpansionEnabled;
     /**
-     * Renderiza o host do componente.
-     *
-     * @returns JSX.Element representando o elemento host do componente, contendo a estrutura da linha da tabela.
+     * Renderiza as células e, quando expandida, o conteúdo adicional.
      */
     render(): any;
 }

package/dist/types/components/table/table.actions-tooltip.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Coordena a dica do trigger com o menu de ações das barras e células.
+ */
+export declare class TableActionsTooltip {
+    dropdown?: HTMLBrDropdownElement;
+    trigger?: HTMLBrButtonElement;
+    tooltip?: HTMLBrTooltipElement;
+    private revision;
+    readonly show: () => Promise<void>;
+    readonly hide: () => Promise<void>;
+}

package/dist/types/components/table/{table-constants.d.ts → table.constants.d.ts}

@@ -1,121 +1,65 @@
 /**
- * Valores semânticos para largura de coluna.
+ * Valores semânticos, mapas CSS e atributos internos da tabela.
  *
- * Representam intenções de layout, abstraindo valores CSS concretos.
- *
- * @remarks
- * - FILL: ocupa o espaço disponível (1fr)
- * - CONTENT: ajusta ao conteúdo (max-content)
+ * @module table-constants
+ * @remarks Este arquivo não mantém estado nem executa efeitos colaterais.
+ */
+/**
+ * Valores semânticos aceitos para largura de coluna.
  */
 export declare const COLUMN_WIDTH_SEMANTICS: {
     readonly FILL: "fill";
     readonly CONTENT: "content";
 };
-/**
- * Mapeia larguras semânticas para valores CSS reais.
- */
 export declare const COLUMN_WIDTH_MAP: Record<(typeof COLUMN_WIDTH_SEMANTICS)[keyof typeof COLUMN_WIDTH_SEMANTICS], string>;
 /**
- * Densidades disponíveis para controle de espaçamento da tabela.
- *
- * @remarks
- * - SMALL: compacto
- * - MEDIUM: padrão
- * - LARGE: espaçado
+ * Densidades visuais aceitas pela tabela.
  */
 export declare const TABLE_DENSITY: {
     readonly SMALL: "small";
     readonly MEDIUM: "medium";
     readonly LARGE: "large";
 };
-/**
- * Mapeia densidades para valores CSS de espaçamento.
- */
 export declare const TABLE_DENSITY_MAP: Record<(typeof TABLE_DENSITY)[keyof typeof TABLE_DENSITY], string>;
+export declare const TABLE_BAR_PADDING_MAP: Record<(typeof TABLE_DENSITY)[keyof typeof TABLE_DENSITY], string>;
 /**
- * Opções de alinhamento do conteúdo nas células.
- *
- * @remarks
- * - START
- * - CENTER
- * - END
+ * Alinhamentos semânticos aceitos nos dois eixos.
  */
 export declare const TABLE_ALIGNMENT: {
     readonly START: "start";
     readonly CENTER: "center";
     readonly END: "end";
 };
-/**
- * Mapeia alinhamentos para valores CSS de posicionamento.
- */
 export declare const TABLE_ALIGNMENT_MAP: Record<(typeof TABLE_ALIGNMENT)[keyof typeof TABLE_ALIGNMENT], string>;
 /**
- * Estilos visuais disponíveis para divisores.
- *
- * @remarks
- * - SOLID
- * - DASHED
+ * Estilos disponíveis para divisores de linha e coluna.
  */
 export declare const TABLE_DIVIDER_STYLE: {
     readonly SOLID: "solid";
     readonly DASHED: "dashed";
 };
-/**
- * Mapeia estilos de divisor para valores CSS reais.
- */
 export declare const TABLE_DIVIDER_STYLE_MAP: Record<(typeof TABLE_DIVIDER_STYLE)[keyof typeof TABLE_DIVIDER_STYLE], string>;
-/**
- * Opções de comportamento de overflow para células.
- *
- * @remarks
- * - HIDDEN: oculta o conteúdo que ultrapassa os limites da célula
- * - VISIBLE: permite que o conteúdo ultrapasse os limites da célula
- */
 export declare const TABLE_CELL_OVERFLOW: {
     readonly HIDDEN: "hidden";
     readonly VISIBLE: "visible";
 };
-/**
- * Opções de comportamento de overflow para texto dentro das células.
- *
- * @remarks
- * - ELLIPSIS: exibe reticências (...) quando o texto ultrapassa os limites da célula
- * - CLIP: corta o texto que ultrapassa os limites da célula
- */
 export declare const TABLE_CELL_TEXT_OVERFLOW: {
     readonly ELLIPSIS: "ellipsis";
     readonly CLIP: "clip";
 };
-/**
- * Opções de controle de quebra de linha para células.
- *
- * @remarks
- * - NOWRAP: impede que o texto quebre em múltiplas linhas
- * - NORMAL: permite que o texto quebre normalmente
- */
 export declare const TABLE_CELL_WHITE_SPACE: {
     readonly NOWRAP: "nowrap";
     readonly NORMAL: "normal";
 };
 /**
- * Opções de controle de truncagem para células.
- *
- * @remarks
- * - TRUNCATE: exibe reticências (...) quando o texto ultrapassa os limites da célula
- * - WRAP: permite que o texto quebre em múltiplas linhas
+ * Modos disponíveis para tratamento de overflow.
  */
 export declare const TABLE_OVERFLOW: {
     readonly TRUNCATE: "truncate";
     readonly WRAP: "wrap";
 };
 /**
- * Estados semânticos disponíveis para o tooltip das células.
- *
- * @remarks
- * - INFO
- * - WARNING
- * - DANGER
- * - SUCCESS
+ * Estados visuais aceitos pelos tooltips das células.
  */
 export declare const TABLE_TOOLTIP_STATE: {
     readonly INFO: "info";
@@ -124,21 +68,13 @@ export declare const TABLE_TOOLTIP_STATE: {
     readonly SUCCESS: "success";
 };
 /**
- * Modos de resolução do tooltip nas células.
- *
- * @remarks
- * - INHERIT: continua a resolução hierárquica
- * - ENABLED: habilita o tooltip explicitamente
- * - DISABLED: desabilita o tooltip explicitamente
+ * Modos de ativação e herança dos tooltips.
  */
 export declare const TABLE_TOOLTIP_MODE: {
     readonly INHERIT: "inherit";
     readonly ENABLED: "enabled";
     readonly DISABLED: "disabled";
 };
-/**
- * Mapeia opções de controle de truncagem para configurações CSS correspondentes.
- */
 export declare const TABLE_OVERFLOW_MAP: {
     readonly truncate: {
         readonly overflow: "hidden";
@@ -151,3 +87,40 @@ export declare const TABLE_OVERFLOW_MAP: {
         readonly whiteSpace: "normal";
     };
 };
+/**
+ * Largura fixa reservada à coluna de seleção.
+ */
+export declare const TABLE_SELECTION_COLUMN_WIDTH = "48px";
+export declare const TABLE_SELECTION_COLUMN_ATTR = "data-selection-column";
+export declare const TABLE_SELECTION_GENERATED_ATTR = "data-generated-selection";
+export declare const TABLE_SELECTION_CHECKBOX_ATTR = "data-selection-checkbox";
+/**
+ * Configurações possíveis para a expansão específica de uma linha.
+ */
+export declare const TABLE_ROW_EXPANSION: {
+    readonly INHERIT: "inherit";
+    readonly ENABLED: "enabled";
+    readonly DISABLED: "disabled";
+};
+/**
+ * Largura fixa reservada à coluna de expansão.
+ */
+export declare const TABLE_EXPANSION_COLUMN_WIDTH = "56px";
+export declare const TABLE_EXPANSION_COLUMN_ATTR = "data-expansion-column";
+export declare const TABLE_EXPANSION_GENERATED_ATTR = "data-generated-expansion";
+export declare const TABLE_EXPANSION_ACTION_ATTR = "data-row-expansion-action";
+/** Modos de ordenação suportados pela tabela. */
+export declare const TABLE_SORT_MODE: {
+    readonly SINGLE: "single";
+    readonly MULTI: "multi";
+};
+/** Estratégias de aplicação da ordenação. */
+export declare const TABLE_SORT_STRATEGY: {
+    readonly LOCAL: "local";
+    readonly MANUAL: "manual";
+};
+/** Direções de ordenação suportadas por uma coluna. */
+export declare const TABLE_SORT_DIRECTION: {
+    readonly ASC: "asc";
+    readonly DESC: "desc";
+};