structra-ui 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +15 -9
  2. package/package.json +11 -10
package/README.md CHANGED
@@ -4,7 +4,19 @@ Biblioteca **Angular** da stack **Structra** para interfaces consistentes: compo
4
4
 
5
5
  **Documentação e exemplos:** [StructraLab](https://structralab.com/)
6
6
 
7
- **Peer dependencies:** `@angular/common`, `@angular/core`, `@angular/forms`, `@angular/cdk`, `@angular/material`, `@angular/router`, `@angular/animations` em **`>=17.0.0 <22.0.0`**
7
+ ## Instalação
8
+
9
+ Para instalar a Structra UI num projeto Angular, utilize:
10
+
11
+ ```bash
12
+ npm install structra-ui ag-grid-angular ag-grid-community
13
+ ```
14
+
15
+ **Observações:**
16
+
17
+ - A Structra UI declara o **Angular** (`@angular/core`, `@angular/common`, `@angular/forms`, `@angular/cdk`, `@angular/material`, `@angular/router`, `@angular/animations`) como **peer dependencies** na faixa `>=17.0.0 <22.0.0` — o seu projeto deve já satisfazer essas versões.
18
+ - Os **componentes de grid** da Structra UI (por exemplo `DataGridComponent` e a vista adaptativa com grade) dependem de **`ag-grid-angular`** e **`ag-grid-community`**, também declarados como **peer dependencies** na faixa **`>=31.3.4 <32.0.0`**. Se utilizar esses componentes, **é obrigatório** instalar esses dois pacotes no projeto consumidor (o comando acima já cobre o caso típico).
19
+ - Se a sua aplicação **não** usar nada baseado em AG Grid, pode instalar apenas `structra-ui`; o gestor de pacotes pode avisar sobre peers opcionais — pode instalar o trio acima para um ambiente alinhado à documentação ou aceitar o aviso, conforme a política do projeto.
8
20
 
9
21
  ## Build do pacote
10
22
 
@@ -15,13 +27,7 @@ npm run lib:build
15
27
  # ou: npx ng build structra-ui
16
28
  ```
17
29
 
18
- gera `dist/structra-ui/`, pronto para `npm pack` / `npm publish`.
19
-
20
- ## Instalação (aplicação consumidora)
21
-
22
- ```bash
23
- npm install structra-ui
24
- ```
30
+ gera `dist/structra-ui/`, pronto para `npm pack` / `npm publish`. O `package.json` gerado em `dist/structra-ui/` **preserva** `peerDependencies` e `dependencies` definidos em `projects/structra-ui/package.json` (incluindo Angular, AG Grid e `tslib`).
25
31
 
26
32
  ## Uso
27
33
 
@@ -29,7 +35,7 @@ npm install structra-ui
29
35
  import { STRUCTRA_UI, BaseButtonComponent } from 'structra-ui';
30
36
  ```
31
37
 
32
- Os estilos globais (tokens, Material, ag-Grid, CDK) seguem os do StructraLab; nas apps consumidoras importe o `styles.scss` principal do produto ou replique os `@use` de tema conforme a documentação interna.
38
+ Os estilos globais (tokens, Material, AG Grid, CDK) seguem os do StructraLab; nas apps consumidoras importe o `styles.scss` principal do produto ou replique os `@use` de tema conforme a documentação interna.
33
39
 
34
40
  ## Licença
35
41
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "structra-ui",
3
- "version": "0.1.10",
4
- "description": "Biblioteca de componente Angular StructraLabs.",
3
+ "version": "0.1.12",
4
+ "description": "Biblioteca de componentes Angular da StructraLab (UI reutilizável).",
5
5
  "homepage": "https://structralab.com/",
6
6
  "license": "MIT",
7
7
  "sideEffects": false,
@@ -11,20 +11,21 @@
11
11
  "angular18",
12
12
  "angular19",
13
13
  "angular20",
14
- "angular21",
15
14
  "ui",
16
15
  "structra",
17
16
  "structra-ui",
18
17
  "structralab"
19
18
  ],
20
19
  "peerDependencies": {
21
- "@angular/animations": ">=17.0.0 <22.0.0",
22
- "@angular/cdk": ">=17.0.0 <22.0.0",
23
- "@angular/common": ">=17.0.0 <22.0.0",
24
- "@angular/core": ">=17.0.0 <22.0.0",
25
- "@angular/forms": ">=17.0.0 <22.0.0",
26
- "@angular/material": ">=17.0.0 <22.0.0",
27
- "@angular/router": ">=17.0.0 <22.0.0"
20
+ "@angular/animations": ">=17.0.0 <21.0.0",
21
+ "@angular/cdk": ">=17.0.0 <21.0.0",
22
+ "@angular/common": ">=17.0.0 <21.0.0",
23
+ "@angular/core": ">=17.0.0 <21.0.0",
24
+ "@angular/forms": ">=17.0.0 <21.0.0",
25
+ "@angular/material": ">=17.0.0 <21.0.0",
26
+ "@angular/router": ">=17.0.0 <21.0.0",
27
+ "ag-grid-angular": ">=31.3.4 <32.0.0",
28
+ "ag-grid-community": ">=31.3.4 <32.0.0"
28
29
  },
29
30
  "dependencies": {
30
31
  "tslib": "^2.3.0"