@vanillaes/esmtk 0.6.3

package/.vscode/launch.json

@@ -0,0 +1,44 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "CopyFileToFile",
+            "type": "node",
+            "request": "launch",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}/bin/esmtk.js",
+            "cwd": "${workspaceFolder}",
+            "args": ["cp", "./test/cp/test1.txt", "./test/cp2/test1.txt"],
+            "console": "integratedTerminal",
+        },
+        {
+            "name": "CopyFileToFolder",
+            "type": "node",
+            "request": "launch",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}/bin/esmtk.js",
+            "cwd": "${workspaceFolder}",
+            "args": ["cp", "./test/cp/test1.txt", "./test/cp2"],
+            "console": "integratedTerminal",
+        },
+        {
+            "name": "CopyFolderRecursively",
+            "type": "node",
+            "request": "launch",
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "program": "${workspaceFolder}/bin/esmtk.js",
+            "cwd": "${workspaceFolder}",
+            "args": ["cp", "-r", "./test/cp/", "./test/cp2"],
+            "console": "integratedTerminal",
+        }
+    ]
+}

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright 2020 Evan Plaice
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,96 @@
+<h1 align="center">ES Module Toolkit</h1>
+
+ESMTK, essential tools and libs for ES module development
+
+<div align="center">
+  <a href="https://github.com/vanillaes/esmtk/releases"><img src="https://badgen.net/github/tag/vanillaes/esmtk" alt="GitHub Release"></a>
+  <a href="https://www.npmjs.com/package/esmtk"><img src="https://badgen.net/npm/v/esmtk" alt="NPM Releases"></a>
+  <a href="https://github.com/vanillaes/esmtk/actions"><img src="https://github.com/vanillaes/esmtk/workflows/Latest/badge.svg" alt="Latest Status"></a>
+  <a href="https://github.com/vanillaes/esmtk/actions"><img src="https://github.com/vanillaes/esmtk/workflows/Release/badge.svg" alt="Release Status"></a>
+</div>
+
+## Lint
+
+Lint uses StandardJS to lint the source
+
+### Arguments
+
+`esmtk lint [--fix]`
+
+- `--fix` - automatically fix problems
+
+### Usage
+
+```sh
+esmtk lint
+```
+
+## Bundle
+
+Bundle uses ESBuild to compile an ES module (and its deps) into a bundle
+
+### Arguments
+
+`esmtk bundle [input] [output]`
+
+- `[input]` - the input source file path
+- `[output]` - the output bundle file path
+
+### Usage
+
+```sh
+esmtk bundle src/sample.js bundle.js
+```
+
+## Minify
+
+Minify uses ESBuild to compile an ES module (and its deps) into a minified bundle
+
+### Arguments
+
+`esmtk minify [input] [output]`
+
+- `[input]` - the input source file path
+- `[output]` - the output bundle file path
+
+### Usage
+
+```sh
+esmtk minify src/sample.js bundle.min.js
+```
+
+## CommonJS
+
+CommonJS uses ESBuild to compile an ES module (and its deps) into a CommonJS bundle
+
+### Arguments
+
+`esmtk commonjs [input] [output]`
+
+- `[input]` - the input source file path
+- `[output]` - the output bundle file path
+
+### Usage
+
+```sh
+esmtk commonjs src/sample.js bundle.cjs
+```
+
+## Copy
+
+Copy us a cross-platform clone of the `cp` command in Linux
+
+### Arguments
+
+`esmtk cp -rf [source] [destination]`
+
+- `[source]` - the source file/glob
+- `[destination]` - the destination file/directory
+- `-r, --recursive` - copy files/directories recursively
+- `-f --force` - force overwrite existing files
+
+### Usage
+
+```sh
+esmtk cp src/* dest/
+```

package/bin/commands/bundle.js

@@ -0,0 +1,13 @@
+import { spawn } from 'child_process'
+import { join } from 'path'
+
+const BIN_PATH = join(process.cwd(), 'node_modules', '.bin', 'esbuild')
+
+export async function bundle (input, output) {
+  spawn(BIN_PATH, ['--format=esm', '--bundle', input, `--outfile=${output}`], {
+    cwd: process.cwd(),
+    stdio: ['pipe', process.stdout, process.stderr]
+  }).on('error', err => {
+    console.error(err)
+  })
+}

package/bin/commands/commonjs.js

@@ -0,0 +1,13 @@
+import { spawn } from 'child_process'
+import { join } from 'path'
+
+const BIN_PATH = join(process.cwd(), 'node_modules', '.bin', 'esbuild')
+
+export async function commonjs (input, output) {
+  spawn(BIN_PATH, ['--format=cjs', '--bundle', input, `--outfile=${output}`], {
+    cwd: process.cwd(),
+    stdio: ['pipe', process.stdout, process.stderr]
+  }).on('error', err => {
+    console.error(err)
+  })
+}

package/bin/commands/cp.js

