@rzl-zone/build-tools 0.0.5

package/dist/utils/client.js

@@ -0,0 +1,12 @@
+/*!
+* ========================================================================
+*  @rzl-zone/build-tools
+* ------------------------------------------------------------------------
+*  Version: `0.0.5`
+*  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
+* ========================================================================
+*/
+
+import { a as joinInline, c as padText, i as formatOptionValue, l as picocolors, n as EOL, o as joinLines, r as NEWLINE, s as joinLinesLoose, t as ConfigurationError, u as plural } from "../client-XhkdKJ4d.js";
+export { ConfigurationError, EOL, NEWLINE, formatOptionValue, joinInline, joinLines, joinLinesLoose, padText, picocolors, plural };

package/dist/utils/server.cjs

@@ -0,0 +1,17 @@
+/*!
+* ========================================================================
+*  @rzl-zone/build-tools
+* ------------------------------------------------------------------------
+*  Version: `0.0.5`
+*  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
+* ========================================================================
+*/
+
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_server = require('../server-B2hBoGDR.cjs');
+exports.ICONS = require_server.ICONS;
+exports.defaultPatternOptions = require_server.defaultPatternOptions;
+exports.fastGlob = require_server.fastGlob;
+exports.fsExtra = require_server.fsExtra;

package/dist/utils/server.d.cts

@@ -0,0 +1,124 @@
+/*!
+* ========================================================================
+*  @rzl-zone/build-tools
+* ------------------------------------------------------------------------
+*  Version: `0.0.5`
+*  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
+* ========================================================================
+*/
+
+import { n as PatternOptions, r as defaultPatternOptions, t as PatternConfig } from "../fast-globe-options-BFt__e__.cjs";
+import _fastGlob from "fast-glob";
+import _fsExtra from "fs-extra";
+type Icons = { readonly [K in keyof typeof emojiIcons]: string };
+declare const emojiIcons: {
+  readonly start: "🕐";
+  readonly arrowRight: "▶️";
+  readonly arrowRightMini: "›";
+  readonly bulletBold: "●";
+  readonly bullet: "•";
+  readonly whiteCircle: "○";
+  readonly whiteBullet: "◦";
+  readonly smallSquare: "▪";
+  readonly success: "✅";
+  readonly warn: "⚠️";
+  readonly error: "❌";
+  readonly config: "⚙️";
+  readonly settings: "🛠️";
+  readonly file: "📄";
+  readonly files: "📁";
+  readonly folder: "📂";
+  readonly path: "🧭";
+  readonly add: "➕";
+  readonly remove: "➖";
+  readonly update: "♻️";
+  readonly copy: "📋";
+  readonly move: "📦";
+  readonly clean: "🧹";
+  readonly build: "🏗️";
+  readonly generate: "🧩";
+  readonly compile: "⚡";
+  readonly watch: "👀";
+  readonly info: "ℹ️";
+  readonly debug: "🐛";
+  readonly question: "❓";
+  readonly separator: "━";
+};
+/** ----------------------------------------------------------------
+* * ***CLI icon mapping (emoji or ASCII fallback).***
+* ----------------------------------------------------------------
+*
+* Provides a centralized set of visual symbols used across the CLI
+* for rendering flow indicators, status messages, filesystem labels,
+* and action markers.
+*
+* - *The icon set is determined at runtime via the environment variable:*
+*     - `FORCE_EMOJI=1` ➜ Emoji icons are enabled.
+*     - Otherwise ➜ ASCII-safe fallback icons are used.
+*
+* - *This ensures compatibility with:*
+*     - Terminals that do not support emoji rendering.
+*     - CI environments.
+*     - Minimal shells or log files.
+* - *Behavior:*
+*     - The object shape is identical in both modes.
+*     - Only the visual representation changes.
+*     - The value is resolved once at module evaluation time.
+* ----------------------------------------------------------------
+* #### Environment Control
+* ```bash
+* FORCE_EMOJI=1
+* ```
+* ----------------------------------------------------------------
+* @remarks
+* This constant is intended for internal CLI rendering only, do not mutate the returned object.
+*
+* @example
+* ```ts
+* console.log(`${ICONS.success} Build completed`);
+* ```
+*
+*/
+declare const ICONS: Readonly<Icons>;
+/** ----------------------------------------------------------------
+* * ***Node.js–only filesystem utilities (fs-extra).***
+* ----------------------------------------------------------------
+*
+* This export is a **thin re-export** of the `fs-extra` package,
+* intended for **server-side / Node.js environments only**.
+*
+* ⚠️ **DO NOT import this in browser or client-side code.**
+* The underlying implementation depends on Node.js built-in
+* modules such as `fs`, `path`, and `process`.
+*
+* - *Typical use cases:*
+*     - CLI tools.
+*     - Build scripts.
+*     - File system manipulation on the server.
+*
+* @see {@link https://github.com/jprichardson/node-fs-extra | **`https://github.com/jprichardson/node-fs-extra`**}.
+* @environment node
+*/
+declare const fsExtra: typeof _fsExtra;
+/** ----------------------------------------------------------------
+* * ***High-performance file system globbing utility (fast-glob).***
+* ----------------------------------------------------------------
+*
+* This export re-exports the default export of `fast-glob`,
+* which is implemented using **CommonJS `export =` semantics**.
+*
+* Due to its reliance on Node.js APIs, this module is
+* **server-side only** and must not be bundled for the browser.
+*
+* - *Typical use cases:*
+*     - Resolving file patterns in build tools.
+*     - Scanning project directories.
+*     - CLI and automation scripts.
+*
+* @see {@link https://github.com/mrmlnc/fast-glob | **`https://github.com/mrmlnc/fast-glob`**}.
+* @environment node
+*/
+declare const fastGlob: typeof _fastGlob;
+export { ICONS, type PatternConfig, type PatternOptions, defaultPatternOptions, fastGlob, fsExtra };
+//# sourceMappingURL=server.d.cts.map

