"use strict"; const GrammarError = require("./grammar-error"); const GrammarLocation = require("./grammar-location"); const asts = require("./compiler/asts.js"); const compiler = require("./compiler"); const parser = require("./parser"); const VERSION = require("./version"); const RESERVED_WORDS = [ // Reserved keywords as of ECMAScript 2015 "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete", "do", "else", "export", "extends", "finally", "for", "function", "if", "import", "in", "instanceof", "new", "return", "super", "switch", "this", "throw", "try", "typeof", "var", "void", "while", "with", // Special constants "null", "true", "false", // These are always reserved: "enum", // The following are only reserved when they are found in strict mode code // Peggy generates code in strict mode, so they are applicable "implements", "interface", "let", "package", "private", "protected", "public", "static", "yield", // The following are only reserved when they are found in module code: "await", // The following are reserved as future keywords by ECMAScript 1..3 // specifications, but not any more in modern ECMAScript. We don't need these // because the code-generation of Peggy only targets ECMAScript >= 5. // // - abstract // - boolean // - byte // - char // - double // - final // - float // - goto // - int // - long // - native // - short // - synchronized // - throws // - transient // - volatile // These are not reserved keywords, but using them as variable names is problematic. "arguments", // Conflicts with a special variable available inside functions. "eval", // Redeclaring eval() is prohibited in strict mode // A few identifiers have a special meaning in some contexts without being // reserved words of any kind. These we don't need to worry about as they can // all be safely used as variable names. // // - as // - async // - from // - get // - of // - set ]; const peg = { // Peggy version (filled in by /tools/release). VERSION, /** * Default list of reserved words. Contains list of currently and future * JavaScript (ECMAScript 2015) reserved words. * * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#reserved_words */ RESERVED_WORDS, GrammarError, GrammarLocation, parser, compiler, // Generates a parser from a specified grammar and returns it. // // The grammar must be a string in the format described by the meta-grammar in // the parser.pegjs file. // // Throws |peg.parser.SyntaxError| if the grammar contains a syntax error or // |peg.GrammarError| if it contains a semantic error. Note that not all // errors are detected during the generation and some may protrude to the // generated parser and cause its malfunction. generate(grammar, options) { options = options !== undefined ? options : {}; function copyPasses(passes) { const converted = {}; Object.keys(passes).forEach(stage => { converted[stage] = passes[stage].slice(); }); return converted; } const plugins = "plugins" in options ? options.plugins : []; const config = { parser: peg.parser, passes: copyPasses(peg.compiler.passes), reservedWords: peg.RESERVED_WORDS.slice(), }; plugins.forEach(p => { p.use(config, options); }); if (!Array.isArray(grammar)) { grammar = [{ source: options.grammarSource, text: grammar, }]; } const combined = asts.combine( grammar.map(({ source, text }) => config.parser.parse(text, { grammarSource: source, reservedWords: config.reservedWords, })) ); return peg.compiler.compile( combined, config.passes, options ); }, }; module.exports = peg;