From 7b7409fb2314e777638cbb2bdde79f83789ad526 Mon Sep 17 00:00:00 2001
From: Patrick Brosset <patrick.brosset@microsoft.com>
Date: Fri, 19 Jul 2024 10:31:54 +0200
Subject: [PATCH] Timeline concept

---
 site/_includes/compat.njk   |   2 +-
 site/_includes/timeline.njk | 110 ++++++++++++++++++++++++++++++++++++
 site/assets/styles.css      |  64 +++++++++++++++++++++
 site/feature.njk            |   4 +-
 4 files changed, 178 insertions(+), 2 deletions(-)
 create mode 100644 site/_includes/timeline.njk

diff --git a/site/_includes/compat.njk b/site/_includes/compat.njk
index a796dec069..a77897896b 100644
--- a/site/_includes/compat.njk
+++ b/site/_includes/compat.njk
@@ -2,7 +2,7 @@
   {% for browser in browsers %}
     <li class="browser browser-{{ browser.id }}{% if feature.status.support[browser.id] %} supported{% endif %}">
       <span class="name">{{ browser.name }}</span>
-      {%set version = feature.status.support[browser.id] %}
+      {% set version = feature.status.support[browser.id] %}
       {% if version %}
         <span class="version">{{ version }}</span>
         <span class="date">Released on {{ browser.releases[version].release_date }}</span>
diff --git a/site/_includes/timeline.njk b/site/_includes/timeline.njk
new file mode 100644
index 0000000000..1aad721223
--- /dev/null
+++ b/site/_includes/timeline.njk
@@ -0,0 +1,110 @@
+<div class="feature-timeline" id="{{ feature.id }}-timeline">
+</div>
+<script type="module" defer>
+  const featureTimelineContainer = document.getElementById("{{ feature.id }}-timeline");
+
+  const featureData = [
+    {% if feature.status.baseline === "low" %}
+      {
+        "event": "low",
+        "date": new Date("{{ feature.status.baseline_low_date }}"),
+        "datestring": "{{ feature.status.baseline_low_date }}"
+      },
+    {% endif %}
+    {% if feature.status.baseline === "high" %}
+      {
+        "event": "high",
+        "date": new Date("{{ feature.status.baseline_high_date }}"),
+        "datestring": "{{ feature.status.baseline_high_date }}"
+      },
+    {% endif %}
+    {% for browser in browsers %}
+      {% set version = feature.status.support[browser.id] %}
+      {% if version %}
+        {
+          "event": "{{ browser.id }}",
+          "date": new Date("{{ browser.releases[version].release_date }}"),
+          "datestring": "{{ browser.releases[version].release_date }}"
+        },
+      {% endif %}
+    {% endfor %}
+  ];
+
+  function getFeatureTimeline(timelineStart, timelineEnd) {
+    let data = [...featureData];
+
+    data.push({
+      "event": "start",
+      "date": new Date(timelineStart),
+      "datestring": timelineStart
+    });
+
+    data.push({
+      "event": "end",
+      "date": new Date(timelineEnd),
+      "datestring": timelineEnd
+    });
+
+    // Add year start events between start and end.
+    const startYear = new Date(timelineStart).getFullYear() + 1;
+    const endYear = new Date(timelineEnd).getFullYear();
+
+    for (let year = startYear; year <= endYear; year++) {
+      data.push({
+        "event": "year",
+        "date": new Date(year, 0, 1),
+        "datestring": year
+      });
+    }
+
+    data = data.sort((a, b) => a.date - b.date);
+
+    // Calculate the total time span.
+    const oneDay = 1000 * 60 * 60 * 24;
+    const firstDate = data[0].date;
+    const lastDate = data[data.length - 1].date;
+    const totalDays = (lastDate - firstDate) / oneDay;
+
+    // Calculate the position of each event.
+    return data.map(event => {
+      const days = (event.date - firstDate) / oneDay;
+      event.position = days / totalDays * 100;
+      return event;
+    });
+  }
+
+  function renderTimeline(timelineStart, timelineEnd) {
+    getFeatureTimeline(timelineStart, timelineEnd).forEach(event => {
+      if (event.event === "start" || event.event === "end") {
+        return;
+      }
+
+      const div = document.createElement("div");
+
+      div.classList.add("event", event.event);
+      if (event.event !== "year") {
+        div.dataset.event = event.event;
+        div.dataset.date = new Date(event.date).toLocaleDateString("en-US", { month: "long", year: "numeric" });
+      } else {
+        div.dataset.date = event.datestring;
+      }
+
+      div.style.left = event.position + "%";
+
+      featureTimelineContainer.appendChild(div);
+    });
+  }
+
+  // Render the initial timeline with, by default, a time span of
+  // 6 months before the first impl, and 6 months after the last event.
+  const [start, ...rest] = featureData.sort((a, b) => a.date - b.date);
+  const end = rest.splice(-1)[0];
+
+  const startDate = new Date(start.date);
+  startDate.setMonth(startDate.getMonth() - 6);
+
+  const endDate = new Date(end.date);
+  endDate.setMonth(endDate.getMonth() + 6);
+  
+  renderTimeline(startDate.toISOString().split("T")[0], endDate.toISOString().split("T")[0]);
+</script>
diff --git a/site/assets/styles.css b/site/assets/styles.css
index 09eb64007f..48269cc7cf 100644
--- a/site/assets/styles.css
+++ b/site/assets/styles.css
@@ -371,3 +371,67 @@ footer {
   color: var(--sub-text);
   font-size: smaller;
 }
+
+.feature-timeline {
+  width: 100%;
+  height: 2px;
+  background: black;
+  position: relative;
+  margin: 7rem 0;
+}
+
+.feature-timeline .event {
+  position: absolute;
+  top: -1rem;
+  bottom: -1rem;
+  width: 2px;
+  background: black;
+}
+
+.feature-timeline .event::before {
+  content: attr(data-event);
+  position: absolute;
+  bottom: 0;
+  transform: rotate(90deg) translateY(.5rem);
+  transform-origin: bottom left;
+}
+
+.feature-timeline .event::after {
+  content: attr(data-date);
+  position: absolute;
+  width: 10rem;
+  top: 0;
+  transform: rotate(-90deg) translateY(-.75rem);
+  transform-origin: top left;
+}
+
+.feature-timeline .event.year {
+  background: transparent;
+}
+
+.feature-timeline .event.year::after {
+	transform: translate(-1.2rem, .25rem);
+	font-size: .8rem;
+	font-weight: bold;
+	background: white;
+	width: unset;
+	padding: .25rem;
+	border-radius: .25rem;
+	border: 1px solid black;
+	text-align: center;
+}
+
+.feature-timeline .event.low::before,
+.feature-timeline .event.high::before {
+  content: "";
+  width: 1.5rem;
+  height: 1.5rem;
+  background-image: url(./baseline-high.svg);
+  background-repeat: no-repeat;
+  transform: translate(-.75rem, 1.5rem);
+  background-position: center;
+}
+
+.feature-timeline .event.low::before {
+  background-image: url(./baseline-low.svg);
+}
diff --git a/site/feature.njk b/site/feature.njk
index d0c9a9ddaf..b35276f008 100644
--- a/site/feature.njk
+++ b/site/feature.njk
@@ -9,4 +9,6 @@ eleventyComputed:
   title: "{{ feature.name }}"
 ---
 
-{% include "feature_full.njk" %}
\ No newline at end of file
+{% include "feature_full.njk" %}
+
+{% include "timeline.njk" %}