@brandon_m_behring/book-scaffold-astro 4.30.0 → 5.0.0

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { AstroUserConfig, AstroIntegration, MarkdownHeading } from 'astro';
-import { c as BookConfigOptions, f as BookScaffoldIntegrationOptions, h as ChaptersRenderer, p as SiblingBooks, r as Style } from './types-DgSlAew3.js';
-export { B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, d as BookPreset, e as BookProfile, g as BookSchemasOptions, C as ChapterFor, F as FreshnessAffordance, i as FrontmatterRouteConfig, N as NUMBER_STYLES, j as NumberStyle, P as PartKey, k as PartialRouteToggles, l as ProfileDefinition, R as ReleaseStatusConfig, m as RouteToggles, S as SecurityHeadersConfig, n as SiblingBookDescriptor, o as SiblingBookEntry, q as StatusBadge, s as StyleInput, V as VolatilityBadge, t as composeStyles, u as defineProfile, v as defineStyle, w as normalizeFrontmatterConfig, x as resolvePreset, y as resolveProfile } from './types-DgSlAew3.js';
+import { c as BookConfigOptions, h as BookScaffoldIntegrationOptions, d as BookCorpus, l as CorpusApparatusRoute, e as BookCorpusInput, m as CorpusBook, k as ChaptersRenderer, v as SiblingBooks, x as Style } from './types-D1QZgKMO.js';
+export { B as BOOK_PRESETS, a as BOOK_PROFILES, b as BookConfigError, f as BookPreset, g as BookProfile, i as BookSchemasOptions, C as CORPUS_APPARATUS_ROUTES, j as ChapterFor, n as CorpusBookInput, F as FreshnessAffordance, o as FrontmatterRouteConfig, N as NUMBER_STYLES, p as NumberStyle, P as PartKey, q as PartialRouteToggles, r as ProfileDefinition, R as ReleaseStatusConfig, s as RouteToggles, S as SecurityHeadersConfig, t as SiblingBookDescriptor, u as SiblingBookEntry, w as StatusBadge, y as StyleInput, V as VolatilityBadge, z as composeStyles, A as defineProfile, D as defineStyle, E as normalizeFrontmatterConfig, G as resolvePreset, H as resolveProfile } from './types-D1QZgKMO.js';
 import { E as volatilityLevels, c as academicParts, Q as Question } from './schemas-CKipJ5Ie.js';
 export { A as AcademicChapter, B as BloomLevel, C as CourseNotesChapter, G as GlossaryTerm, M as MinimalChapter, P as Provenance, a as QuestionType, R as ResearchPortfolioChapter, T as ToolsChapter, b as academicChapterSchema, d as bloomLevels, e as changeKinds, f as changelogSchema, g as chapterStatus, h as citationBackstops, i as courseNotesChapterSchema, j as glossarySchema, l as layoutModes, m as minimalChapterSchema, p as patternCategories, k as patternsSchema, n as provenanceObject, o as provenanceSchema, q as questionDifficulties, r as questionSchema, s as questionTypes, t as refineQuestion, u as refinedQuestionSchema, v as researchPortfolioChapterSchema, w as sourceTiers, x as sourceTiersResearch, y as sourcesSchema, z as toolSlugs, D as toolsChapterSchema } from './schemas-CKipJ5Ie.js';
 export { KIND_LABEL, ResolvedTheoremLabel, THEOREM_KINDS, TheoremKind, TheoremLabelProps, resolveTheoremNumber, theoremLabel } from './lib/theorem-label.js';
 export { ssmMacros } from './lib/katex-macros.js';
 export { ChapterLike, apparatusHref, baseNoSlash, bookOf, chapterHref, isCurrentChapter, normalizeBase, slugOf } from './lib/nav-href.js';
-export { D as DomainScore, E as ExamBlueprint, a as ExamQuestion, b as ExamResult, R as RoutingChapter, c as buildExamManifest, d as deriveDomainRouting, s as sampleExam, e as scoreExam, f as shuffle, g as spreadBlueprint } from './exam-manifest-X9IrX1G3.js';
+export { D as DomainScore, E as ExamBlueprint, a as ExamQuestion, b as ExamResult, R as RoutingChapter, c as buildExamManifest, d as deriveDomainRouting, s as sampleExam, e as scoreExam, f as shuffle, g as spreadBlueprint } from './exam-manifest-DttY7kyZ.js';
 export { F as FlashcardRef, b as buildFlashcardDeck } from './flashcards-okekZcl8.js';
 import 'astro/zod';
 
