@dsivd/prestations-ng 19.2.0-beta.3 → 19.2.0-beta.30

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 (65) hide show
  1. package/AI_GUIDELINES.md +152 -0
  2. package/ANGULAR_SIGNALS.md +6 -2
  3. package/CHANGELOG.md +476 -0
  4. package/CONTRIBUTING.md +128 -8
  5. package/ESLINT_PLUGIN.md +262 -30
  6. package/GOOD_PRACTICES.md +983 -388
  7. package/INTRODUCTION_ANGULAR_SIGNALS.md +227 -155
  8. package/README.md +22 -12
  9. package/UPGRADING_V18.md +5 -5
  10. package/UPGRADING_V19.md +636 -19
  11. package/eslint/configs/spec-ts-recommended.mjs +34 -0
  12. package/eslint/configs/template-recommended.mjs +2 -0
  13. package/eslint/configs/template-rules.mjs +14 -2
  14. package/eslint/configs/ts-recommended.mjs +11 -0
  15. package/eslint/configs/ts-rules.mjs +6 -2
  16. package/eslint/form-reads.mjs +63 -0
  17. package/eslint/index.mjs +17 -0
  18. package/eslint/rules/index.mjs +6 -0
  19. package/eslint/rules/no-direct-signal-mutation.mjs +162 -41
  20. package/eslint/rules/no-item-track-in-form-list.mjs +173 -0
  21. package/eslint/rules/no-uninvoked-signal-in-template.mjs +8 -3
  22. package/eslint/rules/require-model-change.mjs +89 -0
  23. package/eslint/rules/require-track-index.mjs +162 -0
  24. package/eslint/signal-names.mjs +127 -21
  25. package/eslint/template-ast.mjs +12 -2
  26. package/fesm2022/dsivd-prestations-ng.mjs +2889 -2061
  27. package/fesm2022/dsivd-prestations-ng.mjs.map +1 -1
  28. package/package.json +1 -2
  29. package/schematics/migration-collection.json +5 -0
  30. package/schematics/ng-add/index.js +2 -4
  31. package/schematics/ng-update/migrations/update-13_2_0/index.js +7 -2
  32. package/schematics/ng-update/migrations/update-19_2_0/index.js +52 -0
  33. package/schematics/utility/add-allowed-common-js-dependencies.js +39 -29
  34. package/schematics/utility/form-signal/class-migration.js +795 -0
  35. package/schematics/utility/form-signal/edits.js +34 -0
  36. package/schematics/utility/form-signal/form-members.js +318 -0
  37. package/schematics/utility/form-signal/form-signal-migration.js +134 -0
  38. package/schematics/utility/form-signal/page-classes.js +139 -0
  39. package/schematics/utility/form-signal/template-migration.js +775 -0
  40. package/schematics/utility/never-connected-migration.js +87 -0
  41. package/schematics/utility/remove-emit-decorator-metadata.js +8 -9
  42. package/schematics/utility/typescript-files.js +95 -0
  43. package/src/eslint/configs/__tests__/configs.test.mjs +61 -2
  44. package/src/eslint/configs/spec-ts-recommended.mjs +34 -0
  45. package/src/eslint/configs/template-recommended.mjs +2 -0
  46. package/src/eslint/configs/template-rules.mjs +14 -2
  47. package/src/eslint/configs/ts-recommended.mjs +11 -0
  48. package/src/eslint/configs/ts-rules.mjs +6 -2
  49. package/src/eslint/form-reads.mjs +63 -0
  50. package/src/eslint/index.mjs +17 -0
  51. package/src/eslint/rules/__tests__/no-direct-signal-mutation.test.mjs +200 -0
  52. package/src/eslint/rules/__tests__/no-item-track-in-form-list.test.mjs +234 -0
  53. package/src/eslint/rules/__tests__/no-uninvoked-signal-in-template.test.mjs +6 -0
  54. package/src/eslint/rules/__tests__/require-model-change.test.mjs +93 -0
  55. package/src/eslint/rules/__tests__/require-track-index.test.mjs +106 -0
  56. package/src/eslint/rules/index.mjs +6 -0
  57. package/src/eslint/rules/no-direct-signal-mutation.mjs +162 -41
  58. package/src/eslint/rules/no-item-track-in-form-list.mjs +173 -0
  59. package/src/eslint/rules/no-uninvoked-signal-in-template.mjs +8 -3
  60. package/src/eslint/rules/require-model-change.mjs +89 -0
  61. package/src/eslint/rules/require-track-index.mjs +162 -0
  62. package/src/eslint/signal-names.mjs +127 -21
  63. package/src/eslint/template-ast.mjs +12 -2
  64. package/types/dsivd-prestations-ng.d.ts +719 -243
  65. package/dsivd-prestations-ng-19.2.0-beta.3.tgz +0 -0
