feat(registry): week in merges leaderboard block (#4264)

* feat(registry): add a week-in-merges leaderboard block

Authors race across the row at a speed set by their merge count, bouncing at both edges.

* chore(registry): cover week-in-merges in the catalog search index

* style(registry): format the week-in-merges block

Wrap the lines oxfmt rejects so the format check passes.

* fix(registry): regenerate the week-in-merges catalog payload

The format pass left the committed payload off the generator output.

* feat(registry): cap week-in-merges at twelve rows

The block races at most rows_max authors, highest merge count first, and writes one line for everyone left out. The default is 12, so a long list cannot shrink the rows.

* fix(registry): make week-in-merges speed follow merge count

A row now travels the leader's pace times its merges over the leader's count. Only a zero stays on the floor, so a near-tie no longer looks like last place.

Author: miguel-heygen

docs/catalog/blocks/week-in-merges.mdx

@@ -510,12 +510,12 @@
               },
               {
                 "group": "Data & charts",
-                "tag": "17",
+                "tag": "18",
                 "expanded": false,
                 "pages": [
                   {
                     "group": "Data",
-                    "tag": "17",
+                    "tag": "18",
                     "expanded": false,
                     "pages": [
                       "catalog/components/animated-bar-chart",
@@ -534,6 +534,7 @@
                       "catalog/blocks/us-map-bubble",
                       "catalog/blocks/us-map-flow",
                       "catalog/blocks/us-map-hex",
+                      "catalog/blocks/week-in-merges",
                       "catalog/blocks/world-map"
                     ]
                   }

docs/docs.json

@@ -5699,6 +5699,20 @@
     "href": "/catalog/blocks/vpn-youtube-spot",
     "preview": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/vpn-youtube-spot.png"
   },
+  {
+    "name": "week-in-merges",
+    "type": "block",
+    "title": "Week in Merges",
+    "description": "Each author's avatar bounces across their row at a speed set by how many pull requests they merged",
+    "tags": [
+      "data",
+      "chart",
+      "ranking",
+      "leaderboard"
+    ],
+    "href": "/catalog/blocks/week-in-merges",
+    "preview": "https://static.heygen.ai/hyperframes-oss/docs/images/catalog/blocks/week-in-merges.png"
+  },
   {
     "name": "weight-wave",
     "type": "block",

docs/public/catalog-index.json

@@ -0,0 +1,102 @@
+/**
+ * The block says speed is proportional to merges. Bind a near-tie and a
+ * one-merge row, seek one second (before anyone can bounce), and check the
+ * distances.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { runInNewContext } from "node:vm";
+import { parseHTML } from "linkedom";
+import { describe, expect, it } from "vitest";
+
+const htmlPath = join(
+  import.meta.dirname,
+  "../../../../registry/blocks/week-in-merges/week-in-merges.html",
+);
+
+function distances(
+  rows: Array<{ name: string; merges: number }>,
+  extra: Record<string, unknown> = {},
+): Map<number, number> {
+  const { document, window } = parseHTML(readFileSync(htmlPath, "utf8"));
+  const proto = Object.getPrototypeOf(document.createElement("div"));
+  Object.defineProperty(proto, "clientWidth", {
+    configurable: true,
+    get(this: { id?: string }) {
+      return String(this.id || "").startsWith("wim-lane") ? 800 : 1080;
+    },
+  });
+  Object.defineProperty(proto, "clientHeight", {
+    configurable: true,
+    get(this: { id?: string }) {
+      return String(this.id || "").startsWith("wim-row") ? 80 : 40;
+    },
+  });
+
+  let driver: { t: number } | undefined;
+  const gsap = {
+    timeline() {
+      return {
+        paused: true,
+        to(target: { t: number }) {
+          driver = target;
+          return this;
+        },
+      };
+    },
+  };
+  const variables = {
+    rows: JSON.stringify(rows.map((row) => ({ ...row, avatar: "" }))),
+    ...extra,
+  };
+  const sandbox = { document, window, console, gsap };
+  (window as unknown as { __hfVariables: typeof variables }).__hfVariables = variables;
+  const source = [...document.querySelectorAll("script")]
+    .map((node) => node.textContent || "")
+    .find((text) => text.includes("function speedFor"));
+  if (!source) throw new Error("speedFor script missing");
+  runInNewContext(source, sandbox);
+  if (!driver) throw new Error("timeline driver missing");
+  driver.t = 1;
+
+  const out = new Map<number, number>();
+  for (const row of document.querySelectorAll(".wim-row")) {
+    const merges = Number.parseInt(row.querySelector(".wim-count")?.textContent || "", 10);
+    const transform =
+      (row.querySelector(".wim-avatar") as HTMLElement | null)?.style.transform || "";
+    const match = /translateX\(([-\d.]+)px\)/.exec(transform);
+    out.set(merges, match ? Number(match[1]) : Number.NaN);
+  }
+  return out;
+}
+
+describe("week-in-merges speed", () => {
+  it("binds 30, 29, and 1 so distance stays within 5% of the merge ratio", () => {
+    const rows = [
+      { name: "Ada", merges: 30 },
+      { name: "Bao", merges: 29 },
+      { name: "Cam", merges: 1 },
+    ];
+    const traveled = distances(rows);
+    const pairs: Array<[number, number]> = [
+      [29, 30],
+      [1, 30],
+      [1, 29],
+    ];
+    for (const [left, right] of pairs) {
+      const got = traveled.get(left)! / traveled.get(right)!;
+      const want = left / right;
+      expect(
+        Math.abs(got - want) / want,
+        `${left}/${right} traveled ${got}, wanted ${want}`,
+      ).toBeLessThanOrEqual(0.05);
+    }
+
+    // The same counts with the quiet row past the cap. A visible-range rescale
+    // then pins 29 to the floor; proportionality keeps 29/30.
+    const capped = distances(rows, { rows_max: 2 });
+    expect(capped.has(1)).toBe(false);
+    const cappedRatio = capped.get(29)! / capped.get(30)!;
+    expect(Math.abs(cappedRatio - 29 / 30) / (29 / 30)).toBeLessThanOrEqual(0.05);
+  });
+});

docs/public/catalog/blocks/week-in-merges.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "https://hyperframes.heygen.com/schema/registry-item.json",
+  "name": "week-in-merges",
+  "type": "hyperframes:block",
+  "title": "Week in Merges",
+  "description": "Each author's avatar bounces across their row at a speed set by how many pull requests they merged",
+  "tags": ["data", "chart", "ranking", "leaderboard"],
+  "dimensions": {
+    "width": 1080,
+    "height": 1350
+  },
+  "duration": 16,
+  "variables": [
+    {
+      "id": "eyebrow",
+      "type": "string",
+      "label": "Eyebrow",
+      "default": "ACME / WEEK IN MERGES"
+    },
+    {
+      "id": "title",
+      "type": "string",
+      "label": "Title",
+      "default": "Pull requests merged this week"
+    },
+    {
+      "id": "period",
+      "type": "string",
+      "label": "Period",
+      "default": "1 September - 7 September 2026 · America/Los_Angeles"
+    },
+    {
+      "id": "total",
+      "type": "string",
+      "label": "Total",
+      "default": "12 PRs"
+    },
+    {
+      "id": "footer",
+      "type": "string",
+      "label": "Footer",
+      "default": "Speed proportional to merges · By PR author"
+    },
+    {
+      "id": "source",
+      "type": "string",
+      "label": "Source line",
+      "default": "Example org · 1 repo · Bots · 0"
+    },
+    {
+      "id": "rows",
+      "type": "string",
+      "label": "Rows (JSON array of name, merges, avatar)",
+      "default": "[{\"name\":\"Ada\",\"merges\":12,\"avatar\":\"\"},{\"name\":\"Bao\",\"merges\":7,\"avatar\":\"\"},{\"name\":\"Cam\",\"merges\":4,\"avatar\":\"\"},{\"name\":\"Dee\",\"merges\":2,\"avatar\":\"\"},{\"name\":\"Eli\",\"merges\":1,\"avatar\":\"\"}]"
+    },
+    {
+      "id": "rows_max",
+      "type": "number",
+      "label": "Maximum rows",
+      "default": 12,
+      "min": 1,
+      "max": 12,
+      "step": 1,
+      "description": "Authors drawn, highest merge count first."
+    },
+    {
+      "id": "overflow",
+      "type": "string",
+      "label": "Overflow line",
+      "default": "",
+      "description": "Line for everyone past the cap. Empty writes it from the rows left out."
+    }
+  ],
+  "files": [
+    {
+      "path": "week-in-merges.html",
+      "target": "compositions/week-in-merges.html",
+      "type": "hyperframes:composition"
+    }
+  ],
+  "params": [
+    {
+      "key": "eyebrow",
+      "label": "Eyebrow",
+      "type": "text",
+      "default": "ACME / WEEK IN MERGES"
+    },
+    {
+      "key": "title",
+      "label": "Title",
+      "type": "text",
+      "default": "Pull requests merged this week"
+    },
+    {
+      "key": "period",
+      "label": "Period",
+      "type": "text",
+      "default": "1 September - 7 September 2026 · America/Los_Angeles"
+    },
+    {
+      "key": "total",
+      "label": "Total",
+      "type": "text",
+      "default": "12 PRs"
+    },
+    {
+      "key": "footer",
+      "label": "Footer",
+      "type": "text",
+      "default": "Speed proportional to merges · By PR author"
+    },
+    {
+      "key": "source",
+      "label": "Source line",
+      "type": "text",
+      "default": "Example org · 1 repo · Bots · 0"
+    },
+    {
+      "key": "rows",
+      "label": "Rows (JSON array of name, merges, avatar)",
+      "type": "text",
+      "default": "[{\"name\":\"Ada\",\"merges\":12,\"avatar\":\"\"},{\"name\":\"Bao\",\"merges\":7,\"avatar\":\"\"},{\"name\":\"Cam\",\"merges\":4,\"avatar\":\"\"},{\"name\":\"Dee\",\"merges\":2,\"avatar\":\"\"},{\"name\":\"Eli\",\"merges\":1,\"avatar\":\"\"}]"
+    },
+    {
+      "key": "rows_max",
+      "label": "Maximum rows",
+      "type": "number",
+      "default": "12",
+      "min": 1,
+      "max": 12,
+      "step": 1
+    },
+    {
+      "key": "overflow",
+      "label": "Overflow line",
+      "type": "text",
+      "default": ""
+    }
+  ]
+}