@@ -30,6 +30,69 @@ declare function defineBookConfig(opts: BookConfigOptions): Promise<AstroUserCon
 
 declare function bookScaffoldIntegration(opts: BookScaffoldIntegrationOptions): AstroIntegration;
 
+/** Pure corpus-manifest validation and lookup helpers (#80). */
+
+/**
+ * First-segment names owned by application routes/assets or shared content
+ * collection roots rather than a corpus book.
+ */
+declare const RESERVED_CORPUS_BOOK_IDS: readonly ["assets", "chapters", "search", "questions", "glossary", "frontmatter", "_astro", "_og", "pagefind"];
+/**
+ * Public URL slug -> `RouteToggles` key. Keep this explicit: the public
+ * `practice-exam` route is intentionally not the camel-cased config key.
+ */
+declare const CORPUS_APPARATUS_TOGGLE_BY_ROUTE: Readonly<{
+    readonly references: "references";
+    readonly print: "print";
+    readonly convergence: "convergence";
+    readonly tips: "tips";
+    readonly exercises: "exercises";
+    readonly 'practice-exam': "practiceExam";
+    readonly glossary: "glossary";
+    readonly flashcards: "flashcards";
+    readonly answers: "answers";
+}>;
+/**
+ * Define and eagerly validate one homogeneous-preset book corpus.
+ *
+ * The returned value is safe to share between `astro.config.mjs` and
+ * `src/content.config.ts`; no filesystem or Astro virtual module is touched.
+ */
+declare function defineBookCorpus(inputValue: BookCorpusInput): BookCorpus;
+/** Validate that a value came from this major's `defineBookCorpus`. */
+declare function assertBookCorpus(value: unknown): asserts value is BookCorpus;
+/** Return the effective apparatus routes for one manifest book. */
+declare function corpusApparatusRoutesForBook(corpus: BookCorpus, bookId: string, inheritedRoutes?: readonly CorpusApparatusRoute[]): readonly CorpusApparatusRoute[];
+/** True when a public apparatus route is enabled for one manifest book. */
+declare function corpusBookHasApparatusRoute(corpus: BookCorpus, bookId: string, route: CorpusApparatusRoute, inheritedRoutes?: readonly CorpusApparatusRoute[]): boolean;
+/**
+ * Select the current book's payload from a v1 corpus artifact envelope.
+ * Single-book mode deliberately returns the input unchanged, preserving the
+ * legacy JSON contract byte-for-byte.
+ */
+declare function selectBookArtifact<Payload>(value: unknown, corpus: BookCorpus | null | undefined, bookId: string | null | undefined, artifact?: string): Payload;
+/** Resolve one manifest book or fail with the complete known-id set. */
+declare function resolveCorpusBook(corpus: BookCorpus, id: string): CorpusBook;
+/** Return the registered first entry-id segment, or null outside the corpus. */
+declare function corpusBookIdOf(corpus: BookCorpus, entryId: string): string | null;
+/** Strip the registered `<book>/` prefix from one collection entry id. */
+declare function localCorpusEntryId(corpus: BookCorpus, bookId: string, entryId: string): string;
+/** Filter content entries to the current registered book. */
+declare function filterCorpusEntries<Entry extends {
+    id: string;
+}>(entries: readonly Entry[], corpus: BookCorpus | null | undefined, bookId: string | null | undefined): Entry[];
+/**
+ * Derive a collision-safe collection id from a corpus-relative source path.
+ * A legacy `book:` field may agree with the path-derived owner, but can never
+ * override it; disagreement fails before schema parsing can silently strip it.
+ */
+declare function corpusCollectionEntryId(corpus: BookCorpus, entry: string, data: Record<string, unknown>, options?: {
+    label?: string;
+    slugField?: string;
+}): string;
+/** Resolve current book identity from canonical corpus routes. */
+declare function corpusBookIdFromPath(corpus: BookCorpus, pathname: string, baseUrl?: string): string | null;
+
 /**
  * Identity helper — consumers wrap their mdx-components map for TS inference.
  * Same pattern as Vite/Astro defineConfig: a generic identity function that
@@ -309,6 +372,13 @@ declare function assertEnumProp<T extends string>(value: unknown, allowed: reado
  * validator uses `labels` to check literal sibling path/fragment targets.
  */
 