package/README.md CHANGED
@@ -8,21 +8,31 @@ The generated documentation of our entire library is available online at [https:
8
8
 
9
9
  The documentation is available online at [https://dsi-vd.github.io/prestations-ng/](https://dsi-vd.github.io/prestations-ng/)
10
10
 
11
- - If you're using **Angular 21**, use `@dsivd/prestations-ng` at version `^19`.
12
- - If you're using **Angular 19**, use `@dsivd/prestations-ng` at version `^18`.
13
- - If you're using **Angular 17**, use `@dsivd/prestations-ng` at version `^17`.
14
- - If you're using **Angular 15**, use `@dsivd/prestations-ng` at version `^16`.
15
- - If you're using **Angular 13**, use `@dsivd/prestations-ng` at version `^15`.
16
- - If you're using **Angular 12**, use `@dsivd/prestations-ng` at version `^14.5.0`.
17
- - If you're using **Angular 11**, use `@dsivd/prestations-ng` at version `^13` until `14.4.1`.
18
- - If you're using **Angular 9**, use `@dsivd/prestations-ng` at version `^11`.
19
- - If you're using **Angular 8**, use `@dsivd/prestations-ng` at version `^9`.
20
- - If you're using **Angular 6 or 7**, use `@dsivd/prestations-ng` at version `^8`.
21
- - If you're using **Angular 5**, use `prestations-ng` at version `^7`.
11
+ - If you're using **Angular 21**, use `@dsivd/prestations-ng` at version `19`.
12
+ - If you're using **Angular 19**, use `@dsivd/prestations-ng` at version `18`.
13
+ - If you're using **Angular 17**, use `@dsivd/prestations-ng` at version `17`.
14
+ - If you're using **Angular 15**, use `@dsivd/prestations-ng` at version `16`.
15
+ - If you're using **Angular 13**, use `@dsivd/prestations-ng` at version `15`.
16
+ - If you're using **Angular 12**, use `@dsivd/prestations-ng` at version `14`, from `14.5.0`.
17
+ - If you're using **Angular 11**, use `@dsivd/prestations-ng` at version `13`, or `14` until `14.4.1`.
18
+ - If you're using **Angular 9**, use `@dsivd/prestations-ng` at version `11`.
19
+ - If you're using **Angular 8**, use `@dsivd/prestations-ng` at version `9`.
20
+ - If you're using **Angular 6 or 7**, use `@dsivd/prestations-ng` at version `8`.
21
+ - If you're using **Angular 5**, use `prestations-ng` at version `7`.
22
+
23
+ These are the major versions to use. In your `package.json`, declare the library with a tilde (e.g.
24
+ `"@dsivd/prestations-ng": "~19.2.0"`): a minor version may break and goes with the same minor version of
25
+ `prestations-be` (see "Dependency on `prestations-be`" below), and a caret would let `npm install` or the lock file
26
+ maintenance of Renovate install the next one. `npm install @dsivd/prestations-ng@<version>` writes a caret, even over a
27
+ tilde: install a version with `npm install @dsivd/prestations-ng@~<version>`.
22
28
 
23
29
  The library also ships an ESLint plugin whose rules apply to your project: see
24
30
  [the plugin guide](ESLINT_PLUGIN.md).
25
31
 
32
+ An AI assistant working on your project (Claude Code, GitHub Copilot...) follows the rules of
33
+ [AI_GUIDELINES.md](AI_GUIDELINES.md), published with the library for the version you installed: import it into the
34
+ instructions of your assistant, as explained at the top of the file.
35
+
26
36
  Migration guides are available to provide an upgrade path from one major version to another.
27
37
 
28
38
  - If you need to upgrade to version `19+`, please refer to [the V19 upgrade guide](UPGRADING_V19.md).
@@ -40,7 +50,7 @@ Migration guides are available to provide an upgrade path from one major version
40
50
 
41
51
  `@dsivd/prestations-ng` is part of [PrestaKit](https://www.vd.ch/prestakit/) and depends on `prestations-be`.
42
52
 
43
- In order to use all the features of `@dsivd/prestation-ng`, you must use the same minor version of `prestations-be`, see [Notes about versioning in Prestakit](CHANGELOG.md#notes-about-versioning-in-prestakit)
53
+ In order to use all the features of `@dsivd/prestations-ng`, you must use the same minor version of `prestations-be`, see [Notes about versioning in Prestakit](README_COMMON.md#notes-about-versioning-in-prestakit)
44
54
 
45
55
  `prestations-be` is available on the DSI-VD Maven repository. An exemple of integration is available with [Eldorado](https://prestations.vd.ch/pub/101016).
46
56
 
package/UPGRADING_V18.md CHANGED
@@ -51,10 +51,8 @@ Fix application.properties :
51
51
 
52
52
  ```diff
53
53
  logging.config=${ch.vd.configDir}/logback-spring.xml
54
- + # Restore sleuth traces at the same position as in spring boot 2
55
- + logging.pattern.level=%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]
56
- + # remove sleuth traces added by spring boot 3
57
- + logging.pattern.correlation=
54
+ + # Restore sleuth traces at the same position as in spring boot 2, bien laisser l'espace à la fin de la ligne
55
+ + logging.pattern.correlation=[${spring.application.name:},%X{traceId:-},%X{spanId:-}]
58
56
  + logging.include-application-name=false
59
57
  ```
60
58
 
@@ -350,7 +348,9 @@ repository. The subfolder name must correspond to the deployUnit name.
350
348
  Define `deployUnit.groupId` et `deployUnit.name` in your moved base properties file.
351
349
 
352
350
  In the helm folder, add a subfolder with the deployUnit name and fill it with a values.yaml file (copy-paste-replace
353
- from another similar)
351
+ from another similar, take care that there is a `environment: {{ get .Properties.rftoolkit "environment" }}` (with the
352
+ right application name, the right number of replicas, the right management port, the right liveness and readiness
353
+ probes, the right resources, etc.).
354
354
  NB : if your application is using a `${ch.vd.dataDir}` that must survive a restart, your can mount a persistent
355
355
  volume by adding `dataDirSize: 10Mi` (pick the right size) in the values.yaml file.
356
356