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

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.mjs

@@ -173,6 +173,9 @@ function bookScaffoldIntegration(opts) {
         for (const sheet of styles) {
           injectScript("page-ssr", `import '${PACKAGE_NAME}/styles/${sheet}';`);
         }
+        if (profile === "academic") {
+          injectScript("page-ssr", "import 'katex/dist/katex.min.css';");
+        }
         const routes = profile === "tools" ? [...DEFAULT_ROUTES_ALL, ...DEFAULT_ROUTES_TOOLS] : [...DEFAULT_ROUTES_ALL];
         for (const route of routes) {
           injectRoute({

package/layouts/Base.astro

@@ -31,12 +31,9 @@
  */
 import '@fontsource-variable/roboto';
 import '@fontsource-variable/source-code-pro';
-// KaTeX stylesheet is always loaded (~60 KB) so that academic-profile
-// books render math without additional setup. Minimal/tools profiles
-// receive the CSS but have no math elements to style — harmless.
-// rehype-katex (the JS pipeline) is profile-gated in astro.config.mjs;
-// only the academic profile produces katex-classed DOM nodes at build.
-import 'katex/dist/katex.min.css';
+// KaTeX CSS is injected by bookScaffoldIntegration for academic profile
+// only (since v3.0 alpha.8) — tools/minimal profiles don't install katex
+// as a peer dep, so the import would fail at the consumer's build.
 import '../styles/tokens.css';
 import '../styles/typography.css';
 import '../styles/layout.css';

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.7",
+  "version": "3.0.0-alpha.9",
   "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",