= { 'Name as declared': 'Declared as' };
+
+// "Hash matched" is the hash the setup's list writes, whatever was pasted:
+// Batocera declares an MD5, so its row says MD5 when a CRC32 found it.
+const declaredHash = (item: Item) => (item.declared || item.algorithm).toUpperCase();
+
const setupTable = (rows: { item: Item; entry?: Declared; setup: string }[]) => {
const table = document.createElement('table');
const head = table.createTHead().insertRow();
@@ -388,6 +444,7 @@ const setupTable = (rows: { item: Item; entry?: Declared; setup: string }[]) =>
const cell = document.createElement('th');
cell.scope = 'col';
cell.textContent = label;
+ if (STACKED_LABELS[label]) cell.title = STACKED_LABELS[label];
head.append(cell);
}
const body = table.createTBody();
@@ -399,12 +456,12 @@ const setupTable = (rows: { item: Item; entry?: Declared; setup: string }[]) =>
link(item.url, setup),
anyName(name) ? 'Any name' : code(name),
destination ? code(destination) : '-',
- item.algorithm.toUpperCase(),
+ declaredHash(item),
entry?.required === undefined ? '-' : entry.required ? 'Yes' : 'No',
];
cells.forEach((content, column) => {
const cell = row.insertCell();
- cell.dataset.label = head.cells[column].textContent!;
+ cell.dataset.label = stackedLabel(head.cells[column]);
cell.append(content);
});
}
@@ -892,6 +949,7 @@ const notFound = () => {
resolveFileAddress();
followMovedCard();
enhanceTables();
+breakPaths();
hashSearch();
glossaryTerms();
osTabs();
From 29e726c907ad481f3c5bc54298dfd1a9b8e962b5 Mon Sep 17 00:00:00 2001
From: Abdessamad Derraz <3028866+Abdess@users.noreply.github.com>
Date: Sat, 24 Oct 2026 00:47:48 +0200
Subject: [PATCH 4/4] chore: test the round 5 component fixes
---
tests/test_site_r5_components.py | 227 +++++++++++++++++++++++++++++++
1 file changed, 227 insertions(+)
create mode 100644 tests/test_site_r5_components.py
diff --git a/tests/test_site_r5_components.py b/tests/test_site_r5_components.py
new file mode 100644
index 00000000..a09e0f5c
--- /dev/null
+++ b/tests/test_site_r5_components.py
@@ -0,0 +1,227 @@
+"""Round 5, package 2: components and runtime.
+
+Source checks always run. Checks on the built site read website/dist and
+skip when no build is there. The rules written in a build plugin run under
+node and skip without it.
+"""
+
+from __future__ import annotations
+
+import html
+import json
+import re
+import shutil
+import subprocess
+import sys
+import unittest
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(REPO_ROOT / "scripts"))
+
+from common import list_release_pack_platforms # noqa: E402
+
+WEBSITE = REPO_ROOT / "website"
+DIST = WEBSITE / "dist"
+COMPONENTS = WEBSITE / "src" / "components"
+SITE_TS = WEBSITE / "src" / "scripts" / "site.ts"
+PLUGINS = WEBSITE / "src" / "plugins"
+SHORT_CODE = PLUGINS / "rehype-short-code.mjs"
+STACK_TABLES = PLUGINS / "rehype-stack-tables.mjs"
+ENTITY = re.compile(r"&(?:#\d+|#x[0-9a-f]+|[a-z]+);", re.I)
+
+
+def _read(path: Path) -> str:
+ return path.read_text(encoding="utf-8")
+
+
+def _built(page: str) -> str:
+ path = DIST / page / "index.html"
+ if not path.is_file():
+ raise unittest.SkipTest(f"no built site at {path}")
+ return _read(path)
+
+
+def _node(script: str) -> str:
+ node = shutil.which("node")
+ if not node:
+ raise unittest.SkipTest("node is missing")
+ result = subprocess.run(
+ [node, "--input-type=module", "-e", script],
+ capture_output=True, text=True, check=True, cwd=WEBSITE,
+ env={"NODE_DISABLE_COMPILE_CACHE": "1", "PATH": str(Path(node).parent)},
+ )
+ return result.stdout
+
+
+def _text(page: str) -> str:
+ """A built page's visible words: tags dropped, entities read."""
+ return html.unescape(re.sub(r"<[^>]+>", "", page))
+
+
+def _picker_packs() -> set[str]:
+ """The setups the built picker offers a release ZIP line for."""
+ page = _built("which-pack")
+ match = re.search(r'data-release="([^"]*)"', page)
+ if not match:
+ raise AssertionError("which-pack has no picker release data")
+ return set(json.loads(html.unescape(match[1]))["packs"])
+
+
+class PickerFollowsTheRegistry(unittest.TestCase):
+ """2.1: the picker said "The ZIP of release v2026.10.10 holds 5,804
+ files" for ROCKNIX while its setup page and get/ page said "No ZIP for
+ ROCKNIX" (N2, J5). The picker read the raw release.json."""
+
+ def test_source(self):
+ source = _read(COMPONENTS / "FilePicker.astro")
+ self.assertIn("import release from '../generated/release-advertised.json';", source)
+ self.assertNotIn("release.json'", source)
+
+ def test_picker_offers_only_registry_packs(self):
+ offered = _picker_packs()
+ self.assertTrue(offered)
+ released = set(list_release_pack_platforms(str(REPO_ROOT / "platforms"), include_archived=True))
+ self.assertLessEqual(offered, released)
+
+ def test_picker_setup_and_get_pages_agree(self):
+ offered = _picker_packs()
+ setups = json.loads(_read(DIST / "data" / "picker" / "index.json"))
+ self.assertTrue(setups)
+ for entry in setups:
+ name = entry["platform"]
+ with self.subTest(platform=name):
+ get_page = _text(_built(f"get/{name}"))
+ setup_page = _text(_built(f"platforms/{name}"))
+ no_zip = f"No ZIP for {entry['name']}."
+ self.assertEqual(name in offered, no_zip not in get_page)
+ self.assertEqual(name in offered, no_zip not in setup_page)
+
+
+class PathsBreakAtSeparators(unittest.TestCase):
+ """2.2: `~/.var/app/org.libretro.RetroArch/config/r` then
+ `etroarch/system/` on platforms/retroarch/ at 390 px (V8)."""
+
+ def test_the_rule(self):
+ uri = json.dumps(SHORT_CODE.as_uri())
+ out = _node(
+ f"import {{ markRawCode, withBreaks, breaksAtSeparators }} from {uri};"
+ "console.log(JSON.stringify(["
+ "markRawCode('~/.config/retroarch/system/aaaaaaaaaaa/ bios/a.bin | '),"
+ "markRawCode('C:\\\\RetroArch-Win64\\\\system\\\\aaaaaaaaaaaaa | '),"
+ "withBreaks('a/b/'), breaksAtSeparators('x'.repeat(31), false),"
+ "breaksAtSeparators('a/' + 'x'.repeat(30), true), breaksAtSeparators('a/b', false)]));"
+ )
+ self.assertEqual(json.loads(out), [
+ '~/.config/retroarch/system/aaaaaaaaaaa/'
+ ' bios/a.bin | ',
+ 'C:\\RetroArch-Win64\\system\\aaaaaaaaaaaaa | ',
+ "a/b/", False, False, False,
+ ])
+
+ def test_built_page(self):
+ page = _built("platforms/retroarch")
+ self.assertIn("~/.var/app/org.libretro.RetroArch/config/retroarch/system/", page)
+
+ def test_the_page_budget(self):
+ """Each `wbr` is an element: bluemsx held 3,097 of them on 9,369
+ elements against a budget of 10,000. The build spends BREAK_BUDGET
+ per page, the runtime writes the others."""
+ uri = json.dumps(SHORT_CODE.as_uri())
+ out = _node(
+ f"import {{ markRawCode, BREAK_BUDGET }} from {uri};"
+ "const room = { left: 3 };"
+ "const path = 'aaaaaaaaaa/bbbbbbbbbb/cccccccccc/d';"
+ "console.log(JSON.stringify([BREAK_BUDGET, markRawCode(path, room), markRawCode(path, room), room.left]));"
+ )
+ budget, first, second, left = json.loads(out)
+ self.assertEqual(first, "aaaaaaaaaa/bbbbbbbbbb/cccccccccc/d")
+ self.assertEqual(second, "aaaaaaaaaa/bbbbbbbbbb/cccccccccc/d")
+ self.assertEqual(left, 0)
+ if not DIST.is_dir():
+ self.skipTest("no built site")
+ # Link text the generator breaks itself (a forge address) is not code.
+ code = re.compile(r"]*)?>(?:[^<]|)*