@reliverse/dler 1.7.28 → 1.7.30

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
+
+- **`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
+
+### ⚡ 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).
 
@@ -828,7 +852,7 @@ special thanks to the project that inspired `@reliverse/dler`:
 
 ### notes
 
-`<src | dist-npm | dist-jsr>/libs/<lib-name>/<files live here>` === `dist-libs/<lib-name>/<jsr | npm>/bin/<files live here>`
+- `<src | dist-npm | dist-jsr>/libs/<lib-name>/<files live here>` === `dist-libs/<lib-name>/<jsr | npm>/bin/<files live here>`
 
 ## support
 

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

@@ -3,5 +3,13 @@ declare const _default: import("@reliverse/rempts").Command<{
         type: "boolean";
         description: string;
     };
+    debugOnlyCopyNonBuildFiles: {
+        type: "boolean";
+        description: string;
+    };
+    debugDontCopyNonBuildFiles: {
+        type: "boolean";
+        description: string;
+    };
 }>;
 export default _default;

package/bin/app/build/cmd.js

@@ -12,12 +12,25 @@ export default defineCommand({
     dev: {
       type: "boolean",
       description: "Runs the CLI in dev mode"
+    },
+    debugOnlyCopyNonBuildFiles: {
+      type: "boolean",
+      description: "Only copy non-build files to dist directories"
+    },
+    debugDontCopyNonBuildFiles: {
+      type: "boolean",
+      description: "Don't copy non-build files to dist directories, only build buildPreExtensions files"
     }
   }),
   async run({ args }) {
     await ensureDlerConfig(args.dev);
     const config = await getConfigDler();
-    const { timer } = await dlerBuild(args.dev, config);
+    const { timer } = await dlerBuild(
+      args.dev,
+      config,
+      args.debugOnlyCopyNonBuildFiles,
+      args.debugDontCopyNonBuildFiles
+    );
     await finalizeBuild(timer, false, "build");
   }
 });

package/bin/app/build/impl.d.ts

@@ -4,7 +4,7 @@ import type { DlerConfig } from "../../libs/sdk/sdk-impl/config/types.js";
  * Handles building for both main project and libraries.
  * @see `src/app/pub/impl.ts` for pub main function implementation.
  */
-export declare function dlerBuild(isDev: boolean, config?: DlerConfig): Promise<{
+export declare function dlerBuild(isDev: boolean, config?: DlerConfig, debugOnlyCopyNonBuildFiles?: boolean, debugDontCopyNonBuildFiles?: boolean): Promise<{
     timer: any;
     effectiveConfig: any;
 } | undefined>;

package/bin/app/build/impl.js

@@ -1,5 +1,6 @@
 import path from "@reliverse/pathkit";
 import fs from "@reliverse/relifso";
+import { relinka } from "@reliverse/relinka";
 import { getConfigDler } from "../../libs/sdk/sdk-impl/config/load.js";
 import { library_buildFlow } from "../../libs/sdk/sdk-impl/library-flow.js";
 import { regular_buildFlow } from "../../libs/sdk/sdk-impl/regular-flow.js";
@@ -7,9 +8,9 @@ import { removeDistFolders } from "../../libs/sdk/sdk-impl/utils/utils-clean.js"
 import { PROJECT_ROOT } from "../../libs/sdk/sdk-impl/utils/utils-consts.js";
 import { handleDlerError } from "../../libs/sdk/sdk-impl/utils/utils-error-cwd.js";
 import { createPerfTimer } from "../../libs/sdk/sdk-impl/utils/utils-perf.js";
-import { dlerPostBuild } from "./postbuild.js";
+import { dlerPostBuild, wrapper_CopyNonBuildFiles } from "./postbuild.js";
 import { dlerPreBuild } from "./prebuild.js";
-export async function dlerBuild(isDev, config) {
+export async function dlerBuild(isDev, config, debugOnlyCopyNonBuildFiles, debugDontCopyNonBuildFiles) {
   const timer = createPerfTimer();
   let effectiveConfig = config;
   try {
@@ -25,6 +26,18 @@ export async function dlerBuild(isDev, config) {
       effectiveConfig.libsDirDist,
       effectiveConfig.libsList
     );
+    if (debugOnlyCopyNonBuildFiles) {
+      if (debugDontCopyNonBuildFiles) {
+        relinka(
+          "error",
+          "\u{1F4DD} debugOnlyCopyNonBuildFiles and debugDontCopyNonBuildFiles cannot be used together"
+        );
+        process.exit(1);
+      }
+      await wrapper_CopyNonBuildFiles(effectiveConfig);
+      relinka("info", "\u{1F4DD} debugOnlyCopyNonBuildFiles was used, build finished, exiting...");
+      process.exit(0);
+    }
     await dlerPreBuild(effectiveConfig);
     const tempDirs = {
       npm: "dist-tmp/tmp-npm",
@@ -38,8 +51,10 @@ export async function dlerBuild(isDev, config) {
     };
     await regular_buildFlow(timer, isDev, tempConfig);
     await library_buildFlow(timer, isDev, tempConfig);
-    await dlerPostBuild(isDev);
-    await fs.remove(path.join(PROJECT_ROOT, "dist-tmp"));
+    await dlerPostBuild(isDev, debugDontCopyNonBuildFiles);
+    if (effectiveConfig.postBuildSettings?.cleanupTempDirs) {
+      await fs.remove(path.join(PROJECT_ROOT, "dist-tmp"));
+    }
     return { timer, effectiveConfig };
   } catch (error) {
     handleDlerError(error);

package/bin/app/build/postbuild.d.ts

@@ -1 +1,3 @@
-export declare function dlerPostBuild(isDev: boolean): Promise<void>;
+import type { DlerConfig } from "../../libs/sdk/sdk-mod.js";
+export declare function dlerPostBuild(isDev: boolean, debugDontCopyNonBuildFiles?: boolean): Promise<void>;
+export declare function wrapper_CopyNonBuildFiles(config: DlerConfig): Promise<void>;

package/bin/app/build/postbuild.js

@@ -65,10 +65,28 @@ async function copyNonBuildFiles(srcDir, distDir, preExtensions, templatesDir) {
     throw error;
   }
 }
-export async function dlerPostBuild(isDev) {
+export async function dlerPostBuild(isDev, debugDontCopyNonBuildFiles) {
   relinka("info", "\u2014 \u2014 \u2014 dlerPostBuild \u2014 \u2014 \u2014");
   const config = await getConfigDler();
   await resolveAllCrossLibs();
+  if (!debugDontCopyNonBuildFiles) {
+    await wrapper_CopyNonBuildFiles(config);
+  }
+  if (isDev) {
+    await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
+  }
+  await processDistDirectories();
+  await executeDlerHooks(config?.hooksAfterBuild ?? [], "post-build");
+  if (config?.runAfterBuild?.length) {
+    const tools = createPostBuildToolRunner();
+    const availableTools = config.runAfterBuild.filter((toolName) => toolName in tools).map((toolName) => ({ toolName, ...tools[toolName] }));
+    for (const { name, run } of availableTools) {
+      relinka("log", `Running ${name}...`);
+      await run();
+    }
+  }
+}
+export async function wrapper_CopyNonBuildFiles(config) {
   if (config.commonPubRegistry === "npm" || config.commonPubRegistry === "npm-jsr") {
     await copyNonBuildFiles(
       path.join(PROJECT_ROOT, config.coreEntrySrcDir),
@@ -93,17 +111,4 @@ export async function dlerPostBuild(isDev) {
       config.buildTemplatesDir
     );
   }
-  if (isDev) {
-    await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
-  }
-  await processDistDirectories();
-  await executeDlerHooks(config?.hooksAfterBuild ?? [], "post-build");
-  if (config?.runAfterBuild?.length) {
-    const tools = createPostBuildToolRunner();
-    const availableTools = config.runAfterBuild.filter((toolName) => toolName in tools).map((toolName) => ({ toolName, ...tools[toolName] }));
-    for (const { name, run } of availableTools) {
-      relinka("log", `Running ${name}...`);
-      await run();
-    }
-  }
 }

package/bin/libs/cfg/cfg-impl/cfg-consts.d.ts

@@ -69,4 +69,9 @@ export declare const defineConfigDler: (userConfig?: Partial<DlerConfig>) => {
             npm: string[];
         }>;
     };
+    buildPreExtensions: string[];
+    buildTemplatesDir: string;
+    postBuildSettings: {
+        cleanupTempDirs: boolean;
+    };
 };

package/bin/libs/cfg/cfg-impl/cfg-consts.js

@@ -69,7 +69,13 @@ export const DEFAULT_CONFIG_DLER = {
     "dist-jsr": [],
     "dist-npm": [],
     "dist-libs": {}
-  }
+  },
+  // Files with these extensions will be built
+  // Any other files will be copied as-is to dist
+  buildPreExtensions: ["ts", "js"],
+  // If you need to exclude some ts/js files from being built,
+  // you can store them in the dirs with buildTemplatesDir name
+  buildTemplatesDir: "templates"
 };
 export const defineConfigDler = (userConfig = {}) => {
   return { ...DEFAULT_CONFIG_DLER, ...userConfig };

package/bin/libs/cfg/cfg-impl/cfg-types.d.ts

@@ -315,7 +315,7 @@ export interface DlerConfig {
     runBeforeBuild: ("tsc" | "eslint" | "biome" | "knip" | "dler-check")[];
     /**
      * List of tools to run after the build process completes.
-     * Currently only supports "dler-check".
+     * Available options: "dler-check"
      * Each tool will only run if it's installed in the system.
      *
      * @default []
@@ -476,6 +476,27 @@ export interface DlerConfig {
             npm: string[];
         }>;
     };
+    /**
+     * File extensions that should be copied to temporary build directories during pre-build.
+     * These files will be processed by the bundlers.
+     * All other files will be copied as-is to final dist directories during post-build.
+     * @default ["ts", "js"]
+     */
+    buildPreExtensions: string[];
+    /**
+     * Directory name for templates that should be excluded from pre-build processing.
+     * Files in this directory will be copied as-is during post-build.
+     * @default "templates"
+     */
+    buildTemplatesDir: string;
+    /**
+     * When `true`, cleans up the temporary directories after the build process completes.
+     *
+     * @default true
+     */
+    postBuildSettings: {
+        cleanupTempDirs: boolean;
+    };
 }
 export type BumpMode = "patch" | "minor" | "major" | "auto" | "manual";
 /**

package/bin/libs/cfg/cfg-impl/rse-config/rse-impl/rse-define.d.ts

@@ -12,9 +12,9 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
     projectDeployService?: "none" | "vercel" | "netlify" | "railway" | "deno" | undefined;
     projectPackageManager?: "npm" | "bun" | "yarn" | "pnpm" | undefined;
     projectState?: "created" | "creating" | undefined;
-    projectCategory?: "browser" | "cli" | "unknown" | "website" | "vscode" | "library" | "mobile" | undefined;
+    projectCategory?: "cli" | "unknown" | "website" | "vscode" | "browser" | "library" | "mobile" | undefined;
     projectSubcategory?: "unknown" | "e-commerce" | "tool" | undefined;
-    projectFramework?: "rempts" | "npm-jsr" | "unknown" | "vscode" | "nextjs" | "vite" | "svelte" | "remix" | "astro" | "nuxt" | "solid" | "qwik" | "vue" | "wxt" | "lynx" | "react-native" | "expo" | "capacitor" | "ionic" | "electron" | "tauri" | "neutralino" | "citty" | "commander" | "cac" | "meow" | "yargs" | "webextension" | "browser-extension" | undefined;
+    projectFramework?: "rempts" | "vue" | "npm-jsr" | "unknown" | "vscode" | "nextjs" | "vite" | "svelte" | "remix" | "astro" | "nuxt" | "solid" | "qwik" | "wxt" | "lynx" | "react-native" | "expo" | "capacitor" | "ionic" | "electron" | "tauri" | "neutralino" | "citty" | "commander" | "cac" | "meow" | "yargs" | "webextension" | "browser-extension" | undefined;
     projectTemplate?: "unknown" | "blefnk/relivator-nextjs-template" | "blefnk/relivator-docker-template" | "blefnk/next-react-ts-src-minimal" | "blefnk/all-in-one-nextjs-template" | "blefnk/create-t3-app" | "blefnk/create-next-app" | "blefnk/astro-starlight-template" | "blefnk/versator-nextjs-template" | "blefnk/relivator-lynxjs-template" | "blefnk/relivator-react-native-template" | "reliverse/template-browser-extension" | "microsoft/vscode-extension-samples" | "microsoft/vscode-extension-template" | "rsetarter-template" | "blefnk/deno-cli-tutorial" | undefined;
     projectTemplateDate?: string | undefined;
     features?: {
@@ -41,7 +41,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         testing?: "bun" | "unknown" | "vitest" | "jest" | "playwright" | "cypress" | undefined;
         stateManagement?: "unknown" | "zustand" | "jotai" | "redux-toolkit" | undefined;
         formManagement?: "unknown" | "react-hook-form" | "formik" | undefined;
-        styling?: "unknown" | "tailwind" | "styled-components" | "css-modules" | "sass" | undefined;
+        styling?: "sass" | "unknown" | "tailwind" | "styled-components" | "css-modules" | undefined;
         uiComponents?: "unknown" | "shadcn-ui" | "chakra-ui" | "material-ui" | undefined;
         databaseLibrary?: "unknown" | "drizzle" | "prisma" | "supabase" | undefined;
         databaseProvider?: "unknown" | "pg" | "mysql" | "sqlite" | "mongodb" | undefined;

package/bin/libs/sdk/sdk-impl/config/default.js

@@ -68,8 +68,11 @@ export const DEFAULT_CONFIG_DLER = {
     "dist-npm": [],
     "dist-libs": {}
   },
-  // Build file handling configuration
+  // Files with these extensions will be built
+  // Any other files will be copied as-is to dist
   buildPreExtensions: ["ts", "js"],
+  // If you need to exclude some ts/js files from being built,
+  // you can store them in the dirs with buildTemplatesDir name
   buildTemplatesDir: "templates"
 };
 export const defineConfigDler = (userConfig = {}) => {

package/bin/libs/sdk/sdk-impl/config/info.js

@@ -1,5 +1,5 @@
 import { endPrompt, startPrompt } from "@reliverse/rempts";
-const version = "1.7.28";
+const version = "1.7.30";
 export async function showStartPrompt(isDev) {
   await startPrompt({
     titleColor: "inverse",

package/bin/libs/sdk/sdk-impl/config/init.js

@@ -218,12 +218,21 @@ function generateConfig(isDev, pkgDescription) {
     '  // - dist-jsr,dist-libs/jsr: ["jsr.json"]',
     "  publishArtifacts: " + getPublishArtifacts(isDev) + ",",
     "",
+    "  // Files with these extensions will be built",
+    "  // Any other files will be copied as-is to dist",
+    '  buildPreExtensions: ["ts", "js"],',
+    "  // If you need to exclude some ts/js files from being built,",
+    "  // you can store them in the dirs with buildTemplatesDir name",
+    '  buildTemplatesDir: "templates",',
+    "",
     "  // Dependency filtering",
     "  // Global is always applied",
     "  filterDepsPatterns: " + getFilterDepsPatterns(isDev) + ",",
     "",
     "  // Code quality tools",
+    "  // Available: tsc, eslint, biome, knip, dler-check",
     "  runBeforeBuild: [],",
+    "  // Available: dler-check",
     "  runAfterBuild: [],",
     "",
     "  // Build hooks",

package/bin/libs/sdk/sdk-impl/config/types.d.ts

@@ -489,6 +489,14 @@ export interface DlerConfig {
      * @default "templates"
      */
     buildTemplatesDir: string;
+    /**
+     * When `true`, cleans up the temporary directories after the build process completes.
+     *
+     * @default true
+     */
+    postBuildSettings: {
+        cleanupTempDirs: boolean;
+    };
 }
 export type BumpMode = "patch" | "minor" | "major" | "auto" | "manual";
 /**

package/package.json

@@ -53,7 +53,7 @@
   "license": "MIT",
   "name": "@reliverse/dler",
   "type": "module",
-  "version": "1.7.28",
+  "version": "1.7.30",
   "keywords": [
     "reliverse",
     "cli",