@dflat-core/web 1.0.14 → 1.0.15
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/LICENSE +21 -21
- package/README.md +157 -157
- package/assets/images/dflat-icone-positif.svg +1 -1
- package/assets/images/dflat-icone.svg +1 -1
- package/assets/images/dflat-ligature.svg +1 -1
- package/core-model/lib/model/interface.generated.d.ts +40 -17
- package/fesm2022/dflat-core-web-core-data.mjs.map +1 -1
- package/fesm2022/dflat-core-web-core-model.mjs.map +1 -1
- package/fesm2022/dflat-core-web-core-services.mjs.map +1 -1
- package/fesm2022/dflat-core-web-core-ux.mjs +5 -5
- package/fesm2022/dflat-core-web-core-ux.mjs.map +1 -1
- package/fesm2022/dflat-core-web-core.mjs.map +1 -1
- package/fesm2022/dflat-core-web-system-data.mjs.map +1 -1
- package/fesm2022/dflat-core-web-system-model.mjs +4 -2
- package/fesm2022/dflat-core-web-system-model.mjs.map +1 -1
- package/fesm2022/dflat-core-web-system-root.mjs.map +1 -1
- package/fesm2022/dflat-core-web-system-ux.mjs +41 -41
- package/fesm2022/dflat-core-web-system-ux.mjs.map +1 -1
- package/fesm2022/dflat-core-web.mjs.map +1 -1
- package/package.json +12 -12
- package/scss/dflat-app.scss +83 -83
- package/system-data/lib/data-services/error-category-service.generated.d.ts +2 -1
- package/system-data/lib/data-services/permission-service.generated.d.ts +2 -1
- package/system-model/lib/model/interface.generated.d.ts +26 -47
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 Dflat
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Dflat
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,157 +1,157 @@
|
|
|
1
|
-
# @dflat-core/web
|
|
2
|
-
|
|
3
|
-
Librairies Angular de Dflat, empaquetées en un module npm unique (Angular Package Format, construit avec ng-packagr).
|
|
4
|
-
|
|
5
|
-
## Points d'entrée
|
|
6
|
-
|
|
7
|
-
| Import | Contenu |
|
|
8
|
-
| -------------------------- | ------------------------------------------------------------ |
|
|
9
|
-
| `@dflat-core/web/core` | Utilitaires, `EnvironmentBase` |
|
|
10
|
-
| `@dflat-core/web/core-model` | Modèle de base (interfaces générées depuis Dflat.Kernel.Model) |
|
|
11
|
-
| `@dflat-core/web/core-services` | Authentification, messages, menus, hub SignalR... |
|
|
12
|
-
| `@dflat-core/web/core-data` | `DataService`, `EntityDataService` |
|
|
13
|
-
| `@dflat-core/web/core-ux` | Composants, directives et services d'interface |
|
|
14
|
-
| `@dflat-core/web/system-model` | Modèle du module System (généré) |
|
|
15
|
-
| `@dflat-core/web/system-data` | Services de données du module System (générés) |
|
|
16
|
-
| `@dflat-core/web/system-root` | Permissions, clés d'entités et menus du module System |
|
|
17
|
-
| `@dflat-core/web/system-ux` | Écrans du module System, et la coquille applicative |
|
|
18
|
-
|
|
19
|
-
Ressources non TypeScript livrées dans le package :
|
|
20
|
-
|
|
21
|
-
- `assets/` : styles partagés (`site.scss`, `variables.scss`, `text.scss`...), images et polices ;
|
|
22
|
-
- `scss/` : styles globaux (`dflat-app.scss`, `core-ux.scss`, `layout/default/default-layout.scss`...).
|
|
23
|
-
|
|
24
|
-
## Coquille applicative
|
|
25
|
-
|
|
26
|
-
`system-ux` fournit, en plus des écrans du module System, tout ce qui faisait auparavant
|
|
27
|
-
l'ossature de l'application hôte (`system-ux/src/lib/app`) :
|
|
28
|
-
|
|
29
|
-
| Symbole | Rôle |
|
|
30
|
-
| --------------------------------------------------------- | ----------------------------------------------------------- |
|
|
31
|
-
| `DflatAppModule` | Socle du module racine : modules Angular et tiers, intercepteur HTTP, permissions, menus, langue |
|
|
32
|
-
| `DFlatLayoutComponent` | Mise en page : barre supérieure, menu latéral, contenu |
|
|
33
|
-
| `HomepageComponent`, `SearchComponent`, `SearchResultComponent` | Accueil et recherche globale |
|
|
34
|
-
| `UserMenuComponent`, `UserProfileComponent` | Menu et profil de l'utilisateur |
|
|
35
|
-
| `AccessDeniedComponent`, `HistoryComponent`, `DFlatSpinnerComponent` | Écrans et composants utilitaires |
|
|
36
|
-
| `DflatAppService` | Nom, logo et version de l'application (`EnvironmentBase`) |
|
|
37
|
-
| `DFlatAuthInterceptor`, `DFlatPermissionService` | Implémentations par défaut, dérivables |
|
|
38
|
-
|
|
39
|
-
Le module racine d'une application se réduit alors à :
|
|
40
|
-
|
|
41
|
-
```ts
|
|
42
|
-
@NgModule({
|
|
43
|
-
declarations: [AppComponent],
|
|
44
|
-
imports: [DflatAppModule.forRoot(environment), routing],
|
|
45
|
-
bootstrap: [AppComponent]
|
|
46
|
-
})
|
|
47
|
-
export class AppModule {}
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
`environment` implémente `EnvironmentBase` : URL de l'API, du hub et des fichiers, et, en
|
|
51
|
-
option, `appName`, `appLogoUrl` et `appVersion`, affichés par la mise en page et la page
|
|
52
|
-
d'accueil. Pour remplacer un service du socle (menus, permissions, intercepteur), il suffit
|
|
53
|
-
de le fournir après `DflatAppModule` dans les `providers` du module racine.
|
|
54
|
-
|
|
55
|
-
La recherche globale n'interroge que les sources déclarées par l'application : une classe
|
|
56
|
-
dérivée de `DflatSearchProvider` par famille d'objets, fournie en `multi` sous le jeton
|
|
57
|
-
`DFLAT_SEARCH_PROVIDERS`.
|
|
58
|
-
|
|
59
|
-
## Construire
|
|
60
|
-
|
|
61
|
-
```bash
|
|
62
|
-
yarn install
|
|
63
|
-
yarn build # <dépôt>/artifacts/nodejs/dflat-web (compilation partielle, publiable)
|
|
64
|
-
yarn watch # reconstruction continue pendant le développement
|
|
65
|
-
yarn run pack # <dépôt>/artifacts/nodejs/dflat-web-<version>.tgz
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
Depuis la racine du dépôt, `scripts/publish-dflat.ps1` enchaîne ces étapes :
|
|
69
|
-
|
|
70
|
-
```powershell
|
|
71
|
-
.\scripts\publish-dflat.ps1 -bw # yarn install si besoin, build, vidage du cache Angular de webapps
|
|
72
|
-
.\scripts\publish-dflat.ps1 -pn # package versionné + archive .tgz (version calculée depuis npmjs.com)
|
|
73
|
-
.\scripts\publish-dflat.ps1 -pn -Push # ... puis publication sur npmjs.com, après confirmation
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
`yarn install` applique `tools/patch-ng-packagr.js` : correctif d'un bug de ng-packagr 19.2 sur la réécriture
|
|
77
|
-
des `url()` des partials Sass (voir le commentaire du script).
|
|
78
|
-
|
|
79
|
-
## Utiliser dans un espace de travail Angular / Nx
|
|
80
|
-
|
|
81
|
-
1. Dépendance, dans `package.json` : la version publiée sur npmjs.com
|
|
82
|
-
(`"@dflat-core/web": "1.0.2"`), cas de toute application, dont celles créées par
|
|
83
|
-
`dflat -newhost`.
|
|
84
|
-
|
|
85
|
-
`webapps`, dans le dépôt, référence au contraire le dossier de sortie de ng-packagr, pour
|
|
86
|
-
développer le package et l'application en même temps :
|
|
87
|
-
|
|
88
|
-
```json
|
|
89
|
-
"@dflat-core/web": "link:../web/dflat-web/dist"
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
`yarn install` en fait un lien symbolique (`node_modules/@dflat-core/web` → `web/dflat-web/dist`) :
|
|
93
|
-
`dist` doit donc exister, produit une fois par `yarn build:dev` ou `yarn watch`. Pour
|
|
94
|
-
travailler, deux consoles :
|
|
95
|
-
|
|
96
|
-
```bash
|
|
97
|
-
yarn watch:dflat-web # depuis webapps : ng-packagr --watch sur web/dflat-web
|
|
98
|
-
yarn start # depuis webapps : nx serve
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Toute modification d'un fichier du package (TypeScript, template, style) est recompilée par
|
|
102
|
-
ng-packagr dans `dist`, et `nx serve` la reprend dans la foulée (quelques secondes), sans
|
|
103
|
-
vider le cache ni relancer le serveur.
|
|
104
|
-
|
|
105
|
-
L'application doit aussi installer les `peerDependencies` du package : les librairies
|
|
106
|
-
Angular tierces qu'il utilise (`ngx-bootstrap`, `@swimlane/ngx-datatable`, `ngx-toastr`,
|
|
107
|
-
`ng-http-loader`...) et les feuilles de style dont dépendent ses assets (`bootstrap`,
|
|
108
|
-
`bootswatch`, `font-awesome`). Le modèle `dflat-webhost` les liste déjà dans le
|
|
109
|
-
`package.json` du front qu'il génère.
|
|
110
|
-
|
|
111
|
-
2. Dans les options de build de l'application (`project.json`) :
|
|
112
|
-
|
|
113
|
-
```json
|
|
114
|
-
"preserveSymlinks": true,
|
|
115
|
-
"stylePreprocessorOptions": { "includePaths": ["node_modules", "node_modules/@dflat-core/web/assets"] },
|
|
116
|
-
"assets": [{ "input": "node_modules/@dflat-core/web/assets", "glob": "*/**", "output": "assets" }]
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
`preserveSymlinks` évite de résoudre Angular depuis `web/dflat-web/node_modules` (double instance).
|
|
120
|
-
`node_modules` dans les `includePaths` permet à `dflat-app.scss` de résoudre Bootstrap et son thème.
|
|
121
|
-
|
|
122
|
-
3. Styles globaux (`styles.scss`) :
|
|
123
|
-
|
|
124
|
-
```scss
|
|
125
|
-
@import "../../../node_modules/@dflat-core/web/scss/dflat-app.scss";
|
|
126
|
-
```
|
|
127
|
-
|
|
128
|
-
`dflat-app.scss` enchaîne les variables, Bootstrap, le thème Bootswatch, `core-ux.scss`,
|
|
129
|
-
`site.scss` et les règles de mise en page plein écran de la coquille. Pour un autre thème,
|
|
130
|
-
ne l'importez pas : reprenez son contenu dans l'application en changeant la ligne
|
|
131
|
-
`bootswatch`.
|
|
132
|
-
|
|
133
|
-
Les feuilles de style tierces qui ne passent pas par Sass (toastr, ngx-datatable,
|
|
134
|
-
bs-datepicker, font-awesome) restent dans le tableau `styles` des options de build.
|
|
135
|
-
|
|
136
|
-
## Règles propres à une librairie
|
|
137
|
-
|
|
138
|
-
La compilation partielle d'Angular est plus stricte que celle d'une application :
|
|
139
|
-
|
|
140
|
-
- **pas d'import par le barrel de sa propre librairie** (`@dflat-core/web/core-ux` depuis core-ux) : utiliser un
|
|
141
|
-
chemin relatif. Entre librairies, toujours passer par `@dflat-core/web/<librairie>` ;
|
|
142
|
-
- **toute classe déclarée par un NgModule doit être exportée** par le `src/index.ts` de sa librairie (NG3001) ;
|
|
143
|
-
- **pas de cycle d'imports entre un composant et ce qu'utilise son template** (NG3003). Pour casser un cycle :
|
|
144
|
-
`import type` lorsque le symbole ne sert qu'au typage, ou un `InjectionToken` lorsqu'un type de composant
|
|
145
|
-
est nécessaire à l'exécution (voir `core-ux/src/lib/modals/dialog-component.tokens.ts`,
|
|
146
|
-
`RowRefHost` dans `row-ref.directive.ts`) ;
|
|
147
|
-
- **pas de cycle d'imports entre une classe et sa classe parente**, même indirect : chaque point d'entrée est
|
|
148
|
-
aplati en un seul fichier et la classe fille pourrait y être émise avant la parente
|
|
149
|
-
(`Cannot access 'X' before initialization` au démarrage de l'application). `tools/check-bundles.js`, lancé par
|
|
150
|
-
`npm run build`, le détecte.
|
|
151
|
-
|
|
152
|
-
## Code généré
|
|
153
|
-
|
|
154
|
-
`codegenerator -ts -webpkg <dépôt>\web\dflat-web` écrit les librairies Dflat (core-model, system-model,
|
|
155
|
-
system-data) dans ce dossier et génère les imports en `@dflat-core/web/<librairie>`. Sans `-webpkg` (application hôte
|
|
156
|
-
hors dépôt), ces librairies ne sont pas générées : elles sont fournies par le package. `dbmanager` écrit les
|
|
157
|
-
permissions TypeScript du module System dans `system-root/src/lib`.
|
|
1
|
+
# @dflat-core/web
|
|
2
|
+
|
|
3
|
+
Librairies Angular de Dflat, empaquetées en un module npm unique (Angular Package Format, construit avec ng-packagr).
|
|
4
|
+
|
|
5
|
+
## Points d'entrée
|
|
6
|
+
|
|
7
|
+
| Import | Contenu |
|
|
8
|
+
| -------------------------- | ------------------------------------------------------------ |
|
|
9
|
+
| `@dflat-core/web/core` | Utilitaires, `EnvironmentBase` |
|
|
10
|
+
| `@dflat-core/web/core-model` | Modèle de base (interfaces générées depuis Dflat.Kernel.Model) |
|
|
11
|
+
| `@dflat-core/web/core-services` | Authentification, messages, menus, hub SignalR... |
|
|
12
|
+
| `@dflat-core/web/core-data` | `DataService`, `EntityDataService` |
|
|
13
|
+
| `@dflat-core/web/core-ux` | Composants, directives et services d'interface |
|
|
14
|
+
| `@dflat-core/web/system-model` | Modèle du module System (généré) |
|
|
15
|
+
| `@dflat-core/web/system-data` | Services de données du module System (générés) |
|
|
16
|
+
| `@dflat-core/web/system-root` | Permissions, clés d'entités et menus du module System |
|
|
17
|
+
| `@dflat-core/web/system-ux` | Écrans du module System, et la coquille applicative |
|
|
18
|
+
|
|
19
|
+
Ressources non TypeScript livrées dans le package :
|
|
20
|
+
|
|
21
|
+
- `assets/` : styles partagés (`site.scss`, `variables.scss`, `text.scss`...), images et polices ;
|
|
22
|
+
- `scss/` : styles globaux (`dflat-app.scss`, `core-ux.scss`, `layout/default/default-layout.scss`...).
|
|
23
|
+
|
|
24
|
+
## Coquille applicative
|
|
25
|
+
|
|
26
|
+
`system-ux` fournit, en plus des écrans du module System, tout ce qui faisait auparavant
|
|
27
|
+
l'ossature de l'application hôte (`system-ux/src/lib/app`) :
|
|
28
|
+
|
|
29
|
+
| Symbole | Rôle |
|
|
30
|
+
| --------------------------------------------------------- | ----------------------------------------------------------- |
|
|
31
|
+
| `DflatAppModule` | Socle du module racine : modules Angular et tiers, intercepteur HTTP, permissions, menus, langue |
|
|
32
|
+
| `DFlatLayoutComponent` | Mise en page : barre supérieure, menu latéral, contenu |
|
|
33
|
+
| `HomepageComponent`, `SearchComponent`, `SearchResultComponent` | Accueil et recherche globale |
|
|
34
|
+
| `UserMenuComponent`, `UserProfileComponent` | Menu et profil de l'utilisateur |
|
|
35
|
+
| `AccessDeniedComponent`, `HistoryComponent`, `DFlatSpinnerComponent` | Écrans et composants utilitaires |
|
|
36
|
+
| `DflatAppService` | Nom, logo et version de l'application (`EnvironmentBase`) |
|
|
37
|
+
| `DFlatAuthInterceptor`, `DFlatPermissionService` | Implémentations par défaut, dérivables |
|
|
38
|
+
|
|
39
|
+
Le module racine d'une application se réduit alors à :
|
|
40
|
+
|
|
41
|
+
```ts
|
|
42
|
+
@NgModule({
|
|
43
|
+
declarations: [AppComponent],
|
|
44
|
+
imports: [DflatAppModule.forRoot(environment), routing],
|
|
45
|
+
bootstrap: [AppComponent]
|
|
46
|
+
})
|
|
47
|
+
export class AppModule {}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
`environment` implémente `EnvironmentBase` : URL de l'API, du hub et des fichiers, et, en
|
|
51
|
+
option, `appName`, `appLogoUrl` et `appVersion`, affichés par la mise en page et la page
|
|
52
|
+
d'accueil. Pour remplacer un service du socle (menus, permissions, intercepteur), il suffit
|
|
53
|
+
de le fournir après `DflatAppModule` dans les `providers` du module racine.
|
|
54
|
+
|
|
55
|
+
La recherche globale n'interroge que les sources déclarées par l'application : une classe
|
|
56
|
+
dérivée de `DflatSearchProvider` par famille d'objets, fournie en `multi` sous le jeton
|
|
57
|
+
`DFLAT_SEARCH_PROVIDERS`.
|
|
58
|
+
|
|
59
|
+
## Construire
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
yarn install
|
|
63
|
+
yarn build # <dépôt>/artifacts/nodejs/dflat-web (compilation partielle, publiable)
|
|
64
|
+
yarn watch # reconstruction continue pendant le développement
|
|
65
|
+
yarn run pack # <dépôt>/artifacts/nodejs/dflat-web-<version>.tgz
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
Depuis la racine du dépôt, `scripts/publish-dflat.ps1` enchaîne ces étapes :
|
|
69
|
+
|
|
70
|
+
```powershell
|
|
71
|
+
.\scripts\publish-dflat.ps1 -bw # yarn install si besoin, build, vidage du cache Angular de webapps
|
|
72
|
+
.\scripts\publish-dflat.ps1 -pn # package versionné + archive .tgz (version calculée depuis npmjs.com)
|
|
73
|
+
.\scripts\publish-dflat.ps1 -pn -Push # ... puis publication sur npmjs.com, après confirmation
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
`yarn install` applique `tools/patch-ng-packagr.js` : correctif d'un bug de ng-packagr 19.2 sur la réécriture
|
|
77
|
+
des `url()` des partials Sass (voir le commentaire du script).
|
|
78
|
+
|
|
79
|
+
## Utiliser dans un espace de travail Angular / Nx
|
|
80
|
+
|
|
81
|
+
1. Dépendance, dans `package.json` : la version publiée sur npmjs.com
|
|
82
|
+
(`"@dflat-core/web": "1.0.2"`), cas de toute application, dont celles créées par
|
|
83
|
+
`dflat -newhost`.
|
|
84
|
+
|
|
85
|
+
`webapps`, dans le dépôt, référence au contraire le dossier de sortie de ng-packagr, pour
|
|
86
|
+
développer le package et l'application en même temps :
|
|
87
|
+
|
|
88
|
+
```json
|
|
89
|
+
"@dflat-core/web": "link:../web/dflat-web/dist"
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
`yarn install` en fait un lien symbolique (`node_modules/@dflat-core/web` → `web/dflat-web/dist`) :
|
|
93
|
+
`dist` doit donc exister, produit une fois par `yarn build:dev` ou `yarn watch`. Pour
|
|
94
|
+
travailler, deux consoles :
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
yarn watch:dflat-web # depuis webapps : ng-packagr --watch sur web/dflat-web
|
|
98
|
+
yarn start # depuis webapps : nx serve
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Toute modification d'un fichier du package (TypeScript, template, style) est recompilée par
|
|
102
|
+
ng-packagr dans `dist`, et `nx serve` la reprend dans la foulée (quelques secondes), sans
|
|
103
|
+
vider le cache ni relancer le serveur.
|
|
104
|
+
|
|
105
|
+
L'application doit aussi installer les `peerDependencies` du package : les librairies
|
|
106
|
+
Angular tierces qu'il utilise (`ngx-bootstrap`, `@swimlane/ngx-datatable`, `ngx-toastr`,
|
|
107
|
+
`ng-http-loader`...) et les feuilles de style dont dépendent ses assets (`bootstrap`,
|
|
108
|
+
`bootswatch`, `font-awesome`). Le modèle `dflat-webhost` les liste déjà dans le
|
|
109
|
+
`package.json` du front qu'il génère.
|
|
110
|
+
|
|
111
|
+
2. Dans les options de build de l'application (`project.json`) :
|
|
112
|
+
|
|
113
|
+
```json
|
|
114
|
+
"preserveSymlinks": true,
|
|
115
|
+
"stylePreprocessorOptions": { "includePaths": ["node_modules", "node_modules/@dflat-core/web/assets"] },
|
|
116
|
+
"assets": [{ "input": "node_modules/@dflat-core/web/assets", "glob": "*/**", "output": "assets" }]
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
`preserveSymlinks` évite de résoudre Angular depuis `web/dflat-web/node_modules` (double instance).
|
|
120
|
+
`node_modules` dans les `includePaths` permet à `dflat-app.scss` de résoudre Bootstrap et son thème.
|
|
121
|
+
|
|
122
|
+
3. Styles globaux (`styles.scss`) :
|
|
123
|
+
|
|
124
|
+
```scss
|
|
125
|
+
@import "../../../node_modules/@dflat-core/web/scss/dflat-app.scss";
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
`dflat-app.scss` enchaîne les variables, Bootstrap, le thème Bootswatch, `core-ux.scss`,
|
|
129
|
+
`site.scss` et les règles de mise en page plein écran de la coquille. Pour un autre thème,
|
|
130
|
+
ne l'importez pas : reprenez son contenu dans l'application en changeant la ligne
|
|
131
|
+
`bootswatch`.
|
|
132
|
+
|
|
133
|
+
Les feuilles de style tierces qui ne passent pas par Sass (toastr, ngx-datatable,
|
|
134
|
+
bs-datepicker, font-awesome) restent dans le tableau `styles` des options de build.
|
|
135
|
+
|
|
136
|
+
## Règles propres à une librairie
|
|
137
|
+
|
|
138
|
+
La compilation partielle d'Angular est plus stricte que celle d'une application :
|
|
139
|
+
|
|
140
|
+
- **pas d'import par le barrel de sa propre librairie** (`@dflat-core/web/core-ux` depuis core-ux) : utiliser un
|
|
141
|
+
chemin relatif. Entre librairies, toujours passer par `@dflat-core/web/<librairie>` ;
|
|
142
|
+
- **toute classe déclarée par un NgModule doit être exportée** par le `src/index.ts` de sa librairie (NG3001) ;
|
|
143
|
+
- **pas de cycle d'imports entre un composant et ce qu'utilise son template** (NG3003). Pour casser un cycle :
|
|
144
|
+
`import type` lorsque le symbole ne sert qu'au typage, ou un `InjectionToken` lorsqu'un type de composant
|
|
145
|
+
est nécessaire à l'exécution (voir `core-ux/src/lib/modals/dialog-component.tokens.ts`,
|
|
146
|
+
`RowRefHost` dans `row-ref.directive.ts`) ;
|
|
147
|
+
- **pas de cycle d'imports entre une classe et sa classe parente**, même indirect : chaque point d'entrée est
|
|
148
|
+
aplati en un seul fichier et la classe fille pourrait y être émise avant la parente
|
|
149
|
+
(`Cannot access 'X' before initialization` au démarrage de l'application). `tools/check-bundles.js`, lancé par
|
|
150
|
+
`npm run build`, le détecte.
|
|
151
|
+
|
|
152
|
+
## Code généré
|
|
153
|
+
|
|
154
|
+
`codegenerator -ts -webpkg <dépôt>\web\dflat-web` écrit les librairies Dflat (core-model, system-model,
|
|
155
|
+
system-data) dans ce dossier et génère les imports en `@dflat-core/web/<librairie>`. Sans `-webpkg` (application hôte
|
|
156
|
+
hors dépôt), ces librairies ne sont pas générées : elles sont fournies par le package. `dbmanager` écrit les
|
|
157
|
+
permissions TypeScript du module System dans `system-root/src/lib`.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><g stroke="currentColor" stroke-linecap="round" fill="none"><line x1="48" y1="79.3" x2="152" y2="63.3" stroke-width="15"/><line x1="74" y1="75.3" x2="74" y2="131.3" stroke-width="11"/><line x1="100" y1="71.3" x2="100" y2="101.3" stroke-width="11"/><line x1="126" y1="67.3" x2="126" y2="131.3" stroke-width="11"/></g><g fill="currentColor"><circle cx="74" cy="131.3" r="13"/><circle cx="100" cy="101.3" r="13"/><circle cx="126" cy="131.3" r="13"/></g></svg>
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><g stroke="currentColor" stroke-linecap="round" fill="none"><line x1="48" y1="79.3" x2="152" y2="63.3" stroke-width="15"/><line x1="74" y1="75.3" x2="74" y2="131.3" stroke-width="11"/><line x1="100" y1="71.3" x2="100" y2="101.3" stroke-width="11"/><line x1="126" y1="67.3" x2="126" y2="131.3" stroke-width="11"/></g><g fill="currentColor"><circle cx="74" cy="131.3" r="13"/><circle cx="100" cy="101.3" r="13"/><circle cx="126" cy="131.3" r="13"/></g></svg>
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><defs><mask id="dflat-i"><rect width="200" height="200" fill="#fff"/><g stroke="#000" stroke-linecap="round" fill="none"><line x1="48" y1="79.3" x2="152" y2="63.3" stroke-width="15"/><line x1="74" y1="75.3" x2="74" y2="131.3" stroke-width="11"/><line x1="100" y1="71.3" x2="100" y2="101.3" stroke-width="11"/><line x1="126" y1="67.3" x2="126" y2="131.3" stroke-width="11"/></g><g fill="#000"><circle cx="74" cy="131.3" r="13"/><circle cx="100" cy="101.3" r="13"/><circle cx="126" cy="131.3" r="13"/></g></mask></defs><rect width="200" height="200" rx="44" fill="#8EA7F8" mask="url(#dflat-i)"/></svg>
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><defs><mask id="dflat-i"><rect width="200" height="200" fill="#fff"/><g stroke="#000" stroke-linecap="round" fill="none"><line x1="48" y1="79.3" x2="152" y2="63.3" stroke-width="15"/><line x1="74" y1="75.3" x2="74" y2="131.3" stroke-width="11"/><line x1="100" y1="71.3" x2="100" y2="101.3" stroke-width="11"/><line x1="126" y1="67.3" x2="126" y2="131.3" stroke-width="11"/></g><g fill="#000"><circle cx="74" cy="131.3" r="13"/><circle cx="100" cy="101.3" r="13"/><circle cx="126" cy="131.3" r="13"/></g></mask></defs><rect width="200" height="200" rx="44" fill="#8EA7F8" mask="url(#dflat-i)"/></svg>
|
|
@@ -1 +1 @@
|
|
|
1
|
-
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><g stroke="currentColor" stroke-linecap="round" fill="none"><line x1="22" y1="75" x2="178" y2="51" stroke-width="16"/><line x1="61" y1="69" x2="61" y2="143" stroke-width="11"/><line x1="100" y1="63" x2="100" y2="103" stroke-width="11"/><line x1="139" y1="57" x2="139" y2="143" stroke-width="11"/></g><g fill="currentColor"><circle cx="61" cy="143" r="14"/><circle cx="100" cy="103" r="14"/><circle cx="139" cy="143" r="14"/></g></svg>
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200" width="200" height="200" role="img" aria-label="DFlat"><g stroke="currentColor" stroke-linecap="round" fill="none"><line x1="22" y1="75" x2="178" y2="51" stroke-width="16"/><line x1="61" y1="69" x2="61" y2="143" stroke-width="11"/><line x1="100" y1="63" x2="100" y2="103" stroke-width="11"/><line x1="139" y1="57" x2="139" y2="143" stroke-width="11"/></g><g fill="currentColor"><circle cx="61" cy="143" r="14"/><circle cx="100" cy="103" r="14"/><circle cx="139" cy="143" r="14"/></g></svg>
|
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
export interface ViewModel {
|
|
2
2
|
}
|
|
3
|
+
export interface ExtendedProperty {
|
|
4
|
+
EntityId?: number;
|
|
5
|
+
FieldType?: number;
|
|
6
|
+
PropertyId?: number;
|
|
7
|
+
PropertyName?: string;
|
|
8
|
+
Value?: string;
|
|
9
|
+
}
|
|
3
10
|
export declare enum ValidatorTypes {
|
|
4
11
|
None = 0,
|
|
5
12
|
MaxLength = 1,
|
|
@@ -19,18 +26,28 @@ export interface PagingViewModel {
|
|
|
19
26
|
SpecificSortClause?: string;
|
|
20
27
|
Take?: number;
|
|
21
28
|
}
|
|
22
|
-
export interface
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
29
|
+
export interface EntityViewModel extends ViewModel {
|
|
30
|
+
ExtendedProperties?: ExtendedProperty[];
|
|
31
|
+
Id?: number;
|
|
32
|
+
IsEditable?: boolean;
|
|
33
|
+
IsSelected?: boolean;
|
|
34
|
+
IsStorable?: boolean;
|
|
35
|
+
Name?: string;
|
|
36
|
+
RowVersion?: Date;
|
|
28
37
|
}
|
|
29
38
|
export interface TextWithStyle {
|
|
30
39
|
GreenText?: string;
|
|
31
40
|
RedText?: string;
|
|
32
41
|
YellowText?: string;
|
|
33
42
|
}
|
|
43
|
+
export interface INode {
|
|
44
|
+
Childrens?: INode[];
|
|
45
|
+
Code?: string;
|
|
46
|
+
Description?: string;
|
|
47
|
+
Id?: number;
|
|
48
|
+
ParentId?: number;
|
|
49
|
+
UniqueName?: string;
|
|
50
|
+
}
|
|
34
51
|
export interface FilterViewModel extends PagingViewModel {
|
|
35
52
|
AdditionalFilter?: string;
|
|
36
53
|
AggregateClause?: string;
|
|
@@ -66,15 +83,6 @@ export interface FieldValidators {
|
|
|
66
83
|
MinValue?: number;
|
|
67
84
|
ValidatorType?: ValidatorTypes;
|
|
68
85
|
}
|
|
69
|
-
export interface EntityViewModel extends ViewModel {
|
|
70
|
-
ExtendedProperties?: ExtendedProperty[];
|
|
71
|
-
Id?: number;
|
|
72
|
-
IsEditable?: boolean;
|
|
73
|
-
IsSelected?: boolean;
|
|
74
|
-
IsStorable?: boolean;
|
|
75
|
-
Name?: string;
|
|
76
|
-
RowVersion?: Date;
|
|
77
|
-
}
|
|
78
86
|
export declare enum ConditionalResults {
|
|
79
87
|
Hide = 0,
|
|
80
88
|
ReadOnly = 1
|
|
@@ -131,12 +139,21 @@ export interface FieldDescriptor {
|
|
|
131
139
|
ToolTip?: string;
|
|
132
140
|
ValueMember?: string;
|
|
133
141
|
}
|
|
142
|
+
export interface EntityFilterViewModel<T> extends FilterViewModel {
|
|
143
|
+
}
|
|
134
144
|
export declare enum ApiErrorTypes {
|
|
135
145
|
Unknown = 0,
|
|
136
146
|
DatabaseError = 1,
|
|
137
147
|
SystemError = 2,
|
|
138
148
|
UserError = 3
|
|
139
149
|
}
|
|
150
|
+
export interface TreeItem<T> {
|
|
151
|
+
checked?: boolean;
|
|
152
|
+
children?: TreeItem<T>[];
|
|
153
|
+
childrenCount?: number;
|
|
154
|
+
text?: string;
|
|
155
|
+
value?: number;
|
|
156
|
+
}
|
|
140
157
|
export interface Section {
|
|
141
158
|
FieldViewModels?: FieldDescriptor[];
|
|
142
159
|
IsCustomFieldSection?: boolean;
|
|
@@ -144,8 +161,6 @@ export interface Section {
|
|
|
144
161
|
IsTrackRecordSection?: boolean;
|
|
145
162
|
Name?: string;
|
|
146
163
|
}
|
|
147
|
-
export interface EntityFilterViewModel<T> extends FilterViewModel {
|
|
148
|
-
}
|
|
149
164
|
export interface Display {
|
|
150
165
|
baseUrl?: string;
|
|
151
166
|
completingCaracter?: string;
|
|
@@ -161,6 +176,14 @@ export interface Display {
|
|
|
161
176
|
type?: string;
|
|
162
177
|
width?: number;
|
|
163
178
|
}
|
|
179
|
+
export interface BasicNode {
|
|
180
|
+
Childrens?: INode[];
|
|
181
|
+
Code?: string;
|
|
182
|
+
Description?: string;
|
|
183
|
+
Id?: number;
|
|
184
|
+
ParentId?: number;
|
|
185
|
+
UniqueName?: string;
|
|
186
|
+
}
|
|
164
187
|
export interface ApiError {
|
|
165
188
|
ApiErrorType?: ApiErrorTypes;
|
|
166
189
|
ErrorCode?: number;
|