@humu-tech/ui 0.1.25 → 0.2.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 +258 -89
- package/dist/DateInput-HC45BUBP.css +105 -0
- package/dist/DateRangeInput-TBELV5TN.css +143 -0
- package/dist/Sidebar-RBBNUVDV.css +7 -0
- package/dist/index.d.mts +493 -57
- package/dist/index.d.ts +493 -57
- package/dist/index.js +5234 -2944
- package/dist/index.mjs +5227 -2911
- package/dist/tailwind-preset.js +122 -0
- package/dist/tailwind-preset.mjs +122 -0
- package/dist/tokens/colors.css +55 -55
- package/dist/tokens/elevation.css +10 -5
- package/dist/tokens/motion.css +23 -14
- package/dist/tokens/primitives.css +94 -0
- package/dist/tokens/primitives.d.mts +2 -0
- package/dist/tokens/primitives.d.ts +2 -0
- package/dist/tokens/semantic.css +166 -0
- package/dist/tokens/semantic.d.mts +2 -0
- package/dist/tokens/semantic.d.ts +2 -0
- package/dist/tokens/spacing.css +1 -17
- package/dist/tokens/surfaces.css +64 -98
- package/dist/tokens/typography.css +44 -23
- package/dist/tokens.css +10 -7
- package/package.json +40 -21
- package/dist/DateInput-ASNJQV43.css +0 -105
- package/dist/DateRangeInput-PC5F3TTS.css +0 -143
- package/dist/Sidebar-4ILVFQI5.css +0 -44
package/README.md
CHANGED
|
@@ -4,177 +4,346 @@
|
|
|
4
4
|
[](https://inovanti-bank.github.io/humu-ui/)
|
|
5
5
|
[](https://www.npmjs.com/package/@humu-tech/ui)
|
|
6
6
|
|
|
7
|
-
**Design System
|
|
7
|
+
**Design System Humu.** Primitives e patterns em React, com tema claro/escuro, preset para Tailwind CSS 3, ícones lucide e tipos TypeScript.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- **[Storybook](https://inovanti-bank.github.io/humu-ui/)**: catálogo interativo. Cada componente tem a aba **Docs**, com a tabela de props gerada a partir dos tipos, e uma story para cada variação.
|
|
10
|
+
- **[CHANGELOG](https://github.com/Inovanti-Bank/humu-ui/blob/main/packages/react/CHANGELOG.md)**: o que mudou em cada versão.
|
|
11
|
+
- Vindo da 0.1.x? Veja [Migrando da 0.1.x](#migrando-da-01x).
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
## Requisitos
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
| O quê | Versão |
|
|
16
|
+
| --- | --- |
|
|
17
|
+
| `react` e `react-dom` | 18 ou 19 (`peerDependencies`: `^18 \|\| ^19`) |
|
|
18
|
+
| `tailwindcss` | 3 (o preset é um `Config` do Tailwind 3; o Tailwind 4 não é suportado) |
|
|
19
|
+
| Bundler | um que resolva `import` de CSS vindo de `node_modules`, como Vite ou Next.js |
|
|
20
|
+
|
|
21
|
+
Radix, gráficos, ícones (`lucide-react`) e as fontes já vêm como dependências da lib.
|
|
14
22
|
|
|
15
23
|
## Instalação
|
|
16
24
|
|
|
17
25
|
```bash
|
|
18
|
-
npm install @humu-tech/ui
|
|
26
|
+
npm install @humu-tech/ui --save-exact
|
|
19
27
|
```
|
|
20
28
|
|
|
21
|
-
|
|
29
|
+
Se o app ainda não usa Tailwind:
|
|
22
30
|
|
|
23
|
-
|
|
31
|
+
```bash
|
|
32
|
+
npm install -D tailwindcss@3 postcss autoprefixer
|
|
33
|
+
```
|
|
24
34
|
|
|
25
|
-
|
|
35
|
+
Use versão exata (`--save-exact`). O visual muda entre versões menores enquanto a lib está em `0.x`, então subir de versão deve ser uma decisão, conferida nas telas.
|
|
26
36
|
|
|
27
|
-
|
|
37
|
+
## Configuração
|
|
28
38
|
|
|
29
|
-
|
|
39
|
+
São quatro passos, uma vez por app.
|
|
30
40
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
```
|
|
41
|
+
### 1. CSS global: tokens e Tailwind
|
|
42
|
+
|
|
43
|
+
Importe `@humu-tech/ui/tokens.css` no CSS global, **antes** das diretivas do Tailwind:
|
|
35
44
|
|
|
36
45
|
```css
|
|
37
|
-
/* Next.js App Router: app/globals.css */
|
|
38
46
|
@import '@humu-tech/ui/tokens.css';
|
|
47
|
+
@tailwind base;
|
|
48
|
+
@tailwind components;
|
|
49
|
+
@tailwind utilities;
|
|
50
|
+
|
|
51
|
+
body {
|
|
52
|
+
background-color: var(--humu-background-base);
|
|
53
|
+
color: var(--humu-content-title);
|
|
54
|
+
font-family: var(--humu-font-family-ibm-plex-sans);
|
|
55
|
+
}
|
|
39
56
|
```
|
|
40
57
|
|
|
41
|
-
|
|
58
|
+
O `tokens.css` traz as variáveis `--humu-*` dos dois temas (cor, tipografia, raio, sombra, movimento) e carrega as fontes IBM Plex Sans, Inter e JetBrains Mono. Não é preciso importar fonte à parte. Ele não estiliza o `body`: a regra acima é o que faz o fundo, o texto e a fonte do app acompanharem o tema.
|
|
42
59
|
|
|
43
|
-
|
|
60
|
+
Também dá para importar pelo JavaScript, no ponto de entrada do app: `import '@humu-tech/ui/tokens.css'`.
|
|
44
61
|
|
|
45
|
-
|
|
62
|
+
### 2. Tailwind: preset e `content`
|
|
46
63
|
|
|
47
64
|
```ts
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
65
|
+
import type { Config } from 'tailwindcss'
|
|
66
|
+
import humuPreset from '@humu-tech/ui/tailwind-preset'
|
|
67
|
+
|
|
68
|
+
const config: Config = {
|
|
69
|
+
presets: [humuPreset],
|
|
51
70
|
content: [
|
|
71
|
+
'./index.html',
|
|
52
72
|
'./src/**/*.{ts,tsx}',
|
|
53
73
|
'./node_modules/@humu-tech/ui/dist/**/*.{js,mjs}',
|
|
54
74
|
],
|
|
55
75
|
}
|
|
76
|
+
|
|
77
|
+
export default config
|
|
56
78
|
```
|
|
57
79
|
|
|
58
|
-
|
|
59
|
-
<summary><strong>Se o app já usa <code>@inovanti/react/tailwind.config</code> como preset</strong></summary>
|
|
80
|
+
Em `tailwind.config.js` CommonJS: `presets: [require('@humu-tech/ui/tailwind-preset').default]`.
|
|
60
81
|
|
|
61
|
-
|
|
82
|
+
> **A linha do `node_modules/@humu-tech/ui/dist` no `content` não é opcional.** Os componentes trazem as classes Tailwind no bundle. Sem ela, o Tailwind do app não gera essas classes e os estilos somem, sem erro de build.
|
|
62
83
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
84
|
+
O preset liga `darkMode: ['class']` e acrescenta as classes `humu-*` (veja [Classes dos tokens](#classes-dos-tokens)).
|
|
85
|
+
|
|
86
|
+
### 3. Tema: `ThemeProvider`
|
|
87
|
+
|
|
88
|
+
Envolva o app no `ThemeProvider`. Ele aplica o tema no `<html>`, guarda a escolha da pessoa e acompanha o tema do sistema.
|
|
89
|
+
|
|
90
|
+
```tsx
|
|
91
|
+
import { ThemeProvider, Toaster } from '@humu-tech/ui'
|
|
92
|
+
|
|
93
|
+
export function Root({ children }: { children: React.ReactNode }) {
|
|
94
|
+
return (
|
|
95
|
+
<ThemeProvider>
|
|
96
|
+
{children}
|
|
97
|
+
<Toaster />
|
|
98
|
+
</ThemeProvider>
|
|
99
|
+
)
|
|
75
100
|
}
|
|
76
101
|
```
|
|
77
102
|
|
|
78
|
-
|
|
103
|
+
O `<Toaster />`, montado uma vez, é o que faz os avisos de `toast()` aparecerem.
|
|
104
|
+
|
|
105
|
+
### 4. Tema sem piscar: script no `<head>`
|
|
106
|
+
|
|
107
|
+
O `ThemeProvider` só roda depois que o JavaScript carrega. Para a página já abrir no tema certo, coloque no `<head>` o script devolvido por `getThemeBootstrapScript()`. Ele lê a mesma preferência que o provider e aplica `data-theme`, a classe e o `color-scheme` antes do primeiro desenho.
|
|
108
|
+
|
|
109
|
+
A função devolve uma string. Como o bundle da lib importa CSS e é marcado `"use client"`, ela não roda em `vite.config.ts` nem em Server Component do Next.js: gere a string uma vez e cole no HTML.
|
|
110
|
+
|
|
111
|
+
```html
|
|
112
|
+
<head>
|
|
113
|
+
<script data-theme-bootstrap>COLE AQUI A SAÍDA DE getThemeBootstrapScript()</script>
|
|
114
|
+
</head>
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Um teste no app garante que o HTML acompanha a lib quando ela muda o script:
|
|
118
|
+
|
|
119
|
+
```ts
|
|
120
|
+
import { readFileSync } from 'node:fs'
|
|
121
|
+
import { getThemeBootstrapScript } from '@humu-tech/ui'
|
|
122
|
+
import { expect, it } from 'vitest'
|
|
123
|
+
|
|
124
|
+
it('index.html traz o script de tema da versão instalada', () => {
|
|
125
|
+
const html = readFileSync('index.html', 'utf8')
|
|
126
|
+
expect(html).toContain(getThemeBootstrapScript())
|
|
127
|
+
})
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
Se o `ThemeProvider` usa `storageKey` ou `defaultPreference`, passe as mesmas opções para `getThemeBootstrapScript({ storageKey, defaultPreference })`. Em Next.js, o script entra no `<head>` do layout raiz com `dangerouslySetInnerHTML`, e o `<html>` precisa de `suppressHydrationWarning`, porque o script muda os atributos dele antes da hidratação. Com Content-Security-Policy, o script inline precisa de `nonce` ou hash.
|
|
79
131
|
|
|
80
132
|
## Uso
|
|
81
133
|
|
|
134
|
+
Tudo é importado da raiz do pacote.
|
|
135
|
+
|
|
82
136
|
```tsx
|
|
83
|
-
import { Button, Input,
|
|
137
|
+
import { Button, Input, toast } from '@humu-tech/ui'
|
|
138
|
+
import { Save } from 'lucide-react'
|
|
84
139
|
|
|
85
|
-
export function
|
|
140
|
+
export function ClienteForm() {
|
|
86
141
|
return (
|
|
87
|
-
<
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
142
|
+
<form
|
|
143
|
+
className="flex flex-col gap-4"
|
|
144
|
+
onSubmit={(event) => {
|
|
145
|
+
event.preventDefault()
|
|
146
|
+
toast.success('Cliente salvo')
|
|
147
|
+
}}
|
|
148
|
+
>
|
|
149
|
+
<Input label="Nome" name="nome" />
|
|
150
|
+
<Button type="submit" variant="primary" leftIcon={<Save />}>
|
|
151
|
+
Salvar
|
|
152
|
+
</Button>
|
|
153
|
+
</form>
|
|
91
154
|
)
|
|
92
155
|
}
|
|
93
156
|
```
|
|
94
157
|
|
|
95
|
-
###
|
|
158
|
+
### Ícones
|
|
96
159
|
|
|
97
|
-
Os componentes
|
|
160
|
+
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:
|
|
98
161
|
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
|
|
162
|
+
```bash
|
|
163
|
+
npm install lucide-react
|
|
164
|
+
```
|
|
102
165
|
|
|
103
|
-
|
|
104
|
-
<Link to={to} className={className}>{children}</Link>
|
|
105
|
-
)
|
|
166
|
+
Usar a mesma versão da lib evita duas cópias no bundle; `npm ls lucide-react` mostra qual é.
|
|
106
167
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
</
|
|
168
|
+
### Classes dos tokens
|
|
169
|
+
|
|
170
|
+
O preset gera classes Tailwind a partir dos tokens, com o prefixo `humu-`. Use essas classes no app em vez de cores fixas, para acompanhar o tema:
|
|
171
|
+
|
|
172
|
+
```tsx
|
|
173
|
+
<div className="rounded-humu-md border border-humu-background-border bg-humu-background-surface p-4 shadow-humu-card">
|
|
174
|
+
<h2 className="text-humu-heading-xm font-bold text-humu-content-title">Título</h2>
|
|
175
|
+
<p className="text-humu-body-xs text-humu-content-body-text">Texto de apoio</p>
|
|
176
|
+
</div>
|
|
114
177
|
```
|
|
115
178
|
|
|
116
|
-
|
|
179
|
+
| Grupo | Exemplos |
|
|
180
|
+
| --- | --- |
|
|
181
|
+
| 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` |
|
|
183
|
+
| Borda | `border-humu-background-border`, `border-humu-border-default`, `border-humu-border-brand` |
|
|
184
|
+
| Status | `bg-humu-status-background-success-subtle`, `text-humu-status-content-error` |
|
|
185
|
+
| Paleta | `bg-humu-brand-500`, `text-humu-grey-700` (escalas `grey`, `brand`, `turtle`, `purple`, `green`, `yellow`, `red`, `blue`, de 50 a 950) |
|
|
186
|
+
| Gráfico | `fill-humu-chart-1` a `fill-humu-chart-8` |
|
|
187
|
+
| Tipografia | `text-humu-heading-{x,l,xm}`, `text-humu-body-{m,s,xs,xxs}` (tamanho, altura de linha e espaçamento) e `text-humu-size-{xs…6xl}` (só tamanho) |
|
|
188
|
+
| Fonte | `font-humu-ibm-plex-sans`, `font-humu-inter` |
|
|
189
|
+
| Raio | `rounded-humu-{none,sm,md,lg,xl,pill}` |
|
|
190
|
+
| Sombra | `shadow-humu-card`, `shadow-humu-dialog`, `shadow-humu-raised` |
|
|
191
|
+
| Movimento | `duration-humu-{instant,fast,normal,slow,slower}`, `ease-humu-{out,in-out,spring}` |
|
|
192
|
+
|
|
193
|
+
As cores aceitam opacidade do Tailwind (`bg-humu-brand-500/20`). O `cn` conhece esses grupos: `cn('text-humu-body-xs', 'text-humu-body-s')` fica só com o último tamanho e mantém a cor.
|
|
117
194
|
|
|
118
|
-
### Tema claro
|
|
195
|
+
### Tema claro e escuro
|
|
119
196
|
|
|
120
|
-
O
|
|
197
|
+
O tema vale para a página inteira e é aplicado no `<html>`: `data-theme="light"` ou `data-theme="dark"`, a classe `light`/`dark` e o `color-scheme`. Os tokens reagem ao atributo, então CSS fora do React também troca de tema.
|
|
121
198
|
|
|
122
199
|
```tsx
|
|
123
|
-
import { ThemeToggle,
|
|
200
|
+
import { ThemeToggle, useTheme } from '@humu-tech/ui'
|
|
124
201
|
|
|
125
|
-
function Topbar() {
|
|
126
|
-
const theme =
|
|
202
|
+
export function Topbar() {
|
|
203
|
+
const { theme, preference, setPreference } = useTheme()
|
|
127
204
|
return (
|
|
128
|
-
<header>
|
|
129
|
-
<span>
|
|
205
|
+
<header className="flex items-center gap-2">
|
|
206
|
+
<span>
|
|
207
|
+
Tema: {theme} (preferência: {preference})
|
|
208
|
+
</span>
|
|
209
|
+
<button type="button" onClick={() => setPreference('dark')}>
|
|
210
|
+
Escuro
|
|
211
|
+
</button>
|
|
130
212
|
<ThemeToggle size="md" />
|
|
131
213
|
</header>
|
|
132
214
|
)
|
|
133
215
|
}
|
|
134
216
|
```
|
|
135
217
|
|
|
136
|
-
- **`
|
|
137
|
-
- **`
|
|
218
|
+
- **`ThemeProvider`**: guarda a preferência (`light`, `dark` ou `system`) no `localStorage`, acompanha `prefers-color-scheme` quando a preferência é `system` e sincroniza entre abas. Props: `storageKey` (padrão `"theme-preference"`, exportado como `THEME_STORAGE_KEY`) e `defaultPreference` (padrão `"system"`).
|
|
219
|
+
- **`useTheme()`**: devolve `preference` (`ThemePreference`), `theme` (`ResolvedTheme`, `'light' | 'dark'`, já resolvido), `setPreference` e `cyclePreference`. Fora do `ThemeProvider`, lança erro.
|
|
220
|
+
- **`ThemeToggle`**: botão que cicla claro, escuro e sistema, com o título do próximo passo ("Mudar para tema escuro" etc.). Prop `size`: `sm`, `md` (padrão) ou `lg`. Precisa estar dentro do `ThemeProvider`.
|
|
221
|
+
|
|
222
|
+
**Tema escuro num trecho.** `data-theme="dark"` em qualquer elemento aplica os tokens do tema escuro só àquele trecho, com o resto da página no claro:
|
|
223
|
+
|
|
224
|
+
```tsx
|
|
225
|
+
<section data-theme="dark" className="bg-humu-background-base p-6 text-humu-content-title">
|
|
226
|
+
<Button variant="primary">Ação</Button>
|
|
227
|
+
</section>
|
|
228
|
+
```
|
|
229
|
+
|
|
230
|
+
O contrário (trecho claro numa página escura) não existe: só o tema escuro tem seletor por elemento.
|
|
231
|
+
|
|
232
|
+
### Navegação sem acoplar roteador
|
|
233
|
+
|
|
234
|
+
`AppShell`, `Sidebar`, `Breadcrumb` e `KpiHero` não embutem roteador: recebem `linkComponent` (tipo `DsLinkComponent`). `AppShell` e `Sidebar` recebem também `currentPath`, para marcar o item ativo.
|
|
235
|
+
|
|
236
|
+
```tsx
|
|
237
|
+
import { AppShell, type DsLinkComponent, type SidebarGroup } from '@humu-tech/ui'
|
|
238
|
+
import { Link, useLocation } from 'react-router-dom'
|
|
239
|
+
|
|
240
|
+
const RouterLink: DsLinkComponent = ({ to, className, children }) => (
|
|
241
|
+
<Link to={to} className={className}>
|
|
242
|
+
{children}
|
|
243
|
+
</Link>
|
|
244
|
+
)
|
|
245
|
+
|
|
246
|
+
export function Layout({ groups, children }: { groups: SidebarGroup[]; children: React.ReactNode }) {
|
|
247
|
+
const { pathname } = useLocation()
|
|
248
|
+
return (
|
|
249
|
+
<AppShell linkComponent={RouterLink} currentPath={pathname} sidebarGroups={groups}>
|
|
250
|
+
{children}
|
|
251
|
+
</AppShell>
|
|
252
|
+
)
|
|
253
|
+
}
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
Sem `linkComponent`, o padrão é o `DefaultLink`, que renderiza um `<a href>`.
|
|
138
257
|
|
|
139
258
|
## O que o pacote entrega
|
|
140
259
|
|
|
141
260
|
| Entrada | O quê |
|
|
142
261
|
| --- | --- |
|
|
143
|
-
| `@humu-tech/ui` |
|
|
144
|
-
| `@humu-tech/ui/tokens.css` | CSS
|
|
145
|
-
| `@humu-tech/ui/tailwind-preset` |
|
|
262
|
+
| `@humu-tech/ui` | Componentes, tema, `cn` e utilitários (ESM e CommonJS, com tipos para os dois) |
|
|
263
|
+
| `@humu-tech/ui/tokens.css` | Variáveis CSS dos dois temas e as fontes |
|
|
264
|
+
| `@humu-tech/ui/tailwind-preset` | Preset do Tailwind 3 com as classes `humu-*` (ESM e CommonJS) |
|
|
146
265
|
|
|
147
|
-
|
|
266
|
+
Os bundles trazem `"use client"` (compatível com o App Router do Next.js, sem efeito no Vite). O pacote declara `sideEffects` só para `*.css`, o que deixa o bundler descartar o JavaScript dos componentes que o app não usa.
|
|
148
267
|
|
|
149
268
|
## Catálogo
|
|
150
269
|
|
|
151
|
-
Tudo é exportado da raiz: `import { X } from '@humu-tech/ui'`.
|
|
270
|
+
Tudo é exportado da raiz: `import { X } from '@humu-tech/ui'`. Exemplos e props de cada um no [Storybook](https://inovanti-bank.github.io/humu-ui/).
|
|
152
271
|
|
|
153
|
-
### Primitives
|
|
272
|
+
### Primitives
|
|
154
273
|
|
|
155
274
|
| Grupo | Componentes |
|
|
156
275
|
| --- | --- |
|
|
157
|
-
| **Formulário** | `Button` `Checkbox` `CepInput` `ColorPicker` `Combobox` `DateInput` `DateRangeInput` `DocumentInput` `FileUpload` `ImageUpload` `Input` `Label` `MaskedInput` `MoneyInput` `MultiCombobox` `OtpInput` `PasswordInput` `PercentInput` `PhoneInput` `RadioGroup` `Switch` `TextArea` |
|
|
158
|
-
| **Overlays
|
|
159
|
-
| **Exibição de dados** | `Avatar` `Badge` `Box` `Card` `CopyButton` `
|
|
160
|
-
| **Navegação
|
|
161
|
-
| **Feedback** | `FormAlert` `FullScreenLoading` `HelpHint` `Spinner` `
|
|
162
|
-
| **Tema** | `ThemeToggle` |
|
|
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` |
|
|
278
|
+
| **Exibição de dados** | `Avatar` `Badge` `Box` `Card` `ContentCard` `CopyButton` `FieldsCard` `FileInfoCard` `FilePreviewContent` `FileThumbnail` `Heading` `Logo` `Skeleton` `Sparkline` `SparklineBadge` `Text` |
|
|
279
|
+
| **Navegação e layout** | `Breadcrumb` `Separator` `Stepper` `Tabs` |
|
|
280
|
+
| **Feedback** | `Checklist` `FormAlert` `FullScreenLoading` `HelpHint` `InfoBox` `Progress` `ProgressTitle` `Spinner` `Toaster` (com `toast`, `useToast` e `dismissToast`) |
|
|
281
|
+
| **Tema** | `ThemeProvider` `ThemeToggle` `useTheme` `getThemeBootstrapScript` `THEME_STORAGE_KEY` |
|
|
163
282
|
|
|
164
|
-
### Patterns
|
|
283
|
+
### Patterns
|
|
165
284
|
|
|
166
285
|
| Grupo | Componentes |
|
|
167
286
|
| --- | --- |
|
|
168
|
-
| **Formulário** | `FormSection` `FormWithAside` `WizardShell` |
|
|
169
|
-
| **Exibição de dados** | `DataField` `DataTable` `DataTablePagination` `EmptyState` `LegalDocumentRenderer` `PanelCard` `ReadOnlyDataView` `SectionCard` `SortableColumnHeader` `TutorialCard` |
|
|
170
|
-
| **Navegação
|
|
171
|
-
| **Gráficos** | `ChartTimeSeries` `DonutChart` `HorizontalBarChart` `KpiCard` `KpiHero` `LineChart` `StackedBarChart` |
|
|
172
|
-
| **Diversos** | `CommandPalette` `DashboardBlock` `DSAccordion` `
|
|
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` |
|
|
289
|
+
| **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` |
|
|
292
|
+
|
|
293
|
+
### Utilitários
|
|
294
|
+
|
|
295
|
+
`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
|
+
|
|
297
|
+
## Migrando da 0.1.x
|
|
298
|
+
|
|
299
|
+
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).
|
|
300
|
+
|
|
301
|
+
1. **Suba com versão exata e confira as telas.** O visual muda em quase todos os componentes.
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
npm install @humu-tech/ui@0.2.0 --save-exact
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
2. **Tema.** Saem `useDsV2Theme`, os tipos `DsV2Theme` e `ThemeMode` e as props `storageKey`, `ariaLabelLight` e `ariaLabelDark` do `ThemeToggle`.
|
|
308
|
+
|
|
309
|
+
| Antes | Depois |
|
|
310
|
+
| --- | --- |
|
|
311
|
+
| `useDsV2Theme()` | `useTheme().theme` |
|
|
312
|
+
| `DsV2Theme`, `ThemeMode` | `ResolvedTheme` (`'light' \| 'dark'`) ou `ThemePreference` (`'light' \| 'dark' \| 'system'`) |
|
|
313
|
+
| `<ThemeToggle storageKey="..." />` | `<ThemeProvider storageKey="...">` envolvendo o app, com `<ThemeToggle />` dentro dele |
|
|
314
|
+
|
|
315
|
+
O `ThemeToggle` e o `useTheme` passam a exigir o `ThemeProvider`. Adicione também o script do [passo 4](#4-tema-sem-piscar-script-no-head). A preferência salva nas chaves antigas (`ds-v2-theme-preference` e `theme`) é migrada para a chave do provider na primeira leitura.
|
|
316
|
+
|
|
317
|
+
3. **Classes `v2-*` viram legado.** A lib passa a usar só tokens `humu-*`. As classes `v2-*` do preset e as variáveis `--v2-*` usadas por elas continuam funcionando, agora como apelidos, e **serão removidas numa versão futura**. Migre:
|
|
318
|
+
|
|
319
|
+
| Antes | Depois |
|
|
320
|
+
| --- | --- |
|
|
321
|
+
| `rounded-v2-*` | `rounded-humu-*` |
|
|
322
|
+
| `text-v2-{xs…6xl}` | `text-humu-size-{xs…6xl}` |
|
|
323
|
+
| `*-v2-auth-*` | `*-humu-auth-*` |
|
|
324
|
+
| `shadow-v2-2` | `shadow-humu-raised` |
|
|
325
|
+
| `duration-v2-*` / `ease-v2-*` | `duration-humu-*` / `ease-humu-*` |
|
|
326
|
+
|
|
327
|
+
Foram removidas as variáveis `--v2-spacing-*`, `--v2-font-weight-*`, `--v2-line-height-*`, `--v2-letter-spacing-*`, `--v2-font-family-sans`, `--v2-font-family-mono` (use `--humu-font-family-ibm-plex-sans`) e `--v2-elevation-0`.
|
|
328
|
+
|
|
329
|
+
4. **`FilterBarV2` agora é `FilterBar`** (props em `FilterBarProps`). `FilterBarV2` e `FilterBarV2Props` seguem exportados como apelidos.
|
|
330
|
+
|
|
331
|
+
5. **Ícones.** A lib trocou `@phosphor-icons/react` por `lucide-react`. Se o app importava Phosphor contando com a dependência da lib, instale-o por conta própria ou migre para lucide.
|
|
332
|
+
|
|
333
|
+
6. **Nomes internos que mudaram**, só relevantes se o app os usava:
|
|
334
|
+
- camada CSS `@layer ds-v2` → `@layer humu`;
|
|
335
|
+
- classes do calendário `rdp-v2`, `rdp-v2-range`, `rdp-v2-single` → `rdp-humu`, `rdp-humu-range`, `rdp-humu-single`;
|
|
336
|
+
- rolagem da `Sidebar` `.ds-v2-sidebar-nav` → `.humu-sidebar-nav`;
|
|
337
|
+
- estado recolhido da `Sidebar` salvo em `humu-sidebar-collapsed` (o valor de `ds-v2-sidebar-collapsed` ainda é lido se a chave nova não existir).
|
|
173
338
|
|
|
174
|
-
|
|
339
|
+
7. **Pode exigir ajuste em tela ou teste:**
|
|
340
|
+
- `FormAlert` passa a ser um `InfoBox` com `role="alert"` (mesmas variantes e props);
|
|
341
|
+
- `KpiCard` com `variant="danger"` é desenhado como `error`;
|
|
342
|
+
- `Dialog.Footer` e `Drawer.Footer` põem a primeira ação à esquerda e a última à direita; quem forçava `sm:!justify-between` pode tirar a classe;
|
|
343
|
+
- correções de acessibilidade (rótulos, papéis, contraste) podem mudar seletores de teste por `role` ou nome acessível.
|
|
175
344
|
|
|
176
|
-
|
|
345
|
+
8. **React 19** passa a ser aceito, além do 18.
|
|
177
346
|
|
|
178
347
|
## Repositório
|
|
179
348
|
|
|
180
|
-
[github.com/Inovanti-Bank/humu-ui](https://github.com/Inovanti-Bank/humu-ui)
|
|
349
|
+
[github.com/Inovanti-Bank/humu-ui](https://github.com/Inovanti-Bank/humu-ui): monorepo com o pacote, o Storybook e as configs compartilhadas. Licença MIT.
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
.rdp-root.rdp-humu {
|
|
2
|
+
--rdp-day-width: 36px;
|
|
3
|
+
--rdp-day-height: 36px;
|
|
4
|
+
--rdp-day_button-width: 36px;
|
|
5
|
+
--rdp-day_button-height: 36px;
|
|
6
|
+
--rdp-nav-height: 2rem;
|
|
7
|
+
--rdp-nav_button-width: 2rem;
|
|
8
|
+
--rdp-nav_button-height: 2rem;
|
|
9
|
+
--rdp-accent-color: var(--humu-background-brand-brand);
|
|
10
|
+
--rdp-accent-background-color: var(--humu-background-brand-brand);
|
|
11
|
+
--rdp-today-color: var(--humu-background-brand-brand);
|
|
12
|
+
--rdp-selected-border: 2px solid var(--humu-background-brand-brand);
|
|
13
|
+
--rdp-outside-opacity: 0.5;
|
|
14
|
+
--rdp-disabled-opacity: 0.4;
|
|
15
|
+
--rdp-weekday-text-transform: uppercase;
|
|
16
|
+
--rdp-weekday-opacity: 1;
|
|
17
|
+
margin: 0;
|
|
18
|
+
color: var(--humu-content-title);
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
.rdp-humu .rdp-day_button {
|
|
22
|
+
border-radius: var(--radius-md);
|
|
23
|
+
color: var(--humu-content-title);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
.rdp-humu .rdp-day:not(.rdp-selected) .rdp-day_button:hover:not([disabled]) {
|
|
27
|
+
background-color: var(--humu-background-surface);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
.rdp-humu .rdp-selected {
|
|
31
|
+
font-size: inherit;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
.rdp-humu .rdp-day_button:focus-visible {
|
|
35
|
+
outline: 2px solid var(--humu-background-brand-brand);
|
|
36
|
+
outline-offset: 1px;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
.rdp-humu .rdp-today .rdp-day_button {
|
|
40
|
+
color: var(--humu-background-brand-brand);
|
|
41
|
+
font-weight: 600;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
.rdp-humu .rdp-outside .rdp-day_button {
|
|
45
|
+
color: var(--humu-content-body-text);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
.rdp-humu .rdp-weekday {
|
|
49
|
+
color: var(--humu-content-subtitle);
|
|
50
|
+
font-weight: 500;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
.rdp-humu .rdp-caption_label {
|
|
54
|
+
color: var(--humu-content-title);
|
|
55
|
+
font-weight: 600;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
.rdp-humu .rdp-button_previous,
|
|
59
|
+
.rdp-humu .rdp-button_next {
|
|
60
|
+
display: inline-flex;
|
|
61
|
+
align-items: center;
|
|
62
|
+
justify-content: center;
|
|
63
|
+
border: 1px solid var(--humu-border-default);
|
|
64
|
+
border-radius: 9999px;
|
|
65
|
+
background-color: transparent;
|
|
66
|
+
color: var(--humu-content-title);
|
|
67
|
+
transition: background-color 120ms ease;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
.rdp-humu .rdp-button_previous:not([aria-disabled='true']):hover,
|
|
71
|
+
.rdp-humu .rdp-button_next:not([aria-disabled='true']):hover {
|
|
72
|
+
background-color: var(--humu-background-surface);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
.rdp-humu .rdp-button_previous:focus-visible,
|
|
76
|
+
.rdp-humu .rdp-button_next:focus-visible {
|
|
77
|
+
outline: 2px solid var(--humu-background-brand-brand);
|
|
78
|
+
outline-offset: 1px;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
.rdp-humu .rdp-button_previous[aria-disabled='true'],
|
|
82
|
+
.rdp-humu .rdp-button_next[aria-disabled='true'] {
|
|
83
|
+
opacity: 0.4;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
.rdp-humu .rdp-chevron {
|
|
87
|
+
width: 1rem;
|
|
88
|
+
height: 1rem;
|
|
89
|
+
fill: currentColor;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
.rdp-humu-single .rdp-day_button {
|
|
93
|
+
border-radius: 9999px;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
.rdp-humu-single .rdp-today:not(.rdp-selected) .rdp-day_button {
|
|
97
|
+
box-shadow: inset 0 0 0 1.5px var(--humu-background-brand-brand);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
.rdp-humu-single .rdp-selected .rdp-day_button {
|
|
101
|
+
background-color: var(--humu-background-brand-brand);
|
|
102
|
+
color: var(--humu-content-on-brand);
|
|
103
|
+
border: none;
|
|
104
|
+
font-weight: 600;
|
|
105
|
+
}
|