path: root/templates/stats.html

{% extends "base.html" %}

{% block title %}Stats · Lumière{% endblock %}

{% block content %}
  <section class="page-heading">
    <div class="page-heading-row">
      <div>
        <p class="eyebrow">Stats</p>
        <h1>Watching patterns</h1>
      </div>
      <a class="button-link" href="/stats/year-in-review">Year in review</a>
    </div>
  </section>

  <section class="stats-layout">
    <section class="stats-panel stats-panel-wide">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">World Map</p>
          <h2>Films per country</h2>
        </div>
      </div>
      <div id="world-map" class="stats-map" aria-label="World map of watched films"></div>
      <div id="map-readout" class="map-readout" aria-live="polite">
        <strong>Hover a country</strong>
        <span>Film count will appear here.</span>
      </div>
      <div id="map-tooltip" class="stats-tooltip" hidden></div>
    </section>

    <section class="stats-panel stats-panel-wide">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Heatmap</p>
          <h2>Past 365 days</h2>
        </div>
      </div>
      <div id="watch-heatmap" class="heatmap-shell" aria-label="Daily watch heatmap"></div>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Directors</p>
          <h2>Most watched</h2>
        </div>
      </div>
      <ol id="top-directors" class="stats-list"></ol>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Stars</p>
          <h2>Distribution</h2>
        </div>
      </div>
      <div id="star-distribution" class="stats-bars"></div>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Rewatch</p>
          <h2>Rate</h2>
        </div>
      </div>
      <div id="rewatch-rate" class="stats-metric"></div>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Films</p>
          <h2>Rewatches</h2>
        </div>
      </div>
      <div id="rewatch-patterns-list" class="stats-list"></div>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Companions</p>
          <h2>Watched with</h2>
        </div>
      </div>
      <ol id="watched-with" class="stats-list"></ol>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Genres</p>
          <h2>Most watched</h2>
        </div>
      </div>
      <ol id="top-genres" class="stats-list"></ol>
    </section>

    <section class="stats-panel">
      <div class="stats-panel-header">
        <div>
          <p class="eyebrow">Decades</p>
          <h2>By era</h2>
        </div>
      </div>
      <ol id="film-decades" class="stats-list"></ol>
    </section>
  </section>
{% endblock %}

