@brandon_m_behring/book-scaffold-astro 3.0.0-alpha.8 → 3.0.0

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/components/VersionSelector.tsx

@@ -50,7 +50,9 @@ export default function VersionSelector() {
     };
   }, [open]);
 
-  const current = STUB_VERSIONS.find((v) => v.current) || STUB_VERSIONS[0];
+  // STUB_VERSIONS is a const literal with >=1 entry so the fallback is
+  // always defined; the bang silences TS's noUncheckedIndexedAccess.
+  const current = STUB_VERSIONS.find((v) => v.current) ?? STUB_VERSIONS[0]!;
 
   return (
     <div class="version-selector" ref={ref}>

package/dist/components/ToolFilter.d.ts

@@ -0,0 +1,5 @@
+import * as preact from 'preact';
+
+declare function ToolFilter(): preact.JSX.Element;
+
+export { ToolFilter as default };

package/dist/components/ToolFilter.mjs

@@ -0,0 +1,118 @@
+// components/ToolFilter.tsx
+import { useState, useRef, useEffect } from "preact/hooks";
+import { jsx, jsxs } from "preact/jsx-runtime";
+var STORAGE_KEY = "book:tool-filter";
+var EVENT_NAME = "book:tool-filter:change";
+var FILTERABLE_TOOLS = ["claude-code", "gemini-cli", "codex-cli"];
+function readSaved() {
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter((s) => typeof s === "string");
+  } catch {
+    return [];
+  }
+}
+function writeSaved(selected) {
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(selected));
+  } catch {
+  }
+}
+function announce(selected) {
+  window.dispatchEvent(
+    new CustomEvent(EVENT_NAME, { detail: { selected } })
+  );
+}
+function ToolFilter() {
+  const [open, setOpen] = useState(false);
+  const [selected, setSelected] = useState([]);
+  const ref = useRef(null);
+  useEffect(() => {
+    const saved = readSaved();
+    setSelected(saved);
+    announce(saved);
+  }, []);
+  useEffect(() => {
+    if (!open) return;
+    const onClick = (e) => {
+      if (ref.current && !ref.current.contains(e.target)) {
+        setOpen(false);
+      }
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    window.addEventListener("click", onClick);
+    window.addEventListener("keydown", onKey);
+    return () => {
+      window.removeEventListener("click", onClick);
+      window.removeEventListener("keydown", onKey);
+    };
+  }, [open]);
+  function toggle(tool) {
+    const next = selected.includes(tool) ? selected.filter((s) => s !== tool) : [...selected, tool];
+    setSelected(next);
+    writeSaved(next);
+    announce(next);
+  }
+  function clearAll() {
+    setSelected([]);
+    writeSaved([]);
+    announce([]);
+  }
+  const activeCount = selected.length;
+  const buttonLabel = activeCount === 0 ? "Filter chapters by tool (showing all)" : `Filter chapters by tool (${activeCount} active)`;
+  return /* @__PURE__ */ jsxs("div", { class: "tool-filter", ref, children: [
+    /* @__PURE__ */ jsxs(
+      "button",
+      {
+        type: "button",
+        class: "chrome-button tool-filter-trigger",
+        "aria-label": buttonLabel,
+        title: buttonLabel,
+        "aria-expanded": open,
+        "aria-haspopup": "true",
+        onClick: () => setOpen((v) => !v),
+        children: [
+          /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2690" }),
+          activeCount > 0 && /* @__PURE__ */ jsx("span", { class: "tool-filter-count", "aria-hidden": "true", children: activeCount })
+        ]
+      }
+    ),
+    open && /* @__PURE__ */ jsxs("div", { class: "tool-filter-panel", role: "group", "aria-label": "Tool filters", children: [
+      /* @__PURE__ */ jsx("p", { class: "tool-filter-heading", children: "Show chapters for" }),
+      /* @__PURE__ */ jsx("ul", { class: "tool-filter-chips", children: FILTERABLE_TOOLS.map((tool) => {
+        const on = selected.includes(tool);
+        return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            class: `tool-filter-chip${on ? " tool-filter-chip-on" : ""}`,
+            "aria-pressed": on,
+            onClick: () => toggle(tool),
+            children: tool
+          }
+        ) });
+      }) }),
+      /* @__PURE__ */ jsxs("div", { class: "tool-filter-footer", children: [
+        /* @__PURE__ */ jsx(
+          "button",
+          {
+            type: "button",
+            class: "tool-filter-clear",
+            onClick: clearAll,
+            disabled: activeCount === 0,
+            children: "Clear"
+          }
+        ),
+        /* @__PURE__ */ jsx("span", { class: "tool-filter-note", children: "Cross-tool chapters stay visible under any filter." })
+      ] })
+    ] })
+  ] });
+}
+export {
+  ToolFilter as default
+};

