@govbr-ds/webcomponents 2.1.3 → 2.3.0

package/dist/collection/components/pagination/pagination.js

@@ -3,11 +3,40 @@
  * © https://serpro.gov.br/ - MIT License.
  */
 import { Host, h, } from "@stencil/core";
-import Helpers from "../../shared/utils/helpers";
+import { generateUniqueId } from "../../shared/utils/id";
+import { reportInvalidPropValue } from "../../shared/utils/prop-warning";
+import { resolveAllowedPropValue, resolveDensity, resolveIntegerPropValue } from "../../shared/utils/props";
+const PAGINATION_COLOR_MODES = ['dark'];
+const PAGINATION_VARIANTS = ['default', 'contextual'];
 /**
- * Para a documentação completa, incluindo diretrizes de uso, acessibilidade e exemplos visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/pagination?tab=designer).
+ * O componente `br-pagination` é o controle de navegação paginada do GovBR-DS, desenvolvido para segmentar grandes volumes de dados ou conteúdos extensos em páginas sequenciais numeradas.
  *
- * @category Navegação
+ * ### Para que serve
+ *
+ * - **Segmentação de dados volumosos:** Divide listas, tabelas e catálogos em blocos gerenciáveis de itens, reduzindo o tempo de carregamento da página e o consumo de memória.
+ * - **Navegação direta e sequencial:** Oferece botões para avançar, retroceder, ir diretamente a uma página específica e navegar através de atalhos de reticências.
+ * - **Variante contextual completa:** Permite alterar a quantidade de itens exibidos por página (ex.: 10, 20, 50, 100 itens) e pular diretamente para qualquer página através de campo de digitação integrado.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - O número total de itens for superior ao limite recomendado para visualização em uma única rolagem (geralmente mais de 20 a 50 registros).
+ *   - Integrar com tabelas de dados (`br-table`) ou grades de cartões (`br-card`).
+ * - **Evite e prefira outro componente quando:**
+ *   - O conjunto completo de itens for pequeno (menos de 20 itens) e puder ser visualizado sem perda de performance.
+ *   - A navegação representar etapas interdependentes de um processo sequencial com validação (prefira `br-step` ou `br-wizard`).
+ *
+ * ### Estrutura e Slots
+ *
+ * O `br-pagination` disponibiliza slots para complementar a navegação:
+ * - `pagination-info`: Slot para customização do texto de contagem (ex.: "Exibindo 1-20 de 240 itens").
+ * - `loading`: Slot para indicador visual exibido durante a troca assíncrona de páginas.
+ *
+ * Para a documentação completa de design, incluindo diretrizes de acessibilidade e especificações visuais, consulte o [Design System do GovBR](https://www.gov.br/ds/components/pagination?tab=designer).
+ *
+
+
+ * @category Navegação, Dados, Progresso
  * @status stable
  *
  * @slot pagination-info - Informação customizada da paginação contextual. Quando utilizado, o texto padrão de contagem é substituído.
@@ -21,16 +50,19 @@ import Helpers from "../../shared/utils/helpers";
  * @part per-page - Parte para o seletor de itens por página na variante contextual.
  * @part per-page-container - Contêiner encaminhado do seletor de itens por página.
  * @part per-page-input - Campo encaminhado do seletor de itens por página.
+ * @part per-page-input-label - Rótulo encaminhado do seletor de itens por página.
  * @part per-page-list - Lista encaminhada do seletor de itens por página.
  * @part go-to - Parte para o seletor de navegação direta na variante contextual.
  * @part go-to-container - Contêiner encaminhado do seletor de navegação direta.
  * @part go-to-input - Campo encaminhado do seletor de navegação direta.
+ * @part go-to-input-label - Rótulo encaminhado do seletor de navegação direta.
  * @part go-to-list - Lista encaminhada do seletor de navegação direta.
  * @part prev-button - Parte para o botão de página anterior, usada para estilização via ::part().
  * @part prev-button-inner - Botão interno encaminhado da página anterior.
  * @part next-button - Parte para o botão de próxima página, usada para estilização via ::part().
  * @part next-button-inner - Botão interno encaminhado da próxima página.
  * @part loading - Área do indicador de carregamento.
+ *
  */
 export class Pagination {
     constructor() {
@@ -54,18 +86,14 @@ export class Pagination {
          * Identificador único do componente.
          * Quando omitido, um valor é gerado automaticamente.
          *
-         * > **Padrão:** valor único gerado por Helpers.generateUniqueId().
+         * > **Padrão:** valor único gerado por `generateUniqueId()`.
          *
          * > **Uso compartilhado:** mantenha esta descrição idêntica em todos os componentes que usam `customId`.
          */
-        this.customId = Helpers.generateUniqueId();
-        /**
-         * Quantidade total de páginas (mínimo 1).
-         */
+        this.customId = generateUniqueId();
+        /** Quantidade total de páginas (inteiro mínimo 1). Valores inválidos usam 1. */
         this.total = 1;
-        /**
-         * Página atual (1-indexada). Valores fora do intervalo serão ajustados.
-         */
+        /** Página atual (inteira e 1-indexada). Valores inválidos usam 1; valores fora do intervalo são ajustados. */
         this.current = 1;
         /**
          * Rótulo acessível do botão de página anterior.
@@ -87,10 +115,11 @@ export class Pagination {
          * - `large`: Baixa densidade (componente maior, mais espaçamento e altura).
          *
          * > **Uso compartilhado:** mantenha esta descrição idêntica em todos os componentes que usam `density`.
+         * Valores inválidos usam `medium`.
          */
         this.density = 'medium';
         /**
-         * Variante de renderização do componente.
+         * Variante de renderização do componente. Valores inválidos usam `default`.
          * - `default`: paginação numérica (padrão)
          * - `contextual`: paginação contextual com seletores e informação de itens
          */
@@ -108,12 +137,17 @@ export class Pagination {
          * @default false
          */
         this.loading = false;
-        /**
-         * Itens por página (aplicável na variante contextual).
-         */
+        /** Itens por página (inteiro positivo, aplicável na variante contextual). Valores inválidos usam 10. */
         this.perPage = 10;
         /**
-         * Opções disponíveis de itens por página (variante contextual).
+         * Opções disponíveis de itens por página na variante `contextual`.
+         * Passe o array por property binding; atributos HTML não representam arrays.
+         *
+         * @example
+         * ```js
+         * const pagination = document.querySelector('br-pagination');
+         * pagination.perPageOptions = [10, 25, 50, 100];
+         * ```
          */
         this.perPageOptions = [10, 20, 30];
         /**
@@ -137,7 +171,7 @@ export class Pagination {
             if (this.loading)
                 return;
             const next = this.clampPage(page);
-            if (next !== this.current) {
+            if (next !== this.effectiveCurrent) {
                 if (!this.controlled) {
                     this.current = next;
                     if (this.currentPage !== undefined)
@@ -151,15 +185,15 @@ export class Pagination {
         };
         this.handlePrevClick = (event) => {
             event.preventDefault();
-            if (this.current > 1) {
-                this.goTo(this.current - 1);
+            if (this.effectiveCurrent > 1) {
+                this.goTo(this.effectiveCurrent - 1);
             }
         };
         this.handleNextClick = (event) => {
             event.preventDefault();
-            const maxPages = this.variant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
-            if (this.current < maxPages) {
-                this.goTo(this.current + 1);
+            const maxPages = this.effectiveVariant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
+            if (this.effectiveCurrent < maxPages) {
+                this.goTo(this.effectiveCurrent + 1);
             }
         };
         this.handlePageClickFactory = (page) => {
@@ -250,10 +284,10 @@ export class Pagination {
                 return;
             const value = Number(event.detail);
             // Ignora se o valor não for um número finito ou não tiver mudado
-            if (!Number.isFinite(value) || value === this.perPage) {
+            if (!Number.isFinite(value) || value === this.effectivePerPage) {
                 return;
             }
-            const nextPerPage = Math.max(1, value);
+            const nextPerPage = resolveIntegerPropValue(this.el, 'perPage', value, 1, Number.MAX_SAFE_INTEGER, 10);
             if (!this.controlled) {
                 this.perPage = nextPerPage;
                 this.current = this.clampPage(this.current); // Ajusta a página atual
@@ -272,8 +306,8 @@ export class Pagination {
             if (this.pendingGoToPage !== undefined)
                 return;
             // O fallback para this.current garante que não tentemos navegar para NaN.
-            const next = this.clampPage(Number.isFinite(value) ? value : this.current);
-            if (next !== this.current) {
+            const next = this.clampPage(Number.isFinite(value) ? value : this.effectiveCurrent);
+            if (next !== this.effectiveCurrent) {
                 this.lastInteraction = 'goTo';
                 this.pendingGoToPage = next;
                 if (this.pendingGoToResetFrame !== null)
@@ -319,9 +353,9 @@ export class Pagination {
     handlePerPagePropChange(newValue) {
         this.goToOptionsCache = null;
         this.goToOptionsReady = false;
-        if (this.variant !== 'contextual')
+        if (this.effectiveVariant !== 'contextual')
             return;
-        const nextPerPage = Math.max(1, Number(newValue) || 1);
+        const nextPerPage = this.effectivePerPage;
         if (nextPerPage !== newValue) {
             this.perPage = nextPerPage;
             return;
@@ -331,7 +365,7 @@ export class Pagination {
     handleTotalItemsChange() {
         this.goToOptionsCache = null;
         this.goToOptionsReady = false;
-        if (this.variant !== 'contextual')
+        if (this.effectiveVariant !== 'contextual')
             return;
         this.current = this.clampPage(this.current);
     }
@@ -358,9 +392,9 @@ export class Pagination {
     }
     componentWillLoad() {
         if (this.totalPages !== undefined)
-            this.total = this.totalPages;
+            this.total = this.effectiveTotalPages ?? this.effectiveTotal;
         if (this.currentPage !== undefined)
-            this.current = this.currentPage;
+            this.current = this.effectiveCurrentPage ?? this.effectiveCurrent;
         this.current = this.clampPage(this.current);
     }
     componentDidLoad() {
@@ -396,7 +430,11 @@ export class Pagination {
         if (!Number.isFinite(spacingBase) || !Number.isFinite(fontSize) || !Number.isFinite(lineHeight)) {
             return Pagination.ELLIPSIS_ITEM_HEIGHT_FALLBACK;
         }
-        const paddingY = this.density === 'large' ? spacingBase * 3 : this.density === 'medium' ? spacingBase * 2 : spacingBase;
+        const paddingY = this.effectiveDensity === 'large'
+            ? spacingBase * 3
+            : this.effectiveDensity === 'medium'
+                ? spacingBase * 2
+                : spacingBase;
         return Math.ceil(fontSize * lineHeight + paddingY * 2);
     }
     setupMediaQuery() {
@@ -444,20 +482,68 @@ export class Pagination {
         this.mqlSmallHandler = undefined;
     }
     getCssClassMap() {
+        const density = this.effectiveDensity;
         return {
             'br-pagination': true,
-            small: this.density === 'small',
-            large: this.density === 'large',
-            medium: this.density === 'medium',
-            'dark-mode': this.colorMode === 'dark',
+            small: density === 'small',
+            large: density === 'large',
+            medium: density === 'medium',
+            'dark-mode': this.effectiveColorMode === 'dark',
         };
     }
+    get effectiveDensity() {
+        return resolveDensity(this.el, this.density);
+    }
+    get effectiveColorMode() {
+        return resolveAllowedPropValue(this.el, 'colorMode', this.colorMode, PAGINATION_COLOR_MODES, undefined, {
+            allowUndefined: true,
+        });
+    }
+    get effectiveVariant() {
+        return resolveAllowedPropValue(this.el, 'variant', this.variant, PAGINATION_VARIANTS, 'default');
+    }
+    get effectiveTotal() {
+        return resolveIntegerPropValue(this.el, 'total', this.total, 1, Number.MAX_SAFE_INTEGER, 1);
+    }
+    get effectiveTotalPages() {
+        return resolveIntegerPropValue(this.el, 'totalPages', this.totalPages, 1, Number.MAX_SAFE_INTEGER, 1, {
+            allowUndefined: true,
+        });
+    }
+    get effectiveCurrentPage() {
+        return resolveIntegerPropValue(this.el, 'currentPage', this.currentPage, 1, Number.MAX_SAFE_INTEGER, 1, {
+            allowUndefined: true,
+        });
+    }
+    get effectiveTotalItems() {
+        return (resolveIntegerPropValue(this.el, 'totalItems', this.totalItems, 0, Number.MAX_SAFE_INTEGER, 0, {
+            allowUndefined: true,
+        }) ?? 0);
+    }
+    get effectivePerPage() {
+        return resolveIntegerPropValue(this.el, 'perPage', this.perPage, 1, Number.MAX_SAFE_INTEGER, 10);
+    }
+    get effectivePerPageOptions() {
+        const options = Array.isArray(this.perPageOptions)
+            ? this.perPageOptions.map((option) => Number(option)).filter((option) => Number.isInteger(option) && option >= 1)
+            : [];
+        const uniqueOptions = [...new Set(options)];
+        if (!Array.isArray(this.perPageOptions) ||
+            uniqueOptions.length === 0 ||
+            uniqueOptions.length !== this.perPageOptions.length) {
+            reportInvalidPropValue(this.el, 'perPageOptions', this.perPageOptions, 'Informe uma lista com inteiros positivos, sem valores inválidos ou duplicados.', 'Aplicando fallback [10, 20, 30] quando nenhuma opção válida for informada e ignorando entradas inválidas.');
+        }
+        return uniqueOptions.length > 0 ? uniqueOptions : [10, 20, 30];
+    }
     getDefaultTotalPages() {
-        return Math.max(1, Number(this.totalPages ?? this.total) || 1);
+        return this.effectiveTotalPages ?? this.effectiveTotal;
+    }
+    get effectiveCurrent() {
+        return this.clampPage(resolveIntegerPropValue(this.el, 'current', this.current, 1, Number.MAX_SAFE_INTEGER, 1));
     }
     clampPage(value) {
-        const total = this.variant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
-        const clampedValue = Math.max(1, Number(value) || 1);
+        const total = this.effectiveVariant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
+        const clampedValue = Math.max(1, resolveIntegerPropValue(this.el, 'current', value, 1, Number.MAX_SAFE_INTEGER, 1));
         return Math.min(clampedValue, total);
     }
     getVisiblePageButtons() {
@@ -484,7 +570,7 @@ export class Pagination {
             ? requestAnimationFrame
             : (cb) => setTimeout(() => cb(0), 0);
         defer(() => {
-            if (this.variant === 'contextual') {
+            if (this.effectiveVariant === 'contextual') {
                 this.lastInteraction = undefined;
                 return;
             }
@@ -507,11 +593,11 @@ export class Pagination {
         // Respeita o valor fornecido externamente
         if (this.ariaLabel && String(this.ariaLabel).trim().length > 0)
             return this.ariaLabel;
-        const totalPages = this.variant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
-        return `Paginação: página ${this.current} de ${totalPages}`;
+        const totalPages = this.effectiveVariant === 'contextual' ? this.getTotalPages() : this.getDefaultTotalPages();
+        return `Paginação: página ${this.effectiveCurrent} de ${totalPages}`;
     }
     renderPageButton(page) {
-        return (h("li", { key: page }, h("button", { part: "page", class: { page: true, active: page === this.current }, "aria-label": `Página ${page}`, "aria-current": page === this.current ? 'page' : null, type: "button", tabIndex: page === this.current ? 0 : -1, onClick: this.handlePageClickFactory(page), onKeyDown: this.handlePageKeyDown, disabled: this.loading }, page)));
+        return (h("li", { key: page }, h("button", { part: "page", class: { page: true, active: page === this.effectiveCurrent }, "aria-label": `Página ${page}`, "aria-current": page === this.effectiveCurrent ? 'page' : null, type: "button", tabIndex: page === this.effectiveCurrent ? 0 : -1, onClick: this.handlePageClickFactory(page), onKeyDown: this.handlePageKeyDown, disabled: this.loading }, page)));
     }
     getEllipsisRangeKey(position, from, to) {
         return `${position}:${from}:${to}`;
@@ -683,13 +769,13 @@ export class Pagination {
         const items = [];
         for (let pageIndex = renderedStartIndex; pageIndex <= renderedEndIndex; pageIndex++) {
             const page = from + pageIndex;
-            items.push(h("br-item", { key: `ellipsis-item-${key}-${page}`, "data-page-index": pageIndex, "prop:density": this.density, isButton: true, role: "menuitem", "aria-posinset": pageIndex + 1, "aria-setsize": totalItems, onBrDidClick: this.handleEllipsisItemClickFactory(page), onKeyDown: this.handleEllipsisItemKeyDownFactory(key, totalItems), "aria-label": `Página ${page}` }, page));
+            items.push(h("br-item", { key: `ellipsis-item-${key}-${page}`, "data-page-index": pageIndex, "prop:density": this.effectiveDensity, isButton: true, role: "menuitem", "aria-posinset": pageIndex + 1, "aria-setsize": totalItems, onBrDidClick: this.handleEllipsisItemClickFactory(page), onKeyDown: this.handleEllipsisItemKeyDownFactory(key, totalItems), "aria-label": `Página ${page}` }, page));
         }
         const topSpacerHeight = renderedStartIndex * this.ellipsisItemHeight;
         const bottomSpacerHeight = Math.max(0, totalItems - renderedEndIndex - 1) * this.ellipsisItemHeight;
-        return (h("li", { class: "pagination-ellipsis", part: "ellipsis", key: `ellipsis-${key}`, "data-ellipsis-key": key, "data-ellipsis-position": position }, h("br-dropdown", null, h("br-button", { part: "ellipsis", exportparts: "button: ellipsis-button", slot: "trigger", shape: "circle", type: "button", "prop:ariaLabel": this.ellipsisLabel, tabIndex: -1, disabled: this.loading, onClick: () => {
+        return (h("li", { class: "pagination-ellipsis", part: "ellipsis", key: `ellipsis-${key}`, "data-ellipsis-key": key, "data-ellipsis-position": position }, h("br-dropdown", null, h("br-button", { part: "ellipsis", exportparts: "button: ellipsis-button", slot: "trigger", shape: "circle", density: this.effectiveDensity, type: "button", "prop:ariaLabel": this.ellipsisLabel, tabIndex: -1, disabled: this.loading, onClick: () => {
                 this.resetEllipsisScrollOffset(key);
-            }, onKeyDown: this.handlePageKeyDown }, h("br-icon", { "attr:iconName": "fa6-solid:ellipsis", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.ellipsisLabel)), h("br-list", { class: { 'has-scroll': shouldVirtualize, 'is-virtualized': shouldVirtualize }, slot: "target", role: "menu", "aria-label": `Páginas ocultas de ${from} até ${to}`, "aria-orientation": "vertical", onScroll: shouldVirtualize ? this.handleEllipsisScrollFactory(key, totalItems) : undefined, style: shouldVirtualize ? { maxHeight: `${viewportHeight}px` } : undefined }, shouldVirtualize && topSpacerHeight > 0 ? (h("div", { class: "pagination-ellipsis-virtual-spacer", role: "presentation", "aria-hidden": "true", style: { height: `${topSpacerHeight}px` } })) : null, items, shouldVirtualize && bottomSpacerHeight > 0 ? (h("div", { class: "pagination-ellipsis-virtual-spacer", role: "presentation", "aria-hidden": "true", style: { height: `${bottomSpacerHeight}px` } })) : null))));
+            }, onKeyDown: this.handlePageKeyDown }, h("br-icon", { "attr:iconName": "fa6-solid:ellipsis", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.ellipsisLabel)), h("br-list", { class: { 'has-scroll': shouldVirtualize, 'is-virtualized': shouldVirtualize }, density: this.effectiveDensity, slot: "target", role: "menu", "aria-label": `Páginas ocultas de ${from} até ${to}`, "aria-orientation": "vertical", onScroll: shouldVirtualize ? this.handleEllipsisScrollFactory(key, totalItems) : undefined, style: shouldVirtualize ? { maxHeight: `${viewportHeight}px` } : undefined }, shouldVirtualize && topSpacerHeight > 0 ? (h("div", { class: "pagination-ellipsis-virtual-spacer", role: "presentation", "aria-hidden": "true", style: { height: `${topSpacerHeight}px` } })) : null, items, shouldVirtualize && bottomSpacerHeight > 0 ? (h("div", { class: "pagination-ellipsis-virtual-spacer", role: "presentation", "aria-hidden": "true", style: { height: `${bottomSpacerHeight}px` } })) : null))));
     }
     renderPagesSmall(total, current) {
         const nodes = [];
@@ -750,7 +836,7 @@ export class Pagination {
     }
     renderPages() {
         const total = this.getDefaultTotalPages();
-        const current = this.clampPage(this.current);
+        const current = this.effectiveCurrent;
         return this.isSmall ? this.renderPagesSmall(total, current) : this.renderPagesStandard(total, current);
     }
     renderLoading() {
@@ -759,14 +845,14 @@ export class Pagination {
         return (h("span", { part: "loading", class: "pagination-loading", role: "status", "aria-live": "polite", "aria-label": "Carregando" }, h("slot", { name: "loading" }, h("br-loading", { size: "small", compact: true, label: "Carregando" }))));
     }
     getTotalPages() {
-        const items = Math.max(0, Number(this.totalItems) || 0);
-        const perPage = Math.max(1, Number(this.perPage) || 1);
+        const items = this.effectiveTotalItems;
+        const perPage = this.effectivePerPage;
         return Math.max(1, Math.ceil(items / perPage));
     }
     getRangeInfo() {
-        const total = Math.max(0, Number(this.totalItems) || 0);
-        const perPage = Math.max(1, Number(this.perPage) || 1);
-        const current = this.clampPage(this.current);
+        const total = this.effectiveTotalItems;
+        const perPage = this.effectivePerPage;
+        const current = this.effectiveCurrent;
         if (total === 0)
             return { start: 0, end: 0, total };
         const start = (current - 1) * perPage + 1;
@@ -786,7 +872,7 @@ export class Pagination {
             this.handleGoToPageChange(event);
     }
     renderPerPageDropdown() {
-        return (h("br-select", { part: "per-page", exportparts: "container: per-page-container, input: per-page-input, input-container: per-page-input-container, input-field: per-page-input-field, input-action: per-page-input-action, list: per-page-list", label: this.perPageLabel, isInline: true, inputWidth: "88px", borderless: true, disabled: this.loading }, this.perPageOptions.map((perPageOption) => (h("br-select-option", { key: String(perPageOption), value: String(perPageOption), selected: perPageOption === this.perPage }, perPageOption)))));
+        return (h("br-select", { part: "per-page", exportparts: "container: per-page-container, input: per-page-input, input-container: per-page-input-container, input-field: per-page-input-field, input-label: per-page-input-label, input-action: per-page-input-action, list: per-page-list", label: this.perPageLabel, isInline: true, inputWidth: "88px", borderless: true, density: this.effectiveDensity, disabled: this.loading }, this.effectivePerPageOptions.map((perPageOption) => (h("br-select-option", { key: String(perPageOption), value: String(perPageOption), selected: perPageOption === this.effectivePerPage }, perPageOption)))));
     }
     renderPerPageSelect() {
         return (h("div", { class: "pagination-per-page", part: "per-page" }, this.renderPerPageDropdown()));
@@ -795,19 +881,19 @@ export class Pagination {
         const totalPages = this.getTotalPages();
         const largePageSet = totalPages > Pagination.LARGE_PAGE_THRESHOLD;
         const goToInputWidth = `${Math.max(88, String(totalPages).length * 16 + 48)}px`;
-        return (h("div", { class: "pagination-go-to-page d-none d-sm-flex ml-auto" }, h("br-select", { part: "go-to", exportparts: "container: go-to-container, input: go-to-input, input-container: go-to-input-container, input-field: go-to-input-field, input-action: go-to-input-action, list: go-to-list", label: this.goToPageLabel, options: largePageSet
+        return (h("div", { class: "pagination-go-to-page d-none d-sm-flex ml-auto" }, h("br-select", { part: "go-to", exportparts: "container: go-to-container, input: go-to-input, input-container: go-to-input-container, input-field: go-to-input-field, input-label: go-to-input-label, input-action: go-to-input-action, list: go-to-list", label: this.goToPageLabel, options: largePageSet
                 ? this.getWindowedGoToOptions(totalPages, this.goToSearchTerm)
                 : this.goToOptionsReady
                     ? this.getGoToOptions(totalPages)
-                    : this.getCurrentGoToOption(totalPages), onOpened: this.handleGoToSelectOpened, onClosed: () => (this.goToSearchTerm = ''), onBrSelectSearch: (event) => (this.goToSearchTerm = event.detail.query), value: String(this.current), isInline: true, inputWidth: goToInputWidth, "visible-items": 7, filterable: true, searchMode: largePageSet ? 'remote' : 'local', borderless: true, disabled: this.loading })));
+                    : this.getCurrentGoToOption(totalPages), onOpened: this.handleGoToSelectOpened, onClosed: () => (this.goToSearchTerm = ''), onBrSelectSearch: (event) => (this.goToSearchTerm = event.detail.query), value: String(this.effectiveCurrent), isInline: true, inputWidth: goToInputWidth, density: this.effectiveDensity, "visible-items": 7, filterable: true, searchMode: largePageSet ? 'remote' : 'local', borderless: true, disabled: this.loading })));
     }
     getWindowedGoToOptions(totalPages, query) {
         const parsed = Number.parseInt(query.trim(), 10);
-        const center = Number.isInteger(parsed) && parsed >= 1 && parsed <= totalPages ? parsed : this.current;
+        const center = Number.isInteger(parsed) && parsed >= 1 && parsed <= totalPages ? parsed : this.effectiveCurrent;
         const radius = query.trim() ? 10 : 50;
         const pages = new Set([1, totalPages]);
         if (!query.trim())
-            pages.add(Math.min(Math.max(this.current, 1), totalPages));
+            pages.add(Math.min(Math.max(this.effectiveCurrent, 1), totalPages));
         for (let page = center - radius; page <= center + radius; page++) {
             if (page >= 1 && page <= totalPages)
                 pages.add(page);
@@ -816,10 +902,10 @@ export class Pagination {
             return [];
         return [...pages]
             .sort((a, b) => a - b)
-            .map((page) => ({ value: String(page), label: String(page), selected: page === this.current }));
+            .map((page) => ({ value: String(page), label: String(page), selected: page === this.effectiveCurrent }));
     }
     getCurrentGoToOption(totalPages) {
-        const current = Math.min(Math.max(this.current, 1), totalPages);
+        const current = Math.min(Math.max(this.effectiveCurrent, 1), totalPages);
         return [{ value: String(current), label: String(current), selected: true }];
     }
     getGoToOptions(totalPages) {
@@ -835,14 +921,14 @@ export class Pagination {
     renderContextual() {
         const { start, end, total } = this.getRangeInfo();
         const totalPages = this.getTotalPages();
-        return (h("nav", { part: "nav", class: this.getCssClassMap(), "aria-busy": this.loading ? 'true' : null, "aria-label": this.getComputedNavAriaLabel(), tabIndex: -1, "data-total": total, "data-current": this.current, "data-per-page": this.perPage, id: this.customId }, this.renderPerPageSelect(), h("span", { class: "br-divider d-none d-sm-block mx-3" }), h("div", { class: "pagination-information d-none d-sm-flex", "aria-live": "polite" }, h("slot", { name: "pagination-info" }, h("span", { class: "current" }, start), "\u2013", h("span", { class: "per-page" }, end), "\u00A0de\u00A0", h("span", { class: "total" }, total), "\u00A0", this.itemsText), this.renderLoading()), this.renderGoToSelect(), h("span", { class: "br-divider d-none d-sm-block mx-3" }), h("div", { class: "pagination-arrows ml-auto ml-sm-0" }, h("br-button", { part: "prev-button", exportparts: "button: prev-button-inner", shape: "circle", density: this.density, type: "button", "data-previous-page": true, "prop:ariaLabel": this.previousLabel, onClick: this.handlePrevClick, disabled: this.loading || this.current <= 1 }, h("br-icon", { "attr:iconName": "fa6-solid:angle-left", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.previousLabel)), h("br-button", { part: "next-button", exportparts: "button: next-button-inner", shape: "circle", density: this.density, type: "button", "data-next-page": true, "prop:ariaLabel": this.nextLabel, onClick: this.handleNextClick, disabled: this.loading || this.current >= totalPages }, h("br-icon", { "attr:iconName": "fa6-solid:angle-right", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.nextLabel))), h("span", { class: "visually-hidden", "aria-live": "polite" }, "P\u00E1gina ", this.current, " de ", totalPages)));
+        return (h("nav", { part: "nav", class: this.getCssClassMap(), "aria-busy": this.loading ? 'true' : null, "aria-label": this.getComputedNavAriaLabel(), tabIndex: -1, "data-total": total, "data-current": this.effectiveCurrent, "data-per-page": this.effectivePerPage, id: this.customId }, this.renderPerPageSelect(), h("span", { class: "br-divider d-none d-sm-block mx-3" }), h("div", { class: "pagination-information d-none d-sm-flex", "aria-live": "polite" }, h("slot", { name: "pagination-info" }, h("span", { class: "current" }, start), "\u2013", h("span", { class: "per-page" }, end), "\u00A0de\u00A0", h("span", { class: "total" }, total), "\u00A0", this.itemsText), this.renderLoading()), this.renderGoToSelect(), h("span", { class: "br-divider d-none d-sm-block mx-3" }), h("div", { class: "pagination-arrows ml-auto ml-sm-0" }, h("br-button", { part: "prev-button", exportparts: "button: prev-button-inner", shape: "circle", density: this.effectiveDensity, type: "button", "data-previous-page": true, "prop:ariaLabel": this.previousLabel, onClick: this.handlePrevClick, disabled: this.loading || this.effectiveCurrent <= 1 }, h("br-icon", { "attr:iconName": "fa6-solid:angle-left", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.previousLabel)), h("br-button", { part: "next-button", exportparts: "button: next-button-inner", shape: "circle", density: this.effectiveDensity, type: "button", "data-next-page": true, "prop:ariaLabel": this.nextLabel, onClick: this.handleNextClick, disabled: this.loading || this.effectiveCurrent >= totalPages }, h("br-icon", { "attr:iconName": "fa6-solid:angle-right", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.nextLabel))), h("span", { class: "visually-hidden", "aria-live": "polite" }, "P\u00E1gina ", this.effectiveCurrent, " de ", totalPages)));
     }
     render() {
-        if (this.variant === 'contextual') {
+        if (this.effectiveVariant === 'contextual') {
             return h(Host, null, this.renderContextual());
         }
         const totalPages = this.getDefaultTotalPages();
-        return (h(Host, null, h("nav", { part: "nav", class: this.getCssClassMap(), "aria-busy": this.loading ? 'true' : null, "aria-label": this.getComputedNavAriaLabel(), tabIndex: -1, "data-total": totalPages, "data-current": this.current, id: this.customId }, h("ul", { part: "list" }, h("li", null, h("br-button", { part: "prev-button", exportparts: "button: prev-button-inner", shape: "circle", density: this.density, type: "button", "data-previous-page": true, "prop:ariaLabel": this.previousLabel, onClick: this.handlePrevClick, disabled: this.loading || this.current <= 1 }, h("br-icon", { "attr:iconName": "fa6-solid:angle-left", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.previousLabel))), this.renderPages(), this.loading ? (h("li", { part: "loading", class: "pagination-loading" }, this.renderLoading())) : null, h("li", null, h("br-button", { part: "next-button", exportparts: "button: next-button-inner", shape: "circle", density: this.density, type: "button", "data-next-page": true, "prop:ariaLabel": this.nextLabel, onClick: this.handleNextClick, disabled: this.loading || this.current >= totalPages }, h("br-icon", { "attr:iconName": "fa6-solid:angle-right", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.nextLabel)))), h("span", { class: "visually-hidden", "aria-live": "polite" }, "P\u00E1gina ", this.current, " de ", totalPages))));
+        return (h(Host, null, h("nav", { part: "nav", class: this.getCssClassMap(), "aria-busy": this.loading ? 'true' : null, "aria-label": this.getComputedNavAriaLabel(), tabIndex: -1, "data-total": totalPages, "data-current": this.effectiveCurrent, id: this.customId }, h("ul", { part: "list" }, h("li", null, h("br-button", { part: "prev-button", exportparts: "button: prev-button-inner", shape: "circle", density: this.effectiveDensity, type: "button", "data-previous-page": true, "prop:ariaLabel": this.previousLabel, onClick: this.handlePrevClick, disabled: this.loading || this.effectiveCurrent <= 1 }, h("br-icon", { "attr:iconName": "fa6-solid:angle-left", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.previousLabel))), this.renderPages(), this.loading ? (h("li", { part: "loading", class: "pagination-loading" }, this.renderLoading())) : null, h("li", null, h("br-button", { part: "next-button", exportparts: "button: next-button-inner", shape: "circle", density: this.effectiveDensity, type: "button", "data-next-page": true, "prop:ariaLabel": this.nextLabel, onClick: this.handleNextClick, disabled: this.loading || this.effectiveCurrent >= totalPages }, h("br-icon", { "attr:iconName": "fa6-solid:angle-right", width: "16", height: "16", "aria-hidden": "true" }), h("span", { class: "visually-hidden" }, this.nextLabel)))), h("span", { class: "visually-hidden", "aria-live": "polite" }, "P\u00E1gina ", this.effectiveCurrent, " de ", totalPages))));
     }
     static get is() { return "br-pagination"; }
     static get encapsulation() { return "shadow"; }
@@ -877,7 +963,7 @@ export class Pagination {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Define se a pagina\u00E7\u00E3o usar\u00E1 um esquema de cores escuro.\nQuando definido como `dark`, aplica a classe `dark-mode` ao container principal."
+                    "text": "Define se a pagina\u00E7\u00E3o usar\u00E1 um esquema de cores escuro. Valores inv\u00E1lidos s\u00E3o ignorados.\nQuando definido como `dark`, aplica a classe `dark-mode` ao container principal."
                 },
                 "getter": false,
                 "setter": false,
@@ -896,13 +982,13 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Identificador \u00FAnico do componente.\nQuando omitido, um valor \u00E9 gerado automaticamente.\n\n> **Padr\u00E3o:** valor \u00FAnico gerado por Helpers.generateUniqueId().\n\n> **Uso compartilhado:** mantenha esta descri\u00E7\u00E3o id\u00EAntica em todos os componentes que usam `customId`."
+                    "text": "Identificador \u00FAnico do componente.\nQuando omitido, um valor \u00E9 gerado automaticamente.\n\n> **Padr\u00E3o:** valor \u00FAnico gerado por `generateUniqueId()`.\n\n> **Uso compartilhado:** mantenha esta descri\u00E7\u00E3o id\u00EAntica em todos os componentes que usam `customId`."
                 },
                 "getter": false,
                 "setter": false,
                 "reflect": true,
                 "attribute": "custom-id",
-                "defaultValue": "Helpers.generateUniqueId()"
+                "defaultValue": "generateUniqueId()"
             },
             "total": {
                 "type": "number",
@@ -916,7 +1002,7 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Quantidade total de p\u00E1ginas (m\u00EDnimo 1)."
+                    "text": "Quantidade total de p\u00E1ginas (inteiro m\u00EDnimo 1). Valores inv\u00E1lidos usam 1."
                 },
                 "getter": false,
                 "setter": false,
@@ -936,7 +1022,7 @@ export class Pagination {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Quantidade total de p\u00E1ginas. Tem preced\u00EAncia sobre `total`."
+                    "text": "Quantidade total de p\u00E1ginas. Tem preced\u00EAncia sobre `total`; valores inv\u00E1lidos usam 1."
                 },
                 "getter": false,
                 "setter": false,
@@ -955,7 +1041,7 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "P\u00E1gina atual (1-indexada). Valores fora do intervalo ser\u00E3o ajustados."
+                    "text": "P\u00E1gina atual (inteira e 1-indexada). Valores inv\u00E1lidos usam 1; valores fora do intervalo s\u00E3o ajustados."
                 },
                 "getter": false,
                 "setter": false,
@@ -975,7 +1061,7 @@ export class Pagination {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "P\u00E1gina atual. Tem preced\u00EAncia sobre `current`."
+                    "text": "P\u00E1gina atual. Tem preced\u00EAncia sobre `current`; valores inv\u00E1lidos usam 1."
                 },
                 "getter": false,
                 "setter": false,
@@ -1080,7 +1166,7 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Define a densidade visual do componente.\n\n- `small`: Alta densidade (componente menor, mais compacto e com menos espa\u00E7amento).\n- `medium`: Densidade intermedi\u00E1ria, padr\u00E3o recomendado para a maioria dos casos.\n- `large`: Baixa densidade (componente maior, mais espa\u00E7amento e altura).\n\n> **Uso compartilhado:** mantenha esta descri\u00E7\u00E3o id\u00EAntica em todos os componentes que usam `density`."
+                    "text": "Define a densidade visual do componente.\n\n- `small`: Alta densidade (componente menor, mais compacto e com menos espa\u00E7amento).\n- `medium`: Densidade intermedi\u00E1ria, padr\u00E3o recomendado para a maioria dos casos.\n- `large`: Baixa densidade (componente maior, mais espa\u00E7amento e altura).\n\n> **Uso compartilhado:** mantenha esta descri\u00E7\u00E3o id\u00EAntica em todos os componentes que usam `density`.\nValores inv\u00E1lidos usam `medium`."
                 },
                 "getter": false,
                 "setter": false,
@@ -1107,7 +1193,7 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Variante de renderiza\u00E7\u00E3o do componente.\n- `default`: pagina\u00E7\u00E3o num\u00E9rica (padr\u00E3o)\n- `contextual`: pagina\u00E7\u00E3o contextual com seletores e informa\u00E7\u00E3o de itens"
+                    "text": "Variante de renderiza\u00E7\u00E3o do componente. Valores inv\u00E1lidos usam `default`.\n- `default`: pagina\u00E7\u00E3o num\u00E9rica (padr\u00E3o)\n- `contextual`: pagina\u00E7\u00E3o contextual com seletores e informa\u00E7\u00E3o de itens"
                 },
                 "getter": false,
                 "setter": false,
@@ -1173,7 +1259,7 @@ export class Pagination {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Total de itens (aplic\u00E1vel na variante contextual)."
+                    "text": "Total de itens (inteiro n\u00E3o negativo, aplic\u00E1vel na variante contextual). Valores inv\u00E1lidos usam 0."
                 },
                 "getter": false,
                 "setter": false,
@@ -1192,7 +1278,7 @@ export class Pagination {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Itens por p\u00E1gina (aplic\u00E1vel na variante contextual)."
+                    "text": "Itens por p\u00E1gina (inteiro positivo, aplic\u00E1vel na variante contextual). Valores inv\u00E1lidos usam 10."
                 },
                 "getter": false,
                 "setter": false,
@@ -1211,8 +1297,11 @@ export class Pagination {
                 "required": false,
                 "optional": false,
                 "docs": {
-                    "tags": [],
-                    "text": "Op\u00E7\u00F5es dispon\u00EDveis de itens por p\u00E1gina (variante contextual)."
+                    "tags": [{
+                            "name": "example",
+                            "text": "```js\nconst pagination = document.querySelector('br-pagination');\npagination.perPageOptions = [10, 25, 50, 100];\n```"
+                        }],
+                    "text": "Op\u00E7\u00F5es dispon\u00EDveis de itens por p\u00E1gina na variante `contextual`.\nPasse o array por property binding; atributos HTML n\u00E3o representam arrays."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/radio/radio.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)}.br-radio{--radio-size: 24px;--radio-bullet-size: 16px;--radio-bullet-position: calc((var(--radio-size) - var(--radio-bullet-size)) * 0.5);display:block}.br-radio+.br-radio{margin-top:var(--spacing-scale-base)}.br-radio input{opacity:0;position:absolute}.br-radio input+label{cursor:pointer;display:inline-block;margin-bottom:0;min-height:var(--radio-size);min-width:var(--radio-size);padding-left:calc(var(--spacing-scale-base) + var(--radio-size));position:relative}.br-radio input+label::before{background:var(--background);border:1px solid var(--border-color);border-radius:50%;content:"";height:var(--radio-size);left:0;position:absolute;top:-1px;width:var(--radio-size)}.br-radio input+label:empty{padding:0}.br-radio input+label:empty::before{top:0}.br-radio label{font-weight:var(--font-weight-medium)}.br-radio input:checked+label::after{background:var(--selected);border:7px solid var(--selected);border-radius:50%;content:"";height:var(--radio-bullet-size);left:var(--radio-bullet-position);position:absolute;right:0;top:calc(var(--radio-bullet-position) - 1px);width:var(--radio-bullet-size)}.br-radio input:checked+label:empty::after{top:var(--radio-bullet-position)}.br-radio.valid input+label::before,.br-radio[valid] input+label::before{border-color:var(--success)}.br-radio.invalid input+label::before,.br-radio[invalid] input+label::before{border-color:var(--danger)}.br-radio.small input+label,.br-radio[small] input+label{line-height:var(--spacing-scale-2xh);min-height:var(--spacing-scale-2xh)}.br-radio.small input+label::before,.br-radio[small] input+label::before{height:var(--spacing-scale-2xh);width:var(--spacing-scale-2xh)}.br-radio.small input:checked+label::after,.br-radio[small] input:checked+label::after{border-width:4px;height:10px;width:10px}.br-radio input:invalid+label::before{border-color:var(--danger)}.br-radio input:focus-visible:checked+label::before,.br-radio input:focus-visible+label::before,.br-radio input.focus-visible:checked+label::before,.br-radio input.focus-visible+label::before{border-color:var(--focus) !important;box-shadow:0 0 0 var(--surface-width-md) var(--focus);outline:none}.br-radio input:hover:not(:disabled)+label::before{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}.br-radio.inverted,.br-radio.inverted label,.br-radio.dark-mode,.br-radio.dark-mode label{color:var(--color-dark)}input:checked+label::after{background:var(--selected);border:7px solid var(--selected);border-radius:50%;content:"";height:var(--radio-bullet-size);left:var(--radio-bullet-position);position:absolute;right:0;top:calc(var(--radio-bullet-position) - 1px);width:var(--radio-bullet-size)}input:checked+label:empty::after{top:var(--radio-bullet-position)}:host{display:inline-block;margin-bottom:var(--spacing-scale-base)}:host .br-radio.hidden-label label{padding-left:calc(var(--checkbox-size) + var(--surface-width-md)*2);text-indent:-10000px;white-space:nowrap;width:0}
+*,*::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}.br-radio{--radio-size: 24px;--radio-bullet-size: 16px;--radio-bullet-position: calc((var(--radio-size) - var(--radio-bullet-size)) * 0.5);display:block}.br-radio+.br-radio{margin-top:var(--spacing-scale-base)}.br-radio input{opacity:0;position:absolute}.br-radio input+label{cursor:pointer;display:inline-block;margin-bottom:0;min-height:var(--radio-size);min-width:var(--radio-size);padding-left:calc(var(--spacing-scale-base) + var(--radio-size));position:relative}.br-radio input+label::before{background:var(--background);border:1px solid var(--border-color);border-radius:50%;content:"";height:var(--radio-size);left:0;position:absolute;top:-1px;width:var(--radio-size)}.br-radio input+label:empty{padding:0}.br-radio input+label:empty::before{top:0}.br-radio label{font-weight:var(--font-weight-medium)}.br-radio input:checked+label::after{background:var(--selected);border:7px solid var(--selected);border-radius:50%;content:"";height:var(--radio-bullet-size);left:var(--radio-bullet-position);position:absolute;right:0;top:calc(var(--radio-bullet-position) - 1px);width:var(--radio-bullet-size)}.br-radio input:checked+label:empty::after{top:var(--radio-bullet-position)}.br-radio.valid input+label::before,.br-radio[valid] input+label::before{border-color:var(--success)}.br-radio.invalid input+label::before,.br-radio[invalid] input+label::before{border-color:var(--danger)}.br-radio.small input+label,.br-radio[small] input+label{line-height:var(--spacing-scale-2xh);min-height:var(--spacing-scale-2xh)}.br-radio.small input+label::before,.br-radio[small] input+label::before{height:var(--spacing-scale-2xh);width:var(--spacing-scale-2xh)}.br-radio.small input:checked+label::after,.br-radio[small] input:checked+label::after{border-width:4px;height:10px;width:10px}.br-radio input:invalid+label::before{border-color:var(--danger)}.br-radio input:focus-visible:checked+label::before,.br-radio input:focus-visible+label::before,.br-radio input.focus-visible:checked+label::before,.br-radio input.focus-visible+label::before{border-color:var(--focus) !important;box-shadow:0 0 0 var(--surface-width-md) var(--focus);outline:none}.br-radio input:hover:not(:disabled)+label::before{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}.br-radio.inverted,.br-radio.inverted label,.br-radio.dark-mode,.br-radio.dark-mode label{color:var(--color-dark)}input:checked+label::after{background:var(--selected);border:7px solid var(--selected);border-radius:50%;content:"";height:var(--radio-bullet-size);left:var(--radio-bullet-position);position:absolute;right:0;top:calc(var(--radio-bullet-position) - 1px);width:var(--radio-bullet-size)}input:checked+label:empty::after{top:var(--radio-bullet-position)}:host{display:inline-block;margin-bottom:var(--spacing-scale-base)}:host .br-radio.hidden-label label{padding-left:calc(var(--checkbox-size) + var(--surface-width-md)*2);text-indent:-10000px;white-space:nowrap;width:0}