@brandon_m_behring/book-scaffold-astro 4.30.0 → 5.0.0

package/dist/schemas.d.ts

@@ -1,5 +1,5 @@
 import { defineCollection } from 'astro:content';
-import { g as BookSchemasOptions } from './types-DgSlAew3.js';
+import { i as BookSchemasOptions } from './types-D1QZgKMO.js';
 import 'astro';
 import './schemas-CKipJ5Ie.js';
 import 'astro/zod';

package/dist/schemas.mjs

@@ -1,5 +1,5 @@
 // src/schemas-entry.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync } from "fs";
 import { defineCollection } from "astro:content";
 import { glob, file } from "astro/loaders";
 
@@ -790,6 +790,17 @@ var BOOK_PROFILES = Object.keys(PROFILES);
 // src/types.ts
 import { existsSync, readFileSync } from "fs";
 var BOOK_PRESETS = BOOK_PROFILES;
+var CORPUS_APPARATUS_ROUTES = [
+  "references",
+  "print",
+  "convergence",
+  "tips",
+  "exercises",
+  "practice-exam",
+  "glossary",
+  "flashcards",
+  "answers"
+];
 var BookConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -814,36 +825,230 @@ function readEnvFile(path = ".env") {
     return {};
   }
 }
-var PRESET_FALLBACK_WARNING = /* @__PURE__ */ Symbol.for("book-scaffold-astro:preset-fallback-warning");
 function resolvePreset(explicitPreset, explicitProfile) {
   let candidate = explicitPreset ?? explicitProfile ?? process.env.BOOK_PRESET ?? process.env.BOOK_PROFILE;
-  let source = "default";
-  if (explicitPreset || explicitProfile) source = "param";
-  else if (process.env.BOOK_PRESET || process.env.BOOK_PROFILE) source = "env";
   if (!candidate) {
     const env = readEnvFile();
     const fromFile = env.BOOK_PRESET ?? env.BOOK_PROFILE;
     if (fromFile) {
       candidate = fromFile;
-      source = "dotenv";
     }
   }
-  candidate = candidate ?? "minimal";
+  if (!candidate) {
+    throw new BookConfigError(
+      `book-scaffold-astro: no book preset was resolved. Add a built-in Style to \`defineBookConfig({ styles: [...] })\` and pass the same preset to \`defineBookSchemas({ preset: "..." })\`, pass one \`defineBookCorpus\` manifest to both entrypoints, or set BOOK_PRESET in the environment or .env. Valid presets: ${BOOK_PRESETS.join(" | ")}. See https://github.com/brandon-behring/book-scaffold-astro/blob/main/package/MIGRATION-v4-to-v5.md.`
+    );
+  }
   if (!BOOK_PRESETS.includes(candidate)) {
     throw new BookConfigError(
       `preset must be one of ${BOOK_PRESETS.join(" | ")} (got ${JSON.stringify(candidate)})`
     );
   }
-  if (source === "default") {
-    const warningState = globalThis;
-    if (!warningState[PRESET_FALLBACK_WARNING]) {
-      warningState[PRESET_FALLBACK_WARNING] = true;
-      console.warn(
-        "book-scaffold-astro: no preset resolved; falling back to 'minimal' for v4 compatibility. This fallback will be removed in v5. Add a built-in style to defineBookConfig and pass the same preset to defineBookSchemas, or set BOOK_PRESET."
-      );
+  return candidate;
+}
+
+// src/lib/corpus.ts
+var BOOK_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+var BOOK_CORPUS_BRAND = /* @__PURE__ */ Symbol.for(
+  "@brandon_m_behring/book-scaffold-astro/BookCorpus/v1"
+);
+var RESERVED_CORPUS_BOOK_IDS = Object.freeze([
+  "assets",
+  "chapters",
+  "search",
+  "questions",
+  "glossary",
+  "frontmatter",
+  "_astro",
+  "_og",
+  "pagefind"
+]);
+var CORPUS_OWNED_ROUTE_FIELDS = Object.freeze([
+  "chapterRoute",
+  "bookField",
+  "apparatusRoute",
+  "apparatusRoutes"
+]);
+var CORPUS_APPARATUS_TOGGLE_BY_ROUTE = Object.freeze({
+  references: "references",
+  print: "print",
+  convergence: "convergence",
+  tips: "tips",
+  exercises: "exercises",
+  "practice-exam": "practiceExam",
+  glossary: "glossary",
+  flashcards: "flashcards",
+  answers: "answers"
+});
+var RESERVED = new Set(RESERVED_CORPUS_BOOK_IDS);
+var APPARATUS = new Set(CORPUS_APPARATUS_ROUTES);
+var RESERVED_CONTENT_ROOTS = Object.freeze({
+  questions: "src/content/questions/ is the dedicated questions collection root",
+  glossary: "src/content/glossary/ is the dedicated glossary collection root",
+  frontmatter: "src/content/frontmatter/ is the shared frontmatter collection root"
+});
+var BRANDED_CORPUS_KEYS = /* @__PURE__ */ new Set(["__bookCorpusVersion", "preset", "books"]);
+var BOOK_KEYS = /* @__PURE__ */ new Set([
+  "id",
+  "title",
+  "subtitle",
+  "description",
+  "author",
+  "image",
+  "apparatus"
+]);
+function objectRecord(value, label) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new BookConfigError(`${label} must be an object.`);
+  }
+  return value;
+}
+function rejectUnknownKeys(value, allowed, label) {
+  const unknown = Object.keys(value).filter((key) => !allowed.has(key));
+  if (unknown.length > 0) {
+    throw new BookConfigError(
+      `${label} has unknown field${unknown.length === 1 ? "" : "s"}: ${unknown.join(", ")}.`
+    );
+  }
+}
+function optionalNonBlankString(value, label) {
+  if (value === void 0) return void 0;
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new BookConfigError(`${label} must be a non-blank string when provided.`);
+  }
+  return value;
+}
+function validateBook(value, index) {
+  const label = `defineBookCorpus books[${index}]`;
+  const input = objectRecord(value, label);
+  rejectUnknownKeys(input, BOOK_KEYS, label);
+  const id = optionalNonBlankString(input.id, `${label}.id`);
+  if (id === void 0 || !BOOK_ID.test(id)) {
+    throw new BookConfigError(
+      `${label}.id must match [a-z0-9]+(?:-[a-z0-9]+)* (got ${JSON.stringify(input.id)}).`
+    );
+  }
+  if (RESERVED.has(id)) {
+    const reason = RESERVED_CONTENT_ROOTS[id] ?? "the scaffold owns that route or asset namespace";
+    throw new BookConfigError(
+      `${label}.id ${JSON.stringify(id)} is reserved because ${reason}; choose a book-specific id.`
+    );
+  }
+  const title = optionalNonBlankString(input.title, `${label}.title`);
+  if (title === void 0) {
+    throw new BookConfigError(`${label}.title must be a non-blank string.`);
+  }
+  let apparatus;
+  if (input.apparatus !== void 0) {
+    if (!Array.isArray(input.apparatus)) {
+      throw new BookConfigError(`${label}.apparatus must be an array when provided.`);
+    }
+    const seen = /* @__PURE__ */ new Set();
+    const routes = [];
+    for (const route of input.apparatus) {
+      if (typeof route !== "string" || !APPARATUS.has(route)) {
+        throw new BookConfigError(
+          `${label}.apparatus contains ${JSON.stringify(route)}; expected a subset of ` + CORPUS_APPARATUS_ROUTES.join(" | ") + "."
+        );
+      }
+      if (seen.has(route)) {
+        throw new BookConfigError(`${label}.apparatus contains duplicate route ${JSON.stringify(route)}.`);
+      }
+      seen.add(route);
+      routes.push(route);
     }
+    apparatus = Object.freeze(routes);
+  }
+  const book = {
+    id,
+    title,
+    ...optionalField("subtitle", optionalNonBlankString(input.subtitle, `${label}.subtitle`)),
+    ...optionalField("description", optionalNonBlankString(input.description, `${label}.description`)),
+    ...optionalField("author", optionalNonBlankString(input.author, `${label}.author`)),
+    ...optionalField("image", optionalNonBlankString(input.image, `${label}.image`)),
+    ...apparatus === void 0 ? {} : { apparatus }
+  };
+  return Object.freeze(book);
+}
+function optionalField(key, value) {
+  return value === void 0 ? {} : { [key]: value };
+}
+function assertBookCorpus(value) {
+  const invalid = () => new BookConfigError(
+    "corpus must be created by defineBookCorpus() from this book-scaffold major."
+  );
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw invalid();
+  }
+  const input = value;
+  if (input[BOOK_CORPUS_BRAND] !== true || input.__bookCorpusVersion !== 1 || !Object.isFrozen(value) || !Object.isFrozen(input.books)) {
+    throw invalid();
+  }
+  try {
+    rejectUnknownKeys(input, BRANDED_CORPUS_KEYS, "corpus");
+    if (typeof input.preset !== "string" || !BOOK_PRESETS.includes(input.preset)) {
+      throw invalid();
+    }
+    if (!Array.isArray(input.books) || input.books.length === 0) throw invalid();
+    const seen = /* @__PURE__ */ new Set();
+    for (const [index, rawBook] of input.books.entries()) {
+      if (!Object.isFrozen(rawBook)) throw invalid();
+      const book = validateBook(rawBook, index);
+      if (seen.has(book.id)) throw invalid();
+      seen.add(book.id);
+      if (book.apparatus !== void 0) {
+        const original = rawBook.apparatus;
+        if (!Object.isFrozen(original)) throw invalid();
+      }
+    }
+  } catch (error) {
+    if (error instanceof BookConfigError && error.message.startsWith("corpus must be created")) {
+      throw error;
+    }
+    throw invalid();
   }
