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

package/lib/remark/unusedDirectives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remark/unusedDirectives/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAyB,MAAM,EAAC,MAAM,SAAS,CAAC;AAE5D,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAoD3B,MAAM,MAAM,aAAa,GAAG;IAC1B,0BAA0B,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,4BAA4B,CAAC,CAAC;CACnF,CAAC;AA4DF,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,CAmCzC,CAAC;eAEa,MAAM"}

package/lib/remark/unusedDirectives/index.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * 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.
+ */
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const node_process_1 = tslib_1.__importDefault(require("node:process"));
+const unist_util_visit_1 = require("unist-util-visit");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("@docusaurus/utils");
+const utils_2 = require("../utils");
+const directiveTypes = [
+    'containerDirective',
+    'leafDirective',
+    'textDirective',
+];
+const directivePrefixMap = {
+    textDirective: ':',
+    leafDirective: '::',
+    containerDirective: ':::',
+};
+function formatDirectiveName(directive) {
+    const prefix = directivePrefixMap[directive.type];
+    if (!prefix) {
+        throw new Error(`unexpected, no prefix found for directive of type ${directive.type}`);
+    }
+    // To simplify we don't display the eventual label/props of directives
+    return `${prefix}${directive.name}`;
+}
+function formatUnusedDirectiveMessage(directive) {
+    const name = formatDirectiveName(directive);
+    return `- ${name}${(0, utils_2.formatNodePositionExtraMessage)(directive)}`;
+}
+function formatUnusedDirectivesMessage({ directives, filePath, }) {
+    const supportUrl = 'https://github.com/facebook/docusaurus/pull/9394';
+    const customPath = (0, utils_1.posixPath)(node_path_1.default.relative(node_process_1.default.cwd(), filePath));
+    const warningTitle = logger_1.default.interpolate `Docusaurus found ${directives.length} unused Markdown directives in file path=${customPath}`;
+    const customSupportUrl = logger_1.default.interpolate `url=${supportUrl}`;
+    const warningMessages = directives
+        .map(formatUnusedDirectiveMessage)
+        .join('\n');
+    return `${warningTitle}
+${warningMessages}
+Your content might render in an unexpected way. Visit ${customSupportUrl} to find out why and how to fix it.`;
+}
+function asFunction(onUnusedMarkdownDirectives) {
+    if (typeof onUnusedMarkdownDirectives === 'string') {
+        const extraHelp = onUnusedMarkdownDirectives === 'throw'
+            ? logger_1.default.interpolate `\nTo ignore this error, use the code=${'siteConfig.markdown.hooks.onUnusedMarkdownDirectives'} option.`
+            : '';
+        return ({ sourceFilePath, directives }) => {
+            const relativePath = (0, utils_1.toMessageRelativeFilePath)(sourceFilePath);
+            logger_1.default.report(onUnusedMarkdownDirectives) `${formatUnusedDirectivesMessage({
+                directives,
+                filePath: relativePath,
+            })}${extraHelp}`;
+        };
+    }
+    else {
+        return (params) => onUnusedMarkdownDirectives({
+            ...params,
+            sourceFilePath: (0, utils_1.toMessageRelativeFilePath)(params.sourceFilePath),
+        });
+    }
+}
+function isTextDirective(directive) {
+    return directive.type === 'textDirective';
+}
+// A simple text directive is one without any label/props
+function isSimpleTextDirective(directive) {
+    if (isTextDirective(directive)) {
+        // Attributes in MDAST = Directive props
+        const hasAttributes = directive.attributes && Object.keys(directive.attributes).length > 0;
+        // Children in MDAST = Directive label
+        const hasChildren = directive.children.length > 0;
+        return !hasAttributes && !hasChildren;
+    }
+    return false;
+}
+function transformSimpleTextDirectiveToString(textDirective) {
+    (0, utils_2.transformNode)(textDirective, {
+        type: 'text',
+        value: `:${textDirective.name}`, // We ignore label/props on purpose here
+    });
+}
+function isUnusedDirective(directive) {
+    // If directive data is set (notably hName/hProperties set by admonitions)
+    // this usually means the directive has been handled by another plugin
+    return !directive.data;
+}
+const plugin = function plugin(options) {
+    const onUnusedMarkdownDirectives = asFunction(options.onUnusedMarkdownDirectives);
+    return (tree, file) => {
+        const unusedDirectives = [];
+        // @ts-expect-error: TODO fix type
+        (0, unist_util_visit_1.visit)(tree, directiveTypes, (directive) => {
+            // If directive data is set (hName/hProperties set by admonitions)
+            // this usually means the directive has been handled by another plugin
+            if (isUnusedDirective(directive)) {
+                if (isSimpleTextDirective(directive)) {
+                    transformSimpleTextDirectiveToString(directive);
+                }
+                else {
+                    unusedDirectives.push(directive);
+                }
+            }
+        });
+        // We only process unused directives for the client compiler
+        // This avoids emitting duplicate errors/warnings in prod mode
+        // Note: the client compiler is used in both dev/prod modes
+        // Also: the client compiler is what gets used when using crossCompilerCache
+        if (file.data.compilerName === 'client' && unusedDirectives.length > 0) {
+            onUnusedMarkdownDirectives({
+                sourceFilePath: file.path,
+                directives: unusedDirectives,
+            });
+        }
+    };
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/lib/remark/unusedDirectives/index.js.map

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

package/lib/remark/utils/index.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 { Node } from 'unist';
+import type { MdxJsxAttributeValueExpression } from 'mdast-util-mdx';
+/**
+ * Util to transform one node type to another node type
+ * The input node is mutated in place
+ * @param node the node to mutate
+ * @param newNode what the original node should become become
+ */
+export declare function transformNode<NewNode extends Node>(node: Node, newNode: NewNode): NewNode;
+export declare function assetRequireAttributeValue(requireString: string, hash: string): MdxJsxAttributeValueExpression;
+export declare function formatNodePositionExtraMessage(node: Node): string;
+//# sourceMappingURL=index.d.ts.map

package/lib/remark/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remark/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAC,8BAA8B,EAAC,MAAM,gBAAgB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,IAAI,EAChD,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,GACf,OAAO,CAUT;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,GACX,8BAA8B,CAkDhC;AAUD,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGjE"}

package/lib/remark/utils/index.js

@@ -0,0 +1,93 @@
+"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.transformNode = transformNode;
+exports.assetRequireAttributeValue = assetRequireAttributeValue;
+exports.formatNodePositionExtraMessage = formatNodePositionExtraMessage;
+const tslib_1 = require("tslib");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+/**
+ * Util to transform one node type to another node type
+ * The input node is mutated in place
+ * @param node the node to mutate
+ * @param newNode what the original node should become become
+ */
+function transformNode(node, newNode) {
+    Object.keys(node).forEach((key) => {
+        // @ts-expect-error: unsafe but ok
+        delete node[key];
+    });
+    Object.keys(newNode).forEach((key) => {
+        // @ts-expect-error: unsafe but ok
+        node[key] = newNode[key];
+    });
+    return node;
+}
+function assetRequireAttributeValue(requireString, hash) {
+    return {
+        type: 'mdxJsxAttributeValueExpression',
+        value: `require("${requireString}").default${hash && ` + '${hash}'`}`,
+        data: {
+            estree: {
+                type: 'Program',
+                body: [
+                    {
+                        type: 'ExpressionStatement',
+                        expression: {
+                            type: 'BinaryExpression',
+                            left: {
+                                type: 'MemberExpression',
+                                object: {
+                                    type: 'CallExpression',
+                                    callee: {
+                                        type: 'Identifier',
+                                        name: 'require',
+                                    },
+                                    arguments: [
+                                        {
+                                            type: 'Literal',
+                                            value: requireString,
+                                            raw: `"${requireString}"`,
+                                        },
+                                    ],
+                                    optional: false,
+                                },
+                                property: {
+                                    type: 'Identifier',
+                                    name: 'default',
+                                },
+                                computed: false,
+                                optional: false,
+                            },
+                            operator: '+',
+                            right: {
+                                type: 'Literal',
+                                value: hash,
+                                raw: `"${hash}"`,
+                            },
+                        },
+                    },
+                ],
+                sourceType: 'module',
+                comments: [],
+            },
+        },
+    };
+}
+function formatNodePosition(node) {
+    return node.position?.start
+        ? logger_1.default.interpolate `number=${node.position.start.line}:number=${node.position.start.column}`
+        : undefined;
+}
+// Returns " (line:column)" when position info is available
+// The initial space is useful to append easily to any existing message
+function formatNodePositionExtraMessage(node) {
+    const position = formatNodePosition(node);
+    return `${position ? ` (${position})` : ''}`;
+}
+//# sourceMappingURL=index.js.map

package/lib/remark/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/remark/utils/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,wEAAwC;AAIxC;;;;;GAKG;AACH,uBACE,IAAU,EACV,OAAgB;IAEhB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,kCAAkC;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACnC,kCAAkC;QAClC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,IAAe,CAAC;AACzB,CAAC;AAED,oCACE,aAAqB,EACrB,IAAY;IAEZ,OAAO;QACL,IAAI,EAAE,gCAAgC;QACtC,KAAK,EAAE,YAAY,aAAa,aAAa,IAAI,IAAI,OAAO,IAAI,GAAG,EAAE;QACrE,IAAI,EAAE;YACJ,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE;oBACJ;wBACE,IAAI,EAAE,qBAAqB;wBAC3B,UAAU,EAAE;4BACV,IAAI,EAAE,kBAAkB;4BACxB,IAAI,EAAE;gCACJ,IAAI,EAAE,kBAAkB;gCACxB,MAAM,EAAE;oCACN,IAAI,EAAE,gBAAgB;oCACtB,MAAM,EAAE;wCACN,IAAI,EAAE,YAAY;wCAClB,IAAI,EAAE,SAAS;qCAChB;oCACD,SAAS,EAAE;wCACT;4CACE,IAAI,EAAE,SAAS;4CACf,KAAK,EAAE,aAAa;4CACpB,GAAG,EAAE,IAAI,aAAa,GAAG;yCAC1B;qCACF;oCACD,QAAQ,EAAE,KAAK;iCAChB;gCACD,QAAQ,EAAE;oCACR,IAAI,EAAE,YAAY;oCAClB,IAAI,EAAE,SAAS;iCAChB;gCACD,QAAQ,EAAE,KAAK;gCACf,QAAQ,EAAE,KAAK;6BAChB;4BACD,QAAQ,EAAE,GAAG;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,SAAS;gCACf,KAAK,EAAE,IAAI;gCACX,GAAG,EAAE,IAAI,IAAI,GAAG;6BACjB;yBACF;qBACF;iBACF;gBACD,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,EAAE;aACb;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAU;IACpC,OAAO,IAAI,CAAC,QAAQ,EAAE,KAAK;QACzB,CAAC,CAAC,gBAAM,CAAC,WAAW,CAAA,UAAU,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE;QAC7F,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,2DAA2D;AAC3D,uEAAuE;AACvE,wCAA+C,IAAU;IACvD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC/C,CAAC"}

package/lib/serializeJS.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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.
+ */
+/**
+ * Serializes a value to a JS expression string, that can be inlined in the
+ * code of a generated JS module, such as the front matter of an MDX file:
+ *
+ * `export const frontMatter = ${serializeJS(frontMatter)};`
+ *
+ * Contrary to JSON, the output preserves values such as `undefined`, `NaN`,
+ * `Infinity` or `Date` instances.
+ */
+export declare function serializeJS(value: unknown): string;
+//# sourceMappingURL=serializeJS.d.ts.map

package/lib/serializeJS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeJS.d.ts","sourceRoot":"","sources":["../src/serializeJS.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD"}

package/lib/serializeJS.js

@@ -0,0 +1,24 @@
+"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.serializeJS = serializeJS;
+const astring_1 = require("astring");
+const estree_util_value_to_estree_1 = require("estree-util-value-to-estree");
+/**
+ * Serializes a value to a JS expression string, that can be inlined in the
+ * code of a generated JS module, such as the front matter of an MDX file:
+ *
+ * `export const frontMatter = ${serializeJS(frontMatter)};`
+ *
+ * Contrary to JSON, the output preserves values such as `undefined`, `NaN`,
+ * `Infinity` or `Date` instances.
+ */
+function serializeJS(value) {
+    return (0, astring_1.generate)((0, estree_util_value_to_estree_1.valueToEstree)(value, { instanceAsObject: true }));
+}
+//# sourceMappingURL=serializeJS.js.map

package/lib/serializeJS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeJS.js","sourceRoot":"","sources":["../src/serializeJS.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAAiC;AACjC,6EAA0D;AAE1D;;;;;;;;GAQG;AACH,qBAA4B,KAAc;IACxC,OAAO,IAAA,kBAAQ,EAAC,IAAA,2CAAa,EAAC,KAAK,EAAE,EAAC,gBAAgB,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/lib/utils.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 WebpackCompilerName } from '@docusaurus/utils';
+import { type SimpleProcessorResult } from './processor';
+import type { Options } from './options';
+/**
+ * Converts assets an object with Webpack require calls code.
+ * This is useful for mdx files to reference co-located assets using relative
+ * paths. Those assets should enter the Webpack assets pipeline and be hashed.
+ * For now, we only handle that for images and paths starting with `./`:
+ *
+ * `{image: "./myImage.png"}` => `{image: require("./myImage.png")}`
+ */
+export declare function createAssetsExportCode({ assets, inlineMarkdownAssetImageFileLoader, }: {
+    assets: unknown;
+    inlineMarkdownAssetImageFileLoader: string;
+}): string;
+/**
+ * data.contentTitle is set by the remark contentTitle plugin
+ */
+export declare function extractContentTitleData(data: {
+    [key: string]: unknown;
+}): string | undefined;
+export declare function compileToJSX({ filePath, fileContent, frontMatter, options, compilerName, }: {
+    filePath: string;
+    fileContent: string;
+    frontMatter: Record<string, unknown>;
+    options: Options;
+    compilerName: WebpackCompilerName;
+}): Promise<SimpleProcessorResult>;
+//# sourceMappingURL=utils.d.ts.map

