@govbr-ds/webcomponents 2.1.3 → 2.2.0

package/dist/collection/components/item/item.js

@@ -5,19 +5,45 @@
 import { Host, h, } from "@stencil/core";
 import { generateUniqueId } from "../../shared/utils/id";
 import { handleNavigationClick } from "../../shared/utils/navigation";
+import { findComposedOwner } from "../../shared/utils/ownership";
+import { resolveAllowedPropValue, resolveDensity } from "../../shared/utils/props";
 import { hasDefaultLightDomContent, hasNamedLightDomSlot } from "../../shared/utils/slot";
 /**
- * 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/item?tab=designer).
+ * O componente `br-item` é o elemento flexível e padronizado do GovBR-DS para construção de linhas navegáveis, selecionáveis ou de exibição em listas, menus contextuais e painéis suspensos.
  *
+ * ### Para que serve
+ *
+ * - **Padronização de linhas interativas:** Garante espaçamento, tipografia, contraste e efeitos de estado (hover, foco visível, seleção e desativação) em conformidade com os tokens do design system.
+ * - **Polimorfismo semântico:** Pode renderizar internamente um botão interativo (`<button>`), um hiperlink navegável (`<a>`) ou uma divisão semântica (`<div>`) dependendo dos atributos fornecidos (`href`, `clickable`).
+ * - **Suporte a seleção visual:** Oferece suporte a estados de seleção (`selected`), marcas de verificação e densidades ajustáveis.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - Estiver montando linhas de conteúdo em listas (`br-list`), painéis flutuantes (`br-dropdown`) ou agrupamentos verticais.
+ *   - Cada entrada representar um item de dado ou uma ação com estilo homogêneo.
+ * - **Evite e prefira outro componente quando:**
+ *   - O item pertencer especificamente à navegação de abas (use `br-tab-item`), etapas de fluxo (use `br-step-item`) ou seleção em formulário (use `br-select-option`).
+ *
+ * ### Estrutura e Slots
+ *
+ * O `br-item` é um componente estrutural direto:
+ * - `default`: Slot para inserção do conteúdo livre da linha (textos, ícones, badges ou metadados).
+ *
+ * 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/item?tab=designer).
+ *
+
+
  * @slot default - Área de conteúdo, podendo conter qualquer componente, exceto botões primários e componentes relacionados à navegação (como carrosséis, paginações, abas, menus, etc.).
  *
  * @slot start - Área de recursos visuais, podendo conter elementos como ícones, avatares e mídias.
  *
  * @slot end - Área de recursos complementares, podendo conter componentes interativos, metadados e informações adicionais.
  *
- * @category Conteúdo
+ * @category Conteúdo, Navegação
  * @status stable
  * @part item - Elemento principal do item (botão, link ou div).
+ *
  */
 export class Item {
     constructor() {
@@ -87,6 +113,7 @@ export class Item {
          * - `medium`: Densidade intermediária, padrão recomendado para a maioria dos casos.
          * - `large`: Baixa densidade (componente maior, mais espaçamento e altura).
          *
+         * Valores inválidos usam `medium`.
          */
         this.density = 'medium';
         this.hasRadios = false;
@@ -119,14 +146,13 @@ export class Item {
                 return;
             if (this.getTagType() !== 'div')
                 return;
-            if (!this.isInteractive && !this.isButton)
+            if (!this.effectiveInteractive && !this.effectiveButton)
                 return;
             if (event.key === 'Enter' || event.key === ' ' || event.key === 'Spacebar') {
                 event.preventDefault();
                 this.activate();
             }
         };
-        // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: mantém em uma transação os modos standalone, controlado, radio e checkbox.
         this.handleClick = (event) => {
             if (this.disabled) {
                 event.preventDefault();
@@ -137,13 +163,15 @@ export class Item {
             handleNavigationClick({
                 event,
                 href: this.href,
-                target: this.target,
-                navigationMode: this.navigationMode,
+                target: this.effectiveTarget,
+                navigationMode: this.effectiveNavigationMode,
                 brNavigate: this.brNavigate,
             });
             if (this.effectiveButton) {
                 this.brDidClick.emit();
                 this.brItemClick.emit();
+                if (this.selectionEnabled)
+                    this.toggleSelection();
             }
             else if (this.selectionEnabled &&
                 this.effectiveInteractive &&
@@ -151,39 +179,39 @@ export class Item {
                 if (this.hasRadios) {
                     // Só existe um alvo inequívoco quando há exatamente um radio no item; com múltiplos
                     // radios não há como saber qual o clique na superfície pretendia selecionar.
-                    const radios = Array.from(this.el.querySelectorAll('br-radio'));
+                    const radios = this.getOwnedControls('br-radio');
                     if (radios.length === 1 && !radios[0].checked) {
                         radios[0].toggleChecked();
                     }
                 }
                 else {
-                    // Armazena o estado anterior para emitir o evento apenas se houver mudança.
-                    const previousSelectedValue = this.hasControlledSelection ? Boolean(this.selected) : this.selectedValue;
-                    const nextSelected = !previousSelectedValue;
-                    if (!this.hasControlledSelection)
-                        this.selectedValue = nextSelected;
-                    if (previousSelectedValue !== nextSelected) {
-                        const detail = { selected: nextSelected };
-                        this.brDidSelect.emit(detail);
-                        this.brItemSelect.emit(detail);
-                    }
-                    if (!this.hasControlledSelection)
-                        this.updateCheckboxes();
+                    this.toggleSelection();
                 }
             }
             event.stopPropagation();
         };
     }
+    get effectiveTarget() {
+        return resolveAllowedPropValue(this.el, 'target', this.target, ['_self', '_blank', '_parent', '_top'], undefined, {
+            allowUndefined: true,
+        });
+    }
+    get effectiveNavigationMode() {
+        return resolveAllowedPropValue(this.el, 'navigationMode', this.navigationMode, ['native', 'event'], 'native');
+    }
+    get effectiveType() {
+        return resolveAllowedPropValue(this.el, 'type', this.type, ['button', 'submit', 'reset'], 'button');
+    }
     componentWillLoad() {
         this.hasSlotContentDefault();
         this.hasSlotStart = this.hasSlotContent('start');
         this.hasSlotEnd = this.hasSlotContent('end');
         this.selectedValue = this.effectiveSelected;
         if (this.effectiveButton) {
-            this.type = this.type || 'button';
+            this.type = this.effectiveType;
         }
-        const radios = Array.from(this.el.querySelectorAll('br-radio'));
-        const checkboxes = Array.from(this.el.querySelectorAll('br-checkbox'));
+        const radios = this.getOwnedControls('br-radio');
+        const checkboxes = this.getOwnedControls('br-checkbox');
         this.hasRadios = radios.length > 0;
         this.hasCheckboxes = checkboxes.length > 0;
         this.isManagedByList = Boolean(this.el.closest('br-list'));
@@ -202,15 +230,34 @@ export class Item {
             this.updateCheckboxSelectionState(false);
         }
     }
+    componentDidRender() {
+        const hasSlotStart = this.hasSlotContent('start');
+        const hasSlotEnd = this.hasSlotContent('end');
+        if (this.hasSlotStart !== hasSlotStart)
+            this.hasSlotStart = hasSlotStart;
+        if (this.hasSlotEnd !== hasSlotEnd)
+            this.hasSlotEnd = hasSlotEnd;
+    }
     // Sincroniza selectedValue quando a prop é alterada externamente (ex.: toggleAllOptions)
     handleSelectedPropChange() {
         this.selectedValue = this.effectiveSelected;
     }
     handleCheckedChange(event) {
+        this.syncSelectionFromChildEvent(event);
+    }
+    handleInternalChildStateChange(event) {
+        this.syncSelectionFromChildEvent(event);
+    }
+    syncSelectionFromChildEvent(event) {
         if (!this.selectionEnabled)
             return;
-        const target = event.target;
-        if (this.el.contains(target))
+        const target = event
+            .composedPath()
+            .find((node) => node.tagName?.toLowerCase() === 'br-checkbox' ||
+            node.tagName?.toLowerCase() === 'br-radio');
+        if (!(target instanceof HTMLElement) || findComposedOwner(target, 'br-item') !== this.el)
+            return;
+        if (target.tagName.toLowerCase() === 'br-checkbox')
             this.updateCheckboxSelectionState();
         requestAnimationFrame(() => this.updateRadioSelectionState());
     }
@@ -220,7 +267,7 @@ export class Item {
      * internamente pelo próprio item quando standalone (fora de br-list).
      */
     async activate() {
-        if (this.isButton) {
+        if (this.effectiveButton) {
             this.focusableElement?.click();
             return;
         }
@@ -247,9 +294,6 @@ export class Item {
     get effectiveSelected() {
         return this.selected ?? this.isSelected;
     }
-    get hasControlledSelection() {
-        return this.selected !== undefined;
-    }
     get effectiveInteractive() {
         return (this.interactive ??
             (this.isInteractive ||
@@ -268,14 +312,15 @@ export class Item {
         return hasNamedLightDomSlot(this.el, slotName);
     }
     getCssClassMap() {
+        const density = resolveDensity(this.el, this.density);
         return {
             'br-item': true,
             disabled: this.disabled,
             active: this.effectiveActive,
-            selected: this.selected ?? this.selectedValue,
-            small: this.density === 'small',
-            medium: this.density === 'medium',
-            large: this.density === 'large',
+            selected: this.selectedValue,
+            small: density === 'small',
+            medium: density === 'medium',
+            large: density === 'large',
             'no-text-selection': this.effectiveButton || Boolean(this.href?.length) || this.disabled,
         };
     }
@@ -292,31 +337,32 @@ export class Item {
         const TagType = this.getTagType();
         const baseAttributes = TagType === 'button'
             ? {
-                type: this.type,
+                type: this.effectiveType,
                 value: this.value,
                 disabled: this.disabled ? true : null,
             }
-            : { href: this.href, target: this.target };
-        const isInteractiveDiv = TagType === 'div' && this.isInteractive && !this.hasRadios && !this.hasCheckboxes;
-        const isFocusableItem = this.isInteractive || this.isButton || Boolean(this.href?.length);
+            : { href: this.href, target: this.effectiveTarget };
+        const isInteractiveDiv = TagType === 'div' && this.effectiveInteractive && !this.hasRadios && !this.hasCheckboxes;
+        const isFocusableItem = this.effectiveInteractive || this.effectiveButton || Boolean(this.href?.length);
         return {
             ...baseAttributes,
             role: isInteractiveDiv ? 'button' : null,
-            'aria-pressed': isInteractiveDiv ? String(this.selected ?? this.selectedValue) : null,
+            'aria-pressed': isInteractiveDiv || this.effectiveButton ? String(this.selectedValue) : null,
             tabIndex: this.disabled || !isFocusableItem ? -1 : this.rovingTabIndex,
             'aria-disabled': this.disabled ? 'true' : null,
             'aria-current': this.effectiveActive ? 'true' : null,
             'data-toggle': this.effectiveInteractive ? 'selection' : null,
-            'is-selected': (this.selected ?? this.selectedValue) ? true : null,
+            'is-selected': this.selectedValue ? true : null,
         };
     }
     updateCheckboxSelectionState(emitEvent = true) {
         if (this.hasRadios)
             return;
-        const checkboxes = Array.from(this.el.querySelectorAll('br-checkbox'));
+        const checkboxes = this.getOwnedControls('br-checkbox');
+        if (checkboxes.length === 0)
+            return;
         const nextSelected = checkboxes.some((checkbox) => checkbox.checked);
-        if (!this.hasControlledSelection)
-            this.selectedValue = nextSelected;
+        this.setSelectionState(nextSelected, emitEvent);
         if (emitEvent && this.effectiveInteractive) {
             const detail = { selected: nextSelected };
             this.brDidSelect.emit(detail);
@@ -326,10 +372,11 @@ export class Item {
     updateRadioSelectionState(emitEvent = true) {
         if (!this.hasRadios)
             return;
-        const radios = Array.from(this.el.querySelectorAll('br-radio'));
+        const radios = this.getOwnedControls('br-radio');
+        if (radios.length === 0)
+            return;
         const nextSelected = radios.some((radio) => radio.checked);
-        if (!this.hasControlledSelection)
-            this.selectedValue = nextSelected;
+        this.setSelectionState(nextSelected, emitEvent);
         if (emitEvent && this.effectiveInteractive) {
             const detail = { selected: nextSelected };
             this.brDidSelect.emit(detail);
@@ -338,20 +385,44 @@ export class Item {
     }
     isClickInsideInteractiveElement(target) {
         const interactiveSelectors = 'br-checkbox, br-radio, br-input, br-button, br-select, br-textarea';
-        const interactiveElements = this.el.querySelectorAll(interactiveSelectors);
+        const interactiveElements = this.getOwnedControls(interactiveSelectors);
         return Array.from(interactiveElements).some((el) => el.contains(target) || target === el);
     }
     updateCheckboxes() {
-        const checkboxes = Array.from(this.el.querySelectorAll('br-checkbox'));
+        const checkboxes = this.getOwnedControls('br-checkbox');
         checkboxes.forEach((checkbox) => {
             checkbox.checked = this.selectedValue;
         });
     }
+    setSelectionState(selected, reflect = true) {
+        this.selectedValue = selected;
+        if (reflect)
+            this.selected = selected;
+    }
+    toggleSelection() {
+        const previousSelectedValue = this.selectedValue;
+        this.setSelectionState(!previousSelectedValue);
+        this.updateCheckboxes();
+        if (previousSelectedValue !== this.selectedValue) {
+            const detail = { selected: this.selectedValue };
+            this.brDidSelect.emit(detail);
+            this.brItemSelect.emit(detail);
+        }
+    }
+    getOwnedControls(selector) {
+        return Array.from(this.el.querySelectorAll(selector)).filter((element) => findComposedOwner(element, 'br-item') === this.el);
+    }
     render() {
         const TagType = this.getTagType();
         const attributes = this.getAttributes();
         const classList = this.getCssClassMap();
-        return (h(Host, { key: '0c2e8ad9198db23ff1c43bc1a48cabe478f4d207', tabindex: this.isInteractive || this.effectiveInteractive ? (this.disabled ? -1 : 0) : undefined }, h(TagType, { key: 'd88d1732106bba4167118f16f2a27fdf3cf0f660', class: classList, ...attributes, tabindex: this.isInteractive || this.effectiveInteractive ? (this.disabled ? -1 : 0) : undefined, onClick: this.handleClick, onKeyDown: this.handleKeydown, id: this.customId, ref: (el) => (this.focusableElement = el), onMouseDown: this.handleMouseDown, part: "item" }, this.hasSlotStart || this.hasSlotEnd ? (h("div", { class: "row align-items-center" }, this.hasSlotStart && (h("div", { class: "col-auto" }, h("slot", { name: "start" }))), h("div", { class: "col" }, h("slot", null)), this.hasSlotEnd && (h("div", { class: "col-auto" }, h("slot", { name: "end" }))))) : (h("slot", null)))));
+        // O conteúdo nomeado pode ser inserido pelo componente pai durante a
+        // primeira renderização. A leitura atualizada evita que o item comece
+        // usando apenas o slot default e só adote o layout em uma interação
+        // posterior.
+        const hasSlotStart = this.hasSlotStart || this.hasSlotContent('start');
+        const hasSlotEnd = this.hasSlotEnd || this.hasSlotContent('end');
+        return (h(Host, { key: 'd32344a7ca9d0d9a3e6c06d5f4f4247785ce6ce7', tabindex: this.effectiveInteractive || this.effectiveButton ? (this.disabled ? -1 : 0) : undefined }, h(TagType, { key: '4da387479e9f0dad915185210e55ad1386adf046', class: classList, ...attributes, tabindex: this.effectiveInteractive || this.effectiveButton ? (this.disabled ? -1 : 0) : undefined, onClick: this.handleClick, onKeyDown: this.handleKeydown, id: this.customId, ref: (el) => (this.focusableElement = el), onMouseDown: this.handleMouseDown, part: "item" }, hasSlotStart || hasSlotEnd ? (h("div", { class: "row align-items-center" }, hasSlotStart && (h("div", { class: "col-auto" }, h("slot", { name: "start" }))), h("div", { class: "col" }, h("slot", null)), hasSlotEnd && (h("div", { class: "col-auto" }, h("slot", { name: "end" }))))) : (h("slot", null)))));
     }
     static get is() { return "br-item"; }
     static get encapsulation() { return "shadow"; }
@@ -475,7 +546,7 @@ export class Item {
             },
             "selected": {
                 "type": "boolean",
-                "mutable": false,
+                "mutable": true,
                 "complexType": {
                     "original": "boolean",
                     "resolved": "boolean",
@@ -485,7 +556,7 @@ export class Item {
                 "optional": true,
                 "docs": {
                     "tags": [],
-                    "text": "Estado selecionado can\u00F4nico. Quando informado, tem preced\u00EAncia sobre `isSelected`."
+                    "text": "Estado selecionado can\u00F4nico. Em itens interativos, tamb\u00E9m \u00E9 atualizado pelo acionamento."
                 },
                 "getter": false,
                 "setter": false,
@@ -712,7 +783,7 @@ export class Item {
                 "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)."
+                    "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\nValores inv\u00E1lidos usam `medium`."
                 },
                 "getter": false,
                 "setter": false,
@@ -909,7 +980,19 @@ export class Item {
         return [{
                 "name": "checkedChange",
                 "method": "handleCheckedChange",
-                "target": "document",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "brInternalCheckboxStateChange",
+                "method": "handleInternalChildStateChange",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }, {
+                "name": "brInternalRadioStateChange",
+                "method": "handleInternalChildStateChange",
+                "target": undefined,
                 "capture": false,
                 "passive": false
             }];

package/dist/collection/components/link/link.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-button{--button-radius: 100em;--button-xsmall: 24px;--button-small: 32px;--button-medium: 40px;--button-large: 48px;--button-size: var(--button-medium);align-items:center;background-color:rgba(0,0,0,0);border:0;border-radius:var(--button-radius);color:var(--interactive);cursor:pointer;display:inline-flex;font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-semi-bold);height:var(--button-size);justify-content:center;overflow:hidden;padding:0 var(--spacing-scale-3x);position:relative;text-align:center;vertical-align:middle;white-space:nowrap;width:auto}.br-button.block{width:100%}.br-button.circle,.br-button[circle]{border-radius:50%;padding:0;width:var(--button-size)}.br-button.xsmall,.br-button[xsmall]{--button-size: var(--button-xsmall)}.br-button.small,.br-button[small]{--button-size: var(--button-small)}.br-button.medium,.br-button[medium]{--button-size: var(--button-medium)}.br-button.large,.br-button[large]{--button-size: var(--button-large)}.br-button.primary,.br-button[primary]{--interactive-rgb: var(--color-dark-rgb);background-color:var(--interactive-light);color:var(--color-dark)}.br-button.secondary,.br-button[secondary]{background-color:var(--background-light);border:1px solid var(--interactive)}.br-button.danger,.br-button[danger]{background-color:var(--danger);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button.success,.br-button[success]{background-color:var(--success);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button.warning,.br-button[warning]{background-color:var(--warning);--interactive-rgb: var(--color-light-rgb);color:var(--color-light)}.br-button.info,.br-button[info]{background-color:var(--info);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button:disabled{cursor:not-allowed}.br-button:not(:disabled){--focus-offset: var(--spacing-scale-half)}.br-button:not(:disabled):focus{outline:none}.br-button:not(:disabled).focus-visible,.br-button:not(:disabled):focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}.br-button:not(:disabled):not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}.br-button:not(:disabled):not(:disabled):active{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--pressed)), rgba(var(--interactive-rgb), var(--pressed)))}.br-button.active,.br-button.is-active,.br-button[active]{--hover: var(--hover-dark);background-color:var(--active);color:var(--color-dark)}.br-button.loading{color:rgba(0,0,0,0) !important;cursor:progress}.br-button.loading:not(:disabled):hover{background-image:none}.br-button.loading::before{border-color:var(--interactive) var(--interactive) rgba(0,0,0,0);border-style:solid}.br-button.loading.primary::before,.br-button.loading.danger::before,.br-button.loading.success::before,.br-button.loading.info::before{border-color:var(--background) var(--background) rgba(0,0,0,0)}.br-button.inverted,.br-button[inverted],.br-button.dark-mode{--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);color:var(--interactive-dark)}.br-button.inverted.primary,.br-button.inverted[primary],.br-button[inverted].primary,.br-button[inverted][primary],.br-button.dark-mode.primary,.br-button.dark-mode[primary]{--interactive-rgb: var(--background-dark-rgb);background-color:var(--interactive-dark);color:var(--background-dark)}.br-button.inverted.secondary,.br-button.inverted[secondary],.br-button[inverted].secondary,.br-button[inverted][secondary],.br-button.dark-mode.secondary,.br-button.dark-mode[secondary]{background-color:var(--background-dark)}.br-button.inverted.active,.br-button[inverted].active,.br-button.dark-mode.active{--hover: var(--hover-light);--interactive-rgb: var(--active-rgb);background-color:var(--background-light);color:var(--active)}a.br-button{font-weight:var(--font-weight-semi-bold);text-decoration:none !important}:host{display:contents}:host([hidden]){display:none !important}:host([disabled]) a{cursor:not-allowed;opacity:.5}:host([disabled]) a:hover{background-image:none}
+*,*::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-button{--button-radius: 100em;--button-xsmall: 24px;--button-small: 32px;--button-medium: 40px;--button-large: 48px;--button-size: var(--button-medium);align-items:center;background-color:rgba(0,0,0,0);border:0;border-radius:var(--button-radius);color:var(--interactive);cursor:pointer;display:inline-flex;font-size:var(--font-size-scale-up-01);font-weight:var(--font-weight-semi-bold);height:var(--button-size);justify-content:center;overflow:hidden;padding:0 var(--spacing-scale-3x);position:relative;text-align:center;vertical-align:middle;white-space:nowrap;width:auto}.br-button.block{width:100%}.br-button.circle,.br-button[circle]{border-radius:50%;padding:0;width:var(--button-size)}.br-button.xsmall,.br-button[xsmall]{--button-size: var(--button-xsmall)}.br-button.small,.br-button[small]{--button-size: var(--button-small)}.br-button.medium,.br-button[medium]{--button-size: var(--button-medium)}.br-button.large,.br-button[large]{--button-size: var(--button-large)}.br-button.primary,.br-button[primary]{--interactive-rgb: var(--color-dark-rgb);background-color:var(--interactive-light);color:var(--color-dark)}.br-button.secondary,.br-button[secondary]{background-color:var(--background-light);border:1px solid var(--interactive)}.br-button.danger,.br-button[danger]{background-color:var(--danger);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button.success,.br-button[success]{background-color:var(--success);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button.warning,.br-button[warning]{background-color:var(--warning);--interactive-rgb: var(--color-light-rgb);color:var(--color-light)}.br-button.info,.br-button[info]{background-color:var(--info);--interactive-rgb: var(--color-dark-rgb);color:var(--color-dark)}.br-button:disabled{cursor:not-allowed}.br-button:not(:disabled){--focus-offset: var(--spacing-scale-half)}.br-button:not(:disabled):focus{outline:none}.br-button:not(:disabled).focus-visible,.br-button:not(:disabled):focus-visible{outline-color:var(--focus);outline-offset:var(--focus-offset);outline-style:var(--focus-style);outline-width:var(--focus-width)}.br-button:not(:disabled):not(:disabled):hover{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--hover)), rgba(var(--interactive-rgb), var(--hover)))}.br-button:not(:disabled):not(:disabled):active{background-image:linear-gradient(rgba(var(--interactive-rgb), var(--pressed)), rgba(var(--interactive-rgb), var(--pressed)))}.br-button.active,.br-button.is-active,.br-button[active]{--hover: var(--hover-dark);background-color:var(--active);color:var(--color-dark)}.br-button.loading{color:rgba(0,0,0,0) !important;cursor:progress}.br-button.loading:not(:disabled):hover{background-image:none}.br-button.loading::before{border-color:var(--interactive) var(--interactive) rgba(0,0,0,0);border-style:solid}.br-button.loading.primary::before,.br-button.loading.danger::before,.br-button.loading.success::before,.br-button.loading.info::before{border-color:var(--background) var(--background) rgba(0,0,0,0)}.br-button.inverted,.br-button[inverted],.br-button.dark-mode{--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);color:var(--interactive-dark)}.br-button.inverted.primary,.br-button.inverted[primary],.br-button[inverted].primary,.br-button[inverted][primary],.br-button.dark-mode.primary,.br-button.dark-mode[primary]{--interactive-rgb: var(--background-dark-rgb);background-color:var(--interactive-dark);color:var(--background-dark)}.br-button.inverted.secondary,.br-button.inverted[secondary],.br-button[inverted].secondary,.br-button[inverted][secondary],.br-button.dark-mode.secondary,.br-button.dark-mode[secondary]{background-color:var(--background-dark)}.br-button.inverted.active,.br-button[inverted].active,.br-button.dark-mode.active{--hover: var(--hover-light);--interactive-rgb: var(--active-rgb);background-color:var(--background-light);color:var(--active)}a.br-button{font-weight:var(--font-weight-semi-bold);text-decoration:none !important}:host{display:contents}:host([hidden]){display:none !important}:host([disabled]) a{cursor:not-allowed;opacity:.5}:host([disabled]) a:hover{background-image:none}

package/dist/collection/components/link/link.js

@@ -4,15 +4,37 @@
  */
 import { Host, h } from "@stencil/core";
 import { handleNavigationClick } from "../../shared/utils/navigation";
+import { resolveAllowedPropValue } from "../../shared/utils/props";
 /**
- * ## Design System
+ * O componente `br-link` é o controle oficial de hiperlink do GovBR-DS, projetado para orientar e conduzir a pessoa usuária em navegações internas entre páginas ou encaminhamentos para destinos externos.
  *
- * 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/link?tab=designer).
+ * ### Para que serve
  *
- * @category Navegação
+ * - **Navegação estruturada:** Conduz o usuário para novas URLs, rotas de aplicação, âncoras dentro da mesma página ou arquivos para download.
+ * - **Identificação de links externos:** Permite sinalizar visualmente que o link aponta para um domínio externo ou abre em nova aba/janela, adicionando os atributos de segurança e acessibilidade necessários (`target="_blank"`, `rel="noopener noreferrer"`).
+ * - **Estilos inline e de bloco:** Adapta-se ao fluxo de leitura textual em parágrafos ou como elemento de navegação isolado com suporte a ícones.
+ *
+ * ### Quando utilizar
+ *
+ * - **Utilize quando:**
+ *   - A ação resultar na alteração da URL do navegador, navegação para outra página ou download de arquivo.
+ * - **Evite e prefira outro componente quando:**
+ *   - A ação disparar um comportamento na interface sem alterar a URL (como abrir modal, submeter formulário ou acionar filtro): prefira `br-button`.
+ *
+ * ### Estrutura e Slots
+ *
+ * O `br-link` é um componente autônomo:
+ * - `default`: Slot para o texto do link, ícones auxiliares ou elementos combinados.
+ *
+ * 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/link?tab=designer).
+ *
+
+
+ * @category Navegação, Ações
  * @status stable
  * @slot default - Conteúdo do link (texto, ícones ou outros elementos).
  * @part anchor - Parte exposta para o elemento âncora interno, usada para estilos customizados via `::part(anchor)`.
+ *
  */
 export class Link {
     constructor() {
@@ -28,6 +50,9 @@ export class Link {
          */
         this.navigationMode = 'native';
         /**
+         * Ativa o comportamento legado de navegação SPA, interceptando cliques simples
+         * para atualizar o histórico e emitir `brSpaNavigate`.
+         *
          * @deprecated Use `navigationMode="event"` e o evento `brNavigate`.
          */
         this.isSpaLinkBehavior = false;
@@ -64,7 +89,7 @@ export class Link {
             if (event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
                 return;
             }
-            if (this.isSpaLinkBehavior && this.navigationMode === 'native') {
+            if (this.isSpaLinkBehavior && this.effectiveNavigationMode === 'native') {
                 event.preventDefault();
                 const spaEvent = this.brSpaNavigate.emit({ event, href: this.href });
                 if (!spaEvent.defaultPrevented && typeof window !== 'undefined')
@@ -74,8 +99,8 @@ export class Link {
             handleNavigationClick({
                 event,
                 href: this.href,
-                target: this.target,
-                navigationMode: this.navigationMode,
+                target: this.effectiveTarget,
+                navigationMode: this.effectiveNavigationMode,
                 brNavigate: this.brNavigate,
             });
         };
@@ -104,7 +129,7 @@ export class Link {
             return attrs;
         };
         this.getRel = () => {
-            if (this.target === '_blank') {
+            if (this.effectiveTarget === '_blank') {
                 // Garante noopener e noreferrer mesmo com rel customizado (mitiga tabnabbing).
                 const parts = new Set([...(this.rel ?? '').split(' ').filter(Boolean), 'noopener', 'noreferrer']);
                 return [...parts].join(' ');
@@ -112,6 +137,14 @@ export class Link {
             return this.rel;
         };
     }
+    get effectiveTarget() {
+        return resolveAllowedPropValue(this.el, 'target', this.target, ['_self', '_blank', '_parent', '_top'], undefined, {
+            allowUndefined: true,
+        });
+    }
+    get effectiveNavigationMode() {
+        return resolveAllowedPropValue(this.el, 'navigationMode', this.navigationMode, ['native', 'event'], 'native');
+    }
     handleDisabledChange(isDisabled) {
         // Remove o foco se o link for desativado enquanto focado: tabindex/href
         // removidos não retiram um foco já aplicado.
@@ -120,7 +153,7 @@ export class Link {
         }
     }
     render() {
-        return (h(Host, { key: '3a2d7f49bfafc65412524d38a964a713ee1fe526' }, h("a", { key: 'eddc87987df0418b5fdde03b39cadbc2db73762b', part: "anchor", class: { 'br-button': this.button }, href: this.disabled ? undefined : this.href, target: this.target, rel: this.getRel(), download: this.download, hreflang: this.hreflang, referrerPolicy: this.referrerPolicy, type: this.type, "aria-disabled": this.disabled ? 'true' : null, onClick: this.handleClick, ...this.getAnchorAttrs() }, h("slot", { key: '74ece0d935b97cb91fd9d8df789f709dc3c5068d' }))));
+        return (h(Host, { key: '735d6e0d48cb55199a14f32c3d0d86c234e4cd61' }, h("a", { key: '54b489e59820264b3a5367af6195b6bd06e06712', part: "anchor", class: { 'br-button': this.button }, href: this.disabled ? undefined : this.href, target: this.effectiveTarget, rel: this.getRel(), download: this.download, hreflang: this.hreflang, referrerPolicy: this.referrerPolicy, type: this.type, "aria-disabled": this.disabled ? 'true' : null, onClick: this.handleClick, ...this.getAnchorAttrs() }, h("slot", { key: 'c1e47475dd6c47eba68bfe97ce77a08594d3800a' }))));
     }
     static get is() { return "br-link"; }
     static get encapsulation() { return "shadow"; }
@@ -318,7 +351,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `navigationMode=\"event\"` e o evento `brNavigate`."
                         }],
-                    "text": ""
+                    "text": "Ativa o comportamento legado de navega\u00E7\u00E3o SPA, interceptando cliques simples\npara atualizar o hist\u00F3rico e emitir `brSpaNavigate`."
                 },
                 "getter": false,
                 "setter": false,
@@ -400,7 +433,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaExpanded`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-expanded` para o elemento \u00E2ncora interno."
                 },
                 "getter": false,
                 "setter": false,
@@ -442,7 +475,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaSelected`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-selected` para o elemento \u00E2ncora interno."
                 },
                 "getter": false,
                 "setter": false,
@@ -484,7 +517,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaHasPopup`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-haspopup` para o elemento \u00E2ncora interno."
                 },
                 "getter": false,
                 "setter": false,
@@ -526,7 +559,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaCurrent`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-current` para o elemento \u00E2ncora interno.\nIndica o item ativo em um conjunto de navega\u00E7\u00E3o (breadcrumb, menu, pagina\u00E7\u00E3o).\nValores comuns: `\"page\"` (link da p\u00E1gina atual), `\"step\"` (etapa ativa), `\"true\"`.\nRefer\u00EAncia: WCAG 1.3.1 e ARIA `aria-current`."
                 },
                 "getter": false,
                 "setter": false,
@@ -568,7 +601,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaLabel`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-label` para o elemento \u00E2ncora interno.\nFornece nome acess\u00EDvel ao link quando o conte\u00FAdo do slot n\u00E3o \u00E9 descritivo\npor si s\u00F3 (ex.: link com \u00EDcone sem texto vis\u00EDvel)."
                 },
                 "getter": false,
                 "setter": false,
@@ -610,7 +643,7 @@ export class Link {
                             "name": "deprecated",
                             "text": "Use `ariaDescribedBy`."
                         }],
-                    "text": ""
+                    "text": "Encaminhamento de `aria-describedby` para o elemento \u00E2ncora interno.\nReferencia o `id` de um elemento externo que descreve o link."
                 },
                 "getter": false,
                 "setter": false,