argv-flags 0.2.1 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 1.0.1 - 2026-01-30
+
+- Publish a formal JSON Schema for ParseResult and add JSON-safe conversion helper.
+- Add schema validation tests and expanded real-world parsing tests.
+
+## 1.0.0 - 2026-01-30
+
+- Adopt ESM-only packaging and require Node.js >=24.
+- Replace ad-hoc flag parsing with a schema-driven API.
+- Return structured parse results (`values`, `present`, `issues`, `rest`, `unknown`) instead of sentinel `false`.
+- Add explicit issue codes for machine-handling.
+- Document deterministic parsing rules and migration steps.

package/README.md

@@ -1,62 +1,193 @@
 # argv-flags
 
-Tiny helper for parsing simple CLI flags from `process.argv`.
+Schema-driven CLI flag parsing for Node.js 24+. Deterministic rules, typed output, and a machine-consumable result model.
 
-## Installation
+## Install
 
 ```sh
 npm install argv-flags
 ```
 
-## Usage
+## Quick start
 
 ```js
-const parseFlag = require('argv-flags');
+import { defineSchema, parseArgs, toJsonResult } from 'argv-flags';
 
-const name = parseFlag('--name', 'string');
-const enabled = parseFlag('--enabled', 'boolean');
-const count = parseFlag('--count', 'number');
-const items = parseFlag('--items', 'array');
+const schema = defineSchema({
+  src: { type: 'string', flags: ['--src'], required: true },
+  dest: { type: 'string', flags: ['--dest'], required: true },
+  exclude: { type: 'array', flags: ['--exclude'], default: [] },
+  verbose: { type: 'boolean', flags: ['--verbose'], default: false }
+});
+
+const result = parseArgs(schema);
+
+if (!result.ok) {
+  console.error(result.issues);
+  process.exitCode = 1;
+}
+
+console.log(result.values.src, result.values.dest);
+```
+
+## API
+
+```ts
+defineSchema<T extends Schema>(schema: T): T
+parseArgs<T extends Schema>(schema: T, options?: ParseOptions): ParseResult<T>
+toJsonResult<T extends Schema>(result: ParseResult<T>): ParseResultJson
 ```
 
-### Inline values
+### Schema
 
-Flags can be passed as `--flag=value` for string, number, boolean, and array types:
+```ts
+type FlagType = 'string' | 'boolean' | 'number' | 'array';
 
-```sh
---enabled=false
---count=5
---items=a b
+interface FlagSpec<T extends FlagType = FlagType> {
+  type: T;
+  flags: readonly string[];
+  required?: boolean;
+  default?: FlagValue<T>;
+  allowEmpty?: boolean;
+  allowNo?: boolean;
+}
 ```
 
-### Boolean flags
+Notes:
+- `flags` must include at least one flag token (`-x` or `--long`).
+- `default` is cloned for arrays to avoid shared references.
+- `allowNo` enables `--no-<flag>` for boolean specs (default: `true`).
+- `allowEmpty` allows empty string/array values (default: `false`).
 
-Boolean flags accept explicit values when provided:
+### Parse options
 
-```sh
---enabled true
---enabled false
+```ts
+interface ParseOptions {
+  argv?: readonly string[];
+  allowUnknown?: boolean;
+  stopAtDoubleDash?: boolean;
+}
 ```
 
-If no value is provided, the presence of the flag returns `true`.
+- `argv`: defaults to `process.argv.slice(2)`.
+- `allowUnknown`: when `true`, unknown flags are collected instead of erroring.
+- `stopAtDoubleDash`: when `true` (default), `--` stops flag parsing and the rest is returned as `rest`.
+
+## Output contract (machine-readable)
+
+```ts
+interface ParseResult<S extends Schema> {
+  values: { [K in keyof S]: FlagValue<S[K]['type']> | undefined };
+  present: { [K in keyof S]: boolean };
+  rest: string[];
+  unknown: string[];
+  issues: ParseIssue[];
+  ok: boolean;
+}
+```
+
+### JSON Schema (ParseResult)
 
-### Array flags
+`schema/parse-result.schema.json` defines the JSON-serializable shape of `ParseResult`.
 
