@azerion/bunosaurus-mdx-loader 0.0.0-stage → 4.0.0

package/README.md

@@ -1,3 +1,58 @@
-# Temporary Holding Version
+# `@docusaurus/mdx-loader`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Docusaurus webpack loader for [MDX](https://github.com/mdx-js/mdx).
+
+## Installation
+
+```sh
+yarn add @docusaurus/mdx-loader
+```
+
+## Usage
+
+```js
+// ...
+module: {
+  rules: [
+    // ...
+    {
+      test: /\.mdx?$/,
+      use: [
+        {
+          loader: '@docusaurus/mdx-loader',
+          options: {
+            // .. See options
+          },
+        },
+      ],
+    },
+  ];
+}
+```
+
+## Options
+
+### `rehypePlugins`
+
+Array of rehype plugins to manipulate the MDXHAST
+
+### `remarkPlugins`
+
+Array of remark plugins to manipulate the MDXAST
+
+### `metadataPath`
+
+A function to provide the metadataPath depending on current loaded MDX path that will be exported as the MDX metadata.
+
+### `markdownConfig`
+
+The global Docusaurus Markdown config (`config.markdown`), that plugin authors should forward:
+
+```js
+const loader = {
+  loader: require.resolve('@docusaurus/mdx-loader'),
+  options: {
+    markdownConfig: siteConfig.markdown,
+  },
+};
+```

package/lib/createMDXLoader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+import type { Options } from './options';
+import type { RuleSetRule, RuleSetUseItem } from 'webpack';
+export declare function createMDXLoaderItem(options: Options): RuleSetUseItem;
+export declare function createMDXLoaderRule({ include, options, }: {
+    include: RuleSetRule['include'];
+    options: Options;
+}): RuleSetRule;
+//# sourceMappingURL=createMDXLoader.d.ts.map

package/lib/createMDXLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMDXLoader.d.ts","sourceRoot":"","sources":["../src/createMDXLoader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAC,WAAW,EAAE,cAAc,EAAC,MAAM,SAAS,CAAC;AAmCzD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAKpE;AAED,wBAAgB,mBAAmB,CAAC,EAClC,OAAO,EACP,OAAO,GACR,EAAE;IACD,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,WAAW,CAOd"}

package/lib/createMDXLoader.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * 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.createMDXLoaderItem = createMDXLoaderItem;
+exports.createMDXLoaderRule = createMDXLoaderRule;
+const processor_1 = require("./processor");
+// Escape hatch to disable the MDX cross-compiler cache, just in case
+// TODO Docusaurus v5: remove this escape hatch env variable
+const DisableCrossCompilerCache = process.env.DOCUSAURUS_NO_MDX_CROSS_COMPILER_CACHE === 'true';
+function normalizeOptions(optionsInput) {
+    // Skip eager processor creation in tests
+    if (process.env.NODE_ENV === 'test' || process.env.VITEST) {
+        return optionsInput;
+    }
+    let options = optionsInput;
+    // We create the processor earlier here, to avoid the lazy processor creating
+    // Lazy creation messes-up with Rsdoctor ability to measure mdx-loader perf
+    if (!options.processors) {
+        options = { ...options, processors: (0, processor_1.createProcessors)({ options }) };
+    }
+    // Cross-compiler cache permits to compile client/server MDX only once
+    // We don't want to cache in dev mode (docusaurus start)
+    // We only have multiple compilers in production mode (docusaurus build)
+    // TODO wrong but good enough for now (example: "docusaurus build --dev")
+    if (!DisableCrossCompilerCache && process.env.NODE_ENV === 'production') {
+        options = {
+            ...options,
+            crossCompilerCache: new Map(),
+        };
+    }
+    return options;
+}
+function createMDXLoaderItem(options) {
+    return {
+        loader: require.resolve('./index'),
+        options: normalizeOptions(options),
+    };
+}
+function createMDXLoaderRule({ include, options, }) {
+    return {
+        test: /\.mdx?$/i,
+        include,
+        with: { type: { not: 'text' } },
+        use: [createMDXLoaderItem(options)],
+    };
+}
+//# sourceMappingURL=createMDXLoader.js.map

