@optique/core 1.0.0-dev.1303 → 1.0.0-dev.1313

package/dist/modifiers.cjs

@@ -628,7 +628,7 @@ function multiple(parser, options = {}) {
 					suggestion.type,
 					suggestion.pattern ?? "",
 					suggestion.includeHidden === true,
-					suggestion.extensions == null ? "" : suggestion.extensions.join("\0"),
+					suggestion.extensions == null ? "" : suggestion.extensions.toSorted().join("\0"),
 					description
 				]);
 			};

package/dist/modifiers.js

@@ -628,7 +628,7 @@ function multiple(parser, options = {}) {
 					suggestion.type,
 					suggestion.pattern ?? "",
 					suggestion.includeHidden === true,
-					suggestion.extensions == null ? "" : suggestion.extensions.join("\0"),
+					suggestion.extensions == null ? "" : suggestion.extensions.toSorted().join("\0"),
 					description
 				]);
 			};

package/dist/suggestion.cjs

@@ -192,7 +192,7 @@ function createErrorWithSuggestions(baseError, invalidInput, usage, type = "both
 */
 function getSuggestionKey(suggestion) {
 	if (suggestion.kind === "literal") return suggestion.text;
-	return `__FILE__:${suggestion.type}:${suggestion.extensions?.join(",") ?? ""}:${suggestion.pattern ?? ""}`;
+	return `__FILE__:${suggestion.type}:${suggestion.extensions?.toSorted().join(",") ?? ""}:${suggestion.pattern ?? ""}`;
 }
 /**
 * Removes duplicate suggestions from an array while preserving order.
@@ -201,7 +201,11 @@ function getSuggestionKey(suggestion) {
 * - Literal suggestions: same text
 * - File suggestions: same type, extensions, and pattern
 *
-* The first occurrence of each unique suggestion is kept.
+* The first occurrence of each unique suggestion is kept.  For file
+* suggestions, `includeHidden` is merged across duplicates: if any
+* duplicate has `includeHidden: true`, the kept suggestion is upgraded
+* to `includeHidden: true` because it is a superset of the non-hidden
+* variant.
 *
 * @param suggestions Array of suggestions that may contain duplicates
 * @returns A new array with duplicates removed, preserving order of first occurrences
@@ -220,13 +224,20 @@ function getSuggestionKey(suggestion) {
 * @since 0.9.0
 */
 function deduplicateSuggestions(suggestions) {
-	const seen = /* @__PURE__ */ new Set();
-	return suggestions.filter((suggestion) => {
+	const entries = /* @__PURE__ */ new Map();
+	const order = [];
+	for (const suggestion of suggestions) {
 		const key = getSuggestionKey(suggestion);
-		if (seen.has(key)) return false;
-		seen.add(key);
-		return true;
-	});
+		const existing = entries.get(key);
+		if (existing == null) {
+			entries.set(key, suggestion);
+			order.push(key);
+		} else if (suggestion.kind === "file" && existing.kind === "file" && suggestion.includeHidden === true && existing.includeHidden !== true) entries.set(key, {
+			...existing,
+			includeHidden: true
+		});
+	}
+	return order.map((key) => entries.get(key));
 }
 
 //#endregion

package/dist/suggestion.js

@@ -192,7 +192,7 @@ function createErrorWithSuggestions(baseError, invalidInput, usage, type = "both
 */
 function getSuggestionKey(suggestion) {
 	if (suggestion.kind === "literal") return suggestion.text;
-	return `__FILE__:${suggestion.type}:${suggestion.extensions?.join(",") ?? ""}:${suggestion.pattern ?? ""}`;
+	return `__FILE__:${suggestion.type}:${suggestion.extensions?.toSorted().join(",") ?? ""}:${suggestion.pattern ?? ""}`;
 }
 /**
 * Removes duplicate suggestions from an array while preserving order.
@@ -201,7 +201,11 @@ function getSuggestionKey(suggestion) {
 * - Literal suggestions: same text
 * - File suggestions: same type, extensions, and pattern
 *
-* The first occurrence of each unique suggestion is kept.
+* The first occurrence of each unique suggestion is kept.  For file
+* suggestions, `includeHidden` is merged across duplicates: if any
+* duplicate has `includeHidden: true`, the kept suggestion is upgraded
+* to `includeHidden: true` because it is a superset of the non-hidden
+* variant.
 *
 * @param suggestions Array of suggestions that may contain duplicates
 * @returns A new array with duplicates removed, preserving order of first occurrences
@@ -220,13 +224,20 @@ function getSuggestionKey(suggestion) {
 * @since 0.9.0
 */
 function deduplicateSuggestions(suggestions) {
-	const seen = /* @__PURE__ */ new Set();
-	return suggestions.filter((suggestion) => {
+	const entries = /* @__PURE__ */ new Map();
+	const order = [];
+	for (const suggestion of suggestions) {
 		const key = getSuggestionKey(suggestion);
-		if (seen.has(key)) return false;
-		seen.add(key);
-		return true;
-	});
+		const existing = entries.get(key);
+		if (existing == null) {
+			entries.set(key, suggestion);
+			order.push(key);
+		} else if (suggestion.kind === "file" && existing.kind === "file" && suggestion.includeHidden === true && existing.includeHidden !== true) entries.set(key, {
+			...existing,
+			includeHidden: true
+		});
+	}
+	return order.map((key) => entries.get(key));
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1303+2bdb4aa1",
+  "version": "1.0.0-dev.1313+758f4e24",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",