From b09e8282967500adb62b1eb86a13797c1dd1c5d4 Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Wed, 26 Oct 2022 09:50:12 -0400
Subject: [PATCH 1/6] Add README for package to convert ms to duration

---
 .../@stdlib/time/ms2duration/README.md        | 195 ++++++++++++++++++
 1 file changed, 195 insertions(+)
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/README.md

diff --git a/lib/node_modules/@stdlib/time/ms2duration/README.md b/lib/node_modules/@stdlib/time/ms2duration/README.md
new file mode 100644
index 000000000000..33a23bd9deab
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/README.md
@@ -0,0 +1,195 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2022 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# ms2duration
+
+> Convert a number of milliseconds to a string duration.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var ms2duration = require( '@stdlib/time/ms2duration' );
+```
+
+#### ms2duration( str )
+
+Converts a number of milliseconds to a string duration.
+
+```javascript
+var duration = ms2duration( 1030 );
+// returns '1s30ms'
+
+duration = ms2duration( 3600000 );
+// returns '1h'
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+## Notes
+
+-   A duration string is a string containing a sequence of time units. A time unit is a non-negative integer followed by a unit identifier. The following unit identifiers are supported:
+
+    -   `d`: days
+    -   `h`: hours
+    -   `m`: minutes
+    -   `s`: seconds
+    -   `ms`: milliseconds
+    
+    For example, the string `1m3s10ms` is a duration string containing three time units: `1m` (1 minute), `3s` (3 seconds), and `10ms` (10 milliseconds). The string `60m` is a duration string containing a single time unit: `60m` (60 minutes). A duration string must contain at least one time unit.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var ms2duration = require( '@stdlib/time/ms2duration' );
+
+var duration = ms2duration( 1030 );
+// returns '1s30ms'
+
+duration = ms2duration( 3600000 );
+// returns '1h'
+
+duration = ms2duration( 0 );
+// returns '0ms'
+
+duration = ms2duration( 86400000 );
+// returns '1d'
+
+duration = ms2duration( 86400000+3600000+60000+1000+100 );
+// returns '1d1h1m1s100ms'
+```
+
+</section>
+
+<!-- /.examples -->
+
+* * *
+
+<section class="cli">
+
+## CLI
+
+<section class="usage">
+
+### Usage
+
+```text
+Usage: ms2duration [options] [<string>]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- CLI usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+### Notes
+
+-   If the split separator is a [regular expression][mdn-regexp], ensure that the `split` option is either properly escaped or enclosed in quotes.
+
+    ```bash
+    # Not escaped...
+    $ echo -n $'3000\n25300' | ms2duration --split /\r?\n/
+
+    # Escaped...
+    $ echo -n $'3000\n25300' | ms2duration --split /\\r?\\n/
+    ```
+
+-   The implementation ignores trailing delimiters.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+### Examples
+
+```bash
+$ ms2duration 1000
+1s
+```
+
+To use as a [standard stream][standard-streams],
+
+```bash
+$ echo -n '1000\n2000' | ms2duration
+1s
+2s
+```
+
+By default, when used as a [standard stream][standard-streams], the implementation assumes newline-delimited data. To specify an alternative delimiter, set the `split` option.
+
+```bash
+$ echo -n '1350,2000' | ms2duration --split ','
+1s350ms
+2s
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.cli -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+[standard-streams]: https://en.wikipedia.org/wiki/Standard_streams
+
+[mdn-regexp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions
+
+<!-- <related-links> -->
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->

From 258cf09d87e65a7c2ad3498c7d92a57c0607682b Mon Sep 17 00:00:00 2001
From: stdlib-bot <noreply@stdlib.io>
Date: Wed, 26 Oct 2022 14:58:12 +0000
Subject: [PATCH 2/6] Scaffold time/ms2duration package files

---
 .../time/ms2duration/benchmark/benchmark.js   |  54 ++++
 .../@stdlib/time/ms2duration/bin/cli          | 104 +++++++
 .../@stdlib/time/ms2duration/docs/repl.txt    |  30 ++
 .../time/ms2duration/docs/types/index.d.ts    |  51 ++++
 .../time/ms2duration/docs/types/test.ts       |  45 +++
 .../@stdlib/time/ms2duration/docs/usage.txt   |   9 +
 .../time/ms2duration/etc/cli_opts.json        |  17 ++
 .../time/ms2duration/examples/index.js        |  41 +++
 .../@stdlib/time/ms2duration/lib/index.js     |  43 +++
 .../@stdlib/time/ms2duration/lib/main.js      |  50 ++++
 .../@stdlib/time/ms2duration/package.json     |  52 ++++
 .../test/fixtures/stdin_error.js.txt          |  33 +++
 .../@stdlib/time/ms2duration/test/test.cli.js | 260 ++++++++++++++++++
 .../@stdlib/time/ms2duration/test/test.js     |  84 ++++++
 14 files changed, 873 insertions(+)
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/bin/cli
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/docs/usage.txt
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/etc/cli_opts.json
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/examples/index.js
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/lib/index.js
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/lib/main.js
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/package.json
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/test/fixtures/stdin_error.js.txt
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
 create mode 100644 lib/node_modules/@stdlib/time/ms2duration/test/test.js

diff --git a/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js b/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
new file mode 100644
index 000000000000..64d6811a991e
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
@@ -0,0 +1,54 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var pkg = require( './../package.json' ).name;
+var ms2duration = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg, function benchmark( b ) {
+	var values;
+	var str;
+	var i;
+
+	values = [
+		// TODO: add benchmark values
+	];
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		str = ms2duration( values[ i % values.length ] );
+		if ( typeof str !== 'string' ) {
+			b.fail( 'should return a string' );
+		}
+	}
+	b.toc();
+	if ( !isString( str ) ) {
+		b.fail( 'should return a string' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/bin/cli b/lib/node_modules/@stdlib/time/ms2duration/bin/cli
new file mode 100644
index 000000000000..e265c0f9e729
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/bin/cli
@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+
+// MODULES //
+
+var resolve = require( 'path' ).resolve;
+var readFileSync = require( '@stdlib/fs/read-file' ).sync;
+var CLI = require( '@stdlib/cli/ctor' );
+var stdin = require( '@stdlib/process/read-stdin' );
+var stdinStream = require( '@stdlib/streams/node/stdin' );
+var ms2dur = require( './../lib' );
+
+
+// VARIABLES //
+
+var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP;
+
+
+// MAIN //
+
+/**
+* Main execution sequence.
+*
+* @private
+* @returns {void}
+*/
+function main() {
+	var flags;
+	var opts;
+	var cli;
+
+	// Create a command-line interface:
+	cli = new CLI({
+		'pkg': require( './../package.json' ),
+		'options': require( './../etc/cli_opts.json' ),
+		'help': readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+			'encoding': 'utf8'
+		})
+	});
+
+	// Get any provided command-line options:
+	flags = cli.flags();
+	if ( flags.help || flags.version ) {
+		return;
+	}
+	opts = {
+		'split': flags.split
+	};
+
+	// Check if we are receiving data from `stdin`...
+	if ( !stdinStream.isTTY ) {
+		return stdin( onRead );
+	}
+	console.log( ms2dur( stdinStream.read().toString(), opts ) ); // eslint-disable-line no-console
+
+	/**
+	* Callback invoked upon reading from `stdin`.
+	*
+	* @private
+	* @param {(Error|null)} error - error object
+	* @param {Buffer} data - data
+	* @returns {void}
+	*/
+	function onRead( error, data ) {
+		var str;
+		var out;
+		var i;
+		if ( error ) {
+			return cli.error( error );
+		}
+		str = data.toString();
+		out = ms2dur( str, opts );
+		if ( out instanceof Error ) {
+			cli.error( out.message );
+		}
+		out = out.split( RE_EOL );
+		for ( i = 0; i < out.length; i++ ) {
+			console.log( out[ i ] ); // eslint-disable-line no-console
+		}
+	}
+}
+
+main();
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt b/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
new file mode 100644
index 000000000000..d0f1cc789e36
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
@@ -0,0 +1,30 @@
+
+
+{{alias}}( str )
+    Converts a number of milliseconds to a string duration.
+
+    Parameters
+    ----------
+    str: string
+        Input string.
+
+    Returns
+    -------
+    out: string
+        Duration string.
+
+    Examples
+    --------
+    > var d = {{alias}}( 1030 )
+    '1s30ms'
+    > d = {{alias}}( 3600000 )
+    '1h'
+    > d = {{alias}}( 0 )
+    '0ms'
+    > d = {{alias}}( {{alias:@stdlib/constants/int64/pifirst}} )
+    '1d'
+    > d = {{alias}}( {{alias:@stdlib/constants/int64/pifirst}} + 3600000 + 60000 + 1000 + 100 )
+    '1d1h1m1s100ms'
+
+    See Also
+    --------
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts b/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
new file mode 100644
index 000000000000..90b556915f18
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
@@ -0,0 +1,51 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 2.0
+
+/**
+* Converts a number of milliseconds to a string duration.
+*
+* @param n - number of milliseconds
+* @returns duration
+*
+* @example
+* var str = ms2duration( 1030 );
+* // returns '1s30ms'
+*
+* @example
+* var str = ms2duration( 3600000 );
+* // returns '1h'
+*/
+declare function ms2duration( n: number ): string;
+
+
+// EXPORTS //
+
+export = ms2duration;
+
+function ms2duration( n: number ): string {
+	if ( !isNonNegativeInteger( n ) ) {
+		throw new TypeError( 'invalid argument. Must provide a numeric primitive. Value: `' + n + '`.' );
+	}
+	if ( n < 1000 ) {
+		return n + 'ms';
+	}
+	return toString( n );
+}
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts b/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
new file mode 100644
index 000000000000..87e640252095
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
@@ -0,0 +1,45 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import ms2duration = require( './index' );
+
+
+// TESTS //
+
+// The function returns a string...
+{
+	ms2duration( 4444 ); // $ExpectType string
+}
+
+// The compiler throws an error if the function is provided a value other than a number...
+{
+	ms2duration( true ); // $ExpectError
+	ms2duration( false ); // $ExpectError
+	ms2duration( null ); // $ExpectError
+	ms2duration( [] ); // $ExpectError
+	ms2duration( {} ); // $ExpectError
+	ms2duration( 'abc' ); // $ExpectError
+	ms2duration( ( x: number ): number => x ); // $ExpectError
+}
+
+// The compiler throws an error if the function is provided an unsupported number of arguments...
+{
+	ms2duration(); // $ExpectError
+	ms2duration( 4444, 4444 ); // $ExpectError
+}
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/usage.txt b/lib/node_modules/@stdlib/time/ms2duration/docs/usage.txt
new file mode 100644
index 000000000000..6a3a386a3bb3
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/usage.txt
@@ -0,0 +1,9 @@
+
+Usage: ms2duration [options] [<string>]
+
+Options:
+
+  -h,    --help                Print this message.
+  -V,    --version             Print the package version.
+         --split sep           Delimiter for stdin data. Default: '/\\r?\\n/'.
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/etc/cli_opts.json b/lib/node_modules/@stdlib/time/ms2duration/etc/cli_opts.json
new file mode 100644
index 000000000000..7c40f9a10cc1
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/etc/cli_opts.json
@@ -0,0 +1,17 @@
+{
+	"string": [
+		"split"
+	],
+	"boolean": [
+		"help",
+		"version"
+	],
+	"alias": {
+		"help": [
+			"h"
+		],
+		"version": [
+			"V"
+		]
+	}
+}
diff --git a/lib/node_modules/@stdlib/time/ms2duration/examples/index.js b/lib/node_modules/@stdlib/time/ms2duration/examples/index.js
new file mode 100644
index 000000000000..62fd87b92641
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/examples/index.js
@@ -0,0 +1,41 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var ms2duration = require( './../lib' );
+
+var duration = ms2duration( 1030 );
+console.log( duration );
+// => '1s30ms'
+
+duration = ms2duration( 3600000 );
+console.log( duration );
+// => '1h'
+
+duration = ms2duration( 0 );
+console.log( duration );
+// => '0ms'
+
+duration = ms2duration( 86400000 );
+console.log( duration );
+// => '1d'
+
+duration = ms2duration( 86400000+3600000+60000+1000+100 );
+console.log( duration );
+// => '1d1h1m1s100ms'
diff --git a/lib/node_modules/@stdlib/time/ms2duration/lib/index.js b/lib/node_modules/@stdlib/time/ms2duration/lib/index.js
new file mode 100644
index 000000000000..26815d9f3b55
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/lib/index.js
@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Convert a number of milliseconds to a string duration.
+*
+* @module @stdlib/time/ms2duration
+*
+* @example
+* var ms2duration = require( '@stdlib/time/ms2duration' );
+*
+* var duration = ms2duration( 1030 );
+* // returns '1s30ms'
+*
+* duration = ms2duration( 3600000 );
+* // returns '1h'
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
new file mode 100644
index 000000000000..c2a42f3f3b7a
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
@@ -0,0 +1,50 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+// TODO: Load required modules...
+
+
+// MAIN //
+
+/**
+* Converts a number of milliseconds to a string duration.
+*
+* @param {number} n - number of milliseconds
+* @throws {TypeError} must provide a numeric primitive
+* @returns {string} duration
+*
+* @example
+* var str = ms2duration( 1030 );
+* // returns '1s30ms'
+*
+* @example
+* var str = ms2duration( 3600000 );
+* // returns '1h'
+*/
+function ms2duration( n ) {
+	// TODO: Add implementation...
+}
+
+
+// EXPORTS //
+
+module.exports = ms2duration;
diff --git a/lib/node_modules/@stdlib/time/ms2duration/package.json b/lib/node_modules/@stdlib/time/ms2duration/package.json
new file mode 100644
index 000000000000..531ebb9ff55c
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/package.json
@@ -0,0 +1,52 @@
+{
+  "name": "@stdlib/time/ms2duration",
+  "version": "0.0.0",
+  "description": "",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "main": "./lib",
+  "directories": {
+    "benchmark": "./benchmark",
+    "doc": "./docs",
+    "example": "./examples",
+    "lib": "./lib",
+    "test": "./test"
+  },
+  "types": "./docs/types",
+  "scripts": {},
+  "homepage": "https://github.com/stdlib-js/stdlib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "engines": {
+    "node": ">=0.10.0",
+    "npm": ">2.7.0"
+  },
+  "os": [
+    "aix",
+    "darwin",
+    "freebsd",
+    "linux",
+    "macos",
+    "openbsd",
+    "sunos",
+    "win32",
+    "windows"
+  ],
+  "keywords": []
+}
diff --git a/lib/node_modules/@stdlib/time/ms2duration/test/fixtures/stdin_error.js.txt b/lib/node_modules/@stdlib/time/ms2duration/test/fixtures/stdin_error.js.txt
new file mode 100644
index 000000000000..a86ba5e5d90c
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/test/fixtures/stdin_error.js.txt
@@ -0,0 +1,33 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+var proc = require( 'process' );
+var resolve = require( 'path' ).resolve;
+var proxyquire = require( 'proxyquire' );
+
+var fpath = resolve( __dirname, '..', 'bin', 'cli' );
+
+proc.stdin.isTTY = false;
+
+proxyquire( fpath, {
+	'@stdlib/process/read-stdin': stdin
+});
+
+function stdin( clbk ) {
+	clbk( new Error( 'beep' ) );
+}
diff --git a/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js b/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
new file mode 100644
index 000000000000..17dd598a3733
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
@@ -0,0 +1,260 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var resolve = require( 'path' ).resolve;
+var exec = require( 'child_process' ).exec;
+var tape = require( 'tape' );
+var IS_BROWSER = require( '@stdlib/assert/is-browser' );
+var IS_WINDOWS = require( '@stdlib/assert/is-windows' );
+var EXEC_PATH = require( '@stdlib/process/exec-path' );
+var replace = require( '@stdlib/string/replace' );
+var readFileSync = require( '@stdlib/fs/read-file' ).sync;
+
+
+// VARIABLES //
+
+var fpath = resolve( __dirname, '..', 'bin', 'cli' );
+var opts = {
+	'skip': IS_BROWSER || IS_WINDOWS
+};
+
+
+// FIXTURES //
+
+var PKG_VERSION = require( './../package.json' ).version;
+
+
+// TESTS //
+
+tape( 'command-line interface', function test( t ) {
+	t.ok( true, __filename );
+	t.end();
+});
+
+tape( 'when invoked with a `--help` flag, the command-line interface prints the help text to `stderr`', opts, function test( t ) {
+	var expected;
+	var cmd;
+
+	expected = readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+		'encoding': 'utf8'
+	});
+	cmd = [
+		EXEC_PATH,
+		fpath,
+		'--help'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), expected+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `-h` flag, the command-line interface prints the help text to `stderr`', opts, function test( t ) {
+	var expected;
+	var cmd;
+
+	expected = readFileSync( resolve( __dirname, '..', 'docs', 'usage.txt' ), {
+		'encoding': 'utf8'
+	});
+	cmd = [
+		EXEC_PATH,
+		fpath,
+		'-h'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), expected+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `--version` flag, the command-line interface prints the version to `stderr`', opts, function test( t ) {
+	var cmd = [
+		EXEC_PATH,
+		fpath,
+		'--version'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), PKG_VERSION+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when invoked with a `-V` flag, the command-line interface prints the version to `stderr`', opts, function test( t ) {
+	var cmd = [
+		EXEC_PATH,
+		fpath,
+		'-V'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+			t.strictEqual( stderr.toString(), PKG_VERSION+'\n', 'expected value' );
+		}
+		t.end();
+	}
+});
+
+tape( 'the command-line interface prints out the duration corresponding to a millisecond value', opts, function test( t ) {
+	var cmd;
+	var str;
+
+	cmd = [
+		EXEC_PATH,
+		'-e',
+		'"process.stdin.isTTY = true; process.argv[ 2 ] = \'1000\'; require( \''+fpath+'\' );"'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			str = stdout.toString();
+			t.strictEqual( str.length > 0, true, 'expected output length' );
+			t.strictEqual( str.split( /\r?\n/ ).length, 1, 'expected line count' );
+			t.strictEqual( str, '1s\n', 'expected value' );
+			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
+		}
+		t.end();
+	}
+});
+
+tape( 'the command-line interface supports use as a standard stream', opts, function test( t ) {
+	var cmd;
+	var str;
+
+	cmd = [
+		'printf "1000\n2000\n3000\n4000"',
+		'|',
+		EXEC_PATH,
+		fpath
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			str = stdout.toString();
+			t.strictEqual( str.length > 0, true, 'expected output length' );
+			t.strictEqual( str.split( /\r?\n/ ).length, 4, 'expected line count' );
+			t.strictEqual( str, '1s\n2s\n3s\n4s\n', 'expected value' );
+			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
+		}
+		t.end();
+	}
+});
+
+tape( 'the command-line interface supports use as a standard stream (delimiter option)', opts, function test( t ) {
+	var cmd;
+	var str;
+
+	cmd = [
+		'printf "1000,2000,3000,4000"',
+		'|',
+		EXEC_PATH,
+		fpath,
+		'--split ,'
+	];
+
+	exec( cmd.join( ' ' ), done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.fail( error.message );
+		} else {
+			str = stdout.toString();
+			t.strictEqual( str.length > 0, true, 'expected output length' );
+			t.strictEqual( str.split( /\r?\n/ ).length, 4, 'expected line count' );
+			t.strictEqual( str, '1s\n2s\n3s\n4s\n', 'expected value' );
+			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
+		}
+		t.end();
+	}
+});
+
+tape( 'when used as a standard stream, if an error is encountered when reading from `stdin`, the command-line interface prints an error and sets a non-zero exit code', opts, function test( t ) {
+	var script;
+	var opts;
+	var cmd;
+
+	script = readFileSync( resolve( __dirname, 'fixtures', 'stdin_error.js.txt' ), {
+		'encoding': 'utf8'
+	});
+
+	// Replace single quotes with double quotes:
+	script = replace( script, '\'', '"' );
+
+	cmd = [
+		EXEC_PATH,
+		'-e',
+		'\''+script+'\''
+	];
+
+	opts = {
+		'cwd': __dirname
+	};
+
+	exec( cmd.join( ' ' ), opts, done );
+
+	function done( error, stdout, stderr ) {
+		if ( error ) {
+			t.pass( error.message );
+			t.strictEqual( error.code, 1, 'expected exit code' );
+		}
+		t.strictEqual( stdout.toString(), '', 'does not print to `stdout`' );
+		t.strictEqual( stderr.toString(), 'Error: beep\n', 'expected value' );
+		t.end();
+	}
+});
+
diff --git a/lib/node_modules/@stdlib/time/ms2duration/test/test.js b/lib/node_modules/@stdlib/time/ms2duration/test/test.js
new file mode 100644
index 000000000000..a50f7d3928df
--- /dev/null
+++ b/lib/node_modules/@stdlib/time/ms2duration/test/test.js
@@ -0,0 +1,84 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2022 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var ms2duration = require( './../lib' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.equal( typeof ms2duration, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'the function converts seconds to a string duration', function test( t ) {
+	t.equal( ms2duration( 1000 ), '1s', 'converts 1s' );
+	t.equal( ms2duration( 2000 ), '2s', 'converts 2s' );
+	t.equal( ms2duration( 3000 ), '3s', 'converts 3s' );
+	t.equal( ms2duration( 4000 ), '4s', 'converts 4s' );
+	t.equal( ms2duration( 5000 ), '5s', 'converts 5s' );
+	t.equal( ms2duration( 6000 ), '6s', 'converts 6s' );
+	t.equal( ms2duration( 7000 ), '7s', 'converts 7s' );
+	t.equal( ms2duration( 8000 ), '8s', 'converts 8s' );
+	t.equal( ms2duration( 9000 ), '9s', 'converts 9s' );
+	t.end();
+});
+
+tape( 'the function converts minutes to a string duration', function test( t ) {
+	t.equal( ms2duration( 60000 ), '1m', 'converts 1m' );
+	t.equal( ms2duration( 120000 ), '2m', 'converts 2m' );
+	t.equal( ms2duration( 180000 ), '3m', 'converts 3m' );
+	t.equal( ms2duration( 240000 ), '4m', 'converts 4m' );
+	t.equal( ms2duration( 300000 ), '5m', 'converts 5m' );
+	t.equal( ms2duration( 360000 ), '6m', 'converts 6m' );
+	t.equal( ms2duration( 420000 ), '7m', 'converts 7m' );
+	t.equal( ms2duration( 480000 ), '8m', 'converts 8m' );
+	t.equal( ms2duration( 540000 ), '9m', 'converts 9m' );
+	t.end();
+});
+
+tape( 'the function converts hours to a string duration', function test( t ) {
+	t.equal( ms2duration( 3600000 ), '1h', 'converts 1h' );
+	t.equal( ms2duration( 7200000 ), '2h', 'converts 2h' );
+	t.equal( ms2duration( 10800000 ), '3h', 'converts 3h' );
+	t.equal( ms2duration( 14400000 ), '4h', 'converts 4h' );
+	t.equal( ms2duration( 18000000 ), '5h', 'converts 5h' );
+	t.equal( ms2duration( 21600000 ), '6h', 'converts 6h' );
+	t.equal( ms2duration( 25200000 ), '7h', 'converts 7h' );
+	t.equal( ms2duration( 28800000 ), '8h', 'converts 8h' );
+	t.equal( ms2duration( 32400000 ), '9h', 'converts 9h' );
+
+	// TODO: test hour fractions
+
+	t.end();
+});
+
+tape( 'the function converts days to a string duration', function test( t ) {
+	t.equal( ms2duration( 86400000 ), '1d', 'converts 1d' );
+	t.equal( ms2duration( 172800000 ), '2d', 'converts 2d' );
+	t.equal( ms2duration( 259200000 ), '3d', 'converts 3d' );
+	t.equal( ms2duration( 345600000 ), '4d', 'converts 4d' );
+	t.equal( ms2duration( 432000000 ), '5d', 'converts 5d' );
+	t.equal( ms2duration( 518400000 ), '6d', 'converts 6d' );
+	t.equal( ms2duration( 604800000 ), '

From f0ca1228d2ed3c7c666306ed38ea5178ad0e2f0a Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Wed, 26 Oct 2022 11:28:20 -0400
Subject: [PATCH 3/6] Finish implementation

---
 .../time/ms2duration/benchmark/benchmark.js   |  8 ++-
 .../@stdlib/time/ms2duration/bin/cli          | 48 ++++++++-------
 .../@stdlib/time/ms2duration/docs/repl.txt    | 11 ++--
 .../time/ms2duration/docs/types/index.d.ts    | 15 +----
 .../time/ms2duration/docs/types/test.ts       |  1 -
 .../@stdlib/time/ms2duration/lib/main.js      | 37 ++++++++++--
 .../@stdlib/time/ms2duration/package.json     | 19 +++++-
 .../@stdlib/time/ms2duration/test/test.cli.js |  4 --
 .../@stdlib/time/ms2duration/test/test.js     | 60 ++++++++++++++++---
 9 files changed, 140 insertions(+), 63 deletions(-)

diff --git a/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js b/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
index 64d6811a991e..15e86ebefaef 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/benchmark/benchmark.js
@@ -34,7 +34,12 @@ bench( pkg, function benchmark( b ) {
 	var i;
 
 	values = [
-		// TODO: add benchmark values
+		0,
+		1000,
+		3600000,
+		86400000,
+		604800000,
+		30000
 	];
 
 	b.tic();
@@ -51,4 +56,3 @@ bench( pkg, function benchmark( b ) {
 	b.pass( 'benchmark finished' );
 	b.end();
 });
-
diff --git a/lib/node_modules/@stdlib/time/ms2duration/bin/cli b/lib/node_modules/@stdlib/time/ms2duration/bin/cli
index e265c0f9e729..db03384a1e0d 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/bin/cli
+++ b/lib/node_modules/@stdlib/time/ms2duration/bin/cli
@@ -3,7 +3,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2022 The Stdlib Authors.
+* Copyright (c) 2018 The Stdlib Authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
@@ -20,7 +20,6 @@
 
 'use strict';
 
-
 // MODULES //
 
 var resolve = require( 'path' ).resolve;
@@ -28,12 +27,10 @@ var readFileSync = require( '@stdlib/fs/read-file' ).sync;
 var CLI = require( '@stdlib/cli/ctor' );
 var stdin = require( '@stdlib/process/read-stdin' );
 var stdinStream = require( '@stdlib/streams/node/stdin' );
-var ms2dur = require( './../lib' );
-
-
-// VARIABLES //
-
 var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP;
+var isRegExpString = require( '@stdlib/assert/is-regexp-string' );
+var reFromString = require( '@stdlib/utils/regexp-from-string' );
+var ms2duration = require( './../lib' );
 
 
 // MAIN //
@@ -45,8 +42,9 @@ var RE_EOL = require( '@stdlib/regexp/eol' ).REGEXP;
 * @returns {void}
 */
 function main() {
+	var split;
 	var flags;
-	var opts;
+	var args;
 	var cli;
 
 	// Create a command-line interface:
@@ -63,15 +61,23 @@ function main() {
 	if ( flags.help || flags.version ) {
 		return;
 	}
-	opts = {
-		'split': flags.split
-	};
+
+	// Get any provided command-line arguments:
+	args = cli.args();
 
 	// Check if we are receiving data from `stdin`...
 	if ( !stdinStream.isTTY ) {
+		if ( flags.split ) {
+			if ( !isRegExpString( flags.split ) ) {
+				flags.split = '/'+flags.split+'/';
+			}
+			split = reFromString( flags.split );
+		} else {
+			split = RE_EOL;
+		}
 		return stdin( onRead );
 	}
-	console.log( ms2dur( stdinStream.read().toString(), opts ) ); // eslint-disable-line no-console
+	console.log( ms2duration( parseInt( args[ 0 ], 10 ) ) ); // eslint-disable-line no-console
 
 	/**
 	* Callback invoked upon reading from `stdin`.
@@ -82,23 +88,21 @@ function main() {
 	* @returns {void}
 	*/
 	function onRead( error, data ) {
-		var str;
-		var out;
+		var lines;
 		var i;
 		if ( error ) {
 			return cli.error( error );
 		}
-		str = data.toString();
-		out = ms2dur( str, opts );
-		if ( out instanceof Error ) {
-			cli.error( out.message );
+		lines = data.toString().split( split );
+
+		// Remove any trailing separators (e.g., trailing newline)...
+		if ( lines[ lines.length-1 ] === '' ) {
+			lines.pop();
 		}
-		out = out.split( RE_EOL );
-		for ( i = 0; i < out.length; i++ ) {
-			console.log( out[ i ] ); // eslint-disable-line no-console
+		for ( i = 0; i < lines.length; i++ ) {
+			console.log( ms2duration( parseInt( lines[ i ], 10 ) ) ); // eslint-disable-line no-console
 		}
 	}
 }
 
 main();
-
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt b/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
index d0f1cc789e36..b885e8e097fc 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/repl.txt
@@ -1,12 +1,11 @@
 
-
-{{alias}}( str )
+{{alias}}( ms )
     Converts a number of milliseconds to a string duration.
 
     Parameters
     ----------
-    str: string
-        Input string.
+    ms: integer
+        Number of milliseconds to convert.
 
     Returns
     -------
@@ -21,9 +20,9 @@
     '1h'
     > d = {{alias}}( 0 )
     '0ms'
-    > d = {{alias}}( {{alias:@stdlib/constants/int64/pifirst}} )
+    > d = {{alias}}( 86400000 )
     '1d'
-    > d = {{alias}}( {{alias:@stdlib/constants/int64/pifirst}} + 3600000 + 60000 + 1000 + 100 )
+    > d = {{alias}}( 86400000 + 3600000 + 60000 + 1000 + 100 )
     '1d1h1m1s100ms'
 
     See Also
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts b/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
index 90b556915f18..276291e1bd46 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/types/index.d.ts
@@ -21,7 +21,7 @@
 /**
 * Converts a number of milliseconds to a string duration.
 *
-* @param n - number of milliseconds
+* @param ms - number of milliseconds
 * @returns duration
 *
 * @example
@@ -32,20 +32,9 @@
 * var str = ms2duration( 3600000 );
 * // returns '1h'
 */
-declare function ms2duration( n: number ): string;
+declare function ms2duration( ms: number ): string;
 
 
 // EXPORTS //
 
 export = ms2duration;
-
-function ms2duration( n: number ): string {
-	if ( !isNonNegativeInteger( n ) ) {
-		throw new TypeError( 'invalid argument. Must provide a numeric primitive. Value: `' + n + '`.' );
-	}
-	if ( n < 1000 ) {
-		return n + 'ms';
-	}
-	return toString( n );
-}
-
diff --git a/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts b/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
index 87e640252095..d453cb968086 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
+++ b/lib/node_modules/@stdlib/time/ms2duration/docs/types/test.ts
@@ -42,4 +42,3 @@ import ms2duration = require( './index' );
 	ms2duration(); // $ExpectError
 	ms2duration( 4444, 4444 ); // $ExpectError
 }
-
diff --git a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
index c2a42f3f3b7a..9118cbbf96ea 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
@@ -20,7 +20,7 @@
 
 // MODULES //
 
-// TODO: Load required modules...
+var isNonNegativeInteger = require( '@stdlib/assert/is-nonnegative-integer' ).isPrimitive;
 
 
 // MAIN //
@@ -28,8 +28,8 @@
 /**
 * Converts a number of milliseconds to a string duration.
 *
-* @param {number} n - number of milliseconds
-* @throws {TypeError} must provide a numeric primitive
+* @param {number} ms - number of milliseconds
+* @throws {TypeError} must provide a nonnegative integer
 * @returns {string} duration
 *
 * @example
@@ -40,8 +40,35 @@
 * var str = ms2duration( 3600000 );
 * // returns '1h'
 */
-function ms2duration( n ) {
-	// TODO: Add implementation...
+function ms2duration( ms ) {
+	var out;
+	if ( !isNonNegativeInteger( ms ) ) {
+		throw new TypeError( 'invalid argument. Must provide a nonnegative integer. Value: `' + ms + '`.' );
+	}
+	if ( ms === 0 ) {
+		return '0ms';
+	}
+	out = '';
+	if ( ms >= 86400000 ) {
+		out += (ms/86400000|0) + 'd';
+		ms %= 86400000;
+	}
+	if ( ms >= 3600000 ) {
+		out += (ms/3600000|0) + 'h';
+		ms %= 3600000;
+	}
+	if ( ms >= 60000 ) {
+		out += (ms/60000|0) + 'm';
+		ms %= 60000;
+	}
+	if ( ms >= 1000 ) {
+		out += (ms/1000|0) + 's';
+		ms %= 1000;
+	}
+	if ( ms > 0 ) {
+		out += ms + 'ms';
+	}
+	return out;
 }
 
 
diff --git a/lib/node_modules/@stdlib/time/ms2duration/package.json b/lib/node_modules/@stdlib/time/ms2duration/package.json
index 531ebb9ff55c..c68959e8f822 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/package.json
+++ b/lib/node_modules/@stdlib/time/ms2duration/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@stdlib/time/ms2duration",
   "version": "0.0.0",
-  "description": "",
+  "description": "Convert a number of milliseconds to a string duration.",
   "license": "Apache-2.0",
   "author": {
     "name": "The Stdlib Authors",
@@ -13,6 +13,9 @@
       "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
     }
   ],
+  "bin": {
+    "ms2duration": "./bin/cli"
+  },
   "main": "./lib",
   "directories": {
     "benchmark": "./benchmark",
@@ -48,5 +51,17 @@
     "win32",
     "windows"
   ],
-  "keywords": []
+  "keywords": [
+    "stdlib",
+    "stdtime",
+    "utilities",
+    "utility",
+    "utils",
+    "util",
+    "duration",
+    "time",
+    "ms",
+    "milliseconds",
+    "readable"
+  ]
 }
diff --git a/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js b/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
index 17dd598a3733..9e5f30abd103 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/test/test.cli.js
@@ -160,7 +160,6 @@ tape( 'the command-line interface prints out the duration corresponding to a mil
 		} else {
 			str = stdout.toString();
 			t.strictEqual( str.length > 0, true, 'expected output length' );
-			t.strictEqual( str.split( /\r?\n/ ).length, 1, 'expected line count' );
 			t.strictEqual( str, '1s\n', 'expected value' );
 			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
 		}
@@ -187,7 +186,6 @@ tape( 'the command-line interface supports use as a standard stream', opts, func
 		} else {
 			str = stdout.toString();
 			t.strictEqual( str.length > 0, true, 'expected output length' );
-			t.strictEqual( str.split( /\r?\n/ ).length, 4, 'expected line count' );
 			t.strictEqual( str, '1s\n2s\n3s\n4s\n', 'expected value' );
 			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
 		}
@@ -215,7 +213,6 @@ tape( 'the command-line interface supports use as a standard stream (delimiter o
 		} else {
 			str = stdout.toString();
 			t.strictEqual( str.length > 0, true, 'expected output length' );
-			t.strictEqual( str.split( /\r?\n/ ).length, 4, 'expected line count' );
 			t.strictEqual( str, '1s\n2s\n3s\n4s\n', 'expected value' );
 			t.strictEqual( stderr.toString(), '', 'does not print to `stderr`' );
 		}
@@ -257,4 +254,3 @@ tape( 'when used as a standard stream, if an error is encountered when reading f
 		t.end();
 	}
 });
-
diff --git a/lib/node_modules/@stdlib/time/ms2duration/test/test.js b/lib/node_modules/@stdlib/time/ms2duration/test/test.js
index a50f7d3928df..bace7daa30f6 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/test/test.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/test/test.js
@@ -32,7 +32,43 @@ tape( 'main export is a function', function test( t ) {
 	t.end();
 });
 
-tape( 'the function converts seconds to a string duration', function test( t ) {
+tape( 'the function throws an error if provided a value which is not a nonnegative integer', function test( t ) {
+	var values;
+	var i;
+
+	values = [
+		'5',
+		5.3,
+		-5,
+		'abc',
+		NaN,
+		null,
+		true,
+		void 0,
+		[],
+		{},
+		function noop() {}
+	];
+
+	for ( i = 0; i < values.length; i++ ) {
+		t.throws( badValue( values[i] ), TypeError, 'throws a type error when provided '+values[i] );
+	}
+	t.end();
+
+	function badValue( value ) {
+		return function badValue() {
+			ms2duration( value );
+		};
+	}
+});
+
+tape( 'the function returns `0ms` when provided `0`', function test( t ) {
+	var duration = ms2duration( 0 );
+	t.equal( duration, '0ms', 'returns 0ms' );
+	t.end();
+});
+
+tape( 'the function converts milliseconds to a string duration (seconds)', function test( t ) {
 	t.equal( ms2duration( 1000 ), '1s', 'converts 1s' );
 	t.equal( ms2duration( 2000 ), '2s', 'converts 2s' );
 	t.equal( ms2duration( 3000 ), '3s', 'converts 3s' );
@@ -45,7 +81,7 @@ tape( 'the function converts seconds to a string duration', function test( t ) {
 	t.end();
 });
 
-tape( 'the function converts minutes to a string duration', function test( t ) {
+tape( 'the function converts milliseconds to a string duration (minutes)', function test( t ) {
 	t.equal( ms2duration( 60000 ), '1m', 'converts 1m' );
 	t.equal( ms2duration( 120000 ), '2m', 'converts 2m' );
 	t.equal( ms2duration( 180000 ), '3m', 'converts 3m' );
@@ -58,7 +94,7 @@ tape( 'the function converts minutes to a string duration', function test( t ) {
 	t.end();
 });
 
-tape( 'the function converts hours to a string duration', function test( t ) {
+tape( 'the function converts milliseconds to a string duration (hours)', function test( t ) {
 	t.equal( ms2duration( 3600000 ), '1h', 'converts 1h' );
 	t.equal( ms2duration( 7200000 ), '2h', 'converts 2h' );
 	t.equal( ms2duration( 10800000 ), '3h', 'converts 3h' );
@@ -68,17 +104,25 @@ tape( 'the function converts hours to a string duration', function test( t ) {
 	t.equal( ms2duration( 25200000 ), '7h', 'converts 7h' );
 	t.equal( ms2duration( 28800000 ), '8h', 'converts 8h' );
 	t.equal( ms2duration( 32400000 ), '9h', 'converts 9h' );
-
-	// TODO: test hour fractions
-
 	t.end();
 });
 
-tape( 'the function converts days to a string duration', function test( t ) {
+tape( 'the function converts milliseconds to a string duration (days)', function test( t ) {
 	t.equal( ms2duration( 86400000 ), '1d', 'converts 1d' );
 	t.equal( ms2duration( 172800000 ), '2d', 'converts 2d' );
 	t.equal( ms2duration( 259200000 ), '3d', 'converts 3d' );
 	t.equal( ms2duration( 345600000 ), '4d', 'converts 4d' );
 	t.equal( ms2duration( 432000000 ), '5d', 'converts 5d' );
 	t.equal( ms2duration( 518400000 ), '6d', 'converts 6d' );
-	t.equal( ms2duration( 604800000 ), '
+	t.equal( ms2duration( 604800000 ), '7d', 'converts 7d' );
+	t.end();
+});
+
+tape( 'the function converts a value in milliseconds to a string duration', function test( t ) {
+	t.equal( ms2duration( 1234 ), '1s234ms', 'converts 1s234ms' );
+	t.equal( ms2duration( 12345 ), '12s345ms', 'converts 12s345ms' );
+	t.equal( ms2duration( 123456 ), '2m3s456ms', 'converts 2m3s456ms' );
+	t.equal( ms2duration( 1234567 ), '20m34s567ms', 'converts 20m34s567ms' );
+	t.equal( ms2duration( 12345678 ), '3h25m45s678ms', 'converts 3h25m45s678ms' );
+	t.end();
+});

From c8844de144b486c7c6044caefbe61650a51f2989 Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Thu, 27 Oct 2022 15:51:26 -0400
Subject: [PATCH 4/6] Update
 lib/node_modules/@stdlib/time/ms2duration/README.md

Co-authored-by: Athan <kgryte@gmail.com>
---
 lib/node_modules/@stdlib/time/ms2duration/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/node_modules/@stdlib/time/ms2duration/README.md b/lib/node_modules/@stdlib/time/ms2duration/README.md
index 33a23bd9deab..830d5abf7f3c 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/README.md
+++ b/lib/node_modules/@stdlib/time/ms2duration/README.md
@@ -58,7 +58,7 @@ duration = ms2duration( 3600000 );
     -   `s`: seconds
     -   `ms`: milliseconds
     
-    For example, the string `1m3s10ms` is a duration string containing three time units: `1m` (1 minute), `3s` (3 seconds), and `10ms` (10 milliseconds). The string `60m` is a duration string containing a single time unit: `60m` (60 minutes). A duration string must contain at least one time unit.
+    For example, the string `1m3s10ms` is a duration string containing three time units: `1m` (1 minute), `3s` (3 seconds), and `10ms` (10 milliseconds). The string `60m` is a duration string containing a single time unit: `60m` (60 minutes).
 
 </section>
 

From 360fe72d4cb3f852597ccf563c66b784730419a2 Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Thu, 27 Oct 2022 15:56:15 -0400
Subject: [PATCH 5/6] Use floor

---
 lib/node_modules/@stdlib/time/ms2duration/lib/main.js | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
index 9118cbbf96ea..a9a28517414e 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
@@ -21,6 +21,7 @@
 // MODULES //
 
 var isNonNegativeInteger = require( '@stdlib/assert/is-nonnegative-integer' ).isPrimitive;
+var floor = require( '@stdlib/math/base/special/floor' );
 
 
 // MAIN //
@@ -50,19 +51,19 @@ function ms2duration( ms ) {
 	}
 	out = '';
 	if ( ms >= 86400000 ) {
-		out += (ms/86400000|0) + 'd';
+		out += floor(ms/86400000) + 'd';
 		ms %= 86400000;
 	}
 	if ( ms >= 3600000 ) {
-		out += (ms/3600000|0) + 'h';
+		out += floor(ms/3600000) + 'h';
 		ms %= 3600000;
 	}
 	if ( ms >= 60000 ) {
-		out += (ms/60000|0) + 'm';
+		out += floor(ms/60000) + 'm';
 		ms %= 60000;
 	}
 	if ( ms >= 1000 ) {
-		out += (ms/1000|0) + 's';
+		out += floor(ms/1000) + 's';
 		ms %= 1000;
 	}
 	if ( ms > 0 ) {

From ebc4ccea0e217441fc61f21b7e7d0ec31e3ae178 Mon Sep 17 00:00:00 2001
From: Athan <kgryte@gmail.com>
Date: Thu, 27 Oct 2022 14:35:13 -0700
Subject: [PATCH 6/6] Format error message

---
 lib/node_modules/@stdlib/time/ms2duration/lib/main.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
index a9a28517414e..575670167e18 100644
--- a/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
+++ b/lib/node_modules/@stdlib/time/ms2duration/lib/main.js
@@ -22,6 +22,7 @@
 
 var isNonNegativeInteger = require( '@stdlib/assert/is-nonnegative-integer' ).isPrimitive;
 var floor = require( '@stdlib/math/base/special/floor' );
+var format = require( '@stdlib/string/format' );
 
 
 // MAIN //
@@ -44,7 +45,7 @@ var floor = require( '@stdlib/math/base/special/floor' );
 function ms2duration( ms ) {
 	var out;
 	if ( !isNonNegativeInteger( ms ) ) {
-		throw new TypeError( 'invalid argument. Must provide a nonnegative integer. Value: `' + ms + '`.' );
+		throw new TypeError( format( 'invalid argument. Must provide a nonnegative integer. Value: `%s`.', ms ) );
 	}
 	if ( ms === 0 ) {
 		return '0ms';