@optique/core 1.2.0-dev.2242 → 1.2.0-dev.2244

package/dist/suggestion.cjs

@@ -283,12 +283,13 @@ function appendValueHint(base, input, candidates, options) {
 		...options
 	} : void 0);
 	const suggestionMsg = createSuggestionMessage(suggestions);
-	return suggestionMsg.length > 0 ? [
+	if (suggestionMsg.length === 0) return base;
+	return base.length > 0 ? [
 		...base,
 		require_message.lineBreak(),
 		require_message.lineBreak(),
 		...suggestionMsg
-	] : base;
+	] : suggestionMsg;
 }
 /**
 * Creates a unique key for a suggestion to enable deduplication.

package/dist/suggestion.js

@@ -283,12 +283,13 @@ function appendValueHint(base, input, candidates, options) {
 		...options
 	} : void 0);
 	const suggestionMsg = createSuggestionMessage(suggestions);
-	return suggestionMsg.length > 0 ? [
+	if (suggestionMsg.length === 0) return base;
+	return base.length > 0 ? [
 		...base,
 		lineBreak(),
 		lineBreak(),
 		...suggestionMsg
-	] : base;
+	] : suggestionMsg;
 }
 /**
 * Creates a unique key for a suggestion to enable deduplication.

package/dist/valueparser.cjs

@@ -142,9 +142,18 @@ function choice(choices, options = {}) {
 	const stringSuggest = stringOptions.suggest;
 	if (stringSuggest !== void 0) {
 		const isValidString = stringSuggest === "nearest" || stringSuggest === "never";
-		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null;
+		const isArray = Array.isArray(stringSuggest);
+		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null && !isArray;
 		const isValidFunction = typeof stringSuggest === "function";
-		if (!isValidString && !isValidObject && !isValidFunction) throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${typeof stringSuggest}: ${String(stringSuggest)}.`);
+		if (!isValidString && !isValidObject && !isValidFunction) {
+			const actualType = isArray ? "array" : stringSuggest === null ? "null" : typeof stringSuggest;
+			throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${actualType}: ${String(stringSuggest)}.`);
+		}
+		if (isValidObject) {
+			const obj = stringSuggest;
+			if (obj.maxDistance !== void 0 && (typeof obj.maxDistance !== "number" || !isFinite(obj.maxDistance))) throw new TypeError(`Expected suggest.maxDistance to be a finite number, but got ${typeof obj.maxDistance}: ${String(obj.maxDistance)}.`);
+			if (obj.maxSuggestions !== void 0 && (typeof obj.maxSuggestions !== "number" || !isFinite(obj.maxSuggestions))) throw new TypeError(`Expected suggest.maxSuggestions to be a finite number, but got ${typeof obj.maxSuggestions}: ${String(obj.maxSuggestions)}.`);
+		}
 	}
 	return {
 		mode: "sync",
@@ -269,7 +278,7 @@ function formatStringChoiceError(input, choices, invalidChoice, suggest) {
 	if (suggest === "nearest") return require_suggestion.appendValueHint(base, input, choices);
 	if (typeof suggest === "function") {
 		const hints = suggest(input, choices);
-		if (!hints || hints.length === 0) return base;
+		if (!Array.isArray(hints) || hints.length === 0) return base;
 		const suggestionMsg = require_suggestion.createSuggestionMessage(hints);
 		return suggestionMsg.length > 0 ? [
 			...base,

package/dist/valueparser.js

@@ -142,9 +142,18 @@ function choice(choices, options = {}) {
 	const stringSuggest = stringOptions.suggest;
 	if (stringSuggest !== void 0) {
 		const isValidString = stringSuggest === "nearest" || stringSuggest === "never";
-		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null;
+		const isArray = Array.isArray(stringSuggest);
+		const isValidObject = typeof stringSuggest === "object" && stringSuggest !== null && !isArray;
 		const isValidFunction = typeof stringSuggest === "function";
-		if (!isValidString && !isValidObject && !isValidFunction) throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${typeof stringSuggest}: ${String(stringSuggest)}.`);
+		if (!isValidString && !isValidObject && !isValidFunction) {
+			const actualType = isArray ? "array" : stringSuggest === null ? "null" : typeof stringSuggest;
+			throw new TypeError(`Expected suggest to be "nearest", "never", an object, or a function, but got ${actualType}: ${String(stringSuggest)}.`);
+		}
+		if (isValidObject) {
+			const obj = stringSuggest;
+			if (obj.maxDistance !== void 0 && (typeof obj.maxDistance !== "number" || !isFinite(obj.maxDistance))) throw new TypeError(`Expected suggest.maxDistance to be a finite number, but got ${typeof obj.maxDistance}: ${String(obj.maxDistance)}.`);
+			if (obj.maxSuggestions !== void 0 && (typeof obj.maxSuggestions !== "number" || !isFinite(obj.maxSuggestions))) throw new TypeError(`Expected suggest.maxSuggestions to be a finite number, but got ${typeof obj.maxSuggestions}: ${String(obj.maxSuggestions)}.`);
+		}
 	}
 	return {
 		mode: "sync",
@@ -269,7 +278,7 @@ function formatStringChoiceError(input, choices, invalidChoice, suggest) {
 	if (suggest === "nearest") return appendValueHint(base, input, choices);
 	if (typeof suggest === "function") {
 		const hints = suggest(input, choices);
-		if (!hints || hints.length === 0) return base;
+		if (!Array.isArray(hints) || hints.length === 0) return base;
 		const suggestionMsg = createSuggestionMessage(hints);
 		return suggestionMsg.length > 0 ? [
 			...base,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.2.0-dev.2242",
+  "version": "1.2.0-dev.2244",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",
@@ -216,7 +216,7 @@
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3",
-    "@optique/env": "1.2.0-dev.2242+4f7a5e89"
+    "@optique/env": "1.2.0-dev.2244+b3c70b3c"
   },
   "scripts": {
     "build": "tsdown",