@brandon_m_behring/book-scaffold-astro 4.23.0 → 4.25.0

package/dist/components/SectionMap.d.ts

@@ -0,0 +1,10 @@
+import * as preact from 'preact';
+import { MarkdownHeading } from 'astro';
+
+interface Props {
+    /** TOC headings (tocHeadings output) — slug/depth/text only, serializable. */
+    headings: MarkdownHeading[];
+}
+declare function SectionMap({ headings }: Props): preact.JSX.Element;
+
+export { SectionMap as default };

package/dist/components/SectionMap.mjs

@@ -0,0 +1,107 @@
+// components/SectionMap.tsx
+import { useEffect, useRef } from "preact/hooks";
+
+// src/lib/section-map.ts
+function pickActive(visible, prev) {
+  if (visible.length === 0) return prev;
+  let bestNonNeg = null;
+  let bestAbove = null;
+  for (const h of visible) {
+    if (h.top >= 0) {
+      if (bestNonNeg === null || h.top < bestNonNeg.top) bestNonNeg = h;
+    } else {
+      if (bestAbove === null || h.top > bestAbove.top) bestAbove = h;
+    }
+  }
+  if (bestNonNeg !== null) return bestNonNeg.slug;
+  if (bestAbove !== null) return bestAbove.slug;
+  return prev;
+}
+
+// components/SectionMap.tsx
+import { jsx } from "preact/jsx-runtime";
+function SectionMap({ headings }) {
+  const ref = useRef(null);
+  useEffect(() => {
+    const root = ref.current?.closest("[data-section-map-root]");
+    if (!root) {
+      throw new Error(
+        "SectionMap: no [data-section-map-root] ancestor \u2014 mount the island inside the <nav> that contains its links (see the DOM contract in SectionMap.tsx)."
+      );
+    }
+    const tracked = [];
+    for (const h of headings) {
+      const el = document.getElementById(h.slug);
+      if (el) tracked.push({ slug: h.slug, el });
+    }
+    if (tracked.length === 0) {
+      throw new Error(
+        `SectionMap: manifest/DOM drift \u2014 none of the ${headings.length} heading id(s) resolve to an element (#${headings.map((h) => h.slug).join(", #")}).`
+      );
+    }
+    const lastTracked = tracked[tracked.length - 1];
+    function linkFor(slug) {
+      return root.querySelector(
+        `a[data-section-id="${CSS.escape(slug)}"]`
+      );
+    }
+    const inView = /* @__PURE__ */ new Set();
+    let active = null;
+    function setActive(next) {
+      if (next === active) return;
+      if (active !== null) {
+        const prevLink = linkFor(active);
+        if (prevLink) {
+          prevLink.classList.remove("active");
+          prevLink.removeAttribute("aria-current");
+        }
+      }
+      if (next !== null) {
+        const nextLink = linkFor(next);
+        if (nextLink) {
+          nextLink.classList.add("active");
+          nextLink.setAttribute("aria-current", "page");
+        }
+      }
+      active = next;
+    }
+    function recompute() {
+      const visible = [];
+      for (const t of tracked) {
+        if (inView.has(t.el)) {
+          visible.push({ slug: t.slug, top: t.el.getBoundingClientRect().top });
+        }
+      }
+      setActive(pickActive(visible, active));
+    }
+    const observer = new IntersectionObserver(
+      (entries) => {
+        for (const entry of entries) {
+          if (entry.isIntersecting) inView.add(entry.target);
+          else inView.delete(entry.target);
+        }
+        recompute();
+      },
+      // A negative bottom margin biases "active" toward the heading nearest the
+      // top of the viewport (the section you're reading INTO), not the last one
+      // peeking in at the bottom.
+      { rootMargin: "0px 0px -70% 0px", threshold: 0 }
+    );
+    for (const t of tracked) observer.observe(t.el);
+    function onScroll() {
+      const atBottom = window.innerHeight + window.scrollY >= document.documentElement.scrollHeight - 2;
+      if (atBottom) setActive(lastTracked.slug);
+    }
+    window.addEventListener("scroll", onScroll, { passive: true });
+    window.addEventListener("resize", onScroll, { passive: true });
+    return () => {
+      observer.disconnect();
+      window.removeEventListener("scroll", onScroll);
+      window.removeEventListener("resize", onScroll);
+    };
+  }, [headings]);
+  return /* @__PURE__ */ jsx("span", { ref, class: "section-map-mount", hidden: true, "aria-hidden": "true" });
+}
+export {
+  SectionMap as default
+};

