@brandon_m_behring/book-scaffold-astro 3.0.0-alpha.0

package/dist/types-Cz-pwE1N.d.ts

@@ -0,0 +1,61 @@
+import { AstroIntegration, AstroUserConfig } from 'astro';
+
+/**
+ * Shared types for @brandon_m_behring/book-scaffold-astro.
+ *
+ * Public types referenced from PACKAGE_DESIGN.md §4 / §5 / §6. Kept in
+ * one place so consumer IntelliSense surfaces a coherent API.
+ */
+
+type BookProfile = 'academic' | 'tools' | 'minimal';
+declare const BOOK_PROFILES: readonly ["academic", "tools", "minimal"];
+/**
+ * Options for `defineBookConfig`. See PACKAGE_DESIGN.md §4.
+ *
+ * Note on the index signature: `AstroUserConfig` carries generic
+ * parameters (`Locales`, `SessionDriverName`, fonts) that can't be
+ * threaded cleanly through a wrapper. Instead we type the package-
+ * specific fields strictly and allow arbitrary AstroUserConfig keys
+ * via the index signature — consumer types will lint clean but lose
+ * full IDE autocomplete on non-package fields. Acceptable trade.
+ */
+interface BookConfigOptions {
+    /** Required. Book's deployed origin (sitemap, canonical, Pagefind). */
+    site: string;
+    /**
+     * Optional. Falls back to `process.env.BOOK_PROFILE`, then `'minimal'`.
+     * Explicit param always wins over env.
+     */
+    profile?: BookProfile;
+    /** Optional. Appended to the package-provided integration list. */
+    extraIntegrations?: AstroIntegration[];
+    /**
+     * Optional. CSS basenames to inject in addition to the profile-resolved
+     * set. Cross-profile escape hatch (e.g. an academic book using
+     * `<Convergence>`). Example: `['convergence.css']`.
+     */
+    extraStyles?: string[];
+    /** Optional. Spread-merged into the package-provided markdown config. */
+    markdown?: AstroUserConfig['markdown'];
+    /** Escape hatch for any other AstroUserConfig field. */
+    [key: string]: unknown;
+}
+/** Options for `defineBookSchemas`. See PACKAGE_DESIGN.md §5. */
+interface BookSchemasOptions {
+    profile?: BookProfile;
+    /** Defaults to `'./src/content/chapters'`. */
+    chaptersBase?: string;
+}
+/** Options for the internal `bookScaffoldIntegration`. See PACKAGE_DESIGN.md §6. */
+interface BookScaffoldIntegrationOptions {
+    profile: BookProfile;
+    extraStyles?: string[];
+}
+/** Raised when the resolved profile is not one of `BOOK_PROFILES`. */
+declare class BookConfigError extends Error {
+    constructor(message: string);
+}
+/** Resolve profile from explicit param → env → default. Throws on invalid. */
+declare function resolveProfile(explicit?: BookProfile): BookProfile;
+
+export { BOOK_PROFILES as B, BookConfigError as a, type BookConfigOptions as b, type BookProfile as c, type BookScaffoldIntegrationOptions as d, type BookSchemasOptions as e, resolveProfile as r };

package/examples/chapter-template-academic.mdx