-Array flags collect values until the next `--flag`:
+Use `toJsonResult()` to convert `undefined` values to `null` before validation:
+
+```js
+import { parseArgs, toJsonResult } from 'argv-flags';
+import Ajv from 'ajv';
+import schema from 'argv-flags/schema/parse-result.schema.json' assert { type: 'json' };
+
+const result = parseArgs(schemaDef);
+const jsonResult = toJsonResult(result);
+
+const ajv = new Ajv({ allErrors: true });
+const validate = ajv.compile(schema);
+console.log(validate(jsonResult)); // true/false
+```
+
+### `issues`
+
+Each issue is explicit and stable:
+
+```ts
+type IssueCode =
+  | 'UNKNOWN_FLAG'
+  | 'MISSING_VALUE'
+  | 'INVALID_VALUE'
+  | 'REQUIRED'
+  | 'DUPLICATE'
+  | 'EMPTY_VALUE';
+
+interface ParseIssue {
+  code: IssueCode;
+  severity: 'error' | 'warning';
+  message: string;
+  flag?: string;
+  key?: string;
+  value?: string;
+  index?: number;
+}
+```
+
+`ok` is `true` only when no `error`-severity issues exist.
+
+## Parsing rules (deterministic)
+
+Rules are applied in order:
+1. `--` stops flag parsing (when enabled) and the rest becomes `rest`.
+2. Non-flag tokens (`-` or plain values) become `rest`.
+3. `--no-<flag>` maps to the matching boolean spec if present and `allowNo !== false`.
+4. Inline values (`--flag=value`) are parsed before consuming the next argv token.
+5. Arrays collect values until the next flag token or `--`.
+6. Duplicate non-array flags are warnings; duplicate arrays append.
+7. Required flags missing at the end produce `REQUIRED` errors.
+
+## Value parsing
+
+- `boolean`: `true|false|1|0|yes|no|on|off` (case-insensitive).  
+  When no explicit value is provided, presence means `true`.
+- `number`: `Number(value)` must be finite. Negative numbers are accepted.
+- `string`: values are taken as-is; empty strings are rejected unless `allowEmpty`.
+- `array`: collects tokens until the next flag token; empty arrays are rejected unless `allowEmpty`.
+
+## Examples
 
 ```sh
+--flag
+--flag=true
+--count=-3
 --items a b c --other
+-- --literal --values
+--no-verbose
 ```
 
-### Testing / custom argv
+## Versioning and migration
 
-You can pass a custom argv array (useful for tests):
+### 1.0.0
 
