@ffid-br/tailor-ui 0.5.0 → 0.7.0

package/README.md

@@ -35,6 +35,7 @@ A fonte Raleway (e a Roboto, para números) é carregada pelo app.
 <TailorLoader />                                        {/* inline: "Carregando..." */}
 <TailorLoader variant="overlay" label="Entrando" />     {/* tela inteira, bloqueia a interação */}
 <TailorLoader variant="compact" label="Salvando" />     {/* uma linha, para botão ou célula */}
+<TailorLoader sucesso label="Relatório pronto" />     {/* depois de carregar: malha verde e check */}
 <TailorLoader detail="3 de 5 contas" />
 ```
 
@@ -48,8 +49,7 @@ Sempre expõe `role="status"` com o rótulo.
     <CinematicIntro
       onComplete={() => setMostrarIntro(false)}
       produto="Pilot"             // opcional, aparece abaixo da marca
-      overline="Alfaiataria digital"
-      slogan="Tecnologia sob medida para a sua operação"
+      slogan="Sua operação em outro nível"
       skipLabel="Pular"
     />
   )}
@@ -206,6 +206,107 @@ Notas para quem migra:
 - Sem `onRecolher`, o botão de recolher não aparece.
 - As classes novas estão no `dist`, então o `@source` da configuração já as cobre.
 
+### `TailorPageHeader` e a marca do cliente
+
+```tsx
+import { TailorBrand, TailorPageHeader, themeFromWhitelabel } from '@ffid-br/tailor-ui';
+
+const { theme, dark } = themeFromWhitelabel(client.account_info?.whitelabel);
+
+<TailorBrand theme={theme} dark={dark}>
+  <TailorPageHeader
+    eyebrow="Comercial"
+    title="Leads"
+    description="Quem chegou esta semana e o que falta para cada um avançar."
+    breadcrumbs={[{ label: 'Início', href: '/' }, { label: 'Leads' }]}
+    back={{ label: 'Voltar', onClick: () => navigate(-1) }}
+    badge={<Badge>Beta</Badge>}
+    stats={[{ label: 'novos', value: 128 }]}
+    actions={<Button>Novo lead</Button>}
+    renderLink={({ href, ...p }) => <NavLink to={href} {...p} />}
+  >
+    <Tabs />                                {/* abaixo, na largura toda */}
+  </TailorPageHeader>
+</TailorBrand>
+```
+
+O visual vem só de variáveis CSS. Sem tema, vale o padrão Tailor; com tema, o cabeçalho veste a marca do cliente.
+
+- `--tailor-brand-*` (todas as peças que aceitam marca): `primary`, `primary-text`, `text`, `text-muted`, `border`, `background`, `heading-font`, `body-font`, `heading-weight`, `heading-case`, `radius`. Os padrões ficam em `:where()`, então qualquer CSS do app sobrescreve.
+- `--tailor-header-*` (só o cabeçalho): `background`, `padding`, `rule`, `title-size`.
+- `TailorBrand` aplica um `TailorTheme` (e o `dark`, sob `.dark` ou `[data-theme="dark"]`) sem mexer no layout.
+- `themeFromWhitelabel` traduz `account_info.whitelabel` do Mongo. Ignora o azul padrão do cadastro (`#007bff`, que 107 clientes têm sem ter escolhido) e o que não for hex. A primária só vira cor de texto com contraste AA sobre o fundo. Lê também os campos propostos `colors.text_muted`, `colors.border`, `colors.dark.*`, `fonts.heading/body/heading_weight/heading_case` e `shape.radius`.
+- A fonte do cliente é carregada pelo app (ex.: link do Google Fonts).
+
+### `TailorTable`
+
+```tsx
+import { TailorTable, sumBy, type TailorTableColumn } from '@ffid-br/tailor-ui';
+
+const columns: TailorTableColumn<Agent>[] = [
+  { key: 'id', header: 'ID', type: 'id' },
+  { key: 'name', header: 'Corretor', sortable: true },
+  { key: 'leads', header: 'Leads', type: 'number', sortable: true, total: sumBy((a) => a.leads) },
+  { key: 'revenue', header: 'Receita', type: 'currency', sortable: true, total: sumBy((a) => a.revenue) },
+  { key: 'conversion', header: 'Conversão', type: 'percent' },
+  { key: 'status', header: 'Status', cell: (a) => <Badge>{a.status}</Badge> },
+];
+
+<TailorTable caption="Desempenho por corretor" columns={columns} rows={agents}
+  rowKey={(a) => a.id} defaultSort={{ key: 'revenue', direction: 'desc' }} pageSize={20} />
+```
+
+Tabela de relatório. `type` formata e alinha: `number`, `currency` e `percent` (recebe fração: 0,125 = 12,5%) vão à direita com números tabulares; `date` no formato do idioma; `id` em mono; vazio vira traço.
+
+- Ordenação: sozinha no navegador (`defaultSort`), ou controlada pelo servidor com `sort` + `onSortChange`. `aria-sort` no cabeçalho.
+- Paginação: `pageSize` (navegador) ou `pagination={{ page, totalPages, onPageChange, totalRows }}` (servidor).
+- `total` por coluna monta a linha de total, calculada sobre todas as linhas, não só a página. `sumBy` ajuda.
+- `loading` mostra o esqueleto da tabela; `empty` troca o texto de vazio; `onRowClick` deixa a linha clicável (Enter também); `stickyHeader` prende o cabeçalho.
+- Visual por `--tailor-brand-*` e `--tailor-table-*` (`font`, `padding`, `header-padding`, `header`, `sticky-top`, `top`, `background`).
+
+## Idioma e moeda
+
+Os textos dos componentes ("Carregando", "Página 1 de 2", "Próxima") e a formatação de número, moeda e data seguem o `TailorLocaleProvider`. Sem ele: pt-BR e BRL.
+
+```tsx
+<TailorLocaleProvider locale="en" currency="USD">
+  <App />
+</TailorLocaleProvider>
+
+// trocar um texto só
+<TailorLocaleProvider locale="pt-BR" messages={{ empty: 'Nada por aqui.' }}>
+```
+
+Vêm `pt-BR` e `en`; outro idioma usa os textos em inglês e formata números e datas no próprio idioma.
+
+## Retorno padrão: esqueleto, loader, sucesso e avisos
+
+Um jeito só em todo app:
+
+| Momento | Use |
+|---|---|
+| Tela ou bloco chegando | `<TailorSkeleton />` com `shape` `text`, `table`, `cards` ou `block` |
+| Carregamento sem forma conhecida | `<TailorLoader />` |
+| Campo obrigatório vazio ou inválido | `<TailorField label="Nome" required error="Preencha o nome."><input /></TailorField>`: borda e ponto vermelhos, mensagem ligada ao campo |
+| Botão salvando | `<TailorLoader variant="compact" label="Salvando" />` dentro do botão |
+| Formulário salvo | `<TailorLoader success label="Contato salvo" />` no lugar do formulário + `toast.success(...)` |
+| Modal concluído (ou falhou) | `<TailorResult status="success" title="Contato salvo" onClose={close} />` dentro do painel (`position: relative`) |
+| Relatório de parceiro carregando | `<TailorLoader logo={...} logoDark={...} progress={p} steps={[...]} messages={[...]} />` |
+| Retorno de ação em qualquer tela | `toast.success`, `toast.error`, `toast.info` |
+
+```tsx
+// uma vez, perto da raiz
+<TailorToaster />
+
+// em qualquer lugar, até fora de componente
+toast.success('Contato salvo', { description: 'Maria Souza entrou no funil Vendas' });
+toast.error('Não deu para salvar', { description: 'Sem conexão. Tente de novo.' }); // fica 8s, role="alert"
+```
+
+`<TailorTypewriter texts={[...]} />` é o efeito do ponto escrevendo, solto, para usar onde quiser.
+
+Num botão da cor da marca, troque a cor do ponto do loader: `className="[--tailor-loader-dot:#000]"`.
+
 ## Receita: transição login → app
 
 1. **No login**: marque a entrada ao enviar, desmarque se der erro e mostre o preto crescendo do botão.