@@ -0,0 +1,100 @@
+---
+# Frontmatter for BOOK_PROFILE=academic. See src/content.config.ts for
+# the full schema and validation rules.
+week: 1
+part: foundations
+title: "Chapter title — your subject here"
+status: scaffolded
+# Optional fields:
+# description: "Short SEO/meta description, ~140 chars."
+# code_path: experiments/jax/week01/some_module.py
+# tests_path: experiments/jax/week01/test_some_module.py
+# notebook_path: notebooks/week01/companion.ipynb
+# roadmap_lines: [10, 42]
+---
+import NoteBox from '../../components/callouts/NoteBox.astro';
+import ExampleBox from '../../components/callouts/ExampleBox.astro';
+import InsightBox from '../../components/callouts/InsightBox.astro';
+import OpenQuestion from '../../components/callouts/OpenQuestion.astro';
+import Theorem from '../../components/Theorem.astro';
+import Cite from '../../components/Cite.astro';
+import Figure from '../../components/Figure.astro';
+import Sidenote from '../../components/Sidenote.astro';
+
+# {frontmatter.title}
+
+## Overview
+
+A half-page motivation: what this chapter covers, why it matters,
+and how it fits into the curriculum. Reader should be able to decide
+after the Overview whether to read further.<Sidenote>Use Sidenote
+for short asides that belong in the right margin on desktop and
+reflow inline on mobile.</Sidenote>
+
+<InsightBox>
+The single most important takeaway of this chapter, stated as a
+short principle. Comes before the Theory so a reader who only
+skims gets the heart of the matter.
+</InsightBox>
+
+## Theory
+
+The core mathematical content. Definitions, lemmas, propositions,
+theorems. Cite primary sources using <Cite key="example-key2024" />.
+
+<Theorem type="definition" id="ch1:def:main">
+A *something* is a mathematical object such that … Provide the
+precise definition with the key properties explicit.
+</Theorem>
+
+<Theorem type="theorem" id="ch1:thm:main" label="Main result">
+Under the conditions of Definition <a href="#ch1:def:main">1.1</a>,
+the property $P$ holds with $\|x\| \le c \cdot \|y\|$ for some
+constant $c > 0$.
+</Theorem>
+
+<Theorem type="proof">
+Direct calculation. Apply the chain rule, regroup terms, and use
+the boundedness assumption from the hypothesis.
+</Theorem>
+
+## Examples
+
+Concrete instances that exercise the theory. At least one worked
+example per theorem.
+
+<ExampleBox title="Worked example 1">
+Take $A = \mathrm{diag}(\lambda_1, \ldots, \lambda_n)$ with all
+$|\lambda_i| < 1$. Then the iteration $x_{k+1} = A x_k$ converges
+to 0, with rate $\max_i |\lambda_i|$.
+</ExampleBox>
+
+<Figure
+  src="/figures/example/placeholder.svg"
+  caption="Caption explaining what the reader should see in the figure."
+  id="ch1-fig-example"
+/>
+
+## Reflections
+
+What should the reader walk away knowing? Three to five takeaways.
+
+1. The first key insight, restated in plain language.
+2. The second key insight, with a connection to a sibling chapter.
+3. The third key insight, often a caveat or limitation.
+
+<OpenQuestion>
+A research gap the chapter exposes. What's not yet known? What
+would extend this result? Pointers to the wish-list / project-ideas
+file for ambitious readers.
+</OpenQuestion>
+
+## Forward-map
+
+How this chapter connects to next week. One paragraph; sets up the
+reader's mental model for what comes next.
+
+<NoteBox>
+Delete this section when no follow-on chapter exists yet, or replace
+with a "Synthesis" section in the final chapter of a part.
+</NoteBox>

package/examples/chapter-template-tools.mdx