+/**
+ * Resolve a link to another book inside the same corpus application.
+ *
+ * Chapter targets retain the scaffold's `/chapters/<book>/…` namespace;
+ * every other relative target lives below the book landing namespace.
+ */
+declare function resolveCorpusBookHref(book: string, to: string, baseUrl?: string): string;
 declare function resolveBookHref(siblingBooks: SiblingBooks | null | undefined, book: string, to: string): string;
 
 /**
@@ -496,11 +566,9 @@ declare const academicStyle: Style;
 declare const toolsStyle: Style;
 /** Minimal preset — single-author essays / manifestos. */
 declare const minimalStyle: Style;
-/** Course-notes preset — chapters derived from a video course / MOOC / book.
- *  `deploy` is retained as deprecated metadata only (#180). */
+/** Course-notes preset — chapters derived from a video course / MOOC / book. */
 declare const courseNotesStyle: Style;
-/** Research-portfolio preset — academic structure + tools-style provenance + portfolio components.
- *  `deploy` is retained as deprecated metadata only (#180); frontmatter routes remain enabled. */
+/** Research-portfolio preset — academic structure + tools-style provenance + portfolio components. */
 declare const researchPortfolioStyle: Style;
 /**
  * Registry of all toolkit-shipped styles, keyed by their preset name.
@@ -567,4 +635,4 @@ type TipsConfigInput = Omit<TipsConfig, typeof TipsConfigBrand | '__tipsConfigVe
  */
 declare function defineTips(opts: TipsConfigInput): TipsConfig;
 
-export { ACADEMIC_PART_NAMES, BRANDON_PORTFOLIO_DEFAULT, BUILTIN_STYLES, BookConfigOptions, BookScaffoldIntegrationOptions, ChaptersRenderer, DEFAULT_GITHUB_BRANCH, type Freshness, type FreshnessStatus, type PartReviewGroup, type PartReviewSelection, Question, type ReviewChapter, type ReviewExercise, SiblingBooks, Style, type TipsConfig, type TipsConfigInput, UNKNOWN_PART_ORDINAL, type VisibleHeading, type VolatilityLevel, academicChaptersRenderer, academicPartHeading, academicPartName, academicPartOrdinal, academicParts, academicStyle, assertEnumProp, assertKnownDomain, bookScaffoldIntegration, buildGithubUrl, chapterLabel, chapterSortKey, courseNotesStyle, defineBookConfig, defineMdxComponents, defineTips, deriveObjectiveMap, distinctChaptersSorted, fallbackChaptersRenderer, freshnessLabel, getFreshness, groupByChapter, groupByDomain, minimalStyle, originUrlFromGitConfig, parseRepoSlug, pickActive, researchPortfolioChaptersRenderer, researchPortfolioStyle, resolveBookHref, resolveGithubRepo, selectPartExercises, sortQuestions, tocHeadings, toolsChaptersRenderer, toolsStyle, volatilityLevels };
+export { ACADEMIC_PART_NAMES, BRANDON_PORTFOLIO_DEFAULT, BUILTIN_STYLES, BookConfigOptions, BookCorpus, BookCorpusInput, BookScaffoldIntegrationOptions, CORPUS_APPARATUS_TOGGLE_BY_ROUTE, ChaptersRenderer, CorpusApparatusRoute, CorpusBook, DEFAULT_GITHUB_BRANCH, type Freshness, type FreshnessStatus, type PartReviewGroup, type PartReviewSelection, Question, RESERVED_CORPUS_BOOK_IDS, type ReviewChapter, type ReviewExercise, SiblingBooks, Style, type TipsConfig, type TipsConfigInput, UNKNOWN_PART_ORDINAL, type VisibleHeading, type VolatilityLevel, academicChaptersRenderer, academicPartHeading, academicPartName, academicPartOrdinal, academicParts, academicStyle, assertBookCorpus, assertEnumProp, assertKnownDomain, bookScaffoldIntegration, buildGithubUrl, chapterLabel, chapterSortKey, corpusApparatusRoutesForBook, corpusBookHasApparatusRoute, corpusBookIdFromPath, corpusBookIdOf, corpusCollectionEntryId, courseNotesStyle, defineBookConfig, defineBookCorpus, defineMdxComponents, defineTips, deriveObjectiveMap, distinctChaptersSorted, fallbackChaptersRenderer, filterCorpusEntries, freshnessLabel, getFreshness, groupByChapter, groupByDomain, localCorpusEntryId, minimalStyle, originUrlFromGitConfig, parseRepoSlug, pickActive, researchPortfolioChaptersRenderer, researchPortfolioStyle, resolveBookHref, resolveCorpusBook, resolveCorpusBookHref, resolveGithubRepo, selectBookArtifact, selectPartExercises, sortQuestions, tocHeadings, toolsChaptersRenderer, toolsStyle, volatilityLevels };