|
|
'use strict';
var use = require('use'); var define = require('define-property'); var debug = require('debug')('snapdragon:compiler'); var utils = require('./utils');
/** * Create a new `Compiler` with the given `options`. * @param {Object} `options` */
function Compiler(options, state) { debug('initializing', __filename); this.options = utils.extend({source: 'string'}, options); this.state = state || {}; this.compilers = {}; this.output = ''; this.set('eos', function(node) { return this.emit(node.val, node); }); this.set('noop', function(node) { return this.emit(node.val, node); }); this.set('bos', function(node) { return this.emit(node.val, node); }); use(this); }
/** * Prototype methods */
Compiler.prototype = {
/** * Throw an error message with details including the cursor position. * @param {String} `msg` Message to use in the Error. */
error: function(msg, node) { var pos = node.position || {start: {column: 0}}; var message = this.options.source + ' column:' + pos.start.column + ': ' + msg;
var err = new Error(message); err.reason = msg; err.column = pos.start.column; err.source = this.pattern;
if (this.options.silent) { this.errors.push(err); } else { throw err; } },
/** * Define a non-enumberable property on the `Compiler` instance. * * ```js
* compiler.define('foo', 'bar'); * ```
* @name .define * @param {String} `key` propery name * @param {any} `val` property value * @return {Object} Returns the Compiler instance for chaining. * @api public */
define: function(key, val) { define(this, key, val); return this; },
/** * Emit `node.val` */
emit: function(str, node) { this.output += str; return str; },
/** * Add a compiler `fn` with the given `name` */
set: function(name, fn) { this.compilers[name] = fn; return this; },
/** * Get compiler `name`. */
get: function(name) { return this.compilers[name]; },
/** * Get the previous AST node. */
prev: function(n) { return this.ast.nodes[this.idx - (n || 1)] || { type: 'bos', val: '' }; },
/** * Get the next AST node. */
next: function(n) { return this.ast.nodes[this.idx + (n || 1)] || { type: 'eos', val: '' }; },
/** * Visit `node`. */
visit: function(node, nodes, i) { var fn = this.compilers[node.type]; this.idx = i;
if (typeof fn !== 'function') { throw this.error('compiler "' + node.type + '" is not registered', node); } return fn.call(this, node, nodes, i); },
/** * Map visit over array of `nodes`. */
mapVisit: function(nodes) { if (!Array.isArray(nodes)) { throw new TypeError('expected an array'); } var len = nodes.length; var idx = -1; while (++idx < len) { this.visit(nodes[idx], nodes, idx); } return this; },
/** * Compile `ast`. */
compile: function(ast, options) { var opts = utils.extend({}, this.options, options); this.ast = ast; this.parsingErrors = this.ast.errors; this.output = '';
// source map support
if (opts.sourcemap) { var sourcemaps = require('./source-maps'); sourcemaps(this); this.mapVisit(this.ast.nodes); this.applySourceMaps(); this.map = opts.sourcemap === 'generator' ? this.map : this.map.toJSON(); return this; }
this.mapVisit(this.ast.nodes); return this; } };
/** * Expose `Compiler` */
module.exports = Compiler;
|