@rzl-zone/build-tools 0.0.13 → 0.0.14-beta.0

package/dist/{identity-DPB1Qgy4.js.map → identity-BUYu2Hfa.js.map}

@@ -1 +1 @@
-{"version":3,"file":"identity-DPB1Qgy4.js","names":["packageJson.name","packageJson.version"],"sources":["../package.json","../src/_internal/constants/package-meta.ts","../src/commander-kit/identity/index.ts"],"sourcesContent":["","import packageJson from \"../../../package.json\";\n\n/** ----------------------------------------------------------------\n * * ***Shared package metadata derived from the package manifest.***\n * ----------------------------------------------------------------\n *\n * Centralized access to metadata sourced from the root\n * `package.json` file.\n *\n * - *This utility exists to:*\n *      - Avoid repeated `package.json` imports across Node.js entry points.\n *      - Ensure consistent versioning and naming.\n *      - Provide a single source of truth for package-level metadata.\n *\n * - ⚠️ **Important:**\n *      - This file MUST only be imported in Node.js environments.\n *      - Not intended for browser or edge runtimes.\n *\n * @internal\n *\n */\nexport const PACKAGE_META = Object.freeze({\n  /** Package name. */\n  name: packageJson.name,\n\n  /** Current package version. */\n  version: packageJson.version\n});\n","import \"@rzl-zone/node-only\";\n\nimport { isNonEmptyString } from \"@/_internal/utils/helper\";\nimport { PACKAGE_META } from \"@/_internal/constants/package-meta\";\n\nimport { ICONS } from \"@/utils/server\";\nimport { picocolors } from \"@/utils/client\";\n\n/** ----------------------------------------------------------------\n * * ***Options for generating a utility command title.***\n * ----------------------------------------------------------------\n *\n * Used by `CommandIdentity.utility()`.\n */\ntype CommandUtilityTitleOptions = {\n  /** ----------------------------------------------------------------\n   * * ***Command name displayed in the title.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the default command name provided in the constructor.\n   *\n   * @example\n   * ```ts\n   * { commandName: \"fix-dts-react-import\" }\n   * ```\n   */\n  commandName?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Optional arrow icon override.***\n   * ----------------------------------------------------------------\n   *\n   * If provided, this icon replaces the generator's\n   * `defaultIconArrow` for this call only.\n   *\n   * @example\n   * ```ts\n   * { iconArrow: \"⇒\" }\n   * ```\n   */\n  iconArrow?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Displayed at the beginning of every generated title.\n   *\n   * @default \"@rzl-zone/build-tools\"\n   */\n  packageName?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Options for generating a CLI command title.***\n * ----------------------------------------------------------------\n *\n * Used by `CommandIdentity.cli()`\n */\ntype CommandCliTitleOptions = Omit<\n  CommandUtilityTitleOptions,\n  \"packageName\"\n> & {\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the resolved CLI package name for this call only.\n   *\n   * @default \"@rzl-zone/build-tools-cli\"\n   */\n  packageName?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Global configuration for command identity formatting.***\n * ----------------------------------------------------------------\n *\n * Defines the default identity behavior applied to\n * all generated CLI and utility titles.\n */\ntype CommandIdentityOptions = {\n  /** ----------------------------------------------------------------\n   * * ***Default command name.***\n   * ----------------------------------------------------------------\n   *\n   * Used when a command name is not provided in the respective in method `CommandIdentity.cli()` and `CommandIdentity.utility()` options.\n   *\n   * @example\n   * ```ts\n   * defaultCommandName: \"fix-dts-react-import\"\n   * ```\n   */\n  defaultCommandName: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Optional base package name used for title generation.\n   *\n   * If not provided, an internal default will be resolved\n   * depending on the title type (`CLI` or `utility`).\n   */\n  packageName?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package version.***\n   * ----------------------------------------------------------------\n   *\n   * Optional version displayed alongside the package name\n   * in generated titles.\n   *\n   * If not provided, a default version will be resolved internally.\n   *\n   * @example\n   * ```ts\n   * version: \"1.2.0\"\n   * ```\n   */\n  version?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Label for CLI commands.***\n   * ----------------------------------------------------------------\n   *\n   * Optional label displayed between\n   * the package name and arrow icon for CLI titles.\n   */\n  cliLabel?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Label for utility commands.***\n   * ----------------------------------------------------------------\n   *\n   * Optional label displayed between\n   * the package name and arrow icon for utility titles.\n   */\n  utilityLabel?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Default arrow icon.***\n   * ----------------------------------------------------------------\n   *\n   * Icon displayed between the label and command name.\n   *\n   * @default\n   * \"▶️\"\n   * // or\n   * \"▶\"\n   */\n  defaultIconArrow?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Command identity formatter with consistent CLI styling.***\n * ----------------------------------------------------------------\n *\n * Responsible for generating formatted and colorized\n * command titles for CLI and utility commands.\n *\n * - ***Each generated title may include:***\n *      - Package name.\n *      - Optional label (CLI / utility).\n *      - Arrow icon.\n *      - Command name.\n *      - Package version.\n *\n * ---\n *\n * @example\n * ```ts\n * const identity = new CommandIdentity({\n *   defaultCommandName: \"fix-dts-react-import\"\n * });\n *\n * identity.cli();\n * // => \"@rzl-zone/build-tools-cli@<version> ➔ fix-dts-react-import\"\n *\n * identity.utility({ commandName: \"clean-dist\" });\n * // => \"@rzl-zone/build-tools@<version> ➔ clean-dist\"\n * ```\n *\n * @example\n * ```ts\n * const identity = new CommandIdentity({\n *   defaultCommandName: \"build\",\n *   version: \"2.1.0\"\n * });\n *\n * identity.cli();\n * // => \"@rzl-zone/build-tools-cli@2.1.0 ➔ build\"\n *\n * identity.utility({ commandName: \"clean-dist\" });\n * // => \"@rzl-zone/build-tools@2.1.0 ➔ clean-dist\"\n * ```\n */\nexport class CommandIdentity {\n  /** Default command name.\n   *\n   * @internal\n   */\n  private _commandName: string;\n\n  /** Package name.\n   *\n   * @internal\n   */\n  private _packageName: string | undefined;\n\n  /** Package version.\n   *\n   * @internal\n   */\n  private _version: string;\n\n  /** Label for CLI commands.\n   *\n   * @internal\n   */\n  private cliLabel: string | undefined;\n\n  /** Label for utility commands.\n   *\n   * @internal\n   */\n  private utilityLabel: string | undefined;\n\n  /** Default arrow icon.\n   *\n   * @internal\n   */\n  private defaultIconArrow: string;\n\n  /** @internal */\n  private static readonly DEFAULT_UTILITY_PACKAGE = \"@rzl-zone/build-tools\";\n  /** @internal */\n  private static readonly DEFAULT_CLI_PACKAGE = \"@rzl-zone/build-tools-cli\";\n\n  /** ----------------------------------------------------------------\n   * * ***Create a new command identity instance.***\n   * ----------------------------------------------------------------\n   *\n   * Initializes global identity configuration\n   * used by `CommandIdentity.cli()` and `CommandIdentity.utility()`.\n   *\n   * ---\n   *\n   * @param {CommandIdentityOptions} options - Global identity configuration.\n   * @throws {Error} If `options.defaultCommandName` is missing or empty.\n   *\n   * ---\n   *\n   * @example\n   * ```ts\n   * const identity = new CommandIdentity({\n   *   defaultCommandName: \"fix-dts-react-import\"\n   * });\n   *\n   * identity.cli();\n   * // => \"@rzl-zone/build-tools-cli@<version> ➔ fix-dts-react-import\"\n   *\n   * identity.utility({ commandName: \"clean-dist\" });\n   * // => \"@rzl-zone/build-tools@<version> ➔ clean-dist\"\n   * ```\n   *\n   * @example\n   * ```ts\n   * const identity = new CommandIdentity({\n   *   defaultCommandName: \"build\",\n   *   version: \"2.1.0\"\n   * });\n   *\n   * identity.cli();\n   * // => \"@rzl-zone/build-tools-cli@2.1.0 ➔ build\"\n   *\n   * identity.utility({ commandName: \"clean-dist\" });\n   * // => \"@rzl-zone/build-tools@2.1.0 ➔ clean-dist\"\n   * ```\n   */\n  constructor(options: CommandIdentityOptions) {\n    if (!isNonEmptyString(options.defaultCommandName)) {\n      throw new Error(\n        \"CommandIdentity: Default command name is missing, please provide in constructor method options, eg: ({ defaultCommandName: 'inject-directive' }).\"\n      );\n    }\n\n    this._commandName = options.defaultCommandName;\n    this._packageName = options.packageName;\n    this._version = isNonEmptyString(options.version)\n      ? options.version\n      : PACKAGE_META.version;\n\n    this.cliLabel = options.cliLabel;\n    this.utilityLabel = options.utilityLabel;\n    this.defaultIconArrow = options.defaultIconArrow ?? ICONS.arrowRight;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Internal title formatter.***\n   * ----------------------------------------------------------------\n   *\n   * Shared formatter used by `CommandIdentity.cli()` and `CommandIdentity.utility()`.\n   *\n   * @internal\n   */\n  private format(props: {\n    packageName: string;\n    label?: string;\n    name?: string;\n    iconArrow?: string;\n  }): string {\n    const { label, name, iconArrow, packageName } = props;\n    const finalName = isNonEmptyString(name) ? name : this._commandName;\n    const finalLabel = isNonEmptyString(label) ? ` ${label} ` : \" \";\n\n    if (!finalName) {\n      throw new Error(\n        \"CommandIdentity: Command name is missing. \" +\n          \"Provide `defaultCommandName` in constructor or `name` in method options.\"\n      );\n    }\n\n    const versionSuffix = isNonEmptyString(this._version)\n      ? `@${this._version}`\n      : \"\";\n\n    return (\n      `${picocolors.bold(picocolors.blue(packageName + versionSuffix))}` +\n      `${picocolors.whiteBright(finalLabel)}` +\n      `${picocolors.bold(picocolors.magentaBright(isNonEmptyString(iconArrow) ? iconArrow : this.defaultIconArrow))} ` +\n      `${picocolors.underline(picocolors.italic(picocolors.yellowBright(finalName)))}`\n    );\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Generate a CLI command title.***\n   * ----------------------------------------------------------------\n   *\n   * Uses the CLI default package (unless overridden)\n   * and applies CLI-specific labeling.\n   *\n   * @param {CommandCliTitleOptions} options - CLI title configuration.\n   *\n   * @example\n   * ```ts\n   * identity.cli();\n   * identity.cli({ commandName: \"build\" });\n   * ```\n   */\n  public cli(options: CommandCliTitleOptions = {}): string {\n    const packageName = isNonEmptyString(options.packageName)\n      ? options.packageName\n      : (this._packageName ?? CommandIdentity.DEFAULT_CLI_PACKAGE);\n\n    return this.format({\n      packageName,\n      label: this.cliLabel,\n      name: options.commandName,\n      iconArrow: options.iconArrow\n    });\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Generate a utility command title.***\n   * ----------------------------------------------------------------\n   *\n   * Uses the utility default package (unless overridden)\n   * and applies utility-specific labeling.\n   *\n   * @param {CommandUtilityTitleOptions} options - Utility title configuration.\n   *\n   * @example\n   * ```ts\n   * identity.utility();\n   * identity.utility({ commandName: \"clean-dist\", iconArrow: \"⇒\" });\n   * ```\n   */\n  public utility(options: CommandUtilityTitleOptions = {}): string {\n    const packageName = isNonEmptyString(options.packageName)\n      ? options.packageName\n      : (this._packageName ?? CommandIdentity.DEFAULT_UTILITY_PACKAGE);\n\n    return this.format({\n      packageName,\n      label: this.utilityLabel,\n      name: options.commandName,\n      iconArrow: options.iconArrow\n    });\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Package name.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the effective package name used for title generation.\n   *\n   * If a custom package name has been provided via the constructor\n   * or `CommandIdentity.setPackageName()`, that value will be returned.\n   * Otherwise, an internal default package name (as utility) is used.\n   *\n   * @readonly\n   */\n  public get packageName(): string {\n    return this._packageName ?? CommandIdentity.DEFAULT_UTILITY_PACKAGE;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set package name.***\n   * ----------------------------------------------------------------\n   *\n   * Assigns a custom package name to be used for title generation.\n   *\n   * - *This value overrides:*\n   *     - Any package name provided in the constructor.\n   *     - The internal default package name.\n   *\n   * Once set, this value will be returned by the `CommandIdentity.packageName`\n   * getter and used by `CommandIdentity.cli()` and\n   * `CommandIdentity.utility()` unless explicitly\n   * overridden per method call.\n   *\n   * @param value - The new package name to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setPackageName(value: string): this {\n    this._packageName = value;\n    return this;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Command name.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the current command name used for title generation.\n   *\n   * This value is initialized via the constructor and may be\n   * updated later using\n   * `CommandIdentity.setCommandName()`.\n   *\n   * @readonly\n   */\n  public get commandName(): string {\n    return this._commandName;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set command name.***\n   * ----------------------------------------------------------------\n   *\n   * Updates the command name used for title generation.\n   *\n   * This overrides the command name provided in the constructor\n   * and affects subsequent calls to\n   * `CommandIdentity.cli()`\n   * and `CommandIdentity.utility()`,\n   * unless a command name is explicitly provided per method call.\n   *\n   * @param value - The new command name to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setCommandName(value: string): this {\n    this._commandName = value;\n    return this;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Package version.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the effective version used for title generation.\n   *\n   * - *Resolution order:*\n   *    1. If a custom version has been provided via the constructor\n   *       or `CommandIdentity.setVersion()`,\n   *       that value will be returned.\n   *    2. Otherwise, the version falls back to the internally\n   *       resolved default package version.\n   *\n   * A version value is always guaranteed to be present.\n   *\n   * @readonly\n   */\n  public get version(): string {\n    return this._version;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set package version.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the version used for title generation.\n   *\n   * If an empty or invalid value is provided,\n   * the version will remain unchanged.\n   *\n   * @param value - The new version to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setVersion(value: string): this {\n    if (isNonEmptyString(value)) this._version = value;\n\n    return this;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACqBA,MAAa,eAAe,OAAO,OAAO;;CAElCA;;CAGGC;AACX,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC0KD,IAAa,kBAAb,MAAa,gBAAgB;;;;;CAK3B,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;CAGR,OAAwB,0BAA0B;;CAElD,OAAwB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9C,YAAY,SAAiC;EAC3C,IAAI,CAAC,iBAAiB,QAAQ,kBAAkB,GAC9C,MAAM,IAAI,MACR,mJACF;EAGF,KAAK,eAAe,QAAQ;EAC5B,KAAK,eAAe,QAAQ;EAC5B,KAAK,WAAW,iBAAiB,QAAQ,OAAO,IAC5C,QAAQ,UACR,aAAa;EAEjB,KAAK,WAAW,QAAQ;EACxB,KAAK,eAAe,QAAQ;EAC5B,KAAK,mBAAmB,QAAQ,oBAAoB,MAAM;CAC5D;;;;;;;;;CAUA,AAAQ,OAAO,OAKJ;EACT,MAAM,EAAE,OAAO,MAAM,WAAW,gBAAgB;EAChD,MAAM,YAAY,iBAAiB,IAAI,IAAI,OAAO,KAAK;EACvD,MAAM,aAAa,iBAAiB,KAAK,IAAI,IAAI,MAAM,KAAK;EAE5D,IAAI,CAAC,WACH,MAAM,IAAI,MACR,oHAEF;EAGF,MAAM,gBAAgB,iBAAiB,KAAK,QAAQ,IAChD,IAAI,KAAK,aACT;EAEJ,OACE,GAAG,WAAW,KAAK,WAAW,KAAK,cAAc,aAAa,CAAC,IAC5D,WAAW,YAAY,UAAU,IACjC,WAAW,KAAK,WAAW,cAAc,iBAAiB,SAAS,IAAI,YAAY,KAAK,gBAAgB,CAAC,EAAE,GAC3G,WAAW,UAAU,WAAW,OAAO,WAAW,aAAa,SAAS,CAAC,CAAC;CAEjF;;;;;;;;;;;;;;;;CAiBA,AAAO,IAAI,UAAkC,CAAC,GAAW;EACvD,MAAM,cAAc,iBAAiB,QAAQ,WAAW,IACpD,QAAQ,cACP,KAAK,gBAAgB,gBAAgB;EAE1C,OAAO,KAAK,OAAO;GACjB;GACA,OAAO,KAAK;GACZ,MAAM,QAAQ;GACd,WAAW,QAAQ;EACrB,CAAC;CACH;;;;;;;;;;;;;;;;CAiBA,AAAO,QAAQ,UAAsC,CAAC,GAAW;EAC/D,MAAM,cAAc,iBAAiB,QAAQ,WAAW,IACpD,QAAQ,cACP,KAAK,gBAAgB,gBAAgB;EAE1C,OAAO,KAAK,OAAO;GACjB;GACA,OAAO,KAAK;GACZ,MAAM,QAAQ;GACd,WAAW,QAAQ;EACrB,CAAC;CACH;;;;;;;;;;;;;CAcA,IAAW,cAAsB;EAC/B,OAAO,KAAK,gBAAgB,gBAAgB;CAC9C;;;;;;;;;;;;;;;;;;;CAoBA,AAAO,eAAe,OAAqB;EACzC,KAAK,eAAe;EACpB,OAAO;CACT;;;;;;;;;;;;;CAcA,IAAW,cAAsB;EAC/B,OAAO,KAAK;CACd;;;;;;;;;;;;;;;;CAiBA,AAAO,eAAe,OAAqB;EACzC,KAAK,eAAe;EACpB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,IAAW,UAAkB;EAC3B,OAAO,KAAK;CACd;;;;;;;;;;;;;CAcA,AAAO,WAAW,OAAqB;EACrC,IAAI,iBAAiB,KAAK,GAAG,KAAK,WAAW;EAE7C,OAAO;CACT;AACF"}
+{"version":3,"file":"identity-BUYu2Hfa.js","names":["packageJson.name","packageJson.version"],"sources":["../package.json","../src/_internal/constants/package-meta.ts","../src/commander-kit/identity/index.ts"],"sourcesContent":["","import packageJson from \"../../../package.json\";\n\n/** ----------------------------------------------------------------\n * * ***Shared package metadata derived from the package manifest.***\n * ----------------------------------------------------------------\n *\n * Centralized access to metadata sourced from the root\n * `package.json` file.\n *\n * - *This utility exists to:*\n *      - Avoid repeated `package.json` imports across Node.js entry points.\n *      - Ensure consistent versioning and naming.\n *      - Provide a single source of truth for package-level metadata.\n *\n * - ⚠️ **Important:**\n *      - This file MUST only be imported in Node.js environments.\n *      - Not intended for browser or edge runtimes.\n *\n * @internal\n *\n */\nexport const PACKAGE_META = Object.freeze({\n  /** Package name. */\n  name: packageJson.name,\n\n  /** Current package version. */\n  version: packageJson.version\n});\n","import \"@rzl-zone/node-only\";\n\nimport { isNonEmptyString } from \"@/_internal/utils/helper\";\nimport { PACKAGE_META } from \"@/_internal/constants/package-meta\";\n\nimport { ICONS } from \"@/utils/server\";\nimport { picocolors } from \"@/utils/client\";\n\n/** ----------------------------------------------------------------\n * * ***Options for generating a utility command title.***\n * ----------------------------------------------------------------\n *\n * Used by `CommandIdentity.utility()`.\n */\ntype CommandUtilityTitleOptions = {\n  /** ----------------------------------------------------------------\n   * * ***Command name displayed in the title.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the default command name provided in the constructor.\n   *\n   * @example\n   * ```ts\n   * { commandName: \"fix-dts-react-import\" }\n   * ```\n   */\n  commandName?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Optional arrow icon override.***\n   * ----------------------------------------------------------------\n   *\n   * If provided, this icon replaces the generator's\n   * `defaultIconArrow` for this call only.\n   *\n   * @example\n   * ```ts\n   * { iconArrow: \"⇒\" }\n   * ```\n   */\n  iconArrow?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Displayed at the beginning of every generated title.\n   *\n   * @default \"@rzl-zone/build-tools\"\n   */\n  packageName?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Options for generating a CLI command title.***\n * ----------------------------------------------------------------\n *\n * Used by `CommandIdentity.cli()`\n */\ntype CommandCliTitleOptions = Omit<\n  CommandUtilityTitleOptions,\n  \"packageName\"\n> & {\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the resolved CLI package name for this call only.\n   *\n   * @default \"@rzl-zone/build-tools-cli\"\n   */\n  packageName?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Global configuration for command identity formatting.***\n * ----------------------------------------------------------------\n *\n * Defines the default identity behavior applied to\n * all generated CLI and utility titles.\n */\ntype CommandIdentityOptions = {\n  /** ----------------------------------------------------------------\n   * * ***Default command name.***\n   * ----------------------------------------------------------------\n   *\n   * Used when a command name is not provided in the respective in method `CommandIdentity.cli()` and `CommandIdentity.utility()` options.\n   *\n   * @example\n   * ```ts\n   * defaultCommandName: \"fix-dts-react-import\"\n   * ```\n   */\n  defaultCommandName: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package name prefix.***\n   * ----------------------------------------------------------------\n   *\n   * Optional base package name used for title generation.\n   *\n   * If not provided, an internal default will be resolved\n   * depending on the title type (`CLI` or `utility`).\n   */\n  packageName?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Package version.***\n   * ----------------------------------------------------------------\n   *\n   * Optional version displayed alongside the package name\n   * in generated titles.\n   *\n   * If not provided, a default version will be resolved internally.\n   *\n   * @example\n   * ```ts\n   * version: \"1.2.0\"\n   * ```\n   */\n  version?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Label for CLI commands.***\n   * ----------------------------------------------------------------\n   *\n   * Optional label displayed between\n   * the package name and arrow icon for CLI titles.\n   */\n  cliLabel?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Label for utility commands.***\n   * ----------------------------------------------------------------\n   *\n   * Optional label displayed between\n   * the package name and arrow icon for utility titles.\n   */\n  utilityLabel?: string;\n\n  /** ----------------------------------------------------------------\n   * * ***Default arrow icon.***\n   * ----------------------------------------------------------------\n   *\n   * Icon displayed between the label and command name.\n   *\n   * @default\n   * \"▶️\"\n   * // or\n   * \"▶\"\n   */\n  defaultIconArrow?: string;\n};\n\n/** ----------------------------------------------------------------\n * * ***Command identity formatter with consistent CLI styling.***\n * ----------------------------------------------------------------\n *\n * Responsible for generating formatted and colorized\n * command titles for CLI and utility commands.\n *\n * - ***Each generated title may include:***\n *      - Package name.\n *      - Optional label (CLI / utility).\n *      - Arrow icon.\n *      - Command name.\n *      - Package version.\n *\n * ---\n *\n * @example\n * ```ts\n * const identity = new CommandIdentity({\n *   defaultCommandName: \"fix-dts-react-import\"\n * });\n *\n * identity.cli();\n * // => \"@rzl-zone/build-tools-cli@<version> ➔ fix-dts-react-import\"\n *\n * identity.utility({ commandName: \"clean-dist\" });\n * // => \"@rzl-zone/build-tools@<version> ➔ clean-dist\"\n * ```\n *\n * @example\n * ```ts\n * const identity = new CommandIdentity({\n *   defaultCommandName: \"build\",\n *   version: \"2.1.0\"\n * });\n *\n * identity.cli();\n * // => \"@rzl-zone/build-tools-cli@2.1.0 ➔ build\"\n *\n * identity.utility({ commandName: \"clean-dist\" });\n * // => \"@rzl-zone/build-tools@2.1.0 ➔ clean-dist\"\n * ```\n */\nexport class CommandIdentity {\n  /** Default command name.\n   *\n   * @internal\n   */\n  private _commandName: string;\n\n  /** Package name.\n   *\n   * @internal\n   */\n  private _packageName: string | undefined;\n\n  /** Package version.\n   *\n   * @internal\n   */\n  private _version: string;\n\n  /** Label for CLI commands.\n   *\n   * @internal\n   */\n  private cliLabel: string | undefined;\n\n  /** Label for utility commands.\n   *\n   * @internal\n   */\n  private utilityLabel: string | undefined;\n\n  /** Default arrow icon.\n   *\n   * @internal\n   */\n  private defaultIconArrow: string;\n\n  /** @internal */\n  private static readonly DEFAULT_UTILITY_PACKAGE = \"@rzl-zone/build-tools\";\n  /** @internal */\n  private static readonly DEFAULT_CLI_PACKAGE = \"@rzl-zone/build-tools-cli\";\n\n  /** ----------------------------------------------------------------\n   * * ***Create a new command identity instance.***\n   * ----------------------------------------------------------------\n   *\n   * Initializes global identity configuration\n   * used by `CommandIdentity.cli()` and `CommandIdentity.utility()`.\n   *\n   * ---\n   *\n   * @param {CommandIdentityOptions} options - Global identity configuration.\n   * @throws {Error} If `options.defaultCommandName` is missing or empty.\n   *\n   * ---\n   *\n   * @example\n   * ```ts\n   * const identity = new CommandIdentity({\n   *   defaultCommandName: \"fix-dts-react-import\"\n   * });\n   *\n   * identity.cli();\n   * // => \"@rzl-zone/build-tools-cli@<version> ➔ fix-dts-react-import\"\n   *\n   * identity.utility({ commandName: \"clean-dist\" });\n   * // => \"@rzl-zone/build-tools@<version> ➔ clean-dist\"\n   * ```\n   *\n   * @example\n   * ```ts\n   * const identity = new CommandIdentity({\n   *   defaultCommandName: \"build\",\n   *   version: \"2.1.0\"\n   * });\n   *\n   * identity.cli();\n   * // => \"@rzl-zone/build-tools-cli@2.1.0 ➔ build\"\n   *\n   * identity.utility({ commandName: \"clean-dist\" });\n   * // => \"@rzl-zone/build-tools@2.1.0 ➔ clean-dist\"\n   * ```\n   */\n  constructor(options: CommandIdentityOptions) {\n    if (!isNonEmptyString(options.defaultCommandName)) {\n      throw new Error(\n        \"CommandIdentity: Default command name is missing, please provide in constructor method options, eg: ({ defaultCommandName: 'inject-directive' }).\"\n      );\n    }\n\n    this._commandName = options.defaultCommandName;\n    this._packageName = options.packageName;\n    this._version = isNonEmptyString(options.version)\n      ? options.version\n      : PACKAGE_META.version;\n\n    this.cliLabel = options.cliLabel;\n    this.utilityLabel = options.utilityLabel;\n    this.defaultIconArrow = options.defaultIconArrow ?? ICONS.arrowRight;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Internal title formatter.***\n   * ----------------------------------------------------------------\n   *\n   * Shared formatter used by `CommandIdentity.cli()` and `CommandIdentity.utility()`.\n   *\n   * @internal\n   */\n  private format(props: {\n    packageName: string;\n    label?: string;\n    name?: string;\n    iconArrow?: string;\n  }): string {\n    const { label, name, iconArrow, packageName } = props;\n    const finalName = isNonEmptyString(name) ? name : this._commandName;\n    const finalLabel = isNonEmptyString(label) ? ` ${label} ` : \" \";\n\n    if (!finalName) {\n      throw new Error(\n        \"CommandIdentity: Command name is missing. \" +\n          \"Provide `defaultCommandName` in constructor or `name` in method options.\"\n      );\n    }\n\n    const versionSuffix = isNonEmptyString(this._version)\n      ? `@${this._version}`\n      : \"\";\n\n    return (\n      `${picocolors.bold(picocolors.blue(packageName + versionSuffix))}` +\n      `${picocolors.whiteBright(finalLabel)}` +\n      `${picocolors.bold(picocolors.magentaBright(isNonEmptyString(iconArrow) ? iconArrow : this.defaultIconArrow))} ` +\n      `${picocolors.underline(picocolors.italic(picocolors.yellowBright(finalName)))}`\n    );\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Generate a CLI command title.***\n   * ----------------------------------------------------------------\n   *\n   * Uses the CLI default package (unless overridden)\n   * and applies CLI-specific labeling.\n   *\n   * @param {CommandCliTitleOptions} options - CLI title configuration.\n   *\n   * @example\n   * ```ts\n   * identity.cli();\n   * identity.cli({ commandName: \"build\" });\n   * ```\n   */\n  public cli(options: CommandCliTitleOptions = {}): string {\n    const packageName = isNonEmptyString(options.packageName)\n      ? options.packageName\n      : (this._packageName ?? CommandIdentity.DEFAULT_CLI_PACKAGE);\n\n    return this.format({\n      packageName,\n      label: this.cliLabel,\n      name: options.commandName,\n      iconArrow: options.iconArrow\n    });\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Generate a utility command title.***\n   * ----------------------------------------------------------------\n   *\n   * Uses the utility default package (unless overridden)\n   * and applies utility-specific labeling.\n   *\n   * @param {CommandUtilityTitleOptions} options - Utility title configuration.\n   *\n   * @example\n   * ```ts\n   * identity.utility();\n   * identity.utility({ commandName: \"clean-dist\", iconArrow: \"⇒\" });\n   * ```\n   */\n  public utility(options: CommandUtilityTitleOptions = {}): string {\n    const packageName = isNonEmptyString(options.packageName)\n      ? options.packageName\n      : (this._packageName ?? CommandIdentity.DEFAULT_UTILITY_PACKAGE);\n\n    return this.format({\n      packageName,\n      label: this.utilityLabel,\n      name: options.commandName,\n      iconArrow: options.iconArrow\n    });\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Package name.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the effective package name used for title generation.\n   *\n   * If a custom package name has been provided via the constructor\n   * or `CommandIdentity.setPackageName()`, that value will be returned.\n   * Otherwise, an internal default package name (as utility) is used.\n   *\n   * @readonly\n   */\n  public get packageName(): string {\n    return this._packageName ?? CommandIdentity.DEFAULT_UTILITY_PACKAGE;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set package name.***\n   * ----------------------------------------------------------------\n   *\n   * Assigns a custom package name to be used for title generation.\n   *\n   * - *This value overrides:*\n   *     - Any package name provided in the constructor.\n   *     - The internal default package name.\n   *\n   * Once set, this value will be returned by the `CommandIdentity.packageName`\n   * getter and used by `CommandIdentity.cli()` and\n   * `CommandIdentity.utility()` unless explicitly\n   * overridden per method call.\n   *\n   * @param value - The new package name to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setPackageName(value: string): this {\n    this._packageName = value;\n    return this;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Command name.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the current command name used for title generation.\n   *\n   * This value is initialized via the constructor and may be\n   * updated later using\n   * `CommandIdentity.setCommandName()`.\n   *\n   * @readonly\n   */\n  public get commandName(): string {\n    return this._commandName;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set command name.***\n   * ----------------------------------------------------------------\n   *\n   * Updates the command name used for title generation.\n   *\n   * This overrides the command name provided in the constructor\n   * and affects subsequent calls to\n   * `CommandIdentity.cli()`\n   * and `CommandIdentity.utility()`,\n   * unless a command name is explicitly provided per method call.\n   *\n   * @param value - The new command name to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setCommandName(value: string): this {\n    this._commandName = value;\n    return this;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Package version.***\n   * ----------------------------------------------------------------\n   *\n   * Returns the effective version used for title generation.\n   *\n   * - *Resolution order:*\n   *    1. If a custom version has been provided via the constructor\n   *       or `CommandIdentity.setVersion()`,\n   *       that value will be returned.\n   *    2. Otherwise, the version falls back to the internally\n   *       resolved default package version.\n   *\n   * A version value is always guaranteed to be present.\n   *\n   * @readonly\n   */\n  public get version(): string {\n    return this._version;\n  }\n\n  /** ----------------------------------------------------------------\n   * * ***Set package version.***\n   * ----------------------------------------------------------------\n   *\n   * Overrides the version used for title generation.\n   *\n   * If an empty or invalid value is provided,\n   * the version will remain unchanged.\n   *\n   * @param value - The new version to assign.\n   * @returns The current instance for fluent chaining.\n   */\n  public setVersion(value: string): this {\n    if (isNonEmptyString(value)) this._version = value;\n\n    return this;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACqBA,MAAa,eAAe,OAAO,OAAO;;CAElCA;;CAGGC;AACX,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC0KD,IAAa,kBAAb,MAAa,gBAAgB;;;;;CAK3B,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;;;;CAMR,AAAQ;;CAGR,OAAwB,0BAA0B;;CAElD,OAAwB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9C,YAAY,SAAiC;EAC3C,IAAI,CAAC,iBAAiB,QAAQ,kBAAkB,GAC9C,MAAM,IAAI,MACR,mJACF;EAGF,KAAK,eAAe,QAAQ;EAC5B,KAAK,eAAe,QAAQ;EAC5B,KAAK,WAAW,iBAAiB,QAAQ,OAAO,IAC5C,QAAQ,UACR,aAAa;EAEjB,KAAK,WAAW,QAAQ;EACxB,KAAK,eAAe,QAAQ;EAC5B,KAAK,mBAAmB,QAAQ,oBAAoB,MAAM;CAC5D;;;;;;;;;CAUA,AAAQ,OAAO,OAKJ;EACT,MAAM,EAAE,OAAO,MAAM,WAAW,gBAAgB;EAChD,MAAM,YAAY,iBAAiB,IAAI,IAAI,OAAO,KAAK;EACvD,MAAM,aAAa,iBAAiB,KAAK,IAAI,IAAI,MAAM,KAAK;EAE5D,IAAI,CAAC,WACH,MAAM,IAAI,MACR,oHAEF;EAGF,MAAM,gBAAgB,iBAAiB,KAAK,QAAQ,IAChD,IAAI,KAAK,aACT;EAEJ,OACE,GAAG,WAAW,KAAK,WAAW,KAAK,cAAc,aAAa,CAAC,IAC5D,WAAW,YAAY,UAAU,IACjC,WAAW,KAAK,WAAW,cAAc,iBAAiB,SAAS,IAAI,YAAY,KAAK,gBAAgB,CAAC,EAAE,GAC3G,WAAW,UAAU,WAAW,OAAO,WAAW,aAAa,SAAS,CAAC,CAAC;CAEjF;;;;;;;;;;;;;;;;CAiBA,AAAO,IAAI,UAAkC,CAAC,GAAW;EACvD,MAAM,cAAc,iBAAiB,QAAQ,WAAW,IACpD,QAAQ,cACP,KAAK,gBAAgB,gBAAgB;EAE1C,OAAO,KAAK,OAAO;GACjB;GACA,OAAO,KAAK;GACZ,MAAM,QAAQ;GACd,WAAW,QAAQ;EACrB,CAAC;CACH;;;;;;;;;;;;;;;;CAiBA,AAAO,QAAQ,UAAsC,CAAC,GAAW;EAC/D,MAAM,cAAc,iBAAiB,QAAQ,WAAW,IACpD,QAAQ,cACP,KAAK,gBAAgB,gBAAgB;EAE1C,OAAO,KAAK,OAAO;GACjB;GACA,OAAO,KAAK;GACZ,MAAM,QAAQ;GACd,WAAW,QAAQ;EACrB,CAAC;CACH;;;;;;;;;;;;;CAcA,IAAW,cAAsB;EAC/B,OAAO,KAAK,gBAAgB,gBAAgB;CAC9C;;;;;;;;;;;;;;;;;;;CAoBA,AAAO,eAAe,OAAqB;EACzC,KAAK,eAAe;EACpB,OAAO;CACT;;;;;;;;;;;;;CAcA,IAAW,cAAsB;EAC/B,OAAO,KAAK;CACd;;;;;;;;;;;;;;;;CAiBA,AAAO,eAAe,OAAqB;EACzC,KAAK,eAAe;EACpB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,IAAW,UAAkB;EAC3B,OAAO,KAAK;CACd;;;;;;;;;;;;;CAcA,AAAO,WAAW,OAAqB;EACrC,IAAI,iBAAiB,KAAK,GAAG,KAAK,WAAW;EAE7C,OAAO;CACT;AACF"}

package/dist/{index-8QVWHQzC.d.cts → index-BU6nzu6M.d.cts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.13`
+*  Version: `0.0.14-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -353,4 +353,4 @@ declare class CommandIdentity {
   setVersion(value: string): this;
 }
 export { CommandIdentity as t };
-//# sourceMappingURL=index-8QVWHQzC.d.cts.map
+//# sourceMappingURL=index-BU6nzu6M.d.cts.map

package/dist/{index-8QVWHQzC.d.ts → index-BU6nzu6M.d.ts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.13`
+*  Version: `0.0.14-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -353,4 +353,4 @@ declare class CommandIdentity {
   setVersion(value: string): this;
 }
 export { CommandIdentity as t };
-//# sourceMappingURL=index-8QVWHQzC.d.ts.map
+//# sourceMappingURL=index-BU6nzu6M.d.ts.map

package/dist/{index-CyGIoXau.d.ts → index-D5uQ7OdQ.d.cts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.13`
+*  Version: `0.0.14-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -43,7 +43,7 @@ Matches any valid JSON value.
 */
 type JsonValue = JsonPrimitive | JsonObject | JsonArray;
 /**
-Allows creating a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union.
+Create a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union.
 
 Currently, when a union type of a primitive type is combined with literal types, TypeScript loses all information about the combined literals. Thus, when such type is used in an IDE with autocompletion, no suggestions are made for the declared literals.
 
@@ -679,4 +679,4 @@ type GeneratePackageBannerOptions = {
 */
 declare const generatePackageBanner: (options?: GeneratePackageBannerOptions) => Promise<string>;
 export { generatePackageBanner as n, PackageJson as r, GeneratePackageBannerOptions as t };
-//# sourceMappingURL=index-CyGIoXau.d.ts.map
+//# sourceMappingURL=index-D5uQ7OdQ.d.cts.map

package/dist/{index-CyGIoXau.d.cts → index-D5uQ7OdQ.d.ts}

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.13`
+*  Version: `0.0.14-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -43,7 +43,7 @@ Matches any valid JSON value.
 */
 type JsonValue = JsonPrimitive | JsonObject | JsonArray;
 /**
-Allows creating a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union.
+Create a union type by combining primitive types and literal types without sacrificing auto-completion in IDEs for the literal type part of the union.
 
 Currently, when a union type of a primitive type is combined with literal types, TypeScript loses all information about the combined literals. Thus, when such type is used in an IDE with autocompletion, no suggestions are made for the declared literals.
 
@@ -679,4 +679,4 @@ type GeneratePackageBannerOptions = {
 */
 declare const generatePackageBanner: (options?: GeneratePackageBannerOptions) => Promise<string>;
 export { generatePackageBanner as n, PackageJson as r, GeneratePackageBannerOptions as t };
-//# sourceMappingURL=index-CyGIoXau.d.cts.map
+//# sourceMappingURL=index-D5uQ7OdQ.d.ts.map

package/dist/index.cjs

@@ -2,7 +2,7 @@
 * ========================================================================
 *  @rzl-zone/build-tools
 * ------------------------------------------------------------------------
-*  Version: `0.0.13`
+*  Version: `0.0.14-beta.0`
 *  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
 *  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
 * ========================================================================
@@ -10,10 +10,10 @@
 
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_formatter = require('./formatter-C-Yt_Gvf.cjs');
-const require_server = require('./server-BRuKWcjy.cjs');
-const require_identity = require('./identity-8Wy_JtzU.cjs');
-const require_package_banner = require('./package-banner-Cf5uu-7p.cjs');
+const require_formatter = require('./formatter-DkpMt0A4.cjs');
+const require_server = require('./server-BszV1phk.cjs');
+const require_identity = require('./identity-BHNQH-bO.cjs');
+const require_package_banner = require('./package-banner-CHj1ji3Y.cjs');
 require("@rzl-zone/node-only");
 let _babel_types = require("@babel/types");
 _babel_types = require_formatter.__toESM(_babel_types, 1);
@@ -1486,12 +1486,12 @@ const DEFAULT_SJC_OPTIONS = {
 	patternOptions: resolvedSjcPatternOption,
 	logLevel: DEFAULT_LOG_LEVEL
 };
-const VALID_SOURCE_TYPE = new Set([
+const VALID_SOURCE_TYPE = /* @__PURE__ */ new Set([
 	"module",
 	"script",
 	"commonjs"
 ]);
-const VALID_ECMA_VERSION = new Set([
+const VALID_ECMA_VERSION = /* @__PURE__ */ new Set([
 	"latest",
 	3,
 	5,