@reliverse/dler 1.7.69 → 1.7.70

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) Nazar Kornienko (blefnk), Reliverse
+Copyright (c) Nazar Kornienko (blefnk), Bleverse, Reliverse
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -2,147 +2,105 @@
 
 [sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/pb8ukbwpsj) — [github](https://github.com/reliverse/dler) — [npm](https://npmjs.com/@reliverse/dler)
 
-> @reliverse/dler (prev. relidler; `/ˈdiː.lər/`, dealer) is a unified package manager for typescript/javascript projects.
+> @reliverse/dler (formerly relidler; `/ˈdiː.lər/`, dealer) is a unified package manager for typescript/javascript projects.
 >
-> dler is your package manager's best friend. dler extends bun, pnpm, yarn, and npm core functionalities by going far beyond.
+> dler is your package manager’s best friend — it extends bun, deno (🔜), pnpm, yarn, and npm with powerful and modern features.
 >
-> at its core, dler is a flexible, unified, and fully automated bundler for typescript/javascript projects that doubles as an npm/jsr publishing tool. beyond bundling, dler serves as a comprehensive codemod toolkit for modern typescript/javascript development.
+> at its core, dler is a flexible and fully automated bundler that also doubles as an npm/jsr publishing tool. beyond bundling, dler provides a rich codemod toolkit designed for modern typescript/javascript development.
 
 ## features
 
-- **built-in bun environment** when dler is installed as a standalone application
-- **`unjs/unbuild` drop-in** with different powerful capabilities like publishing
-- **automated publishing** to npm/jsr registries with intelligent workflow management
-- **reliable builds** with comprehensive typescript/javascript support and error handling
-- **smart versioning** with automatic version bumps and semantic release integration
-- **zero configuration** eliminates `package.json` maintenance headaches forever
-- **performance optimized** for speed with modern build pipelines and caching
-- **17 built-in commands** — comprehensive [dler commands](#dler-commands) for every workflow
-- **path resolution magic** converts typescript aliases to relative imports automatically
-- **highly configurable** via dedicated configuration files with sensible defaults
-- **dual interface** — cli for everyday use, sdk for advanced programmatic control
-- **clean distribution builds** automatically removes internal logs and debug code
-- **monorepo ready** with experimental `libs` feature for multi-library projects
-- **magic spells** — extensible plugin system for custom build transformations
-- **codemod toolkit** — powerful code transformation utilities built-in
-
-### 🎯 perfect for
-
-dler excels at managing both build and publish workflows, making it ideal for:
-
-- cli tool creators and maintainers
-- project bootstrappers (like [rse](https://github.com/reliverse/rse))
-- library authors seeking streamlined workflows
-- teams wanting consistent build processes
-
-### 🔜 coming soon
-
-**full monorepo system** with advanced dependency management and cross-package optimization.
-
-### supported bundlers
-
-- ✅ [mkdist](https://github.com/unjs/mkdist#readme)
-- ✅ jsr
-- 🏗️ copy
-- 🏗️ [bun](https://bun.sh/docs/bundler)
-- 🏗️ [rollup](https://rollupjs.org)
-- 🏗️ [untyped](https://untyped.unjs.io)
-- 🔜 [tsdown](https://rolldown.rs)
-- 🔜 copy (prev. jsr)
-
-**legend**:
-
-- ✅ well tested with big projects
-- 🏗️ not well tested yet
-- 🔜 coming soon
+- **drop-in `unjs/unbuild` support** with extended capabilities like publishing
+- **automated publishing** to npm and jsr with smart workflow orchestration
+- **reliable builds** with robust typescript/javascript support and error handling
+- **smart versioning** with semantic release and automatic version bumping
+- **zero-config setup** — forget about `package.json` maintenance
+- **built-in bun environment** when used as a standalone cli app
+- **performance-optimized** using fast build pipelines and aggressive caching
+- **17 built-in commands** — see [dler commands](#dler-commands) for everything it can do
+- **path alias resolution** — automatically rewrites tsconfig aliases to relative imports
+- **configurable by design** — dedicated config files with sane defaults
+- **dual interface** — use via cli or import as sdk for programmatic use
+- **clean dist output** — strips internal logs and debug code automatically
+- **monorepo support** with experimental `libs` mode for multi-library setups
+- **magic spells** — plugin system for custom build logic and extensions
+- **codemod toolkit** — powerful code transformation utilities out of the box
+- **full monorepo system** with optimized cross-package dependency handling
+- **esp. designed for** cli tool creators, project bootstrappers (like [rse](https://github.com/reliverse/rse))
+- **perfect for** anyone who wants their package manager to have *sweet powers*
 
 ## getting started
 
-make sure you have git, node.js, and bun/pnpm/yarn/npm (**[bun](https://bun.sh/get) is highly recommended**) are installed. then:
+before using dler, make sure you have [git](https://git-scm.com/downloads), [node.js](https://nodejs.org/en/download), and a supported package manager installed — **[bun](https://bun.sh/get) is highly recommended** for the best experience.
 
 ### 0. try the playground
 
-> **💡 tip**:
-> want to test dler before integrating it into your project?
-> clone the dler repo and build it using dler itself!
+> 💡 **tip**
+> curious to see dler in action before integrating it into your project?
+> clone the repo and try e.g. `bun dler build` to build dler using... dler itself!
 
 ```sh
 git clone https://github.com/reliverse/dler.git
 cd dler
 bun i
-bun dev # bun src/cli.ts --dev
+bun dler build # runs dler from source (cli entry: src/cli.ts)
 ```
 
 ### 1. install dler
 
-**install as dev dep (recommended)**:
-
-```sh
-bun add -D @reliverse/dler
-# or update as needed:
-bun update --latest
-```
+it is recommended to install dler both globally and as a dev dependency:
 
-**and/or install globally**:
+- **global install** — `bun add -g @reliverse/dler` — lets you use dler anywhere, like a system-level cli.
+- **dev dependency** — `bun add -D @reliverse/dler` — pins the version per project, so all contributors use the same version.
 
-```sh
-bun add -g @reliverse/dler
-# or update as needed:
-bun i -g update --latest
-```
+instead of global install, you can alternatively install dler as a standalone binary: `bunx @reliverse/dler `
 
-- **when installed globally**: use `dler` anywhere.
-- **when installed as dev dep**: use with package manager name prefix, e.g. `bun dler`, inside your project directory.
-- **when installed as standalone**: ...
+> usage depends on how dler is installed:
+>
+> - `dler` → if installed globally (or as standalone binary)
+> - `bun dler` → if installed as a dev dependency
 
-### 2. prepare your project
+### 2. initialize dler config
 
-a. **configure `.gitignore`**:
+first-time dler run initializes config, repeatable runs launches dler interactive menu.
 
 ```sh
-echo "dist*" >> .gitignore
-echo "logs" >> .gitignore
+bun dler # if installed locally
+dler     # if installed globally
 ```
 
-b. **add `".config/**/*.ts"` to `include` in `tsconfig.json`**:
-
-```json
-"include": [".config/**/*.ts", ...]
-```
+this creates a starter config file: `.config/dler.ts`
 
-c. **package.json**:
+- it is recommended to tweak the config to match your project structure
+- example config: [.config/dler.ts →](https://github.com/reliverse/dler/blob/main/.config/dler.ts)
+- useful options:
 
-```json
-"scripts": {
-  "build": "dler build", // this is optional
-  "pub": "dler pub" // this does build+publish
-}
-```
+  - `buildPreExtensions`: support additional file types like `["ts", "js", "vue", "tsx", "jsx"]`
+  - `buildTemplatesDir`: exclude a directory from being built; it will be copied as-is (e.g. `src/foo/templates → dist-*/bin/foo/templates`)
 
-d. **initialize config**:
+### 3. run and enjoy
 
 ```sh
-bun dler # if installed as dev dep
-dler # if installed globally
+bun dler [build|pub|--help] # if local
+dler [build|pub|--help]     # if global
 ```
 
-- the `.config/dler.ts` file is automatically created on first run.
+> 💡 run `dler` for an interactive menu, or `dler --help` for full command list.
 
-e. **optionally, customize `.config/dler.ts`**:
+### 4. upgrade your dev tools
 
-- it's recommended to customize this file according to your needs.
-- you can check an example config here: [.config/dler.ts](https://github.com/reliverse/dler/blob/main/.config/dler.ts)
-- if you want to build files which have extensions other than `.ts` and `.js`, you can customize `buildPreExtensions` array (example: `["ts", "js", "vue", "tsx", "jsx"]`).
-- if you want to exclude some files from being built, you can customize `buildTemplatesDir` string (example: `"templates"`). by placing them in this directory, they will not be built, whole directory will be copied from e.g. `src/foo/templates` to `dist-*/bin/foo/templates` as-is.
+keeping your tools fresh is always a good practice.
 
-### 3. run and enjoy
+the command below **upgrades not just dler**, but also your local setup — including `git`, `node.js`, `bun`, `npm`, `yarn`, `pnpm`, and more.
+
+just run:
 
 ```sh
-bun dler [build|pub|--help] # if installed as dev dep
-dler [build|pub|--help] # if installed globally
+bun dler upgrade
 ```
 
-(_run just `dler` to see an interactive list of commands_)
+> ⚠️ don’t confuse this with `dler update`, which upgrades your **project dependencies** and **global packages**, not your system tools.
+> 👉 *note:* both `upgrade` and `update` will update **dler** itself — globally and in your `dependencies` or `devDependencies` if run inside a project with a `package.json` — depends on how dler is installed.
 
 ## dler commands
 
@@ -164,6 +122,23 @@ since dler is fully modular, build command is separated for its own build-in plu
 bun dler build ...
 ```
 
+### supported bundlers
+
+- ✅ [mkdist](https://github.com/unjs/mkdist#readme)
+- ✅ jsr
+- 🏗️ copy
+- 🏗️ [bun](https://bun.sh/docs/bundler)
+- 🏗️ [rollup](https://rollupjs.org)
+- 🏗️ [untyped](https://untyped.unjs.io)
+- 🔜 [tsdown](https://rolldown.rs)
+- 🔜 copy (prev. jsr)
+
+**legend**:
+
+- ✅ well tested with big projects
+- 🏗️ not well tested yet
+- 🔜 coming soon
+
 #### 1.1. `build binary` - Standalone Executable Builder
 
 creates standalone executables for different platforms using bun's `--compile` feature.
@@ -961,6 +936,7 @@ special thanks to the project that inspired `@reliverse/dler`:
 - [ ] at the moment any bundler like `mkdist` can be called using `bun`, but bun's own bundler is not yet fully supported
 - [ ] support all well-known package managers (currently only bun is fully supported)
 - [ ] `dler <command> [...flags] [...args]` usage should support both `bun` and `dler` own commands and flags
+- [ ] fully support deno and jsr
 
 ### todo: commands
 

package/bin/app/build/cmd.js

@@ -1,6 +1,5 @@
 import { defineArgs, defineCommand } from "@reliverse/rempts";
 import { dlerBuild } from "./impl.js";
-import { ensureDlerConfig } from "../../libs/sdk/sdk-impl/config/init.js";
 import { getConfigDler } from "../../libs/sdk/sdk-impl/config/load.js";
 import { finalizeBuild } from "../../libs/sdk/sdk-mod.js";
 export default defineCommand({
@@ -24,7 +23,6 @@ export default defineCommand({
   }),
   async run({ args }) {
     const isDev = args.dev || process.env.DLER_DEV_MODE === "true";
-    await ensureDlerConfig(isDev);
     const config = await getConfigDler();
     const { timer } = await dlerBuild(
       isDev,

package/bin/app/cmds.d.ts

@@ -16,3 +16,4 @@ export declare const getMagicCmd: () => Promise<Command>;
 export declare const getSplitCmd: () => Promise<Command>;
 export declare const getRmCmd: () => Promise<Command>;
 export declare const getUpdateCmd: () => Promise<Command>;
+export declare const getUpgradeCmd: () => Promise<Command>;

package/bin/app/cmds.js

@@ -16,3 +16,4 @@ export const getMagicCmd = async () => loadCommand("magic");
 export const getSplitCmd = async () => loadCommand("split");
 export const getRmCmd = async () => loadCommand("rm");
 export const getUpdateCmd = async () => loadCommand("update");
+export const getUpgradeCmd = async () => loadCommand("upgrade");

package/bin/app/get/cmd.d.ts

@@ -0,0 +1 @@
+export { default } from "../../libs/get/mod.js";

package/bin/app/get/cmd.js

@@ -0,0 +1 @@
+export { default } from "../../libs/get/mod.js";

package/bin/app/remove/cmd.d.ts

@@ -3,6 +3,7 @@
  * - dler remove package-name - removes a package
  * - dler rm package-name - removes a package (alias)
  * - dler uninstall package-name - removes a package (alias)
+ * - dler remove --standalone - removes standalone dler installation
  */
 declare const _default: import("@reliverse/rempts").Command<{
     action: {
@@ -38,5 +39,10 @@ declare const _default: import("@reliverse/rempts").Command<{
         description: string;
         default: false;
     };
+    standalone: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 export default _default;

package/bin/app/remove/cmd.js

@@ -1,5 +1,10 @@
+import path from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { defineArgs, defineCommand } from "@reliverse/rempts";
+import { execa } from "execa";
+import { lookpath } from "lookpath";
+import { homedir, platform } from "node:os";
 import { removeDependency } from "../../libs/sdk/sdk-impl/utils/pm/pm-api.js";
 export default defineCommand({
   meta: {
@@ -40,10 +45,19 @@ export default defineCommand({
       type: "boolean",
       description: "Run linter checks after removing dependencies",
       default: false
+    },
+    standalone: {
+      type: "boolean",
+      description: "Remove standalone dler installation",
+      default: false
     }
   }),
   async run({ args }) {
-    const { action, name, linter, ...options } = args;
+    const { action, name, linter, standalone, ...options } = args;
+    if (standalone) {
+      await removeStandaloneDler();
+      return;
+    }
     if (!name) {
       relinka.error("Package name is required for remove action");
       return process.exit(1);
@@ -69,3 +83,173 @@ export default defineCommand({
     }
   }
 });
+async function removeStandaloneDler() {
+  try {
+    relinka("info", "Removing standalone dler installation...");
+    const installDir = path.resolve(homedir(), ".reliverse", "dler");
+    const appsPath = path.resolve(homedir(), ".reliverse", "apps.json");
+    const currentMeta = await getCurrentAppsJson(appsPath, "dler");
+    if (!currentMeta) {
+      relinka("warn", "Standalone dler installation not found");
+      return;
+    }
+    const binaryInfo = getDlerBinaryInfo();
+    const binaryPath = path.resolve(installDir, binaryInfo.localName);
+    if (await fs.pathExists(binaryPath)) {
+      await fs.remove(binaryPath);
+      relinka("success", `Removed binary: ${binaryPath}`);
+    }
+    await removeFromPath(installDir);
+    await removeFromAppsJson(appsPath, "dler");
+    relinka("success", "Standalone dler installation removed successfully");
+    relinka("info", "Please restart your terminal for PATH changes to take effect");
+  } catch (error) {
+    relinka(
+      "error",
+      `Failed to remove standalone dler: ${error instanceof Error ? error.message : String(error)}`
+    );
+    process.exit(1);
+  }
+}
+function getDlerBinaryInfo() {
+  const os = platform();
+  if (os === "darwin") {
+    return {
+      filename: "dler-darwin-arm64",
+      localName: "dler"
+    };
+  } else if (os === "linux") {
+    return {
+      filename: "dler-linux",
+      localName: "dler"
+    };
+  } else if (os === "win32") {
+    return {
+      filename: "dler-windows.exe",
+      localName: "dler.exe"
+    };
+  } else {
+    throw new Error(`Unsupported platform: ${os}`);
+  }
+}
+async function getCurrentAppsJson(appsPath, binaryKey) {
+  try {
+    if (await fs.pathExists(appsPath)) {
+      const content = await fs.readFile(appsPath, "utf8");
+      const allMeta = JSON.parse(content);
+      return allMeta[binaryKey] || null;
+    }
+  } catch {
+  }
+  return null;
+}
+async function removeFromAppsJson(appsPath, binaryKey) {
+  try {
+    if (await fs.pathExists(appsPath)) {
+      const content = await fs.readFile(appsPath, "utf8");
+      const allMeta = JSON.parse(content);
+      delete allMeta[binaryKey];
+      if (Object.keys(allMeta).length === 0) {
+        await fs.remove(appsPath);
+        relinka("info", "Removed empty apps.json file");
+      } else {
+        await fs.writeFile(appsPath, JSON.stringify(allMeta, null, 2), "utf8");
+        relinka("info", "Updated apps.json file");
+      }
+    }
+  } catch (error) {
+    relinka("warn", `Could not update apps.json: ${error}`);
+  }
+}
+async function removeFromPath(installDir) {
+  const os = platform();
+  if (os === "win32") {
+    try {
+      await removeFromWindowsPath(installDir);
+      relinka("success", `Removed ${installDir} from PATH`);
+    } catch (error) {
+      relinka("warn", `Failed to automatically remove from PATH: ${error}`);
+      relinka("info", `Please manually remove ${installDir} from your PATH environment variable`);
+    }
+  } else {
+    const homeDir = homedir();
+    const shellRc = os === "darwin" ? path.resolve(homeDir, ".zshrc") : path.resolve(homeDir, ".bashrc");
+    try {
+      if (await fs.pathExists(shellRc)) {
+        let rcContent = await fs.readFile(shellRc, "utf8");
+        const pathExport = `export PATH="${installDir}:$PATH"`;
+        const commentLine = "# Added by dler get command";
+        rcContent = rcContent.replace(
+          new RegExp(
+            `
+${commentLine}
+${pathExport.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}
+`,
+            "g"
+          ),
+          "\n"
+        ).replace(
+          new RegExp(
+            `${commentLine}
+${pathExport.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}
+?`,
+            "g"
+          ),
+          ""
+        ).replace(new RegExp(`
+?${pathExport.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`, "g"), "");
+        await fs.writeFile(shellRc, rcContent, "utf8");
+        relinka("success", `Removed from PATH in ${shellRc}`);
+        relinka("info", "Please restart your terminal or run: source " + shellRc);
+      }
+    } catch (error) {
+      relinka("warn", `Could not modify shell RC file: ${error}`);
+      relinka("info", `Please manually remove ${installDir} from your PATH`);
+    }
+  }
+}
+async function removeFromWindowsPath(installDir) {
+  const psScript = `
+    function Refresh-Path {
+      $paths = @(
+        [System.Environment]::GetEnvironmentVariable("Path", "Machine"),
+        [System.Environment]::GetEnvironmentVariable("Path", "User"),
+        [System.Environment]::GetEnvironmentVariable("Path", "Process")
+      )
+      $uniquePaths = $paths |
+        Where-Object { $_ } |
+        ForEach-Object { $_.Split(';', [StringSplitOptions]::RemoveEmptyEntries) } |
+        Where-Object { $_ -and (Test-Path $_) } |
+        Select-Object -Unique
+      $env:Path = ($uniquePaths -join ';').TrimEnd(';')
+    }
+    function Remove-From-User-Path {
+      param([string]$Directory)
+      $absolutePath = Resolve-Path $Directory -ErrorAction SilentlyContinue
+      if (-not $absolutePath) {
+        $absolutePath = $Directory
+      }
+      $currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
+      if (-not $currentPath) { 
+        Write-Host "No User PATH found"
+        return
+      }
+      # Split PATH and remove the target directory
+      $pathArray = $currentPath.Split(';', [StringSplitOptions]::RemoveEmptyEntries)
+      $filteredPaths = $pathArray | Where-Object { $_ -ne $absolutePath }
+      if ($pathArray.Count -eq $filteredPaths.Count) {
+        Write-Host "Directory not found in PATH"
+        return
+      }
+      $newPath = $filteredPaths -join ';'
+      Write-Host "Removing $absolutePath from User PATH..."
+      [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
+      Refresh-Path
+      Write-Host "PATH updated successfully"
+    }
+    Remove-From-User-Path '${installDir.replace(/\\/g, "\\\\").replace(/'/g, "''")}' 
+  `.trim();
+  const pwshPath = await lookpath("pwsh");
+  const powershellCmd = pwshPath || "powershell";
+  await execa(powershellCmd, ["-Command", psScript]);
+}

package/bin/app/update/cmd.d.ts

@@ -59,5 +59,16 @@ declare const _default: import("@reliverse/rempts").Command<{
         default: false;
         alias: string;
     };
+    global: {
+        type: "boolean";
+        description: string;
+        default: false;
+        alias: string;
+    };
+    interactive: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 export default _default;