@optique/discover 1.2.0-dev.2333 → 1.2.0-dev.2337

package/dist/cli.cjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-require('./command-C-NgG0KJ.cjs');
-require('./src-Bb2ONs5m.cjs');
-const require_generator = require('./generator-4mV9w1F0.cjs');
+require('./command-CfkGTUEa.cjs');
+require('./src-DbaTtwIl.cjs');
+const require_generator = require('./generator-CNhp71NK.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.2333+f7f47e8b";
+var version = "1.2.0-dev.2337+36ffc4e1";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "./command-9sgrJtwh.js";
-import "./src-Ddp18zFp.js";
-import { watchCommandsModule, writeCommandsModule } from "./generator-CJiusCJb.js";
+import "./command-CfQmeg9P.js";
+import "./src-BSEAgsAL.js";
+import { watchCommandsModule, writeCommandsModule } from "./generator-BIhI-TjS.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.2333+f7f47e8b";
+var version = "1.2.0-dev.2337+36ffc4e1";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

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

@@ -1,6 +1,8 @@
 //#region src/command.ts
 const commandBrand = Symbol.for("@optique/discover/command");
 function defineCommand(command) {
+	if (Array.isArray(command)) throw new TypeError("Expected object, got array.");
+	if (command == null || typeof command !== "object") throw new TypeError("Expected object.");
 	if (!isParser(command.parser)) throw new TypeError("Command parser must be an Optique parser.");
 	if (command.path != null) validateCommandPath(command.path);
 	if (typeof command.handler !== "function") throw new TypeError("Command handler must be a function.");

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

@@ -2,6 +2,8 @@
 //#region src/command.ts
 const commandBrand = Symbol.for("@optique/discover/command");
 function defineCommand(command) {
+	if (Array.isArray(command)) throw new TypeError("Expected object, got array.");
+	if (command == null || typeof command !== "object") throw new TypeError("Expected object.");
 	if (!isParser(command.parser)) throw new TypeError("Command parser must be an Optique parser.");
 	if (command.path != null) validateCommandPath(command.path);
 	if (typeof command.handler !== "function") throw new TypeError("Command handler must be a function.");

package/dist/command.cjs

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

package/dist/command.js

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

package/dist/{generator-CJiusCJb.js → generator-BIhI-TjS.js}

@@ -1,4 +1,4 @@
-import { getDefaultExtensions } from "./src-Ddp18zFp.js";
+import { getDefaultExtensions } from "./src-BSEAgsAL.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-4mV9w1F0.cjs → generator-CNhp71NK.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_src = require('./src-Bb2ONs5m.cjs');
+const require_src = require('./src-DbaTtwIl.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-C-NgG0KJ.cjs');
-require('./src-Bb2ONs5m.cjs');
-const require_generator = require('./generator-4mV9w1F0.cjs');
+require('./command-CfkGTUEa.cjs');
+require('./src-DbaTtwIl.cjs');
+const require_generator = require('./generator-CNhp71NK.cjs');
 
 exports.generateCommandsModule = require_generator.generateCommandsModule;
 exports.watchCommandsModule = require_generator.watchCommandsModule;

package/dist/generator.js

@@ -1,5 +1,5 @@
-import "./command-9sgrJtwh.js";
-import "./src-Ddp18zFp.js";
-import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-CJiusCJb.js";
+import "./command-CfQmeg9P.js";
+import "./src-BSEAgsAL.js";
+import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-BIhI-TjS.js";
 
 export { generateCommandsModule, watchCommandsModule, writeCommandsModule };

package/dist/index.cjs

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

package/dist/index.js

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

package/dist/{src-Ddp18zFp.js → src-BSEAgsAL.js}

@@ -1,4 +1,4 @@
-import { isCommand, validateHooks } from "./command-9sgrJtwh.js";
+import { isCommand, validateHooks } from "./command-CfQmeg9P.js";
 import { longestMatch, or } from "@optique/core/constructs";
 import { map } from "@optique/core/modifiers";
 import { command } from "@optique/core/primitives";
@@ -92,7 +92,8 @@ async function discoverCommands(options) {
 * @since 1.2.0
 */
 function commandsFromModules(modules, options = {}) {
-	if (modules == null || typeof modules !== "object") throw new TypeError("commandsFromModules() requires a module map object.");
+	if (Array.isArray(modules)) throw new TypeError("Expected object, got array.");
+	if (modules == null || typeof modules !== "object") throw new TypeError("Expected object.");
 	const base = normalizeModuleBase(options.base);
 	const extensions = normalizeExtensions(options.extensions ?? getDefaultExtensions());
 	const entryFileName = normalizeEntryFileName(options.entryFileName);
@@ -154,6 +155,8 @@ function createProgramParser(commands, options = {}) {
 * @since 1.1.0
 */
 async function runProgram(options) {
+	if (Array.isArray(options)) throw new TypeError("Expected object, got array.");
+	if (options == null || typeof options !== "object") throw new TypeError("Expected object.");
 	if (options.hooks != null) validateHooks(options.hooks, "Program");
 	let commands;
 	if (isStaticRunProgramOptions(options)) commands = staticCommandsToEntries(options.commands);
@@ -190,7 +193,7 @@ async function dispatchInvocation(invocation, programHooks) {
 		if (commandHooks?.beforeEach != null) return invocation.handler(invocation.value, commandContext);
 		if (programHooks?.beforeEach != null) return invocation.handler(invocation.value, programContext);
 		return invocation.handler(invocation.value);
-	}));
+	}, programContext));
 }
 /**
 * Runs an inner step wrapped in a single set of lifecycle hooks.
@@ -198,13 +201,14 @@ async function dispatchInvocation(invocation, programHooks) {
 * @param hooks The hooks for this scope, if any.
 * @param invocation The selected command invocation passed to `beforeEach`.
 * @param inner The step to wrap; receives the context from `beforeEach`.
+* @param fallbackContext The context used when `beforeEach` is absent.
 * @returns The value returned by `inner`.
 * @throws The original error thrown by `beforeEach`, `inner`, or `afterEach`,
 *         re-thrown after `onError` runs.  An error thrown by `onError` itself
 *         is suppressed so it cannot mask the original failure.
 */
-async function runHookScope(hooks, invocation, inner) {
-	let context = {};
+async function runHookScope(hooks, invocation, inner, fallbackContext = {}) {
+	let context = hooks?.beforeEach == null ? fallbackContext : {};
 	try {
 		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation) ?? {};
 		const result = await inner(context);

package/dist/{src-Bb2ONs5m.cjs → src-DbaTtwIl.cjs}

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_command = require('./command-C-NgG0KJ.cjs');
+const require_command = require('./command-CfkGTUEa.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"));
@@ -93,7 +93,8 @@ async function discoverCommands(options) {
 * @since 1.2.0
 */
 function commandsFromModules(modules, options = {}) {
-	if (modules == null || typeof modules !== "object") throw new TypeError("commandsFromModules() requires a module map object.");
+	if (Array.isArray(modules)) throw new TypeError("Expected object, got array.");
+	if (modules == null || typeof modules !== "object") throw new TypeError("Expected object.");
 	const base = normalizeModuleBase(options.base);
 	const extensions = normalizeExtensions(options.extensions ?? getDefaultExtensions());
 	const entryFileName = normalizeEntryFileName(options.entryFileName);
@@ -155,6 +156,8 @@ function createProgramParser(commands, options = {}) {
 * @since 1.1.0
 */
 async function runProgram(options) {
+	if (Array.isArray(options)) throw new TypeError("Expected object, got array.");
+	if (options == null || typeof options !== "object") throw new TypeError("Expected object.");
 	if (options.hooks != null) require_command.validateHooks(options.hooks, "Program");
 	let commands;
 	if (isStaticRunProgramOptions(options)) commands = staticCommandsToEntries(options.commands);
@@ -191,7 +194,7 @@ async function dispatchInvocation(invocation, programHooks) {
 		if (commandHooks?.beforeEach != null) return invocation.handler(invocation.value, commandContext);
 		if (programHooks?.beforeEach != null) return invocation.handler(invocation.value, programContext);
 		return invocation.handler(invocation.value);
-	}));
+	}, programContext));
 }
 /**
 * Runs an inner step wrapped in a single set of lifecycle hooks.
@@ -199,13 +202,14 @@ async function dispatchInvocation(invocation, programHooks) {
 * @param hooks The hooks for this scope, if any.
 * @param invocation The selected command invocation passed to `beforeEach`.
 * @param inner The step to wrap; receives the context from `beforeEach`.
+* @param fallbackContext The context used when `beforeEach` is absent.
 * @returns The value returned by `inner`.
 * @throws The original error thrown by `beforeEach`, `inner`, or `afterEach`,
 *         re-thrown after `onError` runs.  An error thrown by `onError` itself
 *         is suppressed so it cannot mask the original failure.
 */
-async function runHookScope(hooks, invocation, inner) {
-	let context = {};
+async function runHookScope(hooks, invocation, inner, fallbackContext = {}) {
+	let context = hooks?.beforeEach == null ? fallbackContext : {};
 	try {
 		if (hooks?.beforeEach != null) context = await hooks.beforeEach(invocation) ?? {};
 		const result = await inner(context);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/discover",
-  "version": "1.2.0-dev.2333",
+  "version": "1.2.0-dev.2337",
   "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.2333+f7f47e8b",
-    "@optique/run": "1.2.0-dev.2333+f7f47e8b"
+    "@optique/core": "1.2.0-dev.2337+36ffc4e1",
+    "@optique/run": "1.2.0-dev.2337+36ffc4e1"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",