structra-ui 0.1.31 → 0.1.32

package/README.md

@@ -1,59 +1,61 @@
 # structra-ui
 
-Biblioteca **Angular** da stack **Structra** para interfaces consistentes: componentes, layout de formulários e padrões de UI reutilizáveis entre produtos.
+Biblioteca **Angular 21** da Structra: componentes, formulários e padrões de UI reutilizáveis.
 
-**Documentação e exemplos:** [StructraLab](https://structralab.com/)
+**Exemplos ao vivo:** [StructraLab](https://structralab.com/)
 
 ## Instalação
 
-Com **npm 7 ou superior**, um comando instala a lib e resolve os **peer dependencies** obrigatórios na raiz do projeto (Angular, Material, CDK, Router, AG Grid, RxJS, Zone.js):
+**Com npm 7 ou superior** (recomendado): um comando instala a lib e, em geral, os **peer dependencies** na raiz do projeto.
 
 ```bash
 npm install structra-ui
 ```
 
-Se usar **npm 6 ou anterior**, instale explicitamente os mesmos pacotes e versões indicados em `peerDependencies` no `package.json` do npm.
+Com **npm 6** (ou se os peers não forem instalados), instala explicitamente o que falta. O mínimo extra em relação a uma app Angular 21 típica costuma ser **AG Grid** e **Material/CDK/Router**, se ainda não existirem:
 
-**Compatibilidade**
-
-- **Angular 21** (`^21.2.7` nos peers): sem suporte para Angular 22.
-- **Material e CDK** obrigatórios; **Router** obrigatório; **AG Grid** obrigatório; **RxJS** e **Zone.js** obrigatórios — nada é opcional no `package.json` da lib.
+```bash
+npm install structra-ui ag-grid-community ag-grid-angular @angular/material @angular/cdk @angular/router
+```
 
-## Estilos globais (automático)
+Versões: segue as gamas em `peerDependencies` do `package.json` publicado (Angular **21.2.x**, AG Grid **35.x**, etc.).
 
-**Não precisa** de adicionar nada ao `angular.json` → `styles` por causa da Structra: ao fazer `import { … } from 'structra-ui'`, o bundle publicado (`fesm2022/structra-ui.mjs`) inclui no topo `import '../structra-ui.css'`, e o **Angular Application builder** segue esse import e injeta o tema (tokens, Material, AG Grid, CDK, etc.) na app.
+## AG Grid (grelhas)
 
-Requisitos no projeto destino:
+Os componentes de **grelha** da lib dependem de **`ag-grid-community`** e **`ag-grid-angular`**. Sem estes pacotes, o build ou o runtime podem falhar ao usar esses componentes.
 
-1. **`npm run lib:build`** no monorepo antes de publicar (não publique só `ng build structra-ui`), senão o `.css` e o patch ao `.mjs` não existem.
-2. O pacote em `node_modules/structra-ui/` tem de conter **`structra-ui.css`**, **`webfonts/`** (Font Awesome), **`files/`** (Roboto via Fontsource) e `fesm2022/structra-ui.mjs`. Tipografia e ícones são **offline**, alinhados ao showcase StructraLab.
+Além disso, o AG Grid 33+ exige **registar os módulos Community uma vez** na aplicação, antes de montar qualquer grelha. Exemplo mínimo (por exemplo em `main.ts`, antes de `bootstrapApplication`):
 
-**Opcional (duplicar tema):** só se quiseres carregar o CSS **antes** de qualquer import TypeScript da lib, podes ainda listar em `angular.json` → `styles` o `node_modules/structra-ui/structra-ui.css` ou a ponte `structra-ui.scss` — não é obrigatório para «funcionar».
+```ts
+import { AllCommunityModule, ModuleRegistry } from 'ag-grid-community';
 
-**`import 'structra-ui/styles'`** em `main.ts` também funciona (export `./styles` → mesmo CSS), mas **não é necessário** se já importas componentes ou símbolos de `'structra-ui'`.
+ModuleRegistry.registerModules([AllCommunityModule]);
+```
 
-**Atenção:** `import type { … } from 'structra-ui'` é apagado em compile-time e **não** executa o módulo — o tema **não** carrega. Garante pelo menos um `import { … }` em runtime ou `import 'structra-ui/styles'`.
+## Estilos globais
 
-**AG Grid 35+:** registe os módulos Community uma vez na app (ex. `ModuleRegistry.registerModules([AllCommunityModule])` em `main.ts`).
+Ao importar algo de `structra-ui` em runtime (por exemplo `import { TextFieldComponent } from 'structra-ui'`), o tema global (Material, tokens, AG Grid, ícones, Roboto, etc.) entra pelo ficheiro publicado `structra-ui.css`. Não é obrigatório repetir isso no `angular.json` → `styles`.
 
-**Importar componentes:** `import { TextFieldComponent } from 'structra-ui';` e use em `imports: [TextFieldComponent, …]` do `@Component`. No `tsconfig.json` da app, prefira `"moduleResolution": "bundler"` ou `"node16"` para o Node resolver o campo `exports` do pacote.
+**Nota:** `import type { … } from 'structra-ui'` não carrega o CSS do tema — usa um import de valor ou `import 'structra-ui/styles'`.
 
-## Build do pacote
+## Build do pacote (mantenedores do monorepo)
 
-A entrada publicada é **`src/structra-public-api.ts`** na raiz do monorepo (ver `ng-package.json`). O comando:
+Na raiz do repositório `web-components`:
 
 ```bash
 npm run lib:build
 ```
 
-Gera `dist/structra-ui/` (JavaScript com import do tema + tipos + **`structra-ui.css`** + **`structra-ui.scss`** ponte). **Não use só `ng build structra-ui`** para publicar: o `npm run lib:build` corre o ng-packagr e depois gera o CSS, a ponte SCSS e **injeta** `import '../structra-ui.css'` no FESM.
+Gera `dist/structra-ui/` pronto para `npm pack` / `npm publish`. Não uses só `ng build structra-ui` para publicar: o tema global completa-se nesse script.
 
-## Uso
+## Uso rápido
 
 ```ts
-import { STRUCTRA_UI, BaseButtonComponent } from 'structra-ui';
+import { TextFieldComponent } from 'structra-ui';
 ```
 
+No `tsconfig` da app, convém `moduleResolution` `bundler` ou `node16` para resolver bem o campo `exports` do npm.
+
 ## Licença
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "structra-ui",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
   "homepage": "https://structralab.com/",
   "license": "MIT",