@vanillaes/jsdown 0.1.2 → 0.1.3

package/README.md

@@ -37,7 +37,7 @@ jsdown
 
 ```sh
 # generate documentation (matching a different file(s))
-lint-es '**/!(*.spec|index).cjs'
+jsdown '**/!(*.spec|index).cjs'
 ```
 
 *Note: In Linux/OSX, matcher patterns must be delimited in quotes.*

package/bin/jsdown.js

@@ -1,16 +1,22 @@
 #!/usr/bin/env node
 import { createDocs } from '../src/index.js'
 import { Command } from 'commander'
-import { readPackageJSON } from '@vanillaes/esmtk'
+import { Package } from '@vanillaes/esmtk'
 
-const pkg = await readPackageJSON()
+const pkg = new Package()
 const program = new Command()
   .name('jsdown')
-  .description('Markdown Doc Generator for JSDoc')
   .version(pkg.version, '-v, --version')
+  .usage(`jsdown [...options] [files...]
+    If [files...] is omitted, all JavaScript source files (**/*.js)
+    in the current working directory are converted, recursively.
 
-program
-  .description('Generate markdown documentation from JSDoc types')
+    Certain paths (node_modules/, coverage/, vendor/, *.min.js, *.spec.js,
+    hidden files) are automatically ignored.
+
+    Paths in a project's .gitignore file are also automatically ignored.
+  `)
+  .description('Markdown Documentation Generator for JSDoc')
   .argument('[files]', 'file(s) to document', '**/!(index).js')
   .action((files, options) => {
     createDocs(files, options)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillaes/jsdown",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Markdown Documentation Generator for JSDoc",
   "keywords": [
     "ecmascript",
@@ -32,7 +32,7 @@
     "postversion": "git push --follow-tags"
   },
   "dependencies": {
-    "@vanillaes/esmtk": "^1.8.2",
+    "@vanillaes/esmtk": "^2.0.0",
     "commander": "^14.0.3",
     "doctrine": "^3.0.0",
     "lodash-es": "^4.18.1"

package/src/jsdown.js

@@ -1,5 +1,5 @@
 import { docdown } from './index.js'
-import { fileExists, match } from '@vanillaes/esmtk'
+import { exists, readGitIgnore, match } from '@vanillaes/esmtk'
 import { mkdir, writeFile } from 'node:fs/promises'
 import { basename, dirname, join } from 'node:path'
 
@@ -10,7 +10,11 @@ import { basename, dirname, join } from 'node:path'
  */
 export async function createDocs (files, options = {}) {
   const defaultIgnores = ['node_modules/', 'coverage/', 'vendor/', '**/*.spec.js', '**/*.min.js', '.*']
-  const ignore = [...defaultIgnores].join(',')
+  const gitIgnores = await readGitIgnore(process.cwd())
+  let ignores = [...defaultIgnores, ...gitIgnores]
+  // de-duplicate
+  ignores = [...new Set(ignores)]
+  const ignore = ignores.join(',')
   const sources = await match(files, process.cwd(), ignore)
   sources.forEach(file => createDoc(file))
 }
@@ -30,8 +34,8 @@ async function createDoc (path) {
   const srcPath = join(process.cwd(), 'src') // TODO: make this configurable?
   const docPath = join(process.cwd(), 'docs') // TODO: make this configurable?
 
-  const exists = await !fileExists(docPath)
-  if (!exists) {
+  const dirExists = await exists(docPath)
+  if (!dirExists) {
     await mkdir(docPath, { recursive: true })
   }