package/dist/utils/server.d.ts

@@ -0,0 +1,124 @@
+/*!
+* ========================================================================
+*  @rzl-zone/build-tools
+* ------------------------------------------------------------------------
+*  Version: `0.0.5`
+*  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
+* ========================================================================
+*/
+
+import { n as PatternOptions, r as defaultPatternOptions, t as PatternConfig } from "../fast-globe-options-6r2aj6UC.js";
+import _fastGlob from "fast-glob";
+import _fsExtra from "fs-extra";
+type Icons = { readonly [K in keyof typeof emojiIcons]: string };
+declare const emojiIcons: {
+  readonly start: "🕐";
+  readonly arrowRight: "▶️";
+  readonly arrowRightMini: "›";
+  readonly bulletBold: "●";
+  readonly bullet: "•";
+  readonly whiteCircle: "○";
+  readonly whiteBullet: "◦";
+  readonly smallSquare: "▪";
+  readonly success: "✅";
+  readonly warn: "⚠️";
+  readonly error: "❌";
+  readonly config: "⚙️";
+  readonly settings: "🛠️";
+  readonly file: "📄";
+  readonly files: "📁";
+  readonly folder: "📂";
+  readonly path: "🧭";
+  readonly add: "➕";
+  readonly remove: "➖";
+  readonly update: "♻️";
+  readonly copy: "📋";
+  readonly move: "📦";
+  readonly clean: "🧹";
+  readonly build: "🏗️";
+  readonly generate: "🧩";
+  readonly compile: "⚡";
+  readonly watch: "👀";
+  readonly info: "ℹ️";
+  readonly debug: "🐛";
+  readonly question: "❓";
+  readonly separator: "━";
+};
+/** ----------------------------------------------------------------
+* * ***CLI icon mapping (emoji or ASCII fallback).***
+* ----------------------------------------------------------------
+*
+* Provides a centralized set of visual symbols used across the CLI
+* for rendering flow indicators, status messages, filesystem labels,
+* and action markers.
+*
+* - *The icon set is determined at runtime via the environment variable:*
+*     - `FORCE_EMOJI=1` ➜ Emoji icons are enabled.
+*     - Otherwise ➜ ASCII-safe fallback icons are used.
+*
+* - *This ensures compatibility with:*
+*     - Terminals that do not support emoji rendering.
+*     - CI environments.
+*     - Minimal shells or log files.
+* - *Behavior:*
+*     - The object shape is identical in both modes.
+*     - Only the visual representation changes.
+*     - The value is resolved once at module evaluation time.
+* ----------------------------------------------------------------
+* #### Environment Control
+* ```bash
+* FORCE_EMOJI=1
+* ```
+* ----------------------------------------------------------------
+* @remarks
+* This constant is intended for internal CLI rendering only, do not mutate the returned object.
+*
+* @example
+* ```ts
+* console.log(`${ICONS.success} Build completed`);
+* ```
+*
+*/
+declare const ICONS: Readonly<Icons>;
+/** ----------------------------------------------------------------
+* * ***Node.js–only filesystem utilities (fs-extra).***
+* ----------------------------------------------------------------
+*
+* This export is a **thin re-export** of the `fs-extra` package,
+* intended for **server-side / Node.js environments only**.
+*
+* ⚠️ **DO NOT import this in browser or client-side code.**
+* The underlying implementation depends on Node.js built-in
+* modules such as `fs`, `path`, and `process`.
+*
+* - *Typical use cases:*
+*     - CLI tools.
+*     - Build scripts.
+*     - File system manipulation on the server.
+*
+* @see {@link https://github.com/jprichardson/node-fs-extra | **`https://github.com/jprichardson/node-fs-extra`**}.
+* @environment node
+*/
+declare const fsExtra: typeof _fsExtra;
+/** ----------------------------------------------------------------
+* * ***High-performance file system globbing utility (fast-glob).***
+* ----------------------------------------------------------------
+*
+* This export re-exports the default export of `fast-glob`,
+* which is implemented using **CommonJS `export =` semantics**.
+*
+* Due to its reliance on Node.js APIs, this module is
+* **server-side only** and must not be bundled for the browser.
+*
+* - *Typical use cases:*
+*     - Resolving file patterns in build tools.
+*     - Scanning project directories.
+*     - CLI and automation scripts.
+*
+* @see {@link https://github.com/mrmlnc/fast-glob | **`https://github.com/mrmlnc/fast-glob`**}.
+* @environment node
+*/
+declare const fastGlob: typeof _fastGlob;
+export { ICONS, type PatternConfig, type PatternOptions, defaultPatternOptions, fastGlob, fsExtra };
+//# sourceMappingURL=server.d.ts.map

