@masterkeymaterial/ui 0.0.1

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.
package/README.md ADDED
@@ -0,0 +1,83 @@
1
+ # @masterkeymaterial/ui
2
+
3
+ Biblioteca Angular com componentes de UI e campos de formulario reutilizaveis para montar formularios dinamicos.
4
+
5
+ ## Instalacao
6
+
7
+ ```bash
8
+ npm install @masterkeymaterial/ui
9
+ ```
10
+
11
+ ## Peer Dependencies
12
+
13
+ Esta biblioteca depende das versoes abaixo no projeto consumidor:
14
+
15
+ ```json
16
+ {
17
+ "@angular/common": "^21.2.0",
18
+ "@angular/core": "^21.2.0",
19
+ "@angular/platform-browser": "^21.2.0"
20
+ }
21
+ ```
22
+
23
+ ## Uso Rapido
24
+
25
+ Exemplo de uso com componente standalone:
26
+
27
+ ```ts
28
+ import { Component } from '@angular/core';
29
+ import { UiButton } from '@masterkeymaterial/ui';
30
+
31
+ @Component({
32
+ selector: 'app-root',
33
+ standalone: true,
34
+ imports: [UiButton],
35
+ template: `
36
+ <lib-ui-button
37
+ [label]="'Salvar'"
38
+ [tema]="'primario'"
39
+ />
40
+ `
41
+ })
42
+ export class AppComponent {}
43
+ ```
44
+
45
+ ## Build Da Biblioteca
46
+
47
+ ```bash
48
+ ng build MasterKeyMaterial --configuration production
49
+ ```
50
+
51
+ O artefato e gerado em `dist/master-key-material`.
52
+
53
+ ## Publicacao No npm
54
+
55
+ Com login valido no npm e permissao na org `masterkeymaterial`:
56
+
57
+ ```bash
58
+ npm publish dist/master-key-material --access public
59
+ ```
60
+
61
+ Para testar antes de publicar:
62
+
63
+ ```bash
64
+ npm publish dist/master-key-material --dry-run
65
+ ```
66
+
67
+ ## Superficie Publica
68
+
69
+ A API publica desta biblioteca e definida em `src/public-api.ts` e inclui:
70
+
71
+ - Tipos e interfaces como `IKV`, `IKV_ext`, `IFileMetadata`, `ITipoBotao`, `ITiposTema`.
72
+ - Utilitarios e base de formularios (`util`, `Formulario`, `BaseFieldsValues`, `BaseFieldsForm`).
73
+ - Elementos de UI (`ui-button`, `ui-chip`, `ui-drop-zone`, `ui-file-list`, `ui-select`, `ui-procurar`, `ui-progress`, `ui-slide`, `ui-check-box`, `ui-list-errors`, `ui-loading`, `ui-menu`).
74
+ - Componentes de formulario (`form-filter`, `form-action`, `form-no-action`, `formated-values`, `single-values`, `generic`).
75
+
76
+ ## Compatibilidade
77
+
78
+ - Angular 21.x
79
+ - Node.js 18+ recomendado
80
+
81
+ ## Licenca
82
+
83
+ MIT