@plenustech/design-system 0.2.1 → 0.2.3

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

@@ -0,0 +1,13 @@
+import type { ChartPoint } from './shapes.js';
+export interface PointLabelPlacement {
+    /** Abaixo do ponto, quando outra serie tem ponto logo acima na mesma categoria. */
+    below: boolean;
+    /** Afastamento horizontal do ponto: nas pontas, o rotulo sai de lado para nao encostar no marcador. */
+    dx: number;
+    textAnchor: 'start' | 'middle' | 'end';
+}
+/**
+ * Onde vai o rotulo de um ponto. Nas pontas ele se alinha para dentro, para nao cobrir os numeros do eixo; e,
+ * quando o rotulo de uma serie alcancaria o ponto de outra logo acima, na mesma categoria, ele desce para baixo do ponto.
+ */
+export declare function pointLabelPlacement(pointsBySeries: readonly (readonly (ChartPoint | null)[])[], series: number, category: number, lineHeight: number, isHidden: (seriesIndex: number) => boolean): PointLabelPlacement;

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

@@ -0,0 +1,49 @@
+import type { ChartFrameProps } from './ChartFrame.js';
+import type { ChartHoveredNode } from './hoverPath.js';
+export type ChartFrameTooltip = NonNullable<ChartFrameProps['tooltip']>;
+export interface CategoryTooltipSeries {
+    /** Formato desta serie, quando difere do grafico, como a do eixo da direita. */
+    format?: (value: number) => string;
+    label: string;
+    values: readonly (number | null)[];
+}
+export interface CategoryTooltipOptions {
+    categories: readonly string[];
+    colors: readonly string[];
+    format: (value: number) => string;
+    /** Categoria sob o ponteiro; `null` deixa o balao sem linhas, e ele nao aparece. */
+    index: number | null;
+    isHidden: (label: string) => boolean;
+    series: readonly CategoryTooltipSeries[];
+    /** Soma das series na ultima linha, para a pilha. */
+    showTotal?: boolean;
+}
+/** Balao dos graficos de categoria: uma linha por serie visivel, com a cor dela e o valor naquela categoria. */
+export declare function categoryTooltip({ categories, colors, format, index, isHidden, series, showTotal, }: CategoryTooltipOptions): ChartFrameTooltip;
+export interface SliceTooltipOptions {
+    colors: readonly string[];
+    formatPercent: (ratio: number) => string;
+    formatValue: (value: number) => string;
+    /** Fatia sob o ponteiro; `null` deixa o balao sem linhas. */
+    index: number | null;
+    slices: readonly {
+        label: string;
+        value: number;
+    }[];
+    /** Soma das fatias ligadas, base da porcentagem. */
+    total: number;
+}
+/** Balao do anel: a fatia sob o ponteiro, com o valor e a parte do total. */
+export declare function sliceTooltip({ colors, formatPercent, formatValue, index, slices, total }: SliceTooltipOptions): ChartFrameTooltip;
+export interface PathTooltipOptions {
+    /** Cor do no sob o ponteiro. */
+    color?: string;
+    format: (value: number) => string;
+    /** Com ele, cada nivel mostra tambem a parte do total. */
+    formatPercent?: (ratio: number) => string;
+    /** Caminho do grupo ate o no; `null` deixa o balao sem linhas. */
+    path: readonly ChartHoveredNode[] | null;
+    total?: number;
+}
+/** Balao dos hierarquicos: uma linha por nivel do caminho, com o no sob o ponteiro em destaque. */
+export declare function pathTooltip({ color, format, formatPercent, path, total }: PathTooltipOptions): ChartFrameTooltip;

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

