@optique/core 1.0.0-dev.1227 → 1.0.0-dev.1236

package/dist/facade.cjs

@@ -678,7 +678,11 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 				sectionOrder
 			}));
 		}
-		return require_mode_dispatch.dispatchByMode(parser.$mode, () => callOnError(1), () => Promise.resolve(callOnError(1)));
+		return require_mode_dispatch.dispatchByMode(parser.$mode, () => {
+			const result = callOnError(1);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnError(1));
 	}
 	const shell = availableShells[shellName];
 	if (!shell) {
@@ -691,19 +695,29 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 			colors,
 			quotes: !colors
 		}));
-		return require_mode_dispatch.dispatchByMode(parser.$mode, () => callOnError(1), () => Promise.resolve(callOnError(1)));
+		return require_mode_dispatch.dispatchByMode(parser.$mode, () => {
+			const result = callOnError(1);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnError(1));
 	}
 	if (args.length === 0) {
 		const completionArg = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
 		const script = shell.generateScript(programName, [completionArg, shellName]);
 		stdout(script);
-		return require_mode_dispatch.dispatchByMode(parser.$mode, () => callOnCompletion(0), () => Promise.resolve(callOnCompletion(0)));
+		return require_mode_dispatch.dispatchByMode(parser.$mode, () => {
+			const result = callOnCompletion(0);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnCompletion(0));
 	}
 	return require_mode_dispatch.dispatchByMode(parser.$mode, () => {
 		const syncParser = parser;
 		const suggestions = require_parser.suggest(syncParser, args);
 		for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
-		return callOnCompletion(0);
+		const result = callOnCompletion(0);
+		if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+		return result;
 	}, async () => {
 		const suggestions = await require_parser.suggestAsync(parser, args);
 		for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
@@ -1090,9 +1104,12 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 * @param args The command-line arguments to parse.
 * @param options Configuration options for customizing behavior.
 * @returns The parsed result if successful.
+* @throws {TypeError} If an async parser is passed at runtime.  Use
+* {@link runParser} or {@link runParserAsync} for async parsers.
 * @since 0.9.0
 */
 function runParserSync(parser, programName, args, options) {
+	if (parser.$mode !== "sync") throw new TypeError("Cannot use an async parser with runParserSync(). Use runParser() or runParserAsync() instead.");
 	return runParser(parser, programName, args, options);
 }
 /**
@@ -1451,11 +1468,14 @@ async function runWith(parser, programName, contexts, options) {
 * @param contexts Source contexts to use (priority: earlier overrides later).
 * @param options Run options including args, help, version, etc.
 * @returns The parsed result.
-* @throws Error if any context returns a Promise or if a context's
+* @throws {TypeError} If an async parser is passed at runtime.  Use
+* {@link runWith} or {@link runWithAsync} for async parsers.
+* @throws {Error} If any context returns a Promise or if a context's
 * `[Symbol.asyncDispose]` returns a Promise.
 * @since 0.10.0
 */
 function runWithSync(parser, programName, contexts, options) {
+	if (parser.$mode !== "sync") throw new TypeError("Cannot use an async parser with runWithSync(). Use runWith() or runWithAsync() instead.");
 	const args = options?.args ?? [];
 	if (needsEarlyExit(args, options)) return runParser(parser, programName, args, options);
 	if (contexts.length === 0) return runParser(parser, programName, args, options);

package/dist/facade.d.cts

@@ -301,6 +301,8 @@ declare function runParser<TParser extends Parser<Mode, unknown, unknown>, THelp
  * @param args The command-line arguments to parse.
  * @param options Configuration options for customizing behavior.
  * @returns The parsed result if successful.
+ * @throws {TypeError} If an async parser is passed at runtime.  Use
+ * {@link runParser} or {@link runParserAsync} for async parsers.
  * @since 0.9.0
  */
 declare function runParserSync<TParser extends Parser<"sync", unknown, unknown>, THelp = void, TError = never>(parser: TParser, programName: string, args: readonly string[], options?: RunOptions<THelp, TError>): InferValue<TParser>;
@@ -461,7 +463,9 @@ declare function runWith<TParser extends Parser<Mode, unknown, unknown>, TContex
  * @param contexts Source contexts to use (priority: earlier overrides later).
  * @param options Run options including args, help, version, etc.
  * @returns The parsed result.
- * @throws Error if any context returns a Promise or if a context's
+ * @throws {TypeError} If an async parser is passed at runtime.  Use
+ * {@link runWith} or {@link runWithAsync} for async parsers.
+ * @throws {Error} If any context returns a Promise or if a context's
  * `[Symbol.asyncDispose]` returns a Promise.
  * @since 0.10.0
  */

package/dist/facade.d.ts

@@ -301,6 +301,8 @@ declare function runParser<TParser extends Parser<Mode, unknown, unknown>, THelp
  * @param args The command-line arguments to parse.
  * @param options Configuration options for customizing behavior.
  * @returns The parsed result if successful.
+ * @throws {TypeError} If an async parser is passed at runtime.  Use
+ * {@link runParser} or {@link runParserAsync} for async parsers.
  * @since 0.9.0
  */
 declare function runParserSync<TParser extends Parser<"sync", unknown, unknown>, THelp = void, TError = never>(parser: TParser, programName: string, args: readonly string[], options?: RunOptions<THelp, TError>): InferValue<TParser>;
@@ -461,7 +463,9 @@ declare function runWith<TParser extends Parser<Mode, unknown, unknown>, TContex
  * @param contexts Source contexts to use (priority: earlier overrides later).
  * @param options Run options including args, help, version, etc.
  * @returns The parsed result.
- * @throws Error if any context returns a Promise or if a context's
+ * @throws {TypeError} If an async parser is passed at runtime.  Use
+ * {@link runWith} or {@link runWithAsync} for async parsers.
+ * @throws {Error} If any context returns a Promise or if a context's
  * `[Symbol.asyncDispose]` returns a Promise.
  * @since 0.10.0
  */

package/dist/facade.js

@@ -678,7 +678,11 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 				sectionOrder
 			}));
 		}
