unist-util-flatmap

1.0.0 • Public • Published

unist-util-flatmap

Create a new Unist tree by mapping (to an array) with the provided function and then flattening.

Helper for creating unist: Universal Syntax Tree.

Installation

npm install unist-util-flatmap

Usage

flatMap(AST, (node, index, parent) => /* array */): AST

flatMap function returns new AST object, but the argument function should return an array of ASTs.

const assert = require('assert')
const assign = require('object-assign')
const flatMap = require('unist-util-flatmap')
 
// Input
const tree = {
  type: 'root',
  children: [
    {
      type: 'node',
      children: [{type: 'leaf', value: '1'}]
    },
    {type: 'leaf', value: '2'}
  ]
}
 
// Transform:
const actual = flatMap(tree, node => {
  if (node.type === 'leaf') {
    return [
      assign({}, node, {value: 'FIRST'}),
      assign({}, node, {value: 'SECOND'})
    ]
  }
  // No change
  return [node]
})
 
// Expected output:
const expected = {
  type: 'root',
  children: [
    {
      type: 'node',
      children: [
        {type: 'leaf', value: 'FIRST'},
        {type: 'leaf', value: 'SECOND'}
      ]
    },
    {type: 'leaf', value: 'FIRST'},
    {type: 'leaf', value: 'SECOND'}
  ]
}
 
assert.deepEqual(actual, expected)

Tests

npm test

License

MIT

Dependencies (0)

    Dev Dependencies (5)

    Package Sidebar

    Install

    npm i unist-util-flatmap

    Weekly Downloads

    15,699

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    6.07 kB

    Total Files

    6

    Last publish

    Collaborators

    • staltz