@docusaurus/theme-classic 2.0.0-beta.20 → 2.0.0-beta.21

package/lib/validateThemeConfig.js

@@ -1,367 +1,400 @@
 "use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.ThemeConfigSchema = exports.DEFAULT_CONFIG = void 0;
-exports.validateThemeConfig = validateThemeConfig;
-
-var _palenight = _interopRequireDefault(require("prism-react-renderer/themes/palenight"));
-
-var _utilsValidation = require("@docusaurus/utils-validation");
-
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
-
 /**
  * Copyright (c) Facebook, Inc. and its affiliates.
  *
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateThemeConfig = exports.ThemeConfigSchema = exports.DEFAULT_CONFIG = void 0;
+const tslib_1 = require("tslib");
+const palenight_1 = tslib_1.__importDefault(require("prism-react-renderer/themes/palenight"));
+const utils_validation_1 = require("@docusaurus/utils-validation");
 const DEFAULT_DOCS_CONFIG = {
-  versionPersistence: 'localStorage',
-  sidebar: {
-    hideable: false,
-    autoCollapseCategories: false
-  }
+    versionPersistence: 'localStorage',
+    sidebar: {
+        hideable: false,
+        autoCollapseCategories: false,
+    },
 };
-
-const DocsSchema = _utilsValidation.Joi.object({
-  versionPersistence: _utilsValidation.Joi.string().equal('localStorage', 'none').default(DEFAULT_DOCS_CONFIG.versionPersistence),
-  sidebar: _utilsValidation.Joi.object({
-    hideable: _utilsValidation.Joi.bool().default(DEFAULT_DOCS_CONFIG.sidebar.hideable),
-    autoCollapseCategories: _utilsValidation.Joi.bool().default(DEFAULT_DOCS_CONFIG.sidebar.autoCollapseCategories)
-  }).default(DEFAULT_DOCS_CONFIG.sidebar)
+const DocsSchema = utils_validation_1.Joi.object({
+    versionPersistence: utils_validation_1.Joi.string()
+        .equal('localStorage', 'none')
+        .default(DEFAULT_DOCS_CONFIG.versionPersistence),
+    sidebar: utils_validation_1.Joi.object({
+        hideable: utils_validation_1.Joi.bool().default(DEFAULT_DOCS_CONFIG.sidebar.hideable),
+        autoCollapseCategories: utils_validation_1.Joi.bool().default(DEFAULT_DOCS_CONFIG.sidebar.autoCollapseCategories),
+    }).default(DEFAULT_DOCS_CONFIG.sidebar),
 }).default(DEFAULT_DOCS_CONFIG);
-
 const DEFAULT_COLOR_MODE_CONFIG = {
-  defaultMode: 'light',
-  disableSwitch: false,
-  respectPrefersColorScheme: false
+    defaultMode: 'light',
+    disableSwitch: false,
+    respectPrefersColorScheme: false,
 };
-const DEFAULT_CONFIG = {
-  colorMode: DEFAULT_COLOR_MODE_CONFIG,
-  docs: DEFAULT_DOCS_CONFIG,
-  metadata: [],
-  prism: {
-    additionalLanguages: [],
-    theme: _palenight.default,
-    magicComments: [{
-      className: 'theme-code-block-highlighted-line',
-      line: 'highlight-next-line',
-      block: {
-        start: 'highlight-start',
-        end: 'highlight-end'
-      }
-    }]
-  },
-  navbar: {
-    hideOnScroll: false,
-    items: []
-  },
-  tableOfContents: {
-    minHeadingLevel: 2,
-    maxHeadingLevel: 3
-  }
+exports.DEFAULT_CONFIG = {
+    colorMode: DEFAULT_COLOR_MODE_CONFIG,
+    docs: DEFAULT_DOCS_CONFIG,
+    metadata: [],
+    prism: {
+        additionalLanguages: [],
+        theme: palenight_1.default,
+        magicComments: [
+            {
+                className: 'theme-code-block-highlighted-line',
+                line: 'highlight-next-line',
+                block: { start: 'highlight-start', end: 'highlight-end' },
+            },
+        ],
+    },
+    navbar: {
+        hideOnScroll: false,
+        items: [],
+    },
+    tableOfContents: {
+        minHeadingLevel: 2,
+        maxHeadingLevel: 3,
+    },
 };
-exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
-
-const NavbarItemPosition = _utilsValidation.Joi.string().equal('left', 'right').default('left');
-
-const NavbarItemBaseSchema = _utilsValidation.Joi.object({
-  label: _utilsValidation.Joi.string(),
-  html: _utilsValidation.Joi.string(),
-  className: _utilsValidation.Joi.string()
-}).nand('html', 'label') // We allow any unknown attributes on the links (users may need additional
-// attributes like target, aria-role, data-customAttribute...)
-.unknown();
-
+const NavbarItemPosition = utils_validation_1.Joi.string().equal('left', 'right').default('left');
+const NavbarItemBaseSchema = utils_validation_1.Joi.object({
+    label: utils_validation_1.Joi.string(),
+    html: utils_validation_1.Joi.string(),
+    className: utils_validation_1.Joi.string(),
+})
+    .nand('html', 'label')
+    // We allow any unknown attributes on the links (users may need additional
+    // attributes like target, aria-role, data-customAttribute...)
+    .unknown();
 const DefaultNavbarItemSchema = NavbarItemBaseSchema.append({
-  to: _utilsValidation.Joi.string(),
-  href: _utilsValidation.URISchema,
-  activeBasePath: _utilsValidation.Joi.string(),
-  activeBaseRegex: _utilsValidation.Joi.string(),
-  prependBaseUrlToHref: _utilsValidation.Joi.bool(),
-  // This is only triggered in case of a nested dropdown
-  items: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'Nested dropdowns are not allowed'
-  })
-}).xor('href', 'to').messages({
-  'object.xor': 'One and only one between "to" and "href" should be provided'
+    to: utils_validation_1.Joi.string(),
+    href: utils_validation_1.URISchema,
+    activeBasePath: utils_validation_1.Joi.string(),
+    activeBaseRegex: utils_validation_1.Joi.string(),
+    prependBaseUrlToHref: utils_validation_1.Joi.bool(),
+    // This is only triggered in case of a nested dropdown
+    items: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'Nested dropdowns are not allowed',
+    }),
+})
+    .xor('href', 'to')
+    .messages({
+    'object.xor': 'One and only one between "to" and "href" should be provided',
 });
 const DocsVersionNavbarItemSchema = NavbarItemBaseSchema.append({
-  type: _utilsValidation.Joi.string().equal('docsVersion').required(),
-  to: _utilsValidation.Joi.string(),
-  docsPluginId: _utilsValidation.Joi.string()
+    type: utils_validation_1.Joi.string().equal('docsVersion').required(),
+    to: utils_validation_1.Joi.string(),
+    docsPluginId: utils_validation_1.Joi.string(),
 });
 const DocItemSchema = NavbarItemBaseSchema.append({
-  type: _utilsValidation.Joi.string().equal('doc').required(),
-  docId: _utilsValidation.Joi.string().required(),
-  docsPluginId: _utilsValidation.Joi.string()
+    type: utils_validation_1.Joi.string().equal('doc').required(),
+    docId: utils_validation_1.Joi.string().required(),
+    docsPluginId: utils_validation_1.Joi.string(),
 });
 const DocSidebarItemSchema = NavbarItemBaseSchema.append({
-  type: _utilsValidation.Joi.string().equal('docSidebar').required(),
-  sidebarId: _utilsValidation.Joi.string().required(),
-  docsPluginId: _utilsValidation.Joi.string()
+    type: utils_validation_1.Joi.string().equal('docSidebar').required(),
+    sidebarId: utils_validation_1.Joi.string().required(),
+    docsPluginId: utils_validation_1.Joi.string(),
+});
+const HtmlNavbarItemSchema = utils_validation_1.Joi.object({
+    className: utils_validation_1.Joi.string(),
+    type: utils_validation_1.Joi.string().equal('html').required(),
+    value: utils_validation_1.Joi.string().required(),
 });
-
-const HtmlNavbarItemSchema = _utilsValidation.Joi.object({
-  className: _utilsValidation.Joi.string(),
-  type: _utilsValidation.Joi.string().equal('html').required(),
-  value: _utilsValidation.Joi.string().required()
-}); // A temporary workaround to allow users to add custom navbar items
+// A temporary workaround to allow users to add custom navbar items
 // See https://github.com/facebook/docusaurus/issues/7227
-
-
 const CustomNavbarItemRegexp = /custom-.*/;
