@brandon_m_behring/book-scaffold-astro 3.6.5 → 3.7.1

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AstroUserConfig, AstroIntegration } from 'astro';
-import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, E as volatilityLevels } from './types-DVbzso8w.js';
-export { A as AcademicChapter, B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, d as BookPreset, e as BookProfile, g as BookSchemasOptions, C as ChapterFor, h as CourseNotesChapter, M as MinimalChapter, P as ProfileDefinition, R as ResearchPortfolioChapter, i as RouteToggles, T as ToolsChapter, j as academicChapterSchema, k as academicParts, l as changeKinds, m as changelogSchema, n as chapterStatus, o as courseNotesChapterSchema, p as defineProfile, q as minimalChapterSchema, r as patternCategories, s as patternsSchema, t as researchPortfolioChapterSchema, u as resolvePreset, v as resolveProfile, w as sourceTiers, x as sourceTiersResearch, y as sourcesSchema, z as toolSlugs, D as toolsChapterSchema } from './types-DVbzso8w.js';
+import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, H as volatilityLevels, h as ChaptersRenderer } from './types-C5CamFM0.js';
+export { A as AcademicChapter, B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, d as BookPreset, e as BookProfile, g as BookSchemasOptions, C as ChapterFor, i as CourseNotesChapter, F as FreshnessAffordance, M as MinimalChapter, P as PartKey, j as ProfileDefinition, R as ResearchPortfolioChapter, k as RouteToggles, S as StatusBadge, T as ToolsChapter, V as VolatilityBadge, l as academicChapterSchema, m as academicParts, n as changeKinds, o as changelogSchema, p as chapterStatus, q as courseNotesChapterSchema, r as defineProfile, s as minimalChapterSchema, t as patternCategories, u as patternsSchema, v as researchPortfolioChapterSchema, w as resolvePreset, x as resolveProfile, y as sourceTiers, z as sourceTiersResearch, D as sourcesSchema, E as toolSlugs, G as toolsChapterSchema } from './types-C5CamFM0.js';
 import 'astro/zod';
 
 declare function defineBookConfig(opts: BookConfigOptions): Promise<AstroUserConfig>;
@@ -103,4 +103,44 @@ declare function freshnessLabel(f: Freshness | null): string;
  */
 declare function chapterSortKey(data: Record<string, unknown>): number;
 
-export { BookConfigOptions, BookScaffoldIntegrationOptions, type Freshness, type FreshnessStatus, type VolatilityLevel, bookScaffoldIntegration, chapterSortKey, defineBookConfig, defineMdxComponents, freshnessLabel, getFreshness, volatilityLevels };
+/**
+ * src/profiles/renderers/tools-chapters.ts — ChaptersRenderer implementation
+ * for the tools profile. Owns: numeric part grouping (with Appendix splitting
+ * at part >= 6), Chapter N numbering, volatility badge, freshness affordance
+ * from last_verified + volatility class, tools_compared tags.
+ *
+ * Mirrors the pre-v3.7.0 logic in pages/chapters.astro for tools-shape
+ * chapters — DOM output is intended to be byte-equivalent so the existing
+ * visual-regression baselines (package/tests/visual/fixture/) pass without
+ * recapture.
+ */
+
+declare const toolsChaptersRenderer: ChaptersRenderer;
+
+/**
+ * src/profiles/renderers/academic-chapters.ts — ChaptersRenderer implementation
+ * for the academic profile. Owns: string-enum part grouping (foundations,
+ * ssm-core, beyond-ssm, integration, synthesis), Week N numbering, status
+ * badge (7-state). No freshness/last_verified, no tools_compared.
+ *
+ * Mirrors the v3.5.2 academic branch of pages/chapters.astro — DOM output
+ * intended to match exactly so academic visual baselines stay stable.
+ */
+
+declare const academicChaptersRenderer: ChaptersRenderer;
+
+/**
+ * src/profiles/renderers/fallback-chapters.ts — ChaptersRenderer used by
+ * profiles that don't ship a dedicated renderer (minimal, course-notes,
+ * research-portfolio). Dispatches by field presence — exactly the v3.5.2
+ * logic that lived inline in pages/chapters.astro before #35.
+ *
+ * Safety net for shapes we haven't designed for explicitly. If a consumer
+ * opts a course-notes or research-portfolio book into `routes.chapters: true`,
+ * the fallback renders reasonably without crashing. Custom output for those
+ * profiles is a v4+ extension point (consumer-overridable renderer).
+ */
+
+declare const fallbackChaptersRenderer: ChaptersRenderer;
+
+export { BookConfigOptions, BookScaffoldIntegrationOptions, ChaptersRenderer, type Freshness, type FreshnessStatus, type VolatilityLevel, academicChaptersRenderer, bookScaffoldIntegration, chapterSortKey, defineBookConfig, defineMdxComponents, fallbackChaptersRenderer, freshnessLabel, getFreshness, toolsChaptersRenderer, volatilityLevels };

