@wellingtonhlc/shared-ui 0.24.2 → 0.24.3

package/README.md

@@ -55,6 +55,10 @@ Nao inclua:
 
 | Comando | Uso |
 |---------|-----|
+| `npm run typecheck` | Valida tipos sem emitir arquivos. |
+| `npm run test` | Executa testes de contrato e acessibilidade com Vitest, Testing Library e axe. |
+| `npm run check:storybook-static` | Confere se o Storybook estatico gerado possui artefatos e stories publicas. |
+| `npm run check` | Gate local completo: typecheck, testes, build, Storybook, smoke do Storybook estatico e `npm pack --dry-run`. |
 | `npm run build` | Compila TypeScript e copia assets para `dist`. |
 | `npm run prepack` | Executado automaticamente antes de empacotar/publicar. |
 | `npm run storybook` | Sobe o Storybook local. |
@@ -74,8 +78,22 @@ Antes de publicar ou consumir localmente uma alteracao visual, gere tambem a bui
 
 ```bash
 npm run build-storybook
+npm run check:storybook-static
 ```
 
+## Qualidade publica
+
+Todo export publico deve ter pelo menos uma destas evidencias:
+
+- teste de contrato observavel em `tests/`;
+- story em `stories/` cobrindo uso real, estados e variantes;
+- justificativa explicita na spec/PR quando o export for puramente auxiliar.
+
+Componentes interativos devem preservar acessibilidade verificavel: labels, roles, atributos
+`aria-*`, estado `disabled`/`loading`/`selected` quando aplicavel, foco e callbacks publicos.
+O gate `npm run test` inclui axe em composicoes representativas e nao deve ser burlado com
+snapshots de classe completa.
+
 ## Exportacoes
 
 Entrada principal:
@@ -84,6 +102,14 @@ Entrada principal:
 import { Button, Card, Modal, Table, cn } from '@wellingtonhlc/shared-ui';
 ```
 
+Subpaths recomendados para telas grandes ou rotas lazy-loaded:
+
+```tsx
+import { Button } from '@wellingtonhlc/shared-ui/components/Button';
+import { Table } from '@wellingtonhlc/shared-ui/components/Table';
+import { cn } from '@wellingtonhlc/shared-ui/utils/cn';
+```
+
 Estilos:
 
 ```tsx
@@ -106,7 +132,7 @@ Componentes disponiveis na API publica:
 | Acoes | `Button`, `ActionPrimitives`, `AppShellActions`, `ConfirmationDialog` |
 | Feedback | `Badge`, `EmptyState`, `PageMessage`, `Tooltip`, `CopyableField` |
 | Formularios | `FieldControl`, `FieldGroup`, `TextField`, `TextareaField`, `SelectField`, `DateField`, `DecimalField`, `MultiSelectField`, `PasswordInput`, `Switch`, `RadioGroup` |
-| Consulta | `Filter` |
+| Consulta | `Filter`, `Workspace` |
 | Dados | `Table`, `Pagination`, `TabsUnderlined` |
 | Controle de renderizacao | `RenderIf`, `RenderCase` |
 | Tema | `ThemePreferencesSelector` |
@@ -187,7 +213,21 @@ Padrões do painel:
 - Use `Filter.Footer` para manter botões sempre visíveis no rodapé do painel.
 - Em telas administrativas, campos internos devem preferir `size="sm"` e não devem usar formato `rounded-full`.
 
-## Contrato público 0.1.0
+## Contrato publico atual
+
+O pacote oficial e `@wellingtonhlc/shared-ui`, publicado no npm publico (`https://registry.npmjs.org/`).
+Ele deve permanecer generico: componentes visuais, utilitarios, tokens, estilos e preset Tailwind.
+
+Fora do contrato publico:
+
+- regra de negocio;
+- services HTTP;
+- rotas;
+- permissoes;
+- schemas de dominio;
+- textos ou fluxos especificos de CRM, licencas, pagamentos, suporte, relatorios ou clientes.
+
+## Contrato publico 0.1.0
 
 A API pública pré-v1 foi limpa para evitar compatibilidade artificial em produção.
 
@@ -226,6 +266,9 @@ Tabela de historico:
 
 | Versao | Data | Tipo | Resumo | Validacao |
 |--------|------|------|--------|-----------|
