@open3cl/engine 1.11.2 → 1.11.4

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) {

package/13.2_generateur_pac.spec.js

@@ -9,7 +9,7 @@ const { updateGenerateurPacs } = await import('./13.2_generateur_pac.js');
 /**
  * 13.2 - Substitution des générateurs "autre système thermodynamique" par un CET
  * sur air ambiant équivalent selon la période d'installation.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13.2
  */
 describe('updateGenerateurPacs - substitution des générateurs thermodynamiques', () => {
   test("aucune période d'installation renseignée : aucune modification", () => {

package/13_rendement_distribution_ecs.spec.js

@@ -16,7 +16,7 @@ const { default: rendement_distribution_ecs } = await import('./13_rendement_dis
 
 /**
  * 13. Rendement de distribution de l'ECS
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §13
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §13
  */
 describe('rendement_distribution_ecs', () => {
   test('ne retourne aucune valeur (fonction sans effet de sortie)', () => {

package/14_generateur_ecs.js

@@ -1,3 +1,4 @@
+/** @import { GenerateurEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import {
   bug_for_bug_compat,
@@ -200,7 +201,7 @@ const PVEILLEUSES_EXPORTEES_TRIBU = [10, 0.01];
  * chauffe-eau gaz / GPL instantané 2001-2015, veilleuse de la méthode (100 W) retenue, et
  * pveilleuse exportée par le DPE égale à 10 W ou 0,01 kW.
  * @param typeGenerateurId {string|number} enum_type_generateur_ecs_id
- * @param di {Donnee_intermediaire}
+ * @param di {GenerateurEcsDI}
  * @returns {boolean}
  */
 export function isPveilChauffeEauGazInstantaneTribu(typeGenerateurId, di) {

package/14_generateur_ecs.spec.js

@@ -90,7 +90,7 @@ const { getChaudiereFioulDefautId } = await import('./13.2_generateur_combustion
 
 /**
  * 14. Générateur d'ECS : rendements et consommations
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §14
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §14
  */
 describe('rendements de génération (fonctions pures)', () => {
   const di = { rpn: 0.9, qp0: 0.1, pveil: 0.02, Qgw: 1000 };
@@ -415,7 +415,7 @@ describe('calc_gen_ecs - consommation par générateur', () => {
 
   /**
    * 14.1 - Pertes de stockage forfaitaires (générateur électrique à accumulation).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
    */
   test('électrique avec stockage : pertes de stockage forfaitaires et matcher de volume', () => {
     vi.mocked(tvColumnIDs).mockImplementation((table) =>
@@ -690,7 +690,7 @@ describe('calc_gen_ecs - consommation par générateur', () => {
 
   /**
    * Issue #39 : présence de veilleuse lue dans la fiche technique (de.presence_veilleuse).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §14.1
    */
   test.each([
     [1, undefined, 0.02],
@@ -943,7 +943,7 @@ describe('calc_gen_ecs - consommation par générateur', () => {
 
   /**
    * Type 84 : 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
    */
   test('type 84 combustion compatible 84 : chaudière de la période de construction retenue', () => {
     vi.mocked(getChaudiereFioulDefautId).mockReturnValue('39');

package/15_conso_aux.js

@@ -1,3 +1,5 @@
+/** @import { EmetteurChauffage, EmetteurChauffageDI, GenerateurChauffageDE, GenerateurChauffageDI } from './features/dpe/domain/models/installation-chauffage.model.js' */
+/** @import { GenerateurEcsDE, GenerateurEcsDI, InstallationEcsDE, InstallationEcsDI } from './features/dpe/domain/models/installation-ecs.model.js' */
 import enums from './enums.js';
 import tvs from './tv.js';
 import { mois_liste, Njj, Tbase } from './utils.js';
@@ -11,8 +13,8 @@ const H_CHAUDIERE_BOIS = 10.5;
 
 /**
  * 15.1 Consommation des auxiliaires de génération
- * @param di {Donnee_intermediaire}
- * @param de {Donnee_entree}
+ * @param di {GenerateurChauffageDI|GenerateurEcsDI}
+ * @param de {GenerateurChauffageDE|GenerateurEcsDE}
  * @param type {'ecs'|'ch'}
  * @param besoin {number} Besoin en chauffage ou ecs pour ce générateur
  * @param besoin_dep {number} Besoin en chauffage ou ecs pour ce générateur (mode dépensier)
@@ -31,7 +33,7 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep) {
    * nominale réelle du générateur, comme le moteur de référence CSTB (Tribu) et comme le calcul
    * dépensier. Autotests CSTB APP3-0-3 (chaudière bois collective 150 kW, Tribu Qaux_ch =
    * 13,27 kWh) et IC4-0-1 (chaudière bois 300 kW, Tribu Qaux_ch = 864,60 kWh).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   const pnReel = di.pn / (de.ratio_virtualisation || 1);
   let pe = pnReel;
@@ -53,7 +55,7 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep) {
    * Installation collective virtualisée : Paux_g (W) est celle du générateur de l'immeuble
    * (Pn = pe, puissance immeuble) et Caux_g = Paux_g × Bch_logement / Pn. Le terme G ne doit pas
    * être proratisé par ratio_virtualisation (sinon G × ratio), comme le moteur CSTB (Tribu).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   const Paux_g_ch = g + h * (pe / 1000);
 
@@ -65,7 +67,7 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep) {
    * le moteur de référence CSTB (Tribu) n'utilise aucune clé de répartition pour ces
    * installations (DPE.Core : Calcul_installation.cs l.79-80, Calcul_generateur.cs l.1497,
    * Calcul_batiment.cs l.652). La clé reste appliquée au collectif et à l'ECS.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   const ignoreCle = type === 'ch' && String(de.enum_type_installation_id) === '1';
   const cle = ignoreCle ? 1 : de[`cle_repartition_${type}`] || 1;
@@ -78,7 +80,7 @@ export function conso_aux_gen(di, de, type, besoin, besoin_dep) {
    * seconde fois (sinon Bch × (Sc / Sh)²), comme le moteur de référence CSTB (Tribu).
    * Autotest CSTB MI5-0-8 : radiateur gaz, Sc = 96 m², Sh = 136 m², Tribu Qaux_ch = 84,69 kWh
    * (59,78 kWh avec le double prorata, −29 %).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   di[`conso_auxiliaire_generation_${type}`] = (Paux_g_ch * besoinAppart) / pnReel || 0;
   di[`conso_auxiliaire_generation_${type}_depensier`] = (Paux_g_ch * besoinAppartDep) / pnReel || 0;
@@ -167,9 +169,9 @@ function getFacteur(values, type, id, presenceVentilateur) {
 
 /**
  * Calcul de la consommation des auxiliaires de distribution de chauffage
- * @param em_ch { EmetteurChauffageItem[]}
- * @param de {Donnee_entree} donnée du générateur de chauffage
- * @param di {Donnee_intermediaire} donnée intermédiaire du générateur de chauffage
+ * @param em_ch { EmetteurChauffage[]}
+ * @param de {GenerateurChauffageDE} donnée du générateur de chauffage
+ * @param di {GenerateurChauffageDI} donnée intermédiaire du générateur de chauffage
  * @param du {object} donnée utilisateur du générateur de chauffage
  * @param surfaceHabitable {number}
  * @param zcId {number} id de la zone climatique du bien
@@ -214,9 +216,9 @@ export function conso_aux_distribution_ch(
 
 /**
  * 15.2.1 Puissance des circulateurs de chauffage
- * @param em_ch { EmetteurChauffageItem[]}
- * @param de {Donnee_entree} donnée du générateur de chauffage
- * @param di {Donnee_intermediaire} donnée intermédiaire du générateur de chauffage
+ * @param em_ch { EmetteurChauffage[]}
+ * @param de {GenerateurChauffageDE} donnée du générateur de chauffage
+ * @param di {GenerateurChauffageDI} donnée intermédiaire du générateur de chauffage
  * @param du {object} donnée utilisateur du générateur de chauffage
  * @param surfaceHabitable {number}
  * @param GV {number} déperdition de l'enveloppe
@@ -285,7 +287,7 @@ function getPuissanceCirculateur(em_ch, de, di, du, surfaceHabitable, GV, Tbase)
 
   // Exposition de la longueur du réseau (lb) dans les données intermédiaires des émetteurs desservis
   em_ch.forEach((em) => {
-    em.donnee_intermediaire = em.donnee_intermediaire || {};
+    em.donnee_intermediaire = /** @type {EmetteurChauffageDI} */ (em.donnee_intermediaire || {});
     em.donnee_intermediaire.lb = Lem;
   });
 
@@ -319,8 +321,8 @@ function getPuissanceCirculateur(em_ch, de, di, du, surfaceHabitable, GV, Tbase)
  * température impose 15 °C, quel que soit l'ordre de saisie des émetteurs (comme le moteur de
  * référence CSTB Tribu). Auparavant, seul le premier émetteur était considéré.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
- * @param em_ch {EmetteurChauffageItem[]}
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+ * @param em_ch {EmetteurChauffage[]}
  * @return {number}
  */
 export function getDeltaDim(em_ch) {
@@ -343,8 +345,8 @@ export function getDeltaDim(em_ch) {
  *   CAS 3 - enum_bouclage_reseau_ecs_id = 3 (traçage) : conso = 0.14 * BECS_annuel * Sh_install / Sh_logement
  *
  * @param ecs {object} installation ECS
- * @param de {Donnee_entree} donnée d'entrée de l'installation ECS
- * @param di {Donnee_intermediaire} donnée intermédiaire de l'installation ECS
+ * @param de {InstallationEcsDE} donnée d'entrée de l'installation ECS
+ * @param di {InstallationEcsDI} donnée intermédiaire de l'installation ECS
  * @param Sh_logement {number} surface habitable du logement
  * @param Sh_immeuble {number} surface habitable de l'immeuble
  * @param caId {number} id de la classe d'altitude

package/15_conso_aux.spec.js

@@ -36,7 +36,7 @@ const { conso_aux_gen, conso_aux_distribution_ch, conso_aux_distribution_ecs, ge
 
 /**
  * 15.1 Consommation des auxiliaires de génération
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
  */
 describe('conso_aux_gen - auxiliaires de génération', () => {
   let di;
@@ -94,7 +94,7 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
   /**
    * Le besoin transmis par calc_chauffage est déjà proratisé par Sc / Sh : aucun second prorata.
    * Autotest CSTB MI5-0-8 : radiateur gaz (G = 40, H = 0), Sc = 96 m², Sh = 136 m².
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   test('chauffage : surface chauffée partielle sans second prorata Sc / Sh du besoin', () => {
     const diPartiel = { pn: 20000 };
@@ -235,7 +235,7 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
    * installation individuelle (enum_type_installation_id = 1) : ce besoin est déjà proratisé
    * par Sc / Sh, et le moteur CSTB (Tribu) n'utilise aucune clé pour ces installations.
    * La clé reste appliquée au collectif et à l'ECS.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.1
    */
   describe('clé de répartition (issue #252)', () => {
     test('chauffage, installation individuelle : la clé de répartition est ignorée', () => {
@@ -297,7 +297,7 @@ describe('conso_aux_gen - auxiliaires de génération', () => {
 
 /**
  * 15.2 Consommation des auxiliaires de distribution de chauffage
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2
  */
 describe('conso_aux_distribution_ch - auxiliaires de distribution', () => {
   const emCh = [
@@ -379,7 +379,7 @@ describe('conso_aux_distribution_ch - auxiliaires de distribution', () => {
    * Seuls les émetteurs reliés au générateur (même enum_lien_generateur_emetteur_id) dimensionnent
    * son circulateur. Autotest CSTB IC5-0-3 : chaudière (lien 1) sur plancher chauffant + convecteurs
    * électriques d'appoint (lien 2) : Fcot du plancher (0,156), pas le forçage multi-émetteurs.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
    */
   test('émetteurs reliés à un autre générateur : exclus du dimensionnement du circulateur', () => {
     const plancher = {
@@ -412,7 +412,7 @@ describe('conso_aux_distribution_ch - auxiliaires de distribution', () => {
   /**
    * La longueur du réseau le plus défavorisé (Lem) est exposée sous le nom lb dans la donnée
    * intermédiaire de chaque émetteur desservi par le circulateur.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.1
    */
   test('longueur du réseau lb exposée dans la donnée intermédiaire des émetteurs', () => {
     const em = [
@@ -640,7 +640,7 @@ describe('conso_aux_distribution_ch - auxiliaires de distribution', () => {
 
 /**
  * 15.2.1 Chute nominale de température de dimensionnement ΔθDim
- * @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('getDeltaDim - chute nominale de température de dimensionnement', () => {
   const em = (temp, type = '10') => ({
@@ -674,7 +674,7 @@ describe('getDeltaDim - chute nominale de température de dimensionnement', () =
 
 /**
  * 15.2.3 Consommation des auxiliaires de distribution d'ECS
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §15.2.3
  *
  * Les scénarios ci-dessous s'appuient sur l'année réduite à Janvier (31 jours,
  * tefs = 10 °C) définie par les mocks en tête de fichier :

package/16.2_production_enr.js

@@ -1,3 +1,4 @@
+/** @import { EfConso, EpConso, SortieParEnergie } from './features/dpe/domain/models/sortie.model.js' */
 import enums from './enums.js';
 import { mois_liste, tv } from './utils.js';
 import tvs from './tv.js';
@@ -152,7 +153,7 @@ export class ProductionENR {
 
     /**
      * Récupération des consommations électriques pour ch et ecs
-     * @type {SortieParEnergieItem}
+     * @type {SortieParEnergie}
      */
     let consoElec = conso.sortie_par_energie_collection.sortie_par_energie.find(
       (sortie) => sortie.enum_type_energie_id === '1'
@@ -302,7 +303,7 @@ export class ProductionENR {
   /**
    * Mise à jour des consommations ef en minorant l'énergie primaire consommée par l'énergie autoconsommée par chaque enveloppe
    * @param productionElectricite
-   * @param conso {{ep_conso: Ep_conso}}
+   * @param conso {{ep_conso: EpConso}}
    * @param Sh {number}
    * @param coeff_ep_override {number?} coeff ep à surcharger si définit
    */
@@ -350,7 +351,7 @@ export class ProductionENR {
 
   /**
    * Calcul des taux d'autoproduction consommés pour chaque enveloppe
-   * @param efConso {Ef_conso}
+   * @param efConso {EfConso}
    * @param consoElec
    * @param ccom {number}
    * @param consoElecTotale {number}

package/16.2_production_enr.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test, it } from 'vitest';
 
 describe('production ENR unit tests', () => {
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 103
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 103
    */
   const productionENR = new ProductionENR();
 

package/16_conso_eclairage.spec.js

@@ -23,7 +23,7 @@ const { default: calc_conso_eclairage } = await import('./16_conso_eclairage.js'
 
 /**
  * 16.1 Consommation d'éclairage (Cecl)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §16.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §16.1
  *
  * Cecl = (C * Pecl * Nh) / 1000 avec C = 0.9 (interrupteur) et Pecl = 1.4 W/m²
  * Nh = nombre d'heures de fonctionnement de l'éclairage, fonction de la zone climatique.

package/2021_04_13_confort_ete.spec.js

@@ -45,7 +45,7 @@ function plancherHaut({ typeAdjacence = 'extérieur', typeIsolation = 'isolé' }
 
 /**
  * Indicateur de confort d'été
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe confort d'été
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe confort d'été
  */
 describe("calc_confort_ete - indicateur de confort d'été", () => {
   test('inertie lourde + aspect traversant : niveau « bon »', () => {

package/2021_04_13_qualite_isolation.js

@@ -120,7 +120,7 @@ export default function calc_qualite_isolation(enveloppe, dp) {
    * Il ne prend en compte QUE les déperditions par les parois et les ponts thermiques :
    * les déperditions par renouvellement d'air (DR) sont volontairement exclues
    * (cf. issue #45).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 (indicateurs de qualité d'isolation)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 (indicateurs de qualité d'isolation)
    */
   const deperdition =
     dp.deperdition_mur +

package/2021_04_13_qualite_isolation.spec.js

@@ -9,7 +9,7 @@ const { default: calc_qualite_isolation, qualite_isol } =
 
 /**
  * Qualité de l'isolation
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe qualité d'isolation
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe qualité d'isolation
  */
 describe('qualite_isol - classement selon les seuils U', () => {
   const seuils = [0.3, 0.45, 0.65];
@@ -123,7 +123,7 @@ describe('calc_qualite_isolation - agrégation et classement', () => {
   /**
    * Ubat est un coefficient de transmission surfacique moyen : il exclut les
    * déperditions par renouvellement d'air (DR).
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 / issue #45
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 / issue #45
    */
   test("les déperditions par renouvellement d'air (DR) ne sont pas prises en compte dans ubat", () => {
     const env = enveloppe({

package/3.1_b.spec.js

@@ -54,7 +54,7 @@ afterEach(() => {
 
 /**
  * 3.1 Coefficient de réduction des déperditions (b)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.1
  */
 describe('findRanges - encadrement du rapport surface_aiu / surface_aue', () => {
   const ranges = [0.25, 0.5, 0.75, 1, 1.25, 2, 2.5, 3, 3.5, 4, 6, 8, 10, 25, 50];

package/3.2.1_mur.js

@@ -1,3 +1,4 @@
+/** @import { MurDE, MurDI } from './features/dpe/domain/models/mur.model.js' */
 import enums from './enums.js';
 import {
   tv,
@@ -24,7 +25,7 @@ const scriptName = new URL(import.meta.url).pathname.split('/').pop();
  * logiciels) : colonne la plus proche, et en cas d'égalité la colonne inférieure (la plus
  * défavorable thermiquement). Les bornes ouvertes « ≤ x » / « ≥ x » sont ramenées à x.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
  *
  * @param enumMateriauxStructureMurId {string|number}
  * @param epaisseur {number|string}
@@ -87,7 +88,7 @@ function matcherEpaisseurTable(matcher) {
  * 2, 3 - pierre de taille et moellons ; 4 - pisé / béton de terre ; 5, 6 - pan de bois (colombage) ;
  * 7 - bois (rondin) ; 8, 9 - briques pleines ; 21 - autre matériau traditionnel ancien.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
  * @see https://github.com/Open3CL/engine/issues/295
  */
 export const MATERIAUX_PAROI_ANCIENNE = [2, 3, 4, 5, 6, 7, 8, 9, 21];
@@ -99,7 +100,7 @@ export const MATERIAUX_PAROI_ANCIENNE = [2, 3, 4, 5, 6, 7, 8, 9, 21];
  * La méthode ne précise pas de règle d'interpolation pour Umur0 : cette valeur n'est utilisée qu'en
  * compatibilité (bug_for_bug), lorsque le DPE d'origine l'a manifestement appliquée.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
  * @see https://github.com/Open3CL/engine/issues/295
  *
  * @param enumMateriauxStructureMurId {string|number}
@@ -204,7 +205,7 @@ function tv_umur0(di, de, du) {
      * Certains logiciels interpolent Umur0 entre les deux colonnes d'épaisseur qui encadrent
      * l'épaisseur saisie (ex : 2,28 pour un béton banché de 32 cm, entre 30 et 35 cm).
      * Si l'Umur0 du DPE correspond à cette interpolation (tolérance empirique de 0,006), on la reprend.
-     * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
+     * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1.2
      * @see https://github.com/Open3CL/engine/issues/295
      */
     if (bug_for_bug_compat && du.umur0_avant !== undefined) {
@@ -260,7 +261,7 @@ function tv_umur(di, de, du, pc_id, zc, effetJoule) {
     enum_zone_climatique_id: zc,
     effet_joule: effetJoule
   };
-  const row = tv('umur', matcher, de);
+  const row = tv('umur', matcher);
   if (row) {
     di.umur = Number(row.umur);
     de.tv_umur_id = Number(row.tv_umur_id);
@@ -330,7 +331,7 @@ function calc_umur0(di, de, du, versionDpe) {
    * DPE antérieurs à la version 2.4 : certains logiciels n'y cumulent déjà pas le doublage avec une
    * isolation ITE/ITI. Si l'Umur0 du DPE vaut min(2,5 ; Umur0 de la paroi nue), le doublage n'a pas
    * été appliqué : on ne l'applique pas non plus.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
    * @see https://github.com/Open3CL/engine/issues/295
    */
   if (
@@ -376,7 +377,7 @@ function calc_umur0(di, de, du, versionDpe) {
      * intègre l'enduit. Si l'Umur du DPE vaut min(2,5 ; Umur0 avec enduit), le DPE a bien appliqué
      * l'enduit : l'Umur0 d'origine ne doit pas être conservé.
      * Garde : l'enduit isolant ne vaut que pour les parois anciennes (MATERIAUX_PAROI_ANCIENNE).
-     * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
+     * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
      * @see https://github.com/Open3CL/engine/issues/295
      */
     const enduitAppliqueDansDpe =
@@ -510,8 +511,8 @@ export default function calc_mur(mur, zc, pc_id, effetJoule, versionDpe) {
  * Vérification si le calcul des déperditions des murs utilisent, dans le DPE d'origine, une minoration à 2.5 de Umur0
  * pour l'application du doublage
  * @param type_doublage {number}
- * @param di {Donnee_intermediaire}
- * @param de {Donnee_entree}
+ * @param di {MurDI}
+ * @param de {MurDE}
  * @param umur0_avant {number}
  * @param umur_avant {number}
  */