@gunshi/bone 0.34.0 → 0.35.1

package/lib/index.d.ts

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/parser-DT7Ztcch.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/parser-DT7Ztcch.d.ts
 //#region src/parser.d.ts
 /**
  * Entry point of argument parser.
@@ -55,13 +55,13 @@ interface ArgToken {
  * Parser Options.
  */
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/resolver.d.ts
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/resolver.d.ts
 //#region src/resolver.d.ts
 /**
  * An argument schema definition for command-line argument parsing.
  *
  * This schema is similar to the schema of Node.js `util.parseArgs` but with extended features:
- * - Additional `required` and `description` properties
+ * - Additional `required`, `description`, and `hidden` properties
  * - Extended `type` support: 'string', 'boolean', 'number', 'enum', 'positional', 'custom'
  * - Simplified `default` property (single type, not union types)
  *
@@ -166,6 +166,25 @@ interface ArgSchema {
    * ```
    */
   description?: string;
+  /**
+   * Hide the argument from generated help or usage output.
+   *
+   * This is metadata for renderers. It does not affect parsing, validation,
+   * required checks, defaults, conflicts, or resolved values.
+   *
+   * @example
+   * Hidden compatibility option:
+   * ```ts
+   * {
+   *   legacy: {
+   *     type: 'string',
+   *     hidden: true,
+   *     description: 'Deprecated compatibility option'
+   *   }
+   * }
+   * ```
+   */
+  hidden?: boolean;
   /**
    * Marks the argument as required.
    *

package/lib/index.js

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/parser.js
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/parser.js
 /**
 * forked from `nodejs/node` (`pkgjs/parseargs`)
 * repository url: https://github.com/nodejs/node (https://github.com/pkgjs/parseargs)
@@ -203,7 +203,7 @@ function hasOptionValue(value) {
 	return !(value == null) && value.codePointAt(0) !== HYPHEN_CODE;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/utils.js
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/utils.js
 /**
 * Entry point of utils.
 *
@@ -225,7 +225,7 @@ function kebabnize(str) {
 	return str.replace(/[A-Z]/g, (match, offset) => (offset > 0 ? "-" : "") + match.toLowerCase());
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/resolver.js
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/resolver.js
 /**
 * Entry point of argument options resolver.
 *
@@ -387,37 +387,53 @@ function resolveArgs(args, tokens, { shortGrouping = false, skipPositional = SKI
 		explicit[rawArg] = false;
 		if (schema.type === "positional") {
 			if (skipPositionalIndex > SKIP_POSITIONAL_DEFAULT) while (positionalsCount <= getPositionalSkipIndex()) positionalsCount++;
-			const requiredPositionals = getRequiredPositionalsAfter(rawArg);
-			const availablePositionals = Math.max(positionalTokens.length - positionalsCount, 0);
 			if (schema.multiple) {
-				const positionalsToConsume = Math.max(availablePositionals - requiredPositionals, 0);
-				const remainingPositionals = positionalTokens.slice(positionalsCount, positionalsCount + positionalsToConsume);
-				if (remainingPositionals.length > 0) {
-					if (typeof schema.parse === "function") {
-						const parsed = [];
-						for (const p of remainingPositionals) try {
-							parsed.push(schema.parse(p.value));
-						} catch (error) {
-							errors.push(error);
+				const availablePositionals = Math.max(positionalTokens.length - positionalsCount, 0);
+				if (availablePositionals > 0) {
+					const requiredPositionals = getRequiredPositionalsAfter(rawArg);
+					const positionalsToConsume = Math.max(availablePositionals - requiredPositionals, 0);
+					if (positionalsToConsume > 0) {
+						const endPositionals = positionalsCount + positionalsToConsume;
+						if (typeof schema.parse === "function") {
+							const parsed = [];
+							for (let i = positionalsCount; i < endPositionals; i++) {
+								const p = positionalTokens[i];
+								try {
+									parsed.push(schema.parse(p.value));
+								} catch (error) {
+									errors.push(error);
+								}
+							}
+							values[rawArg] = parsed;
+						} else {
+							const valuesArray = [];
+							for (let i = positionalsCount; i < endPositionals; i++) valuesArray.push(positionalTokens[i].value);
+							values[rawArg] = valuesArray;
 						}
-						values[rawArg] = parsed;
-					} else values[rawArg] = remainingPositionals.map((p) => p.value);
-					positionalsCount += remainingPositionals.length;
-					explicit[rawArg] = true;
+						positionalsCount = endPositionals;
+						explicit[rawArg] = true;
+					} else if (schema.required) errors.push(createRequireError(arg, schema));
 				} else if (schema.required) errors.push(createRequireError(arg, schema));
 			} else {
 				const positional = positionalTokens[positionalsCount];
-				if (positional != null && (shouldRequireMissingSinglePositional(schema) || availablePositionals > requiredPositionals)) {
-					if (typeof schema.parse === "function") try {
-						values[rawArg] = schema.parse(positional.value);
-					} catch (error) {
-						errors.push(error);
+				if (shouldRequireMissingSinglePositional(schema)) {
+					if (positional != null) {
+						resolveSinglePositionalValue(values, errors, rawArg, schema, positional);
+						explicit[rawArg] = true;
+						positionalsCount++;
+					} else errors.push(createRequireError(arg, schema));
+					continue;
+				}
+				if (positional != null) {
+					const requiredPositionals = getRequiredPositionalsAfter(rawArg);
+					if (Math.max(positionalTokens.length - positionalsCount, 0) > requiredPositionals) {
+						resolveSinglePositionalValue(values, errors, rawArg, schema, positional);
+						explicit[rawArg] = true;
+						positionalsCount++;
+						continue;
 					}
-					else values[rawArg] = positional.value;
-					explicit[rawArg] = true;
-					positionalsCount++;
-				} else if (shouldRequireMissingSinglePositional(schema)) errors.push(createRequireError(arg, schema));
-				else if (hasDefault(schema)) values[rawArg] = schema.default;
+				}
+				if (hasDefault(schema)) values[rawArg] = schema.default;
 			}
 			continue;
 		}
@@ -486,6 +502,14 @@ function parse(token, option, schema) {
 function createRequireError(option, schema) {
 	return new ArgResolveError(schema.type === "positional" ? `Positional argument '${option}' is required` : `Optional argument '--${option}' ${schema.short ? `or '-${schema.short}' ` : ""}is required`, option, "required", schema);
 }
+function resolveSinglePositionalValue(values, errors, rawArg, schema, positional) {
+	if (typeof schema.parse === "function") try {
+		values[rawArg] = schema.parse(positional.value);
+	} catch (error) {
+		errors.push(error);
+	}
+	else values[rawArg] = positional.value;
+}
 function hasDefault(schema) {
 	return schema.default != null;
 }
@@ -559,7 +583,7 @@ function checkConflicts(args, explicit, toKebab, actualInputNames) {
 	return [];
 }
 //#endregion
-//#region ../../node_modules/.pnpm/args-tokens@0.26.1/node_modules/args-tokens/lib/index.js
+//#region ../../node_modules/.pnpm/args-tokens@0.27.0/node_modules/args-tokens/lib/index.js
 /**
 * @author kazuya kawaguchi (a.k.a. kazupon)
 * @license MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gunshi/bone",
   "description": "gunshi minimum",
-  "version": "0.34.0",
+  "version": "0.35.1",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -56,10 +56,10 @@
     "jsr-exports-lint": "^0.4.2",
     "publint": "^0.3.20",
     "tsdown": "0.21.0",
-    "@gunshi/definition": "0.34.0",
-    "@gunshi/plugin-renderer": "0.34.0",
-    "gunshi": "0.34.0",
-    "@gunshi/plugin-global": "0.34.0"
+    "@gunshi/definition": "0.35.1",
+    "@gunshi/plugin-global": "0.35.1",
+    "@gunshi/plugin-renderer": "0.35.1",
+    "gunshi": "0.35.1"
   },
   "scripts": {
     "build": "tsdown",