@brandon_m_behring/book-scaffold-astro 4.25.1 → 4.25.2

package/layouts/Base.astro

@@ -16,10 +16,14 @@
  *   showSidebar — render the left chapter-navigation sidebar (default: true).
  *                 Set false for the landing page or any full-bleed surface.
  *                 Below 1024px the sidebar is auto-hidden via CSS regardless.
+ *   showChrome  — render the tools chrome (ToolFilter + VersionSelector)
+ *                 (default: true). Set false on a landing/hub page with no
+ *                 chapters/tools/versions; search + theme toggle always render.
  *
  * Tools chrome (ToolFilter, VersionSelector): only mounted when
- * BOOK_PROFILE !== 'academic'. Academic-profile books get no JS islands
- * in the chrome row (search + theme toggle only).
+ * BOOK_PROFILE !== 'academic' AND showChrome !== false. Academic-profile books
+ * (and any page with showChrome={false}) get no JS islands in the chrome row
+ * (search + theme toggle only).
  *
  * Usage:
  *   ---
@@ -61,13 +65,17 @@ import Sidebar from '../components/Sidebar.astro';
 import bookConfig from 'virtual:book-scaffold/book-config';
 
 const profile = import.meta.env.BOOK_PROFILE ?? 'minimal';
-const showToolsChrome = profile !== 'academic';
 
 interface Props {
   title: string;
   description?: string;
   lang?: string;
   showSidebar?: boolean;
+  /** #163: render the optional "tools chrome" — the ToolFilter +
+   *  VersionSelector islands (default true). Set false on landing/hub pages
+   *  with no chapters/tools/versions; the search + theme-toggle cluster always
+   *  renders. (No-op for the academic profile, which never shows them.) */
+  showChrome?: boolean;
   /** v4.6.0: Open Graph image URL (relative to site root, or absolute). */
   ogImage?: string;
   /** v4.6.0: Open Graph type. Defaults to 'website'; Chapter.astro passes 'article'. */
@@ -79,10 +87,18 @@ const {
   description,
   lang = 'en',
   showSidebar = true,
+  showChrome = true,
   ogImage,
   ogType = 'website',
 } = Astro.props;
 
+// Tools chrome (ToolFilter + VersionSelector) renders only for non-academic
+// profiles AND when the page opts in via showChrome (default true). A
+// landing/hub page (no chapters/tools/versions) passes showChrome={false} to
+// get the search + theme-toggle cluster only — the chrome-free path that
+// previously forced borrowing the academic profile (and its katex deps). #163.
+const showToolsChrome = (profile !== 'academic') && showChrome;
+
 // v4.6.0: canonical + og:url need Astro.site. defineBookConfig throws at
 // config-load if `site` is missing, so Astro.site is guaranteed populated
 // here. `new URL` resolves the relative pathname against it.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@brandon_m_behring/book-scaffold-astro",
   "description": "Astro 6 + MDX toolkit for long-form technical books. Profile-aware (academic / tools / minimal); ships Tufte typography, KaTeX, BibTeX citations, Pagefind, Cloudflare Workers deploy. See PACKAGE_DESIGN.md for the API contract.",
-  "version": "4.25.1",
+  "version": "4.25.2",
   "type": "module",
   "license": "MIT",
   "author": "Brandon Behring",

package/styles/chapter.css

@@ -230,3 +230,18 @@
   }
   .chapter-nav .next { grid-column: 1; text-align: left; }
 }
+
+/* Display math (KaTeX) — scroll a too-wide equation WITHIN its own block instead
+   of forcing a horizontal scroll on the whole page. KaTeX sets no `overflow` on
+   `.katex-display`, so it defaults to `visible`; a wide equation (long
+   derivations, big matrices) then overflows the viewport and the page scrolls
+   sideways on mobile. WCAG 1.4.10 Reflow. See book-scaffold-astro#162.
+   overflow-y is deliberately NOT set: once overflow-x is non-visible the CSS
+   overflow rule already computes overflow-y to `auto`, so there is no spurious
+   vertical scrollbar — and an explicit `hidden` would silently clip tall
+   equations if a consumer ever constrains .katex-display's height. */
+.katex-display {
+  overflow-x: auto;
+  /* a little room so the horizontal scrollbar doesn't clip the equation's descenders */
+  padding-block-end: 0.25rem;
+}