@optique/discover 1.2.0-dev.2255 → 1.2.0-dev.2259

package/dist/cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-require('./command-C9u5sJZS.cjs');
-require('./src-CzbbFDmi.cjs');
-const require_generator = require('./generator-DW4rrPD2.cjs');
+require('./command-C-NgG0KJ.cjs');
+require('./src-C3_a7SFM.cjs');
+const require_generator = require('./generator-CkGpilfc.cjs');
 const require_main_check = require('./main-check-CwunSNpK.cjs');
 const __optique_core_constructs = require_chunk.__toESM(require("@optique/core/constructs"));
 const __optique_core_message = require_chunk.__toESM(require("@optique/core/message"));
@@ -15,7 +15,7 @@ const node_process = require_chunk.__toESM(require("node:process"));
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.2.0-dev.2255+a902c666";
+var version = "1.2.0-dev.2259+0b30260e";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./command-DSHIV50v.js";
-import "./src-CVATvqru.js";
-import { watchCommandsModule, writeCommandsModule } from "./generator-HNXr5Vz2.js";
+import "./command-9sgrJtwh.js";
+import "./src-wHLRsXWK.js";
+import { watchCommandsModule, writeCommandsModule } from "./generator-B8UY7n7b.js";
 import { isMainModuleUrl } from "./main-check-mMnKfUZs.js";
 import { object } from "@optique/core/constructs";
 import { message } from "@optique/core/message";
@@ -14,7 +14,7 @@ import process from "node:process";
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.2.0-dev.2255+a902c666";
+var version = "1.2.0-dev.2259+0b30260e";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{command-DSHIV50v.js → command-9sgrJtwh.js}

