@brandon_m_behring/book-scaffold-astro 4.11.0 → 4.12.0

package/layouts/Base.astro

@@ -26,8 +26,13 @@
  *   import Base from '../layouts/Base.astro';
  *   ---
  *   <Base title="Chapter 1" description="...">
- *     <main>...</main>
+ *     <article class="prose">...</article>
  *   </Base>
+ *
+ * Landmark ownership: Base emits the single `<main>` landmark for every
+ * page (both the sidebar and full-bleed branches below). Slotted content
+ * must NOT wrap itself in `<main>` — use `<article>` / `<section>` / `<div>`
+ * — or the page ends up with duplicate `<main>` landmarks (a11y, #91).
  */
 import '@fontsource-variable/roboto';
 import '@fontsource-variable/source-code-pro';
@@ -169,7 +174,7 @@ const ogDescription = description ?? bookConfig.description ?? '';
         <main class="layout-main"><slot /></main>
       </div>
     ) : (
-      <slot />
+      <main><slot /></main>
     )}
     <script is:inline>
       (function () {

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.11.0",
+  "version": "4.12.0",
   "type": "module",
   "license": "MIT",
   "author": "Brandon Behring",

package/pages/print.astro

@@ -36,12 +36,12 @@ const rendered = await Promise.all(
 ---
 
 <Base title="Book (print edition)" description="Full book rendered as a single paginated document for PDF export.">
-  <main class="prose print-edition">
+  <div class="prose print-edition">
     {rendered.map(({ entry, Content }) => (
       <section class="chapter-print">
         <ChapterHeader data={entry.data} />
         <Content components={mdxComponents} />
       </section>
     ))}
-  </main>
+  </div>
 </Base>

package/pages/search.astro

@@ -19,7 +19,7 @@ import Base from '../layouts/Base.astro';
 >
   <link rel="stylesheet" href="/pagefind/pagefind-ui.css" slot="head" />
 
-  <main class="prose search-page">
+  <div class="prose search-page">
     <h1>Search</h1>
     <p>
       Full-text search runs in your browser. The index is generated at
@@ -27,7 +27,7 @@ import Base from '../layouts/Base.astro';
       the page.
     </p>
     <div id="search"></div>
-  </main>
+  </div>
 
   <script src="/pagefind/pagefind-ui.js" is:inline></script>
   <script is:inline>

package/recipes/06-mobile-first-layout.md

@@ -43,7 +43,7 @@ Re-tune with Playwright + `browser_take_screenshot` at the four viewports above
 </Base>
 ```
 
-Default is `showSidebar={true}`. The landing page (`src/pages/index.astro`) sets false because it's a one-page demo with no chapter context. Every chapter route inherits the default (true).
+Default is `showSidebar={true}`. Set it false on full-bleed surfaces — landing pages, splash screens, search results — that have no chapter context (`Base.astro` still emits the page's single `<main>` landmark in that branch). Every chapter route inherits the default (true).
 
 ## Customizing the sidebar
 

package/recipes/08-decisions-ledger.md

@@ -6,6 +6,8 @@
 
 The full master plan with discussion lives at `~/.claude/plans/i-want-to-investigate-recursive-yao.md`. The decisions ledger below is the operational summary.
 
+> **Scaffold ledger vs. consumer decision log.** This file is the *scaffold's own* design ledger. Separately, since v4.12.0 (#90) `create-book` scaffolds every new book with a `decisions/` directory (numbered ADRs + `ADR_TEMPLATE.md` + `README.md`) so each book keeps its own decision log by construction. The two are independent: this ledger explains why the scaffold is shaped as it is; a book's `decisions/` explains why that book is shaped as it is.
+
 ## Strategic decisions (Round 1)
 
 ### D1. Canonical repo