up n_m

node_modules/@docusaurus/mdx-loader/lib/remark/transformLinks/index.js

@@ -0,0 +1,153 @@
+"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 path_1 = tslib_1.__importDefault(require("path"));
+const url_1 = tslib_1.__importDefault(require("url"));
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const utils_1 = require("@docusaurus/utils");
+const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
+const utils_2 = require("../utils");
+const { loaders: { inlineMarkdownLinkFileLoader }, } = (0, utils_1.getFileLoaderUtils)();
+/**
+ * Transforms the link node to a JSX `<a>` element with a `require()` call.
+ */
+async function toAssetRequireNode([node], assetPath, filePath) {
+    // 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)(path_1.default.relative(path_1.default.dirname(filePath), assetPath))}`;
+    const parsedUrl = url_1.default.parse(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
+    path_1.default.extname(relativeAssetPath) === '.json'
+        ? `${relativeAssetPath.replace('.json', '.raw')}!=`
+        : ''}${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: (0, escape_html_1.default)(node.title),
+        });
+    }
+    const { children } = node;
+    (0, utils_2.transformNode)(jsxNode, {
+        type: 'mdxJsxTextElement',
+        name: 'a',
+        attributes,
+        children,
+    });
+}
+async function ensureAssetFileExist(assetPath, sourceFilePath) {
+    const assetExists = await fs_extra_1.default.pathExists(assetPath);
+    if (!assetExists) {
+        throw new Error(`Asset ${(0, utils_1.toMessageRelativeFilePath)(assetPath)} used in ${(0, utils_1.toMessageRelativeFilePath)(sourceFilePath)} not found.`);
+    }
+}
+async function getAssetAbsolutePath(assetPath, { siteDir, filePath, staticDirs }) {
+    if (assetPath.startsWith('@site/')) {
+        const assetFilePath = path_1.default.join(siteDir, assetPath.replace('@site/', ''));
+        // The @site alias is the only way to believe that the user wants an asset.
+        // Everything else can just be a link URL
+        await ensureAssetFileExist(assetFilePath, filePath);
+        return assetFilePath;
+    }
+    else if (path_1.default.isAbsolute(assetPath)) {
+        const assetFilePath = await (0, utils_1.findAsyncSequential)(staticDirs.map((dir) => path_1.default.join(dir, assetPath)), fs_extra_1.default.pathExists);
+        if (assetFilePath) {
+            return assetFilePath;
+        }
+    }
+    else {
+        const assetFilePath = path_1.default.join(path_1.default.dirname(filePath), assetPath);
+        if (await fs_extra_1.default.pathExists(assetFilePath)) {
+            return assetFilePath;
+        }
+    }
+    return null;
+}
+async function processLinkNode(target, context) {
+    const [node] = target;
+    if (!node.url) {
+        // Try to improve error feedback
+        // see https://github.com/facebook/docusaurus/issues/3309#issuecomment-690371675
+        const title = node.title ?? node.children[0]?.value ?? '?';
+        const line = node.position?.start.line ?? '?';
+        throw new Error(`Markdown link URL is mandatory in "${(0, utils_1.toMessageRelativeFilePath)(context.filePath)}" file (title: ${title}, line: ${line}).`);
+    }
+    const parsedUrl = url_1.default.parse(node.url);
+    if (parsedUrl.protocol || !parsedUrl.pathname) {
+        // Don't process pathname:// here, it's used by the <Link> component
+        return;
+    }
+    const hasSiteAlias = parsedUrl.pathname.startsWith('@site/');
+    const hasAssetLikeExtension = path_1.default.extname(parsedUrl.pathname) &&
+        !parsedUrl.pathname.match(/\.(?:mdx?|html)(?:#|$)/);
+    if (!hasSiteAlias && !hasAssetLikeExtension) {
+        return;
+    }
+    const assetPath = await getAssetAbsolutePath(decodeURIComponent(parsedUrl.pathname), context);
+    if (assetPath) {
+        await toAssetRequireNode(target, assetPath, context.filePath);
+    }
+}
+function plugin(options) {
+    return async (root, vfile) => {
+        const { visit } = await import('unist-util-visit');
+        const promises = [];
+        visit(root, 'link', (node, index, parent) => {
+            promises.push(processLinkNode([node, index, parent], {
+                ...options,
+                filePath: vfile.path,
+            }));
+        });
+        await Promise.all(promises);
+    };
+}
+exports.default = plugin;
+//# sourceMappingURL=index.js.map