@govbr-ds/webcomponents 2.2.0 → 2.4.0

package/dist/types/components/button/button.d.ts

@@ -95,7 +95,8 @@ export declare class Button {
      */
     shape?: ButtonShape;
     /**
-     * Define o tipo de botão, especificando seu comportamento padrão. Valores inválidos usam `button`.
+     * Define o tipo de botão, especificando seu comportamento padrão.
+     * Quando omitido, usa `button`; valores inválidos também usam `button` e geram aviso no console.
      */
     type?: ButtonType;
     /**

package/dist/types/components/collapse/collapse.d.ts

@@ -32,6 +32,8 @@ import type { CollapseChangeDetail, CollapseColorMode, CollapseExpansionDirectio
  * @see br-list
  * @slot default - Slot para o conteúdo expansível exibido ao abrir o collapse.
  * @slot trigger - Slot para personalizar o acionador (texto, ícones, imagens, etc.).
+ * @slot icon-to-show - Ícone exibido quando o conteúdo está oculto (ex.: `<i slot="icon-to-show" class="fas fa-plus"></i>`). Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToShow`.
+ * @slot icon-to-hide - Ícone exibido quando o conteúdo está visível. Forma preferida para ícones por classe CSS; tem precedência sobre a prop `iconToHide`.
  *
  * @part details - Elemento details nativo do collapse.
  * @part trigger - Acionador (summary) do collapse.
@@ -67,11 +69,13 @@ export declare class Collapse {
      */
     accordionGroup?: string;
     /**
-     * Identificador do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+     * Identificador Iconify do ícone exibido quando o conteúdo está oculto. O valor padrão usa o registro SVG local.
+     * Para ícones por classe CSS, use o slot `icon-to-show`.
      */
     iconToShow: string;
     /**
-     * Identificador do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+     * Identificador Iconify do ícone exibido quando o conteúdo está visível. O valor padrão usa o registro SVG local.
+     * Para ícones por classe CSS, use o slot `icon-to-hide`.
      */
     iconToHide: string;
     /**

package/dist/types/components/datetime-picker/date-picker/date-picker-locale.d.ts

@@ -7,30 +7,30 @@ import type { WeekDayIndex } from '../datetime-picker.types';
  * importados pela aplicação consumidora e registrados somente quando forem
  * necessários, evitando que o catálogo completo do date-fns seja empacotado.
  *
- * @param localeCode - Código usado na propriedade `locale` do componente.
- * @param locale - Locale compatível com o date-fns.
+ * @param {string} localeCode - Código usado na propriedade `locale` do componente.
+ * @param {Locale} locale - Locale compatível com o date-fns.
  * @throws {TypeError} Quando o código ou o objeto de locale são inválidos.
  */
 export declare function registerDatePickerLocale(localeCode: string, locale: Locale): void;
 /**
  * Resolve o objeto `Locale` do date-fns a partir do código público informado.
  *
- * @param localeCode - Código de locale aceito pelo componente.
- * @returns Locale resolvido ou `ptBR` quando não houver correspondência.
+ * @param {string} localeCode - Código de locale aceito pelo componente.
+ * @returns {Locale} Locale resolvido ou `ptBR` quando não houver correspondência.
  */
 export declare function resolveDateFnsLocale(localeCode?: string): Locale;
 /**
  * Gera os rótulos de mês no locale informado.
  *
- * @param localeCode - Código de locale aceito pelo componente.
- * @returns Lista com os 12 meses formatados para exibição.
+ * @param {string} localeCode - Código de locale aceito pelo componente.
+ * @returns {string[]} Lista com os 12 meses formatados para exibição.
  */
 export declare function getMonthLabels(localeCode: string): string[];
 /**
  * Gera os rótulos dos dias da semana considerando o início informado.
  *
- * @param localeCode - Código de locale aceito pelo componente.
- * @param weekStartsOn - Índice do primeiro dia da semana.
- * @returns Lista com abreviações dos sete dias da semana.
+ * @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.
  */
 export declare function getWeekdayLabels(localeCode: string, weekStartsOn: WeekDayIndex): string[];

package/dist/types/components/datetime-picker/date-picker/date-picker-props-validation.d.ts

@@ -1,30 +1,31 @@
 import type { WeekDayIndex } from '../datetime-picker.types';
 /**
- * Verifica se o valor informado representa um índice válido de início da semana.
+ * Verifica se um valor representa um índice válido para o primeiro dia da semana (0-6).
  *
- * @param value - Valor bruto recebido via prop.
- * @returns `true` quando o valor está entre `0` e `6`.
+ * @param {number} value Valor a validar (possivelmente vindo de uma `@Prop`).
+ * @returns {value is WeekDayIndex} `true` quando `value` é um `WeekDayIndex` válido (0..6).
  */
 export declare function isValidWeekStartsOn(value: number): value is WeekDayIndex;
 /**
- * Normaliza o índice de início da semana e aplica `0` quando o valor é inválido.
+ * Normaliza o índice de início da semana.
+ * Quando o valor é inválido, emite um aviso e retorna o fallback `0`.
  *
- * @param value - Valor bruto recebido via prop.
- * @returns Índice normalizado para o primeiro dia da semana.
+ * @param {number} value Valor informado pelo consumidor.
+ * @returns {WeekDayIndex} Índice normalizado (`WeekDayIndex`).
  */
 export declare function normalizeWeekStartsOn(value: number): WeekDayIndex;
 /**
- * Valida se o código de locale pode ser resolvido pelo date-fns.
- * Retorna true se a resolução for bem-sucedida (inclui fallback).
+ * Verifica se um código de `locale` pode ser resolvido pelo date-fns.
  *
- * @param value - Código de locale informado pelo consumidor.
- * @returns `true` quando o locale pode ser resolvido com sucesso.
+ * @param {string} value Código de locale (ex.: "pt-BR").
+ * @returns {boolean} `true` se a resolução for bem-sucedida; `false` caso contrário.
  */
 export declare function isValidLocaleCode(value: string): boolean;
 /**
- * Normaliza o locale informado e aplica o default do componente quando necessário.
+ * Normaliza o código de `locale` informado pelo consumidor.
+ * Se inválido, emite aviso e retorna o `DATETIME_PICKER_LOCALE.DEFAULT`.
  *
- * @param value - Código de locale informado pelo consumidor.
- * @returns Locale válido para o date picker.
+ * @param {string} value Código de locale informado pelo consumidor.
+ * @returns {string} Código de locale validado (ou o default do componente).
  */
 export declare function normalizeLocale(value: string): string;