-```js
-const argv = ['node', 'script.js', '--flag', 'true'];
-parseFlag('--flag', 'boolean', argv);
+This release is intentionally strict and schema-driven:
+
+- ESM-only (Node.js >=24).
+- Typed schema is the single source of truth.
+- Parsing returns a structured result object rather than sentinel `false` values.
+
+Migration from 0.x:
+
+```diff
+- const parseFlag = require('argv-flags');
+- const name = parseFlag('--name', 'string');
++ import { defineSchema, parseArgs } from 'argv-flags';
++ const schema = defineSchema({ name: { type: 'string', flags: ['--name'] } });
++ const result = parseArgs(schema);
++ const name = result.values.name;
 ```
 
+## Guarantees
+
+- Deterministic output for a given `argv`.
+- No mutation of the input `argv`.
+- Stable issue codes for programmatic handling.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+export type FlagType = 'string' | 'boolean' | 'number' | 'array';
+export type FlagValue<T extends FlagType> = T extends 'string' ? string : T extends 'boolean' ? boolean : T extends 'number' ? number : T extends 'array' ? string[] : never;
+export interface FlagSpec<T extends FlagType = FlagType> {
+    type: T;
+    flags: readonly string[];
+    required?: boolean;
+    default?: FlagValue<T>;
+    allowEmpty?: boolean;
+    allowNo?: boolean;
+}
+export type Schema = Record<string, FlagSpec>;
+export type IssueSeverity = 'error' | 'warning';
+export type IssueCode = 'UNKNOWN_FLAG' | 'MISSING_VALUE' | 'INVALID_VALUE' | 'REQUIRED' | 'DUPLICATE' | 'EMPTY_VALUE';
+export interface ParseIssue {
+    code: IssueCode;
+    severity: IssueSeverity;
+    message: string;
+    flag?: string;
+    key?: string;
+    value?: string;
+    index?: number;
+}
+export interface ParseOptions {
+    argv?: readonly string[];
+    allowUnknown?: boolean;
+    stopAtDoubleDash?: boolean;
+}
+export type ParsedValues<S extends Schema> = {
+    [K in keyof S]: FlagValue<S[K]['type']> | undefined;
+};
+export type ParsedPresent<S extends Schema> = {
+    [K in keyof S]: boolean;
+};
+export interface ParseResult<S extends Schema> {
+    values: ParsedValues<S>;
+    present: ParsedPresent<S>;
+    rest: string[];
+    unknown: string[];
+    issues: ParseIssue[];
+    ok: boolean;
+}
+export type JsonFlagValue = string | number | boolean | string[] | null;
+export interface ParseResultJson {
+    values: Record<string, JsonFlagValue>;
+    present: Record<string, boolean>;
+    rest: string[];
+    unknown: string[];
+    issues: ParseIssue[];
+    ok: boolean;
+}
+export declare const defineSchema: <T extends Schema>(schema: T) => T;
+export declare const parseArgs: <T extends Schema>(schema: T, options?: ParseOptions) => ParseResult<T>;
+export default parseArgs;
+export declare const toJsonResult: <T extends Schema>(result: ParseResult<T>) => ParseResultJson;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,337 @@
+const BOOLEAN_TRUE = new Set(['true', '1', 'yes', 'y', 'on']);
+const BOOLEAN_FALSE = new Set(['false', '0', 'no', 'n', 'off']);
+const isFlagToken = (value) => typeof value === 'string' && value.startsWith('-') && value.length > 1;
+const normalizeBoolean = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.toLowerCase();
+    if (BOOLEAN_TRUE.has(normalized))
+        return true;
+    if (BOOLEAN_FALSE.has(normalized))
+        return false;
+    return undefined;
+};
+const isNumericValue = (value) => {
+    if (typeof value !== 'string' || value.length === 0)
+        return false;
+    const parsed = Number(value);
+    return Number.isFinite(parsed);
+};
+const cloneDefault = (value, type) => {
+    if (type === 'array' && Array.isArray(value)) {
+        return [...value];
+    }
+    return value;
+};
+const splitInlineValue = (token) => {
+    const eqIndex = token.indexOf('=');
+    if (eqIndex <= 0)
+        return { flag: token };
+    return { flag: token.slice(0, eqIndex), value: token.slice(eqIndex + 1) };
+};
+const validateSchema = (schema) => {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema)) {
+        throw new TypeError('Schema must be an object.');
+    }
+    const flagToKey = new Map();
+    const normalized = new Map();
+    for (const [rawKey, rawSpec] of Object.entries(schema)) {
+        const key = rawKey;
+        const spec = rawSpec;
+        if (!spec || typeof spec !== 'object') {
+            throw new TypeError(`Schema entry for "${String(key)}" must be an object.`);
+        }
+        const type = spec.type;
+        if (!['string', 'boolean', 'number', 'array'].includes(type)) {
+            throw new TypeError(`Schema entry "${String(key)}" has invalid type "${String(type)}".`);
+        }
+        const flagsInput = spec.flags;
+        if (!Array.isArray(flagsInput) || flagsInput.length === 0) {
+            throw new TypeError(`Schema entry "${String(key)}" must define at least one flag.`);
+        }
+        const flags = [];
+        for (const flag of flagsInput) {
+            if (typeof flag !== 'string' || flag.length < 2 || !flag.startsWith('-')) {
+                throw new TypeError(`Schema entry "${String(key)}" has invalid flag "${String(flag)}".`);
+            }
+            if (flagToKey.has(flag)) {
+                const existing = flagToKey.get(flag);
+                throw new TypeError(`Flag "${flag}" is already assigned to "${String(existing)}".`);
+            }
+            flagToKey.set(flag, key);
+            flags.push(flag);
+        }
+        const longFlag = flags.find((flag) => flag.startsWith('--'));
+        const normalizedSpec = {
+            ...spec,
+            type,
+            flags,
+            ...(longFlag ? { longFlag } : {})
+        };
+        normalized.set(key, normalizedSpec);
+    }
+    return { flagToKey, normalized };
+};
+export const defineSchema = (schema) => schema;
+export const parseArgs = (schema, options = {}) => {
+    const { flagToKey, normalized } = validateSchema(schema);
+    const argv = Array.isArray(options.argv) ? options.argv : process.argv.slice(2);
+    const allowUnknown = options.allowUnknown === true;
+    const stopAtDoubleDash = options.stopAtDoubleDash !== false;
+    const values = {};
+    const present = {};
+    const issues = [];
+    const unknown = [];
+    const rest = [];
+    for (const [key, spec] of normalized.entries()) {
+        present[key] = false;
+        values[key] = cloneDefault(spec.default, spec.type);
+    }
+    const pushIssue = (issue) => {
+        issues.push(issue);
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (stopAtDoubleDash && token === '--') {
+            rest.push(...argv.slice(i + 1));
+            break;
+        }
+        if (!isFlagToken(token)) {
+            rest.push(token);
+            continue;
+        }
+        const rawToken = token;
+        const { flag, value: inlineValue } = splitInlineValue(token);
+        if (flag.startsWith('--no-') && !flagToKey.has(flag)) {
+            const base = `--${flag.slice(5)}`;
+            const baseKey = flagToKey.get(base);
+            if (baseKey) {
+                const baseSpec = normalized.get(baseKey);
+                if (baseSpec?.type === 'boolean' && baseSpec.allowNo !== false) {
+                    if (present[baseKey]) {
+                        pushIssue({
+                            code: 'DUPLICATE',
+                            severity: 'warning',
+                            message: `Duplicate flag ${base}.`,
+                            flag: base,
+                            key: String(baseKey),
+                            index: i
+                        });
+                    }
+                    present[baseKey] = true;
+                    values[baseKey] = false;
+                    continue;
+                }
+            }
+        }
+        const key = flagToKey.get(flag);
+        if (!key) {
+            if (!allowUnknown) {
+                pushIssue({
+                    code: 'UNKNOWN_FLAG',
+                    severity: 'error',
+                    message: `Unknown flag ${flag}.`,
+                    flag,
+                    index: i
+                });
+            }
+            else {
+                unknown.push(rawToken);
+            }
+            continue;
+        }
+        const spec = normalized.get(key);
+        if (!spec) {
+            continue;
+        }
+        const wasPresent = present[key];
+        if (wasPresent && spec.type !== 'array') {
+            pushIssue({
+                code: 'DUPLICATE',
+                severity: 'warning',
+                message: `Duplicate flag ${flag}.`,
+                flag,
+                key: String(key),
+                index: i
+            });
+        }
+        present[key] = true;
+        if (spec.type === 'boolean') {
+            let raw = inlineValue;
+            let consumedNext = false;
+            if (raw === undefined) {
+                const nextValue = argv[i + 1];
+                const normalizedValue = normalizeBoolean(nextValue);
+                if (normalizedValue !== undefined) {
+                    raw = nextValue;
+                    consumedNext = true;
+                }
+            }
+            if (raw !== undefined) {
+                const normalizedValue = normalizeBoolean(raw);
+                if (normalizedValue === undefined) {
+                    pushIssue({
+                        code: 'INVALID_VALUE',
+                        severity: 'error',
+                        message: `Invalid boolean value for ${flag}: ${raw}.`,
+                        flag,
+                        key: String(key),
+                        value: raw,
+                        index: i
+                    });
+                }
+                else {
+                    values[key] = normalizedValue;
+                    if (consumedNext) {
+                        i += 1;
+                    }
+                }
+            }
+            else {
+                values[key] = true;
+            }
+            continue;
+        }
+        if (spec.type === 'string') {
+            let raw = inlineValue;
+            if (raw === undefined) {
+                const nextValue = argv[i + 1];
+                if (typeof nextValue !== 'string' || isFlagToken(nextValue)) {
+                    pushIssue({
+                        code: 'MISSING_VALUE',
+                        severity: 'error',
+                        message: `Missing value for ${flag}.`,
+                        flag,
+                        key: String(key),
+                        index: i
+                    });
+                    continue;
+                }
+                raw = nextValue;
+                i += 1;
+            }
+            if (raw.length === 0 && spec.allowEmpty !== true) {
+                pushIssue({
+                    code: 'EMPTY_VALUE',
+                    severity: 'error',
+                    message: `Empty value not allowed for ${flag}.`,
+                    flag,
+                    key: String(key),
+                    index: i
+                });
+                continue;
+            }
+            values[key] = raw;
+            continue;
+        }
+        if (spec.type === 'number') {
+            let raw = inlineValue;
+            if (raw === undefined) {
+                const nextValue = argv[i + 1];
+                if (typeof nextValue !== 'string' || (!isNumericValue(nextValue) && isFlagToken(nextValue))) {
+                    pushIssue({
+                        code: 'MISSING_VALUE',
+                        severity: 'error',
+                        message: `Missing value for ${flag}.`,
+                        flag,
+                        key: String(key),
+                        index: i
+                    });
+                    continue;
+                }
+                raw = nextValue;
+                i += 1;
+            }
+            if (!isNumericValue(raw)) {
+                pushIssue({
+                    code: 'INVALID_VALUE',
+                    severity: 'error',
+                    message: `Invalid number value for ${flag}: ${raw}.`,
+                    flag,
+                    key: String(key),
+                    value: raw,
+                    index: i
+                });
+                continue;
+            }
+            values[key] = Number(raw);
+            continue;
+        }
+        if (spec.type === 'array') {
+            const collected = [];
+            if (inlineValue !== undefined && inlineValue.length > 0) {
+                collected.push(inlineValue);
+            }
+            let cursor = i + 1;
+            while (cursor < argv.length) {
+                const nextValue = argv[cursor];
+                if (stopAtDoubleDash && nextValue === '--') {
+                    break;
+                }
+                if (isFlagToken(nextValue)) {
+                    break;
+                }
+                collected.push(nextValue);
+                cursor += 1;
+            }
+            if (cursor > i + 1) {
+                i = cursor - 1;
+            }
+            if (collected.length === 0 && spec.allowEmpty !== true) {
+                pushIssue({
+                    code: 'MISSING_VALUE',
+                    severity: 'error',
+                    message: `Missing value for ${flag}.`,
+                    flag,
+                    key: String(key),
+                    index: i
+                });
+                continue;
+            }
+            const existing = Array.isArray(values[key]) ? values[key] : [];
+            values[key] = [...existing, ...collected];
+            continue;
+        }
+    }
+    for (const [key, spec] of normalized.entries()) {
+        if (spec.required && !present[key]) {
+            const primaryFlag = spec.flags[0];
+            pushIssue({
+                code: 'REQUIRED',
+                severity: 'error',
+                message: `Missing required flag ${primaryFlag ?? ''}.`,
+                ...(primaryFlag ? { flag: primaryFlag } : {}),
+                key: String(key)
+            });
+        }
+    }
+    const ok = issues.every((issue) => issue.severity !== 'error');
+    return {
+        values,
+        present,
+        rest,
+        unknown,
+        issues,
+        ok
+    };
+};
+export default parseArgs;
+export const toJsonResult = (result) => {
+    const values = {};
+    for (const [key, value] of Object.entries(result.values)) {
+        if (value === undefined) {
+            values[key] = null;
+            continue;
+        }
+        values[key] = value;
+    }
+    return {
+        values,
+        present: result.present,
+        rest: [...result.rest],
+        unknown: [...result.unknown],
+        issues: [...result.issues],
+        ok: result.ok
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,17 +1,26 @@
 {
   "name": "argv-flags",
-  "version": "0.2.1",
-  "description": "Minimal CLI flag parser for strings, booleans, numbers, and arrays.",
-  "main": "index.js",
-  "types": "index.d.ts",
+  "version": "1.0.1",
+  "description": "Schema-based CLI flag parser for Node.js.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "files": [
+    "CHANGELOG.md",
     "LICENSE",
     "README.md",
-    "index.js",
-    "index.d.ts"
+    "dist",
+    "schema"
   ],
   "scripts": {
-    "test": "node --test"
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test"
   },
   "repository": {
     "type": "git",
@@ -30,6 +39,11 @@
   },
   "homepage": "https://github.com/Ismail-elkorchi/argv-flags#readme",
   "engines": {
-    "node": ">=18"
+    "node": ">=24"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "ajv": "^8.17.1",
+    "typescript": "^5.5.4"
   }
 }

package/schema/parse-result.schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schema.argv-flags.dev/parse-result.schema.json",
+  "title": "argv-flags ParseResult (JSON)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["values", "present", "rest", "unknown", "issues", "ok"],
+  "properties": {
+    "values": {
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          { "type": "null" }
+        ]
+      }
+    },
+    "present": {
+      "type": "object",
+      "additionalProperties": { "type": "boolean" }
+    },
+    "rest": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "unknown": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["code", "severity", "message"],
+        "properties": {
+          "code": {
+            "type": "string",
+            "enum": [
+              "UNKNOWN_FLAG",
+              "MISSING_VALUE",
+              "INVALID_VALUE",
+              "REQUIRED",
+              "DUPLICATE",
+              "EMPTY_VALUE"
+            ]
+          },
+          "severity": { "type": "string", "enum": ["error", "warning"] },
+          "message": { "type": "string" },
+          "flag": { "type": "string" },
+          "key": { "type": "string" },
+          "value": { "type": "string" },
+          "index": { "type": "integer", "minimum": 0 }
+        }
+      }
+    },
+    "ok": { "type": "boolean" }
+  }
+}

package/index.d.ts

@@ -1,7 +0,0 @@
-declare function parseFlag(
-	flag: string,
-	type?: 'string' | 'boolean' | 'array' | 'number',
-	argv?: string[]
-): string | boolean | string[] | number | false;
-
-export = parseFlag;

package/index.js

@@ -1,95 +0,0 @@
-'use strict';
-
-const isLongFlag = ( value ) => typeof value === 'string' && value.startsWith( '--' );
-
-const normalizeBooleanValue = ( value ) => {
-	if ( typeof value !== 'string' ) {
-		return undefined;
-	}
-	const normalized = value.toLowerCase();
-	if ( normalized === 'true' ) {
-		return true;
-	}
-	if ( normalized === 'false' ) {
-		return false;
-	}
-	return undefined;
-};
-
-const findFlagMatch = ( argv, targetArgument ) => {
-	const directIndex = argv.indexOf( targetArgument );
-	if ( directIndex !== -1 ) {
-		return { index: directIndex };
-	}
-
-	const prefix = `${targetArgument}=`;
-	const inlineIndex = argv.findIndex( ( value ) => typeof value === 'string' && value.startsWith( prefix ) );
-	if ( inlineIndex === -1 ) {
-		return null;
-	}
-
-	return {
-		index: inlineIndex,
-		inlineValue: argv[ inlineIndex ].slice( prefix.length )
-	};
-};
-
-function parseFlag( targetArgument, argumentType, argv = process.argv ) {
-	const processArguments = Array.isArray( argv ) ? argv : process.argv;
-	const match = findFlagMatch( processArguments, targetArgument );
-
-	if ( ! match ) {
-		return false;
-	}
-
-	const inlineValue = Object.prototype.hasOwnProperty.call( match, 'inlineValue' )
-		? match.inlineValue
-		: undefined;
-	const nextValue = processArguments[ match.index + 1 ];
-
-	if ( argumentType === 'string' ) {
-		if ( typeof inlineValue === 'string' ) {
-			return inlineValue;
-		}
-		if ( typeof nextValue !== 'string' || isLongFlag( nextValue ) ) {
-			return false;
-		}
-		return nextValue;
-	}
-
-	if ( argumentType === 'array' ) {
-		const values = [];
-		if ( typeof inlineValue === 'string' && inlineValue.length > 0 ) {
-			values.push( inlineValue );
-		}
-		for ( let i = match.index + 1; i < processArguments.length; i++ ) {
-			const value = processArguments[ i ];
-			if ( isLongFlag( value ) ) {
-				break;
-			}
-			values.push( value );
-		}
-		return values;
-	}
-
-	if ( argumentType === 'boolean' ) {
-		const normalizedValue = normalizeBooleanValue( typeof inlineValue === 'string' ? inlineValue : nextValue );
-		if ( typeof normalizedValue === 'boolean' ) {
-			return normalizedValue;
-		}
-		return true;
-	}
-
-	if ( argumentType === 'number' ) {
-		const candidate = typeof inlineValue === 'string' ? inlineValue : nextValue;
-		if ( typeof candidate !== 'string' || isLongFlag( candidate ) ) {
-			return false;
-		}
-		const parsed = Number( candidate );
-		return Number.isNaN( parsed ) ? false : parsed;
-	}
-
-	return false;
-}
-
-module.exports = parseFlag;