@@ -276,6 +377,23 @@ Página pública: https://ffid-br.github.io/tailor-ui/ (publicada pelo workflow
 
 ## Mudanças
 
+### 0.7.0
+API em inglês, pensando na internacionalização. O que saiu na 0.6.0 mudou de nome sem alias (nenhum app usava ainda); o que os apps já usam ganhou nome em inglês e o antigo segue funcionando até a 1.0.
+- `TailorLocaleProvider`: idioma, moeda e textos dos componentes (`pt-BR` e `en`).
+- `TailorTable`: tabela de relatório com formatação por tipo, ordenação, paginação, linha de total e marca do cliente.
+- `TailorSkeleton`: esqueleto de texto, bloco, tabela e cartões com a linha verde varrendo.
+- `TailorToaster` + `toast.success/error/info`: avisos da marca; o ponto escreve o título e vira check ou X.
+- `TailorResult`: fim de modal ou formulário. O ponto do botão (`origin`) cresce até cobrir o painel com a cor do resultado, o título é escrito, e tudo recolhe no ponto antes de `onClose`.
+- `TailorField`: rótulo, campo e mensagem; com `error`, borda e ponto vermelhos, um empurrão curto e `aria-invalid`/`aria-describedby`.
+- `TailorTypewriter`: o ponto da marca como cursor; escreve, apaga e escreve a próxima frase.
+- `TailorLoader`: o ponto corre uma espiral Fibonacci com rastro verde; `success`, `logo`/`logoDark`, `progress`, `steps`, `messages`; `variant="box"` e `noPadding` (os antigos `caixa` e `semRespiro` seguem valendo).
+- 0.6.0 renomeada: `TailorMarca` → `TailorBrand`, `temaDoWhitelabel` → `themeFromWhitelabel`, `temaParaVariaveis` → `themeToVars`, `contraste` → `contrast`; props do `TailorPageHeader` em inglês; variáveis `--tailor-marca-*` → `--tailor-brand-*`, `--tailor-cabecalho-*` → `--tailor-header-*`.
+- `CinematicIntro`: `overline` e `slogan` sem texto padrão.
+
+### 0.6.0
+- `TailorPageHeader`, `TailorMarca`, `temaDoWhitelabel`: cabeçalho de página que veste a marca do cliente por variáveis CSS. Segue `--color-tailor-green`/`-ink` do app quando definidos.
+- Simulador de mascotes na página de exemplos (`#simulador`).
+
 ### 0.5.0
 - `AgenteMascote` `estilo="vetor"`: 11 agentes, olhar que segue o cursor, 9 expressões nos olhos, temas de datas, acessórios, objetos e balão de fala. Estados novos: `parado`, `cumprimentando`, `falando`, `erro`.
 - `EquipeDock`: prop `estilo` e equipe trabalhando no botão.