blockforce-design-system 2.0.4 → 2.0.6
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/MIGRATION.md +41 -33
- package/lib/ai/components.json +51 -10
- package/lib/ai/tokens.md +1 -1
- package/lib/commonjs/components/charts/bar-chart/bar-chart.comp.js +1 -1
- package/lib/commonjs/components/charts/bar-chart/bar-chart.comp.js.map +1 -1
- package/lib/commonjs/components/charts/chart-legend/chart-legend.comp.js +1 -1
- package/lib/commonjs/components/charts/chart-legend/chart-legend.comp.js.map +1 -1
- package/lib/commonjs/components/charts/chart-legend/chart-legend.styles.js +22 -15
- package/lib/commonjs/components/charts/chart-legend/chart-legend.styles.js.map +1 -1
- package/lib/commonjs/components/charts/doughnut-chart/doughnut-chart.comp.js +1 -1
- package/lib/commonjs/components/charts/doughnut-chart/doughnut-chart.comp.js.map +1 -1
- package/lib/commonjs/components/charts/line-chart/line-chart.comp.js +1 -1
- package/lib/commonjs/components/charts/line-chart/line-chart.comp.js.map +1 -1
- package/lib/commonjs/components/charts/treemap-chart/treemap-chart.comp.js +1 -1
- package/lib/commonjs/components/charts/treemap-chart/treemap-chart.comp.js.map +1 -1
- package/lib/commonjs/components/icons/icon-box/icon-box.comp.js +1 -1
- package/lib/commonjs/components/icons/icon-box/icon-box.comp.js.map +1 -1
- package/lib/commonjs/components/icons/icon-box/icon-box.styles.js +7 -4
- package/lib/commonjs/components/icons/icon-box/icon-box.styles.js.map +1 -1
- package/lib/commonjs/components/layout/card/card.styles.js +3 -52
- package/lib/commonjs/components/layout/card/card.styles.js.map +1 -1
- package/lib/commonjs/index.js +1 -1
- package/lib/commonjs/theme/gradient-border.js +51 -0
- package/lib/commonjs/theme/gradient-border.js.map +1 -0
- package/lib/index.d.ts +88 -15
- package/lib/module/components/charts/bar-chart/bar-chart.comp.js +1 -1
- package/lib/module/components/charts/bar-chart/bar-chart.comp.js.map +1 -1
- package/lib/module/components/charts/chart-legend/chart-legend.comp.js +1 -1
- package/lib/module/components/charts/chart-legend/chart-legend.comp.js.map +1 -1
- package/lib/module/components/charts/chart-legend/chart-legend.styles.js +21 -14
- package/lib/module/components/charts/chart-legend/chart-legend.styles.js.map +1 -1
- package/lib/module/components/charts/doughnut-chart/doughnut-chart.comp.js +1 -1
- package/lib/module/components/charts/doughnut-chart/doughnut-chart.comp.js.map +1 -1
- package/lib/module/components/charts/line-chart/line-chart.comp.js +1 -1
- package/lib/module/components/charts/line-chart/line-chart.comp.js.map +1 -1
- package/lib/module/components/charts/treemap-chart/treemap-chart.comp.js +1 -1
- package/lib/module/components/charts/treemap-chart/treemap-chart.comp.js.map +1 -1
- package/lib/module/components/icons/icon-box/icon-box.comp.js +1 -1
- package/lib/module/components/icons/icon-box/icon-box.comp.js.map +1 -1
- package/lib/module/components/icons/icon-box/icon-box.styles.js +7 -4
- package/lib/module/components/icons/icon-box/icon-box.styles.js.map +1 -1
- package/lib/module/components/layout/card/card.styles.js +3 -52
- package/lib/module/components/layout/card/card.styles.js.map +1 -1
- package/lib/module/index.js +1 -1
- package/lib/module/theme/gradient-border.js +51 -0
- package/lib/module/theme/gradient-border.js.map +1 -0
- package/llms-full.txt +36 -5
- package/llms.txt +10 -2
- package/package.json +1 -1
package/llms-full.txt
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Blockforce Design System 2.0.
|
|
1
|
+
# Blockforce Design System 2.0.5 (completo)
|
|
2
2
|
|
|
3
3
|
> Pacote `blockforce-design-system`. Storybook: https://designsystem.blockforce.ai
|
|
4
4
|
|
|
@@ -7,6 +7,8 @@
|
|
|
7
7
|
1. **Procure a peça antes de criar uma nova.** Card, Tag, Toast, EmptyState, IconButton, Skeleton, Pagination, DatePicker, Matrix e as peças da árvore já existem. A lista completa está em `lib/ai/components.json`.
|
|
8
8
|
2. **Nunca escreva cor, tamanho, raio ou sombra à mão.** Use o token do tema: `theme.colors.grey_2`, `theme.spacing.md`, `theme.radius.lg`, `theme.shadow.sm`. Em props de componente, use o nome (`color="primary"`, `padding="md"`).
|
|
9
9
|
3. **Cores com os nomes de sempre:** `primary` (roxo), `secondary` (teal), `grey_1`…`grey_6`, `white`. Estados em `state.*`, fundos claros de estado em `stateSubtle.*`, texto de estado em `stateText.*`, gráficos em `chart.*`.
|
|
10
|
+
- **Gráfico usa só `chart.*`, mesmo quando cada fatia é um status** (aprovado, pendente, reprovado). `DoughnutChart`, `BarChart`, `LineChart`, `TreemapChart` e `ChartLegend` nunca levam verde, laranja e vermelho de `state.*` nem hex. Bom, parcial e ruim: `chart.blue`, `chart.lightBlue` e `chart.purple`.
|
|
11
|
+
- **Como passar:** o nome (`color: 'chart.blue'`) ou nenhuma cor, que o gráfico segue a ordem de `getChartColors`.
|
|
10
12
|
4. **O gradiente é a marca e existe um só:** `theme.colors.brand.gradient`, a 45°, roxo → teal. Nunca outro ângulo nem outras cores.
|
|
11
13
|
5. **Cor de estado é só para estado.** Verde é sucesso, laranja é alerta, vermelho é erro. O teal da marca não é cor de sucesso.
|
|
12
14
|
6. **A fonte é Inter** (`theme.typography.fontFamily`). O projeto carrega a Inter de 300 a 700; o DS não carrega fonte.
|
|
@@ -29,7 +31,13 @@
|
|
|
29
31
|
## Como usar
|
|
30
32
|
|
|
31
33
|
```tsx
|
|
32
|
-
import {
|
|
34
|
+
import {
|
|
35
|
+
ThemeProvider,
|
|
36
|
+
defaultTheme,
|
|
37
|
+
Card,
|
|
38
|
+
Tag,
|
|
39
|
+
Button,
|
|
40
|
+
} from 'blockforce-design-system'
|
|
33
41
|
|
|
34
42
|
export const App = () => (
|
|
35
43
|
<ThemeProvider theme={defaultTheme}>
|
|
@@ -1302,6 +1310,7 @@ Props:
|
|
|
1302
1310
|
Gráfico de barras para comparar valores entre categorias (ex.: emissões por fornecedor).
|
|
1303
1311
|
Cada item de `data` é uma barra, com `name` e `value`.
|
|
1304
1312
|
Para evolução no tempo use LineChart; para partes de um total use DoughnutChart.
|
|
1313
|
+
Cor da barra pela paleta de gráfico (`color: 'chart.purple'`), mesmo quando a barra é um status.
|
|
1305
1314
|
|
|
1306
1315
|
|
|
1307
1316
|
Exemplo:
|
|
@@ -1331,12 +1340,19 @@ Props:
|
|
|
1331
1340
|
|
|
1332
1341
|
Legenda de gráfico: bolinha na cor da série, nome e valor opcional.
|
|
1333
1342
|
Use ao lado ou abaixo de qualquer gráfico; o DoughnutChart já monta a dele com a prop `legend`.
|
|
1343
|
+
`variant="square"` é a legenda das roscas das dashboards: quadradinho e "Nome: valor".
|
|
1334
1344
|
|
|
1335
1345
|
|
|
1336
1346
|
Exemplo:
|
|
1337
1347
|
|
|
1338
1348
|
```tsx
|
|
1339
|
-
<ChartLegend items={[{ label: 'Aprovados', color: '
|
|
1349
|
+
<ChartLegend items={[{ label: 'Aprovados', color: 'chart.blue', value: '60%' }]} />
|
|
1350
|
+
```
|
|
1351
|
+
|
|
1352
|
+
Exemplo:
|
|
1353
|
+
|
|
1354
|
+
```tsx
|
|
1355
|
+
<ChartLegend variant="square" direction="column" items={[{ label: 'Pendentes', color: 'chart.purple', value: 850 }]} />
|
|
1340
1356
|
```
|
|
1341
1357
|
|
|
1342
1358
|
Documentação: https://designsystem.blockforce.ai/?path=/docs/gráficos-chartlegend--docs
|
|
@@ -1345,6 +1361,7 @@ Props:
|
|
|
1345
1361
|
|
|
1346
1362
|
- `items` (`ChartLegendItem[]`, obrigatória): Itens da legenda, na ordem do gráfico.
|
|
1347
1363
|
- `direction` (`row` | `column`, padrão `row`): `row`: itens lado a lado, quebrando linha. `column`: um por linha, com o valor alinhado à direita.
|
|
1364
|
+
- `variant` (`square` | `dot`, padrão `dot`): Visual da legenda. - `dot`: bolinha, nome e valor em destaque (à direita no `column`). - `square`: quadradinho e "Nome: valor" na mesma linha, em texto pequeno. É o das roscas das dashboards da plataforma (cards por status).
|
|
1348
1365
|
|
|
1349
1366
|
### DoughnutChart (Gráficos)
|
|
1350
1367
|
|
|
@@ -1352,12 +1369,14 @@ Rosca que mostra partes de um total (ex.: 60% dos fornecedores aprovados).
|
|
|
1352
1369
|
`parts` são as fatias; o que faltar para chegar em `totalValue` aparece em cinza.
|
|
1353
1370
|
`legend` mostra a legenda das fatias com nome ao lado (`side`) ou abaixo (`bottom`).
|
|
1354
1371
|
Use com até 5 fatias. Com mais categorias use BarChart.
|
|
1372
|
+
As fatias usam a paleta de gráfico (`chart.*`), mesmo quando cada uma é um status: passe o nome
|
|
1373
|
+
(`color: 'chart.blue'`) ou deixe sem cor, que a rosca segue a ordem de `getChartColors`.
|
|
1355
1374
|
|
|
1356
1375
|
|
|
1357
1376
|
Exemplo:
|
|
1358
1377
|
|
|
1359
1378
|
```tsx
|
|
1360
|
-
<DoughnutChart totalValue={100} parts={[{ value: 60, color: '
|
|
1379
|
+
<DoughnutChart totalValue={100} parts={[{ value: 60, color: 'chart.blue', name: 'Aprovados' }]} />
|
|
1361
1380
|
```
|
|
1362
1381
|
|
|
1363
1382
|
Documentação: https://designsystem.blockforce.ai/?path=/docs/gráficos-doughnutchart--docs
|
|
@@ -1386,7 +1405,7 @@ Para comparar categorias sem ordem de tempo use BarChart.
|
|
|
1386
1405
|
Exemplo:
|
|
1387
1406
|
|
|
1388
1407
|
```tsx
|
|
1389
|
-
<LineChart data={dados} series={[{ dataKey: 'total', name: 'Total', color: '
|
|
1408
|
+
<LineChart data={dados} series={[{ dataKey: 'total', name: 'Total', color: 'chart.purple' }]} />
|
|
1390
1409
|
```
|
|
1391
1410
|
|
|
1392
1411
|
Documentação: https://designsystem.blockforce.ai/?path=/docs/gráficos-linechart--docs
|
|
@@ -1407,6 +1426,8 @@ Props:
|
|
|
1407
1426
|
|
|
1408
1427
|
Retângulos com área proporcional ao valor, para mostrar o peso de muitas categorias de uma vez (ex.: volume por material).
|
|
1409
1428
|
Para poucas categorias use BarChart ou DoughnutChart.
|
|
1429
|
+
Cor de cada bloco pela paleta de gráfico (`color: 'chart.lilac'`); sem cor, segue a ordem de
|
|
1430
|
+
`getChartColors`.
|
|
1410
1431
|
|
|
1411
1432
|
|
|
1412
1433
|
Exemplo:
|
|
@@ -1474,6 +1495,7 @@ Props:
|
|
|
1474
1495
|
|
|
1475
1496
|
Ícone dentro de uma caixinha com borda e sombra leve. É o ícone dos títulos de card e dos números
|
|
1476
1497
|
das dashboards. Sem `color`, o ícone vem no gradiente da marca.
|
|
1498
|
+
`shape="circle"` com `gradientBorder="animated"` é o ícone de um agente de IA ao lado do nome dele.
|
|
1477
1499
|
Use para identificar um bloco; não use como botão (use IconButton).
|
|
1478
1500
|
|
|
1479
1501
|
|
|
@@ -1483,12 +1505,20 @@ Exemplo:
|
|
|
1483
1505
|
<IconBox icon="file_list3" />
|
|
1484
1506
|
```
|
|
1485
1507
|
|
|
1508
|
+
Exemplo:
|
|
1509
|
+
|
|
1510
|
+
```tsx
|
|
1511
|
+
<IconBox icon="robot2" shape="circle" gradientBorder="animated" />
|
|
1512
|
+
```
|
|
1513
|
+
|
|
1486
1514
|
Documentação: https://designsystem.blockforce.ai/?path=/docs/imagens-e-ícones-iconbox--docs
|
|
1487
1515
|
|
|
1488
1516
|
Props:
|
|
1489
1517
|
|
|
1490
1518
|
- `icon` (`IconsName`, valores em lib/ai/icons.txt, obrigatória): Ícone mostrado dentro da caixa.
|
|
1491
1519
|
- `color` (`ThemeColors`, valores em lib/ai/tokens.md (theme.colors)): Cor do ícone (token do tema). Sem ela, o ícone usa o gradiente da marca.
|
|
1520
|
+
- `gradientBorder` (`boolean | "animated"`): Borda no gradiente da marca, como no Card. - `true`: borda fixa (1px), para destacar. - `'animated'`: borda (2px) com as cores da marca girando devagar, para algo vivo ou em andamento (um agente trabalhando). Use um por tela; quem pediu menos movimento no sistema vê a borda parada.
|
|
1521
|
+
- `shape` (`circle` | `square`, padrão `square`): Formato da caixa. `square` é o dos títulos de card e números; `circle` é para quem age (agente de IA, assistente), ao lado de um nome.
|
|
1492
1522
|
- `size` (`number`, padrão `24`): Tamanho do ícone em px. A caixa acompanha (ícone + 10px de cada lado).
|
|
1493
1523
|
|
|
1494
1524
|
### Image (Imagens e ícones)
|
|
@@ -2036,6 +2066,7 @@ Props:
|
|
|
2036
2066
|
- `getClientThemeIssues`: Confere a marca do cliente sem montar o tema. - As cores precisam estar em hex com `#` (`#1D428A` ou `#14A`), sem transparência. - `primary` precisa de contraste 4.5:1 com texto branco (é fundo de botão). - `accent` precisa de contraste 3:1 com o fundo do card (é detalhe gráfico). - `fontFamily` precisa estar na lista suportada.
|
|
2037
2067
|
- `createClientTheme`: Monta o tema com a marca de um cliente sobre a base Blockforce. Estrutura, espaços, estados e acessibilidade continuam os da Blockforce; só cor principal, cor de destaque e fonte mudam. Valor com problema (ver `getClientThemeIssues`) é ignorado e o padrão Blockforce fica no lugar. O gradiente só usa as cores do cliente quando as duas passam; com uma só, fica o gradiente Blockforce, para não misturar as marcas. A paleta de gráfico (`colors.chart`) não muda. Sem opções, devolve o tema Blockforce.
|
|
2038
2068
|
- `defaultTheme`: Tema padrão Blockforce. Montado a partir dos tokens; para mudar um valor, edite `tokens/*.tokens.json`.
|
|
2069
|
+
- `gradientBorder`: Borda no gradiente da marca (45°, roxo → teal), fixa ou girando. Fundo branco por dentro. É a borda do `Card` com `gradientBorder` e do `IconBox` com `gradientBorder`. A animada gira só uma camada com `transform`, sem repintar o conteúdo.
|
|
2039
2070
|
- `breakpointValues`: Larguras de tela em pixels, como número.
|
|
2040
2071
|
- `media`: Media queries prontas para usar dentro de styled-components. A largura do breakpoint pertence ao lado de baixo: `down('md')` inclui 768px, `up('md')` começa em 769px.
|
|
2041
2072
|
- `thinScrollbar`: Barra de rolagem fina, a mesma em toda área que rola (regra de ouro 12): 4px, polegar `grey_4` (`grey_3` no hover), trilho transparente e raio `full`. Use dentro do styled de qualquer contêiner com `overflow: auto`, em vez de escrever `::-webkit-scrollbar`.
|
package/llms.txt
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Blockforce Design System 2.0.
|
|
1
|
+
# Blockforce Design System 2.0.5
|
|
2
2
|
|
|
3
3
|
> Componentes React (styled-components) e tokens visuais da Blockforce. Pacote `blockforce-design-system`. Storybook com exemplos e props: https://designsystem.blockforce.ai
|
|
4
4
|
|
|
@@ -7,6 +7,8 @@
|
|
|
7
7
|
1. **Procure a peça antes de criar uma nova.** Card, Tag, Toast, EmptyState, IconButton, Skeleton, Pagination, DatePicker, Matrix e as peças da árvore já existem. A lista completa está em `lib/ai/components.json`.
|
|
8
8
|
2. **Nunca escreva cor, tamanho, raio ou sombra à mão.** Use o token do tema: `theme.colors.grey_2`, `theme.spacing.md`, `theme.radius.lg`, `theme.shadow.sm`. Em props de componente, use o nome (`color="primary"`, `padding="md"`).
|
|
9
9
|
3. **Cores com os nomes de sempre:** `primary` (roxo), `secondary` (teal), `grey_1`…`grey_6`, `white`. Estados em `state.*`, fundos claros de estado em `stateSubtle.*`, texto de estado em `stateText.*`, gráficos em `chart.*`.
|
|
10
|
+
- **Gráfico usa só `chart.*`, mesmo quando cada fatia é um status** (aprovado, pendente, reprovado). `DoughnutChart`, `BarChart`, `LineChart`, `TreemapChart` e `ChartLegend` nunca levam verde, laranja e vermelho de `state.*` nem hex. Bom, parcial e ruim: `chart.blue`, `chart.lightBlue` e `chart.purple`.
|
|
11
|
+
- **Como passar:** o nome (`color: 'chart.blue'`) ou nenhuma cor, que o gráfico segue a ordem de `getChartColors`.
|
|
10
12
|
4. **O gradiente é a marca e existe um só:** `theme.colors.brand.gradient`, a 45°, roxo → teal. Nunca outro ângulo nem outras cores.
|
|
11
13
|
5. **Cor de estado é só para estado.** Verde é sucesso, laranja é alerta, vermelho é erro. O teal da marca não é cor de sucesso.
|
|
12
14
|
6. **A fonte é Inter** (`theme.typography.fontFamily`). O projeto carrega a Inter de 300 a 700; o DS não carrega fonte.
|
|
@@ -29,7 +31,13 @@
|
|
|
29
31
|
## Como usar
|
|
30
32
|
|
|
31
33
|
```tsx
|
|
32
|
-
import {
|
|
34
|
+
import {
|
|
35
|
+
ThemeProvider,
|
|
36
|
+
defaultTheme,
|
|
37
|
+
Card,
|
|
38
|
+
Tag,
|
|
39
|
+
Button,
|
|
40
|
+
} from 'blockforce-design-system'
|
|
33
41
|
|
|
34
42
|
export const App = () => (
|
|
35
43
|
<ThemeProvider theme={defaultTheme}>
|