-
-const CustomNavbarItemSchema = _utilsValidation.Joi.object({
-  type: _utilsValidation.Joi.string().regex(CustomNavbarItemRegexp).required()
+const CustomNavbarItemSchema = utils_validation_1.Joi.object({
+    type: utils_validation_1.Joi.string().regex(CustomNavbarItemRegexp).required(),
 }).unknown();
-
-const itemWithType = type => {
-  // Because equal(undefined) is not supported :/
-  const typeSchema = // eslint-disable-next-line no-nested-ternary
-  type instanceof RegExp ? _utilsValidation.Joi.string().required().regex(type) : type ? _utilsValidation.Joi.string().required().equal(type) : _utilsValidation.Joi.string().forbidden();
-  return _utilsValidation.Joi.object({
-    type: typeSchema
-  }).unknown().required();
+const itemWithType = (type) => {
+    // Because equal(undefined) is not supported :/
+    const typeSchema = 
+    // eslint-disable-next-line no-nested-ternary
+    type instanceof RegExp
+        ? utils_validation_1.Joi.string().required().regex(type)
+        : type
+            ? utils_validation_1.Joi.string().required().equal(type)
+            : utils_validation_1.Joi.string().forbidden();
+    return utils_validation_1.Joi.object({
+        type: typeSchema,
+    })
+        .unknown()
+        .required();
 };
-
-const DropdownSubitemSchema = _utilsValidation.Joi.object({
-  position: _utilsValidation.Joi.forbidden()
+const DropdownSubitemSchema = utils_validation_1.Joi.object({
+    position: utils_validation_1.Joi.forbidden(),
 }).when('.', {
-  switch: [{
-    is: itemWithType('docsVersion'),
-    then: DocsVersionNavbarItemSchema
-  }, {
-    is: itemWithType('doc'),
-    then: DocItemSchema
-  }, {
-    is: itemWithType('docSidebar'),
-    then: DocSidebarItemSchema
-  }, {
-    is: itemWithType(undefined),
-    then: DefaultNavbarItemSchema
-  }, {
-    is: itemWithType('html'),
-    then: HtmlNavbarItemSchema
-  }, {
-    is: itemWithType(CustomNavbarItemRegexp),
-    then: CustomNavbarItemSchema
-  }, {
-    is: _utilsValidation.Joi.alternatives().try(itemWithType('dropdown'), itemWithType('docsVersionDropdown'), itemWithType('localeDropdown'), itemWithType('search')),
-    then: _utilsValidation.Joi.forbidden().messages({
-      'any.unknown': 'Nested dropdowns are not allowed'
-    })
-  }],
-  otherwise: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'Bad navbar item type {.type}'
-  })
+    switch: [
+        {
+            is: itemWithType('docsVersion'),
+            then: DocsVersionNavbarItemSchema,
+        },
+        {
+            is: itemWithType('doc'),
+            then: DocItemSchema,
+        },
+        {
+            is: itemWithType('docSidebar'),
+            then: DocSidebarItemSchema,
+        },
+        {
+            is: itemWithType(undefined),
+            then: DefaultNavbarItemSchema,
+        },
+        {
+            is: itemWithType('html'),
+            then: HtmlNavbarItemSchema,
+        },
+        {
+            is: itemWithType(CustomNavbarItemRegexp),
+            then: CustomNavbarItemSchema,
+        },
+        {
+            is: utils_validation_1.Joi.alternatives().try(itemWithType('dropdown'), itemWithType('docsVersionDropdown'), itemWithType('localeDropdown'), itemWithType('search')),
+            then: utils_validation_1.Joi.forbidden().messages({
+                'any.unknown': 'Nested dropdowns are not allowed',
+            }),
+        },
+    ],
+    otherwise: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'Bad navbar item type {.type}',
+    }),
 });
-
 const DropdownNavbarItemSchema = NavbarItemBaseSchema.append({
-  items: _utilsValidation.Joi.array().items(DropdownSubitemSchema).required()
+    items: utils_validation_1.Joi.array().items(DropdownSubitemSchema).required(),
 });
 const DocsVersionDropdownNavbarItemSchema = NavbarItemBaseSchema.append({
-  type: _utilsValidation.Joi.string().equal('docsVersionDropdown').required(),
-  docsPluginId: _utilsValidation.Joi.string(),
-  dropdownActiveClassDisabled: _utilsValidation.Joi.boolean(),
-  dropdownItemsBefore: _utilsValidation.Joi.array().items(DropdownSubitemSchema).default([]),
-  dropdownItemsAfter: _utilsValidation.Joi.array().items(DropdownSubitemSchema).default([])
+    type: utils_validation_1.Joi.string().equal('docsVersionDropdown').required(),
+    docsPluginId: utils_validation_1.Joi.string(),
+    dropdownActiveClassDisabled: utils_validation_1.Joi.boolean(),
+    dropdownItemsBefore: utils_validation_1.Joi.array().items(DropdownSubitemSchema).default([]),
+    dropdownItemsAfter: utils_validation_1.Joi.array().items(DropdownSubitemSchema).default([]),
 });
 const LocaleDropdownNavbarItemSchema = NavbarItemBaseSchema.append({
-  type: _utilsValidation.Joi.string().equal('localeDropdown').required(),
-  dropdownItemsBefore: _utilsValidation.Joi.array().items(DropdownSubitemSchema).default([]),
-  dropdownItemsAfter: _utilsValidation.Joi.array().items(DropdownSubitemSchema).default([])
+    type: utils_validation_1.Joi.string().equal('localeDropdown').required(),
+    dropdownItemsBefore: utils_validation_1.Joi.array().items(DropdownSubitemSchema).default([]),
+    dropdownItemsAfter: utils_validation_1.Joi.array().items(DropdownSubitemSchema).default([]),
 });
-
-const SearchItemSchema = _utilsValidation.Joi.object({
-  type: _utilsValidation.Joi.string().equal('search').required()
+const SearchItemSchema = utils_validation_1.Joi.object({
+    type: utils_validation_1.Joi.string().equal('search').required(),
+    className: utils_validation_1.Joi.string(),
 });
-
-const NavbarItemSchema = _utilsValidation.Joi.object({
-  position: NavbarItemPosition
+const NavbarItemSchema = utils_validation_1.Joi.object({
+    position: NavbarItemPosition,
 }).when('.', {
-  switch: [{
-    is: itemWithType('docsVersion'),
-    then: DocsVersionNavbarItemSchema
-  }, {
-    is: itemWithType('dropdown'),
-    then: DropdownNavbarItemSchema
-  }, {
-    is: itemWithType('docsVersionDropdown'),
-    then: DocsVersionDropdownNavbarItemSchema
-  }, {
-    is: itemWithType('doc'),
-    then: DocItemSchema
-  }, {
-    is: itemWithType('docSidebar'),
-    then: DocSidebarItemSchema
-  }, {
-    is: itemWithType('localeDropdown'),
-    then: LocaleDropdownNavbarItemSchema
-  }, {
-    is: itemWithType('search'),
-    then: SearchItemSchema
-  }, {
-    is: itemWithType('html'),
-    then: HtmlNavbarItemSchema
-  }, {
-    is: itemWithType(CustomNavbarItemRegexp),
-    then: CustomNavbarItemSchema
-  }, {
-    is: itemWithType(undefined),
-    then: _utilsValidation.Joi.object().when('.', {
-      // Dropdown item can be specified without type field
-      is: _utilsValidation.Joi.object({
-        items: _utilsValidation.Joi.array().required()
-      }).unknown(),
-      then: DropdownNavbarItemSchema,
-      otherwise: DefaultNavbarItemSchema
-    })
-  }],
-  otherwise: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'Bad navbar item type {.type}'
-  })
+    switch: [
+        {
+            is: itemWithType('docsVersion'),
+            then: DocsVersionNavbarItemSchema,
+        },
+        {
+            is: itemWithType('dropdown'),
+            then: DropdownNavbarItemSchema,
+        },
+        {
+            is: itemWithType('docsVersionDropdown'),
+            then: DocsVersionDropdownNavbarItemSchema,
+        },
+        {
+            is: itemWithType('doc'),
+            then: DocItemSchema,
+        },
+        {
+            is: itemWithType('docSidebar'),
+            then: DocSidebarItemSchema,
+        },
+        {
+            is: itemWithType('localeDropdown'),
+            then: LocaleDropdownNavbarItemSchema,
+        },
+        {
+            is: itemWithType('search'),
+            then: SearchItemSchema,
+        },
+        {
+            is: itemWithType('html'),
+            then: HtmlNavbarItemSchema,
+        },
+        {
+            is: itemWithType(CustomNavbarItemRegexp),
+            then: CustomNavbarItemSchema,
+        },
+        {
+            is: itemWithType(undefined),
+            then: utils_validation_1.Joi.object().when('.', {
+                // Dropdown item can be specified without type field
+                is: utils_validation_1.Joi.object({
+                    items: utils_validation_1.Joi.array().required(),
+                }).unknown(),
+                then: DropdownNavbarItemSchema,
+                otherwise: DefaultNavbarItemSchema,
+            }),
+        },
+    ],
+    otherwise: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'Bad navbar item type {.type}',
+    }),
 });
-
-const ColorModeSchema = _utilsValidation.Joi.object({
-  defaultMode: _utilsValidation.Joi.string().equal('dark', 'light').default(DEFAULT_COLOR_MODE_CONFIG.defaultMode),
-  disableSwitch: _utilsValidation.Joi.bool().default(DEFAULT_COLOR_MODE_CONFIG.disableSwitch),
-  respectPrefersColorScheme: _utilsValidation.Joi.bool().default(DEFAULT_COLOR_MODE_CONFIG.respectPrefersColorScheme),
-  switchConfig: _utilsValidation.Joi.any().forbidden().messages({
-    'any.unknown': 'colorMode.switchConfig is deprecated. If you want to customize the icons for light and dark mode, swizzle IconLightMode, IconDarkMode, or ColorModeToggle instead.'
-  })
+const ColorModeSchema = utils_validation_1.Joi.object({
+    defaultMode: utils_validation_1.Joi.string()
+        .equal('dark', 'light')
+        .default(DEFAULT_COLOR_MODE_CONFIG.defaultMode),
+    disableSwitch: utils_validation_1.Joi.bool().default(DEFAULT_COLOR_MODE_CONFIG.disableSwitch),
+    respectPrefersColorScheme: utils_validation_1.Joi.bool().default(DEFAULT_COLOR_MODE_CONFIG.respectPrefersColorScheme),
+    switchConfig: utils_validation_1.Joi.any().forbidden().messages({
+        'any.unknown': 'colorMode.switchConfig is deprecated. If you want to customize the icons for light and dark mode, swizzle IconLightMode, IconDarkMode, or ColorModeToggle instead.',
+    }),
 }).default(DEFAULT_COLOR_MODE_CONFIG);
-
-const HtmlMetadataSchema = _utilsValidation.Joi.object({
-  id: _utilsValidation.Joi.string(),
-  name: _utilsValidation.Joi.string(),
-  property: _utilsValidation.Joi.string(),
-  content: _utilsValidation.Joi.string(),
-  itemprop: _utilsValidation.Joi.string()
+const HtmlMetadataSchema = utils_validation_1.Joi.object({
+    id: utils_validation_1.Joi.string(),
+    name: utils_validation_1.Joi.string(),
+    property: utils_validation_1.Joi.string(),
+    content: utils_validation_1.Joi.string(),
+    itemprop: utils_validation_1.Joi.string(),
 }).unknown();
-
-const FooterLinkItemSchema = _utilsValidation.Joi.object({
-  to: _utilsValidation.Joi.string(),
-  href: _utilsValidation.URISchema,
-  html: _utilsValidation.Joi.string(),
-  label: _utilsValidation.Joi.string()
-}).xor('to', 'href', 'html').with('to', 'label').with('href', 'label').nand('html', 'label') // We allow any unknown attributes on the links (users may need additional
-// attributes like target, aria-role, data-customAttribute...)
-.unknown();
-
-const CustomCssSchema = _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.array().items(_utilsValidation.Joi.string().required()), _utilsValidation.Joi.string().required()).optional();
-
-const ThemeConfigSchema = _utilsValidation.Joi.object({
-  // TODO temporary (@alpha-58)
-  disableDarkMode: _utilsValidation.Joi.any().forbidden().messages({
-    'any.unknown': 'disableDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.disableSwitch = true'
-  }),
-  // TODO temporary (@alpha-58)
-  defaultDarkMode: _utilsValidation.Joi.any().forbidden().messages({
-    'any.unknown': 'defaultDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.defaultMode = "dark"'
-  }),
-  customCss: CustomCssSchema,
-  colorMode: ColorModeSchema,
-  image: _utilsValidation.Joi.string(),
-  docs: DocsSchema,
-  metadata: _utilsValidation.Joi.array().items(HtmlMetadataSchema).default(DEFAULT_CONFIG.metadata),
-  // cSpell:ignore metadatas
-  metadatas: _utilsValidation.Joi.any().forbidden().messages({
-    'any.unknown': // cSpell:ignore metadatas
-    'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871'
-  }),
-  announcementBar: _utilsValidation.Joi.object({
-    id: _utilsValidation.Joi.string().default('announcement-bar'),
-    content: _utilsValidation.Joi.string().required(),
-    backgroundColor: _utilsValidation.Joi.string(),
-    textColor: _utilsValidation.Joi.string(),
-    isCloseable: _utilsValidation.Joi.bool().default(true)
-  }).optional(),
-  navbar: _utilsValidation.Joi.object({
-    style: _utilsValidation.Joi.string().equal('dark', 'primary'),
-    hideOnScroll: _utilsValidation.Joi.bool().default(DEFAULT_CONFIG.navbar.hideOnScroll),
+const FooterLinkItemSchema = utils_validation_1.Joi.object({
+    to: utils_validation_1.Joi.string(),
+    href: utils_validation_1.URISchema,
+    html: utils_validation_1.Joi.string(),
+    label: utils_validation_1.Joi.string(),
+})
+    .xor('to', 'href', 'html')
+    .with('to', 'label')
+    .with('href', 'label')
+    .nand('html', 'label')
+    // We allow any unknown attributes on the links (users may need additional
+    // attributes like target, aria-role, data-customAttribute...)
+    .unknown();
+const CustomCssSchema = utils_validation_1.Joi.alternatives()
+    .try(utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().required()), utils_validation_1.Joi.string().required())
+    .optional();
+exports.ThemeConfigSchema = utils_validation_1.Joi.object({
     // TODO temporary (@alpha-58)
-    links: _utilsValidation.Joi.any().forbidden().messages({
-      'any.unknown': 'themeConfig.navbar.links has been renamed as themeConfig.navbar.items'
+    // @ts-expect-error: forbidden
+    disableDarkMode: utils_validation_1.Joi.any().forbidden().messages({
+        'any.unknown': 'disableDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.disableSwitch = true',
     }),
-    items: _utilsValidation.Joi.array().items(NavbarItemSchema).default(DEFAULT_CONFIG.navbar.items),
-    title: _utilsValidation.Joi.string().allow('', null),
-    logo: _utilsValidation.Joi.object({
-      alt: _utilsValidation.Joi.string().allow(''),
-      src: _utilsValidation.Joi.string().required(),
-      srcDark: _utilsValidation.Joi.string(),
-      width: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.string(), _utilsValidation.Joi.number()),
-      height: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.string(), _utilsValidation.Joi.number()),
-      href: _utilsValidation.Joi.string(),
-      target: _utilsValidation.Joi.string()
+    // TODO temporary (@alpha-58)
+    defaultDarkMode: utils_validation_1.Joi.any().forbidden().messages({
+        'any.unknown': 'defaultDarkMode theme config is deprecated. Please use the new colorMode attribute. You likely want: config.themeConfig.colorMode.defaultMode = "dark"',
+    }),
+    customCss: CustomCssSchema,
+    colorMode: ColorModeSchema,
+    image: utils_validation_1.Joi.string(),
+    docs: DocsSchema,
+    metadata: utils_validation_1.Joi.array()
+        .items(HtmlMetadataSchema)
+        .default(exports.DEFAULT_CONFIG.metadata),
+    // cSpell:ignore metadatas
+    metadatas: utils_validation_1.Joi.any().forbidden().messages({
+        'any.unknown': 
+        // cSpell:ignore metadatas
+        'themeConfig.metadatas has been renamed as themeConfig.metadata. See https://github.com/facebook/docusaurus/pull/5871',
+    }),
+    announcementBar: utils_validation_1.Joi.object({
+        id: utils_validation_1.Joi.string().default('announcement-bar'),
+        content: utils_validation_1.Joi.string().required(),
+        backgroundColor: utils_validation_1.Joi.string(),
+        textColor: utils_validation_1.Joi.string(),
+        isCloseable: utils_validation_1.Joi.bool().default(true),
+    }).optional(),
+    navbar: utils_validation_1.Joi.object({
+        style: utils_validation_1.Joi.string().equal('dark', 'primary'),
+        hideOnScroll: utils_validation_1.Joi.bool().default(exports.DEFAULT_CONFIG.navbar.hideOnScroll),
+        // TODO temporary (@alpha-58)
+        links: utils_validation_1.Joi.any().forbidden().messages({
+            'any.unknown': 'themeConfig.navbar.links has been renamed as themeConfig.navbar.items',
+        }),
+        items: utils_validation_1.Joi.array()
+            .items(NavbarItemSchema)
+            .default(exports.DEFAULT_CONFIG.navbar.items),
+        title: utils_validation_1.Joi.string().allow('', null),
+        logo: utils_validation_1.Joi.object({
+            alt: utils_validation_1.Joi.string().allow(''),
+            src: utils_validation_1.Joi.string().required(),
+            srcDark: utils_validation_1.Joi.string(),
+            width: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.number()),
+            height: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.number()),
+            href: utils_validation_1.Joi.string(),
+            target: utils_validation_1.Joi.string(),
+        }),
+    }).default(exports.DEFAULT_CONFIG.navbar),
+    footer: utils_validation_1.Joi.object({
+        style: utils_validation_1.Joi.string().equal('dark', 'light').default('light'),
+        logo: utils_validation_1.Joi.object({
+            alt: utils_validation_1.Joi.string().allow(''),
+            src: utils_validation_1.Joi.string().required(),
+            srcDark: utils_validation_1.Joi.string(),
+            // TODO infer this from reading the image
+            width: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.number()),
+            height: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.number()),
+            href: utils_validation_1.Joi.string(),
+        }),
+        copyright: utils_validation_1.Joi.string(),
+        links: utils_validation_1.Joi.alternatives(utils_validation_1.Joi.array().items(utils_validation_1.Joi.object({
+            title: utils_validation_1.Joi.string().allow(null).default(null),
+            items: utils_validation_1.Joi.array().items(FooterLinkItemSchema).default([]),
+        })), utils_validation_1.Joi.array().items(FooterLinkItemSchema))
+            .messages({
+            'alternatives.match': `The footer must be either simple or multi-column, and not a mix of the two. See: https://docusaurus.io/docs/api/themes/configuration#footer-links`,
+        })
+            .default([]),
+    }).optional(),
+    prism: utils_validation_1.Joi.object({
+        theme: utils_validation_1.Joi.object({
+            plain: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.array(), utils_validation_1.Joi.object()).required(),
+            styles: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.array(), utils_validation_1.Joi.object()).required(),
+        }).default(exports.DEFAULT_CONFIG.prism.theme),
+        darkTheme: utils_validation_1.Joi.object({
+            plain: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.array(), utils_validation_1.Joi.object()).required(),
+            styles: utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.array(), utils_validation_1.Joi.object()).required(),
+        }),
+        defaultLanguage: utils_validation_1.Joi.string(),
+        additionalLanguages: utils_validation_1.Joi.array()
+            .items(utils_validation_1.Joi.string())
+            .default(exports.DEFAULT_CONFIG.prism.additionalLanguages),
+        magicComments: utils_validation_1.Joi.array()
+            .items(utils_validation_1.Joi.object({
+            className: utils_validation_1.Joi.string().required(),
+            line: utils_validation_1.Joi.string(),
+            block: utils_validation_1.Joi.object({
+                start: utils_validation_1.Joi.string().required(),
+                end: utils_validation_1.Joi.string().required(),
+            }),
+        }).or('line', 'block'))
+            .default(exports.DEFAULT_CONFIG.prism.magicComments),
     })
-  }).default(DEFAULT_CONFIG.navbar),
-  footer: _utilsValidation.Joi.object({
-    style: _utilsValidation.Joi.string().equal('dark', 'light').default('light'),
-    logo: _utilsValidation.Joi.object({
-      alt: _utilsValidation.Joi.string().allow(''),
-      src: _utilsValidation.Joi.string().required(),
-      srcDark: _utilsValidation.Joi.string(),
-      // TODO infer this from reading the image
-      width: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.string(), _utilsValidation.Joi.number()),
-      height: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.string(), _utilsValidation.Joi.number()),
-      href: _utilsValidation.Joi.string()
+        .default(exports.DEFAULT_CONFIG.prism)
+        .unknown(),
+    hideableSidebar: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'themeConfig.hideableSidebar has been moved to themeConfig.docs.sidebar.hideable.',
     }),
-    copyright: _utilsValidation.Joi.string(),
-    links: _utilsValidation.Joi.alternatives(_utilsValidation.Joi.array().items(_utilsValidation.Joi.object({
-      title: _utilsValidation.Joi.string().allow(null).default(null),
-      items: _utilsValidation.Joi.array().items(FooterLinkItemSchema).default([])
-    })), _utilsValidation.Joi.array().items(FooterLinkItemSchema)).messages({
-      'alternatives.match': `The footer must be either simple or multi-column, and not a mix of the two. See: https://docusaurus.io/docs/api/themes/configuration#footer-links`
-    }).default([])
-  }).optional(),
-  prism: _utilsValidation.Joi.object({
-    theme: _utilsValidation.Joi.object({
-      plain: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.array(), _utilsValidation.Joi.object()).required(),
-      styles: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.array(), _utilsValidation.Joi.object()).required()
-    }).default(DEFAULT_CONFIG.prism.theme),
-    darkTheme: _utilsValidation.Joi.object({
-      plain: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.array(), _utilsValidation.Joi.object()).required(),
-      styles: _utilsValidation.Joi.alternatives().try(_utilsValidation.Joi.array(), _utilsValidation.Joi.object()).required()
+    autoCollapseSidebarCategories: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'themeConfig.autoCollapseSidebarCategories has been moved to themeConfig.docs.sidebar.autoCollapseCategories.',
     }),
