@brandon_m_behring/book-scaffold-astro 3.7.0 → 3.7.1

package/dist/index.mjs

@@ -787,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"
@@ -862,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,

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

package/scripts/validate.mjs

@@ -26,9 +26,9 @@
  * Exit code = total failure count (0 = pass, >=1 = errors).
  */
 import { readFile, access } from 'node:fs/promises';
-import { glob } from 'node:fs/promises';
 import { existsSync, readFileSync } from 'node:fs';
 import { resolve, dirname, join } from 'node:path';
+import { walkMdx } from './walk-mdx.mjs';
 
 /**
  * Best-effort .env reader. Mirrors `readEnvFile` in src/types.ts; kept inline
@@ -134,8 +134,13 @@ const refs = await loadJson(join(DATA_DIR, 'references.json'));
 const labels = await loadJson(join(DATA_DIR, 'labels.json'));
 
 // ===== Collect chapter files =====
+// v3.7.1 (closes #52): walkMdx (in ./walk-mdx.mjs) is a recursive readdir
+// walker that replaces the previous `glob` import from `node:fs/promises`.
+// The `glob` API was added in Node 22 but consumer CI templates ship
+// Node 20 — `npm run validate` crashed on every consumer's prebuild hook.
+// Walker uses readdir + path only; works on Node 18+.
 const chapterFiles = [];
-for await (const f of glob('**/*.{md,mdx}', { cwd: CHAPTERS_DIR })) {
+for await (const f of walkMdx(CHAPTERS_DIR)) {
   if (!f.split('/').pop().startsWith('_')) chapterFiles.push(f);
 }
 

package/scripts/walk-mdx.mjs

@@ -0,0 +1,34 @@
+/**
+ * scripts/walk-mdx.mjs — recursive .md/.mdx file walker for content trees.
+ *
+ * Extracted from scripts/validate.mjs in v3.7.1 (closes #52) so it can be
+ * unit-tested without running validate's side-effectful top-level await.
+ *
+ * Replaces the previous `glob` import from `node:fs/promises` (Node 22+
+ * only). The walker below uses `readdir` only — works on Node 18+ so
+ * consumer CIs running `node-version: '20'` no longer crash on the
+ * scaffold's prebuild validate hook.
+ *
+ * Output: relative paths in POSIX form ("subdir/file.mdx"), matching what
+ * the previous `glob('**\/*.{md,mdx}', { cwd })` produced.
+ */
+import { readdir } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+
+export async function* walkMdx(dir, baseDir = dir) {
+  let entries;
+  try {
+    entries = await readdir(dir, { withFileTypes: true });
+  } catch {
+    return; // dir missing or unreadable — treat as zero chapters
+  }
+  for (const entry of entries) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      yield* walkMdx(full, baseDir);
+    } else if (/\.(md|mdx)$/.test(entry.name)) {
+      // Normalize to forward slashes for cross-platform stability.
+      yield relative(baseDir, full).split(/[\\/]/).join('/');
+    }
+  }
+}