@brandon_m_behring/book-scaffold-astro 4.5.0 → 4.5.1

package/dist/index.mjs

@@ -824,6 +824,23 @@ function defineMdxComponents(components) {
 }
 
 // src/integration.ts
+var LANDING_VIRTUAL_ID = "virtual:book-scaffold/landing-config";
+var LANDING_RESOLVED_ID = "\0" + LANDING_VIRTUAL_ID;
+function makeLandingConfigVitePlugin(config) {
+  const serialized = `export default ${JSON.stringify(config)};`;
+  return {
+    name: "book-scaffold:landing-config",
+    enforce: "pre",
+    resolveId(id) {
+      if (id === LANDING_VIRTUAL_ID) return LANDING_RESOLVED_ID;
+      return null;
+    },
+    load(id) {
+      if (id !== LANDING_RESOLVED_ID) return null;
+      return serialized;
+    }
+  };
+}
 var PACKAGE_NAME = "@brandon_m_behring/book-scaffold-astro";
 var ROUTE_REGISTRY = {
   references: { pattern: "/references", file: "references.astro" },
@@ -918,17 +935,22 @@ function bookScaffoldIntegration(opts) {
         const enabledRouteNames = Object.entries(enabledRoutes).filter(([, on]) => on).map(([name]) => name);
         updateConfig({
           vite: {
-            plugins: [makeMdxComponentsVitePlugin(resolvedMdxPath)],
+            plugins: [
+              makeMdxComponentsVitePlugin(resolvedMdxPath),
+              makeLandingConfigVitePlugin({
+                title: title ?? null,
+                description: description ?? null,
+                portfolio: portfolio ?? false,
+                enabledRoutes: enabledRouteNames
+              })
+            ],
             define: {
+              // Preset/profile stay as env vars — preference-flag pattern where
+              // env-based override IS the convention (resolvePreset reads from
+              // process.env / .env explicitly). Config values (title, etc.) now
+              // route through the virtual module above to avoid that override.
               "import.meta.env.BOOK_PRESET": presetLiteral,
-              "import.meta.env.BOOK_PROFILE": presetLiteral,
-              // v4.5.0: landing-page data. JSON.stringify on undefined → 'undefined'
-              // (which evaluates to JavaScript undefined at use site); on object →
-              // the JSON literal; on false → 'false'.
-              "import.meta.env.BOOK_TITLE": JSON.stringify(title ?? null),
-              "import.meta.env.BOOK_DESCRIPTION": JSON.stringify(description ?? null),
-              "import.meta.env.BOOK_PORTFOLIO": JSON.stringify(portfolio ?? null),
-              "import.meta.env.BOOK_ROUTES_ENABLED": JSON.stringify(enabledRouteNames)
+              "import.meta.env.BOOK_PROFILE": presetLiteral
             }
           }
         });

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

package/pages/index.astro

@@ -1,14 +1,22 @@
 ---
 /**
- * /index — minimal default landing page (v4.5.0).
+ * /index — minimal default landing page (v4.5.0; landing-config source
+ * refactored in v4.5.1 from env vars to virtual module).
  *
  * Auto-injected by bookScaffoldIntegration when routes.landing === true
  * (default for every profile). Consumers with their own src/pages/index.astro
  * override automatically — file-system routes win over injectRoute, no extra
  * config needed.
  *
- * Reads book identity + portfolio + enabled-routes from vite.define-injected
- * env vars (see integration.ts §4.5.0). Renders:
+ * Reads book identity + portfolio + enabled-routes from the
+ * `virtual:book-scaffold/landing-config` virtual module exposed by
+ * makeLandingConfigVitePlugin (see integration.ts §4.5.1). v4.5.0 used
+ * import.meta.env.BOOK_* env vars; that pattern was vulnerable to silent
+ * override by consumer .env files (caught during DML deploy when a stale
+ * `BOOK_TITLE=web` in web/.env overrode defineBookConfig({title})). The
+ * virtual module isolates landing config from any env-based override.
+ *
+ * Renders:
  *   - h1 with book title (fallback: 'book-scaffold-astro')
  *   - lead paragraph with description (omitted if not set)
  *   - "Read" list of links to enabled scaffold routes (filtered to only
@@ -23,13 +31,12 @@
  *     or defineBookConfig({ portfolio: false })
  */
 import Base from '../layouts/Base.astro';
+import bookConfig from 'virtual:book-scaffold/landing-config';
 
-// Vite-injected at build time. JSON.stringify(value ?? null) is the
-// integration's convention; null means "not set", an object/string means real value.
-const title = (import.meta.env.BOOK_TITLE as string | null) ?? 'book-scaffold-astro';
-const description = import.meta.env.BOOK_DESCRIPTION as string | null;
-const portfolio = import.meta.env.BOOK_PORTFOLIO as { url: string; label: string } | false | null;
-const enabledRoutes = (import.meta.env.BOOK_ROUTES_ENABLED as string[] | undefined) ?? [];
+const title = bookConfig.title ?? 'book-scaffold-astro';
+const description = bookConfig.description;
+const portfolio = bookConfig.portfolio;
+const enabledRoutes = bookConfig.enabledRoutes;
 
 // Map from internal route name → display label + URL. Only routes that
 // produce a single landing-list entry are listed here (frontmatter is a