feat: support single dash as positional

README.md

@@ -202,7 +202,7 @@ const { flags, values, positionals } = parseArgs(argv, options);
   - the first flag would be parsed as `'-foo'`
   - the second flag would be parsed as `'foo'`
 - Is `-` a positional? ie, `bash some-test.sh | tap -`
-  - no
+  - yes
 
 [coverage-image]: https://img.shields.io/nycrc/pkgjs/parseargs
 [coverage-url]: https://github.com/pkgjs/parseargs/blob/main/.nycrc

index.js

@@ -93,9 +93,14 @@ const parseArgs = (
     let arg = argv[pos];
 
     if (StringPrototypeStartsWith(arg, '-')) {
-      // Everything after a bare '--' is considered a positional argument
-      // and is returned verbatim
-      if (arg === '--') {
+      if (arg === '-') {
+        // '-' commonly used to represent stdin/stdout, treat as positional
+        result.positionals = ArrayPrototypeConcat(result.positionals, '-');
+        ++pos;
+        continue;
+      } else if (arg === '--') {
+        // Everything after a bare '--' is considered a positional argument
+        // and is returned verbatim
         result.positionals = ArrayPrototypeConcat(
           result.positionals,
           ArrayPrototypeSlice(argv, ++pos)

test/index.js

@@ -47,6 +47,16 @@ test('args equals are passed "withValue"', function(t) {
   t.end();
 });
 
+test('when args include single dash then result stores dash as positional', function(t) {
+  const passedArgs = ['-'];
+  const expected = { flags: { }, values: { }, positionals: ['-'] };
+  const args = parseArgs(passedArgs);
+
+  t.deepEqual(args, expected);
+
+  t.end();
+});
+
 test('same arg is passed twice "withValue" and last value is recorded', function(t) {
   const passedArgs = ['--foo=a', '--foo', 'b'];
   const passedOptions = { withValue: ['foo'] };