@bemoje/cli 1.0.4 → 1.0.6

package/index.js

@@ -0,0 +1,6 @@
+export * from "./lib/Command.js";
+export * from "./lib/CommandHelpAdapter.js";
+export * from "./lib/CommanderHelpAdapter.js";
+export * from "./lib/Help.js";
+export * from "./lib/renderHelp.js";
+//# sourceMappingURL=index.js.map

package/{esm/lib/Command.mjs → lib/Command.js}

@@ -1,6 +1,11 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { parseArgs } from "node:util";
-import { CommandHelpAdapter } from "./CommandHelpAdapter";
+import { CommandHelpAdapter } from "./CommandHelpAdapter.js";
 class Command {
+  static {
+    __name(this, "Command");
+  }
   /** Command name used for invocation */
   name;
   /** Optional version string */
@@ -426,4 +431,4 @@ class Command {
 export {
   Command
 };
-//# sourceMappingURL=Command.mjs.map
+//# sourceMappingURL=Command.js.map

package/{esm/lib/CommandHelpAdapter.mjs → lib/CommandHelpAdapter.js}

@@ -1,5 +1,6 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -8,13 +9,16 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
-import lazyProp from "./internal/lazyProp";
-import { Help } from "./Help";
-import { renderHelp } from "./renderHelp";
+import lazyProp from "./internal/lazyProp.js";
+import { Help } from "./Help.js";
+import { renderHelp } from "./renderHelp.js";
 const _CommandHelpAdapter = class _CommandHelpAdapter {
   constructor(cmd) {
     this.cmd = cmd;
   }
+  static {
+    __name(this, "CommandHelpAdapter");
+  }
   renderHelp(help = new Help()) {
     return renderHelp(this, help);
   }
@@ -95,4 +99,4 @@ let CommandHelpAdapter = _CommandHelpAdapter;
 export {
   CommandHelpAdapter
 };
-//# sourceMappingURL=CommandHelpAdapter.mjs.map
+//# sourceMappingURL=CommandHelpAdapter.js.map

package/{esm/lib/CommanderHelpAdapter.mjs → lib/CommanderHelpAdapter.js}

@@ -1,5 +1,6 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -8,13 +9,16 @@ var __decorateClass = (decorators, target, key, kind) => {
   if (kind && result) __defProp(target, key, result);
   return result;
 };
-import { Help } from "./Help";
-import lazyProp from "./internal/lazyProp";
-import { renderHelp } from "./renderHelp";
+import { Help } from "./Help.js";
+import lazyProp from "./internal/lazyProp.js";
+import { renderHelp } from "./renderHelp.js";
 const _CommanderHelpAdapter = class _CommanderHelpAdapter {
   constructor(cmd) {
     this.cmd = cmd;
   }
+  static {
+    __name(this, "CommanderHelpAdapter");
+  }
   renderHelp(help = new Help()) {
     return renderHelp(this, help);
   }
@@ -85,4 +89,4 @@ let CommanderHelpAdapter = _CommanderHelpAdapter;
 export {
   CommanderHelpAdapter
 };
-//# sourceMappingURL=CommanderHelpAdapter.mjs.map
+//# sourceMappingURL=CommanderHelpAdapter.js.map

package/{esm/lib/Help.mjs → lib/Help.js}

@@ -1,4 +1,9 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 class Help {
+  static {
+    __name(this, "Help");
+  }
   /** output helpWidth, long lines are wrapped to fit */
   helpWidth = process.stdout.isTTY ? process.stdout.columns : 80;
   minWidthToWrap = 40;
@@ -21,9 +26,9 @@ class Help {
    * Compare options for sort.
    */
   compareOptions(a, b) {
-    const getSortKey = (option) => {
+    const getSortKey = /* @__PURE__ */ __name((option) => {
       return option.short ? option.short.replace(/^-/, "") : option.long.replace(/^--/, "");
-    };
+    }, "getSortKey");
     return getSortKey(a).localeCompare(getSortKey(b));
   }
   /**
@@ -226,6 +231,7 @@ class Help {
     function callFormatItem(term, description) {
       return helper.formatItem(term, termWidth, description, helper);
     }
+    __name(callFormatItem, "callFormatItem");
     let output = [`${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`, ""];
     const commandDescription = helper.commandDescription(cmd);
     if (commandDescription.length > 0) {
@@ -456,11 +462,13 @@ function stripColor(str) {
   const sgrPattern = /\x1b\[\d*(;\d*)*m/g;
   return str.replace(sgrPattern, "");
 }
+__name(stripColor, "stripColor");
 function humanReadableArgName(arg) {
   const nameOutput = arg.name + (arg.variadic === true ? "..." : "");
   return arg.required ? "<" + nameOutput + ">" : "[" + nameOutput + "]";
 }
+__name(humanReadableArgName, "humanReadableArgName");
 export {
   Help
 };
-//# sourceMappingURL=Help.mjs.map
+//# sourceMappingURL=Help.js.map

package/{esm/lib/internal/lazyProp.mjs → lib/internal/lazyProp.js}

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function lazyProp(target, key, descriptor) {
   const orig = descriptor.get;
   if (typeof orig !== "function") {
@@ -15,7 +17,8 @@ function lazyProp(target, key, descriptor) {
   };
   return descriptor;
 }
+__name(lazyProp, "lazyProp");
 export {
   lazyProp as default
 };
-//# sourceMappingURL=lazyProp.mjs.map
+//# sourceMappingURL=lazyProp.js.map

package/lib/renderHelp.js

@@ -0,0 +1,12 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Help } from "./Help.js";
+function renderHelp(cmd, help = new Help()) {
+  const helper = Object.assign(help, cmd.helpConfiguration);
+  return helper.formatHelp(cmd, helper);
+}
+__name(renderHelp, "renderHelp");
+export {
+  renderHelp
+};
+//# sourceMappingURL=renderHelp.js.map

package/package.json

@@ -1,13 +1,19 @@
 {
   "name": "@bemoje/cli",
   "description": "A type-safe CLI builder focused on command composition and help generation without execution coupling. Parse arguments, generate help, and integrate with existing CLI frameworks through a clean, fluent API.",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "private": false,
   "sideEffects": false,
   "type": "module",
-  "module": "./esm/index.mjs",
-  "main": "./cjs/index.cjs",
-  "typings": "./typings/index.d.ts",
+  "module": "./index.js",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./*": "./lib/*.js",
+    "./package.json": "./package.json",
+    "./index.d.ts": "./index.d.ts"
+  },
+  "typings": "./index.d.ts",
   "dependencies": {},
   "devDependencies": {
     "commander": "^14.0.0"

package/cjs/index.cjs

@@ -1,31 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var src_exports = {};
-module.exports = __toCommonJS(src_exports);
-__reExport(src_exports, require("./lib/Command"), module.exports);
-__reExport(src_exports, require("./lib/CommandHelpAdapter"), module.exports);
-__reExport(src_exports, require("./lib/CommanderHelpAdapter"), module.exports);
-__reExport(src_exports, require("./lib/Help"), module.exports);
-__reExport(src_exports, require("./lib/renderHelp"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("./lib/Command"),
-  ...require("./lib/CommandHelpAdapter"),
-  ...require("./lib/CommanderHelpAdapter"),
-  ...require("./lib/Help"),
-  ...require("./lib/renderHelp")
-});
-//# sourceMappingURL=index.cjs.map

package/cjs/lib/Command.cjs

@@ -1,453 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var Command_exports = {};
-__export(Command_exports, {
-  Command: () => Command
-});
-module.exports = __toCommonJS(Command_exports);
-var import_node_util = require("node:util");
-var import_CommandHelpAdapter = require("./CommandHelpAdapter");
-class Command {
-  /** Command name used for invocation */
-  name;
-  /** Optional version string */
-  version;
-  /** Alternative names for this command */
-  aliases;
-  /** Brief single-line description */
-  summary;
-  /** Full command description */
-  description;
-  /** Whether command should be hidden from help */
-  hidden;
-  /** Group name for organizing commands in help */
-  group;
-  /** Parent command if this is a subcommand */
-  parent;
-  /** Child subcommands */
-  commands;
-  /** Positional arguments */
-  arguments;
-  /** Named options/flags */
-  options;
-  /** Help system configuration */
-  helpConfiguration;
-  constructor(name = "", parent = null) {
-    this.name = name;
-    this.parent = parent;
-    this.aliases = [];
-    this.description = "";
-    this.commands = [];
-    this.arguments = [];
-    this.options = [];
-    this.helpConfiguration = { showGlobalOptions: true, sortOptions: true, sortSubcommands: true };
-    Object.defineProperty(this, "parent", { enumerable: false });
-  }
-  /** Updates multiple command properties at once */
-  setState(state) {
-    Object.assign(this, state);
-    if (state.commands) {
-      state.commands = state.commands.map((cmd) => new Command(cmd.name, this).setState(cmd));
-    }
-    return this;
-  }
-  /** Serializes command to JSON, maintaining compatibility with previous state-based structure */
-  toJSON() {
-    const result = {
-      name: this.name,
-      version: this.version,
-      aliases: this.aliases,
-      summary: this.summary,
-      description: this.description,
-      hidden: this.hidden,
-      group: this.group,
-      commands: this.commands,
-      arguments: this.arguments,
-      options: this.options,
-      helpConfiguration: this.helpConfiguration
-    };
-    Object.defineProperty(result, "parent", {
-      value: this.parent,
-      writable: true,
-      enumerable: false,
-      configurable: true
-    });
-    return result;
-  }
-  /** Sets the command name */
-  setName(name) {
-    this.name = name;
-  }
-  /** Sets command aliases, flattening nested arrays */
-  setAliases(...aliases) {
-    this.aliases = aliases.flat();
-    return this;
-  }
-  /** Adds aliases to existing ones */
-  addAliases(...aliases) {
-    this.aliases.push(...aliases.flat());
-    return this;
-  }
-  /** Sets the command version */
-  setVersion(version) {
-    this.version = version;
-    return this;
-  }
-  /** Sets the command summary */
-  setSummary(summary) {
-    this.summary = summary;
-    return this;
-  }
-  /** Sets command description, joining multiple lines */
-  setDescription(...lines) {
-    this.description = lines.join("\n");
-    return this;
-  }
-  /** Sets whether command is hidden from help */
-  setHidden(hidden = true) {
-    this.hidden = hidden;
-    return this;
-  }
-  /** Sets the command group for help organization */
-  setGroup(group) {
-    this.group = group;
-    return this;
-  }
-  /** Sets the parent command */
-  setParent(parent) {
-    this.parent = parent;
-    return this;
-  }
-  /** Extends existing help configuration with new settings */
-  extendHelpConfiguration(config) {
-    this.helpConfiguration = { ...this.helpConfiguration, ...config };
-    return this;
-  }
-  /** Sets help configuration, using defaults if not provided */
-  setHelpConfiguration(config) {
-    this.helpConfiguration = config ? { ...config } : { showGlobalOptions: true, sortOptions: true, sortSubcommands: true };
-    return this;
-  }
-  /** Creates and adds a subcommand */
-  subcommand(name) {
-    const sub = new Command(name, this);
-    this.commands.push(sub);
-    return sub;
-  }
-  /**
-   * Adds positional argument with type inference and CLI ordering validation.
-   */
-  argument(usage, description, options = {}) {
-    const match = usage.match(/^<(.*?)>$|^\[(.*?)\]$/);
-    if (!match) throw new Error(`Invalid argument format: ${usage}`);
-    const nameMatch = match[1] || match[2];
-    const name = nameMatch.replace(/\.\.\.$/, "");
-    this.assertArgumentNameNotInUse(name);
-    if (usage.startsWith("<")) {
-      if (nameMatch.endsWith("...")) {
-        this.assertNoMultipleVariadicArguments();
-        this.arguments.push({
-          name,
-          description,
-          required: true,
-          multiple: true,
-          ...options
-        });
-      } else {
-        this.assertNoOptionalOrVariadicArguments();
-        this.arguments.push({
-          name,
-          description,
-          required: true,
-          multiple: false,
-          ...options
-        });
-      }
-    } else if (usage.startsWith("[")) {
-      if (nameMatch.endsWith("...")) {
-        this.assertNoMultipleVariadicArguments();
-        this.arguments.push({
-          name,
-          description,
-          required: false,
-          multiple: true,
-          defaultValue: options.defaultValue ?? [],
-          ...options
-        });
-      } else {
-        this.assertNoVariadicArgument();
-        this.arguments.push({
-          name,
-          description,
-          required: false,
-          multiple: false,
-          ...options
-        });
-      }
-    }
-    return this;
-  }
-  /**
-   * Adds command-line option with type inference. Parses format: `-s, --long [<value>|[value]|<value...>|[value...]]`
-   */
-  option(usage, description, opts = {}) {
-    const match = usage.match(/^-(.+?), --([a-zA-Z][\w-]*)(?:\s*(<(.+?)>|\[(.+?)\]))?$/);
-    if (!match) throw new Error(`Invalid option format: ${usage}`);
-    const short = match[1];
-    this.assertOptionShortNameIsValid(short);
-    this.assertOptionShortNameNotInUse(short);
-    const name = match[2];
-    const argName = (match[4] || match[5])?.replace(/\.\.\.$/, "");
-    this.assertOptionNameNotInUse(name);
-    if (!argName) {
-      this.options.push({
-        type: "boolean",
-        short,
-        name,
-        description,
-        required: false,
-        multiple: false,
-        ...opts
-      });
-    } else if (usage.endsWith(">")) {
-      if (usage.endsWith("...>")) {
-        this.options.push({
-          type: "string",
-          short,
-          name,
-          argName,
-          description,
-          required: true,
-          multiple: true,
-          ...opts
-        });
-      } else {
-        this.options.push({
-          type: "string",
-          short,
-          name,
-          argName,
-          description,
-          required: true,
-          multiple: false,
-          ...opts
-        });
-      }
-    } else if (usage.endsWith("]")) {
-      if (usage.endsWith("...]")) {
-        this.options.push({
-          type: "string",
-          short,
-          name,
-          argName,
-          description,
-          required: false,
-          multiple: true,
-          defaultValue: opts.defaultValue ?? [],
-          ...opts
-        });
-      } else {
-        this.options.push({
-          type: "string",
-          short,
-          name,
-          argName,
-          description,
-          required: false,
-          multiple: false,
-          ...opts
-        });
-      }
-    }
-    return this;
-  }
-  /**
-   * Parses command-line arguments with subcommand support and type-safe validation.
-   *
-   * @example
-   * ```typescript
-   * const result = cmd.parse(['input.txt', '-v', '--format', 'json'])
-   * // { arguments: ['input.txt'], options: { verbose: true, format: 'json' } }
-   * ```
-   */
-  parse(argv = process.argv.slice(2), globalOptions = []) {
-    const maybeSubArg = (0, import_node_util.parseArgs)({
-      args: argv,
-      allowPositionals: true,
-      tokens: false,
-      strict: false,
-      allowNegative: true
-    }).positionals[0];
-    const sub = this.findCommand(maybeSubArg);
-    if (sub) {
-      return sub.parse(
-        argv?.filter((a) => a !== maybeSubArg),
-        [...globalOptions, ...this.options]
-      );
-    }
-    const parsed = (0, import_node_util.parseArgs)({
-      args: argv,
-      options: Object.fromEntries(
-        [...globalOptions, ...this.options].map((o) => {
-          return [o.name, o];
-        })
-      ),
-      allowPositionals: true,
-      tokens: true,
-      strict: true,
-      allowNegative: true
-    });
-    for (let i = 0; i < parsed.tokens.length; i++) {
-      const token = parsed.tokens[i];
-      if (token.kind === "option") {
-        const optionDescriptor = this.options.find((o) => o.name === token.name);
-        if (optionDescriptor && optionDescriptor.multiple && optionDescriptor.type === "string") {
-          const values = [token.value];
-          let j = i + 1;
-          while (j < parsed.tokens.length && parsed.tokens[j].kind === "positional") {
-            const positionalToken = parsed.tokens[j];
-            if (positionalToken.kind === "positional") {
-              values.push(positionalToken.value);
-              const posIndex = parsed.positionals.indexOf(positionalToken.value);
-              if (posIndex !== -1) {
-                parsed.positionals.splice(posIndex, 1);
-              }
-            }
-            j++;
-          }
-          Reflect.set(
-            parsed.values,
-            token.name,
-            values.filter((v) => v !== void 0)
-          );
-        }
-      }
-    }
-    const parsedArguments = this.arguments.map((arg, index) => {
-      if (arg.multiple) {
-        const remainingArgs = parsed.positionals.slice(index);
-        return remainingArgs.length > 0 ? remainingArgs : arg.defaultValue ?? [];
-      } else {
-        return parsed.positionals[index] ?? arg.defaultValue;
-      }
-    });
-    for (const option of this.options) {
-      if (!(option.name in parsed.values) && "defaultValue" in option) {
-        Reflect.set(parsed.values, option.name, option.defaultValue);
-      }
-    }
-    const self = this;
-    return {
-      get command() {
-        return self;
-      },
-      arguments: parsedArguments,
-      options: { ...parsed.values }
-    };
-  }
-  /** Validates CLI argument ordering */
-  assertNoOptionalOrVariadicArguments() {
-    if (this.arguments.some((arg) => !arg.required)) {
-      throw new Error("Cannot add required argument after optional or variadic arguments");
-    }
-  }
-  /** Validates optional args don't follow variadic args */
-  assertNoVariadicArgument() {
-    if (this.arguments.some((arg) => arg.multiple)) {
-      throw new Error("Cannot add optional argument after variadic argument");
-    }
-  }
-  /** Ensures only one variadic argument per command */
-  assertNoMultipleVariadicArguments() {
-    if (this.arguments.some((arg) => arg.multiple)) {
-      throw new Error("Cannot add more than one variadic argument");
-    }
-  }
-  /** Ensures unique argument names across arguments and options */
-  assertArgumentNameNotInUse(name) {
-    if (this.arguments.some((arg) => arg.name === name)) {
-      throw new Error(`Argument name already in use: ${name}`);
-    }
-    if (this.options.some((opt) => opt.name === name)) {
-      throw new Error(`Argument name already in use: ${name}`);
-    }
-  }
-  /** Validates option short names are single alphanumeric characters */
-  assertOptionShortNameIsValid(short) {
-    const isSingleAlphaNumericChar = /^[a-zA-Z0-9]$/.test(short);
-    if (!isSingleAlphaNumericChar) {
-      throw new Error(`Expected short name to be a single alpha-numeric character. Got: ${short}`);
-    }
-  }
-  /** Validates option short names are unique across command hierarchy */
-  assertOptionShortNameNotInUse(short) {
-    for (const opt of this.options) {
-      if (opt.short === short) {
-        throw new Error(`Option short name already in use: -${short}`);
-      }
-    }
-    this.parent?.assertOptionShortNameNotInUse(short);
-  }
-  /** Validates option names are unique across command hierarchy */
-  assertOptionNameNotInUse(name) {
-    if (this.options.some((opt) => opt.name === name)) {
-      throw new Error(`Option name already in use: --${name}`);
-    }
-    this.parent?.assertOptionNameNotInUse(name);
-  }
-  /** Returns command and all ancestor commands in hierarchy */
-  getCommandAndAncestors() {
-    const result = [];
-    let command = this;
-    for (; command; command = command.parent) {
-      result.push(command);
-    }
-    return result;
-  }
-  /** Returns all ancestor commands excluding this command */
-  getAncestors() {
-    return this.getCommandAndAncestors().slice(1);
-  }
-  /** Returns all options from this command and ancestors */
-  getOptionsInclAncestors() {
-    return this.getCommandAndAncestors().flatMap((cmd) => cmd.options);
-  }
-  /** Finds subcommand by name or alias */
-  findCommand(name) {
-    if (!name) return void 0;
-    return this.commands.find((cmd) => cmd.name === name || cmd.aliases.includes(name));
-  }
-  /** Finds option by short or long name */
-  findOption(arg) {
-    return this.options.find((option) => option.short === arg || option.name === arg);
-  }
-  /** Returns a view that is compliant with the CommandHelp interface */
-  createHelpAdapter() {
-    return new import_CommandHelpAdapter.CommandHelpAdapter(this);
-  }
-  /** Renders formatted help text using provided help definition */
-  renderHelp(help) {
-    return this.createHelpAdapter().renderHelp(help);
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Command
-});
-//# sourceMappingURL=Command.cjs.map