{% block scripts %}
  <script src="https://cdnjs.cloudflare.com/ajax/libs/d3/7.8.5/d3.min.js"></script>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/topojson/3.0.2/topojson.min.js"></script>
  <script>
    const PANEL_COLOR = getComputedStyle(document.documentElement).getPropertyValue("--panel").trim();
    const PANEL_SOFT_COLOR = getComputedStyle(document.documentElement).getPropertyValue("--panel-soft").trim();
    const ACCENT_COLOR = getComputedStyle(document.documentElement).getPropertyValue("--accent").trim();

    function heatmapColor(count) {
      if (count <= 0) return PANEL_SOFT_COLOR;
      if (count === 1) return "rgba(240, 184, 77, 0.35)";
      if (count === 2) return "rgba(240, 184, 77, 0.65)";
      return ACCENT_COLOR;
    }

    function formatMonthLabel(dateString) {
      return new Date(`${dateString}T00:00:00`).toLocaleDateString(undefined, { month: "short" });
    }

    function formatCountryCode(value) {
      return String(value).padStart(3, "0");
    }

    function renderLists(data) {
      const topDirectors = document.getElementById("top-directors");
      topDirectors.innerHTML = data.most_watched_directors.slice(0, 8).map((item) => `
        <li><span>${item.director}</span><strong>${item.count}</strong></li>
      `).join("");

      const watchedWith = document.getElementById("watched-with");
      watchedWith.innerHTML = data.watched_with_breakdown
        .filter((item) => item.watched_with.toLowerCase() !== "solo")
        .slice(0, 8)
        .map((item) => `
        <li><span>${item.watched_with}</span><strong>${item.count}</strong></li>
      `).join("");

      const topGenres = document.getElementById("top-genres");
      topGenres.innerHTML = data.films_per_genre.slice(0, 8).map((item) => `
        <li><span>${item.genre}</span><strong>${item.count}</strong></li>
      `).join("");

      const filmDecades = document.getElementById("film-decades");
      filmDecades.innerHTML = data.films_per_decade.map((item) => `
        <li><span>${item.decade}</span><strong>${item.count}</strong></li>
      `).join("");

      const starDistribution = document.getElementById("star-distribution");
      const maxStars = Math.max(1, ...data.star_distribution.map((item) => item.count));
      starDistribution.innerHTML = data.star_distribution.map((item) => `
        <div class="stats-bar-row">
          <span>${item.stars} star</span>
          <div class="stats-bar-track"><div class="stats-bar-fill" style="width:${(item.count / maxStars) * 100}%"></div></div>
          <strong>${item.count}</strong>
        </div>
      `).join("");

      const rewatchRate = document.getElementById("rewatch-rate");
      const rate = data.rewatch_rate.total_watched ? Math.round(data.rewatch_rate.rate * 100) : 0;
      rewatchRate.innerHTML = `
        <strong>${rate}%</strong>
        <span>${data.rewatch_rate.rewatched} of ${data.rewatch_rate.total_watched} watched films were rewatches.</span>
      `;

      const rewatchPatterns = document.getElementById("rewatch-patterns-list");
      if (data.rewatch_patterns && data.rewatch_patterns.length > 0) {
        rewatchPatterns.innerHTML = data.rewatch_patterns.map((item) => {
          const stars = (n) => (n > 0 ? "✦".repeat(n) : "—");
          const ratingHistory = item.ratings.map(stars).join(" → ");
          const drift = item.rating_changed
            ? `<span style="color:var(--accent)">${ratingHistory}</span>`
            : `<span style="color:var(--muted)">${ratingHistory}</span>`;
          const gap = item.days_between != null
            ? `<span style="color:var(--subtle);font-size:13px">${item.days_between}d apart</span>`
            : "";
          return `<div class="stats-list-row">
            <span>${item.title}</span>
            <span style="display:flex;gap:12px;align-items:center">${gap}${drift}<strong>${item.watches}×</strong></span>
          </div>`;
        }).join("");
      } else {
        rewatchPatterns.innerHTML = "<p style=\"color:var(--muted);font-size:14px;margin:0\">No rewatches yet.</p>";
      }
    }

    function renderHeatmap(days) {
      const container = document.getElementById("watch-heatmap");
      const weekdays = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"];
      const parsedDays = days.map((item) => {
        const date = new Date(`${item.date}T00:00:00`);
        return { ...item, dateObj: date };
      });

      const firstWeekStart = new Date(parsedDays[0].dateObj);
      const mondayOffset = (firstWeekStart.getDay() + 6) % 7;
      firstWeekStart.setDate(firstWeekStart.getDate() - mondayOffset);

      const monthLabels = [];
      const seenMonths = new Set();
      const cells = parsedDays.map((item) => {
        const diffDays = Math.floor((item.dateObj - firstWeekStart) / 86400000);
        const week = Math.floor(diffDays / 7);
        const weekday = (item.dateObj.getDay() + 6) % 7;
        const monthKey = item.date.slice(0, 7);
        if (!seenMonths.has(monthKey)) {
          seenMonths.add(monthKey);
          monthLabels.push({ week, label: formatMonthLabel(item.date) });
        }
        return `
          <button
            class="heatmap-cell"
            style="grid-column:${week + 1};grid-row:${weekday + 1};background:${heatmapColor(item.count)}"
            title="${item.date}: ${item.count} film${item.count === 1 ? "" : "s"}"
            aria-label="${item.date}: ${item.count} film${item.count === 1 ? "" : "s"}"
            type="button"
          ></button>
        `;
      }).join("");

      container.innerHTML = `
        <div class="heatmap-months">
          ${monthLabels.map((item) => `<span style="grid-column:${item.week + 1}">${item.label}</span>`).join("")}
        </div>
        <div class="heatmap-body">
          <div class="heatmap-weekdays">
            ${weekdays.map((label) => `<span>${label}</span>`).join("")}
          </div>
          <div class="heatmap-grid">${cells}</div>
        </div>
      `;
    }

    async function renderMap(data) {
      const container = document.getElementById("world-map");
      const readout = document.getElementById("map-readout");
      const tooltip = document.getElementById("map-tooltip");
      const [worldResponse, namesResponse] = await Promise.all([
        fetch("https://cdn.jsdelivr.net/npm/world-atlas@2/countries-110m.json"),
        fetch("https://cdn.jsdelivr.net/gh/lukes/ISO-3166-Countries-with-Regional-Codes@master/all/all.json"),
      ]);
      const [world, countryRows] = await Promise.all([worldResponse.json(), namesResponse.json()]);
      const counts = new Map(data.films_per_country_codes.map((item) => [String(item.code), item.count]));
      const labels = data.country_labels_by_code || {};
      const names = countryRows.reduce((map, row) => {
        map.set(formatCountryCode(row["country-code"]), row.name);
        return map;
      }, new Map());
      const maxCount = Math.max(1, ...data.films_per_country_codes.map((item) => item.count));

      const width = container.clientWidth || 960;
      const height = Math.min(520, Math.max(320, Math.round(width * 0.55)));
      const projection = d3.geoNaturalEarth1().fitSize([width, height], topojson.feature(world, world.objects.countries));
      const path = d3.geoPath(projection);
      const color = d3.scaleLinear().domain([0, maxCount]).range([PANEL_COLOR, ACCENT_COLOR]);

      const svg = d3.create("svg")
        .attr("viewBox", `0 0 ${width} ${height}`)
        .attr("role", "img")
        .attr("aria-label", "World map shaded by films watched");
      let activeCountryPath = null;

      function updateReadout(name, count) {
        readout.innerHTML = `<strong>${name}</strong><span>${count} film${count === 1 ? "" : "s"}</span>`;
      }

      function resetMapHover() {
        if (activeCountryPath) {
          activeCountryPath.attr("stroke", "rgba(244, 239, 230, 0.18)").attr("stroke-width", 0.7);
          activeCountryPath = null;
        }
        readout.innerHTML = `<strong>Hover a country</strong><span>Film count will appear here.</span>`;
        tooltip.hidden = true;
      }

      svg.append("g")
        .selectAll("path")
        .data(topojson.feature(world, world.objects.countries).features)
        .join("path")
        .attr("d", path)
        .attr("fill", (feature) => color(counts.get(String(feature.id)) || 0))
        .attr("stroke", "rgba(244, 239, 230, 0.18)")
        .attr("stroke-width", 0.7)
        .style("cursor", "pointer")
        .on("pointerenter", function(event, feature) {
          const count = counts.get(String(feature.id)) || 0;
          const featureCode = formatCountryCode(feature.id);
          const name = names.get(featureCode) || labels[String(feature.id)] || `Country ${feature.id}`;
          if (activeCountryPath) {
            activeCountryPath.attr("stroke", "rgba(244, 239, 230, 0.18)").attr("stroke-width", 0.7);
          }
          activeCountryPath = d3.select(this);
          activeCountryPath.attr("stroke", ACCENT_COLOR).attr("stroke-width", 1.4);
          updateReadout(name, count);
          tooltip.hidden = false;
          tooltip.innerHTML = `<strong>${name}</strong><span>${count} film${count === 1 ? "" : "s"}</span>`;
          tooltip.style.left = `${event.pageX + 12}px`;
          tooltip.style.top = `${event.pageY + 12}px`;
        })
        .on("pointermove", function(event) {
          tooltip.style.left = `${event.pageX + 12}px`;
          tooltip.style.top = `${event.pageY + 12}px`;
        })
        .on("pointerleave", function() {
          resetMapHover();
        });

      container.innerHTML = "";
      container.appendChild(svg.node());
      svg.on("pointerleave", resetMapHover);
      container.addEventListener("mouseleave", resetMapHover);
    }

    async function bootStats() {
      const response = await fetch("/stats/data");
      const data = await response.json();
      renderLists(data);
      renderHeatmap(data.films_per_day_365);
      await renderMap(data);
    }

    bootStats();
  </script>
{% endblock %}