@@ -32,6 +32,7 @@ function isCommand(value) {
 * @internal
 */
 function validateHooks(hooks, scope) {
+	if (Array.isArray(hooks)) throw new TypeError(`${scope} hooks must be an object, not an array.`);
 	if (typeof hooks !== "object" || hooks == null) throw new TypeError(`${scope} hooks must be an object.`);
 	for (const name of [
 		"beforeEach",

package/dist/{command-C9u5sJZS.cjs → command-C-NgG0KJ.cjs}

@@ -33,6 +33,7 @@ function isCommand(value) {
 * @internal
 */
 function validateHooks(hooks, scope) {
+	if (Array.isArray(hooks)) throw new TypeError(`${scope} hooks must be an object, not an array.`);
 	if (typeof hooks !== "object" || hooks == null) throw new TypeError(`${scope} hooks must be an object.`);
 	for (const name of [
 		"beforeEach",

package/dist/{command-DIfnalpt.d.cts → command-Dvg452tU.d.cts}

@@ -104,13 +104,15 @@ interface ProgramHooks {
    *
    * The returned {@link ProgramHookContext} is threaded forward as the second
    * argument to the command handler (when this is the most specific hook scope)
-   * and to {@link afterEach} and {@link onError}.
+   * and to {@link afterEach} and {@link onError}.  Returning a context is
+   * optional: omit the return or return `null`, and an empty context is
+   * threaded forward instead.
    *
    * Returning a promise is supported; the dispatcher awaits it.  A rejected
    * promise (or a thrown error) aborts the command before the handler runs and
    * invokes {@link onError}.
    */
-  readonly beforeEach?: (invocation: ProgramInvocation) => ProgramHookContext | Promise<ProgramHookContext>;
+  readonly beforeEach?: (invocation: ProgramInvocation) => ProgramHookContext | null | void | Promise<ProgramHookContext | null | void>;
   /**
    * Called after the handler returns successfully, receiving the context from
    * {@link beforeEach} (or an empty object when no `beforeEach` ran) and the

package/dist/{command-s80EaEXl.d.ts → command-egqHCvDL.d.ts}

@@ -104,13 +104,15 @@ interface ProgramHooks {
    *
    * The returned {@link ProgramHookContext} is threaded forward as the second
    * argument to the command handler (when this is the most specific hook scope)
-   * and to {@link afterEach} and {@link onError}.
+   * and to {@link afterEach} and {@link onError}.  Returning a context is
+   * optional: omit the return or return `null`, and an empty context is
+   * threaded forward instead.
    *
    * Returning a promise is supported; the dispatcher awaits it.  A rejected
    * promise (or a thrown error) aborts the command before the handler runs and
    * invokes {@link onError}.
    */
-  readonly beforeEach?: (invocation: ProgramInvocation) => ProgramHookContext | Promise<ProgramHookContext>;
+  readonly beforeEach?: (invocation: ProgramInvocation) => ProgramHookContext | null | void | Promise<ProgramHookContext | null | void>;
   /**
    * Called after the handler returns successfully, receiving the context from
    * {@link beforeEach} (or an empty object when no `beforeEach` ran) and the

package/dist/command.cjs

@@ -1,4 +1,4 @@
-const require_command = require('./command-C9u5sJZS.cjs');
+const require_command = require('./command-C-NgG0KJ.cjs');
 
 exports.defineCommand = require_command.defineCommand;
 exports.isCommand = require_command.isCommand;

package/dist/command.d.cts

@@ -1,2 +1,2 @@
-import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks } from "./command-DIfnalpt.cjs";
+import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks } from "./command-Dvg452tU.cjs";
 export { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks };

package/dist/command.d.ts

@@ -1,2 +1,2 @@
-import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks } from "./command-s80EaEXl.js";
+import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks } from "./command-egqHCvDL.js";
 export { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand, validateHooks };

package/dist/command.js

@@ -1,3 +1,3 @@
-import { defineCommand, isCommand, validateHooks } from "./command-DSHIV50v.js";
+import { defineCommand, isCommand, validateHooks } from "./command-9sgrJtwh.js";
 
 export { defineCommand, isCommand, validateHooks };

package/dist/{generator-HNXr5Vz2.js → generator-B8UY7n7b.js}

@@ -1,4 +1,4 @@
-import { getDefaultExtensions } from "./src-CVATvqru.js";
+import { getDefaultExtensions } from "./src-wHLRsXWK.js";
 import { mkdir, readdir, realpath, stat, writeFile } from "node:fs/promises";
 import { dirname, posix, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";

package/dist/{generator-DW4rrPD2.cjs → generator-CkGpilfc.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_src = require('./src-CzbbFDmi.cjs');
+const require_src = require('./src-C3_a7SFM.cjs');
 const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_url = require_chunk.__toESM(require("node:url"));

package/dist/generator.cjs

@@ -1,6 +1,6 @@
-require('./command-C9u5sJZS.cjs');
-require('./src-CzbbFDmi.cjs');
-const require_generator = require('./generator-DW4rrPD2.cjs');
+require('./command-C-NgG0KJ.cjs');
+require('./src-C3_a7SFM.cjs');
+const require_generator = require('./generator-CkGpilfc.cjs');
 
 exports.generateCommandsModule = require_generator.generateCommandsModule;
 exports.watchCommandsModule = require_generator.watchCommandsModule;

package/dist/generator.js

@@ -1,5 +1,5 @@
-import "./command-DSHIV50v.js";
-import "./src-CVATvqru.js";
-import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-HNXr5Vz2.js";
+import "./command-9sgrJtwh.js";
+import "./src-wHLRsXWK.js";
+import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-B8UY7n7b.js";
 
 export { generateCommandsModule, watchCommandsModule, writeCommandsModule };

package/dist/index.cjs

@@ -1,5 +1,5 @@
-const require_command = require('./command-C9u5sJZS.cjs');
-const require_src = require('./src-CzbbFDmi.cjs');
+const require_command = require('./command-C-NgG0KJ.cjs');
+const require_src = require('./src-C3_a7SFM.cjs');
 
 exports.commandsFromModules = require_src.commandsFromModules;
 exports.createProgramParser = require_src.createProgramParser;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand } from "./command-DIfnalpt.cjs";
+import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand } from "./command-Dvg452tU.cjs";
 import { Mode } from "@optique/core/parser";
 import { FluentParser } from "@optique/core/fluent";
 import { Message } from "@optique/core/message";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand } from "./command-s80EaEXl.js";
+import { AnyCommand, AnyStaticCommand, Command, CommandDefinition, CommandMetadata, CommandPath, ProgramHookContext, ProgramHooks, ProgramInvocation, StaticCommand, defineCommand, isCommand } from "./command-egqHCvDL.js";
 import { Message } from "@optique/core/message";
 import { ProgramMetadata } from "@optique/core/program";
 import { RunOptions } from "@optique/run";

package/dist/index.js

@@ -1,4 +1,4 @@
-import { defineCommand, isCommand } from "./command-DSHIV50v.js";
-import { commandsFromModules, createProgramParser, discoverCommands, getDefaultExtensions, runProgram } from "./src-CVATvqru.js";
+import { defineCommand, isCommand } from "./command-9sgrJtwh.js";
+import { commandsFromModules, createProgramParser, discoverCommands, getDefaultExtensions, runProgram } from "./src-wHLRsXWK.js";
 
 export { commandsFromModules, createProgramParser, defineCommand, discoverCommands, getDefaultExtensions, isCommand, runProgram };

package/dist/{src-CzbbFDmi.cjs → src-C3_a7SFM.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_command = require('./command-C9u5sJZS.cjs');
+const require_command = require('./command-C-NgG0KJ.cjs');
 const __optique_core_constructs = require_chunk.__toESM(require("@optique/core/constructs"));
 const __optique_core_modifiers = require_chunk.__toESM(require("@optique/core/modifiers"));
 const __optique_core_primitives = require_chunk.__toESM(require("@optique/core/primitives"));
@@ -200,7 +200,7 @@ async function dispatchInvocation(invocation, programHooks) {
 async function runHookScope(hooks, invocation, inner) {
 	let context = {};
 	try {
-		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation);
+		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation) ?? {};
 		const result = await inner(context);
 		if (hooks?.afterEach != null) await hooks.afterEach(context, result);
 		return result;

package/dist/{src-CVATvqru.js → src-wHLRsXWK.js}

@@ -1,4 +1,4 @@
-import { isCommand, validateHooks } from "./command-DSHIV50v.js";
+import { isCommand, validateHooks } from "./command-9sgrJtwh.js";
 import { longestMatch, or } from "@optique/core/constructs";
 import { map } from "@optique/core/modifiers";
 import { command } from "@optique/core/primitives";
@@ -199,7 +199,7 @@ async function dispatchInvocation(invocation, programHooks) {
 async function runHookScope(hooks, invocation, inner) {
 	let context = {};
 	try {
-		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation);
+		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation) ?? {};
 		const result = await inner(context);
 		if (hooks?.afterEach != null) await hooks.afterEach(context, result);
 		return result;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/discover",
-  "version": "1.2.0-dev.2255",
+  "version": "1.2.0-dev.2259",
   "description": "Runtime-aware command discovery for Optique CLI programs",
   "keywords": [
     "CLI",
@@ -83,8 +83,8 @@
     "optique-discover": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/core": "1.2.0-dev.2255+a902c666",
-    "@optique/run": "1.2.0-dev.2255+a902c666"
+    "@optique/core": "1.2.0-dev.2259+0b30260e",
+    "@optique/run": "1.2.0-dev.2259+0b30260e"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",