@optique/core 1.0.0-dev.1502 → 1.0.0-dev.1514

package/dist/facade.cjs

@@ -1173,15 +1173,15 @@ function disposeContextsSync(contexts) {
 */
 async function runWith(parser, programName, contexts, options) {
 	const args = options?.args ?? [];
-	if (needsEarlyExit(args, options)) {
-		if (parser.$mode === "async") return runParser(parser, programName, args, options);
-		return Promise.resolve(runParser(parser, programName, args, options));
-	}
 	if (contexts.length === 0) {
 		if (parser.$mode === "async") return runParser(parser, programName, args, options);
 		return Promise.resolve(runParser(parser, programName, args, options));
 	}
 	try {
+		if (needsEarlyExit(args, options)) {
+			if (parser.$mode === "async") return runParser(parser, programName, args, options);
+			return Promise.resolve(runParser(parser, programName, args, options));
+		}
 		const ctxOptions = options?.contextOptions;
 		const { annotations: phase1Annotations, annotationsList: phase1AnnotationsList, hasDynamic: needsTwoPhase } = await collectPhase1Annotations(contexts, ctxOptions);
 		if (!needsTwoPhase) {
@@ -1245,9 +1245,9 @@ async function runWith(parser, programName, contexts, options) {
 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);
 	try {
+		if (needsEarlyExit(args, options)) return runParser(parser, programName, args, options);
 		const ctxOptions = options?.contextOptions;
 		const { annotations: phase1Annotations, annotationsList: phase1AnnotationsList, hasDynamic: needsTwoPhase } = collectPhase1AnnotationsSync(contexts, ctxOptions);
 		if (!needsTwoPhase) {

package/dist/facade.js

@@ -1173,15 +1173,15 @@ function disposeContextsSync(contexts) {
 */
 async function runWith(parser, programName, contexts, options) {
 	const args = options?.args ?? [];
-	if (needsEarlyExit(args, options)) {
-		if (parser.$mode === "async") return runParser(parser, programName, args, options);
-		return Promise.resolve(runParser(parser, programName, args, options));
-	}
 	if (contexts.length === 0) {
 		if (parser.$mode === "async") return runParser(parser, programName, args, options);
 		return Promise.resolve(runParser(parser, programName, args, options));
 	}
 	try {
+		if (needsEarlyExit(args, options)) {
+			if (parser.$mode === "async") return runParser(parser, programName, args, options);
+			return Promise.resolve(runParser(parser, programName, args, options));
+		}
 		const ctxOptions = options?.contextOptions;
 		const { annotations: phase1Annotations, annotationsList: phase1AnnotationsList, hasDynamic: needsTwoPhase } = await collectPhase1Annotations(contexts, ctxOptions);
 		if (!needsTwoPhase) {
@@ -1245,9 +1245,9 @@ async function runWith(parser, programName, contexts, options) {
 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);
 	try {
+		if (needsEarlyExit(args, options)) return runParser(parser, programName, args, options);
 		const ctxOptions = options?.contextOptions;
 		const { annotations: phase1Annotations, annotationsList: phase1AnnotationsList, hasDynamic: needsTwoPhase } = collectPhase1AnnotationsSync(contexts, ctxOptions);
 		if (!needsTwoPhase) {

package/dist/primitives.cjs

@@ -968,8 +968,11 @@ async function* suggestCommandAsync(context, prefix, name, parser, options) {
 *                a description for documentation.
 * @returns A {@link Parser} that matches the command name and delegates
 *          to the inner parser for the remaining arguments.
+* @throws {TypeError} If `name` is empty, whitespace-only, contains
+*         embedded whitespace, or contains control characters.
 */
 function command(name, parser, options = {}) {
+	require_validate.validateCommandNames([name], "Command");
 	const isAsync = parser.$mode === "async";
 	const result = {
 		[Symbol.for("@optique/core/commandParser")]: true,

package/dist/primitives.d.cts

@@ -396,6 +396,8 @@ type CommandState<TState> = undefined | ["matched", string] | ["parsing", TState
  *                a description for documentation.
  * @returns A {@link Parser} that matches the command name and delegates
  *          to the inner parser for the remaining arguments.
+ * @throws {TypeError} If `name` is empty, whitespace-only, contains
+ *         embedded whitespace, or contains control characters.
  */
 declare function command<M extends Mode, T, TState>(name: string, parser: Parser<M, T, TState>, options?: CommandOptions): Parser<M, T, CommandState<TState>>;
 /**

package/dist/primitives.d.ts

@@ -396,6 +396,8 @@ type CommandState<TState> = undefined | ["matched", string] | ["parsing", TState
  *                a description for documentation.
  * @returns A {@link Parser} that matches the command name and delegates
  *          to the inner parser for the remaining arguments.
+ * @throws {TypeError} If `name` is empty, whitespace-only, contains
+ *         embedded whitespace, or contains control characters.
  */
 declare function command<M extends Mode, T, TState>(name: string, parser: Parser<M, T, TState>, options?: CommandOptions): Parser<M, T, CommandState<TState>>;
 /**

package/dist/primitives.js

@@ -2,7 +2,7 @@ import { annotateFreshArray, getAnnotations } from "./annotations.js";
 import { message, metavar, optionName, optionNames, text, valueSet } from "./message.js";
 import { createDeferredParseState, createDependencySourceState, createPendingDependencySourceState, dependencyId, getDefaultValuesFunction, getDependencyIds, isDeferredParseState, isDependencySource, isDependencySourceState, isDerivedValueParser, isPendingDependencySourceState, suggestWithDependency } from "./dependency.js";
 import { dispatchIterableByMode } from "./mode-dispatch.js";
-import { validateOptionNames } from "./validate.js";
+import { validateCommandNames, validateOptionNames } from "./validate.js";
 import { extractOptionNames, isDocHidden, isSuggestionHidden } from "./usage.js";
 import { DEFAULT_FIND_SIMILAR_OPTIONS, createErrorWithSuggestions, createSuggestionMessage, findSimilar } from "./suggestion.js";
 import { extractLeadingCommandNames } from "./usage-internals.js";
@@ -968,8 +968,11 @@ async function* suggestCommandAsync(context, prefix, name, parser, options) {
 *                a description for documentation.
 * @returns A {@link Parser} that matches the command name and delegates
 *          to the inner parser for the remaining arguments.
+* @throws {TypeError} If `name` is empty, whitespace-only, contains
+*         embedded whitespace, or contains control characters.
 */
 function command(name, parser, options = {}) {
+	validateCommandNames([name], "Command");
 	const isAsync = parser.$mode === "async";
 	const result = {
 		[Symbol.for("@optique/core/commandParser")]: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.1502+fda779c7",
+  "version": "1.0.0-dev.1514+78606b85",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",