args-tokens 0.19.0 → 0.20.1

package/lib/index.d.ts

@@ -1,10 +1,8 @@
-import { ArgToken, ParserOptions, parseArgs$1 as parseArgs } from "./parser-Bx112mWZ.js";
-import { ArgResolveError$1 as ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ResolveArgs, resolveArgs$1 as resolveArgs } from "./resolver-COGeGqd3.js";
+import { ArgToken, ParserOptions, parseArgs$1 as parseArgs } from "./parser-FiQIAw-2.js";
+import { ArgResolveError$1 as ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ResolveArgs, resolveArgs$1 as resolveArgs } from "./resolver-U72Jg6Ll.js";
 
 //#region src/parse.d.ts
-/**
-* Parse options for {@link parse} function.
-*/
+
 /**
 * Parse options for {@link parse} function.
 */
@@ -54,5 +52,6 @@ type ParsedArgs<A extends Args> = {
 * @param options - parse options, about details see {@link ParseOptions}
 * @returns An object that contains the values of the arguments, positional arguments, {@link AggregateError | validation errors}, and {@link ArgToken | argument tokens}.
 */
-declare function parse<A extends Args>(args: string[], options?: ParseOptions<A>): ParsedArgs<A>; //#endregion
+declare function parse<A extends Args>(args: string[], options?: ParseOptions<A>): ParsedArgs<A>;
+//#endregion
 export { ArgResolveError, ArgResolveErrorType, ArgSchema, ArgToken, ArgValues, Args, ParseOptions, ParsedArgs, ParserOptions, ResolveArgs, parse, parseArgs, resolveArgs };

package/lib/index.js

@@ -1,5 +1,6 @@
 import { parseArgs } from "./parser-Dr4iAGaX.js";
-import { ArgResolveError, resolveArgs } from "./resolver-Df1uPA8Z.js";
+import "./utils-N7UlhLbz.js";
+import { ArgResolveError, resolveArgs } from "./resolver-Q4k2fgTW.js";
 
 //#region src/parse.ts
 const DEFAULT_OPTIONS = {

package/lib/{parser-Bx112mWZ.d.ts → parser-FiQIAw-2.d.ts}

@@ -86,5 +86,6 @@ declare function isShortOption(arg: string): boolean;
 * @param arg the argument to check
 * @returns whether `arg` is a long option prefix.
 */
-declare function hasLongOptionPrefix(arg: string): boolean; //#endregion
+declare function hasLongOptionPrefix(arg: string): boolean;
+//#endregion
 export { ArgToken, ParserOptions, hasLongOptionPrefix as hasLongOptionPrefix$1, isShortOption as isShortOption$1, parseArgs as parseArgs$1 };

package/lib/parser.d.ts

@@ -1,2 +1,2 @@
-import { ArgToken, ParserOptions, hasLongOptionPrefix$1 as hasLongOptionPrefix, isShortOption$1 as isShortOption, parseArgs$1 as parseArgs } from "./parser-Bx112mWZ.js";
+import { ArgToken, ParserOptions, hasLongOptionPrefix$1 as hasLongOptionPrefix, isShortOption$1 as isShortOption, parseArgs$1 as parseArgs } from "./parser-FiQIAw-2.js";
 export { ArgToken, ParserOptions, hasLongOptionPrefix, isShortOption, parseArgs };

package/lib/{resolver-Df1uPA8Z.js → resolver-Q4k2fgTW.js}

@@ -1,10 +1,8 @@
 import { hasLongOptionPrefix, isShortOption } from "./parser-Dr4iAGaX.js";
+import { kebabnize } from "./utils-N7UlhLbz.js";
 
 //#region src/resolver.ts
 const SKIP_POSITIONAL_DEFAULT = -1;
-function kebabnize(str) {
-	return str.replace(/[A-Z]/g, (match, offset) => (offset > 0 ? "-" : "") + match.toLowerCase());
-}
 /**
 * Resolve command line arguments.
 * @param args - An arguments that contains {@link ArgSchema | arguments schema}.

package/lib/{resolver-COGeGqd3.d.ts → resolver-U72Jg6Ll.d.ts}

@@ -1,14 +1,7 @@
-import { ArgToken } from "./parser-Bx112mWZ.js";
+import { ArgToken } from "./parser-FiQIAw-2.js";
 
 //#region src/resolver.d.ts
-/**
-* An argument schema
-* This schema is similar to the schema of the `node:utils`.
-* difference is that:
-* - `required` property and `description` property are added
-* - `type` is not only 'string' and 'boolean', but also 'number', 'enum', 'positional', 'custom' too.
-* - `default` property type, not support multiple types
-*/
+
 /**
 * An argument schema
 * This schema is similar to the schema of the `node:utils`.
@@ -87,12 +80,16 @@ type ResolveOptionValue<A extends ArgSchema, T> = A["multiple"] extends true ? T
 /**
 * @internal
 */
-type ResolveArgValues<A extends Args, V extends Record<keyof A, unknown>> = { -readonly [Arg in keyof A]?: V[Arg] } & FilterArgs<A, V, "default"> & FilterArgs<A, V, "required"> extends infer P ? { [K in keyof P]: P[K] } : never;
+type ResolveArgValues<A extends Args, V extends Record<keyof A, unknown>> = { -readonly [Arg in keyof A]?: V[Arg] } & FilterArgs<A, V, "default"> & FilterArgs<A, V, "required"> & FilterPositionalArgs<A, V> extends infer P ? { [K in keyof P]: P[K] } : never;
 /**
 * @internal
 */
 type FilterArgs<A extends Args, V extends Record<keyof A, unknown>, K extends keyof ArgSchema> = { [Arg in keyof A as A[Arg][K] extends {} ? Arg : never]: V[Arg] };
 /**
+* @internal
+*/
+type FilterPositionalArgs<A extends Args, V extends Record<keyof A, unknown>> = { [Arg in keyof A as A[Arg]["type"] extends "positional" ? Arg : never]: V[Arg] };
+/**
 * An arguments for {@link resolveArgs | resolve arguments}.
 */
 interface ResolveArgs {
@@ -144,6 +141,5 @@ declare class ArgResolveError extends Error {
   type: ArgResolveErrorType;
   constructor(message: string, name: string, type: ArgResolveErrorType, schema: ArgSchema);
 }
-
 //#endregion
-export { ArgResolveError as ArgResolveError$1, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, ResolveArgValues, ResolveArgs, resolveArgs as resolveArgs$1 };
+export { ArgResolveError as ArgResolveError$1, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, FilterPositionalArgs, ResolveArgValues, ResolveArgs, resolveArgs as resolveArgs$1 };

package/lib/resolver.d.ts

@@ -1,3 +1,3 @@
-import "./parser-Bx112mWZ.js";
-import { ArgResolveError$1 as ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, ResolveArgValues, ResolveArgs, resolveArgs$1 as resolveArgs } from "./resolver-COGeGqd3.js";
-export { ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, ResolveArgValues, ResolveArgs, resolveArgs };
+import "./parser-FiQIAw-2.js";
+import { ArgResolveError$1 as ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, FilterPositionalArgs, ResolveArgValues, ResolveArgs, resolveArgs$1 as resolveArgs } from "./resolver-U72Jg6Ll.js";
+export { ArgResolveError, ArgResolveErrorType, ArgSchema, ArgValues, Args, ExtractOptionValue, FilterArgs, FilterPositionalArgs, ResolveArgValues, ResolveArgs, resolveArgs };

package/lib/resolver.js

@@ -1,4 +1,5 @@
 import "./parser-Dr4iAGaX.js";
-import { ArgResolveError, resolveArgs } from "./resolver-Df1uPA8Z.js";
+import "./utils-N7UlhLbz.js";
+import { ArgResolveError, resolveArgs } from "./resolver-Q4k2fgTW.js";
 
 export { ArgResolveError, resolveArgs };

package/lib/utils-N7UlhLbz.js

@@ -0,0 +1,18 @@
+//#region src/utils.ts
+/**
+* Entry point of utils.
+*
+* Note that this entry point is used by gunshi to import utility functions.
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+function kebabnize(str) {
+	return str.replace(/[A-Z]/g, (match, offset) => (offset > 0 ? "-" : "") + match.toLowerCase());
+}
+
+//#endregion
+export { kebabnize };

package/lib/utils.d.ts

@@ -0,0 +1,15 @@
+//#region src/utils.d.ts
+/**
+* Entry point of utils.
+*
+* Note that this entry point is used by gunshi to import utility functions.
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+declare function kebabnize(str: string): string;
+//#endregion
+export { kebabnize };

package/lib/utils.js

@@ -0,0 +1,3 @@
+import { kebabnize } from "./utils-N7UlhLbz.js";
+
+export { kebabnize };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "args-tokens",
   "description": "parseArgs tokens compatibility and more high-performance parser",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -52,6 +52,12 @@
       "require": "./lib/resolver.js",
       "default": "./lib/resolver.js"
     },
+    "./utils": {
+      "types": "./lib/utils.d.ts",
+      "import": "./lib/utils.js",
+      "require": "./lib/utils.js",
+      "default": "./lib/utils.js"
+    },
     "./package.json": "./package.json",
     "./*": "./*"
   },
@@ -68,11 +74,11 @@
     "@eslint/markdown": "^6.4.0",
     "@kazupon/eslint-config": "^0.29.0",
     "@kazupon/prettier-config": "^0.1.1",
-    "@types/node": "^22.15.21",
-    "@typescript/native-preview": "7.0.0-dev.20250525.1",
-    "@vitest/eslint-plugin": "^1.2.0",
+    "@types/node": "^22.15.27",
+    "@typescript/native-preview": "7.0.0-dev.20250529.1",
+    "@vitest/eslint-plugin": "^1.2.1",
     "bumpp": "^10.1.1",
-    "deno": "^2.3.3",
+    "deno": "^2.3.4",
     "eslint": "^9.27.0",
     "eslint-config-prettier": "^10.1.5",
     "eslint-plugin-jsonc": "^2.20.1",
@@ -83,16 +89,16 @@
     "gh-changelogen": "^0.2.8",
     "jsr": "^0.13.4",
     "jsr-exports-lint": "^0.4.0",
-    "knip": "^5.57.1",
-    "lint-staged": "^15.5.2",
+    "knip": "^5.59.1",
+    "lint-staged": "^16.0.0",
     "mitata": "^1.0.34",
-    "pkg-pr-new": "^0.0.50",
+    "pkg-pr-new": "^0.0.51",
     "prettier": "^3.5.3",
-    "tsdown": "^0.12.1",
+    "tsdown": "^0.12.4",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1",
+    "typescript-eslint": "^8.33.0",
     "vitest": "^3.1.4",
-    "zod": "^3.25.28"
+    "zod": "^3.25.41"
   },
   "prettier": "@kazupon/prettier-config",
   "lint-staged": {