@@ -0,0 +1,90 @@
+---
+# Frontmatter for BOOK_PROFILE=tools. See src/content.config.ts for
+# the full schema and validation rules.
+title: "Chapter title — your topic here"
+part: 1
+chapter: 1
+volatility: architectural-pattern
+tools_compared: [claude-code, gemini-cli, codex-cli]
+last_verified: 2026-05-18
+sources: []
+# Optional fields:
+# description: "Short SEO/meta description, ~140 chars."
+# draft: false
+# updated: 2026-05-18
+---
+import SkillBox from '../../components/callouts/SkillBox.astro';
+import CaseStudy from '../../components/callouts/CaseStudy.astro';
+import ConceptBox from '../../components/callouts/ConceptBox.astro';
+import KeyIdea from '../../components/callouts/KeyIdea.astro';
+import TryThis from '../../components/callouts/TryThis.astro';
+import Recovery from '../../components/callouts/Recovery.astro';
+import Convergence from '../../components/callouts/Convergence.astro';
+import Divergence from '../../components/callouts/Divergence.astro';
+
+# {frontmatter.title}
+
+## Representation
+
+What does the artifact (a pattern, a feature, a capability) look like
+across the tools you're comparing? Define terms precisely.
+
+<ConceptBox term="The thing being represented">
+A short, precise definition. Avoid jargon; if jargon is unavoidable,
+link to a chapter where it's defined.
+</ConceptBox>
+
+<KeyIdea>
+The single most important framing of this chapter. The reader who
+reads only this box should still leave with the central insight.
+</KeyIdea>
+
+## Operation
+
+What do you DO with this artifact? Concrete operations, with
+examples per tool. Show, don't tell.
+
+<SkillBox title="The core skill">
+A practical workflow the reader can apply right now. Numbered steps,
+specific commands, no hand-waving.
+
+1. First concrete action
+2. Second concrete action
+3. Verify
+</SkillBox>
+
+<TryThis title="Hands-on exercise">
+Open your own project and apply the skill above to a specific case.
+What did you observe? What surprised you?
+</TryThis>
+
+<CaseStudy date="2026-05">
+A specific, dated incident or example showing the pattern in
+practice. Concrete numbers if possible (durations, file counts,
+token savings, etc.).
+</CaseStudy>
+
+<Recovery
+  pattern="Common anti-pattern in this space"
+  symptom="What the reader experiences when stuck in the anti-pattern."
+>
+The recommended fix. One paragraph.
+</Recovery>
+
+## Evolution
+
+What's converging or diverging across the tools you're tracking?
+This is the comparative-tracking heart of the Koller-Friedman shape
+applied to evolving technology.
+
+<Convergence tools={['claude-code', 'gemini-cli', 'codex-cli']}>
+All tracked tools now do X. You can safely write practices that
+assume this. Date the convergence so the reader knows when to
+re-check.
+</Convergence>
+
+<Divergence axis="The axis of disagreement">
+Tool A picks one tradeoff; Tool B picks the opposite. The space
+hasn't settled. Document both positions plainly so the reader can
+make an informed choice.
+</Divergence>

package/layouts/Base.astro

