weseek__growi/packages/remark-growi-directive/test/mdast-util-growi-directive.test.js

import { fromMarkdown } from 'mdast-util-from-markdown';
import { toMarkdown } from 'mdast-util-to-markdown';
import test from 'tape';
import { removePosition } from 'unist-util-remove-position';

import { DirectiveType } from '../src/mdast-util-growi-directive/consts.js';
import { directiveFromMarkdown, directiveToMarkdown } from '../src/mdast-util-growi-directive/index.js';
import { directive } from '../src/micromark-extension-growi-directive/index.js';

test('markdown -> mdast', (t) => {
  t.deepEqual(
    fromMarkdown('a $b[c](d) e.', {
      extensions: [directive()],
      mdastExtensions: [directiveFromMarkdown],
    }).children[0],
    {
      type: 'paragraph',
      children: [
        {
          type: 'text',
          value: 'a ',
          position: {
            start: { line: 1, column: 1, offset: 0 },
            end: { line: 1, column: 3, offset: 2 },
          },
        },
        {
          type: DirectiveType.Text,
          name: 'b',
          attributes: { d: '' },
          children: [
            {
              type: 'text',
              value: 'c',
              position: {
                start: { line: 1, column: 6, offset: 5 },
                end: { line: 1, column: 7, offset: 6 },
              },
            },
          ],
          position: {
            start: { line: 1, column: 3, offset: 2 },
            end: { line: 1, column: 11, offset: 10 },
          },
        },
        {
          type: 'text',
          value: ' e.',
          position: {
            start: { line: 1, column: 11, offset: 10 },
            end: { line: 1, column: 14, offset: 13 },
          },
        },
      ],
      position: {
        start: { line: 1, column: 1, offset: 0 },
        end: { line: 1, column: 14, offset: 13 },
      },
    },
    'should support directives (text)',
  );

  t.deepEqual(
    fromMarkdown('$a[b](c)', {
      extensions: [directive()],
      mdastExtensions: [directiveFromMarkdown],
    }).children[0],
    {
      type: DirectiveType.Leaf,
      name: 'a',
      attributes: { c: '' },
      children: [
        {
          type: 'text',
          value: 'b',
          position: {
            start: { line: 1, column: 4, offset: 3 },
            end: { line: 1, column: 5, offset: 4 },
          },
        },
      ],
      position: {
        start: { line: 1, column: 1, offset: 0 },
        end: { line: 1, column: 9, offset: 8 },
      },
    },
    'should support directives (leaf)',
  );

  t.deepEqual(
    removePosition(
      fromMarkdown('x $a[b *c*\nd]', {
        extensions: [directive()],
        mdastExtensions: [directiveFromMarkdown],
      }),
      true,
    ),
    {
      type: 'root',
      children: [
        {
          type: 'paragraph',
          children: [
            { type: 'text', value: 'x ' },
            {
              type: DirectiveType.Text,
              name: 'a',
              attributes: {},
              children: [
                { type: 'text', value: 'b ' },
                { type: 'emphasis', children: [{ type: 'text', value: 'c' }] },
                { type: 'text', value: '\nd' },
              ],
            },
          ],
        },
      ],
    },
    'should support content in a label',
  );

  const hoge = removePosition(
    fromMarkdown('x $a(#b.c.d e=f g="h&i&unknown;j")', {
      extensions: [directive()],
      mdastExtensions: [directiveFromMarkdown],
    }),
    true,
  );

  t.deepEqual(
    removePosition(
      fromMarkdown('x $a(#b.c.d e=f g="h&i&unknown;j")', {
        extensions: [directive()],
        mdastExtensions: [directiveFromMarkdown],
      }),
      true,
    ),
    {
      type: 'root',
      children: [
        {
          type: 'paragraph',
          children: [
            { type: 'text', value: 'x ' },
            {
              type: DirectiveType.Text,
              name: 'a',
              attributes: {
                '#b.c.d': '', e: 'f', g: 'h&i&unknown;j',
              },
              children: [],
            },
          ],
        },
      ],
    },
    'should support attributes',
  );

  t.deepEqual(
    removePosition(
      fromMarkdown('$a(b\nc="d\ne")', {
        extensions: [directive()],
        mdastExtensions: [directiveFromMarkdown],
      }),
      true,
    ),
    {
      type: 'root',
      children: [
        {
          type: 'paragraph',
          children: [
            {
              type: DirectiveType.Text,
              name: 'a',
              attributes: { b: '', c: 'd\ne' },
              children: [],
            },
          ],
        },
      ],
    },
    'should support EOLs in attributes',
  );

  t.end();
});

