@govbr-ds/webcomponents 2.5.0 → 2.6.0

package/dist/collection/components/table/table-row/table-row.js

@@ -3,75 +3,156 @@
  * © https://serpro.gov.br/ - MIT License.
  */
 import { Host, h } from "@stencil/core";
-import { resolveAllowedPropValue } from "../../../shared/utils/props";
+import { TABLE_ROW_EXPANSION } from "../table.constants";
+import { TableScrollShadows } from "../table.scroll-shadows";
 /**
- * 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 class TableRow {
-    validateProps() {
-        void resolveAllowedPropValue(this.el, 'horizontalAlignment', this.horizontalAlignment, ['start', 'center', 'end'], undefined, { allowUndefined: true });
-        void resolveAllowedPropValue(this.el, 'verticalAlignment', this.verticalAlignment, ['start', 'center', 'end'], undefined, { allowUndefined: true });
-        void resolveAllowedPropValue(this.el, 'overflow', this.overflow, ['truncate', 'wrap'], undefined, {
-            allowUndefined: true,
-        });
-        void resolveAllowedPropValue(this.el, 'tooltipState', this.tooltipState, ['info', 'warning', 'danger', 'success'], undefined, { allowUndefined: true });
-        void resolveAllowedPropValue(this.el, 'tooltipMode', this.tooltipMode, ['inherit', 'enabled', 'disabled'], undefined, { allowUndefined: true });
+    constructor() {
+        /**
+         * Indica se a linha está selecionada.
+         *
+         * @default false
+         */
+        this.selected = false;
+        /**
+         * Controla se a expansão é habilitada, desabilitada ou herdada da tabela.
+         *
+         * @default 'inherit'
+         */
+        this.rowExpansion = TABLE_ROW_EXPANSION.INHERIT;
+        /**
+         * Altura visível da área expandida desta linha, em pixels.
+         *
+         * @remarks Quando omitida, herda `virtualExpandedContentHeight` de `br-table`.
+         * @default null
+         */
+        this.virtualExpandedContentHeight = null;
+        /**
+         * Indica se o conteúdo adicional da linha está visível.
+         *
+         * @default false
+         */
+        this.expanded = false;
     }
     /**
-     * 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.
+     * 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.
      */