@@ -0,0 +1,250 @@
+---
+/**
+ * Base.astro — the outermost HTML shell.
+ *
+ * Every page in the book extends this. Loads:
+ *   - Variable fonts (Roboto, Source Code Pro) self-hosted via @fontsource-variable
+ *   - Design tokens, baseline typography, Tufte layout
+ *   - FOUC-prevention script for dark mode (reads localStorage before paint)
+ *   - Meta tags for viewport, color-scheme, generator
+ *   - Optional left chapter-nav Sidebar (showSidebar prop; default true)
+ *
+ * Props:
+ *   title       — document title (required)
+ *   description — meta description (optional; used by search and social)
+ *   lang        — html lang attribute (default: en)
+ *   showSidebar — render the left chapter-navigation sidebar (default: true).
+ *                 Set false for the landing page or any full-bleed surface.
+ *                 Below 1024px the sidebar is auto-hidden via CSS regardless.
+ *
+ * Tools chrome (ToolFilter, VersionSelector): only mounted when
+ * BOOK_PROFILE !== 'academic'. Academic-profile books get no JS islands
+ * in the chrome row (search + theme toggle only).
+ *
+ * Usage:
+ *   ---
+ *   import Base from '../layouts/Base.astro';
+ *   ---
+ *   <Base title="Chapter 1" description="...">
+ *     <main>...</main>
+ *   </Base>
+ */
+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';
+import '../styles/tokens.css';
+import '../styles/typography.css';
+import '../styles/layout.css';
+import '../styles/callouts.css';
+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';
+import Sidebar from '../components/Sidebar.astro';
+
+const profile = import.meta.env.BOOK_PROFILE ?? 'minimal';
+const showToolsChrome = profile !== 'academic';
+
+interface Props {
+  title: string;
+  description?: string;
+  lang?: string;
+  showSidebar?: boolean;
+}
+
+const { title, description, lang = 'en', showSidebar = true } = Astro.props;
+---
+
+<!doctype html>
+<html lang={lang}>
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="color-scheme" content="light dark" />
+    <meta name="generator" content={Astro.generator} />
+    <title>{title}</title>
+    {description && <meta name="description" content={description} />}
+    {/* FOUC prevention — apply saved theme before any paint. */}
+    <script is:inline>
+      (function () {
+        try {
+          var saved = localStorage.getItem('theme');
+          if (saved === 'light' || saved === 'dark') {
+            document.documentElement.setAttribute('data-theme', saved);
+          }
+        } catch (e) { /* localStorage unavailable — fall back to prefers-color-scheme */ }
+      })();
+    </script>
+    <slot name="head" />
+  </head>
+  <body>
+    <div class="chrome-buttons">
+      {showToolsChrome && <ToolFilter client:idle />}
+      {showToolsChrome && <VersionSelector client:idle />}
+      <a
+        href="/search/"
+        class="chrome-button"
+        aria-label="Search the book"
+        title="Search"
+      >
+        <span aria-hidden="true">⌕</span>
+      </a>
+      <button
+        id="theme-toggle"
+        class="chrome-button theme-toggle"
+        type="button"
+        aria-label="Toggle dark mode"
+        title="Toggle dark mode"
+      >
+        <span class="theme-toggle-icon light-icon" aria-hidden="true">☀</span>
+        <span class="theme-toggle-icon dark-icon" aria-hidden="true">☾</span>
+      </button>
+    </div>
+    {showSidebar ? (
+      <div class="layout-with-sidebar">
+        <Sidebar />
+        <main class="layout-main"><slot /></main>
+      </div>
+    ) : (
+      <slot />
+    )}
+    <script is:inline>
+      (function () {
+        var btn = document.getElementById('theme-toggle');
+        if (!btn) return;
+        btn.addEventListener('click', function () {
+          var current = document.documentElement.getAttribute('data-theme');
+          // If no explicit theme, pick the opposite of prefers-color-scheme.
+          if (!current) {
+            var prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+            current = prefersDark ? 'dark' : 'light';
+          }
+          var next = current === 'dark' ? 'light' : 'dark';
+          document.documentElement.setAttribute('data-theme', next);
+          try { localStorage.setItem('theme', next); } catch (e) {}
+        });
+      })();
+    </script>
+  </body>
+</html>
+
+<style is:global>
+  /* Floating chrome buttons — fixed top-right corner.
+   * Search icon + theme toggle; more buttons can join this row later. */
+  .chrome-buttons {
+    position: fixed;
+    top: var(--space-3);
+    right: var(--space-3);
+    display: inline-flex;
+    gap: var(--space-2);
+    z-index: 10;
+  }
+  .chrome-button {
+    width: 2.25rem;
+    height: 2.25rem;
+    padding: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    background: var(--color-bg-subtle);
+    color: var(--color-text);
+    border: 1px solid var(--color-border);
+    border-radius: 50%;
+    cursor: pointer;
+    font-size: 1.1rem;
+    line-height: 1;
+    text-decoration: none;
+    transition: background 120ms ease, border-color 120ms ease;
+  }
+  .chrome-button:hover {
+    border-color: var(--color-link);
+    text-decoration: none;
+  }
+
+  /* Version selector dropdown */
+  .version-selector {
+    position: relative;
+    display: inline-block;
+  }
+  .version-selector-trigger {
+    font-family: var(--font-code);
+    font-weight: 600;
+    font-size: 0.9rem;
+    padding: 0 0.6em !important;
+  }
+  .version-selector-menu {
+    position: absolute;
+    top: calc(100% + var(--space-2));
+    right: 0;
+    min-width: 12rem;
+    margin: 0;
+    padding: var(--space-2);
+    list-style: none;
+    background: var(--color-bg);
+    border: 1px solid var(--color-border);
+    border-radius: var(--radius-md);
+    box-shadow: 0 4px 12px rgba(0, 0, 0, 0.08);
+  }
+  .version-selector-menu li {
+    margin: 0;
+  }
+  .version-selector-menu a {
+    display: grid;
+    grid-template-columns: 1fr auto;
+    gap: var(--space-2);
+    padding: var(--space-2) var(--space-3);
+    text-decoration: none;
+    color: var(--color-text);
+    border-radius: var(--radius-sm);
+  }
+  .version-selector-menu a:hover {
+    background: var(--color-bg-subtle);
+  }
+  .version-selector-menu a.version-current {
+    color: var(--color-link);
+    font-weight: 500;
+  }
+  .version-selector-menu .version-label {
+    font-family: var(--font-body);
+    font-size: var(--text-sm);
+  }
+  .version-selector-menu .version-date {
+    font-family: var(--font-code);
+    font-size: var(--text-xs);
+    color: var(--color-text-muted);
+  }
+  .theme-toggle .theme-toggle-icon {
+    display: none;
+  }
+  /* Default (light): show moon (click to go dark) */
+  .theme-toggle .dark-icon {
+    display: inline;
+  }
+  /* Dark mode (explicit or system): show sun (click to go light) */
+  :root[data-theme="dark"] .theme-toggle .dark-icon,
+  :root:not([data-theme]) .theme-toggle .dark-icon {
+    display: inline;
+  }
+  :root[data-theme="dark"] .theme-toggle .light-icon {
+    display: inline;
+  }
+  :root[data-theme="dark"] .theme-toggle .dark-icon {
+    display: none;
+  }
+  @media (prefers-color-scheme: dark) {
+    :root:not([data-theme="light"]) .theme-toggle .light-icon {
+      display: inline;
+    }
+    :root:not([data-theme="light"]) .theme-toggle .dark-icon {
+      display: none;
+    }
+  }
+</style>

