@brandon_m_behring/book-scaffold-astro 4.1.2 → 4.3.0

package/recipes/16-tikz-figures.md

@@ -0,0 +1,102 @@
+# Recipe 16 — TikZ figures (v4.2.0+)
+
+`book-scaffold build-figures` (v4.2.0+) auto-compiles TikZ standalone `.tex` sources to PDF via `pdflatex`, then converts the PDF to SVG via the existing pdf2svg pipeline. Closes [#17](https://github.com/brandon-behring/book-scaffold-astro/issues/17).
+
+## TL;DR
+
+Drop `figures/<topic>/diagram.tex` (standalone TikZ source). Run `npm run build:figures` (or it's wired into `prebuild`). Get `public/figures/<topic>/diagram.svg` ready to reference in MDX as `<Figure src="/figures/<topic>/diagram.svg" />`.
+
+## The TikZ source
+
+Use the `standalone` document class; configure for SVG via `tikz` option. Recommended:
+
+```latex
+\documentclass[tikz,border=2mm]{standalone}
+\usepackage{tikz}
+\usetikzlibrary{positioning, shapes, arrows}  % whichever libraries you need
+\begin{document}
+\begin{tikzpicture}
+  \node (a) at (0,0) {Hello};
+  \node (b) at (3,0) {World};
+  \draw[->] (a) -- (b);
+\end{tikzpicture}
+\end{document}
+```
+
+The `border=2mm` adds a small margin around the figure so it doesn't crop right at the edge.
+
+## Discovery rule
+
+`build-figures` walks `figures/` (or `BOOK_FIGURES_PATH`) for both `.pdf` and `.tex` files. For each `.tex` source:
+
+- If no sibling `.pdf` exists → compile.
+- If `.pdf` exists but `.tex` is newer → recompile.
+- If `.pdf` is newer than (or equal in mtime to) `.tex` → skip (use the existing PDF).
+
+This means consumers who ship pre-compiled `.pdf` figures alongside their `.tex` sources don't pay the compilation cost on every build.
+
+## Working directory
+
+`pdflatex` runs in `figures/<topic>/` (the directory containing the source). This makes TikZ `\input{}` relative paths work correctly and keeps intermediate files (`.aux`, `.log`) alongside the source for easy debugging.
+
+## Gitignore intermediate files
+
+Add to your project's `.gitignore`:
+
+```gitignore
+figures/**/*.aux
+figures/**/*.log
+figures/**/*.fdb_latexmk
+figures/**/*.fls
+figures/**/*.synctex.gz
+```
+
+The intermediate `.pdf` files generated from `.tex` SHOULD be committed — they let consumers without TeX Live still see your figures (the SVGs still get generated from the committed PDFs).
+
+## Required: TeX Live install
+
+`pdflatex` is a system dependency (not an npm package). Install:
+
+- **macOS**: `brew install --cask mactex` (full) or `brew install --cask basictex` (minimal — add packages via `tlmgr`)
+- **Ubuntu/Debian**: `sudo apt-get install texlive-base texlive-pictures` (minimal for TikZ)
+- **Other**: https://www.tug.org/texlive/
+
+If `pdflatex` is missing but `.tex` files are present, `build-figures` prints a clear ERROR with the install link and continues processing any `.pdf`-only topics. Doesn't crash the build.
+
+## CI workflow note
+
+If your CI builds rely on regenerating SVGs from `.tex` sources (rather than just serving committed SVGs), add TeX Live to your CI workflow:
+
+```yaml
+- name: Install TeX Live for TikZ figures
+  run: sudo apt-get install -y texlive-base texlive-pictures
+```
+
+This adds ~200 MB to the runner — only do it if your figures actually change between commits. The recommended pattern is to commit both `.tex` AND the generated `.pdf`/`.svg`, treating regeneration as a local-dev concern.
+
+## Debugging compilation failures
+
+When pdflatex fails on a `.tex` source, `build-figures` prints the stderr (and falls back to stdout) and continues with the remaining figures. Don't fail the whole build for one broken figure.
+
+To debug interactively:
+
+```bash
+cd figures/<topic>/
+pdflatex diagram.tex
+# read diagram.log for the full error trace
+```
+
+Common failures:
+- **Missing package**: `! LaTeX Error: File 'tikz-cd.sty' not found.` → install with `tlmgr install tikz-cd` (macOS/Linux Tex Live) or `sudo apt-get install texlive-tikz-cd` (Debian).
+- **Syntax error**: `! Undefined control sequence.` → check the `.log` file for the line number.
+- **Compilation hang**: should auto-resolve via `-halt-on-error -interaction=nonstopmode` flags the scaffold uses.
+
+## Feedback loop
+
+If you hit friction with the TikZ pipeline (a TikZ feature that doesn't compile, an obscure error message, a workflow pattern that doesn't fit), file an issue at https://github.com/brandon-behring/book-scaffold-astro/issues with the `consumer:<your-workspace>` label. v4.x is the iteration window.
+
+## See also
+
+- `recipes/06-figures.md` — overall figure pipeline + matplotlib/svg sources
+- `PACKAGE_DESIGN.md §7` — peer dependencies (lists `pdflatex` as optional system dep)
+- `PACKAGE_DESIGN.md §8` — `book-scaffold` CLI reference (build-figures subcommand)

package/recipes/17-draft-chapter-workflow.md

@@ -0,0 +1,88 @@
+# Recipe 17 — Draft chapter workflow (v4.3.0+)
+
+The scaffold ships a `draft: boolean` field on every chapter schema (default `false`). Chapters with `draft: true` are filtered out by the canonical chapter-list and per-chapter routes — they exist in `src/content/chapters/` but don't render. Closes [#68](https://github.com/brandon-behring/2-scaffold-astro/issues/68).
+
+## TL;DR
+
+```yaml
+---
+title: "My in-progress chapter"
+week: 4
+part: foundations
+status: scaffolded
+draft: true   # ← Chapter is invisible while draft: true. Flip to false to publish.
+---
+```
+
+## The filter
+
+Both the scaffold-injected `/chapters/` index AND the auto-injected per-chapter route `/chapters/[...slug]/` (new in v4.3.0; see [#69](https://github.com/brandon-behring/2-scaffold-astro/issues/69)) filter via:
+
+```ts
+await getCollection('chapters', (entry) => !entry.data.draft);
+```
+
+So a `draft: true` chapter:
+- Does **not** appear in `/chapters/`
+- Does **not** get a `/chapters/<slug>/` route
+- Does **not** appear in nav / TOC
+- DOES exist in the source tree (still validated by `book-scaffold validate`; still scanned by `book-scaffold build-labels`)
+
+This is by design: keeps in-progress work under version control without polluting the production build.
+
+## Schema definition
+
+All 5 built-in chapter schemas define `draft`:
+
+```ts
+// package/src/schemas.ts (academic + tools + minimal + course-notes + research-portfolio)
+draft: z.boolean().default(false),
+```
+
+The default is `false` — chapters publish by default. Authors flip to `true` to hide a work-in-progress.
+
+## When to use draft
+
+- **Active drafting** — writing a chapter over multiple sessions; don't want intermediate states deployed.
+- **Outline-stage chapters** — frontmatter exists but body is just a TODO list.
+- **Migration in progress** — porting from another source format (LaTeX, Docs, etc.); keep the partial port in-tree but invisible.
+
+When you're ready to publish, edit the frontmatter to `draft: false` (or delete the line — default is false).
+
+## When NOT to use draft
+
+- **Deleting a chapter** — if you no longer want it at all, delete the file. `draft: true` is for chapters that ARE coming back to live.
+- **Reordering** — `draft` doesn't affect chapter ordering. To rearrange chapters, edit the `week:` / `part:` / `chapter:` frontmatter fields (the field varies by preset).
+- **Section-level hiding** — `draft` is whole-chapter only. To hide a section within a published chapter, comment it out in MDX or use a build-time conditional.
+
+## Previewing draft chapters during development
+
+The default canonical filter excludes drafts in BOTH `npm run dev` and `npm run build`. To preview a draft locally without publishing it:
+
+**Option A** (transient): temporarily flip the chapter to `draft: false`, run `npm run dev`, then flip back before committing.
+
+**Option B** (recommended): scope the filter to honor an env var in your `src/pages/chapters/[...slug].astro` (only relevant if you've ejected from the scaffold's auto-injected route):
+
+```ts
+const includeDrafts = import.meta.env.BOOK_INCLUDE_DRAFTS === '1';
+const chapters = await getCollection('chapters', (entry) =>
+  includeDrafts || !entry.data.draft
+);
+```
+
+Then run `BOOK_INCLUDE_DRAFTS=1 npm run dev` for the draft-inclusive preview. This is NOT shipped in the scaffold's auto-route (would muddy the production behavior); add it to a consumer-owned override file if you need it.
+
+## Common gotchas
+
+- **Silent zero-chapters build** — if EVERY chapter has `draft: true` (or no chapters are published yet), `/chapters/` renders an empty list and no `/chapters/<slug>/` routes generate. Build succeeds with no warnings. Diagnosis: check `npx book-scaffold validate` output — it reports the total `chapter(s) checked` regardless of draft status, so you'll see "5 chapter(s) checked" even when no chapters render.
+- **Author's intent vs filter behavior** — early Phase-1 chapter authoring sessions sometimes catch this: chapter is fully written, frontmatter looks right, but it doesn't render. First check: `grep '^draft:' src/content/chapters/*.mdx` to find drafts. Time-to-diagnosis tax averages ~20 min per consumer per session until they remember the filter exists. This recipe is the discoverability fix.
+
+## See also
+
+- `recipes/01-create-book.md` — full scaffold getting-started flow
+- `recipes/09-validation.md` — `book-scaffold validate` semantics (which DON'T honor the draft filter)
+- `PACKAGE_DESIGN.md §5` — `defineBookSchemas` API (where the draft field lives)
+
+## Feedback
+
+If the filter behavior surprises you in a new way or you want a different draft-preview UX (e.g., a `BOOK_INCLUDE_DRAFTS` env in the scaffold's auto-route by default), file an issue at https://github.com/brandon-behring/book-scaffold-astro/issues with the `consumer:<workspace>` label.

package/scripts/build-figures.mjs

@@ -6,6 +6,13 @@
  * pdftocairo, emitting under public/figures/. SVG preserves zoom/quality
  * and stays small for matplotlib-style plots.
  *
+ * v4.2.0 (closes #17): TikZ standalone `.tex` sources are auto-compiled
+ * to `.pdf` via pdflatex before the existing PDF→SVG pass runs. Discovery
+ * rule: if `figures/<topic>/<name>.tex` exists AND no sibling `.pdf`
+ * (or `.tex` is newer than `.pdf`), pdflatex runs. Graceful skip when
+ * pdflatex is not on PATH (only emits ERROR if .tex sources exist).
+ * See recipes/16-tikz-figures.md for the workflow + install pointers.
+ *
  * Default source: figures/ at scaffold root. Override via BOOK_FIGURES_PATH
  * env var (absolute path or path relative to scaffold root) — useful for
  * books that share figures with a LaTeX sibling at e.g. ../shared/figures/.
@@ -98,6 +105,55 @@ async function listPdfsRecursive(root, prefix = '') {
   return out;
 }
 
+/**
+ * v4.2.0 (#17): recursively collect .tex sources under FIGURES_SRC.
+ * Same shape as listPdfsRecursive but for `.tex` extension. TikZ
+ * standalone files at any subdirectory depth are picked up.
+ */
+async function listTexRecursive(root, prefix = '') {
+  if (!existsSync(root)) return [];
+  const entries = await readdir(root, { withFileTypes: true });
+  const out = [];
+  for (const entry of entries) {
+    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      out.push(...(await listTexRecursive(resolve(root, entry.name), relPath)));
+    } else if (entry.isFile() && entry.name.endsWith('.tex')) {
+      out.push({ relPath });
+    }
+  }
+  return out;
+}
+
+/**
+ * v4.2.0 (#17): compile a TikZ standalone .tex to .pdf via pdflatex.
+ * Run in the source directory so TikZ \input{} relative paths resolve
+ * + intermediate .aux/.log files land alongside the source.
+ * Returns true on success; throws Error with stderr on failure.
+ */
+function compileTikz(srcPath) {
+  const srcDir = dirname(srcPath);
+  const srcName = basename(srcPath);
+  const r = spawnSync(
+    'pdflatex',
+    [
+      '-halt-on-error',
+      '-interaction=nonstopmode',
+      '-output-directory=.',
+      srcName,
+    ],
+    { cwd: srcDir, stdio: 'pipe' },
+  );
+  if (r.status !== 0) {
+    const stderr = (r.stderr ?? Buffer.from('')).toString().trim();
+    const stdout = (r.stdout ?? Buffer.from('')).toString().trim();
+    throw new Error(
+      `pdflatex failed for ${srcPath}: ${stderr || stdout || `exit code ${r.status}`}`,
+    );
+  }
+  return true;
+}
+
 function isUpToDate(srcPath, dstPath) {
   if (!existsSync(dstPath)) return false;
   const srcMtime = statSync(srcPath).mtimeMs;
@@ -153,6 +209,38 @@ async function main() {
     return;
   }
 
+  // v4.2.0 (#17): stage 1 — compile any TikZ standalone .tex sources to .pdf
+  // BEFORE the PDF→SVG loop. Topic-walk discovers .tex files; compiles those
+  // where no sibling .pdf exists OR .tex is newer than .pdf.
+  const texSources = await listTexRecursive(FIGURES_SRC);
+  let tikzCompiled = 0;
+  if (texSources.length > 0) {
+    if (!check('pdflatex')) {
+      console.error(
+        `build-figures: pdflatex not on $PATH but ${texSources.length} ` +
+          `.tex source(s) detected. Install TeX Live to enable TikZ ` +
+          `compilation (see https://www.tug.org/texlive/). Skipping ` +
+          `.tex sources; pre-compiled .pdf siblings (if any) will still ` +
+          `be converted to SVG.`,
+      );
+    } else {
+      for (const { relPath } of texSources) {
+        const srcPath = resolve(FIGURES_SRC, relPath);
+        const pdfPath = srcPath.replace(/\.tex$/, '.pdf');
+        if (existsSync(pdfPath) && statSync(pdfPath).mtimeMs >= statSync(srcPath).mtimeMs) {
+          continue; // pdf is up-to-date
+        }
+        try {
+          compileTikz(srcPath);
+          tikzCompiled++;
+        } catch (err) {
+          console.error(`build-figures: ${err.message ?? err}`);
+          // Continue — don't fail the whole build on one broken .tex file.
+        }
+      }
+    }
+  }
+
   const pdfs = await listPdfsRecursive(FIGURES_SRC);
   if (pdfs.length === 0) {
     console.log('build-figures: no PDFs found; nothing to do.');
@@ -185,9 +273,10 @@ async function main() {
     converted++;
   }
 
+  const tikzNote = tikzCompiled > 0 ? `, ${tikzCompiled} tikz→pdf` : '';
   console.log(
     `build-figures: ${total} total, ${converted} converted ` +
-      `(${pngFallback} png fallback), ${skipped} cached`,
+      `(${pngFallback} png fallback), ${skipped} cached${tikzNote}`,
   );
 }
 

package/scripts/build-tips.mjs

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * scripts/build-tips.mjs — emit src/data/tips.json from <Tip> instances
+ * in chapter MDX (v4.3.0, closes #70).
+ *
+ * Scans `src/content/chapters/**\/*.mdx` (honoring loader.base via
+ * readChaptersBase from walk-mdx.mjs — same path-resolution as build-labels +
+ * validate). Extracts `<Tip n="N" title="T">body</Tip>` occurrences via regex
+ * (same approach as build-labels.mjs LABELABLE_TYPES extraction). Emits an
+ * array sorted by n.
+ *
+ * Output shape:
+ *   [
+ *     { "n": 1, "title": "...", "chapter": "ch-slug", "preview": "first 80 chars" },
+ *     ...
+ *   ]
+ *
+ * Graceful no-op: if no <Tip> instances exist, writes [] (doesn't fail
+ * builds for consumers who don't use the feature).
+ *
+ * Run on `prebuild` via the consumer's package.json. Doesn't depend on
+ * Astro virtual modules — pure regex + Node fs.
+ */
+import { writeFile, mkdir, readFile } from 'node:fs/promises';
+import { resolve, dirname, basename } from 'node:path';
+import { walkMdx, readChaptersBase } from './walk-mdx.mjs';
+
+const USAGE = `Usage: book-scaffold build-tips
+
+Scan chapter MDX for <Tip n="N" title="T">body</Tip> occurrences; emit
+src/data/tips.json sorted by n. Used by the /tips auto-route + <TipsCard>
+component when routes.tips: true.
+
+Env:
+  BOOK_CHAPTERS_DIR   Override chapters dir (default: src/content/chapters).
+  BOOK_TIPS_OUT       Override output path (default: src/data/tips.json).
+
+Options:
+  --help, -h          Print this message and exit (non-mutating).
+`;
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  process.stdout.write(USAGE);
+  process.exit(0);
+}
+
+const CWD = process.cwd();
+const CHAPTERS_DIR = await readChaptersBase(CWD);
+const OUTPUT_PATH = process.env.BOOK_TIPS_OUT ?? 'src/data/tips.json';
+
+/**
+ * Extract <Tip n="..." title="..."> tags and their body content from MDX.
+ *
+ * Regex captures:
+ *   - n: the tip number (string; coerced to int when writing JSON)
+ *   - title: the tip title (string)
+ *   - body: text between opening + closing tags
+ *
+ * Limitations (deliberate, documented):
+ *   - Doesn't handle nested <Tip> tags (no real use case)
+ *   - String attributes must use single OR double quotes (not template literals)
+ *   - title may not contain a literal quote of the same type used as delimiter
+ *     (escaping isn't supported)
+ *   - body is captured raw; first 80 chars (ignoring leading whitespace) used as preview
+ */
+function extractTips(source, chapterSlug) {
+  const tips = [];
+  // Two-branch alternation (single OR double quotes), no backreference —
+  // same portability pattern as readChaptersBase regex (v4.1.2 lesson).
+  const re = new RegExp(
+    [
+      // double-quoted attrs
+      `<Tip\\s+n="([^"]+)"\\s+title="([^"]+)"\\s*>([\\s\\S]*?)</Tip>`,
+      // single-quoted attrs
+      `<Tip\\s+n='([^']+)'\\s+title='([^']+)'\\s*>([\\s\\S]*?)</Tip>`,
+      // mixed (n double, title single) — rare but support it
+      `<Tip\\s+n="([^"]+)"\\s+title='([^']+)'\\s*>([\\s\\S]*?)</Tip>`,
+      // mixed (n single, title double)
+      `<Tip\\s+n='([^']+)'\\s+title="([^"]+)"\\s*>([\\s\\S]*?)</Tip>`,
+    ].join('|'),
+    'g',
+  );
+  for (const match of source.matchAll(re)) {
+    // One of the 4 alternation branches matched; locate captures.
+    const [, n1, t1, b1, n2, t2, b2, n3, t3, b3, n4, t4, b4] = match;
+    const n = n1 || n2 || n3 || n4;
+    const title = t1 || t2 || t3 || t4;
+    const body = b1 || b2 || b3 || b4 || '';
+    if (!n || !title) continue;
+    const nNum = Number.parseInt(n, 10);
+    if (!Number.isFinite(nNum)) continue;
+    const preview = body
+      .trim()
+      .replace(/\s+/g, ' ')
+      .slice(0, 80);
+    tips.push({
+      n: nNum,
+      title,
+      chapter: chapterSlug,
+      preview,
+    });
+  }
+  return tips;
+}
+
+async function main() {
+  const allTips = [];
+  for await (const rel of walkMdx(CHAPTERS_DIR)) {
+    const chapterPath = resolve(CHAPTERS_DIR, rel);
+    const chapterSlug = basename(rel).replace(/\.mdx?$/, '');
+    let source;
+    try {
+      source = await readFile(chapterPath, 'utf8');
+    } catch {
+      continue;
+    }
+    allTips.push(...extractTips(source, chapterSlug));
+  }
+
+  // Sort by n; warn on duplicates (don't fail — the index page just shows duplicates).
+  allTips.sort((a, b) => a.n - b.n);
+  const seenN = new Set();
+  for (const tip of allTips) {
+    if (seenN.has(tip.n)) {
+      process.stderr.write(`build-tips: WARN duplicate Tip n="${tip.n}" (last wins on /tips index)\n`);
+    }
+    seenN.add(tip.n);
+  }
+
+  const outPath = resolve(CWD, OUTPUT_PATH);
+  await mkdir(dirname(outPath), { recursive: true });
+  await writeFile(outPath, JSON.stringify(allTips, null, 2) + '\n');
+  process.stdout.write(`build-tips: ${allTips.length} tip${allTips.length === 1 ? '' : 's'} → ${OUTPUT_PATH}\n`);
+}
+
+main().catch((err) => {
+  console.error('build-tips: failed');
+  console.error(err.message ?? err);
+  process.exit(1);
+});
+
+// Export for tests.
+export { extractTips };

package/src/lib/define-tips.ts

@@ -0,0 +1,56 @@
+/**
+ * src/lib/define-tips.ts — `defineTips()` API for cross-volume tip registry
+ * (v4.3.0, closes #70).
+ *
+ * Pragmatic Programmer-style numbered tips can be distributed across multiple
+ * volumes (e.g., Handbook tips 1-25, Architect's Reference 26-40, Field-Guide
+ * 41-50). Authors write `<Tip n="14" ...>` with explicit numbers; defineTips()
+ * lets per-volume books offset their displayed numbers + label without
+ * renumbering source tags.
+ *
+ * Branded type follows the same convention as `defineStyle` (v4.0.0 D6):
+ * type-only `unique symbol` brand, closed shape, readonly fields, no public
+ * index signature. Consumer-side metadata goes in scoped `extra` if needed.
+ */
+
+// ===== Branded nominal type =====
+
+declare const TipsConfigBrand: unique symbol;
+
+export interface TipsConfig {
+  /** Type-only brand for nominal typing. Set automatically by defineTips. */
+  readonly [TipsConfigBrand]: true;
+  /** Internal version marker; auto-set to 1 by defineTips. */
+  readonly __tipsConfigVersion: 1;
+  /** Display offset added to each `<Tip n="N">` for cross-volume coordination.
+   *  Example: Vol B with volumeOffset=25 renders `<Tip n="1">` as "Tip 26". */
+  readonly volumeOffset?: number;
+  /** Optional label shown alongside tip numbers in the /tips index + TipsCard.
+   *  Example: "Vol B" → "Vol B Tip 26". */
+  readonly volumeLabel?: string;
+  /** Scoped consumer-side metadata (matches defineStyle pattern). */
+  readonly extra?: Readonly<Record<string, unknown>>;
+}
+
+/** Input type for defineTips — omits the auto-set internal fields. */
+export type TipsConfigInput = Omit<TipsConfig, typeof TipsConfigBrand | '__tipsConfigVersion'>;
+
+/**
+ * Identity helper that creates a typed, branded TipsConfig.
+ * Zero runtime overhead beyond an object spread + version marker.
+ *
+ * Usage:
+ *
+ *   import { defineTips } from '@brandon_m_behring/book-scaffold-astro';
+ *
+ *   export const tipsConfig = defineTips({
+ *     volumeOffset: 25,
+ *     volumeLabel: 'Vol B',
+ *   });
+ *
+ * Consumed by `<Tip>` and `<TipsCard>` components + the auto-injected
+ * `/tips` route to compute display numbers from `<Tip n="N">` source tags.
+ */
+export function defineTips(opts: TipsConfigInput): TipsConfig {
+  return { __tipsConfigVersion: 1, ...opts } as TipsConfig;
+}

package/src/profile-kit.ts

@@ -49,6 +49,14 @@ export interface RouteToggles {
    * If enabled without defining the collection, Astro errors clearly at build.
    */
   frontmatter: boolean;
+  /**
+   * v4.3.0 (closes #70): auto-inject `/tips` route listing all numbered
+   * `<Tip>` instances from chapter MDX. Requires running
+   * `book-scaffold build-tips` (via prebuild) which emits src/data/tips.json.
+   * Default `false` per profile — opt in via
+   * defineBookConfig({ routes: { tips: true } }).
+   */
+  tips: boolean;
 }
 
 /** Profile definition — declarative shape for one book profile. */

package/src/profiles/academic.ts

@@ -23,6 +23,7 @@ export const academicProfile = defineProfile({
     chapters: false,        // academic consumers ship their own week-based /chapters listing
     convergence: false,     // tools-profile-specific
     frontmatter: false,     // opt-in per book; see #7
+    tips: false,            // v4.3.0 #70: opt-in per book; requires build-tips
   },
   styles: ['tokens.css', 'layout.css', 'callouts.css', 'chapter.css', 'typography.css', 'print.css'],
   katex: true,

package/src/profiles/course-notes.ts

@@ -25,6 +25,7 @@ export const courseNotesProfile = defineProfile({
     chapters: false,        // multi-book consumers route via [book]/[slug] themselves
     convergence: false,
     frontmatter: false,     // opt-in per book; see #7
+    tips: false,            // v4.3.0 #70: opt-in per book
   },
   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

package/src/profiles/minimal.ts

@@ -20,6 +20,7 @@ export const minimalProfile = defineProfile({
     chapters: false,
     convergence: false,
     frontmatter: false,     // opt-in per book; see #7
+    tips: false,            // v4.3.0 #70: opt-in per book
   },
   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

package/src/profiles/research-portfolio.ts

@@ -36,6 +36,7 @@ export const researchPortfolioProfile = defineProfile({
     chapters: false,             // portfolio books ship their own landing/index
     convergence: false,          // tools-profile-specific
     frontmatter: true,           // portfolios universally need title/disclosure/banner pages
+    tips: false,                 // v4.3.0 #70: opt-in per book
   },
   styles: ['tokens.css', 'layout.css', 'callouts.css', 'chapter.css', 'typography.css', 'print.css'],
   katex: true,                   // math is common in research content

package/src/profiles/tools.ts

@@ -20,6 +20,7 @@ export const toolsProfile = defineProfile({
     chapters: true,         // tools profile ships a flat chapter index
     convergence: true,      // tools profile ships convergence dashboard
     frontmatter: false,     // opt-in per book; see #7
+    tips: false,            // v4.3.0 #70: opt-in per book
   },
   styles: [
     'tokens.css', 'layout.css', 'callouts.css', 'chapter.css',