@reliverse/dler 1.7.27 → 1.7.29

package/README.md

@@ -1,25 +1,46 @@
-# dler (prev. relidler) • framework for ts/js libs/cli/apps
+# 🛋️ dler (prev. relidler) • build/publish/improve ts/js libs/cli/apps
 
-> @reliverse/dler (`/ˈdiː.lər/`, dealer) is a flexible, unified, and fully automated bundler for ts/js projects, as well as an npm/jsr publishing tool. dler is not only a bundler, it also tries to serve as the most powerful codemod toolkit for ts/js.
+[sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/pb8ukbwpsj) — [github](https://github.com/reliverse/dler) — [npm](https://npmjs.com/@reliverse/dler)
 
-[sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/pb8ukbwpsj) — [github](https://github.com/reliverse/dler) — [npm](https://npmjs.com/@reliverse/dler) — [docs](https://docs.reliverse.org/reliverse/dler)
+> @reliverse/dler (`/ˈdiː.lər/`, dealer) 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.
 
 ## features
 
-- 😘 replacement for `unjs/unbuild`
-- ⚡ `dler` works via cli and sdk
-- 📦 automated npm/jsr publishing
-- ✅ ensures reliable ts/js builds
-- 🔄 handles automatic version bumps
-- 🔧 eliminates `package.json` headaches
-- 🎯 optimized for speed and modern workflows
-- ✨ packed with powerful features under the hood
-- 🛠️ converts typescript aliases to relative paths
-- 🔌 18 built-in helper [dler commands](#-commands) included
-- 📝 highly configurable flow via a configuration file
-- 🔜 `libraries` plugin —> dler monorepo implementation
-- 🧼 cleans up your internal logs from the build dist
-- 🪄 magic spells (built-in plugin)
+### 🚀 core power
+
+- **drop-in replacement** for `unjs/unbuild` — seamless migration with enhanced capabilities
+- **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
+
+### ⚡ developer experience
+
+- **performance optimized** for speed with modern build pipelines and caching
+- **18 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
+
+### 🔧 advanced capabilities
+
+- **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
 
@@ -40,7 +61,7 @@
 
 ## getting started
 
-ensure git, node.js, and bun/pnpm/yarn/npm are installed. then:
+ensure git, node.js, and bun/pnpm/yarn/npm (**[bun](https://bun.sh/get) is highly recommended**) are installed. then:
 
 ### playground
 
@@ -75,6 +96,9 @@ bun dev # bun src/cli.ts --dev
     bun i -g update --latest
     ```
 
+    - **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.
+
 2. **prepare your project**:
 
     a. **configure `.gitignore`**:
@@ -117,7 +141,7 @@ bun dev # bun src/cli.ts --dev
     dler [build|pub] # if installed globally
     ```
 
-## 🔌 commands
+## dler commands
 
 dler ships with a flexible command system (prev. plugins) and **18 built-in commands** (from [reliverse addons](https://reliverse.org/addons) collection).
 
@@ -820,12 +844,16 @@ special thanks to the project that inspired `@reliverse/dler`:
 
 ## contributors
 
-### scripts
+### helper scripts
 
 - `libs:pack`: Creates two templates, `cfg` and `sdk`, based on dist-libs directory structure (using **dler pack** command).
 - `libs:unpack`: Creates a project structure using all templates from the `cfg` and `sdk` templates (using **dler unpack** command).
 - `libs:example`: Since `libs:unpack`'s serves as a dist-libs mock, then `libs:example` helps easily test dler's features like `resolveAllCrossLibs()`.
 
+### notes
+
+- `<src | dist-npm | dist-jsr>/libs/<lib-name>/<files live here>` === `dist-libs/<lib-name>/<jsr | npm>/bin/<files live here>`
+
 ## support
 
 - if dler saves you time and effort, please consider supporting its development: [github sponsors](https://github.com/sponsors/blefnk);

package/bin/app/build/impl.js

@@ -26,9 +26,20 @@ export async function dlerBuild(isDev, config) {
       effectiveConfig.libsList
     );
     await dlerPreBuild(effectiveConfig);
-    await regular_buildFlow(timer, isDev, effectiveConfig);
-    await library_buildFlow(timer, isDev, effectiveConfig);
+    const tempDirs = {
+      npm: "dist-tmp/tmp-npm",
+      jsr: "dist-tmp/tmp-jsr",
+      libs: "dist-tmp/tmp-libs"
+    };
+    const tempConfig = {
+      ...effectiveConfig,
+      coreEntrySrcDir: tempDirs.npm,
+      libsDirSrc: tempDirs.libs
+    };
+    await regular_buildFlow(timer, isDev, tempConfig);
+    await library_buildFlow(timer, isDev, tempConfig);
     await dlerPostBuild(isDev);
+    await fs.remove(path.join(PROJECT_ROOT, "dist-tmp"));
     return { timer, effectiveConfig };
   } catch (error) {
     handleDlerError(error);

package/bin/app/build/postbuild.js

@@ -1,10 +1,13 @@
 import path, { convertImportsAliasToRelative } from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { runCmd } from "@reliverse/rempts";
+import { glob } from "tinyglobby";
 import { getCheckCmd } from "../cmds.js";
 import { getConfigDler } from "../../libs/sdk/sdk-impl/config/load.js";
 import { applyMagicSpells } from "../../libs/sdk/sdk-impl/magic/ms-apply.js";
 import { resolveAllCrossLibs } from "../../libs/sdk/sdk-impl/utils/resolve-cross-libs.js";
+import { PROJECT_ROOT } from "../../libs/sdk/sdk-impl/utils/utils-consts.js";
 import { directoryExists, executeDlerHooks } from "./ppb-utils.js";
 const DIST_DIRECTORIES = ["dist-npm", "dist-jsr"];
 const ALIAS_TO_REPLACE = "~";
@@ -38,13 +41,62 @@ async function processDistDirectories() {
     await processDistDirectory(dir, ALIAS_TO_REPLACE);
   }
 }
+async function copyNonBuildFiles(srcDir, distDir, preExtensions, templatesDir) {
+  try {
+    const files = await glob("**/*", {
+      cwd: srcDir,
+      onlyFiles: true
+    });
+    for (const file of files) {
+      const ext = path.extname(file).slice(1);
+      const isInTemplatesDir = file.startsWith(templatesDir);
+      if (isInTemplatesDir || !preExtensions.includes(ext)) {
+        const srcPath = path.join(srcDir, file);
+        const destPath = path.join(distDir, file);
+        await fs.ensureDir(path.dirname(destPath));
+        await fs.copy(srcPath, destPath);
+      }
+    }
+  } catch (error) {
+    relinka(
+      "error",
+      `Error copying non-build files: ${error instanceof Error ? error.message : String(error)}`
+    );
+    throw error;
+  }
+}
 export async function dlerPostBuild(isDev) {
+  relinka("info", "\u2014 \u2014 \u2014 dlerPostBuild \u2014 \u2014 \u2014");
+  const config = await getConfigDler();
   await resolveAllCrossLibs();
+  if (config.commonPubRegistry === "npm" || config.commonPubRegistry === "npm-jsr") {
+    await copyNonBuildFiles(
+      path.join(PROJECT_ROOT, config.coreEntrySrcDir),
+      path.join(PROJECT_ROOT, config.distNpmDirName),
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
+  if (config.commonPubRegistry === "jsr" || config.commonPubRegistry === "npm-jsr") {
+    await copyNonBuildFiles(
+      path.join(PROJECT_ROOT, config.coreEntrySrcDir),
+      path.join(PROJECT_ROOT, config.distJsrDirName),
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
+  if (config.libsActMode === "libs-only" || config.libsActMode === "main-and-libs") {
+    await copyNonBuildFiles(
+      path.join(PROJECT_ROOT, config.libsDirSrc),
+      path.join(PROJECT_ROOT, config.libsDirDist),
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
   if (isDev) {
     await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
   }
   await processDistDirectories();
-  const config = await getConfigDler();
   await executeDlerHooks(config?.hooksAfterBuild ?? [], "post-build");
   if (config?.runAfterBuild?.length) {
     const tools = createPostBuildToolRunner();

package/bin/app/build/prebuild.js

@@ -1,6 +1,10 @@
+import path from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { runCmd } from "@reliverse/rempts";
+import { glob } from "tinyglobby";
 import { getCheckCmd } from "../cmds.js";
+import { PROJECT_ROOT } from "../../libs/sdk/sdk-impl/utils/utils-consts.js";
 import { executeCommand, executeDlerHooks, isCommandAvailable } from "./ppb-utils.js";
 const createToolRunner = () => ({
   tsc: {
@@ -27,8 +31,66 @@ const createToolRunner = () => ({
     }
   }
 });
+async function copyFilesToTempDir(srcDir, tempDir, extensions, excludeDir) {
+  try {
+    await fs.ensureDir(tempDir);
+    const files = await glob("**/*", {
+      cwd: srcDir,
+      ignore: [`**/${excludeDir}/**`],
+      onlyFiles: true
+    });
+    for (const file of files) {
+      const ext = path.extname(file).slice(1);
+      if (extensions.includes(ext)) {
+        const srcPath = path.join(srcDir, file);
+        const destPath = path.join(tempDir, file);
+        await fs.ensureDir(path.dirname(destPath));
+        await fs.copy(srcPath, destPath);
+      }
+    }
+  } catch (error) {
+    relinka(
+      "error",
+      `Error copying files to temp directory: ${error instanceof Error ? error.message : String(error)}`
+    );
+    throw error;
+  }
+}
 export async function dlerPreBuild(config) {
+  relinka("info", "\u2014 \u2014 \u2014 dlerPreBuild \u2014 \u2014 \u2014");
   await executeDlerHooks(config?.hooksBeforeBuild ?? [], "pre-build");
+  const tempDirs = {
+    npm: path.join(PROJECT_ROOT, "dist-tmp", "tmp-npm"),
+    jsr: path.join(PROJECT_ROOT, "dist-tmp", "tmp-jsr"),
+    libs: path.join(PROJECT_ROOT, "dist-tmp", "tmp-libs")
+  };
+  for (const dir of Object.values(tempDirs)) {
+    await fs.remove(dir);
+  }
+  if (config.commonPubRegistry === "npm" || config.commonPubRegistry === "npm-jsr") {
+    await copyFilesToTempDir(
+      path.join(PROJECT_ROOT, config.coreEntrySrcDir),
+      tempDirs.npm,
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
+  if (config.commonPubRegistry === "jsr" || config.commonPubRegistry === "npm-jsr") {
+    await copyFilesToTempDir(
+      path.join(PROJECT_ROOT, config.coreEntrySrcDir),
+      tempDirs.jsr,
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
+  if (config.libsActMode === "libs-only" || config.libsActMode === "main-and-libs") {
+    await copyFilesToTempDir(
+      path.join(PROJECT_ROOT, config.libsDirSrc),
+      tempDirs.libs,
+      config.buildPreExtensions,
+      config.buildTemplatesDir
+    );
+  }
   if (!config?.runBeforeBuild?.length) return;
   const tools = createToolRunner();
   const availableTools = await Promise.all(

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

@@ -6,13 +6,13 @@ interface DirOptions {
 }
 type DirConfig = Record<string, DirOptions>;
 type ExtMap = Record<string, [string, string, string]>;
-interface ConfigFile {
+export interface ConfigRemdn {
     title?: string;
     output?: string;
     dirs: DirConfig;
     "ext-map"?: ExtMap;
 }
-export declare function scanDirectories(config?: ConfigFile, configPath?: string, outputPath?: string): Promise<void>;
+export declare function scanDirectories(config?: ConfigRemdn, configPath?: string, outputPath?: string): Promise<void>;
 declare const _default: import("@reliverse/rempts").Command<{
     mode: {
         type: "string";
@@ -31,13 +31,5 @@ declare const _default: import("@reliverse/rempts").Command<{
         type: "string";
         description: string;
     };
-    processLibsOnly: {
-        type: "boolean";
-        description: string;
-    };
-    preventLibsProcessing: {
-        type: "boolean";
-        description: string;
-    };
 }>;
 export default _default;