package/dist/utils/server.js

@@ -0,0 +1,12 @@
+/*!
+* ========================================================================
+*  @rzl-zone/build-tools
+* ------------------------------------------------------------------------
+*  Version: `0.0.5`
+*  Author: `Rizalvin Dwiky <rizalvindwiky1998@gmail.com>`
+*  Repository: `https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools`
+* ========================================================================
+*/
+
+import { i as defaultPatternOptions, n as fsExtra, r as ICONS, t as fastGlob } from "../server-CWrDd29Y.js";
+export { ICONS, defaultPatternOptions, fastGlob, fsExtra };

package/package.json

@@ -0,0 +1,151 @@
+{
+  "name": "@rzl-zone/build-tools",
+  "version": "0.0.5",
+  "description": "Toolkit to standardize and improve build outputs for TypeScript and JavaScript packages.",
+  "license": "MIT",
+  "author": "Rizalvin Dwiky <rizalvindwiky1998@gmail.com>",
+  "contributors": [
+    "Rizalvin Dwiky <rizalvindwiky1998@gmail.com>"
+  ],
+  "homepage": "https://github.com/rzl-zone/rzl-zone/tree/main/packages/build-tools",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rzl-zone/rzl-zone.git",
+    "directory": "packages/build-tools"
+  },
+  "keywords": [
+    "build",
+    "build tools",
+    "build-tools",
+    "typescript",
+    "javascript",
+    "ts",
+    "js",
+    "tools",
+    "build tools rzl",
+    "rzl build tools",
+    "rzl build",
+    "@rzl-zone",
+    "@rzl-zone/build-tools",
+    "rzl",
+    "rzl-zone",
+    "rzl zone"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engineStrict": true,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md",
+    "!**/*.test.*"
+  ],
+  "exports": {
+    "./.references": {
+      "import": {
+        "types": "./dist/.references/index.d.ts"
+      },
+      "require": {
+        "types": "./dist/.references/index.d.cts"
+      }
+    },
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./bundler/*": {
+      "import": {
+        "types": "./dist/bundler/*.d.ts",
+        "default": "./dist/bundler/*.js"
+      },
+      "require": {
+        "types": "./dist/bundler/*.d.cts",
+        "default": "./dist/bundler/*.cjs"
+      }
+    },
+    "./utils": {
+      "import": {
+        "types": "./dist/utils/client.d.ts",
+        "default": "./dist/utils/client.js"
+      },
+      "require": {
+        "types": "./dist/utils/client.d.cts",
+        "default": "./dist/utils/client.cjs"
+      }
+    },
+    "./utils/server": {
+      "import": {
+        "types": "./dist/utils/server.d.ts",
+        "default": "./dist/utils/server.js"
+      },
+      "require": {
+        "types": "./dist/utils/server.d.cts",
+        "default": "./dist/utils/server.cjs"
+      }
+    },
+    "./commander-kit": {
+      "import": {
+        "types": "./dist/commander-kit/index.d.ts",
+        "default": "./dist/commander-kit/index.js"
+      },
+      "require": {
+        "types": "./dist/commander-kit/index.d.cts",
+        "default": "./dist/commander-kit/index.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@babel/parser": "^7.29.2",
+    "@babel/traverse": "^7.29.0",
+    "@babel/types": "^7.29.0",
+    "acorn": "^8.16.0",
+    "commander": "^14.0.3",
+    "dotenv": "^17.4.2",
+    "fast-glob": "^3.3.3",
+    "fs-extra": "^11.3.4",
+    "picocolors": "^1.1.1",
+    "semver": "^7.7.4",
+    "@rzl-zone/node-only": "0.0.5"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.28.0",
+    "@types/fs-extra": "^11.0.4",
+    "eslint": "^9.39.2",
+    "rolldown": "^1.0.0-rc.15",
+    "terser": "^5.46.1",
+    "tsdown": "0.21.8",
+    "type-fest": "5.5.0",
+    "typescript": "^6.0.2",
+    "@workspace/eslint-config": "0.0.0",
+    "@workspace/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "rolldown": ">=1",
+    "tsdown": "^0.21.x"
+  },
+  "peerDependenciesMeta": {
+    "rolldown": {
+      "optional": true
+    },
+    "tsdown": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "check-types:package": "tsc --noEmit",
+    "build": "tsdown --config-loader unrun",
+    "dev:package-build-tools": "tsdown --watch \"./src/**/*\" --config-loader unrun"
+  }
+}