@brandon_m_behring/book-scaffold-astro 3.0.0-alpha.9 → 3.0.1

package/components/SourceArchive.astro

@@ -12,7 +12,7 @@
  * pedagogy of Appendix D — the archive is intentionally sparse in the
  * early book, and the gap is visible by design.
  */
-import { sourceTiers } from '../content.config';
+import { sourceTiers } from '@brandon_m_behring/book-scaffold-astro';
 import {
   getSourcesByTier,
   TIER_LABELS,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AstroUserConfig, AstroIntegration } from 'astro';
-import { b as BookConfigOptions, d as BookScaffoldIntegrationOptions } from './types-Cz-pwE1N.js';
-export { B as BOOK_PROFILES, a as BookConfigError, c as BookProfile, e as BookSchemasOptions, r as resolveProfile } from './types-Cz-pwE1N.js';
+import { b as BookConfigOptions, d as BookScaffoldIntegrationOptions } from './types-BoCXCvBy.js';
+export { B as BOOK_PROFILES, a as BookConfigError, c as BookProfile, e as BookSchemasOptions, r as resolveProfile } from './types-BoCXCvBy.js';
 import { z } from 'astro/zod';
 
 declare function defineBookConfig(opts: BookConfigOptions): Promise<AstroUserConfig>;

package/dist/index.mjs

@@ -119,6 +119,7 @@ import mdx from "@astrojs/mdx";
 import preact from "@astrojs/preact";
 
 // src/types.ts