package/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAa,KAAK,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAe,KAAK,qBAAqB,EAAC,MAAM,aAAa,CAAC;AAGrE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,kCAAkC,GACnC,EAAE;IACD,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC,EAAE,MAAM,CAAC;CAC5C,GAAG,MAAM,CAuCT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GAAG,MAAM,GAAG,SAAS,CAErB;AAED,wBAAsB,YAAY,CAAC,EACjC,QAAQ,EACR,WAAW,EACX,WAAW,EACX,OAAO,EACP,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,mBAAmB,CAAC;CACnC,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2CjC"}

package/lib/utils.js

@@ -0,0 +1,97 @@
+"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.createAssetsExportCode = createAssetsExportCode;
+exports.extractContentTitleData = extractContentTitleData;
+exports.compileToJSX = compileToJSX;
+const tslib_1 = require("tslib");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const utils_1 = require("@docusaurus/utils");
+const processor_1 = require("./processor");
+const frontMatter_1 = require("./frontMatter");
+const preprocessor_1 = tslib_1.__importDefault(require("./preprocessor"));
+/**
+ * Converts assets an object with Webpack require calls code.
+ * This is useful for mdx files to reference co-located assets using relative
+ * paths. Those assets should enter the Webpack assets pipeline and be hashed.
+ * For now, we only handle that for images and paths starting with `./`:
+ *
+ * `{image: "./myImage.png"}` => `{image: require("./myImage.png")}`
+ */
+function createAssetsExportCode({ assets, inlineMarkdownAssetImageFileLoader, }) {
+    if (typeof assets !== 'object' ||
+        !assets ||
+        Object.keys(assets).length === 0) {
+        return 'undefined';
+    }
+    // TODO implementation can be completed/enhanced
+    function createAssetValueCode(assetValue) {
+        if (Array.isArray(assetValue)) {
+            const arrayItemCodes = assetValue.map((item) => createAssetValueCode(item) ?? 'undefined');
+            return `[${arrayItemCodes.join(', ')}]`;
+        }
+        // Only process string values starting with ./
+        // We could enhance this logic and check if file exists on disc?
+        if (typeof assetValue === 'string' && assetValue.startsWith('./')) {
+            // TODO do we have other use-cases than image assets?
+            // Probably not worth adding more support, as we want to move to Webpack 5 new asset system (https://github.com/facebook/docusaurus/pull/4708)
+            return `require("${inlineMarkdownAssetImageFileLoader}${(0, utils_1.escapePath)(assetValue)}").default`;
+        }
+        return undefined;
+    }
+    const assetEntries = Object.entries(assets);
+    const codeLines = assetEntries
+        .map(([key, value]) => {
+        const assetRequireCode = createAssetValueCode(value);
+        return assetRequireCode ? `"${key}": ${assetRequireCode},` : undefined;
+    })
+        .filter(Boolean);
+    return `{\n${codeLines.join('\n')}\n}`;
+}
+/**
+ * data.contentTitle is set by the remark contentTitle plugin
+ */
+function extractContentTitleData(data) {
+    return data.contentTitle;
+}
+async function compileToJSX({ filePath, fileContent, frontMatter, options, compilerName, }) {
+    const preprocessedFileContent = (0, preprocessor_1.default)({
+        fileContent,
+        filePath,
+        admonitions: options.admonitions,
+        markdownConfig: options.markdownConfig,
+    });
+    const mdxFrontMatter = (0, frontMatter_1.validateMDXFrontMatter)(frontMatter.mdx);
+    const processor = (0, processor_1.getProcessor)({
+        filePath,
+        options,
+        mdxFrontMatter,
+    });
+    try {
+        return await processor.process({
+            content: preprocessedFileContent,
+            filePath,
+            frontMatter,
+            compilerName,
+        });
+    }
+    catch (errorUnknown) {
+        const error = errorUnknown;
+        // MDX can emit errors that have useful extra attributes
+        const errorJSON = JSON.stringify(error, null, 2);
+        const errorDetails = errorJSON === '{}'
+            ? // regular JS error case: print stacktrace
+                (error.stack ?? 'N/A')
+            : // MDX error: print extra attributes + stacktrace
+                `${errorJSON}\n${error.stack}`;
+        throw new Error(`MDX compilation failed for file ${logger_1.default.path(filePath)}\nCause: ${error.message}\nDetails:\n${errorDetails}`, 
+        // TODO error cause doesn't seem to be used by Webpack stats.errors :s
+        { cause: errorUnknown });
+    }
+}
+//# sourceMappingURL=utils.js.map

