@govbr-ds/webcomponents 2.1.3 → 2.2.0

package/dist/collection/components/step/step.js

@@ -3,12 +3,53 @@
  * © https://serpro.gov.br/ - MIT License.
  */
 import { Host, h, } from "@stencil/core";
+import { findComposedOwner } from "../../shared/utils/ownership";
+import { resolveAllowedPropValue, resolveIntegerPropValue } from "../../shared/utils/props";
+const STEP_ORIENTATIONS = ['horizontal', 'vertical'];
+const STEP_LABEL_POSITIONS = ['top', 'right', 'bottom', 'left'];
+const STEP_CONTENT_TYPES = [
+    'default',
+    'br-icon',
+    'no-content',
+    'slotted',
+];
+const STEP_MODES = ['controller', 'step'];
+const STEP_PROGRESSION_TYPES = ['linear', 'nonlinear'];
+const STEP_VERTICAL_CONTENT_PLACEMENTS = ['between', 'side'];
 /**
- * ## Design System
+ * O componente `br-step` é o indicador visual de etapas e progresso do GovBR-DS, desenvolvido para orientar a pessoa usuária ao longo de fluxos sequenciais e processos com múltiplos passos.
  *
- * 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/step?tab=designer).
+ * ### Para que serve
  *
- * @category Navegação
+ * - **Visualização de progresso:** Informa claramente em qual etapa do processo o usuário se encontra, quais já foram concluídas e quais ainda estão pendentes.
+ * - **Orientação flexível:** Suporta leiaute horizontal (ideal para telas amplas) e vertical (ideal para fluxos em barra lateral ou dispositivos móveis).
+ * - **Semântica e acessibilidade WAI-ARIA:** Comunica o passo ativo através de `aria-current="step"` e indica etapas concluídas ou bloqueadas.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - O fluxo tiver entre 2 e 5 etapas lógicas com uma sequência recomendada de execução (ex.: Identificação > Dados > Pagamento > Confirmação).
+ * - **Evite e prefira outro componente quando:**
+ *   - A pessoa usuária puder alternar livremente entre as seções em qualquer ordem sem dependência de progresso (prefira `br-tab`).
+ *   - For necessário um contêiner completo que gerencie também os painéis de formulário e botões de avançar/voltar (prefira `br-wizard`).
+ *
+ * ### Composição e Subcomponentes
+ *
+ * | Subcomponente | Papel | Regra de uso |
+ * | --- | --- | --- |
+ * | `br-step` | **Orquestrador de progresso.** Gerencia a orientação, conecta as linhas de fluxo e calcula os estados das etapas. | Contêiner raiz da barra de progresso. |
+ * | `br-step-item` | **Etapa individual.** Representa cada passo com número, rótulo e estado. | Declarado dentro do slot padrão do `br-step`. |
+ *
+ * ### Como os subcomponentes se relacionam
+ *
+ * O componente pai `br-step` recebe múltiplos elementos `br-step-item` em seu slot padrão:
+ * 1. Com base na propriedade `current` ou nos índices declarados, o pai calcula as linhas conectoras visuais entre as etapas.
+ * 2. Sincroniza os estados de cada etapa: concluída (`completed`), ativa (`active`) ou desabilitada (`disabled`).
+ *
+ * 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/step?tab=designer).
+ *
+
+ * @category Navegação, Progresso
  * @status stable
  * @slot default - Slot para os itens do step (br-step-item), aceitando apenas esse componente.
  *
@@ -27,40 +68,41 @@ export class Step {
         this.isTablist = false;
         this.stepItems = [];
         /**
-         * propriedade responsável por definir a orientação do componente Step
+         * propriedade responsável por definir a orientação do componente Step. Valores inválidos usam `horizontal`.
          * @deprecated Use `orientation`.
          */
         this.layout = 'horizontal';
         /**
          *
-         * define o passo que começará destacado
+         * define o passo que começará destacado. Valores inválidos usam 0.
          * @deprecated Use `initialIndex`.
          */
         this.initialStep = '0';
         /**
          *
-         * Propriedade que  define a posição onde o texto de destaque,label, ficará localizado no stepItem
+         * Propriedade que define a posição onde o texto de destaque, label, ficará localizado no stepItem. Valores inválidos usam `bottom`.
          */
         this.labelPosition = 'bottom';
         /**
          *
-         * Propriedade que define o tipo de conteúdo a ser exibido dentro do componente step  e stepItem
+         * Propriedade que define o tipo de conteúdo a ser exibido dentro do componente step e stepItem. Valores inválidos usam `default`.
          */
         this.contentType = 'default';
         /**
          *
-         * Propriedade que define o tipo de comportamento que o componente Step deverá seguir
+         * Propriedade que define o tipo de comportamento que o componente Step deverá seguir. Valores inválidos usam `step`.
          */
         this.mode = 'step';
         /**
          *
-         * Propriedade que define o tipo de progressão de etapas que o step vai executar
+         * Propriedade que define o tipo de progressão de etapas que o step vai executar. Valores inválidos usam `nonlinear`.
          */
         this.progressionType = 'nonlinear';
         /**
          * Define a posição do conteúdo de cada etapa no layout vertical.
          * - `between`: conteúdo abaixo do indicador/rótulo, entre as etapas.
          * - `side`: conteúdo em coluna lateral à linha de indicadores.
+         * Valores inválidos usam `between`.
          */
         this.verticalContentPlacement = 'between';
         this.ariaObjectContent = {
@@ -83,7 +125,7 @@ export class Step {
         if (oldValue === newValue || !this.isValidStepIndex(newValue))
             return;
         this.updateStepItemsActiveState(oldValue);
-        if (this.progressionType === 'linear') {
+        if (this.effectiveProgressionType === 'linear') {
             this.configureLinearProgression();
         }
         this.brStepChange.emit({ activeStep: newValue });
@@ -114,8 +156,8 @@ export class Step {
     /**
      * Observa mudanças no modo e propaga aos itens.
      */
-    modeChanged(newValue) {
-        this.setStepItemsMode(newValue);
+    modeChanged(_newValue) {
+        this.setStepItemsMode(this.effectiveMode);
         this.configureStepItems();
     }
     /**
@@ -136,8 +178,16 @@ export class Step {
     verticalContentPlacementChanged() {
         this.setStepItemsVerticalContentPlacement();
     }
+    get effectiveInitialIndex() {
+        const initialIndex = resolveIntegerPropValue(this.el, 'initialIndex', this.initialIndex, 0, Number.MAX_SAFE_INTEGER, 0, {
+            allowUndefined: true,
+        });
+        if (initialIndex !== undefined)
+            return initialIndex;
+        return resolveIntegerPropValue(this.el, 'initialStep', Number(this.initialStep), 0, Number.MAX_SAFE_INTEGER, 0);
+    }
     componentWillLoad() {
-        this.activeStep = this.initialIndex ?? Number(this.initialStep);
+        this.activeStep = this.effectiveInitialIndex;
         this.getStepItemsElements();
         const root = this.el.getRootNode();
         this.isTablist = root instanceof ShadowRoot && root.host?.tagName?.toLowerCase() === 'br-carousel';
@@ -146,7 +196,7 @@ export class Step {
         this.setStepItemsLabelPosition();
         this.setStepItemsContentType();
         this.setStepItemsDefaultContent();
-        this.setStepItemsMode(this.mode);
+        this.setStepItemsMode(this.effectiveMode);
         this.setStepItemsVerticalContentPlacement();
         this.configureStepItems();
         if (this.isValidStepIndex(this.activeStep)) {
@@ -161,9 +211,10 @@ export class Step {
      * Através desse listener o componente define qual será o proximo passo do step que terá o estado ativo
      */
     handleClick(event) {
-        const targetElement = event.target;
-        const targetStepItem = targetElement.closest('br-step-item');
-        if (targetStepItem === null)
+        const targetStepItem = event
+            .composedPath()
+            .find((node) => node.tagName?.toLowerCase() === 'br-step-item');
+        if (!targetStepItem || findComposedOwner(targetStepItem, 'br-step') !== this.el)
             return;
         this.setActiveStep(this.stepItems.indexOf(targetStepItem));
     }
@@ -177,7 +228,7 @@ export class Step {
         this.getStepItemsElements();
         if (this.activeStep + 1 < this.stepItems.length) {
             this.setActiveStep(this.activeStep + 1);
-            if (this.progressionType === 'linear') {
+            if (this.effectiveProgressionType === 'linear') {
                 this.configureLinearProgression();
             }
         }
@@ -223,7 +274,25 @@ export class Step {
         return this.activeStep;
     }
     get effectiveOrientation() {
-        return this.orientation ?? this.layout;
+        if (this.orientation !== undefined) {
+            return resolveAllowedPropValue(this.el, 'orientation', this.orientation, STEP_ORIENTATIONS, 'horizontal');
+        }
+        return resolveAllowedPropValue(this.el, 'layout', this.layout, STEP_ORIENTATIONS, 'horizontal');
+    }
+    get effectiveLabelPosition() {
+        return resolveAllowedPropValue(this.el, 'labelPosition', this.labelPosition, STEP_LABEL_POSITIONS, 'bottom');
+    }
+    get effectiveContentType() {
+        return resolveAllowedPropValue(this.el, 'contentType', this.contentType, STEP_CONTENT_TYPES, 'default');
+    }
+    get effectiveMode() {
+        return resolveAllowedPropValue(this.el, 'mode', this.mode, STEP_MODES, 'step');
+    }
+    get effectiveProgressionType() {
+        return resolveAllowedPropValue(this.el, 'progressionType', this.progressionType, STEP_PROGRESSION_TYPES, 'nonlinear');
+    }
+    get effectiveVerticalContentPlacement() {
+        return resolveAllowedPropValue(this.el, 'verticalContentPlacement', this.verticalContentPlacement, STEP_VERTICAL_CONTENT_PLACEMENTS, 'between');
     }
     /**
      * Atualiza os atributos 'active' dos step-items de forma segura
@@ -238,7 +307,9 @@ export class Step {
     getStepItemsElements() {
         const rawChildren = Array.from(this.el.children).filter((child) => child.tagName.toLowerCase() !== 'style' && child.tagName.toLowerCase() !== 'script');
         if (rawChildren.length === 0) {
-            this.stepItems = [];
+            if (this.stepItems.length > 0) {
+                this.stepItems = [];
+            }
             return;
         }
         const childrenHaveConsistentTagName = rawChildren.every((item) => item.tagName.toLowerCase() === 'br-step-item');
@@ -251,6 +322,9 @@ export class Step {
         if (!childrenHaveConsistentContentType) {
             throw new Error('br-step must have all child elements with same content type attribute value');
         }
+        const stepItemsDidNotChange = this.stepItems.length === slotItems.length && this.stepItems.every((item, index) => item === slotItems[index]);
+        if (stepItemsDidNotChange)
+            return;
         this.stepItems = slotItems;
     }
     getStepItems() {
@@ -264,7 +338,7 @@ export class Step {
         const slotItems = this.getStepItems();
         slotItems.forEach((elements) => {
             if (this.labelPosition !== undefined) {
-                elements.setLabelPosition(this.labelPosition);
+                elements.setLabelPosition(this.effectiveLabelPosition);
             }
         });
     }
@@ -277,13 +351,13 @@ export class Step {
     }
     async setStepItemsContentType() {
         const slotItems = this.getStepItems();
-        await Promise.all(slotItems.map((element) => element.setContentType(this.contentType)));
+        await Promise.all(slotItems.map((element) => element.setContentType(this.effectiveContentType)));
         slotItems.forEach((elements, index) => {
             elements.setAttribute('aria-posinset', `${index + 1}`);
             elements.setAttribute('aria-setsize', `${slotItems.length}`);
         });
     }
-    setStepItemsMode(mode) {
+    setStepItemsMode(mode = this.effectiveMode) {
         const slotItems = this.getStepItems();
         slotItems.forEach((elements) => {
             elements.setMode(mode);
@@ -302,13 +376,13 @@ export class Step {
     setStepItemsVerticalContentPlacement() {
         const slotItems = this.getStepItems();
         slotItems.forEach((element) => {
-            element.setVerticalContentPlacement(this.verticalContentPlacement);
+            element.setVerticalContentPlacement(this.effectiveVerticalContentPlacement);
         });
     }
     setActiveStep(value) {
         if (!this.isValidStepIndex(value))
             return;
-        if (this.progressionType !== 'linear' && this.stepItems[value]?.hasAttribute('disabled'))
+        if (this.effectiveProgressionType !== 'linear' && this.stepItems[value]?.hasAttribute('disabled'))
             return;
         this.activeStep = value;
     }
@@ -320,10 +394,10 @@ export class Step {
             this.configureTablistMode();
             return;
         }
-        if (this.mode === 'step') {
+        if (this.effectiveMode === 'step') {
             this.configureTimeLine();
         }
-        if (this.progressionType === 'linear') {
+        if (this.effectiveProgressionType === 'linear') {
             this.configureLinearProgression();
         }
         else {
@@ -382,6 +456,7 @@ export class Step {
     clearLinearProgression() {
         const slotItems = this.getStepItems();
         slotItems.forEach((elements) => {
+            elements.disabled = false;
             elements.removeAttribute('disabled');
         });
     }
@@ -397,29 +472,29 @@ export class Step {
             return 'Slides';
         }
         let ariaLabel = ' Lista de Opções ';
-        if (this.mode !== 'controller') {
+        if (this.effectiveMode !== 'controller') {
             ariaLabel +=
-                this.ariaObjectContent[this.mode] +
-                    this.ariaObjectContent[this.contentType] +
-                    this.ariaObjectContent[this.progressionType] +
+                this.ariaObjectContent[this.effectiveMode] +
+                    this.ariaObjectContent[this.effectiveContentType] +
+                    this.ariaObjectContent[this.effectiveProgressionType] +
                     this.ariaObjectContent[this.effectiveOrientation];
         }
         else {
-            ariaLabel += this.ariaObjectContent[this.mode];
+            ariaLabel += this.ariaObjectContent[this.effectiveMode];
         }
         return ariaLabel;
     }
     render() {
         const isTablist = this.isTablist;
-        return (h(Host, { key: 'afbe0f698f9c2e98309cc4ebcd920eade167209f' }, this.stepItems.length > 0 &&
-            (isTablist ? (h("div", { part: "container", role: "tablist", "aria-orientation": this.effectiveOrientation, "aria-label": this.getAreaLabel(), class: this.getCssClassMap(), "data-label": this.labelPosition }, h("div", { class: "step-progress" }, h("slot", { onSlotchange: () => this.handleSlotChange() })))) : (h("div", { part: "container", role: "group", "aria-label": this.getAreaLabel(), class: this.getCssClassMap(), "data-label": this.labelPosition }, h("div", { class: "step-progress" }, h("slot", { onSlotchange: () => this.handleSlotChange() })))))));
+        return (h(Host, { key: '9c911332978824aeef3be291bcda9d0f411efbb5' }, this.stepItems.length > 0 &&
+            (isTablist ? (h("div", { part: "container", role: "tablist", "aria-orientation": this.effectiveOrientation, "aria-label": this.getAreaLabel(), class: this.getCssClassMap(), "data-label": this.effectiveLabelPosition }, h("div", { class: "step-progress" }, h("slot", { onSlotchange: () => this.handleSlotChange() })))) : (h("div", { part: "container", role: "group", "aria-label": this.getAreaLabel(), class: this.getCssClassMap(), "data-label": this.effectiveLabelPosition }, h("div", { class: "step-progress" }, h("slot", { onSlotchange: () => this.handleSlotChange() })))))));
     }
     handleSlotChange() {
         this.getStepItemsElements();
         this.setStepItemsLabelPosition();
         void this.setStepItemsContentType();
         this.setStepItemsDefaultContent();
-        this.setStepItemsMode(this.mode);
+        this.setStepItemsMode(this.effectiveMode);
         this.setStepItemsVerticalContentPlacement();
         this.configureStepItems();
     }
@@ -459,7 +534,7 @@ export class Step {
                             "name": "deprecated",
                             "text": "Use `orientation`."
                         }],
-                    "text": "propriedade respons\u00E1vel por definir a orienta\u00E7\u00E3o do componente Step"
+                    "text": "propriedade respons\u00E1vel por definir a orienta\u00E7\u00E3o do componente Step. Valores inv\u00E1lidos usam `horizontal`."
                 },
                 "getter": false,
                 "setter": false,
@@ -486,7 +561,7 @@ export class Step {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Orienta\u00E7\u00E3o do componente. Quando informada, tem preced\u00EAncia sobre `layout`."
+                    "text": "Orienta\u00E7\u00E3o do componente. Quando informada, tem preced\u00EAncia sobre `layout`; valores inv\u00E1lidos usam `horizontal`."
                 },
                 "getter": false,
                 "setter": false,
@@ -508,7 +583,7 @@ export class Step {
                             "name": "deprecated",
                             "text": "Use `initialIndex`."
                         }],
-                    "text": "\ndefine o passo que come\u00E7ar\u00E1 destacado"
+                    "text": "\ndefine o passo que come\u00E7ar\u00E1 destacado. Valores inv\u00E1lidos usam 0."
                 },
                 "getter": false,
                 "setter": false,
@@ -528,7 +603,7 @@ export class Step {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "\u00CDndice inicial zero-based. Quando informado, tem preced\u00EAncia sobre `initialStep`."
+                    "text": "\u00CDndice inicial zero-based. Quando informado, tem preced\u00EAncia sobre `initialStep`; valores inv\u00E1lidos usam 0."
                 },
                 "getter": false,
                 "setter": false,
@@ -554,7 +629,7 @@ export class Step {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "\nPropriedade que  define a posi\u00E7\u00E3o onde o texto de destaque,label, ficar\u00E1 localizado no stepItem"
+                    "text": "\nPropriedade que define a posi\u00E7\u00E3o onde o texto de destaque, label, ficar\u00E1 localizado no stepItem. Valores inv\u00E1lidos usam `bottom`."
                 },
                 "getter": false,
                 "setter": false,
@@ -581,7 +656,7 @@ export class Step {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "\nPropriedade que define o tipo de conte\u00FAdo a ser exibido dentro do componente step  e stepItem"
+                    "text": "\nPropriedade que define o tipo de conte\u00FAdo a ser exibido dentro do componente step e stepItem. Valores inv\u00E1lidos usam `default`."
                 },
                 "getter": false,
                 "setter": false,
@@ -608,7 +683,7 @@ export class Step {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "\nPropriedade que define o tipo de comportamento que o componente Step dever\u00E1 seguir"
+                    "text": "\nPropriedade que define o tipo de comportamento que o componente Step dever\u00E1 seguir. Valores inv\u00E1lidos usam `step`."
                 },
                 "getter": false,
                 "setter": false,
@@ -635,7 +710,7 @@ export class Step {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "\nPropriedade que define o tipo de progress\u00E3o de etapas que o step vai executar"
+                    "text": "\nPropriedade que define o tipo de progress\u00E3o de etapas que o step vai executar. Valores inv\u00E1lidos usam `nonlinear`."
                 },
                 "getter": false,
                 "setter": false,
@@ -662,7 +737,7 @@ export class Step {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Define a posi\u00E7\u00E3o do conte\u00FAdo de cada etapa no layout vertical.\n- `between`: conte\u00FAdo abaixo do indicador/r\u00F3tulo, entre as etapas.\n- `side`: conte\u00FAdo em coluna lateral \u00E0 linha de indicadores."
+                    "text": "Define a posi\u00E7\u00E3o do conte\u00FAdo de cada etapa no layout vertical.\n- `between`: conte\u00FAdo abaixo do indicador/r\u00F3tulo, entre as etapas.\n- `side`: conte\u00FAdo em coluna lateral \u00E0 linha de indicadores.\nValores inv\u00E1lidos usam `between`."
                 },
                 "getter": false,
                 "setter": false,

package/dist/collection/components/switch/switch.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-switch{--switch-height: var(--switch-height-medium);--switch-width: var(--switch-width-medium);--switch-toggle-size: var(--switch-toggle-medium);--switch-icon-size: var(--switch-icon-medium);--switch-height-small: 24px;--switch-height-medium: 30px;--switch-height-large: 36px;--switch-width-small: 40px;--switch-width-medium: 52px;--switch-width-large: 64px;--switch-toggle-small: 16px;--switch-toggle-medium: 22px;--switch-toggle-large: 28px;--switch-icon-small: var(--icon-size-xs);--switch-icon-medium: var(--icon-size-sm);--switch-icon-large: var(--icon-size-base);display:inline-flex;min-height:var(--switch-height)}.br-switch input{opacity:0;position:absolute}.br-switch input+label{align-items:center;color:var(--color);cursor:pointer;display:inline-flex;font-size:var(--font-size-scale-base);margin-bottom:0;position:relative}.br-switch input+label::before{background:var(--background-light);border:1px solid var(--border-color);border-radius:100em;content:"";height:var(--switch-height);position:absolute;width:var(--switch-width)}.br-switch input+label::after{background-color:var(--off);border-radius:50%;content:"";height:var(--switch-toggle-size);position:absolute;transition:all .3s ease-in-out;width:var(--switch-toggle-size)}.br-switch input:checked+label::after{background-color:var(--on)}.br-switch input+label{padding-right:calc(var(--spacing-scale-2x) + var(--switch-width))}.br-switch input+label:empty{padding-right:var(--switch-width)}.br-switch input+label::before{right:0}.br-switch input+label::after{right:calc(4px + var(--switch-toggle-size))}.br-switch input:checked+label::after{right:4px}.br-switch.right input+label{padding-left:calc(var(--spacing-scale-2x) + var(--switch-width));padding-right:0}.br-switch.right input+label::before{left:0}.br-switch.right input+label::after{left:4px}.br-switch.right input:checked+label::after{left:calc(var(--switch-width) - var(--switch-toggle-size) - 4px)}.br-switch.top{min-height:calc(var(--switch-height)*2)}.br-switch.top input+label{align-items:flex-start;padding-right:0}.br-switch.top input+label::before{bottom:0;left:0}.br-switch.top input+label::after{bottom:4px;left:4px}.br-switch.top input:checked+label::after{left:calc(var(--switch-width) - var(--switch-toggle-size) - 4px)}.br-switch.small{--switch-height: var(--switch-height-small);--switch-width: var(--switch-width-small);--switch-toggle-size: var(--switch-toggle-small);--switch-icon-size: var(--switch-icon-small)}.br-switch.medium{--switch-height: var(--switch-height-medium);--switch-width: var(--switch-width-medium);--switch-toggle-size: var(--switch-toggle-medium);--switch-icon-size: var(--switch-icon-medium)}.br-switch.large{--switch-height: var(--switch-height-large);--switch-width: var(--switch-width-large);--switch-toggle-size: var(--switch-toggle-large);--switch-icon-size: var(--switch-icon-large)}.br-switch input~.switch-data{align-self:center;color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-regular);margin-left:8px}.br-switch input~.switch-data::before{content:attr(data-disabled)}.br-switch input:checked~.switch-data{color:var(--color)}.br-switch input:checked~.switch-data::before{content:attr(data-enabled)}.br-switch.icon input+label::after{align-items:center;color:var(--color-dark);content:"";display:inline-flex;font-family:"Font Awesome 5 Free",sans-serif;font-size:var(--switch-icon-size);font-weight:var(--font-weight-black);justify-content:center}.br-switch.icon input:checked+label::after{content:""}.br-switch input:focus-visible+label::before,.br-switch input.focus-visible+label::before{border-color:var(--focus) !important;box-shadow:0 0 0 var(--surface-width-md) var(--focus);outline:none}.br-switch input:hover:not([disabled]):checked+label::before{background-image:linear-gradient(rgba(var(--on-rgb), var(--hover)), rgba(var(--on-rgb), var(--hover)))}.br-switch input:hover:not([disabled]):not(:checked)+label::before{background-image:linear-gradient(rgba(var(--off-rgb), var(--hover)), rgba(var(--off-rgb), var(--hover)))}.br-switch input:active:not([disabled]):checked+label::before{background-image:linear-gradient(rgba(var(--on-rgb), var(--pressed)), rgba(var(--on-rgb), var(--pressed)))}.br-switch input:active:not([disabled]):not(:checked)+label::before{background-image:linear-gradient(rgba(var(--off-rgb), var(--pressed)), rgba(var(--off-rgb), var(--pressed)))}.br-switch.inverted,.br-switch.inverted label,.br-switch.dark-mode,.br-switch.dark-mode label{color:var(--color-dark)}:host{display:inline-block;margin-bottom:var(--spacing-scale-base)}:host([disabled]) .br-switch,:host([disabled]) .br-switch label,:host([disabled]) .br-switch input{cursor:not-allowed}
+*,*::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-switch{--switch-height: var(--switch-height-medium);--switch-width: var(--switch-width-medium);--switch-toggle-size: var(--switch-toggle-medium);--switch-icon-size: var(--switch-icon-medium);--switch-height-small: 24px;--switch-height-medium: 30px;--switch-height-large: 36px;--switch-width-small: 40px;--switch-width-medium: 52px;--switch-width-large: 64px;--switch-toggle-small: 16px;--switch-toggle-medium: 22px;--switch-toggle-large: 28px;--switch-icon-small: var(--icon-size-xs);--switch-icon-medium: var(--icon-size-sm);--switch-icon-large: var(--icon-size-base);display:inline-flex;min-height:var(--switch-height)}.br-switch input{opacity:0;position:absolute}.br-switch input+label{align-items:center;color:var(--color);cursor:pointer;display:inline-flex;font-size:var(--font-size-scale-base);margin-bottom:0;position:relative}.br-switch input+label::before{background:var(--background-light);border:1px solid var(--border-color);border-radius:100em;content:"";height:var(--switch-height);position:absolute;width:var(--switch-width)}.br-switch input+label::after{background-color:var(--off);border-radius:50%;content:"";height:var(--switch-toggle-size);position:absolute;transition:all .3s ease-in-out;width:var(--switch-toggle-size)}.br-switch input:checked+label::after{background-color:var(--on)}.br-switch input+label{padding-right:calc(var(--spacing-scale-2x) + var(--switch-width))}.br-switch input+label:empty{padding-right:var(--switch-width)}.br-switch input+label::before{right:0}.br-switch input+label::after{right:calc(4px + var(--switch-toggle-size))}.br-switch input:checked+label::after{right:4px}.br-switch.right input+label{padding-left:calc(var(--spacing-scale-2x) + var(--switch-width));padding-right:0}.br-switch.right input+label::before{left:0}.br-switch.right input+label::after{left:4px}.br-switch.right input:checked+label::after{left:calc(var(--switch-width) - var(--switch-toggle-size) - 4px)}.br-switch.top{min-height:calc(var(--switch-height)*2)}.br-switch.top input+label{align-items:flex-start;padding-right:0}.br-switch.top input+label::before{bottom:0;left:0}.br-switch.top input+label::after{bottom:4px;left:4px}.br-switch.top input:checked+label::after{left:calc(var(--switch-width) - var(--switch-toggle-size) - 4px)}.br-switch.small{--switch-height: var(--switch-height-small);--switch-width: var(--switch-width-small);--switch-toggle-size: var(--switch-toggle-small);--switch-icon-size: var(--switch-icon-small)}.br-switch.medium{--switch-height: var(--switch-height-medium);--switch-width: var(--switch-width-medium);--switch-toggle-size: var(--switch-toggle-medium);--switch-icon-size: var(--switch-icon-medium)}.br-switch.large{--switch-height: var(--switch-height-large);--switch-width: var(--switch-width-large);--switch-toggle-size: var(--switch-toggle-large);--switch-icon-size: var(--switch-icon-large)}.br-switch input~.switch-data{align-self:center;color:var(--color);font-size:var(--font-size-scale-base);font-weight:var(--font-weight-regular);margin-left:8px}.br-switch input~.switch-data::before{content:attr(data-disabled)}.br-switch input:checked~.switch-data{color:var(--color)}.br-switch input:checked~.switch-data::before{content:attr(data-enabled)}.br-switch.icon input+label::after{align-items:center;color:var(--color-dark);content:"";display:inline-flex;font-family:"Font Awesome 5 Free",sans-serif;font-size:var(--switch-icon-size);font-weight:var(--font-weight-black);justify-content:center}.br-switch.icon input:checked+label::after{content:""}.br-switch input:focus-visible+label::before,.br-switch input.focus-visible+label::before{border-color:var(--focus) !important;box-shadow:0 0 0 var(--surface-width-md) var(--focus);outline:none}.br-switch input:hover:not([disabled]):checked+label::before{background-image:linear-gradient(rgba(var(--on-rgb), var(--hover)), rgba(var(--on-rgb), var(--hover)))}.br-switch input:hover:not([disabled]):not(:checked)+label::before{background-image:linear-gradient(rgba(var(--off-rgb), var(--hover)), rgba(var(--off-rgb), var(--hover)))}.br-switch input:active:not([disabled]):checked+label::before{background-image:linear-gradient(rgba(var(--on-rgb), var(--pressed)), rgba(var(--on-rgb), var(--pressed)))}.br-switch input:active:not([disabled]):not(:checked)+label::before{background-image:linear-gradient(rgba(var(--off-rgb), var(--pressed)), rgba(var(--off-rgb), var(--pressed)))}.br-switch.inverted,.br-switch.inverted label,.br-switch.dark-mode,.br-switch.dark-mode label{color:var(--color-dark)}:host{display:inline-block;margin-bottom:var(--spacing-scale-base)}.br-switch input+label::after{transition:none}@media(prefers-reduced-motion: no-preference){.br-switch input+label::after{transition:right var(--duration-fast, 300ms) var(--animation-ease-in-out, ease-in-out),background-color var(--duration-fast, 300ms) var(--animation-ease-in-out, ease-in-out)}}:host([disabled]) .br-switch,:host([disabled]) .br-switch label,:host([disabled]) .br-switch input{cursor:not-allowed}

package/dist/collection/components/switch/switch.js

@@ -6,14 +6,38 @@ import { Host, h, } from "@stencil/core";
 import { redispatchNativeFormEvent } from "../../shared/utils/event";
 import { getCheckableFormValue, getCheckableRestoreState, getFormValidationState, isFormControlDisabled, safeSetFormValue, syncNativeFormValidity, } from "../../shared/utils/form";
 import { generateUniqueId } from "../../shared/utils/id";
+import { resolveAllowedPropValue, resolveDensity } from "../../shared/utils/props";
 import { hasAssignedSlotContent, hasDefaultLightDomContent } from "../../shared/utils/slot";
 import { resolveFormValidator, runFormValidator } from "../../shared/utils/validator";
+const SWITCH_LABEL_POSITIONS = ['right', 'left', 'top'];
 /**
- * ## Design System
+ * O componente `br-switch` é o interruptor de alternância do GovBR-DS, desenvolvido para ativar ou desativar instantaneamente um recurso, modo ou configuração na interface.
  *
- * 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/switch?tab=designer).
+ * ### Para que serve
  *
- * @category Formulários
+ * - **Alternância binária imediata:** Alterna entre dois estados mutuamente exclusivos (ligado/desligado, ativo/inativo, habilitado/desabilitado) com efeito imediato na aplicação.
+ * - **Rótulo contextual dinâmico:** Suporta textos explicativos de estado (ex.: "Ativado" / "Desativado") e ícones de apoio.
+ * - **Acessibilidade nativa WAI-ARIA:** Utiliza internamente o papel semântico `role="switch"` com o atributo `aria-checked`, garantindo anúncio claro de estado para leitores de tela.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - A alteração de estado entrar em vigor imediatamente após a interação, sem depender de um botão "Salvar" ou submissão de formulário.
+ *   - Para preferências do sistema (ex.: "Tema escuro", "Notificações ativas", "Wi-Fi ligado").
+ * - **Evite e prefira outro componente quando:**
+ *   - A escolha fizer parte de um formulário com múltiplos campos que serão submetidos juntos (prefira `br-checkbox`).
+ *   - A escolha for entre duas opções com nomes explícitos diferentes de ligado/desligado (prefira `br-radio`).
+ *
+ * ### Estrutura e Slots
+ *
+ * O `br-switch` é um controle direto:
+ * - `default`: Slot para personalização do rótulo descritivo do switch (com prioridade sobre a propriedade `label`).
+ * - `feedback`: Slot para mensagens de validação contextual (como `br-message`).
+ *
+ * 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/switch?tab=designer).
+ *
+
+ * @category Formulários, Seleção, Ações
  * @status stable
  * @slot default - Slot para o rótulo do switch, com prioridade sobre a propriedade label.
  * @slot feedback - Mensagem de validação, normalmente um `br-message`.
@@ -51,7 +75,7 @@ export class Switch {
          */
         this.customId = generateUniqueId();
         /**
-         * Posição do rótulo em relação ao switch.
+         * Posição do rótulo em relação ao switch. Valores inválidos usam `left`.
          */
         this.labelPosition = 'left';
         /**
@@ -59,7 +83,8 @@ export class Switch {
          * @deprecated Use `showIcon`.
          */
         this.hasIcon = false;
-        /** Ajusta a área de interação: `small` é compacto, `medium` é o padrão e `large` é mais espaçado. */
+        /** Ajusta a área de interação: `small` é compacto, `medium` é o padrão e `large` é mais espaçado.
+         * Valores inválidos usam `medium`. */
         this.density = 'medium';
         this.validationRunId = 0;
         this.initialChecked = false;
@@ -215,23 +240,28 @@ export class Switch {
         return this._slotDefault || (this.label !== undefined && this.label !== null && this.label.trim() !== '');
     }
     getCssClassMap() {
+        const density = resolveDensity(this.el, this.density);
+        const labelPosition = this.effectiveLabelPosition;
         return {
             'br-switch': true,
             icon: this.showIcon ?? this.hasIcon,
-            top: this.labelPosition === 'top',
-            right: this.labelPosition === 'right',
-            large: this.density === 'large',
-            small: this.density === 'small',
+            top: labelPosition === 'top',
+            right: labelPosition === 'right',
+            large: density === 'large',
+            small: density === 'small',
             disabled: this.isDisabled(),
         };
     }
+    get effectiveLabelPosition() {
+        return resolveAllowedPropValue(this.el, 'labelPosition', this.labelPosition, SWITCH_LABEL_POSITIONS, 'left');
+    }
     render() {
         const hasVisibleText = this.hasVisibleText();
-        return (h(Host, { key: '4dd9e91f5d826b858d781b367f868ee29f47bb61', "aria-disabled": this.isDisabled() ? 'true' : null }, h("div", { key: '931d05d4b685a1dbab3b4240b8824ab755092046', class: this.getCssClassMap(), part: "container" }, h("input", { key: '3afd320438b534d364d2f74b385166f4da1570ff', part: "input", ref: (el) => (this.nativeInput = el), id: this.customId, type: "checkbox", name: this.name, checked: this.checked, disabled: this.isDisabled(), required: this.required, role: "switch", "aria-checked": this.checked ? 'true' : 'false', "aria-busy": this.isValidating ? 'true' : null, "aria-describedby": this.hasFeedbackSlot || this.manualValidationMessage || this.validatorMessage
+        return (h(Host, { key: 'cdf7fbf56aab55137acc7fa795acf138d3e58ad6', "aria-disabled": this.isDisabled() ? 'true' : null }, h("div", { key: '141edc6e4b71f3b7a878d06b6fe1fbc8fe40e4dc', class: this.getCssClassMap(), part: "container" }, h("input", { key: '30f130caae79ff96ead26d3728bec6800443f224', part: "input", ref: (el) => (this.nativeInput = el), id: this.customId, type: "checkbox", name: this.name, checked: this.checked, disabled: this.isDisabled(), required: this.required, role: "switch", "aria-checked": this.checked ? 'true' : 'false', "aria-busy": this.isValidating ? 'true' : null, "aria-describedby": this.hasFeedbackSlot || this.manualValidationMessage || this.validatorMessage
                 ? `${this.customId}-feedback`
                 : null, "aria-errormessage": this.manualValidationMessage || this.validatorMessage || this.hasFeedbackSlot
                 ? `${this.customId}-feedback`
-                : null, onInput: this.handleCheckedInput, onChange: this.handleCheckedChange, onClick: this.handleClick, ...(!hasVisibleText ? { 'aria-label': this.getAccessibilityLabel() } : {}) }), h("label", { key: '591be3df7b30eddbb067238654159e38078fa3ff', part: "label", htmlFor: this.customId }, this._slotDefault ? h("slot", null) : this.label || ''), this.labelOn && this.labelOff && (h("div", { key: '3d7d008ac48f25b65509b0acda2c7854378b91d6', class: "switch-data", "data-enabled": this.labelOn, "data-disabled": this.labelOff, "aria-hidden": "true", part: "data" }))), h("div", { key: '44be45c093d338c06afe8e4259a0f73e15517307', id: `${this.customId}-feedback`, part: "feedback", hidden: !this.hasFeedbackSlot && !this.manualValidationMessage && !this.validatorMessage }, h("slot", { key: '9523f6a34a279ebd19b9a92b48fa6259ba9f0254', name: "feedback", onSlotchange: (event) => (this.hasFeedbackSlot = hasAssignedSlotContent(event.currentTarget)) }), !this.hasFeedbackSlot && (this.manualValidationMessage || this.validatorMessage) ? (h("br-message", { state: "danger", message: this.manualValidationMessage || this.validatorMessage })) : null)));
+                : null, onInput: this.handleCheckedInput, onChange: this.handleCheckedChange, onClick: this.handleClick, ...(!hasVisibleText ? { 'aria-label': this.getAccessibilityLabel() } : {}) }), h("label", { key: '755fdd0c8bc57e8d386532267b2d1364d7496897', part: "label", htmlFor: this.customId }, this._slotDefault ? h("slot", null) : this.label || ''), this.labelOn && this.labelOff && (h("div", { key: '96b6dfdea3eff539dd1aead339bfd9555ba87bc7', class: "switch-data", "data-enabled": this.labelOn, "data-disabled": this.labelOff, "aria-hidden": "true", part: "data" }))), h("div", { key: '140e5aea8abea6d5afed40313510ef63ad5e588c', id: `${this.customId}-feedback`, part: "feedback", hidden: !this.hasFeedbackSlot && !this.manualValidationMessage && !this.validatorMessage }, h("slot", { key: '9050c26808d86f5d21c018853cdfb00e66c2dee2', name: "feedback", onSlotchange: (event) => (this.hasFeedbackSlot = hasAssignedSlotContent(event.currentTarget)) }), !this.hasFeedbackSlot && (this.manualValidationMessage || this.validatorMessage) ? (h("br-message", { state: "danger", message: this.manualValidationMessage || this.validatorMessage })) : null)));
     }
     static get is() { return "br-switch"; }
     static get encapsulation() { return "shadow"; }
@@ -307,8 +337,11 @@ export class Switch {
                 "required": false,
                 "optional": true,
                 "docs": {
-                    "tags": [],
-                    "text": "Regra s\u00EDncrona ou ass\u00EDncrona aplicada ao estado booleano do switch."
+                    "tags": [{
+                            "name": "example",
+                            "text": "```js\nconst toggle = document.querySelector('br-switch');\ntoggle.validator = (checked) => checked ? null : 'Ative esta op\u00E7\u00E3o para continuar';\n```"
+                        }],
+                    "text": "Regra s\u00EDncrona ou ass\u00EDncrona aplicada ao estado booleano do switch.\nRetorne uma mensagem para invalidar ou `null` para aceitar o valor."
                 },
                 "getter": false,
                 "setter": false
@@ -384,7 +417,7 @@ export class Switch {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Posi\u00E7\u00E3o do r\u00F3tulo em rela\u00E7\u00E3o ao switch."
+                    "text": "Posi\u00E7\u00E3o do r\u00F3tulo em rela\u00E7\u00E3o ao switch. Valores inv\u00E1lidos usam `left`."
                 },
                 "getter": false,
                 "setter": false,
@@ -522,7 +555,7 @@ export class Switch {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Ajusta a \u00E1rea de intera\u00E7\u00E3o: `small` \u00E9 compacto, `medium` \u00E9 o padr\u00E3o e `large` \u00E9 mais espa\u00E7ado."
+                    "text": "Ajusta a \u00E1rea de intera\u00E7\u00E3o: `small` \u00E9 compacto, `medium` \u00E9 o padr\u00E3o e `large` \u00E9 mais espa\u00E7ado.\nValores inv\u00E1lidos usam `medium`."
                 },
                 "getter": false,
                 "setter": false,