@@ -0,0 +1,20 @@
+import { type CartesianLayoutOptions, type ChartMargins } from './cartesianLayout.js';
+export interface AxisReveal {
+    onPointerEnter: () => void;
+    onPointerLeave: () => void;
+    revealed: boolean;
+}
+/**
+ * Layout cartesiano com os eixos `onHover`. Sem eles revelados, o desenho ocupa
+ * o espaco todo; revelados, ele encolhe ate as calhas, numa transicao so. Dado
+ * ou tamanho que mudam reposicionam na hora: o que anima e a revelacao.
+ */
+export declare function useCartesianLayout(options: Omit<CartesianLayoutOptions, 'revealed'>): {
+    axisReveal: AxisReveal;
+    margins: ChartMargins;
+    plot: {
+        height: number;
+        width: number;
+    };
+    rotation: import("./cartesianLayout").AxisLabelRotation;
+};

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

@@ -1,10 +1,17 @@
 export interface UseSeriesToggleOptions {
     defaultHiddenSeries?: readonly string[];
     hiddenSeries?: readonly string[];
+    /** Todos os rotulos; com eles, desligar a ultima serie mantem a escala de antes. */
+    labels?: readonly string[];
     onHiddenSeriesChange?: (hidden: readonly string[]) => void;
 }
 export interface SeriesToggle {
     isHidden: (label: string) => boolean;
+    /**
+     * Se a serie fica fora da escala de valores. E o `isHidden` enquanto alguma esta ligada; com todas desligadas
+     * pela legenda, vale o que estava ligado antes da ultima sair, e a escala nao se mexe enquanto ela some.
+     */
+    isOutOfScale: (label: string) => boolean;
     toggle: (label: string) => void;
 }
 /**
@@ -13,4 +20,11 @@ export interface SeriesToggle {
  * secao 6. Trabalha com rotulos porque e o rotulo que a legenda exibe e o que
  * o produto reconhece; indices mudariam de significado ao reordenar as series.
  */
-export declare function useSeriesToggle({ defaultHiddenSeries, hiddenSeries, onHiddenSeriesChange, }: UseSeriesToggleOptions): SeriesToggle;
+export declare function useSeriesToggle({ defaultHiddenSeries, hiddenSeries, labels, onHiddenSeriesChange, }: UseSeriesToggleOptions): SeriesToggle;
+/**
+ * Series que entram na escala de valores, ou todas quando nenhuma entra. Sem isso a escala desabava ao
+ * desligar a ultima, e ela saia esticada para fora do grafico em vez de encolher no lugar.
+ */
+export declare function seriesInScale<T extends {
+    label: string;
+}>(series: readonly T[], isHidden: (label: string) => boolean): readonly T[];

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

@@ -2,10 +2,13 @@ import { type ComponentPropsWithRef, type ReactNode } from 'react';
 export interface AccordionItem {
     content: ReactNode;
     disabled?: boolean;
+    /** Id do cabecalho, para um link de ancora apontar a secao. */
+    id?: string;
     key: string;
     label: string;
 }
 export type AccordionIconPosition = 'left' | 'right';
+export type AccordionHeadingLevel = 2 | 3 | 4 | 5 | 6;
 export interface AccordionProps extends ComponentPropsWithRef<'div'> {
     defaultExpandedKeys?: readonly string[];
     expandedKeys?: readonly string[];
@@ -16,5 +19,7 @@ export interface AccordionProps extends ComponentPropsWithRef<'div'> {
     iconPosition?: AccordionIconPosition;
     /** Divisor entre as secoes, com a folga que ele exige. */
     divider?: boolean;
+    /** Nivel do titulo de cada secao, na hierarquia da pagina em que o acordeao esta. */
+    headingLevel?: AccordionHeadingLevel;
 }
-export declare function Accordion({ className, defaultExpandedKeys, expandedKeys, items, multiple, onExpandedChange, iconPosition, divider, ...props }: AccordionProps): import("react").JSX.Element;
+export declare function Accordion({ className, defaultExpandedKeys, expandedKeys, items, multiple, onExpandedChange, iconPosition, divider, headingLevel, ...props }: AccordionProps): import("react").JSX.Element;

package/dist/types/components/data-display/Accordion/index.d.ts

@@ -1,2 +1,2 @@
 export { Accordion } from './Accordion.js';
-export type { AccordionProps, AccordionItem, AccordionIconPosition } from './Accordion.js';
+export type { AccordionHeadingLevel, AccordionProps, AccordionItem, AccordionIconPosition } from './Accordion.js';

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

@@ -0,0 +1,16 @@
+import { type ComponentPropsWithRef } from 'react';
+import { type CodeSyntax } from './syntax.js';
+export interface CodeBlockProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
+    code: string;
+    copyable?: boolean;
+    fileName?: string;
+    /** Linhas destacadas, contadas a partir de 1. */
+    highlightedLines?: readonly number[];
+    /** Rotulo do cabecalho. Sem ele, vale o nome da sintaxe. */
+    language?: string;
+    lineNumbers?: boolean;
+    /** Linguagem do realce de cores. Sem ela, o codigo sai numa cor so. */
+    syntax?: CodeSyntax;
+    wrap?: boolean;
+}
+export declare function CodeBlock({ className, code, copyable, fileName, highlightedLines, language, lineNumbers, syntax, wrap, ...props }: CodeBlockProps): import("react").JSX.Element;

