@brandon_m_behring/book-scaffold-astro 3.0.1 → 3.2.0

package/components/ChapterHeader.astro

@@ -6,14 +6,23 @@
  * tools), so this component renders only the fields that are present on
  * the chapter data. Tools-profile metadata (volatility, last_verified,
  * tools_compared) appears when defined; academic-profile metadata (week,
- * status) appears in its place.
+ * part, status, companion artifacts) appears in its place.
  *
- * Use a chapter card's metadata to calibrate how much trust to place in
- * its specific claims — stable principles age slowly; feature surfaces
- * age fast.
+ * v3.1.0 — academic flavor: Roman-numeral part labels, StatusBadge
+ * component, and an optional companion-artifacts block.
+ *
+ * v3.2.0 — companions refactored from sibling <aside> to inline <span>
+ * elements inside the existing .chapter-meta flex row. v3.1.0 shipped
+ * <aside class="chapter-companions"> with no CSS; UA-default <ul> block
+ * layout added ~100px height at <=1280px, producing a uniform vertical
+ * pixel shift on all academic chapters. Inline rendering eliminates the
+ * extra block by construction. The data-companion attribute on each
+ * inline span preserves introspection.
  */
 import type { CollectionEntry } from 'astro:content';
 import { getFreshness, freshnessLabel } from '../src/lib/freshness';
+import StatusBadge from './StatusBadge.astro';
+import CodeRef from './CodeRef.astro';
 
 interface Props {
   data: CollectionEntry<'chapters'>['data'];
@@ -51,9 +60,24 @@ const freshnessText = freshness
       : 'Stale'
   : null;
 
+// Academic-profile part labels (Roman-numeral · descriptive name).
+// v2.0 post_transformers used this exact mapping; verbatim restore here so
+// the header content density matches at narrow viewports. Keys mirror
+// `academicParts` enum from src/schemas.ts.
+const ACADEMIC_PART_LABELS: Record<string, string> = {
+  foundations: 'Part I · Foundations',
+  'ssm-core': 'Part II · SSM Core',
+  'beyond-ssm': 'Part III · Beyond SSMs',
+  integration: 'Part IV · Integration',
+  synthesis: 'Part V · Synthesis',
+};
+
 // Display strings, profile-tagged for clarity in markup.
 const partLabel = (() => {
   const p = d.part;
+  if (hasAcademicMeta && typeof p === 'string' && p in ACADEMIC_PART_LABELS) {
+    return ACADEMIC_PART_LABELS[p];
+  }
   if (typeof p === 'number') return `Part ${p}`;
   if (typeof p === 'string' && p.length > 0) return `Part: ${p}`;
   return null;
@@ -61,8 +85,6 @@ const partLabel = (() => {
 const chapterNum =
   typeof d.chapter === 'number' ? `Chapter ${d.chapter}` : null;
 const weekNum = typeof d.week === 'number' ? `Week ${d.week}` : null;
-const statusBadge =
-  typeof d.status === 'string' ? d.status.replace(/_/g, ' ') : null;
 const title = typeof d.title === 'string' ? d.title : '(untitled)';
 const description = typeof d.description === 'string' ? d.description : null;
 const toolsCompared = Array.isArray(d.tools_compared)
@@ -71,16 +93,31 @@ const toolsCompared = Array.isArray(d.tools_compared)
 const lastVerified = d.last_verified instanceof Date ? d.last_verified : null;
 const updated = d.updated instanceof Date ? d.updated : null;
 const volatility = typeof d.volatility === 'string' ? d.volatility : null;
+
+// Academic companion artifacts. Notebook source path is transformed via
+// generic basename strip so any book whose render-notebooks output lands
+// under public/notebooks/ gets a correct deep link (v2.0 hardcoded a
+// post_transformers-specific prefix; v3.1.0 generalizes).
+//
+// v3.2.0: each companion renders as an inline <span class="chapter-companion">
+// inside .chapter-meta — no sibling <aside>, no <ul>, no "Companion artifacts:"
+// label. Zero added vertical height vs v2.0.
+const codePath = hasAcademicMeta && typeof d.code_path === 'string' ? d.code_path : null;
+const testsPath = hasAcademicMeta && typeof d.tests_path === 'string' ? d.tests_path : null;
+const notebookHtmlPath =
+  hasAcademicMeta && typeof d.notebook_path === 'string'
+    ? `/notebooks/${(d.notebook_path as string)
+        .replace(/^.*\//, '')
+        .replace(/\.ipynb$/, '')}.html`
+    : null;
 ---
 <header class="chapter-header">
   <div class="chapter-meta">
-    {partLabel && <span>{partLabel}</span>}
+    {partLabel && <span class="chapter-part">{partLabel}</span>}
     {chapterNum && <span>{chapterNum}</span>}
-    {weekNum && <span>{weekNum}</span>}
-    {statusBadge && (
-      <span class="status-badge" data-status={d.status as string}>
-        {statusBadge}
-      </span>
+    {weekNum && <span class="chapter-week">{weekNum}</span>}
+    {hasAcademicMeta && typeof d.status === 'string' && (
+      <StatusBadge status={d.status as never} />
     )}
     {lastVerified && (
       <span>
@@ -96,9 +133,25 @@ const volatility = typeof d.volatility === 'string' ? d.volatility : null;
       </span>
     )}
     {updated && <span>Updated {formatDate(updated)}</span>}
+    {codePath && (
+      <span class="chapter-companion" data-companion="code">
+        <CodeRef path={codePath} />
+      </span>
+    )}
+    {testsPath && (
+      <span class="chapter-companion" data-companion="tests">
+        <CodeRef path={testsPath} />
+      </span>
+    )}
+    {notebookHtmlPath && (
+      <span class="chapter-companion" data-companion="notebook">
+        <a href={notebookHtmlPath}>Notebook</a>
+      </span>
+    )}
   </div>
   <h1>{title}</h1>
   {description && <p class="chapter-description">{description}</p>}
+
   {hasToolsMeta && volatility && (
     <div class="chapter-badge-row">
       <span class="chapter-badge-row-label">Volatility:</span>

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

package/styles/chapter.css

@@ -38,6 +38,29 @@
   font-size: 0.75em;
 }
 
+/* Inline companion-artifact chips inside .chapter-meta.
+ * v3.2.0: structural inline rendering. Previous v3.1.0 emitted a sibling
+ * <aside class="chapter-companions"><ul>...</ul></aside> with no CSS
+ * coverage; UA-default block layout added ~100px height at <=1280px,
+ * producing a uniform vertical pixel shift on academic chapter pages
+ * vs the v2.0 baseline. The inline span here adds zero block height by
+ * construction; styling matches the surrounding .chapter-meta spans. */
+.chapter-companion {
+  font-family: var(--font-code);
+  font-size: var(--text-sm);
+  color: var(--color-text-muted);
+}
+.chapter-companion a,
+.chapter-companion code {
+  color: inherit;
+  text-decoration: none;
+  border-bottom: 1px dotted var(--color-border);
+}
+.chapter-companion a:hover {
+  color: var(--color-link);
+  border-bottom-style: solid;
+}
+
 /* Volatility + tool badges: reuse .tool-badge from callouts.css */
 .volatility-badge {
   display: inline-block;