package/lib/createMDXLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMDXLoader.js","sourceRoot":"","sources":["../src/createMDXLoader.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,2CAA6C;AAI7C,qEAAqE;AACrE,4DAA4D;AAC5D,MAAM,yBAAyB,GAC7B,OAAO,CAAC,GAAG,CAAC,sCAAsC,KAAK,MAAM,CAAC;AAEhE,SAAS,gBAAgB,CAAC,YAAqB;IAC7C,yCAAyC;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAC1D,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,GAAG,YAAY,CAAC;IAE3B,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,GAAG,EAAC,GAAG,OAAO,EAAE,UAAU,EAAE,IAAA,4BAAgB,EAAC,EAAC,OAAO,EAAC,CAAC,EAAC,CAAC;IAClE,CAAC;IAED,sEAAsE;IACtE,wDAAwD;IACxD,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QACxE,OAAO,GAAG;YACR,GAAG,OAAO;YACV,kBAAkB,EAAE,IAAI,GAAG,EAAE;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6BAAoC,OAAgB;IAClD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QAClC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,6BAAoC,EAClC,OAAO,EACP,OAAO,GAIR;IACC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,OAAO;QACP,IAAI,EAAE,EAAC,IAAI,EAAE,EAAC,GAAG,EAAE,MAAM,EAAC,EAAC;QAC3B,GAAG,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/lib/format.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ */
+import type { MDXFrontMatter } from './frontMatter';
+import type { Format, FormatInput } from './index';
+export declare function getFormat({ filePath, frontMatterFormat, markdownConfigFormat, }: {
+    filePath: string;
+    frontMatterFormat: MDXFrontMatter['format'];
+    markdownConfigFormat: FormatInput;
+}): Format;
+//# sourceMappingURL=format.d.ts.map

package/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAC,MAAM,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAqBjD,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,GACrB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,oBAAoB,EAAE,WAAW,CAAC;CACnC,GAAG,MAAM,CAWT"}

package/lib/format.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * 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.getFormat = getFormat;
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+// Copied from https://mdxjs.com/packages/mdx/#optionsmdextensions
+// Although we are likely to only use .md / .mdx anyway...
+const mdFormatExtensions = [
+    '.md',
+    '.markdown',
+    '.mdown',
+    '.mkdn',
+    '.mkd',
+    '.mdwn',
+    '.mkdown',
+    '.ron',
+];
+function getExtensionFormat(filepath) {
+    const isMDFormat = mdFormatExtensions.includes(node_path_1.default.extname(filepath));
+    // Bias toward mdx if unknown extension
+    return isMDFormat ? 'md' : 'mdx';
+}
+function getFormat({ filePath, frontMatterFormat, markdownConfigFormat, }) {
+    if (frontMatterFormat) {
+        if (frontMatterFormat !== 'detect') {
+            return frontMatterFormat;
+        }
+        return getExtensionFormat(filePath);
+    }
+    if (markdownConfigFormat !== 'detect') {
+        return markdownConfigFormat;
+    }
+    return getExtensionFormat(filePath);
+}
+//# sourceMappingURL=format.js.map

package/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,kEAA6B;AAI7B,kEAAkE;AAClE,0DAA0D;AAC1D,MAAM,kBAAkB,GAAG;IACzB,KAAK;IACL,WAAW;IACX,QAAQ;IACR,OAAO;IACP,MAAM;IACN,OAAO;IACP,SAAS;IACT,MAAM;CACP,CAAC;AAEF,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvE,uCAAuC;IACvC,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACnC,CAAC;AAED,mBAA0B,EACxB,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,GAKrB;IACC,IAAI,iBAAiB,EAAE,CAAC;QACtB,IAAI,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,oBAAoB,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/lib/frontMatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ */
+import type { FormatInput } from './index';
+export type MDXFrontMatter = {
+    format?: FormatInput;
+};
+export declare const DefaultMDXFrontMatter: MDXFrontMatter;
+export declare function validateMDXFrontMatter(frontMatter: unknown): MDXFrontMatter;
+//# sourceMappingURL=frontMatter.d.ts.map

