@brandon_m_behring/book-scaffold-astro 4.26.2 → 4.26.3

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AstroUserConfig, AstroIntegration, MarkdownHeading } from 'astro';
-import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, l as Style } from './types-Hue-uSeQ.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-Hue-uSeQ.js';
+import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, m as Style } from './types-CWXP1S4b.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 ReleaseStatusConfig, l as RouteToggles, S as StatusBadge, n as StyleInput, V as VolatilityBadge, o as composeStyles, p as defineProfile, q as defineStyle, r as normalizeFrontmatterConfig, s as resolvePreset, t as resolveProfile } from './types-CWXP1S4b.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';

package/dist/index.mjs

@@ -983,6 +983,9 @@ function composeStyles(styles) {
     if (style.preset !== void 0) merged.preset = style.preset;
     if (style.site !== void 0) merged.site = style.site;
     if (style.deploy !== void 0) merged.deploy = style.deploy;
+    if (style.releaseStatus !== void 0) {
+      merged.releaseStatus = style.releaseStatus;
+    }
     if (style.mdxComponentsModule !== void 0) {
       merged.mdxComponentsModule = style.mdxComponentsModule;
     }
@@ -1378,6 +1381,7 @@ async function defineBookConfig(opts) {
   const mdxComponentsModule = opts.mdxComponentsModule ?? composed.mdxComponentsModule;
   const composedMarkdown = composed.markdown ?? {};
   const userMarkdown = opts.markdown ?? {};
+  const resolvedReleaseStatus = opts.releaseStatus !== void 0 ? opts.releaseStatus : composed.releaseStatus;
   const wantsKatex = PROFILES[profile]?.katex === true;
   const remarkPlugins = [];
   const rehypePlugins = [];
@@ -1427,8 +1431,8 @@ async function defineBookConfig(opts) {
       title: opts.title,
       // v4.23.0 (#135): sidebar brand subtitle.
       subtitle: opts.subtitle,
-      // v4.27.0 (#149): release-state banner (top-level beats the style chain).
-      releaseStatus: opts.releaseStatus ?? composed.releaseStatus,
+      // v4.26.2 (#149; style inheritance + opt-out fixed in v4.26.3).
+      releaseStatus: resolvedReleaseStatus === false ? void 0 : resolvedReleaseStatus,
       description: opts.description,
       portfolio: resolvedPortfolio,
       // v4.6.0: book-level author + SEO config (ogImage, twitterHandle),
@@ -1486,7 +1490,7 @@ async function defineBookConfig(opts) {
     // v4.5.0: strip new landing-related opts so they don't leak into AstroUserConfig.
     title: _title,
     subtitle: _subtitle,
-    // v4.27.0 (#149): strip the release-state banner config.
+    // v4.26.2 (#149): strip the release-state banner config.
     releaseStatus: _releaseStatus,
     description: _description,
     portfolio: _portfolio,

package/dist/schemas.d.ts

@@ -1,5 +1,5 @@
 import { defineCollection } from 'astro:content';
-import { g as BookSchemasOptions } from './types-Hue-uSeQ.js';
+import { g as BookSchemasOptions } from './types-CWXP1S4b.js';
 import 'astro';
 import './schemas-CKipJ5Ie.js';
 import 'astro/zod';

package/dist/{types-Hue-uSeQ.d.ts → types-CWXP1S4b.d.ts}

@@ -379,12 +379,12 @@ interface Style {
      *  - `'pages'`: Cloudflare Pages (default for research-portfolio/course-notes)
      *  Closes #50. */
     readonly deploy?: 'pages' | 'workers';
-    /** v4.27.0 (#149): release-state banner; shallow override (last wins). */
-    readonly releaseStatus?: {
-        state: 'alpha' | 'beta' | 'rc' | 'locked';
-        dismissAt?: string;
-        message?: string;
-    };
+    /**
+     * v4.26.2 (#149; style inheritance fixed in v4.26.3): release-state
+     * banner. Shallow override (last defined wins); `false` suppresses a
+     * banner inherited from an earlier style.
+     */
+    readonly releaseStatus?: ReleaseStatusConfig | false;
     /**
      * Scoped consumer-side metadata. Ignored by the toolkit; survives composition
      * as per-key spread (last wins per key). Use this for workflow data that
@@ -445,7 +445,8 @@ declare function defineStyle(opts: StyleInput): Style;
  *   - Top-level `defineBookConfig` fields beat any style (handled in config.ts)
  *
  * Per-key merge strategy:
- *   - `preset`, `site`, `deploy`, `mdxComponentsModule`, `name` → shallow override (last wins)
+ *   - `preset`, `site`, `deploy`, `mdxComponentsModule`, `name`, `releaseStatus`
+ *     → shallow override (last defined wins; `releaseStatus: false` suppresses)
  *   - `routes` → per-route spread (each route key independently overridable)
  *   - `katexMacros` → per-macro spread (each macro key independently overridable)
  *   - `extra` → per-key spread (consumer metadata accumulates across the chain)
@@ -481,6 +482,17 @@ declare function normalizeFrontmatterConfig(v: FrontmatterRouteConfig | undefine
 
 type BookPreset = BookProfile;
 declare const BOOK_PRESETS: readonly ("academic" | "tools" | "minimal" | "course-notes" | "research-portfolio")[];
+/**
+ * v4.26.2 (#149): book-level release state rendered by
+ * `<PreReleaseBanner>` across every page.
+ *
+ * Style inheritance and explicit suppression were fixed in v4.26.3.
+ */
+interface ReleaseStatusConfig {
+    state: 'alpha' | 'beta' | 'rc' | 'locked';
+    dismissAt?: string;
+    message?: string;
+}
 /**
  * Options for `defineBookConfig`. See PACKAGE_DESIGN.md §4.
  *
@@ -607,16 +619,12 @@ interface BookConfigOptions {
      */
     subtitle?: string;
     /**
-     * v4.27.0 (#149): book-level release state. When set, Base.astro renders
-     * the existing <PreReleaseBanner> site-wide (top of <body>) with these
-     * props — previously the banner was author-import-only, so auto-layout
-     * consumers (ssm-foundations) had no way to wire it. Omit for no banner.
+     * v4.26.2 (#149; style inheritance fixed in v4.26.3): book-level release
+     * state. When set, Base.astro renders the existing <PreReleaseBanner>
+     * site-wide (top of <body>) with these props. Omit to inherit from the
+     * composed style chain; set `false` to suppress an inherited banner.
      */
-    releaseStatus?: {
-        state: 'alpha' | 'beta' | 'rc' | 'locked';
-        dismissAt?: string;
-        message?: string;
-    };
+    releaseStatus?: ReleaseStatusConfig | false;
     /**
      * v4.5.0: Book description. Read by the auto-injected `/` landing page (lead paragraph + <meta description>).
      * Optional; landing renders no description paragraph if unset.
@@ -769,13 +777,9 @@ interface BookScaffoldIntegrationOptions {
     /** v4.23.0 (#135): sidebar brand subtitle, propagated via the book-config
      *  virtual module to Sidebar.astro. */
     subtitle?: string;
-    /** v4.27.0 (#149): release-state banner, propagated via the book-config
-     *  virtual module; Base.astro renders <PreReleaseBanner> when set. */
-    releaseStatus?: {
-        state: 'alpha' | 'beta' | 'rc' | 'locked';
-        dismissAt?: string;
-        message?: string;
-    };
+    /** v4.26.2 (#149; style inheritance fixed in v4.26.3): resolved
+     *  release-state banner propagated via the book-config virtual module. */
+    releaseStatus?: ReleaseStatusConfig;
     /** v4.5.0: book description, propagated to `/` landing via vite.define. */
     description?: string;
     /**
@@ -851,4 +855,4 @@ declare function resolvePreset(explicitPreset?: BookPreset, explicitProfile?: Bo
  */
 declare function resolveProfile(explicit?: BookProfile): BookProfile;
 
-export { BOOK_PRESETS as B, type ChapterFor as C, type FreshnessAffordance as F, type PartKey as P, type RouteToggles as R, type StatusBadge as S, type VolatilityBadge as V, BOOK_PROFILES as a, BookConfigError as b, type BookConfigOptions as c, type BookPreset as d, type BookProfile as e, type BookScaffoldIntegrationOptions as f, type BookSchemasOptions as g, type ChaptersRenderer as h, type FrontmatterRouteConfig as i, type PartialRouteToggles as j, type ProfileDefinition as k, type Style as l, type StyleInput as m, composeStyles as n, defineProfile as o, defineStyle as p, normalizeFrontmatterConfig as q, resolvePreset as r, resolveProfile as s };
+export { BOOK_PRESETS as B, type ChapterFor as C, type FreshnessAffordance as F, type PartKey as P, type ReleaseStatusConfig as R, type StatusBadge as S, type VolatilityBadge as V, BOOK_PROFILES as a, BookConfigError as b, type BookConfigOptions as c, type BookPreset as d, type BookProfile as e, type BookScaffoldIntegrationOptions as f, type BookSchemasOptions as g, type ChaptersRenderer as h, type FrontmatterRouteConfig as i, type PartialRouteToggles as j, type ProfileDefinition as k, type RouteToggles as l, type Style as m, type StyleInput as n, composeStyles as o, defineProfile as p, defineStyle as q, normalizeFrontmatterConfig as r, resolvePreset as s, resolveProfile as t };

package/layouts/Base.astro

@@ -59,7 +59,8 @@ import '../styles/print.css';
 import VersionSelector from '@brandon_m_behring/book-scaffold-astro/components/VersionSelector';
 import ToolFilter from '@brandon_m_behring/book-scaffold-astro/components/ToolFilter';
 import Sidebar from '../components/Sidebar.astro';
-// v4.27.0 (#149): site-wide release-state banner, driven by defineBookConfig.
+// v4.26.2 (#149; style inheritance fixed in v4.26.3): site-wide
+// release-state banner, driven by defineBookConfig.
 import PreReleaseBanner from '../components/PreReleaseBanner.astro';
 // v4.26.0 (#80): the mobile/tablet drawer reuses the same book-scoped nav source.
 import NavContent from '../components/NavContent.astro';
@@ -167,7 +168,7 @@ const baseUrl = (import.meta.env.BASE_URL ?? '/').replace(/\/*$/, '/');
     <slot name="head" />
   </head>
   <body>
-    {/* v4.27.0 (#149): book-level release banner — first element in <body> so
+    {/* v4.26.2 (#149; style inheritance fixed in v4.26.3): book-level release banner — first element in <body> so
         every page (chapters, apparatus, landing) declares its state. Renders
         only when defineBookConfig({ releaseStatus }) is set. */}
     {bookConfig.releaseStatus && (

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

package/recipes/15-defining-styles.md

@@ -122,7 +122,8 @@ Different fields have different merge semantics. Documented:
 
 | Field | Strategy |
 |---|---|
-| `name`, `preset`, `site`, `deploy`, `mdxComponentsModule` | Shallow override (last wins) |
+| `name`, `preset`, `site`, `deploy`, `mdxComponentsModule` | Shallow override (last defined wins) |
+| `releaseStatus` | Shallow override (last defined object replaces the whole earlier object); `false` suppresses an inherited banner |
 | `routes` | Per-route spread (each route key independently overridable) |
 | `routes.frontmatter` | Per-route spread; later value (boolean OR object) wholly replaces earlier |
 | `katexMacros` | Object spread (per-macro override) |

package/src/lib/define-style.ts

@@ -27,7 +27,7 @@
  * for migration from the v3 `preset:` shorthand.
  */
 import type { AstroIntegration, AstroUserConfig } from 'astro';
-import type { BookPreset, RouteToggles } from '../types.js';
+import type { BookPreset, ReleaseStatusConfig, RouteToggles } from '../types.js';
 
 // ===== Branded nominal type =====
 
@@ -123,8 +123,12 @@ export interface Style {
    *  - `'pages'`: Cloudflare Pages (default for research-portfolio/course-notes)
    *  Closes #50. */
   readonly deploy?: 'pages' | 'workers';
-  /** v4.27.0 (#149): release-state banner; shallow override (last wins). */
-  readonly releaseStatus?: { state: 'alpha' | 'beta' | 'rc' | 'locked'; dismissAt?: string; message?: string };
+  /**
+   * v4.26.2 (#149; style inheritance fixed in v4.26.3): release-state
+   * banner. Shallow override (last defined wins); `false` suppresses a
+   * banner inherited from an earlier style.
+   */
+  readonly releaseStatus?: ReleaseStatusConfig | false;
 
   /**
    * Scoped consumer-side metadata. Ignored by the toolkit; survives composition
@@ -195,7 +199,8 @@ export function defineStyle(opts: StyleInput): Style {
  *   - Top-level `defineBookConfig` fields beat any style (handled in config.ts)
  *
  * Per-key merge strategy:
- *   - `preset`, `site`, `deploy`, `mdxComponentsModule`, `name` → shallow override (last wins)
+ *   - `preset`, `site`, `deploy`, `mdxComponentsModule`, `name`, `releaseStatus`
+ *     → shallow override (last defined wins; `releaseStatus: false` suppresses)
  *   - `routes` → per-route spread (each route key independently overridable)
  *   - `katexMacros` → per-macro spread (each macro key independently overridable)
  *   - `extra` → per-key spread (consumer metadata accumulates across the chain)
@@ -218,6 +223,9 @@ export function composeStyles(styles: readonly Style[]): Style {
     if (style.preset !== undefined) merged.preset = style.preset;
     if (style.site !== undefined) merged.site = style.site;
     if (style.deploy !== undefined) merged.deploy = style.deploy;
+    if (style.releaseStatus !== undefined) {
+      merged.releaseStatus = style.releaseStatus;
+    }
     if (style.mdxComponentsModule !== undefined) {
       merged.mdxComponentsModule = style.mdxComponentsModule;
     }