@docusaurus/mdx-loader 2.0.0-beta.2 → 2.0.0-beta.20

package/src/remark/toc/__tests__/index.test.js

@@ -1,212 +0,0 @@
-/**
- * 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 {join} from 'path';
-import remark from 'remark';
-import mdx from 'remark-mdx';
-import vfile from 'to-vfile';
-import plugin from '../index';
-import headings from '../../headings/index';
-
-const processFixture = async (name, options) => {
-  const path = join(__dirname, 'fixtures', `${name}.md`);
-  const file = await vfile.read(path);
-  const result = await remark()
-    .use(headings)
-    .use(mdx)
-    .use(plugin, options)
-    .process(file);
-
-  return result.toString();
-};
-
-test('non text phrasing content', async () => {
-  const result = await processFixture('non-text-content');
-  expect(result).toMatchSnapshot();
-});
-
-test('inline code should be escaped', async () => {
-  const result = await processFixture('inline-code');
-  expect(result).toMatchSnapshot();
-});
-
-test('text content', async () => {
-  const result = await processFixture('just-content');
-  expect(result).toMatchInlineSnapshot(`
-    "export const toc = [
-    	{
-    		value: 'Endi',
-    		id: 'endi',
-    		children: []
-    	},
-    	{
-    		value: 'Endi',
-    		id: 'endi-1',
-    		children: [
-    			{
-    				value: 'Yangshun',
-    				id: 'yangshun',
-    				children: []
-    			}
-    		]
-    	},
-    	{
-    		value: 'I ♥ unicode.',
-    		id: 'i--unicode',
-    		children: []
-    	}
-    ];
-
-    ### Endi
-
-    \`\`\`md
-    ## This is ignored
-    \`\`\`
-
-    ## Endi
-
-    Lorem ipsum
-
-    ### Yangshun
-
-    Some content here
-
-    ## I ♥ unicode.
-    "
-  `);
-});
-
-test('should export even with existing name', async () => {
-  const result = await processFixture('name-exist');
-  expect(result).toMatchInlineSnapshot(`
-    "export const toc = [
-    	{
-    		value: 'Thanos',
-    		id: 'thanos',
-    		children: []
-    	},
-    	{
-    		value: 'Tony Stark',
-    		id: 'tony-stark',
-    		children: [
-    			{
-    				value: 'Avengers',
-    				id: 'avengers',
-    				children: []
-    			}
-    		]
-    	}
-    ];
-
-    ## Thanos
-
-    ## Tony Stark
-
-    ### Avengers
-    "
-  `);
-});
-
-test('should export with custom name', async () => {
-  const options = {
-    name: 'customName',
-  };
-  const result = await processFixture('just-content', options);
-  expect(result).toMatchInlineSnapshot(`
-    "export const customName = [
-    	{
-    		value: 'Endi',
-    		id: 'endi',
-    		children: []
-    	},
-    	{
-    		value: 'Endi',
-    		id: 'endi-1',
-    		children: [
-    			{
-    				value: 'Yangshun',
-    				id: 'yangshun',
-    				children: []
-    			}
-    		]
-    	},
-    	{
-    		value: 'I ♥ unicode.',
-    		id: 'i--unicode',
-    		children: []
-    	}
-    ];
-
-    ### Endi
-
-    \`\`\`md
-    ## This is ignored
-    \`\`\`
-
-    ## Endi
-
-    Lorem ipsum
-
-    ### Yangshun
-
-    Some content here
-
-    ## I ♥ unicode.
-    "
-  `);
-});
-
-test('should insert below imports', async () => {
-  const result = await processFixture('insert-below-imports');
-  expect(result).toMatchInlineSnapshot(`
-    "import something from 'something';
-
-    import somethingElse from 'something-else';
-
-    export const toc = [
-    	{
-    		value: 'Title',
-    		id: 'title',
-    		children: []
-    	},
-    	{
-    		value: 'Test',
-    		id: 'test',
-    		children: [
-    			{
-    				value: 'Again',
-    				id: 'again',
-    				children: []
-    			}
-    		]
-    	}
-    ];
-
-    ## Title
-
-    ## Test
-
-    ### Again
-
-    Content.
-    "
-  `);
-});
-
-test('empty headings', async () => {
-  const result = await processFixture('empty-headings');
-  expect(result).toMatchInlineSnapshot(`
-    "export const toc = [];
-
-    # Ignore this
-
-    ## 
-
-    ## ![](an-image.svg)
-    "
-  `);
-});

package/src/remark/toc/index.js

@@ -1,79 +0,0 @@
-/**
- * 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 {parse} = require('@babel/parser');
-const traverse = require('@babel/traverse').default;
-const stringifyObject = require('stringify-object');
-const search = require('./search');
-
-const parseOptions = {
-  plugins: ['jsx'],
-  sourceType: 'module',
-};
-const isImport = (child) => child.type === 'import';
-const hasImports = (index) => index > -1;
-const isExport = (child) => child.type === 'export';
-
-const isTarget = (child, name) => {
-  let found = false;
-  const ast = parse(child.value, parseOptions);
-  traverse(ast, {
-    VariableDeclarator: (path) => {
-      if (path.node.id.name === name) {
-        found = true;
-      }
-    },
-  });
-
-  return found;
-};
-
-const getOrCreateExistingTargetIndex = (children, name) => {
-  let importsIndex = -1;
-  let targetIndex = -1;
-
-  children.forEach((child, index) => {
-    if (isImport(child)) {
-      importsIndex = index;
-    } else if (isExport(child) && isTarget(child, name)) {
-      targetIndex = index;
-    }
-  });
-
-  if (targetIndex === -1) {
-    const target = {
-      default: false,
-      type: 'export',
-      value: `export const ${name} = [];`,
-    };
-
-    targetIndex = hasImports(importsIndex) ? importsIndex + 1 : 0;
-    children.splice(targetIndex, 0, target);
-  }
-
-  return targetIndex;
-};
-
-const plugin = (options = {}) => {
-  const name = options.name || 'toc';
-
-  const transformer = (node) => {
-    const headings = search(node);
-    const {children} = node;
-    const targetIndex = getOrCreateExistingTargetIndex(children, name);
-
-    if (headings && headings.length) {
-      children[targetIndex].value = `export const ${name} = ${stringifyObject(
-        headings,
-      )};`;
-    }
-  };
-
-  return transformer;
-};
-
-module.exports = plugin;

package/src/remark/toc/search.js

@@ -1,73 +0,0 @@
-/**
- * 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.
- */
-
-// @ts-check
-
-const toString = require('mdast-util-to-string');
-const visit = require('unist-util-visit');
-// Destructuring require tslib
-// eslint-disable-next-line prefer-destructuring
-const toValue = require('../utils').toValue;
-
-/** @typedef {import('@docusaurus/types').TOCItem} TOC */
-/** @typedef {import('unist').Node} Node */
-
-/**
- * @typedef {Object} StringValuedNode
- * @property {string} type
- * @property {string} value
- * @property {number} depth
- * @property {Object} data
- * @property {StringValuedNode[]} children
- */
-
-// Visit all headings. We `slug` all headings (to account for
-// duplicates), but only take h2 and h3 headings.
-/**
- * @param {StringValuedNode} node
- * @returns {TOC[]}
- */
-function search(node) {
-  /** @type {TOC[]} */
-  const headings = [];
-  let current = -1;
-  let currentDepth = 0;
-
-  /**
-   * @param {StringValuedNode} child
-   * @param {number} index
-   * @param {Node | undefined} parent
-   * @returns {void}
-   */
-  const onHeading = (child, index, parent) => {
-    const value = toString(child);
-
-    if (parent !== node || !value || child.depth > 3 || child.depth < 2) {
-      return;
-    }
-
-    const entry = {
-      value: toValue(child),
-      id: child.data.id,
-      children: [],
-    };
-
-    if (!headings.length || currentDepth >= child.depth) {
-      headings.push(entry);
-      current += 1;
-      currentDepth = child.depth;
-    } else {
-      headings[current].children.push(entry);
-    }
-  };
-
-  visit(node, 'heading', onHeading);
-
-  return headings;
-}
-
-module.exports = search;