package/lib/utils.js.map

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

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@azerion/bunosaurus-mdx-loader",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "4.0.0",
+  "description": "Docusaurus Loader for MDX",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/azerion/bunosaurus.git",
+    "directory": "packages/docusaurus-mdx-loader"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@docusaurus/fs": "npm:@azerion/bunosaurus-fs@4.0.0",
+    "@docusaurus/logger": "npm:@azerion/bunosaurus-logger@4.0.0",
+    "@docusaurus/utils": "npm:@azerion/bunosaurus-utils@4.0.0",
+    "@docusaurus/utils-validation": "npm:@azerion/bunosaurus-utils-validation@4.0.0",
+    "@mdx-js/mdx": "^3.1.1",
+    "@slorber/remark-comment": "^1.0.0",
+    "astring": "^1.9.0",
+    "escape-html": "^1.0.3",
+    "estree-util-value-to-estree": "^3.5.0",
+    "image-size": "^2.0.4",
+    "mdast-util-mdx": "^3.0.0",
+    "mdast-util-to-string": "^4.0.0",
+    "rehype-raw": "^7.0.0",
+    "remark-directive": "^4.0.0",
+    "remark-emoji": "^5.0.2",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-mdx": "^3.1.1",
+    "tslib": "^2.8.1",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.1.0",
+    "vfile": "^6.0.3"
+  },
+  "devDependencies": {
+    "@docusaurus/types": "npm:@azerion/bunosaurus-types@4.0.0",
+    "@types/escape-html": "^1.0.4",
+    "@types/estree": "^1.0.9",
+    "@types/mdast": "^4.0.4",
+    "@types/unist": "^3.0.3",
+    "lodash": "^4.18.1",
+    "mdast-util-directive": "3.1.0",
+    "rehype-stringify": "^10.0.1",
+    "remark": "^15.0.1",
+    "remark-rehype": "^11.1.2",
+    "to-vfile": "^8.0.0",
+    "unist-builder": "^4.0.0",
+    "utility-types": "^3.11.0",
+    "webpack": "^5.111.0"
+  },
+  "peerDependencies": {
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "engines": {
+    "bun": ">=1.4.1"
+  }
+}

