@open3cl/engine 1.11.3 → 1.11.4

package/10_besoin_fr.spec.js

@@ -38,7 +38,7 @@ const { calc_sse_j } = await import('./6.2_surface_sud_equivalente.js');
 
 /**
  * 10. Calcul des besoins de froid (Bfr)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
  */
 describe('calc_besoin_fr_j - besoin de froid journalier', () => {
   test('retourne 0 lorsque le nombre de jours de référence est nul', () => {

package/10_clim.js

@@ -5,7 +5,7 @@ function tv_seer(di, de, du, zc_id) {
     enum_zone_climatique_id: zc_id,
     enum_periode_installation_fr_id: requestInputID(de, du, 'periode_installation_fr')
   };
-  const row = tv('seer', matcher, de);
+  const row = tv('seer', matcher);
   if (row) {
     de.tv_seer_id = Number(row.tv_seer_id);
     di.eer = row.eer;

package/10_clim.spec.js

@@ -31,7 +31,7 @@ beforeEach(() => {
 
 /**
  * 10. Calcul de la consommation de climatisation (froid)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §10
  */
 describe('calc_clim - consommation de climatisation', () => {
   test('prorate le besoin de froid au ratio surface_clim / Sh', () => {
@@ -69,14 +69,10 @@ describe('calc_clim - consommation de climatisation', () => {
 
     calc_clim(c, 1000, 1500, '2', 100);
 
-    expect(tv).toHaveBeenCalledWith(
-      'seer',
-      {
-        enum_zone_climatique_id: '2',
-        enum_periode_installation_fr_id: '4'
-      },
-      c.donnee_entree
-    );
+    expect(tv).toHaveBeenCalledWith('seer', {
+      enum_zone_climatique_id: '2',
+      enum_periode_installation_fr_id: '4'
+    });
   });
 
   test.each([['6'], ['7'], ['8']])(

package/11_besoin_ecs.spec.js

@@ -23,7 +23,7 @@ const { default: calc_besoin_ecs, calc_besoin_ecs_j } = await import('./11_besoi
 
 /**
  * 11. Calcul du besoin d'eau chaude sanitaire (Becs)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11
  */
 describe('calc_besoin_ecs_j - besoin ECS journalier', () => {
   test('valeur de référence en mode conventionnel (56 L/j/personne)', () => {

package/11_ecs.js

@@ -1,3 +1,4 @@
+/** @import { InstallationEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import calc_gen_ecs from './14_generateur_ecs.js';
 import { tv, requestInput, mois_liste, Njj } from './utils.js';
@@ -196,7 +197,7 @@ const TYPES_INSTALLATION_ECS_COLLECTIVE = ['2', '3'];
  * @see Moteur_DPE.dll Calcul_batiment.cs l.583-592 (Becs / Rdim seulement pour une installation
  * individuelle en immeuble ; Becs × Sh_ecs / SH sans Rdim pour une installation collective)
  * @param th {string} type de bâtiment (maison, appartement, immeuble)
- * @param de {Donnee_entree} donnée d'entrée de l'installation ECS
+ * @param de {InstallationEcsDE} donnée d'entrée de l'installation ECS
  * @returns {boolean}
  */
 export function isRdimEcsNeutralise(th, de) {

package/11_ecs.spec.js

@@ -61,7 +61,7 @@ beforeEach(() => {
 
 /**
  * 11. Prise en compte de l'ECS (ratio de besoin + rendement de distribution)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11 / §17.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11 / §17.2.1
  */
 describe('calc_ecs - ratio de besoin ECS', () => {
   test('virtualisation : le ratio est la clé de répartition ECS', () => {
@@ -87,7 +87,7 @@ describe('calc_ecs - ratio de besoin ECS', () => {
    * Immeuble à ECS individuelles de surfaces différentes (cas CSTB IC1-0-3 / IC1-0-5 : 4
    * appartements de 20, 30, 45 et 80 m² sur 175 m², rdim 1) : besoin au prorata de la surface
    * desservie, comme Tribu (Becs appartement 1 = Becs immeuble × 20 / 175).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §11.4
    */
   test('immeuble à ECS individuelles : ratio = surface desservie / surface de l’immeuble', () => {
     const des = [20, 30, 45, 80].map((surface) => ({

package/11_nadeq.js

@@ -1,3 +1,4 @@
+/** @import { Logement } from './features/dpe/domain/models/dpe.model.js' */
 export class Nadeq {
   /**
    * Return nadeq for maison or individual logement

package/11_nadeq.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 
 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 nadeq = new Nadeq();
 

package/12.4_pac.js

@@ -1,9 +1,11 @@
+/** @import { GenerateurChauffageDE, GenerateurChauffageDI } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE, GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import { requestInputID, tv } from './utils.js';
 
 /**
  * Calcul ou récupération des paramètres scop ou cop
- * @param di {Donnee_intermediaire}
- * @param de {Donnee_entree}
+ * @param di {GenerateurChauffageDI|GenerateurEcsDI}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param du {Object}
  * @param zc_id {string}
  * @param ed_id {string|null}
@@ -31,7 +33,7 @@ function tv_scop(di, de, du, zc_id, ed_id, type) {
   };
   matcher[`enum_type_generateur_${type}_id`] = requestInputID(de, du, `type_generateur_${type}`);
   if (ed_id) matcher.enum_type_emission_distribution_id = ed_id;
-  const row = tv('scop', matcher, de);
+  const row = tv('scop', matcher);
   if (row) {
     const scop = row.scop_ou_cop;
     di[scop] = Number(row.scop);

package/12.4_pac.spec.js

@@ -26,7 +26,7 @@ beforeEach(() => {
 
 /**
  * 12.4 - Détermination du SCOP / COP des pompes à chaleur.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §12.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §12.4
  */
 describe('scopOrCop - méthode de saisie "caractéristiques saisies" (id 6)', () => {
   test('SCOP renseigné : rg et rg_dep prennent la valeur du SCOP sans accès à la table', () => {
@@ -55,14 +55,10 @@ describe('scopOrCop - valeur forfaitaire (table scop)', () => {
 
     scopOrCop(di, de, {}, 'h1a', null, 'ch');
 
-    expect(tv).toHaveBeenCalledWith(
-      'scop',
-      {
-        enum_zone_climatique_id: 'h1a',
-        enum_type_generateur_ch_id: '160'
-      },
-      de
-    );
+    expect(tv).toHaveBeenCalledWith('scop', {
+      enum_zone_climatique_id: 'h1a',
+      enum_type_generateur_ch_id: '160'
+    });
     expect(di.scop).toBe(4.2);
     expect(di.rg).toBe(4.2);
     expect(di.rg_dep).toBe(4.2);
@@ -76,15 +72,11 @@ describe('scopOrCop - valeur forfaitaire (table scop)', () => {
 
     scopOrCop(di, de, {}, 'h2b', '5', 'ecs');
 
-    expect(tv).toHaveBeenCalledWith(
-      'scop',
-      {
-        enum_zone_climatique_id: 'h2b',
-        enum_type_generateur_ecs_id: '10',
-        enum_type_emission_distribution_id: '5'
-      },
-      de
-    );
+    expect(tv).toHaveBeenCalledWith('scop', {
+      enum_zone_climatique_id: 'h2b',
+      enum_type_generateur_ecs_id: '10',
+      enum_type_emission_distribution_id: '5'
+    });
     // scop_ou_cop vaut 'cop' : la valeur est stockée sous di.cop
     expect(di.cop).toBe(3.1);
     expect(di.rg).toBe(3.1);

package/13.2_generateur_combustion.js

@@ -1,3 +1,6 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffage, GenerateurChauffageDE, GenerateurChauffageDI, InstallationChauffage } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE, GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import { bug_for_bug_compat, convertExpression, tv, tvColumnLines } from './utils.js';
 import enums from './enums.js';
 import { updateGenerateurBouilleurs } from './13.2_generateur_combustion_bouilleur.js';
@@ -63,7 +66,7 @@ export const PN_MAX_QP0_CHAUDIERE_GAZ = 400000;
  * (Tribu, `Calcul_generateur.cs` Rpn_chaudieregaz, `Math.Min(400.0, Pn)`) plafonne Pn à 400 kW :
  * au-delà, la formule n'est plus représentative (elle décroît et devient négative vers 1 500 kW).
  * Le plafond ne s'applique pas aux chaudières fioul (Rpn_chaudierefioul : Pn non plafonné).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
  *
  * @param row {object} ligne de la table generateur_combustion
  * @param pnCollectif {number} puissance nominale du générateur (W)
@@ -154,7 +157,7 @@ export function pnEstimee(GV, tbase, ratioSurface = 1) {
  * pour le chauffage, 8 pour l'ECS) du générateur.
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  * @returns {boolean|undefined} undefined si non renseigné
  */
@@ -170,7 +173,7 @@ export function chaudiereMurale(dpe, de, type) {
  * générateur ECS mixte de même `reference_generateur_mixte`, sinon générateur ECS mixte unique.
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree} données du générateur de chauffage
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur de chauffage
  * @returns {number|undefined}
  */
 export function volumeStockageEcsMixte(dpe, de) {
@@ -200,7 +203,7 @@ export function volumeStockageEcsMixte(dpe, de) {
  * pour une installation collective, Pch est conservée (comportement historique).
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree} données du générateur
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur
  * @param type {'ch' | 'ecs'}
  * @param pch {number} Pch (W) proratisée à la surface desservie
  * @param optionsPn {{installationIndividuelle?: boolean, volumeStockage?: number}}
@@ -249,8 +252,8 @@ export function pnEstimeeGenerateur(dpe, de, type, pch, optionsPn = {}) {
  * 5 - caractéristiques saisies à partir de la plaque signalétique ou d'une documentation technique du système à combustion : pn, rpn,rpint,qp0,temp_fonc_30,temp_fonc_100
  *
  * @param dpe {FullDpe}
- * @param di {Donnee_intermediaire} données du générateur
- * @param de {Donnee_entree} données du générateur
+ * @param di {GenerateurChauffageDI|GenerateurEcsDI} données du générateur
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE} données du générateur
  * @param type {'ecs'|'ch'}
  * @param GV {number} déperdition de l'enveloppe
  * @param tbase {number} température de fonctionnement du générateur
@@ -392,8 +395,8 @@ export function tv_generateur_combustion(
    * dans Cper). Le XML ne transporte pas cette donnée : elle est lue dans la fiche technique du
    * générateur. Sans fiche technique, la ventouse est conservée comme approximation (choix
    * Open3CL, la méthode ne prévoyant pas de valeur par défaut).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
-   * @see : Tribu Calcul_generateur.cs (ventilateur_combustion)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+   * @see Tribu Calcul_generateur.cs (ventilateur_combustion)
    */
   const indexEF = de.ventilateurCombustion ?? de.presence_ventouse;
   const E = E_tab[indexEF];
@@ -474,7 +477,7 @@ export function tv_generateur_combustion(
 /**
  * Mise à jour du type de générateur si besoin
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurCombustion(dpe, de, type) {
@@ -515,7 +518,7 @@ export function valeurVeilleuse(valeur) {
  * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4 / §14.1 (« Pveil : si veilleuse »)
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  * @returns {1 | 0 | undefined} 1 si veilleuse, 0 si pas de veilleuse, undefined si non renseigné
  */
@@ -558,7 +561,7 @@ export function presenceVeilleuse(dpe, de, type) {
  * Récupération d'informations complémentaires issues des fiches techniques pour les générateurs
  *
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 function addInfosFromFichesTechniques(dpe, de, type) {
@@ -590,7 +593,7 @@ function addInfosFromFichesTechniques(dpe, de, type) {
  * Vérifier que les informations du générateur ECS sont bien les mêmes que celles du générateur de chauffage
  * Dans le cas d'une génération mixte, le type du générateur doit être le même
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param typeGenerateurKey {string}
  * @returns {string}
  */
@@ -612,7 +615,7 @@ function checkEcsVsChauffageForMixteGeneration(dpe, de, typeGenerateurKey) {
   }
 
   /**
-   * @type {InstallationChauffageItem[]}
+   * @type {InstallationChauffage[]}
    */
   const installationsCh = dpe.logement.installation_chauffage_collection.installation_chauffage;
 
@@ -668,9 +671,9 @@ function checkEcsVsChauffageForMixteGeneration(dpe, de, typeGenerateurKey) {
  * 3. même énergie (`enum_type_energie_id`), si un seul générateur de chauffage mixte correspond ;
  * 4. générateur de chauffage mixte unique du DPE, si son énergie n'est pas incompatible.
  *
- * @param generateursChMixtes {GenerateurChauffageItem[]} générateurs de chauffage d'usage 'chauffage + ecs'
- * @param de {Donnee_entree} données du générateur ECS
- * @returns {GenerateurChauffageItem|null} null si aucun jumeau ne peut être identifié sans ambiguïté
+ * @param generateursChMixtes {GenerateurChauffage[]} générateurs de chauffage d'usage 'chauffage + ecs'
+ * @param de {GenerateurEcsDE} données du générateur ECS
+ * @returns {GenerateurChauffage|null} null si aucun jumeau ne peut être identifié sans ambiguïté
  */
 export function findGenerateurChMixteJumeau(generateursChMixtes, de) {
   const sameValue = (a, b) =>

package/13.2_generateur_combustion.spec.js

@@ -121,7 +121,7 @@ const ROW_DEFAUT = {
 
 /**
  * 13.2 - Récupération des caractéristiques forfaitaires d'un générateur à combustion.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('tv_generateur_combustion - caractéristiques du générateur', () => {
   test('puissance nominale calculée à partir de GV et Tbase lorsqu’elle est absente', () => {
@@ -358,7 +358,7 @@ describe('tv_generateur_combustion - compatibilité bug_for_bug_compat', () => {
 
   /**
    * Système collectif par défaut : chaudière fioul standard datant de la construction du bâtiment.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
    */
   describe('système collectif par défaut : chaudière selon l’année de construction', () => {
     test('CH 119 + ligne compatible : type et ligne de la période de construction retenus', () => {
@@ -668,7 +668,7 @@ describe('tv_generateur_combustion - génération mixte (checkEcsVsChauffageForM
 /**
  * Issue #210 : l'ECS mixte doit être appariée avec SON générateur de chauffage mixte (même appareil),
  * et non avec le premier générateur de chauffage mixte du DPE.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §14
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §14
  */
 describe('findGenerateurChMixteJumeau - appariement ECS / chauffage mixte (issue #210)', () => {
   const ch = (donnees) => ({ donnee_entree: { enum_usage_generateur_id: '3', ...donnees } });
@@ -876,7 +876,7 @@ const dpeFiches = (...fiches) => ({
 
 /**
  * 13.2 - Orchestration des substitutions de générateurs et enrichissement fiches techniques.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('updateGenerateurCombustion - orchestration des substitutions', () => {
   test('délègue aux trois routines de substitution avec les mêmes arguments', () => {
@@ -983,7 +983,7 @@ describe('updateGenerateurCombustion - orchestration des substitutions', () => {
 /**
  * Issue #35 : les coefficients (E, F) de la formule qp0 dépendent de la présence d'un ventilateur
  * dans le circuit de combustion (fiche technique), la ventouse n'étant qu'un repli.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
  */
 describe('tv_generateur_combustion - coefficients (E, F) selon le ventilateur de combustion (#35)', () => {
   const ROW_EF = { ...ROW_DEFAUT, rpn: 'E*40', qp0_perc: 'Pn*(E+F*log10(Pn))/100' };
@@ -1032,7 +1032,7 @@ describe('tv_generateur_combustion - coefficients (E, F) selon le ventilateur de
  * Issue #39 : présence d'une veilleuse lue dans la sous-fiche technique du générateur.
  * Tribu : entrée `Is_veilleuse` (DPE.DataClasses/generateur.cs), Pveil1 = 0 si absente
  * (DPE.Core/Calcul_generateur.cs).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4 / §14.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4 / §14.1
  */
 describe('presenceVeilleuse - fiche technique « Présence d’une veilleuse »', () => {
   const ficheGen = (desc, veilleuse) => [
@@ -1151,7 +1151,7 @@ describe('presenceVeilleuse - fiche technique « Présence d’une veilleuse »'
 /**
  * Issue #124 : générateur collectif virtualisé, puissance saisie collective (Pn) ou individualisée
  * (Pe = a × Pn) selon les logiciels.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1
  */
 describe('tv_generateur_combustion - convention de puissance d’un générateur virtualisé (#124)', () => {
   const ROW_PN = {
@@ -1418,7 +1418,7 @@ describe('caracteristiquesGenerateurCombustion - selon la méthode de saisie', (
 /**
  * Plafond de Pn à 400 kW dans Qp0 = Pn × (E + F × log Pn) / 100 des chaudières gaz après 2015
  * (moteur de référence Tribu : Calcul_generateur.cs, Rpn_chaudieregaz, Math.Min(400.0, Pn)).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2
  */
 describe('puissanceFormuleQp0 - plafond de Pn à 400 kW pour les chaudières gaz', () => {
   const ROW_GAZ = {
@@ -1486,7 +1486,7 @@ describe('puissanceFormuleQp0 - plafond de Pn à 400 kW pour les chaudières gaz
 
 /**
  * Estimation de la puissance nominale d'un générateur à combustion (pn absente).
- * @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('pnEstimee - puissance nominale estimée (issue #264)', () => {
   // 1,2 × 200 × (19 − (−9)) / 0,95³ -- valeur de référence de régression
@@ -1518,7 +1518,7 @@ describe('pnEstimee - puissance nominale estimée (issue #264)', () => {
 
 /**
  * Pn estimée par la puissance de dimensionnement (issue #271).
- * @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('pnEstimeeGenerateur - Pdim = max(Pch ; Pecs) et table Pdim → Pn (issue #271)', () => {
   const dpeAvecEcsMixte = (generateursEcs) => ({

package/13.2_generateur_combustion_bouilleur.js

@@ -1,9 +1,12 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffageDE } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 import getFicheTechnique from './ficheTechnique.js';
 
 /**
  * Pour les générateurs "poêles à bois bouilleur", les calculs sont faits comme pour les chaudières bois
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurBouilleurs(dpe, de, type) {
@@ -121,7 +124,7 @@ export function updateGenerateurBouilleurs(dpe, de, type) {
  *  - Pour un poêle à bois bouilleur bûche installé avant 1948, on prendra la chaudière bois bûche avant 1978
  * @param dpe {FullDpe}
  * @param ids
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 function updateGenerateurBouilleur(dpe, ids, de, type) {

package/13.2_generateur_combustion_bouilleur.spec.js

@@ -18,7 +18,7 @@ beforeEach(() => {
 /**
  * 13.1 - Les poêles à bois bouilleur sont assimilés à des chaudières bois de la
  * période correspondante.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.1
  */
 describe('updateGenerateurBouilleurs - substitution par une chaudière bois équivalente', () => {
   test('type non concerné : aucune substitution', () => {

package/13.2_generateur_combustion_ch.js

@@ -1,3 +1,4 @@
+/** @import { GenerateurChauffageDE, GenerateurChauffageDI } from './features/dpe/domain/models/installation-chauffage.model.js' */
 import enums from './enums.js';
 import { bug_for_bug_compat, requestInput, requestInputID, tv } from './utils.js';
 
@@ -18,7 +19,7 @@ const coef_pond = {
  * Coefficients de conversion PCS / PCI.
  * Le propane et le butane sont des GPL : k = 1.09 (et non 1.11, valeur du gaz naturel), comme
  * dans le moteur de référence CSTB (Tribu).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
  */
 export const K = {
   électricité: 1,
@@ -84,7 +85,7 @@ export const TOLERANCE_TEMP_FONC = 0.01;
  * 13.2.1.5 Chaudières basse température et condensation
  * « Si l'année d'installation des émetteurs est inconnue, prendre l'année de construction du
  * bâtiment. »
- * @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 ac {number} année de construction du bâtiment
  * @return {string} période d'installation des émetteurs
@@ -148,7 +149,7 @@ export function temp_fonc_pour_periode(de, em_ch, periodeParDefaut) {
  * - plusieurs : celle de l'année de construction si elle en fait partie, sinon la plus récente ;
  * - aucune : null (repli sur l'année de construction, valeurs hors tables).
  *
- * @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 tempFonc30Dpe {number} temp_fonc_30 d'origine du DPE
  * @param tempFonc100Dpe {number} temp_fonc_100 d'origine du DPE
@@ -203,7 +204,7 @@ export function deductionPeriodeEmetteursActive(tempFonc30Dpe, tempFonc100Dpe, e
  * d'installation des émetteurs non exportée (issue #220) ; les valeurs retenues proviennent
  * toujours des tables (tv_temp_fonc_30_id / tv_temp_fonc_100_id renseignés).
  *
- * @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
  */
 export function tv_temp_fonc_30_100(di, de, du, em_ch, ac) {
   const tempFonc30Dpe = di.temp_fonc_30;
@@ -281,9 +282,9 @@ function Tch_xfinal(x, Cdimref) {
  * une division en place ramenait QP0 à ~0 (÷ 100 à chaque appel), et le terme 0,45 × QP0 du
  * rendement de génération en était absent.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1
- * @param de {Donnee_entree}
- * @param di {Donnee_intermediaire}
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1
+ * @param de {GenerateurChauffageDE}
+ * @param di {GenerateurChauffageDI}
  * @param k {number} rapport PCI/PCS de l'énergie
  * @returns {number}
  */

package/13.2_generateur_combustion_ch.spec.js

@@ -68,7 +68,7 @@ const RG_DEP_AIR_CHAUD = 0.874622228362935;
 /**
  * Pertes à l'arrêt QP0 (kW sur PCS) : pour les générateurs d'air chaud, la valeur de la table 13.2
  * est en % de Pn et doit être ramenée en W.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1
  */
 describe('qp0PcsKw - pertes à l’arrêt sur PCS', () => {
   test('générateur à air chaud : qp0 ramené en W (÷ 100) puis en kW PCS', () => {
@@ -94,7 +94,7 @@ describe('qp0PcsKw - pertes à l’arrêt sur PCS', () => {
 
 /**
  * 13.2.1.1 - Températures de fonctionnement à 30 % et 100 % de charge.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.1
  */
 describe('tv_temp_fonc_30_100 - températures de fonctionnement', () => {
   function emetteur(overrides = {}) {
@@ -266,7 +266,7 @@ describe('tv_temp_fonc_30_100 - températures de fonctionnement', () => {
  * Mode strict : « Si l'année d'installation des émetteurs est inconnue, prendre l'année de
  * construction du bâtiment. » En mode bug_for_bug_compat uniquement, la période est retrouvée à
  * partir des temp_fonc_30 / temp_fonc_100 d'origine stockées dans le DPE (règle de l'expert).
- * @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('tv_temp_fonc_30_100 - période des émetteurs absente (issue #220)', () => {
   /**
@@ -555,7 +555,7 @@ describe('tempDistributionChPourTempFonc', () => {
 
 /**
  * 13.2.1.2 - Rendement de génération des chaudières (rg PCI).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
  */
 describe('calc_generateur_combustion_ch - rendement de génération', () => {
   test('chaudière gaz standard : rendement PCI et rendement dépensier', () => {
@@ -822,7 +822,7 @@ describe('calc_generateur_combustion_ch - rendement de génération', () => {
    * Pveil = 150 W, Tfonc30/100 = 56/70, Cdimref = 0.05 / TchFinal(Ch_5)).
    * Comme QP0, la puissance de veilleuse est exprimée sur PCS (Pveil × k) dans le dénominateur.
    * Avant correctif (Pveil sur PCI) : rg = 0.740607866698453 (Cch −0,42 %).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
    */
   test('autotest État MI4-0-1 : rg identique à Tribu (Pveil exprimée sur PCS)', () => {
     const di = {
@@ -902,7 +902,7 @@ describe('calc_generateur_combustion_ch - rendement de génération', () => {
    * Issue #39 : la présence de veilleuse lue dans la fiche technique (de.presence_veilleuse)
    * prime sur la valeur intermédiaire pveilleuse du DPE. Sans fiche, comportement inchangé.
    * Tribu : Pveil1 = 0 si Is_veilleuse != oui (DPE.Core/Calcul_generateur.cs).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.4
    */
   describe('présence de veilleuse (issue #39)', () => {
     const di = (extra) => ({
@@ -985,7 +985,7 @@ describe('calc_generateur_combustion_ch - rendement de génération', () => {
 
 /**
  * Coefficient de conversion PCS / PCI : le propane et le butane sont des GPL (k = 1.09).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.2
  */
 describe('K - coefficient PCS / PCI', () => {
   test('propane et butane : même coefficient que le gpl (1.09), distinct du gaz naturel', () => {

package/13.2_generateur_combustion_chaudiere.js

@@ -1,3 +1,6 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffageDE } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 import getFicheTechnique from './ficheTechnique.js';
 
 /**
@@ -91,7 +94,7 @@ export function getChaudiereFioulDefautId(dpe, type, typeSaisiId) {
 /**
  * Pour les générateurs "Autre système à combustion", les calculs sont faits comme pour les chaudières standard
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurChaudieres(dpe, de, type) {
@@ -169,7 +172,7 @@ export function updateGenerateurChaudieres(dpe, de, type) {
  *  - Pour un système 'autre système à combustion fioul' granulés installé en 2000, on prendra la chaudière gaz standard 2001-2015
  * @param dpe {FullDpe}
  * @param ids
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 function updateGenerateurChaudiere(dpe, ids, de, type) {

package/13.2_generateur_combustion_chaudiere.spec.js

@@ -20,7 +20,7 @@ beforeEach(() => {
 /**
  * 13.2 - Les "autres systèmes à combustion" sont assimilés à des chaudières standard
  * de la période correspondante.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('updateGenerateurChaudieres - substitution par une chaudière équivalente', () => {
   test('type non concerné : aucune substitution, pas de champ previous', () => {
@@ -108,7 +108,7 @@ describe('findIdForAnnee - sélection de la période', () => {
 /**
  * Système collectif par défaut (ch 119 / ecs 84) : chaudière atmosphérique mixte standard
  * datant de la construction du bâtiment, énergie fioul.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §17.2.1.1
  */
 describe('getChaudiereFioulDefautId - chaudière fioul par défaut selon l’année de construction', () => {
   const dpe = (annee) => ({

package/13.2_generateur_combustion_pdim.js

@@ -173,13 +173,13 @@ export function valeurChaudiereMurale(valeur) {
  *    majoritairement murales), première sinon.
  *
  * @param params {{
- *   pch: number,                      Pch (W), déjà proratisée à la surface desservie
- *   volumeStockage?: number|string,   Vs (L) de la production d'ECS assurée par le générateur
- *   usageEcs?: boolean,               le générateur produit de l'ECS (usage ECS ou mixte)
- *   usageChauffage?: boolean,         le générateur assure le chauffage (défaut true)
+ *   pch: number,                      // Pch (W), déjà proratisée à la surface desservie
+ *   volumeStockage?: number|string,   // Vs (L) de la production d'ECS assurée par le générateur
+ *   usageEcs?: boolean,               // le générateur produit de l'ECS (usage ECS ou mixte)
+ *   usageChauffage?: boolean,         // le générateur assure le chauffage (défaut true)
  *   libelleTypeGenerateur?: string,
- *   murale?: boolean,                 pose murale (undefined si inconnue)
- *   anneeInstallation?: number        année d'installation (undefined si inconnue)
+ *   murale?: boolean,                 // pose murale (undefined si inconnue)
+ *   anneeInstallation?: number        // année d'installation (undefined si inconnue)
  * }}
  * @returns {number} Pn (W)
  */

package/13.2_generateur_combustion_pdim.spec.js

@@ -12,7 +12,7 @@ import {
 
 /**
  * Module de calcul pur (aucune dépendance) : pas de mock nécessaire.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 Calcul des puissances nominales (p.90-91)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 Calcul des puissances nominales (p.90-91)
  */
 describe('puissanceEcs - puissance de dimensionnement ECS selon le volume de stockage', () => {
   test('production instantanée (Vs = 0) : Pecs = 21 kW', () => {

package/13.2_generateur_combustion_pn.spec.js

@@ -14,7 +14,7 @@ import {
  * Module pur (aucune dépendance importée) : les caractéristiques du générateur sont fournies par
  * une fonction injectée, remplacée ici par un double de test déterministe.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1 (virtualisation)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2 et §17.2.1 (virtualisation)
  */
 
 /**

package/13.2_generateur_pac.js

@@ -1,7 +1,10 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffageDE } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE } from './features/dpe/domain/models/installation-ecs.model.js' */
 /**
  * Pour les générateurs "Autre système thermodynamique", les calculs sont faits comme pour les 'cet sur air ambiant'
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ch' | 'ecs'}
  */
 export function updateGenerateurPacs(dpe, de, type) {