@open3cl/engine 1.11.3 → 1.11.4

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}
  */

package/3.2.1_mur.spec.js

@@ -106,7 +106,7 @@ beforeEach(() => {
 
 /**
  * 3.2.1 Coefficient de transmission des murs (Umur)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.1
  */
 describe('calc_mur - mur non isolé', () => {
   test('type de paroi inconnu : Umur0 = 2,5 et Umur = min(Umur0 ; 2,5)', () => {
@@ -710,8 +710,7 @@ describe('calc_mur - table forfaitaire (Umur)', () => {
         enum_periode_construction_id: '1',
         enum_zone_climatique_id: 'h1a',
         effet_joule: '0'
-      }),
-      mur.donnee_entree
+      })
     );
     // min(0,5 ; 2,5) = 0,5
     expect(mur.donnee_intermediaire.umur).toBe(0.5);
@@ -732,8 +731,7 @@ describe('calc_mur - table forfaitaire (Umur)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'umur',
-      expect.objectContaining({ enum_periode_construction_id: '6' }),
-      mur.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '6' })
     );
   });
 
@@ -751,8 +749,7 @@ describe('calc_mur - table forfaitaire (Umur)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'umur',
-      expect.objectContaining({ enum_periode_construction_id: '5' }),
-      mur.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '5' })
     );
   });
 
@@ -790,8 +787,7 @@ describe('calc_mur - année de construction saisie (table forfaitaire)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'umur',
-      expect.objectContaining({ enum_periode_construction_id: '6' }),
-      mur.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '6' })
     );
     warn.mockRestore();
   });
@@ -827,8 +823,7 @@ describe('calc_mur - année de construction saisie (table forfaitaire)', () => {
       // parseInt(getKeyByValue(periode_isolation, '1975-1977'), 10) = 2 (nombre)
       expect(tv).toHaveBeenCalledWith(
         'umur',
-        expect.objectContaining({ enum_periode_construction_id: 2 }),
-        mur.donnee_entree
+        expect.objectContaining({ enum_periode_construction_id: 2 })
       );
       expect(warn).toHaveBeenCalled();
       warn.mockRestore();
@@ -867,8 +862,7 @@ describe('calc_mur - année de construction saisie (table forfaitaire)', () => {
     // Le dernier appel forfaitaire réutilise la période de construction d'origine ('1')
     expect(tv).toHaveBeenLastCalledWith(
       'umur',
-      expect.objectContaining({ enum_periode_construction_id: '1' }),
-      mur.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '1' })
     );
     warn.mockRestore();
   });
@@ -887,8 +881,7 @@ describe('calc_mur - année de construction saisie (table forfaitaire)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'umur',
-      expect.objectContaining({ enum_periode_construction_id: '5' }),
-      mur.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '5' })
     );
     expect(warn).not.toHaveBeenCalled();
     warn.mockRestore();
@@ -930,8 +923,7 @@ describe('calc_mur - bug_for_bug sur tv_umur (récupération depuis tv_umur_id)'
     // Le matcher final utilise l'effet Joule ('1') et la période ('5') issus du DPE
     expect(tv).toHaveBeenLastCalledWith(
       'umur',
-      expect.objectContaining({ effet_joule: '1', enum_periode_construction_id: '5' }),
-      mur.donnee_entree
+      expect.objectContaining({ effet_joule: '1', enum_periode_construction_id: '5' })
     );
     error.mockRestore();
   });
@@ -1077,7 +1069,7 @@ describe('calc_mur - doublage et isolation ITE/ITI (#146)', () => {
  * 3.2.1.2 Calcul des Umur0 : l'épaisseur saisie est ramenée sur une colonne de la table du
  * matériau déclaré, sans jamais basculer vers un autre matériau (issue #138).
  * Convention (la méthode ne précise pas l'arrondi) : colonne la plus proche, égalité => inférieure.
- * @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
  */
 describe('epaisseurStructureTable - épaisseur hors table (issue #138)', () => {
   test.each([
@@ -1138,7 +1130,7 @@ describe('epaisseurStructureTable - épaisseur hors table (issue #138)', () => {
 
 /**
  * Correctifs de compatibilité (bug_for_bug) sur les murs.
- * @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
  */
 describe('issue #295 - enduit isolant sur paroi ancienne (MUR1)', () => {

package/3.2.2_plancher_bas.js

@@ -9,7 +9,7 @@ function tv_upb0(di, de, du) {
   const matcher = {
     enum_type_plancher_bas_id: de.enum_type_plancher_bas_id
   };
-  const row = tv('upb0', matcher, de);
+  const row = tv('upb0', matcher);
   if (row) {
     di.upb0 = Number(row.upb0);
     de.tv_upb0_id = Number(row.tv_upb0_id);
@@ -44,7 +44,7 @@ function tv_upb(di, de, du, pc_id, zc, effetJoule) {
     enum_zone_climatique_id: zc,
     effet_joule: effetJoule
   };
-  const row = tv('upb', matcher, de);
+  const row = tv('upb', matcher);
   if (row) {
     di.upb = Number(row.upb);
     de.tv_upb_id = Number(row.tv_upb_id);
@@ -61,7 +61,7 @@ const values_2s_p = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 16, 18, 20];
  * (perimetre_ue) du seul plancher courant, sans sommer les autres planchers de même adjacence.
  * Les valeurs absentes du tableau sont obtenues par interpolation linéaire sur upb.
  *
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue)
  */
 function tv_ue(di, de, du, pc_id) {
   const type_adjacence = enums.type_adjacence[de.enum_type_adjacence_id];
@@ -84,6 +84,7 @@ function tv_ue(di, de, du, pc_id) {
   const surfaceUe = de.surface_ue || de.surface_paroi_opaque;
   const perimetreUe = de.perimetre_ue || 0;
 
+  /** @type {Record<string, any>} `2s_p` est d'abord numérique puis devient une regex (chaîne) */
   const matcher = {
     type_adjacence_plancher,
     '2s_p': Math.round((2 * surfaceUe) / perimetreUe)