@reliverse/dler 1.2.1 → 1.2.3

package/README.md

@@ -1,12 +1,12 @@
 # dler (prev. relidler) • reliverse bundler
 
-[💖 github sponsors](https://github.com/sponsors/blefnk) — [💬 discord](https://discord.gg/pb8ukbwpsj) — [✨ repo](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 and javascript projects, as well as an npm and jsr publishing tool. dler is not only a bundler, it also tries to serve as the most powerful codemod toolkit for js/ts.
 
-> @reliverse/dler (`/ˈdiː.lər/`, dealer) is a flexible, unified, and fully automated bundler for typescript and javascript projects, as well as an npm and jsr publishing tool.
+[sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/pb8ukbwpsj) — [repo](https://github.com/reliverse/dler) — [npm](https://npmjs.com/@reliverse/dler) — [docs](https://docs.reliverse.org/reliverse/dler)
 
 ## features
 
-- 😘 replacement for `unbuild`
+- 😘 replacement for `unjs/unbuild`
 - ⚡ `dler` works via cli and sdk
 - 📦 automated npm/jsr publishing
 - ✅ ensures reliable js/ts builds
@@ -122,77 +122,41 @@ bun dev # bun src/mod.ts --dev
     dler [build|pub] # if installed globally
     ```
 
-absolutely! here’s your improved section, now listing all available spell types:
-
----
-
 ## 🔌 plugins
 
-dler ships with a flexible plugin system and **10 built-in plugins** (from [@reliverse/addons](https://reliverse.org/addons)).
-
-### 1. `magic-spells-dler-plugin`
-
-**available spell types:**
-
-- `replace-line` — injects contents from one file into another
-- `rename-file` — renames the current file
-- `remove-comment` — removes a specific comment from code
-- `remove-line` — removes a specific line from code
-- `remove-file` — deletes the current file
-- `transform-content` — applies a transformation to the file content
-- `copy-file` — copies the current file to a new location
-- `move-file` — moves the current file to a new location
-- `insert-at` — inserts content at a specific position in the file
-
-**params:**
-
-params are optional and comma-separated.
+dler ships with a flexible plugin system and **15 built-in plugins** (from [@reliverse/addons](https://reliverse.org/addons)).
 
-currently, only the first param is supported:
+feel free to create your own plugins. plugins can be implemented as built-in directly in `src/app/plugin-name/impl/*` and then imported from `src/app/plugin-name/cmd.ts`; or implemented in your own library and then imported from `src/app/plugin-name/cmd.ts`.
 
-- `hooked` (boolean, default: `false`)  
-  - `false`: dler handles the spell automatically at postbuild  
-  - `true`: disables default behavior, so you can trigger the spell yourself (e.g. from your own cli function)
-
-more params coming soon...
+### 1. `agg`
 
-**usage examples:**
+generates aggregator file with content like `import { getsomething } from "./utils.js"`.
 
-- `export * from "../../types.js"; // <dler-replace-line-{hooked=false}>` — injects file contents at this line
-- `// @ts-expect-error <dler-remove-comment-{hooked=false}>` — removes just this comment
-- `// <dler-remove-line-{hooked=false}>` — removes this line
-- `// <dler-remove-file-{hooked=false}>` — deletes this file
-- `// <dler-rename-file-"tsconfig.json"-{hooked=false}>` — renames this file (runs at postbuild because `hooked=false`)
-
-**using `hooked=true`:**
+```bash
+dler agg ...
+```
 
-- `// <dler-rename-file-"tsconfig.json"-{hooked=true}>` — renames the file, but only when you trigger it yourself (hooked from your side)
+### 2. `auth`
 
-**triggering spells:**
+best friend of auth+db libs like [better-auth](https://better-auth.com) and [drizzle-orm](https://orm.drizzle.team).
 
-from dler’s cli:  
+```bash
+dler auth better-auth generate
+```
 
-- `dler spell --trigger rename-file,... --files tsconfig.json,...`
-- `dler spell --trigger all`
-- `dler spell`
+### 3. `build`
 
-from your own code:
+since dler is fully modular, build command is separated for its own build-in plugin as well.
 
-```ts
-await dler.spell({ spells: ["rename-file"], files: [] });
-// await dler.spell({}) // means all spells and all files
-// spell: ["all"] // means all spells
-// spell: [] // means all spells
-// files: [] // means all files
+```bash
+dler build ...
 ```
 
-p.s. [see how rse cli uses hooked=true](https://github.com/reliverse/rse/blob/main/src/postbuild.ts)
-
-here’s an extended and improved section for your readme, keeping your lowercase style and adding clarity, options, and a bit more detail:
+### 4. `conv`
 
----
+not yet documented.
 
-### 2. `deps-dler-plugin`
+### 5. `deps`
 
 finds missing dependencies in your project by scanning your code for imports and comparing them to your `package.json`.
 
@@ -239,7 +203,11 @@ dler deps --all --directory ./src --include-builtins
 missing dependencies are shown only once, even if used in multiple files.  
 deep imports like `dep/some/file` or `@org/dep/some/thing` are always resolved to their root package.
 
-### 3. `libraries-dler-plugin`
+### 6. `inject`
+
+not yet documented.
+
+### 7. `libs`
 
 builds and publishes specific subdirectories of your main project as standalone packages.
 
@@ -275,9 +243,106 @@ libslist: {
 
 - more magic commands coming soon...
 
----
+### 8. `merge`
+
+not yet documented.
+
+### 9. `mono`
+
+not yet documented.
+
+### 10. `pub`
+
+pub command is separated for its own build-in plugin as well.
+
+it already calls build command by itself, so you don't need to run `dler build` separately.
+
+```bash
+dler pub ...
+```
+
+### 11. `relifso`
+
+```bash
+dler relifso init ...
+```
+
+### 12. `relinka`
+
+@reliverse/relinka's best friend. learn more in its [docs](https://github.com/reliverse/relinka).
+
+```bash
+dler relinka --console-to-relinka
+```
+
+### 13. `rempts`
+
+@reliverse/rempts's best friend. learn more in its [docs](https://github.com/reliverse/rempts).
+
+```bash
+dler rempts init --cmd my-cmd-1
+dler rempts init --cmds
+```
+
+### 14. `spell`
+
+**available spell types:**
+
+- `replace-line` — injects contents from one file into another
+- `rename-file` — renames the current file
+- `remove-comment` — removes a specific comment from code
+- `remove-line` — removes a specific line from code
+- `remove-file` — deletes the current file
+- `transform-content` — applies a transformation to the file content
+- `copy-file` — copies the current file to a new location
+- `move-file` — moves the current file to a new location
+- `insert-at` — inserts content at a specific position in the file
+
+**params:**
+
+params are optional and comma-separated.
+
+currently, only the first param is supported:
+
+- `hooked` (boolean, default: `false`)  
+  - `false`: dler handles the spell automatically at postbuild  
+  - `true`: disables default behavior, so you can trigger the spell yourself (e.g. from your own cli function)
+
+more params coming soon...
+
+**usage examples:**
+
+- `export * from "../../types.js"; // <dler-replace-line-{hooked=false}>` — injects file contents at this line
+- `// @ts-expect-error <dler-remove-comment-{hooked=false}>` — removes just this comment
+- `// <dler-remove-line-{hooked=false}>` — removes this line
+- `// <dler-remove-file-{hooked=false}>` — deletes this file
+- `// <dler-rename-file-"tsconfig.json"-{hooked=false}>` — renames this file (runs at postbuild because `hooked=false`)
+
+**using `hooked=true`:**
+
+- `// <dler-rename-file-"tsconfig.json"-{hooked=true}>` — renames the file, but only when you trigger it yourself (hooked from your side)
+
+**triggering spells:**
+
+from dler’s cli:  
+
+- `dler spell --trigger rename-file,... --files tsconfig.json,...`
+- `dler spell --trigger all`
+- `dler spell`
+
+from your own code:
+
+```ts
+await dler.spell({ spells: ["rename-file"], files: [] });
+// await dler.spell({}) // means all spells and all files
+// spell: ["all"] // means all spells
+// spell: [] // means all spells
+// files: [] // means all files
+```
+
+p.s. [see how rse cli uses hooked=true](https://github.com/reliverse/rse/blob/main/src/postbuild.ts)
 
-### 4. `tools-dler-plugin`
+### 15. `tools`
 
 lets you run standalone dler features directly from the cli:
 

package/bin/app/build/cmd.js

@@ -0,0 +1,17 @@
+import { defineArgs, defineCommand } from "@reliverse/rempts";
+import { dlerBuild } from "../../cli.js";
+export default defineCommand({
+  meta: {
+    name: "build",
+    description: "Build the project"
+  },
+  args: defineArgs({
+    dev: {
+      type: "boolean",
+      description: "Runs the CLI in dev mode"
+    }
+  }),
+  async run({ args }) {
+    await dlerBuild(args.dev);
+  }
+});

package/bin/{cli/args/inject → app/inject/impl}/ts-expect-error.txt

@@ -129,7 +129,7 @@ async function runTscAndParseErrors(
     // In case of error, try to extract the output.
     const combined = (error.all as string) || "";
     if (!combined) {
-      relinka("info", `TSC returned no error lines. Possibly no TS errors?`);
+      relinka("log", `TSC returned no error lines. Possibly no TS errors?`);
       return [];
     }
 
@@ -191,7 +191,7 @@ async function injectCommentIntoFiles(
     lineNums.sort((a, b) => b - a);
     const absPath = path.resolve(filePath);
     relinka(
-      "info",
+      "log",
       `Injecting into ${absPath} at lines: ${lineNums.join(", ")}`,
     );
 
@@ -235,7 +235,7 @@ export async function useTsExpectError(args: {
   }
 
   if (usedAuto) {
-    relinka("info", "Running TSC to discover error lines...");
+    relinka("log", "Running TSC to discover error lines...");
     const tscCommand = userConfig.tscCommand!;
     try {
       const discovered = await runTscAndParseErrors(tscCommand, args.tscPaths);

package/bin/app/pub/cmd.js

@@ -0,0 +1,17 @@
+import { defineArgs, defineCommand } from "@reliverse/rempts";
+import { dlerPub } from "../../cli.js";
+export default defineCommand({
+  meta: {
+    name: "build",
+    description: "Build the project"
+  },
+  args: defineArgs({
+    dev: {
+      type: "boolean",
+      description: "Runs the CLI in dev mode"
+    }
+  }),
+  async run({ args }) {
+    await dlerPub(args.dev);
+  }
+});

package/bin/app/relifso/cmd.js

@@ -0,0 +1,5 @@
+export { FILE_TYPES } from "./impl/const.js";
+export { gitignoreTemplate } from "./impl/templates/t-gitignore.js";
+export { licenseTemplate } from "./impl/templates/t-license.js";
+export { readmeTemplate } from "./impl/templates/t-readme.js";
+export { escapeMarkdownCodeBlocks } from "./impl/utils.js";

package/bin/{cli/args/init/libs/reinit/reint-impl → app/relifso/impl}/reinit-mod.txt

@@ -197,7 +197,7 @@ async function doInitFile(
     }
     if (maybeNewDest !== resolvedDestPath) {
       // e.g., attach-index was chosen
-      relinka("info", `attach-index or rename => ${maybeNewDest}`);
+      relinka("log", `attach-index or rename => ${maybeNewDest}`);
       return await finalizeInit(
         req,
         initBehaviour,
@@ -268,7 +268,7 @@ async function runCopy(
   }
 
   relinka(
-    "info",
+    "log",
     `Attempting copy:
   - Source Dir: ${resolvedSrcDir}
   - Source Path: ${sourcePath}
@@ -283,7 +283,7 @@ async function runCopy(
       throw new Error(`Source file not found: ${sourcePath}`);
     }
     await fs.copy(sourcePath, resolvedDestPath, { overwrite: true });
-    relinka("info", `Copied file: ${chosenVariation} -> ${resolvedDestPath}`);
+    relinka("log", `Copied file: ${chosenVariation} -> ${resolvedDestPath}`);
     return {
       requested: req,
       finalPath: resolvedDestPath,
@@ -305,7 +305,7 @@ async function runCopy(
         }
         await fs.copy(fallbackFullPath, resolvedDestPath, { overwrite: true });
         relinka(
-          "info",
+          "log",
           `Fallback copy: ${fallbackSource} -> ${resolvedDestPath}`,
         );
         return {
@@ -390,6 +390,6 @@ async function attachIndex(originalPath: string) {
     newPath = path.join(dir, `${base}.${counter}${ext}`);
     counter++;
   }
-  relinka("info", `Attaching index => ${newPath}`);
+  relinka("log", `Attaching index => ${newPath}`);
   return newPath;
 }

package/bin/{cli/args/init/libs/reinit/reint-impl → app/relifso/impl}/templates/t-license.js

@@ -1,6 +1,6 @@
 export const licenseTemplate = `# MIT License
 
-Copyright (c) 2025 Nazar Kornienko (blefnk), Reliverse
+Copyright (c) Nazar Kornienko (blefnk), 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/bin/{cli/args/init/init-mod.txt → app/rempts/cmd.txt}

@@ -76,7 +76,7 @@ const main = defineCommand({
       });
 
       if (chosen.length === 0) {
-        relinka("info", "No file types selected. Exiting...");
+        relinka("log", "No file types selected. Exiting...");
         return;
       }
 

package/bin/{cli/args/init/cmd → app/rempts/impl}/index.js

@@ -12,7 +12,8 @@ export default defineCommand({
     cmd: {
       type: "array",
       required: true,
-      description: "Names of commands to initialize"
+      description: "Names of commands to initialize",
+      options: ["cmd1", "cmd2", "cmd3"]
     },
     force: {
       type: "boolean",
@@ -35,7 +36,7 @@ export default defineCommand({
       fs.mkdirSync(dirPath, { recursive: true });
       const content = generateCommandTemplate(cmdName);
       fs.writeFileSync(filePath, content, "utf-8");
-      relinka("info", `\u2705 Created new command: ${filePath}`);
+      relinka("log", `\u2705 Created new command: ${filePath}`);
     }
   }
 });
@@ -58,8 +59,8 @@ export default defineCommand({
     },
   },
   async run({ args }) {
-    relinka("info", "Command '${cmdName}' executed.");
-    relinka("info", "Received args:", args);
+    relinka("log", "Command '${cmdName}' executed.");
+    relinka("log", "Received args:", args);
   },
 });
 `;

package/bin/{cli/args/tools/index.js → app/tools/cmd.js}

@@ -1,7 +1,7 @@
 import { relinka } from "@reliverse/relinka";
 import { defineCommand } from "@reliverse/rempts";
 import path from "pathe";
-import { printUsage, useAggregator } from "./tools-impl.js";
+import { printUsage, useAggregator } from "./impl.js";
 const TOOLS = ["agg"];
 export default defineCommand({
   meta: {
@@ -52,7 +52,7 @@ export default defineCommand({
     }
     if (!TOOLS.includes(args.tool)) {
       relinka("error", `Error: Invalid tool: ${args.tool}`);
-      relinka("info", `Available tools: ${TOOLS.join(", ")}`);
+      relinka("log", `Available tools: ${TOOLS.join(", ")}`);
       printUsage(isDev);
       process.exit(1);
     }

package/bin/{cli/args/tools/tools-impl.js → app/tools/impl.js}

@@ -28,7 +28,7 @@ export async function useAggregator({
     const exts = [".ts", ".js"];
     if (verbose)
       relinka(
-        "info",
+        "log",
         `Scanning directory ${inputDir} for files with extensions: ${exts.join(
           ", "
         )}`
@@ -61,7 +61,7 @@ export async function useAggregator({
     const allLines = aggregatorLinesArrays.flat();
     if (sortLines) {
       allLines.sort();
-      if (verbose) relinka("info", "Sorted aggregator lines alphabetically.");
+      if (verbose) relinka("log", "Sorted aggregator lines alphabetically.");
     }
     if (outFile.startsWith(inputDir)) {
       relinka(
@@ -83,7 +83,7 @@ ${AGGREGATOR_END}
     if (overrideFile) {
       finalText = aggregatorBlock;
       if (verbose) {
-        relinka("info", "Override mode: rewriting entire file.");
+        relinka("log", "Override mode: rewriting entire file.");
       }
     } else {
       let existingContent = "";
@@ -91,12 +91,12 @@ ${AGGREGATOR_END}
         existingContent = await fs.readFile(outFile, "utf8");
       } catch {
         if (verbose)
-          relinka("info", "Aggregator file does not exist. Creating new one.");
+          relinka("log", "Aggregator file does not exist. Creating new one.");
       }
       if (existingContent?.includes(AGGREGATOR_START) && existingContent.includes(AGGREGATOR_END)) {
         if (verbose) {
           relinka(
-            "info",
+            "log",
             "Existing aggregator block found. Updating auto-generated section."
           );
         }
@@ -109,7 +109,7 @@ ${AGGREGATOR_END}
         if (existingContent) {
           if (verbose)
             relinka(
-              "info",
+              "log",
               "No aggregator block found. Appending auto-generated section."
             );
           finalText = `${existingContent.trim()}
@@ -160,7 +160,7 @@ async function collectFiles(dir, exts, recursive, ignoreDirs, verbose, includeIn
     if (entry.isDirectory()) {
       if (ignoreDirs.includes(entry.name)) {
         if (verbose) {
-          relinka("info", `Skipping ignored directory: ${fullPath}`);
+          relinka("log", `Skipping ignored directory: ${fullPath}`);
         }
         continue;
       }
@@ -179,13 +179,13 @@ async function collectFiles(dir, exts, recursive, ignoreDirs, verbose, includeIn
     } else if (entry.isFile()) {
       if (!includeInternal && path.basename(fullPath).startsWith(internalMarker)) {
         if (verbose) {
-          relinka("info", `Skipping internal file: ${fullPath}`);
+          relinka("log", `Skipping internal file: ${fullPath}`);
         }
         continue;
       }
       if (exts.some((ext) => entry.name.toLowerCase().endsWith(ext))) {
         if (verbose) {
-          relinka("info", `Found file: ${fullPath}`);
+          relinka("log", `Found file: ${fullPath}`);
         }
         found.push(fullPath);
       }
@@ -275,21 +275,21 @@ function guessStarImportIdentifier(filePath) {
   return identifier || "file";
 }
 export function printUsage(isDev) {
-  relinka("info", "====================");
-  relinka("info", "TOOLS USAGE EXAMPLES");
-  relinka("info", "====================");
+  relinka("log", "====================");
+  relinka("log", "TOOLS USAGE EXAMPLES");
+  relinka("log", "====================");
   relinka(
-    "info",
+    "log",
     `${isDev ? "bun dev:agg" : "dler tools"} --tool agg --input <dir> --out <file> [options]`
   );
   if (isDev) {
     relinka(
-      "info",
+      "log",
       "bun dev:tools agg --input src/libs/sdk/sdk-impl --out src/libs/sdk/sdk-mod.ts --recursive --named --strip src/libs/sdk"
     );
   } else {
     relinka(
-      "info",
+      "log",
       "dler tools --tool agg --input src/libs --out aggregator.ts --recursive --named"
     );
   }

package/bin/{tools.txt → app/tools/tools.txt}

@@ -60,7 +60,7 @@ const tools = defineCommand()
     }
     if (!TOOLS.includes(args.tool as string)) {
       relinka("error", `Error: Invalid tool: ${args.tool}`);
-      relinka("info", `Available tools: ${TOOLS.join(", ")}`);
+      relinka("log", `Available tools: ${TOOLS.join(", ")}`);
       printUsage(isDev);
       process.exit(1);
     }

package/bin/cli.js

@@ -10,7 +10,7 @@ import { handleDlerError } from "./libs/sdk/sdk-impl/utils/utils-error.js";
 import { finalizeBuild } from "./libs/sdk/sdk-impl/utils/utils-info.js";
 import { createPerfTimer } from "./libs/sdk/sdk-impl/utils/utils-perf.js";
 import { loadConfig } from "./load.js";
-export async function dler(isDev) {
+export async function dlerBuild(isDev) {
   const timer = createPerfTimer();
   try {
     const config = await loadConfig();
@@ -18,7 +18,7 @@ export async function dler(isDev) {
       config.commonPubPause = true;
       config.bumpDisable = true;
       relinka(
-        "info",
+        "log",
         "Development mode: Publishing paused and version bumping disabled."
       );
     }
@@ -67,7 +67,108 @@ export async function dler(isDev) {
       config.transpileStub,
       config.transpileWatch,
       config.distJsrGenTsconfig,
-      config.coreDeclarations
+      config.coreDeclarations,
+      { coreDescription: config.coreDescription }
+    );
+    await processLibraryFlow(
+      timer,
+      isDev,
+      config.libsActMode,
+      config.libsList,
+      config.distJsrDryRun,
+      config.distJsrFailOnWarn,
+      config.libsDirDist,
+      config.libsDirSrc,
+      config.commonPubPause,
+      config.commonPubRegistry,
+      config.distNpmOutFilesExt,
+      config.distNpmBuilder,
+      config.coreEntrySrcDir,
+      config.rmDepsMode,
+      config.rmDepsPatterns,
+      config.transpileEsbuild,
+      config.transpileTarget,
+      config.transpileFormat,
+      config.transpileSplitting,
+      config.transpileSourcemap,
+      config.transpilePublicPath,
+      config.distJsrBuilder,
+      config.transpileStub,
+      config.transpileWatch,
+      config.distJsrOutFilesExt
+    );
+    await finalizeBuild(
+      timer,
+      config.commonPubPause,
+      config.libsList,
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist,
+      isDev
+    );
+  } catch (error) {
+    handleDlerError(error, timer);
+  }
+}
+export async function dlerPub(isDev) {
+  const timer = createPerfTimer();
+  try {
+    const config = await loadConfig();
+    if (isDev) {
+      config.commonPubPause = true;
+      config.bumpDisable = true;
+      relinka(
+        "log",
+        "Development mode: Publishing paused and version bumping disabled."
+      );
+    }
+    if (config.logsFreshFile) {
+      await fs.remove(path.join(PROJECT_ROOT, config.logsFileName));
+    }
+    await removeDistFolders(
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist,
+      config.libsList
+    );
+    if (!config.bumpDisable) {
+      await bumpHandler(
+        config.bumpMode,
+        config.bumpDisable,
+        config.commonPubPause,
+        config.bumpFilter
+      );
+    }
+    await processRegularFlow(
+      timer,
+      isDev,
+      config.coreIsCLI,
+      config.libsActMode,
+      config.commonPubRegistry,
+      config.coreEntrySrcDir,
+      config.distNpmDirName,
+      config.distNpmBuilder,
+      config.coreEntryFile,
+      config.distJsrDryRun,
+      config.distJsrFailOnWarn,
+      config.commonPubPause,
+      config.distJsrDirName,
+      config.distJsrBuilder,
+      config.transpileTarget,
+      config.transpileFormat,
+      config.transpileSplitting,
+      config.transpileMinify,
+      config.transpileSourcemap,
+      config.transpilePublicPath,
+      config.distJsrAllowDirty,
+      config.distJsrSlowTypes,
+      config.distNpmOutFilesExt,
+      config.rmDepsMode,
+      config.transpileStub,
+      config.transpileWatch,
+      config.distJsrGenTsconfig,
+      config.coreDeclarations,
+      { coreDescription: config.coreDescription }
     );
     await processLibraryFlow(
       timer,