Adjusting comments into files.

src/js/utils.js

@@ -1,5 +1,5 @@
 
-// Echapper les donnees issues de l'EPG pour eviter les injections HTML
+// Escape EPG-provided strings before injecting them into HTML.
 function esc(str) {
   const d = document.createElement('div');
   d.textContent = str || '';
@@ -8,8 +8,8 @@ function esc(str) {
 
 let channels = [];
 let programs = {};
-let m3uStreams = {}; // slug normalisé → url stream
-let scrollListenerAdded = false; // sync scroll vertical chaînes
+let m3uStreams = {}; // Normalized slug -> stream URL.
+let scrollListenerAdded = false; // Keeps the channel column vertically synced with the timeline.
 
 function pad(n) { return String(n).padStart(2,'0'); }
 
@@ -35,6 +35,8 @@ function parseXMLTVDate(str) {
   if (!str) return null;
   const m = str.match(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})\s*([+-]\d{4})?/);
   if (!m) return null;
+  // XMLTV timestamps use a compact timezone suffix like +0200, so we rebuild
+  // the UTC instant manually before letting Date convert it to local time.
   const offset = m[7] ? parseInt(m[7]) : 0;
   const offsetMs = (Math.floor(Math.abs(offset)/100)*60 + (Math.abs(offset)%100)) * 60000 * (offset<0?-1:1);
   return new Date(Date.UTC(+m[1],+m[2]-1,+m[3],+m[4],+m[5],+m[6]) - offsetMs);
@@ -78,7 +80,7 @@ function loadFromInput() {
 }
 
 function parseEpisode(p) {
-  // Format xmltv_ns : "S.E.part" (0-indexed) ex: "0.2.0/1" = S01E03
+  // xmltv_ns format: "S.E.part" (0-indexed), e.g. "0.2.0/1" -> S01E03
   const ns = p.querySelector('episode-num[system="xmltv_ns"]')?.textContent;
   if (ns) {
     const parts = ns.split('.');
@@ -87,7 +89,7 @@ function parseEpisode(p) {
     const e = ePart !== '' ? parseInt(ePart) + 1 : null;
     if (s !== null || e !== null) return { season: s, episode: e };
   }
-  // Format onscreen : "S01E03" ou "s1e3"
+  // onscreen format: "S01E03" or "s1e3"
   const os = p.querySelector('episode-num[system="onscreen"]')?.textContent;
   if (os) {
     const m = os.match(/[Ss](\d+)[Ee](\d+)/);
@@ -136,4 +138,3 @@ function renderAll() {
   if (isMobile()) { renderMobile(); }
   else { renderGrid(); setTimeout(centerNow, 150); }
 }
-