package/lib/frontMatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontMatter.d.ts","sourceRoot":"","sources":["../src/frontMatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAEnC,CAAC;AAMF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,GAAG,cAAc,CAI3E"}

package/lib/frontMatter.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * 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.DefaultMDXFrontMatter = void 0;
+exports.validateMDXFrontMatter = validateMDXFrontMatter;
+const utils_validation_1 = require("@docusaurus/utils-validation");
+exports.DefaultMDXFrontMatter = {
+    format: undefined,
+};
+const MDXFrontMatterSchema = utils_validation_1.JoiFrontMatter.object({
+    format: utils_validation_1.JoiFrontMatter.string().equal('md', 'mdx', 'detect').optional(),
+}).default(exports.DefaultMDXFrontMatter);
+function validateMDXFrontMatter(frontMatter) {
+    return (0, utils_validation_1.validateFrontMatter)(frontMatter, MDXFrontMatterSchema, {
+        allowUnknown: false,
+    });
+}
+//# sourceMappingURL=frontMatter.js.map

package/lib/frontMatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontMatter.js","sourceRoot":"","sources":["../src/frontMatter.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;AAEH,mEAGsC;AAQzB,QAAA,qBAAqB,GAAmB;IACnD,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,oBAAoB,GAAG,iCAAG,CAAC,MAAM,CAAiB;IACtD,MAAM,EAAE,iCAAG,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC,OAAO,CAAC,QAAA,qBAAqB,CAAC,CAAC;AAElC,gCAAuC,WAAoB;IACzD,OAAO,IAAA,sCAAmB,EAAC,WAAW,EAAE,oBAAoB,EAAE;QAC5D,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC;AACL,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+import type { ReactNode } from 'react';
+import { mdxLoader } from './loader';
+import type { TOCItem as TOCItemImported } from './remark/toc/types';
+export { createMDXLoaderRule, createMDXLoaderItem } from './createMDXLoader';
+export default mdxLoader;
+export type TOCItem = TOCItemImported;
+export type Format = 'md' | 'mdx';
+export type FormatInput = Format | 'detect';
+export type LoadedMDXContent<FrontMatter, Metadata, Assets = undefined> = {
+    /** As verbatim declared in the MDX document. */
+    readonly frontMatter: FrontMatter;
+    /** As provided by the content plugin. */
+    readonly metadata: Metadata;
+    /** A list of TOC items (headings). */
+    readonly toc: readonly TOCItem[];
+    /** First h1 title before any content. */
+    readonly contentTitle: string | undefined;
+    /**
+     * Usually image assets that may be collocated like `./img/thumbnail.png`.
+     * The loader would also bundle these assets and the client should use these
+     * in priority.
+     */
+    readonly assets: Assets;
+    (): ReactNode;
+};
+export type { MDXPlugin } from './loader';
+export type { MDXOptions } from './processor';
+export type { Options } from './options';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAErC,OAAO,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AAEnC,OAAO,KAAK,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAC,mBAAmB,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;eAE5D,SAAS;AAExB,MAAM,MAAM,OAAO,GAAG,eAAe,CAAC;AAEtC,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAElC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C,MAAM,MAAM,gBAAgB,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,IAAI;IACxE,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;IACjC,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,SAAS,CAAC;CACf,CAAC;AAEF,YAAY,EAAC,SAAS,EAAC,MAAM,UAAU,CAAC;AACxC,YAAY,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC"}

