@reliverse/rempts 1.7.2 → 1.7.4

package/README.md

@@ -18,7 +18,7 @@
 - 🚨 Crash-safe (Ctrl+C, SIGINT, errors)
 - 🪄 Minimal API surface, max expressiveness
 - 🧪 Scriptable for testing, stable for production
-- 🆕 Automatic commands creation (via `dler init --cmd my-cool-cmd`)
+- 🆕 Automatic commands creation (via `dler rempts init --cmd my-cool-cmd`)
 - 🏞️ No more hacking together `inquirer`, `citty`, `commander`, `chalk`
 
 ## Installation
@@ -94,7 +94,7 @@ import {
 
 ### Notices
 
-- `setup`/`cleanup` are now `onCmdStart`/`onCmdEnd` (old names still work for now).
+- `setup`/`cleanup` are now `onCmdInit`/`onCmdExit` (old names still work for now).
 
 ### Prompts Usage Example
 
@@ -145,6 +145,8 @@ await main();
 
 #### Launcher Usage Example
 
+**Important**: Ensure your commands don't have `await main();`, `await runMain();`, or something like that — to prevent any unexpected behavior. Only main command should have it.
+
 ```ts
 import { relinka } from "@reliverse/relinka";
 
@@ -156,10 +158,10 @@ const main = defineCommand({
     version: "1.0.0",
     description: "Rempts Launcher Playground CLI",
   },
-  onCmdStart() {
+  onCmdInit() {
     relinka("success", "Setup");
   },
-  onCmdEnd() {
+  onCmdExit() {
     relinka("success", "Cleanup");
   },
   commands: {
@@ -220,7 +222,7 @@ export default defineCommand({
 **Hint**:
 
 - Install `bun add -D @reliverse/dler`
-- Use `dler init --cmd cmd1 cmd2` to init commands for rempts launcher's automatically
+- Use `dler rempts init --cmd cmd1 cmd2` to init commands for rempts launcher's automatically
 
 ### Advanced Minimal API
 
@@ -287,7 +289,7 @@ await runMain(defineCommand({}));
 
 ```bash
 bun add -D @reliverse/dler # or: bun i -g @reliverse/dler
-bun dler init --cmd my-cmd-1 # or: dler init my-cmd-1 my-cmd-2 --main src/mod.ts
+bun dler rempts init --cmd my-cmd-1 # or: dler rempts init my-cmd-1 my-cmd-2 --main src/mod.ts
 # * `--main` is optional, default is `./src/mod.ts`
 # * you can specify multiple commands at once
 ```
@@ -545,18 +547,18 @@ Finally, a full-featured CLI launcher without the ceremony. `@reliverse/rempts`'
 - **Lifecycle Hooks:**
   You can define optional lifecycle hooks in your main command:
   - `onLauncherStart` and `onLauncherEnd` (global, called once per CLI process)
-  - `onCmdStart` and `onCmdEnd` (per-command, called before/after each command, but NOT for the main `run()` handler)
+  - `onCmdInit` and `onCmdExit` (per-command, called before/after each command, but NOT for the main `run()` handler)
 
   **Global Hooks:**
   - `onLauncherStart`: Called once, before any command/run() is executed.
   - `onLauncherEnd`: Called once, after all command/run() logic is finished (even if an error occurs).
 
   **Per-Command Hooks:**
-  - `onCmdStart`: Called before each command (not for main `run()`).
-  - `onCmdEnd`: Called after each command (not for main `run()`).
+  - `onCmdInit`: Called before each command (not for main `run()`).
+  - `onCmdExit`: Called after each command (not for main `run()`).
 
   This means:
-  - If your CLI has multiple commands, `onCmdStart` and `onCmdEnd` will be called for each command invocation, not just once for the whole CLI process.
+  - If your CLI has multiple commands, `onCmdInit` and `onCmdExit` will be called for each command invocation, not just once for the whole CLI process.
   - If your main command has a `run()` handler (and no command is invoked), these hooks are **not** called; use the `run()` handler itself or the global hooks for such logic.
   - This allows you to perform setup/teardown logic specific to each command execution.
   - If you want logic to run only once for the entire CLI process, use `onLauncherStart` and `onLauncherEnd`.
@@ -567,18 +569,18 @@ Finally, a full-featured CLI launcher without the ceremony. `@reliverse/rempts`'
   const main = defineCommand({
     onLauncherStart() { relinka('info', 'Global setup (once per process)'); },
     onLauncherEnd() { relinka('info', 'Global cleanup (once per process)'); },
-    onCmdStart() { relinka('info', 'Setup for each command'); },
-    onCmdEnd() { relinka('info', 'Cleanup for each command'); },
+    onCmdInit() { relinka('info', 'Setup for each command'); },
+    onCmdExit() { relinka('info', 'Cleanup for each command'); },
     commands: { ... },
     run() { relinka('info', 'Main run handler (no command)'); },
   });
   // onLauncherStart/onLauncherEnd are called once per process
-  // onCmdStart/onCmdEnd are called for every command (not for main run())
+  // onCmdInit/onCmdExit are called for every command (not for main run())
   // If you want per-run() logic, use the run() handler or global hooks
   ```
 
 - **Deprecation Notice**
-  - The legacy `setup` and `cleanup` names are still supported as aliases for per-command hooks, but will be removed in a future major version. Prefer `onCmdStart` and `onCmdEnd` going forward.
+  - The legacy `setup` and `cleanup` names are still supported as aliases for per-command hooks, but will be removed in a future major version. Prefer `onCmdInit` and `onCmdExit` going forward.
   - The `subCommands` property is deprecated as well. Please use `commands` instead. `subCommands` will be removed in a future major version.
 
 - **Dynamic Usage Examples:**

package/bin/components/launcher/launcher-mod.d.ts

@@ -53,6 +53,7 @@ type CommandContext<ARGS> = {
     raw: string[];
 };
 type CommandRun<ARGS> = (ctx: CommandContext<ARGS>) => void | Promise<void>;
+type CommandHook<ARGS> = (ctx: CommandContext<ARGS>) => void | Promise<void>;
 type DefineCommandOptions<A extends ArgDefinitions = EmptyArgs> = {
     meta?: CommandMeta;
     args?: A;
@@ -66,21 +67,21 @@ type DefineCommandOptions<A extends ArgDefinitions = EmptyArgs> = {
      */
     subCommands?: CommandsMap;
     /**
-     * Called before the command runs
+     * Called before the command runs. Receives `{ args, raw }` (parsed args and raw argv).
      */
-    onCmdStart?: () => void | Promise<void>;
+    onCmdInit?: CommandHook<InferArgTypes<A>>;
     /**
-     * Called after the command finishes
+     * Called after the command finishes. Receives `{ args, raw }` (parsed args and raw argv).
      */
-    onCmdEnd?: () => void | Promise<void>;
+    onCmdExit?: CommandHook<InferArgTypes<A>>;
     /**
-     * @deprecated Use onCmdStart instead
+     * @deprecated Use onCmdInit instead
      */
-    setup?: () => void | Promise<void>;
+    setup?: CommandHook<InferArgTypes<A>>;
     /**
-     * @deprecated Use onCmdEnd instead
+     * @deprecated Use onCmdExit instead
      */
-    cleanup?: () => void | Promise<void>;
+    cleanup?: CommandHook<InferArgTypes<A>>;
     /**
      * Called once per CLI process, before any command/run() is executed
      */
@@ -103,21 +104,21 @@ export type Command<A extends ArgDefinitions = EmptyArgs> = {
      */
     subCommands?: CommandsMap;
     /**
-     * Called before the command runs
+     * Called before the command runs. Receives `{ args, raw }` (parsed args and raw argv).
      */
-    onCmdStart?: () => void | Promise<void>;
+    onCmdInit?: CommandHook<InferArgTypes<A>>;
     /**
-     * Called after the command finishes
+     * Called after the command finishes. Receives `{ args, raw }` (parsed args and raw argv).
      */
-    onCmdEnd?: () => void | Promise<void>;
+    onCmdExit?: CommandHook<InferArgTypes<A>>;
     /**
-     * @deprecated Use onCmdStart instead
+     * @deprecated Use onCmdInit instead
      */
-    setup?: () => void | Promise<void>;
+    setup?: CommandHook<InferArgTypes<A>>;
     /**
-     * @deprecated Use onCmdEnd instead
+     * @deprecated Use onCmdExit instead
      */
-    cleanup?: () => void | Promise<void>;
+    cleanup?: CommandHook<InferArgTypes<A>>;
     /**
      * Called once per CLI process, before any command/run() is executed
      */

package/bin/components/launcher/launcher-mod.js

@@ -57,8 +57,8 @@ function isFlag(str) {
   return str.startsWith("-");
 }
 export function defineCommand(options) {
-  const onCmdStart = options.onCmdStart || options.setup;
-  const onCmdEnd = options.onCmdEnd || options.cleanup;
+  const onCmdInit = options.onCmdInit || options.setup;
+  const onCmdExit = options.onCmdExit || options.cleanup;
   const onLauncherStart = options.onLauncherStart;
   const onLauncherEnd = options.onLauncherEnd;
   let commands = options.commands;
@@ -70,13 +70,13 @@ export function defineCommand(options) {
     args: options.args || {},
     run: options.run,
     commands,
-    onCmdStart,
-    onCmdEnd,
+    onCmdInit,
+    onCmdExit,
     onLauncherStart,
     onLauncherEnd,
     // Backward-compatible aliases
-    setup: onCmdStart,
-    cleanup: onCmdEnd
+    setup: onCmdInit,
+    cleanup: onCmdExit
   };
   Object.defineProperty(cmdObj, "subCommands", {
     get() {
@@ -167,7 +167,7 @@ export async function showUsage(command, parserOptions = {}, displayNotFoundMess
         );
       }
       if (subCommandNames.length > 0) {
-        relinka("log", "Available commands (run with `help` to see more):");
+        relinka("info", "Available commands (run with `help` to see more):");
         subCommandDefs.forEach(({ name, def }) => {
           const desc = def?.meta?.description ?? "";
           relinka("log", `\u2022 ${name}${desc ? ` | ${desc}` : ""}`);
@@ -217,14 +217,14 @@ export async function showUsage(command, parserOptions = {}, displayNotFoundMess
       );
     }
     if (subCommandNames.length > 0) {
-      relinka("log", "Available commands (run with `help` to see more):");
+      relinka("info", "Available commands (run with `help` to see more):");
       subCommandDefs.forEach(({ name, def }) => {
         const desc = def?.meta?.description ?? "";
         relinka("log", `\u2022 ${name}${desc ? ` | ${desc}` : ""}`);
       });
     }
   }
-  relinka("log", "Available options:");
+  relinka("info", "Available options:");
   relinka("log", "\u2022 -h, --help    | Show help");
   relinka("log", "\u2022 -v, --version | Show version");
   relinka("log", "\u2022 --debug       | Enable debug mode");
@@ -334,14 +334,17 @@ This can cause recursion or unexpected behavior.`
     if (fileBasedEnabled && rawArgv.length > 0 && !isFlag(rawArgv[0])) {
       const [subName, ...subCmdArgv] = rawArgv;
       try {
-        if (typeof command.onCmdStart === "function")
-          await command.onCmdStart();
+        const ctx = getParsedContext(command, rawArgv, parserOptions);
+        if (typeof command.onCmdInit === "function")
+          await command.onCmdInit(ctx);
         await runFileBasedSubCmd(
           subName,
           subCmdArgv,
           parserOptions.fileBasedCmds,
           parserOptions,
-          command.onCmdEnd
+          command.onCmdExit ? async (_subCtx) => {
+            await command.onCmdExit?.(ctx);
+          } : void 0
         );
         if (autoExit) process.exit(0);
         return;
@@ -371,13 +374,16 @@ This can cause recursion or unexpected behavior.`
       }
       if (subSpec) {
         try {
-          if (typeof command.onCmdStart === "function")
-            await command.onCmdStart();
+          const ctx = getParsedContext(command, rawArgv, parserOptions);
+          if (typeof command.onCmdInit === "function")
+            await command.onCmdInit(ctx);
           await runSubCommand(
             subSpec,
             subCmdArgv,
             parserOptions,
-            command.onCmdEnd
+            command.onCmdExit ? async (_subCtx) => {
+              await command.onCmdExit?.(ctx);
+            } : void 0
           );
           if (autoExit) process.exit(0);
           return;
@@ -474,27 +480,41 @@ Info for this CLI's developer: No valid command directory found, expected: ${exp
     );
   }
   try {
-    await runCommandWithArgs(subCommand, argv, parserOptions);
+    const subCtx = await runCommandWithArgs(
+      subCommand,
+      argv,
+      parserOptions,
+      true
+    );
+    if (typeof parentFinish === "function" && subCtx)
+      await parentFinish(subCtx);
   } finally {
-    if (typeof parentFinish === "function") await parentFinish();
   }
 }
 async function runSubCommand(spec, argv, parserOptions, parentFinish) {
   const subCommand = await loadSubCommand(spec);
   try {
-    await runCommandWithArgs(subCommand, argv, parserOptions);
+    const subCtx = await runCommandWithArgs(
+      subCommand,
+      argv,
+      parserOptions,
+      true
+    );
+    if (typeof parentFinish === "function" && subCtx)
+      await parentFinish(subCtx);
   } finally {
-    if (typeof parentFinish === "function") await parentFinish();
   }
 }
-async function runCommandWithArgs(command, argv, parserOptions) {
+async function runCommandWithArgs(command, argv, parserOptions, returnCtx) {
   const autoExit = parserOptions.autoExit !== false;
   const booleanKeys = Object.keys(command.args || {}).filter(
     (k) => command.args[k].type === "boolean"
   );
   const defaultMap = {};
   for (const [argKey, def] of Object.entries(command.args || {})) {
-    if (def.default !== void 0) {
+    if (def.type === "boolean") {
+      defaultMap[argKey] = def.default !== void 0 ? def.default : false;
+    } else if (def.default !== void 0) {
       if (def.type === "array" && typeof def.default === "string") {
         defaultMap[argKey] = [def.default];
       } else {
@@ -543,7 +563,11 @@ async function runCommandWithArgs(command, argv, parserOptions) {
       else throw new Error(`Missing required argument: --${key}`);
     }
     try {
-      finalArgs[key] = castArgValue(def, rawVal, key);
+      if (def.type === "boolean") {
+        finalArgs[key] = rawVal !== void 0 ? castArgValue(def, rawVal, key) : false;
+      } else {
+        finalArgs[key] = castArgValue(def, rawVal, key);
+      }
       if (def.type === "array" && def.options && finalArgs[key]) {
         const values = finalArgs[key];
         const invalidOptions = values.filter(
@@ -593,6 +617,8 @@ ${String(err)}`);
     if (autoExit) process.exit(1);
     else throw err;
   }
+  if (returnCtx) return ctx;
+  return void 0;
 }
 function castArgValue(def, rawVal, argName) {
   if (rawVal == null) {
@@ -643,7 +669,9 @@ export async function runCmd(command, argv = [], parserOptions = {}) {
   );
   const defaultMap = {};
   for (const [argKey, def] of Object.entries(command.args || {})) {
-    if (def.default !== void 0) {
+    if (def.type === "boolean") {
+      defaultMap[argKey] = def.default !== void 0 ? def.default : false;
+    } else if (def.default !== void 0) {
       if (def.type === "array" && typeof def.default === "string") {
         defaultMap[argKey] = [def.default];
       } else {
@@ -708,3 +736,53 @@ export async function runCmd(command, argv = [], parserOptions = {}) {
     throw new Error("Command has no run() handler.");
   }
 }
+function getParsedContext(command, argv, parserOptions) {
+  const booleanKeys = Object.keys(command.args || {}).filter(
+    (k) => command.args[k].type === "boolean"
+  );
+  const defaultMap = {};
+  for (const [argKey, def] of Object.entries(command.args || {})) {
+    if (def.type === "boolean") {
+      defaultMap[argKey] = def.default !== void 0 ? def.default : false;
+    } else if (def.default !== void 0) {
+      if (def.type === "array" && typeof def.default === "string") {
+        defaultMap[argKey] = [def.default];
+      } else {
+        defaultMap[argKey] = def.default;
+      }
+    }
+  }
+  const mergedParserOptions = {
+    ...parserOptions,
+    boolean: [...parserOptions.boolean || [], ...booleanKeys],
+    defaults: { ...defaultMap, ...parserOptions.defaults || {} }
+  };
+  const parsed = reliArgParser(argv, mergedParserOptions);
+  const finalArgs = {};
+  const positionalKeys = Object.keys(command.args || {}).filter(
+    (k) => command.args[k].type === "positional"
+  );
+  const leftoverPositionals = [...parsed._ || []];
+  for (let i = 0; i < positionalKeys.length; i++) {
+    const key = positionalKeys[i];
+    const def = command.args?.[key];
+    const val = leftoverPositionals[i];
+    finalArgs[key] = val != null ? castArgValue(def, val, key) : def.default;
+  }
+  const otherKeys = Object.keys(command.args || {}).filter(
+    (k) => command.args[k].type !== "positional"
+  );
+  for (const key of otherKeys) {
+    const def = command.args?.[key];
+    let rawVal = parsed[key];
+    if (def.type === "array" && rawVal !== void 0 && !Array.isArray(rawVal)) {
+      rawVal = [rawVal];
+    }
+    if (def.type === "boolean") {
+      finalArgs[key] = rawVal !== void 0 ? castArgValue(def, rawVal, key) : false;
+    } else {
+      finalArgs[key] = castArgValue(def, rawVal, key);
+    }
+  }
+  return { args: finalArgs, raw: argv };
+}

package/package.json

@@ -28,7 +28,7 @@
   "license": "MIT",
   "name": "@reliverse/rempts",
   "type": "module",
-  "version": "1.7.2",
+  "version": "1.7.4",
   "author": "reliverse",
   "bugs": {
     "email": "blefnk@gmail.com",