@open3cl/engine 1.11.3 → 1.11.4

package/3.2.2_plancher_bas.spec.js

@@ -61,7 +61,7 @@ beforeEach(() => {
 
 /**
  * 3.2.2 Coefficient de transmission des planchers bas (Upb)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2
  */
 describe('calc_pb - plancher non isolé (methode 1)', () => {
   test('Upb égal à Upb0 (paroi nue) et adjacence non déperditive => upb_final = upb', () => {
@@ -216,8 +216,7 @@ describe('calc_pb - isolation inconnue / table forfaitaire (methodes 2 et 7)', (
     // La période d'isolation renseignée est utilisée comme période de la table
     expect(tv).toHaveBeenCalledWith(
       'upb',
-      expect.objectContaining({ enum_periode_construction_id: '6' }),
-      pb.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '6' })
     );
     // min(0,3 ; 2) = 0,3
     expect(pb.donnee_intermediaire.upb).toBe(0.3);
@@ -237,8 +236,7 @@ describe('calc_pb - isolation inconnue / table forfaitaire (methodes 2 et 7)', (
 
     expect(tv).toHaveBeenCalledWith(
       'upb',
-      expect.objectContaining({ enum_periode_construction_id: '5' }),
-      pb.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '5' })
     );
   });
 
@@ -278,8 +276,7 @@ describe('calc_pb - année de construction saisie (methode 8)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'upb',
-      expect.objectContaining({ enum_periode_construction_id: '6' }),
-      pb.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '6' })
     );
     warn.mockRestore();
   });
