@open3cl/engine 1.11.3 → 1.11.4

package/features/engine/domain/apport_et_besoin/surface-sud-equivalente.service.js

@@ -1,3 +1,8 @@
+/** @import { BaieEts } from '../../../dpe/domain/models/baie-ets.model.js' */
+/** @import { BaieVitree } from '../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Enveloppe } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Ets } from '../../../dpe/domain/models/ets.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { mois_liste } from '../../../../utils.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +13,7 @@ import { BaieVitreeTvStore } from '../../../dpe/infrastructure/enveloppe/baieVit
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 45
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class SurfaceSudEquivalenteService {
   /**
@@ -206,7 +211,7 @@ export class SurfaceSudEquivalenteService {
    * @param baieVitree {BaieVitree|BaieEts}
    * @param zc {string} zone climatique du logement
    * @param mois {string} mois au cours duquel calculer la surface sur équivalente de la baie vitrée
-   * @param coeff {number} coefficient à appliquer à cette surface sud
+   * @param [coeff] {number} coefficient à appliquer à cette surface sud
    * @returns {number}
    */
   ssdBaieMois(baieVitree, zc, mois, coeff) {

package/features/engine/domain/apport_et_besoin/surface-sud-equivalente.service.spec.js

@@ -170,7 +170,7 @@ describe('Calcul de la surface sud équivalente (§6.2 / §6.3)', () => {
    * véranda ; Sse = Sse_ext + Σ(v) Sse_veranda_v. Une baie adjacence 10 n'entre que dans la véranda
    * sur laquelle elle donne (reference_lnc = ets.reference).
    * Cas de test fournis par Olivier (thermicien) : C1 sud = 1, est = 0,40, nord = 0,31 ; Fe = 1.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
    */
   describe('ssdMois - plusieurs espaces tampons solarisés (issue #101)', () => {
     // Baie extérieure 10 m² sud, Sw = 0,5 => Sse_ext = 5

package/features/engine/domain/ch/emetteur-ch.service.js

@@ -1,3 +1,5 @@
+/** @import { EmetteurChauffage, GenerateurChauffageDE } from '../../../dpe/domain/models/installation-chauffage.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { ChTvStore } from '../../../dpe/infrastructure/ch/chTv.store.js';
 import { inject } from 'dioma';
 import { bug_for_bug_compat } from '../../../../utils.js';
@@ -95,7 +97,7 @@ export class EmetteurChService {
    * Aucune déduction si le mode bug_for_bug_compat est désactivé, si l'une des deux températures
    * du DPE est absente ou non numérique, ou si tous les émetteurs ont une période saisie.
    *
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
    *
    * @param ctx {Contexte}
    * @param generateurChauffageDE {GenerateurChauffageDE}

package/features/engine/domain/ch/emetteur-ch.service.spec.js

@@ -116,7 +116,7 @@ describe('Calcul des caractéristiques des générateurs de chauffage', () => {
  * Issue #220 - période d'installation des émetteurs absente du DPE.
  * Mode strict : année de construction. Mode bug_for_bug_compat : période retrouvée à partir des
  * temp_fonc_30 / temp_fonc_100 d'origine du DPE.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
  */
 describe('Déduction de la période des émetteurs depuis les données du DPE (issue #220)', () => {
   /**

package/features/engine/domain/ch/generateur-ch.service.js

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { EmetteurChauffage, GenerateurChauffage, GenerateurChauffageDE, GenerateurChauffageDI, InstallationChauffage } from '../../../dpe/domain/models/installation-chauffage.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { ChTvStore } from '../../../dpe/infrastructure/ch/chTv.store.js';
 import { excel_to_js_exec } from '../../../../utils.js';
@@ -385,7 +388,7 @@ export class GenerateurChService {
        * retrouvée à partir des temp_fonc_30 / temp_fonc_100 d'origine du DPE (données
        * intermédiaires du générateur, non encore recalculées à ce stade). Sans déduction possible,
        * la règle §13.2.1.5 s'applique (année de construction).
-       * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+       * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
        */
       const periodeDeduite = this.#emetteurChService.periodeInstallationEmetteurDeduite(
         ctx,

package/features/engine/domain/ch/generateur-ch.service.spec.js

@@ -12,7 +12,7 @@ let emetteurChService;
 
 /**
  * Températures de fonctionnement du générateur (délégation au service émetteurs).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.5
  */
 describe('Températures de fonctionnement des générateurs de chauffage', () => {
   const ctx = { anneeConstruction: 1900 };
@@ -82,7 +82,7 @@ describe('Températures de fonctionnement des générateurs de chauffage', () =>
 
 /**
  * Puissance nominale estimée d'un générateur à combustion sans pn.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
  */
 describe('Puissance nominale estimée des générateurs de chauffage (issue #264)', () => {
   /** @type {TvStore} */
@@ -132,7 +132,7 @@ describe('Puissance nominale estimée des générateurs de chauffage (issue #264
 /**
  * Puissance nominale estimée par la puissance de dimensionnement : Pdim = max(Pch ; Pecs) puis table
  * Pdim → Pn des chaudières (le calcul de la table est testé dans 13.2_generateur_combustion_pdim.spec.js).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4
  */
 describe('Puissance nominale estimée : Pdim et table Pdim → Pn (issue #271)', () => {
   /** @type {TvStore} */

package/features/engine/domain/ch/installation-ch.service.js

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { GenerateurChService } from './generateur-ch.service.js';
 

package/features/engine/domain/conso/conso.service.js

@@ -1,3 +1,5 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { ConsoFroidService } from './froid/conso-froid.service.js';
 

package/features/engine/domain/conso/froid/conso-froid.service.js

@@ -1,3 +1,7 @@
+/** @import { Climatisation, ClimatisationDE, ClimatisationDI } from '../../../../dpe/domain/models/climatisation.model.js' */
+/** @import { Logement } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { ApportEtBesoin } from '../../../../dpe/domain/models/sortie.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
 
@@ -7,7 +11,7 @@ import { FrTvStore } from '../../../../dpe/infrastructure/froid/frTv.store.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 69
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class ConsoFroidService {
   /**

package/features/engine/domain/contexte.builder.js

@@ -1,3 +1,5 @@
+/** @import { CaracteristiqueGenerale, Dpe } from '../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from './models/contexte.model.js' */
 import { TypeDpe, TypeHabitation } from '../../dpe/domain/models/type-habitation.model.js';
 import enums from '../../../enums.js';
 import { NadeqService } from './logement/nadeq.service.js';

package/features/engine/domain/ecs/generateur-ecs.service.js

@@ -1,3 +1,4 @@
+/** @import { GenerateurEcsDE, InstallationEcs } from '../../../dpe/domain/models/installation-ecs.model.js' */
 import { TypeStockage } from '../../../dpe/domain/models/type-stockage.model.js';
 import { inject } from 'dioma';
 import { EcsTvStore } from '../../../dpe/infrastructure/ecs/ecsTv.store.js';

package/features/engine/domain/ecs/installation-ecs.service.js

@@ -1,3 +1,6 @@
+/** @import { Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { InstallationEcs, InstallationEcsDE } from '../../../dpe/domain/models/installation-ecs.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { GenerateurEcsService } from './generateur-ecs.service.js';
 import { inject } from 'dioma';
 import { isStockageEcsVolumeChauffe } from '../../../../11_stockage_ecs_volume_chauffe.js';

package/features/engine/domain/engine.service.js

@@ -1,3 +1,4 @@
+/** @import { Dpe } from '../../dpe/domain/models/dpe.model.js' */
 import { inject } from 'dioma';
 import { ContexteBuilder } from './contexte.builder.js';
 import { DeperditionEnveloppeService } from './enveloppe/deperdition-enveloppe.service.js';

package/features/engine/domain/enveloppe/baie_vitree/deperdition-baie-vitree.service.js

@@ -1,3 +1,5 @@
+/** @import { BaieVitree, BaieVitreeDE, BaieVitreeDI, BaieVitreeDoubleFenetreDE, MasqueLointainNonHomogene } from '../../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { DeperditionService } from '../deperdition.service.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +10,8 @@ import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baie
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @extends {DeperditionService<BaieVitreeTvStore>}
  */
 export class DeperditionBaieVitreeService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/deperdition-enveloppe.service.js

@@ -1,3 +1,6 @@
+/** @import { Enveloppe, Logement } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Deperdition } from '../../../dpe/domain/models/sortie.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { DeperditionMurService } from './mur/deperdition-mur.service.js';
 import { DeperditionPorteService } from './porte/deperdition-porte.service.js';

package/features/engine/domain/enveloppe/deperdition.service.js

@@ -1,3 +1,6 @@
+/** @import { DE } from '../../../dpe/domain/models/dpe.model.js' */
+/** @import { Contexte } from '../models/contexte.model.js' */
+/** @import { DeperditionData } from '../models/deperdition.model.js' */
 import { logger } from '../../../../core/util/logger/log-service.js';
 import { inject } from 'dioma';
 import { TvStore } from '../../../dpe/infrastructure/tv.store.js';
@@ -5,17 +8,18 @@ import { TvStore } from '../../../dpe/infrastructure/tv.store.js';
 /**
  * Calcul des déperditions de l’enveloppe GV
  * @see Méthode de calcul 3CL-DPE 2021 (cotobre 2021) chapitre 3
+ * @template {TvStore} [S=TvStore] type du store de tables de valeurs (spécialisé par sous-classe)
  */
 export class DeperditionService {
   /**
-   * @type {TvStore}
+   * @type {S}
    */
   tvStore;
 
   /**
-   * @param tvStore {TvStore}
+   * @param tvStore {S}
    */
-  constructor(tvStore = inject(TvStore)) {
+  constructor(tvStore = /** @type {S} */ (inject(TvStore))) {
     this.tvStore = tvStore;
   }
 
@@ -88,7 +92,7 @@ export class DeperditionService {
    *   Si Année de construction ≤74 alors Année d’isolation = 75-77
    *   Sinon Année d’isolation = Année de construction
    *
-   * @param enumPeriodeIsolationId {number}
+   * @param enumPeriodeIsolationId {string}
    * @param ctx {Contexte}
    * @return {string} ID de la période d'isolation
    */

package/features/engine/domain/enveloppe/espace_tampon/espace-tampon.service.js

@@ -1,3 +1,5 @@
+/** @import { Ets, EtsDI } from '../../../../dpe/domain/models/ets.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { DeperditionService } from '../deperdition.service.js';
 import { inject } from 'dioma';
 import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baieVitreeTv.store.js';
@@ -8,7 +10,8 @@ import { BaieVitreeTvStore } from '../../../../dpe/infrastructure/enveloppe/baie
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @extends {DeperditionService<BaieVitreeTvStore>}
  */
 export class EspaceTamponService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/mur/deperdition-mur.service.js

@@ -1,3 +1,5 @@
+/** @import { MurDE, MurDI } from '../../../../dpe/domain/models/mur.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { logger } from '../../../../../core/util/logger/log-service.js';
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
@@ -10,7 +12,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class DeperditionMurService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/plancher_bas/deperdition-plancher-bas.service.js

@@ -1,3 +1,5 @@
+/** @import { PlancherBasDE, PlancherBasDI } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
 import { DeperditionService } from '../deperdition.service.js';
@@ -9,7 +11,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class DeperditionPlancherBasService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/plancher_bas/deperdition-plancher-bas.service.spec.js

@@ -7,7 +7,7 @@ import { DeperditionPlancherBasService } from './deperdition-plancher-bas.servic
  * Le `TvStore` est remplacé par un double de test (spies `vi.fn`) et le coefficient b (classe de
  * base) est espionné : seule la logique propre au service (Upb0, Upb, Ue, type d'isolation) est
  * vérifiée, sans dépendre des tables de valeurs réelles.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
  */
 
 /** @type {{ getUpb0: import('vitest').Mock, getUpb: import('vitest').Mock, getUeByUpd: import('vitest').Mock }} */
@@ -156,7 +156,7 @@ describe('DeperditionPlancherBasService - calcul de upb_final (Ue)', () => {
 
   /**
    * Issue #46 : ue calculé plancher par plancher, 2S/P issu du seul plancher courant.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
    */
   describe('calcul plancher par plancher (#46)', () => {
     test('2187E0982591I plancher 1 : 2S/P = 2 * 44,8 / 12,8 = 7', () => {

package/features/engine/domain/enveloppe/plancher_haut/deperdition-plancher-haut.service.js

@@ -1,3 +1,5 @@
+/** @import { PlancherHautDE, PlancherHautDI } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { PRECISION } from '../../constants.js';
 import { DeperditionService } from '../deperdition.service.js';
@@ -9,7 +11,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class DeperditionPlancherHautService extends DeperditionService {
   /**
@@ -119,7 +121,7 @@ export class DeperditionPlancherHautService extends DeperditionService {
    * @see Méthode de calcul 3CL-DPE 2021 (cotobre 2021) chapitre 3.2.3.1
    * "Lorsque le local au-dessus du logement est un local non chauffé, ou un local autre que d’habitation., Uph_tab est pris dans la catégorie « Terrasse »."
    * @param phDE {PlancherHautDE}
-   * @return {'combles'|'terasse'}
+   * @return {'combles'|'terrasse'}
    */
   #getTypeAdjacence(phDE) {
     switch (phDE.enum_type_adjacence_id) {

package/features/engine/domain/enveloppe/pont_thermique/deperdition-pont-thermique.service.js

@@ -1,3 +1,10 @@
+/** @import { BaieVitreeDE } from '../../../../dpe/domain/models/baie-vitree.model.js' */
+/** @import { Enveloppe } from '../../../../dpe/domain/models/dpe.model.js' */
+/** @import { MurDE } from '../../../../dpe/domain/models/mur.model.js' */
+/** @import { PlancherBasDE, PlancherHautDE } from '../../../../dpe/domain/models/plancher.model.js' */
+/** @import { PontThermiqueDE, PontThermiqueDI } from '../../../../dpe/domain/models/pont-thermique.model.js' */
+/** @import { PorteDE } from '../../../../dpe/domain/models/porte.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { DeperditionService } from '../deperdition.service.js';
 import { logger } from '../../../../../core/util/logger/log-service.js';
@@ -14,9 +21,10 @@ import { DeperditionPlancherBasService } from '../plancher_bas/deperdition-planc
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  *
  * Si le coefficient U des portes est connu et justifié, le saisir directement. Sinon, prendre les valeurs tabulées
+ * @extends {DeperditionService<PontThermiqueTvStore>}
  */
 export class DeperditionPontThermiqueService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/pont_thermique/deperdition-pont-thermique.service.spec.js

@@ -6,7 +6,7 @@ import { DeperditionPontThermiqueService } from './deperdition-pont-thermique.se
  *
  * Le store des tables de valeurs et les services de déperdition des parois sont remplacés par des
  * doubles de test : seule la logique propre au service (exclusions de ponts thermiques) est vérifiée.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 
 let tvStore;

package/features/engine/domain/enveloppe/porte/deperdition-porte.service.js

@@ -1,3 +1,5 @@
+/** @import { PorteDE, PorteDI } from '../../../../dpe/domain/models/porte.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { inject } from 'dioma';
 import { DeperditionService } from '../deperdition.service.js';
 import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
@@ -8,7 +10,7 @@ import { TvStore } from '../../../../dpe/infrastructure/tv.store.js';
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  *
  * Si le coefficient U des portes est connu et justifié, le saisir directement. Sinon, prendre les valeurs tabulées
  */

package/features/engine/domain/enveloppe/ventilation/deperdition-ventilation.service.js

@@ -1,3 +1,5 @@
+/** @import { VentilationDE, VentilationDI } from '../../../../dpe/domain/models/ventilation.model.js' */
+/** @import { Contexte } from '../../models/contexte.model.js' */
 import { DeperditionService } from '../deperdition.service.js';
 
 import { logger } from '../../../../../core/util/logger/log-service.js';
@@ -11,7 +13,7 @@ import { TypeVentilation } from '../../../../dpe/domain/models/type-ventilation.
  *
  * Méthode de calcul 3CL-DPE 2021
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class DeperditionVentilationService extends DeperditionService {
   /**

package/features/engine/domain/enveloppe/ventilation/deperdition-ventilation.service.spec.js

@@ -18,7 +18,7 @@ const { DeperditionVentilationService } = await import('./deperdition-ventilatio
  * Tests unitaires isolés du calcul de Q4Paconv (`DeperditionVentilationService.q4paConv`).
  * Le store des tables de valeurs est remplacé par un double de test.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
  */
 
 /** @type {DeperditionVentilationService} */

package/features/engine/domain/logement/nadeq.service.js

@@ -6,7 +6,7 @@ import { TypeDpe } from '../../../dpe/domain/models/type-habitation.model.js';
  *
  * Methode_de_calcul_3CL_DPE_2021 - Page 70
  * Octobre 2021
- * @see consolide_anne…arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
+ * @see consolide_annexe_arrete_du_31_03_2021_relatif_aux_methodes_et_procedures_applicables.pdf
  */
 export class NadeqService {
   /**

package/features/engine/domain/logement/nadeq.service.spec.js

@@ -4,7 +4,7 @@ import { TypeDpe } from '../../../dpe/domain/models/type-habitation.model.js';
 
 describe('Nadeq unit tests', () => {
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 70
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 70
    */
   const service = new NadeqService();
 

package/features/engine/domain/models/contexte.model.ts

@@ -1,9 +1,9 @@
-import { TypeDpe, TypeHabitation } from '../../../dpe/domain/models/dpe.model';
+import type { TypeDpe, TypeHabitation } from '../../../dpe/domain/models/type-habitation.model.js';
 
 export interface Contexte {
   typeHabitation: TypeHabitation;
   typeDpe: TypeDpe;
-  enumPeriodeConstructionId: number;
+  enumPeriodeConstructionId: string;
   anneeConstruction: number;
   surfaceHabitable: number;
   hauteurSousPlafond: number;

package/features/normalizer/domain/dpe-normalizer.service.js

@@ -1,3 +1,4 @@
+/** @import { Dpe } from '../../dpe/domain/models/dpe.model.js' */
 import { DpePreProcessor } from '../../../preprocessor/index.js';
 
 /**

package/ficheTechnique.js

@@ -1,3 +1,5 @@
+/** @import { XsdFicheTechnique } from './features/dpe/domain/models/dpe-xsd.generated.js' */
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
 /**
  * Recherche dans les fiches techniques d'un DPE.
  *
@@ -29,7 +31,7 @@ const indexParDpe = new WeakMap();
 function indexerFichesTechniques(dpe) {
   const parCategorie = new Map();
 
-  /** @type {FicheTechniqueItem[]} */
+  /** @type {XsdFicheTechnique[]} */
   let fichesTechniques = dpe.fiche_technique_collection?.fiche_technique || [];
   if (!Array.isArray(fichesTechniques)) {
     fichesTechniques = [fichesTechniques];
@@ -87,7 +89,7 @@ function champEnMinuscules(groupe, field) {
  * @param dpe {FullDpe}
  * @param categoryFicheTechiqueId {string}
  * @param description {string}
- * @param classifications {[string]}
+ * @param classifications {string[]}
  * @param field {'description' | 'valeur'}
  */
 export default function getFicheTechnique(

package/globals.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Compléments aux typings globaux de TypeScript.
+ *
+ * `parseInt` / `parseFloat` sont appelés dans le moteur avec des nombres (conversion implicite
+ * en chaîne, comportement JS standard) : on déclare ces surcharges plutôt que de modifier
+ * chaque appel.
+ */
+declare function parseInt(value: string | number, radix?: number): number;
+declare function parseFloat(value: string | number): number;
+
+interface NumberConstructor {
+  parseInt(value: string | number, radix?: number): number;
+  parseFloat(value: string | number): number;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open3cl/engine",
-  "version": "1.11.3",
+  "version": "1.11.4",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {
@@ -27,8 +27,8 @@
     "release": "semantic-release",
     "release:dry": "semantic-release --dry-run",
     "prepare": "husky",
-    "types:generate": "node scripts/generate_types_from_xsd.js && prettier --write src/features/dpe/domain/models/dpe-xsd.generated.ts",
-    "assets:sync": "node scripts/synchronize_assets.js",
+    "types:generate": "node scripts/generate_types_from_xsd.js && node scripts/generate_tables_types.js && prettier --write src/features/dpe/domain/models/dpe-xsd.generated.ts src/enums.d.ts src/tv.d.ts",
+    "assets:sync": "node scripts/synchronize_assets.js && node scripts/generate_tables_types.js && prettier --write src/enums.d.ts src/tv.d.ts",
     "version:update": "node scripts/update_version.js",
     "reports:preview": "npm run http-server dist/reports/corpus -o",
     "reports:clean": "node scripts/clean_corpus_reports.js",

package/preprocessor/index.js

@@ -1,3 +1,4 @@
+/** @import { Dpe } from '../features/dpe/domain/models/dpe.model.js' */
 /**
  * Pré-traitement du DPE d'entrée.
  *