-    defaultLanguage: _utilsValidation.Joi.string(),
-    additionalLanguages: _utilsValidation.Joi.array().items(_utilsValidation.Joi.string()).default(DEFAULT_CONFIG.prism.additionalLanguages),
-    magicComments: _utilsValidation.Joi.array().items(_utilsValidation.Joi.object({
-      className: _utilsValidation.Joi.string().required(),
-      line: _utilsValidation.Joi.string(),
-      block: _utilsValidation.Joi.object({
-        start: _utilsValidation.Joi.string().required(),
-        end: _utilsValidation.Joi.string().required()
-      })
-    }).or('line', 'block')).default(DEFAULT_CONFIG.prism.magicComments)
-  }).default(DEFAULT_CONFIG.prism).unknown(),
-  hideableSidebar: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'themeConfig.hideableSidebar has been moved to themeConfig.docs.sidebar.hideable.'
-  }),
-  autoCollapseSidebarCategories: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'themeConfig.autoCollapseSidebarCategories has been moved to themeConfig.docs.sidebar.autoCollapseCategories.'
-  }),
-  sidebarCollapsible: _utilsValidation.Joi.forbidden().messages({
-    'any.unknown': 'The themeConfig.sidebarCollapsible has been moved to docs plugin options. See: https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs'
-  }),
-  tableOfContents: _utilsValidation.Joi.object({
-    minHeadingLevel: _utilsValidation.Joi.number().default(DEFAULT_CONFIG.tableOfContents.minHeadingLevel).when('maxHeadingLevel', {
-      is: _utilsValidation.Joi.exist(),
-      then: _utilsValidation.Joi.number().integer().min(2).max(6).max(_utilsValidation.Joi.ref('maxHeadingLevel')),
-      otherwise: _utilsValidation.Joi.number().integer().min(2).max(6)
+    sidebarCollapsible: utils_validation_1.Joi.forbidden().messages({
+        'any.unknown': 'The themeConfig.sidebarCollapsible has been moved to docs plugin options. See: https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs',
     }),
-    maxHeadingLevel: _utilsValidation.Joi.number().integer().min(2).max(6).default(DEFAULT_CONFIG.tableOfContents.maxHeadingLevel)
-  }).default(DEFAULT_CONFIG.tableOfContents)
+    tableOfContents: utils_validation_1.Joi.object({
+        minHeadingLevel: utils_validation_1.Joi.number()
+            .default(exports.DEFAULT_CONFIG.tableOfContents.minHeadingLevel)
+            .when('maxHeadingLevel', {
+            is: utils_validation_1.Joi.exist(),
+            then: utils_validation_1.Joi.number()
+                .integer()
+                .min(2)
+                .max(6)
+                .max(utils_validation_1.Joi.ref('maxHeadingLevel')),
+            otherwise: utils_validation_1.Joi.number().integer().min(2).max(6),
+        }),
+        maxHeadingLevel: utils_validation_1.Joi.number()
+            .integer()
+            .min(2)
+            .max(6)
+            .default(exports.DEFAULT_CONFIG.tableOfContents.maxHeadingLevel),
+    }).default(exports.DEFAULT_CONFIG.tableOfContents),
 });
-
-exports.ThemeConfigSchema = ThemeConfigSchema;
-
-function validateThemeConfig({
-  validate,
-  themeConfig
-}) {
-  return validate(ThemeConfigSchema, themeConfig);
-}
+function validateThemeConfig({ validate, themeConfig, }) {
+    return validate(exports.ThemeConfigSchema, themeConfig);
+}
+exports.validateThemeConfig = validateThemeConfig;