package/layouts/Chapter.astro

@@ -0,0 +1,37 @@
+---
+/**
+ * Chapter.astro — layout for a single chapter page.
+ *
+ * Wraps Base.astro with a chapter-specific structure:
+ *   <article.prose>
+ *     <ChapterHeader />     ← frontmatter metadata
+ *     <ChapterTOC />        ← collapsed "On this page"
+ *     <slot />              ← the rendered MDX body
+ *     <ChapterNav />        ← prev / next
+ *   </article.prose>
+ *
+ * Driven by a CollectionEntry<'chapters'> passed in Astro.props.entry
+ * plus the `headings` array Astro's MDX renderer provides.
+ */
+import type { CollectionEntry } from 'astro:content';
+import type { MarkdownHeading } from 'astro';
+import Base from './Base.astro';
+import ChapterHeader from '../components/ChapterHeader.astro';
+import ChapterTOC from '../components/ChapterTOC.astro';
+import ChapterNav from '../components/ChapterNav.astro';
+
+interface Props {
+  entry: CollectionEntry<'chapters'>;
+  headings: MarkdownHeading[];
+}
+const { entry, headings } = Astro.props;
+---
+
+<Base title={entry.data.title} description={entry.data.description}>
+  <article class="prose">
+    <ChapterHeader data={entry.data} />
+    <ChapterTOC headings={headings} />
+    <slot />
+    <ChapterNav currentId={entry.id} />
+  </article>
+</Base>

package/package.json

