blockforce-design-system 2.0.3 → 2.0.4
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 +23 -19
- package/lib/ai/components.json +106 -1
- package/lib/ai/tokens.md +1 -1
- package/lib/commonjs/components/data-display/calendar/calendar.styles.js +14 -13
- package/lib/commonjs/components/data-display/calendar/calendar.styles.js.map +1 -1
- package/lib/commonjs/components/data-display/matrix/matrix.styles.js +22 -21
- package/lib/commonjs/components/data-display/matrix/matrix.styles.js.map +1 -1
- package/lib/commonjs/components/data-display/side-panel/side-panel.styles.js +11 -10
- package/lib/commonjs/components/data-display/side-panel/side-panel.styles.js.map +1 -1
- package/lib/commonjs/components/forms/autocomplete/autocomplete.styles.js +8 -21
- package/lib/commonjs/components/forms/autocomplete/autocomplete.styles.js.map +1 -1
- package/lib/commonjs/components/layout/drawer/drawer.styles.js +7 -5
- package/lib/commonjs/components/layout/drawer/drawer.styles.js.map +1 -1
- package/lib/commonjs/components/layout/modal/modal.styles.js +7 -18
- package/lib/commonjs/components/layout/modal/modal.styles.js.map +1 -1
- package/lib/commonjs/components/layout/popover/popover.styles.js +3 -2
- package/lib/commonjs/components/layout/popover/popover.styles.js.map +1 -1
- package/lib/commonjs/components/layout/slider/slider.styles.js +5 -26
- package/lib/commonjs/components/layout/slider/slider.styles.js.map +1 -1
- package/lib/commonjs/components/layout/table/table.comp.js +1 -1
- package/lib/commonjs/components/layout/table/table.comp.js.map +1 -1
- package/lib/commonjs/components/layout/table/table.styles.js +18 -17
- package/lib/commonjs/components/layout/table/table.styles.js.map +1 -1
- package/lib/commonjs/components/layout/table-head/table-head.comp.js +1 -1
- package/lib/commonjs/components/layout/table-head/table-head.comp.js.map +1 -1
- package/lib/commonjs/components/layout/table-head/table-head.styles.js +1 -1
- package/lib/commonjs/components/layout/table-head/table-head.styles.js.map +1 -1
- package/lib/commonjs/components/layout/table-row/table-row.comp.js +1 -1
- package/lib/commonjs/components/layout/table-row/table-row.comp.js.map +1 -1
- package/lib/commonjs/components/navigation/navigation-card/navigation-card.comp.js +2 -0
- package/lib/commonjs/components/navigation/navigation-card/navigation-card.comp.js.map +1 -0
- package/lib/commonjs/components/navigation/navigation-card/navigation-card.styles.js +47 -0
- package/lib/commonjs/components/navigation/navigation-card/navigation-card.styles.js.map +1 -0
- package/lib/commonjs/components/navigation/navigation-card/navigation-cards.comp.js +2 -0
- package/lib/commonjs/components/navigation/navigation-card/navigation-cards.comp.js.map +1 -0
- package/lib/commonjs/components/navigation/navigation-sections/navigation-sections.comp.js +2 -0
- package/lib/commonjs/components/navigation/navigation-sections/navigation-sections.comp.js.map +1 -0
- package/lib/commonjs/components/navigation/navigation-sections/navigation-sections.styles.js +91 -0
- package/lib/commonjs/components/navigation/navigation-sections/navigation-sections.styles.js.map +1 -0
- package/lib/commonjs/index.js +1 -1
- package/lib/commonjs/theme/scrollbar.js +39 -0
- package/lib/commonjs/theme/scrollbar.js.map +1 -0
- package/lib/index.d.ts +112 -1
- package/lib/module/components/data-display/calendar/calendar.styles.js +17 -16
- package/lib/module/components/data-display/calendar/calendar.styles.js.map +1 -1
- package/lib/module/components/data-display/matrix/matrix.styles.js +20 -19
- package/lib/module/components/data-display/matrix/matrix.styles.js.map +1 -1
- package/lib/module/components/data-display/side-panel/side-panel.styles.js +10 -9
- package/lib/module/components/data-display/side-panel/side-panel.styles.js.map +1 -1
- package/lib/module/components/forms/autocomplete/autocomplete.styles.js +8 -21
- package/lib/module/components/forms/autocomplete/autocomplete.styles.js.map +1 -1
- package/lib/module/components/layout/drawer/drawer.styles.js +7 -5
- package/lib/module/components/layout/drawer/drawer.styles.js.map +1 -1
- package/lib/module/components/layout/modal/modal.styles.js +7 -18
- package/lib/module/components/layout/modal/modal.styles.js.map +1 -1
- package/lib/module/components/layout/popover/popover.styles.js +2 -1
- package/lib/module/components/layout/popover/popover.styles.js.map +1 -1
- package/lib/module/components/layout/slider/slider.styles.js +5 -26
- package/lib/module/components/layout/slider/slider.styles.js.map +1 -1
- package/lib/module/components/layout/table/table.comp.js +1 -1
- package/lib/module/components/layout/table/table.comp.js.map +1 -1
- package/lib/module/components/layout/table/table.styles.js +9 -8
- package/lib/module/components/layout/table/table.styles.js.map +1 -1
- package/lib/module/components/layout/table-head/table-head.comp.js +1 -1
- package/lib/module/components/layout/table-head/table-head.comp.js.map +1 -1
- package/lib/module/components/layout/table-head/table-head.styles.js +1 -1
- package/lib/module/components/layout/table-head/table-head.styles.js.map +1 -1
- package/lib/module/components/layout/table-row/table-row.comp.js +1 -1
- package/lib/module/components/layout/table-row/table-row.comp.js.map +1 -1
- package/lib/module/components/navigation/navigation-card/navigation-card.comp.js +2 -0
- package/lib/module/components/navigation/navigation-card/navigation-card.comp.js.map +1 -0
- package/lib/module/components/navigation/navigation-card/navigation-card.styles.js +47 -0
- package/lib/module/components/navigation/navigation-card/navigation-card.styles.js.map +1 -0
- package/lib/module/components/navigation/navigation-card/navigation-cards.comp.js +2 -0
- package/lib/module/components/navigation/navigation-card/navigation-cards.comp.js.map +1 -0
- package/lib/module/components/navigation/navigation-sections/navigation-sections.comp.js +2 -0
- package/lib/module/components/navigation/navigation-sections/navigation-sections.comp.js.map +1 -0
- package/lib/module/components/navigation/navigation-sections/navigation-sections.styles.js +91 -0
- package/lib/module/components/navigation/navigation-sections/navigation-sections.styles.js.map +1 -0
- package/lib/module/index.js +1 -1
- package/lib/module/theme/scrollbar.js +39 -0
- package/lib/module/theme/scrollbar.js.map +1 -0
- package/llms-full.txt +87 -2
- package/llms.txt +15 -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.3 (completo)
|
|
2
2
|
|
|
3
3
|
> Pacote `blockforce-design-system`. Storybook: https://designsystem.blockforce.ai
|
|
4
4
|
|
|
@@ -16,7 +16,15 @@
|
|
|
16
16
|
- **Como detectar:** no styled, use `media.down('md')`; no componente, `useIsMobile()`. Não invente outro corte (600, 720, 900).
|
|
17
17
|
- **Como testar:** toda tela funciona em 375px sem rolagem horizontal na página.
|
|
18
18
|
- **Como adaptar:** grade vira uma coluna. Tabela que as pessoas consultam no celular usa `mobileLayout="cards"`; as outras rolam dentro da própria tabela.
|
|
19
|
-
10. **
|
|
19
|
+
10. **Padding padrão é 16px** (`padding="md"`, `padding={2}` ou `theme.spacing.md`). Vale para página, header, card e painel.
|
|
20
|
+
- **Outro valor só quando a peça pede:** 8px entre ícone e texto, 4px dentro de etiqueta. Nunca 24px por hábito.
|
|
21
|
+
- **O espaço não soma.** Quem só embrulha (layout, área com rolagem, `main`) não tem padding. O espaço vem de quem tem o conteúdo, a página. Assim o conteúdo encosta certo no fim da área quando rola.
|
|
22
|
+
- **Header alinha com a página:** o padding lateral do header é o mesmo da página, para o breadcrumb começar na mesma linha do conteúdo.
|
|
23
|
+
11. **Raio pelo papel da peça,** não pelo gosto: campo e botão `theme.radius.md` (8px), card `radius.lg` (12px), tabela, painel e modal `radius.xl` (16px), pílula e círculo `radius.full`. Caixa de texto é campo, inclusive a do chat.
|
|
24
|
+
12. **Rolagem:** a barra é uma só em toda a tela: fina (4px), polegar `grey_4` (`grey_3` no hover), trilho transparente, raio `full`. Use o `thinScrollbar` do DS no styled de quem rola; não escreva `::-webkit-scrollbar`.
|
|
25
|
+
- **Nada por cima de área que rola.** Botão dentro de campo fica ao lado do texto (flex), não em `position: absolute` por cima. Senão a barra aparece entre o texto e o botão.
|
|
26
|
+
13. **Borda em gradiente:** `border: 1px solid transparent` com `background: <fundo> padding-box, theme.colors.brand.gradient border-box`, como no `Button variant="gradientOutlined"`. Sem `::before` com máscara.
|
|
27
|
+
14. **Nomes antigos funcionam, mas use os novos.** `CheckBox` → `Checkbox`, `DragNDrop` → `FileDropzone`, `Slider` → `Carousel`, `Treeview` → `TreeView`, `TablePagination` → `Pagination` com `totalItems`. O editor mostra os antigos riscados (`@deprecated`).
|
|
20
28
|
|
|
21
29
|
## Como usar
|
|
22
30
|
|
|
@@ -1676,6 +1684,81 @@ Props:
|
|
|
1676
1684
|
- `items` (`BreadcrumbItem[]`, obrigatória): Passos do caminho, do início até a página atual (último).
|
|
1677
1685
|
- `showLabels` (`boolean`, padrão `false`): Mostra o nome também nos passos anteriores. Por padrão, como no front, os anteriores mostram só o ícone (e o nome, quando não têm ícone).
|
|
1678
1686
|
|
|
1687
|
+
### NavigationCard (Navegação)
|
|
1688
|
+
|
|
1689
|
+
Atalho para outra tela, em card: ícone no círculo, título e descrição centralizados e a seta
|
|
1690
|
+
no canto. Use em linha, com poucos atalhos (até uns cinco), pelo NavigationCards.
|
|
1691
|
+
Para muitos atalhos ou atalhos em grupos, use NavigationSections; para link no meio do texto, TextLink.
|
|
1692
|
+
|
|
1693
|
+
|
|
1694
|
+
Exemplo:
|
|
1695
|
+
|
|
1696
|
+
```tsx
|
|
1697
|
+
<NavigationCard icon="barcode_box" title="Produtos" description="Total de produtos cadastrados" onClick={goToProducts} />
|
|
1698
|
+
```
|
|
1699
|
+
|
|
1700
|
+
Documentação: https://designsystem.blockforce.ai/?path=/docs/navegação-navigationcard--docs
|
|
1701
|
+
|
|
1702
|
+
Props:
|
|
1703
|
+
|
|
1704
|
+
- `description` (`string`, obrigatória): Uma frase sobre o que a pessoa encontra lá.
|
|
1705
|
+
- `icon` (`IconsName`, valores em lib/ai/icons.txt, obrigatória): Ícone do atalho, em gradiente dentro de um círculo.
|
|
1706
|
+
- `title` (`string`, obrigatória): Nome da tela para onde o atalho leva (ex. "Produtos").
|
|
1707
|
+
- `data-testid` (`string`, padrão `'navigation-card'`): `data-testid` do card, para testes.
|
|
1708
|
+
- `onClick` (`(() => void)`): Chamado ao clicar ou apertar Enter/Espaço. Sem ele, o card é só ilustração e não recebe foco.
|
|
1709
|
+
|
|
1710
|
+
### NavigationCards (Navegação)
|
|
1711
|
+
|
|
1712
|
+
Linha de atalhos em card (NavigationCard) no topo de uma dashboard. Os cards dividem a
|
|
1713
|
+
largura e descem para a linha de baixo quando não cabem (mínimo de 220px cada).
|
|
1714
|
+
Use com poucos atalhos (até uns cinco); para muitos ou em grupos, use NavigationSections.
|
|
1715
|
+
|
|
1716
|
+
|
|
1717
|
+
Exemplo:
|
|
1718
|
+
|
|
1719
|
+
```tsx
|
|
1720
|
+
<NavigationCards
|
|
1721
|
+
items={[
|
|
1722
|
+
{ key: 'products', icon: 'barcode_box', title: 'Produtos', description: 'Total de produtos cadastrados' },
|
|
1723
|
+
{ key: 'orders', icon: 'checkbox_circle', title: 'Pedidos de compra', description: 'Registre e acompanhe pedidos' },
|
|
1724
|
+
]}
|
|
1725
|
+
/>
|
|
1726
|
+
```
|
|
1727
|
+
|
|
1728
|
+
Documentação: https://designsystem.blockforce.ai/?path=/docs/navegação-navigationcards--docs
|
|
1729
|
+
|
|
1730
|
+
Props:
|
|
1731
|
+
|
|
1732
|
+
- `items` (`NavigationCardsItem[]`, obrigatória): Atalhos, na ordem em que aparecem (até uns cinco).
|
|
1733
|
+
|
|
1734
|
+
### NavigationSections (Navegação)
|
|
1735
|
+
|
|
1736
|
+
Painel de atalhos agrupados em seções, para o topo de módulos com muitas telas (Compliance,
|
|
1737
|
+
Relatórios). Cada atalho é uma linha com ícone em caixa, título, descrição de até duas
|
|
1738
|
+
linhas e seta. Para poucos atalhos soltos (até uns cinco), use NavigationCards.
|
|
1739
|
+
|
|
1740
|
+
|
|
1741
|
+
Exemplo:
|
|
1742
|
+
|
|
1743
|
+
```tsx
|
|
1744
|
+
<NavigationSections
|
|
1745
|
+
sections={[
|
|
1746
|
+
{
|
|
1747
|
+
key: 'register',
|
|
1748
|
+
icon: 'file_list',
|
|
1749
|
+
title: 'Cadastro & Configuração',
|
|
1750
|
+
items: [{ key: 'providers', icon: 'user_community', title: 'Fornecedores', description: 'Gerencie e monitore seus fornecedores', onClick: goToProviders }],
|
|
1751
|
+
},
|
|
1752
|
+
]}
|
|
1753
|
+
/>
|
|
1754
|
+
```
|
|
1755
|
+
|
|
1756
|
+
Documentação: https://designsystem.blockforce.ai/?path=/docs/navegação-navigationsections--docs
|
|
1757
|
+
|
|
1758
|
+
Props:
|
|
1759
|
+
|
|
1760
|
+
- `sections` (`NavigationSection[]`, obrigatória): Seções, de cima para baixo. Seção sem atalho não aparece.
|
|
1761
|
+
|
|
1679
1762
|
### Stepper (Navegação)
|
|
1680
1763
|
|
|
1681
1764
|
Passos numerados de um fluxo longo (cadastro, onboarding, cálculo), ligados pelo gradiente da marca.
|
|
@@ -1955,6 +2038,8 @@ Props:
|
|
|
1955
2038
|
- `defaultTheme`: Tema padrão Blockforce. Montado a partir dos tokens; para mudar um valor, edite `tokens/*.tokens.json`.
|
|
1956
2039
|
- `breakpointValues`: Larguras de tela em pixels, como número.
|
|
1957
2040
|
- `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
|
+
- `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`.
|
|
2042
|
+
- `thinScrollbarOnHover`: Barra fina que só aparece com o mouse em cima, para faixas que rolam de lado (ex. Carousel). No celular, sem hover, a rolagem continua pelo toque.
|
|
1958
2043
|
- `getThemeColor`: Resolve um nome de cor do tema para o valor CSS. Aceita nomes (`primary`, `success`, `grey_3`), caminhos com ponto (`brand.gradient`, `stateSubtle.error`) e, se não achar no tema, devolve o valor como veio (ex. `transparent`).
|
|
1959
2044
|
- `getThemeSize`: Resolve um tamanho de texto: `textSize` (`body`, `bodySm`, `h3`…), `body_size` e `title_size` da v1, ou o valor CSS como veio.
|
|
1960
2045
|
- `getThemeSpacing`: Resolve um espaçamento: número da escala (`2` = 16px), nome (`md` = 16px) ou valor CSS (`10px`). `0` devolve `undefined` de propósito: o Box usa 0 como "não definido" para não sobrescrever o `padding` geral.
|
package/llms.txt
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Blockforce Design System 2.0.
|
|
1
|
+
# Blockforce Design System 2.0.3
|
|
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
|
|
|
@@ -16,7 +16,15 @@
|
|
|
16
16
|
- **Como detectar:** no styled, use `media.down('md')`; no componente, `useIsMobile()`. Não invente outro corte (600, 720, 900).
|
|
17
17
|
- **Como testar:** toda tela funciona em 375px sem rolagem horizontal na página.
|
|
18
18
|
- **Como adaptar:** grade vira uma coluna. Tabela que as pessoas consultam no celular usa `mobileLayout="cards"`; as outras rolam dentro da própria tabela.
|
|
19
|
-
10. **
|
|
19
|
+
10. **Padding padrão é 16px** (`padding="md"`, `padding={2}` ou `theme.spacing.md`). Vale para página, header, card e painel.
|
|
20
|
+
- **Outro valor só quando a peça pede:** 8px entre ícone e texto, 4px dentro de etiqueta. Nunca 24px por hábito.
|
|
21
|
+
- **O espaço não soma.** Quem só embrulha (layout, área com rolagem, `main`) não tem padding. O espaço vem de quem tem o conteúdo, a página. Assim o conteúdo encosta certo no fim da área quando rola.
|
|
22
|
+
- **Header alinha com a página:** o padding lateral do header é o mesmo da página, para o breadcrumb começar na mesma linha do conteúdo.
|
|
23
|
+
11. **Raio pelo papel da peça,** não pelo gosto: campo e botão `theme.radius.md` (8px), card `radius.lg` (12px), tabela, painel e modal `radius.xl` (16px), pílula e círculo `radius.full`. Caixa de texto é campo, inclusive a do chat.
|
|
24
|
+
12. **Rolagem:** a barra é uma só em toda a tela: fina (4px), polegar `grey_4` (`grey_3` no hover), trilho transparente, raio `full`. Use o `thinScrollbar` do DS no styled de quem rola; não escreva `::-webkit-scrollbar`.
|
|
25
|
+
- **Nada por cima de área que rola.** Botão dentro de campo fica ao lado do texto (flex), não em `position: absolute` por cima. Senão a barra aparece entre o texto e o botão.
|
|
26
|
+
13. **Borda em gradiente:** `border: 1px solid transparent` com `background: <fundo> padding-box, theme.colors.brand.gradient border-box`, como no `Button variant="gradientOutlined"`. Sem `::before` com máscara.
|
|
27
|
+
14. **Nomes antigos funcionam, mas use os novos.** `CheckBox` → `Checkbox`, `DragNDrop` → `FileDropzone`, `Slider` → `Carousel`, `Treeview` → `TreeView`, `TablePagination` → `Pagination` com `totalItems`. O editor mostra os antigos riscados (`@deprecated`).
|
|
20
28
|
|
|
21
29
|
## Como usar
|
|
22
30
|
|
|
@@ -124,6 +132,11 @@ materialidade, grade de status por mês ou valores por mês.
|
|
|
124
132
|
- [ActionMenu](https://designsystem.blockforce.ai/?path=/docs/navegação-actionmenu--docs): Menu de ações de um item (editar, duplicar, excluir), aberto por um botão de três pontos.
|
|
125
133
|
- [Breadcrumb](https://designsystem.blockforce.ai/?path=/docs/navegação-breadcrumb--docs): Caminho de navegação do topo da página: ícones dos passos anteriores, seta entre eles e o nome
|
|
126
134
|
da página atual.
|
|
135
|
+
- [NavigationCard](https://designsystem.blockforce.ai/?path=/docs/navegação-navigationcard--docs): Atalho para outra tela, em card: ícone no círculo, título e descrição centralizados e a seta
|
|
136
|
+
no canto.
|
|
137
|
+
- [NavigationCards](https://designsystem.blockforce.ai/?path=/docs/navegação-navigationcards--docs): Linha de atalhos em card (NavigationCard) no topo de uma dashboard.
|
|
138
|
+
- [NavigationSections](https://designsystem.blockforce.ai/?path=/docs/navegação-navigationsections--docs): Painel de atalhos agrupados em seções, para o topo de módulos com muitas telas (Compliance,
|
|
139
|
+
Relatórios).
|
|
127
140
|
- [Stepper](https://designsystem.blockforce.ai/?path=/docs/navegação-stepper--docs): Passos numerados de um fluxo longo (cadastro, onboarding, cálculo), ligados pelo gradiente da marca.
|
|
128
141
|
- [Tabs](https://designsystem.blockforce.ai/?path=/docs/navegação-tabs-tabs--docs): Abas para alternar entre seções ou visões de um mesmo conteúdo.
|
|
129
142
|
- [TextLink](https://designsystem.blockforce.ai/?path=/docs/navegação-textlink--docs): Link em texto, na cor de link do tema, para navegar ou abrir algo.
|