@brandon_m_behring/book-scaffold-astro 4.22.0 → 4.23.0

package/components/Sidebar.astro

@@ -14,16 +14,20 @@
  * 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';
 
 // Academic profile: part is a string enum. `academicParts` (schemas.ts) is
 // the canonical order, shared with the renderer and ChapterHeader (#95); the

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