@optique/core 1.0.0-dev.1335 → 1.0.0-dev.1354

package/dist/constructs.cjs

@@ -146,6 +146,19 @@ function extractRequiredUsage(usage) {
 	return required;
 }
 /**
+* Validates that every element of the given array is a {@link Parser} object.
+* @param parsers The array of values to validate.
+* @param callerName The name of the calling function, used in error messages.
+* @throws {TypeError} If any element is not a valid {@link Parser}.
+*/
+function assertParsers(parsers, callerName) {
+	for (let i = 0; i < parsers.length; i++) {
+		const p = parsers[i];
+		const r = p;
+		if (p == null || typeof p !== "object" && typeof p !== "function" || !(r.$mode === "sync" || r.$mode === "async") || !Array.isArray(r.usage) || typeof r.priority !== "number" || Number.isNaN(r.priority) || !("initialState" in p) || typeof r.parse !== "function" || typeof r.complete !== "function" || typeof r.suggest !== "function" || typeof r.getDocFragments !== "function") throw new TypeError(`${callerName} argument at index ${i} is not a valid Parser.`);
+	}
+}
+/**
 * Analyzes parsers to determine what types of inputs are expected.
 * @param parsers The parsers being combined
 * @returns Context about what types of inputs are expected
@@ -306,6 +319,7 @@ function or(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("or() requires at least one parser argument.");
+	assertParsers(parsers, "or()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -496,6 +510,7 @@ function longestMatch(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("longestMatch() requires at least one parser argument.");
+	assertParsers(parsers, "longestMatch()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -1655,6 +1670,7 @@ function merge(...args) {
 	const endIndex = hasOptions ? args.length - 1 : args.length;
 	const rawParsers = args.slice(startIndex, endIndex);
 	if (rawParsers.length < 1) throw new TypeError("merge() requires at least one parser argument.");
+	assertParsers(rawParsers, "merge()");
 	const combinedMode = rawParsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncRawParsers = rawParsers;
@@ -2098,6 +2114,7 @@ function tryParseSuggestList(context, stateArray, parsers, matchedParsers, remai
 }
 function concat(...parsers) {
 	if (parsers.length < 1) throw new TypeError("concat() requires at least one parser argument.");
+	assertParsers(parsers, "concat()");
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;

package/dist/constructs.js

@@ -146,6 +146,19 @@ function extractRequiredUsage(usage) {
 	return required;
 }
 /**
+* Validates that every element of the given array is a {@link Parser} object.
+* @param parsers The array of values to validate.
+* @param callerName The name of the calling function, used in error messages.
+* @throws {TypeError} If any element is not a valid {@link Parser}.
+*/
+function assertParsers(parsers, callerName) {
+	for (let i = 0; i < parsers.length; i++) {
+		const p = parsers[i];
+		const r = p;
+		if (p == null || typeof p !== "object" && typeof p !== "function" || !(r.$mode === "sync" || r.$mode === "async") || !Array.isArray(r.usage) || typeof r.priority !== "number" || Number.isNaN(r.priority) || !("initialState" in p) || typeof r.parse !== "function" || typeof r.complete !== "function" || typeof r.suggest !== "function" || typeof r.getDocFragments !== "function") throw new TypeError(`${callerName} argument at index ${i} is not a valid Parser.`);
+	}
+}
+/**
 * Analyzes parsers to determine what types of inputs are expected.
 * @param parsers The parsers being combined
 * @returns Context about what types of inputs are expected
@@ -306,6 +319,7 @@ function or(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("or() requires at least one parser argument.");
+	assertParsers(parsers, "or()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -496,6 +510,7 @@ function longestMatch(...args) {
 		options = void 0;
 	}
 	if (parsers.length < 1) throw new TypeError("longestMatch() requires at least one parser argument.");
+	assertParsers(parsers, "longestMatch()");
 	const noMatchContext = analyzeNoMatchContext(parsers);
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const syncParsers = parsers;
@@ -1655,6 +1670,7 @@ function merge(...args) {
 	const endIndex = hasOptions ? args.length - 1 : args.length;
 	const rawParsers = args.slice(startIndex, endIndex);
 	if (rawParsers.length < 1) throw new TypeError("merge() requires at least one parser argument.");
+	assertParsers(rawParsers, "merge()");
 	const combinedMode = rawParsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncRawParsers = rawParsers;
@@ -2098,6 +2114,7 @@ function tryParseSuggestList(context, stateArray, parsers, matchedParsers, remai
 }
 function concat(...parsers) {
 	if (parsers.length < 1) throw new TypeError("concat() requires at least one parser argument.");
+	assertParsers(parsers, "concat()");
 	const combinedMode = parsers.some((p) => p.$mode === "async") ? "async" : "sync";
 	const isAsync = combinedMode === "async";
 	const syncParsers = parsers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1335+e6f8ec57",
+  "version": "1.0.0-dev.1354+b0af7b96",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",