Upgrade library to use ESM and UMD

.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [10, 12, 14]
+        node-version: [16, 18, 20]
     steps:
       - uses: actions/checkout@v2
         with:

.gitignore

@@ -1 +1,7 @@
-node_modules
+node_modules
+index*.js
+index.d.ts
+*.mjs
+*.map
+.vscode
+index.html

README.md

@@ -9,9 +9,9 @@
 
 Useful for splitting a command to use with NodeJS' [child process](https://nodejs.org/api/child_process.html) methods, like [spawn](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options), [exec](https://nodejs.org/api/child_process.html#child_process_child_process_exec_command_options_callback), and [execFile](https://nodejs.org/api/child_process.html#child_process_child_process_execfile_file_args_options_callback), as well with libs like [execa](https://github.com/sindresorhus/execa).
 
-* No external dependencies.
-* Unit-tested.
+⚡ Just 0.4 KB uncompressed, no external dependencies.
 
+🎯 Version `1.1`+ works with NodeJS, DenoJS and browsers. JavaScript and TypeScript.
 
 ## Installation
 
@@ -24,25 +24,29 @@ npm i split-cmd
 ### Splitting into an array
 
 ```js
-var split = require( 'split-cmd' ).split;
-var arr = split( 'git commit -m "some message with spaces"' );
+import { split } from 'split-cmd';
+
+const arr = split( 'git commit -m "some message with spaces"' );
+
 console.log( arr ); // [ "git", "commit", "-m", "some message with spaces" ]
 ```
 
 ### Splitting into an object
 
 ```js
-var splitToObject = require( 'split-cmd' ).splitToObject;
-var obj = splitToObject( 'git commit -m "some message with spaces"' );
+import { splitToObject } from 'split-cmd';
+
+const obj = splitToObject( 'git commit -m "some message with spaces"' );
+
 console.log( obj.command ); // git
 console.log( obj.args ); // [ "commit", "-m", "some message with spaces" ]
 ```
 
 ### Using it with execa
 
 ```js
-const { splitToObject } = require( 'split-cmd' );
-const execa = require( 'execa' );
+import { splitToObject } from 'split-cmd';
+import { execa } from 'execa';
 
 // Executing a single command
 const obj = splitToObject( 'echo "I see unicorns"' );
@@ -82,7 +86,7 @@ split( command: string ): string[]
  * @param {string} command Command to split.
  * @returns {object}
  */
-splitToObject( command: string ): object
+splitToObject( command: string ): { command?: string, args?: string[] }
 ```
 
 ## License

__tests__/test.js → __tests__/test.spec.js

@@ -1,6 +1,4 @@
-// Run these tests with Jest
-
-var lib = require( '..' );
+const lib = require( '..' );
 
 describe( 'split-cmd', function () {
 
@@ -122,4 +120,4 @@ describe( 'split-cmd', function () {
 
   } );
 
-} );
+} );

index.ts

@@ -0,0 +1,54 @@
+/**
+ * Split a command into an array.
+ *
+ * @example
+ * ```js
+ * const arr = split( 'git commit -m "some message with spaces"' );
+ * console.log( arr ); // [ "git", "commit", "-m", "some message with spaces" ]
+ * ```
+ *
+ * @param {string} command Command to split.
+ * @returns {Array}
+ */
+export function split( command: string ): string[] {
+
+    if ( typeof command !== 'string' ) {
+        throw new Error( 'Command must be a string' );
+    }
+
+    const r = command.match( /[^"\s]+|"(?:\\"|[^"])*"/g );
+    if ( ! r ) {
+        return [];
+    }
+
+    return r.map( function ( expr ) {
+        const isQuoted = expr.charAt( 0 ) === '"' && expr.charAt( expr.length - 1 ) === '"';
+        return isQuoted ? expr.slice( 1, -1 ) : expr;
+    } );
+}
+
+/**
+ * Split a command into an object with the attributes `command` and `args`.
+ *
+ * @example
+ * ```js
+ * const obj = splitToObject( 'git commit -m "some message with spaces"' );
+ * console.log( obj.command ); // git
+ * console.log( obj.args ); // [ "commit", "-m", "some message with spaces" ]
+ * ```
+ *
+ * @param {string} command Command to split.
+ * @returns {object}
+ */
+export function splitToObject( command: string ): { command?: string, args?: string[] } {
+    const cmds = split( command );
+    switch( cmds.length ) {
+        case 0: return {};
+        case 1: return { command: cmds[ 0 ] };
+        default: {
+            const first = cmds[ 0 ];
+            cmds.shift();
+            return { command: first, args: cmds };
+        }
+    }
+}