package/dist/index.mjs

@@ -307,6 +307,63 @@ var patternsSchema = z.object({
   convergence_date: z.date().nullable().optional()
 });
 
+// src/profiles/renderers/academic-chapters.ts
+var ACADEMIC_PART_ORDINAL = {
+  foundations: 1,
+  "ssm-core": 2,
+  "beyond-ssm": 3,
+  integration: 4,
+  synthesis: 5
+};
+var UNKNOWN_PART_ORDINAL = 99;
+function titleCase(part) {
+  return part.split("-").map((w) => w.length > 0 ? w.charAt(0).toUpperCase() + w.slice(1) : "").join(" ");
+}
+var academicChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? "";
+  },
+  formatPartLabel(part) {
+    if (typeof part === "string" && part.length > 0) {
+      return titleCase(part);
+    }
+    return String(part);
+  },
+  isAppendix(_part) {
+    return false;
+  },
+  formatChapterNumber(data, _appendix) {
+    const week = data.week ?? 0;
+    return `Week ${week}`;
+  },
+  getToolsAttr(_data) {
+    return "cross-tool";
+  },
+  getVolatilityData(_data) {
+    return null;
+  },
+  getStatusData(data) {
+    const status = data.status;
+    if (!status) return null;
+    return { status, label: status };
+  },
+  getFreshnessData(_data, _now) {
+    return null;
+  },
+  getVerifiedDateLabel(_data) {
+    return null;
+  },
+  getToolsCompared(_data) {
+    return [];
+  },
+  sortKey(data) {
+    const partRaw = data.part;
+    const partOrdinal = typeof partRaw === "string" ? ACADEMIC_PART_ORDINAL[partRaw] ?? UNKNOWN_PART_ORDINAL : typeof partRaw === "number" ? partRaw : UNKNOWN_PART_ORDINAL;
+    const week = typeof data.week === "number" ? data.week : 0;
+    return partOrdinal * 1e3 + week;
+  }
+};
+
 // src/profiles/academic.ts
 var academicProfile = defineProfile({
   name: "academic",
@@ -323,9 +380,104 @@ var academicProfile = defineProfile({
     // opt-in per book; see #7
   },
   styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
-  katex: true
+  katex: true,
+  chaptersRenderer: academicChaptersRenderer
+  // v3.7.0 (#35) — owns /chapters semantics if consumer opts in via routes.chapters
 });
 
+// src/lib/freshness.ts
+var THRESHOLDS = {
+  "stable-principle": 365,
+  "architectural-pattern": 180,
+  "feature-surface": 90
+};
+var MS_PER_DAY = 1e3 * 60 * 60 * 24;
+function getFreshness(lastVerified, volatility, now = /* @__PURE__ */ new Date()) {
+  if (!(lastVerified instanceof Date)) return null;
+  const thresholdDays = THRESHOLDS[volatility];
+  const daysOld = Math.floor((now.getTime() - lastVerified.getTime()) / MS_PER_DAY);
+  const daysUntil = thresholdDays - daysOld;
+  let status;
+  if (daysOld < thresholdDays * 0.75) {
+    status = "fresh";
+  } else if (daysOld < thresholdDays) {
+    status = "verify-soon";
+  } else {
+    status = "stale";
+  }
+  return { status, daysOld, thresholdDays, daysUntil };
+}
+function freshnessLabel(f) {
+  if (f === null) return "Verification status unknown";
+  switch (f.status) {
+    case "fresh":
+      return `Fresh (${f.daysOld}d old; verify within ${f.daysUntil}d)`;
+    case "verify-soon":
+      return `Verify soon (${f.daysOld}d old; ${f.daysUntil}d until stale)`;
+    case "stale":
+      return `Stale (${f.daysOld}d old; ${Math.abs(f.daysUntil)}d past threshold)`;
+  }
+}
+
+// src/profiles/renderers/tools-chapters.ts
+function formatDate(d) {
+  return d.toISOString().slice(0, 10);
+}
+var toolsChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? 0;
+  },
+  formatPartLabel(part) {
+    if (typeof part === "number") {
+      return part >= 6 ? "Appendices" : `Part ${part}`;
+    }
+    return String(part);
+  },
+  isAppendix(part) {
+    return typeof part === "number" && part >= 6;
+  },
+  formatChapterNumber(data, appendix) {
+    const chapter = data.chapter ?? 0;
+    if (appendix) {
+      return `Appendix ${String.fromCharCode(64 + chapter).toLowerCase()}`;
+    }
+    return `Chapter ${chapter}`;
+  },
+  getToolsAttr(data) {
+    const tools = data.tools_compared ?? [];
+    return tools.join(" ");
+  },
+  getVolatilityData(data) {
+    const level = data.volatility;
+    if (!level) return null;
+    return { level, label: level };
+  },
+  getStatusData(_data) {
+    return null;
+  },
+  getFreshnessData(data, now) {
+    const lastVerified = data.last_verified;
+    const volatility = data.volatility;
+    if (!lastVerified || !volatility) return null;
+    const f = getFreshness(lastVerified, volatility, now);
+    if (!f) return null;
+    return { status: f.status, label: freshnessLabel(f) };
+  },
+  getVerifiedDateLabel(data) {
+    const lastVerified = data.last_verified;
+    if (!(lastVerified instanceof Date)) return null;
+    return `verified ${formatDate(lastVerified)}`;
+  },
+  getToolsCompared(data) {
+    return (data.tools_compared ?? []).slice();
+  },
+  sortKey(data) {
+    const part = data.part ?? 0;
+    const chapter = data.chapter ?? 0;
+    return part * 1e3 + chapter;
+  }
+};
+
 // src/profiles/tools.ts
 var toolsProfile = defineProfile({
   name: "tools",
@@ -350,9 +502,62 @@ var toolsProfile = defineProfile({
     "print.css",
     "convergence.css",
     "tool-filter.css"
-  ]
+  ],
+  chaptersRenderer: toolsChaptersRenderer
+  // v3.7.0 (#35) — owns /chapters semantics for tools shape
 });
 
