@cbnventures/docusaurus-preset-nova 0.18.0 → 0.20.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;
+
+// Body text font family (e.g., "Inter", "DM Sans").
+export type NovaPresetOverridesFontsBody = string | undefined;
 
-// Enable hover effects on interactive elements.
-export type NovaPresetOverridesMotionHoverEffects = boolean | 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;
 };
@@ -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,9 +818,6 @@ 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;
 
@@ -838,9 +857,6 @@ export type NovaThemeConfigSiteLogoWordmark = {
   dark?: NovaThemeConfigSiteLogoWordmarkDark;
 } | undefined;
 
-// Brand title text shown in the navbar (e.g., "Envoy"). Not used for SEO.
-export type NovaThemeConfigSiteLogoTitle = string | undefined;
-
 // Site logo configuration.
 export type NovaThemeConfigSiteLogo = {
   alt?: NovaThemeConfigSiteLogoAlt;
@@ -850,7 +866,6 @@ export type NovaThemeConfigSiteLogo = {
   rel?: NovaThemeConfigSiteLogoRel;
   ariaLabel?: NovaThemeConfigSiteLogoAriaLabel;
   wordmark?: NovaThemeConfigSiteLogoWordmark;
-  title?: NovaThemeConfigSiteLogoTitle;
 } | undefined;
 
 // Default social sharing image - URL path from static dir (e.g., "/thumbnails/brand.png"). Defaults to "".
@@ -859,9 +874,8 @@ 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cbnventures/docusaurus-preset-nova",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Scripts, templates, and project configuration for the common JavaScript and TypeScript developer",
   "keywords": [
     "eslint",
@@ -87,7 +87,7 @@
     "node": "^20 || ^22 || ^24"
   },
   "dependencies": {
-    "@cbnventures/nova": "0.18.0",
+    "@cbnventures/nova": "0.20.0",
     "@codesandbox/sandpack-react": "2.20.0",
     "@docusaurus/plugin-content-blog": "3.10.0",
     "@docusaurus/plugin-content-docs": "3.10.0",
@@ -98,12 +98,7 @@
     "@docusaurus/theme-common": "3.10.0",
     "@docusaurus/theme-translations": "3.10.0",
     "@docusaurus/utils-validation": "3.10.0",
-    "@iconify-json/logos": "1.2.11",
-    "@iconify-json/lucide": "1.2.101",
-    "@iconify-json/mdi": "1.2.3",
-    "@iconify-json/openmoji": "1.2.27",
-    "@iconify-json/ri": "1.2.10",
-    "@iconify-json/simple-icons": "1.2.80",
+    "@iconify/json": "2.2.488",
     "@iconify/react": "6.0.2",
     "@mdx-js/react": "3.1.1",
     "cheerio": "1.2.0",