+| `0.24.3` | 2026-06-18 | Patch | Amplia testes de contrato para exports publicos, adiciona gate axe e smoke do Storybook estatico ao `check`. | `npm run test`; `npm run check`. |
+| `0.24.2` | 2026-06-18 | Patch | Alinha metadados e documentacao do pacote npm publico, mantendo o contrato generico e sem regra de negocio. | `npm run build`; `npm run build-storybook`; `npm pack --dry-run`. |
+| `0.24.0` | 2026-06-17 | Minor pre-v1 | Adiciona `Workspace` e corrige a composicao de `Filter` para consultas com painel de filtros e area de resultados. | `npm run build`; build do `EloDesk.CRM`. |
 | `0.21.0` | 2026-06-17 | Minor pre-v1 | Adiciona stories para `Modal`, `Card`, `PageMessage`, `EmptyState`, `StatCard`, `SelectField`, `TextareaField`, `DateField`, `DecimalField`, `RadioGroup`, `MultiSelectField`, `TabsUnderlined`, `Tooltip`, `CopyableField`, `FieldGroup`, `FieldSkeleton`, `FieldValidationError`, `NavCard`, `Sidebar` e `AppShell`. | `npm run build`; `npm run build-storybook`. |
 | `0.1.17` | 2026-06-16 | Minor pre-v1 | Remove a variante ambigua `default` de `Button`; adiciona variants semanticas `information` e `warning`; `ConfirmationDialog` usa `information`, `question`, `warning` e `destructive` com botao principal na cor da variant; Storybook passou a gerar tokens semanticos de tema. | `npm run build`; `npm run build-storybook`; builds do `EloDesk.CRM` e `EloDesk.CRM.Portal`. |
 | `0.1.16` | 2026-06-16 | Patch | Consolida os ajustes visuais recentes do pacote para consumo no `EloDesk.CRM`. | `npm run build`; `npm run build-storybook`; validacao no `EloDesk.CRM`. |
@@ -254,9 +297,10 @@ Ao criar uma nova versao:
 
 1. Atualize `package.json`.
 2. Atualize esta tabela com versao, data, tipo, resumo e validacao.
-3. Rode `npm run build`.
-4. Publique com `npm publish`.
-5. Atualize os consumidores afetados.
+3. Rode `npm run check`.
+4. Rode `npm pack --dry-run` e revise o conteudo do pacote.
+5. Publique com `npm publish --access public --registry=https://registry.npmjs.org/`.
+6. Atualize os consumidores afetados.
 
 ## Publicacao
 
@@ -264,13 +308,15 @@ Publicacao npm:
 
 ```bash
 npm run build
-npm publish
+npm run check
+npm pack --dry-run
+npm publish --access public --registry=https://registry.npmjs.org/
 ```
 
 Quando o npm exigir OTP:
 
 ```bash
-npm publish --otp CODIGO_OTP
+npm publish --access public --registry=https://registry.npmjs.org/ --otp CODIGO_OTP
 ```
 
 Depois de publicar, atualize os consumidores:

package/dist/styles.css

@@ -3503,6 +3503,16 @@ h2.react-datepicker__current-month {
       gap: calc(var(--spacing) * 4);
     }
   }
+  .md\:text-center {
+    @media (width >= 48rem) {
+      text-align: center;
+    }
+  }
+  .md\:text-left {
+    @media (width >= 48rem) {
+      text-align: left;
+    }
+  }
   .md\:text-\[0\.8125rem\] {
     @media (width >= 48rem) {
       font-size: 0.8125rem;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@wellingtonhlc/shared-ui",
-    "version": "0.24.2",
+    "version": "0.24.3",
     "private": false,
     "type": "module",
     "main": "./dist/index.js",
@@ -11,7 +11,7 @@
     ],
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/Wellington-Henrique/EurekaCRM.Shared.UI.git"
+        "url": "git+https://github.com/Wellington-Henrique/EloDesk.CRM.Shared.UI.git"
     },
     "publishConfig": {
         "registry": "https://registry.npmjs.org/"
@@ -38,6 +38,11 @@
     "scripts": {
         "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
         "prepack": "npm run build",
+        "typecheck": "tsc -p tsconfig.json --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "check:storybook-static": "node scripts/check-storybook-static.mjs",
+        "check": "npm run typecheck && npm run test && npm run build && npm run build-storybook && npm run check:storybook-static && npm pack --dry-run",
         "storybook": "storybook dev -p 6006",
         "build-storybook": "storybook build"
     },
@@ -50,15 +55,22 @@
         "@storybook/addon-docs": "^10.4.6",
         "@storybook/react-vite": "^10.4.6",
         "@tailwindcss/postcss": "4.1.10",
+        "@testing-library/jest-dom": "^6.9.1",
+        "@testing-library/react": "^16.3.2",
+        "@testing-library/user-event": "^14.6.1",
         "@types/react": "^19.1.2",
         "@types/react-dom": "^19.1.2",
         "autoprefixer": "^10.5.0",
+        "axe-core": "^4.12.1",
+        "jsdom": "^29.1.1",
         "lucide-react": "^0.522.0",
         "postcss": "^8.5.15",
         "storybook": "^10.4.6",
         "tailwindcss": "4.1.10",
         "typescript": "~5.8.3",
-        "vite": "^8.0.16"
+        "vite": "^8.0.16",
+        "vitest": "^4.1.9",
+        "vitest-axe": "^0.1.0"
     },
     "dependencies": {
         "@radix-ui/react-dialog": "^1.1.16",