@govbr-ds/webcomponents 2.1.3 → 2.2.0

package/dist/collection/components/select/select-list/select-list.js

@@ -3,24 +3,47 @@
  * © https://serpro.gov.br/ - MIT License.
  */
 import { Host, h } from "@stencil/core";
+import { reportInvalidPropValue } from "../../../shared/utils/prop-warning";
+import { resolveDensity, resolveIntegerPropValue, resolveNumberPropValue } from "../../../shared/utils/props";
 import { createRafBatcher } from "../../../shared/utils/raf-batcher";
+import { computeVirtualWindow } from "../../../shared/utils/virtual-scroll";
 /**
- * ## Design System
+ * Subcomponente de lista virtualizada de opções, projetado para renderizar o conjunto de escolhas do `br-select`.
  *
- * 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/select?tab=designer).
+ * ### Papel na composição
+ * - Atua como o painel suspenso (popup `listbox`) que exibe os itens `br-select-option`.
+ * - Implementa virtualização de itens para oferecer alta performance mesmo em listas extensas com centenas ou milhares de opções.
+ * - Mantém o posicionamento flutuante e controla a rolagem de visualização do item ativo em navegação por teclado.
  *
- * @category Formulários
+ * ### Regra de uso e relacionamento
+ * Gerenciado exclusivamente pelo componente pai `br-select`, que injeta a coleção normalizada em `options`, controla o estado de exibição (aberto/fechado), a seleção múltipla e o índice ativo. A prop `options` desta lista é um contrato interno de composição e não substitui a API de opções do `br-select`. A lista cria internamente elementos `br-select-option` para a janela virtualizada, em vez de exibir diretamente os filhos declarados no slot do pai. Não utilize `br-select-list` como controle autônomo de formulário, pois ele não possui associação nativa com formulários (`formAssociated`) nem campo de acionamento próprio.
+ *
+ * Para a documentação completa de design, consulte o [Design System do GovBR](https://www.gov.br/ds/components/select?tab=designer).
+ *
+ * @category Formulários, Seleção
  * @status stable
  * @part list - Contêiner visual da lista virtualizada.
  * @slot loading - Indicador exibido enquanto resultados remotos são carregados.
  * @part loading - Área do indicador de carregamento.
+ * @part option-group - Cabeçalho visual de um grupo de opções.
  */
 export class SelectList {
     constructor() {
+        /**
+         * Define a densidade visual da lista, das opções e do indicador de carregamento.
+         * Aceita `small`, `medium` ou `large`. Valores inválidos usam `medium`.
+         *
+         * @default 'medium'
+         */
+        this.density = 'medium';
         /**
          * Coleção de opções exibidas pela lista.
          *
          * @type {SelectOptionData[]}
+         * É um contrato de composição abastecido pelo `br-select`; não é a API de
+         * opções do componente principal. Cada opção deve conter `value` string e
+         * pode conter `label` e `group` como strings opcionais; entradas inválidas
+         * são ignoradas.
          * @default []
          */
         this.options = [];
@@ -35,19 +58,23 @@ export class SelectList {
          */
         this.loading = false;
         /**
-         * Define quantas opções permanecem visíveis na viewport da lista.
+         * Define quantas linhas visuais permanecem visíveis na viewport da lista.
+         * Cabeçalhos de grupo também ocupam uma linha quando existem.
+         * Deve ser um inteiro positivo; valores inválidos usam 6.
          *
          * @default 6
          */
         this.visibleItems = 6;
         /**
          * Informa a altura base usada no cálculo de posicionamento das opções.
+         * Deve ser um número finito positivo; valores inválidos usam 56.
          *
          * @default 56
          */
         this.itemHeight = 56;
         /**
          * Define quantas opções extras são renderizadas fora da viewport quando o virtual scroll está ativo.
+         * Deve ser um inteiro não negativo; valores inválidos usam 0.
          *
          * @default 0
          */
@@ -66,6 +93,7 @@ export class SelectList {
         this.unselectAllLabel = SelectList.DESELECT_ALL_LABEL;
         /**
          * Índice da opção atualmente ativa para navegação por teclado.
+         * Deve ser um inteiro maior ou igual a -1; valores inválidos usam -1.
          *
          * @default -1
          * @remarks
@@ -79,6 +107,7 @@ export class SelectList {
         this.measurementFrame = null;
         this.filteredOptionsCache = null;
         this.filteredOptionsCacheKey = '';
+        this.virtualRowsCache = null;
         this.scrollBatch = createRafBatcher((scrollTop) => {
             if (this.scrollTop !== scrollTop)
                 this.scrollTop = scrollTop;
@@ -96,6 +125,49 @@ export class SelectList {
             this.scrollBatch.schedule(target?.scrollTop ?? 0);
         };
     }
+    handleOptionsChange(newOptions) {
+        const normalizedOptions = this.normalizeOptionData(newOptions);
+        if (normalizedOptions !== newOptions) {
+            this.options = normalizedOptions;
+            return;
+        }
+        this.syncRenderedOptionSelection(normalizedOptions);
+    }
+    syncRenderedOptionSelection(options) {
+        const renderedOptions = this.el.shadowRoot?.querySelectorAll('br-select-option');
+        if (!renderedOptions)
+            return;
+        const selectedByValue = new Map(options.map((option) => [option.value, Boolean(option.selected)]));
+        renderedOptions.forEach((option) => {
+            const selected = selectedByValue.get(option.value);
+            if (selected !== undefined && option.selected !== selected)
+                option.selected = selected;
+        });
+    }
+    get effectiveVisibleItems() {
+        return resolveIntegerPropValue(this.el, 'visibleItems', this.visibleItems, 1, Number.MAX_SAFE_INTEGER, 6);
+    }
+    get effectiveDensity() {
+        return resolveDensity(this.el, this.density);
+    }
+    get effectiveItemHeight() {
+        return resolveNumberPropValue(this.el, 'itemHeight', this.itemHeight, 1, Number.MAX_SAFE_INTEGER, 56);
+    }
+    get effectiveOverscan() {
+        return resolveIntegerPropValue(this.el, 'overscan', this.overscan, 0, Number.MAX_SAFE_INTEGER, 0);
+    }
+    get effectiveActiveOptionIndex() {
+        return resolveIntegerPropValue(this.el, 'activeOptionIndex', this.activeOptionIndex, -1, Number.MAX_SAFE_INTEGER, -1);
+    }
+    /**
+     * O `br-select` fornece a opção sintética de selecionar todos antes de
+     * conseguir chamar `setMultiple()` no elemento da lista. Usar esse
+     * marcador no primeiro render evita que os checkboxes apareçam somente
+     * depois de uma interação.
+     */
+    get effectiveMultiple() {
+        return this.isMultiple || this.options.some((option) => this.isSelectAllOption(option));
+    }
     disconnectedCallback() {
         this.scrollBatch.cancel();
         if (this.measurementFrame !== null) {
@@ -111,7 +183,7 @@ export class SelectList {
         this.scheduleMeasureItemHeight();
     }
     handleSelectAllLabelChange() {
-        if (!this.isMultiple)
+        if (!this.effectiveMultiple)
             return;
         this.options = this.syncSelectAllOption(this.options);
     }
@@ -121,7 +193,7 @@ export class SelectList {
         const detail = event.detail;
         if (!detail?.value)
             return;
-        if (this.isMultiple)
+        if (this.effectiveMultiple)
             return this.applyMultipleOption(detail);
         if (detail.selected)
             return this.applySingleSelect(detail);
@@ -151,7 +223,8 @@ export class SelectList {
      * @returns Uma promise concluída após a atualização da lista.
      */
     async setOptions(options) {
-        if (!options || options.length === 0) {
+        const normalizedInput = this.normalizeOptionData(options);
+        if (normalizedInput.length === 0) {
             this.options = [];
             this.scrollTop = 0;
             this.measuredItemHeight = null;
@@ -162,7 +235,7 @@ export class SelectList {
         }
         const map = new Map();
         let hasDuplicates = false;
-        options.forEach((opt) => {
+        normalizedInput.forEach((opt) => {
             if (map.has(opt.value)) {
                 hasDuplicates = true;
             }
@@ -172,7 +245,7 @@ export class SelectList {
             console.warn('[br-select-list] Foram encontrados valores duplicados em `setOptions`. Apenas a ultima ocorrencia de cada `value` sera mantida.');
         }
         const nextOptions = Array.from(map.values());
-        this.options = this.normalizeOptionsForMode(nextOptions, this.isMultiple);
+        this.options = this.normalizeOptionsForMode(nextOptions, this.effectiveMultiple);
         this.scheduleMeasureItemHeight();
         requestAnimationFrame(() => this.clampScrollPosition());
     }
@@ -183,15 +256,18 @@ export class SelectList {
      * @returns Uma promise concluída após a atualização da coleção.
      */
     async setOption(option) {
-        const index = this.options.findIndex((opt) => opt.value === option.value);
+        const normalizedOption = this.normalizeOptionData([option])[0];
+        if (!normalizedOption)
+            return;
+        const index = this.options.findIndex((opt) => opt.value === normalizedOption.value);
         let nextOptions;
         if (index !== -1) {
-            nextOptions = this.options.map((opt) => (opt.value === option.value ? option : opt));
+            nextOptions = this.options.map((opt) => (opt.value === normalizedOption.value ? normalizedOption : opt));
         }
         else {
-            nextOptions = [...this.options, option];
+            nextOptions = [...this.options, normalizedOption];
         }
-        this.options = this.normalizeOptionsForMode(nextOptions, this.isMultiple);
+        this.options = this.normalizeOptionsForMode(nextOptions, this.effectiveMultiple);
         requestAnimationFrame(() => this.clampScrollPosition());
     }
     /**
@@ -245,10 +321,14 @@ export class SelectList {
         const filteredOptions = this.getFilteredOptions();
         if (index < 0 || index >= filteredOptions.length || !this.listElement)
             return false;
+        const rows = this.getVirtualRows();
+        const rowIndex = this.getRowIndexForOption(rows, index);
+        if (rowIndex < 0)
+            return false;
         const rowHeight = this.getRowHeight();
         const viewportHeight = this.getViewportHeight();
-        const maxScrollTop = Math.max(0, filteredOptions.length * rowHeight - viewportHeight);
-        const nextScrollTop = Math.min(index * rowHeight, maxScrollTop);
+        const maxScrollTop = Math.max(0, rows.length * rowHeight - viewportHeight);
+        const nextScrollTop = Math.min(rowIndex * rowHeight, maxScrollTop);
         /*
          * Atualiza primeiro o estado que define a janela virtual. Dessa forma,
          * os itens do novo intervalo são renderizados antes de o viewport nativo
@@ -346,7 +426,7 @@ export class SelectList {
         this.options = this.options.map((o) => ({ ...o, selected: false }));
     }
     isSelectAllOption(option) {
-        if (option.value === SelectList.SELECT_ALL_VALUE)
+        if (option.value === SelectList.SELECT_ALL_VALUE || option.value === '__select_all__')
             return true;
         const optionLabel = (option.label ?? option.value).trim();
         return optionLabel === this.selectAllLabel || optionLabel === this.unselectAllLabel;
@@ -423,6 +503,33 @@ export class SelectList {
             };
         });
     }
+    normalizeOptionData(value) {
+        if (!Array.isArray(value)) {
+            reportInvalidPropValue(this.el, 'options', value, 'Informe um array de opções com `value` string e `label` string opcional.', 'Aplicando fallback [].');
+            return [];
+        }
+        const validOptions = value.filter((option) => typeof option === 'object' && option !== null && typeof option.value === 'string');
+        const hasInvalidLabels = validOptions.some((option) => {
+            const label = option.label;
+            return label !== undefined && typeof label !== 'string';
+        });
+        const hasInvalidGroups = validOptions.some((option) => {
+            const group = option.group;
+            return group !== undefined && typeof group !== 'string';
+        });
+        if (validOptions.length === value.length && !hasInvalidLabels && !hasInvalidGroups) {
+            const hasGroupsToNormalize = validOptions.some((option) => typeof option.group === 'string' && option.group !== (option.group.trim() || undefined));
+            if (!hasGroupsToNormalize)
+                return value;
+            return validOptions.map((option) => ({ ...option, group: option.group?.trim() || undefined }));
+        }
+        reportInvalidPropValue(this.el, 'options', value, 'Cada opção deve ter `value` string e pode ter `label` e `group` como strings.', 'Ignorando opções inválidas e removendo rótulos ou grupos com tipo incompatível.');
+        return validOptions.map((option) => ({
+            ...option,
+            group: typeof option.group === 'string' ? option.group.trim() || undefined : undefined,
+            label: typeof option.label === 'string' ? option.label : undefined,
+        }));
+    }
     normalizeSearchText(value) {
         return (value ?? '')
             .normalize('NFD')
@@ -432,7 +539,7 @@ export class SelectList {
     }
     getFilteredOptions() {
         const normalizedTerm = this.normalizeSearchText(this.searchTerm);
-        const cacheKey = `${normalizedTerm}|${this.isMultiple}|${this.selectAllLabel}|${this.unselectAllLabel}|${this.options.length}`;
+        const cacheKey = `${normalizedTerm}|${this.effectiveMultiple}|${this.selectAllLabel}|${this.unselectAllLabel}|${this.options.length}`;
         if (this.options === this.filteredOptionsCacheSource &&
             cacheKey === this.filteredOptionsCacheKey &&
             this.filteredOptionsCache !== null) {
@@ -447,35 +554,67 @@ export class SelectList {
         this.filteredOptionsCacheKey = cacheKey;
         this.filteredOptionsCache = this.options.filter((option) => {
             if (this.isSelectAllOption(option))
-                return this.isMultiple;
+                return this.effectiveMultiple;
             const label = this.normalizeSearchText(option.label ?? option.value);
+            const group = this.normalizeSearchText(option.group);
             const value = this.normalizeSearchText(option.value);
-            return label.includes(normalizedTerm) || value.includes(normalizedTerm);
+            return label.includes(normalizedTerm) || group.includes(normalizedTerm) || value.includes(normalizedTerm);
         });
         return this.filteredOptionsCache;
     }
+    getVirtualRows() {
+        const filteredOptions = this.getFilteredOptions();
+        if (filteredOptions === this.virtualRowsCacheSource && this.virtualRowsCache !== null) {
+            return this.virtualRowsCache;
+        }
+        const rows = [];
+        let previousGroup;
+        filteredOptions.forEach((option, optionIndex) => {
+            const group = option.group?.trim() || undefined;
+            if (group && group !== previousGroup && !this.isSelectAllOption(option)) {
+                rows.push({
+                    kind: 'group',
+                    group,
+                    key: `group:${group}:${optionIndex}`,
+                });
+            }
+            rows.push({
+                kind: 'option',
+                option,
+                optionIndex,
+                key: `option:${option.value}:${optionIndex}`,
+            });
+            previousGroup = group;
+        });
+        this.virtualRowsCacheSource = filteredOptions;
+        this.virtualRowsCache = rows;
+        return rows;
+    }
+    getRowIndexForOption(rows, optionIndex) {
+        return rows.findIndex((row) => row.kind === 'option' && row.optionIndex === optionIndex);
+    }
     getViewportHeight() {
-        const visibleOptionCount = Math.min(this.getFilteredOptions().length, this.visibleItems);
-        return visibleOptionCount * this.getRowHeight();
+        const visibleRowCount = Math.min(this.getVirtualRows().length, this.effectiveVisibleItems);
+        return visibleRowCount * this.getRowHeight();
     }
     getRowHeight() {
-        return this.measuredItemHeight ?? this.itemHeight;
+        return this.measuredItemHeight ?? this.effectiveItemHeight;
     }
     getVisibleRange() {
-        const filteredOptions = this.getFilteredOptions();
-        if (filteredOptions.length === 0) {
-            return { startIndex: 0, endIndex: 0 };
-        }
-        const rowHeight = this.getRowHeight();
-        const firstVisibleIndex = Math.floor(this.scrollTop / rowHeight);
-        const startIndex = Math.max(0, firstVisibleIndex - this.overscan);
-        const endIndex = Math.min(filteredOptions.length, firstVisibleIndex + this.visibleItems + this.overscan);
+        const rows = this.getVirtualRows();
+        const { startIndex, endIndex } = computeVirtualWindow({
+            totalItems: rows.length,
+            itemHeight: this.getRowHeight(),
+            scrollTop: this.scrollTop,
+            viewportHeight: this.getViewportHeight(),
+            overscan: this.effectiveOverscan,
+        });
         return { startIndex, endIndex };
     }
     clampScrollPosition() {
         if (!this.listElement)
             return;
-        const totalHeight = this.getFilteredOptions().length * this.getRowHeight();
+        const totalHeight = this.getVirtualRows().length * this.getRowHeight();
         const maxScrollTop = Math.max(0, totalHeight - this.getViewportHeight());
         const nextScrollTop = Math.min(Math.max(0, this.listElement.scrollTop), maxScrollTop);
         if (this.listElement.scrollTop !== nextScrollTop) {
@@ -517,9 +656,13 @@ export class SelectList {
     async ensureOptionVisible(index) {
         if (!this.listElement)
             return;
+        const rows = this.getVirtualRows();
+        const rowIndex = this.getRowIndexForOption(rows, index);
+        if (rowIndex < 0)
+            return;
         const rowHeight = this.getRowHeight();
         const viewportHeight = this.getViewportHeight();
-        const optionTop = index * rowHeight;
+        const optionTop = rowIndex * rowHeight;
         const optionBottom = optionTop + rowHeight;
         const viewportTop = this.listElement.scrollTop;
         const viewportBottom = viewportTop + viewportHeight;
@@ -530,7 +673,7 @@ export class SelectList {
         else if (optionBottom > viewportBottom) {
             nextScrollTop = optionBottom - viewportHeight;
         }
-        const maxScrollTop = Math.max(0, this.getFilteredOptions().length * rowHeight - viewportHeight);
+        const maxScrollTop = Math.max(0, rows.length * rowHeight - viewportHeight);
         nextScrollTop = Math.min(Math.max(0, nextScrollTop), maxScrollTop);
         if (nextScrollTop === viewportTop)
             return;
@@ -544,22 +687,36 @@ export class SelectList {
             'is-open': this.isOpen,
         };
     }
-    renderOption(option, index) {
+    renderOption(option, optionIndex, rowIndex) {
         const rowHeight = this.getRowHeight();
         const optionPart = this.isSelectAllOption(option) ? 'option select-all' : 'option';
-        return (h("br-select-option", { part: optionPart, active: index === this.activeOptionIndex, "data-option-index": index, disabled: option.disabled, id: `${this.el.id || 'br-select-list'}-option-${index}`, indeterminate: option.indeterminate,
+        return (h("br-select-option", { part: optionPart, active: optionIndex === this.effectiveActiveOptionIndex, "data-option-index": optionIndex, density: this.effectiveDensity, disabled: option.disabled, id: `${this.el.id || 'br-select-list'}-option-${optionIndex}`, indeterminate: option.indeterminate,
             // A seleção faz parte da identidade visual renderizada. Incluir o estado
             // na chave evita que uma opção virtual reutilizada retenha o snapshot
             // interno anterior do br-select-option/br-item.
-            key: `${option.value}:${option.selected ? 'selected' : 'unselected'}`, label: option.label, selected: option.selected, "show-checkbox": this.isMultiple, style: {
+            key: `${option.value}:${option.selected ? 'selected' : 'unselected'}:${option.group ?? ''}`, label: option.label, ref: (element) => {
+                if (element && option.group)
+                    element.setAttribute('group', option.group);
+            }, selected: option.selected, "show-checkbox": this.effectiveMultiple, style: {
                 boxSizing: 'border-box',
                 height: `${rowHeight}px`,
                 position: 'absolute',
-                top: `${index * rowHeight}px`,
+                top: `${rowIndex * rowHeight}px`,
                 left: '0',
                 right: '0',
             }, value: option.value }, option.content ? h("span", { innerHTML: option.content }) : (option.label ?? option.value)));
     }
+    renderGroup(row, rowIndex) {
+        const rowHeight = this.getRowHeight();
+        return (h("div", { "aria-hidden": "true", class: "option-group-label", key: row.key, part: "option-group", role: "presentation", style: {
+                boxSizing: 'border-box',
+                height: `${rowHeight}px`,
+                position: 'absolute',
+                top: `${rowIndex * rowHeight}px`,
+                left: '0',
+                right: '0',
+            } }, row.group));
+    }
     getVirtualScrollStyle() {
         return {
             height: `${this.getViewportHeight()}px`,
@@ -569,30 +726,35 @@ export class SelectList {
     }
     getVirtualSpacerStyle() {
         return {
-            height: `${this.getFilteredOptions().length * this.getRowHeight()}px`,
+            height: `${this.getVirtualRows().length * this.getRowHeight()}px`,
             position: 'relative',
         };
     }
-    getVirtualVisibleOptions() {
-        const filteredOptions = this.getFilteredOptions();
+    getVirtualVisibleRows() {
+        const rows = this.getVirtualRows();
         const { startIndex, endIndex } = this.getVisibleRange();
         return {
             startIndex,
-            visibleOptions: filteredOptions.slice(startIndex, endIndex),
+            visibleRows: rows.slice(startIndex, endIndex),
         };
     }
     renderVirtualOptions() {
-        const { startIndex, visibleOptions } = this.getVirtualVisibleOptions();
-        if (visibleOptions.length === 0) {
+        const { startIndex, visibleRows } = this.getVirtualVisibleRows();
+        if (visibleRows.length === 0) {
             return (h("div", { part: "empty-option", role: "option", "aria-selected": "false", tabIndex: 0 }, "Nenhum resultado encontrado"));
         }
-        return (h("div", { style: this.getVirtualSpacerStyle() }, visibleOptions.map((option, relativeIndex) => this.renderOption(option, startIndex + relativeIndex))));
+        return (h("div", { style: this.getVirtualSpacerStyle() }, visibleRows.map((row, relativeIndex) => {
+            const rowIndex = startIndex + relativeIndex;
+            if (row.kind === 'group')
+                return this.renderGroup(row, rowIndex);
+            return this.renderOption(row.option, row.optionIndex, rowIndex);
+        })));
     }
     renderLoading() {
-        return (h("div", { part: "loading", role: "status", "aria-live": "polite" }, h("slot", { name: "loading" }, h("br-loading", { size: "small", label: "Buscando op\u00E7\u00F5es" }))));
+        return (h("div", { part: "loading", role: "status", "aria-live": "polite" }, h("slot", { name: "loading" }, h("br-loading", { density: this.effectiveDensity, label: "Buscando op\u00E7\u00F5es" }))));
     }
     render() {
-        return (h(Host, { key: '537c7f312573570953b24e27fed7188a052c4bd5' }, h("div", { key: 'aac978e5664c9dee21ba7a6763125fe7daf915d3', class: this.getCssClassMap(), part: "list", ref: (el) => (this.listElement = el), onScroll: this.handleScroll, style: this.getVirtualScrollStyle() }, this.loading ? this.renderLoading() : this.renderVirtualOptions())));
+        return (h(Host, { key: '47c188f8f3e86d028476b8583d667e4eb412ec78' }, h("div", { key: '36386dc9532a3bd3561e319493ec7b86100be204', class: this.getCssClassMap(), part: "list", ref: (el) => (this.listElement = el), onScroll: this.handleScroll, style: this.getVirtualScrollStyle() }, this.loading ? this.renderLoading() : this.renderVirtualOptions())));
     }
     static get is() { return "br-select-list"; }
     static get encapsulation() { return "shadow"; }
@@ -608,6 +770,36 @@ export class SelectList {
     }
     static get properties() {
         return {
+            "density": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "BrDensity",
+                    "resolved": "\"large\" | \"medium\" | \"small\"",
+                    "references": {
+                        "BrDensity": {
+                            "location": "import",
+                            "path": "../../global.types",
+                            "id": "src/components/global.types.ts::BrDensity",
+                            "referenceLocation": "BrDensity"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "default",
+                            "text": "'medium'"
+                        }],
+                    "text": "Define a densidade visual da lista, das op\u00E7\u00F5es e do indicador de carregamento.\nAceita `small`, `medium` ou `large`. Valores inv\u00E1lidos usam `medium`."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "density",
+                "defaultValue": "'medium'"
+            },
             "options": {
                 "type": "unknown",
                 "mutable": true,
@@ -628,7 +820,7 @@ export class SelectList {
                 "docs": {
                     "tags": [{
                             "name": "type",
-                            "text": "{SelectOptionData[]}"
+                            "text": "{SelectOptionData[]} \u00C9 um contrato de composi\u00E7\u00E3o abastecido pelo `br-select`; n\u00E3o \u00E9 a API de\nop\u00E7\u00F5es do componente principal. Cada op\u00E7\u00E3o deve conter `value` string e\npode conter `label` e `group` como strings opcionais; entradas inv\u00E1lidas\ns\u00E3o ignoradas."
                         }, {
                             "name": "default",
                             "text": "[]"
@@ -700,7 +892,7 @@ export class SelectList {
                             "name": "default",
                             "text": "6"
                         }],
-                    "text": "Define quantas op\u00E7\u00F5es permanecem vis\u00EDveis na viewport da lista."
+                    "text": "Define quantas linhas visuais permanecem vis\u00EDveis na viewport da lista.\nCabe\u00E7alhos de grupo tamb\u00E9m ocupam uma linha quando existem.\nDeve ser um inteiro positivo; valores inv\u00E1lidos usam 6."
                 },
                 "getter": false,
                 "setter": false,
@@ -723,7 +915,7 @@ export class SelectList {
                             "name": "default",
                             "text": "56"
                         }],
-                    "text": "Informa a altura base usada no c\u00E1lculo de posicionamento das op\u00E7\u00F5es."
+                    "text": "Informa a altura base usada no c\u00E1lculo de posicionamento das op\u00E7\u00F5es.\nDeve ser um n\u00FAmero finito positivo; valores inv\u00E1lidos usam 56."
                 },
                 "getter": false,
                 "setter": false,
@@ -746,7 +938,7 @@ export class SelectList {
                             "name": "default",
                             "text": "0"
                         }],
-                    "text": "Define quantas op\u00E7\u00F5es extras s\u00E3o renderizadas fora da viewport quando o virtual scroll est\u00E1 ativo."
+                    "text": "Define quantas op\u00E7\u00F5es extras s\u00E3o renderizadas fora da viewport quando o virtual scroll est\u00E1 ativo.\nDeve ser um inteiro n\u00E3o negativo; valores inv\u00E1lidos usam 0."
                 },
                 "getter": false,
                 "setter": false,
@@ -818,7 +1010,7 @@ export class SelectList {
                             "name": "remarks",
                             "text": "Esse valor \u00E9 usado para refletir visualmente o foco l\u00F3gico da lista."
                         }],
-                    "text": "\u00CDndice da op\u00E7\u00E3o atualmente ativa para navega\u00E7\u00E3o por teclado."
+                    "text": "\u00CDndice da op\u00E7\u00E3o atualmente ativa para navega\u00E7\u00E3o por teclado.\nDeve ser um inteiro maior ou igual a -1; valores inv\u00E1lidos usam -1."
                 },
                 "getter": false,
                 "setter": false,
@@ -916,7 +1108,7 @@ export class SelectList {
                     "signature": "(option: SelectOptionData) => Promise<void>",
                     "parameters": [{
                             "name": "option",
-                            "type": "{ content?: string; disabled?: boolean; indeterminate?: boolean; label?: string; selected?: boolean; value: string; }",
+                            "type": "{ content?: string; disabled?: boolean; group?: string; indeterminate?: boolean; label?: string; selected?: boolean; value: string; }",
                             "docs": "Op\u00E7\u00E3o que deve ser persistida na lista."
                         }],
                     "references": {
@@ -1134,6 +1326,9 @@ export class SelectList {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
+                "propName": "options",
+                "methodName": "handleOptionsChange"
+            }, {
                 "propName": "searchTerm",
                 "methodName": "handleSearchTermChange"
             }, {

package/dist/collection/components/select/select-option/select-option.css

@@ -1 +1 @@
-*,*::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))}.col-sm-4{flex-basis:33.3333333333%;max-width:33.3333333333%}}@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))}.col-lg-3{flex-basis:25%;max-width:25%}}@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{--br-select-option-bg-color: var(--bg-color, var(--background, var(--background-color, #fff)));contain:paint;display:block;background-color:var(--br-select-option-bg-color);line-height:0;overflow:hidden;position:relative}:host(:focus-within){contain:none;overflow:visible}:host([active]){contain:none;overflow:visible;z-index:1}:host([active])::after{border:var(--focus-width) var(--focus-style) var(--focus);box-sizing:border-box;content:"";inset:0;pointer-events:none;position:absolute}.br-select-option{opacity:1 !important}br-item{--br-item-bg-color: var(--br-select-option-bg-color);background-color:var(--br-select-option-bg-color);display:block;line-height:normal;overflow:visible;width:100%}:host(:not([disabled])) br-item::part(item){cursor:pointer}:host([disabled]){background:var(--br-select-option-bg-color) !important;cursor:not-allowed}br-item[disabled]{--br-item-bg-color: var(--br-select-option-bg-color);background:var(--br-select-option-bg-color) !important;cursor:not-allowed}:host([disabled]) ::slotted(*){opacity:var(--disabled) !important}.br-select-option-label{display:block;min-width:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}:host([disabled]) .br-select-option-label{opacity:var(--disabled) !important}.br-select-option-label ::slotted(*){display:block;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}
+*,*::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}pre{font-family:monospace;font-size:1em}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,optgroup,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))}.col-sm-4{flex-basis:33.3333333333%;max-width:33.3333333333%}}@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))}.col-lg-3{flex-basis:25%;max-width:25%}}@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-out{animation-timing-function:cubic-bezier(0, 0, 0.58, 1)}.ease-in-out{animation-timing-function:cubic-bezier(0.42, 0, 0.58, 1)}.fast{animation-duration:var(--duration-fast)}.slow{animation-duration:var(--duration-slow)}.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}fieldset[disabled]{opacity:1}.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)}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)}pre,.pre{background:var(--gray-5);margin:var(--spacing-scale-2x) 0 var(--spacing-scale-4x);padding:var(--spacing-scale-2x)}pre code,.pre code{display:inline;padding:0}*[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)}@media(prefers-reduced-motion: reduce){:host,:host::before,:host::after,:host *,:host *::before,:host *::after{animation:none !important;scroll-behavior:auto !important;transition:none !important}}:host-context([data-wbc-reduced-motion=true])::before,:host-context([data-wbc-reduced-motion=true])::after,:host-context([data-wbc-reduced-motion=true]) *,:host-context([data-wbc-reduced-motion=true]) *::before,:host-context([data-wbc-reduced-motion=true]) *::after{animation:none !important;scroll-behavior:auto !important;transition:none !important}:host{--br-select-option-bg-color: var(--bg-color, var(--background, var(--background-color, #fff)));contain:paint;display:block;background-color:var(--br-select-option-bg-color);line-height:0;overflow:hidden;position:relative}:host(:focus-within){contain:none;overflow:visible}:host([active]){contain:none;overflow:visible;z-index:1}:host([active])::after{border:var(--focus-width) var(--focus-style) var(--focus);box-sizing:border-box;content:"";inset:0;pointer-events:none;position:absolute}.br-select-option{opacity:1 !important}br-item{--br-item-bg-color: var(--br-select-option-bg-color);background-color:var(--br-select-option-bg-color);display:block;line-height:normal;overflow:visible;width:100%}br-checkbox{--border-color: var(--gray-40, #888);--disabled: 1;pointer-events:none}:host(:not([disabled])) br-item::part(item){cursor:pointer}:host([disabled]){background:var(--br-select-option-bg-color) !important;cursor:not-allowed}br-item[disabled]{--br-item-bg-color: var(--br-select-option-bg-color);background:var(--br-select-option-bg-color) !important;cursor:not-allowed}:host([disabled]) ::slotted(*){opacity:var(--disabled) !important}.br-select-option-label{display:block;min-width:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}:host([disabled]) .br-select-option-label{opacity:var(--disabled) !important}.br-select-option-label ::slotted(*){display:block;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}