Plugin Setup

/**
 * Creates a Docusaurus theme plugin for Mermaid integration
 * @returns Plugin configuration object for Docusaurus
 */
function themeMermaid(): Plugin<void>;

interface Plugin<T> {
  name: string;
  getThemePath?(): string;
  getTypeScriptThemePath?(): string;
}

// docusaurus.config.js
import themeMermaid from "@docusaurus/theme-mermaid";

export default {
  themes: [themeMermaid()],
  themeConfig: {
    mermaid: {
      theme: {
        light: 'default',
        dark: 'dark',
      },
    },
  },
};

/**
 * Validates and normalizes theme configuration for Mermaid settings
 * @param context - Validation context with validate function and themeConfig
 * @returns Validated and normalized theme configuration
 */
function validateThemeConfig(
  context: ThemeConfigValidationContext<ThemeConfig>
): ThemeConfig;

interface ThemeConfigValidationContext<T> {
  validate: (schema: any, config: any) => T;
  themeConfig: any;
}

const DEFAULT_THEME_CONFIG: ThemeConfig;

interface ThemeConfig {
  mermaid: {
    theme: {
      dark: string;
      light: string;
    };
    options: Record<string, any>;
  };
}

const Schema: Joi.ObjectSchema<ThemeConfig>;

const config = {
  mermaid: {
    theme: {
      light: 'forest',      // Any valid Mermaid theme
      dark: 'dark',         // Any valid Mermaid theme
    },
    options: {
      startOnLoad: false,   // Mermaid configuration options
      theme: 'base',        // Will be overridden by theme.light/dark
    },
  },
};