@brandon_m_behring/book-scaffold-astro 4.31.0 → 5.0.0

package/pages/corpus-apparatus/exercises.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import ExercisesPage from '../exercises.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'exercises', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<ExercisesPage bookId={bookId} />

package/pages/corpus-apparatus/flashcards.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import FlashcardsPage from '../flashcards.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'flashcards', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<FlashcardsPage bookId={bookId} />

package/pages/corpus-apparatus/glossary.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import GlossaryPage from '../glossary.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'glossary', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<GlossaryPage bookId={bookId} />

package/pages/corpus-apparatus/practice-exam.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import PracticeExamPage from '../practice-exam.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'practice-exam', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<PracticeExamPage bookId={bookId} />

package/pages/corpus-apparatus/print.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import PrintPage from '../print.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'print', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<PrintPage bookId={bookId} />

package/pages/corpus-apparatus/references.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import ReferencesPage from '../references.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'references', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<ReferencesPage bookId={bookId} />

package/pages/corpus-apparatus/tips.astro

@@ -0,0 +1,15 @@
+---
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { corpusBookHasApparatusRoute } from '../../src/lib/corpus';
+import TipsPage from '../tips.astro';
+
+export function getStaticPaths() {
+  if (!bookConfig.corpus) return [];
+  return bookConfig.corpus.books
+    .filter((book) => corpusBookHasApparatusRoute(bookConfig.corpus!, book.id, 'tips', bookConfig.apparatusRoutes))
+    .map((book) => ({ params: { book: book.id }, props: { bookId: book.id } }));
+}
+
+const { bookId } = Astro.props;
+---
+<TipsPage bookId={bookId} />

package/pages/exercises.astro

@@ -11,16 +11,29 @@
  */
 import Base from '../layouts/Base.astro';
 import { normalizeBase } from '../src/lib/nav-href';
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { selectBookArtifact } from '../src/lib/corpus';
+
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
 
 // v4.4.0 fix: use Vite's import.meta.glob with a project-root-relative
 // path (same lesson as tips.astro). `/src/data/...` is consumer-project-
 // rooted in Vite's resolver and works across all consumer build contexts.