@@ -0,0 +1,137 @@
+{
+  "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.0",
+  "type": "module",
+  "license": "MIT",
+  "author": "Brandon Behring",
+  "homepage": "https://github.com/brandon-behring/book-scaffold-astro",
+  "bugs": "https://github.com/brandon-behring/book-scaffold-astro/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brandon-behring/book-scaffold-astro.git",
+    "directory": "package"
+  },
+  "keywords": [
+    "astro",
+    "astro-component",
+    "mdx",
+    "book",
+    "tufte",
+    "katex",
+    "bibtex",
+    "pagefind",
+    "book-scaffold"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "book-scaffold": "./bin/book-scaffold.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "import": "./dist/schemas.mjs"
+    },
+    "./components/CaseStudy.astro": "./components/CaseStudy.astro",
+    "./components/ChapterHeader.astro": "./components/ChapterHeader.astro",
+    "./components/ChapterNav.astro": "./components/ChapterNav.astro",
+    "./components/ChapterTOC.astro": "./components/ChapterTOC.astro",
+    "./components/Citation.astro": "./components/Citation.astro",
+    "./components/Cite.astro": "./components/Cite.astro",
+    "./components/CodeBlock.astro": "./components/CodeBlock.astro",
+    "./components/CodeRef.astro": "./components/CodeRef.astro",
+    "./components/ConceptBox.astro": "./components/ConceptBox.astro",
+    "./components/Convergence.astro": "./components/Convergence.astro",
+    "./components/CounterBox.astro": "./components/CounterBox.astro",
+    "./components/Divergence.astro": "./components/Divergence.astro",
+    "./components/DynConnect.astro": "./components/DynConnect.astro",
+    "./components/ExampleBox.astro": "./components/ExampleBox.astro",
+    "./components/Figure.astro": "./components/Figure.astro",
+    "./components/InsightBox.astro": "./components/InsightBox.astro",
+    "./components/KeyIdea.astro": "./components/KeyIdea.astro",
+    "./components/MarginNote.astro": "./components/MarginNote.astro",
+    "./components/NoteBox.astro": "./components/NoteBox.astro",
+    "./components/OpenQuestion.astro": "./components/OpenQuestion.astro",
+    "./components/PaperBox.astro": "./components/PaperBox.astro",
+    "./components/PatternTimeline.astro": "./components/PatternTimeline.astro",
+    "./components/Recovery.astro": "./components/Recovery.astro",
+    "./components/ResultBox.astro": "./components/ResultBox.astro",
+    "./components/Sidebar.astro": "./components/Sidebar.astro",
+    "./components/Sidenote.astro": "./components/Sidenote.astro",
+    "./components/SkillBox.astro": "./components/SkillBox.astro",
+    "./components/SourceArchive.astro": "./components/SourceArchive.astro",
+    "./components/StatusBadge.astro": "./components/StatusBadge.astro",
+    "./components/Tag.astro": "./components/Tag.astro",
+    "./components/Theorem.astro": "./components/Theorem.astro",
+    "./components/TipBox.astro": "./components/TipBox.astro",
+    "./components/ToolFilter": "./components/ToolFilter.tsx",
+    "./components/TryThis.astro": "./components/TryThis.astro",
+    "./components/VersionSelector": "./components/VersionSelector.tsx",
+    "./components/WarnBox.astro": "./components/WarnBox.astro",
+    "./components/WeekRef.astro": "./components/WeekRef.astro",
+    "./components/XRef.astro": "./components/XRef.astro",
+    "./styles/tokens.css": "./styles/tokens.css",
+    "./styles/layout.css": "./styles/layout.css",
+    "./styles/callouts.css": "./styles/callouts.css",
+    "./styles/chapter.css": "./styles/chapter.css",
+    "./styles/typography.css": "./styles/typography.css",
+    "./styles/print.css": "./styles/print.css",
+    "./styles/convergence.css": "./styles/convergence.css",
+    "./styles/tool-filter.css": "./styles/tool-filter.css",
+    "./layouts/Base.astro": "./layouts/Base.astro",
+    "./layouts/Chapter.astro": "./layouts/Chapter.astro",
+    "./lib": {
+      "types": "./dist/lib/katex-macros.d.ts",
+      "import": "./dist/lib/katex-macros.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "components",
+    "styles",
+    "layouts",
+    "pages",
+    "scripts",
+    "bin",
+    "recipes",
+    "pedagogy",
+    "examples",
+    "CLAUDE.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "astro": "^6.1.7",
+    "@astrojs/mdx": "^5.0.3",
+    "@astrojs/preact": "^5.1.1",
+    "preact": "^10.29.1"
+  },
+  "peerDependenciesMeta": {
+    "katex": { "optional": true },
+    "rehype-katex": { "optional": true },
+    "remark-math": { "optional": true }
+  },
+  "dependencies": {
+    "@citation-js/core": "^0.7.21",
+    "@citation-js/plugin-bibtex": "^0.7.21",
+    "@fontsource-variable/roboto": "^5.2.10",
+    "@fontsource-variable/source-code-pro": "^5.2.7",
+    "pagefind": "^1.5.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.0"
+  }
+}