@cbnventures/docusaurus-preset-nova 0.17.0 → 0.19.0

package/nova-config.d.ts

@@ -6,106 +6,120 @@ import type {
   RouteConfig,
 } from '@docusaurus/types';
 
-// Primary brand color — hex format (e.g., "#DC2626").
-export type NovaPresetOverridesColorsPrimary = string | undefined;
+// Primary brand color - light mode hex (e.g., "#DC2626").
+export type NovaPresetOverridesColorsPrimaryLight = string | undefined;
 
-// Accent color for highlights and CTAs — hex format (e.g., "#FFBA33").
-export type NovaPresetOverridesColorsAccent = string | undefined;
+// Primary brand color - dark mode hex (e.g., "#F87171").
+export type NovaPresetOverridesColorsPrimaryDark = string | undefined;
 
-// Neutral color for borders and muted text — hex format (e.g., "#78716C").
-export type NovaPresetOverridesColorsNeutral = string | undefined;
+// Primary brand color override - light/dark hex pair.
+export type NovaPresetOverridesColorsPrimary = {
+  light: NovaPresetOverridesColorsPrimaryLight;
+  dark: NovaPresetOverridesColorsPrimaryDark;
+};
 
-// Brand color overrides.
-export type NovaPresetOverridesColors = {
-  primary: NovaPresetOverridesColorsPrimary;
-  accent: NovaPresetOverridesColorsAccent;
-  neutral: NovaPresetOverridesColorsNeutral;
+// Secondary accent color - light mode hex (e.g., "#FBBF24").
+export type NovaPresetOverridesColorsSecondaryLight = string | undefined;
+
+// Secondary accent color - dark mode hex (e.g., "#FBBF24").
+export type NovaPresetOverridesColorsSecondaryDark = string | undefined;
+
+// Secondary accent color override - light/dark hex pair.
+export type NovaPresetOverridesColorsSecondary = {
+  light: NovaPresetOverridesColorsSecondaryLight;
+  dark: NovaPresetOverridesColorsSecondaryDark;
 };
 
-// Display/heading font family (e.g., "Sora", "Plus Jakarta Sans").
-export type NovaPresetOverridesFontsDisplay = string | undefined;
+// Body text color - light mode hex (e.g., "#1C1917").
+export type NovaPresetOverridesColorsTextLight = string | undefined;
 
-// Body text font family (e.g., "Inter", "DM Sans").
-export type NovaPresetOverridesFontsBody = string | undefined;
+// Body text color - dark mode hex (e.g., "#E7E5E4").
+export type NovaPresetOverridesColorsTextDark = string | undefined;
 
-// Code/monospace font family (e.g., "Fira Code", "JetBrains Mono").
-export type NovaPresetOverridesFontsCode = string | undefined;
+// Body text color override - light/dark hex pair.
+export type NovaPresetOverridesColorsText = {
+  light: NovaPresetOverridesColorsTextLight;
+  dark: NovaPresetOverridesColorsTextDark;
+};
 
-// Font family overrides.
-export type NovaPresetOverridesFonts = {
-  display: NovaPresetOverridesFontsDisplay;
-  body: NovaPresetOverridesFontsBody;
-  code: NovaPresetOverridesFontsCode;
+// Border and divider color - light mode hex (e.g., "#D6D3D1").
+export type NovaPresetOverridesColorsBorderLight = string | undefined;
+
+// Border and divider color - dark mode hex (e.g., "#44403C").
+export type NovaPresetOverridesColorsBorderDark = string | undefined;
+
+// Border and divider color override - light/dark hex pair.
+export type NovaPresetOverridesColorsBorder = {
+  light: NovaPresetOverridesColorsBorderLight;
+  dark: NovaPresetOverridesColorsBorderDark;
 };
 
-// Border radius style.
-export type NovaPresetOverridesShapeRadius = 'sharp' | 'rounded' | 'pill' | undefined;
+// Warning admonition color - light mode hex (e.g., "#F59E0B").
+export type NovaPresetOverridesColorsWarningLight = string | undefined;
 
-// Spacing density — affects padding and margins.
-export type NovaPresetOverridesShapeDensity = 'compact' | 'comfortable' | 'spacious' | undefined;
+// Warning admonition color - dark mode hex (e.g., "#FBBF24").
+export type NovaPresetOverridesColorsWarningDark = string | undefined;
 
-// Shape and spacing overrides.
-export type NovaPresetOverridesShape = {
-  radius: NovaPresetOverridesShapeRadius;
-  density: NovaPresetOverridesShapeDensity;
+// Warning admonition color override - light/dark hex pair.
+export type NovaPresetOverridesColorsWarning = {
+  light: NovaPresetOverridesColorsWarningLight;
+  dark: NovaPresetOverridesColorsWarningDark;
 };
 
-// Card surface style.
-export type NovaPresetOverridesDepthCards = 'flat' | 'elevated' | 'glass' | undefined;
+// Danger/error admonition color - light mode hex (e.g., "#EF4444").
+export type NovaPresetOverridesColorsDangerLight = string | undefined;
 
-// Code block surface style.
-export type NovaPresetOverridesDepthCodeBlocks = 'flat' | 'bordered' | 'elevated' | undefined;
+// Danger/error admonition color - dark mode hex (e.g., "#F87171").
+export type NovaPresetOverridesColorsDangerDark = string | undefined;
 
-// Surface depth overrides.
-export type NovaPresetOverridesDepth = {
-  cards: NovaPresetOverridesDepthCards;
-  codeBlocks: NovaPresetOverridesDepthCodeBlocks;
+// Danger/error admonition color override - light/dark hex pair.
+export type NovaPresetOverridesColorsDanger = {
+  light: NovaPresetOverridesColorsDangerLight;
+  dark: NovaPresetOverridesColorsDangerDark;
 };
 
-// Animation speed.
-export type NovaPresetOverridesMotionSpeed = 'none' | 'subtle' | 'normal' | 'expressive' | undefined;
+// Brand color overrides - each category is a light/dark hex pair.
+export type NovaPresetOverridesColors = {
+  primary: NovaPresetOverridesColorsPrimary;
+  secondary: NovaPresetOverridesColorsSecondary;
+  text: NovaPresetOverridesColorsText;
+  border: NovaPresetOverridesColorsBorder;
+  warning: NovaPresetOverridesColorsWarning;
+  danger: NovaPresetOverridesColorsDanger;
+};
 
-// Stagger reveal animations on page load.
-export type NovaPresetOverridesMotionStaggeredReveals = boolean | undefined;
+// Display/heading font family (e.g., "Sora", "Plus Jakarta Sans").
+export type NovaPresetOverridesFontsDisplay = string | undefined;
 
-// Enable hover effects on interactive elements.
-export type NovaPresetOverridesMotionHoverEffects = boolean | undefined;
+// Body text font family (e.g., "Inter", "DM Sans").
+export type NovaPresetOverridesFontsBody = string | undefined;
+
+// Code/monospace font family (e.g., "Fira Code", "JetBrains Mono").
+export type NovaPresetOverridesFontsCode = string | undefined;
 
-// Animation and motion overrides.
-export type NovaPresetOverridesMotion = {
-  speed: NovaPresetOverridesMotionSpeed;
-  staggeredReveals: NovaPresetOverridesMotionStaggeredReveals;
-  hoverEffects: NovaPresetOverridesMotionHoverEffects;
+// Font family overrides.
+export type NovaPresetOverridesFonts = {
+  display: NovaPresetOverridesFontsDisplay;
+  body: NovaPresetOverridesFontsBody;
+  code: NovaPresetOverridesFontsCode;
 };
 
-// Override preset brand colors (e.g., { primary: "#DC2626" }).
+// Override preset brand colors (e.g., { primary: { light: "#DC2626" } }).
 export type NovaPresetOverridesColorsPartial = Partial<NovaPresetOverridesColors> | undefined;
 
 // Override preset font families (e.g., { display: "Sora" }).
 export type NovaPresetOverridesFontsPartial = Partial<NovaPresetOverridesFonts> | undefined;
 
-// Override preset border radius and spacing density.
-export type NovaPresetOverridesShapePartial = Partial<NovaPresetOverridesShape> | undefined;
-
-// Override preset card and code block depth styling.
-export type NovaPresetOverridesDepthPartial = Partial<NovaPresetOverridesDepth> | undefined;
-
-// Override preset animation speed and effects.
-export type NovaPresetOverridesMotionPartial = Partial<NovaPresetOverridesMotion> | undefined;
-
 // Navbar variant override.
 export type NovaPresetOverridesNavbar = 'bridge' | 'canopy' | 'monolith' | 'compass' | undefined;
 
 // Footer variant override.
 export type NovaPresetOverridesFooter = 'commons' | 'embassy' | 'ledger' | 'launchpad' | undefined;
 
-// Preset visual overrides — colors, fonts, shape, depth, motion, and layout variants.
+// Preset visual overrides - colors, fonts, and navbar/footer layout variants.
 export type NovaPresetOverrides = {
   colors?: NovaPresetOverridesColorsPartial;
   fonts?: NovaPresetOverridesFontsPartial;
-  shape?: NovaPresetOverridesShapePartial;
-  depth?: NovaPresetOverridesDepthPartial;
-  motion?: NovaPresetOverridesMotionPartial;
   navbar?: NovaPresetOverridesNavbar;
   footer?: NovaPresetOverridesFooter;
 };
@@ -179,7 +193,7 @@ export type NovaPresetPluginsDocsConfigVersionOptionsPath = string | undefined;
 // Version label for badges and dropdowns (e.g., "1.0.0", "Next").
 export type NovaPresetPluginsDocsConfigVersionOptionsLabel = string | undefined;
 
-// Banner style shown at the top of docs — "none" to hide, or a version status indicator.
+// Banner style shown at the top of docs - "none" to hide, or a version status indicator.
 export type NovaPresetPluginsDocsConfigVersionOptionsBanner = 'none' | 'unreleased' | 'unmaintained' | undefined;
 
 // Show a badge with the version label at the top of each doc. Defaults to true.
@@ -255,7 +269,7 @@ export type NovaPresetPluginsDocsConfigDocCategoryGeneratedIndexComponent = stri
 // Custom callback to generate sidebar items from autogenerated sections.
 export type NovaPresetPluginsDocsConfigSidebarItemsGenerator = ((generatorArgs: Record<string, unknown>) => unknown[] | Promise<unknown[]>) | undefined;
 
-// Docs plugin options — pass-through to @docusaurus/plugin-content-docs.
+// Docs plugin options - pass-through to @docusaurus/plugin-content-docs.
 export type NovaPresetPluginsDocsConfig = {
   id?: NovaPresetPluginsDocsConfigId;
   path?: NovaPresetPluginsDocsConfigPath;
@@ -297,7 +311,7 @@ export type NovaPresetPluginsDocsConfig = {
   [key: string]: unknown;
 };
 
-// Docs plugin options — pass-through to @docusaurus/plugin-content-docs.
+// Docs plugin options - pass-through to @docusaurus/plugin-content-docs.
 export type NovaPresetPluginsDocs = NovaPresetPluginsDocsConfig | undefined;
 
 // Plugin ID for multi-instance support.
@@ -383,7 +397,7 @@ export type NovaPresetPluginsBlogConfigTags = string | false | null | undefined;
 // Behavior when inline tags are detected. Defaults to "warn".
 export type NovaPresetPluginsBlogConfigOnInlineTags = ReportingSeverity | undefined;
 
-// Feed format — array of types, single type, "all" for all formats, or null to disable. Defaults to null.
+// Feed format - array of types, single type, "all" for all formats, or null to disable. Defaults to null.
 export type NovaPresetPluginsBlogConfigFeedOptionsType = ('rss' | 'atom' | 'json')[] | 'all' | 'rss' | 'atom' | 'json' | null | undefined;
 
 // Feed title override. Defaults to the site title.
@@ -401,7 +415,7 @@ export type NovaPresetPluginsBlogConfigFeedOptionsLanguage = string | undefined;
 // Maximum number of feed items, or false/null for unlimited. Defaults to 20.
 export type NovaPresetPluginsBlogConfigFeedOptionsLimit = number | false | null | undefined;
 
-// XSLT stylesheet configuration — true for defaults, false/null to disable, or per-format overrides.
+// XSLT stylesheet configuration - true for defaults, false/null to disable, or per-format overrides.
 export type NovaPresetPluginsBlogConfigFeedOptionsXslt = boolean | null | {
   rss?: string | boolean | null | undefined;
   atom?: string | boolean | null | undefined;
@@ -464,7 +478,7 @@ export type NovaPresetPluginsBlogConfigReadingTime = ReadingTimeFunctionOption |
 // Async callback to transform, filter, or modify blog posts before rendering.
 export type NovaPresetPluginsBlogConfigProcessBlogPosts = ProcessBlogPostsFn | undefined;
 
-// Blog plugin options — pass-through to @docusaurus/plugin-content-blog.
+// Blog plugin options - pass-through to @docusaurus/plugin-content-blog.
 export type NovaPresetPluginsBlogConfig = {
   id?: NovaPresetPluginsBlogConfigId;
   path?: NovaPresetPluginsBlogConfigPath;
@@ -511,7 +525,7 @@ export type NovaPresetPluginsBlogConfig = {
   [key: string]: unknown;
 };
 
-// Blog plugin options — pass-through to @docusaurus/plugin-content-blog, or false to disable.
+// Blog plugin options - pass-through to @docusaurus/plugin-content-blog, or false to disable.
 export type NovaPresetPluginsBlog = NovaPresetPluginsBlogConfig | false | undefined;
 
 // Plugin ID for multi-instance support.
@@ -567,7 +581,7 @@ export type NovaPresetPluginsPagesConfigBeforeDefaultRehypePlugins = unknown[] |
 // Root component for MDX pages (e.g., "@theme/MDXPage").
 export type NovaPresetPluginsPagesConfigMdxPageComponent = string | undefined;
 
-// Pages plugin options — pass-through to @docusaurus/plugin-content-pages.
+// Pages plugin options - pass-through to @docusaurus/plugin-content-pages.
 export type NovaPresetPluginsPagesConfig = {
   id?: NovaPresetPluginsPagesConfigId;
   path?: NovaPresetPluginsPagesConfigPath;
@@ -588,7 +602,7 @@ export type NovaPresetPluginsPagesConfig = {
   [key: string]: unknown;
 };
 
-// Pages plugin options — pass-through to @docusaurus/plugin-content-pages, or false to disable.
+// Pages plugin options - pass-through to @docusaurus/plugin-content-pages, or false to disable.
 export type NovaPresetPluginsPages = NovaPresetPluginsPagesConfig | false | undefined;
 
 // Output filename for the sitemap, relative to the build directory (e.g., "sitemap.xml"). Defaults to "sitemap.xml".
@@ -597,7 +611,7 @@ export type NovaPresetPluginsSitemapConfigFilename = string | undefined;
 // Glob patterns for routes to exclude from the sitemap (e.g., ["/docs/tags/**"]).
 export type NovaPresetPluginsSitemapConfigIgnorePatterns = string[] | undefined;
 
-// Format of the lastmod entry — "date" for YYYY-MM-DD, "datetime" for ISO 8601, or null to omit. Defaults to null.
+// Format of the lastmod entry - "date" for YYYY-MM-DD, "datetime" for ISO 8601, or null to omit. Defaults to null.
 export type NovaPresetPluginsSitemapConfigLastmod = 'date' | 'datetime' | null | undefined;
 
 // Change frequency hint for search engines, or null to omit. Defaults to null.
@@ -633,7 +647,7 @@ export type NovaPresetPluginsSitemapConfigCreateSitemapItems = ((params: {
   defaultCreateSitemapItems: NovaSitemapCallbackDefaultCreateSitemapItems;
 }) => Promise<NovaSitemapItem[]>) | undefined;
 
-// Sitemap plugin options — pass-through to @docusaurus/plugin-sitemap.
+// Sitemap plugin options - pass-through to @docusaurus/plugin-sitemap.
 export type NovaPresetPluginsSitemapConfig = {
   filename?: NovaPresetPluginsSitemapConfigFilename;
   ignorePatterns?: NovaPresetPluginsSitemapConfigIgnorePatterns;
@@ -644,7 +658,7 @@ export type NovaPresetPluginsSitemapConfig = {
   [key: string]: unknown;
 };
 
-// Sitemap plugin options — pass-through to @docusaurus/plugin-sitemap, or false to disable.
+// Sitemap plugin options - pass-through to @docusaurus/plugin-sitemap, or false to disable.
 export type NovaPresetPluginsSitemap = NovaPresetPluginsSitemapConfig | false | undefined;
 
 // Docusaurus plugin configuration (docs, blog, pages, sitemap).
@@ -734,7 +748,7 @@ export type NovaPresetSearchConfigFuzzyMatchingDistance = number | undefined;
 // Glob patterns of routes to exclude from search (e.g., ["/docs/tags/**"]). Defaults to [].
 export type NovaPresetSearchConfigIgnorePatterns = string[] | undefined;
 
-// Docs route base path — must match plugins.docs.routeBasePath (e.g., "docs", "guides"). Defaults to "docs".
+// Docs route base path - must match plugins.docs.routeBasePath (e.g., "docs", "guides"). Defaults to "docs".
 export type NovaPresetSearchConfigDocsRouteBasePath = string | undefined;
 
 // Local search configuration.
@@ -756,8 +770,8 @@ export type NovaPresetSearchConfig = {
 // Local search configuration, or false to disable search entirely. Defaults to false.
 export type NovaPresetSearch = NovaPresetSearchConfig | false;
 
-// Preset identity — determines default colors, fonts, shape, and layout.
-export type NovaPresetName = 'foundry' | 'sentinel' | 'signal' | 'envoy';
+// Preset identity - determines default colors, fonts, shape, and layout.
+export type NovaPresetName = 'envoy' | 'foundry' | 'lantern' | 'marshal' | 'sentinel' | 'signal';
 
 // Override individual preset defaults (undefined = use preset default).
 export type NovaPresetOptionsOverrides = NovaPresetOverrides | undefined;
@@ -774,7 +788,13 @@ export type NovaPresetOptionsProgressBar = NovaPresetProgressBar | undefined;
 // Local search configuration, or false to disable search entirely. Defaults to false.
 export type NovaPresetOptionsSearch = NovaPresetSearch | undefined;
 
-// Nova preset options — identity, overrides, plugins, analytics, progress bar, and search.
+// Icon identifiers to always bundle, for names built dynamically that the build-time scan cannot see. Defaults to [].
+export type NovaPresetOptionsIconSafelist = string[] | undefined;
+
+// Maximum size in MiB any emitted JavaScript bundle file may reach before the build fails, or false to disable. Defaults to 3.
+export type NovaPresetOptionsMaxBundleFileSize = number | false | undefined;
+
+// Nova preset options - identity, overrides, plugins, analytics, progress bar, search, icon safelist, and bundle size guard.
 export type NovaPresetOptions = {
   preset: NovaPresetName;
   overrides?: NovaPresetOptionsOverrides;
@@ -782,6 +802,8 @@ export type NovaPresetOptions = {
   analytics?: NovaPresetOptionsAnalytics;
   progressBar?: NovaPresetOptionsProgressBar;
   search?: NovaPresetOptionsSearch;
+  iconSafelist?: NovaPresetOptionsIconSafelist;
+  maxBundleFileSize?: NovaPresetOptionsMaxBundleFileSize;
 };
 
 // Meta tag name attribute (e.g., "twitter:card", "og:description").
@@ -796,50 +818,64 @@ export type NovaThemeConfigSiteMetadataEntry = {
   content: NovaThemeConfigSiteMetadataEntryContent;
 };
 
-// Site title shown in the browser tab and SEO (e.g., "Nova", "Foundry"). Defaults to "".
-export type NovaThemeConfigSiteTitle = string | undefined;
-
 // Alt text for the logo image (e.g., "Nova"). Defaults to "".
 export type NovaThemeConfigSiteLogoAlt = string | undefined;
 
-// Logo image — URL path from static dir (e.g., "/images/logo.svg"). Defaults to "".
-export type NovaThemeConfigSiteLogoSrc = string | undefined;
+// Light mode logo - URL path from static dir (e.g., "/images/logo.svg"). Defaults to "".
+export type NovaThemeConfigSiteLogoSrcLight = string | undefined;
 
-// Dark mode logo — URL path from static dir (e.g., "/images/logo-dark.svg").
+// Dark mode logo - URL path from static dir (e.g., "/images/logo-dark.svg").
 export type NovaThemeConfigSiteLogoSrcDark = string | undefined;
 
+// Logo image - light/dark variants.
+export type NovaThemeConfigSiteLogoSrc = {
+  light?: NovaThemeConfigSiteLogoSrcLight;
+  dark?: NovaThemeConfigSiteLogoSrcDark;
+} | undefined;
+
 // Clicking the logo navigates to this URL (e.g., "https://example.com").
 export type NovaThemeConfigSiteLogoHref = string | undefined;
 
-// Wordmark image — URL path from static dir (e.g., "/images/wordmark.svg").
-export type NovaThemeConfigSiteLogoWordmark = string | undefined;
+// Link target attribute (e.g., "_blank" for opening in a new tab).
+export type NovaThemeConfigSiteLogoTarget = string | undefined;
 
-// Dark mode wordmark — URL path from static dir (e.g., "/images/wordmark-dark.svg").
+// Link rel attribute (e.g., "noopener noreferrer").
+export type NovaThemeConfigSiteLogoRel = string | undefined;
+
+// Accessible label for the logo link (e.g., "Home").
+export type NovaThemeConfigSiteLogoAriaLabel = string | undefined;
+
+// Light mode wordmark - URL path from static dir (e.g., "/images/wordmark.svg").
+export type NovaThemeConfigSiteLogoWordmarkLight = string | undefined;
+
+// Dark mode wordmark - URL path from static dir (e.g., "/images/wordmark-dark.svg").
 export type NovaThemeConfigSiteLogoWordmarkDark = string | undefined;
 
-// Brand title text shown in the navbar (e.g., "Envoy"). Not used for SEO.
-export type NovaThemeConfigSiteLogoTitle = string | undefined;
+// Wordmark image - light/dark variants.
+export type NovaThemeConfigSiteLogoWordmark = {
+  light?: NovaThemeConfigSiteLogoWordmarkLight;
+  dark?: NovaThemeConfigSiteLogoWordmarkDark;
+} | undefined;
 
 // Site logo configuration.
 export type NovaThemeConfigSiteLogo = {
   alt?: NovaThemeConfigSiteLogoAlt;
   src?: NovaThemeConfigSiteLogoSrc;
-  srcDark?: NovaThemeConfigSiteLogoSrcDark;
   href?: NovaThemeConfigSiteLogoHref;
+  target?: NovaThemeConfigSiteLogoTarget;
+  rel?: NovaThemeConfigSiteLogoRel;
+  ariaLabel?: NovaThemeConfigSiteLogoAriaLabel;
   wordmark?: NovaThemeConfigSiteLogoWordmark;
-  wordmarkDark?: NovaThemeConfigSiteLogoWordmarkDark;
-  title?: NovaThemeConfigSiteLogoTitle;
 } | undefined;
 
-// Default social sharing image — URL path from static dir (e.g., "/thumbnails/brand.png"). Defaults to "".
+// Default social sharing image - URL path from static dir (e.g., "/thumbnails/brand.png"). Defaults to "".
 export type NovaThemeConfigSiteImage = string | undefined;
 
 // HTML <meta> tags for SEO (e.g., [{ name: "twitter:card", content: "summary_large_image" }]). Defaults to [].
 export type NovaThemeConfigSiteMetadata = NovaThemeConfigSiteMetadataEntry[] | undefined;
 
-// Site identity — title, logo, image, and metadata.
+// Site identity - logo, image, and metadata.
 export type NovaThemeConfigSite = {
-  title?: NovaThemeConfigSiteTitle;
   logo?: NovaThemeConfigSiteLogo;
   image?: NovaThemeConfigSiteImage;
   metadata?: NovaThemeConfigSiteMetadata;
@@ -861,28 +897,28 @@ export type NovaThemeConfigColorMode = {
 // Display text for the navbar item (e.g., "Documentation", "Blog").
 export type NovaThemeConfigNavbarItemLabel = string | undefined;
 
-// Item type — determines rendering behavior.
+// Item type - determines rendering behavior.
 export type NovaThemeConfigNavbarItemType = 'default' | 'doc' | 'docSidebar' | 'dropdown' | 'html' | 'localeDropdown' | 'docsVersion' | 'docsVersionDropdown' | 'search' | undefined;
 
-// Nested items — used when type is "dropdown".
+// Nested items - used when type is "dropdown".
 export type NovaThemeConfigNavbarItemItems = NovaThemeConfigNavbarItem[] | undefined;
 
-// Internal site path — uses client-side routing (e.g., "/blog", "/docs/getting-started").
+// Internal site path - uses client-side routing (e.g., "/blog", "/docs/getting-started").
 export type NovaThemeConfigNavbarItemTo = string | undefined;
 
-// External URL — full page navigation (e.g., "https://github.com/...").
+// External URL - full page navigation (e.g., "https://github.com/...").
 export type NovaThemeConfigNavbarItemHref = string | undefined;
 
-// Iconify icon ID or object (e.g., "lucide:book-open", "mdi:github").
+// Iconify icon ID or object (e.g., "lucide:book-open", "ri:github-fill").
 export type NovaThemeConfigNavbarItemIcon = string | undefined;
 
-// Document ID — filename without extension, used with type: "doc" (e.g., "getting-started", "overview").
+// Document ID - filename without extension, used with type: "doc" (e.g., "getting-started", "overview").
 export type NovaThemeConfigNavbarItemDocId = string | undefined;
 
-// Sidebar ID — defined in sidebars.ts, used with type: "docSidebar" (e.g., "docs").
+// Sidebar ID - defined in sidebars.ts, used with type: "docSidebar" (e.g., "docs").
 export type NovaThemeConfigNavbarItemSidebarId = string | undefined;
 
-// Single navbar item — link, doc, dropdown, search, etc.
+// Single navbar item - link, doc, dropdown, search, etc.
 export type NovaThemeConfigNavbarItem = {
   label?: NovaThemeConfigNavbarItemLabel;
   type?: NovaThemeConfigNavbarItemType;
@@ -895,18 +931,14 @@ export type NovaThemeConfigNavbarItem = {
   [key: string]: unknown;
 };
 
-// Text title displayed next to the logo in the navbar (e.g., "Nova", "Foundry"). Defaults to "".
-export type NovaThemeConfigNavbarTitle = string | undefined;
-
 // Hide the navbar when scrolling down. Defaults to false.
 export type NovaThemeConfigNavbarHideOnScroll = boolean | undefined;
 
-// Navbar items — links, dropdowns, docs, and search. Defaults to [].
+// Navbar items - links, dropdowns, docs, and search. Defaults to [].
 export type NovaThemeConfigNavbarItems = NovaThemeConfigNavbarItem[] | undefined;
 
-// Navbar configuration — title, items, and scroll behavior.
+// Navbar configuration - items and scroll behavior.
 export type NovaThemeConfigNavbar = {
-  title?: NovaThemeConfigNavbarTitle;
   hideOnScroll?: NovaThemeConfigNavbarHideOnScroll;
   items?: NovaThemeConfigNavbarItems;
   [key: string]: unknown;
@@ -928,7 +960,7 @@ export type NovaThemeConfigDocsSidebar = {
   [key: string]: unknown;
 } | undefined;
 
-// Docs theme configuration — version persistence and sidebar.
+// Docs theme configuration - version persistence and sidebar.
 export type NovaThemeConfigDocs = {
   versionPersistence?: NovaThemeConfigDocsVersionPersistence;
   sidebar?: NovaThemeConfigDocsSidebar;
@@ -950,17 +982,30 @@ export type NovaThemeConfigBlogLayoutHeading = string | undefined;
 // Description text below the heading (e.g., "Updates and insights from the team"). Defaults to "".
 export type NovaThemeConfigBlogLayoutDescription = string | undefined;
 
-// Blog list page layout — heading and description.
+// Blog list page layout - heading and description.
 export type NovaThemeConfigBlogLayout = {
   heading?: NovaThemeConfigBlogLayoutHeading;
   description?: NovaThemeConfigBlogLayoutDescription;
   [key: string]: unknown;
 } | undefined;
 
-// Blog theme configuration — sidebar and layout.
+// Single share platform - social network or copy-link affordance for blog posts.
+export type NovaThemeConfigBlogSharePlatform = 'x' | 'facebook' | 'linkedin' | 'reddit' | 'copy';
+
+// Share button platforms shown on blog posts. Defaults to [].
+export type NovaThemeConfigBlogSharePlatforms = NovaThemeConfigBlogSharePlatform[] | undefined;
+
+// Blog post share configuration.
+export type NovaThemeConfigBlogShare = {
+  platforms?: NovaThemeConfigBlogSharePlatforms;
+  [key: string]: unknown;
+} | undefined;
+
+// Blog theme configuration - sidebar, layout, and share.
 export type NovaThemeConfigBlog = {
   sidebar?: NovaThemeConfigBlogSidebar;
   layout?: NovaThemeConfigBlogLayout;
+  share?: NovaThemeConfigBlogShare;
   [key: string]: unknown;
 } | undefined;
 
@@ -976,19 +1021,16 @@ export type NovaThemeConfigTableOfContents = {
   maxHeadingLevel?: NovaThemeConfigTableOfContentsMaxHeadingLevel;
 } | undefined;
 
-// Show a floating scroll-to-top button. Defaults to true.
-export type NovaThemeConfigBackToTopButton = boolean | undefined;
-
-// Unique ID — used to remember dismissal in localStorage.
+// Unique ID - used to remember dismissal in localStorage.
 export type NovaThemeConfigAnnouncementBarId = string;
 
-// Banner content — supports HTML (e.g., "Check out our <a href="/blog">latest post</a>").
+// Banner content - supports HTML (e.g., "Check out our <a href="/blog">latest post</a>").
 export type NovaThemeConfigAnnouncementBarContent = string;
 
-// Background color — any CSS color (e.g., "#1a1a2e", "var(--custom-color)").
+// Background color - any CSS color (e.g., "#1a1a2e", "var(--custom-color)").
 export type NovaThemeConfigAnnouncementBarBackgroundColor = string | undefined;
 
-// Text color — any CSS color (e.g., "#ffffff").
+// Text color - any CSS color (e.g., "#ffffff").
 export type NovaThemeConfigAnnouncementBarTextColor = string | undefined;
 
 // Allow users to dismiss the banner. Defaults to true.
@@ -1003,10 +1045,60 @@ export type NovaThemeConfigAnnouncementBar = {
   isCloseable?: NovaThemeConfigAnnouncementBarIsCloseable;
 } | undefined;
 
+// Show a floating scroll-to-top button. Defaults to true.
+export type NovaThemeConfigBackToTopButton = boolean | undefined;
+
+// 404 page heading - replaces Nova's randomized title pool when set.
+export type NovaThemeConfigErrorPagesNotFoundTitle = string | undefined;
+
+// 404 page description - replaces Nova's randomized description pool when set.
+export type NovaThemeConfigErrorPagesNotFoundDescription = string | undefined;
+
+// "Back to home" CTA label on the 404 page (e.g., "Back to home", "Return to start").
+export type NovaThemeConfigErrorPagesNotFoundBackHomeLabel = string | undefined;
+
+// "Back to home" CTA href on the 404 page. Defaults to the site `baseUrl`.
+export type NovaThemeConfigErrorPagesNotFoundBackHomeHref = string | undefined;
+
+// 404 page content overrides.
+export type NovaThemeConfigErrorPagesNotFound = {
+  title?: NovaThemeConfigErrorPagesNotFoundTitle;
+  description?: NovaThemeConfigErrorPagesNotFoundDescription;
+  backHomeLabel?: NovaThemeConfigErrorPagesNotFoundBackHomeLabel;
+  backHomeHref?: NovaThemeConfigErrorPagesNotFoundBackHomeHref;
+} | undefined;
+
+// Per-page crash heading - replaces Nova's randomized title pool when set.
+export type NovaThemeConfigErrorPagesErrorPageContentTitle = string | undefined;
+
+// Retry button label on the per-page crash fallback (e.g., "Try again", "Reload").
+export type NovaThemeConfigErrorPagesErrorPageContentRetryLabel = string | undefined;
+
+// Per-page crash content overrides.
+export type NovaThemeConfigErrorPagesErrorPageContent = {
+  title?: NovaThemeConfigErrorPagesErrorPageContentTitle;
+  retryLabel?: NovaThemeConfigErrorPagesErrorPageContentRetryLabel;
+} | undefined;
+
+// Retry button label on the top-level error boundary fallback.
+export type NovaThemeConfigErrorPagesErrorRetryLabel = string | undefined;
+
+// Top-level error boundary content overrides.
+export type NovaThemeConfigErrorPagesError = {
+  retryLabel?: NovaThemeConfigErrorPagesErrorRetryLabel;
+} | undefined;
+
+// Error pages configuration - overrides Nova's defaults for 404 / per-page crash / top-level error surfaces.
+export type NovaThemeConfigErrorPages = {
+  notFound?: NovaThemeConfigErrorPagesNotFound;
+  errorPageContent?: NovaThemeConfigErrorPagesErrorPageContent;
+  error?: NovaThemeConfigErrorPagesError;
+} | undefined;
+
 // Link text (e.g., "Terms of Use", "Privacy Policy").
 export type NovaThemeConfigFooterSectionLinkLabel = string;
 
-// Link destination — internal path or external URL (e.g., "/docs/getting-started/", "https://example.com").
+// Link destination - internal path or external URL (e.g., "/docs/getting-started/", "https://example.com").
 export type NovaThemeConfigFooterSectionLinkHref = string;
 
 // Single footer section link.
@@ -1021,7 +1113,7 @@ export type NovaThemeConfigFooterLayoutSlotTitle = string | undefined;
 // Key from sections to display in this slot (e.g., "legal", "company").
 export type NovaThemeConfigFooterLayoutSlotSection = string;
 
-// Single footer layout slot — maps a section to a column.
+// Single footer layout slot - maps a section to a column.
 export type NovaThemeConfigFooterLayoutSlot = {
   title?: NovaThemeConfigFooterLayoutSlotTitle;
   section: NovaThemeConfigFooterLayoutSlotSection;
@@ -1063,7 +1155,7 @@ export type NovaIconifyIcon = {
   vFlip?: NovaIconifyIconVFlip;
 };
 
-// Iconify icon ID or object (e.g., "mdi:github", "ri:twitter-x-fill").
+// Iconify icon ID or object (e.g., "ri:github-fill", "ri:twitter-x-fill").
 export type NovaThemeConfigFooterSocialLinkIcon = string | NovaIconifyIcon;
 
 // Social profile URL (e.g., "https://github.com/cbnventures").
@@ -1079,10 +1171,10 @@ export type NovaThemeConfigFooterSocialLink = {
   label: NovaThemeConfigFooterSocialLinkLabel;
 };
 
-// Link sections — keyed by section name (e.g., { legal: [{ label: "Terms", href: "/terms/" }] }).
+// Link sections - keyed by section name (e.g., { legal: [{ label: "Terms", href: "/terms/" }] }).
 export type NovaThemeConfigFooterSections = Record<string, NovaThemeConfigFooterSectionLink[]> | undefined;
 
-// Layout slots — keyed by slot name (e.g., { company: { title: "Company", section: "company" } }).
+// Layout slots - keyed by slot name (e.g., { company: { title: "Company", section: "company" } }).
 export type NovaThemeConfigFooterLayout = Record<string, NovaThemeConfigFooterLayoutSlot> | undefined;
 
 // Social media icon links shown in the footer.
@@ -1108,7 +1200,7 @@ export type NovaThemeConfigFooter = {
   [key: string]: unknown;
 } | false | undefined;
 
-// Nova theme configuration — site, navbar, docs, blog, footer, and more.
+// Nova theme configuration - site, navbar, docs, blog, footer, and more.
 export type NovaThemeConfig = {
   site?: NovaThemeConfigSite;
   colorMode?: NovaThemeConfigColorMode;
@@ -1118,20 +1210,21 @@ export type NovaThemeConfig = {
   tableOfContents?: NovaThemeConfigTableOfContents;
   announcementBar?: NovaThemeConfigAnnouncementBar;
   backToTopButton?: NovaThemeConfigBackToTopButton;
+  errorPages?: NovaThemeConfigErrorPages;
   footer?: NovaThemeConfigFooter;
   [key: string]: unknown;
 };
 
-// Site title — used in metadata and browser tab (e.g., "Nova", "Foundry").
+// Site title - used in metadata and browser tab (e.g., "Nova", "Foundry").
 export type DocusaurusNovaConfigTitle = string;
 
-// Site URL — top-level hostname (e.g., "https://nova.cbnventures.io").
+// Site URL - top-level hostname (e.g., "https://nova.cbnventures.io").
 export type DocusaurusNovaConfigUrl = string;
 
 // Path after the host (e.g., "/", "/my-site/"). Must start and end with "/".
 export type DocusaurusNovaConfigBaseUrl = string;
 
-// Site favicon — file path relative to site dir (e.g., "./favicon.ico").
+// Site favicon - file path relative to site dir (e.g., "./favicon.ico").
 export type DocusaurusNovaConfigFavicon = string | undefined;
 
 // Delimiter between page title and site title in <title> tag. Defaults to "|".
@@ -1176,13 +1269,13 @@ export type DocusaurusNovaConfigStaticDirectories = string[] | undefined;
 // Show a banner when CSS/JS fails to load due to wrong baseUrl. Defaults to true.
 export type DocusaurusNovaConfigBaseUrlIssueBanner = boolean | undefined;
 
-// Script tag — either a URL string or an object with src and attributes.
+// Script tag - either a URL string or an object with src and attributes.
 export type NovaScriptTag = string | {
   src: string;
   [key: string]: string | boolean | undefined;
 };
 
-// Stylesheet tag — either a URL string or an object with href and attributes.
+// Stylesheet tag - either a URL string or an object with href and attributes.
 export type NovaStylesheetTag = string | {
   href: string;
   [key: string]: string | boolean | undefined;
@@ -1197,13 +1290,13 @@ export type DocusaurusNovaConfigStylesheets = NovaStylesheetTag[] | undefined;
 // Module paths loaded on every page. Defaults to [].
 export type DocusaurusNovaConfigClientModules = string[] | undefined;
 
-// Plugin reference — package name, [name, options] tuple, false to disable, or null.
+// Plugin reference - package name, [name, options] tuple, false to disable, or null.
 export type NovaPluginConfig = string | [string, Record<string, unknown>] | false | null;
 
 // Additional Docusaurus themes (e.g., "@docusaurus/theme-mermaid"). Defaults to [].
 export type DocusaurusNovaConfigThemes = NovaPluginConfig[] | undefined;
 
-// Custom fields — arbitrary data accessible via useDocusaurusContext().
+// Custom fields - arbitrary data accessible via useDocusaurusContext().
 export type DocusaurusNovaConfigCustomFields = Record<string, unknown> | undefined;
 
 // HTML tag name (e.g., "meta", "link", "script").
@@ -1225,7 +1318,7 @@ export type NovaHtmlTag = {
 // HTML tags injected into <head> (e.g., meta, link, script). Defaults to [].
 export type DocusaurusNovaConfigHeadTags = NovaHtmlTag[] | undefined;
 
-// Display label for the locale dropdown (e.g., "English", "Français").
+// Display label for the locale dropdown (e.g., "English", "Francais").
 export type NovaI18nLocaleConfigLabel = string;
 
 // BCP 47 language tag for <html lang="..."> (e.g., "en-US", "fr-FR").
@@ -1330,13 +1423,13 @@ export type NovaMarkdownConfig = {
 // Markdown processing configuration.
 export type DocusaurusNovaConfigMarkdown = NovaMarkdownConfig;
 
-// Nova preset configuration — [presetPackageName, presetOptions] tuples.
+// Nova preset configuration - [presetPackageName, presetOptions] tuples.
 export type DocusaurusNovaConfigPresets = (['@cbnventures/docusaurus-preset-nova', NovaPresetOptions] | [string, Record<string, unknown>])[] | undefined;
 
 // Docusaurus plugin configuration. Defaults to [].
 export type DocusaurusNovaConfigPlugins = NovaPluginConfig[] | undefined;
 
-// Nova theme configuration — site identity, navbar, footer, docs, blog.
+// Nova theme configuration - site identity, navbar, footer, docs, blog.
 export type DocusaurusNovaConfigThemeConfig = NovaThemeConfig | undefined;
 
 // Opt-in flags for Docusaurus v4 breaking changes.
@@ -1350,7 +1443,7 @@ export type DocusaurusNovaConfigFuture = {
 // Custom Eta HTML template for server-side rendering.
 export type DocusaurusNovaConfigSsrTemplate = string | undefined;
 
-// Webpack JS loader — "babel" for default, or a function returning a custom RuleSetRule.
+// Webpack JS loader - "babel" for default, or a function returning a custom RuleSetRule.
 export type DocusaurusNovaConfigWebpack = {
   jsLoader?: 'babel' | ((isServer: boolean) => Record<string, unknown>);
 } | undefined;