package/dist/components/VersionSelector.d.ts

@@ -0,0 +1,5 @@
+import * as preact from 'preact';
+
+declare function VersionSelector(): preact.JSX.Element;
+
+export { VersionSelector as default };

package/dist/components/VersionSelector.mjs

@@ -0,0 +1,58 @@
+// components/VersionSelector.tsx
+import { useState, useRef, useEffect } from "preact/hooks";
+import { jsx, jsxs } from "preact/jsx-runtime";
+var STUB_VERSIONS = [
+  { id: "", label: "Latest (main)", date: "2026-04-17", current: true },
+  { id: "v1.0", label: "v1.0", date: "2026-05-01", current: false }
+];
+function VersionSelector() {
+  const [open, setOpen] = useState(false);
+  const ref = useRef(null);
+  useEffect(() => {
+    if (!open) return;
+    const onClick = (e) => {
+      if (ref.current && !ref.current.contains(e.target)) {
+        setOpen(false);
+      }
+    };
+    const onKey = (e) => {
+      if (e.key === "Escape") setOpen(false);
+    };
+    window.addEventListener("click", onClick);
+    window.addEventListener("keydown", onKey);
+    return () => {
+      window.removeEventListener("click", onClick);
+      window.removeEventListener("keydown", onKey);
+    };
+  }, [open]);
+  const current = STUB_VERSIONS.find((v) => v.current) ?? STUB_VERSIONS[0];
+  return /* @__PURE__ */ jsxs("div", { class: "version-selector", ref, children: [
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        class: "chrome-button version-selector-trigger",
+        "aria-label": "Select book version",
+        title: `Current: ${current.label} (${current.date})`,
+        "aria-expanded": open,
+        "aria-haspopup": "listbox",
+        onClick: () => setOpen((v) => !v),
+        children: /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "v" })
+      }
+    ),
+    open && /* @__PURE__ */ jsx("ul", { class: "version-selector-menu", role: "listbox", children: STUB_VERSIONS.map((v) => /* @__PURE__ */ jsx("li", { role: "option", "aria-selected": v.current, children: /* @__PURE__ */ jsxs(
+      "a",
+      {
+        href: v.id ? `/${v.id}/` : "/",
+        class: v.current ? "version-current" : "",
+        children: [
+          /* @__PURE__ */ jsx("span", { class: "version-label", children: v.label }),
+          /* @__PURE__ */ jsx("span", { class: "version-date", children: v.date })
+        ]
+      }
+    ) })) })
+  ] });
+}
+export {
+  VersionSelector as default
+};

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.8",
+  "version": "3.0.0",
   "type": "module",
   "license": "MIT",
   "author": "Brandon Behring",
@@ -73,9 +73,15 @@
     "./components/Tag.astro": "./components/Tag.astro",
     "./components/Theorem.astro": "./components/Theorem.astro",
     "./components/TipBox.astro": "./components/TipBox.astro",
-    "./components/ToolFilter": "./components/ToolFilter.tsx",
+    "./components/ToolFilter": {
+      "types": "./dist/components/ToolFilter.d.ts",
+      "import": "./dist/components/ToolFilter.mjs"
+    },
     "./components/TryThis.astro": "./components/TryThis.astro",
-    "./components/VersionSelector": "./components/VersionSelector.tsx",
+    "./components/VersionSelector": {
+      "types": "./dist/components/VersionSelector.d.ts",
+      "import": "./dist/components/VersionSelector.mjs"
+    },
     "./components/WarnBox.astro": "./components/WarnBox.astro",
     "./components/WeekRef.astro": "./components/WeekRef.astro",
     "./components/XRef.astro": "./components/XRef.astro",
@@ -111,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/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];