暫無描述

index.js 3.7KB

    '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()); }