@wellingtonhlc/shared-ui 0.0.3 → 0.0.4

package/README.md

@@ -0,0 +1,164 @@
+# EloDesk CRM Shared UI
+
+Pacote de componentes visuais genericos usados pelos frontends `EloDesk.CRM` e `EloDesk.CRM.Portal`.
+
+O objetivo deste pacote e concentrar componentes base, tokens, presets e helpers de UI reutilizaveis, sem regras de negocio de dominio.
+
+## Pacote
+
+```bash
+npm install @wellingtonhlc/shared-ui
+```
+
+Uso basico:
+
+```tsx
+import { Button, Card, Page, Table } from '@wellingtonhlc/shared-ui';
+
+export function ExamplePage() {
+  return (
+    <Page.Root>
+      <Card.Root>
+        <Card.Header>
+          <Card.Title>Clientes</Card.Title>
+          <Card.Description>Consulta operacional</Card.Description>
+        </Card.Header>
+        <Card.Body>
+          <Button>Salvar</Button>
+        </Card.Body>
+      </Card.Root>
+    </Page.Root>
+  );
+}
+```
+
+## Escopo
+
+Inclua aqui apenas infraestrutura visual generica:
+
+- componentes base de interface;
+- campos de formulario reutilizaveis;
+- primitives de acao;
+- tokens, estilos e presets;
+- helpers sem dependencia de dominio.
+
+Nao inclua:
+
+- services HTTP;
+- rotas;
+- schemas de dominio;
+- permissoes;
+- regras de negocio;
+- componentes acoplados a `customer`, `supplier`, `item`, PDV, financeiro, estoque, licencas, suporte ou relatorios.
+
+## Scripts
+
+| Comando | Uso |
+|---------|-----|
+| `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. |
+| `npm run build-storybook` | Gera build estatico do Storybook. |
+
+## Exportacoes
+
+Entrada principal:
+
+```tsx
+import { Button, Card, Modal, Table, cn } from '@wellingtonhlc/shared-ui';
+```
+
+Estilos:
+
+```tsx
+import '@wellingtonhlc/shared-ui/styles.css';
+```
+
+Preset Tailwind:
+
+```ts
+import sharedUiPreset from '@wellingtonhlc/shared-ui/tailwind-preset';
+```
+
+## Componentes
+
+Componentes disponiveis na API publica:
+
+| Grupo | Componentes |
+|-------|-------------|
+| Layout | `AppShell`, `Page`, `Sidebar`, `Card`, `StatCard` |
+| Acoes | `Button`, `ActionPrimitives`, `AppShellActions`, `ConfirmationDialog` |
+| Feedback | `Badge`, `EmptyState`, `PageMessage`, `Tooltip`, `CopyableField` |
+| Formularios | `FieldControl`, `FieldGroup`, `TextField`, `TextareaField`, `SelectField`, `DateField`, `DecimalField`, `MultiSelectField`, `PasswordInput`, `Switch`, `RadioGroup` |
+| Dados | `Table`, `Pagination`, `TabsUnderlined` |
+| Controle de renderizacao | `RenderIf`, `RenderCase` |
+| Tema | `ThemePreferencesSelector` |
+
+## Padroes de implementacao
+
+- Exporte sempre o componente e seus tipos publicos em `src/index.ts`.
+- Prefira composicao por slots para componentes com partes internas (`Root`, `Header`, `Body`, `Footer`, `Actions`, etc.).
+- Evite aliases antes da v1; a API deve ser definitiva sempre que possivel.
+- Preserve nomes semanticos e contratos pequenos.
+- Use `cn` para composicao de classes.
+- Mantenha o pacote livre de regra de negocio dos consumidores.
+- Rode `npm run build` antes de publicar.
+- Valide pelo menos um consumidor quando a mudanca puder afetar runtime.
+
+## Versionamento
+
+Este pacote segue SemVer, mesmo antes da v1:
+
+- `patch`: correcoes internas sem alteracao de contrato.
+- `minor`: novos componentes, novas props opcionais ou novas variantes compativeis.
+- `major` ou `minor` com destaque pre-v1: remocao/renomeacao de API publica ou mudanca que exige migracao nos consumidores.
+
+Tabela de historico:
+
+| Versao | Data | Tipo | Resumo | Validacao |
+|--------|------|------|--------|-----------|
+| `0.0.4` | 2026-06-14 | Minor pre-v1 | Adiciona `Table.Row isInteractive` para controlar cursor de linhas interativas, com padrao `true`. | `npm run build`. |
+| `0.0.3` | 2026-06-14 | Breaking pre-v1 | Define API final de `Card` por slots explicitos; remove `<Card>` chamavel, `Card.Content` e `CardContentProps`. | `npm run build`; builds de `EloDesk.CRM` e `EloDesk.CRM.Portal`. |
+| `0.0.2` | 2026-06-14 | Minor pre-v1 | Publica pacote no npm publico com novos slots de `Card` ainda retrocompativeis. | `npm run build`. |
+| `0.0.0` | 2026-06-14 | Inicial | Publicacao inicial do pacote `@wellingtonhlc/shared-ui`. | Build do pacote. |
+
+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.
+
+## Publicacao
+
+Publicacao npm:
+
+```bash
+npm run build
+npm publish
+```
+
+Quando o npm exigir OTP:
+
+```bash
+npm publish --otp CODIGO_OTP
+```
+
+Depois de publicar, atualize os consumidores:
+
+```bash
+npm install @wellingtonhlc/shared-ui@^VERSAO
+npm run build
+```
+
+Se o consumidor estiver com dev server Vite em execucao, reinicie com cache limpo:
+
+```powershell
+Remove-Item -Recurse -Force node_modules\.vite -ErrorAction SilentlyContinue
+npm run dev -- --force
+```
+
+## Template de demanda
+
+Use `docs/templates/novo-componente-shared-ui.md` quando solicitar um novo componente para este pacote.

package/dist/components/Table.d.ts

@@ -5,6 +5,9 @@ interface TableRootProps extends TableHTMLAttributes<HTMLTableElement> {
     density?: 'default' | 'compact';
     wrapperClassName?: string;
 }
+interface TableRowProps extends HTMLAttributes<HTMLTableRowElement> {
+    isInteractive?: boolean;
+}
 interface TableActionProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: 'default' | 'ghost' | 'danger';
     tooltip?: string;
@@ -14,7 +17,7 @@ export declare const Table: {
     Header: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & import("react").RefAttributes<HTMLTableSectionElement>>;
     Body: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & import("react").RefAttributes<HTMLTableSectionElement>>;
     Footer: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableSectionElement> & import("react").RefAttributes<HTMLTableSectionElement>>;
-    Row: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLTableRowElement> & import("react").RefAttributes<HTMLTableRowElement>>;
+    Row: import("react").ForwardRefExoticComponent<TableRowProps & import("react").RefAttributes<HTMLTableRowElement>>;
     Head: import("react").ForwardRefExoticComponent<ThHTMLAttributes<HTMLTableCellElement> & import("react").RefAttributes<HTMLTableCellElement>>;
     Cell: import("react").ForwardRefExoticComponent<TdHTMLAttributes<HTMLTableCellElement> & import("react").RefAttributes<HTMLTableCellElement>>;
     ActionCell: import("react").ForwardRefExoticComponent<TdHTMLAttributes<HTMLTableCellElement> & import("react").RefAttributes<HTMLTableCellElement>>;

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

@@ -1 +1 @@
-{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../src/components/Table.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,UAAU,cAAe,SAAQ,mBAAmB,CAAC,gBAAgB,CAAC;IACpE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA+FD,UAAU,gBAAiB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACxE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkBD,eAAO,MAAM,KAAK;;;;;;;;;;;CAWjB,CAAC"}
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../src/components/Table.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,OAAO,CAAC;AAIf,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,UAAU,cAAe,SAAQ,mBAAmB,CAAC,gBAAgB,CAAC;IACpE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAwDD,UAAU,aAAc,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAmDD,UAAU,gBAAiB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IACxE,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkBD,eAAO,MAAM,KAAK;;;;;;;;;;;CAWjB,CAAC"}

package/dist/components/Table.js

@@ -16,7 +16,7 @@ const Body = forwardRef(({ className, ...props }, ref) => _jsx("tbody", { ref: r
 Body.displayName = 'Table.Body';
 const Footer = forwardRef(({ className, ...props }, ref) => (_jsx("tfoot", { ref: ref, className: cn('border-app-border bg-background border-t font-medium', className), ...props })));
 Footer.displayName = 'Table.Footer';
-const Row = forwardRef(({ className, ...props }, ref) => _jsx("tr", { ref: ref, className: cn('transition-colors hover:bg-[color-mix(in_srgb,var(--brand)_5%,transparent)] last:[&>td]:border-b-0', className), ...props }));
+const Row = forwardRef(({ className, isInteractive = true, ...props }, ref) => (_jsx("tr", { ref: ref, className: cn('transition-colors hover:bg-[color-mix(in_srgb,var(--brand)_5%,transparent)] last:[&>td]:border-b-0', isInteractive && 'cursor-pointer', className), ...props })));
 Row.displayName = 'Table.Row';
 const Head = forwardRef(({ className, ...props }, ref) => (_jsx("th", { ref: ref, className: cn('border-app-border bg-background-secondary sticky top-0 z-[2] whitespace-nowrap border-b px-3 py-2.5 text-left align-middle text-xs font-extrabold tracking-[0.045em] text-foreground-muted uppercase', className), ...props })));
 Head.displayName = 'Table.Head';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@wellingtonhlc/shared-ui",
-    "version": "0.0.3",
+    "version": "0.0.4",
     "private": false,
     "type": "module",
     "main": "./dist/index.js",