package/lib/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * 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.createMDXLoaderItem = exports.createMDXLoaderRule = void 0;
+const loader_1 = require("./loader");
+var createMDXLoader_1 = require("./createMDXLoader");
+Object.defineProperty(exports, "createMDXLoaderRule", { enumerable: true, get: function () { return createMDXLoader_1.createMDXLoaderRule; } });
+Object.defineProperty(exports, "createMDXLoaderItem", { enumerable: true, get: function () { return createMDXLoader_1.createMDXLoaderItem; } });
+exports.default = loader_1.mdxLoader;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,qCAAmC;AAInC,qDAA2E;AAAnE,sHAAA,mBAAmB,OAAA;AAAE,sHAAA,mBAAmB,OAAA;kBAEjC,kBAAS"}

package/lib/loader.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+import type { Options } from './options';
+import type { LoaderContext } from 'webpack';
+export type { MDXPlugin } from './processor';
+export declare function mdxLoader(this: LoaderContext<Options>, fileContent: string): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/lib/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAuL3C,wBAAsB,SAAS,CAC7B,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/lib/loader.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * 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.mdxLoader = mdxLoader;
+const tslib_1 = require("tslib");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("@docusaurus/utils");
+const utils_2 = require("./utils");
+const serializeJS_1 = require("./serializeJS");
+async function loadMDX({ fileContent, filePath, options, compilerName, }) {
+    const { frontMatter } = await options.markdownConfig.parseFrontMatter({
+        filePath,
+        fileContent,
+        defaultParseFrontMatter: utils_1.DEFAULT_PARSE_FRONT_MATTER,
+    });
+    const hasFrontMatter = Object.keys(frontMatter).length > 0;
+    const result = await (0, utils_2.compileToJSX)({
+        fileContent,
+        filePath,
+        frontMatter,
+        options,
+        compilerName,
+    });
+    const contentTitle = (0, utils_2.extractContentTitleData)(result.data);
+    // MDX partials are MDX files starting with _ or in a folder starting with _
+    // Partial are not expected to have associated metadata files or front matter
+    const isMDXPartial = options.isMDXPartial?.(filePath);
+    if (isMDXPartial && hasFrontMatter) {
+        const errorMessage = `Docusaurus MDX partial files should not contain front matter.
+Those partial files use the _ prefix as a convention by default, but this is configurable.
+File at ${filePath} contains front matter that will be ignored:
+${JSON.stringify(frontMatter, null, 2)}`;
+        if (!options.isMDXPartialFrontMatterWarningDisabled) {
+            const shouldError = process.env.NODE_ENV === 'test' || process.env.CI;
+            if (shouldError) {
+                throw new Error(errorMessage);
+            }
+            logger_1.default.warn(errorMessage);
+        }
+    }
+    const metadataPath = (function getMetadataPath() {
+        if (!isMDXPartial) {
+            return options.metadataPath?.(filePath);
+        }
+        return undefined;
+    })();
+    const assets = options.createAssets && !isMDXPartial
+        ? options.createAssets({ filePath, frontMatter })
+        : undefined;
+    const fileLoaderUtils = (0, utils_1.getFileLoaderUtils)(compilerName === 'server');
+    // TODO use remark plugins to insert extra exports instead of string concat?
+    // cf how the toc is exported
+    const exportsCode = `
+export const frontMatter = ${(0, serializeJS_1.serializeJS)(frontMatter)};
+export const contentTitle = ${(0, serializeJS_1.serializeJS)(contentTitle)};
+${metadataPath
+        ? `export {default as metadata} from '${(0, utils_1.aliasedSitePath)(metadataPath, options.siteDir)}'`
+        : ''}
+${assets
+        ? `export const assets = ${(0, utils_2.createAssetsExportCode)({
+            assets,
+            inlineMarkdownAssetImageFileLoader: fileLoaderUtils.loaders.inlineMarkdownAssetImageFileLoader,
+        })};`
+        : ''}
+`;
+    const code = `
+${exportsCode}
+${result.content}
+`;
+    return code;
+}
+// Note: we cache promises instead of strings
+// This is because client/server compilations might be triggered in parallel
+// When this happens for the same file, we don't want to compile it twice
+async function loadMDXWithCaching({ resource, fileContent, filePath, options, compilerName, }) {
+    const { crossCompilerCache } = options;
+    if (!crossCompilerCache) {
+        return loadMDX({
+            fileContent,
+            filePath,
+            options,
+            compilerName,
+        });
+    }
+    // Note we "resource" as cache key, not "filePath" nor "fileContent"
+    // This is because:
+    // - the same file can be compiled in different variants (blog.mdx?truncated)
+    // - the same content can be processed differently (versioned docs links)
+    const cacheKey = resource;
+    // We can clean up the cache and free memory after cache entry consumption
+    // We know there are only 2 compilations for the same file
+    // Note: once we introduce RSCs we'll probably have 3 compilations
+    // Note: we can't use string keys in WeakMap
+    // But we could eventually use WeakRef for the values
+    const deleteCacheEntry = () => crossCompilerCache.delete(cacheKey);
+    const cacheEntry = crossCompilerCache?.get(cacheKey);
+    // When deduplicating client/server compilations, we always use the client
+    // compilation and not the server compilation
+    // This is important because the server compilation usually skips some steps
+    // Notably: the server compilation does not emit file-loader assets
+    // Using the server compilation otherwise leads to broken images
+    // See https://github.com/facebook/docusaurus/issues/10544#issuecomment-2390943794
+    // See https://github.com/facebook/docusaurus/pull/10553
+    // TODO a problem with this: server bundle will use client inline loaders
+    //  This means server bundle will use ?emit=true for assets
+    //  We should try to get rid of inline loaders to cleanup this caching logic
+    if (compilerName === 'client') {
+        const promise = loadMDX({
+            fileContent,
+            filePath,
+            options,
+            compilerName,
+        });
+        if (cacheEntry) {
+            promise.then(cacheEntry.resolve, cacheEntry.reject);
+            deleteCacheEntry();
+        }
+        else {
+            const noop = () => {
+                throw new Error('this should never be called');
+            };
+            crossCompilerCache.set(cacheKey, {
+                promise,
+                resolve: noop,
+                reject: noop,
+            });
+        }
+        return promise;
+    }
+    // Server compilation always uses the result of the client compilation above
+    else if (compilerName === 'server') {
+        if (cacheEntry) {
+            deleteCacheEntry();
+            return cacheEntry.promise;
+        }
+        else {
+            const { promise, resolve, reject } = Promise.withResolvers();
+            crossCompilerCache.set(cacheKey, { promise, resolve, reject });
+            return promise;
+        }
+    }
+    else {
+        throw new Error(`Unexpected compilerName=${compilerName}`);
+    }
+}
+async function mdxLoader(fileContent) {
+    const compilerName = (0, utils_1.getWebpackLoaderCompilerName)(this);
+    const callback = this.async();
+    const options = this.getOptions();
+    options.dependencies?.forEach(this.addDependency);
+    try {
+        const result = await loadMDXWithCaching({
+            resource: this.resource,
+            filePath: this.resourcePath,
+            fileContent,
+            options,
+            compilerName,
+        });
+        return callback(null, result);
+    }
+    catch (error) {
+        return callback(error);
+    }
+}
+//# sourceMappingURL=loader.js.map

