just-bash-util 0.1.5 → 0.1.6

package/README.md

@@ -63,7 +63,7 @@ await serve.invoke({ port: 8080, entry: "app.ts" }, ctx);
 - Subcommand nesting with automatic option inheritance
 - `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
+- `--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`)
 - Environment variable fallbacks for options
 - Levenshtein-based "did you mean?" suggestions for typos
@@ -81,6 +81,16 @@ options: {
 }
 ```
 
+Flags support counting mode via `.count()`. Repeated occurrences produce a number instead of a boolean — useful for verbosity levels (`-v`, `-vv`, `-vvv`):
+
+```ts
+options: {
+  verbose: f().alias("v").count().describe("Verbosity level"),
+}
+// -v → 1, -vv → 2, -vvv → 3, absent → 0
+// handler receives args.verbose as number
+```
+
 Short flags (single-dash, single-character) require `.alias()`. A single-character key like `b: f()` creates the long flag `--b`, **not** the short flag `-b`. To get `-b`, use a descriptive key with an alias:
 
 ```ts

package/dist/{chunk-RNQNKFXA.js → chunk-4J5EECVQ.js}

@@ -64,6 +64,13 @@ var FlagBuilder = class _FlagBuilder {
   default(value) {
     return new _FlagBuilder({ ...this._def, default: value });
   }
+  /**
+   * Enable counting mode. Repeated occurrences (-v -v or -vv) produce a
+   * number instead of a boolean: 0 (absent), 1, 2, 3, etc.
+   */
+  count() {
+    return new _FlagBuilder({ ...this._def, counted: true });
+  }
 };
 
 // src/command/builders/arg.ts
@@ -231,7 +238,7 @@ function parseArgs(options, argDefs, tokens, env) {
         if (longName.startsWith("no-")) {
           const positiveEntry = longMap.get(longName.slice(3));
           if (positiveEntry && positiveEntry.def._kind === "flag") {
-            result[positiveEntry.key] = false;
+            result[positiveEntry.key] = positiveEntry.def.counted ? 0 : false;
             i++;
             continue;
           }
@@ -246,7 +253,11 @@ function parseArgs(options, argDefs, tokens, env) {
         continue;
       }
       if (entry.def._kind === "flag") {
-        result[entry.key] = true;
+        if (entry.def.counted) {
+          result[entry.key] = (result[entry.key] || 0) + 1;
+        } else {
+          result[entry.key] = true;
+        }
         i++;
         continue;
       }
@@ -281,7 +292,11 @@ function parseArgs(options, argDefs, tokens, env) {
           continue;
         }
         if (entry.def._kind === "flag") {
-          result[entry.key] = true;
+          if (entry.def.counted) {
+            result[entry.key] = (result[entry.key] || 0) + 1;
+          } else {
+            result[entry.key] = true;
+          }
           continue;
         }
         const restOfString = chars.slice(j + 1);
@@ -342,7 +357,7 @@ function parseArgs(options, argDefs, tokens, env) {
   for (const [key, def] of Object.entries(options)) {
     if (result[key] === void 0) {
       if (def._kind === "flag") {
-        result[key] = def.default ?? false;
+        result[key] = def.default ?? (def.counted ? 0 : false);
       } else if (def._kind === "option") {
         const opt = def;
         if (opt.env && env?.[opt.env] !== void 0) {
@@ -486,6 +501,7 @@ function formatOptionsTable(schema, header) {
       parts.push(`--${longName}`);
       const descParts = [];
       if (flag.description) descParts.push(flag.description);
+      if (flag.counted) descParts.push("(counted)");
       if (flag.default !== void 0) descParts.push(`(default: ${flag.default})`);
       rows.push([parts.join(" "), descParts.join(" ")]);
     } else {
@@ -640,7 +656,9 @@ var Command = class _Command {
       const value = input[key];
       const kebab = camelToKebab(key);
       if (def._kind === "flag") {
-        if (value === true) {
+        if (def.counted && typeof value === "number" && value > 0) {
+          for (let n = 0; n < value; n++) tokens.push(`--${kebab}`);
+        } else if (value === true) {
           tokens.push(`--${kebab}`);
         } else if (value === false && def.default === true) {
           tokens.push(`--no-${kebab}`);
@@ -690,7 +708,7 @@ var Command = class _Command {
     for (const [key, def] of Object.entries(allOpts)) {
       if (resolved[key] === void 0) {
         if (def._kind === "flag") {
-          resolved[key] = def.default ?? false;
+          resolved[key] = def.default ?? (def.counted ? 0 : false);
         } else if (def._kind === "option") {
           if (def.default !== void 0) {
             resolved[key] = def.default;

package/dist/command/index.d.ts

@@ -21,7 +21,8 @@ interface FlagDef {
     readonly _kind: "flag";
     readonly description?: string;
     readonly short?: string;
-    readonly default?: boolean;
+    readonly default?: boolean | number;
+    readonly counted?: boolean;
 }
 interface ArgDef<TOut = unknown> {
     readonly _kind: "arg";
@@ -88,16 +89,21 @@ declare function string$1(): OptionBuilder<string | undefined>;
 /** Create a number option (optional by default) */
 declare function number$1(): OptionBuilder<number | undefined>;
 
-declare class FlagBuilder {
+declare class FlagBuilder<TCounted extends boolean = false> {
     /** @internal */
     readonly _def: FlagDef;
     constructor(def?: FlagDef);
     /** Add a description */
-    describe(text: string): FlagBuilder;
+    describe(text: string): FlagBuilder<TCounted>;
     /** Set a short alias (single character, e.g. "v" for -v) */
-    alias(short: string): FlagBuilder;
+    alias(short: string): FlagBuilder<TCounted>;
     /** Set a default value */
-    default(value: boolean): FlagBuilder;
+    default(value: TCounted extends true ? number : boolean): FlagBuilder<TCounted>;
+    /**
+     * Enable counting mode. Repeated occurrences (-v -v or -vv) produce a
+     * number instead of a boolean: 0 (absent), 1, 2, 3, etc.
+     */
+    count(): FlagBuilder<true>;
 }
 
 declare class ArgBuilder<TOut, TName extends string = never, THasDefault extends boolean = false> {
@@ -140,12 +146,12 @@ type Prettify<T> = {
     [K in keyof T as string extends K ? never : K]: T[K];
 } & {};
 /** Builder input types — what the user passes in config */
-type OptionInput = OptionBuilder<any, any> | FlagBuilder;
+type OptionInput = OptionBuilder<any, any> | FlagBuilder<any>;
 type OptionsInput = Record<string, OptionInput>;
 type ArgsInput = readonly ArgBuilder<any, any, any>[];
 /** Infer the value types from option builder instances (handler signature) */
 type InferOptionsFromInput<T extends OptionsInput> = {
-    [K in keyof T]: T[K] extends OptionBuilder<infer V, any> ? V : T[K] extends FlagBuilder ? boolean : never;
+    [K in keyof T]: T[K] extends OptionBuilder<infer V, any> ? V : T[K] extends FlagBuilder<true> ? number : T[K] extends FlagBuilder ? boolean : never;
 };
 /** Infer positional arg types from arg builder instances (handler signature) */
 type InferArgsFromInput<T extends ArgsInput> = {
@@ -153,9 +159,9 @@ type InferArgsFromInput<T extends ArgsInput> = {
 };
 /** Infer invoke() options: required options mandatory, defaulted/optional/flags optional */
 type InferInvokeOptions<T extends OptionsInput> = {
-    [K in keyof T as T[K] extends FlagBuilder ? never : T[K] extends OptionBuilder<infer V, infer D> ? [D] extends [true] ? never : undefined extends V ? never : K : never]: T[K] extends OptionBuilder<infer V, any> ? V : never;
+    [K in keyof T as T[K] extends FlagBuilder<any> ? never : T[K] extends OptionBuilder<infer V, infer D> ? [D] extends [true] ? never : undefined extends V ? never : K : never]: T[K] extends OptionBuilder<infer V, any> ? V : never;
 } & {
-    [K in keyof T as T[K] extends FlagBuilder ? K : T[K] extends OptionBuilder<infer V, infer D> ? [D] extends [true] ? K : undefined extends V ? K : never : never]?: T[K] extends OptionBuilder<infer V, any> ? V : T[K] extends FlagBuilder ? boolean : never;
+    [K in keyof T as T[K] extends FlagBuilder<any> ? K : T[K] extends OptionBuilder<infer V, infer D> ? [D] extends [true] ? K : undefined extends V ? K : never : never]?: T[K] extends OptionBuilder<infer V, any> ? V : T[K] extends FlagBuilder<true> ? number : T[K] extends FlagBuilder ? boolean : never;
 };
 /** Infer invoke() args: required args mandatory, defaulted/optional args optional */
 type InferInvokeArgs<T extends ArgsInput> = {

package/dist/command/index.js

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

package/dist/index.js

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

package/package.json

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