package/src/createMDXLoader.ts

@@ -0,0 +1,65 @@
+/**
+ * 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 {createProcessors} from './processor';
+import type {Options} from './options';
+import type {RuleSetRule, RuleSetUseItem} from 'webpack';
+
+// 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: Options): Options {
+  // 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: 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;
+}
+
+export function createMDXLoaderItem(options: Options): RuleSetUseItem {
+  return {
+    loader: require.resolve('./index'),
+    options: normalizeOptions(options),
+  };
+}
+
+export function createMDXLoaderRule({
+  include,
+  options,
+}: {
+  include: RuleSetRule['include'];
+  options: Options;
+}): RuleSetRule {
+  return {
+    test: /\.mdx?$/i,
+    include,
+    with: {type: {not: 'text'}},
+    use: [createMDXLoaderItem(options)],
+  };
+}

package/src/format.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 path from 'node:path';
+import type {MDXFrontMatter} from './frontMatter';
+import type {Format, FormatInput} from './index';
+
+// 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: string): Format {
+  const isMDFormat = mdFormatExtensions.includes(path.extname(filepath));
+  // Bias toward mdx if unknown extension
+  return isMDFormat ? 'md' : 'mdx';
+}
+
+export function getFormat({
+  filePath,
+  frontMatterFormat,
+  markdownConfigFormat,
+}: {
+  filePath: string;
+  frontMatterFormat: MDXFrontMatter['format'];
+  markdownConfigFormat: FormatInput;
+}): Format {
+  if (frontMatterFormat) {
+    if (frontMatterFormat !== 'detect') {
+      return frontMatterFormat;
+    }
+    return getExtensionFormat(filePath);
+  }
+  if (markdownConfigFormat !== 'detect') {
+    return markdownConfigFormat;
+  }
+  return getExtensionFormat(filePath);
+}