@docusaurus/theme-classic 3.3.2 → 3.5.0

package/lib/theme/NavbarItem/ComponentTypes.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import type { ComponentTypesObject } from '@theme/NavbarItem/ComponentTypes';
 declare const ComponentTypes: ComponentTypesObject;
 export default ComponentTypes;

package/lib/theme/NavbarItem/DefaultNavbarItem.d.ts

@@ -4,8 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DefaultNavbarItem({ mobile, position, // Need to destructure position from props so that it doesn't get passed on.
 ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocNavbarItem';
 export default function DocNavbarItem({ docId, label: staticLabel, docsPluginId, ...props }: Props): JSX.Element | null;

package/lib/theme/NavbarItem/DocNavbarItem.js

@@ -5,8 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useActiveDocContext} from '@docusaurus/plugin-content-docs/client';
-import {useLayoutDoc} from '@docusaurus/theme-common/internal';
+import {
+  useActiveDocContext,
+  useLayoutDoc,
+} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DocNavbarItem({
   docId,

package/lib/theme/NavbarItem/DocSidebarNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocSidebarNavbarItem';
 export default function DocSidebarNavbarItem({ sidebarId, label, docsPluginId, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocSidebarNavbarItem.js

@@ -5,8 +5,10 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useActiveDocContext} from '@docusaurus/plugin-content-docs/client';
-import {useLayoutDocsSidebar} from '@docusaurus/theme-common/internal';
+import {
+  useActiveDocContext,
+  useLayoutDocsSidebar,
+} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 export default function DocSidebarNavbarItem({
   sidebarId,

package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocsVersionDropdownNavbarItem';
 export default function DocsVersionDropdownNavbarItem({ mobile, docsPluginId, dropdownActiveClassDisabled, dropdownItemsBefore, dropdownItemsAfter, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocsVersionDropdownNavbarItem.js

@@ -8,15 +8,24 @@ import React from 'react';
 import {
   useVersions,
   useActiveDocContext,
+  useDocsVersionCandidates,
+  useDocsPreferredVersion,
 } from '@docusaurus/plugin-content-docs/client';
-import {useDocsPreferredVersion} from '@docusaurus/theme-common';
-import {useDocsVersionCandidates} from '@docusaurus/theme-common/internal';
 import {translate} from '@docusaurus/Translate';
 import {useLocation} from '@docusaurus/router';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 import DropdownNavbarItem from '@theme/NavbarItem/DropdownNavbarItem';
-const getVersionMainDoc = (version) =>
-  version.docs.find((doc) => doc.id === version.mainDocId);
+function getVersionMainDoc(version) {
+  return version.docs.find((doc) => doc.id === version.mainDocId);
+}
+function getVersionTargetDoc(version, activeDocContext) {
+  // We try to link to the same doc, in another version
+  // When not possible, fallback to the "main doc" of the version
+  return (
+    activeDocContext.alternateDocVersions[version.name] ??
+    getVersionMainDoc(version)
+  );
+}
 export default function DocsVersionDropdownNavbarItem({
   mobile,
   docsPluginId,
@@ -29,23 +38,19 @@ export default function DocsVersionDropdownNavbarItem({
   const activeDocContext = useActiveDocContext(docsPluginId);
   const versions = useVersions(docsPluginId);
   const {savePreferredVersionName} = useDocsPreferredVersion(docsPluginId);
-  const versionLinks = versions.map((version) => {
-    // We try to link to the same doc, in another version
-    // When not possible, fallback to the "main doc" of the version
-    const versionDoc =
-      activeDocContext.alternateDocVersions[version.name] ??
-      getVersionMainDoc(version);
+  function versionToLink(version) {
+    const targetDoc = getVersionTargetDoc(version, activeDocContext);
     return {
       label: version.label,
       // preserve ?search#hash suffix on version switches
-      to: `${versionDoc.path}${search}${hash}`,
+      to: `${targetDoc.path}${search}${hash}`,
       isActive: () => version === activeDocContext.activeVersion,
       onClick: () => savePreferredVersionName(version.name),
     };
-  });
+  }
   const items = [
     ...dropdownItemsBefore,
-    ...versionLinks,
+    ...versions.map(versionToLink),
     ...dropdownItemsAfter,
   ];
   const dropdownVersion = useDocsVersionCandidates(docsPluginId)[0];
@@ -62,7 +67,7 @@ export default function DocsVersionDropdownNavbarItem({
   const dropdownTo =
     mobile && items.length > 1
       ? undefined
-      : getVersionMainDoc(dropdownVersion).path;
+      : getVersionTargetDoc(dropdownVersion, activeDocContext).path;
   // We don't want to render a version dropdown with 0 or 1 item. If we build
   // the site with a single docs version (onlyIncludeVersions: ['1.0.0']),
   // We'd rather render a button instead of a dropdown

package/lib/theme/NavbarItem/DocsVersionNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DocsVersionNavbarItem';
 export default function DocsVersionNavbarItem({ label: staticLabel, to: staticTo, docsPluginId, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/DocsVersionNavbarItem.js

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
-import {useDocsVersionCandidates} from '@docusaurus/theme-common/internal';
+import {useDocsVersionCandidates} from '@docusaurus/plugin-content-docs/client';
 import DefaultNavbarItem from '@theme/NavbarItem/DefaultNavbarItem';
 const getVersionMainDoc = (version) =>
   version.docs.find((doc) => doc.id === version.mainDocId);

package/lib/theme/NavbarItem/DropdownNavbarItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/DropdownNavbarItem';
 export default function DropdownNavbarItem({ mobile, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/HtmlNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/HtmlNavbarItem';
 export default function HtmlNavbarItem({ value, className, mobile, isDropdownItem, }: Props): JSX.Element;

package/lib/theme/NavbarItem/LocaleDropdownNavbarItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/LocaleDropdownNavbarItem';
 export default function LocaleDropdownNavbarItem({ mobile, dropdownItemsBefore, dropdownItemsAfter, queryString, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/NavbarNavLink.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/NavbarNavLink';
 export default function NavbarNavLink({ activeBasePath, activeBaseRegex, to, href, label, html, isDropdownLink, prependBaseUrlToHref, ...props }: Props): JSX.Element;

package/lib/theme/NavbarItem/SearchNavbarItem.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem/SearchNavbarItem';
 export default function SearchNavbarItem({ mobile, className, }: Props): JSX.Element | null;

package/lib/theme/NavbarItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NavbarItem';
 export default function NavbarItem({ type, ...props }: Props): JSX.Element;

package/lib/theme/NotFound/Content/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/NotFound/Content';
 export default function NotFoundContent({ className }: Props): JSX.Element;

package/lib/theme/NotFound/index.d.ts

@@ -4,5 +4,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference types="react" />
 export default function Index(): JSX.Element;

package/lib/theme/PaginatorNavLink/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/PaginatorNavLink';
 export default function PaginatorNavLink(props: Props): JSX.Element;

package/lib/theme/SearchBar.d.ts

@@ -4,5 +4,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference types="@docusaurus/module-type-aliases" />
 export { default } from '@docusaurus/Noop';

package/lib/theme/SearchMetadata/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/SearchMetadata';
 export default function SearchMetadata({ locale, version, tag, }: Props): JSX.Element;

package/lib/theme/SiteMetadata/index.d.ts

@@ -4,5 +4,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference types="react" />
 export default function SiteMetadata(): JSX.Element;

package/lib/theme/SkipToContent/index.d.ts

@@ -4,5 +4,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference types="react" />
 export default function SkipToContent(): JSX.Element;

package/lib/theme/TOC/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TOC';
 export default function TOC({ className, ...props }: Props): JSX.Element;

package/lib/theme/TOCCollapsible/CollapseButton/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TOCCollapsible/CollapseButton';
 export default function TOCCollapsibleCollapseButton({ collapsed, ...props }: Props): JSX.Element;

package/lib/theme/TOCCollapsible/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TOCCollapsible';
 export default function TOCCollapsible({ toc, className, minHeadingLevel, maxHeadingLevel, }: Props): JSX.Element;

package/lib/theme/TOCInline/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TOCInline';
 export default function TOCInline({ toc, minHeadingLevel, maxHeadingLevel, }: Props): JSX.Element;

package/lib/theme/TOCItems/Tree.d.ts

@@ -4,7 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
 import React from 'react';
 import type { Props } from '@theme/TOCItems/Tree';
 declare function TOCItemTree({ toc, className, linkClassName, isChild, }: Props): JSX.Element | null;

package/lib/theme/TOCItems/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TOCItems';
 export default function TOCItems({ toc, className, linkClassName, linkActiveClassName, minHeadingLevel: minHeadingLevelOption, maxHeadingLevel: maxHeadingLevelOption, ...props }: Props): JSX.Element | null;

package/lib/theme/TabItem/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TabItem';
 export default function TabItem({ children, hidden, className, }: Props): JSX.Element;

package/lib/theme/Tabs/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Tabs';
 export default function Tabs(props: Props): JSX.Element;

package/lib/theme/Tabs/index.js

@@ -91,7 +91,9 @@ function TabContent({lazy, children, selectedValue}) {
       // fail-safe or fail-fast? not sure what's best here
       return null;
     }
-    return cloneElement(selectedTabItem, {className: 'margin-top--md'});
+    return cloneElement(selectedTabItem, {
+      className: clsx('margin-top--md', selectedTabItem.props.className),
+    });
   }
   return (
     <div className="margin-top--md">

package/lib/theme/Tag/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/Tag';
-export default function Tag({ permalink, label, count }: Props): JSX.Element;
+export default function Tag({ permalink, label, count, description, }: Props): JSX.Element;

package/lib/theme/Tag/index.js

@@ -8,10 +8,11 @@ import React from 'react';
 import clsx from 'clsx';
 import Link from '@docusaurus/Link';
 import styles from './styles.module.css';
-export default function Tag({permalink, label, count}) {
+export default function Tag({permalink, label, count, description}) {
   return (
     <Link
       href={permalink}
+      title={description}
       className={clsx(
         styles.tag,
         count ? styles.tagWithCount : styles.tagRegular,

package/lib/theme/TagsListByLetter/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TagsListByLetter';
 export default function TagsListByLetter({ tags }: Props): JSX.Element;

package/lib/theme/TagsListInline/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/TagsListInline';
 export default function TagsListInline({ tags }: Props): JSX.Element;

package/lib/theme/TagsListInline/index.js

@@ -20,9 +20,9 @@ export default function TagsListInline({tags}) {
         </Translate>
       </b>
       <ul className={clsx(styles.tags, 'padding--none', 'margin-left--sm')}>
-        {tags.map(({label, permalink: tagPermalink}) => (
-          <li key={tagPermalink} className={styles.tag}>
-            <Tag label={label} permalink={tagPermalink} />
+        {tags.map((tag) => (
+          <li key={tag.permalink} className={styles.tag}>
+            <Tag {...tag} />
           </li>
         ))}
       </ul>

package/lib/theme/ThemedImage/index.d.ts

@@ -4,7 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/// <reference path="../../../src/theme-classic.d.ts" />
-/// <reference types="react" />
 import type { Props } from '@theme/ThemedImage';
 export default function ThemedImage(props: Props): JSX.Element;

package/lib/translations.js

@@ -6,7 +6,8 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.translateThemeConfig = exports.getTranslationFiles = void 0;
+exports.getTranslationFiles = getTranslationFiles;
+exports.translateThemeConfig = translateThemeConfig;
 const tslib_1 = require("tslib");
 const lodash_1 = tslib_1.__importDefault(require("lodash"));
 const utils_1 = require("@docusaurus/utils");
@@ -165,7 +166,6 @@ function getTranslationFiles({ themeConfig, }) {
     ];
     return translationFiles.filter(Boolean);
 }
-exports.getTranslationFiles = getTranslationFiles;
 function translateThemeConfig({ themeConfig, translationFiles, }) {
     const translationFilesMap = lodash_1.default.keyBy(translationFiles, (f) => f.path);
     return {
@@ -176,4 +176,3 @@ function translateThemeConfig({ themeConfig, translationFiles, }) {
             : undefined,
     };
 }
-exports.translateThemeConfig = translateThemeConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "3.3.2",
+  "version": "3.5.0",
   "description": "Classic theme for Docusaurus",
   "main": "lib/index.js",
   "types": "src/theme-classic.d.ts",
@@ -20,22 +20,22 @@
     "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch"
   },
   "dependencies": {
-    "@docusaurus/core": "3.3.2",
-    "@docusaurus/mdx-loader": "3.3.2",
-    "@docusaurus/module-type-aliases": "3.3.2",
-    "@docusaurus/plugin-content-blog": "3.3.2",
-    "@docusaurus/plugin-content-docs": "3.3.2",
-    "@docusaurus/plugin-content-pages": "3.3.2",
-    "@docusaurus/theme-common": "3.3.2",
-    "@docusaurus/theme-translations": "3.3.2",
-    "@docusaurus/types": "3.3.2",
-    "@docusaurus/utils": "3.3.2",
-    "@docusaurus/utils-common": "3.3.2",
-    "@docusaurus/utils-validation": "3.3.2",
+    "@docusaurus/core": "3.5.0",
+    "@docusaurus/mdx-loader": "3.5.0",
+    "@docusaurus/module-type-aliases": "3.5.0",
+    "@docusaurus/plugin-content-blog": "3.5.0",
+    "@docusaurus/plugin-content-docs": "3.5.0",
+    "@docusaurus/plugin-content-pages": "3.5.0",
+    "@docusaurus/theme-common": "3.5.0",
+    "@docusaurus/theme-translations": "3.5.0",
+    "@docusaurus/types": "3.5.0",
+    "@docusaurus/utils": "3.5.0",
+    "@docusaurus/utils-common": "3.5.0",
+    "@docusaurus/utils-validation": "3.5.0",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "copy-text-to-clipboard": "^3.2.0",
-    "infima": "0.2.0-alpha.43",
+    "infima": "0.2.0-alpha.44",
     "lodash": "^4.17.21",
     "nprogress": "^0.2.0",
     "postcss": "^8.4.26",
@@ -61,5 +61,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "bc638d674bfbde1e254ef306697f47e764b5e107"
+  "gitHead": "cb5829f3c34b26d798b869e38ee25073488140bd"
 }

package/src/getSwizzleConfig.ts

@@ -127,6 +127,27 @@ export default function getSwizzleConfig(): SwizzleConfig {
         description:
           'The object mapping admonition type to a React component.\nUse it to add custom admonition type components, or replace existing ones.\nCan be ejected or wrapped (only manually, see our documentation).',
       },
+      Blog: {
+        actions: {
+          // Forbidden because it's a parent folder, makes the CLI crash atm
+          eject: 'forbidden',
+          wrap: 'forbidden',
+        },
+      },
+      'Blog/Components': {
+        actions: {
+          // Forbidden because it's a parent folder, makes the CLI crash atm
+          eject: 'forbidden',
+          wrap: 'forbidden',
+        },
+      },
+      'Blog/Pages': {
+        actions: {
+          // Forbidden because it's a parent folder, makes the CLI crash atm
+          eject: 'forbidden',
+          wrap: 'forbidden',
+        },
+      },
       CodeBlock: {
         actions: {
           eject: 'safe',
@@ -289,6 +310,17 @@ export default function getSwizzleConfig(): SwizzleConfig {
         },
         description: 'The menu icon component',
       },
+      'Icon/Socials': {
+        actions: {
+          // Forbidden because it's a parent folder, makes the CLI crash atm
+          // TODO the CLI should rather support --eject
+          // Subfolders can be swizzled
+          eject: 'forbidden',
+          wrap: 'forbidden',
+        },
+        description:
+          'The Icon/Socials folder is not directly swizzle-able, but you can swizzle its sub-components.',
+      },
       MDXComponents: {
         actions: {
           eject: 'safe',