structra-ui 0.1.28 → 0.1.29

package/README.md

@@ -19,37 +19,20 @@ Se usar **npm 6 ou anterior**, instale explicitamente os mesmos pacotes e versõ
 - **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.
 
-## Estilos globais (obrigatório)
+## Estilos globais (automático)
 
-O pacote publica **`structra-ui.css`** (tema completo: tokens, Material, AG Grid, CDK, etc.) e **`structra-ui.scss`**, que só faz `@include meta.load-css('structra-ui.css')` — **o mesmo ficheiro CSS na pasta do pacote**. Isto evita colocar centenas de KB de CSS comprimido num único `.scss`, situação em que alguns builds do Angular no projeto consumidor **deixam de aplicar** os estilos globais.
+**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.
 
-**`angular.json`:** no **início** de `projects.<app>.architect.build.options.styles`, use **uma** destas entradas (ambas válidas):
+Requisitos no projeto destino:
 
-```json
-"styles": [
-  "node_modules/structra-ui/structra-ui.scss",
-  "src/styles.scss"
-]
-```
-
-ou, se o projeto aceitar `.css` na lista:
-
-```json
-"styles": [
-  "node_modules/structra-ui/structra-ui.css",
-  "src/styles.scss"
-]
-```
+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`** ao lado de `fesm2022/structra-ui.mjs` (o tarball gerado por `npm pack` / npm já inclui ambos).
 
-**`main.ts` (alternativa):** antes de `bootstrapApplication`:
-
-```ts
-import 'structra-ui/styles';
-```
+**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».
 
-(isso resolve para `structra-ui.css` via `exports` do pacote. Exige `moduleResolution` compatível, por exemplo `bundler` ou `node16`.)
+**`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'`.
 
-**Checklist se «não há estilos nenhuns»:** (1) linha acima no **início** de `styles`; (2) pacote instalado com **`npm run lib:build`** antes de publicar (não publique só `ng build structra-ui`); (3) **duas** entradas no npm — `structra-ui.css` e `structra-ui.scss` — têm de existir lado a lado em `node_modules/structra-ui/` (o `.scss` não funciona sem o `.css`).
+**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'`.
 
 **AG Grid 35+:** registe os módulos Community uma vez na app (ex. `ModuleRegistry.registerModules([AllCommunityModule])` em `main.ts`).
 
@@ -63,7 +46,7 @@ A entrada publicada é **`src/structra-public-api.ts`** na raiz do monorepo (ver
 npm run lib:build
 ```
 
-Gera `dist/structra-ui/` (JavaScript + tipos + **`structra-ui.css`** + **`structra-ui.scss`** ponte). **Não use só `ng build structra-ui`** para publicar: esse comando **não** gera o tema global; o `npm run lib:build` corre o ng-packagr e depois gera o CSS e a ponte SCSS.
+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.
 
 ## Uso
 

package/fesm2022/structra-ui.mjs

@@ -1,3 +1,4 @@
+import '../structra-ui.css';
 import * as i0 from '@angular/core';
 import { booleanAttribute, HostBinding, Input, ChangeDetectionStrategy, Component, numberAttribute, ElementRef, ViewChild, inject, ChangeDetectorRef, Injector, DestroyRef, EventEmitter, Output, Directive, signal, computed, Injectable, HostListener, ViewChildren, forwardRef, ApplicationRef, afterNextRender, ContentChildren, NgZone, ViewContainerRef, TemplateRef, ContentChild } from '@angular/core';
 import { takeUntilDestroyed } from '@angular/core/rxjs-interop';

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "structra-ui",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
   "homepage": "https://structralab.com/",
   "license": "MIT",
   "sideEffects": [
     "structra-ui.css",
-    "structra-ui.scss"
+    "structra-ui.scss",
+    "fesm2022/structra-ui.mjs"
   ],
   "files": [
     "fesm2022/",