@brandon_m_behring/book-scaffold-astro 4.11.0 → 4.13.0

package/dist/index.mjs

@@ -368,6 +368,13 @@ var ACADEMIC_PART_ORDINAL = {
   synthesis: 5
 };
 var UNKNOWN_PART_ORDINAL = 99;
+var ACADEMIC_PART_LABEL = {
+  foundations: "Foundations",
+  "ssm-core": "SSM Core",
+  "beyond-ssm": "Beyond SSM",
+  integration: "Integration",
+  synthesis: "Synthesis"
+};
 function titleCase(part) {
   return part.split("-").map((w) => w.length > 0 ? w.charAt(0).toUpperCase() + w.slice(1) : "").join(" ");
 }
@@ -377,7 +384,7 @@ var academicChaptersRenderer = {
   },
   formatPartLabel(part) {
     if (typeof part === "string" && part.length > 0) {
-      return titleCase(part);
+      return ACADEMIC_PART_LABEL[part] ?? titleCase(part);
     }
     return String(part);
   },

package/dist/schemas.mjs

@@ -252,6 +252,13 @@ var ACADEMIC_PART_ORDINAL = {
   synthesis: 5
 };
 var UNKNOWN_PART_ORDINAL = 99;
+var ACADEMIC_PART_LABEL = {
+  foundations: "Foundations",
+  "ssm-core": "SSM Core",
+  "beyond-ssm": "Beyond SSM",
+  integration: "Integration",
+  synthesis: "Synthesis"
+};
 function titleCase(part) {
   return part.split("-").map((w) => w.length > 0 ? w.charAt(0).toUpperCase() + w.slice(1) : "").join(" ");
 }
@@ -261,7 +268,7 @@ var academicChaptersRenderer = {
   },
   formatPartLabel(part) {
     if (typeof part === "string" && part.length > 0) {
-      return titleCase(part);
+      return ACADEMIC_PART_LABEL[part] ?? titleCase(part);
     }
     return String(part);
   },

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.13.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

package/src/profiles/renderers/academic-chapters.ts

@@ -28,7 +28,22 @@ const ACADEMIC_PART_ORDINAL: Record<string, number> = {
 
 const UNKNOWN_PART_ORDINAL = 99;
 
-/** Title-case an enum string: "ssm-core" → "Ssm Core". */
+/**
+ * Display labels for the academic-profile `part` enum. An explicit map (not
+ * naive title-casing) so acronyms render correctly: `ssm-core` → "SSM Core",
+ * not "Ssm Core" (#91). Keys mirror ACADEMIC_PART_ORDINAL; unknown/custom
+ * parts fall back to titleCase() in formatPartLabel.
+ */
+const ACADEMIC_PART_LABEL: Record<string, string> = {
+  foundations: 'Foundations',
+  'ssm-core': 'SSM Core',
+  'beyond-ssm': 'Beyond SSM',
+  integration: 'Integration',
+  synthesis: 'Synthesis',
+};
+
+/** Title-case an enum string: "ssm-core" → "Ssm Core". Fallback for parts
+ *  outside the known ACADEMIC_PART_LABEL map (e.g. consumer-custom parts). */
 function titleCase(part: string): string {
   return part
     .split('-')
@@ -43,7 +58,7 @@ export const academicChaptersRenderer: ChaptersRenderer = {
 
   formatPartLabel(part) {
     if (typeof part === 'string' && part.length > 0) {
-      return titleCase(part);
+      return ACADEMIC_PART_LABEL[part] ?? titleCase(part);
     }
     return String(part);
   },

package/styles/tokens.css

@@ -34,7 +34,9 @@
   --color-bg:         var(--paper);
   --color-bg-subtle:  var(--code-bg);
   --color-text:       var(--dark-text);
-  --color-text-muted: color-mix(in srgb, var(--dark-text) 55%, var(--paper));
+  /* 65% clears WCAG AA on --paper (~5.4:1); 55% computed to ≈#807F7E ≈3.9:1, failing AA (#91).
+     color-mix re-resolves in the dark scope (cream over deep bg → higher contrast). */
+  --color-text-muted: color-mix(in srgb, var(--dark-text) 65%, var(--paper));
   --color-border:     var(--code-frame);
   --color-link:       var(--warm-blue);
   --color-heading:    var(--warm-blue);