@humu-tech/ui 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -155,6 +155,24 @@ export function ClienteForm() {
155
155
  }
156
156
  ```
157
157
 
158
+ ### Campos em grade
159
+
160
+ Os campos (`Input`, `MaskedInput` e os derivados, como `CepInput`, `MoneyInput`, `PhoneInput`, `DocumentInput`, `PasswordInput` e `PercentInput`) têm duas props de classe:
161
+
162
+ | Prop | Onde aplica | Use para |
163
+ | --- | --- | --- |
164
+ | `containerClassName` | Bloco externo do campo (rótulo, caixa e mensagens), que é o item da grade | `col-span-*`, `row-span-*`, largura na grade |
165
+ | `className` | Caixa do campo | Ajustes visuais da caixa |
166
+
167
+ ```tsx
168
+ <div className="grid grid-cols-1 gap-3 sm:grid-cols-2">
169
+ <CepInput label="CEP" />
170
+ <Input label="Logradouro" containerClassName="sm:col-span-2" />
171
+ <Input label="Número" />
172
+ <Input label="Complemento" />
173
+ </div>
174
+ ```
175
+
158
176
  ### Ícones
159
177
 
160
178
  A lib usa [`lucide-react`](https://lucide.dev/icons/). Os componentes recebem o ícone como `ReactNode` (`leftIcon`, `rightIcon` e `icon` do `Button`, por exemplo). Para usar ícones no app, instale o pacote:
@@ -179,8 +197,9 @@ O preset gera classes Tailwind a partir dos tokens, com o prefixo `humu-`. Use e
179
197
  | Grupo | Exemplos |
180
198
  | --- | --- |
181
199
  | Fundo | `bg-humu-background-base`, `bg-humu-background-surface`, `bg-humu-background-brand-brand` |
182
- | Texto | `text-humu-content-title`, `text-humu-content-subtitle`, `text-humu-content-body-text`, `text-humu-content-brand` |
200
+ | Texto | `text-humu-content-title`, `text-humu-content-subtitle`, `text-humu-content-body-text`, `text-humu-content-brand`, `text-humu-content-brand-strong` (texto de destaque da marca: Carvão no claro, verde da marca no escuro) |
183
201
  | Borda | `border-humu-background-border`, `border-humu-border-default`, `border-humu-border-brand` |
202
+ | Foco | `ring-humu-focus`, `outline-humu-focus` (indicador de foco com 3:1 sobre os fundos nos dois temas; use sólido, sem opacidade) |
184
203
  | Status | `bg-humu-status-background-success-subtle`, `text-humu-status-content-error` |
185
204
  | Paleta | `bg-humu-brand-500`, `text-humu-grey-700` (escalas `grey`, `brand`, `turtle`, `purple`, `green`, `yellow`, `red`, `blue`, de 50 a 950) |
186
205
  | Gráfico | `fill-humu-chart-1` a `fill-humu-chart-8` |
@@ -273,7 +292,7 @@ Tudo é exportado da raiz: `import { X } from '@humu-tech/ui'`. Exemplos e props
273
292
 
274
293
  | Grupo | Componentes |
275
294
  | --- | --- |
276
- | **Formulário** | `Button` `Checkbox` `CepInput` `ColorPicker` `Combobox` `DateInput` `DateRangeInput` `DocumentInput` `DocumentUploadCard` `FileUpload` `ImageUpload` `Input` `Label` `MaskedInput` `MoneyInput` `MultiCombobox` `OtpInput` `PasswordInput` `PercentInput` `PhoneInput` `RadioGroup` `SelectableCard` `Switch` `TextArea` `TitleSelect` `ToggleChip` |
295
+ | **Formulário** | `Button` `Checkbox` `CepInput` `ColorPicker` `Combobox` `DateInput` `DateRangeInput` `DocumentInput` `DocumentUploadCard` `FileUpload` `FileViewCard` `ImageUpload` `Input` `Label` `MaskedInput` `MoneyInput` `MultiCombobox` `OtpInput` `PasswordInput` `PercentInput` `PhoneInput` `RadioGroup` `SelectableCard` `Switch` `TextArea` `TitleSelect` `ToggleChip` |
277
296
  | **Overlays e menus** | `ConfirmDialog` `ContextMenu` `Dialog` `Drawer` `Dropdown` `FilePreviewDialog` `Popover` `Tooltip` |
278
297
  | **Exibição de dados** | `Avatar` `Badge` `Box` `Card` `ContentCard` `CopyButton` `FieldsCard` `FileInfoCard` `FilePreviewContent` `FileThumbnail` `Heading` `Logo` `Skeleton` `Sparkline` `SparklineBadge` `Text` |
279
298
  | **Navegação e layout** | `Breadcrumb` `Separator` `Stepper` `Tabs` |
@@ -284,7 +303,7 @@ Tudo é exportado da raiz: `import { X } from '@humu-tech/ui'`. Exemplos e props
284
303
 
285
304
  | Grupo | Componentes |
286
305
  | --- | --- |
287
- | **Formulário** | `FilterBar` `FormSection` `FormWithAside` `WizardShell` |
306
+ | **Formulário** | `FilterBar` `FilterToolbar` `FormSection` `FormWithAside` `WizardShell` |
288
307
  | **Exibição de dados** | `DataField` `DataTable` (com `DataTableTextCell`, `DataTableLinkCell`, `DataTableDocumentCell` e `DataTableActionButton`) `DataTablePagination` `EmptyState` `LegalDocumentRenderer` `PanelCard` `ReadOnlyDataView` `SectionCard` `SortableColumnHeader` `Timeline` (com `TimelineItem`, `TimelineDaySeparator` e `TimelineSection`) `TutorialCard` |
289
308
  | **Navegação e layout** | `AppShell` `ErrorPageLayout` `NavigatorTile` `NavigatorTileGrid` `PageTitle` `PublicPageLayout` `Sidebar` `Topbar` (com `TopbarIconButton` e `TopbarSearchButton`) |
290
309
  | **Gráficos e indicadores** | `ChartTimeSeries` `DonutChart` `HorizontalBarChart` `KpiCard` `KpiHero` `LineChart` `StackedBarChart` |
@@ -294,6 +313,43 @@ Tudo é exportado da raiz: `import { X } from '@humu-tech/ui'`. Exemplos e props
294
313
 
295
314
  `cn` (junta classes e resolve conflitos do Tailwind, incluindo as `humu-*`), `DefaultLink`, `SuspenseSkeleton`, `isMacOS`, `getShortcutLabel`, `getShortcutKeys`, `isImageFile` e `isPdfFile`. Os componentes exportam também o tipo das props (`ButtonProps`, `DataTableProps` etc.).
296
315
 
316
+ ## Migrando da 0.2.x
317
+
318
+ A 0.3.0 alinha a lib com a revisão do Figma de 04/11, corrige contraste e padroniza movimento, foco e estados. O detalhe está no [CHANGELOG](https://github.com/Inovanti-Bank/humu-ui/blob/main/packages/react/CHANGELOG.md#030). O que pede ação de quem consome:
319
+
320
+ 1. **Suba com versão exata e confira as telas.**
321
+
322
+ ```bash
323
+ npm install @humu-tech/ui@0.3.0 --save-exact
324
+ ```
325
+
326
+ 2. **`Combobox` e `MultiCombobox` foram refeitos.** A busca acontece no próprio campo, que agora é um `input` com `role="combobox"`:
327
+ - a `ref` aponta para o `input` (antes era um `button`); `focus()` continua funcionando;
328
+ - em testes, o valor escolhido é lido com `toHaveValue(...)` ou `getByDisplayValue(...)`, não mais com `toHaveTextContent(...)`; o placeholder com `getByPlaceholderText(...)`;
329
+ - o botão "Limpar seleção" fica ao lado do `input`, não dentro dele;
330
+ - o texto padrão de `emptyMessage` passou a ser "Nenhum resultado encontrado";
331
+ - no `MultiCombobox`, o indicador padrão da lista é o check à direita; para caixas de seleção, use `selectionIndicator="checkbox"`.
332
+
333
+ 3. **`Drawer.Footer` e `Dialog.Footer`**: como no Figma, as ações ficam todas à direita, com 16px entre elas (Cancelar e depois a ação principal). O `Drawer.Footer` tem a prop `status` para um texto acima delas. Quem forçava `sm:!justify-between` ou separava as ações pode tirar a classe.
334
+
335
+ 4. **Tamanhos do Figma**: campos com 52px no tamanho padrão (`md` igual a `lg`), bordas de 1.5px em campos, `Checkbox` e `Radio`, botões do `ConfirmDialog` com 44px e área do `FileUpload` com 152px. Revise layouts com altura fixa.
336
+
337
+ 5. **`Badge` abraça o conteúdo** (`w-fit`). Quem passava `w-fit` pode tirar a classe.
338
+
339
+ 6. **Filtros**: o gatilho do `FilterBar` passa a ser o chip "Filtros avançados", com a contagem ao lado. O novo `FilterToolbar` monta a barra das listagens com o `FilterBar` e os `ToggleChip` de filtros rápidos como filhos. Quem usa `hideTrigger` não é afetado.
340
+
341
+ 7. **Arquivo enviado**: `FileUpload` (com `label` e um arquivo) e `DocumentUploadCard` (tamanho padrão) mostram o arquivo na variante View do Figma, com "Trocar arquivo" e "Excluir arquivo". O nome acessível do botão de excluir passa a conter o texto visível ("Excluir arquivo (rótulo)"). A versão `compact` não muda.
342
+
343
+ 8. **Animações no preset**: o `tailwindcss-animate` passou a ser dependência da lib e está no preset, então o app pode tirá-lo do próprio `tailwind.config`. Os keyframes `slideDownAndFade`, `slideLeftAndFade`, `slideUpAndFade`, `slideRightAndFade`, `slideIn` e `slideOut` saíram do preset; quem os usa precisa declará-los no próprio config.
344
+
345
+ 9. **Visual que pode mudar seletores ou capturas**: `Checkbox` desabilitado com 50% de opacidade, `Toast` sem sombra, foco com contorno único (`outline-humu-focus`) e um só hover neutro em listas, linhas de tabela e botões de ícone. No `CommandPalette`, o item realçado continua na cor da marca e o ícone à direita (`meta`) passa a ter 18px.
346
+
347
+ 10. **Campos em grade**: `col-span-*` passado em `className` de um campo nunca chegou à grade, porque o `className` estiliza a caixa. Use a nova prop `containerClassName` (veja [Campos em grade](#campos-em-grade)).
348
+
349
+ 11. **Arquivos como no Figma**: o novo `FileViewCard` é o componente **View files** (`size="sm"` em linha, `size="lg"` em cartão), com "Ver arquivo", selo de status e campos extras. O `DocumentUploadCard` mostra o arquivo já enviado com ele (Large no tamanho padrão, Small no `compact`, só com o ícone de arquivo no lugar da miniatura) e aceita `sent.status`, `sent.fields` e `viewText`. O `FileUpload` ganha a variante **View no name** (`showFileInfo={false}`), e o `ImageUpload` passa a usar o mesmo cartão: área de envio do Figma vazia e, com imagem, miniatura de 100px com "Trocar arquivo" e "Excluir arquivo" empilhados.
350
+
351
+ 12. **Títulos de cartão em 20px negrito**: `Card.Title` passa de 16px seminegrito para 20px negrito, como o "Card title" do Figma, igual a `SectionCard`, `PanelCard` e `FormSection`.
352
+
297
353
  ## Migrando da 0.1.x
298
354
 
299
355
  A 0.2.0 traz o novo layout do Figma. Os nomes exportados continuam os mesmos, exceto os do tema. O resumo abaixo é o que pede ação de quem consome; o detalhe está no [CHANGELOG](https://github.com/Inovanti-Bank/humu-ui/blob/main/packages/react/CHANGELOG.md#020).
@@ -32,7 +32,7 @@
32
32
  }
33
33
 
34
34
  .rdp-humu .rdp-day_button:focus-visible {
35
- outline: 2px solid var(--humu-background-brand-brand);
35
+ outline: 2px solid var(--humu-focus-ring);
36
36
  outline-offset: 1px;
37
37
  }
38
38
 
@@ -64,7 +64,7 @@
64
64
  border-radius: 9999px;
65
65
  background-color: transparent;
66
66
  color: var(--humu-content-title);
67
- transition: background-color 120ms ease;
67
+ transition: background-color var(--humu-duration-fast) var(--humu-easing-in-out);
68
68
  }
69
69
 
70
70
  .rdp-humu .rdp-button_previous:not([aria-disabled='true']):hover,
@@ -74,7 +74,7 @@
74
74
 
75
75
  .rdp-humu .rdp-button_previous:focus-visible,
76
76
  .rdp-humu .rdp-button_next:focus-visible {
77
- outline: 2px solid var(--humu-background-brand-brand);
77
+ outline: 2px solid var(--humu-focus-ring);
78
78
  outline-offset: 1px;
79
79
  }
80
80
 
@@ -103,3 +103,10 @@
103
103
  border: none;
104
104
  font-weight: 600;
105
105
  }
106
+
107
+ @media (prefers-reduced-motion: reduce) {
108
+ .rdp-humu .rdp-button_previous,
109
+ .rdp-humu .rdp-button_next {
110
+ transition: none;
111
+ }
112
+ }
@@ -49,7 +49,7 @@
49
49
  }
50
50
 
51
51
  .rdp-humu-range .rdp-day_button:focus-visible {
52
- outline: 2px solid var(--humu-background-brand-brand);
52
+ outline: 2px solid var(--humu-focus-ring);
53
53
  outline-offset: 1px;
54
54
  }
55
55
 
@@ -113,7 +113,7 @@
113
113
  border-radius: 9999px;
114
114
  background-color: var(--humu-background-surface);
115
115
  color: var(--humu-content-title);
116
- transition: background-color 120ms ease;
116
+ transition: background-color var(--humu-duration-fast) var(--humu-easing-in-out);
117
117
  }
118
118
 
119
119
  .rdp-humu-range .rdp-button_previous:not([aria-disabled='true']):hover,
@@ -123,7 +123,7 @@
123
123
 
124
124
  .rdp-humu-range .rdp-button_previous:focus-visible,
125
125
  .rdp-humu-range .rdp-button_next:focus-visible {
126
- outline: 2px solid var(--humu-background-brand-brand);
126
+ outline: 2px solid var(--humu-focus-ring);
127
127
  outline-offset: 1px;
128
128
  }
129
129
 
@@ -141,3 +141,10 @@
141
141
  .rdp-humu-range .rdp-selected {
142
142
  font-size: inherit;
143
143
  }
144
+
145
+ @media (prefers-reduced-motion: reduce) {
146
+ .rdp-humu-range .rdp-button_previous,
147
+ .rdp-humu-range .rdp-button_next {
148
+ transition: none;
149
+ }
150
+ }
package/dist/index.d.mts CHANGED
@@ -172,6 +172,7 @@ declare const MaskedInput: react.ForwardRefExoticComponent<Omit<react.InputHTMLA
172
172
  floating?: boolean;
173
173
  size?: "sm" | "md" | "lg";
174
174
  surface?: "light" | "dark";
175
+ containerClassName?: string;
175
176
  normalizeRaw?: (raw: string) => string;
176
177
  } & react.RefAttributes<HTMLInputElement>>;
177
178
 
@@ -185,6 +186,7 @@ type MaskedInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'o
185
186
  floating?: boolean;
186
187
  size?: 'sm' | 'md' | 'lg';
187
188
  surface?: 'light' | 'dark';
189
+ containerClassName?: string;
188
190
  normalizeRaw?: (raw: string) => string;
189
191
  };
190
192
 
@@ -224,7 +226,19 @@ type ComboboxItem = {
224
226
  description?: string;
225
227
  disabled?: boolean;
226
228
  };
227
- type ComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange'> & {
229
+ type ComboboxSelectionIndicator = 'check' | 'checkbox' | 'radio';
230
+ type ComboboxListAction = {
231
+ label: string;
232
+ icon?: ReactNode;
233
+ onClick: () => void;
234
+ };
235
+ type ComboboxRenderItemState = {
236
+ selected: boolean;
237
+ highlighted: boolean;
238
+ disabled: boolean;
239
+ };
240
+ type ComboboxRenderItem = (item: ComboboxItem, state: ComboboxRenderItemState) => ReactNode;
241
+ type ComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange' | 'defaultValue'> & {
228
242
  items: ComboboxItem[];
229
243
  value?: string;
230
244
  defaultValue?: string;
@@ -238,11 +252,22 @@ type ComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange
238
252
  disabled?: boolean;
239
253
  loading?: boolean;
240
254
  emptyMessage?: string;
255
+ emptyDescription?: string;
241
256
  allowClear?: boolean;
242
257
  allowScrollSelection?: boolean;
258
+ listTitle?: string;
259
+ listBadge?: string;
260
+ selectionIndicator?: Exclude<ComboboxSelectionIndicator, 'checkbox'>;
261
+ renderItem?: ComboboxRenderItem;
262
+ listAction?: ComboboxListAction;
263
+ showFooter?: boolean;
264
+ open?: boolean;
265
+ defaultOpen?: boolean;
266
+ onOpenChange?: (open: boolean) => void;
267
+ contentClassName?: string;
243
268
  };
244
269
 
245
- declare const Combobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "children" | "onChange"> & {
270
+ declare const Combobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
246
271
  items: ComboboxItem[];
247
272
  value?: string;
248
273
  defaultValue?: string;
@@ -256,9 +281,20 @@ declare const Combobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttribute
256
281
  disabled?: boolean;
257
282
  loading?: boolean;
258
283
  emptyMessage?: string;
284
+ emptyDescription?: string;
259
285
  allowClear?: boolean;
260
286
  allowScrollSelection?: boolean;
261
- } & react.RefAttributes<HTMLButtonElement>>;
287
+ listTitle?: string;
288
+ listBadge?: string;
289
+ selectionIndicator?: Exclude<ComboboxSelectionIndicator, "checkbox">;
290
+ renderItem?: ComboboxRenderItem;
291
+ listAction?: ComboboxListAction;
292
+ showFooter?: boolean;
293
+ open?: boolean;
294
+ defaultOpen?: boolean;
295
+ onOpenChange?: (open: boolean) => void;
296
+ contentClassName?: string;
297
+ } & react.RefAttributes<HTMLInputElement>>;
262
298
 
263
299
  type ConfirmDialogVariant = 'danger' | 'warn' | 'info';
264
300
  type ConfirmDialogProps = {
@@ -377,7 +413,7 @@ declare const DialogRoot: typeof DialogRootBase & {
377
413
  type DocumentInputProps = Omit<MaskedInputProps, 'mask'>;
378
414
  declare function DocumentInput({ normalizeRaw, ...props }: DocumentInputProps): react.JSX.Element;
379
415
 
380
- type DrawerSide = 'right' | 'left' | 'bottom';
416
+ type DrawerSide = 'right' | 'left' | 'top' | 'bottom';
381
417
  type DrawerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
382
418
  type DrawerProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Root> & {
383
419
  children?: ReactNode;
@@ -387,6 +423,9 @@ type DrawerContentProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Conten
387
423
  size?: DrawerSize;
388
424
  hideCloseButton?: boolean;
389
425
  };
426
+ type DrawerFooterProps = ComponentPropsWithoutRef<'div'> & {
427
+ status?: ReactNode;
428
+ };
390
429
 
391
430
  declare function DrawerRootBase({ children, ...props }: DrawerProps): react.JSX.Element;
392
431
  declare namespace DrawerRootBase {
@@ -402,7 +441,9 @@ declare const DrawerRoot: typeof DrawerRootBase & {
402
441
  } & react.RefAttributes<HTMLDivElement>>;
403
442
  Header: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
404
443
  Body: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
405
- Footer: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
444
+ Footer: react.ForwardRefExoticComponent<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
445
+ status?: react.ReactNode;
446
+ } & react.RefAttributes<HTMLDivElement>>;
406
447
  Title: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
407
448
  Description: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
408
449
  };
@@ -461,11 +502,13 @@ type CopyButtonProps = Omit<ComponentPropsWithoutRef<'button'>, 'children'> & {
461
502
  textToCopy: string;
462
503
  children?: ReactNode;
463
504
  unstyled?: boolean;
505
+ size?: 'sm' | 'md';
464
506
  };
465
507
  declare const CopyButton: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "children"> & {
466
508
  textToCopy: string;
467
509
  children?: ReactNode;
468
510
  unstyled?: boolean;
511
+ size?: "sm" | "md";
469
512
  } & react.RefAttributes<HTMLButtonElement>>;
470
513
 
471
514
  type FilePreviewContentProps = {
@@ -490,6 +533,39 @@ type SourceProps = CommonProps & {
490
533
  type FilePreviewDialogProps = FileProps | SourceProps;
491
534
  declare function FilePreviewDialog(props: FilePreviewDialogProps): react.JSX.Element;
492
535
 
536
+ type FileViewCardField = {
537
+ label: ReactNode;
538
+ value: ReactNode;
539
+ };
540
+ type FileViewCardProps = Omit<HTMLAttributes<HTMLDivElement>, 'title'> & {
541
+ size?: 'sm' | 'lg';
542
+ name: ReactNode;
543
+ description?: ReactNode;
544
+ descriptionClassName?: string;
545
+ thumbnail?: ReactNode;
546
+ status?: ReactNode;
547
+ fields?: FileViewCardField[];
548
+ viewLabel?: string;
549
+ viewAriaLabel?: string;
550
+ onView?: () => void;
551
+ renderView?: (trigger: ReactElement) => ReactNode;
552
+ actions?: ReactNode;
553
+ };
554
+ declare const FileViewCard: react.ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "title"> & {
555
+ size?: "sm" | "lg";
556
+ name: ReactNode;
557
+ description?: ReactNode;
558
+ descriptionClassName?: string;
559
+ thumbnail?: ReactNode;
560
+ status?: ReactNode;
561
+ fields?: FileViewCardField[];
562
+ viewLabel?: string;
563
+ viewAriaLabel?: string;
564
+ onView?: () => void;
565
+ renderView?: (trigger: ReactElement) => ReactNode;
566
+ actions?: ReactNode;
567
+ } & react.RefAttributes<HTMLDivElement>>;
568
+
493
569
  type DocumentUploadCardTone = 'neutral' | 'success' | 'warning' | 'danger';
494
570
  type DocumentUploadCardSentFile = {
495
571
  name: string;
@@ -500,6 +576,8 @@ type DocumentUploadCardSentFile = {
500
576
  previewUrl?: string;
501
577
  previewMimeType?: string;
502
578
  renderPreview?: (trigger: ReactElement) => ReactNode;
579
+ status?: ReactNode;
580
+ fields?: FileViewCardField[];
503
581
  };
504
582
  type DocumentUploadCardProps = {
505
583
  label: string;
@@ -523,9 +601,12 @@ type DocumentUploadCardProps = {
523
601
  replaceLabel?: string;
524
602
  removeLabel?: string;
525
603
  previewLabel?: string;
604
+ replaceText?: string;
605
+ removeText?: string;
606
+ viewText?: string;
526
607
  className?: string;
527
608
  };
528
- declare function DocumentUploadCard({ label, hint, error, file, onSelect, accept, maxSize, validate, onValidationError, sent, dropzonePlaceholder, dropzoneHint, showLabel, required, icon, bordered, size, selectLabel, replaceLabel, removeLabel, previewLabel, className, }: DocumentUploadCardProps): react.JSX.Element;
609
+ declare function DocumentUploadCard({ label, hint, error, file, onSelect, accept, maxSize, validate, onValidationError, sent, dropzonePlaceholder, dropzoneHint, showLabel, required, icon, bordered, size, selectLabel, replaceLabel, removeLabel, previewLabel, replaceText, removeText, viewText, className, }: DocumentUploadCardProps): react.JSX.Element;
529
610
 
530
611
  type FileThumbnailProps = {
531
612
  /** Direct image URL. Takes precedence over `loadPreview`. */
@@ -558,6 +639,10 @@ declare const FileUpload: react.ForwardRefExoticComponent<Omit<react.HTMLAttribu
558
639
  dropzoneHint?: react.ReactNode;
559
640
  required?: boolean;
560
641
  icon?: react.ReactNode;
642
+ fileDescription?: react.ReactNode;
643
+ replaceLabel?: string;
644
+ removeLabel?: string;
645
+ showFileInfo?: boolean;
561
646
  } & react.RefAttributes<HTMLDivElement>>;
562
647
 
563
648
  type FileUploadProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'children' | 'onDrop'> & {
@@ -576,6 +661,10 @@ type FileUploadProps = Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'childr
576
661
  dropzoneHint?: ReactNode;
577
662
  required?: boolean;
578
663
  icon?: ReactNode;
664
+ fileDescription?: ReactNode;
665
+ replaceLabel?: string;
666
+ removeLabel?: string;
667
+ showFileInfo?: boolean;
579
668
  };
580
669
 
581
670
  declare const infoBoxStyles: (props?: ({
@@ -778,6 +867,8 @@ type ImageUploadProps = {
778
867
  required?: boolean;
779
868
  selectLabel?: string;
780
869
  changeLabel?: string;
870
+ removeLabel?: string;
871
+ hint?: ReactNode;
781
872
  removeConfirmTitle?: string;
782
873
  removeConfirmDescription?: string;
783
874
  removeConfirmLabel?: string;
@@ -802,6 +893,7 @@ type InputProps = Omit<ComponentPropsWithoutRef<'input'>, 'size'> & Pick<Variant
802
893
  required?: boolean;
803
894
  floating?: boolean;
804
895
  surface?: 'light' | 'dark';
896
+ containerClassName?: string;
805
897
  };
806
898
  declare const Input: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size"> & Pick<VariantProps<(props?: ({
807
899
  size?: "sm" | "md" | "lg" | null | undefined;
@@ -816,6 +908,7 @@ declare const Input: react.ForwardRefExoticComponent<Omit<Omit<react.DetailedHTM
816
908
  required?: boolean;
817
909
  floating?: boolean;
818
910
  surface?: "light" | "dark";
911
+ containerClassName?: string;
819
912
  } & react.RefAttributes<HTMLInputElement>>;
820
913
 
821
914
  type LabelProps = ComponentPropsWithoutRef<'label'> & {
@@ -839,7 +932,10 @@ type MultiComboboxItem = {
839
932
  description?: string;
840
933
  disabled?: boolean;
841
934
  };
842
- type MultiComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange'> & {
935
+ type MultiComboboxSelectAll = boolean | {
936
+ label?: string;
937
+ };
938
+ type MultiComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange' | 'defaultValue'> & {
843
939
  items: MultiComboboxItem[];
844
940
  value?: string[];
845
941
  defaultValue?: string[];
@@ -853,11 +949,22 @@ type MultiComboboxProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onC
853
949
  disabled?: boolean;
854
950
  loading?: boolean;
855
951
  emptyMessage?: string;
952
+ emptyDescription?: string;
856
953
  maxChipsVisible?: number;
857
954
  contentClassName?: string;
955
+ listTitle?: string;
956
+ listBadge?: string;
957
+ selectionIndicator?: Exclude<ComboboxSelectionIndicator, 'radio'>;
958
+ selectAll?: MultiComboboxSelectAll;
959
+ renderItem?: ComboboxRenderItem;
960
+ listAction?: ComboboxListAction;
961
+ showFooter?: boolean;
962
+ open?: boolean;
963
+ defaultOpen?: boolean;
964
+ onOpenChange?: (open: boolean) => void;
858
965
  };
859
966
 
860
- declare const MultiCombobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "children" | "onChange"> & {
967
+ declare const MultiCombobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> & {
861
968
  items: MultiComboboxItem[];
862
969
  value?: string[];
863
970
  defaultValue?: string[];
@@ -871,9 +978,20 @@ declare const MultiCombobox: react.ForwardRefExoticComponent<Omit<react.HTMLAttr
871
978
  disabled?: boolean;
872
979
  loading?: boolean;
873
980
  emptyMessage?: string;
981
+ emptyDescription?: string;
874
982
  maxChipsVisible?: number;
875
983
  contentClassName?: string;
876
- } & react.RefAttributes<HTMLButtonElement>>;
984
+ listTitle?: string;
985
+ listBadge?: string;
986
+ selectionIndicator?: Exclude<ComboboxSelectionIndicator, "radio">;
987
+ selectAll?: MultiComboboxSelectAll;
988
+ renderItem?: ComboboxRenderItem;
989
+ listAction?: ComboboxListAction;
990
+ showFooter?: boolean;
991
+ open?: boolean;
992
+ defaultOpen?: boolean;
993
+ onOpenChange?: (open: boolean) => void;
994
+ } & react.RefAttributes<HTMLInputElement>>;
877
995
 
878
996
  type OtpInputProps = {
879
997
  value?: string;
@@ -1947,6 +2065,17 @@ type FilterBarProps = {
1947
2065
 
1948
2066
  declare function FilterBar({ fields, values: controlledValues, defaultValues, activeCount, onApply, onClear, title, applyLabel, clearLabel, className, defaultOpen, hideTrigger, open: controlledOpen, onOpenChange, }: FilterBarProps): react.JSX.Element;
1949
2067
 
2068
+ type FilterToolbarProps = HTMLAttributes<HTMLDivElement> & {
2069
+ onClearAll?: () => void;
2070
+ showClearAll?: boolean;
2071
+ clearAllLabel?: string;
2072
+ };
2073
+ declare const FilterToolbar: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
2074
+ onClearAll?: () => void;
2075
+ showClearAll?: boolean;
2076
+ clearAllLabel?: string;
2077
+ } & react.RefAttributes<HTMLDivElement>>;
2078
+
1950
2079
  type FormSectionProps = {
1951
2080
  id: string;
1952
2081
  icon: ReactNode;
@@ -2141,4 +2270,4 @@ declare const TimelineSection: react.ForwardRefExoticComponent<Omit<Omit<react.D
2141
2270
  title: ReactNode;
2142
2271
  } & react.RefAttributes<HTMLElement>>;
2143
2272
 
2144
- export { AppShell, type AppShellProps, Avatar, type AvatarColor, type AvatarProps, type AvatarSize, type AvatarTone, Badge, type BadgeProps, type BadgeVariant, Box, type BoxProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Card, type CardProps, CepInput, type CepInputProps, ChartTimeSeries, type ChartTimeSeriesPoint, type ChartTimeSeriesProps, Checkbox, type CheckboxProps, Checklist, type ChecklistItem, type ChecklistProps, type ChecklistStatus, ColorPicker, type ColorPickerProps, Combobox, type ComboboxItem, type ComboboxProps, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, ContentCard, type ContentCardProps, ContextMenu, type ContextMenuContentProps, type ContextMenuItemProps, type ContextMenuProps, CopyButton, type CopyButtonProps, DSAccordion, type DSAccordionRootProps, type DSAccordionTriggerProps, DashboardBlock, type DashboardBlockData, type DashboardBlockProps, type DashboardReason, DataField, type DataFieldProps, DataTable, DataTableActionButton, type DataTableActionButtonProps, type DataTableColumn, type DataTableDensity, DataTableDocumentCell, type DataTableDocumentCellProps, DataTableLinkCell, type DataTableLinkCellProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, type DataTableSortDirection, DataTableTextCell, type DataTableTextCellProps, DateInput, type DateInputProps, type DateRange, type DateRangeFilterField, DateRangeInput, type DateRangeInputProps, DefaultLink, type DetailsDialog, DialogRoot as Dialog, type DialogContentProps, type DialogProps, DocumentInput, type DocumentInputProps, DocumentUploadCard, type DocumentUploadCardProps, type DocumentUploadCardSentFile, type DocumentUploadCardTone, DonutChart, type DonutChartProps, type DonutChartSlice, DrawerRoot as Drawer, type DrawerContentProps, type DrawerProps, type DrawerSide, type DrawerSize, Dropdown, type DropdownCheckboxItemProps, type DropdownContentProps, type DropdownItemProps, type DropdownProps, type DsLinkComponent, EmptyState, type EmptyStateProps, type EmptyStateVariant, ErrorPageLayout, type ErrorPageLayoutProps, FieldsCard, type FieldsCardField, type FieldsCardProps, type FieldsCardVariant, FileInfoCard, type FileInfoCardProps, FilePreviewContent, type FilePreviewContentProps, FilePreviewDialog, type FilePreviewDialogProps, FileThumbnail, type FileThumbnailProps, FileUpload, type FileUploadProps, FilterBar, type FilterBarProps, FilterBar as FilterBarV2, type FilterBarProps as FilterBarV2Props, type FilterField, type FilterFormValues, FormAlert, type FormAlertProps, type FormAsideSection, FormSection, type FormSectionProps, FormWithAside, type FormWithAsideProps, FullScreenLoading, type FullScreenLoadingProps, Heading, type HeadingProps, HelpHint, type HelpHintProps, type HelpHintSize, HorizontalBarChart, type HorizontalBarChartProps, type HorizontalBarItem, ImageUpload, type ImageUploadPreviewBg, type ImageUploadProps, InfoBox, type InfoBoxProps, type InfoBoxVariant, Input, type InputProps, KpiCard, type KpiCardProgress, type KpiCardProgressTone, type KpiCardProps, type KpiCardVariant, KpiHero, type KpiHeroProps, type KpiHeroTone, type KpiHeroTrend, type KpiHeroTrendDirection, Label, type LabelProps, type LegalDocumentContent, LegalDocumentRenderer, type LegalDocumentRendererProps, LineChart, type LineChartProps, type LineSeries, Logo, type LogoProps, type LogoTone, type LogoVariant, type MaskFilterField, MaskedInput, type MaskedInputProps, MoneyInput, type MoneyInputProps, MultiCombobox, type MultiComboboxItem, type MultiComboboxProps, type MultiSelectFilterField, NavigatorTile, NavigatorTileGrid, type NavigatorTileGridProps, type NavigatorTileProps, type Notification, NotificationCenter, type NotificationCenterProps, type NotificationSeverity, type NumberRangeFilterField, OtpInput, type OtpInputProps, PageTitle, type PageTitleInfoItem, type PageTitleProps, PanelCard, type PanelCardProps, PasswordInput, type PasswordInputProps, PercentInput, type PercentInputProps, PhoneInput, type PhoneInputProps, Popover, type PopoverContentProps, type PopoverProps, Progress, type ProgressItem, type ProgressProps, ProgressTitle, type ProgressTitleProps, PublicPageLayout, type PublicPageLayoutProps, RadioGroup, type RadioGroupProps, type ReadOnlyColumn, ReadOnlyDataView, type ReadOnlyDataViewProps, type ResolvedTheme, SectionCard, type SectionCardProps, type SelectFilterField, SelectableCard, type SelectableCardIndicator, type SelectableCardProps, Separator, type SeparatorProps, Sidebar, type SidebarGroup, type SidebarItem, type SidebarProps, Skeleton, type SkeletonProps, type SortDirection$1 as SortDirection, SortableColumnHeader, type SortableColumnHeaderProps, Sparkline, SparklineBadge, type SparklineBadgeDirection, type SparklineBadgeProps, type SparklineBadgeTone, type SparklineProps, Spinner, type SpinnerProps, type StackSeries, StackedBarChart, type StackedBarChartProps, type StepState, Stepper, type StepperProps, type StepperStep, SuspenseSkeleton, Switch, type SwitchProps, THEME_STORAGE_KEY, Tabs, type TabsListProps, type TabsProps, type TabsTriggerProps, type TabsTriggerTone, type TabsVariant, Text, TextArea, type TextAreaProps, type TextFilterField, type TextProps, type ThemeContextValue, type ThemeOptions, type ThemePreference, ThemeProvider, type ThemeProviderProps, ThemeToggle, type ThemeToggleProps, Timeline, TimelineDaySeparator, type TimelineDaySeparatorProps, TimelineItem, type TimelineItemProps, type TimelineProps, TimelineSection, type TimelineSectionProps, type TimelineTone, TitleSelect, type TitleSelectOption, type TitleSelectProps, type ToastOptions, type ToastRecord, type ToastVariant, Toaster, type ToasterProps, ToggleChip, type ToggleChipProps, type ToggleChipTone, Tooltip, type TooltipProps, Topbar, TopbarIconButton, type TopbarIconButtonProps, type TopbarProps, TopbarSearchButton, type TopbarSearchButtonProps, TutorialCard, type TutorialCardProps, WizardShell, type WizardShellProps, type WizardShellStep, WorkflowDesigner, type WorkflowDesignerProps, type WorkflowEdge, type WorkflowEdgeTrigger, type WorkflowNode, type WorkflowNodeAction, type WorkflowNodeKind, type WorkflowNodeRule, cn, dismissToast, getShortcutKeys, getShortcutLabel, getThemeBootstrapScript, isImageFile, isMacOS, isPdfFile, toast, useTheme, useToast };
2273
+ export { AppShell, type AppShellProps, Avatar, type AvatarColor, type AvatarProps, type AvatarSize, type AvatarTone, Badge, type BadgeProps, type BadgeVariant, Box, type BoxProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, Button, type ButtonProps, Card, type CardProps, CepInput, type CepInputProps, ChartTimeSeries, type ChartTimeSeriesPoint, type ChartTimeSeriesProps, Checkbox, type CheckboxProps, Checklist, type ChecklistItem, type ChecklistProps, type ChecklistStatus, ColorPicker, type ColorPickerProps, Combobox, type ComboboxItem, type ComboboxListAction, type ComboboxProps, type ComboboxRenderItem, type ComboboxRenderItemState, type ComboboxSelectionIndicator, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmDialogVariant, ContentCard, type ContentCardProps, ContextMenu, type ContextMenuContentProps, type ContextMenuItemProps, type ContextMenuProps, CopyButton, type CopyButtonProps, DSAccordion, type DSAccordionRootProps, type DSAccordionTriggerProps, DashboardBlock, type DashboardBlockData, type DashboardBlockProps, type DashboardReason, DataField, type DataFieldProps, DataTable, DataTableActionButton, type DataTableActionButtonProps, type DataTableColumn, type DataTableDensity, DataTableDocumentCell, type DataTableDocumentCellProps, DataTableLinkCell, type DataTableLinkCellProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, type DataTableSortDirection, DataTableTextCell, type DataTableTextCellProps, DateInput, type DateInputProps, type DateRange, type DateRangeFilterField, DateRangeInput, type DateRangeInputProps, DefaultLink, type DetailsDialog, DialogRoot as Dialog, type DialogContentProps, type DialogProps, DocumentInput, type DocumentInputProps, DocumentUploadCard, type DocumentUploadCardProps, type DocumentUploadCardSentFile, type DocumentUploadCardTone, DonutChart, type DonutChartProps, type DonutChartSlice, DrawerRoot as Drawer, type DrawerContentProps, type DrawerFooterProps, type DrawerProps, type DrawerSide, type DrawerSize, Dropdown, type DropdownCheckboxItemProps, type DropdownContentProps, type DropdownItemProps, type DropdownProps, type DsLinkComponent, EmptyState, type EmptyStateProps, type EmptyStateVariant, ErrorPageLayout, type ErrorPageLayoutProps, FieldsCard, type FieldsCardField, type FieldsCardProps, type FieldsCardVariant, FileInfoCard, type FileInfoCardProps, FilePreviewContent, type FilePreviewContentProps, FilePreviewDialog, type FilePreviewDialogProps, FileThumbnail, type FileThumbnailProps, FileUpload, type FileUploadProps, FileViewCard, type FileViewCardField, type FileViewCardProps, FilterBar, type FilterBarProps, FilterBar as FilterBarV2, type FilterBarProps as FilterBarV2Props, type FilterField, type FilterFormValues, FilterToolbar, type FilterToolbarProps, FormAlert, type FormAlertProps, type FormAsideSection, FormSection, type FormSectionProps, FormWithAside, type FormWithAsideProps, FullScreenLoading, type FullScreenLoadingProps, Heading, type HeadingProps, HelpHint, type HelpHintProps, type HelpHintSize, HorizontalBarChart, type HorizontalBarChartProps, type HorizontalBarItem, ImageUpload, type ImageUploadPreviewBg, type ImageUploadProps, InfoBox, type InfoBoxProps, type InfoBoxVariant, Input, type InputProps, KpiCard, type KpiCardProgress, type KpiCardProgressTone, type KpiCardProps, type KpiCardVariant, KpiHero, type KpiHeroProps, type KpiHeroTone, type KpiHeroTrend, type KpiHeroTrendDirection, Label, type LabelProps, type LegalDocumentContent, LegalDocumentRenderer, type LegalDocumentRendererProps, LineChart, type LineChartProps, type LineSeries, Logo, type LogoProps, type LogoTone, type LogoVariant, type MaskFilterField, MaskedInput, type MaskedInputProps, MoneyInput, type MoneyInputProps, MultiCombobox, type MultiComboboxItem, type MultiComboboxProps, type MultiComboboxSelectAll, type MultiSelectFilterField, NavigatorTile, NavigatorTileGrid, type NavigatorTileGridProps, type NavigatorTileProps, type Notification, NotificationCenter, type NotificationCenterProps, type NotificationSeverity, type NumberRangeFilterField, OtpInput, type OtpInputProps, PageTitle, type PageTitleInfoItem, type PageTitleProps, PanelCard, type PanelCardProps, PasswordInput, type PasswordInputProps, PercentInput, type PercentInputProps, PhoneInput, type PhoneInputProps, Popover, type PopoverContentProps, type PopoverProps, Progress, type ProgressItem, type ProgressProps, ProgressTitle, type ProgressTitleProps, PublicPageLayout, type PublicPageLayoutProps, RadioGroup, type RadioGroupProps, type ReadOnlyColumn, ReadOnlyDataView, type ReadOnlyDataViewProps, type ResolvedTheme, SectionCard, type SectionCardProps, type SelectFilterField, SelectableCard, type SelectableCardIndicator, type SelectableCardProps, Separator, type SeparatorProps, Sidebar, type SidebarGroup, type SidebarItem, type SidebarProps, Skeleton, type SkeletonProps, type SortDirection$1 as SortDirection, SortableColumnHeader, type SortableColumnHeaderProps, Sparkline, SparklineBadge, type SparklineBadgeDirection, type SparklineBadgeProps, type SparklineBadgeTone, type SparklineProps, Spinner, type SpinnerProps, type StackSeries, StackedBarChart, type StackedBarChartProps, type StepState, Stepper, type StepperProps, type StepperStep, SuspenseSkeleton, Switch, type SwitchProps, THEME_STORAGE_KEY, Tabs, type TabsListProps, type TabsProps, type TabsTriggerProps, type TabsTriggerTone, type TabsVariant, Text, TextArea, type TextAreaProps, type TextFilterField, type TextProps, type ThemeContextValue, type ThemeOptions, type ThemePreference, ThemeProvider, type ThemeProviderProps, ThemeToggle, type ThemeToggleProps, Timeline, TimelineDaySeparator, type TimelineDaySeparatorProps, TimelineItem, type TimelineItemProps, type TimelineProps, TimelineSection, type TimelineSectionProps, type TimelineTone, TitleSelect, type TitleSelectOption, type TitleSelectProps, type ToastOptions, type ToastRecord, type ToastVariant, Toaster, type ToasterProps, ToggleChip, type ToggleChipProps, type ToggleChipTone, Tooltip, type TooltipProps, Topbar, TopbarIconButton, type TopbarIconButtonProps, type TopbarProps, TopbarSearchButton, type TopbarSearchButtonProps, TutorialCard, type TutorialCardProps, WizardShell, type WizardShellProps, type WizardShellStep, WorkflowDesigner, type WorkflowDesignerProps, type WorkflowEdge, type WorkflowEdgeTrigger, type WorkflowNode, type WorkflowNodeAction, type WorkflowNodeKind, type WorkflowNodeRule, cn, dismissToast, getShortcutKeys, getShortcutLabel, getThemeBootstrapScript, isImageFile, isMacOS, isPdfFile, toast, useTheme, useToast };