package/src/remark/transformImage/__tests__/__snapshots__/index.test.js.snap

@@ -1,31 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`transformImage plugin fail if image does not exist 1`] = `"Image packages/docusaurus-mdx-loader/src/remark/transformImage/__tests__/fixtures/img/doesNotExist.png used in packages/docusaurus-mdx-loader/src/remark/transformImage/__tests__/fixtures/fail.md not found."`;
-
-exports[`transformImage plugin fail if image url is absent 1`] = `"Markdown image URL is mandatory in \\"packages/docusaurus-mdx-loader/src/remark/transformImage/__tests__/fixtures/noUrl.md\\" file"`;
-
-exports[`transformImage plugin pathname protocol 1`] = `
-"![img](/img/unchecked.png)
-"
-`;
-
-exports[`transformImage plugin transform md images to <img /> 1`] = `
-"![img](https://example.com/img.png)
-
-<img src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./img.png\\").default} />
-
-<img alt={\\"img\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./img.png\\").default} />
-
-<img alt={\\"img\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./img.png\\").default} title=\\"Title\\" /> <img alt={\\"img\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!packages/docusaurus-mdx-loader/src/remark/transformImage/__tests__/fixtures/img.png\\").default} />
-
-<img alt={\\"img with &quot;quotes&quot;\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./img.png\\").default} title=\\"&#39;Quoted&#39; title\\" />
-
-## Heading
-
-\`\`\`md
-![img](./img.png)
-\`\`\`
-
-<img alt={\\"img\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./img.png\\").default} />
-"
-`;