@@ -305,8 +302,7 @@ describe('calc_pb - année de construction saisie (methode 8)', () => {
       // getKeyByValue(periode_isolation, '1975-1977') = '2' (différent de pc_id) => avertissement
       expect(tv).toHaveBeenCalledWith(
         'upb',
-        expect.objectContaining({ enum_periode_construction_id: '2' }),
-        pb.donnee_entree
+        expect.objectContaining({ enum_periode_construction_id: '2' })
       );
       expect(warn).toHaveBeenCalled();
       warn.mockRestore();
@@ -346,8 +342,7 @@ describe('calc_pb - année de construction saisie (methode 8)', () => {
     // Le dernier appel forfaitaire utilise la période de construction d'origine ('1')
     expect(tv).toHaveBeenLastCalledWith(
       'upb',
-      expect.objectContaining({ enum_periode_construction_id: '1' }),
-      pb.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '1' })
     );
     warn.mockRestore();
     error.mockRestore();
@@ -368,8 +363,7 @@ describe('calc_pb - année de construction saisie (methode 8)', () => {
 
     expect(tv).toHaveBeenCalledWith(
       'upb',
-      expect.objectContaining({ enum_periode_construction_id: '5' }),
-      pb.donnee_entree
+      expect.objectContaining({ enum_periode_construction_id: '5' })
     );
     expect(warn).not.toHaveBeenCalled();
     warn.mockRestore();
@@ -498,11 +492,7 @@ describe('calc_pb - compatibilité bug for bug (forçage de la méthode de saisi
 
     expect(error).toHaveBeenCalledWith(expect.stringContaining('effet_joule'));
     // Le matcher forfaitaire final utilise l'effet Joule '1' issu du DPE
-    expect(tv).toHaveBeenLastCalledWith(
-      'upb',
-      expect.objectContaining({ effet_joule: '1' }),
-      pb.donnee_entree
-    );
+    expect(tv).toHaveBeenLastCalledWith('upb', expect.objectContaining({ effet_joule: '1' }));
     error.mockRestore();
   });
 
@@ -531,7 +521,7 @@ describe('calc_pb - compatibilité bug for bug (forçage de la méthode de saisi
 
 /**
  * Calcul de la déperdition Ue vers un plancher bas sur terre-plein / vide sanitaire / sous-sol.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (Ue)
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (Ue)
  */
 describe('calc_pb - calcul de Ue (tv_ue)', () => {
   /** Renvoie une ue interpolée selon la valeur de upb du matcher. */
@@ -658,7 +648,7 @@ describe('calc_pb - calcul de Ue (tv_ue)', () => {
 
   /**
    * Issue #46 : ue calculé plancher par plancher, 2S/P issu du seul plancher courant.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue : « Les données ne figurant
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.2 (tableau ue : « Les données ne figurant
    * pas dans le tableau peuvent être obtenues par interpolation et extrapolation »)
    */
   describe('calcul plancher par plancher (#46)', () => {

package/3.2.3_plancher_haut.js

@@ -7,7 +7,7 @@ function tv_uph0(di, de, du) {
   const matcher = {
     enum_type_plancher_haut_id: de.enum_type_plancher_haut_id
   };
-  const row = tv('uph0', matcher, de);
+  const row = tv('uph0', matcher);
   if (row) {
     di.uph0 = Number(row.uph0);
     de.tv_uph0_id = Number(row.tv_uph0_id);

package/3.2.3_plancher_haut.spec.js

@@ -52,7 +52,7 @@ beforeEach(() => {
 
 /**
  * 3.2.3 Coefficient de transmission des planchers hauts (Uph)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.2.3
  */
 describe('calc_ph - plancher non isolé', () => {
   test('Uph égal à Uph0 (paroi nue)', () => {
@@ -249,7 +249,7 @@ describe('calc_ph - isolation inconnue (table forfaitaire)', () => {
 
   /**
    * Détermination du type de toiture (matcher de la table `uph`) selon l'adjacence.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - page 21
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - page 21
    */
   test.each([
     ['locaux non chauffés non accessible', 'terrasse', 'terrasse'],

package/3.3.1.4_porte.js

@@ -6,7 +6,7 @@ function tv_uporte(di, de, du) {
   const matcher = {
     enum_type_porte_id: de.enum_type_porte_id
   };
-  const row = tv('uporte', matcher, de);
+  const row = tv('uporte', matcher);
   if (row) {
     di.uporte = Number(row.uporte);
     de.tv_uporte_id = Number(row.tv_uporte_id);

package/3.3.1.4_porte.spec.js

@@ -27,7 +27,7 @@ beforeEach(() => {
 
 /**
  * 3.3.1.4 Coefficient de transmission surfacique des portes (Uporte)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3.1.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3.1.4
  */
 describe('calc_porte - coefficient de transmission des portes', () => {
   test('valeur forfaitaire : Uporte lu dans la table via le type de porte', () => {
@@ -42,7 +42,7 @@ describe('calc_porte - coefficient de transmission des portes', () => {
 
     calc_porte(porte, 1);
 
-    expect(tv).toHaveBeenCalledWith('uporte', { enum_type_porte_id: '3' }, porte.donnee_entree);
+    expect(tv).toHaveBeenCalledWith('uporte', { enum_type_porte_id: '3' });
     expect(porte.donnee_intermediaire.uporte).toBe(2.4);
     expect(porte.donnee_entree.tv_uporte_id).toBe(15);
   });

package/3.3_baie_vitree.js

@@ -320,8 +320,8 @@ export default function calc_bv(bv, zc) {
       mlnh.reduce((acc, ml) => acc - calc_omb(ml) / 100, 1)
     );
   }
-  tv_masque_proche(di, de, du);
-  tv_masque_lointain_homogene(di, de, du);
+  tv_masque_proche(di, de);
+  tv_masque_lointain_homogene(di, de);
 
   delete di.deltar;
 

package/3.3_baie_vitree.spec.js

@@ -105,7 +105,7 @@ function baseBv(overrides = {}) {
 
 /**
  * 3.3 Coefficients de transmission thermique et facteur solaire des baies vitrées.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3
  */
 describe('calc_bv - parcours nominal (double vitrage avec fermeture)', () => {
   test('renseigne b, sw, ug, uw, ujn et u_menuiserie', () => {
@@ -301,7 +301,7 @@ describe('calc_bv - traitement de la fermeture', () => {
 
 /**
  * 3.3.2 / 6.2.1 Traitement des doubles fenêtres : sw et uw équivalents.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3.2
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.3.2
  */
 describe('calc_bv - double fenêtre', () => {
   /** Baie secondaire (deuxième fenêtre) mesurable pour sw / uw équivalents. */
@@ -394,7 +394,7 @@ describe('calc_bv - double fenêtre', () => {
 
 /**
  * 6.3 Masques proches et lointains.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
  */
 describe('calc_bv - masques lointains non homogènes (fe2)', () => {
   test('collection de masques : fe2 = 1 - somme des occultations', () => {

package/3.4_pont_thermique.js

@@ -1,3 +1,5 @@
+/** @import { BaieVitree } from './features/dpe/domain/models/baie-vitree.model.js' */
+/** @import { PontThermiqueDE, PontThermiqueDI } from './features/dpe/domain/models/pont-thermique.model.js' */
 import enums from './enums.js';
 import { isNil } from 'lodash-es';
 import { tv, requestInput, cleanReference, bug_for_bug_compat } from './utils.js';
@@ -36,7 +38,7 @@ function tv_k(pt_di, di, de, du, pc_id, logement) {
   const mur_list = enveloppe.mur_collection.mur || [];
   const pb_list = enveloppe.plancher_bas_collection.plancher_bas || [];
   const ph_list = enveloppe.plancher_haut_collection.plancher_haut || [];
-  /** @type {BaieVitreeItem[]} **/
+  /** @type {BaieVitree[]} **/
   const bv_list = enveloppe.baie_vitree_collection.baie_vitree || [];
   const porte_list = enveloppe.porte_collection.porte || [];
 
@@ -137,7 +139,7 @@ function tv_k(pt_di, di, de, du, pc_id, logement) {
        * Si on ne trouve pas de mur associé au pont thermique, on vérifie si on trouve une baie vitrée associée
        * au pont thermique et si cette dernière à une reference_paroi qui correspond à un mur existant.
        */
-      /** @type {BaieVitreeItem} **/
+      /** @type {BaieVitree} **/
       const bvPt = bv_list.find((bv) => bv.donnee_entree.reference === de.reference_1);
       if (bvPt && Number(bvPt.donnee_entree.reference_paroi) === murIndex) {
         console.error(
@@ -444,9 +446,9 @@ function tv_k(pt_di, di, de, du, pc_id, logement) {
  * Si la valeur k calculée est égale au à celle spécifiée, le facteur est déjà pris en compte
  *
  * @param type_liaison {string} type de liaison du pont thermique en cours d'étude
- * @param de {Donnee_entree} données d'entrée du pont thermique en cours d'étude
+ * @param de {PontThermiqueDE} données d'entrée du pont thermique en cours d'étude
  * @param k {string} valeur calculée pour k
- * @param pt_di {Donnee_intermediaire} données intermédiaires du pont thermique en cours d'étude
+ * @param pt_di {PontThermiqueDI} données intermédiaires du pont thermique en cours d'étude
  */
 function pourcentageValeurPontThermique(type_liaison, de, k, pt_di) {
   if (

package/3.4_pont_thermique.spec.js

@@ -81,7 +81,7 @@ afterEach(() => {
 
 /**
  * 3.4 Calcul des déperditions par les ponts thermiques
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 describe('calc_pont_thermique - méthode de saisie directe', () => {
   test('k justifié saisi (méthode 2) : k pris directement', () => {
@@ -132,7 +132,7 @@ describe('calc_pont_thermique - valeur forfaitaire (méthode 1)', () => {
 
   /**
    * Les ponts thermiques des murs de circulation avec k intermédiaire nul restent nuls.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4 (locaux de circulation)
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4 (locaux de circulation)
    */
   test('mur de circulation (adjacence 22) avec k intermédiaire nul : k = 0 sans accès table', () => {
     const mur = [
@@ -157,7 +157,7 @@ describe('calc_pont_thermique - valeur forfaitaire (méthode 1)', () => {
 
   /**
    * 3.4.5 Menuiserie / mur : les ponts thermiques avec les parois en structure bois sont négligés.
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.5
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.5
    */
   test('liaison menuiserie / mur sur structure bois : k = 0', () => {
     const mur = [
@@ -248,7 +248,7 @@ describe('defaultValue - valeur de repli sur description non reconnue', () => {
 
 /**
  * 3.4 Reconstruction des références manquantes à partir de la description.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 describe('calc_pont_thermique - reconstruction des références via la description', () => {
   test('description "mur / plancher" : la référence du mur est retrouvée (liaison refend, pas de 2e paroi)', () => {
@@ -439,7 +439,7 @@ describe('calc_pont_thermique - mur de circulation avec k non nul', () => {
 
 /**
  * 3.4.1 / 3.4.3 Ponts thermiques plancher bas / mur et plancher haut lourd / mur.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.1 et §3.4.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.1 et §3.4.3
  */
 describe('calc_pont_thermique - liaisons plancher / mur', () => {
   function murPlancher(murOverrides = {}, plancherOverrides = {}) {
@@ -633,7 +633,7 @@ describe('calc_pont_thermique - liaisons plancher / mur', () => {
 
 /**
  * 3.4.5 Menuiserie / mur.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.5
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4.5
  */
 describe('calc_pont_thermique - liaison menuiserie / mur', () => {
   function murMenuiserie(murOverrides = {}, menuiserieOverrides = {}) {
@@ -920,7 +920,7 @@ describe('calc_pont_thermique - cas limites', () => {
 /**
  * Issue #212 : l'exclusion des parois non déperditives s'applique aussi au plancher des liaisons
  * plancher bas / mur et plancher haut lourd / mur, pas seulement au mur.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 describe('calc_pont_thermique - plancher sur paroi non déperditive (issue #212)', () => {
   /** Mur extérieur lourd isolé ITI + plancher lourd isolé ITE avec l'adjacence donnée. */

package/3_deperdition.js

@@ -1,3 +1,4 @@
+/** @import { FullDpe } from './features/dpe/domain/models/dpe.model.js' */
 import enums from './enums.js';
 import calc_mur from './3.2.1_mur.js';
 import calc_pb from './3.2.2_plancher_bas.js';

package/3_deperdition.spec.js

@@ -52,7 +52,7 @@ afterEach(() => {
 
 /**
  * 3. Déperditions de l'enveloppe : déperditions surfaciques par paroi.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3
  */
 describe('déperditions surfaciques par paroi (U * surface * b)', () => {
   test('Umur = surface_paroi_opaque * umur * b', () => {
@@ -106,7 +106,7 @@ describe('déperditions surfaciques par paroi (U * surface * b)', () => {
 
 /**
  * 3.4 Déperdition d'un pont thermique : Upt = l * k * pourcentage.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 describe('Upt - déperdition linéique des ponts thermiques', () => {
   test("Upt = l * k lorsque le pourcentage n'est pas renseigné (défaut 1)", () => {
@@ -361,7 +361,7 @@ describe("calc_deperdition - agrégation des déperditions de l'enveloppe", () =
 
 /**
  * 3.4 Comparaison des déperditions calculées et déclarées.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §3.4
  */
 describe('totalDeperditionMurs - arbitrage entre valeur calculée et déclarée', () => {
   /** Un mur unique : Umur = 10 * 0,5 * 1 = 5. */

package/4_ventilation.js

@@ -134,7 +134,7 @@ function tv_q4pa_conv(di, de, cg, mur_list, ph_list, porte_list, bv_list) {
        * le recalcul les donne non isolées. Dans le sens inverse (ligne « non isolées », recalcul
        * « isolées »), le DPE a pu être modifié par l'appelant (scénario d'isolation des parois) :
        * la valeur recalculée est utilisée.
-       * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
+       * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
        */
       if (rowQ4paConv.isolation_surfaces !== isolation_surfaces) {
         if (
@@ -160,7 +160,7 @@ function tv_q4pa_conv(di, de, cg, mur_list, ph_list, porte_list, bv_list) {
        * la ligne q4pa_conv retenue par le logiciel (ex. ligne 12 « avant 1948 avec joints », 2,5) :
        * on reprend sa valeur `presence_joints_menuiserie` au lieu de considérer les menuiseries
        * sans joint. Uniquement avec l'option `compat_for_corpus_analysis`.
-       * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
+       * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
        */
       if (
         compat_for_corpus_analysis &&

package/4_ventilation.spec.js

@@ -51,7 +51,7 @@ beforeEach(() => {
 
 /**
  * Déperdition par renouvellement d'air dû aux infiltrations (Hperm)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §4
  */
 describe('calc_hperm - déperdition par perméabilité', () => {
   test('plusieurs façades exposées (pfe=1) : e=0,07 et f=15', () => {

package/5_conso_ventilation.spec.js

@@ -17,7 +17,7 @@ const {
 
 /**
  * 5. Consommation des auxiliaires de ventilation
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §5, pages 41-42
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §5, pages 41-42
  */
 describe('calc_pvent - consommation des auxiliaires de ventilation', () => {
   let di;

package/6.1_apport_gratuit.spec.js

@@ -3,7 +3,7 @@ import { describe, expect, test } from 'vitest';
 
 describe("Recherche de bugs dans le calcul de l'apport gratuit", () => {
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 43
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 43
    */
   test('calcul de f apport solaire', () => {
     const ilpa = '0';
@@ -165,7 +165,7 @@ describe("Recherche de bugs dans le calcul de l'apport gratuit", () => {
   });
 
   /**
-   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf Page 43
+   * @see Methode_de_calcul_3CL_DPE_2021-338.pdf Page 43
    */
   test('calcul de f apport interne', () => {
     const ilpa = '0';

package/6.2_surface_sud_equivalente.js

@@ -1,3 +1,6 @@
+/** @import { BaieVitree, BaieVitreeDE, BaieVitreeDI } from './features/dpe/domain/models/baie-vitree.model.js' */
+/** @import { BaieEtsDE } from './features/dpe/domain/models/baie-ets.model.js' */
+/** @import { Ets } from './features/dpe/domain/models/ets.model.js' */
 import enums from './enums.js';
 import tvs from './tv.js';
 import { mois_liste } from './utils.js';
@@ -41,8 +44,8 @@ export function calc_sse_j(bv_list, ets, ca, zc, mois) {
  * Certaines vérandas sont dupliquées dans les DPE : une même véranda (même référence, ou à défaut
  * même contenu) ne doit être comptée qu'une seule fois.
  *
- * @param etsList {EtsItem[]}
- * @returns {EtsItem[]}
+ * @param etsList {Ets[]}
+ * @returns {Ets[]}
  */
 export function dedoublonnerEts(etsList) {
   const vues = new Set();
@@ -64,9 +67,9 @@ export function dedoublonnerEts(etsList) {
  * rattachée à la première véranda : c'est le comportement historique, et le seul possible quand le
  * DPE ne comporte qu'une véranda. La méthode ne permet pas de faire mieux pour une donnée manquante.
  *
- * @param baiesAdjVeranda {BaieVitreeItem[]}
- * @param etsList {EtsItem[]}
- * @returns {BaieVitreeItem[][]} baies par véranda, dans l'ordre de etsList
+ * @param baiesAdjVeranda {BaieVitree[]}
+ * @param etsList {Ets[]}
+ * @returns {BaieVitree[][]} baies par véranda, dans l'ordre de etsList
  */
 export function rattacherBaiesAuxEts(baiesAdjVeranda, etsList) {
   const baiesParEts = etsList.map(() => []);
@@ -87,8 +90,8 @@ export function rattacherBaiesAuxEts(baiesAdjVeranda, etsList) {
 /**
  * Surface sud équivalente apportée par une véranda sur le mois j (§6.3).
  *
- * @param ets {EtsItem}
- * @param baiesAdjVeranda {BaieVitreeItem[]} baies séparant le logement de cette véranda
+ * @param ets {Ets}
+ * @param baiesAdjVeranda {BaieVitree[]} baies séparant le logement de cette véranda
  * @param zc {string}
  * @param mois {string}
  * @returns {number}
@@ -157,7 +160,7 @@ function calc_sse_veranda_j(ets, baiesAdjVeranda, zc, mois) {
 /**
  * Calcul de la surface sur équivalente pour la baie vitrée bv pendant le mois $mois
  *
- * @param bv {BaieVitreeItem}
+ * @param bv {{donnee_entree: BaieVitreeDE | BaieEtsDE, donnee_intermediaire?: BaieVitreeDI}} baie vitrée ou baie d'espace tampon solarisé
  * @param zc {string} zone climatique du logement
  * @param mois {string} mois au cours duquel calculer la surface sur équivalente de la baie vitrée
  * @param coeff {number} coefficient à appliquer à cette surface sud
@@ -167,7 +170,7 @@ function getSsd(bv, zc, mois, coeff) {
   const c1 = tvs.c1;
 
   const de = bv.donnee_entree;
-  const di = bv.donnee_intermediaire || {};
+  const di = /** @type {BaieVitreeDI} */ (bv.donnee_intermediaire || {});
 
   const orientation = enums.orientation[de.enum_orientation_id];
   const inclinaison = enums.inclinaison_vitrage[de.enum_inclinaison_vitrage_id ?? 3];

package/6.2_surface_sud_equivalente.spec.js

@@ -51,7 +51,7 @@ function baie({ adjacence, surface, orientationId = '1', inclinaisonId = '3', sw
 
 /**
  * 6.2 Calcul de la surface sud équivalente (SSE)
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.2 / §6.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.2 / §6.3
  */
 describe('calc_sse_j - surface sud équivalente journalière', () => {
   test("sans espace tampon : somme sur les baies donnant sur l'extérieur", () => {
@@ -143,7 +143,7 @@ describe('calc_sse_j - surface sud équivalente journalière', () => {
  * Issue #140 : la surface sud équivalente véranda (Sse_ver = Ssd + Ssind * bver) n'est calculée que
  * pour les baies vitrées séparant le logement de l'espace tampon solarisé (adjacence 10).
  * Sans aucune de ces baies, les apports de l'ETS n'entrent pas dans le logement => Sse_ver = 0.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
  */
 describe('calc_sse_j - espace tampon solarisé sans baie séparant le logement de l’ETS', () => {
   /** Fabrique un espace tampon solarisé avec une baie donnant sur l'extérieur. */
@@ -225,7 +225,7 @@ describe('calc_sse - surface sud équivalente annuelle', () => {
  * sur laquelle elle donne (reference_lnc = ets.reference).
  * Cas de test fournis par Olivier (thermicien), zone h1b mockée avec C1 sud = 1, est = 0,40,
  * nord = 0,31 ; Fe = 1.
- * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
+ * @see Methode_de_calcul_3CL_DPE_2021-338.pdf - §6.3
  */
 describe('calc_sse_j - plusieurs espaces tampons solarisés (issue #101)', () => {
   const SUD = '1';

package/7_inertie.js

@@ -1,3 +1,6 @@
+/** @import { Enveloppe } from './features/dpe/domain/models/dpe.model.js' */
+/** @import { Mur, MurDE } from './features/dpe/domain/models/mur.model.js' */
+/** @import { PlancherBas, PlancherBasDE, PlancherHaut, PlancherHautDE } from './features/dpe/domain/models/plancher.model.js' */
 import enums from './enums.js';
 import { getThicknessFromDescription, getKeyByValue } from './utils.js';
 
@@ -11,7 +14,7 @@ export class Inertie {
 
   /**
    * Return 1 if the plancher_haut has high inertia, 0 otherwise
-   * @param de {Donnee_entree}
+   * @param de {PlancherHautDE}
    * @returns {number}
    */
   calculateInertiePhLourd(de) {
@@ -37,7 +40,7 @@ export class Inertie {
 
   /**
    * Return 1 if the plancher_bas has high inertia, 0 otherwise
-   * @param de {Donnee_entree}
+   * @param de {PlancherBasDE}
    * @returns {number}
    */
   calculateInertiePbLourd(de) {
@@ -68,7 +71,7 @@ export class Inertie {
 
   /**
    * Return 1 if the mur has high inertia, 0 otherwise
-   * @param de {Donnee_entree}
+   * @param de {MurDE}
    * @returns {number}
    */
   calculateInertieMurLourd(de) {
@@ -163,7 +166,7 @@ export class Inertie {
 
   /**
    * Return 1 if the collection has high inertia (majority high inertia surface), 0 otherwise
-   * @param collection {PlancherBasItem[] || PlancherHautItem[] || MurItem[]}
+   * @param collection {PlancherBas[] | PlancherHaut[] | Mur[]}
    * @param method - method to apply on each item to get inertia type
    * @returns {number}
    */

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