-const exModules = import.meta.glob<{ default: Record<string, Array<{ id: string; problem: string }>> }>(
+type ExerciseIndex = Record<string, Array<{ id: string; problem: string }>>;
+const exModules = import.meta.glob<{ default: unknown }>(
   '/src/data/exercises.json',
   { eager: true },
 );
 const exEntry = exModules['/src/data/exercises.json'];
-const byChapter = exEntry?.default ?? {};
+const byChapter = exEntry
+  ? selectBookArtifact<ExerciseIndex>(
+      exEntry.default,
+      bookConfig.corpus,
+      bookId,
+      'src/data/exercises.json',
+    )
+  : {};
 const loadError = exEntry
   ? null
   : 'src/data/exercises.json not found — run `npx book-scaffold build-exercises` to generate.';
@@ -31,7 +44,7 @@ const total = chapters.reduce((sum, c) => sum + byChapter[c].length, 0);
 // #142: chapter deep-links must prefix the deploy base.
 const baseUrl = normalizeBase(import.meta.env.BASE_URL);
 ---
-<Base title="Exercises" description="All exercises in this book, grouped by chapter with deep links.">
+<Base title="Exercises" description="All exercises in this book, grouped by chapter with deep links." bookId={bookId}>
   <article class="prose">
     <h1>Exercises</h1>
     {loadError && (
@@ -51,12 +64,12 @@ const baseUrl = normalizeBase(import.meta.env.BASE_URL);
     {chapters.map((chapter) => (
       <section class="exercises-chapter" id={`chapter-${chapter}`}>
         <h2 class="exercises-chapter-title">
-          Chapter: <a href={`${baseUrl}chapters/${chapter}/`}>{chapter}</a>
+          Chapter: <a href={`${baseUrl}chapters/${bookId ? `${bookId}/` : ''}${chapter}/`}>{chapter}</a>
         </h2>
         <ol class="exercises-list">
           {byChapter[chapter].map((ex) => (
             <li class="exercises-item">
-              <a href={`${baseUrl}chapters/${chapter}/#exercise-${ex.id}`} class="exercises-link">
+              <a href={`${baseUrl}chapters/${bookId ? `${bookId}/` : ''}${chapter}/#exercise-${ex.id}`} class="exercises-link">
                 <strong class="exercises-id">Exercise {ex.id}</strong>
                 <span class="exercises-preview">{ex.problem.slice(0, 120)}{ex.problem.length > 120 ? '…' : ''}</span>
               </a>

package/pages/flashcards.astro

@@ -24,30 +24,47 @@ import Base from '../layouts/Base.astro';
 import { getCollection, render } from 'astro:content';
 import Flashcards from '@brandon_m_behring/book-scaffold-astro/components/Flashcards';
 import { buildFlashcardDeck } from '../src/lib/flashcards';
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { localCorpusEntryId } from '../src/lib/corpus';
 import '../styles/flashcards.css';
 
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
+
 // Presence-gate: only touch the collection when the directory holds files.
 const glossModules = import.meta.glob('/src/content/glossary/**/*.{md,mdx}', {
   query: '?raw',
   import: 'default',
   eager: true,
 });
-const hasGlossary = Object.keys(glossModules).length > 0;
+const hasGlossary = bookId
+  ? Object.keys(glossModules).some((path) => path.includes(`/glossary/${bookId}/`))
+  : Object.keys(glossModules).length > 0;
 
-const entries = hasGlossary ? await getCollection('glossary', (e) => !e.data.draft) : [];
-const deck = buildFlashcardDeck(entries);
+const allEntries = hasGlossary ? await getCollection('glossary', (e) => !e.data.draft) : [];
+const entries = bookId
+  ? allEntries.filter((entry) => entry.id.startsWith(`${bookId}/`))
+  : allEntries;
+const localId = (id: string) => bookId && bookConfig.corpus
+  ? localCorpusEntryId(bookConfig.corpus, bookId, id)
+  : id;
+const deck = buildFlashcardDeck(entries.map((entry) => ({ ...entry, id: localId(entry.id) })));
 // Render definitions in deck (alphabetical) order so cards and manifest agree.
-const byId = new Map(entries.map((e) => [e.id, e]));
+const byId = new Map(entries.map((e) => [localId(e.id), e]));
 const rendered = await Promise.all(
   deck.map(async (card) => {
     const entry = byId.get(card.id)!;
     return { ...card, Content: (await render(entry)).Content };
   }),
 );
+const storageKey = bookId
+  ? `book:${import.meta.env.BASE_URL}:flashcards:${bookId}:known`
+  : undefined;
 ---
 <Base
   title="Flashcards"
   description="Glossary flashcards: shuffled recall practice with flip-to-check and known/still-learning buckets."
+  bookId={bookId}
 >
   <article class="prose flashcards-page" data-flashcards-root>
     <h1>Flashcards</h1>
@@ -65,7 +82,11 @@ const rendered = await Promise.all(
         {/* Without JS the island's deck controls would render dead — hide
             them; the full card list below stays readable. */}
         <noscript><style is:inline>.flashcards-runner { display: none; }</style></noscript>
-        <Flashcards client:idle deck={deck.map(({ id, front }) => ({ id, front }))} />
+        <Flashcards
+          client:idle
+          deck={deck.map(({ id, front }) => ({ id, front }))}
+          storageKey={storageKey}
+        />
         <section class="flashcards-list">
           {rendered.map((card) => {
             const Content = card.Content;

package/pages/glossary.astro

@@ -16,6 +16,11 @@
  */
 import Base from '../layouts/Base.astro';
 import { getCollection, render } from 'astro:content';
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { localCorpusEntryId } from '../src/lib/corpus';
+
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
 
 // Presence-gate: only touch the collection when the directory holds files.
 const glossModules = import.meta.glob('/src/content/glossary/**/*.{md,mdx}', {
@@ -23,14 +28,25 @@ const glossModules = import.meta.glob('/src/content/glossary/**/*.{md,mdx}', {
   import: 'default',
   eager: true,
 });
-const hasGlossary = Object.keys(glossModules).length > 0;
+const hasGlossary = bookId
+  ? Object.keys(glossModules).some((path) => path.includes(`/glossary/${bookId}/`))
+  : Object.keys(glossModules).length > 0;
 
-const entries = hasGlossary ? await getCollection('glossary', (e) => !e.data.draft) : [];
+const allEntries = hasGlossary ? await getCollection('glossary', (e) => !e.data.draft) : [];
+const entries = bookId
+  ? allEntries.filter((entry) => entry.id.startsWith(`${bookId}/`))
+  : allEntries;
 // Alphabetical by display term (locale-aware so case/accents sort naturally).
 entries.sort((a, b) => a.data.term.localeCompare(b.data.term));
 
 const rendered = await Promise.all(
-  entries.map(async (e) => ({ id: e.id, data: e.data, Content: (await render(e)).Content })),
+  entries.map(async (e) => ({
+    id: bookId && bookConfig.corpus
+      ? localCorpusEntryId(bookConfig.corpus, bookId, e.id)
+      : e.id,
+    data: e.data,
+    Content: (await render(e)).Content,
+  })),
 );
 const total = rendered.length;
 // id → display term, so "See also" links show the friendly term, not the kebab id.
@@ -39,6 +55,7 @@ const termById = new Map(rendered.map((t) => [t.id, t.data.term]));
 <Base
   title="Glossary"
   description="Searchable key-terms glossary, listed alphabetically."
+  bookId={bookId}
 >
   <article class="prose glossary">
     <h1>Glossary</h1>

package/pages/index.astro

@@ -60,10 +60,17 @@ const ROUTE_LABELS: Record<string, { label: string; href: string }> = {
 
 const visibleRoutes = enabledRoutes
   .filter((name) => name in ROUTE_LABELS)
+  .filter((name) => !bookConfig.corpus || name === 'chapters' || name === 'search')
   .map((name) => ROUTE_LABELS[name]!);
 ---
 
-<Base title={title} description={description ?? undefined}>
+<Base
+  title={title}
+  description={description ?? undefined}
+  showChrome={!bookConfig.corpus}
+  showSidebar={!bookConfig.corpus}
+  pagefindSurface={bookConfig.corpus ? 'corpus' : undefined}
+>
   <article class="prose landing">
     <h1>{title}</h1>
     {description && <p class="lead">{description}</p>}
@@ -79,6 +86,22 @@ const visibleRoutes = enabledRoutes
       </>
     )}
 
+    {bookConfig.corpus && (
+      <section aria-labelledby="corpus-books-heading">
+        <h2 id="corpus-books-heading" class="read-heading">Books</h2>
+        <ol class="book-list">
+          {bookConfig.corpus.books.map((book) => (
+            <li>
+              <a href={`${baseUrl}${book.id}/`}>
+                <strong>{book.title}</strong>
+                {book.description && <span>{book.description}</span>}
+              </a>
+            </li>
+          ))}
+        </ol>
+      </section>
+    )}
+
     {portfolio && portfolio !== false && (
       <p class="portfolio-footer">
         <small>
@@ -117,6 +140,36 @@ const visibleRoutes = enabledRoutes
     font-family: var(--font-sans, sans-serif);
     font-size: 1rem;
   }
+  .book-list {
+    list-style: none;
+    padding: 0;
+    display: grid;
+    gap: var(--space-4);
+  }
+  .book-list li {
+    margin: 0;
+  }
+  .book-list a {
+    display: block;
+    padding: var(--space-4);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-md);
+    color: inherit;
+    text-decoration: none;
+    background: var(--color-bg-subtle);
+  }
+  .book-list a:hover,
+  .book-list a:focus-visible {
+    border-color: var(--color-link);
+  }
+  .book-list strong,
+  .book-list span {
+    display: block;
+  }
+  .book-list span {
+    margin-top: var(--space-1);
+    color: var(--color-text-muted);
+  }
   .portfolio-footer {
     margin-top: 3rem;
     color: var(--color-text-muted, #555);

package/pages/practice-exam.astro

@@ -42,15 +42,20 @@ import { getAllQuestions, groupByDomain } from '../src/lib/questions';
 import { assertKnownDomain } from '../src/lib/exam-domains';
 import { buildExamManifest } from '../src/lib/exam-manifest';
 
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
+
 // Presence-gate: only touch the collection when the directory holds files.
 const questionModules = import.meta.glob('/src/content/questions/**/*.{md,mdx}', {
   query: '?raw',
   import: 'default',
   eager: true,
 });
-const hasQuestions = Object.keys(questionModules).length > 0;
+const hasQuestions = bookId
+  ? Object.keys(questionModules).some((path) => path.includes(`/questions/${bookId}/`))
+  : Object.keys(questionModules).length > 0;
 
-const entries = hasQuestions ? await getAllQuestions() : [];
+const entries = hasQuestions ? await getAllQuestions(bookId) : [];
 
 // Fail-loud: every question's domain must be in the examDomains registry.
 for (const entry of entries) {
@@ -78,6 +83,7 @@ const manifest = buildExamManifest(entries);
 <Base
   title="Practice question bank"
   description="All practice questions in this book, grouped by exam domain, with a scored practice-exam mode and answers behind a reveal."
+  bookId={bookId}
 >
   <article class="prose practice-exam" data-exam-root>
     <h1>Practice question bank</h1>

package/pages/print.astro

@@ -26,7 +26,12 @@ import { getAllChapters } from '../src/lib/chapters';
 import ChapterHeader from '../components/ChapterHeader.astro';
 import mdxComponents from 'virtual:book-scaffold/mdx-components';
 
-const chapters = await getAllChapters();
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
+const allChapters = await getAllChapters();
+const chapters = bookId
+  ? allChapters.filter((entry) => entry.id.startsWith(`${bookId}/`))
+  : allChapters;
 const rendered = await Promise.all(
   chapters.map(async (entry) => {
     const { Content } = await render(entry);
@@ -35,7 +40,7 @@ const rendered = await Promise.all(
 );
 ---
 
-<Base title="Book (print edition)" description="Full book rendered as a single paginated document for PDF export.">
+<Base title="Book (print edition)" description="Full book rendered as a single paginated document for PDF export." bookId={bookId}>
   <div class="prose print-edition">
     {rendered.map(({ entry, Content }) => (
       <section class="chapter-print">

package/pages/references.astro

@@ -17,6 +17,11 @@
  */
 import Base from '../layouts/Base.astro';
 import SourceArchive from '../components/SourceArchive.astro';
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { selectBookArtifact } from '../src/lib/corpus';
+
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
 
 type CslAuthor = { family?: string; given?: string; literal?: string };
 type CslEntry = {
@@ -36,23 +41,38 @@ type CslEntry = {
 };
 
 // --- Bibliography: BibTeX → references.json (academic profile). ---
-const refsModules = import.meta.glob<{ default: Record<string, CslEntry> }>(
+const refsModules = import.meta.glob<{ default: unknown }>(
   '/src/data/references.json',
   { eager: true },
 );
 const refsModule = refsModules['/src/data/references.json'];
-const map = (refsModule?.default ?? {}) as Record<string, CslEntry>;
+const map = refsModule
+  ? selectBookArtifact<Record<string, CslEntry>>(
+      refsModule.default,
+      bookConfig.corpus,
+      bookId,
+      'src/data/references.json',
+    )
+  : {};
 const entries = Object.values(map);
 
 // --- Cited sources: sources/manifest.yaml → sources.json (tools profile).
 // Presence-only gate; the actual render reads the live `sources` collection
 // via <SourceArchive>, which only runs when this gate is true (so it is never
 // reached on profiles without a `sources` collection). ---
-const srcModules = import.meta.glob<{ default: unknown[] }>(
+const srcModules = import.meta.glob<{ default: unknown }>(
   '/src/data/sources.json',
   { eager: true },
 );
-const sourcesData = (srcModules['/src/data/sources.json']?.default ?? []) as unknown[];
+const sourcesModule = srcModules['/src/data/sources.json'];
+const sourcesData = sourcesModule
+  ? selectBookArtifact<unknown[]>(
+      sourcesModule.default,
+      bookConfig.corpus,
+      bookId,
+      'src/data/sources.json',
+    )
+  : [];
 const hasSources = Array.isArray(sourcesData) && sourcesData.length > 0;
 const hasBib = entries.length > 0;
 
@@ -100,7 +120,7 @@ const lede =
         ? 'Every external source cited in this book, grouped by tier in descending authority.'
         : 'This book has no references yet.';
 ---
-<Base title="References" description="Bibliography and cited sources for this book.">
+<Base title="References" description="Bibliography and cited sources for this book." bookId={bookId}>
   <article class="prose">
     <header>
       <h1>References</h1>
@@ -156,7 +176,7 @@ const lede =
           External sources cited inline via <code>&lt;Citation&gt;</code>, grouped
           by tier in descending authority.
         </p>
-        <SourceArchive />
+        <SourceArchive sources={bookConfig.corpus ? sourcesData : undefined} />
       </section>
     )}
   </article>

package/pages/search.astro

@@ -12,15 +12,24 @@
  */
 import Base from '../layouts/Base.astro';
 import { normalizeBase } from '../src/lib/nav-href';
+import bookConfig from 'virtual:book-scaffold/book-config';
 
 // #142: Pagefind writes its bundle to dist/pagefind/, served under the deploy
 // base — so the asset URLs must prefix BASE_URL or they 404 under a non-root base.
 const baseUrl = normalizeBase(import.meta.env.BASE_URL);
+const corpusBooks = bookConfig.corpus?.books ?? [];
+const corpusBookIds = corpusBooks.map((book) => book.id);
+const searchOwner = bookConfig.title ?? (bookConfig.corpus ? 'Book corpus' : 'book-scaffold-astro');
+const searchDescription = bookConfig.corpus
+  ? 'Full-text search across the books in this corpus. All queries run in the browser.'
+  : 'Full-text search across the book. Indexed via Pagefind at build time; all queries run in the browser.';
 ---
 
 <Base
-  title="Search · book-template-astro"
-  description="Full-text search across the book. Indexed via Pagefind at build time; all queries run in the browser."
+  title={`Search · ${searchOwner}`}
+  description={searchDescription}
+  showSidebar={!bookConfig.corpus}
+  pagefindSurface={bookConfig.corpus ? 'corpus' : undefined}
 >
   <link rel="stylesheet" href={`${baseUrl}pagefind/pagefind-ui.css`} slot="head" />
 
@@ -31,20 +40,55 @@ const baseUrl = normalizeBase(import.meta.env.BASE_URL);
       build time and is less than 100 KB total — queries never leave
       the page.
     </p>
+    {bookConfig.corpus && (
+      <label class="search-book-filter" for="search-book">
+        <span>Book</span>
+        <select id="search-book" name="book">
+          <option value="">All books</option>
+          {corpusBooks.map((book) => <option value={book.id}>{book.title}</option>)}
+        </select>
+      </label>
+    )}
     <div id="search"></div>
   </div>
 
   <script src={`${baseUrl}pagefind/pagefind-ui.js`} is:inline></script>
-  <script is:inline>
+  <script is:inline define:vars={{ corpusBookIds }}>
     // Initialize after the Pagefind bundle has loaded.
     window.addEventListener('DOMContentLoaded', () => {
       if (typeof window.PagefindUI === 'function') {
-        new window.PagefindUI({
+        var params = new URLSearchParams(window.location.search);
+        var requestedBook = params.get('book');
+        var selectedBook = requestedBook && corpusBookIds.indexOf(requestedBook) !== -1
+          ? requestedBook
+          : '';
+        if (requestedBook && !selectedBook) {
+          params.delete('book');
+          var canonicalQuery = params.toString();
+          history.replaceState(null, '', location.pathname + (canonicalQuery ? '?' + canonicalQuery : '') + location.hash);
+        }
+
+        var ui = new window.PagefindUI({
           element: '#search',
           showImages: false,
           showSubResults: true,
           resetStyles: false,
         });
+        if (selectedBook) ui.triggerFilters({ book: [selectedBook] });
+
+        var selector = document.getElementById('search-book');
+        if (selector) {
+          selector.value = selectedBook;
+          selector.addEventListener('change', function () {
+            selectedBook = selector.value;
+            var next = new URLSearchParams(window.location.search);
+            if (selectedBook) next.set('book', selectedBook);
+            else next.delete('book');
+            var query = next.toString();
+            history.replaceState(null, '', location.pathname + (query ? '?' + query : '') + location.hash);
+            ui.triggerFilters(selectedBook ? { book: [selectedBook] } : {});
+          });
+        }
       } else {
         document.getElementById('search').innerHTML =
           '<p><em>Search index not found. Run <code>npm run build</code> first; dev mode does not include the index.</em></p>';
@@ -57,6 +101,23 @@ const baseUrl = normalizeBase(import.meta.env.BASE_URL);
     .pagefind-ui__form {
       margin-top: var(--space-4);
     }
+    .search-book-filter {
+      display: grid;
+      gap: var(--space-1);
+      max-width: 24rem;
+      margin: var(--space-5) 0 var(--space-3);
+      font-family: var(--font-sans);
+      font-size: var(--text-sm);
+      font-weight: 600;
+    }
+    .search-book-filter select {
+      padding: var(--space-2) var(--space-3);
+      border: 1px solid var(--color-border);
+      border-radius: var(--radius-md);
+      background: var(--color-bg-subtle);
+      color: var(--color-text);
+      font: inherit;
+    }
     .pagefind-ui__search-input {
       font-family: var(--font-body) !important;
       font-size: var(--text-base) !important;

package/pages/tips.astro

@@ -11,18 +11,31 @@
  */
 import Base from '../layouts/Base.astro';
 import { normalizeBase } from '../src/lib/nav-href';
+import bookConfig from 'virtual:book-scaffold/book-config';
+import { selectBookArtifact } from '../src/lib/corpus';
+
+interface Props { bookId?: string; }
+const { bookId } = Astro.props;
 
 // v4.4.0 fix: use Vite's import.meta.glob with a project-root-relative
 // path. The previous `../../../src/data/tips.json` resolution failed when
 // the auto-injected route was processed from node_modules (or any context
 // other than a workspace symlink). `/src/data/...` is consumer-project-rooted
 // in Vite's resolver and works across all consumer build contexts.
-const tipsModules = import.meta.glob<{ default: Array<{ n: number; title: string; chapter: string; preview: string }> }>(
+type TipIndexEntry = { n: number; title: string; chapter: string; preview: string };
+const tipsModules = import.meta.glob<{ default: unknown }>(
   '/src/data/tips.json',
   { eager: true },
 );
 const tipsEntry = tipsModules['/src/data/tips.json'];
-const tips = tipsEntry?.default ?? [];
+const tips = tipsEntry
+  ? selectBookArtifact<TipIndexEntry[]>(
+      tipsEntry.default,
+      bookConfig.corpus,
+      bookId,
+      'src/data/tips.json',
+    )
+  : [];
 const loadError = tipsEntry
   ? null
   : 'src/data/tips.json not found — run `npx book-scaffold build-tips` to generate.';
@@ -30,7 +43,7 @@ const loadError = tipsEntry
 // #142: chapter back-links must prefix the deploy base.
 const baseUrl = normalizeBase(import.meta.env.BASE_URL);
 ---
-<Base title="Tips" description="Numbered tips from this book, drawn from <Tip> instances in chapters.">
+<Base title="Tips" description="Numbered tips from this book, drawn from <Tip> instances in chapters." bookId={bookId}>
   <article class="prose">
     <h1>Tips</h1>
     {loadError && (
@@ -51,7 +64,7 @@ const baseUrl = normalizeBase(import.meta.env.BASE_URL);
               <p class="tips-index-preview">{tip.preview}</p>
             )}
             <p class="tips-index-meta">
-              From <a href={`${baseUrl}chapters/${tip.chapter}/`}>{tip.chapter}</a>
+              From <a href={`${baseUrl}chapters/${bookId ? `${bookId}/` : ''}${tip.chapter}/`}>{tip.chapter}</a>
             </p>
           </li>
         ))}