+import { existsSync, readFileSync } from "fs";
 var BOOK_PROFILES = ["academic", "tools", "minimal"];
 var BookConfigError = class extends Error {
   constructor(message) {
@@ -126,14 +127,43 @@ var BookConfigError = class extends Error {
     this.name = "BookConfigError";
   }
 };
+function readEnvFile(path = ".env") {
+  try {
+    if (!existsSync(path)) return {};
+    const out = {};
+    for (const line of readFileSync(path, "utf8").split(/\r?\n/)) {
+      const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*?)\s*$/);
+      if (!m) continue;
+      let val = m[2] ?? "";
+      if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+        val = val.slice(1, -1);
+      }
+      out[m[1]] = val;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
 function resolveProfile(explicit) {
-  const candidate = explicit ?? process.env.BOOK_PROFILE ?? "minimal";
+  let candidate = explicit ?? process.env.BOOK_PROFILE;
+  let source = "default";
+  if (explicit) source = "param";
+  else if (process.env.BOOK_PROFILE) source = "env";
+  if (!candidate) {
+    const fromFile = readEnvFile().BOOK_PROFILE;
+    if (fromFile) {
+      candidate = fromFile;
+      source = "dotenv";
+    }
+  }
+  candidate = candidate ?? "minimal";
   if (!BOOK_PROFILES.includes(candidate)) {
     throw new BookConfigError(
       `profile must be one of ${BOOK_PROFILES.join(" | ")} (got ${JSON.stringify(candidate)})`
     );
   }
-  if (!explicit && !process.env.BOOK_PROFILE) {
+  if (source === "default") {
     console.warn("book-scaffold-astro: BOOK_PROFILE not set; falling back to 'minimal'.");
   }
   return candidate;
@@ -194,8 +224,14 @@ async function defineBookConfig(opts) {
   const remarkPlugins = [];
   const rehypePlugins = [];
   if (profile === "academic") {
-    const { default: remarkMath } = await import("remark-math");
-    const { default: rehypeKatex } = await import("rehype-katex");
+    const { default: remarkMath } = await import(
+      /* @vite-ignore */
+      "remark-math"
+    );
+    const { default: rehypeKatex } = await import(
+      /* @vite-ignore */
+      "rehype-katex"
+    );
     const { ssmMacros: ssmMacros2 } = await Promise.resolve().then(() => (init_katex_macros(), katex_macros_exports));
     remarkPlugins.push(remarkMath);
     rehypePlugins.push([
@@ -240,10 +276,19 @@ async function defineBookConfig(opts) {
   void _extraIntegrations;
   void _extraStyles;
   void _markdown;
+  const katexExternals = profile === "academic" ? [] : ["remark-math", "rehype-katex", "katex"];
   const config = {
     ...rest,
     integrations,
-    markdown
+    markdown,
+    vite: {
+      build: {
+        rollupOptions: {
+          external: katexExternals
+        }
+      },
+      ...rest.vite ?? {}
+    }
   };
   return config;
 }

package/dist/schemas.d.ts

@@ -1,4 +1,4 @@
-import { e as BookSchemasOptions } from './types-Cz-pwE1N.js';
+import { e as BookSchemasOptions } from './types-BoCXCvBy.js';
 import 'astro';
 
 /**

package/dist/schemas.mjs

@@ -1,9 +1,10 @@
 // src/schemas-entry.ts
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import { defineCollection } from "astro:content";
 import { glob, file } from "astro/loaders";
 
 // src/types.ts
+import { existsSync, readFileSync } from "fs";
 var BOOK_PROFILES = ["academic", "tools", "minimal"];
 var BookConfigError = class extends Error {
   constructor(message) {
@@ -11,14 +12,43 @@ var BookConfigError = class extends Error {
     this.name = "BookConfigError";
   }
 };
+function readEnvFile(path = ".env") {
+  try {
+    if (!existsSync(path)) return {};
+    const out = {};
+    for (const line of readFileSync(path, "utf8").split(/\r?\n/)) {
+      const m = line.match(/^\s*([A-Z_][A-Z0-9_]*)\s*=\s*(.*?)\s*$/);
+      if (!m) continue;
+      let val = m[2] ?? "";
+      if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+        val = val.slice(1, -1);
+      }
+      out[m[1]] = val;
+    }
+    return out;
+  } catch {
+    return {};
+  }
+}
 function resolveProfile(explicit) {
-  const candidate = explicit ?? process.env.BOOK_PROFILE ?? "minimal";
+  let candidate = explicit ?? process.env.BOOK_PROFILE;
+  let source = "default";
+  if (explicit) source = "param";
+  else if (process.env.BOOK_PROFILE) source = "env";
+  if (!candidate) {
+    const fromFile = readEnvFile().BOOK_PROFILE;
+    if (fromFile) {
+      candidate = fromFile;
+      source = "dotenv";
+    }
+  }
+  candidate = candidate ?? "minimal";
   if (!BOOK_PROFILES.includes(candidate)) {
     throw new BookConfigError(
       `profile must be one of ${BOOK_PROFILES.join(" | ")} (got ${JSON.stringify(candidate)})`
     );
   }
-  if (!explicit && !process.env.BOOK_PROFILE) {
+  if (source === "default") {
     console.warn("book-scaffold-astro: BOOK_PROFILE not set; falling back to 'minimal'.");
   }
   return candidate;
@@ -143,19 +173,19 @@ function defineBookSchemas(opts = {}) {
   const collections = {
     chapters
   };
-  if (existsSync("./sources/manifest.yaml")) {
+  if (existsSync2("./sources/manifest.yaml")) {
     collections.sources = defineCollection({
       loader: file("sources/manifest.yaml"),
       schema: sourcesSchema
     });
   }
-  if (existsSync("./changelog/tools")) {
+  if (existsSync2("./changelog/tools")) {
     collections.changelog = defineCollection({
       loader: glob({ pattern: "*.yaml", base: "./changelog/tools" }),
       schema: changelogSchema
     });
   }
-  if (existsSync("./changelog/patterns.yaml")) {
+  if (existsSync2("./changelog/patterns.yaml")) {
     collections.patterns = defineCollection({
       loader: file("changelog/patterns.yaml"),
       schema: patternsSchema

package/layouts/Base.astro

@@ -42,8 +42,13 @@ import '../styles/chapter.css';
 import '../styles/tool-filter.css';
 import '../styles/convergence.css';
 import '../styles/print.css';
-import VersionSelector from '../components/VersionSelector';
-import ToolFilter from '../components/ToolFilter';
+// Use package-path imports for the .tsx islands so Vite resolves them
+// via the exports map (→ pre-compiled dist/components/*.mjs with proper
+// preact JSX). The raw .tsx files are also shipped so consumers can
+// import them directly, but relative imports from inside the package
+// must route through the exports map, not the raw source.
+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';
 
 const profile = import.meta.env.BOOK_PROFILE ?? 'minimal';

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.0-alpha.9",
+  "version": "3.0.1",
   "type": "module",
   "license": "MIT",
   "author": "Brandon Behring",
@@ -117,7 +117,8 @@
   ],
   "scripts": {
     "build": "tsup && rm -f dist/types-*.d.ts",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "test": "node --test tests/*.test.mjs"
   },
   "peerDependencies": {
     "astro": "^6.1.7",

package/pages/convergence.astro

@@ -16,7 +16,7 @@ import {
   getPatternsByCategory,
   CATEGORY_LABELS,
 } from '../src/lib/patterns';
-import { patternCategories } from '../content.config';
+import { patternCategories } from '@brandon_m_behring/book-scaffold-astro';
 
 const grouped = await getPatternsByCategory();
 const totalPatterns = Object.values(grouped).reduce(

package/scripts/build-bib.mjs

@@ -37,7 +37,7 @@ import { Cite } from '@citation-js/core';
 import '@citation-js/plugin-bibtex';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = resolve(__dirname, '..');
+const PROJECT_ROOT = process.cwd();
 
 // Default: bibliography.bib at scaffold root.
 // Override via BOOK_BIB_PATH=path/to/your.bib (absolute or relative to cwd).

package/scripts/build-figures.mjs

@@ -31,7 +31,7 @@ import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = resolve(__dirname, '..');
+const PROJECT_ROOT = process.cwd();
 
 // Default: figures/ at scaffold root.
 // Override via BOOK_FIGURES_PATH=path/to/figures (absolute or relative to

package/scripts/render-notebooks.mjs

@@ -36,7 +36,7 @@ import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const PROJECT_ROOT = resolve(__dirname, '..');
+const PROJECT_ROOT = process.cwd();
 
 // Default: notebooks/ at scaffold root.
 // Override via BOOK_NOTEBOOKS_PATH (absolute or relative to scaffold root)

package/src/lib/patterns.ts

@@ -17,7 +17,7 @@ import {
   toolSlugs,
   patternCategories,
   changeKinds,
-} from '../schemas.js';
+} from '@brandon_m_behring/book-scaffold-astro';
 
 export type PatternEntry = CollectionEntry<'patterns'>;
 export type ToolSlug = (typeof toolSlugs)[number];

package/src/lib/sources.ts

@@ -6,7 +6,7 @@
  * component and any future dashboards share a single source of truth.
  */
 import { getCollection, type CollectionEntry } from 'astro:content';
-import { sourceTiers } from '../schemas.js';
+import { sourceTiers } from '@brandon_m_behring/book-scaffold-astro';
 
 export type SourceEntry = CollectionEntry<'sources'>;
 export type SourceTier = (typeof sourceTiers)[number];