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

package/lib/remark/toc/utils.js

@@ -0,0 +1,184 @@
+"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.getImportDeclarations = getImportDeclarations;
+exports.isMarkdownImport = isMarkdownImport;
+exports.findDefaultImportName = findDefaultImportName;
+exports.addTocSliceImportIfNeeded = addTocSliceImportIfNeeded;
+exports.isNamedExport = isNamedExport;
+exports.createTOCExportNodeAST = createTOCExportNodeAST;
+exports.toHeadingHTMLValue = toHeadingHTMLValue;
+const tslib_1 = require("tslib");
+const mdast_util_to_string_1 = require("mdast-util-to-string");
+const estree_util_value_to_estree_1 = require("estree-util-value-to-estree");
+const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
+function getImportDeclarations(program) {
+    return program.body.filter((item) => item.type === 'ImportDeclaration');
+}
+function isMarkdownImport(node) {
+    if (node.type !== 'ImportDeclaration') {
+        return false;
+    }
+    const importPath = node.source.value;
+    return typeof importPath === 'string' && /\.mdx?$/.test(importPath);
+}
+function findDefaultImportName(importDeclaration) {
+    return importDeclaration.specifiers.find((o) => o.type === 'ImportDefaultSpecifier')?.local.name;
+}
+function findNamedImportSpecifier(importDeclaration, localName) {
+    return importDeclaration?.specifiers.find((specifier) => specifier.type === 'ImportSpecifier' &&
+        specifier.local.name === localName);
+}
+// Before: import Partial from "partial"
+// After: import Partial, {toc as __tocPartial} from "partial"
+function addTocSliceImportIfNeeded({ importDeclaration, tocExportName, tocSliceImportName, }) {
+    // We only add the toc slice named import if it doesn't exist already
+    if (!findNamedImportSpecifier(importDeclaration, tocSliceImportName)) {
+        importDeclaration.specifiers.push({
+            type: 'ImportSpecifier',
+            imported: { type: 'Identifier', name: tocExportName },
+            local: { type: 'Identifier', name: tocSliceImportName },
+        });
+    }
+}
+function isNamedExport(node, exportName) {
+    if (node.type !== 'mdxjsEsm') {
+        return false;
+    }
+    const program = node.data?.estree;
+    if (!program) {
+        return false;
+    }
+    if (program.body.length !== 1) {
+        return false;
+    }
+    const exportDeclaration = program.body[0];
+    if (exportDeclaration.type !== 'ExportNamedDeclaration') {
+        return false;
+    }
+    const variableDeclaration = exportDeclaration.declaration;
+    if (variableDeclaration?.type !== 'VariableDeclaration') {
+        return false;
+    }
+    const { id } = variableDeclaration.declarations[0];
+    if (id.type !== 'Identifier') {
+        return false;
+    }
+    return id.name === exportName;
+}
+function createTOCExportNodeAST({ tocExportName, tocItems, }) {
+    function createTOCSliceAST(tocSlice) {
+        return {
+            type: 'SpreadElement',
+            argument: { type: 'Identifier', name: tocSlice.importName },
+        };
+    }
+    function createTOCHeadingAST({ heading }) {
+        const value = {
+            value: toHeadingHTMLValue(heading),
+            id: heading.data.id,
+            level: heading.depth,
+        };
+        return (0, estree_util_value_to_estree_1.valueToEstree)(value);
+    }
+    function createTOCItemAST(tocItem) {
+        switch (tocItem.type) {
+            case 'slice':
+                return createTOCSliceAST(tocItem);
+            case 'heading':
+                return createTOCHeadingAST(tocItem);
+            default: {
+                throw new Error(`unexpected toc item type`);
+            }
+        }
+    }
+    return {
+        type: 'mdxjsEsm',
+        value: '', // See https://github.com/facebook/docusaurus/pull/9684#discussion_r1457595181
+        data: {
+            estree: {
+                type: 'Program',
+                body: [
+                    {
+                        type: 'ExportNamedDeclaration',
+                        attributes: [],
+                        declaration: {
+                            type: 'VariableDeclaration',
+                            declarations: [
+                                {
+                                    type: 'VariableDeclarator',
+                                    id: {
+                                        type: 'Identifier',
+                                        name: tocExportName,
+                                    },
+                                    init: {
+                                        type: 'ArrayExpression',
+                                        elements: tocItems.map(createTOCItemAST),
+                                    },
+                                },
+                            ],
+                            kind: 'const',
+                        },
+                        specifiers: [],
+                        source: null,
+                    },
+                ],
+                sourceType: 'module',
+            },
+        },
+    };
+}
+function stringifyChildren(node) {
+    return node.children
+        .map(toHeadingHTMLValue)
+        .join('')
+        .trim();
+}
+// TODO This is really a workaround, and not super reliable
+// For now we only support serializing tagName, className and content
+// Can we implement the TOC with real JSX nodes instead of html strings later?
+function mdxJsxTextElementToHtml(element) {
+    const tag = element.name;
+    // See https://github.com/facebook/docusaurus/issues/11003#issuecomment-2733925363
+    if (tag === 'img') {
+        return '';
+    }
+    const attributes = element.attributes.filter((child) => child.type === 'mdxJsxAttribute');
+    const classAttribute = attributes.find((attr) => attr.name === 'className') ??
+        attributes.find((attr) => attr.name === 'class');
+    const classAttributeString = classAttribute
+        ? `class="${(0, escape_html_1.default)(String(classAttribute.value))}"`
+        : ``;
+    const allAttributes = classAttributeString ? ` ${classAttributeString}` : '';
+    const content = stringifyChildren(element);
+    return `<${tag}${allAttributes}>${content}</${tag}>`;
+}
+function toHeadingHTMLValue(node) {
+    switch (node.type) {
+        case 'mdxJsxTextElement': {
+            return mdxJsxTextElementToHtml(node);
+        }
+        case 'text':
+            return (0, escape_html_1.default)(node.value);
+        case 'heading':
+            return stringifyChildren(node);
+        case 'inlineCode':
+            return `<code>${(0, escape_html_1.default)(node.value)}</code>`;
+        case 'emphasis':
+            return `<em>${stringifyChildren(node)}</em>`;
+        case 'strong':
+            return `<strong>${stringifyChildren(node)}</strong>`;
+        case 'delete':
+            return `<del>${stringifyChildren(node)}</del>`;
+        case 'link':
+            return stringifyChildren(node);
+        default:
+            return (0, mdast_util_to_string_1.toString)(node);
+    }
+}
+//# sourceMappingURL=utils.js.map

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

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

