@plenustech/design-system 0.1.1 → 0.2.1

package/dist/reset.css

@@ -14,20 +14,21 @@ html {
 
 body {
   margin: 0;
-  background: var(--pl-bg);
-  color: var(--pl-text);
+  background: var(--pl-color-background);
+  color: var(--pl-color-text);
   font-family: var(--pl-font-body);
   font-size: var(--pl-type-body-size);
-  line-height: var(--pl-leading);
+  line-height: var(--pl-type-body-line-height);
   -webkit-font-smoothing: antialiased;
   text-rendering: optimizeLegibility;
 }
 
+/* O tamanho de cada titulo e da pagina; a entrelinha acompanha o tamanho, qualquer que seja. */
 h1, h2, h3, h4, h5, h6 {
   margin: 0;
   font-family: var(--pl-font-heading);
-  font-weight: var(--pl-weight-semibold);
-  line-height: var(--pl-leading-tight);
+  font-weight: var(--pl-type-headline-medium-weight);
+  line-height: 1.2;
 }
 
 p, figure, blockquote { margin: 0; }
@@ -58,8 +59,8 @@ select {
 }
 
 ::selection {
-  background: var(--pl-primary);
-  color: var(--pl-on-primary);
+  background: var(--pl-color-primary);
+  color: var(--pl-color-on-primary);
 }
 
 /* Foco visivel para o que a pagina traz. Os componentes do sistema definem o
@@ -72,7 +73,7 @@ select {
 ::-webkit-scrollbar { width: 10px; height: 10px; }
 
 ::-webkit-scrollbar-thumb {
-  background: var(--pl-border-strong);
+  background: var(--pl-color-border-strong);
   border-radius: var(--pl-radius-md);
   border: 3px solid transparent;
   background-clip: content-box;

package/dist/types/components/charts/ChartArea/ChartArea.d.ts

@@ -14,7 +14,7 @@ export interface ChartAreaProps {
     /**
      * Inclui o zero no dominio do eixo de valor. Ligado por padrao, porque marca
      * que nao parte do zero exagera a diferenca; para medidas que nao se comparam
-     * a ele — um ano, uma temperatura — desligue.
+     * a ele — um ano, uma temperatura — desligue; um ano pede tambem um formato sem separador de milhar em `formatValue`.
      */
     includeZero?: boolean;
     height?: ChartHeight;

package/dist/types/components/charts/ChartBar/ChartBar.d.ts

@@ -21,6 +21,7 @@ export interface ChartBarProps {
     onHoverCategory?: (index: number | null) => void;
     orientation?: ChartBarOrientation;
     series: readonly ChartBarSeries[];
+    /** Valor alem da ponta de cada barra; empilhada, o total da categoria alem da ponta da pilha. */
     showDataLabels?: boolean;
     stacked?: boolean;
     title: string;

package/dist/types/components/charts/ChartLine/ChartLine.d.ts

@@ -14,7 +14,7 @@ export interface ChartLineProps {
     /**
      * Inclui o zero no dominio do eixo de valor. Ligado por padrao, porque marca
      * que nao parte do zero exagera a diferenca; para medidas que nao se comparam
-     * a ele — um ano, uma temperatura — desligue.
+     * a ele — um ano, uma temperatura — desligue; um ano pede tambem um formato sem separador de milhar em `formatValue`.
      */
     includeZero?: boolean;
     height?: ChartHeight;

package/dist/types/components/charts/ChartRadial/ChartRadial.d.ts

@@ -20,6 +20,7 @@ export interface ChartRadialProps {
     legend?: ChartLegendPosition;
     legendAlign?: ChartLegendAlign;
     onHiddenTracksChange?: (hidden: readonly string[]) => void;
+    /** Valor no centro. Ele reserva o proprio espaco, ate metade do raio: com muitos aneis, quem cede e a espessura deles. */
     showCenter?: boolean;
     startAngle?: number;
     /** Raio das pontas do arco. Sem valor, o token de raio pequeno. */

package/dist/types/components/charts/ChartScatter/ChartScatter.d.ts

@@ -18,11 +18,11 @@ export interface ChartScatterProps {
     formatY?: (value: number) => string;
     formatZ?: (value: number) => string;
     /**
-     * Inclui o zero no dominio dos eixos. Ligado por padrao, porque barra que nao
-     * parte do zero exagera a diferenca; para medidas que nao se comparam a ele —
-     * um ano, uma temperatura — desligue.
+     * Inclui o zero no dominio: `true` nos dois eixos, `'x'` ou `'y'` so naquele, `false` em nenhum.
+     * Medida que nao se compara ao zero — um ano, uma temperatura — fica com o eixo dela de fora;
+     * um ano pede tambem um formato sem separador de milhar em `formatX` ou `formatY`.
      */
-    includeZero?: boolean;
+    includeZero?: boolean | 'x' | 'y';
     height?: ChartHeight;
     hiddenSeries?: readonly string[];
     legend?: ChartLegendPosition;

package/dist/types/components/charts/core/centerText.d.ts

@@ -6,9 +6,10 @@ export interface CenterText {
     size: number;
     value: string;
 }
+/** Raio do vazio central em que o valor cabe inteiro no menor degrau da escala. */
+export declare function centerTextRadius(value: string, font: LabelFont): number;
 /**
- * Valor e rotulo do centro, no maior degrau da escala em que o texto ainda cabe
- * dentro do anel. O SVG nao quebra linha nem corta o que transborda, entao quem
- * precisa caber e o texto: ele desce de degrau e, no ultimo, e cortado.
+ * Valor e rotulo do centro, no maior degrau da escala oficial em que o texto ainda cabe dentro do anel: o valor e um
+ * KPI, e anel pequeno desce na escala em vez de sair dela. O SVG nao corta o que transborda; no ultimo degrau, corta-se.
  */
 export declare function fitCenterText(value: string, label: string, font: LabelFont, innerDiameter: number): CenterText;

package/dist/types/components/charts/core/index.d.ts

@@ -8,7 +8,7 @@ export { bottomLabelRotation, cartesianLayout, chartHeight, valueLabelsFor, } fr
 export type { AxisLabelAngle, AxisLabelRotation, AxisVisibility, CartesianLayout, CartesianLayoutOptions, ChartHeight, ChartMargins, ChartPlot, ResolvedHeight, } from './cartesianLayout.js';
 export { arcAnchor, arcCentroid, arcPath, sliceAngles, VOLTA } from './arcs.js';
 export type { ArcAngles, ArcShape, SliceAnglesOptions } from './arcs.js';
-export { fitCenterText } from './centerText.js';
+export { centerTextRadius, fitCenterText } from './centerText.js';
 export type { CenterText } from './centerText.js';
 export { CartesianFrame } from './CartesianFrame.js';
 export type { CartesianAxis, CartesianFrameProps, CartesianGrid } from './CartesianFrame.js';

package/dist/types/components/charts/core/measureText.d.ts

@@ -1,4 +1,12 @@
+/** Um degrau da escala tipografica para o valor do centro de um anel. */
+export interface CenterStep {
+    display: boolean;
+    lineHeight: number;
+    size: number;
+}
 export interface LabelFont {
+    /** Degraus do valor do centro, do maior ao menor: display, headline e title. */
+    centerSteps: readonly CenterStep[];
     family: string;
     /** Familia de display, usada onde o valor e um KPI. */
     headingFamily: string;

package/dist/types/components/charts/core/slices.d.ts

@@ -7,12 +7,4 @@ export interface GroupSmallSlicesOptions {
     label: string;
     threshold: number;
 }
-/**
- * Reune as fatias pequenas numa so. Abaixo de um limiar a fatia deixa de ser
- * legivel no anel e ainda ocupa uma linha da legenda; o agrupamento e a regra
- * de percentual minimo da referencia.
- *
- * A fatia reunida entra no lugar da primeira pequena, para que a ordem das
- * demais, que a legenda repete, permaneca a mesma.
- */
 export declare function groupSmallSlices(slices: readonly ChartSlice[], { label, threshold }: GroupSmallSlicesOptions): readonly ChartSlice[];

package/dist/types/components/charts/palette/index.d.ts

@@ -1,3 +1,3 @@
 export { SERIES_TOKENS, paletteWithAccent, seriesColors } from './palette.js';
-export { INTENT_TOKENS, resolveSeriesColors } from './seriesColor.js';
+export { INTENT_TOKENS, resolveSeriesColors, textColorOn } from './seriesColor.js';
 export type { ResolveSeriesColorsOptions, SeriesAppearance, SeriesIntent } from './seriesColor.js';

package/dist/types/components/charts/palette/seriesColor.d.ts

@@ -13,6 +13,11 @@ export interface ResolveSeriesColorsOptions {
 }
 /** Token de cada intencao. A paleta e quem detem esse mapa. */
 export declare const INTENT_TOKENS: Record<SeriesIntent, string>;
+/**
+ * Cor do texto escrito sobre a marca, como a porcentagem dentro da fatia. A cor
+ * informada em hexadecimal e medida; em outro formato, o texto fica branco.
+ */
+export declare function textColorOn(color: string): string;
 /**
  * Cor de cada serie, em tres niveis de precedencia: a cor informada pelo
  * implementador vence; depois a intencao semantica; por fim a paleta

package/dist/types/components/charts/scales/index.d.ts

@@ -1,2 +1,2 @@
-export { bandScale, domainOf, linearScale, logScale, mergeDomains, pointScale, radiusScale, stackedExtremes, ticksFor, timeScale, } from './scales.js';
-export type { CategoricalScaleOptions, ContinuousScaleOptions, NumericRange, ScaleKind } from './scales.js';
+export { alignZeros, bandScale, domainOf, linearScale, mergeDomains, pointScale, radiusScale, stackDiverging, ticksFor, } from './scales.js';
+export type { CategoricalScaleOptions, ContinuousScaleOptions, NumericRange } from './scales.js';

package/dist/types/components/charts/scales/scales.d.ts

@@ -1,4 +1,3 @@
-export type ScaleKind = 'linear' | 'log' | 'time' | 'band' | 'point';
 export interface NumericRange {
     max: number;
     min: number;
@@ -21,22 +20,19 @@ export interface CategoricalScaleOptions {
 export declare function domainOf(values: readonly number[], { includeZero }?: {
     includeZero?: boolean | undefined;
 }): NumericRange;
-/** Une varias series na mesma faixa, para que compartilhem um unico eixo. */
 /**
- * Extremos que uma pilha alcanca, e nao apenas onde ela termina. Com sinais
- * mistos o total engana: `+10` e `-5` somam `5`, mas o segmento positivo chega
- * a `10` e ficaria desenhado fora da area. O dominio precisa do caminho do
- * acumulado, incluindo o zero de onde ele parte.
+ * Pilha divergente: positivos sobem do zero e negativos descem dele, cada sinal com o proprio acumulado.
+ * Na soma corrida, `+10` e `-5` desenhavam o negativo por cima do positivo.
  */
-export declare function stackedExtremes(contributions: readonly number[]): number[];
+export declare function stackDiverging(contributions: readonly number[]): [number, number][];
+/** Une varias series na mesma faixa, para que compartilhem um unico eixo. */
 export declare function mergeDomains(domains: readonly NumericRange[]): NumericRange;
-export declare function linearScale({ clamp, domain, nice, range }: ContinuousScaleOptions): import("d3-scale").ScaleLinear<number, number, never>;
 /**
- * Escala logaritmica. Nao existe log de zero ou de negativo, entao o dominio
- * e recortado para o primeiro valor positivo.
+ * Estende dois dominios que contem o zero para que ele caia na mesma altura nos
+ * dois eixos. Cada um cresce so do lado que precisa, e a folga sai igual nos dois.
  */
-export declare function logScale({ clamp, domain, nice, range }: ContinuousScaleOptions): import("d3-scale").ScaleLogarithmic<number, number, never>;
-export declare function timeScale({ clamp, domain, nice, range }: ContinuousScaleOptions): import("d3-scale").ScaleTime<number, number, never>;
+export declare function alignZeros(a: NumericRange, b: NumericRange): [NumericRange, NumericRange];
+export declare function linearScale({ clamp, domain, nice, range }: ContinuousScaleOptions): import("d3-scale").ScaleLinear<number, number, never>;
 /** Faixas de largura igual, uma por categoria. Serve barras. */
 export declare function bandScale({ domain, padding, range }: CategoricalScaleOptions): import("d3-scale").ScaleBand<string>;
 /** Pontos sem largura, um por categoria. Serve linhas e dispersao. */

package/dist/types/components/data-display/Card/Card.d.ts

@@ -3,7 +3,7 @@ export type CardHeadingLevel = 2 | 3 | 4 | 5 | 6;
 export interface CardProps extends ComponentPropsWithRef<'section'> {
     children: ReactNode;
 }
-export declare function Card({ children, className, ...props }: CardProps): import("react").JSX.Element;
+export declare function Card({ 'aria-labelledby': ariaLabelledBy, children, className, ...props }: CardProps): import("react").JSX.Element;
 export declare namespace Card {
     var Header: typeof CardHeader;
     var Body: typeof CardBody;

package/dist/types/components/data-display/List/useListing.d.ts

@@ -23,6 +23,7 @@ export interface Listing {
     handleKeyDown: (event: KeyboardEvent<HTMLElement>) => void;
     isSelected: (value: string) => boolean;
     filter: (term: string) => void;
+    reset: () => void;
     typeahead: (character: string) => void;
     select: (item: ListingItem, extend?: boolean) => void;
     selected: readonly ListingItem[];

package/dist/types/components/data-display/Table/Table.d.ts

@@ -15,6 +15,8 @@ export interface TableSort {
 }
 export interface TableProps extends ComponentPropsWithRef<'div'> {
     children: ReactNode;
+    /** Escolha inicial no modo nao controlado. */
+    defaultSelectedIds?: readonly string[];
     defaultSort?: TableSort;
     divider?: boolean;
     label?: string;
@@ -29,10 +31,11 @@ export interface TableProps extends ComponentPropsWithRef<'div'> {
     selectionMode?: TableSelectionMode;
     size?: TableSize;
     sort?: TableSort;
+    /** Cabecalho colado no topo da rolagem da pagina; com a tabela mais larga ou mais alta que o espaco, no dela. */
     stickyHeader?: boolean;
     striped?: boolean;
 }
-export declare function Table({ children, className, defaultSort, divider, highlightSelectedRow, label, loading, loadingMessage, onSelectionChange, onSortChange, rows, selectedIds, selectionControl, selectionMode, size, sort, stickyHeader, striped, ...props }: TableProps): import("react").JSX.Element;
+export declare function Table({ children, className, defaultSelectedIds, defaultSort, divider, highlightSelectedRow, label, loading, loadingMessage, onSelectionChange, onSortChange, rows, selectedIds, selectionControl, selectionMode, size, sort, stickyHeader, striped, ref, ...props }: TableProps): import("react").JSX.Element;
 export declare namespace Table {
     var Header: typeof TableHeader;
     var Column: typeof TableColumn;
@@ -55,12 +58,12 @@ export interface TableColumnProps {
     width?: string;
 }
 declare function TableColumn({ align, children, help, hideBelow, id, numeric, sortable, width }: TableColumnProps): import("react").JSX.Element;
-export interface TableBodyProps<T> {
+export interface TableBodyProps<T extends TableRowItem> {
     children: (item: T) => ReactNode;
     empty?: ReactNode;
     items: readonly T[];
 }
-declare function TableBody<T>({ children, empty, items }: TableBodyProps<T>): import("react").JSX.Element;
+declare function TableBody<T extends TableRowItem>({ children, empty, items }: TableBodyProps<T>): import("react").JSX.Element;
 export interface TableRowProps {
     children: ReactNode;
     disabled?: boolean;

package/dist/types/components/feedback/Progress/Progress.d.ts

@@ -1,6 +1,6 @@
-import type { HTMLAttributes } from 'react';
+import type { ComponentPropsWithRef } from 'react';
 export type ProgressSize = 'sm' | 'md';
-export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+export interface ProgressProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
     label: string;
     max?: number;
     showValue?: boolean;

package/dist/types/components/forms/Checkbox/Checkbox.d.ts

@@ -1,8 +1,9 @@
-import { type ComponentPropsWithRef } from 'react';
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
 export interface CheckboxProps extends Omit<ComponentPropsWithRef<'input'>, 'type' | 'size'> {
     error?: string;
     hint?: string;
     indeterminate?: boolean;
-    label: string;
+    /** Sem rotulo visivel, o nome vem de `aria-label` ou `aria-labelledby`. */
+    label?: ReactNode;
 }
-export declare function Checkbox({ 'aria-describedby': ariaDescribedBy, className, error, hint, id: providedId, indeterminate, label, ref, ...props }: CheckboxProps): import("react").JSX.Element;
+export declare function Checkbox({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, error, hint, id: providedId, indeterminate, label, ref, ...props }: CheckboxProps): import("react").JSX.Element;

package/dist/types/components/forms/ComboBox/ComboBox.d.ts

@@ -1,16 +1,15 @@
+import { type ComponentPropsWithRef } from 'react';
 export type ComboBoxSize = 'sm' | 'md';
 export interface ComboBoxOption {
     disabled?: boolean;
     label: string;
     value: string;
 }
-export interface ComboBoxProps {
-    defaultValue?: string;
-    disabled?: boolean;
+/** As propriedades nativas vao ao campo de texto, que e o controle; o `className` soma ao do sistema. */
+interface ComboBoxBaseProps extends Omit<ComponentPropsWithRef<'input'>, 'defaultValue' | 'name' | 'onChange' | 'size' | 'type' | 'value'> {
     emptyMessage?: string;
     error?: string;
     hint?: string;
-    id?: string;
     label?: string;
     /**
      * Nome do campo no formulario. Com ele, um input oculto carrega o valor para
@@ -19,11 +18,21 @@ export interface ComboBoxProps {
     name?: string;
     loading?: boolean;
     onSearch?: (term: string) => void;
-    onValueChange?: (value: string) => void;
     options: readonly ComboBoxOption[];
-    placeholder?: string;
-    required?: boolean;
     size?: ComboBoxSize;
+}
+export interface ComboBoxSingleProps extends ComboBoxBaseProps {
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    selectionMode?: 'single';
     value?: string;
 }
-export declare function ComboBox({ defaultValue, name, disabled, emptyMessage, error, hint, id: providedId, label, loading, onSearch, onValueChange, options, placeholder, required, size, value, }: ComboBoxProps): import("react").JSX.Element;
+export interface ComboBoxMultipleProps extends ComboBoxBaseProps {
+    defaultValue?: readonly string[];
+    onValueChange?: (values: readonly string[]) => void;
+    selectionMode: 'multiple';
+    value?: readonly string[];
+}
+export type ComboBoxProps = ComboBoxSingleProps | ComboBoxMultipleProps;
+export declare function ComboBox(allProps: ComboBoxProps): import("react").JSX.Element;
+export {};

package/dist/types/components/forms/ComboBox/index.d.ts

@@ -1,2 +1,2 @@
 export { ComboBox } from './ComboBox.js';
-export type { ComboBoxProps, ComboBoxOption, ComboBoxSize } from './ComboBox.js';
+export type { ComboBoxMultipleProps, ComboBoxOption, ComboBoxProps, ComboBoxSingleProps, ComboBoxSize, } from './ComboBox.js';

package/dist/types/components/forms/DatePicker/DatePicker.d.ts

@@ -1,12 +1,17 @@
-import { type CalendarDate } from '@internationalized/date';
+import { type ComponentPropsWithRef } from 'react';
 export type DatePickerSize = 'sm' | 'md';
-export interface DatePickerProps {
-    defaultValue?: CalendarDate;
+/**
+ * As propriedades nativas vao ao campo de texto, que e o controle; o `className` soma a caixa do campo, que e o que
+ * se posiciona e dimensiona.
+ */
+export interface DatePickerProps extends Omit<ComponentPropsWithRef<'input'>, 'defaultValue' | 'max' | 'min' | 'name' | 'onChange' | 'size' | 'type' | 'value'> {
+    /** Data em ISO, `2026-03-09`, como no `FormData`: a API nao expoe tipo de biblioteca de terceiros. */
+    defaultValue?: string;
     disabled?: boolean;
     error?: string;
     hint?: string;
     id?: string;
-    isDateUnavailable?: (date: CalendarDate) => boolean;
+    isDateUnavailable?: (date: string) => boolean;
     label?: string;
     /**
      * Nome do campo no formulario. Com ele, um input oculto carrega o valor para
@@ -14,9 +19,10 @@ export interface DatePickerProps {
      */
     name?: string;
     locale?: string;
-    max?: CalendarDate;
-    min?: CalendarDate;
-    onValueChange?: (value?: CalendarDate) => void;
+    max?: string;
+    min?: string;
+    /** Sem data inteira e permitida, o valor e `null`, que mantem o campo controlado e vazio. */
+    onValueChange?: (value: string | null) => void;
     placeholder?: string;
     required?: boolean;
     size?: DatePickerSize;
@@ -24,6 +30,6 @@ export interface DatePickerProps {
      * `null` e "controlado e vazio": devolver a propriedade a `undefined` nao
      * limpa o campo, porque ali ele volta a ser nao controlado.
      */
-    value?: CalendarDate | null;
+    value?: string | null;
 }
-export declare function DatePicker({ defaultValue, name, disabled, error, hint, id: providedId, isDateUnavailable, label, locale, max, min, onValueChange, placeholder, required, size, value, }: DatePickerProps): import("react").JSX.Element;
+export declare function DatePicker({ 'aria-describedby': ariaDescribedBy, className, defaultValue, name, disabled, error, hint, id: providedId, isDateUnavailable, label, locale, max, min, onValueChange, onBlur, onKeyDown, placeholder, required, size, ref, value, ...props }: DatePickerProps): import("react").JSX.Element;

package/dist/types/components/forms/DatePicker/iso.d.ts

@@ -0,0 +1,7 @@
+import { type CalendarDateTime, type Time } from '@internationalized/date';
+export declare const readIsoDate: (texto?: string | null) => import("@internationalized/date").CalendarDate | undefined;
+export declare const readIsoTime: (texto?: string | null) => Time | undefined;
+export declare const readIsoDateTime: (texto?: string | null) => CalendarDateTime | undefined;
+/** Hora e data com hora saem sem segundos, que os seletores nao escolhem: `09:30` e `2026-03-09T09:30`. */
+export declare const toIsoTime: (hora: Time) => string;
+export declare const toIsoDateTime: (instante: CalendarDateTime) => string;

package/dist/types/components/forms/DateTimePicker/DateTimePicker.d.ts

@@ -1,12 +1,17 @@
-import { CalendarDate, CalendarDateTime } from '@internationalized/date';
+import { type ComponentPropsWithRef } from 'react';
 export type DateTimePickerSize = 'sm' | 'md';
-export interface DateTimePickerProps {
-    defaultValue?: CalendarDateTime;
+/**
+ * As propriedades nativas vao ao campo de texto, que e o controle; o `className` soma a caixa do campo, que e o que
+ * se posiciona e dimensiona.
+ */
+export interface DateTimePickerProps extends Omit<ComponentPropsWithRef<'input'>, 'defaultValue' | 'max' | 'min' | 'name' | 'onChange' | 'size' | 'type' | 'value' | 'step'> {
+    /** Data e hora em ISO, `2026-03-09T18:40`, como no `FormData`: a API nao expoe tipo de biblioteca de terceiros. */
+    defaultValue?: string;
     disabled?: boolean;
     error?: string;
     hint?: string;
     id?: string;
-    isDateUnavailable?: (date: CalendarDate) => boolean;
+    isDateUnavailable?: (date: string) => boolean;
     label?: string;
     /**
      * Nome do campo no formulario. Com ele, um input oculto carrega o valor para
@@ -14,10 +19,12 @@ export interface DateTimePickerProps {
      */
     name?: string;
     locale?: string;
-    max?: CalendarDate;
-    min?: CalendarDate;
+    /** Limites de data, em `2026-03-09`. */
+    max?: string;
+    min?: string;
     step?: number;
-    onValueChange?: (value?: CalendarDateTime) => void;
+    /** Sem data e hora inteiras e permitidas, o valor e `null`, que mantem o campo controlado e vazio. */
+    onValueChange?: (value: string | null) => void;
     placeholder?: string;
     required?: boolean;
     size?: DateTimePickerSize;
@@ -25,9 +32,6 @@ export interface DateTimePickerProps {
      * `null` e "controlado e vazio": devolver a propriedade a `undefined` nao
      * limpa o campo, porque ali ele volta a ser nao controlado.
      */
-    value?: CalendarDateTime | null;
+    value?: string | null;
 }
-/** Aplica a mascara dia/mes/ano hora:minuto conforme o usuario digita. */
-export declare function formatarEntradaDataHora(valor: string): string;
-export declare function lerEntradaDataHora(valor: string): CalendarDateTime | undefined;
-export declare function DateTimePicker({ defaultValue, name, disabled, error, hint, id: providedId, isDateUnavailable, label, locale, max, min, step, onValueChange, placeholder, required, size, value, }: DateTimePickerProps): import("react").JSX.Element;
+export declare function DateTimePicker({ 'aria-describedby': ariaDescribedBy, className, defaultValue, name, disabled, error, hint, id: providedId, isDateUnavailable, label, locale, max, min, step, onValueChange, onBlur, onKeyDown, placeholder, required, size, ref, value, ...props }: DateTimePickerProps): import("react").JSX.Element;

package/dist/types/components/forms/Field/FormValue.d.ts

@@ -0,0 +1,13 @@
+export interface FormValueProps {
+    disabled: boolean;
+    name?: string;
+    /** O navegador foca o campo invalido no envio; o foco segue para o controle que a pessoa enxerga. */
+    onFocus: () => void;
+    required: boolean;
+    value: string;
+}
+/**
+ * Leva ao formulario o valor de um campo sem controle nativo por baixo. Oculto quando basta enviar; obrigatorio, vai
+ * num campo que o navegador valida, porque o oculto fica fora da validacao e o envio vazio passava.
+ */
+export declare function FormValue({ disabled, name, onFocus, required, value }: FormValueProps): import("react").JSX.Element | null;

package/dist/types/components/forms/InputNumber/InputNumber.d.ts

@@ -5,4 +5,4 @@ export interface InputNumberProps extends Omit<InputTextProps, 'defaultValue' |
     onValueChange?: (value: string) => void;
     value?: string | number;
 }
-export declare function InputNumber({ decimalScale, defaultValue, onKeyDown, onValueChange, value, ...props }: InputNumberProps): import("react").JSX.Element;
+export declare function InputNumber({ decimalScale, defaultValue, onBlur, onKeyDown, onValueChange, value, ...props }: InputNumberProps): import("react").JSX.Element;

package/dist/types/components/forms/RadioGroup/RadioGroup.d.ts

@@ -5,6 +5,7 @@ interface RadioGroupContexto {
     invalid: boolean;
     name: string;
     onValueChange?: (value: string) => void;
+    required: boolean;
     value?: string;
 }
 declare const RadioGroupContexto: import("react").Context<RadioGroupContexto | null>;
@@ -21,5 +22,5 @@ export interface RadioGroupProps extends Omit<ComponentPropsWithRef<'fieldset'>,
     required?: boolean;
     value?: string;
 }
-export declare function RadioGroup({ children, className, defaultValue, disabled, error, hint, label, name: providedName, onValueChange, required, value, ...props }: RadioGroupProps): import("react").JSX.Element;
+export declare function RadioGroup({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, children, className, defaultValue, disabled, error, hint, label, name: providedName, onValueChange, required, value, ...props }: RadioGroupProps): import("react").JSX.Element;
 export {};

package/dist/types/components/forms/Select/Select.d.ts

@@ -1,15 +1,15 @@
+import { type ComponentPropsWithRef } from 'react';
 export type SelectSize = 'sm' | 'md';
 export interface SelectOption {
     disabled?: boolean;
     label: string;
     value: string;
 }
-export interface SelectProps {
+/** As propriedades nativas vao ao gatilho, que e o controle; o `className` soma ao do sistema. */
+export interface SelectProps extends Omit<ComponentPropsWithRef<'button'>, 'children' | 'defaultValue' | 'name' | 'onChange' | 'type' | 'value'> {
     defaultValue?: string;
-    disabled?: boolean;
     error?: string;
     hint?: string;
-    id?: string;
     label?: string;
     /**
      * Nome do campo no formulario. Com ele, um input oculto carrega o valor para
@@ -23,4 +23,4 @@ export interface SelectProps {
     size?: SelectSize;
     value?: string;
 }
-export declare function Select({ defaultValue, name, disabled, error, hint, id: providedId, label, onValueChange, options, placeholder, required, size, value, }: SelectProps): import("react").JSX.Element;
+export declare function Select({ 'aria-describedby': ariaDescribedBy, className, defaultValue, name, disabled, error, hint, id: providedId, label, onClick, onKeyDown, onValueChange, options, placeholder, ref, required, size, value, ...props }: SelectProps): import("react").JSX.Element;

package/dist/types/components/forms/Switch/Switch.d.ts

@@ -4,4 +4,4 @@ export interface SwitchProps extends Omit<ComponentPropsWithRef<'input'>, 'type'
     hint?: string;
     label: string;
 }
-export declare function Switch({ 'aria-describedby': ariaDescribedBy, className, error, hint, id: providedId, label, ref, ...props }: SwitchProps): import("react").JSX.Element;
+export declare function Switch({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, error, hint, id: providedId, label, ref, ...props }: SwitchProps): import("react").JSX.Element;

package/dist/types/components/forms/TimePicker/TimePicker.d.ts

@@ -1,7 +1,12 @@
-import { Time } from '@internationalized/date';
+import { type ComponentPropsWithRef } from 'react';
 export type TimePickerSize = 'sm' | 'md';
-export interface TimePickerProps {
-    defaultValue?: Time;
+/**
+ * As propriedades nativas vao ao campo de texto, que e o controle; o `className` soma a caixa do campo, que e o que
+ * se posiciona e dimensiona.
+ */
+export interface TimePickerProps extends Omit<ComponentPropsWithRef<'input'>, 'defaultValue' | 'max' | 'min' | 'name' | 'onChange' | 'size' | 'type' | 'value' | 'step'> {
+    /** Hora em `HH:mm`, como no `FormData`: a API nao expoe tipo de biblioteca de terceiros. */
+    defaultValue?: string;
     disabled?: boolean;
     error?: string;
     hint?: string;
@@ -12,10 +17,11 @@ export interface TimePickerProps {
      * o `FormData`: sem controle nativo por baixo, o envio ignorava o campo.
      */
     name?: string;
-    max?: Time;
-    min?: Time;
+    max?: string;
+    min?: string;
     step?: number;
-    onValueChange?: (value?: Time) => void;
+    /** Sem hora inteira e permitida, o valor e `null`, que mantem o campo controlado e vazio. */
+    onValueChange?: (value: string | null) => void;
     placeholder?: string;
     required?: boolean;
     size?: TimePickerSize;
@@ -23,6 +29,6 @@ export interface TimePickerProps {
      * `null` e "controlado e vazio": devolver a propriedade a `undefined` nao
      * limpa o campo, porque ali ele volta a ser nao controlado.
      */
-    value?: Time | null;
+    value?: string | null;
 }
-export declare function TimePicker({ defaultValue, name, disabled, error, hint, id: providedId, label, max, min, step, onValueChange, placeholder, required, size, value, }: TimePickerProps): import("react").JSX.Element;
+export declare function TimePicker({ 'aria-describedby': ariaDescribedBy, className, defaultValue, name, disabled, error, hint, id: providedId, label, max, min, step, onValueChange, onBlur, onKeyDown, placeholder, required, size, ref, value, ...props }: TimePickerProps): import("react").JSX.Element;

package/dist/types/components/forms/TimePicker/TimeSlots.d.ts

@@ -1,5 +1,6 @@
 import { Time } from '@internationalized/date';
 export interface TimeSlotsProps {
+    autoFocus?: boolean;
     baseId: string;
     label?: string;
     max?: Time;
@@ -9,14 +10,8 @@ export interface TimeSlotsProps {
     value?: Time;
 }
 export declare function paraTextoDeHora(hora?: Time): string;
-/** Aplica a mascara hora:minuto conforme o usuario digita. */
-export declare function formatarEntradaHora(valor: string): string;
-/**
- * So devolve a hora quando os quatro digitos foram informados. Aceitar
- * 18:4 como 18:04 fixaria o valor no terceiro digito e impediria completar
- * a dezena do minuto.
- */
-export declare function lerEntradaHora(valor: string): Time | undefined;
+/** A hora digitada respeita os limites que a lista ja respeita. */
+export declare function isTimeAllowed(time: Time, min?: Time, max?: Time): boolean;
 /** Horarios do dia inteiro, do primeiro ao ultimo que couber no passo. */
 export declare function gerarHorarios(step: number, min?: Time, max?: Time): Time[];
-export declare function TimeSlots({ baseId, label, max, min, onChange, step, value }: TimeSlotsProps): import("react").JSX.Element;
+export declare function TimeSlots({ autoFocus, baseId, label, max, min, onChange, step, value }: TimeSlotsProps): import("react").JSX.Element;

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

@@ -3,6 +3,7 @@ export declare function IconArrowDown(props: IconProps): import("react").JSX.Ele
 export declare function IconArrowUp(props: IconProps): import("react").JSX.Element;
 export declare function IconCalendar(props: IconProps): import("react").JSX.Element;
 export declare function IconChevronDown(props: IconProps): import("react").JSX.Element;
+export declare function IconChevronExpand(props: IconProps): import("react").JSX.Element;
 export declare function IconChevronLeft(props: IconProps): import("react").JSX.Element;
 export declare function IconChevronRight(props: IconProps): import("react").JSX.Element;
 export declare function IconChevronUp(props: IconProps): import("react").JSX.Element;
@@ -10,3 +11,4 @@ export declare function IconClock(props: IconProps): import("react").JSX.Element
 export declare function IconClose(props: IconProps): import("react").JSX.Element;
 export declare function IconMinusCircle(props: IconProps): import("react").JSX.Element;
 export declare function IconPlusCircle(props: IconProps): import("react").JSX.Element;
+export declare function IconQuestionCircle(props: IconProps): import("react").JSX.Element;

package/dist/types/components/icons/index.d.ts

@@ -1,2 +1,2 @@
 export type { IconProps } from './Icon.js';
-export { IconArrowDown, IconArrowUp, IconCalendar, IconChevronDown, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconMinusCircle, IconPlusCircle, } from './icons.js';
+export { IconArrowDown, IconArrowUp, IconCalendar, IconChevronDown, IconChevronExpand, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconMinusCircle, IconPlusCircle, IconQuestionCircle, } from './icons.js';