package/lib/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"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"}

package/lib/options.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+import type { MDXOptions, SimpleProcessors } from './processor';
+import type { MarkdownConfig } from '@docusaurus/types';
+import type { ResolveMarkdownLink } from './remark/resolveMarkdownLinks';
+import type { Options as RemarkMdxOptions } from 'remark-mdx';
+export type Options = Partial<MDXOptions> & {
+    dependencies?: string[];
+    markdownConfig: MarkdownConfig;
+    staticDirs: string[];
+    siteDir: string;
+    isMDXPartial?: (filePath: string) => boolean;
+    isMDXPartialFrontMatterWarningDisabled?: boolean;
+    removeContentTitle?: boolean;
+    metadataPath?: (filePath: string) => string;
+    createAssets?: (metadata: {
+        filePath: string;
+        frontMatter: {
+            [key: string]: unknown;
+        };
+    }) => {
+        [key: string]: unknown;
+    };
+    resolveMarkdownLink?: ResolveMarkdownLink;
+    remarkMdxOptions?: RemarkMdxOptions;
+    processors?: SimpleProcessors;
+    crossCompilerCache?: Map<string, CrossCompilerCacheEntry>;
+};
+type CrossCompilerCacheEntry = PromiseWithResolvers<string>;
+export {};
+//# sourceMappingURL=options.d.ts.map

