@optique/core 1.0.0-dev.563 → 1.0.0-dev.565

package/dist/context.d.cts

@@ -146,7 +146,9 @@ interface SourceContext<TRequiredOptions = void> {
   /**
    * Optional asynchronous cleanup method.  Called by `runWith()` in a
    * `finally` block after parsing completes.  Takes precedence over
-   * `[Symbol.dispose]` in async runners.
+   * `[Symbol.dispose]` in async runners.  `runWithSync()` also calls this
+   * method when `[Symbol.dispose]` is absent, but throws if it returns a
+   * Promise.
    */
   [Symbol.asyncDispose]?(): void | PromiseLike<void>;
 }

package/dist/context.d.ts

@@ -146,7 +146,9 @@ interface SourceContext<TRequiredOptions = void> {
   /**
    * Optional asynchronous cleanup method.  Called by `runWith()` in a
    * `finally` block after parsing completes.  Takes precedence over
-   * `[Symbol.dispose]` in async runners.
+   * `[Symbol.dispose]` in async runners.  `runWithSync()` also calls this
+   * method when `[Symbol.dispose]` is absent, but throws if it returns a
+   * Promise.
    */
   [Symbol.asyncDispose]?(): void | PromiseLike<void>;
 }

package/dist/facade.cjs

@@ -933,16 +933,35 @@ function collectAnnotationsSync(contexts, parsed, options) {
 * @param contexts Source contexts to dispose.
 */
 async function disposeContexts(contexts) {
-	for (const context of contexts) if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") await context[Symbol.asyncDispose]();
-	else if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	const errors = [];
+	for (const context of contexts) try {
+		if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") await context[Symbol.asyncDispose]();
+		else if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	} catch (error) {
+		errors.push(error);
+	}
+	if (errors.length === 1) throw errors[0];
+	if (errors.length > 1) throw new AggregateError(errors, "Failed to dispose one or more source contexts.");
 }
 /**
 * Disposes all contexts that implement `Disposable` synchronously.
+* Falls back to `[Symbol.asyncDispose]` when it completes synchronously.
 *
 * @param contexts Source contexts to dispose.
 */
 function disposeContextsSync(contexts) {
-	for (const context of contexts) if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	const errors = [];
+	for (const context of contexts) try {
+		if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+		else if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") {
+			const result = context[Symbol.asyncDispose]();
+			if (typeof result === "object" && result !== null && "then" in result && typeof result.then === "function") throw new TypeError(`Context ${String(context.id)} returned a Promise from Symbol.asyncDispose in sync mode. Use runWith() or runWithAsync() for async disposal.`);
+		}
+	} catch (error) {
+		errors.push(error);
+	}
+	if (errors.length === 1) throw errors[0];
+	if (errors.length > 1) throw new AggregateError(errors, "Failed to dispose one or more source contexts.");
 }
 /**
 * Runs a parser with multiple source contexts.
@@ -1051,7 +1070,8 @@ 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.
+* @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) {

package/dist/facade.d.cts

@@ -431,7 +431,8 @@ 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.
+ * @throws Error if any context returns a Promise or if a context's
+ * `[Symbol.asyncDispose]` returns a Promise.
  * @since 0.10.0
  */
 declare function runWithSync<TParser extends Parser<"sync", unknown, unknown>, TContexts extends readonly SourceContext<unknown>[], THelp = void, TError = never>(parser: TParser, programName: string, contexts: TContexts, options: RunWithOptions<THelp, TError> & ExtractRequiredOptions<TContexts, InferValue<TParser>>): InferValue<TParser>;

package/dist/facade.d.ts

@@ -431,7 +431,8 @@ 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.
+ * @throws Error if any context returns a Promise or if a context's
+ * `[Symbol.asyncDispose]` returns a Promise.
  * @since 0.10.0
  */
 declare function runWithSync<TParser extends Parser<"sync", unknown, unknown>, TContexts extends readonly SourceContext<unknown>[], THelp = void, TError = never>(parser: TParser, programName: string, contexts: TContexts, options: RunWithOptions<THelp, TError> & ExtractRequiredOptions<TContexts, InferValue<TParser>>): InferValue<TParser>;

package/dist/facade.js

@@ -933,16 +933,35 @@ function collectAnnotationsSync(contexts, parsed, options) {
 * @param contexts Source contexts to dispose.
 */
 async function disposeContexts(contexts) {
-	for (const context of contexts) if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") await context[Symbol.asyncDispose]();
-	else if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	const errors = [];
+	for (const context of contexts) try {
+		if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") await context[Symbol.asyncDispose]();
+		else if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	} catch (error) {
+		errors.push(error);
+	}
+	if (errors.length === 1) throw errors[0];
+	if (errors.length > 1) throw new AggregateError(errors, "Failed to dispose one or more source contexts.");
 }
 /**
 * Disposes all contexts that implement `Disposable` synchronously.
+* Falls back to `[Symbol.asyncDispose]` when it completes synchronously.
 *
 * @param contexts Source contexts to dispose.
 */
 function disposeContextsSync(contexts) {
-	for (const context of contexts) if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+	const errors = [];
+	for (const context of contexts) try {
+		if (Symbol.dispose in context && typeof context[Symbol.dispose] === "function") context[Symbol.dispose]();
+		else if (Symbol.asyncDispose in context && typeof context[Symbol.asyncDispose] === "function") {
+			const result = context[Symbol.asyncDispose]();
+			if (typeof result === "object" && result !== null && "then" in result && typeof result.then === "function") throw new TypeError(`Context ${String(context.id)} returned a Promise from Symbol.asyncDispose in sync mode. Use runWith() or runWithAsync() for async disposal.`);
+		}
+	} catch (error) {
+		errors.push(error);
+	}
+	if (errors.length === 1) throw errors[0];
+	if (errors.length > 1) throw new AggregateError(errors, "Failed to dispose one or more source contexts.");
 }
 /**
 * Runs a parser with multiple source contexts.
@@ -1051,7 +1070,8 @@ 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.
+* @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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/core",
-  "version": "1.0.0-dev.563+68c9b43a",
+  "version": "1.0.0-dev.565+d8d53900",
   "description": "Type-safe combinatorial command-line interface parser",
   "keywords": [
     "CLI",