@reliverse/dler 1.4.6 → 1.5.0

package/README.md

@@ -15,7 +15,7 @@
 - 🎯 optimized for speed and modern workflows
 - ✨ packed with powerful features under the hood
 - 🛠️ converts typescript aliases to relative paths
-- 🔌 plugin system with two built-in plugins included
+- 🔌 plugin system with 14 built-in plugins included
 - 📝 highly configurable flow via a configuration file
 - 🔜 `libraries` plugin —> dler monorepo implementation
 - 🧼 cleans up your internal logs from the build dist
@@ -52,7 +52,7 @@ ensure git, node.js, and bun/pnpm/yarn/npm are installed. then:
 git clone https://github.com/reliverse/dler.git
 cd dler
 bun i
-bun dev # bun src/dler.ts --dev
+bun dev # bun src/cli.ts --dev
 ```
 
 ### installation
@@ -117,15 +117,15 @@ bun dev # bun src/dler.ts --dev
     dler [build|pub] # if installed globally
     ```
 
-## 🔌 addons
+## 🔌 plugins
 
-dler ships with a flexible addon system (aka plugins) and **14 built-in addons** (from [@reliverse/addons](https://reliverse.org/addons)).
+dler ships with a flexible plugin system (aka plugins) and **14 built-in plugins** (from [reliverse addons](https://reliverse.org/addons) collection).
 
-feel free to create your own addons. addons can be implemented as built-in directly in `src/app/<addon>/impl/*` and then imported from `src/app/<addon>/cmd.ts`; or implemented in your own library and then imported from `src/app/<addon>/cmd.ts`.
+feel free to create your own plugins. plugins can be implemented as built-in directly in `src/app/<plugin>/impl/*` and then imported from `src/app/<plugin>/cmd.ts`; or implemented in your own library and then imported from `src/app/<plugin>/cmd.ts`.
 
-if you run just `dler` — it will display a list of addons which you can launch interactively.
+if you run just `dler` — it will display a list of plugins which you can launch interactively.
 
-## **available addons**
+## **available plugins**
 
 [agg](#1-agg), [build](#2-build), [conv](#3-conv), [deps](#4-deps), [inject](#5-inject), [libs](#6-libs), [merge](#7-merge), [mono](#8-mono), [pub](#9-pub), [relifso](#10-relifso), [relinka](#11-relinka), [rempts](#12-rempts), [spell](#13-spell), [split](#14-split).
 
@@ -147,7 +147,7 @@ dler agg --input <dir> --out <file> [options]
 
 ```bash
 bun tools:agg # shortcut for:
-bun src/dler.ts tools --dev --tool agg --input src/libs/sdk/sdk-impl --out src/libs/sdk/sdk-mod.ts --recursive --named --strip src/libs/sdk
+bun src/cli.ts tools --dev --tool agg --input src/libs/sdk/sdk-impl --out src/libs/sdk/sdk-mod.ts --recursive --named --strip src/libs/sdk
 ```
 
 ### 2. `build`

package/bin/{addons.js → app/agg/run.js}

@@ -6,7 +6,7 @@ import {
 } from "@reliverse/rempts";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { cmdAgg } from "./app/cmds.js";
+import { cmdAgg } from "../cmds.js";
 async function loadConfig() {
   const configPath = resolve(".config/dler.ts");
   if (!existsSync(configPath)) return null;

package/bin/app/build/cmd.js

@@ -1,6 +1,6 @@
 import { defineArgs, defineCommand } from "@reliverse/rempts";
-import { dlerBuild } from "../../impl.js";
-import { ensureDlerConfig } from "../../init.js";
+import { dlerBuild } from "./impl.js";
+import { ensureDlerConfig } from "../../init/init.js";
 export default defineCommand({
   meta: {
     name: "build",

package/bin/app/build/impl.js

@@ -0,0 +1,97 @@
+import {
+  bumpHandler,
+  isBumpDisabled,
+  setBumpDisabledValueTo
+} from "@reliverse/bleump";
+import path from "@reliverse/pathkit";
+import fs from "@reliverse/relifso";
+import { loadConfig } from "../../init/load.js";
+import { processLibraryFlow } from "../../libs/sdk/sdk-impl/library-flow.js";
+import { processRegularFlow } from "../../libs/sdk/sdk-impl/regular-flow.js";
+import { finalizeBuildPub } from "../../libs/sdk/sdk-impl/utils/finalize.js";
+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.js";
+import { createPerfTimer } from "../../libs/sdk/sdk-impl/utils/utils-perf.js";
+export async function dlerBuild(isDev) {
+  const timer = createPerfTimer();
+  try {
+    const config = await loadConfig();
+    if (config.logsFreshFile) {
+      await fs.remove(path.join(PROJECT_ROOT, config.logsFileName));
+    }
+    await removeDistFolders(
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist,
+      config.libsList
+    );
+    try {
+      const bumpIsDisabled = await isBumpDisabled();
+      if (!bumpIsDisabled && !config.commonPubPause) {
+        await bumpHandler(
+          config.bumpMode,
+          false,
+          config.bumpFilter,
+          config.bumpSet
+        );
+        await setBumpDisabledValueTo(true);
+      }
+    } catch {
+      throw new Error("[.config/dler.ts] Failed to set bumpDisable to true");
+    }
+    await processRegularFlow(timer, isDev, config);
+    await processLibraryFlow(timer, isDev, config);
+    await finalizeBuildPub(
+      timer,
+      config.commonPubPause,
+      config.libsList,
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist
+    );
+  } catch (error) {
+    handleDlerError(error, timer);
+  }
+}
+export async function dlerPub(isDev) {
+  const timer = createPerfTimer();
+  try {
+    const config = await loadConfig();
+    if (config.logsFreshFile) {
+      await fs.remove(path.join(PROJECT_ROOT, config.logsFileName));
+    }
+    await removeDistFolders(
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist,
+      config.libsList
+    );
+    const bumpIsDisabled = await isBumpDisabled();
+    if (!bumpIsDisabled && !config.commonPubPause) {
+      try {
+        await bumpHandler(
+          config.bumpMode,
+          false,
+          config.bumpFilter,
+          config.bumpSet
+        );
+        await setBumpDisabledValueTo(true);
+      } catch {
+        throw new Error("[.config/dler.ts] Failed to set bumpDisable to true");
+      }
+    }
+    await processRegularFlow(timer, isDev, config);
+    await processLibraryFlow(timer, isDev, config);
+    await finalizeBuildPub(
+      timer,
+      config.commonPubPause,
+      config.libsList,
+      config.distNpmDirName,
+      config.distJsrDirName,
+      config.libsDirDist
+    );
+  } catch (error) {
+    handleDlerError(error, timer);
+  }
+}

package/bin/app/pub/cmd.js

@@ -1,6 +1,6 @@
 import { defineArgs, defineCommand } from "@reliverse/rempts";
-import { dlerPub } from "../../impl.js";
-import { ensureDlerConfig } from "../../init.js";
+import { dlerPub } from "../build/impl.js";
+import { ensureDlerConfig } from "../../init/init.js";
 export default defineCommand({
   meta: {
     name: "build",

package/bin/{dler.js → cli.js}

@@ -7,9 +7,9 @@ import {
   showUsage,
   runCmd
 } from "@reliverse/rempts";
-import { promptAggCommand } from "./addons.js";
+import { promptAggCommand } from "./app/agg/run.js";
 import { cmdBuild, cmdPub } from "./app/cmds.js";
-import { showEndPrompt, showStartPrompt } from "./info.js";
+import { showEndPrompt, showStartPrompt } from "./init/info.js";
 const INTERACTIVE_CMDS = ["agg", "build", "pub"];
 const main = defineCommand({
   meta: {

package/bin/init/info.d.ts

@@ -0,0 +1,2 @@
+export declare function showStartPrompt(isDev: boolean): Promise<void>;
+export declare function showEndPrompt(): Promise<void>;

package/bin/{info.js → init/info.js}

@@ -19,4 +19,3 @@ export async function showEndPrompt() {
     titleAnimationDelay: 800
   });
 }
-export const FILL_ISSUE = "If you believe this is an error, please fill in the issue on https://github.com/reliverse/dler/issues";

package/bin/{init.js → init/init.js}

@@ -2,7 +2,7 @@ import path from "@reliverse/pathkit";
 import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { readPackageJSON } from "pkg-types";
-import { DEFAULT_CONFIG } from "./default.js";
+import { DEFAULT_CONFIG } from "../libs/sdk/default.js";
 const CONFIG_FILENAME = ".config/dler.ts";
 export async function ensureDlerConfig(isDev) {
   const configPath = path.resolve(process.cwd(), CONFIG_FILENAME);
@@ -46,7 +46,7 @@ function getCoreIsCLI(isDev) {
   // },`;
 }
 function generateConfig(isDev, pkgDescription) {
-  const importDefineConfigStatement = isDev ? `import { defineConfig } from "./mod.js";` : `import { defineConfig } from "@reliverse/dler";`;
+  const importDefineConfigStatement = isDev ? `import { defineConfig } from "../mod.js";` : `import { defineConfig } from "@reliverse/dler";`;
   const verboseValue = getValue(isDev, true, DEFAULT_CONFIG.commonVerbose);
   const coreIsCLI = getCoreIsCLI(isDev);
   const registryValue = getValue(
@@ -140,8 +140,26 @@ export default defineConfig({
   logsFileName: "${DEFAULT_CONFIG.logsFileName}",
   logsFreshFile: ${DEFAULT_CONFIG.logsFreshFile},
   // Dependency filtering
-  rmDepsMode: "${DEFAULT_CONFIG.rmDepsMode}",
-  rmDepsPatterns: ${JSON.stringify(DEFAULT_CONFIG.rmDepsPatterns)},
+  // Global is always applied
+  removeDepsPatterns: {
+    global: [
+      "@types",
+      "biome",
+      "eslint",
+      "knip",
+      "prettier",
+      "typescript",
+      "@reliverse/dler",
+    ],
+    "dist-npm": [],
+    "dist-jsr": [],
+    "dist-libs": {
+      "@reliverse/dler-sdk": {
+        npm: [],
+        jsr: [],
+      },
+    },
+  },
   // Build setup
   transpileEsbuild: "${DEFAULT_CONFIG.transpileEsbuild}",
   transpileFormat: "${DEFAULT_CONFIG.transpileFormat}",

package/bin/{load.d.ts → init/load.d.ts}

@@ -1,4 +1,4 @@
-import type { BuildPublishConfig } from "./libs/sdk/sdk-types.js";
+import type { BuildPublishConfig } from "../libs/sdk/sdk-types.js";
 /**
  * Searches for and loads the configuration file `.config/dler.ts`.
  * Falls back to default configuration if the file is not found.

package/bin/{load.js → init/load.js}

@@ -1,7 +1,7 @@
 import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { resolve } from "node:path";
-import { defineConfig } from "./mod.js";
+import { defineConfig } from "../mod.js";
 const CONFIG_FILENAME = ".config/dler.ts";
 export async function loadConfig() {
   const cwd = process.cwd();

package/bin/{default.d.ts → libs/sdk/default.d.ts}

@@ -1,4 +1,4 @@
-import type { BuildPublishConfig } from "./libs/sdk/sdk-types.js";
+import type { BuildPublishConfig } from "./sdk-types.js";
 /**
  * Default configuration for the build and publish logic.
  */

package/bin/{default.js → libs/sdk/default.js}

@@ -34,16 +34,27 @@ export const DEFAULT_CONFIG = {
   libsList: {},
   logsFileName: "logs/relinka.log",
   logsFreshFile: true,
-  rmDepsMode: "patterns-and-devdeps",
-  rmDepsPatterns: [
-    "@types",
-    "biome",
-    "eslint",
-    "knip",
-    "prettier",
-    "typescript",
-    "@reliverse/config"
-  ],
+  // Dependency filtering
+  removeDepsPatterns: {
+    global: [
+      "@types",
+      "biome",
+      "eslint",
+      "knip",
+      "prettier",
+      "typescript",
+      "@reliverse/dler"
+    ],
+    "dist-npm": [],
+    "dist-jsr": [],
+    "dist-libs": {
+      "@reliverse/dler-sdk": {
+        npm: [],
+        jsr: []
+      }
+    }
+  },
+  // Build setup
   transpileEsbuild: "es2023",
   transpileFormat: "esm",
   transpileMinify: true,

package/bin/libs/sdk/sdk-impl/build/build-library.d.ts

@@ -1,29 +1,5 @@
-import type { BundlerName, Esbuild, ExcludeMode, LibConfig, NpmOutExt, Sourcemap, transpileFormat, transpileTarget } from "../../sdk-types.js";
-import { type PerfTimer } from "../utils/utils-perf.js";
-/** Options common to both NPM and JSR build targets */
-type BaseLibBuildOptions = {
-    libName: string;
-    mainDir: string;
-    libMainFile: string;
-    isDev: boolean;
-    libsList: Record<string, LibConfig>;
-    rmDepsMode: ExcludeMode;
-    rmDepsPatterns: string[];
-    timer: PerfTimer;
-};
-/** Options specific to the transpilation/bundling process */
-type TranspileOptions = {
-    transpileTarget: transpileTarget;
-    transpileFormat: transpileFormat;
-    transpileSplitting: boolean;
-    libTranspileMinify: boolean;
-    transpileSourcemap: Sourcemap;
-    transpilePublicPath: string;
-    transpileEsbuild: Esbuild;
-    transpileStub: boolean;
-    transpileWatch: boolean;
-    unifiedBundlerOutExt: NpmOutExt;
-};
+import type { PerfTimer } from "../../sdk-types.js";
+import type { BundlerName, BuildPublishConfig, Esbuild, LibConfig, NpmOutExt, Sourcemap, transpileFormat, transpileTarget } from "../../sdk-types.js";
 /** Options specific to the NPM build target */
 type NpmBuildOptions = {
     npmOutDir: string;
@@ -37,11 +13,27 @@ type JsrBuildOptions = {
     distJsrOutFilesExt: NpmOutExt;
 };
 /** Consolidated options for the main library build function */
-export type LibraryBuildOptions = {
+export type LibraryBuildOptions = BuildPublishConfig & {
     effectivePubRegistry: "npm" | "jsr" | "npm-jsr" | undefined;
     npm?: NpmBuildOptions;
     jsr?: JsrBuildOptions;
-} & BaseLibBuildOptions & TranspileOptions;
+    libName: string;
+    mainDir: string;
+    libMainFile: string;
+    isDev: boolean;
+    libsList: Record<string, LibConfig>;
+    timer: PerfTimer;
+    libTranspileMinify: boolean;
+    transpileTarget: transpileTarget;
+    transpileFormat: transpileFormat;
+    transpileSplitting: boolean;
+    transpileSourcemap: Sourcemap;
+    transpilePublicPath: string;
+    transpileEsbuild: Esbuild;
+    transpileStub: boolean;
+    transpileWatch: boolean;
+    unifiedBundlerOutExt: NpmOutExt;
+};
 /**
  * Main entry point to build a library based on the provided options.
  * Manages pre-build source modifications, orchestrates target builds, and ensures post-build cleanup.

package/bin/libs/sdk/sdk-impl/build/build-library.js

@@ -33,9 +33,7 @@ import {
   createJsrJSON,
   renameTsxFiles
 } from "../utils/utils-jsr-json.js";
-import {
-  getElapsedPerfTime
-} from "../utils/utils-perf.js";
+import { getElapsedPerfTime } from "../utils/utils-perf.js";
 import { library_createPackageJSON } from "../utils/utils-pkg-json-libs.js";
 const BIN_DIR_NAME = "bin";
 const REPLACEMENT_MARKER = "// dler-replace-me";
@@ -267,8 +265,6 @@ async function library_buildDistributionTarget(params) {
     timer,
     libMainFile,
     libsList,
-    rmDepsMode,
-    rmDepsPatterns,
     // Transpile/Bundle Options from `options`
     libTranspileMinify,
     transpileTarget,
@@ -313,8 +309,7 @@ async function library_buildDistributionTarget(params) {
     isJsr,
     libName,
     libsList,
-    rmDepsMode,
-    rmDepsPatterns,
+    config: options,
     unifiedBundlerOutExt,
     distJsrOutFilesExt,
     deleteFiles: isJsr,
@@ -550,8 +545,7 @@ async function library_performCommonBuildSteps(params) {
     isJsr,
     libName,
     libsList,
-    rmDepsMode,
-    rmDepsPatterns,
+    config,
     unifiedBundlerOutExt,
     distJsrOutFilesExt,
     deleteFiles = false,
@@ -566,18 +560,15 @@ async function library_performCommonBuildSteps(params) {
     "verbose",
     `${logPrefix} Performing common steps in ${outputDirRoot}`
   );
-  if (npmOutputDirRoot || jsrOutputDirRoot) {
-    await library_createPackageJSON(
-      libName,
-      npmOutputDirRoot || outputDirRoot,
-      jsrOutputDirRoot || outputDirRoot,
-      effectivePubRegistry,
-      libsList,
-      rmDepsMode,
-      rmDepsPatterns,
-      unifiedBundlerOutExt
-    );
-  }
+  await library_createPackageJSON(
+    libName,
+    npmOutputDirRoot || outputDirRoot,
+    jsrOutputDirRoot || outputDirRoot,
+    effectivePubRegistry,
+    libsList,
+    config,
+    unifiedBundlerOutExt
+  );
   relinka("verbose", `${logPrefix} Created package.json.`);
   await removeLogInternalCalls(outDirBin);
   if (deleteFiles) {

package/bin/libs/sdk/sdk-impl/build/build-regular.d.ts

@@ -1,5 +1,4 @@
-import type { BundlerName, ExcludeMode, NpmOutExt, Sourcemap, transpileFormat, transpileTarget } from "../../sdk-types.js";
-import { type PerfTimer } from "../utils/utils-perf.js";
+import type { BundlerName, NpmOutExt, Sourcemap, transpileFormat, transpileTarget, BuildPublishConfig, PerfTimer } from "../../sdk-types.js";
 /**
  * Builds a regular JSR distribution.
  * - Copies the entire source directory if `distJsrBuilder` = "jsr"
@@ -8,19 +7,13 @@ import { type PerfTimer } from "../utils/utils-perf.js";
 export declare function regular_buildJsrDist(isDev: boolean, isJsr: boolean, coreIsCLI: {
     enabled: boolean;
     scripts: Record<string, string>;
-}, coreEntrySrcDir: string, distJsrDirName: string, distJsrBuilder: BundlerName, coreEntryFile: string, transpileTarget: transpileTarget, transpileFormat: transpileFormat, transpileSplitting: boolean, transpileMinify: boolean, transpileSourcemap: Sourcemap, transpilePublicPath: string, unifiedBundlerOutExt: NpmOutExt, rmDepsMode: ExcludeMode, timer: PerfTimer, transpileStub: boolean, transpileWatch: boolean, distJsrGenTsconfig: boolean, coreDeclarations: boolean, config: {
-    coreDescription: string;
-    coreBuildOutDir?: string;
-}): Promise<void>;
+}, coreEntrySrcDir: string, distJsrDirName: string, distJsrBuilder: BundlerName, coreEntryFile: string, transpileTarget: transpileTarget, transpileFormat: transpileFormat, transpileSplitting: boolean, transpileMinify: boolean, transpileSourcemap: Sourcemap, transpilePublicPath: string, unifiedBundlerOutExt: NpmOutExt, config: BuildPublishConfig, timer: PerfTimer, transpileStub: boolean, transpileWatch: boolean, distJsrGenTsconfig: boolean, coreDeclarations: boolean): Promise<void>;
 /**
  * Builds a regular NPM distribution.
  * - Copies entire src dir if "jsr"
  * - Otherwise uses Bun or a unified builder
  */
-export declare function regular_buildNpmDist(isDev: boolean, coreEntrySrcDir: string, distNpmDirName: string, distNpmBuilder: BundlerName, coreEntryFile: string, unifiedBundlerOutExt: NpmOutExt, rmDepsMode: ExcludeMode, coreIsCLI: {
+export declare function regular_buildNpmDist(isDev: boolean, coreEntrySrcDir: string, distNpmDirName: string, distNpmBuilder: BundlerName, coreEntryFile: string, unifiedBundlerOutExt: NpmOutExt, config: BuildPublishConfig, coreIsCLI: {
     enabled: boolean;
     scripts: Record<string, string>;
-}, transpileTarget: transpileTarget, transpileFormat: transpileFormat, transpileSplitting: boolean, transpileMinify: boolean, transpileSourcemap: Sourcemap, transpilePublicPath: string, transpileStub: boolean, transpileWatch: boolean, timer: PerfTimer, coreDeclarations: boolean, config: {
-    coreDescription: string;
-    coreBuildOutDir?: string;
-}): Promise<void>;
+}, transpileTarget: transpileTarget, transpileFormat: transpileFormat, transpileSplitting: boolean, transpileMinify: boolean, transpileSourcemap: Sourcemap, transpilePublicPath: string, transpileStub: boolean, transpileWatch: boolean, timer: PerfTimer, coreDeclarations: boolean): Promise<void>;