-  return candidate;
+}
+function corpusCollectionEntryId(corpus, entry, data, options = {}) {
+  const label = options.label ?? "Content entry";
+  const normalized = entry.replaceAll("\\", "/").replace(/^\.\//, "");
+  const [bookId, ...localParts] = normalized.split("/");
+  if (!bookId || !corpus.books.some((book) => book.id === bookId)) {
+    throw new Error(`${label} ${JSON.stringify(entry)} is outside the registered corpus books.`);
+  }
+  if (Object.prototype.hasOwnProperty.call(data, "book") && data.book !== bookId) {
+    throw new Error(
+      `${label} ${JSON.stringify(entry)} has frontmatter book ${JSON.stringify(data.book)}, but its registered path owner is ${JSON.stringify(bookId)}.`
+    );
+  }
+  const fileId = localParts.join("/").replace(/\.(?:md|mdx)$/i, "");
+  const configured = options.slugField ? data[options.slugField] : void 0;
+  const localId = typeof configured === "string" ? configured : fileId;
+  const localSegments = localId.split("/");
+  let hasInvalidEncodedSegment = false;
+  for (const segment of localSegments) {
+    try {
+      const decoded = decodeURIComponent(segment);
+      if (decoded === "." || decoded === ".." || decoded.includes("/") || decoded.includes("\\")) {
+        hasInvalidEncodedSegment = true;
+      }
+    } catch {
+      hasInvalidEncodedSegment = true;
+    }
+  }
+  if (localId.length === 0 || localId.startsWith("/") || localId.endsWith("/") || localId.includes("\\") || localSegments.some((part) => part === "." || part === ".." || part.length === 0) || hasInvalidEncodedSegment) {
+    throw new Error(
+      `${label} ${JSON.stringify(entry)} resolved invalid corpus id ${JSON.stringify(localId)}.`
+    );
+  }
+  return `${bookId}/${localId}`;
+}
+
+// src/lib/corpus-collateral.ts
+function corpusPatternsCollection(bookId) {
+  return `corpus-patterns-${bookId}`;
+}
+function corpusChangelogCollection(bookId) {
+  return `corpus-changelog-${bookId}`;
 }
 
 // src/schemas-entry.ts
@@ -856,6 +1061,30 @@ function isYamlEmpty(path) {
     return false;
   }
 }
