General Update

src/layouts/BaseLayout.astro

@@ -54,10 +54,13 @@ const ogImageUrl = ogImage
 ---
 
 <!doctype html>
-<!-- `no-js` is removed by reveal-init.ts the moment JS runs. While it stays,
-     the global.css `.no-js .reveal { opacity: 1 }` rule guarantees content is
-     never invisible even if the reveal script fails to load. -->
-<html lang="en" class="no-js" data-theme="light">
+<!-- no-js guard: removed by reveal-init.ts once JS runs; while present, the
+     global.css `.no-js .reveal { opacity:1 }` rule keeps content visible even
+     if the reveal script fails. Theme model: data-theme on <html>, data-surface
+     on <body>. DARK MODE IS CURRENTLY FORCED — light mode is deferred (the
+     site is designed for dark first). theme-init.ts pins data-theme="dark" and
+     ignores any stored/OS preference until light mode is reintroduced. -->
+<html lang="en" class="no-js" data-theme="dark">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
@@ -79,7 +82,10 @@ const ogImageUrl = ogImage
 
     <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
 
-    <!-- Theme boot: blocking inline script prevents flash of wrong theme. -->
+    <!-- Theme boot: blocking inline script prevents flash of the wrong theme.
+         Dark mode is currently forced (light mode deferred), so this just pins
+         data-theme="dark" before paint. No data-astro-rerun needed since the
+         theme never changes across navigations. -->
     <script is:inline set:html={themeInitScript} />
 
     <!-- Reveal-on-scroll observer. Pairs with Reveal.astro / [data-reveal].