@docusaurus/types 3.10.2 → 4.0.0-canary-6809

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/types",
-  "version": "3.10.2",
+  "version": "4.0.0-canary-6809",
   "description": "Common types for Docusaurus packages.",
   "types": "./src/index.d.ts",
   "publishConfig": {
@@ -13,20 +13,20 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@mdx-js/mdx": "^3.0.0",
+    "@mdx-js/mdx": "^3.1.1",
     "@types/history": "^4.7.11",
-    "@types/mdast": "^4.0.2",
-    "@types/react": "*",
+    "@types/mdast": "^4.0.4",
+    "@types/react": "19.3.0",
     "commander": "^5.1.0",
-    "joi": "^17.9.2",
+    "joi": "^18.2.8",
     "react-helmet-async": "npm:@slorber/react-helmet-async@1.3.0",
-    "utility-types": "^3.10.0",
-    "webpack": "^5.95.0",
-    "webpack-merge": "^5.9.0"
+    "utility-types": "^3.11.0",
+    "webpack": "^5.110.3",
+    "webpack-merge": "^6.0.1"
   },
   "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
-  "gitHead": "f37f9035584917a97a260b91fc2842cba4f8b94f"
+  "gitHead": "db942b07f3529b5359bcae27ab3796cb07dec10e"
 }

package/src/config.d.ts

@@ -37,7 +37,6 @@ export type FasterConfig = {
 };
 
 export type FutureV4Config = {
-  removeLegacyPostBuildHeadAttribute: boolean;
   useCssCascadeLayers: boolean;
   siteStorageNamespacing: boolean;
   fasterByDefault: boolean;

package/src/index.d.ts

@@ -28,6 +28,7 @@ export {
   ParseFrontMatter,
   OnBrokenMarkdownLinksFunction,
   OnBrokenMarkdownImagesFunction,
+  OnUnusedMarkdownDirectivesFunction,
 } from './markdown';
 
 export {ReportingSeverity} from './reporting';

package/src/markdown.d.ts

@@ -7,6 +7,7 @@
 
 import type {ProcessorOptions} from '@mdx-js/mdx';
 import type {Image, Definition, Link} from 'mdast';
+import type {Directives} from 'mdast-util-directive';
 
 import type {ReportingSeverity} from './reporting';
 
@@ -86,6 +87,21 @@ export type OnBrokenMarkdownImagesFunction = (params: {
   node: Image;
 }) => void | string;
 
+export type OnUnusedMarkdownDirectivesFunction = (params: {
+  /**
+   * Path of the source file on which the unused directive was found
+   * Relative to the site dir.
+   * Example: "docs/category/myDoc.mdx"
+   */
+  sourceFilePath: string;
+
+  /**
+   * The Markdown directives that were unused.
+   * Example: "myDirective"
+   */
+  directives: Directives[];
+}) => void | string;
+
 export type MarkdownHooks = {
   /**
    * The behavior of Docusaurus when it detects any broken Markdown link.
@@ -97,6 +113,10 @@ export type MarkdownHooks = {
   onBrokenMarkdownLinks: ReportingSeverity | OnBrokenMarkdownLinksFunction;
 
   onBrokenMarkdownImages: ReportingSeverity | OnBrokenMarkdownImagesFunction;
+
+  onUnusedMarkdownDirectives:
+    | ReportingSeverity
+    | OnUnusedMarkdownDirectivesFunction;
 };
 
 export type MarkdownConfig = {

package/src/plugin.d.ts

@@ -10,7 +10,6 @@ import type {RuleSetRule, Configuration as WebpackConfiguration} from 'webpack';
 import type {CustomizeRuleString} from 'webpack-merge/dist/types';
 import type {CommanderStatic} from 'commander';
 import type Joi from 'joi';
-import type {HelmetServerState} from 'react-helmet-async';
 import type {ThemeConfig} from './config';
 import type {LoadContext, Props} from './context';
 import type {SwizzleConfig} from './swizzle';
@@ -137,10 +136,6 @@ export type Plugin<Content = unknown> = {
   postBuild?: (
     props: Props & {
       content: Content;
-      // TODO Docusaurus v4: remove old messy unserializable "head" API
-      //  breaking change, replaced by routesBuildMetadata
-      //  Reason: https://github.com/facebook/docusaurus/pull/10826
-      head: {[location: string]: HelmetServerState};
       routesBuildMetadata: {[location: string]: RouteBuildMetadata};
     },
   ) => Promise<void> | void;
@@ -208,10 +203,10 @@ export type LoadedPlugin = InitializedPlugin & {
 };
 
 export type PluginModule<Content = unknown> = {
-  (context: LoadContext, options: unknown):
-    | Plugin<Content>
-    | null
-    | Promise<Plugin<Content> | null>;
+  (
+    context: LoadContext,
+    options: unknown,
+  ): Plugin<Content> | null | Promise<Plugin<Content> | null>;
 
   validateOptions?: <T, U>(data: OptionValidationContext<T, U>) => U;
   validateThemeConfig?: <T>(data: ThemeConfigValidationContext<T>) => T;

package/src/swizzle.d.ts

@@ -32,12 +32,11 @@ export type SwizzleConfig = {
 export type WrapperProps<
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   T extends keyof JSX.IntrinsicElements | JSXElementConstructor<any>,
-> = T extends JSXElementConstructor<infer P>
-  ? unknown extends P
-    ? // eslint-disable-next-line @typescript-eslint/ban-types
-      {}
-    : P
-  : T extends keyof JSX.IntrinsicElements
-  ? JSX.IntrinsicElements[T]
-  : // eslint-disable-next-line @typescript-eslint/ban-types
-    {};
+> =
+  T extends JSXElementConstructor<infer P>
+    ? unknown extends P
+      ? {}
+      : P
+    : T extends keyof JSX.IntrinsicElements
+      ? JSX.IntrinsicElements[T]
+      : {};