package/lib/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAE5D,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,sCAAsC,CAAC,EAAE,OAAO,CAAC;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAC,CAAC;KACvC,KAAK;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,CAAC;IAC/B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAG1C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAGpC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CAC3D,CAAC;AAEF,KAAK,uBAAuB,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC"}

package/lib/options.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * 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 });
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/lib/preprocessor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+import type { Options } from './options';
+/**
+ * Preprocess the string before passing it to MDX
+ * This is not particularly recommended but makes it easier to upgrade to MDX 2
+ */
+export default function preprocessContent({ fileContent: initialFileContent, filePath, markdownConfig, admonitions, }: {
+    fileContent: string;
+    filePath: string;
+    markdownConfig: Options['markdownConfig'];
+    admonitions: Options['admonitions'] | undefined;
+}): string;
+//# sourceMappingURL=preprocessor.d.ts.map

package/lib/preprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor.d.ts","sourceRoot":"","sources":["../src/preprocessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,EACxC,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EACR,cAAc,EACd,WAAW,GACZ,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1C,WAAW,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;CACjD,GAAG,MAAM,CAiBT"}

package/lib/preprocessor.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * 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.default = preprocessContent;
+const utils_1 = require("@docusaurus/utils");
+const admonitions_1 = require("./remark/admonitions");
+/**
+ * Preprocess the string before passing it to MDX
+ * This is not particularly recommended but makes it easier to upgrade to MDX 2
+ */
+function preprocessContent({ fileContent: initialFileContent, filePath, markdownConfig, admonitions, }) {
+    let fileContent = initialFileContent;
+    if (markdownConfig.preprocessor) {
+        fileContent = markdownConfig.preprocessor({
+            fileContent,
+            filePath,
+        });
+    }
+    fileContent = (0, utils_1.unwrapMdxCodeBlocks)(fileContent);
+    if (markdownConfig.mdx1Compat.headingIds) {
+        fileContent = (0, utils_1.escapeMarkdownHeadingIds)(fileContent);
+    }
+    if (markdownConfig.mdx1Compat.admonitions && admonitions) {
+        const { keywords } = (0, admonitions_1.normalizeAdmonitionOptions)(admonitions);
+        fileContent = (0, utils_1.admonitionTitleToDirectiveLabel)(fileContent, keywords);
+    }
+    return fileContent;
+}
+//# sourceMappingURL=preprocessor.js.map

package/lib/preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preprocessor.js","sourceRoot":"","sources":["../src/preprocessor.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6CAI2B;AAC3B,sDAAgE;AAGhE;;;GAGG;AACH,2BAA0C,EACxC,WAAW,EAAE,kBAAkB,EAC/B,QAAQ,EACR,cAAc,EACd,WAAW,GAMZ;IACC,IAAI,WAAW,GAAG,kBAAkB,CAAC;IACrC,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;QAChC,WAAW,GAAG,cAAc,CAAC,YAAY,CAAC;YACxC,WAAW;YACX,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IACD,WAAW,GAAG,IAAA,2BAAmB,EAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,cAAc,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QACzC,WAAW,GAAG,IAAA,gCAAwB,EAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,cAAc,CAAC,UAAU,CAAC,WAAW,IAAI,WAAW,EAAE,CAAC;QACzD,MAAM,EAAC,QAAQ,EAAC,GAAG,IAAA,wCAA0B,EAAC,WAAW,CAAC,CAAC;QAC3D,WAAW,GAAG,IAAA,uCAA+B,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}