@brandon_m_behring/book-scaffold-astro 4.22.0 → 4.24.0

package/components/ChapterNav.astro

@@ -10,17 +10,18 @@ interface Props {
 }
 const { currentId } = Astro.props;
 const { prev, next } = await getNeighbors(currentId);
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 ---
 {(prev || next) && (
   <nav class="chapter-nav" aria-label="Chapter navigation">
     {prev && (
-      <a href={`/${prev.id}/`} class="prev">
+      <a href={`${baseUrl}chapters/${prev.id}/`} class="prev">
         <span class="nav-label">← Previous</span>
         <span class="nav-title">{prev.data.title}</span>
       </a>
     )}
     {next && (
-      <a href={`/${next.id}/`} class="next">
+      <a href={`${baseUrl}chapters/${next.id}/`} class="next">
         <span class="nav-label">Next →</span>
         <span class="nav-title">{next.data.title}</span>
       </a>

package/components/Cite.astro

@@ -45,6 +45,7 @@ interface Props {
 }
 
 const { key, page } = Astro.props;
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 const entry = map[key];
 if (!entry) {
   throw new Error(
@@ -66,6 +67,6 @@ else authorText = `${surname(authors[0])} et al.`;
 const year = entry.issued?.['date-parts']?.[0]?.[0] ?? 'n.d.';
 const yearText = page ? `${year}, p. ${page}` : `${year}`;
 ---
-<a href={`/references#${key}`} class="cite" title={entry.title ?? key}>
+<a href={`${baseUrl}references#${key}`} class="cite" title={entry.title ?? key}>
   {authorText} ({yearText})
 </a>

package/components/PartReview.astro

@@ -27,6 +27,7 @@ interface Props {
   title?: string;
 }
 const { part, title } = Astro.props;
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 
 // Reuse the build-exercises index (keyed by chapter slug). Project-root-relative
 // glob (the tips.astro / exercises.astro lesson) so it resolves across consumers.
@@ -65,7 +66,7 @@ const heading = title ?? `Part ${part} Review`;
       </p>
       {groups.map((g) => (
         <section class="part-review-chapter">
-          <h3 class="part-review-chapter-title"><a href={`/chapters/${g.chapter}/`}>{g.chapter}</a></h3>
+          <h3 class="part-review-chapter-title"><a href={`${baseUrl}chapters/${g.chapter}/`}>{g.chapter}</a></h3>
           <ol class="part-review-list">
             {g.exercises.map((ex) => (
               <li id={`review-${ex.id}`} class="part-review-item">

package/components/Rationale.astro

@@ -54,7 +54,7 @@ const asLink = appendix && !onAnswersRoute;
 ---
 {asLink ? (
   <p class="question-rationale-ref">
-    <a href={`/answers#answer-${forId}`}>{title} →</a>
+    <a href={`${basePath}/answers#answer-${forId}`}>{title} →</a>
   </p>
 ) : (
   <details class="question-rationale">

package/components/Sidebar.astro

@@ -14,16 +14,21 @@
  * Visual: ~280px wide, sticky to top, scrollable independently of main.
  * Site title at top doubles as a "home" link.
  *
- * Customize: edit the `siteTitle` / `siteSubtitle` strings below or pass
- * them in as Astro.props from Base.astro if you want per-page overrides.
+ * Customize (v4.23.0, #135): the brand reads `defineBookConfig({ title,
+ * subtitle })` via the book-config virtual module — consumers set both in
+ * astro.config.mjs with zero component overrides. The previous hardcoded
+ * strings remain the fallbacks, so existing books render unchanged until
+ * they configure a title.
  */
 import { getCollection } from 'astro:content';
+import bookConfig from 'virtual:book-scaffold/book-config';
 import { academicParts } from '../src/schemas';
 import { academicPartHeading } from '../src/lib/academic-parts';
 
 const profile = import.meta.env.BOOK_PROFILE ?? 'minimal';
-const siteTitle = 'Book';
-const siteSubtitle = 'A scaffold-astro book';
+const siteTitle = bookConfig.title ?? 'Book';
+const siteSubtitle = bookConfig.subtitle ?? 'A scaffold-astro book';
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 
 // Academic profile: part is a string enum. `academicParts` (schemas.ts) is
 // the canonical order, shared with the renderer and ChapterHeader (#95); the
@@ -87,8 +92,10 @@ for (const r of rows) {
 }
 
 const currentPath = Astro.url.pathname;
+const chaptersIndexHref = `${baseUrl}chapters/`;
+const referencesHref = `${baseUrl}references/`;
 function isCurrent(id: string): boolean {
-  return currentPath === `/chapters/${id}/` || currentPath === `/chapters/${id}`;
+  return currentPath === `${baseUrl}chapters/${id}/` || currentPath === `${baseUrl}chapters/${id}`;
 }
 
 function partLabel(key: string): string {
@@ -99,22 +106,22 @@ function partLabel(key: string): string {
 
 <aside class="sidebar" aria-label="Chapter navigation">
   <div class="sidebar-inner">
-    <a href="/" class="sidebar-home">
+    <a href={baseUrl} class="sidebar-home">
       <strong>{siteTitle}</strong>
       <span class="sidebar-subtitle">{siteSubtitle}</span>
     </a>
 
     <nav class="sidebar-nav">
       <a
-        href="/chapters/"
-        class={`sidebar-link sidebar-link-index ${currentPath === '/chapters/' ? 'is-current' : ''}`}
+        href={chaptersIndexHref}
+        class={`sidebar-link sidebar-link-index ${currentPath === chaptersIndexHref ? 'is-current' : ''}`}
       >
         All chapters
       </a>
       {profile === 'academic' && (
         <a
-          href="/references/"
-          class={`sidebar-link sidebar-link-index ${currentPath === '/references/' ? 'is-current' : ''}`}
+          href={referencesHref}
+          class={`sidebar-link sidebar-link-index ${currentPath === referencesHref ? 'is-current' : ''}`}
         >
           References
         </a>
@@ -127,7 +134,7 @@ function partLabel(key: string): string {
             {list.map((r) => (
               <li>
                 <a
-                  href={`/chapters/${r.id}/`}
+                  href={`${baseUrl}chapters/${r.id}/`}
                   class={`sidebar-link ${isCurrent(r.id) ? 'is-current' : ''}`}
                 >
                   <span class="sidebar-week">{r.prefix}</span>

package/components/Term.astro

@@ -17,8 +17,9 @@ interface Props {
   id: string;
 }
 const { id } = Astro.props;
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 ---
-<a href={`/glossary#term-${id}`} class="term-link"><slot /></a>
+<a href={`${baseUrl}glossary#term-${id}`} class="term-link"><slot /></a>
 
 <style>
   .term-link {

package/components/TipsCard.astro

@@ -20,6 +20,7 @@ const tipsModules = import.meta.glob<{ default: Array<{ n: number; title: string
   { eager: true },
 );
 const tips = tipsModules['/src/data/tips.json']?.default ?? [];
+const baseUrl = import.meta.env.BASE_URL ?? '/';
 ---
 <aside class="tips-card" role="contentinfo">
   <h2 class="tips-card-title">Tips</h2>
@@ -33,7 +34,7 @@ const tips = tipsModules['/src/data/tips.json']?.default ?? [];
     <ol class="tips-card-list">
       {tips.map((tip) => (
         <li class="tips-card-item">
-          <a href={`/tips#tip-${tip.n}`} class="tips-card-link">
+          <a href={`${baseUrl}tips#tip-${tip.n}`} class="tips-card-link">
             <span class="tips-card-number">{tip.n}.</span>
             <strong class="tips-card-rule">{tip.title}</strong>
           </a>

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AstroUserConfig, AstroIntegration } from 'astro';
-import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, l as Style } from './types-CwsA0C9T.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-CwsA0C9T.js';
+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';
 export { KIND_LABEL, ResolvedTheoremLabel, THEOREM_KINDS, TheoremKind, TheoremLabelProps, resolveTheoremNumber, theoremLabel } from './lib/theorem-label.js';

package/dist/index.mjs

@@ -1188,6 +1188,7 @@ function bookScaffoldIntegration(opts) {
     mdxComponentsModule,
     // v4.5.0: landing-page data, propagated via virtual module to /index.astro.
     title,
+    subtitle,
     description,
     portfolio,
     // v4.6.0: book-level author + SEO config, propagated through the
@@ -1251,6 +1252,7 @@ function bookScaffoldIntegration(opts) {
               makeMdxComponentsVitePlugin(resolvedMdxPath),
               makeBookConfigVitePlugin({
                 title: title ?? null,
+                subtitle: subtitle ?? null,
                 description: description ?? null,
                 portfolio: portfolio ?? false,
                 enabledRoutes: enabledRouteNames,
@@ -1388,6 +1390,8 @@ async function defineBookConfig(opts) {
       // v4.5.0: pass landing-page data through to the integration so it can
       // be exposed to the auto-injected /index.astro via the virtual module.
       title: opts.title,
+      // v4.23.0 (#135): sidebar brand subtitle.
+      subtitle: opts.subtitle,
       description: opts.description,
       portfolio: resolvedPortfolio,
       // v4.6.0: book-level author + SEO config (ogImage, twitterHandle),
@@ -1439,6 +1443,7 @@ async function defineBookConfig(opts) {
     katexMacros: _katexMacros,
     // v4.5.0: strip new landing-related opts so they don't leak into AstroUserConfig.
     title: _title,
+    subtitle: _subtitle,
     description: _description,
     portfolio: _portfolio,
     // v4.6.0: strip new book-level SEO opts (author + seo block).
@@ -1463,6 +1468,7 @@ async function defineBookConfig(opts) {
   void _markdown;
   void _katexMacros;
   void _title;
+  void _subtitle;
   void _description;
   void _portfolio;
   void _author;

package/dist/schemas.d.ts

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

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

@@ -592,6 +592,14 @@ interface BookConfigOptions {
      * default <title> when no per-page title is supplied.
      */
     title?: string;
+    /**
+     * v4.23.0 (#135): Sidebar brand subtitle — the second line under the brand
+     * title in the left chapter-nav. Optional; defaults to the scaffold's
+     * placeholder ('A scaffold-astro book') for backward compatibility. The
+     * brand TITLE is the existing `title` field above (previously the sidebar
+     * hardcoded both strings, so every consumer shipped the placeholder).
+     */
+    subtitle?: string;
     /**
      * v4.5.0: Book description. Read by the auto-injected `/` landing page (lead paragraph + <meta description>).
      * Optional; landing renders no description paragraph if unset.
@@ -708,6 +716,9 @@ interface BookScaffoldIntegrationOptions {
     extraStyles?: readonly string[];
     /** v4.5.0: book title, propagated to `/` landing via vite.define. */
     title?: string;
+    /** v4.23.0 (#135): sidebar brand subtitle, propagated via the book-config
+     *  virtual module to Sidebar.astro. */
+    subtitle?: string;
     /** v4.5.0: book description, propagated to `/` landing via vite.define. */
     description?: string;
     /**

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