structra-ui 0.1.27 → 0.1.29

package/README.md

@@ -19,28 +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 inclui **só um ficheiro de tema:** **`structra-ui.scss`**. É o resultado de compilar o `styles.scss` do monorepo (tokens, Material, AG Grid, CDK, etc.): por dentro é **CSS já resolvido**, mas a extensão é **`.scss`** para alinhar com projetos que só usam SCSS no `angular.json`. Sem este ficheiro na lista `styles`, a UI fica sem estilos.
+**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`:
+Requisitos no projeto destino:
 
-```json
-"styles": [
-  "node_modules/structra-ui/structra-ui.scss",
-  "src/styles.scss"
-]
-```
-
-**`main.ts` (alternativa):** antes de `bootstrapApplication`:
+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).
 
-```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».
 
-(Exige `moduleResolution` compatível com `exports` do npm, 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'`.
 
-**Se Material ou AG Grid parecerem «sem tema»** num projeto consumidor: confirme que usa uma versão da lib construída com `npm run lib:build`. O ficheiro `structra-ui.scss` tem de trazer **todo** o CSS (incluindo prebuilt Material e folhas AG Grid) **embutido** — versões antigas do bundle deixavam `@import` para pacotes npm, que **não resolvem** dentro de `node_modules/structra-ui/`.
+**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`).
 
@@ -54,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.scss`**). **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 compila `src/styles.scss` para `structra-ui.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,22 +1,26 @@
 {
   "name": "structra-ui",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
   "homepage": "https://structralab.com/",
   "license": "MIT",
   "sideEffects": [
-    "structra-ui.scss"
+    "structra-ui.css",
+    "structra-ui.scss",
+    "fesm2022/structra-ui.mjs"
   ],
   "files": [
     "fesm2022/",
     "types/",
+    "structra-ui.css",
     "structra-ui.scss",
     "README.md",
     "package.json"
   ],
   "exports": {
+    "./structra-ui.css": "./structra-ui.css",
     "./structra-ui.scss": "./structra-ui.scss",
-    "./styles": "./structra-ui.scss",
+    "./styles": "./structra-ui.css",
     "./global.scss": "./structra-ui.scss",
     "./package.json": {
       "default": "./package.json"