package/dist/{exam-manifest-DbTHo90M.d.ts → exam-manifest-DnqyzZ9I.d.ts}

@@ -1,4 +1,4 @@
-import { Q as Question } from './schemas-DDWDRUxs.js';
+import { Q as Question } from './schemas-CKipJ5Ie.js';
 
 /**
  * exam-engine.ts — PURE sampling + scoring for the interactive practice exam

package/dist/{flashcards-DPFFQhP8.d.ts → flashcards-okekZcl8.d.ts}

@@ -1,4 +1,4 @@
-import { G as GlossaryTerm } from './schemas-DDWDRUxs.js';
+import { G as GlossaryTerm } from './schemas-CKipJ5Ie.js';
 
 /**
  * flashcards.ts — PURE deck-manifest bridge between the `glossary` collection

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { AstroUserConfig, AstroIntegration } from 'astro';
-import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, l as Style } from './types-CGN95mrX.js';
-export { B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, d as BookPreset, e as BookProfile, g as BookSchemasOptions, C as ChapterFor, F as FreshnessAffordance, i as FrontmatterRouteConfig, P as PartKey, j as PartialRouteToggles, k as ProfileDefinition, R as RouteToggles, S as StatusBadge, m as StyleInput, V as VolatilityBadge, n as composeStyles, o as defineProfile, p as defineStyle, q as normalizeFrontmatterConfig, r as resolvePreset, s as resolveProfile } from './types-CGN95mrX.js';
-import { D as volatilityLevels, c as academicParts, Q as Question } from './schemas-DDWDRUxs.js';
-export { A as AcademicChapter, B as BloomLevel, C as CourseNotesChapter, G as GlossaryTerm, M as MinimalChapter, P as Provenance, a as QuestionType, R as ResearchPortfolioChapter, T as ToolsChapter, b as academicChapterSchema, d as bloomLevels, e as changeKinds, f as changelogSchema, g as chapterStatus, h as citationBackstops, i as courseNotesChapterSchema, j as glossarySchema, m as minimalChapterSchema, p as patternCategories, k as patternsSchema, l as provenanceObject, n as provenanceSchema, q as questionDifficulties, o as questionSchema, r as questionTypes, s as refineQuestion, t as refinedQuestionSchema, u as researchPortfolioChapterSchema, v as sourceTiers, w as sourceTiersResearch, x as sourcesSchema, y as toolSlugs, z as toolsChapterSchema } from './schemas-DDWDRUxs.js';
+import { AstroUserConfig, AstroIntegration, MarkdownHeading } from 'astro';
+import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, l as Style } from './types-Bn7rKhgP.js';
+export { B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, d as BookPreset, e as BookProfile, g as BookSchemasOptions, C as ChapterFor, F as FreshnessAffordance, i as FrontmatterRouteConfig, P as PartKey, j as PartialRouteToggles, k as ProfileDefinition, R as RouteToggles, S as StatusBadge, m as StyleInput, V as VolatilityBadge, n as composeStyles, o as defineProfile, p as defineStyle, q as normalizeFrontmatterConfig, r as resolvePreset, s as resolveProfile } from './types-Bn7rKhgP.js';
+import { E as volatilityLevels, c as academicParts, Q as Question } from './schemas-CKipJ5Ie.js';
+export { A as AcademicChapter, B as BloomLevel, C as CourseNotesChapter, G as GlossaryTerm, M as MinimalChapter, P as Provenance, a as QuestionType, R as ResearchPortfolioChapter, T as ToolsChapter, b as academicChapterSchema, d as bloomLevels, e as changeKinds, f as changelogSchema, g as chapterStatus, h as citationBackstops, i as courseNotesChapterSchema, j as glossarySchema, l as layoutModes, m as minimalChapterSchema, p as patternCategories, k as patternsSchema, n as provenanceObject, o as provenanceSchema, q as questionDifficulties, r as questionSchema, s as questionTypes, t as refineQuestion, u as refinedQuestionSchema, v as researchPortfolioChapterSchema, w as sourceTiers, x as sourceTiersResearch, y as sourcesSchema, z as toolSlugs, D as toolsChapterSchema } from './schemas-CKipJ5Ie.js';
 export { KIND_LABEL, ResolvedTheoremLabel, THEOREM_KINDS, TheoremKind, TheoremLabelProps, resolveTheoremNumber, theoremLabel } from './lib/theorem-label.js';
-export { D as DomainScore, E as ExamBlueprint, a as ExamQuestion, b as ExamResult, R as RoutingChapter, c as buildExamManifest, d as deriveDomainRouting, s as sampleExam, e as scoreExam, f as shuffle, g as spreadBlueprint } from './exam-manifest-DbTHo90M.js';
-export { F as FlashcardRef, b as buildFlashcardDeck } from './flashcards-DPFFQhP8.js';
+export { D as DomainScore, E as ExamBlueprint, a as ExamQuestion, b as ExamResult, R as RoutingChapter, c as buildExamManifest, d as deriveDomainRouting, s as sampleExam, e as scoreExam, f as shuffle, g as spreadBlueprint } from './exam-manifest-DnqyzZ9I.js';
+export { F as FlashcardRef, b as buildFlashcardDeck } from './flashcards-okekZcl8.js';
 import 'astro/zod';
 
 /**
@@ -360,6 +360,69 @@ declare function distinctChaptersSorted<T extends {
     data: Pick<Question, 'chapter'>;
 }>(entries: readonly T[]): string[];
 
+/**
+ * section-map.ts — PURE heading-selection + scrollspy logic for the right-gutter
+ * "On this page" section map (#section-map).
+ *
+ * No DOM, no Preact: this is the testable core under both ChapterTOC.astro (the
+ * collapsed mobile fallback) and the SectionMap island (the sticky gutter nav).
+ * Two pure, total functions:
+ *
+ *   - tocHeadings:  the ONE filter (h2+h3) that both the fallback TOC and the
+ *                   gutter map share — a single source of truth so the two
+ *                   never disagree about which headings are "on this page".
+ *   - pickActive:   given the headings currently intersecting the viewport (slug
+ *                   + viewport-relative top), choose which one is "active". The
+ *                   island feeds it IntersectionObserver state; node:test feeds
+ *                   it plain arrays. Browser geometry stays OUT of this file.
+ *
+ * Both are unit-tested in tests/section-map.test.mjs (node:test, no browser),
+ * mirroring exam-engine.ts.
+ */
+
+/**
+ * Filter a chapter's headings to the TOC set: depth 2–3 only. h1 is the chapter
+ * title (rendered by ChapterHeader, not the body) and h4+ is noise in an anchor
+ * list. This is the shared contract — ChapterTOC.astro and SectionMap.astro both
+ * call it so the fallback and the gutter map carry IDENTICAL entries. Pure: it
+ * copies (filter) rather than mutating the input.
+ */
+declare function tocHeadings(headings: MarkdownHeading[]): MarkdownHeading[];
+/**
+ * One visible heading, as the island measures it: its slug and its
+ * viewport-relative top (CSS pixels — `getBoundingClientRect().top`). A negative
+ * `top` means the heading has scrolled above the top of the viewport.
+ */
+interface VisibleHeading {
+    slug: string;
+    /** Viewport-relative top in px (negative = scrolled above the fold). */
+    top: number;
+}
+/**
+ * Choose the active section slug from the headings currently intersecting the
+ * viewport.
+ *
+ * Rule (a stable, total scrollspy):
+ *   1. Prefer the topmost heading at or below the top of the viewport — the
+ *      visible heading with the SMALLEST non-negative `top`. That's the section
+ *      the reader has just scrolled to / is reading into.
+ *   2. If every visible heading is above the fold (all `top` negative — e.g. a
+ *      heading STRADDLING the top edge: its top is slightly negative but its box
+ *      still overlaps the top zone, so it's intersecting yet has no non-negative
+ *      sibling below it), fall back to the one nearest the fold from above: the
+ *      GREATEST `top` (closest to 0 from the negative side). That keeps the
+ *      enclosing section lit instead of going dark mid-section. (A heading whose
+ *      box FULLY scrolled above the top has left `inView` entirely — it isn't in
+ *      `visible` at all, and is handled by the empty-set → `prev` branch below.)
+ *   3. If NOTHING is visible (the observer reports an empty set — between two
+ *      sparse intersections, or scrolled past the last heading), retain `prev`
+ *      so the highlight is sticky rather than flickering off.
+ *
+ * Pure + total: no DOM, no throw, deterministic. Ties (equal `top`) resolve to
+ * the first in iteration order, which the island passes in document order.
+ */
+declare function pickActive(visible: ReadonlyArray<VisibleHeading>, prev: string | null): string | null;
+
 /** One exercise as emitted by `book-scaffold build-exercises` (src/data/exercises.json). */
 interface ReviewExercise {
     id: string;
@@ -488,4 +551,4 @@ type TipsConfigInput = Omit<TipsConfig, typeof TipsConfigBrand | '__tipsConfigVe
  */
 declare function defineTips(opts: TipsConfigInput): TipsConfig;
 
-export { ACADEMIC_PART_NAMES, BRANDON_PORTFOLIO_DEFAULT, BUILTIN_STYLES, BookConfigOptions, BookScaffoldIntegrationOptions, ChaptersRenderer, DEFAULT_GITHUB_BRANCH, type Freshness, type FreshnessStatus, type PartReviewGroup, type PartReviewSelection, Question, type ReviewChapter, type ReviewExercise, Style, type TipsConfig, type TipsConfigInput, UNKNOWN_PART_ORDINAL, type VolatilityLevel, academicChaptersRenderer, academicPartHeading, academicPartName, academicPartOrdinal, academicParts, academicStyle, assertEnumProp, assertKnownDomain, bookScaffoldIntegration, buildGithubUrl, chapterLabel, chapterSortKey, courseNotesStyle, defineBookConfig, defineMdxComponents, defineTips, deriveObjectiveMap, distinctChaptersSorted, fallbackChaptersRenderer, freshnessLabel, getFreshness, groupByChapter, groupByDomain, minimalStyle, originUrlFromGitConfig, parseRepoSlug, researchPortfolioStyle, resolveBookHref, resolveGithubRepo, selectPartExercises, sortQuestions, toolsChaptersRenderer, toolsStyle, volatilityLevels };
+export { ACADEMIC_PART_NAMES, BRANDON_PORTFOLIO_DEFAULT, BUILTIN_STYLES, BookConfigOptions, BookScaffoldIntegrationOptions, ChaptersRenderer, DEFAULT_GITHUB_BRANCH, type Freshness, type FreshnessStatus, type PartReviewGroup, type PartReviewSelection, Question, type ReviewChapter, type ReviewExercise, Style, type TipsConfig, type TipsConfigInput, UNKNOWN_PART_ORDINAL, type VisibleHeading, type VolatilityLevel, academicChaptersRenderer, academicPartHeading, academicPartName, academicPartOrdinal, academicParts, academicStyle, assertEnumProp, assertKnownDomain, bookScaffoldIntegration, buildGithubUrl, chapterLabel, chapterSortKey, courseNotesStyle, defineBookConfig, defineMdxComponents, defineTips, deriveObjectiveMap, distinctChaptersSorted, fallbackChaptersRenderer, freshnessLabel, getFreshness, groupByChapter, groupByDomain, minimalStyle, originUrlFromGitConfig, parseRepoSlug, pickActive, researchPortfolioStyle, resolveBookHref, resolveGithubRepo, selectPartExercises, sortQuestions, tocHeadings, toolsChaptersRenderer, toolsStyle, volatilityLevels };

package/dist/index.mjs

@@ -168,6 +168,7 @@ var chapterStatus = [
   "scaffolded",
   "planned"
 ];
+var layoutModes = ["default", "wide"];
 var citationBackstops = ["research-kb", "manual", "unverified"];
 var provenanceObject = z.object({
   ai_tools: z.array(z.string()).default([]),
@@ -186,6 +187,8 @@ var academicChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   status: z.enum(chapterStatus),
   roadmap_lines: z.tuple([z.number().int(), z.number().int()]).optional(),
   code_path: z.string().optional(),
@@ -207,6 +210,8 @@ var toolsChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   part: z.number().int().min(0).max(10),
   chapter: z.number().int().min(0).max(99),
   volatility: z.enum(volatilityLevels),
@@ -232,6 +237,8 @@ var courseNotesChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   chapter: z.number().int().min(0).max(99),
   part: z.number().int().min(0).max(20).default(1),
   description: z.string().optional(),
@@ -268,6 +275,8 @@ var researchPortfolioChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // explicit slug override (otherwise filename)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   description: z.string().optional(),
   // Hierarchy — accept either academic-style or tools-style; all optional.
   // The academic 'part' field is a string enum; tools 'part' is a number.
@@ -576,7 +585,7 @@ var academicProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing; consumers override via src/pages/index.astro
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   katex: true,
   chaptersRenderer: academicChaptersRenderer,
   // v3.7.0 (#35) — owns /chapters semantics if consumer opts in via routes.chapters
@@ -715,7 +724,8 @@ var toolsProfile = defineProfile({
     "typography.css",
     "print.css",
     "convergence.css",
-    "tool-filter.css"
+    "tool-filter.css",
+    "section-map.css"
   ],
   chaptersRenderer: toolsChaptersRenderer
   // v3.7.0 (#35) — owns /chapters semantics for tools shape
@@ -800,7 +810,7 @@ var minimalProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   // v3.7.0 (#35): minimal aliases tools schema; fallback renderer field-dispatches if a consumer opts into routes.chapters
   chaptersRenderer: fallbackChaptersRenderer
 });
@@ -833,7 +843,7 @@ var courseNotesProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   // v3.7.0 (#35): course-notes schema has tools-style fields (chapter, volatility, sources) — fallback renderer dispatches via tools renderer
   chaptersRenderer: fallbackChaptersRenderer,
   // v4.6.0 (#76 Secondary): exclude /print/ from sitemap — print-friendly
@@ -870,7 +880,7 @@ var researchPortfolioProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   katex: true,
   // math is common in research content
   // v3.7.0 (#35): portfolio schema is a union of academic + tools shapes — fallback renderer dispatches per chapter via field presence
@@ -1749,6 +1759,26 @@ function buildFlashcardDeck(entries) {
   return entries.filter((e) => !e.data.draft).map((e) => ({ id: e.id, front: e.data.term })).sort((a, b) => a.front.localeCompare(b.front));
 }
 
+// src/lib/section-map.ts
+function tocHeadings(headings) {
+  return headings.filter((h) => h.depth >= 2 && h.depth <= 3);
+}
+function pickActive(visible, prev) {
+  if (visible.length === 0) return prev;
+  let bestNonNeg = null;
+  let bestAbove = null;
+  for (const h of visible) {
+    if (h.top >= 0) {
+      if (bestNonNeg === null || h.top < bestNonNeg.top) bestNonNeg = h;
+    } else {
+      if (bestAbove === null || h.top > bestAbove.top) bestAbove = h;
+    }
+  }
+  if (bestNonNeg !== null) return bestNonNeg.slug;
+  if (bestAbove !== null) return bestAbove.slug;
+  return prev;
+}
+
 // src/lib/part-review.ts
 function selectPartExercises(chapters, byChapter, part) {
   const want = String(part);
@@ -1844,6 +1874,7 @@ export {
   glossarySchema,
   groupByChapter,
   groupByDomain,
+  layoutModes,
   minimalChapterSchema,
   minimalStyle,
   normalizeFrontmatterConfig,
@@ -1851,6 +1882,7 @@ export {
   parseRepoSlug,
   patternCategories,
   patternsSchema,
+  pickActive,
   provenanceObject,
   provenanceSchema,
   questionDifficulties,
@@ -1875,6 +1907,7 @@ export {
   sourcesSchema,
   spreadBlueprint,
   theoremLabel,
+  tocHeadings,
   toolSlugs,
   toolsChapterSchema,
   toolsChaptersRenderer,

package/dist/{schemas-DDWDRUxs.d.ts → schemas-CKipJ5Ie.d.ts}

@@ -25,6 +25,7 @@ declare const changeKinds: readonly ["added", "removed", "changed", "deprecated"
 declare const patternCategories: readonly ["safety", "scale", "context", "interaction", "extension", "other"];
 declare const academicParts: readonly ["foundations", "ssm-core", "beyond-ssm", "integration", "synthesis"];
 declare const chapterStatus: readonly ["implemented", "chapter_only", "reading_only", "prose_only", "code_only", "scaffolded", "planned"];
+declare const layoutModes: readonly ["default", "wide"];
 declare const citationBackstops: readonly ["research-kb", "manual", "unverified"];
 declare const provenanceObject: z.ZodObject<{
     ai_tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -67,6 +68,10 @@ declare const academicChapterSchema: z.ZodObject<{
     }>;
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        wide: "wide";
+    }>>;
     status: z.ZodEnum<{
         implemented: "implemented";
         chapter_only: "chapter_only";
@@ -106,6 +111,10 @@ declare const academicChapterSchema: z.ZodObject<{
 declare const toolsChapterSchema: z.ZodObject<{
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        wide: "wide";
+    }>>;
     part: z.ZodNumber;
     chapter: z.ZodNumber;
     volatility: z.ZodEnum<{
@@ -148,6 +157,10 @@ declare const toolsChapterSchema: z.ZodObject<{
 declare const minimalChapterSchema: z.ZodObject<{
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        wide: "wide";
+    }>>;
     part: z.ZodNumber;
     chapter: z.ZodNumber;
     volatility: z.ZodEnum<{
@@ -205,6 +218,10 @@ declare const sourceTiersResearch: readonly ["T1", "T2", "T3", "T4"];
 declare const courseNotesChapterSchema: z.ZodObject<{
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        wide: "wide";
+    }>>;
     chapter: z.ZodNumber;
     part: z.ZodDefault<z.ZodNumber>;
     description: z.ZodOptional<z.ZodString>;
@@ -269,6 +286,10 @@ declare const courseNotesChapterSchema: z.ZodObject<{
 declare const researchPortfolioChapterSchema: z.ZodObject<{
     title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        wide: "wide";
+    }>>;
     description: z.ZodOptional<z.ZodString>;
     part: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
     week: z.ZodOptional<z.ZodNumber>;
@@ -488,4 +509,4 @@ declare const glossarySchema: z.ZodObject<{
 }, z.core.$strict>;
 type GlossaryTerm = z.infer<typeof glossarySchema>;
 
-export { type AcademicChapter as A, type BloomLevel as B, type CourseNotesChapter as C, volatilityLevels as D, type GlossaryTerm as G, type MinimalChapter as M, type Provenance as P, type Question as Q, type ResearchPortfolioChapter as R, type ToolsChapter as T, type QuestionType as a, academicChapterSchema as b, academicParts as c, bloomLevels as d, changeKinds as e, changelogSchema as f, chapterStatus as g, citationBackstops as h, courseNotesChapterSchema as i, glossarySchema as j, patternsSchema as k, provenanceObject as l, minimalChapterSchema as m, provenanceSchema as n, questionSchema as o, patternCategories as p, questionDifficulties as q, questionTypes as r, refineQuestion as s, refinedQuestionSchema as t, researchPortfolioChapterSchema as u, sourceTiers as v, sourceTiersResearch as w, sourcesSchema as x, toolSlugs as y, toolsChapterSchema as z };
+export { type AcademicChapter as A, type BloomLevel as B, type CourseNotesChapter as C, toolsChapterSchema as D, volatilityLevels as E, type GlossaryTerm as G, type MinimalChapter as M, type Provenance as P, type Question as Q, type ResearchPortfolioChapter as R, type ToolsChapter as T, type QuestionType as a, academicChapterSchema as b, academicParts as c, bloomLevels as d, changeKinds as e, changelogSchema as f, chapterStatus as g, citationBackstops as h, courseNotesChapterSchema as i, glossarySchema as j, patternsSchema as k, layoutModes as l, minimalChapterSchema as m, provenanceObject as n, provenanceSchema as o, patternCategories as p, questionDifficulties as q, questionSchema as r, questionTypes as s, refineQuestion as t, refinedQuestionSchema as u, researchPortfolioChapterSchema as v, sourceTiers as w, sourceTiersResearch as x, sourcesSchema as y, toolSlugs as z };

package/dist/schemas.d.ts

@@ -1,7 +1,7 @@
 import { defineCollection } from 'astro:content';
-import { g as BookSchemasOptions } from './types-CGN95mrX.js';
+import { g as BookSchemasOptions } from './types-Bn7rKhgP.js';
 import 'astro';
-import './schemas-DDWDRUxs.js';
+import './schemas-CKipJ5Ie.js';
 import 'astro/zod';
 
 /**

package/dist/schemas.mjs

@@ -52,6 +52,7 @@ var chapterStatus = [
   "scaffolded",
   "planned"
 ];
+var layoutModes = ["default", "wide"];
 var citationBackstops = ["research-kb", "manual", "unverified"];
 var provenanceObject = z.object({
   ai_tools: z.array(z.string()).default([]),
@@ -70,6 +71,8 @@ var academicChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   status: z.enum(chapterStatus),
   roadmap_lines: z.tuple([z.number().int(), z.number().int()]).optional(),
   code_path: z.string().optional(),
@@ -91,6 +94,8 @@ var toolsChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   part: z.number().int().min(0).max(10),
   chapter: z.number().int().min(0).max(99),
   volatility: z.enum(volatilityLevels),
@@ -116,6 +121,8 @@ var courseNotesChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // v4.9.0: explicit URL slug override (else filename → entry.id)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   chapter: z.number().int().min(0).max(99),
   part: z.number().int().min(0).max(20).default(1),
   description: z.string().optional(),
@@ -152,6 +159,8 @@ var researchPortfolioChapterSchema = z.object({
   title: z.string().min(1),
   slug: z.string().optional(),
   // explicit slug override (otherwise filename)
+  layout: z.enum(layoutModes).optional(),
+  // 1d: per-page width knob (default measure | 'wide'); threaded as data-layout
   description: z.string().optional(),
   // Hierarchy — accept either academic-style or tools-style; all optional.
   // The academic 'part' field is a string enum; tools 'part' is a number.
@@ -454,7 +463,7 @@ var academicProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing; consumers override via src/pages/index.astro
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   katex: true,
   chaptersRenderer: academicChaptersRenderer,
   // v3.7.0 (#35) — owns /chapters semantics if consumer opts in via routes.chapters
@@ -593,7 +602,8 @@ var toolsProfile = defineProfile({
     "typography.css",
     "print.css",
     "convergence.css",
-    "tool-filter.css"
+    "tool-filter.css",
+    "section-map.css"
   ],
   chaptersRenderer: toolsChaptersRenderer
   // v3.7.0 (#35) — owns /chapters semantics for tools shape
@@ -678,7 +688,7 @@ var minimalProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   // v3.7.0 (#35): minimal aliases tools schema; fallback renderer field-dispatches if a consumer opts into routes.chapters
   chaptersRenderer: fallbackChaptersRenderer
 });
@@ -711,7 +721,7 @@ var courseNotesProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   // v3.7.0 (#35): course-notes schema has tools-style fields (chapter, volatility, sources) — fallback renderer dispatches via tools renderer
   chaptersRenderer: fallbackChaptersRenderer,
   // v4.6.0 (#76 Secondary): exclude /print/ from sitemap — print-friendly
@@ -748,7 +758,7 @@ var researchPortfolioProfile = defineProfile({
     landing: true
     // v4.5.0: auto-inject minimal root landing
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css", "section-map.css"],
   katex: true,
   // math is common in research content
   // v3.7.0 (#35): portfolio schema is a union of academic + tools shapes — fallback renderer dispatches per chapter via field presence

package/dist/{types-CGN95mrX.d.ts → types-Bn7rKhgP.d.ts}

@@ -1,5 +1,5 @@
 import { AstroIntegration, AstroUserConfig } from 'astro';
-import { A as AcademicChapter, T as ToolsChapter, M as MinimalChapter, C as CourseNotesChapter, R as ResearchPortfolioChapter } from './schemas-DDWDRUxs.js';
+import { A as AcademicChapter, T as ToolsChapter, M as MinimalChapter, C as CourseNotesChapter, R as ResearchPortfolioChapter } from './schemas-CKipJ5Ie.js';
 
 /**
  * src/lib/chapters-renderer.ts — per-profile strategy interface for the

package/layouts/Base.astro

@@ -99,13 +99,14 @@ const absoluteOgImage = resolvedOgImage
 const twitterHandle = bookConfig.seo?.twitterHandle ?? null;
 const ogSiteName = bookConfig.title ?? title;
 const ogDescription = description ?? bookConfig.description ?? '';
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 ---
 
 <!doctype html>
 <html lang={lang}>
   <head>
     <meta charset="utf-8" />
-    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <link rel="icon" type="image/svg+xml" href={`${baseUrl}favicon.svg`} />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="color-scheme" content="light dark" />
     <meta name="generator" content={Astro.generator} />
@@ -119,7 +120,7 @@ const ogDescription = description ?? bookConfig.description ?? '';
         OG tags). sitemap link points at @astrojs/sitemap's auto-emitted
         index. */}
     <link rel="canonical" href={canonicalURL} />
-    <link rel="sitemap" type="application/xml" href="/sitemap-index.xml" />
+    <link rel="sitemap" type="application/xml" href={`${baseUrl}sitemap-index.xml`} />
     <meta property="og:title" content={title} />
     {ogDescription && <meta property="og:description" content={ogDescription} />}
     <meta property="og:url" content={canonicalURL} />
@@ -150,7 +151,7 @@ const ogDescription = description ?? bookConfig.description ?? '';
       {showToolsChrome && <ToolFilter client:idle />}
       {showToolsChrome && <VersionSelector client:idle />}
       <a
-        href="/search/"
+        href={`${baseUrl}search/`}
         class="chrome-button"
         aria-label="Search the book"
         title="Search"

package/layouts/Chapter.astro

@@ -25,6 +25,7 @@ import Base from './Base.astro';
 import bookConfig from 'virtual:book-scaffold/book-config';
 import ChapterHeader from '../components/ChapterHeader.astro';
 import ChapterTOC from '../components/ChapterTOC.astro';
+import SectionMap from '../components/SectionMap.astro';
 import ChapterNav from '../components/ChapterNav.astro';
 
 interface Props {
@@ -44,6 +45,39 @@ const articlePublished = (entry.data as { published?: Date }).published;
 const articleUpdated = (entry.data as { updated?: Date }).updated;
 const articleTags = ((entry.data as { tags?: string[] }).tags ?? []) as string[];
 const chapterImage = (entry.data as { image?: string }).image;
+
+// (#section-map): best-effort context label for the gutter section map, e.g.
+// "Part 2 · Ch 4" or "Week 1". All hierarchy fields are profile-dependent and
+// Zod-optional (academic carries part+week; tools/research-portfolio carry
+// part+chapter; minimal carries none), so each piece is included only when
+// present — the label is omitted entirely (undefined) when nothing is derivable.
+const dataAny = entry.data as {
+  part?: string | number;
+  chapter?: number;
+  week?: number;
+  layout?: 'default' | 'wide';
+};
+
+// 1d: per-page width knob. `layout` is Zod-optional on every profile schema
+// (closed enum 'default'|'wide'). Emit `data-layout` ONLY for a non-default
+// value so existing chapters (no `layout`, or `layout: default`) render the
+// attribute-free <article> byte-identically — `undefined` makes Astro drop the
+// attribute, and only `.prose[data-layout="wide"]` carries a rule in layout.css.
+const layoutMode =
+  dataAny.layout && dataAny.layout !== 'default' ? dataAny.layout : undefined;
+const labelParts: string[] = [];
+if (dataAny.part !== undefined && dataAny.part !== '') {
+  // Numeric part → "Part N"; string-enum part (academic, e.g. "foundations")
+  // → title-case it as-is.
+  labelParts.push(
+    typeof dataAny.part === 'number'
+      ? `Part ${dataAny.part}`
+      : dataAny.part.charAt(0).toUpperCase() + dataAny.part.slice(1),
+  );
+}
+if (dataAny.chapter !== undefined) labelParts.push(`Ch ${dataAny.chapter}`);
+else if (dataAny.week !== undefined) labelParts.push(`Week ${dataAny.week}`);
+const sectionMapLabel = labelParts.length > 0 ? labelParts.join(' · ') : undefined;
 ---
 
 <Base
@@ -62,9 +96,10 @@ const chapterImage = (entry.data as { image?: string }).image;
     )}
     {articleTags.map((t) => <meta property="article:tag" content={t} />)}
   </Fragment>
-  <article class="prose">
+  <article class="prose" data-layout={layoutMode}>
     <ChapterHeader data={entry.data} />
     <ChapterTOC headings={headings} />
+    <SectionMap headings={headings} label={sectionMapLabel} />
     <slot />
     <ChapterNav currentId={entry.id} />
   </article>