@wellingtonhlc/shared-ui 0.24.1 → 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/components/Badge.d.ts

@@ -4,6 +4,13 @@ export type BadgeSize = 'xs' | 'sm' | 'md';
 export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
     variant?: BadgeVariant | string;
     size?: BadgeSize;
+    /**
+     * Permite que o conteudo quebre em multiplas linhas quando nao couber na largura
+     * disponivel. Por padrao o badge fica em linha unica (`inline-flex` + `whitespace-nowrap`),
+     * adequado a status curtos; com `wrap` vira `inline-block` e quebra palavras longas,
+     * util para valores longos (ex.: auditoria).
+     */
+    wrap?: boolean;
 }
 export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
 //# sourceMappingURL=Badge.d.ts.map

package/dist/components/Badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/components/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAIxD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAC,eAAe,CAAC;IACjE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AA+BD,eAAO,MAAM,KAAK,wGAoBjB,CAAC"}
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../src/components/Badge.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAIxD,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,UAAW,SAAQ,cAAc,CAAC,eAAe,CAAC;IACjE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA+BD,eAAO,MAAM,KAAK,wGAuBjB,CAAC"}

package/dist/components/Badge.js

@@ -24,11 +24,13 @@ const sizeClasses = {
     sm: 'px-2.5 py-1 text-sm',
     md: 'px-3 py-1 text-base',
 };
-export const Badge = forwardRef(({ className, size = 'xs', variant = 'default', ...props }, ref) => {
+export const Badge = forwardRef(({ className, size = 'xs', variant = 'default', wrap = false, ...props }, ref) => {
     const normalizedVariant = variant.toLowerCase();
     const normalizedAlias = variantAlias[normalizedVariant] ?? normalizedVariant;
     const knownVariant = normalizedAlias;
     const variantClass = variantClasses[knownVariant] ?? normalizedVariant;
-    return (_jsx("span", { ref: ref, className: cn('inline-flex items-center gap-1.5 whitespace-nowrap rounded-full border font-medium leading-none', variantClass, sizeClasses[size], className), ...props }));
+    return (_jsx("span", { ref: ref, className: cn('rounded-full border font-medium', wrap
+            ? 'inline-block whitespace-normal break-words [overflow-wrap:anywhere] leading-snug'
+            : 'inline-flex items-center gap-1.5 whitespace-nowrap leading-none', variantClass, sizeClasses[size], className), ...props }));
 });
 Badge.displayName = 'Badge';

package/dist/styles.css

@@ -1041,6 +1041,9 @@ h2.react-datepicker__current-month {
   .inline {
     display: inline;
   }
+  .inline-block {
+    display: inline-block;
+  }
   .inline-flex {
     display: inline-flex;
   }
@@ -2194,9 +2197,18 @@ h2.react-datepicker__current-month {
     --tw-tracking: var(--tracking-wide);
     letter-spacing: var(--tracking-wide);
   }
+  .\[overflow-wrap\:anywhere\] {
+    overflow-wrap: anywhere;
+  }
+  .break-words {
+    overflow-wrap: break-word;
+  }
   .text-ellipsis {
     text-overflow: ellipsis;
   }
+  .whitespace-normal {
+    white-space: normal;
+  }
   .whitespace-nowrap {
     white-space: nowrap;
   }
@@ -3491,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.1",
+    "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",