@govbr-ds/webcomponents 2.1.0 → 2.1.1

package/dist/esm/br-table.entry.js

@@ -0,0 +1,678 @@
+/*!
+ * Construído por SERPRO
+ * © https://serpro.gov.br/ - MIT License.
+ */
+import { r as registerInstance, h, H as Host, g as getElement } from './index-C2RBydfd.js';
+import { g as generateUniqueId } from './id-BkS6ujyf.js';
+import { b as TABLE_OVERFLOW, a as TABLE_TOOLTIP_STATE, C as COLUMN_WIDTH_MAP, c as COLUMN_WIDTH_SEMANTICS, d as TABLE_ALIGNMENT_MAP, e as TABLE_ALIGNMENT, f as TABLE_OVERFLOW_MAP, g as TABLE_DENSITY_MAP, h as TABLE_DENSITY, i as TABLE_DIVIDER_STYLE_MAP, j as TABLE_DIVIDER_STYLE } from './table-constants-CXMwM9m4.js';
+
+/**
+ * Tokens CSS utilizados pela tabela.
+ * Centralizam variáveis customizadas para controle de layout e estilo.
+ */
+const TABLE_TOKENS = {
+    /**
+     * Define o template de colunas aplicado ao grid.
+     */
+    COLUMN_WIDTHS: '--br-table-column-widths',
+    /**
+     * Controla o espaçamento interno das células.
+     */
+    DENSITY: '--br-table-density',
+    /**
+     * Define o alinhamento horizontal do conteúdo das células.
+     */
+    HORIZONTAL_ALIGNMENT: '--br-table-horizontal-alignment',
+    /**
+     * Define o alinhamento vertical do conteúdo das células.
+     */
+    VERTICAL_ALIGNMENT: '--br-table-vertical-alignment',
+    /**
+     * Define o estilo visual das linhas divisórias.
+     */
+    DIVIDER_STYLE: '--br-table-divider-style',
+    /**
+     * Controla a visibilidade/intensidade do divisor entre colunas.
+     */
+    COLUMN_DIVIDER_FACTOR: '--br-table-column-divider-factor',
+    /**
+     * Controla a visibilidade/intensidade do divisor entre linhas.
+     */
+    ROW_DIVIDER_FACTOR: '--br-table-row-divider-factor',
+    /**
+     * Controla o comportamento de overflow do conteúdo das células.
+     */
+    CELL_OVERFLOW: '--br-table-cell-overflow',
+    /**
+     * Controla o comportamento de overflow de texto dentro das células.
+     */
+    CELL_TEXT_OVERFLOW: '--br-table-cell-text-overflow',
+    /**
+     * Controla o comportamento de quebra de linha dentro das células.
+     */
+    CELL_WHITE_SPACE: '--br-table-cell-white-space',
+};
+
+/**
+ * Resolve um valor de token aplicando validação e fallback.
+ *
+ * @param raw Valor bruto informado.
+ * @param options Configurações de resolução.
+ * @param options.fallback Valor padrão utilizado quando `raw` é inválido.
+ * @param options.semanticMap Mapa opcional de valores semânticos.
+ * @param options.validators Lista opcional de validadores.
+ *
+ * @returns Valor final resolvido.
+ *
+ * @remarks
+ * Ordem de resolução:
+ * 1. Retorna fallback se `raw` for vazio ou indefinido.
+ * 2. Retorna o valor do mapa semântico, se aplicável.
+ * 3. Retorna `raw` se passar por algum validador.
+ * 4. Caso contrário, retorna o fallback.
+ */
+function resolveTokenValue(raw, options) {
+    if (raw === undefined || raw === '')
+        return options.fallback;
+    const { semanticMap, validators = [], fallback } = options;
+    if (semanticMap && raw in semanticMap) {
+        return semanticMap[raw];
+    }
+    const isValid = validators.some((validator) => validator(raw));
+    return isValid ? raw : fallback;
+}
+/**
+ * Valida valores positivos em pixels.
+ *
+ * @example 16px
+ */
+const positivePxValidator = (value) => /^\d+(\.\d+)?px$/.test(value) && parseFloat(value) > 0;
+/**
+ * Valida valores positivos em frações de grid.
+ *
+ * @example 1fr
+ */
+const positiveFrValidator = (value) => /^\d+(\.\d+)?fr$/.test(value) && parseFloat(value) > 0;
+
+const tableCss = () => `*,*::before,*::after{box-sizing:border-box}:host{line-height:var(--font-line-height-medium);-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;text-size-adjust:100%}main{display:block}hr{box-sizing:content-box;height:0;overflow:visible}a{background-color:rgba(0,0,0,0)}b,strong{font-weight:bolder}code{font-family:monospace;font-size:1em}small{font-size:80%}img{border-style:none}button,input,select,textarea{font-family:inherit;font-size:100%;line-height:var(--font-line-height-medium);margin:0}button,input{overflow:visible}button,select{text-transform:none}button,[type=button],[type=reset],[type=submit]{appearance:button}button::-moz-focus-inner,[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner{border-style:none;padding:0}button:-moz-focusring,[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{appearance:none}::-webkit-file-upload-button{appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}.d-none{display:none !important}@media (min-width: 576px){.d-sm-block{display:block !important}.d-sm-flex{display:flex !important}}[data-toggle=dropdown]+*{position:absolute}.dropdown{position:relative}.dropdown [data-toggle=dropdown]+*{box-shadow:var(--surface-shadow-sm);left:0;position:absolute;top:100%}.dropdown>.br-notification{left:auto;right:0}.dropdown .br-item{--color:var(--color-light);--color-rgb:var(--color-light-rgb);--text-color:var(--color-light);--interactive:var(--interactive-light);--interactive-rgb:var(--color-rgb);--visited:var(--visited-light);--hover:var(--hover-light);--pressed:var(--pressed-light);--focus-color:var(--focus-color-light);--focus:var(--focus-color-light);--item-padding-y:var(--spacing-scale-2x);background-color:var(--background-light);color:var(--color)}.dropdown .br-item:not(:last-child){border-bottom:1px solid var(--border-color)}.dropdown .br-item.selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}.justify-content-start{justify-content:flex-start !important}.justify-content-end{justify-content:flex-end !important}.justify-content-center{justify-content:center !important}.align-items-center{align-items:center !important}.col,[class*=col-]{padding-left:calc(var(--grid-gutter)*.5);padding-right:calc(var(--grid-gutter)*.5);width:100%}.col{flex:1 0 0%;min-width:8.3333333333%}.col-auto{flex:0 0 auto;width:auto}.col-2{flex-basis:16.6666666667%;max-width:16.6666666667%}.container,.container-fluid,.container-lg{--grid-margin:var(--grid-portrait-margin);--grid-maxwidth:var(--grid-portrait-maxwidth);margin-left:auto;margin-right:auto;max-width:var(--grid-maxwidth);padding-left:var(--grid-margin);padding-right:var(--grid-margin);width:100%}.row{--grid-gutter:var(--grid-portrait-gutter);display:flex;flex-wrap:wrap;margin-left:calc(var(--grid-gutter)*-0.5);margin-right:calc(var(--grid-gutter)*-0.5)}@media (min-width: 576px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-sm) - var(--grid-tablet-margin))}}@media (min-width: 992px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tablet-margin)}.row{--grid-gutter:var(--grid-tablet-gutter)}.container{--grid-maxwidth:calc(var(--grid-breakpoint-md) - var(--grid-tablet-margin))}}@media (min-width: 1280px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-desktop-margin)}.row{--grid-gutter:var(--grid-desktop-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-lg) - var(--grid-desktop-margin))}}@media (min-width: 1600px){.container,.container-lg,.container-fluid{--grid-margin:var(--grid-tv-margin)}.row{--grid-gutter:var(--grid-tv-gutter)}.container,.container-lg{--grid-maxwidth:calc(var(--grid-breakpoint-xl) - var(--grid-tv-margin))}}.ease{animation-timing-function:cubic-bezier(0.25, 0.1, 0.25, 1)}.ease-in-out{animation-timing-function:cubic-bezier(0.42, 0, 0.58, 1)}.mt-1{margin-top:var(--spacing-scale-half) !important}.mr-1{margin-right:var(--spacing-scale-half) !important}.mb-1{margin-bottom:var(--spacing-scale-half) !important}.ml-1{margin-left:var(--spacing-scale-half) !important}.mx-3{margin-left:var(--spacing-scale-2x) !important;margin-right:var(--spacing-scale-2x) !important}.mb-4{margin-bottom:var(--spacing-scale-3x) !important}.ml-auto{margin-left:auto !important}.pt-half{padding-top:var(--spacing-scale-half) !important}@media (min-width: 576px){.ml-sm-0{margin-left:var(--spacing-scale-default) !important}}.highlight{background:var(--status-highlight-background) linear-gradient(var(--status-highlight-overlay), var(--status-highlight-overlay));color:var(--status-highlight-text);padding:0 var(--spacing-scale-half)}[disabled],.disabled{cursor:not-allowed;opacity:var(--disabled)}[disabled] *,.disabled *{pointer-events:none}.text-center{text-align:center !important}.text-right{text-align:right !important}.text-nowrap{white-space:nowrap !important}.text-uppercase{text-transform:uppercase !important}.text-bold{font-weight:700 !important}.text-base{font-size:var(--font-size-scale-base) !important}.text-down-01{font-size:var(--font-size-scale-down-01) !important}@media (min-width: 576px){.text-sm-center{text-align:center !important}.text-sm-left{text-align:left !important}.text-sm-right{text-align:right !important}}p{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-2x);margin-top:0}p a{text-decoration:underline}@media (min-width: 576px){p{font-size:var(--font-size-scale-up-01)}}a{--focus-offset:var(--spacing-scale-half)}a:focus{outline:none}a.focus-visible,a:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}a:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}a:not(:disabled):active{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--pressed)), rgba(var(--interactive-rgb), var(--pressed)))}a{color:var(--interactive);text-decoration:none}.main-content a{text-decoration:underline}button{cursor:pointer}img{max-width:100%;vertical-align:middle}h2,.h2{color:var(--color);font-size:var(--font-size-scale-up-03);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2xh);margin-top:var(--spacing-scale-3xh);padding-bottom:var(--spacing-scale-2xh)}@media (min-width: 576px){.h2,h2{font-size:var(--font-size-scale-up-05);font-weight:var(--font-weight-regular)}}ul,ol{margin-bottom:var(--spacing-scale-2x);margin-top:0;padding:0 0 0 var(--spacing-scale-5x)}table{--table-background:var(--background);--table-color:var(--color);--table-border-color:var(--gray-20);--table-border-style:solid;--table-border-width:1px;--table-hover:var(--color-rgb);--table-padding:var(--spacing-scale-3x);--table-font-weight:var(--font-weight-medium);--table-th-background:var(--background-alternative);--table-th-font-weight:var(--font-weight-semi-bold);--table-row-size:var(--spacing-scale-2x);border-collapse:collapse;width:100%}tr.selected,tr.is-selected{--color:var(--color-dark);--color-rgb:var(--color-dark-rgb);--text-color:var(--color-dark);--interactive:var(--interactive-dark);--interactive-rgb:var(--interactive-dark-rgb);--visited:var(--visited-dark);--hover:var(--hover-dark);--pressed:var(--pressed-dark);--focus-color:var(--focus-color-dark);--focus:var(--focus-color-dark)}label,.label{color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half)}fieldset,.fieldset{border:var(--surface-width-none);margin-bottom:var(--spacing-scale-5x);margin-top:0;padding:0}legend,.legend{color:var(--color);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-semi-bold);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-2x);margin-top:var(--spacing-scale-2x)}::placeholder,.placeholder{color:var(--color-light);font-size:var(--font-size-scale-base);font-style:italic;font-weight:var(--font-weight-regular);line-height:var(--font-line-height-medium);margin-bottom:var(--spacing-scale-half);margin-top:var(--spacing-scale-half);opacity:1}input,textarea,.input{color:var(--color-light);font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);margin-bottom:var(--spacing-scale-half)}.help{font-size:var(--font-size-scale-base)}code,.code{background:var(--gray-5);border-radius:4px;color:var(--gray-80);display:inline-block;font-family:monospace;font-size:var(--font-size-scale-base);font-weight:var(--font-weight-medium);line-height:var(--font-line-height-low);padding:var(--spacing-scale-half)}*[data-toggle=collapse]:not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}*[data-toggle=collapse]:focus{outline:none}*[data-toggle=collapse].focus-visible,*[data-toggle=collapse]:focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}:host{display:block;--table-row-size:var(--spacing-scale-3x);--br-table-divider-base-width:var(--surface-width-sm);--br-table-loading-opacity:0.5}.br-table{position:relative;width:100%}.br-table-content{display:grid;grid-template-columns:var(--br-table-column-widths);min-width:0}[part=loading]{position:absolute;z-index:2;inset:0;display:grid;place-items:center;pointer-events:auto}.br-table-content.loading{opacity:var(--br-table-loading-opacity)}@media (width <= 991px){.br-table{overflow-x:auto;-webkit-overflow-scrolling:touch}.br-table-content{min-width:max-content}}`;
+
+const Table = class {
+    constructor(hostRef) {
+        registerInstance(this, hostRef);
+        /**
+         * Ativa divisores verticais entre colunas.
+         *
+         * @default false
+         * @deprecated Use `columnDivider`.
+         */
+        this.hasColumnDivider = false;
+        /**
+         * Ativa divisores horizontais entre linhas.
+         *
+         * @default false
+         * @deprecated Use `rowDivider`.
+         */
+        this.hasRowDivider = false;
+        /**
+         * Define o comportamento de overflow para as células.
+         *
+         * @remarks Valores aceitos:
+         * - truncate
+         * - wrap
+         *
+         * Observação:
+         * - O overflow é independente de `columnWidth`.
+         * - Com `columnWidth="content"`, a coluna tende a crescer com o conteúdo (`max-content`), o que pode reduzir casos visíveis de truncagem.
+         * - Com `columnWidth="fill"`, a coluna ocupa o espaço disponível (`1fr`), então a truncagem tende a ficar mais evidente quando não há espaço suficiente.
+         *
+         * @default wrap
+         */
+        this.overflow = TABLE_OVERFLOW.WRAP;
+        /**
+         * Define o estado semântico do tooltip nas células da tabela.
+         *
+         * @remarks Valores aceitos:
+         * - info
+         * - warning
+         * - danger
+         * - success
+         *
+         * @default info
+         */
+        this.tooltipState = TABLE_TOOLTIP_STATE.INFO;
+        /**
+         * Indica que as linhas estão sendo atualizadas pelo consumidor.
+         * O componente mantém o conteúdo anterior, aplica `aria-busy="true"` e
+         * exibe o slot `loading` sobre os dados; transporte, erro e substituição das
+         * linhas ficam sob responsabilidade da aplicação.
+         * A prop pode ser alterada diretamente ou pelos métodos `startLoading()` e
+         * `stopLoading()`.
+         * @default false
+         */
+        this.loading = false;
+        this.headers = [];
+        this.rows = [];
+        this.cells = [];
+        this.rowCells = new Map();
+        this.columnIndexes = new Map();
+        this.structureReady = false;
+        this.structureRefreshFrame = null;
+        this.handleColumnWidthEvent = () => {
+            this.scheduleStructureRefresh();
+        };
+        this.handleAlignmentEvent = (event) => {
+            if (!this.structureReady) {
+                this.scheduleStructureRefresh();
+                return;
+            }
+            this.updateAlignmentForTarget(event.target);
+        };
+        this.handleOverflowEvent = (event) => {
+            if (!this.structureReady) {
+                this.scheduleStructureRefresh();
+                return;
+            }
+            this.updateOverflowForTarget(event.target);
+        };
+        this.generatedHeaderPrefix = generateUniqueId();
+        /**
+         * Recalcula estrutura, tokens e metadados de acessibilidade quando há mudança de slots.
+         */
+        this.handleStructureChange = () => {
+            this.scheduleStructureRefresh();
+        };
+    }
+    /**
+     * Reaplica a largura das colunas quando alterada.
+     */
+    handleTableColumnWidthChange() {
+        this.updateColumnWidths();
+    }
+    /**
+     * Reaplica o token de densidade quando alterado.
+     */
+    handleDensityChange() {
+        this.applyDensity();
+    }
+    /**
+     * Atualiza os tokens de divisor quando qualquer propriedade relacionada é alterada.
+     */
+    handleDividerChange() {
+        this.applyDividers();
+    }
+    /**
+     * Atualiza os tokens de alinhamento quando alterados.
+     */
+    handleAlignmentChange() {
+        this.updateAllCellAlignments();
+    }
+    /**
+     * Atualiza os tokens de overflow quando a propriedade é alterada.
+     */
+    handleOverflowChange() {
+        this.updateAllCellOverflow();
+    }
+    /**
+     * Ciclo de vida do componente que é chamado após o componente ser carregado no DOM.
+     * Inicializa os tokens visuais após a montagem do componente.
+     */
+    componentDidLoad() {
+        this.refreshStructure();
+        this.applyDensity();
+        this.applyDividers();
+        // garante cálculo inicial após filhos renderizarem
+        queueMicrotask(() => {
+            this.updateColumnWidths();
+            this.updateAllCellAlignments();
+            this.updateAllCellOverflow();
+            this.applyAriaMetadata();
+        });
+    }
+    connectedCallback() {
+        this.el.addEventListener('brColumnWidthChange', this.handleColumnWidthEvent);
+        this.el.addEventListener('brAlignmentChange', this.handleAlignmentEvent);
+        this.el.addEventListener('brOverflowChange', this.handleOverflowEvent);
+    }
+    disconnectedCallback() {
+        this.el.removeEventListener('brColumnWidthChange', this.handleColumnWidthEvent);
+        this.el.removeEventListener('brAlignmentChange', this.handleAlignmentEvent);
+        this.el.removeEventListener('brOverflowChange', this.handleOverflowEvent);
+        if (this.structureRefreshFrame !== null) {
+            cancelAnimationFrame(this.structureRefreshFrame);
+            this.structureRefreshFrame = null;
+        }
+    }
+    /** Inicia o estado de carregamento da tabela. */
+    async startLoading() {
+        this.loading = true;
+    }
+    /** Interrompe o estado de carregamento da tabela. */
+    async stopLoading() {
+        this.loading = false;
+    }
+    /**
+     * Marca a última linha e a última coluna para permitir estilização condicional.
+     */
+    refreshStructure() {
+        this.headers = Array.from(this.el.querySelectorAll('br-table-header-cell'));
+        this.rows = Array.from(this.el.querySelectorAll('br-table-row'));
+        this.cells = [...this.headers, ...Array.from(this.el.querySelectorAll('br-table-cell'))];
+        this.rowCells.clear();
+        this.columnIndexes.clear();
+        const columnCount = this.headers.length;
+        this.headers.forEach((column, columnIndex) => {
+            if (!(column instanceof HTMLElement))
+                return;
+            const isLastColumn = columnIndex === columnCount - 1;
+            column.toggleAttribute('data-last-column', isLastColumn);
+            this.columnIndexes.set(column, columnIndex);
+        });
+        this.rows.forEach((row, rowIndex) => {
+            const isLastRow = rowIndex === this.rows.length - 1;
+            const rowCells = Array.from(row.querySelectorAll('br-table-cell, br-table-header-cell'));
+            this.rowCells.set(row, rowCells);
+            rowCells.forEach((cell, columnIndex) => {
+                if (!(cell instanceof HTMLElement))
+                    return;
+                const isLastColumn = columnIndex === columnCount - 1;
+                cell.toggleAttribute('data-last-row', isLastRow);
+                cell.toggleAttribute('data-last-column', isLastColumn);
+                this.columnIndexes.set(cell, columnIndex);
+            });
+        });
+        this.structureReady = true;
+    }
+    scheduleStructureRefresh() {
+        if (this.structureRefreshFrame !== null)
+            return;
+        this.structureRefreshFrame = requestAnimationFrame(() => {
+            this.structureRefreshFrame = null;
+            this.refreshStructure();
+            this.updateColumnWidths();
+            this.updateAllCellAlignments();
+            this.updateAllCellOverflow();
+            this.applyAriaMetadata();
+        });
+    }
+    /**
+     * Atualiza a largura das colunas com base nos cabeçalhos.
+     * @returns void
+     */
+    updateColumnWidths() {
+        const headers = this.getHeaderCells();
+        if (headers.length === 0)
+            return;
+        const template = this.buildGridTemplate(headers);
+        this.applyGridTemplate(template);
+    }
+    /**
+     * Constrói o template de grid para a tabela com base nos cabeçalhos.
+     * @param headers Os elementos de cabeçalho da tabela.
+     * @returns Uma string representando o template de grid CSS.
+     */
+    buildGridTemplate(headers) {
+        const tableWidth = this.resolveTableColumnWidth();
+        const columnWidths = headers.map((header) => this.resolveColumnWidth(header, tableWidth));
+        return columnWidths.join(' ');
+    }
+    /**
+     * Resolve a largura de uma coluna específica com base no cabeçalho e na largura global da tabela.
+     */
+    resolveTableColumnWidth() {
+        return this.resolveWidthToken(this.columnWidth, COLUMN_WIDTH_MAP[COLUMN_WIDTH_SEMANTICS.FILL]);
+    }
+    /**
+     * Resolve a largura de uma coluna específica com base no cabeçalho e na largura global da tabela.
+     * @param header O elemento de cabeçalho da coluna.
+     * @param fallback A largura de fallback a ser usada caso o cabeçalho não defina uma largura.
+     * @returns A largura resolvida da coluna.
+     */
+    resolveColumnWidth(header, fallback) {
+        const headerWidth = header.getAttribute('column-width');
+        return this.resolveWidthToken(headerWidth, fallback);
+    }
+    /**
+     * Aplica o template de grid à tabela definindo a propriedade CSS customizada correspondente.
+     * @param raw O template de grid bruto a ser aplicado.
+     * @param fallback O template de grid de fallback a ser usado caso o valor bruto seja inválido.
+     * @return void
+     */
+    resolveWidthToken(raw, fallback) {
+        return resolveTokenValue(raw ?? undefined, {
+            fallback,
+            semanticMap: COLUMN_WIDTH_MAP,
+            validators: [positivePxValidator, positiveFrValidator],
+        });
+    }
+    /**
+     * Aplica o template de grid à tabela definindo a propriedade CSS customizada correspondente.
+     * @param template O template de grid a ser aplicado.
+     */
+    applyGridTemplate(template) {
+        this.el.style.setProperty(TABLE_TOKENS.COLUMN_WIDTHS, template);
+    }
+    /**
+     * Atualiza o alinhamento de todas as células da tabela com base nos tokens de alinhamento.
+     */
+    updateAllCellAlignments() {
+        const cells = this.getAllCells();
+        cells.forEach((cell) => {
+            this.updateAlignmentForCell(cell);
+        });
+    }
+    /**
+     * Atualiza o alinhamento de uma célula específica com base nos tokens de alinhamento.
+     * @param cell A célula a ser atualizada.
+     */
+    updateAlignmentForCell(cell) {
+        const horizontal = this.resolveHorizontalAlignmentForCell(cell);
+        const vertical = this.resolveVerticalAlignmentForCell(cell);
+        cell.style.setProperty(TABLE_TOKENS.HORIZONTAL_ALIGNMENT, horizontal);
+        cell.style.setProperty(TABLE_TOKENS.VERTICAL_ALIGNMENT, vertical);
+    }
+    /**
+     * Resolve o alinhamento horizontal de uma célula específica com base nos tokens de alinhamento.
+     * @param cell A célula a ser avaliada.
+     * @returns O valor do token de alinhamento horizontal resolvido.
+     */
+    resolveHorizontalAlignmentForCell(cell) {
+        // Cell
+        const cellValue = cell.getAttribute('horizontal-alignment');
+        if (cellValue !== null)
+            return this.resolveAlignmentToken(cellValue);
+        // Row
+        const row = cell.closest('br-table-row');
+        const rowValue = row?.getAttribute('horizontal-alignment');
+        if (rowValue !== null)
+            return this.resolveAlignmentToken(rowValue);
+        // Column (header)
+        const columnValue = this.getColumnAlignment(cell, 'horizontal-alignment');
+        if (columnValue !== null)
+            return this.resolveAlignmentToken(columnValue);
+        // Table
+        if (this.horizontalAlignment !== undefined)
+            return this.resolveAlignmentToken(this.horizontalAlignment);
+        // Fallback
+        return TABLE_ALIGNMENT_MAP[TABLE_ALIGNMENT.START];
+    }
+    /**
+     * Resolve o alinhamento vertical de uma célula específica com base nos tokens de alinhamento.
+     * @param cell A célula a ser avaliada.
+     * @returns O valor do token de alinhamento vertical resolvido.
+     */
+    resolveVerticalAlignmentForCell(cell) {
+        const cellValue = cell.getAttribute('vertical-alignment');
+        if (cellValue !== null)
+            return this.resolveAlignmentToken(cellValue);
+        const row = cell.closest('br-table-row');
+        const rowValue = row?.getAttribute('vertical-alignment');
+        if (rowValue !== null)
+            return this.resolveAlignmentToken(rowValue);
+        const columnValue = this.getColumnAlignment(cell, 'vertical-alignment');
+        if (columnValue !== null)
+            return this.resolveAlignmentToken(columnValue);
+        if (this.verticalAlignment !== undefined)
+            return this.resolveAlignmentToken(this.verticalAlignment);
+        return TABLE_ALIGNMENT_MAP[TABLE_ALIGNMENT.START];
+    }
+    /**
+     * Resolve um valor de token de alinhamento com base no valor bruto e no mapeamento semântico definido.
+     * @param value O valor bruto do token de alinhamento a ser resolvido.
+     * @returns O valor do token de alinhamento resolvido, ou o valor de fallback se o valor bruto for inválido.
+     */
+    resolveAlignmentToken(value) {
+        return resolveTokenValue(value ?? undefined, {
+            fallback: TABLE_ALIGNMENT_MAP[TABLE_ALIGNMENT.START],
+            semanticMap: TABLE_ALIGNMENT_MAP,
+        });
+    }
+    /**
+     * Retorna o valor do atributo de alinhamento de uma coluna específica.
+     * @param cell A célula para a qual o alinhamento da coluna deve ser obtido.
+     * @param attribute O atributo de alinhamento a ser obtido ('horizontal-alignment' ou 'vertical-alignment').
+     * @returns O valor do atributo de alinhamento da coluna, ou null se não estiver definido.
+     */
+    getColumnAlignment(cell, attribute) {
+        const columnIndex = this.getColumnIndex(cell);
+        if (columnIndex === -1)
+            return null;
+        const headers = this.getHeaderCells();
+        const header = headers[columnIndex];
+        return header?.getAttribute(attribute) ?? null;
+    }
+    /**
+     * Obtém o índice da coluna para uma célula específica, permitindo a associação entre células e seus respectivos cabeçalhos para herança de propriedades como alinhamento e largura.
+     * @param cell A célula para a qual o índice da coluna deve ser obtido.
+     * @returns O índice da coluna correspondente à célula, ou -1 se a célula não estiver dentro de uma linha válida.
+     */
+    getColumnIndex(cell) {
+        return this.columnIndexes.get(cell) ?? -1;
+    }
+    /**
+     * Constrói o template de grid para a tabela com base nos cabeçalhos.
+     * @return Array de larguras de coluna resolvidas.
+     */
+    getHeaderCells() {
+        return this.headers;
+    }
+    /**
+     * Obtém todas as células (tanto de corpo quanto de cabeçalho) da tabela, permitindo a aplicação de estilos e tokens de forma abrangente.
+     * @returns Um array contendo todas as células da tabela.
+     */
+    getAllCells() {
+        return this.cells;
+    }
+    /**
+     * Aplica metadados ARIA para melhorar a navegação por leitores de tela.
+     */
+    applyAriaMetadata() {
+        const rows = this.rows;
+        const headers = this.getHeaderCells();
+        this.el.setAttribute('aria-colcount', String(headers.length));
+        this.el.setAttribute('aria-rowcount', String(rows.length));
+        rows.forEach((row, rowIndex) => {
+            row.setAttribute('aria-rowindex', String(rowIndex + 1));
+        });
+        headers.forEach((header, headerIndex) => {
+            const colIndex = String(headerIndex + 1);
+            const headerId = header.id || `${this.generatedHeaderPrefix}-${headerIndex + 1}`;
+            header.id = headerId;
+            header.setAttribute('aria-colindex', colIndex);
+        });
+        const bodyCells = this.cells.filter((cell) => cell.tagName === 'BR-TABLE-CELL');
+        bodyCells.forEach((cell) => {
+            const columnIndex = this.getColumnIndex(cell);
+            if (columnIndex === -1)
+                return;
+            const colIndex = String(columnIndex + 1);
+            const header = headers[columnIndex];
+            cell.setAttribute('aria-colindex', colIndex);
+            if (header !== undefined && header.id !== '') {
+                cell.setAttribute('aria-labelledby', header.id);
+            }
+        });
+    }
+    /**
+     * Atualiza os tokens de overflow para todas as células da tabela, garantindo que as mudanças na propriedade de overflow sejam refletidas dinamicamente em todas as células, controlando o comportamento de overflow, text-overflow e white-space conforme definido no token.
+     */
+    updateAllCellOverflow() {
+        this.getAllCells().forEach((cell) => {
+            this.updateOverflowForCell(cell);
+        });
+    }
+    updateAlignmentForTarget(target) {
+        if (target === null || !this.el.contains(target))
+            return;
+        if (target.tagName === 'BR-TABLE-CELL' || target.tagName === 'BR-TABLE-HEADER-CELL') {
+            this.updateAlignmentForCell(target);
+            return;
+        }
+        if (target.tagName === 'BR-TABLE-ROW') {
+            this.rowCells.get(target)?.forEach((cell) => {
+                this.updateAlignmentForCell(cell);
+            });
+            return;
+        }
+        this.updateAllCellAlignments();
+    }
+    updateOverflowForTarget(target) {
+        if (target === null || !this.el.contains(target))
+            return;
+        if (target.tagName === 'BR-TABLE-CELL' || target.tagName === 'BR-TABLE-HEADER-CELL') {
+            this.updateOverflowForCell(target);
+            return;
+        }
+        if (target.tagName === 'BR-TABLE-ROW') {
+            this.rowCells.get(target)?.forEach((cell) => {
+                this.updateOverflowForCell(cell);
+            });
+            return;
+        }
+        this.updateAllCellOverflow();
+    }
+    /**
+     * Atualiza os tokens de overflow para uma célula específica, controlando o comportamento de overflow, text-overflow e white-space com base na resolução do token de overflow para a célula, que considera atributos específicos da célula, da linha, da coluna e da tabela para determinar o comportamento final de overflow a ser aplicado.
+     * @param cell A célula para a qual os tokens de overflow devem ser atualizados.
+     */
+    updateOverflowForCell(cell) {
+        const mode = this.resolveOverflowForCell(cell);
+        const config = TABLE_OVERFLOW_MAP[mode];
+        cell.style.setProperty(TABLE_TOKENS.CELL_OVERFLOW, config.overflow);
+        cell.style.setProperty(TABLE_TOKENS.CELL_TEXT_OVERFLOW, config.textOverflow);
+        cell.style.setProperty(TABLE_TOKENS.CELL_WHITE_SPACE, config.whiteSpace);
+        // O atributo 'applied-overflow' deve sempre aparecer
+        cell.setAttribute('data-applied-overflow', mode);
+    }
+    /**
+     * Resolve o token de overflow para uma célula específica, considerando a hierarquia de atributos (célula, linha, coluna, tabela) para determinar o comportamento de overflow final a ser aplicado à célula.
+     * @param cell A célula para a qual o token de overflow deve ser resolvido.
+     * @returns O valor do token de overflow resolvido para a célula, determinando o comportamento de overflow a ser aplicado.
+     */
+    resolveOverflowForCell(cell) {
+        // Resolução hierárquica: célula > linha > coluna > tabela > fallback
+        let value = cell.getAttribute('overflow');
+        if (value === null) {
+            const row = cell.closest('br-table-row');
+            value = row?.getAttribute('overflow') ?? null;
+        }
+        if (value === null) {
+            value = this.getColumnAttribute(cell, 'overflow') ?? null;
+        }
+        if (value === null) {
+            value = this.overflow ?? null;
+        }
+        if (value === null) {
+            value = TABLE_OVERFLOW.WRAP;
+        }
+        return value === TABLE_OVERFLOW.TRUNCATE ? TABLE_OVERFLOW.TRUNCATE : TABLE_OVERFLOW.WRAP;
+    }
+    /**
+     * Obtém o valor de um atributo específico de uma coluna para uma célula, permitindo a herança de propriedades da coluna para as células associadas com base no cabeçalho correspondente.
+     * @param cell A célula para a qual o atributo da coluna deve ser obtido.
+     * @param attribute O atributo específico a ser obtido da coluna (por exemplo, 'horizontal-alignment' ou 'vertical-alignment').
+     * @returns O valor do atributo da coluna correspondente à célula, ou null se não estiver definido.
+     */
+    getColumnAttribute(cell, attribute) {
+        const header = this.getHeaderForCell(cell);
+        return header?.getAttribute(attribute) ?? null;
+    }
+    /**
+     * Obtém o elemento de cabeçalho correspondente a uma célula específica, permitindo a associação entre células e seus respectivos cabeçalhos para herança de propriedades como alinhamento e largura.
+     * @param cell A célula para a qual o cabeçalho correspondente deve ser obtido.
+     * @returns O elemento de cabeçalho correspondente à célula, ou null se não for encontrado.
+     */
+    getHeaderForCell(cell) {
+        const index = this.getColumnIndex(cell);
+        if (index === -1)
+            return null;
+        const headers = this.getHeaderCells();
+        return headers[index] ?? null;
+    }
+    /**
+     * Resolve e aplica o token de densidade.
+     */
+    applyDensity() {
+        const resolved = resolveTokenValue(this.density, {
+            fallback: TABLE_DENSITY_MAP[TABLE_DENSITY.MEDIUM],
+            semanticMap: TABLE_DENSITY_MAP,
+        });
+        this.el.style.setProperty(TABLE_TOKENS.DENSITY, resolved);
+    }
+    /**
+     * Resolve e aplica os tokens relacionados aos divisores
+     * (estilo e fatores de linha/coluna).
+     */
+    applyDividers() {
+        const style = resolveTokenValue(this.dividerStyle, {
+            fallback: TABLE_DIVIDER_STYLE_MAP[TABLE_DIVIDER_STYLE.SOLID],
+            semanticMap: TABLE_DIVIDER_STYLE_MAP,
+        });
+        const rowFactor = (this.rowDivider ?? this.hasRowDivider) ? '1' : '0';
+        const columnFactor = (this.columnDivider ?? this.hasColumnDivider) ? '1' : '0';
+        this.el.style.setProperty(TABLE_TOKENS.DIVIDER_STYLE, style);
+        this.el.style.setProperty(TABLE_TOKENS.ROW_DIVIDER_FACTOR, rowFactor);
+        this.el.style.setProperty(TABLE_TOKENS.COLUMN_DIVIDER_FACTOR, columnFactor);
+    }
+    /**
+     * Retorna o mapa de classes base do componente.
+     *
+     * @returns Um objeto representando as classes CSS a serem aplicadas ao elemento da tabela.
+     */
+    getTableCssClassMap() {
+        return {
+            'br-table': true,
+        };
+    }
+    /**
+     * Renderiza a estrutura interna da tabela (header e body).
+     *
+     * @returns JSX.Element representando o conteúdo da tabela, incluindo os slots para header e body.
+     */
+    renderContent() {
+        return (h("div", { class: { 'br-table-content': true, loading: this.loading }, part: "content" }, h("slot", { name: "header", onSlotchange: this.handleStructureChange }), h("slot", { name: "body", onSlotchange: this.handleStructureChange })));
+    }
+    /**
+     * Renderiza o host do componente.
+     *
+     * @returns JSX.Element representando o elemento host do componente, contendo a estrutura da tabela.
+     */
+    render() {
+        return (h(Host, { key: 'bb33a9d7d47cbf531c23216f37e14114b2855db3', role: "table", "aria-busy": this.loading ? 'true' : null }, h("div", { key: '1e4c88e462a941eae79b2d7893721f0058dab307', class: this.getTableCssClassMap(), part: "container" }, this.renderContent(), this.loading ? (h("div", { part: "loading", role: "status", "aria-live": "polite" }, h("slot", { name: "loading" }, h("br-loading", { size: "small", label: "Carregando dados" })))) : null)));
+    }
+    get el() { return getElement(this); }
+    static get watchers() { return {
+        "columnWidth": [{
+                "handleTableColumnWidthChange": 0
+            }],
+        "density": [{
+                "handleDensityChange": 0
+            }],
+        "hasColumnDivider": [{
+                "handleDividerChange": 0
+            }],
+        "hasRowDivider": [{
+                "handleDividerChange": 0
+            }],
+        "columnDivider": [{
+                "handleDividerChange": 0
+            }],
+        "rowDivider": [{
+                "handleDividerChange": 0
+            }],
+        "dividerStyle": [{
+                "handleDividerChange": 0
+            }],
+        "horizontalAlignment": [{
+                "handleAlignmentChange": 0
+            }],
+        "verticalAlignment": [{
+                "handleAlignmentChange": 0
+            }],
+        "overflow": [{
+                "handleOverflowChange": 0
+            }]
+    }; }
+};
+Table.style = tableCss();
+
+export { Table as br_table };