@govbr-ds/webcomponents 2.4.0 → 2.5.0

package/dist/collection/components/cookiebar/cookiebar-group/cookiebar-group.js

@@ -6,23 +6,10 @@ import { Host, h, } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 import { aggregateSelection } from "../cookiebar.utils";
 /**
- * O componente `br-cookiebar-group` é o subcomponente do GovBR-DS que representa uma categoria de cookies (ex.: necessários, desempenho, marketing) acompanhada de um controle de seleção (switch ou checkbox).
+ * Uma categoria de cookies dentro do `br-cookiebar`, como "Necessários" ou "Estatísticas". Contém um `br-cookiebar-cookie` para cada cookie.
  *
- * ### Para que serve
+ * Informe `group-id`, `group-name` e `group-text`. Use `group-opt-out="false"` quando a categoria não puder ser desativada: ela aparece como "Sempre ativo".
  *
- * - **Segmentação por finalidade:** Organiza os cookies conforme o tipo e necessidade técnica.
- * - **Controle de consentimento:** Permite habilitar ou desabilitar categorias não obrigatórias.
- *
- * ### Papel na composição
- *
- * Atua como contêiner de agrupamento intermediário dentro do `br-cookiebar`, contendo instâncias de `br-cookiebar-cookie`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser utilizado dentro do corpo de configuração do `br-cookiebar`.
- * - Recebe elementos filhos do tipo `br-cookiebar-cookie`.
- *
-
  * @slot default - Recebe os subcomponentes `br-cookiebar-cookie` do grupo.
  *
  * @part container - Div raiz do grupo.
@@ -311,7 +298,7 @@ export class CookiebarGroup {
     }
     render() {
         const summary = this.getCookieSummary();
-        return (h(Host, { key: '860769f21ded66f75553148b64781e4166d1198a' }, h("div", { key: '81e099af13c024d988ec583e678b8fff0d678b51', "aria-live": "polite", "aria-atomic": "true", class: "sr-only" }, this.liveAnnouncement), h("div", { key: '03a3abc28b699c4d233b58c1e7e9652f78445ec8', class: this.getCssClassMap(), part: "container" }, this.renderGroupHeader(summary), this.renderAlert(), h("p", { key: '6d4c20895a48eedefee5b56688c4626eb9b241f8', class: "group-description" }, this.groupText), this.renderGroupBody())));
+        return (h(Host, { key: '727a6d82baf32e758e54d1d550cb4d1041d6af26' }, h("div", { key: '2ce32eaad82695f9eb16eba675d7f090a5217d45', "aria-live": "polite", "aria-atomic": "true", class: "sr-only" }, this.liveAnnouncement), h("div", { key: 'd566bdbb470b9379565bae9f211354bf9734b3e8', class: this.getCssClassMap(), part: "container" }, this.renderGroupHeader(summary), this.renderAlert(), h("p", { key: '7433df483444a4a208a361748734ecf8236eaff8', class: "group-description" }, this.groupText), this.renderGroupBody())));
     }
     static get is() { return "br-cookiebar-group"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/cookiebar/cookiebar-header/cookiebar-header.js

@@ -5,23 +5,10 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-cookiebar-header` é o subcomponente de topo do GovBR-DS que apresenta o título e o texto introdutório do aviso de cookies.
+ * Título e texto de introdução do painel do `br-cookiebar`. Use no slot `header` do cookiebar.
  *
- * ### Para que serve
+ * Informe `main-title`, `entry-text` e, se quiser, a data em `last-update`. Para outro layout, coloque seu próprio conteúdo dentro do componente.
  *
- * - **Apresentação do contexto:** Explica resumidamente a finalidade do aviso de privacidade.
- * - **Identificação visual:** Fornece o cabeçalho padronizado da barra de cookies.
- *
- * ### Papel na composição
- *
- * Atua como elemento introdutório estrutural do `br-cookiebar`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser posicionado no slot de cabeçalho do `br-cookiebar`.
- * - Não deve ser utilizado de forma independente fora do aviso de cookies.
- *
-
  * @slot default - Conteúdo HTML personalizado que substitui o layout estruturado.
  *   Quando preenchido, as props `main-title`, `entry-text` e `last-update` são ignoradas.
  *
@@ -47,7 +34,7 @@ export class CookiebarHeader {
         };
     }
     render() {
-        return (h(Host, { key: 'da3b6d03ef41ce087c374ad2169e486dd40bc056' }, h("div", { key: '044b02ac03c20993d985c5b94c0e0fc0124125cf', class: this.getCssClassMap(), part: "container" }, !this.slotDefault && (h("div", { key: '1f05f3ac20bf55aa2095779c9a04234993a46c6d', class: "cookiebar-header-content" }, h("h2", { key: '0eb4e703748b054d787f21b03fe2f6d4ae79baa1', class: "cookiebar-header-title" }, this.mainTitle), this.lastUpdate && (h("p", { key: 'c7763c422b252a22bb548611870533608951aced', class: "cookiebar-header-last-update" }, this.lastUpdateLabel, ": ", h("span", { key: '4a13c8cb3e724659f35e8cf657c944b62754bc8d' }, this.lastUpdate))), h("p", { key: 'fa3333797857ac55b4b5560b8d2de5ba277116f4', class: "cookiebar-header-entry-text" }, this.entryText))), h("div", { key: '843212053c8e0a84d89a1146572e61a281963e8b', class: !this.slotDefault ? 'hidden-slot' : undefined }, h("slot", { key: '889ceaaf985d0d5750169948c090adff3afd13f6' })))));
+        return (h(Host, { key: '5b3abc8ce16cccc8de172af0fa299bc8a34af864' }, h("div", { key: '62d34a4dd0c1b38afa81e85c44a02fb5c23113d2', class: this.getCssClassMap(), part: "container" }, !this.slotDefault && (h("div", { key: '908f971f696cdadc79112d4f316dcbe9ba31b4a5', class: "cookiebar-header-content" }, h("h2", { key: 'b26058d9f05feb4ab6d70c68a5ce0927b6d03c7a', class: "cookiebar-header-title" }, this.mainTitle), this.lastUpdate && (h("p", { key: '4e170b3d8a9b5c52af5175f9ca3d5fd3b82b9e50', class: "cookiebar-header-last-update" }, this.lastUpdateLabel, ": ", h("span", { key: '00b3afcd30296c26247571e1379cd21094b57592' }, this.lastUpdate))), h("p", { key: 'b8cf0863ec2bcc1dc79f0e40985bbceed185ced2', class: "cookiebar-header-entry-text" }, this.entryText))), h("div", { key: '9b640667f632ce39b3998436c97c12842b74d432', class: !this.slotDefault ? 'hidden-slot' : undefined }, h("slot", { key: '58085d5bf6c4611be30a5dfb4ed110f42a00d61f' })))));
     }
     static get is() { return "br-cookiebar-header"; }
     static get encapsulation() { return "shadow"; }

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

@@ -7,22 +7,10 @@ import { generateUniqueId } from "../../../shared/utils/id";
 import { handleNavigationClick } from "../../../shared/utils/navigation";
 import { resolveAllowedPropValue } from "../../../shared/utils/props";
 /**
- * O componente `br-cookiebar-link` é o subcomponente de hiperlink do GovBR-DS destinado a apontar para Políticas de Privacidade, Termos de Uso e orientações legais.
+ * Link do `br-cookiebar` para a política de privacidade ou os termos de uso. Use no slot `links` do cookiebar.
  *
- * ### Para que serve
+ * Informe `name` e `href`. Em SPA, use `navigation-mode="event"` e trate o evento `brNavigate`.
  *
- * - **Acesso a termos legais:** Encaminha a pessoa usuária para a documentação completa de proteção de dados.
- * - **Estilo consistente:** Garante conformidade visual e acessibilidade no contexto do aviso de cookies.
- *
- * ### Papel na composição
- *
- * Atua como item de navegação auxiliar no aviso de cookies.
- *
- * ### Regra de uso e relacionamento
- *
- * - Pode ser utilizado dentro do cabeçalho, notas ou corpo do componente `br-cookiebar`.
- *
-
  * @part link - Elemento âncora (`<a>`) do link.
  */
 export class CookiebarLink {
@@ -64,7 +52,7 @@ export class CookiebarLink {
         };
     }
     render() {
-        return (h(Host, { key: 'dd9850a3a6d93bcd225c6655b4aba5a62893114f' }, h("div", { key: 'ffac985b40ea1e2019ef4f8057604f954ead4627', class: this.getCssClassMap() }, h("a", { key: 'c19835a4a184980816ea80e0d73a4a743acb48db', class: "cookiebar-link-anchor", href: this.href, target: this.effectiveTarget, rel: this.effectiveTarget === '_blank' ? 'noopener noreferrer' : undefined, onClick: this.handleClick, part: "link" }, this.name, this.effectiveTarget === '_blank' && (h("br-icon", { key: 'e069e9af659cb77bd28f45425a9e661a0f680264', class: "external-icon", iconName: "fa6-solid:arrow-up-right-from-square", width: "12", height: "12", "aria-label": "(abre em nova aba)" }))))));
+        return (h(Host, { key: '8047d8b600ab5d1fa1c4827eccf2bfdb0598c91a' }, h("div", { key: '84c2c4a97e2d94d0381ed6441af95fdd7d7218b1', class: this.getCssClassMap() }, h("a", { key: 'ee8619039f1bb9ccd5140d5c5b739de2222680c8', class: "cookiebar-link-anchor", href: this.href, target: this.effectiveTarget, rel: this.effectiveTarget === '_blank' ? 'noopener noreferrer' : undefined, onClick: this.handleClick, part: "link" }, this.name, this.effectiveTarget === '_blank' && (h("br-icon", { key: 'd0908588f3b1074abbaa13ba9d483ac4db653190', class: "external-icon", iconName: "fa6-solid:arrow-up-right-from-square", width: "12", height: "12", "aria-label": "(abre em nova aba)" }))))));
     }
     static get is() { return "br-cookiebar-link"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/cookiebar/cookiebar-note/cookiebar-note.js

@@ -5,21 +5,10 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-cookiebar-note` é o subcomponente textual do GovBR-DS que exibe notas explicativas, orientações complementares ou avisos jurídicos adicionais.
+ * Uma pergunta e resposta complementar no painel do `br-cookiebar`. Informe `question` e `answer`.
  *
- * ### Para que serve
+ * Para reunir várias notas, coloque-as em um `br-cookiebar-note-group`.
  *
- * - **Notas de rodapé do aviso:** Apresenta esclarecimentos sobre retenção de dados, atualizações de termos ou exceções regulatórias.
- *
- * ### Papel na composição
- *
- * Atua como bloco textual informativo complementar.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser utilizado diretamente no `br-cookiebar` ou dentro de um `br-cookiebar-note-group`.
- *
-
  * @part container - Div raiz do item.
  * @part question - Parágrafo da pergunta.
  * @part answer - Parágrafo da resposta.
@@ -30,7 +19,7 @@ export class CookiebarNote {
         this.customId = generateUniqueId();
     }
     render() {
-        return (h(Host, { key: '32364f5bde7a8d4fa6c131e29c2939df33886718' }, h("div", { key: 'ff00101ed18878af6c30df4bb2756e3c99c9d4c7', class: "br-cookiebar-note", part: "container" }, h("p", { key: 'aed474a2fe84bc0fb9e081b234088ead48191eda', class: "note-question", part: "question" }, this.question), h("p", { key: '17c11c4c7879428bbf27c92cdc41ca7d105b144b', class: "note-answer", part: "answer" }, this.answer))));
+        return (h(Host, { key: '27a435f2cc2f45f6730c87ac1325cb3880a1637b' }, h("div", { key: '9509241f196eab29ecd5ee4b23340d3679668346', class: "br-cookiebar-note", part: "container" }, h("p", { key: '2fa3cd70d2aa1dc224b719ea9c75cb1c86e89cd6', class: "note-question", part: "question" }, this.question), h("p", { key: '861f92ef168b6bc831e1c3811523c6e09f6b6224', class: "note-answer", part: "answer" }, this.answer))));
     }
     static get is() { return "br-cookiebar-note"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/cookiebar/cookiebar-note-group/cookiebar-note-group.js

@@ -5,21 +5,10 @@
 import { Host, h } from "@stencil/core";
 import { generateUniqueId } from "../../../shared/utils/id";
 /**
- * O componente `br-cookiebar-note-group` é o subcomponente contêiner do GovBR-DS que agrupa uma ou mais notas informativas `br-cookiebar-note`.
+ * Agrupa notas do `br-cookiebar` em uma seção que pode ser expandida. O título vem de `note-title`.
  *
- * ### Para que serve
+ * Coloque dentro dele elementos `br-cookiebar-note` ou outro conteúdo.
  *
- * - **Estruturação de notas:** Agrupa avisos jurídicos e observações complementares em uma seção visualmente delimitada.
- *
- * ### Papel na composição
- *
- * Atua como contêiner estrutural para instâncias de `br-cookiebar-note`.
- *
- * ### Regra de uso e relacionamento
- *
- * - Deve ser inserido na seção de notas informativas do `br-cookiebar`.
- *
-
  * @slot default - Recebe `br-cookiebar-note` ou qualquer conteúdo HTML livre.
  *
  * @part container - Div raiz do grupo.

package/dist/collection/components/cookiebar/cookiebar.js

@@ -12,41 +12,46 @@ import { resolveAllowedPropValue } from "../../shared/utils/props";
 import { aggregateSelection } from "./cookiebar.utils";
 const COOKIEBAR_MODES = ['default', 'open'];
 /**
- * O componente `br-cookiebar` é o orquestrador completo do GovBR-DS para aviso e gestão de consentimento de cookies, atendendo às exigências da LGPD (Lei Geral de Proteção de Dados).
+ * O `br-cookiebar` avisa sobre o uso de cookies e registra o consentimento da pessoa, por categoria e por cookie.
  *
- * ### Para que serve
+ * Ele aparece como uma barra no rodapé (`mode="default"`) e abre um painel com as categorias quando a pessoa escolhe "Definir Cookies" (`mode="open"`).
  *
- * - **Aviso de privacidade e cookies:** Informa com clareza à pessoa usuária sobre a coleta e finalidade de cookies no sistema.
- * - **Gestão de consentimento:** Permite aceitar todos os cookies, rejeitar os não essenciais ou gerenciar categorias de forma granular.
- * - **Detalhamento transparente:** Exibe a relação técnica de cookies utilizados por categoria com nome, validade e finalidade.
+ * ### Como usar
  *
- * ### Quando utilizar
+ * 1. Escreva o texto da barra em `info-text`.
+ * 2. Coloque o título e a introdução do painel em um `br-cookiebar-header`.
+ * 3. Crie um `br-cookiebar-group` por categoria e, dentro dele, um `br-cookiebar-cookie` por cookie. Use `group-opt-out="false"` nas categorias que não podem ser desativadas.
+ * 4. Adicione os links de política em `br-cookiebar-link`, no slot `links`.
+ * 5. Ouça `brCookiebarResponse` para salvar a escolha e ative `show` somente enquanto não houver escolha salva.
  *
- * - **Utilize quando:**
- *   - A aplicação ou portal público utilizar cookies de sessão, rastreamento ou preferências que demandem consentimento explícito.
- *   - For necessário dar cumprimento às diretrizes de privacidade e proteção de dados pessoais (LGPD).
- * - **Evite e prefira outro componente quando:**
- *   - A notificação for apenas um alerta contextual ou mensagem simples de status sem relação com consentimento (prefira `br-message` ou `br-notification`).
+ * ```html
+ * <br-cookiebar info-text="Usamos cookies para melhorar sua experiência.">
+ *   <br-cookiebar-header slot="header" main-title="Aviso de cookies" entry-text="Escolha quais cookies aceitar."></br-cookiebar-header>
  *
- * ### Composição e Subcomponentes
+ *   <br-cookiebar-group group-id="necessarios" group-name="Necessários" group-text="Essenciais para o site funcionar." group-opt-out="false">
+ *     <br-cookiebar-cookie cookie-id="sessao" cookie-name="sessao" expires="Ao fechar o navegador" domain="exemplo.gov.br" enterprise="Próprio" purpose="Manter a sessão" description="Identifica a sessão de acesso."></br-cookiebar-cookie>
+ *   </br-cookiebar-group>
  *
- * | Subcomponente | Papel | Regra de uso |
- * | --- | --- | --- |
- * | `br-cookiebar` | **Orquestrador principal.** Gerencia abertura, fechamento, persistência e emissão dos eventos de consentimento. | Declarado como contêiner do aviso de cookies na aplicação. |
- * | `br-cookiebar-header` | **Cabeçalho informativo.** Exibe título e mensagem inicial de contexto. | Inserido no slot de topo do `br-cookiebar`. |
- * | `br-cookiebar-group` | **Categoria de cookies.** Agrupa cookies por finalidade com controle de seleção. | Inserido no corpo de opções do `br-cookiebar`. |
- * | `br-cookiebar-cookie` | **Item de cookie.** Descreve detalhadamente um cookie específico. | Inserido dentro de um `br-cookiebar-group`. |
- * | `br-cookiebar-link` | **Link informativo.** Atalho para a Política de Privacidade e termos. | Usado no cabeçalho ou notas do `br-cookiebar`. |
- * | `br-cookiebar-note` | **Nota complementar.** Mensagem ou aviso jurídico adicional. | Inserido individualmente ou em `br-cookiebar-note-group`. |
- * | `br-cookiebar-note-group` | **Agrupador de notas.** Organiza múltiplas notas informativas. | Posicionado na área de notas do `br-cookiebar`. |
+ *   <br-cookiebar-link slot="links" name="Política de privacidade" href="/privacidade"></br-cookiebar-link>
+ * </br-cookiebar>
+ * ```
  *
- * ### Como os subcomponentes se relacionam
+ * ```js
+ * const cookiebar = document.querySelector('br-cookiebar');
+ * cookiebar.show = !localStorage.getItem('consentimento');
+ * cookiebar.addEventListener('brCookiebarResponse', (event) => {
+ *   localStorage.setItem('consentimento', JSON.stringify(event.detail));
+ * });
+ * ```
  *
- * O `br-cookiebar` atua como orquestrador central. Ele controla a visualização do painel (modo compacto ou expandido), agrupa as categorias (`br-cookiebar-group`) com seus respectivos cookies (`br-cookiebar-cookie`) e disponibiliza os botões de ação para aceitar todos, rejeitar ou salvar preferências. A aplicação consome eventos unificados de consentimento disparados pelo componente pai.
+ * `event.detail` traz o estado de cada categoria (`cookieGroups`) e de cada cookie (`cookieList`). Para reabrir o painel depois, por exemplo num link "Preferências de cookies", chame `openPanel()`.
  *
- * 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/cookiebar?tab=designer).
+ * ### Quando evitar
+ *
+ * - Avisos que não tratam de consentimento: use `br-message` ou `br-notification`.
+ *
+ * Consulte as [diretrizes de design do GovBR](https://www.gov.br/ds/components/cookiebar?tab=designer).
  *
-
  * @category Feedback, Sobreposições
  * @status stable
  * @slot default - Recebe os subcomponentes `br-cookiebar-group`, `br-cookiebar-note-group` e `br-cookiebar-note`.
@@ -780,10 +785,10 @@ export class Cookiebar {
     }
     render() {
         const containerContent = [
-            this.effectiveMode === 'default' && this.scrim && h("div", { key: 'd8c86bf41c9e9f5afeff7b5f21a29ec465f7eeb2', class: "cookiebar-scrim", part: "scrim", "aria-hidden": "true" }),
+            this.effectiveMode === 'default' && this.scrim && h("div", { key: '76c0c2a7d5d18437a733c789dc6728bb1cc18a22', class: "cookiebar-scrim", part: "scrim", "aria-hidden": "true" }),
             this.effectiveMode === 'default' ? this.renderDefaultPanel() : this.renderOpenPanel(),
         ];
-        return (h(Host, { key: '13e95228e78891eea097613210916cd82e3eb20d' }, h("div", { key: '02dab794a5c849a2a8dd52946e8bf20133aa9894', "aria-live": "polite", "aria-atomic": "true", class: "sr-only" }, this.liveAnnouncement), this.show &&
+        return (h(Host, { key: 'cdd183310fe4efde34c719562f7157f8f11fa754' }, h("div", { key: 'e71c1aec05b8b8d91724c8aa236f4d4e7fa1b9a9', "aria-live": "polite", "aria-atomic": "true", class: "sr-only" }, this.liveAnnouncement), this.show &&
             (this.usesNativeDialog ? (h("dialog", { ref: (el) => (this.nativeDialogRef = el), class: this.getCssClassMap(), part: "container", role: this.usesNativeTopLayer ? undefined : 'dialog', "aria-modal": "true", "aria-label": this.effectiveMode === 'open' ? this.panelLabel : this.defaultPanelLabel, "aria-describedby": this.effectiveMode === 'open' && this.openPanelDescription ? `${this.customId}-desc` : undefined, onCancel: this.handleNativeCancel }, containerContent)) : (h("div", { ref: () => (this.nativeDialogRef = null), class: this.getCssClassMap(), part: "container" }, containerContent)))));
     }
     static get is() { return "br-cookiebar"; }

package/dist/collection/components/datetime-picker/date-picker/date-picker-locale.js

@@ -10,6 +10,26 @@ import { setMonth } from "date-fns/setMonth";
 import { startOfWeek } from "date-fns/startOfWeek";
 import { DATETIME_PICKER_LOCALE } from "../datetime-picker-constants";
 const registeredLocales = new Map([[localeCodeToKey(DATETIME_PICKER_LOCALE.DEFAULT), ptBR]]);
+/**
+ * Rótulos já gerados por locale (e início da semana), reaproveitados entre renderizações.
+ * São invalidados quando um locale é registrado novamente.
+ */
+const labelsCache = new Map();
+/**
+ * Retorna os rótulos memorizados para a chave ou os gera uma única vez.
+ *
+ * @param {string} cacheKey - Chave composta por tipo de rótulo e locale.
+ * @param {() => string[]} build - Gerador dos rótulos.
+ * @returns {readonly string[]} Rótulos memorizados.
+ */
+function getCachedLabels(cacheKey, build) {
+    let labels = labelsCache.get(cacheKey);
+    if (labels === undefined) {
+        labels = Object.freeze(build());
+        labelsCache.set(cacheKey, labels);
+    }
+    return labels;
+}
 /**
  * Converte um rótulo para capitalização de frase.
  *
@@ -50,6 +70,7 @@ export function registerDatePickerLocale(localeCode, locale) {
         throw new TypeError('locale deve ser um objeto compatível com date-fns');
     }
     registeredLocales.set(localeCodeToKey(localeCode), locale);
+    labelsCache.clear();
 }
 /**
  * Resolve o objeto `Locale` do date-fns a partir do código público informado.
@@ -68,27 +89,53 @@ export function resolveDateFnsLocale(localeCode = DATETIME_PICKER_LOCALE.DEFAULT
  * @returns {string[]} Lista com os 12 meses formatados para exibição.
  */
 export function getMonthLabels(localeCode) {
-    const locale = resolveDateFnsLocale(localeCode);
-    const baseDate = new Date(2026, 0, 1);
-    return Array.from({ length: 12 }, (_, monthIndex) => {
-        const monthDate = setMonth(baseDate, monthIndex);
-        return toLabelCase(format(monthDate, 'MMMM', { locale }));
+    return getCachedLabels(`month:${localeCodeToKey(localeCode)}`, () => {
+        const locale = resolveDateFnsLocale(localeCode);
+        const baseDate = new Date(2026, 0, 1);
+        return Array.from({ length: 12 }, (_, monthIndex) => {
+            const monthDate = setMonth(baseDate, monthIndex);
+            return toLabelCase(format(monthDate, 'MMMM', { locale }));
+        });
     });
 }
 /**
- * Gera os rótulos dos dias da semana considerando o início informado.
+ * Gera os nomes dos dias da semana considerando o início informado.
  *
  * @param {string} localeCode - Código de locale aceito pelo componente.
  * @param {WeekDayIndex} weekStartsOn - Índice do primeiro dia da semana.
- * @returns {string[]} Lista com abreviações dos sete dias da semana.
+ * @param {boolean} abbreviated - `true` para abreviações de três letras; `false` para nomes completos.
+ * @returns {readonly string[]} Lista com os sete dias da semana.
  */
-export function getWeekdayLabels(localeCode, weekStartsOn) {
-    const locale = resolveDateFnsLocale(localeCode);
-    const baseDate = new Date(2026, 0, 4);
-    const weekStartDate = startOfWeek(setDay(baseDate, weekStartsOn), { weekStartsOn });
-    return Array.from({ length: 7 }, (_, dayIndex) => {
-        const dayDate = addDays(weekStartDate, dayIndex);
-        const abbreviated = format(dayDate, 'EEE', { locale }).slice(0, 3);
-        return toLabelCase(abbreviated);
+function getWeekdayNames(localeCode, weekStartsOn, abbreviated) {
+    const cacheKey = `weekday:${abbreviated ? 'short' : 'long'}:${weekStartsOn}:${localeCodeToKey(localeCode)}`;
+    return getCachedLabels(cacheKey, () => {
+        const locale = resolveDateFnsLocale(localeCode);
+        const baseDate = new Date(2026, 0, 4);
+        const weekStartDate = startOfWeek(setDay(baseDate, weekStartsOn), { weekStartsOn });
+        return Array.from({ length: 7 }, (_, dayIndex) => {
+            const dayDate = addDays(weekStartDate, dayIndex);
+            const name = abbreviated ? format(dayDate, 'EEE', { locale }).slice(0, 3) : format(dayDate, 'EEEE', { locale });
+            return toLabelCase(name);
+        });
     });
 }
+/**
+ * Gera os rótulos abreviados dos dias da semana considerando o início informado.
+ *
+ * @param {string} localeCode - Código de locale aceito pelo componente.
+ * @param {WeekDayIndex} weekStartsOn - Índice do primeiro dia da semana.
+ * @returns {readonly string[]} Lista com abreviações dos sete dias da semana.
+ */
+export function getWeekdayLabels(localeCode, weekStartsOn) {
+    return getWeekdayNames(localeCode, weekStartsOn, true);
+}
+/**
+ * Gera os nomes completos dos dias da semana, usados como nome acessível dos cabeçalhos.
+ *
+ * @param {string} localeCode - Código de locale aceito pelo componente.
+ * @param {WeekDayIndex} weekStartsOn - Índice do primeiro dia da semana.
+ * @returns {readonly string[]} Lista com os nomes completos dos sete dias da semana.
+ */
+export function getWeekdayFullNames(localeCode, weekStartsOn) {
+    return getWeekdayNames(localeCode, weekStartsOn, false);
+}