@reliverse/dler 1.7.1 → 1.7.2

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 14 built-in plugins included
+- 🔌 plugin system with [15 built-in plugins](#-plugins) included
 - 📝 highly configurable flow via a configuration file
 - 🔜 `libraries` plugin —> dler monorepo implementation
 - 🧼 cleans up your internal logs from the build dist
@@ -119,7 +119,7 @@ bun dev # bun src/cli.ts --dev
 
 ## 🔌 plugins
 
-dler ships with a flexible plugin system (aka plugins) and **14 built-in plugins** (from [reliverse addons](https://reliverse.org/addons) collection).
+dler ships with a flexible plugin system (aka plugins) and **15 built-in plugins** (from [reliverse addons](https://reliverse.org/addons) collection).
 
 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`.
 
@@ -127,7 +127,7 @@ if you run just `dler` — it will display a list of plugins which you can launc
 
 ## **available plugins**
 
-[agg](#1-agg), [build](#2-build), [conv](#3-conv), [deps](#4-deps), [inject](#5-inject), [libs](#6-libs), [merge](#7-merge), [migrate](#8-migrate), [pub](#9-pub), [relifso](#10-relifso), [relinka](#11-relinka), [rempts](#12-rempts), [spell](#13-spell), [split](#14-split).
+[agg](#1-agg), [check](#2-check-aka-rules-of-dler), [build](#3-build), [conv](#4-conv), [deps](#5-deps), [inject](#6-inject), [libs](#7-libs), [merge](#8-merge), [migrate](#9-migrate), [pub](#10-pub), [relifso](#11-relifso), [relinka](#12-relinka), [rempts](#13-rempts), [spell](#14-spell), [split](#15-split)
 
 ### 1. `agg`
 
@@ -150,7 +150,7 @@ bun tools:agg # shortcut for:
 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
 ```
 
-### 1.5. `check`
+### 2. `check` (aka rules of dler)
 
 checks your project for common issues and potential improvements. This command performs several types of checks:
 
@@ -216,7 +216,7 @@ dler check --json
 **pro tip:**  
 the command will prompt you only for the arguments you haven't provided. for example, if you specify `--directory` but not `--checks`, it will only prompt you to select which checks to run.
 
-### 2. `build`
+### 3. `build`
 
 since dler is fully modular, build command is separated for its own build-in plugin as well.
 
@@ -224,11 +224,11 @@ since dler is fully modular, build command is separated for its own build-in plu
 dler build ...
 ```
 
-### 3. `conv`
+### 4. `conv`
 
 not yet documented.
 
-### 4. `deps`
+### 5. `deps`
 
 finds missing dependencies in your project by scanning your code for imports and comparing them to your `package.json`. This command is particularly useful for maintaining clean dependency lists and preventing runtime errors.
 
@@ -246,6 +246,8 @@ finds missing dependencies in your project by scanning your code for imports and
 - optionally includes node.js built-in modules in the report
 - outputs results in a readable format or as json
 - exits with error code 1 if missing dependencies are found
+- detects packages that are only in `devDependencies` but used in production code
+- identifies packages listed in both `dependencies` and `devDependencies`
 
 **usage examples:**
 
@@ -276,11 +278,17 @@ 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.
 
-### 5. `inject`
+**warning types:**
+
+- **Missing Dependencies**: Packages that are imported but not listed in `package.json`
+- **Dev-only Dependencies**: Packages that are only in `devDependencies` but imported in production code
+- **Duplicate Dependencies**: Packages listed in both `dependencies` and `devDependencies`
+
+### 6. `inject`
 
 not yet documented.
 
-### 6. `libs`
+### 7. `libs`
 
 builds and publishes specific subdirectories of your main project as standalone packages.
 
@@ -316,20 +324,21 @@ libslist: {
 
 - more magic commands coming soon...
 
-### 7. `merge`
+### 8. `merge`
 
 not yet documented.
 
-### 8. `migrate`
+### 9. `migrate`
 
 helps migrate between different libraries and module resolution strategies. currently supports:
 
-- `path-to-pathkit`: migrate from node:path and unjs/pathe to pathkit library
-- `fs-to-relifso`: migrate from node:fs and fs-extra to relifso library
-- `module-resolution`: migrate between module resolution strategies
-- `anything-to-bun`: migrate Node.js projects to Bun runtime
+- `anything-bun`: migrate Node.js projects to Bun runtime
+- `path-pathkit`: migrate from node:path and unjs/pathe to pathkit library
+- `fs-relifso`: migrate from node:fs and fs-extra to relifso library
+- `nodenext-bundler`: migrate between module resolution strategies
+- `readdir-glob`: migrate from fs.readdir to globby for better file system operations
 
-**path-to-pathkit features:**
+**path-pathkit features:**
 
 - Migrates from both `pathe` and `node:path` to `@reliverse/pathkit`
 - Handles both default and named exports
@@ -337,7 +346,7 @@ helps migrate between different libraries and module resolution strategies. curr
 - Converts require statements
 - Updates package.json dependencies
 
-**fs-to-relifso features:**
+**fs-relifso features:**
 
 - Migrates from both `node:fs` and `fs-extra` to `@reliverse/relifso`
 - Handles both default and named exports
@@ -346,7 +355,7 @@ helps migrate between different libraries and module resolution strategies. curr
 - Updates package.json dependencies
 - Preserves import structure and formatting
 
-**anything-to-bun features:**
+**anything-bun features:**
 
 - Migrates Node.js imports to use `node:` prefix
 - Replaces npm/yarn/pnpm features with bun equivalents
@@ -362,17 +371,27 @@ helps migrate between different libraries and module resolution strategies. curr
 - Generates Bun configuration files
 - Creates Dockerfile for Bun deployment
 
-**usage example:**
+**readdir-glob features:**
+
+- Migrates from `fs.readdir` and `fs.readdirSync` to `globby`
+- Handles both synchronous and asynchronous readdir operations
+- Supports `fs.promises.readdir` migration
+- Adds globby import if not present
+- Updates package.json with globby dependency
+- Preserves target directory paths
+- Maintains async/await usage
+
+**usage examples:**
 
 ```bash
 # Preview changes without applying them
-dler migrate --lib anything-to-bun --dryRun
+dler migrate --lib readdir-glob --dryRun
 
 # Apply changes
-dler migrate --lib anything-to-bun
+dler migrate --lib readdir-glob
 
 # Migrate specific project
-dler migrate --lib anything-to-bun --project ./my-app
+dler migrate --lib readdir-glob --project ./my-app
 ```
 
 **module resolution targets:**
@@ -384,19 +403,19 @@ dler migrate --lib anything-to-bun --project ./my-app
 
 ```bash
 # Migrate from node:path and/or pathe to pathkit
-dler migrate --lib path-to-pathkit
+dler migrate --lib path-pathkit
 
 # Migrate from node:fs and/or fs-extra to relifso
-dler migrate --lib fs-to-relifso
+dler migrate --lib fs-relifso
 
 # Migrate to nodenext module resolution
-dler migrate --lib module-resolution --target nodenext
+dler migrate --lib nodenext-bundler --target nodenext
 
 # Migrate to bundler module resolution
-dler migrate --lib module-resolution --target bundler
+dler migrate --lib nodenext-bundler --target bundler
 
 # Preview changes without applying them
-dler migrate --lib module-resolution --target nodenext --dryRun
+dler migrate --lib nodenext-bundler --target nodenext --dryRun
 ```
 
 **what it does:**
@@ -410,29 +429,35 @@ dler migrate --lib module-resolution --target nodenext --dryRun
 
 **next steps after migration:**
 
-- for path-to-pathkit:
+- for path-pathkit:
   1. run 'bun install' to install @reliverse/pathkit
   2. test your application
   3. consider using advanced pathkit features
 
-- for fs-to-relifso:
+- for fs-relifso:
   1. run 'bun install' to install @reliverse/relifso
   2. test your application
   3. review any file system operations that might need manual updates
 
-- for module-resolution:
+- for nodenext-bundler:
   1. test your application
   2. ensure your build tools support the new module resolution
   3. review any warnings in the migration output
 
-- for anything-to-bun:
+- for anything-bun:
   1. run 'bun install' to install dependencies with Bun
   2. test your application thoroughly
   3. review async/await usage in converted file operations
   4. update any custom database queries to use Bun.sql syntax
   5. review and update any custom middleware in Express apps
 
-### 9. `pub`
+- for readdir-glob:
+  1. run 'bun install' to install globby
+  2. test your application
+  3. review any file system operations that might need manual updates
+  4. consider using globby's advanced features like pattern matching and recursive searching
+
+### 10. `pub`
 
 pub command is separated for its own build-in plugin as well.
 
@@ -442,13 +467,13 @@ it already calls build command by itself, so you don't need to run `dler build`
 dler pub ...
 ```
 
-### 10. `relifso`
+### 11. `relifso`
 
 ```bash
 dler relifso init ...
 ```
 
-### 11. `relinka`
+### 12. `relinka`
 
 [@reliverse/relinka](https://github.com/reliverse/relinka)'s best friend. Converts between different logging formats (console, consola method/object, and relinka's function/method/object styles).
 
@@ -487,7 +512,7 @@ dler relinka --input src/app.ts --from relinkaFunction --to consolaObject
 - Supports conversion between any combination of formats
 - Supports both consola method and object styles
 
-### 12. `rempts`
+### 13. `rempts`
 
 @reliverse/rempts's best friend. learn more in its [docs](https://github.com/reliverse/rempts).
 
@@ -496,7 +521,7 @@ dler rempts init --cmd my-cmd-1
 dler rempts init --cmds
 ```
 
-### 13. `spell`
+### 14. `spell`
 
 **available spell types:**
 
@@ -565,7 +590,7 @@ files: [] // means all files
 
 p.s. [see how rse cli uses hooked=true](https://github.com/reliverse/rse/blob/main/src/postbuild.ts)
 
-### 14. `split`
+### 15. `split`
 
 splits your code/text file into multiple files.
 

package/bin/app/build/cmd.js

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

package/bin/app/build/impl.js

@@ -5,7 +5,7 @@ import {
 } from "@reliverse/bleump";
 import path from "@reliverse/pathkit";
 import fs from "@reliverse/relifso";
-import { loadConfig } from "../../libs/sdk/sdk-impl/config/load.js";
+import { loadConfig } from "../../libs/sdk/sdk-impl/cfg/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";

package/bin/app/check/cmd.js

@@ -6,14 +6,15 @@ import {
   confirmPrompt,
   defineArgs
 } from "@reliverse/rempts";
-import { displayCheckResults } from "../../libs/sdk/sdk-impl/check/check-mod.js";
-import { checkDlerConfigHealth } from "../../libs/sdk/sdk-impl/check/rules/dler-config-health.js";
-import { checkFileExtensions } from "../../libs/sdk/sdk-impl/check/rules/file-extensions.js";
-import { checkMissingDependencies } from "../../libs/sdk/sdk-impl/check/rules/missing-deps.js";
-import { checkPackageJsonHealth } from "../../libs/sdk/sdk-impl/check/rules/package-json-health.js";
-import { checkPathExtensions } from "../../libs/sdk/sdk-impl/check/rules/path-extensions.js";
-import { checkSelfInclude } from "../../libs/sdk/sdk-impl/check/rules/self-include.js";
-import { checkTsConfigHealth } from "../../libs/sdk/sdk-impl/check/rules/tsconfig-health.js";
+import { checkDlerConfigHealth } from "../../libs/sdk/sdk-impl/rules/reliverse/dler-config-health/dler-config-health.js";
+import { checkFileExtensions } from "../../libs/sdk/sdk-impl/rules/reliverse/file-extensions/file-extensions.js";
+import { checkMissingDependencies } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/deps-mod.js";
+import { checkNoIndexFiles } from "../../libs/sdk/sdk-impl/rules/reliverse/no-index-files/no-index-files.js";
+import { checkPackageJsonHealth } from "../../libs/sdk/sdk-impl/rules/reliverse/package-json-health/package-json-health.js";
+import { checkPathExtensions } from "../../libs/sdk/sdk-impl/rules/reliverse/path-extensions/path-extensions.js";
+import { checkSelfInclude } from "../../libs/sdk/sdk-impl/rules/reliverse/self-include/self-include.js";
+import { checkTsConfigHealth } from "../../libs/sdk/sdk-impl/rules/reliverse/tsconfig-health/tsconfig-health.js";
+import { displayCheckResults } from "../../libs/sdk/sdk-impl/rules/rules-mod.js";
 export default defineCommand({
   meta: {
     name: "check",
@@ -27,7 +28,7 @@ export default defineCommand({
     },
     checks: {
       type: "string",
-      description: "comma-separated list of checks to run (missing-deps,file-extensions,path-extensions,dler-config-health,self-include,tsconfig-health,package-json-health)"
+      description: "comma-separated list of checks to run (missing-deps,file-extensions,path-extensions,dler-config-health,self-include,tsconfig-health,package-json-health,no-index-files)"
     },
     strict: {
       type: "boolean",
@@ -55,6 +56,10 @@ export default defineCommand({
       "info",
       "\u{1F504} self-include rules: no importing from main package or self-imports in libs"
     );
+    relinka(
+      "info",
+      "\u{1F4DA} index files: avoid using index.{ts,js} files to prevent module resolution confusion"
+    );
     let dir;
     let checks;
     let strict;
@@ -105,6 +110,10 @@ export default defineCommand({
           {
             label: "package.json validation",
             value: "package-json-health"
+          },
+          {
+            label: "no index files",
+            value: "no-index-files"
           }
         ]
       });
@@ -201,6 +210,17 @@ checking directory: ${directory}`);
           process.stdout.write("\r");
           displayCheckResults("self-includes", directory, result);
         }
+        if (checks.includes("no-index-files")) {
+          process.stdout.write("  checking for index files...\n");
+          const result = await checkNoIndexFiles({
+            directory,
+            strict,
+            moduleResolution: "bundler",
+            onProgress
+          });
+          process.stdout.write("\r");
+          displayCheckResults("no index files", directory, result);
+        }
       } catch (error) {
         relinka(
           "error",

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

@@ -0,0 +1,26 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    source: {
+        type: "string";
+        description: string;
+    };
+    destination: {
+        type: "string";
+        description: string;
+    };
+    recursive: {
+        type: "boolean";
+        description: string;
+        default: true;
+    };
+    force: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    preserveStructure: {
+        type: "boolean";
+        description: string;
+        default: true;
+    };
+}>;
+export default _default;

package/bin/app/copy/cmd.js

@@ -0,0 +1,143 @@
+import { relinka } from "@reliverse/relinka";
+import { defineCommand, selectPrompt, inputPrompt } from "@reliverse/rempts";
+import { copyFile, access, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { glob } from "tinyglobby";
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function safeCopy(source, destination) {
+  if (await fileExists(destination)) {
+    throw new Error(`Destination file already exists: ${destination}`);
+  }
+  await copyFile(source, destination);
+}
+async function ensureDir(path) {
+  try {
+    await access(path);
+  } catch {
+    await mkdir(path, { recursive: true });
+  }
+}
+export default defineCommand({
+  meta: {
+    name: "copy",
+    version: "1.0.0",
+    description: "Copy files and directories"
+  },
+  args: {
+    source: {
+      type: "string",
+      description: "Source file or directory to copy (supports glob patterns)"
+    },
+    destination: {
+      type: "string",
+      description: "Destination path for the copy operation"
+    },
+    recursive: {
+      type: "boolean",
+      description: "Recursively process all files in subdirectories (default: true)",
+      default: true
+    },
+    force: {
+      type: "boolean",
+      description: "Overwrite existing files (default: false)",
+      default: false
+    },
+    preserveStructure: {
+      type: "boolean",
+      description: "Preserve source directory structure in destination (default: true)",
+      default: true
+    }
+  },
+  async run({ args }) {
+    const {
+      source,
+      destination,
+      recursive = true,
+      force = false,
+      preserveStructure = true
+    } = args;
+    let finalSource = source;
+    let finalDestination = destination;
+    if (!finalSource) {
+      finalSource = await inputPrompt({
+        title: "Enter source file or directory (supports glob patterns)",
+        placeholder: "e.g., putout/packages/*/lib/**/*"
+      });
+    }
+    if (!finalDestination) {
+      finalDestination = await inputPrompt({
+        title: "Enter destination path",
+        placeholder: "e.g., src/libs/sdk/sdk-impl/rules/putout"
+      });
+    }
+    if (!finalSource || !finalDestination) {
+      relinka("error", "Usage: dler copy <source> <destination>");
+      process.exit(1);
+    }
+    try {
+      const files = await glob(finalSource, {
+        dot: true,
+        ignore: recursive ? [] : ["**/*"]
+      });
+      if (files.length === 0) {
+        relinka("error", `No files found matching pattern: ${finalSource}`);
+        process.exit(1);
+      }
+      if (files.length > 1) {
+        const confirm = await selectPrompt({
+          title: `Found ${files.length} files to copy. Proceed?`,
+          options: [
+            { label: "Yes", value: "yes" },
+            { label: "No", value: "no" }
+          ]
+        });
+        if (confirm === "no") {
+          relinka("log", "Operation cancelled by user");
+          return;
+        }
+      }
+      for (const file of files) {
+        let destPath;
+        if (preserveStructure) {
+          const match = file.match(/packages\/([^/]+)\/lib\/(.*)/);
+          if (match?.[1] && match?.[2]) {
+            const packageName = match[1];
+            const relativePath = match[2];
+            destPath = join(finalDestination, packageName, relativePath);
+          } else {
+            destPath = join(finalDestination, file);
+          }
+        } else {
+          destPath = join(finalDestination, file);
+        }
+        try {
+          await ensureDir(dirname(destPath));
+          if (force) {
+            await copyFile(file, destPath);
+          } else {
+            await safeCopy(file, destPath);
+          }
+          relinka("log", `Copied '${file}' to '${destPath}'`);
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+          relinka("error", `Error copying '${file}': ${errorMessage}`);
+          if (!force) {
+            process.exit(1);
+          }
+        }
+      }
+      relinka("log", `Successfully copied ${files.length} file(s)`);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      relinka("error", `Error during copy operation: ${errorMessage}`);
+      process.exit(1);
+    }
+  }
+});

package/bin/app/deps/cmd.js

@@ -1,8 +1,8 @@
 import path from "@reliverse/pathkit";
 import { re } from "@reliverse/relico";
 import { defineArgs, defineCommand } from "@reliverse/rempts";
-import { analyzeDependencies } from "../../libs/sdk/sdk-impl/check/rules/deps/analyzer.js";
-import { formatOutput } from "../../libs/sdk/sdk-impl/check/rules/deps/formatter.js";
+import { analyzeDependencies } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/analyzer.js";
+import { formatOutput } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/formatter.js";
 export default defineCommand({
   meta: {
     name: "deps",

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

@@ -22,5 +22,17 @@ declare const _default: import("@reliverse/rempts").Command<{
         description: string;
         default: false;
     };
+    consoleRelinkaInput: {
+        type: "string";
+        description: string;
+    };
+    consoleRelinkaFrom: {
+        type: "string";
+        description: string;
+    };
+    consoleRelinkaTo: {
+        type: "string";
+        description: string;
+    };
 }>;
 export default _default;