markdown-magic 3.1.0 → 3.2.0

package/lib/transforms/code/index.js

@@ -3,7 +3,7 @@ const path = require('path')
 const { remoteRequest } = require('../../utils/remoteRequest')
 const { isLocalPath } = require('../../utils/fs')
 const { deepLog } = require('../../utils/logs')
-const { getLineCount, getTextBetweenLines } = require('../../utils/text')
+const { getLineCount, getTextBetweenLines, stripOutMultiLineDoubleDashComments } = require('../../utils/text')
 const { resolveGithubContents, isGithubLink } = require('./resolve-github-file')
 
 const GITHUB_LINK = /https:\/\/github\.com\/([^/\s]*)\/([^/\s]*)\/blob\//
@@ -17,6 +17,7 @@ const RAW_URL_LIKE = /^([A-Za-z0-9_]*)\.([A-Za-z0-9_]*)\/(.*)/
  * @property {string} [syntax] - The syntax of the code. If not specified, it will be inferred by fileType.
  * @property {string} [header] - The header comment to add to the code snippet. Useful for pointing to relative source directory or adding live doc links.
  * @property {string} [lines] - A range of lines of code to include from the file. The line range should be defined like "lines=22-44".
+ * @property {boolean} [trimDeadCode] - Remove multi-line comments that start with `//` from the code.
  * @example
    ```md
    <!-- doc-gen CODE src="./relative/path/to/code.js" -->
@@ -163,6 +164,10 @@ module.exports = async function CODE(api) {
     header = `\n${options.header}`
   }
 
+  if (options.trimDeadCode) {
+    code = stripOutMultiLineDoubleDashComments(code)
+  }
+
   return `\`\`\`${syntax}${header}
 ${code}
 \`\`\``

package/lib/utils/syntax.js

@@ -1,7 +1,6 @@
 const html = {
   tags: [
-    '<!--', 
-    '-->'
+    '<!--', '-->'
   ],
   pattern: [
     '<!-{2,}', 
@@ -13,7 +12,9 @@ const html = {
 
 // JS https://regex101.com/r/XKHU18/5
 const js = {
-  tags: ['/*', '*/'],
+  tags: [
+    '/*', '*/'
+  ],
   pattern: [
     '\/\\*+',
     // Old ^ '\/\\*{1,}[\n\\*]*',     // '\/\\*+', '\/\*[\*\n\s\t]+', // 
@@ -27,8 +28,7 @@ const js = {
 
 const jsx = {
   tags: [
-    '{/*', 
-    '*/}'
+    '{/*', '*/}'
   ],
   pattern: [
     '\{\/\\*+',
@@ -46,7 +46,7 @@ const yaml = {
   singleLinePattern: '#+',
   singleLine: '#.*$',
   content: '[ \\t\\S]*?',
-  converter: (str) => {
+  converter: (str = '') => {
     return str.split('\n').map((line) => {
       return line[0] === '#' ? line : `#${line}`
     }).join()

package/lib/utils/text.js

@@ -191,8 +191,21 @@ function stripComments(str, syntax = 'md') {
   return str.replace(/\s?[ \t]*\/\*[\s\S]*?\*\/|\s?[ \t]*\/\/.*$|\/\*{1,}[\n\*]*(\s?[\s\S]*?)?\*+\//gm, '')
 }
 
+
+// https://regex101.com/r/nCnt2J/1
+function stripOutMultiLineDoubleDashComments(str = '') {
+  return str.replace(/(?:\n\s*\/\/.*){2,}/g, '')
+}
+
+// https://regex101.com/r/plpXmr/1
+function stripOutMultilineJsComments(str = '') {
+  return str.replace(/\/\*[\s\S]+?\*\/\s*\n?/g, (match) => {
+    return match.trim().includes('\n') ? '' : match
+  })
+}
+
 // @TODO export as util to import into CODE
-function stripAllComments(block) {
+function stripAllHTMLComments(block) {
   // ([^\s]*)?([ \t]*)?(\/\*{1,}[\n\*]*(\s?[\s\S]*?)?\*\/)([^\s<]*)?(\n{1,2})?
   // https://regex101.com/r/WSioZ7/1
   const pattern = new RegExp(`([^\\s]*)?([ \\t]*)?(<!-{2,}(\\s?[\\s\\S]*?)?-{2,}>)([^\\s<]*)?(\n{1,2})?`, 'gi')
@@ -328,6 +341,7 @@ module.exports = {
   dedentString,
   stripComments,
   convertCommentSyntax,
+  stripOutMultiLineDoubleDashComments,
   // stripCommentBlockJS,
   trimString,
   // future https://github.com/junfengliang/autowrap

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markdown-magic",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Automatically update markdown files with content from external sources",
   "main": "lib/index.js",
   "bin": {