+function assertCorpusConvergenceLayout(books) {
+  const registered = new Set(books.map((book) => book.id));
+  const legacy = existsSync2("./changelog/patterns.yaml") ? ["./changelog/patterns.yaml"] : [];
+  if (existsSync2("./changelog/tools") && readdirSync("./changelog/tools", { withFileTypes: true }).some(
+    (entry) => entry.isFile() && entry.name.endsWith(".yaml") && !(registered.has("tools") && entry.name === "patterns.yaml")
+  )) {
+    legacy.push("./changelog/tools/*.yaml");
+  }
+  if (legacy.length > 0) {
+    throw new Error(
+      `Corpus convergence collateral must be book-owned; move ${legacy.join(" and ")} to changelog/<book>/patterns.yaml and changelog/<book>/tools/.`
+    );
+  }
+  if (!existsSync2("./changelog")) return;
+  for (const entry of readdirSync("./changelog", { withFileTypes: true })) {
+    if (!entry.isDirectory() || registered.has(entry.name)) continue;
+    const base = `./changelog/${entry.name}`;
+    if (existsSync2(`${base}/patterns.yaml`) || existsSync2(`${base}/tools`)) {
+      throw new Error(
+        `Corpus convergence collateral owner ${JSON.stringify(entry.name)} is not a registered book. Known books: ${books.map((book) => book.id).join(", ")}.`
+      );
+    }
+  }
+}
 function frontmatterCollection(schema, base = "./src/content/frontmatter") {
   return defineCollection({
     loader: glob({
@@ -866,14 +1095,33 @@ function frontmatterCollection(schema, base = "./src/content/frontmatter") {
   });
 }
 function defineBookSchemas(opts = {}) {
-  const profile = resolvePreset(opts.preset, opts.profile);
-  const chaptersBase = opts.chaptersBase ?? "./src/content/chapters";
+  const corpus = opts.corpus;
+  if (corpus !== void 0) assertBookCorpus(corpus);
+  const explicitProfile = opts.preset ?? opts.profile;
+  if (corpus && explicitProfile !== void 0 && explicitProfile !== corpus.preset) {
+    throw new Error(
+      `defineBookSchemas preset ${JSON.stringify(explicitProfile)} does not match corpus preset ${JSON.stringify(corpus.preset)}.`
+    );
+  }
+  const profile = corpus?.preset ?? resolvePreset(opts.preset, opts.profile);
+  const chaptersBase = opts.chaptersBase ?? (corpus ? "./src/content" : "./src/content/chapters");
   const schemaForProfile = profile === "academic" ? academicChapterSchema : profile === "course-notes" ? courseNotesChapterSchema : profile === "research-portfolio" ? researchPortfolioChapterSchema : profile === "minimal" ? minimalChapterSchema : toolsChapterSchema;
   const chapters = defineCollection({
     loader: glob({
       // Exclude underscore-prefixed files (standard "hidden" convention).
-      pattern: ["**/*.{md,mdx}", "!**/_*"],
-      base: chaptersBase
+      pattern: corpus ? [
+        ...corpus.books.map((book) => `${book.id}/**/*.{md,mdx}`),
+        "!**/_*"
+      ] : ["**/*.{md,mdx}", "!**/_*"],
+      base: chaptersBase,
+      ...corpus ? {
+        generateId: ({ entry, data }) => {
+          return corpusCollectionEntryId(corpus, entry, data, {
+            label: "Chapter",
+            slugField: "slug"
+          });
+        }
+      } : {}
     }),
     schema: schemaForProfile
   });
@@ -886,23 +1134,49 @@ function defineBookSchemas(opts = {}) {
       schema: sourcesSchema
     });
   }
-  if (existsSync2("./changelog/tools")) {
-    collections.changelog = defineCollection({
-      loader: glob({ pattern: "*.yaml", base: "./changelog/tools" }),
-      schema: changelogSchema
-    });
-  }
-  if (existsSync2("./changelog/patterns.yaml")) {
-    collections.patterns = defineCollection({
-      loader: file("changelog/patterns.yaml"),
-      schema: patternsSchema
-    });
+  if (corpus) {
+    assertCorpusConvergenceLayout(corpus.books);
+    for (const book of corpus.books) {
+      const changelogBase = `./changelog/${book.id}/tools`;
+      if (existsSync2(changelogBase)) {
+        collections[corpusChangelogCollection(book.id)] = defineCollection({
+          loader: glob({ pattern: "*.yaml", base: changelogBase }),
+          schema: changelogSchema
+        });
+      }
+      const patternsPath = `changelog/${book.id}/patterns.yaml`;
+      if (existsSync2(`./${patternsPath}`)) {
+        collections[corpusPatternsCollection(book.id)] = defineCollection({
+          loader: file(patternsPath),
+          schema: patternsSchema
+        });
+      }
+    }
+  } else {
+    if (existsSync2("./changelog/tools")) {
+      collections.changelog = defineCollection({
+        loader: glob({ pattern: "*.yaml", base: "./changelog/tools" }),
+        schema: changelogSchema
+      });
+    }
+    if (existsSync2("./changelog/patterns.yaml")) {
+      collections.patterns = defineCollection({
+        loader: file("changelog/patterns.yaml"),
+        schema: patternsSchema
+      });
+    }
   }
   if (existsSync2("./src/content/questions")) {
     collections.questions = defineCollection({
       loader: glob({
+        // In corpus mode this intentionally scans the entire dedicated root.
+        // `generateId` is the ownership boundary: a flat file or an unknown
+        // first directory must fail instead of disappearing from the loader.
         pattern: ["**/*.{md,mdx}", "!**/_*"],
-        base: "./src/content/questions"
+        base: "./src/content/questions",
+        ...corpus ? {
+          generateId: ({ entry, data }) => corpusCollectionEntryId(corpus, entry, data, { label: "Question" })
+        } : {}
       }),
       schema: refinedQuestionSchema
     });
@@ -910,8 +1184,13 @@ function defineBookSchemas(opts = {}) {
   if (existsSync2("./src/content/glossary")) {
     collections.glossary = defineCollection({
       loader: glob({
+        // As with questions, discover all non-hidden entries so malformed
+        // corpus ownership is rejected rather than silently ignored.
         pattern: ["**/*.{md,mdx}", "!**/_*"],
-        base: "./src/content/glossary"
+        base: "./src/content/glossary",
+        ...corpus ? {
+          generateId: ({ entry, data }) => corpusCollectionEntryId(corpus, entry, data, { label: "Glossary term" })
+        } : {}
       }),
       schema: glossarySchema
     });

package/dist/{types-DgSlAew3.d.ts → types-D1QZgKMO.d.ts}

@@ -302,8 +302,8 @@ type ChapterFor<P extends BookProfile> = P extends 'academic' ? AcademicChapter
  *   - Version marker (`__styleVersion`) — future API-shape changes can
  *     be detected at composition time without breaking existing styles.
  *
- * See `recipes/15-defining-styles.md` for usage patterns + MIGRATION-v3-to-v4.md
- * for migration from the v3 `preset:` shorthand.
+ * See `recipes/15-defining-styles.md` for usage patterns and the migration
+ * guides for version-specific breaking changes.
  */
 
 /** Internal brand symbol — prevents confusion between Style and plain config objects.
@@ -376,11 +376,6 @@ interface Style {
      *  `remarkPlugins` and `rehypePlugins` arrays concat across the chain;
      *  scalar fields override. */
     readonly markdown?: AstroUserConfig['markdown'];
-    /** Reserved legacy metadata. It is composed but has no runtime or
-     *  create-book effect: create-book chooses wrangler.toml from its CLI
-     *  preset before a consumer Style exists (#180).
-     *  @deprecated Inert in v4; scheduled for removal in v5. */
-    readonly deploy?: 'pages' | 'workers';
     /**
      * v4.26.2 (#149; style inheritance fixed in v4.26.3): release-state
      * banner. Shallow override (last defined wins); `false` suppresses a
@@ -417,7 +412,6 @@ type StyleInput = Omit<Style, typeof StyleBrand | '__styleVersion'>;
  *     preset: 'research-portfolio',
  *     site: 'https://guides.brandon-behring.dev/',
  *     routes: { frontmatter: { enabled: true, prefix: '' } },
- *     deploy: 'pages',
  *   });
  *
  *   // guides/foo/astro.config.mjs
@@ -447,7 +441,7 @@ declare function defineStyle(opts: StyleInput): Style;
  *   - Top-level `defineBookConfig` fields beat any style (handled in config.ts)
  *
  * Per-key merge strategy:
- *   - `preset`, `numberStyle`, `site`, `deploy`, `mdxComponentsModule`, `name`, `releaseStatus`
+ *   - `preset`, `numberStyle`, `site`, `mdxComponentsModule`, `name`, `releaseStatus`
  *     → shallow override (last defined wins; `releaseStatus: false` suppresses)
  *   - `routes` → per-route spread (each route key independently overridable)
  *   - `katexMacros` → per-macro spread (each macro key independently overridable)
@@ -487,6 +481,44 @@ declare const BOOK_PRESETS: readonly ("academic" | "tools" | "minimal" | "course
 /** Theorem-family numbering strategy used by build-labels and validate. */
 type NumberStyle = 'shared' | 'per-kind';
 declare const NUMBER_STYLES: readonly ["shared", "per-kind"];
+/** Scaffold-owned book routes that may be enabled per corpus book (#80). */
+declare const CORPUS_APPARATUS_ROUTES: readonly ["references", "print", "convergence", "tips", "exercises", "practice-exam", "glossary", "flashcards", "answers"];
+type CorpusApparatusRoute = (typeof CORPUS_APPARATUS_ROUTES)[number];
+/** Consumer-authored metadata for one book in a corpus manifest. */
+interface CorpusBookInput {
+    id: string;
+    title: string;
+    subtitle?: string;
+    description?: string;
+    author?: string;
+    image?: string;
+    apparatus?: readonly CorpusApparatusRoute[];
+}
+/** Frozen, validated book metadata returned by `defineBookCorpus`. */
+interface CorpusBook extends Omit<CorpusBookInput, 'apparatus'> {
+    readonly id: string;
+    readonly title: string;
+    readonly subtitle?: string;
+    readonly description?: string;
+    readonly author?: string;
+    readonly image?: string;
+    readonly apparatus?: readonly CorpusApparatusRoute[];
+}
+/** Input accepted by `defineBookCorpus`. One preset applies to the whole app. */
+interface BookCorpusInput {
+    preset: BookPreset;
+    books: readonly CorpusBookInput[];
+}
+/**
+ * Branded, deeply frozen corpus registry shared by Astro and content config.
+ * The string version marker is intentionally serializable through Vite's
+ * virtual module and inspectable by plain-Node CLI tooling.
+ */
+interface BookCorpus {
+    readonly __bookCorpusVersion: 1;
+    readonly preset: BookPreset;
+    readonly books: readonly CorpusBook[];
+}
 /**
  * A sibling book with an optional vendored label index for cross-book
  * `<BookLink>` validation (#147).
@@ -573,6 +605,12 @@ interface BookConfigOptions {
      *   });
      */
     styles?: readonly Style[];
+    /**
+     * v5.0.0 (#80): opt into one-app/one-build corpus mode. Define the value
+     * once with `defineBookCorpus` and pass the same object to
+     * `defineBookSchemas({ corpus })`.
+     */
+    corpus?: BookCorpus;
     /**
      * v4.27.0 (#175): theorem-family counter strategy. `shared` preserves the
      * amsthm-style sequence used through v4.26; `per-kind` gives theorem,
@@ -593,16 +631,6 @@ interface BookConfigOptions {
      * Closes #3 (v3.3.0).
      */
     routes?: PartialRouteToggles;
-    /**
-     * v4.0.0 (#50): RESERVED — accepted and style-chain-merged, but currently
-     * has NO runtime effect (#180). The wrangler.toml shape is decided once, at
-     * scaffold time, by `create-book` from the profile name (academic/tools/
-     * minimal → Workers; course-notes/research-portfolio → Pages); setting this
-     * field changes nothing afterward. Wire-or-remove is a v5 decision.
-     * @deprecated Inert in v4; remove this option before v5. Deployment shape
-     * is chosen by create-book or by the consumer's own deployment files.
-     */
-    deploy?: 'pages' | 'workers';
     /**
      * Optional explicit path to the consumer's MDX-components map (relative
      * to project root). When omitted, the toolkit auto-detects one of
@@ -819,12 +847,16 @@ interface BookSchemasOptions {
     preset?: BookPreset;
     /** Backward-compat alias for `preset`. */
     profile?: BookProfile;
-    /** Defaults to `'./src/content/chapters'`. */
+    /** Defaults to `'./src/content/chapters'`, or `'./src/content'` in corpus mode. */
     chaptersBase?: string;
+    /** v5.0.0 (#80): the same branded manifest passed to `defineBookConfig`. */
+    corpus?: BookCorpus;
 }
 /** Options for the internal `bookScaffoldIntegration`. See PACKAGE_DESIGN.md §6. */
 interface BookScaffoldIntegrationOptions {
     profile: BookProfile;
+    /** v5.0.0 (#80): resolved one-app corpus manifest. */
+    corpus?: BookCorpus;
     /** Resolved theorem-family counter strategy exposed to package CLI tooling. */
     numberStyle?: NumberStyle;
     /**
@@ -903,6 +935,26 @@ interface BookScaffoldIntegrationOptions {
 declare class BookConfigError extends Error {
     constructor(message: string);
 }
+/**
+ * Resolve a required preset from explicit args → env → .env.
+ * Throws when the selected value is invalid or every source is absent.
+ *
+ * v3.4.0 (closes #9): canonical resolver. Accepts both `preset` and `profile`
+ * (back-compat) explicit args; reads both `BOOK_PRESET` (preferred) and
+ * `BOOK_PROFILE` (alias) env vars; same for .env file lookups.
+ *
+ * Resolution order:
+ *   1. explicitPreset (from defineBookConfig({ preset: ... }))
+ *   2. explicitProfile (from defineBookConfig({ profile: ... }))
+ *   3. process.env.BOOK_PRESET
+ *   4. process.env.BOOK_PROFILE
+ *   5. .env BOOK_PRESET
+ *   6. .env BOOK_PROFILE
+ *
+ * v5.0.0 (#212): there is deliberately no implicit `minimal` fallback. A
+ * missing preset can otherwise make CI validate and render against a schema
+ * that the author never selected.
+ */
 declare function resolvePreset(explicitPreset?: BookPreset, explicitProfile?: BookProfile): BookPreset;
 /**
  * Backward-compat alias. New code should use `resolvePreset()`.
@@ -911,4 +963,4 @@ declare function resolvePreset(explicitPreset?: BookPreset, explicitProfile?: Bo
  */
 declare function resolveProfile(explicit?: BookProfile): BookProfile;
 
-export { BOOK_PRESETS as B, type ChapterFor as C, type FreshnessAffordance as F, NUMBER_STYLES as N, type PartKey as P, type ReleaseStatusConfig as R, type SecurityHeadersConfig as S, type VolatilityBadge as V, BOOK_PROFILES as a, BookConfigError as b, type BookConfigOptions as c, type BookPreset as d, type BookProfile as e, type BookScaffoldIntegrationOptions as f, type BookSchemasOptions as g, type ChaptersRenderer as h, type FrontmatterRouteConfig as i, type NumberStyle as j, type PartialRouteToggles as k, type ProfileDefinition as l, type RouteToggles as m, type SiblingBookDescriptor as n, type SiblingBookEntry as o, type SiblingBooks as p, type StatusBadge as q, type Style as r, type StyleInput as s, composeStyles as t, defineProfile as u, defineStyle as v, normalizeFrontmatterConfig as w, resolvePreset as x, resolveProfile as y };
+export { defineProfile as A, BOOK_PRESETS as B, CORPUS_APPARATUS_ROUTES as C, defineStyle as D, normalizeFrontmatterConfig as E, type FreshnessAffordance as F, resolvePreset as G, resolveProfile as H, NUMBER_STYLES as N, type PartKey as P, type ReleaseStatusConfig as R, type SecurityHeadersConfig as S, type VolatilityBadge as V, BOOK_PROFILES as a, BookConfigError as b, type BookConfigOptions as c, type BookCorpus as d, type BookCorpusInput as e, type BookPreset as f, type BookProfile as g, type BookScaffoldIntegrationOptions as h, type BookSchemasOptions as i, type ChapterFor as j, type ChaptersRenderer as k, type CorpusApparatusRoute as l, type CorpusBook as m, type CorpusBookInput as n, type FrontmatterRouteConfig as o, type NumberStyle as p, type PartialRouteToggles as q, type ProfileDefinition as r, type RouteToggles as s, type SiblingBookDescriptor as t, type SiblingBookEntry as u, type SiblingBooks as v, type StatusBadge as w, type Style as x, type StyleInput as y, composeStyles as z };