package/lib/remark/transformImage/index.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.
+ */
+import type { Plugin } from 'unified';
+import type { Root } from 'mdast';
+import type { MarkdownConfig } from '@docusaurus/types';
+export type PluginOptions = {
+    staticDirs: string[];
+    siteDir: string;
+    onBrokenMarkdownImages: MarkdownConfig['hooks']['onBrokenMarkdownImages'];
+};
+declare const plugin: Plugin<PluginOptions[], Root>;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remark/transformImage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,OAAO,KAAK,EAAC,MAAM,EAAc,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAQ,IAAI,EAAC,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,wBAAwB,CAAC,CAAC;CAC3E,CAAC;AAwMF,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,CA0BzC,CAAC;eAEa,MAAM"}

package/lib/remark/transformImage/index.js

@@ -0,0 +1,187 @@
+"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 });
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const unist_util_visit_1 = require("unist-util-visit");
+const utils_1 = require("@docusaurus/utils");
+const fromFile_1 = require("image-size/fromFile");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const fs_1 = require("@docusaurus/fs");
+const utils_2 = require("../utils");
+function asFunction(onBrokenMarkdownImages) {
+    if (typeof onBrokenMarkdownImages === 'string') {
+        const extraHelp = onBrokenMarkdownImages === 'throw'
+            ? logger_1.default.interpolate `\nTo ignore this error, use the code=${'siteConfig.markdown.hooks.onBrokenMarkdownImages'} option, or apply the code=${'pathname://'} protocol to the broken image URLs.`
+            : '';
+        return ({ sourceFilePath, url: imageUrl, node }) => {
+            const relativePath = (0, utils_1.toMessageRelativeFilePath)(sourceFilePath);
+            if (imageUrl) {
+                logger_1.default.report(onBrokenMarkdownImages) `Markdown image with URL code=${imageUrl} in source file path=${relativePath}${(0, utils_2.formatNodePositionExtraMessage)(node)} couldn't be resolved to an existing local image file.${extraHelp}`;
+            }
+            else {
+                logger_1.default.report(onBrokenMarkdownImages) `Markdown image with empty URL found in source file path=${relativePath}${(0, utils_2.formatNodePositionExtraMessage)(node)}.${extraHelp}`;
+            }
+        };
+    }
+    else {
+        return (params) => onBrokenMarkdownImages({
+            ...params,
+            sourceFilePath: (0, utils_1.toMessageRelativeFilePath)(params.sourceFilePath),
+        });
+    }
+}
+async function toImageRequireNode([node], imagePath, context) {
+    // MdxJsxTextElement => see https://github.com/facebook/docusaurus/pull/8288#discussion_r1125871405
+    const jsxNode = node;
+    const attributes = [];
+    let relativeImagePath = (0, utils_1.posixPath)(node_path_1.default.relative(node_path_1.default.dirname(context.filePath), imagePath));
+    relativeImagePath = `./${relativeImagePath}`;
+    const parsedUrl = (0, utils_1.parseURLOrPath)(node.url);
+    const hash = parsedUrl.hash ?? '';
+    const search = parsedUrl.search ?? '';
+    const requireString = `${context.inlineMarkdownImageFileLoader}${(0, utils_1.escapePath)(relativeImagePath) + search}`;
+    if (node.alt) {
+        attributes.push({
+            type: 'mdxJsxAttribute',
+            name: 'alt',
+            value: node.alt,
+        });
+    }
+    attributes.push({
+        type: 'mdxJsxAttribute',
+        name: 'src',
+        value: (0, utils_2.assetRequireAttributeValue)(requireString, hash),
+    });
+    if (node.title) {
+        attributes.push({
+            type: 'mdxJsxAttribute',
+            name: 'title',
+            value: node.title,
+        });
+    }
+    try {
+        const size = (await (0, fromFile_1.imageSizeFromFile)(imagePath));
+        if (size.width) {
+            attributes.push({
+                type: 'mdxJsxAttribute',
+                name: 'width',
+                value: String(size.width),
+            });
+        }
+        if (size.height) {
+            attributes.push({
+                type: 'mdxJsxAttribute',
+                name: 'height',
+                value: String(size.height),
+            });
+        }
+    }
+    catch (err) {
+        console.error(err);
+        // Workaround for https://github.com/yarnpkg/berry/pull/3889#issuecomment-1034469784
+        // TODO remove this check once fixed in Yarn PnP
+        if (!process.versions.pnp) {
+            logger_1.default.warn `The image at path=${imagePath} can't be read correctly. Please ensure it's a valid image.
+${err.message}`;
+        }
+    }
+    (0, utils_2.transformNode)(jsxNode, {
+        type: 'mdxJsxTextElement',
+        name: 'img',
+        attributes,
+        children: [],
+    });
+}
+async function getLocalImageAbsolutePath(originalImagePath, { siteDir, filePath, staticDirs }) {
+    if (originalImagePath.startsWith('@site/')) {
+        const imageFilePath = node_path_1.default.join(siteDir, originalImagePath.replace('@site/', ''));
+        if (!(await (0, fs_1.pathExists)(imageFilePath))) {
+            return null;
+        }
+        return imageFilePath;
+    }
+    else if (node_path_1.default.isAbsolute(originalImagePath)) {
+        // Absolute paths are expected to exist in the static folder.
+        const possiblePaths = staticDirs.map((dir) => node_path_1.default.join(dir, originalImagePath));
+        const imageFilePath = await (0, utils_1.findAsyncSequential)(possiblePaths, fs_1.pathExists);
+        if (!imageFilePath) {
+            return null;
+        }
+        return imageFilePath;
+    }
+    else {
+        // relative paths are resolved against the source file's folder
+        const imageFilePath = node_path_1.default.join(node_path_1.default.dirname(filePath), originalImagePath);
+        if (!(await (0, fs_1.pathExists)(imageFilePath))) {
+            return null;
+        }
+        return imageFilePath;
+    }
+}
+async function processImageNode(target, context) {
+    const [node] = target;
+    if (!node.url) {
+        node.url =
+            context.onBrokenMarkdownImages({
+                url: node.url,
+                sourceFilePath: context.filePath,
+                node,
+            }) ?? node.url;
+        return;
+    }
+    const localUrlPath = (0, utils_1.parseLocalURLPath)(node.url);
+    if (!localUrlPath) {
+        // pathname:// is an escape hatch, in case the user does not want images to
+        // be converted to require calls going through webpack loader
+        if ((0, utils_1.parseURLOrPath)(node.url).protocol === 'pathname:') {
+            node.url = node.url.replace('pathname://', '');
+        }
+        return;
+    }
+    // We decode it first because Node Url.pathname is always encoded
+    // while the image file-system path are not.
+    // See https://github.com/facebook/docusaurus/discussions/10720
+    const decodedPathname = decodeURIComponent(localUrlPath.pathname);
+    // We try to convert image urls without protocol to images with require calls
+    // going through webpack ensures that image assets exist at build time
+    const localImagePath = await getLocalImageAbsolutePath(decodedPathname, context);
+    if (localImagePath === null) {
+        node.url =
+            context.onBrokenMarkdownImages({
+                url: node.url,
+                sourceFilePath: context.filePath,
+                node,
+            }) ?? node.url;
+    }
+    else {
+        await toImageRequireNode(target, localImagePath, context);
+    }
+}
+const plugin = function plugin(options) {
+    const onBrokenMarkdownImages = asFunction(options.onBrokenMarkdownImages);
+    return async (root, vfile) => {
+        const fileLoaderUtils = (0, utils_1.getFileLoaderUtils)(vfile.data.compilerName === 'server');
+        const context = {
+            ...options,
+            filePath: vfile.path,
+            inlineMarkdownImageFileLoader: fileLoaderUtils.loaders.inlineMarkdownImageFileLoader,
+            onBrokenMarkdownImages,
+        };
+        const promises = [];
+        (0, unist_util_visit_1.visit)(root, 'image', (node, index, parent) => {
+            if (!parent || index === undefined) {
+                return;
+            }
+            promises.push(processImageNode([node, index, parent], context));
+        });
+        await Promise.all(promises);
+    };
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

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

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

package/lib/remark/transformLinks/index.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.
+ */
+import type { Plugin } from 'unified';
+import type { Root } from 'mdast';
+import type { MarkdownConfig } from '@docusaurus/types';
+export type PluginOptions = {
+    staticDirs: string[];
+    siteDir: string;
+    onBrokenMarkdownLinks: MarkdownConfig['hooks']['onBrokenMarkdownLinks'];
+};
+declare const plugin: Plugin<PluginOptions[], Root>;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remark/transformLinks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EAAC,MAAM,EAAc,MAAM,SAAS,CAAC;AAGjD,OAAO,KAAK,EAAO,IAAI,EAAC,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,uBAAuB,CAAC,CAAC;CACzE,CAAC;AA+NF,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,CA2BzC,CAAC;eAEa,MAAM"}

package/lib/remark/transformLinks/index.js

@@ -0,0 +1,205 @@
+"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 });
+const tslib_1 = require("tslib");
+const node_path_1 = tslib_1.__importDefault(require("node:path"));
+const unist_util_visit_1 = require("unist-util-visit");
+const utils_1 = require("@docusaurus/utils");
+const logger_1 = tslib_1.__importDefault(require("@docusaurus/logger"));
+const fs_1 = require("@docusaurus/fs");
+const utils_2 = require("../utils");
+function asFunction(onBrokenMarkdownLinks) {
+    if (typeof onBrokenMarkdownLinks === 'string') {
+        const extraHelp = onBrokenMarkdownLinks === 'throw'
+            ? logger_1.default.interpolate `\nTo ignore this error, use the code=${'siteConfig.markdown.hooks.onBrokenMarkdownLinks'} option, or apply the code=${'pathname://'} protocol to the broken link URLs.`
+            : '';
+        return ({ sourceFilePath, url: linkUrl, node }) => {
+            const relativePath = (0, utils_1.toMessageRelativeFilePath)(sourceFilePath);
+            if (linkUrl) {
+                logger_1.default.report(onBrokenMarkdownLinks) `Markdown link with URL code=${linkUrl} in source file path=${relativePath}${(0, utils_2.formatNodePositionExtraMessage)(node)} couldn't be resolved.
+Make sure it references a local Markdown file that exists within the current plugin.${extraHelp}`;
+            }
+            else {
+                logger_1.default.report(onBrokenMarkdownLinks) `Markdown link with empty URL found in source file path=${relativePath}${(0, utils_2.formatNodePositionExtraMessage)(node)}.${extraHelp}`;
+            }
+        };
+    }
+    else {
+        return (params) => onBrokenMarkdownLinks({
+            ...params,
+            sourceFilePath: (0, utils_1.toMessageRelativeFilePath)(params.sourceFilePath),
+        });
+    }
+}
+/**
+ * Transforms the link node to a JSX `<a>` element with a `require()` call.
+ */
+function toAssetRequireNode([node], assetPath, context) {
+    // MdxJsxTextElement => see https://github.com/facebook/docusaurus/pull/8288#discussion_r1125871405
+    const jsxNode = node;
+    const attributes = [];
+    // require("assets/file.pdf") means requiring from a package called assets
+    const relativeAssetPath = `./${(0, utils_1.posixPath)(node_path_1.default.relative(node_path_1.default.dirname(context.filePath), assetPath))}`;
+    const parsedUrl = (0, utils_1.parseURLOrPath)(node.url);
+    const hash = parsedUrl.hash ?? '';
+    const search = parsedUrl.search ?? '';
+    const requireString = `${
+    // A hack to stop Webpack from using its built-in loader to parse JSON
+    node_path_1.default.extname(relativeAssetPath) === '.json'
+        ? `${relativeAssetPath.replace('.json', '.raw')}!=`
+        : ''}${context.inlineMarkdownLinkFileLoader}${(0, utils_1.escapePath)(relativeAssetPath) + search}`;
+    attributes.push({
+        type: 'mdxJsxAttribute',
+        name: 'target',
+        value: '_blank',
+    });
+    // Assets are not routes, and are required by Webpack already
+    // They should not trigger the broken link checker
+    attributes.push({
+        type: 'mdxJsxAttribute',
+        name: 'data-noBrokenLinkCheck',
+        value: {
+            type: 'mdxJsxAttributeValueExpression',
+            value: 'true',
+            data: {
+                estree: {
+                    type: 'Program',
+                    body: [
+                        {
+                            type: 'ExpressionStatement',
+                            expression: {
+                                type: 'Literal',
+                                value: true,
+                                raw: 'true',
+                            },
+                        },
+                    ],
+                    sourceType: 'module',
+                    comments: [],
+                },
+            },
+        },
+    });
+    attributes.push({
+        type: 'mdxJsxAttribute',
+        name: 'href',
+        value: (0, utils_2.assetRequireAttributeValue)(requireString, hash),
+    });
+    if (node.title) {
+        attributes.push({
+            type: 'mdxJsxAttribute',
+            name: 'title',
+            value: node.title,
+        });
+    }
+    const { children } = node;
+    (0, utils_2.transformNode)(jsxNode, {
+        type: 'mdxJsxTextElement',
+        name: 'a',
+        attributes,
+        children,
+    });
+}
+/**
+ * Checks if the given file path exists and is a file.
+ * Returns true if it exists, false otherwise.
+ */
+async function isExistingFile(filePath) {
+    try {
+        return (await fs_1.fs.stat(filePath)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function getLocalFileAbsolutePath(assetPath, { siteDir, filePath, staticDirs }) {
+    if (assetPath.startsWith('@site/')) {
+        const assetFilePath = node_path_1.default.join(siteDir, assetPath.replace('@site/', ''));
+        if (await isExistingFile(assetFilePath)) {
+            return assetFilePath;
+        }
+    }
+    else if (node_path_1.default.isAbsolute(assetPath)) {
+        const assetFilePath = await (0, utils_1.findAsyncSequential)(staticDirs.map((dir) => node_path_1.default.join(dir, assetPath)), isExistingFile);
+        if (assetFilePath) {
+            return assetFilePath;
+        }
+    }
+    else {
+        const assetFilePath = node_path_1.default.join(node_path_1.default.dirname(filePath), assetPath);
+        if (await isExistingFile(assetFilePath)) {
+            return assetFilePath;
+        }
+    }
+    return null;
+}
+async function processLinkNode(target, context) {
+    const [node] = target;
+    if (!node.url) {
+        node.url =
+            context.onBrokenMarkdownLinks({
+                url: node.url,
+                sourceFilePath: context.filePath,
+                node,
+            }) ?? node.url;
+        return;
+    }
+    const localUrlPath = (0, utils_1.parseLocalURLPath)(node.url);
+    if (!localUrlPath) {
+        // Don't process pathname:// here, it's used by the <Link> component
+        return;
+    }
+    const hasSiteAlias = localUrlPath.pathname.startsWith('@site/');
+    const hasAssetLikeExtension = node_path_1.default.extname(localUrlPath.pathname) &&
+        !localUrlPath.pathname.match(/\.(?:mdx?|html)(?:#|$)/);
+    if (!hasSiteAlias && !hasAssetLikeExtension) {
+        return;
+    }
+    const localFilePath = await getLocalFileAbsolutePath(decodeURIComponent(localUrlPath.pathname), context);
+    if (localFilePath) {
+        toAssetRequireNode(target, localFilePath, context);
+    }
+    else {
+        // The @site alias is the only way to believe that the user wants an asset.
+        if (hasSiteAlias) {
+            node.url =
+                context.onBrokenMarkdownLinks({
+                    url: node.url,
+                    sourceFilePath: context.filePath,
+                    node,
+                }) ?? node.url;
+        }
+        else {
+            // Even if the url has a dot, and it looks like a file extension
+            // it can be risky to throw and fail fast by default
+            // It's perfectly valid for a route path segment to look like a filename
+        }
+    }
+}
+const plugin = function plugin(options) {
+    const onBrokenMarkdownLinks = asFunction(options.onBrokenMarkdownLinks);
+    return async (root, vfile) => {
+        const fileLoaderUtils = (0, utils_1.getFileLoaderUtils)(vfile.data.compilerName === 'server');
+        const context = {
+            ...options,
+            filePath: vfile.path,
+            inlineMarkdownLinkFileLoader: fileLoaderUtils.loaders.inlineMarkdownLinkFileLoader,
+            onBrokenMarkdownLinks,
+        };
+        const promises = [];
+        (0, unist_util_visit_1.visit)(root, 'link', (node, index, parent) => {
+            if (!parent || index === undefined) {
+                return;
+            }
+            promises.push(processLinkNode([node, index, parent], context));
+        });
+        await Promise.all(promises);
+    };
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { Root } from 'mdast';
+import type { Plugin } from 'unified';
+import type { MarkdownConfig } from '@docusaurus/types';
+export type PluginOptions = {
+    onUnusedMarkdownDirectives: MarkdownConfig['hooks']['onUnusedMarkdownDirectives'];
+};
+declare const plugin: Plugin<PluginOptions[], Root>;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map