package/src/remark/transformImage/__tests__/fixtures/fail.md

@@ -1 +0,0 @@
-![img](/img/doesNotExist.png)

package/src/remark/transformImage/__tests__/fixtures/img.md

@@ -1,17 +0,0 @@
-![img](https://example.com/img.png)
-
-![](./img.png)
-
-![img](./img.png)
-
-![img](./img.png 'Title') ![img](/img.png)
-
-![img with "quotes"](./img.png ''Quoted' title')
-
-## Heading
-
-```md
-![img](./img.png)
-```
-
-![img](img.png)

package/src/remark/transformImage/__tests__/fixtures/noUrl.md

@@ -1 +0,0 @@
-![img]()

package/src/remark/transformImage/__tests__/fixtures/pathname.md

@@ -1 +0,0 @@
-![img](pathname:///img/unchecked.png)

package/src/remark/transformImage/__tests__/index.test.js

@@ -1,59 +0,0 @@
-/**
- * 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 {join, relative} from 'path';
-import remark from 'remark';
-import mdx from 'remark-mdx';
-import vfile from 'to-vfile';
-import plugin from '../index';
-import headings from '../../headings/index';
-
-const processFixture = async (name, options) => {
-  const path = join(__dirname, 'fixtures', `${name}.md`);
-  const file = await vfile.read(path);
-  const result = await remark()
-    .use(headings)
-    .use(mdx)
-    .use(plugin, {...options, filePath: path})
-    .process(file);
-
-  return result.toString();
-};
-
-// avoid hardcoding absolute
-const staticDir = `./${relative(process.cwd(), join(__dirname, 'fixtures'))}`;
-
-describe('transformImage plugin', () => {
-  test('fail if image does not exist', async () => {
-    await expect(
-      processFixture('fail', {
-        staticDir,
-      }),
-    ).rejects.toThrowErrorMatchingSnapshot();
-  });
-  test('fail if image url is absent', async () => {
-    await expect(
-      processFixture('noUrl', {
-        staticDir,
-      }),
-    ).rejects.toThrowErrorMatchingSnapshot();
-  });
-
-  test('transform md images to <img />', async () => {
-    const result = await processFixture('img', {
-      staticDir,
-    });
-    expect(result).toMatchSnapshot();
-  });
-
-  test('pathname protocol', async () => {
-    const result = await processFixture('pathname', {
-      staticDir,
-    });
-    expect(result).toMatchSnapshot();
-  });
-});

package/src/remark/transformImage/index.js

@@ -1,106 +0,0 @@
-/**
- * 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 visit = require('unist-util-visit');
-const path = require('path');
-const url = require('url');
-const fs = require('fs-extra');
-const escapeHtml = require('escape-html');
-const {getFileLoaderUtils} = require('@docusaurus/core/lib/webpack/utils');
-const {
-  posixPath,
-  escapePath,
-  toMessageRelativeFilePath,
-} = require('@docusaurus/utils');
-
-const {
-  loaders: {inlineMarkdownImageFileLoader},
-} = getFileLoaderUtils();
-
-const createJSX = (node, pathUrl) => {
-  const jsxNode = node;
-  jsxNode.type = 'jsx';
-  jsxNode.value = `<img ${node.alt ? `alt={"${escapeHtml(node.alt)}"} ` : ''}${
-    node.url
-      ? `src={require("${inlineMarkdownImageFileLoader}${escapePath(
-          pathUrl,
-        )}").default}`
-      : ''
-  }${node.title ? ` title="${escapeHtml(node.title)}"` : ''} />`;
-
-  if (jsxNode.url) {
-    delete jsxNode.url;
-  }
-  if (jsxNode.alt) {
-    delete jsxNode.alt;
-  }
-  if (jsxNode.title) {
-    delete jsxNode.title;
-  }
-};
-
-async function ensureImageFileExist(imagePath, sourceFilePath) {
-  const imageExists = await fs.pathExists(imagePath);
-  if (!imageExists) {
-    throw new Error(
-      `Image ${toMessageRelativeFilePath(
-        imagePath,
-      )} used in ${toMessageRelativeFilePath(sourceFilePath)} not found.`,
-    );
-  }
-}
-
-async function processImageNode(node, {filePath, staticDir}) {
-  if (!node.url) {
-    throw new Error(
-      `Markdown image URL is mandatory in "${toMessageRelativeFilePath(
-        filePath,
-      )}" file`,
-    );
-  }
-
-  const parsedUrl = url.parse(node.url);
-  if (parsedUrl.protocol) {
-    // pathname:// is an escape hatch,
-    // in case user does not want his images to be converted to require calls going through webpack loader
-    // we don't have to document this for now,
-    // it's mostly to make next release less risky (2.0.0-alpha.59)
-    if (parsedUrl.protocol === 'pathname:') {
-      node.url = node.url.replace('pathname://', '');
-    } else {
-      // noop
-    }
-  }
-  // images without protocol
-  else if (path.isAbsolute(node.url)) {
-    // absolute paths are expected to exist in the static folder
-    const expectedImagePath = path.join(staticDir, node.url);
-    await ensureImageFileExist(expectedImagePath, filePath);
-    createJSX(node, posixPath(expectedImagePath));
-  }
-  // We try to convert image urls without protocol to images with require calls
-  // going through webpack ensures that image assets exist at build time
-  else {
-    // relative paths are resolved against the source file's folder
-    const expectedImagePath = path.join(path.dirname(filePath), node.url);
-    await ensureImageFileExist(expectedImagePath, filePath);
-    createJSX(node, node.url.startsWith('./') ? node.url : `./${node.url}`);
-  }
-}
-
-const plugin = (options) => {
-  const transformer = async (root) => {
-    const promises = [];
-    visit(root, 'image', (node) => {
-      promises.push(processImageNode(node, options));
-    });
-    await Promise.all(promises);
-  };
-  return transformer;
-};
-
-module.exports = plugin;

package/src/remark/transformLinks/__tests__/__snapshots__/index.test.js.snap

@@ -1,41 +0,0 @@
-// Jest Snapshot v1, https://goo.gl/fbAQLP
-
-exports[`transformAsset plugin fail if asset url is absent 1`] = `"Markdown link URL is mandatory in \\"packages/docusaurus-mdx-loader/src/remark/transformLinks/__tests__/fixtures/noUrl.md\\" file (title: asset, line: 1)."`;
-
-exports[`transformAsset plugin pathname protocol 1`] = `
-"[asset](pathname:///asset/unchecked.pdf)
-"
-`;
-
-exports[`transformAsset plugin transform md links to <a /> 1`] = `
-"[asset](https://example.com/asset.pdf)
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./asset.pdf').default}></a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./asset.pdf').default}>asset</a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./asset.pdf').default}title=\\"Title\\">asset</a>
-
-## Heading
-
-\`\`\`md
-[asset](./asset.pdf)
-\`\`\`
-
-[assets](!file-loader!./asset.pdf)
-
-[assets](/github/!file-loader!/assets.pdf)
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./asset.pdf').default}>asset</a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAsset.pdf').default}>staticAsset.pdf</a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAsset.pdf').default}>@site/static/staticAsset.pdf</a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAsset.pdf').default}>Just staticAsset.pdf</a>, and <a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAsset.pdf').default}><strong>awesome</strong> staticAsset 2.pdf &#39;It is really &quot;AWESOME&quot;&#39;</a>, but also <a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAsset.pdf').default}>coded <code>staticAsset 3.pdf</code></a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./static/staticAssetImage.png').default}><img alt={\\"Clickable Docusaurus logo\\"} src={require(\\"!url-loader?limit=10000&name=assets/images/[name]-[hash].[ext]&fallback=file-loader!./static/staticAssetImage.png\\").default} /></a>
-
-<a target=\\"_blank\\" href={require('!file-loader?name=assets/files/[name]-[hash].[ext]!./asset.pdf').default}><span style={{color: \\"red\\"}}>Stylized link to asset file</span></a>
-"
-`;

package/src/remark/transformLinks/__tests__/fixtures/asset.md

@@ -1,29 +0,0 @@
-[asset](https://example.com/asset.pdf)
-
-[](./asset.pdf)
-
-[asset](./asset.pdf)
-
-[asset](asset.pdf 'Title')
-
-## Heading
-
-```md
-[asset](./asset.pdf)
-```
-
-[assets](!file-loader!./asset.pdf)
-
-[assets](/github/!file-loader!/assets.pdf)
-
-[asset](asset.pdf)
-
-[staticAsset.pdf](/staticAsset.pdf)
-
-[@site/static/staticAsset.pdf](@site/static/staticAsset.pdf)
-
-[Just staticAsset.pdf](/staticAsset.pdf), and [**awesome** staticAsset 2.pdf 'It is really "AWESOME"'](/staticAsset.pdf), but also [coded `staticAsset 3.pdf`](/staticAsset.pdf)
-
-[![Clickable Docusaurus logo](./static/staticAssetImage.png)](/staticAssetImage.png)
-
-[<span style={{color: "red"}}>Stylized link to asset file</span>](./asset.pdf)

package/src/remark/transformLinks/__tests__/fixtures/noUrl.md

@@ -1 +0,0 @@
-[asset]()

package/src/remark/transformLinks/__tests__/fixtures/pathname.md

@@ -1 +0,0 @@
-[asset](pathname:///asset/unchecked.pdf)