just-bash-util 0.1.7 → 0.1.8

package/README.md

@@ -64,7 +64,7 @@ await serve.invoke({ port: 8080, entry: "app.ts" }, ctx);
 - `omitInherited` to exclude parent options from specific subcommands
 - `--help` / `-h` auto-generated at every level
 - `--no-<flag>` negation, `-abc` combined short flags, `--key=value` syntax, counted flags (`-vvv` → 3)
-- `--` end-of-options separator (remaining tokens become positional args and are available via `meta.passthrough`)
+- `--` end-of-options separator (remaining tokens go to `meta.passthrough` without consuming positional args)
 - Environment variable fallbacks for options
 - Levenshtein-based "did you mean?" suggestions for typos
 - `transformArgs` callback to rewrite tokens before parsing — support non-standard shorthand syntax like `-5` → `-n 5`
@@ -114,13 +114,19 @@ args: [
 
 #### The `--` separator
 
-The `--` token signals end-of-options. Tokens after `--` are treated as positional arguments (not parsed as flags) and are also available in `meta.passthrough`:
+The `--` token stops all parsing. Tokens after `--` go exclusively into `meta.passthrough` — they are **not** consumed as positional args or parsed as flags. Positional args must appear before `--`:
 
 ```ts
+// mycli checkout main -- README.md
+handler: (args, ctx, meta) => {
+  args.target;          // "main" (positional arg before --)
+  meta.passthrough;     // ["README.md"] (tokens after --)
+}
+
 // mycli checkout -- README.md
 handler: (args, ctx, meta) => {
-  args.target;          // "README.md" (assigned to positional arg)
-  meta.passthrough;     // ["README.md"] (raw tokens after --)
+  args.target;          // undefined (no positional before --)
+  meta.passthrough;     // ["README.md"]
 }
 ```
 

package/dist/{chunk-B6JJTTPV.js → chunk-4EGDYWA4.js}

@@ -217,7 +217,6 @@ function parseArgs(options, argDefs, tokens, env) {
     if (token === "--") {
       i++;
       while (i < tokens.length) {
-        positionals.push(tokens[i]);
         passthrough.push(tokens[i]);
         i++;
       }

package/dist/command/index.js

@@ -8,7 +8,7 @@ import {
   generateHelp,
   o,
   parseArgs
-} from "../chunk-B6JJTTPV.js";
+} from "../chunk-4EGDYWA4.js";
 export {
   Command,
   a,

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   generateHelp,
   o,
   parseArgs
-} from "./chunk-B6JJTTPV.js";
+} from "./chunk-4EGDYWA4.js";
 import {
   findUp,
   loadConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-bash-util",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "CLI command framework, config file discovery, and path utilities for just-bash",
   "type": "module",
   "license": "MIT",