-    handleAlignmentChange() {
-        this.validateProps();
-        this.notifyAlignmentChange();
+    async getMeasuredHeight() {
+        const cells = Array.from(this.el.querySelectorAll('br-table-cell')).filter((cell) => cell.closest('br-table-row') === this.el);
+        const cellHeights = await Promise.all(cells
+            .filter((cell) => Number(cell.getAttribute('aria-rowspan') ?? 1) <= 1)
+            .map((cell) => cell.getMeasuredHeight()));
+        const group = this.el.parentElement;
+        const trackIndex = group?.hasAttribute('data-table-row-group') ? Array.from(group.children).indexOf(this.el) : -1;
+        const track = trackIndex >= 0 && group ? getComputedStyle(group).gridTemplateRows.split(/\s+/)[trackIndex] : undefined;
+        const trackHeight = track && /^\d+(\.\d+)?px$/.test(track) ? Number.parseFloat(track) : 0;
+        const cellHeight = trackHeight || Math.max(0, ...cellHeights);
+        const expandedContent = this.el.shadowRoot?.querySelector('.br-table-row-expanded-content');
+        return cellHeight + (expandedContent?.getBoundingClientRect().height ?? 0);
     }
     /**
-     * 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.
+     * Sincroniza as propriedades herdáveis após a primeira renderização.
      */
-    handleOverflowChange() {
-        this.validateProps();
+    connectedCallback() {
+        this.applyExpandedContentHeight();
+        this.syncScrollShadows();
+    }
+    componentDidLoad() {
+        this.applyExpandedContentHeight();
+        this.notifyAlignmentChange();
         this.notifyOverflowChange();
     }
+    syncScrollShadows() {
+        const viewport = this.el.shadowRoot?.querySelector('.br-table-row-expanded-content');
+        if (viewport !== this.expandedViewport) {
+            this.scrollShadows?.disconnect();
+            this.scrollShadows = undefined;
+            this.expandedViewport = viewport ?? undefined;
+            const content = viewport?.querySelector('.expanded-content-inner');
+            if (viewport && content && viewport.parentElement) {
+                this.scrollShadows = new TableScrollShadows(viewport, content, viewport.parentElement);
+            }
+        }
+        this.scrollShadows?.update();
+    }
+    componentDidRender() {
+        this.syncScrollShadows();
+    }
+    disconnectedCallback() {
+        this.scrollShadows?.disconnect();
+        this.scrollShadows = undefined;
+        this.expandedViewport = undefined;
+    }
     /**
-     * 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.
+     * Notifica a tabela para recalcular os alinhamentos das células.
      */
-    componentDidLoad() {
-        this.validateProps();
+    handleAlignmentChange() {
         this.notifyAlignmentChange();
+    }
+    /**
+     * Notifica a tabela para recalcular o overflow das células.
+     */
+    handleOverflowChange() {
         this.notifyOverflowChange();
     }
     /**
-     * Notifica que o alinhamento foi alterado, emitindo o evento customizado correspondente.
+     * Publica a solicitação de recálculo de alinhamento.
      */
     notifyAlignmentChange() {
         this.brAlignmentChange.emit();
     }
     /**
-     * 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.
      */
     notifyOverflowChange() {
         this.brOverflowChange.emit();
     }
+    /** Sincroniza o override local de altura da área expandida. */
+    handleVirtualExpandedContentHeightChange() {
+        this.applyExpandedContentHeight();
+    }
+    applyExpandedContentHeight() {
+        const value = this.virtualExpandedContentHeight;
+        if (value !== null && value !== undefined && Number.isFinite(value) && value > 0) {
+            this.el.style.setProperty('--br-table-expanded-content-height', `${value}px`);
+            return;
+        }
+        // Sem override local, permite que o token definido por br-table seja herdado.
+        this.el.style.removeProperty('--br-table-expanded-content-height');
+    }
     /**
-     * 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.
      */
-    getRowCssClassMap() {
-        return {
-            'br-table-row': true,
-        };
+    isExpansionEnabled() {
+        return this.rowExpansion === TABLE_ROW_EXPANSION.ENABLED || this.el.hasAttribute('data-row-expansion-enabled');
     }
     /**
-     * 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() {
-        return (h(Host, { key: '1b2246705a8a2017b87e056b6582811d18a0984b', role: "row" }, h("div", { key: '0b740cf446684867c9ce4081466bdc7e3e01bb6f', class: this.getRowCssClassMap(), role: "presentation", part: "row" }, h("slot", { key: 'f98e999efa1f30a2c3c03614d5f7e272ca438452' }))));
+        const standalone = this.el.closest('br-table') === null;
+        const shouldRenderExpandedContent = this.expanded && (standalone || this.isExpansionEnabled());
+        const columnCount = this.el.querySelectorAll(':scope > br-table-cell').length;
+        return (h(Host, { key: 'ace9d4ad52c20827ec6047c7acf272fa0f79ecd3', role: "row" }, h("div", { key: 'c8931561787d0f04332c02d777a083575fa2d6b0', class: "br-table-row", role: "presentation", part: "row" }, h("slot", { key: 'ab1b420bfd4a538f66f2fa9997343540b07689ea' }), shouldRenderExpandedContent && (h("div", { key: '6a8aab7c4e72c66536b0b479798241b5989bb365', class: "expanded-content-shell", role: "presentation" }, h("div", { key: 'ff1585ac5946d727446f4797a25d2a1dc8c9a28a', class: "br-table-row-expanded-content", role: "gridcell", tabIndex: -1, "aria-colspan": columnCount > 1 ? String(columnCount) : undefined, part: "expanded-content" }, h("div", { key: '8bdb995415a4eda39d833ea5ef2ef4b928833925', class: "expanded-content-inner" }, h("slot", { key: 'd14b1c47734bb192f4d6ac53d34b103b97852a8f', name: "expanded-content" }))))))));
     }
     static get is() { return "br-table-row"; }
     static get encapsulation() { return "shadow"; }
@@ -87,6 +168,28 @@ export class TableRow {
     }
     static get properties() {
         return {
+            "rowGroup": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Identifica um grupo cont\u00EDguo de linhas com chave exclusiva, preservado como unidade na ordena\u00E7\u00E3o,\npagina\u00E7\u00E3o e virtualiza\u00E7\u00E3o. Vazio ou omitido mant\u00E9m a linha independente.\nA sele\u00E7\u00E3o continua sendo individual por linha."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "row-group"
+            },
             "horizontalAlignment": {
                 "type": "string",
                 "mutable": false,
@@ -96,8 +199,8 @@ export class TableRow {
                     "references": {
                         "TableAlignment": {
                             "location": "import",
-                            "path": "../table-types",
-                            "id": "src/components/table/table-types.ts::TableAlignment",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableAlignment",
                             "referenceLocation": "TableAlignment"
                         }
                     }
@@ -105,8 +208,11 @@ export class TableRow {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Define o alinhamento horizontal das c\u00E9lulas dentro da linha, permitindo a heran\u00E7a de alinhamento para as c\u00E9lulas filhas com base no valor definido."
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Alinhamento horizontal herdado pelas c\u00E9lulas da linha."
                 },
                 "getter": false,
                 "setter": false,
@@ -122,8 +228,8 @@ export class TableRow {
                     "references": {
                         "TableAlignment": {
                             "location": "import",
-                            "path": "../table-types",
-                            "id": "src/components/table/table-types.ts::TableAlignment",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableAlignment",
                             "referenceLocation": "TableAlignment"
                         }
                     }
@@ -131,8 +237,11 @@ export class TableRow {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Define o alinhamento vertical das c\u00E9lulas dentro da linha, permitindo a heran\u00E7a de alinhamento para as c\u00E9lulas filhas com base no valor definido."
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Alinhamento vertical herdado pelas c\u00E9lulas da linha."
                 },
                 "getter": false,
                 "setter": false,
@@ -148,8 +257,8 @@ export class TableRow {
                     "references": {
                         "TableOverflow": {
                             "location": "import",
-                            "path": "../table-types",
-                            "id": "src/components/table/table-types.ts::TableOverflow",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableOverflow",
                             "referenceLocation": "TableOverflow"
                         }
                     }
@@ -157,8 +266,11 @@ export class TableRow {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Define se o conte\u00FAdo dentro das c\u00E9lulas da linha deve ser truncado, permitindo a heran\u00E7a dessa configura\u00E7\u00E3o para as c\u00E9lulas filhas com base no valor definido."
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Estrat\u00E9gia de overflow herdada pelas c\u00E9lulas da linha."
                 },
                 "getter": false,
                 "setter": false,
@@ -174,8 +286,8 @@ export class TableRow {
                     "references": {
                         "TableTooltipState": {
                             "location": "import",
-                            "path": "../table-types",
-                            "id": "src/components/table/table-types.ts::TableTooltipState",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableTooltipState",
                             "referenceLocation": "TableTooltipState"
                         }
                     }
@@ -183,8 +295,11 @@ export class TableRow {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Define o estado sem\u00E2ntico do tooltip nas c\u00E9lulas desta linha."
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Estado visual herdado pelos tooltips da linha."
                 },
                 "getter": false,
                 "setter": false,
@@ -200,8 +315,8 @@ export class TableRow {
                     "references": {
                         "TableTooltipMode": {
                             "location": "import",
-                            "path": "../table-types",
-                            "id": "src/components/table/table-types.ts::TableTooltipMode",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableTooltipMode",
                             "referenceLocation": "TableTooltipMode"
                         }
                     }
@@ -209,13 +324,118 @@ export class TableRow {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Define o modo de resolu\u00E7\u00E3o do tooltip nas c\u00E9lulas desta linha."
+                    "tags": [{
+                            "name": "default",
+                            "text": "undefined"
+                        }],
+                    "text": "Modo de exibi\u00E7\u00E3o herdado pelos tooltips da linha."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": true,
                 "attribute": "tooltip-mode"
+            },
+            "selected": {
+                "type": "boolean",
+                "mutable": true,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }],
+                    "text": "Indica se a linha est\u00E1 selecionada."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "selected",
+                "defaultValue": "false"
+            },
+            "rowExpansion": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "TableRowExpansion",
+                    "resolved": "\"disabled\" | \"enabled\" | \"inherit\"",
+                    "references": {
+                        "TableRowExpansion": {
+                            "location": "import",
+                            "path": "../table.types",
+                            "id": "src/components/table/table.types.ts::TableRowExpansion",
+                            "referenceLocation": "TableRowExpansion"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "'inherit'"
+                        }],
+                    "text": "Controla se a expans\u00E3o \u00E9 habilitada, desabilitada ou herdada da tabela."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "row-expansion",
+                "defaultValue": "'inherit'"
+            },
+            "virtualExpandedContentHeight": {
+                "type": "number",
+                "mutable": false,
+                "complexType": {
+                    "original": "number | null",
+                    "resolved": "number",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "remarks",
+                            "text": "Quando omitida, herda `virtualExpandedContentHeight` de `br-table`."
+                        }, {
+                            "name": "default",
+                            "text": "null"
+                        }],
+                    "text": "Altura vis\u00EDvel da \u00E1rea expandida desta linha, em pixels."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "virtual-expanded-content-height",
+                "defaultValue": "null"
+            },
+            "expanded": {
+                "type": "boolean",
+                "mutable": true,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "false"
+                        }],
+                    "text": "Indica se o conte\u00FAdo adicional da linha est\u00E1 vis\u00EDvel."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "expanded",
+                "defaultValue": "false"
             }
         };
     }
@@ -228,7 +448,7 @@ export class TableRow {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Evento customizado emitido quando o alinhamento \u00E9 alterado, permitindo que as c\u00E9lulas reajam dinamicamente a mudan\u00E7as nos tokens de alinhamento."
+                    "text": "Emitido quando uma propriedade de alinhamento da linha muda."
                 },
                 "complexType": {
                     "original": "void",
@@ -243,7 +463,7 @@ export class TableRow {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": "Evento customizado emitido quando a configura\u00E7\u00E3o de overflow \u00E9 alterada, permitindo que as c\u00E9lulas reajam dinamicamente a mudan\u00E7as no token de overflow."
+                    "text": "Emitido quando a estrat\u00E9gia de overflow da linha muda."
                 },
                 "complexType": {
                     "original": "void",
@@ -252,6 +472,38 @@ export class TableRow {
                 }
             }];
     }
+    static get methods() {
+        return {
+            "getMeasuredHeight": {
+                "complexType": {
+                    "signature": "() => Promise<number>",
+                    "parameters": [],
+                    "references": {
+                        "Promise": {
+                            "location": "global",
+                            "id": "global::Promise"
+                        },
+                        "HTMLBrTableCellElement": {
+                            "location": "global",
+                            "id": "global::HTMLBrTableCellElement"
+                        },
+                        "HTMLElement": {
+                            "location": "global",
+                            "id": "global::HTMLElement"
+                        }
+                    },
+                    "return": "Promise<number>"
+                },
+                "docs": {
+                    "text": "Retorna a maior altura das c\u00E9lulas desta linha somada \u00E0 \u00E1rea de expans\u00E3o, em pixels.",
+                    "tags": [{
+                            "name": "returns",
+                            "text": "Altura medida das c\u00E9lulas diretamente pertencentes \u00E0 linha e do conte\u00FAdo expandido renderizado."
+                        }]
+                }
+            }
+        };
+    }
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
@@ -263,6 +515,9 @@ export class TableRow {
             }, {
                 "propName": "overflow",
                 "methodName": "handleOverflowChange"
+            }, {
+                "propName": "virtualExpandedContentHeight",
+                "methodName": "handleVirtualExpandedContentHeightChange"
             }];
     }
 }

package/dist/collection/components/table/table.actions-tooltip.js

@@ -0,0 +1,33 @@
+/*!
+ * Construído por SERPRO
+ * © https://serpro.gov.br/ - MIT License.
+ */
+/**
+ * Coordena a dica do trigger com o menu de ações das barras e células.
+ */
+export class TableActionsTooltip {
+    constructor() {
+        this.revision = 0;
+        this.show = async () => {
+            const { dropdown, trigger, tooltip } = this;
+            if (!trigger?.isConnected || !tooltip?.isConnected || dropdown?.isOpen)
+                return;
+            const revision = ++this.revision;
+            await tooltip.setTriggerElement(trigger);
+            if (revision !== this.revision || !trigger.isConnected || !tooltip.isConnected || dropdown?.isOpen)
+                return;
+            await tooltip.showTooltip();
+        };
+        this.hide = async () => {
+            const revision = ++this.revision;
+            const tooltip = this.tooltip;
+            if (!tooltip?.isConnected)
+                return;
+            // Remove também os listeners de hover registrados por setTriggerElement.
+            await tooltip.setTriggerElement(null);
+            if (revision !== this.revision || !tooltip.isConnected)
+                return;
+            await tooltip.hideTooltip();
+        };
+    }
+}