-		return dispatchByMode(parser.$mode, () => callOnError(1), () => Promise.resolve(callOnError(1)));
+		return dispatchByMode(parser.$mode, () => {
+			const result = callOnError(1);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnError(1));
 	}
 	const shell = availableShells[shellName];
 	if (!shell) {
@@ -691,19 +695,29 @@ function handleCompletion(completionArgs, programName, parser, completionParser,
 			colors,
 			quotes: !colors
 		}));
-		return dispatchByMode(parser.$mode, () => callOnError(1), () => Promise.resolve(callOnError(1)));
+		return dispatchByMode(parser.$mode, () => {
+			const result = callOnError(1);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnError(1));
 	}
 	if (args.length === 0) {
 		const completionArg = isOptionMode ? completionOptionDisplayName ?? "--completion" : completionCommandDisplayName ?? "completion";
 		const script = shell.generateScript(programName, [completionArg, shellName]);
 		stdout(script);
-		return dispatchByMode(parser.$mode, () => callOnCompletion(0), () => Promise.resolve(callOnCompletion(0)));
+		return dispatchByMode(parser.$mode, () => {
+			const result = callOnCompletion(0);
+			if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+			return result;
+		}, async () => callOnCompletion(0));
 	}
 	return dispatchByMode(parser.$mode, () => {
 		const syncParser = parser;
 		const suggestions = suggest(syncParser, args);
 		for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
-		return callOnCompletion(0);
+		const result = callOnCompletion(0);
+		if (result instanceof Promise) throw new RunParserError("Synchronous parser returned async result.");
+		return result;
 	}, async () => {
 		const suggestions = await suggestAsync(parser, args);
 		for (const chunk of shell.encodeSuggestions(suggestions)) stdout(chunk);
@@ -1090,9 +1104,12 @@ function runParser(parserOrProgram, programNameOrArgs, argsOrOptions, optionsPar
 * @param args The command-line arguments to parse.
 * @param options Configuration options for customizing behavior.
 * @returns The parsed result if successful.
+* @throws {TypeError} If an async parser is passed at runtime.  Use
+* {@link runParser} or {@link runParserAsync} for async parsers.
 * @since 0.9.0
 */
 function runParserSync(parser, programName, args, options) {
+	if (parser.$mode !== "sync") throw new TypeError("Cannot use an async parser with runParserSync(). Use runParser() or runParserAsync() instead.");
 	return runParser(parser, programName, args, options);
 }
 /**
@@ -1451,11 +1468,14 @@ async function runWith(parser, programName, contexts, options) {
 * @param contexts Source contexts to use (priority: earlier overrides later).
 * @param options Run options including args, help, version, etc.
 * @returns The parsed result.
-* @throws Error if any context returns a Promise or if a context's
+* @throws {TypeError} If an async parser is passed at runtime.  Use
+* {@link runWith} or {@link runWithAsync} for async parsers.
+* @throws {Error} If any context returns a Promise or if a context's
 * `[Symbol.asyncDispose]` returns a Promise.
 * @since 0.10.0
 */
 function runWithSync(parser, programName, contexts, options) {
+	if (parser.$mode !== "sync") throw new TypeError("Cannot use an async parser with runWithSync(). Use runWith() or runWithAsync() instead.");
 	const args = options?.args ?? [];
 	if (needsEarlyExit(args, options)) return runParser(parser, programName, args, options);
 	if (contexts.length === 0) return runParser(parser, programName, args, options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1227+f9861245",
+  "version": "1.0.0-dev.1236+3ee9891d",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",