@open3cl/engine 1.11.2 → 1.11.4

package/7_inertie.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 
 describe('Inertie unit tests', () => {
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 53
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 53
    */
   const inertie = new Inertie();
 

package/8_intermittence.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 
 /**
  * 8. Modélisation de l'intermittence
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §8
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §8
  *
  * i = i0 / (1 + 0.1 * (G - 1)) avec G = GV / (Sh * Hsp)
  * (fonction pure, aucune dépendance à mocker).

package/9_besoin_ch.js

@@ -1,3 +1,5 @@
+/** @import { GenerateurChauffage } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcs } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import tvs from './tv.js';
 import { calc_besoin_ecs_j } from './11_besoin_ecs.js';
@@ -99,7 +101,7 @@ export default function calc_besoin_ch(
    * Seules les pertes des générateurs et des ballons de stockage en volume chauffé sont récupérables. Les pertes
    * récupérées des générateurs d’air chaud sont nulles.
    *
-   * @type {GenerateurChauffageItem[]}
+   * @type {GenerateurChauffage[]}
    */
   const gen_ch_recup = instal_ch.flatMap((inst_ch) =>
     inst_ch.generateur_chauffage_collection.generateur_chauffage.filter(
@@ -112,9 +114,9 @@ export default function calc_besoin_ch(
    * 9.1.1 - Générateurs de la collection ECS assurant l'ECS uniquement, avec Qp0 > 0 et situés en
    * volume chauffé : leurs pertes de génération sont aussi récupérées pour le chauffage.
    * Les générateurs 'chauffage + ecs' sont exclus car déjà présents dans la collection chauffage.
-   * @see issue #153
+   * @see issue 153
    *
-   * @type {GenerateurEcsItem[]}
+   * @type {GenerateurEcs[]}
    */
   const gen_ecs_recup = instal_ecs.flatMap((inst_ecs) =>
     (inst_ecs.generateur_ecs_collection?.generateur_ecs || []).filter(

package/9_besoin_ch.spec.js

@@ -73,7 +73,7 @@ const { calc_Qrec_gen_j, calc_Qrec_gen_ecs_j, isGenerateurEcsSeulRecuperable } =
 
 /**
  * 9. Besoins de chauffage (Bch)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
  */
 describe('calc_Fj - fraction des besoins de chauffage couverte par les apports', () => {
   test('retourne 0 lorsque le nombre de degrés-heures est nul', () => {
@@ -419,7 +419,7 @@ describe('calc_besoin_ch - branches complémentaires', () => {
 /**
  * 9.1.1 - Pertes récupérées de génération : générateurs de la collection ECS assurant l'ECS
  * uniquement, avec Qp0 > 0 et en volume chauffé (issue #153).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
  */
 describe('calc_besoin_ch - récupération des pertes des générateurs ECS seuls (#153)', () => {
   const genEcsSeul = {
@@ -566,7 +566,7 @@ describe('calc_besoin_ch - récupération des pertes des générateurs ECS seuls
  * Immeuble à plusieurs installations ECS dont une collective (ex. installation mixte
  * individuelle/collective) : besoin de chaque installation = Becs_immeuble × Sh_ecs / SH, × rdim
  * pour une installation individuelle (Tribu, Calcul_batiment.Calcul_Cecs et l. 374).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1 et §11.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1 et §11.4
  */
 describe('calc_besoin_ch - immeuble à installations ECS individuelles et collectives', () => {
   const ecsIndividuelle = (surface_habitable, rdim) => ({

package/9_chauffage.js

@@ -1,3 +1,5 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { GenerateurChauffage, GenerateurChauffageDU, InstallationChauffage, InstallationChauffageDE } from './features/dpe/domain/models/installation-chauffage.model.js' */
 import { requestInput, Tbase, tv, tvColumnIDs } from './utils.js';
 import { calc_emetteur_ch } from './9_emetteur_ch.js';
 import {
@@ -195,9 +197,8 @@ export default function calc_chauffage(
       zc,
       principaux.includes(gen)
     );
-    /* c8 ignore next 2 -- repli défensif inatteignable : donnee_utilisateur est toujours renseignée
-       par la première boucle sur gen_ch ci-dessus */
-    (gen.donnee_utilisateur = gen.donnee_utilisateur || {}).nbGenerateurCascade =
+    // donnee_utilisateur est toujours renseignée par la première boucle sur gen_ch ci-dessus
+    /** @type {GenerateurChauffageDU} */ (gen.donnee_utilisateur).nbGenerateurCascade =
       reseauCirculateurUnique(de.enum_cfg_installation_ch_id) ? 1 : gen_ch.length;
 
     calc_generateur_ch(
@@ -251,9 +252,9 @@ export default function calc_chauffage(
  * Comme le moteur de référence CSTB (Tribu, autotests État APP5-0-4/41/43), le générateur
  * prioritaire assure la totalité du besoin et son taux de charge est calculé avec sa seule Pn.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
- * @param gen_ch {GenerateurChauffageItem[]}
- * @return {GenerateurChauffageItem[]} générateurs principaux
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
+ * @param gen_ch {GenerateurChauffage[]}
+ * @return {GenerateurChauffage[]} générateurs principaux
  */
 export function generateursPrincipauxCascade(gen_ch) {
   const priorites = gen_ch.map((gen) => Number(gen.donnee_entree.priorite_generateur_cascade));
@@ -278,7 +279,7 @@ export function generateursPrincipauxCascade(gen_ch) {
  * collectif (cfg 10). Le circulateur unique n'est pas divisé par le nombre de générateurs.
  * Autotests CSTB IC4-0-1 (cfg 6, Tribu Caux_dist_ch = 8908,24 kWh), IC5-0-1 (cfg 8, 1777,76 kWh),
  * IC5-0-3 (cfg 10, 1951,90 kWh).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
  * @param cfgInstallationId {string|number} enum_cfg_installation_ch_id
  * @return {boolean}
  */
@@ -332,8 +333,8 @@ function getProrataGenerateur(
 
 /**
  * Retourne le facteur de couverture solaire pour les maisons avec chauffage solaire
- * @param de {Donnee_entree}
- * @param zc_id {int}
+ * @param de {InstallationChauffageDE}
+ * @param zc_id {number}
  * @returns {number|*|null}
  */
 function tv_ch_facteur_couverture_solaire(de, zc_id) {
@@ -362,7 +363,7 @@ function tv_ch_facteur_couverture_solaire(de, zc_id) {
  * 13.2.1.2 Présence d’un ou plusieurs générateurs à combustion indépendants
  * Calcul du taux de charge cdimref et cdimrefDep pour chacun des générateurs
  *
- * @param installationChauffage {InstallationChauffageItem[]}
+ * @param installationChauffage {InstallationChauffage[]}
  * @param GV {number} déperdition de l'enveloppe
  * @param zcId {string} id de la zone climatique du bien
  * @param caId {string} id de la classe d'altitude du bien
@@ -421,7 +422,7 @@ export function tauxChargeForGenerator(installationChauffage, GV, caId, zcId, th
  * En immeuble, chaque installation est ramenée à l'échelle de l'immeuble par son rdim (y compris les
  * installations collectives : rdim est renseigné par le logiciel et déjà appliqué au GV avant correctif).
  *
- * @param installCh {InstallationChauffageItem}
+ * @param installCh {InstallationChauffage}
  * @param th {string} type d'habitation
  * @return {number}
  */

package/9_chauffage.spec.js

@@ -176,7 +176,7 @@ beforeEach(() => {
 
 /**
  * 9. Consommation de chauffage — orchestration
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
  */
 describe('calc_chauffage - cas nominal (1 générateur, 1 émetteur)', () => {
   test('agrège les consommations et renseigne les données intermédiaires', () => {
@@ -243,7 +243,7 @@ describe('calc_chauffage - cas nominal (1 générateur, 1 émetteur)', () => {
 /**
  * Longueur du réseau de l'installation de chauffage, même formule que la longueur de
  * bouclage ECS : Lb = 4 × (Sh / Niv)^0,5 + 6 × (Niv − 0,5)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
  */
 describe('calc_lb_installation_ch - longueur du réseau de chauffage', () => {
   test.each([
@@ -442,7 +442,7 @@ describe('calc_chauffage - générateurs à combustion', () => {
   });
 
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 (prorata de Pch à la surface desservie)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.2.4 (prorata de Pch à la surface desservie)
    */
   test('ratio surface chauffée de l’installation / Sh transmis pour la Pn estimée (issue #264)', () => {
     const ch = installation(
@@ -550,7 +550,7 @@ describe('calc_chauffage - générateurs à combustion', () => {
  * dimensionné pour tout le besoin (pas de division par le nombre de générateurs). La consommation
  * est ensuite répartie entre générateurs (division par nbGenWithAuxConsoDistribution).
  * Autotests CSTB IC4-0-2 / IC4-0-21 (cascade de 2 chaudières gaz, Tribu Pcirc = 1321,76 W).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
  */
 describe('calc_chauffage - nombre de générateurs pris en compte pour le circulateur', () => {
   test('installation simple (cfg 1) avec 2 générateurs en cascade : circulateur unique', () => {
@@ -577,7 +577,7 @@ describe('calc_chauffage - nombre de générateurs pris en compte pour le circul
  * PAC (cfg 8) et base + appoint collectif (cfg 10) partagent le réseau ; le circulateur est
  * dimensionné pour tout le besoin, comme en installation simple (cfg 1).
  * Autotests CSTB IC4-0-1 (cfg 6), IC5-0-1 (cfg 8), IC5-0-3 (cfg 10).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
  */
 describe('reseauCirculateurUnique', () => {
   test.each(['1', '6', '8', '10', 6, 8])('configuration %s : circulateur unique', (cfg) => {
@@ -641,7 +641,7 @@ describe('calc_chauffage - prorata entre générateurs', () => {
 
 /**
  * 13.2.1.3 Cascade de deux générateurs à combustion avec priorité
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2.1.3
  */
 describe('calc_chauffage - cascade de générateurs à combustion avec priorité', () => {
   /** Deux chaudières (combustion) en cascade sur un seul émetteur. */
@@ -779,7 +779,7 @@ describe('calc_chauffage - initialisation défensive des données du générateu
 
 /**
  * 13.2.1.2 Taux de charge des générateurs à combustion (cdimref)
- * @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('tauxChargeForGenerator - taux de charge des générateurs à combustion', () => {
   /** Installation avec un générateur à combustion. */

package/9_conso_ch.spec.js

@@ -66,7 +66,7 @@ function emetteur(i0, surface = 100, lien = '1') {
 
 /**
  * 9. Consommations de chauffage (Cch)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9
  */
 describe('conso_ch - configuration par défaut (installation simple)', () => {
   beforeEach(() => {
@@ -467,7 +467,7 @@ describe('conso_ch - installation collective base + appoint', () => {
    * bâtiment) est proratisé à la surface chauffée par l'installation, comme `bch`.
    * Tribu Calcul_installation.cs l.79-86 : bch = Bch1 × S_ratio / Rdim et
    * Bch1_mensuel × S_ratio / Rdim, avec S_ratio = Sh_chauffée × Rdim / Stotal.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.8
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.8
    */
   describe('installation desservant une partie de l’immeuble (Sh_installation < Sh)', () => {
     function appelPartiel(pos, { pn = 0, Sh = 200, sInst = 100, bch = 25, rdim = 1 } = {}) {
@@ -645,7 +645,7 @@ describe('conso_ch - installation collective base + appoint', () => {
  * génération (§15.1 : Caux_g = Paux_g × Bch_générateur / Pn).
  * Autotests CSTB APP5-0-5 (relève de PAC, 0,8 / 0,2) et IC4-0-1 (relève d'une chaudière bois,
  * 0,75 / 0,25).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9 et §15.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9 et §15.1
  */
 describe('conso_ch - besoin couvert par le générateur', () => {
   beforeEach(() => {

package/9_emetteur_ch.js

@@ -43,7 +43,7 @@ function tv_rendement_emission(di, de) {
   const matcher = {
     enum_type_emission_distribution_id: de.enum_type_emission_distribution_id
   };
-  const row = tv('rendement_emission', matcher, de);
+  const row = tv('rendement_emission', matcher);
   if (row) {
     di.rendement_emission = Number(row.re);
     de.tv_rendement_emission_id = Number(row.tv_rendement_emission_id);
@@ -56,7 +56,7 @@ function tv_rendement_regulation(di, de) {
   const matcher = {
     enum_type_emission_distribution_id: de.enum_type_emission_distribution_id
   };
-  const row = tv('rendement_regulation', matcher, de);
+  const row = tv('rendement_regulation', matcher);
   if (row) {
     di.rendement_regulation = Number(row.rr);
     de.tv_rendement_regulation_id = Number(row.tv_rendement_regulation_id);
@@ -73,7 +73,7 @@ function tv_rendement_regulation(di, de) {
  */
 export function isIntermittenceCollectiveSaisie(de) {
   if (!bug_for_bug_compat || !de.tv_intermittence_id) return false;
-  const row = tv('intermittence', { tv_intermittence_id: de.tv_intermittence_id }, de);
+  const row = tv('intermittence', { tv_intermittence_id: de.tv_intermittence_id });
   if (!row || !row.enum_type_installation_id) return false;
   return !row.enum_type_installation_id.split('|').includes('1');
 }
@@ -94,7 +94,7 @@ function tv_intermittence(di, de, inst_ch_de, map_id, inertie_id, isAppointIndiv
       const inertie = {
         tv_intermittence_id: de.tv_intermittence_id
       };
-      row = tv('intermittence', inertie, de);
+      row = tv('intermittence', inertie);
 
       if (row && row.comptage_individuel) {
         hasComptage = row.comptage_individuel.includes('Présence');
@@ -128,7 +128,7 @@ function tv_intermittence(di, de, inst_ch_de, map_id, inertie_id, isAppointIndiv
     delete matcher.comptage_individuel;
   }
 
-  row = tv('intermittence', matcher, de);
+  row = tv('intermittence', matcher);
   if (row) {
     di.i0 = Number(row.i0);
     de.tv_intermittence_id = Number(row.tv_intermittence_id);

package/9_emetteur_ch.spec.js

@@ -81,7 +81,7 @@ function emetteur({
  * Tests pour le calcul du rendement de distribution pour chauffage (9_emetteur_ch.js)
  * Focus sur la correction du bug #170 : conservation du tv_rendement_distribution_ch_id
  * pour type_emission_distribution=41 ('Autres équipements').
- * @see : https://github.com/Open3CL/engine/issues/170
+ * @see https://github.com/Open3CL/engine/issues/170
  */
 describe('tv_rendement_distribution_ch - rendement de distribution CH', () => {
   test("type_emission=41 AVEC tv_rendement_distribution_ch_id=6 : conserve l'ID original", () => {

package/9_generateur_ch.js

@@ -1,3 +1,6 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { EmetteurChauffage, GenerateurChauffageDE, GenerateurChauffageDI } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcs, GenerateurEcsDE, GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import { requestInput, requestInputID, tv, tvColumnIDs } from './utils.js';
 import { conso_aux_distribution_ch, conso_aux_gen } from './15_conso_aux.js';
@@ -57,15 +60,15 @@ export function calc_Qrec_gen_j(gen_ch, nrefj, Bch_hp_j) {
  * l'usage est 'ecs' sont concernés. Les générateurs 'chauffage + ecs' sont déjà pris en compte via
  * la collection des générateurs de chauffage (cf. issue #153).
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
  *
- * @param gen_ecs {GenerateurEcsItem}
+ * @param gen_ecs {GenerateurEcs}
  * @param nrefj {number}
  * @returns {number}
  */
 export function calc_Qrec_gen_ecs_j(gen_ecs, nrefj) {
   const de = gen_ecs.donnee_entree;
-  const di = gen_ecs.donnee_intermediaire || {};
+  const di = /** @type {GenerateurEcsDI} */ (gen_ecs.donnee_intermediaire || {});
 
   if (!isGenerateurEcsSeulRecuperable(gen_ecs)) return 0;
 
@@ -78,12 +81,12 @@ export function calc_Qrec_gen_ecs_j(gen_ecs, nrefj) {
  * s'il a des pertes à l'arrêt (Qp0 > 0), s'il est en volume chauffé et si son usage est 'ecs' seul
  * (enum_usage_generateur_id = 2).
  *
- * @param gen_ecs {GenerateurEcsItem}
+ * @param gen_ecs {GenerateurEcs}
  * @returns {boolean}
  */
 export function isGenerateurEcsSeulRecuperable(gen_ecs) {
-  const de = gen_ecs.donnee_entree || {};
-  const di = gen_ecs.donnee_intermediaire || {};
+  const de = /** @type {GenerateurEcsDE} */ (gen_ecs.donnee_entree || {});
+  const di = /** @type {GenerateurEcsDI} */ (gen_ecs.donnee_intermediaire || {});
   return (
     Number(di.qp0 || 0) > 0 &&
     Number(de.position_volume_chauffe ?? 0) === 1 &&
@@ -95,7 +98,7 @@ function tv_rendement_generation(di, de, du) {
   const matcher = {
     enum_type_generateur_ch_id: requestInputID(de, du, 'type_generateur_ch')
   };
-  const row = tv('rendement_generation', matcher, de);
+  const row = tv('rendement_generation', matcher);
   if (row) {
     di.rendement_generation = Number(row.rg);
     di.rg = di.rendement_generation;
@@ -128,8 +131,8 @@ export function type_generateur_ch(di, de, du, usage_generateur) {
 /**
  * Récupération du type de générateur
  * @param dpe {FullDpe}
- * @param de {Donnee_entree}
- * @param di {Donnee_intermediaire}
+ * @param de {GenerateurChauffageDE}
+ * @param di {GenerateurChauffageDI}
  * @param du {Object}
  */
 export function checkForGeneratorType(dpe, de, di, du) {
@@ -285,7 +288,7 @@ export function calc_generateur_ch(
    * ce générateur (part de base / d'appoint, relève), et non le besoin de toute l'installation.
    * Autotests CSTB APP5-0-5 (chaudière fioul en relève de PAC, Tribu Qaux_ch = 2,13 kWh) et
    * IC4-0-1 (chaudière en relève d'une chaudière bois).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   const besoinGenerateur = besoinCouvert ?? bch;
   const besoinGenerateurDep = bch > 0 ? (bch_dep * besoinGenerateur) / bch : 0;
@@ -330,11 +333,11 @@ const TYPE_EMISSION_DISTRIBUTION_AERAULIQUE = 5;
  * aéraulique a donc des auxiliaires de distribution, bien que hasConsoForAuxDistribution l'exclue.
  * L'émetteur est rattaché au générateur s'il est seul, ou par enum_lien_generateur_emetteur_id.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
  * @see Tribu Calcul_installation.cs (calcul_Cauxiliaires), Calcul_batiment.cs (Calcul_Cauxiliaires)
  * @see https://github.com/Open3CL/engine/issues/291
- * @param em_ch {EmetteurChauffageItem[]}
- * @param de {Donnee_entree} donnée d'entrée du générateur de chauffage
+ * @param em_ch {EmetteurChauffage[]}
+ * @param de {GenerateurChauffageDE} donnée d'entrée du générateur de chauffage
  * @returns {boolean}
  */
 export function hasEmetteurAerauliqueLie(em_ch, de) {

package/9_generateur_ch.spec.js

@@ -94,7 +94,7 @@ beforeEach(() => {
 
 /**
  * 9.1.1 Pertes récupérées de génération pour le chauffage (Qrec_gen)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
  */
 describe('calc_Qrec_gen_j - pertes de génération récupérées', () => {
   /** Générateur minimal en volume chauffé, non "air chaud". */
@@ -159,7 +159,7 @@ describe('calc_Qrec_gen_j - pertes de génération récupérées', () => {
  * 9.1.1 Pertes récupérées de génération pour le chauffage : générateur de la collection ECS
  * assurant l'ECS uniquement (issue #153).
  * Dperj = Nrefj * 1790 / 8760 ; Qgen_rec_j = 0,48 * Cper * Qp0 * Dperj
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.1
  */
 describe('calc_Qrec_gen_ecs_j / isGenerateurEcsSeulRecuperable - générateur ECS seul', () => {
   /** Générateur ECS seul (usage 2), en volume chauffé, avec Qp0 = 100 W. */
@@ -355,7 +355,7 @@ describe('checkForGeneratorType - classification du générateur', () => {
 
   /**
    * Chaudière fioul par défaut : chaudière 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('cas 119 : chaudière fioul par défaut selon l’année de construction', () => {
     beforeEach(() => {
@@ -397,7 +397,7 @@ describe('checkForGeneratorType - classification du générateur', () => {
 
 /**
  * 15 Consommations d'auxiliaires de distribution : générateurs concernés.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15
  */
 describe('hasConsoForAuxDistribution - éligibilité aux auxiliaires de distribution', () => {
   test('générateurs éligibles (chacune des plages)', () => {
@@ -428,7 +428,7 @@ describe('hasConsoForAuxDistribution - éligibilité aux auxiliaires de distribu
 /**
  * 15.2 Réseau aéraulique (émetteur 5) rattaché au générateur : auxiliaires de distribution calculés
  * quel que soit le générateur, comme le moteur de référence (#291).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
  */
 describe('hasEmetteurAerauliqueLie - réseau aéraulique rattaché au générateur', () => {
   const em = (ed, lien) => ({
@@ -688,7 +688,7 @@ describe('calc_generateur_ch - orchestration du calcul générateur', () => {
  * effectivement couvert par le générateur (retourné par conso_ch : part de relève, de base ou
  * d'appoint) et non le besoin de toute l'installation.
  * Autotest CSTB APP5-0-5 : chaudière fioul en relève de PAC (part 0,2), Tribu Qaux_ch = 2,13 kWh.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
  */
 describe('calc_generateur_ch - besoin couvert transmis aux auxiliaires de génération', () => {
   const dpe = {

package/README.md

@@ -383,15 +383,15 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.10.0`** · branche `main` · généré le 2026-10-29
+> **Version `1.11.3`** · branche `main` · généré le 2026-11-07
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>88 475</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>75 700</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>85,56 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>75 961</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>85,86 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
@@ -402,9 +402,9 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 | 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **93,36 %** | `███████████████████░` |  9 180 / 9 833 |
 | 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **92,14 %** | `██████████████████░░` |  9 003 / 9 771 |
 | 🟢  | **Maison individuelle (2026)**<br/><sub>`dpe_maison_individuelle_2026.csv`</sub>                                        | **90,46 %** | `██████████████████░░` | 9 046 / 10 000 |
-| 🟢  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **89,13 %** | `██████████████████░░` |  8 680 / 9 739 |
-| 🟢  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **86,04 %** | `█████████████████░░░` |  8 539 / 9 924 |
-| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **70,50 %** | `██████████████░░░░░░` |  6 748 / 9 571 |
+| 🟢  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **89,23 %** | `██████████████████░░` |  8 690 / 9 739 |
+| 🟢  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **86,17 %** | `█████████████████░░░` |  8 552 / 9 924 |
+| 🟡  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **72,99 %** | `███████████████░░░░░` |  6 986 / 9 571 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **57,83 %** | `████████████░░░░░░░░` |  5 678 / 9 818 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -416,24 +416,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>5,64 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,87 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,11 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>957,0 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>5,25 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,54 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>527,5 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Appartement · chauffage individuel (2025)**  | 4,00 ms | 3,58 ms | 1,42 ms |  34,6 ms | 6,99 ms | 9,30 ms |
-| **Appartement · chauffage collectif (2025)**   | 4,46 ms | 4,04 ms | 1,62 ms |  42,4 ms | 7,33 ms | 9,33 ms |
-| **Logement individuel (2025)**                 | 5,20 ms | 4,57 ms | 1,74 ms |  56,0 ms | 9,72 ms | 13,5 ms |
-| **Maison individuelle (2025)**                 | 6,01 ms | 5,41 ms | 2,04 ms |  51,8 ms | 10,7 ms | 14,3 ms |
-| **Maison individuelle (2026)**                 | 6,16 ms | 5,47 ms | 2,09 ms |  46,7 ms | 11,1 ms | 15,1 ms |
-| **Immeuble · chauffage collectif**             | 5,81 ms | 4,91 ms | 0,14 ms | 126,7 ms | 10,9 ms | 17,7 ms |
-| **Immeuble · chauffage individuel**            | 7,07 ms | 5,99 ms | 0,11 ms | 123,4 ms | 14,5 ms | 22,6 ms |
-| **Immeuble · chauffage mixte**                 | 5,73 ms | 4,63 ms | 0,20 ms | 957,0 ms | 11,9 ms | 19,7 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,33 ms | 5,26 ms | 1,79 ms |  79,2 ms | 12,0 ms | 19,1 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,67 ms | 3,30 ms | 1,36 ms |  43,8 ms | 6,43 ms | 8,54 ms |
+| **Appartement · chauffage collectif (2025)**   | 4,14 ms | 3,70 ms | 1,59 ms |  42,2 ms | 6,90 ms | 8,93 ms |
+| **Logement individuel (2025)**                 | 5,04 ms | 4,49 ms | 1,81 ms |  55,4 ms | 9,25 ms | 13,0 ms |
+| **Maison individuelle (2025)**                 | 5,94 ms | 5,28 ms | 2,04 ms |  59,1 ms | 10,7 ms | 14,7 ms |
+| **Maison individuelle (2026)**                 | 6,03 ms | 5,39 ms | 1,92 ms |  53,8 ms | 10,6 ms | 14,6 ms |
+| **Immeuble · chauffage collectif**             | 5,29 ms | 4,48 ms | 0,14 ms | 123,7 ms | 9,60 ms | 16,3 ms |
+| **Immeuble · chauffage individuel**            | 6,07 ms | 5,12 ms | 0,12 ms | 111,3 ms | 12,3 ms | 20,4 ms |
+| **Immeuble · chauffage mixte**                 | 5,17 ms | 4,19 ms | 0,19 ms | 527,5 ms | 11,0 ms | 17,2 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,91 ms | 4,90 ms | 1,80 ms |  83,7 ms | 11,1 ms | 18,6 ms |
 
 <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
 dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas

package/apport_et_besoin.spec.js

@@ -62,7 +62,7 @@ beforeEach(() => {
 
 /**
  * Calcul des apports et besoins (assembleur chauffage / froid / ECS)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf
  */
 describe('calc_apport_et_besoin', () => {
   test('agrège les besoins, apports et volumes ECS (climatisation présente)', () => {

package/conso.js

@@ -1,3 +1,5 @@
+/** @import { GenerateurChauffage, GenerateurChauffageDE, GenerateurChauffageDU } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcs, GenerateurEcsDE, GenerateurEcsDU, InstallationEcs } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import calc_conso_eclairage from './16_conso_eclairage.js';
 import tvs from './tv.js';
@@ -219,7 +221,7 @@ export function masqueEnergie(groupe) {
  * Calcul_batiment.cs l.1318). Vérifié sur 927 / 1000 DPE ADEME appartement gaz collectif 2026.
  *
  * @param base {object} barème (prix unitaires et fonctions par tranches)
- * @param consoGroupe {function(masque): {total: number, collectif: number}} consommations EF
+ * @param consoGroupe {function(object): {total: number, collectif: number}} consommations EF
  * @param nbLogements {number} nombre de logements (1 hors immeuble)
  * @param genCollectifs {Set} générateurs de chauffage / ECS d'installations collectives
  * @param ratioSurfaceCollectif {number} SH_immeuble / SH_logement pour un appartement (1 sinon)
@@ -261,12 +263,12 @@ function coefPourGenerateur(coef, gen) {
 /**
  * Part d'appoint individuel (40 % du besoin, §9.1.6) de la consommation d'un convecteur
  * bi-jonction, mémorisée par conso_ch (9_conso_ch.js) ; 0 pour les autres générateurs.
- * @param gen {GenerateurChauffageItem}
+ * @param gen {GenerateurChauffage}
  * @param field {'conso_ch'|'conso_ch_depensier'}
  * @returns {number}
  */
 export function appointBijonction(gen, field) {
-  const du = gen.donnee_utilisateur || {};
+  const du = /** @type {GenerateurChauffageDU} */ (gen.donnee_utilisateur || {});
   const appoint =
     field === 'conso_ch_depensier'
       ? du.conso_ch_appoint_bijonction_depensier
@@ -281,10 +283,10 @@ export function appointBijonction(gen, field) {
  * Moteur de référence CSTB : DPE.Core Calcul_batiment.cs l.861-872 (base Cch1 → conso_elec_coll_ch
  * si l'installation n'est pas individuelle) et l.912-915 (Cch_appoint_elec → conso_elec_indiv_ch),
  * Calcul_cout.cs l.149-172 (tarification séparée collectif / individuel).
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.6 (convecteurs bi-jonction)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §9.1.6 (convecteurs bi-jonction)
  *
  * @param coef {object} barème issu de coefCoutProrata
- * @param gen {GenerateurChauffageItem}
+ * @param gen {GenerateurChauffage}
  * @param typeEnergie {string}
  * @param conso {number} consommation du générateur (base + appoint)
  * @param field {'conso_ch'|'conso_ch_depensier'}
@@ -444,7 +446,7 @@ const ENERGIE_MULTI_BATIMENT = {
 
 /**
  * Récupération du coefficient d'émission GES pour le générateur
- * @param gen_ch {GenerateurChauffageItem||GenerateurEcsItem}
+ * @param gen_ch {GenerateurChauffage|GenerateurEcs}
  * @param suffix {'ch'|'ecs'}
  * @param dateDpe {string} date d'établissement du DPE
  * @param versionLogiciel {string} version du logiciel de saisie
@@ -508,8 +510,9 @@ export default function calc_conso(
       value.donnee_entree.enum_methode_calcul_conso_id =
         ch.donnee_entree.enum_methode_calcul_conso_id;
       value.donnee_entree.enum_type_installation_id = ch.donnee_entree.enum_type_installation_id;
-      (value.donnee_utilisateur = value.donnee_utilisateur || {}).coeffEmissionGes =
-        getGesCoeffForGenerateur(value, 'ch', dateDpe, versionLogiciel);
+      /** @type {GenerateurChauffageDU} */ (
+        value.donnee_utilisateur = value.donnee_utilisateur || {}
+      ).coeffEmissionGes = getGesCoeffForGenerateur(value, 'ch', dateDpe, versionLogiciel);
     });
     return acc.concat(generateur_chauffage);
   }, []);
@@ -523,8 +526,9 @@ export default function calc_conso(
       generateur_ecs.forEach((value) => {
         value.donnee_entree.cle_repartition_ecs =
           (ecs.donnee_entree.cle_repartition_ecs || 1) * getRdimEcs(ecs);
-        (value.donnee_utilisateur = value.donnee_utilisateur || {}).coeffEmissionGes =
-          getGesCoeffForGenerateur(value, 'ecs', dateDpe, versionLogiciel);
+        /** @type {GenerateurEcsDU} */ (
+          value.donnee_utilisateur = value.donnee_utilisateur || {}
+        ).coeffEmissionGes = getGesCoeffForGenerateur(value, 'ecs', dateDpe, versionLogiciel);
       });
     }
     return acc.concat(generateur_ecs);
@@ -882,7 +886,7 @@ export function classe_emission_ges(emission_ges_5_usages_m2, zc_id, ca_id, Sh)
 
 /**
  Calcul de la consommation globale d'ECS
- * @param gen_ecs {Generateur_ecs_collection}
+ * @param gen_ecs {GenerateurEcs[]}
  * @param field {string}
  * @param coef {number}
  * @param prorataECS {number}
@@ -948,8 +952,8 @@ export function getAuxGenerationEcs(ecs, field, coef, prorataECS, facteurAc = 1)
 
 /**
  * Calcul de la consommation globale de chauffage
- * @param gen_ch {Generateur_chauffage_collection}
- * @param field {string}
+ * @param gen_ch {GenerateurChauffage[]}
+ * @param field {'conso_ch'|'conso_ch_depensier'}
  * @param coef {number}
  * @param prorataChauffage {number}
  * @param prefix {string}
@@ -1133,7 +1137,7 @@ function calc_conso_pond(
 /**
  * Retourne le type d'énergie utilisé.
  * 1 - Electricité par défaut si la donnée n'est pas définie
- * @param donneeEntree {Donnee_entree}
+ * @param donneeEntree {GenerateurChauffageDE|GenerateurEcsDE}
  * @param suffix {string} Suffix à ajouter au type électricité
  * @return {string}
  */