package/dist/types/components/data-display/CodeBlock/index.d.ts

@@ -0,0 +1,3 @@
+export { CodeBlock } from './CodeBlock.js';
+export type { CodeBlockProps } from './CodeBlock.js';
+export type { CodeSyntax } from './syntax.js';

package/dist/types/components/data-display/CodeBlock/syntax.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Realce de sintaxe por regras lexicas, sem analisador de linguagem: reconhece o
+ * que ajuda a ler o trecho — palavra reservada, texto, numero, comentario,
+ * anotacao, chamada, propriedade, tag e atributo — e deixa o resto sem cor.
+ */
+export type CodeSyntax = 'java' | 'javascript' | 'jsx' | 'typescript' | 'tsx' | 'sql' | 'json' | 'shell';
+export type CodeTokenKind = 'annotation' | 'attribute' | 'comment' | 'function' | 'keyword' | 'number' | 'property' | 'string' | 'tag';
+export interface CodeToken {
+    kind?: CodeTokenKind;
+    text: string;
+}
+export declare const SYNTAX_LABELS: Readonly<Record<CodeSyntax, string>>;
+export declare function tokenize(code: string, syntax: CodeSyntax): CodeToken[];
+/** As linhas do trecho, cada uma com os seus pedacos: o comentario de bloco que atravessa linhas e partido nelas. */
+export declare function tokenizeLines(code: string, syntax?: CodeSyntax): CodeToken[][];

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

@@ -0,0 +1,22 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+export interface SortableListItem {
+    /** Ações da linha, como `ButtonIcon`: alcançadas pelas setas para os lados. */
+    actions?: ReactNode;
+    excerpt?: string;
+    icon?: ReactNode;
+    key: string;
+    /** Nível de aninhamento, a partir de 1. Só recua a linha. */
+    level?: number;
+    title: string;
+}
+export interface SortableListProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onKeyDown'> {
+    defaultSelectedKey?: string;
+    items: readonly SortableListItem[];
+    /** Nome da lista, para o leitor de tela. */
+    label: string;
+    onReorder: (fromIndex: number, toIndex: number) => void;
+    onSelectionChange?: (key: string) => void;
+    /** `null` deixa a lista controlada sem nenhum item escolhido. */
+    selectedKey?: string | null;
+}
+export declare function SortableList({ className, defaultSelectedKey, items, label, onReorder, onSelectionChange, selectedKey, ...props }: SortableListProps): import("react").JSX.Element;

package/dist/types/components/data-display/SortableList/index.d.ts

@@ -0,0 +1,2 @@
+export { SortableList } from './SortableList.js';
+export type { SortableListItem, SortableListProps } from './SortableList.js';

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

