@humu-tech/ui 0.2.0 → 0.4.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 +64 -8
- package/dist/{DateInput-HC45BUBP.css → DateInput-W7IF3TRC.css} +10 -3
- package/dist/{DateRangeInput-TBELV5TN.css → DateRangeInput-66WC5JQX.css} +10 -3
- package/dist/index.d.mts +426 -51
- package/dist/index.d.ts +426 -51
- package/dist/index.js +4518 -2290
- package/dist/index.mjs +4445 -2194
- package/dist/tailwind-preset.js +21 -34
- package/dist/tailwind-preset.mjs +11 -34
- package/dist/tokens/semantic.css +6 -0
- package/package.json +3 -2
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,8 +292,8 @@ 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` |
|
|
277
|
-
| **Overlays e menus** | `ConfirmDialog` `ContextMenu` `Dialog` `Drawer` `Dropdown` `FilePreviewDialog` `Popover` `Tooltip` |
|
|
295
|
+
| **Formulário** | `Button` `Checkbox` `CepInput` `ColorPicker` `Combobox` `DateInput` `DateRangeInput` `DocumentInput` `DocumentUploadCard` `DownloadButton` `FileUpload` `FileViewCard` `ImageUpload` `Input` `Label` `MaskedInput` `MoneyInput` `MultiCombobox` `OtpInput` `PasswordInput` `PasswordRequirements` `PercentInput` `PhoneInput` `RadioGroup` `SelectableCard` `Switch` `TextArea` `TitleSelect` `ToggleChip` |
|
|
296
|
+
| **Overlays e menus** | `ConfirmDialog` `ContextMenu` `Dialog` `Drawer` `Dropdown` `FilePreviewDialog` `PasswordPromptDialog` `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` |
|
|
280
299
|
| **Feedback** | `Checklist` `FormAlert` `FullScreenLoading` `HelpHint` `InfoBox` `Progress` `ProgressTitle` `Spinner` `Toaster` (com `toast`, `useToast` e `dismissToast`) |
|
|
@@ -284,15 +303,52 @@ 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` |
|
|
288
|
-
| **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` |
|
|
306
|
+
| **Formulário** | `ActionBar` `FilterBar` `FilterToolbar` `FormSection` `FormWithAside` `QuickFilters` `SectionHeading` `ToggleTile` `WizardShell` |
|
|
307
|
+
| **Exibição de dados** | `DataField` `DataTable` (com `DataTableTextCell`, `DataTableLinkCell`, `DataTableDocumentCell` e `DataTableActionButton`) `DataTablePagination` `EmptyState` `LegalDocumentRenderer` `PanelCard` `ReadOnlyDataView` `SectionCard` `SortableColumnHeader` `StatusBadge` `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
|
-
| **Gráficos e indicadores** | `ChartTimeSeries` `DonutChart` `HorizontalBarChart` `KpiCard` `KpiHero` `LineChart` `StackedBarChart` |
|
|
291
|
-
| **Diversos** | `CommandPalette` `DashboardBlock` `DSAccordion` `NotificationCenter` `WorkflowDesigner` |
|
|
309
|
+
| **Gráficos e indicadores** | `ChartTimeSeries` `DonutChart` `HorizontalBarChart` `KpiCard` `KpiHero` `LineChart` `Speedometer` `StackedBarChart` |
|
|
310
|
+
| **Diversos** | `CommandPalette` `CookieConsent` `DashboardBlock` `DSAccordion` `ErrorBoundary` `NotificationCenter` `WorkflowDesigner` |
|
|
292
311
|
|
|
293
312
|
### Utilitários
|
|
294
313
|
|
|
295
|
-
`cn` (junta classes e resolve conflitos do Tailwind, incluindo as `humu-*`), `DefaultLink`, `SuspenseSkeleton`, `isMacOS`, `getShortcutLabel`, `getShortcutKeys`, `isImageFile` e `
|
|
314
|
+
`cn` (junta classes e resolve conflitos do Tailwind, incluindo as `humu-*`), `DefaultLink`, `SuspenseSkeleton`, `isMacOS`, `getShortcutLabel`, `getShortcutKeys`, `isImageFile`, `isPdfFile`, `downloadFile`, `normalizeDocument`, `brazilianPhoneDigits`, `meetsPasswordRules` e `DEFAULT_PASSWORD_RULES`. Os componentes exportam também o tipo das props (`ButtonProps`, `DataTableProps` etc.).
|
|
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`.
|
|
296
352
|
|
|
297
353
|
## Migrando da 0.1.x
|
|
298
354
|
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
}
|
|
33
33
|
|
|
34
34
|
.rdp-humu .rdp-day_button:focus-visible {
|
|
35
|
-
outline: 2px solid var(--humu-
|
|
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
|
|
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-
|
|
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-
|
|
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
|
|
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-
|
|
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
|
+
}
|