@@ -0,0 +1,97 @@
+import { basename, dirname } from 'node:path'
+import { access, constants, cp as nodeCp, stat } from 'node:fs/promises'
+
+export async function cp (source, target, options) {
+  if (!options.recursive) {
+    await copyAsync(source, target, options.force)
+  }
+
+  if (options.recursive) {
+    await copyRecursiveAsync(source, target, options.force)
+  }
+}
+
+// copy a single file
+async function copyAsync (source, target, force = false) {
+  const sExists = await fileExists(source)
+  if (!sExists) {
+    console.error(`cp: source ${source} does not exist`)
+    process.exit(1)
+  }
+  const sStats = await stat(source)
+  if (sStats.isSymbolicLink()) {
+    console.error(`cp: source ${source} is a sybolic link`)
+    process.exit(1)
+  }
+
+  const tDir = dirname(target)
+  const tDirExists = await fileExists(tDir)
+  if (!tDirExists) {
+    console.error(`cp: target directory ${tDir} does not exist`)
+    process.exit(1)
+  }
+
+  const tExists = await fileExists(target)
+  if (tExists) {
+    const tStats = await stat(target)
+    if (tStats.isSymbolicLink()) {
+      console.error(`cp: target ${target} is a sybolic link`)
+      process.exit(1)
+    }
+    if (tStats.isDirectory()) {
+      const sourceFile = basename(source)
+      target = target.endsWith('/') ? target.slice(0, -1) : target
+      target = `${target}/${sourceFile}`
+    }
+  }
+
+  try {
+    await nodeCp(source, target, { force })
+  } catch (err) {
+    console.error(`cp: error ${err.message}`)
+  }
+}
+
+// copy a directory recursively
+async function copyRecursiveAsync (source, target, force = false) {
+  const sExists = await fileExists(source)
+  if (!sExists) {
+    console.error(`cp: source ${source} does not exist`)
+    process.exit(1)
+  }
+  const sStats = await stat(source)
+  if (sStats.isSymbolicLink()) {
+    console.error(`cp: source ${source} is a sybolic link`)
+    process.exit(1)
+  }
+
+  const tExists = await fileExists(target)
+  if (!tExists) {
+    console.error(`cp: target directory ${target} does not exist`)
+    process.exit(1)
+  }
+  const tStats = await stat(target)
+  if (tStats.isSymbolicLink()) {
+    console.error(`cp: target ${target} is a sybolic link`)
+    process.exit(1)
+  }
+  if (!tStats.isDirectory()) {
+    console.error(`cp: target ${target} is not a directory`)
+    process.exit(1)
+  }
+
+  try {
+    await nodeCp(source, target, { force, recursive: true })
+  } catch (err) {
+    console.error(`cp": error ${err.message}`)
+  }
+}
+
+async function fileExists (file) {
+  try {
+    await access(file, constants.F_OK)
+    return true
+  } catch (error) {
+    return false
+  }
+}

package/bin/commands/index.js

@@ -0,0 +1,5 @@
+export { bundle } from './bundle.js'
+export { commonjs } from './commonjs.js'
+export { cp } from './cp.js'
+export { lint } from './lint.js'
+export { minify } from './minify.js'

package/bin/commands/lint.js

@@ -0,0 +1,13 @@
+import { spawn } from 'child_process'
+import { join } from 'path'
+
+const BIN_PATH = join(process.cwd(), 'node_modules', '.bin', 'standard')
+
+export async function lint (flags) {
+  spawn(BIN_PATH, flags, {
+    cwd: process.cwd(),
+    stdio: ['pipe', process.stdout, process.stderr]
+  }).on('error', err => {
+    console.error(err)
+  })
+}

package/bin/commands/minify.js

@@ -0,0 +1,13 @@
+import { spawn } from 'child_process'
+import { join } from 'path'
+
+const BIN_PATH = join(process.cwd(), 'node_modules', '.bin', 'esbuild')
+
+export async function minify (input, output) {
+  spawn(BIN_PATH, ['--format=esm', '--minify', '--bundle', input, `--outfile=${output}`], {
+    cwd: process.cwd(),
+    stdio: ['pipe', process.stdout, process.stderr]
+  }).on('error', err => {
+    console.error(err)
+  })
+}

package/bin/esmtk.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import { bundle, cp, commonjs, lint, minify } from './commands/index.js'
+import { Command } from 'commander'
+import { createRequire } from 'module'
+const program = new Command()
+const require = createRequire(import.meta.url)
+const pkg = require('../package.json')
+
+program.version(pkg.version, '-v, --version')
+
+program.command('lint')
+  .description('Lint the source using StandardJS')
+  .option('--fix', 'Automatically fix problems')
+  .action(options => {
+    const flags = options.fix ? ['--fix'] : []
+    lint(flags)
+  })
+
+program.command('bundle <input> <output>')
+  .description('Bundle the source using ESBuild')
+  .action((input, output) => {
+    bundle(input, output)
+  })
+
+program.command('commonjs <input> <output>')
+  .description('Transpile the source to CommonJS using ESBuild')
+  .action((input, output) => {
+    commonjs(input, output)
+  })
+
+program.command('minify <input> <output>')
+  .description('Minify the source using ESBuild')
+  .action((input, output) => {
+    minify(input, output)
+  })
+
+program.command('cp <source> <target>')
+  .usage('[-rf] source target')
+  .description('Copy files from the source to the target')
+  .option('-f, --force', 'do not prompt before overwriting')
+  .option('-r, --recursive', 'copy directories recursively')
+  .action((source, target, options) => {
+    cp(source, target, options)
+  })
+
+program.parse(process.argv)

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@vanillaes/esmtk",
+  "version": "0.6.3",
+  "description": "ES Module Toolkit",
+  "keywords": [
+    "esm",
+    "esmodules",
+    "nodejs",
+    "cli",
+    "developer-tools"
+  ],
+  "repository": "https://github.com/vanillaes/esmtk",
+  "author": "Evan Plaice <evanplaice@gmail.com> (https://evanplaice.com/)",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "esmtk": "bin/esmtk.js"
+  },
+  "scripts": {
+    "lint": "./bin/esmtk.js lint",
+    "preversion": "npm run lint",
+    "postversion": "git push --follow-tags"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "esbuild": "^0.13.13",
+    "glob": "^13.0.6",
+    "standard": "^17.1.2"
+  },
+  "engines": {
+    "node": ">=17"
+  }
+}