|
'use strict';
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.extract = extract;
exports.strip = strip;
exports.parse = parse;
exports.parseWithComments = parseWithComments;
exports.print = print;
var _detectNewline;
function _load_detectNewline() {
return _detectNewline = _interopRequireDefault(require('detect-newline'));
}
var _os;
function _load_os() {
return _os = require('os');
}
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
/**
* Copyright (c) 2014-present, Facebook, Inc. All rights reserved.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*
*
*/
const commentEndRe = /\*\/$/;
const commentStartRe = /^\/\*\*/;
const docblockRe = /^\s*(\/\*\*?(.|\r?\n)*?\*\/)/;
const lineCommentRe = /(^|\s+)\/\/([^\r\n]*)/g;
const ltrimNewlineRe = /^(\r?\n)+/;
const multilineRe = /(?:^|\r?\n) *(@[^\r\n]*?) *\r?\n *(?![^@\r\n]*\/\/[^]*)([^@\r\n\s][^@\r\n]+?) *\r?\n/g;
const propertyRe = /(?:^|\r?\n) *@(\S+) *([^\r\n]*)/g;
const stringStartRe = /(\r?\n|^) *\* ?/g;
function extract(contents) {
const match = contents.match(docblockRe);
return match ? match[0].trimLeft() : '';
}
function strip(contents) {
const match = contents.match(docblockRe);
return match && match[0] ? contents.substring(match[0].length) : contents;
}
function parse(docblock) {
return parseWithComments(docblock).pragmas;
}
function parseWithComments(docblock) {
const line = (0, (_detectNewline || _load_detectNewline()).default)(docblock) || (_os || _load_os()).EOL;
docblock = docblock.replace(commentStartRe, '').replace(commentEndRe, '').replace(stringStartRe, '$1');
// Normalize multi-line directives
let prev = '';
while (prev !== docblock) {
prev = docblock;
docblock = docblock.replace(multilineRe, `${line}$1 $2${line}`);
}
docblock = docblock.replace(ltrimNewlineRe, '').trimRight();
const result = Object.create(null);
const comments = docblock.replace(propertyRe, '').replace(ltrimNewlineRe, '').trimRight();
let match;
while (match = propertyRe.exec(docblock)) {
// strip linecomments from pragmas
const nextPragma = match[2].replace(lineCommentRe, '');
if (typeof result[match[1]] === 'string' || Array.isArray(result[match[1]])) {
result[match[1]] = [].concat(result[match[1]], nextPragma);
} else {
result[match[1]] = nextPragma;
}
}
return { comments, pragmas: result };
}
function print(_ref) {
var _ref$comments = _ref.comments;
let comments = _ref$comments === undefined ? '' : _ref$comments;
var _ref$pragmas = _ref.pragmas;
let pragmas = _ref$pragmas === undefined ? {} : _ref$pragmas;
const line = (0, (_detectNewline || _load_detectNewline()).default)(comments) || (_os || _load_os()).EOL;
const head = '/**';
const start = ' *';
const tail = ' */';
const keys = Object.keys(pragmas);
const printedObject = keys.map(key => printKeyValues(key, pragmas[key])).reduce((arr, next) => arr.concat(next), []).map(keyValue => start + ' ' + keyValue + line).join('');
if (!comments) {
if (keys.length === 0) {
return '';
}
if (keys.length === 1 && !Array.isArray(pragmas[keys[0]])) {
const value = pragmas[keys[0]];
return `${head} ${printKeyValues(keys[0], value)[0]}${tail}`;
}
}
const printedComments = comments.split(line).map(textLine => `${start} ${textLine}`).join(line) + line;
return head + line + (comments ? printedComments : '') + (comments && keys.length ? start + line : '') + printedObject + tail;
}
function printKeyValues(key, valueOrArray) {
return [].concat(valueOrArray).map(value => `@${key} ${value}`.trim());
}
|