markdown-magic 3.7.0 → 4.0.1

package/src/utils/fs.js

@@ -9,10 +9,21 @@ const { readdir, stat, readFile } = fs
 
 const IS_HIDDEN_FILE = /(^|[\\\/])\.[^\\\/\.]/g
 
+/**
+ * Check if value is a RegExp
+ * @param {any} thing - Value to check
+ * @returns {boolean} True if value is RegExp
+ */
 function isRegex(thing) {
   return (thing instanceof RegExp)
 }
 
+/**
+ * Write file with directory creation if needed
+ * @param {string} filePath - File path to write to
+ * @param {string} content - Content to write
+ * @returns {Promise<void>}
+ */
 async function writeFile(filePath, content) {
   try {
     await fs.writeFile(filePath, content)
@@ -69,6 +80,12 @@ async function escalade(start, callback) {
 
 // }
 
+/**
+ * Convert absolute path to relative path
+ * @param {string} file - Absolute file path
+ * @param {string} cwd - Current working directory
+ * @returns {string} Relative path
+ */
 function convertToRelativePath(file, cwd) {
   return file.replace(cwd, '').replace(/^\//, '')
 }
@@ -165,6 +182,11 @@ function depth(string) {
   return path.normalize(string).split(path.sep).length - 1;
 }
 
+/**
+ * Check if path is local (not remote)
+ * @param {string} filePath - File path to check
+ * @returns {boolean} True if path is local
+ */
 function isLocalPath(filePath) {
   if (filePath.startsWith('github.com/') || filePath.startsWith('raw.githubusercontent.com/')) return false
   return _isLocalPath(filePath)

package/src/utils/fs.test.js

@@ -26,8 +26,8 @@ test('Finds file from dir', async () => {
 })
 
 test('getGitignoreContents', async () => {
-  const files = await getGitignoreContents()
-  /*
+  const files = await getGitignoreContents(path.resolve(__dirname, '../../', '.gitignore'))
+  //*
   console.log('files', files)
   /** */
   assert.is(Array.isArray(files), true)

package/src/utils/index.js

@@ -1,12 +1,33 @@
 
+/**
+ * Filter function to get only unique values
+ * @param {any} value - Current value
+ * @param {number} index - Current index
+ * @param {any[]} self - Original array
+ * @returns {boolean} True if value is unique
+ */
 function onlyUnique(value, index, self) {
   return self.indexOf(value) === index
 }
 
+/**
+ * Get code location string in format path:line:column
+ * @param {string} srcPath - Source file path
+ * @param {string|number} line - Line number
+ * @param {string} [column='0'] - Column number
+ * @returns {string} Location string
+ */
 function getCodeLocation(srcPath, line, column = '0') {
   return `${srcPath}:${line}:${column}`
 }
 
+/**
+ * Pluralize word based on count
+ * @param {any[]|number} thing - Array or number to count
+ * @param {string} [single=''] - Singular form
+ * @param {string} [plural=''] - Plural form
+ * @returns {string} Singular or plural form
+ */
 function pluralize(thing, single = '', plural = '') {
   const count = Array.isArray(thing) ? thing.length : Number(thing)
   return count === 1 ? single : plural

package/src/utils/regex-timeout.js

@@ -1,7 +1,7 @@
 // https://stackoverflow.com/questions/38859506/cancel-regex-match-if-timeout
 const util = require('util')
 const vm = require('vm')
-const { getBlockRegex } = require('../block-parser')
+const { getBlockRegex } = require('comment-block-parser')
 const { getSyntaxInfo } = require('./syntax')
 
 const goodString = `

package/src/utils/text.js

@@ -1,13 +1,29 @@
 const { syntaxMap } = require('./syntax')
 
+/**
+ * Split string into lines
+ * @param {string} str - Input string
+ * @returns {string[]} Array of lines
+ */
 function getLines(str = '') {
   return str.split(/\r\n|\r|\n/)
 }
 
+/**
+ * Get line count from string
+ * @param {string} str - Input string
+ * @returns {number} Number of lines
+ */
 function getLineCount(str = '') {
   return getLines(str).length
 }
 
+/**
+ * Get row and column position from character index
+ * @param {string} input - Input string
+ * @param {number} indexToFind - Character index to find
+ * @returns {{row: number, col: number}} Row and column position
+ */
 function getRowAndColumnFromCharPos(input, indexToFind) {
   const preChunk = input.substr(0, indexToFind);
   const row = preChunk.split('\n').length - 1
@@ -16,23 +32,50 @@ function getRowAndColumnFromCharPos(input, indexToFind) {
   return { row, col }
 };
 
+/**
+ * Get word count from string
+ * @param {string} str - Input string
+ * @returns {number} Word count
+ */
 function getWordCount(str = '') {
   return str.trim().split(/\s+/).length
 }
 
+/**
+ * Get first character from string
+ * @param {string} str - Input string
+ * @returns {string} First character
+ */
 function getFirstCharacter(str) {
   return str.charAt(0)
 }
 
+/**
+ * Get last character from string
+ * @param {string} str - Input string
+ * @returns {string} Last character
+ */
 function getLastCharacter(str) {
   return str.substr(-1)
 }
 
+/**
+ * Get leading spaces from text
+ * @param {string} text - Input text
+ * @returns {string} Leading spaces
+ */
 function getLeadingSpaces(text) {
   const matches = text.match(/^\s*/)
   return (matches && matches[0]) ? matches[0] : ''
 }
 
+/**
+ * Get text between character positions
+ * @param {string} text - Input text
+ * @param {number} start - Start position
+ * @param {number} end - End position
+ * @returns {string} Text between positions
+ */
 function getTextBetweenChars(text, start, end) {
   return text.slice(start, end)
 }
@@ -56,6 +99,14 @@ function getTextBetweenWords(s, prefix, suffix) {
   return s
 }
 
+/**
+ * Replace text between character positions
+ * @param {string} str - Input string
+ * @param {number} start - Start position
+ * @param {number} end - End position
+ * @param {string} newStr - Replacement string
+ * @returns {string} Modified string
+ */
 function replaceTextBetweenChars(str = '', start, end, newStr) {
   return str.substring(0, start) + newStr + str.substring(end)
 }
@@ -77,22 +128,39 @@ function getTextBetweenLines(content, startLine, endLine) {
   if (startDefined && !endDefined) {
     return lines.slice(startLine - 1, startLine).join('')
   }
-  if (startLine && endLine && parseInt(startLine, 10) <= parseInt(endLine, 10)) {
+  // @ts-ignore
+  if (startLine && endLine && Number(startLine) <= Number(endLine)) {
     return lines.slice(startLine - 1, endLine).join('\n')
   }
 }
 
+/**
+ * Check if string is uppercase
+ * @param {string} str - Input string
+ * @returns {boolean} True if uppercase
+ */
 function isUpperCase(str) {
   return str === str.toUpperCase()
 }
 
 // https://github.com/jamiebuilds/min-indent/blob/master/index.js
+/**
+ * Find minimum indentation in string
+ * @param {string} string - Input string
+ * @returns {number} Minimum indentation level
+ */
 function findMinIndent(string) {
 	const match = string.match(/^[ \t]*(?=\S)/gm)
 	if (!match) return 0
 	return match.reduce((r, a) => Math.min(r, a.length), Infinity)
 }
 
+/**
+ * Strip indentation from string
+ * @param {string} string - Input string
+ * @param {number} [indentation] - Indentation level to strip
+ * @returns {string} String with indentation stripped
+ */
 function stripIndent(string, indentation) {
   const indent = typeof indentation !== 'undefined' ? indentation : findMinIndent(string);
 	if (indent === 0) {
@@ -105,7 +173,7 @@ function stripIndent(string, indentation) {
 /**
  * Trim leading & trailing spaces/line breaks in code and keeps the indentation of the first non-empty line
  * @param {string|number} str 
- * @returns string
+ * @returns {string}
  */
  function trimString(str = '') {
   let content = (typeof str === 'number') ? str.toString() : str
@@ -113,6 +181,15 @@ function stripIndent(string, indentation) {
   return content.replace(/^(?:[\t ]*(?:\r?\n|\r))+|\s+$/g, '')
 }
 
+/**
+ * Add indentation to string
+ * @param {string} string - Input string
+ * @param {number} [count=1] - Number of indentations to add
+ * @param {object} [options={}] - Options for indentation
+ * @param {string} [options.indent=' '] - Character(s) to use for indentation
+ * @param {boolean} [options.includeEmptyLines=false] - Whether to indent empty lines
+ * @returns {string} Indented string
+ */
 function indentString(string, count = 1, options = {}) {
 	const {
 		indent = ' ',
@@ -130,8 +207,8 @@ function indentString(string, count = 1, options = {}) {
 /**
  * Removes the indentation of multiline strings
  * @link https://github.com/victornpb/tiny-dedent/
- * @param  {string} str A template literal string
- * @return {string} A string without the indentation
+ * @param {string} str - A template literal string
+ * @returns {string} A string without the indentation
  */
 function dedentString(str) {
   str = str.replace(/^[ \t]*\r?\n/, ''); // remove leading blank line
@@ -180,7 +257,7 @@ function stripCommentBlockOld(str, syntax = 'md') {
 /**
  * Strip out comment blocks
  * @param {string} str 
- * @param {typeof import('../types')['syntaxType']} syntax 
+ * @param {import('../types').SyntaxType} syntax 
  * @returns {string} clean comment-less string
  */
 function stripComments(str, syntax = 'md') {
@@ -298,33 +375,48 @@ function convertCommentSyntax(str, { from, to }) {
 }
 
 /**
- * capitalize first letter
- * @param {string} str 
- * @returns 
+ * Capitalize first letter
+ * @param {string} str - Input string
+ * @returns {string} String with first letter capitalized
  */
 function capitalizeFirstLetter(str) {
   return capitalize(str.charAt(0)) + str.slice(1)
 }
 
 /**
- * capitalize string
- * @param {string} str 
- * @returns 
+ * Capitalize string
+ * @param {string} str - Input string
+ * @returns {string} Capitalized string
  */
 function capitalize(str = '') {
   return str.toUpperCase()
 }
 
+/**
+ * Convert string to camelCase
+ * @param {string} str - Input string
+ * @returns {string} camelCase string
+ */
 function camelCase(str = '') {
   return str.replace(/[-_ ](\w)/g, (_, c) => c.toUpperCase())
 }
 
+/**
+ * Convert string to kebab-case
+ * @param {string} str - Input string
+ * @returns {string} kebab-case string
+ */
 function kebabCase(str = '') {
   return str.replace(/\B([A-Z])/g, '-$1').toLowerCase()
 }
 
 const smallWords = /^(a|an|and|as|at|but|by|en|for|if|in|nor|of|on|or|per|the|to|vs?\.?|via)$/i;
 
+/**
+ * Convert string to Title Case
+ * @param {string} str - Input string
+ * @returns {string} Title Case string
+ */
 function toTitleCase(str = '') {
 	return str.replace(/[A-Za-z0-9\u00C0-\u00FF]+[^\s-]*/g, (match, index, title) => {
 		if (index > 0

package/types/_tests/config.d.ts

@@ -0,0 +1,4 @@
+export const FIXTURE_DIR: string;
+export const MARKDOWN_FIXTURE_DIR: string;
+export const OUTPUT_DIR: string;
+//# sourceMappingURL=config.d.ts.map

package/types/_tests/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../_tests/config.js"],"names":[],"mappings":"AACA,iCAAoD;AACpD,0CAAyD;AACzD,gCAAmD"}

package/types/_tests/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/types/_tests/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../_tests/errors.test.js"],"names":[],"mappings":""}

package/types/_tests/fixtures/js/simple.d.ts

@@ -0,0 +1,8 @@
+/**
+ * comment inside
+ */
+/****************
+ comment inside
+******************/
+declare var x: string;
+//# sourceMappingURL=simple.d.ts.map

package/types/_tests/fixtures/js/simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.d.ts","sourceRoot":"","sources":["../../../../_tests/fixtures/js/simple.js"],"names":[],"mappings":"AAqBA;;GAEG;AAIH;;mBAEmB;AAGnB,sBAAa"}

package/types/_tests/fixtures/local-code-file-lines.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=local-code-file-lines.d.ts.map

package/types/_tests/fixtures/local-code-file-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-code-file-lines.d.ts","sourceRoot":"","sources":["../../../_tests/fixtures/local-code-file-lines.js"],"names":[],"mappings":""}

package/types/_tests/fixtures/local-code-file.d.ts

@@ -0,0 +1,2 @@
+export function run(): void;
+//# sourceMappingURL=local-code-file.d.ts.map

package/types/_tests/fixtures/local-code-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-code-file.d.ts","sourceRoot":"","sources":["../../../_tests/fixtures/local-code-file.js"],"names":[],"mappings":"AAYqB,4BAGpB"}

package/types/_tests/fixtures/local-code-id.d.ts

@@ -0,0 +1,3 @@
+declare function _exports(filePath: any, config: any): Promise<void>;
+export = _exports;
+//# sourceMappingURL=local-code-id.d.ts.map

package/types/_tests/fixtures/local-code-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-code-id.d.ts","sourceRoot":"","sources":["../../../_tests/fixtures/local-code-id.js"],"names":[],"mappings":"AAUiB,qEAyBhB"}

package/types/_tests/transforms-toc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transforms-toc.test.d.ts.map

package/types/_tests/transforms-toc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms-toc.test.d.ts","sourceRoot":"","sources":["../../_tests/transforms-toc.test.js"],"names":[],"mappings":""}

package/types/_tests/transforms.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transforms.test.d.ts.map

package/types/_tests/transforms.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.test.d.ts","sourceRoot":"","sources":["../../_tests/transforms.test.js"],"names":[],"mappings":""}

package/types/_tests/utils/diff.d.ts

@@ -0,0 +1,3 @@
+declare function _exports(actual: any, expected: any): any;
+export = _exports;
+//# sourceMappingURL=diff.d.ts.map

package/types/_tests/utils/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../_tests/utils/diff.js"],"names":[],"mappings":"AA8HiB,2DAShB"}

package/types/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.js"],"names":[],"mappings":""}

package/types/src/argparse/argparse.d.ts

@@ -0,0 +1,33 @@
+export function uxParse(_rawArgv?: any[], opts?: {}): {
+    leadingCommands: string[];
+    extraParse: {};
+    mriOptionsOriginal: mri.Argv<{
+        [x: string]: any;
+    }>;
+    globGroups: any[];
+    rawArgv?: undefined;
+    mriOptionsClean?: undefined;
+    mriDiff?: undefined;
+    yargsParsed?: undefined;
+    mergedOptions?: undefined;
+} | {
+    rawArgv: string;
+    leadingCommands: string[];
+    globGroups: any[];
+    extraParse: {};
+    mriOptionsOriginal: mri.Argv<{
+        [x: string]: any;
+    }>;
+    mriOptionsClean: {
+        [x: string]: any;
+    } & {
+        _: string[];
+    };
+    mriDiff: boolean;
+    yargsParsed: string;
+    mergedOptions: {
+        _: string[];
+    };
+};
+import mri = require("mri");
+//# sourceMappingURL=argparse.d.ts.map

package/types/src/argparse/argparse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argparse.d.ts","sourceRoot":"","sources":["../../../src/argparse/argparse.js"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2QC"}

package/types/src/argparse/argparse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=argparse.test.d.ts.map

package/types/src/argparse/argparse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argparse.test.d.ts","sourceRoot":"","sources":["../../../src/argparse/argparse.test.js"],"names":[],"mappings":""}

package/types/src/argparse/index.d.ts

@@ -0,0 +1,3 @@
+export { uxParse };
+import { uxParse } from "./argparse";
+//# sourceMappingURL=index.d.ts.map

package/types/src/argparse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/argparse/index.js"],"names":[],"mappings":""}

package/types/src/argparse/splitOutsideQuotes.d.ts

@@ -0,0 +1,2 @@
+export function splitOutsideQuotes(str: any): any[];
+//# sourceMappingURL=splitOutsideQuotes.d.ts.map

package/types/src/argparse/splitOutsideQuotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitOutsideQuotes.d.ts","sourceRoot":"","sources":["../../../src/argparse/splitOutsideQuotes.js"],"names":[],"mappings":"AAEA,oDAuEC"}

package/types/src/argparse/splitOutsideQuotes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=splitOutsideQuotes.test.d.ts.map

package/types/src/argparse/splitOutsideQuotes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitOutsideQuotes.test.d.ts","sourceRoot":"","sources":["../../../src/argparse/splitOutsideQuotes.test.js"],"names":[],"mappings":""}

package/types/src/cli-run.d.ts

@@ -0,0 +1,4 @@
+import { getGlobGroupsFromArgs } from "./globparse";
+export function runCli(options: {}, rawArgv: any): Promise<import("./").MarkdownMagicResult>;
+export { getGlobGroupsFromArgs };
+//# sourceMappingURL=cli-run.d.ts.map

package/types/src/cli-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-run.d.ts","sourceRoot":"","sources":["../../src/cli-run.js"],"names":[],"mappings":";AAsBA,6FAoLC"}

package/types/src/cli-run.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli-run.test.d.ts.map

package/types/src/cli-run.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-run.test.d.ts","sourceRoot":"","sources":["../../src/cli-run.test.js"],"names":[],"mappings":""}

package/types/src/defaults.d.ts

@@ -0,0 +1,5 @@
+export const SYNTAX: "md";
+export const OPEN_WORD: "doc-gen";
+export const CLOSE_WORD: "end-doc-gen";
+export const DEFAULT_GLOB_PATTERN: "**/**.md";
+//# sourceMappingURL=defaults.d.ts.map

package/types/src/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.js"],"names":[],"mappings":"AACA,qBAAe,IAAI,CAAA;AACnB,wBAAkB,SAAS,CAAA;AAC3B,yBAAmB,aAAa,CAAA;AAChC,mCAA6B,UAAU,CAAA"}

package/types/src/globparse.d.ts

@@ -0,0 +1,18 @@
+export function getGlobGroupsFromArgs(args: any, opts?: {}): {
+    globGroups: {
+        key: any;
+        rawKey: any;
+        values: any;
+    }[];
+    otherOpts: any[];
+};
+export function isArrayLike(str: any): boolean;
+export function stringLooksLikeFile(value: any): boolean;
+export function getValue(val: any): any;
+export function trimLeadingDashes(value: any): any;
+export function removeNodeModules(value?: string): boolean;
+export function coerceStringToRegex(str: any): any;
+export function convertToArray(str?: string): any;
+export function addValue(value: any, currentCollection: any): any;
+export function customIsGlob(arg: any): any;
+//# sourceMappingURL=globparse.d.ts.map

package/types/src/globparse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globparse.d.ts","sourceRoot":"","sources":["../../src/globparse.js"],"names":[],"mappings":"AA6EA;;;;;;;EA8EC;AA5ID,+CAGC;AAED,yDAOC;AAED,wCAEC;AAED,mDAEC;AAED,2DAKC;AAED,mDAOC;AAED,kDAGC;AAED,kEASC;AAED,4CAMC"}

package/types/src/globparse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=globparse.test.d.ts.map

package/types/src/globparse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globparse.test.d.ts","sourceRoot":"","sources":["../../src/globparse.test.js"],"names":[],"mappings":""}