editor.js/src/components/modules/renderer.ts

import Module from '../__module';
import _, {ChainData} from '../utils';
import {BlockToolData} from '../../../types';

/**
 * Codex Editor Renderer Module
 *
 * @module Renderer
 * @author CodeX Team
 *
 * @version 2.0.0
 */
export default class Renderer extends Module {
  /**
   * @typedef {Object} RendererBlocks
   * @property {String} type - tool name
   * @property {Object} data - tool data
   */

  /**
   * @example
   *
   * blocks: [
   *   {
   *     type : 'paragraph',
   *     data : {
   *       text : 'Hello from Codex!'
   *     }
   *   },
   *   {
   *     type : 'paragraph',
   *     data : {
   *       text : 'Leave feedback if you like it!'
   *     }
   *   },
   * ]
   *
   */

  /**
   * Make plugin blocks from array of plugin`s data
   * @param {RendererBlocks[]} blocks
   */
  public render(blocks: BlockToolData[]): Promise<void> {
    const chainData = blocks.map((block) => ({function: () => this.insertBlock(block)}));

    return _.sequence(chainData as ChainData[]);
  }

  /**
   * Get plugin instance
   * Add plugin instance to BlockManager
   * Insert block to working zone
   *
   * @param {Object} item
   * @returns {Promise<void>}
   * @private
   */
  public async insertBlock(item): Promise<void> {
    const tool = item.type;
    const data = item.data;
    const settings = item.settings;

    if (tool in this.Editor.Tools.available) {
      try {
        this.Editor.BlockManager.insert(tool, data, settings);
      } catch (error) {
        _.log(`Block «${tool}» skipped because of plugins error`, 'warn', data);
        throw Error(error);
      }
    } else {
      /**
       * @todo show warning notification message
       *
       * `${tool} blocks was skipped.`
       */
      _.log(`Tool «${tool}» is not found. Check 'tools' property at your initial CodeX Editor config.`, 'warn');
    }
  }
}