test('mdast -> markdown', (t) => {
  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          // @ts-expect-error: `children`, `name` missing.
          { type: DirectiveType.Text },
          { type: 'text', value: ' b.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $ b.\n',
    'should try to serialize a directive (text) w/o `name`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          // @ts-expect-error: `children` missing.
          { type: DirectiveType.Text, name: 'b' },
          { type: 'text', value: ' c.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b c.\n',
    'should serialize a directive (text) w/ `name`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            children: [{ type: 'text', value: 'c' }],
          },
          { type: 'text', value: ' d.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b[c] d.\n',
    'should serialize a directive (text) w/ `children`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            children: [{ type: 'text', value: 'c[d]e' }],
          },
          { type: 'text', value: ' f.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b[c\\[d\\]e] f.\n',
    'should escape brackets in a directive (text) label',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            children: [{ type: 'text', value: 'c\nd' }],
          },
          { type: 'text', value: ' e.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b[c\nd] e.\n',
    'should support EOLs in a directive (text) label',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            // @ts-expect-error: should contain only `string`s
            attributes: {
              c: 'd', e: 'f', g: '', h: null, i: undefined, j: 2,
            },
            children: [],
          },
          { type: 'text', value: ' k.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(c="d" e="f" g j="2") k.\n',
    'should serialize a directive (text) w/ `attributes`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: { '#d': '', '.a.b.c': '', key: 'value' },
            children: [],
          },
          { type: 'text', value: ' k.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(#d .a.b.c key="value") k.\n',
    'should serialize a directive (text) w/ hash, dot notation attributes',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: { x: 'y"\'\r\nz' },
            children: [],
          },
          { type: 'text', value: ' k.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(x="y"\'\r\nz") k.\n',
    'should encode the quote in an attribute value (text)',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: { x: 'y"\'\r\nz' },
            children: [],
          },
          { type: 'text', value: ' k.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(x="y"\'\r\nz") k.\n',
    'should encode the quote in an attribute value (text)',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: { id: 'c#d' },
            children: [],
          },
          { type: 'text', value: ' e.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(id="c#d") e.\n',
    'should not use the `id` shortcut if impossible characters exist',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: { 'c.d': '', 'e<f': '' },
            children: [],
          },
          { type: 'text', value: ' g.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(c.d e<f) g.\n',
    'should not use the `class` shortcut if impossible characters exist',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: 'text', value: 'a ' },
          {
            type: DirectiveType.Text,
            name: 'b',
            attributes: {
              'c.d': '', e: '', 'f<g': '', hij: '',
            },
            children: [],
          },
          { type: 'text', value: ' k.' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a $b(c.d e f<g hij) k.\n',
    'should not use the `class` shortcut if impossible characters exist (but should use it for classes that don’t)',
  );

  t.deepEqual(
    // @ts-expect-error: `children`, `name` missing.
    toMarkdown({ type: DirectiveType.Leaf }, { extensions: [directiveToMarkdown] }),
    '$\n',
    'should try to serialize a directive (leaf) w/o `name`',
  );

  t.deepEqual(
    toMarkdown(
      // @ts-expect-error: `children` missing.
      { type: DirectiveType.Leaf, name: 'a' },
      { extensions: [directiveToMarkdown] },
    ),
    '$a\n',
    'should serialize a directive (leaf) w/ `name`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: DirectiveType.Leaf,
        name: 'a',
        children: [{ type: 'text', value: 'b' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$a[b]\n',
    'should serialize a directive (leaf) w/ `children`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: DirectiveType.Leaf,
        name: 'a',
        children: [{ type: 'text', value: 'b' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$a[b]\n',
    'should serialize a directive (leaf) w/ `children`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: DirectiveType.Leaf,
        name: 'a',
        children: [{ type: 'text', value: 'b\nc' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$a[b&#xA;c]\n',
    'should serialize a directive (leaf) w/ EOLs in `children`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: DirectiveType.Leaf,
        name: 'a',
        attributes: { '#b': '', '.c.d': '', key: 'e\nf' },
        children: [],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$a(#b .c.d key="e&#xA;f")\n',
    'should serialize a directive (leaf) w/ EOLs in `attributes`',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: 'a$b' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a\\$b\n',
    'should escape a `:` in phrasing when followed by an alpha',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: 'a$9' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a$9\n',
    'should not escape a `:` in phrasing when followed by a non-alpha',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: 'a$c' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    'a\\$c\n',
    'should not escape a `:` in phrasing when preceded by a colon',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: '$\na' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$\na\n',
    'should not escape a `:` at a break',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: '$a' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '\\$a\n',
    'should not escape a `:` at a break when followed by an alpha',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [{ type: 'text', value: '$\na' }],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$\na\n',
    'should escape a `:` at a break when followed by a colon',
  );

  t.deepEqual(
    toMarkdown(
      {
        type: 'paragraph',
        children: [
          { type: DirectiveType.Text, name: 'red', children: [] },
          { type: 'text', value: '$' },
        ],
      },
      { extensions: [directiveToMarkdown] },
    ),
    '$red$\n',
    'should escape a `:` after a text directive',
  );

  t.end();
});