+// src/profiles/renderers/fallback-chapters.ts
+function isToolsShape(data) {
+  return "volatility" in data && "chapter" in data;
+}
+function isAcademicShape(data) {
+  return "week" in data && "status" in data;
+}
+function dispatch(data) {
+  if (isToolsShape(data)) return toolsChaptersRenderer;
+  if (isAcademicShape(data)) return academicChaptersRenderer;
+  return toolsChaptersRenderer;
+}
+var fallbackChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? 0;
+  },
+  formatPartLabel(part) {
+    if (typeof part === "number") {
+      return part >= 6 ? "Appendices" : `Part ${part}`;
+    }
+    return dispatch({ part }).formatPartLabel(part);
+  },
+  isAppendix(part) {
+    return typeof part === "number" && part >= 6;
+  },
+  formatChapterNumber(data, appendix) {
+    return dispatch(data).formatChapterNumber(data, appendix);
+  },
+  getToolsAttr(data) {
+    return dispatch(data).getToolsAttr(data);
+  },
+  getVolatilityData(data) {
+    return dispatch(data).getVolatilityData(data);
+  },
+  getStatusData(data) {
+    return dispatch(data).getStatusData(data);
+  },
+  getFreshnessData(data, now) {
+    return dispatch(data).getFreshnessData(data, now);
+  },
+  getVerifiedDateLabel(data) {
+    return dispatch(data).getVerifiedDateLabel(data);
+  },
+  getToolsCompared(data) {
+    return dispatch(data).getToolsCompared(data);
+  },
+  sortKey(data) {
+    return dispatch(data).sortKey(data);
+  }
+};
+
 // src/profiles/minimal.ts
 var minimalProfile = defineProfile({
   name: "minimal",
@@ -366,7 +571,9 @@ var minimalProfile = defineProfile({
     frontmatter: false
     // opt-in per book; see #7
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"]
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  // v3.7.0 (#35): minimal aliases tools schema; fallback renderer field-dispatches if a consumer opts into routes.chapters
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/course-notes.ts
@@ -383,7 +590,9 @@ var courseNotesProfile = defineProfile({
     frontmatter: false
     // opt-in per book; see #7
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"]
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  // v3.7.0 (#35): course-notes schema has tools-style fields (chapter, volatility, sources) — fallback renderer dispatches via tools renderer
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/research-portfolio.ts
@@ -402,8 +611,10 @@ var researchPortfolioProfile = defineProfile({
     // portfolios universally need title/disclosure/banner pages
   },
   styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
-  katex: true
+  katex: true,
   // math is common in research content
+  // v3.7.0 (#35): portfolio schema is a union of academic + tools shapes — fallback renderer dispatches per chapter via field presence
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/index.ts
@@ -576,9 +787,10 @@ function bookScaffoldIntegration(opts) {
 // src/config.ts
 async function defineBookConfig(opts) {
   const profile = resolvePreset(opts.preset, opts.profile);
+  const wantsKatex = PROFILES[profile]?.katex === true;
   const remarkPlugins = [];
   const rehypePlugins = [];
-  if (profile === "academic") {
+  if (wantsKatex) {
     const { default: remarkMath } = await import(
       /* @vite-ignore */
       "remark-math"
@@ -651,7 +863,7 @@ async function defineBookConfig(opts) {
   void _extraStyles;
   void _markdown;
   void _katexMacros;
-  const katexExternals = profile === "academic" ? [] : ["remark-math", "rehype-katex", "katex"];
+  const katexExternals = wantsKatex ? [] : ["remark-math", "rehype-katex", "katex"];
   const config = {
     ...rest,
     integrations,
@@ -668,52 +880,18 @@ async function defineBookConfig(opts) {
   return config;
 }
 
-// src/lib/freshness.ts
-var THRESHOLDS = {
-  "stable-principle": 365,
-  "architectural-pattern": 180,
-  "feature-surface": 90
-};
-var MS_PER_DAY = 1e3 * 60 * 60 * 24;
-function getFreshness(lastVerified, volatility, now = /* @__PURE__ */ new Date()) {
-  if (!(lastVerified instanceof Date)) return null;
-  const thresholdDays = THRESHOLDS[volatility];
-  const daysOld = Math.floor((now.getTime() - lastVerified.getTime()) / MS_PER_DAY);
-  const daysUntil = thresholdDays - daysOld;
-  let status;
-  if (daysOld < thresholdDays * 0.75) {
-    status = "fresh";
-  } else if (daysOld < thresholdDays) {
-    status = "verify-soon";
-  } else {
-    status = "stale";
-  }
-  return { status, daysOld, thresholdDays, daysUntil };
-}
-function freshnessLabel(f) {
-  if (f === null) return "Verification status unknown";
-  switch (f.status) {
-    case "fresh":
-      return `Fresh (${f.daysOld}d old; verify within ${f.daysUntil}d)`;
-    case "verify-soon":
-      return `Verify soon (${f.daysOld}d old; ${f.daysUntil}d until stale)`;
-    case "stale":
-      return `Stale (${f.daysOld}d old; ${Math.abs(f.daysUntil)}d past threshold)`;
-  }
-}
-
 // src/lib/chapter-sort.ts
-var ACADEMIC_PART_ORDINAL = {
+var ACADEMIC_PART_ORDINAL2 = {
   foundations: 1,
   "ssm-core": 2,
   "beyond-ssm": 3,
   integration: 4,
   synthesis: 5
 };
-var UNKNOWN_PART_ORDINAL = 99;
+var UNKNOWN_PART_ORDINAL2 = 99;
 function chapterSortKey(data) {
   const partRaw = data.part;
-  const partOrdinal = typeof partRaw === "number" ? partRaw : typeof partRaw === "string" ? ACADEMIC_PART_ORDINAL[partRaw] ?? UNKNOWN_PART_ORDINAL : UNKNOWN_PART_ORDINAL;
+  const partOrdinal = typeof partRaw === "number" ? partRaw : typeof partRaw === "string" ? ACADEMIC_PART_ORDINAL2[partRaw] ?? UNKNOWN_PART_ORDINAL2 : UNKNOWN_PART_ORDINAL2;
   const within = typeof data.chapter === "number" ? data.chapter : typeof data.week === "number" ? data.week : 0;
   return partOrdinal * 1e3 + within;
 }
@@ -722,6 +900,7 @@ export {
   BOOK_PROFILES,
   BookConfigError,
   academicChapterSchema,
+  academicChaptersRenderer,
   academicParts,
   bookScaffoldIntegration,
   changeKinds,
@@ -732,6 +911,7 @@ export {
   defineBookConfig,
   defineMdxComponents,
   defineProfile,
+  fallbackChaptersRenderer,
   freshnessLabel,
   getFreshness,
   minimalChapterSchema,
@@ -745,5 +925,6 @@ export {
   sourcesSchema,
   toolSlugs,
   toolsChapterSchema,
+  toolsChaptersRenderer,
   volatilityLevels
 };

package/dist/schemas.d.ts

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

package/dist/schemas.mjs

@@ -192,6 +192,63 @@ var patternsSchema = z.object({
   convergence_date: z.date().nullable().optional()
 });
 
+// src/profiles/renderers/academic-chapters.ts
+var ACADEMIC_PART_ORDINAL = {
+  foundations: 1,
+  "ssm-core": 2,
+  "beyond-ssm": 3,
+  integration: 4,
+  synthesis: 5
+};
+var UNKNOWN_PART_ORDINAL = 99;
+function titleCase(part) {
+  return part.split("-").map((w) => w.length > 0 ? w.charAt(0).toUpperCase() + w.slice(1) : "").join(" ");
+}
+var academicChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? "";
+  },
+  formatPartLabel(part) {
+    if (typeof part === "string" && part.length > 0) {
+      return titleCase(part);
+    }
+    return String(part);
+  },
+  isAppendix(_part) {
+    return false;
+  },
+  formatChapterNumber(data, _appendix) {
+    const week = data.week ?? 0;
+    return `Week ${week}`;
+  },
+  getToolsAttr(_data) {
+    return "cross-tool";
+  },
+  getVolatilityData(_data) {
+    return null;
+  },
+  getStatusData(data) {
+    const status = data.status;
+    if (!status) return null;
+    return { status, label: status };
+  },
+  getFreshnessData(_data, _now) {
+    return null;
+  },
+  getVerifiedDateLabel(_data) {
+    return null;
+  },
+  getToolsCompared(_data) {
+    return [];
+  },
+  sortKey(data) {
+    const partRaw = data.part;
+    const partOrdinal = typeof partRaw === "string" ? ACADEMIC_PART_ORDINAL[partRaw] ?? UNKNOWN_PART_ORDINAL : typeof partRaw === "number" ? partRaw : UNKNOWN_PART_ORDINAL;
+    const week = typeof data.week === "number" ? data.week : 0;
+    return partOrdinal * 1e3 + week;
+  }
+};
+
 // src/profiles/academic.ts
 var academicProfile = defineProfile({
   name: "academic",
@@ -208,9 +265,104 @@ var academicProfile = defineProfile({
     // opt-in per book; see #7
   },
   styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
-  katex: true
+  katex: true,
+  chaptersRenderer: academicChaptersRenderer
+  // v3.7.0 (#35) — owns /chapters semantics if consumer opts in via routes.chapters
 });
 
+// src/lib/freshness.ts
+var THRESHOLDS = {
+  "stable-principle": 365,
+  "architectural-pattern": 180,
+  "feature-surface": 90
+};
+var MS_PER_DAY = 1e3 * 60 * 60 * 24;
+function getFreshness(lastVerified, volatility, now = /* @__PURE__ */ new Date()) {
+  if (!(lastVerified instanceof Date)) return null;
+  const thresholdDays = THRESHOLDS[volatility];
+  const daysOld = Math.floor((now.getTime() - lastVerified.getTime()) / MS_PER_DAY);
+  const daysUntil = thresholdDays - daysOld;
+  let status;
+  if (daysOld < thresholdDays * 0.75) {
+    status = "fresh";
+  } else if (daysOld < thresholdDays) {
+    status = "verify-soon";
+  } else {
+    status = "stale";
+  }
+  return { status, daysOld, thresholdDays, daysUntil };
+}
+function freshnessLabel(f) {
+  if (f === null) return "Verification status unknown";
+  switch (f.status) {
+    case "fresh":
+      return `Fresh (${f.daysOld}d old; verify within ${f.daysUntil}d)`;
+    case "verify-soon":
+      return `Verify soon (${f.daysOld}d old; ${f.daysUntil}d until stale)`;
+    case "stale":
+      return `Stale (${f.daysOld}d old; ${Math.abs(f.daysUntil)}d past threshold)`;
+  }
+}
+
+// src/profiles/renderers/tools-chapters.ts
+function formatDate(d) {
+  return d.toISOString().slice(0, 10);
+}
+var toolsChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? 0;
+  },
+  formatPartLabel(part) {
+    if (typeof part === "number") {
+      return part >= 6 ? "Appendices" : `Part ${part}`;
+    }
+    return String(part);
+  },
+  isAppendix(part) {
+    return typeof part === "number" && part >= 6;
+  },
+  formatChapterNumber(data, appendix) {
+    const chapter = data.chapter ?? 0;
+    if (appendix) {
+      return `Appendix ${String.fromCharCode(64 + chapter).toLowerCase()}`;
+    }
+    return `Chapter ${chapter}`;
+  },
+  getToolsAttr(data) {
+    const tools = data.tools_compared ?? [];
+    return tools.join(" ");
+  },
+  getVolatilityData(data) {
+    const level = data.volatility;
+    if (!level) return null;
+    return { level, label: level };
+  },
+  getStatusData(_data) {
+    return null;
+  },
+  getFreshnessData(data, now) {
+    const lastVerified = data.last_verified;
+    const volatility = data.volatility;
+    if (!lastVerified || !volatility) return null;
+    const f = getFreshness(lastVerified, volatility, now);
+    if (!f) return null;
+    return { status: f.status, label: freshnessLabel(f) };
+  },
+  getVerifiedDateLabel(data) {
+    const lastVerified = data.last_verified;
+    if (!(lastVerified instanceof Date)) return null;
+    return `verified ${formatDate(lastVerified)}`;
+  },
+  getToolsCompared(data) {
+    return (data.tools_compared ?? []).slice();
+  },
+  sortKey(data) {
+    const part = data.part ?? 0;
+    const chapter = data.chapter ?? 0;
+    return part * 1e3 + chapter;
+  }
+};
+
 // src/profiles/tools.ts
 var toolsProfile = defineProfile({
   name: "tools",
@@ -235,9 +387,62 @@ var toolsProfile = defineProfile({
     "print.css",
     "convergence.css",
     "tool-filter.css"
-  ]
+  ],
+  chaptersRenderer: toolsChaptersRenderer
+  // v3.7.0 (#35) — owns /chapters semantics for tools shape
 });
 
+// src/profiles/renderers/fallback-chapters.ts
+function isToolsShape(data) {
+  return "volatility" in data && "chapter" in data;
+}
+function isAcademicShape(data) {
+  return "week" in data && "status" in data;
+}
+function dispatch(data) {
+  if (isToolsShape(data)) return toolsChaptersRenderer;
+  if (isAcademicShape(data)) return academicChaptersRenderer;
+  return toolsChaptersRenderer;
+}
+var fallbackChaptersRenderer = {
+  partKey(data) {
+    return data.part ?? 0;
+  },
+  formatPartLabel(part) {
+    if (typeof part === "number") {
+      return part >= 6 ? "Appendices" : `Part ${part}`;
+    }
+    return dispatch({ part }).formatPartLabel(part);
+  },
+  isAppendix(part) {
+    return typeof part === "number" && part >= 6;
+  },
+  formatChapterNumber(data, appendix) {
+    return dispatch(data).formatChapterNumber(data, appendix);
+  },
+  getToolsAttr(data) {
+    return dispatch(data).getToolsAttr(data);
+  },
+  getVolatilityData(data) {
+    return dispatch(data).getVolatilityData(data);
+  },
+  getStatusData(data) {
+    return dispatch(data).getStatusData(data);
+  },
+  getFreshnessData(data, now) {
+    return dispatch(data).getFreshnessData(data, now);
+  },
+  getVerifiedDateLabel(data) {
+    return dispatch(data).getVerifiedDateLabel(data);
+  },
+  getToolsCompared(data) {
+    return dispatch(data).getToolsCompared(data);
+  },
+  sortKey(data) {
+    return dispatch(data).sortKey(data);
+  }
+};
+
 // src/profiles/minimal.ts
 var minimalProfile = defineProfile({
   name: "minimal",
@@ -251,7 +456,9 @@ var minimalProfile = defineProfile({
     frontmatter: false
     // opt-in per book; see #7
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"]
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  // v3.7.0 (#35): minimal aliases tools schema; fallback renderer field-dispatches if a consumer opts into routes.chapters
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/course-notes.ts
@@ -268,7 +475,9 @@ var courseNotesProfile = defineProfile({
     frontmatter: false
     // opt-in per book; see #7
   },
-  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"]
+  styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
+  // v3.7.0 (#35): course-notes schema has tools-style fields (chapter, volatility, sources) — fallback renderer dispatches via tools renderer
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/research-portfolio.ts
@@ -287,8 +496,10 @@ var researchPortfolioProfile = defineProfile({
     // portfolios universally need title/disclosure/banner pages
   },
   styles: ["tokens.css", "layout.css", "callouts.css", "chapter.css", "typography.css", "print.css"],
-  katex: true
+  katex: true,
   // math is common in research content
+  // v3.7.0 (#35): portfolio schema is a union of academic + tools shapes — fallback renderer dispatches per chapter via field presence
+  chaptersRenderer: fallbackChaptersRenderer
 });
 
 // src/profiles/index.ts