@@ -60,10 +60,11 @@ export interface TableColumnProps {
 declare function TableColumn({ align, children, help, hideBelow, id, numeric, sortable, width }: TableColumnProps): import("react").JSX.Element;
 export interface TableBodyProps<T extends TableRowItem> {
     children: (item: T) => ReactNode;
-    empty?: ReactNode;
+    emptyDescription?: string;
+    emptyTitle?: string;
     items: readonly T[];
 }
-declare function TableBody<T extends TableRowItem>({ children, empty, items }: TableBodyProps<T>): import("react").JSX.Element;
+declare function TableBody<T extends TableRowItem>({ children, emptyDescription, emptyTitle, items, }: TableBodyProps<T>): import("react").JSX.Element;
 export interface TableRowProps {
     children: ReactNode;
     disabled?: boolean;
@@ -71,6 +72,7 @@ export interface TableRowProps {
     label?: string;
 }
 declare function TableRow({ children, disabled, id, label }: TableRowProps): import("react").JSX.Element;
+/** Sem valor proprio, `align`, `hideBelow` e `numeric` seguem a coluna da mesma posicao no cabecalho. */
 export interface TableCellProps {
     align?: TableAlign;
     children?: ReactNode;

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

@@ -0,0 +1,13 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+export type TagSize = 'sm' | 'md';
+export interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'> {
+    children: ReactNode;
+    disabled?: boolean;
+    /** Mostra o botao de remover, nomeado como "Remover" seguido do texto da etiqueta. */
+    onRemove?: () => void;
+    /** Com `selected`, a etiqueta vira um botao de alternar, como o filtro que se liga e desliga. */
+    onSelectedChange?: (selected: boolean) => void;
+    selected?: boolean;
+    size?: TagSize;
+}
+export declare function Tag({ children, className, disabled, onRemove, onSelectedChange, selected, size, ...props }: TagProps): import("react").JSX.Element;

package/dist/types/components/data-display/Tag/index.d.ts

@@ -0,0 +1,2 @@
+export { Tag } from './Tag.js';
+export type { TagProps, TagSize } from './Tag.js';

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

@@ -0,0 +1,15 @@
+import type { ComponentPropsWithRef } from 'react';
+export interface TimelineItem {
+    date?: string;
+    description?: string;
+    key: string;
+    label: string;
+}
+export interface TimelineProps extends Omit<ComponentPropsWithRef<'ol'>, 'children'> {
+    /** Chave do estado atual. Os anteriores contam como concluídos, os seguintes como por vir. */
+    current: string;
+    items: readonly TimelineItem[];
+    /** Nome da lista, para o leitor de tela. */
+    label: string;
+}
+export declare function Timeline({ className, current, items, label, ...props }: TimelineProps): import("react").JSX.Element;

package/dist/types/components/data-display/Timeline/index.d.ts

@@ -0,0 +1,2 @@
+export { Timeline } from './Timeline.js';
+export type { TimelineItem, TimelineProps } from './Timeline.js';

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

@@ -0,0 +1,14 @@
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+export type EmptyStateSize = 'sm' | 'md' | 'lg';
+export type EmptyStateTone = 'neutral' | 'danger';
+export interface EmptyStateProps extends Omit<ComponentPropsWithRef<'div'>, 'title'> {
+    /** Uma ou duas acoes: a secundaria antes da principal. */
+    actions?: ReactNode;
+    description?: ReactNode;
+    /** Sem icone proprio, a lupa. */
+    icon?: ReactNode;
+    size?: EmptyStateSize;
+    title: ReactNode;
+    tone?: EmptyStateTone;
+}
+export declare function EmptyState({ actions, className, description, icon, size, title, tone, ...props }: EmptyStateProps): import("react").JSX.Element;

package/dist/types/components/feedback/EmptyState/index.d.ts

@@ -0,0 +1,2 @@
+export { EmptyState } from './EmptyState.js';
+export type { EmptyStateProps, EmptyStateSize, EmptyStateTone } from './EmptyState.js';

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

@@ -0,0 +1,13 @@
+import type { HTMLAttributes } from 'react';
+export type SkeletonShape = 'line' | 'circle' | 'block';
+export interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Numero em pixels ou qualquer medida CSS. Sem altura, cada forma tem a sua: linha de texto, avatar ou bloco. */
+    height?: number | string;
+    shape?: SkeletonShape;
+    width?: number | string;
+}
+/**
+ * Lugar de um conteudo que ainda carrega. E decorativo e fica fora da leitura:
+ * quem envolve os esqueletos anuncia o carregamento, com `aria-busy` ou uma mensagem de status.
+ */
+export declare function Skeleton({ className, height, shape, style, width, ...props }: SkeletonProps): import("react").JSX.Element;

package/dist/types/components/feedback/Skeleton/index.d.ts

@@ -0,0 +1,2 @@
+export { Skeleton } from './Skeleton.js';
+export type { SkeletonProps, SkeletonShape } from './Skeleton.js';

package/dist/types/components/feedback/Toast/ToastRegion.d.ts

@@ -0,0 +1,2 @@
+/** Canto onde os avisos de `showToast` aparecem. Montado uma vez, na raiz da aplicacao. */
+export declare function ToastRegion(): import("react").JSX.Element;

package/dist/types/components/feedback/Toast/index.d.ts

@@ -0,0 +1,3 @@
+export { ToastRegion } from './ToastRegion.js';
+export { dismissToast, showToast } from './toastStore.js';
+export type { ToastAction, ToastOptions, ToastTone } from './toastStore.js';

package/dist/types/components/feedback/Toast/toastStore.d.ts

@@ -0,0 +1,24 @@
+import type { AlertTone } from '../Alert/index.js';
+export type ToastTone = AlertTone;
+export interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ToastOptions {
+    /** Botao unico de acao, como tentar de novo. Acionar fecha o aviso. */
+    action?: ToastAction;
+    description?: string;
+    /** Milissegundos ate sumir. `null` mantem ate a pessoa fechar; o padrao e 6s, e o erro fica. */
+    duration?: number | null;
+    title: string;
+    tone?: ToastTone;
+}
+export interface ToastEntry extends ToastOptions {
+    id: string;
+}
+/** Mostra um aviso no `ToastRegion` da pagina e devolve o id para fecha-lo antes do tempo. */
+export declare function showToast(options: ToastOptions): string;
+export declare function dismissToast(id: string): void;
+export declare function subscribeToasts(listener: () => void): () => void;
+export declare function getToasts(): ToastEntry[];
+export declare function getServerToasts(): ToastEntry[];

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

@@ -0,0 +1,28 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+interface CheckboxGroupContextValue {
+    disabled: boolean;
+    invalid: boolean;
+    name: string;
+    required: boolean;
+    toggle: (value: string, checked: boolean) => void;
+    values: readonly string[];
+}
+/** O `Checkbox` com `value` dentro de um grupo lê daqui o estado; fora dele, segue solto. */
+export declare function useCheckboxGroup(): CheckboxGroupContextValue | null;
+export type CheckboxGroupOrientation = 'vertical' | 'horizontal';
+export interface CheckboxGroupProps extends Omit<ComponentPropsWithRef<'fieldset'>, 'defaultValue' | 'onChange'> {
+    children: ReactNode;
+    defaultValue?: readonly string[];
+    disabled?: boolean;
+    error?: string;
+    hint?: string;
+    label: string;
+    name?: string;
+    onValueChange?: (values: string[]) => void;
+    orientation?: CheckboxGroupOrientation;
+    /** Exige ao menos uma caixa marcada no envio. */
+    required?: boolean;
+    value?: readonly string[];
+}
+export declare function CheckboxGroup({ 'aria-describedby': ariaDescribedBy, children, className, defaultValue, disabled, error, hint, label, name: providedName, onValueChange, orientation, ref, required, value, ...props }: CheckboxGroupProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,2 @@
+export { CheckboxGroup } from './CheckboxGroup.js';
+export type { CheckboxGroupOrientation, CheckboxGroupProps } from './CheckboxGroup.js';

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

@@ -0,0 +1,26 @@
+import { type ComponentPropsWithRef } from 'react';
+export interface ColorPickerOption {
+    /** Qualquer cor do CSS; é só o desenho da amostra. */
+    color: string;
+    /** Nome da cor: é o que o leitor de tela anuncia e o que aparece como dica. */
+    label: string;
+    value: string;
+}
+export type ColorPickerSize = 'sm' | 'md';
+export interface ColorPickerProps extends Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
+    /** Primeira amostra, que significa sem cor: escolhida, o valor é `null`. */
+    defaultOption?: {
+        label?: string;
+    };
+    defaultValue?: string | null;
+    disabled?: boolean;
+    /** Nome do grupo, para o leitor de tela. */
+    label: string;
+    name?: string;
+    onValueChange?: (value: string | null) => void;
+    options: readonly ColorPickerOption[];
+    size?: ColorPickerSize;
+    value?: string | null;
+}
+/** Escolha de cor por amostras. Por baixo são rádios nativos: setas, Tab e formulário vêm do navegador. */
+export declare function ColorPicker({ className, defaultOption, defaultValue, disabled, label, name: providedName, onValueChange, options, size, value, ...props }: ColorPickerProps): import("react").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { ColorPicker } from './ColorPicker.js';
+export type { ColorPickerOption, ColorPickerProps, ColorPickerSize } from './ColorPicker.js';

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

@@ -1,7 +1,10 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
+export type FieldSize = 'sm' | 'md';
 export interface FieldWiring {
-    id: string;
+    /** O visual dos campos do sistema para o controle — borda, foco, erro e tamanho. A classe do controle vence a dele. */
+    className: string;
     describedBy: string | undefined;
+    id: string;
     invalid: boolean;
 }
 export interface FieldProps extends Omit<ComponentPropsWithRef<'div'>, 'children'> {
@@ -15,5 +18,6 @@ export interface FieldProps extends Omit<ComponentPropsWithRef<'div'>, 'children
     maxLength?: number;
     required?: boolean;
     showCharacterCount?: boolean;
+    size?: FieldSize;
 }
-export declare function Field({ 'aria-describedby': ariaDescribedBy, className, characterCount, children, error, hint, id: providedId, label, maxLength, required, showCharacterCount, ...props }: FieldProps): import("react").JSX.Element;
+export declare function Field({ 'aria-describedby': ariaDescribedBy, className, characterCount, children, error, hint, id: providedId, label, maxLength, required, showCharacterCount, size, ...props }: FieldProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 export { Field } from './Field.js';
-export type { FieldProps, FieldWiring } from './Field.js';
+export type { FieldProps, FieldSize, FieldWiring } from './Field.js';

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

@@ -0,0 +1,37 @@
+import { type ComponentPropsWithRef } from 'react';
+export type FileRejectionReason = 'type' | 'size';
+export interface FileRejection {
+    file: File;
+    reason: FileRejectionReason;
+}
+export type FileUploadStatus = 'uploading' | 'done' | 'error';
+/** Um arquivo em envio. Quem envia e o produto: ele monta a lista e informa o progresso. */
+export interface FileUploadItem {
+    error?: string;
+    id: string;
+    name: string;
+    /** De 0 a 100. Sem ele, o progresso e indeterminado. */
+    progress?: number;
+    size: number;
+    status: FileUploadStatus;
+}
+export interface FileUploadProps extends Omit<ComponentPropsWithRef<'div'>, 'children' | 'onDrop'> {
+    /** Os tipos aceitos, como no `<input type="file">`: `.pdf,image/*`. */
+    accept?: string;
+    disabled?: boolean;
+    /** Vence a mensagem de recusa do proprio campo. */
+    error?: string;
+    hint?: string;
+    items?: readonly FileUploadItem[];
+    label: string;
+    /** Limite por arquivo, em bytes. */
+    maxSize?: number;
+    multiple?: boolean;
+    onCancel?: (id: string) => void;
+    /** Recebe so os arquivos aceitos. */
+    onFilesSelected: (files: File[]) => void;
+    onFilesRejected?: (rejections: FileRejection[]) => void;
+    onRemove?: (id: string) => void;
+    onRetry?: (id: string) => void;
+}
+export declare function FileUpload({ accept, className, disabled, error, hint, id, items, label, maxSize, multiple, onCancel, onFilesRejected, onFilesSelected, onRemove, onRetry, ...props }: FileUploadProps): import("react").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { FileUpload } from './FileUpload.js';
+export type { FileRejection, FileRejectionReason, FileUploadItem, FileUploadProps, FileUploadStatus, } from './FileUpload.js';

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

@@ -1,10 +1,12 @@
-import { type ComponentPropsWithRef } from 'react';
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
 export type InputTextSize = 'sm' | 'md';
 export interface InputTextProps extends Omit<ComponentPropsWithRef<'input'>, 'size'> {
     error?: string;
     hint?: string;
+    /** Icone decorativo a frente do texto, como a lupa de uma busca. O nome do campo continua no `label`. */
+    icon?: ReactNode;
     label?: string;
     size?: InputTextSize;
     showCharacterCount?: boolean;
 }
-export declare function InputText({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, error, hint, id: providedId, label, maxLength, required, size, showCharacterCount, defaultValue, onChange, value, ref, ...props }: InputTextProps): import("react").JSX.Element;
+export declare function InputText({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, error, hint, icon, id: providedId, label, maxLength, required, size, showCharacterCount, defaultValue, onChange, value, ref, ...props }: InputTextProps): import("react").JSX.Element;

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

@@ -0,0 +1,23 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+export interface SegmentedControlItem {
+    disabled?: boolean;
+    icon?: ReactNode;
+    label: string;
+    value: string;
+}
+export type SegmentedControlSize = 'sm' | 'md';
+export interface SegmentedControlProps extends Omit<ComponentPropsWithRef<'div'>, 'defaultValue' | 'onChange'> {
+    defaultValue?: string;
+    disabled?: boolean;
+    /** Mostra so os icones; o `label` de cada item continua sendo o nome e aparece como dica. */
+    iconOnly?: boolean;
+    items: readonly SegmentedControlItem[];
+    /** Nome do grupo, para o leitor de tela. */
+    label: string;
+    name?: string;
+    onValueChange?: (value: string) => void;
+    size?: SegmentedControlSize;
+    value?: string;
+}
+/** Escolha unica em poucos segmentos lado a lado. Por baixo sao radios nativos: setas, Tab e formulario vem do navegador. */
+export declare function SegmentedControl({ className, defaultValue, disabled, iconOnly, items, label, name: providedName, onValueChange, size, value, ...props }: SegmentedControlProps): import("react").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SegmentedControl } from './SegmentedControl.js';
+export type { SegmentedControlItem, SegmentedControlProps, SegmentedControlSize } from './SegmentedControl.js';

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

@@ -2,6 +2,9 @@ import { type IconProps } from './Icon.js';
 export declare function IconArrowDown(props: IconProps): import("react").JSX.Element;
 export declare function IconArrowUp(props: IconProps): import("react").JSX.Element;
 export declare function IconCalendar(props: IconProps): import("react").JSX.Element;
+export declare function IconChartBar(props: IconProps): import("react").JSX.Element;
+export declare function IconCheck(props: IconProps): import("react").JSX.Element;
+export declare function IconCheckCircle(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;
@@ -9,6 +12,34 @@ export declare function IconChevronRight(props: IconProps): import("react").JSX.
 export declare function IconChevronUp(props: IconProps): import("react").JSX.Element;
 export declare function IconClock(props: IconProps): import("react").JSX.Element;
 export declare function IconClose(props: IconProps): import("react").JSX.Element;
+export declare function IconExclamationCircle(props: IconProps): import("react").JSX.Element;
+export declare function IconExclamationTriangle(props: IconProps): import("react").JSX.Element;
+export declare function IconInfoCircle(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 IconSearch(props: IconProps): import("react").JSX.Element;
 export declare function IconQuestionCircle(props: IconProps): import("react").JSX.Element;
+export declare function IconAlignCenter(props: IconProps): import("react").JSX.Element;
+export declare function IconAlignLeft(props: IconProps): import("react").JSX.Element;
+export declare function IconAlignRight(props: IconProps): import("react").JSX.Element;
+export declare function IconDesktop(props: IconProps): import("react").JSX.Element;
+export declare function IconDragHandle(props: IconProps): import("react").JSX.Element;
+export declare function IconExternalLink(props: IconProps): import("react").JSX.Element;
+export declare function IconEye(props: IconProps): import("react").JSX.Element;
+export declare function IconFile(props: IconProps): import("react").JSX.Element;
+export declare function IconFilter(props: IconProps): import("react").JSX.Element;
+export declare function IconLightning(props: IconProps): import("react").JSX.Element;
+export declare function IconLink(props: IconProps): import("react").JSX.Element;
+export declare function IconMobile(props: IconProps): import("react").JSX.Element;
+export declare function IconMore(props: IconProps): import("react").JSX.Element;
+export declare function IconPencil(props: IconProps): import("react").JSX.Element;
+export declare function IconPlus(props: IconProps): import("react").JSX.Element;
+export declare function IconRedo(props: IconProps): import("react").JSX.Element;
+export declare function IconSidebar(props: IconProps): import("react").JSX.Element;
+export declare function IconStructure(props: IconProps): import("react").JSX.Element;
+export declare function IconTablet(props: IconProps): import("react").JSX.Element;
+export declare function IconTrash(props: IconProps): import("react").JSX.Element;
+export declare function IconUndo(props: IconProps): import("react").JSX.Element;
+export declare function IconUpload(props: IconProps): import("react").JSX.Element;
+export declare function IconBold(props: IconProps): import("react").JSX.Element;
+export declare function IconItalic(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, IconChevronExpand, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconMinusCircle, IconPlusCircle, IconQuestionCircle, } from './icons.js';
+export { IconAlignCenter, IconAlignLeft, IconAlignRight, IconArrowDown, IconArrowUp, IconBold, IconCalendar, IconChartBar, IconCheck, IconCheckCircle, IconChevronDown, IconChevronExpand, IconChevronLeft, IconChevronRight, IconChevronUp, IconClock, IconClose, IconDesktop, IconDragHandle, IconExclamationCircle, IconExclamationTriangle, IconExternalLink, IconEye, IconFile, IconFilter, IconInfoCircle, IconItalic, IconLightning, IconLink, IconMinusCircle, IconMobile, IconMore, IconPencil, IconPlus, IconPlusCircle, IconQuestionCircle, IconRedo, IconSearch, IconSidebar, IconStructure, IconTablet, IconTrash, IconUndo, IconUpload, } from './icons.js';

package/dist/types/components/navigation/SkipLink/SkipLink.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentPropsWithRef } from 'react';
+export interface SkipLinkProps extends ComponentPropsWithRef<'a'> {
+    /** Ancora do conteudo principal, como `#conteudo`. */
+    href: string;
+}
+/** Primeiro item da pagina para quem navega por teclado: some ate receber foco e leva direto ao conteudo. */
+export declare function SkipLink({ children, className, ...props }: SkipLinkProps): import("react").JSX.Element;

package/dist/types/components/navigation/SkipLink/index.d.ts

@@ -0,0 +1,2 @@
+export { SkipLink } from './SkipLink.js';
+export type { SkipLinkProps } from './SkipLink.js';

package/dist/types/components/navigation/Steps/Steps.d.ts

@@ -0,0 +1,16 @@
+import type { ComponentPropsWithRef } from 'react';
+export interface StepItem {
+    description?: string;
+    key: string;
+    label: string;
+}
+export interface StepsProps extends Omit<ComponentPropsWithRef<'nav'>, 'children'> {
+    /** Chave da etapa atual. As anteriores contam como concluidas, as seguintes como por vir. */
+    current: string;
+    items: readonly StepItem[];
+    /** Nome da navegacao, para o leitor de tela. */
+    label: string;
+    /** Com ela, cada etapa vira um botao, para quem pode ir e voltar livremente. */
+    onStepChange?: (key: string) => void;
+}
+export declare function Steps({ className, current, items, label, onStepChange, ...props }: StepsProps): import("react").JSX.Element;

package/dist/types/components/navigation/Steps/index.d.ts

@@ -0,0 +1,2 @@
+export { Steps } from './Steps.js';
+export type { StepItem, StepsProps } from './Steps.js';