@reliverse/dler 1.7.2 → 1.7.3

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 [15 built-in plugins](#-plugins) included
+- 🔌 [15 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
@@ -117,17 +117,17 @@ bun dev # bun src/cli.ts --dev
     dler [build|pub] # if installed globally
     ```
 
-## 🔌 plugins
+## 🔌 commands
 
-dler ships with a flexible plugin system (aka plugins) and **15 built-in plugins** (from [reliverse addons](https://reliverse.org/addons) collection).
+dler ships with a flexible command system (prev. plugins) and **15 built-in commands** (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`.
+feel free to create your own commands. commands can be implemented as built-in directly in `src/app/<command>/impl/*` and then imported from `src/app/<command>/cmd.ts`; or implemented in your own library and then imported from `src/app/<command>/cmd.ts`.
 
-if you run just `dler` — it will display a list of plugins which you can launch interactively.
+if you run just `dler` — it will display a list of commands which you can launch interactively.
 
-## **available plugins**
+## **available commands**
 
-[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)
+[agg](#1-agg) [build](#2-build) [check](#3-check) [conv](#4-conv) [copy](#5-copy) [init](#6-init) [inject](#7-inject) [libs](#8-libs) [merge](#9-merge) [migrate](#10-migrate) [pub](#11-pub) [rempts](#13-rempts) [rename](#13-rename) [spell](#14-spell) [split](#15-split)
 
 ### 1. `agg`
 
@@ -150,9 +150,17 @@ 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
 ```
 
-### 2. `check` (aka rules of dler)
+### 2. `build`
 
-checks your project for common issues and potential improvements. This command performs several types of checks:
+since dler is fully modular, build command is separated for its own build-in plugin as well.
+
+```bash
+bun dler build ...
+```
+
+### 3. `check`
+
+checks your project for common issues and potential improvements. This command performs several types of checks (aka rules of dler):
 
 - **File Extensions**: Validates that files have the correct extensions based on their location and module resolution strategy
   - Enforces `.ts` files in source and JSR distributions
@@ -216,14 +224,6 @@ 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.
 
-### 3. `build`
-
-since dler is fully modular, build command is separated for its own build-in plugin as well.
-
-```bash
-dler build ...
-```
-
 ### 4. `conv`
 
 not yet documented.
@@ -284,11 +284,25 @@ deep imports like `dep/some/file` or `@org/dep/some/thing` are always resolved t
 - **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`
+### 5. `copy`
+
+```bash
+# simple example:
+bun dler copy --s "src/**/*.ts" --d "dist"
+
+# advanced example:
+bun dler copy --s ".temp/packages/*/lib/**/*" --d "src/libs/sdk/sdk-impl/rules/external"
+```
+
+### 6. `init`
 
 not yet documented.
 
-### 7. `libs`
+### 7. `inject`
+
+not yet documented.
+
+### 8. `libs`
 
 builds and publishes specific subdirectories of your main project as standalone packages.
 
@@ -324,11 +338,19 @@ libslist: {
 
 - more magic commands coming soon...
 
-### 8. `merge`
+### 9. `merge`
 
-not yet documented.
+merges multiple files into a single file.
 
-### 9. `migrate`
+```bash
+# simple example:
+bun dler merge --s "src/**/*.ts" --d "dist/merged.ts"
+
+# advanced example:
+bun dler merge --s ".temp1/packages/*/lib/**/*" --d ".temp2/merged.ts" --sort "mtime" --header "// Header" --footer "// Footer" --dedupe
+```
+
+### 10. `migrate`
 
 helps migrate between different libraries and module resolution strategies. currently supports:
 
@@ -427,7 +449,46 @@ dler migrate --lib nodenext-bundler --target nodenext --dryRun
 - handles both relative and alias imports
 - supports both .ts and .tsx files
 
-**next steps after migration:**
+#### `console-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).
+
+```bash
+# Basic usage
+dler relinka --input <file> --from <source> --to <target>
+
+# Examples:
+# Convert console.log to relinka function style
+dler relinka --input src/app.ts --from console --to relinkaFunction
+
+# Convert consola method to relinka method style
+dler relinka --input src/app.ts --from consolaMethod --to relinkaMethod
+
+# Convert between relinka styles
+dler relinka --input src/app.ts --from relinkaMethod --to relinkaObject
+
+# Convert to consola object style
+dler relinka --input src/app.ts --from relinkaFunction --to consolaObject
+```
+
+**Supported formats:**
+
+- `console`: Standard console logging (`console.log(message, ...args)`)
+- `consolaMethod`: Consola method style (`consola.log(message, ...args)`)
+- `consolaObject`: Consola object style (`consola({ level, message, title?, args? })`)
+- `relinkaFunction`: Relinka function style (`relinka("level", message, ...args)`)
+- `relinkaMethod`: Relinka method style (`relinka.level(message, ...args)`)
+- `relinkaObject`: Relinka object style (`relinka({ level, message, title?, args? })`)
+
+**Special features:**
+
+- Preserves additional arguments in all formats
+- Handles special box format with title and message
+- Maintains proper escaping and formatting
+- Supports conversion between any combination of formats
+- Supports both consola method and object styles
+
+#### next steps after migration
 
 - for path-pathkit:
   1. run 'bun install' to install @reliverse/pathkit
@@ -457,68 +518,29 @@ dler migrate --lib nodenext-bundler --target nodenext --dryRun
   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`
+### 11. `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 ...
+bun dler pub ...
 ```
 
-### 12. `relinka`
+### 13. `rempts`
 
-[@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).
+@reliverse/rempts's best friend. learn more in its [docs](https://github.com/reliverse/rempts).
 
 ```bash
-# Basic usage
-dler relinka --input <file> --from <source> --to <target>
-
-# Examples:
-# Convert console.log to relinka function style
-dler relinka --input src/app.ts --from console --to relinkaFunction
-
-# Convert consola method to relinka method style
-dler relinka --input src/app.ts --from consolaMethod --to relinkaMethod
-
-# Convert between relinka styles
-dler relinka --input src/app.ts --from relinkaMethod --to relinkaObject
-
-# Convert to consola object style
-dler relinka --input src/app.ts --from relinkaFunction --to consolaObject
+bun dler rempts
+bun dler rempts --init cmd1 cmd2
 ```
 
-**Supported formats:**
-
-- `console`: Standard console logging (`console.log(message, ...args)`)
-- `consolaMethod`: Consola method style (`consola.log(message, ...args)`)
-- `consolaObject`: Consola object style (`consola({ level, message, title?, args? })`)
-- `relinkaFunction`: Relinka function style (`relinka("level", message, ...args)`)
-- `relinkaMethod`: Relinka method style (`relinka.level(message, ...args)`)
-- `relinkaObject`: Relinka object style (`relinka({ level, message, title?, args? })`)
-
-**Special features:**
-
-- Preserves additional arguments in all formats
-- Handles special box format with title and message
-- Maintains proper escaping and formatting
-- Supports conversion between any combination of formats
-- Supports both consola method and object styles
-
-### 13. `rempts`
-
-@reliverse/rempts's best friend. learn more in its [docs](https://github.com/reliverse/rempts).
+### 13. `rename`
 
 ```bash
-dler rempts init --cmd my-cmd-1
-dler rempts init --cmds
+bun dler rename ...
 ```
 
 ### 14. `spell`
@@ -595,7 +617,7 @@ p.s. [see how rse cli uses hooked=true](https://github.com/reliverse/rse/blob/ma
 splits your code/text file into multiple files.
 
 ```bash
-dler split ...
+bun dler split ...
 ```
 
 ## api (for advanced users)

package/bin/app/agg/run.js

@@ -6,7 +6,7 @@ import {
 } from "@reliverse/rempts";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { getCmdAgg } from "../cmds.js";
+import { getAggCmd } from "../cmds.js";
 async function loadConfig() {
   const configPath = resolve(".config/dler.ts");
   if (!existsSync(configPath)) return null;
@@ -84,7 +84,7 @@ export async function promptAggCommand() {
       defaultValue: out.replace(/\.(ts|js)$/, ".types.$1")
     });
   }
-  await runCmd(await getCmdAgg(), [
+  await runCmd(await getAggCmd(), [
     `--imports=${imports}`,
     `--input=${input}`,
     `--named=${named}`,

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

@@ -15,5 +15,42 @@ declare const _default: import("@reliverse/rempts").Command<{
         type: "boolean";
         description: string;
     };
+    deps: {
+        type: "boolean";
+        description: string;
+    };
+    all: {
+        type: "boolean";
+        description: string;
+    };
+    ignore: {
+        type: "string";
+        description: string;
+    };
+    builtins: {
+        type: "boolean";
+        description: string;
+    };
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+    peer: {
+        type: "boolean";
+        description: string;
+    };
+    optional: {
+        type: "boolean";
+        description: string;
+    };
+    fix: {
+        type: "boolean";
+        description: string;
+    };
+    depth: {
+        type: "number";
+        description: string;
+        default: number;
+    };
 }>;
 export default _default;

package/bin/app/check/cmd.js

@@ -1,3 +1,5 @@
+import path from "@reliverse/pathkit";
+import { re } from "@reliverse/relico";
 import { relinka } from "@reliverse/relinka";
 import {
   defineCommand,
@@ -8,7 +10,9 @@ import {
 } from "@reliverse/rempts";
 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 { analyzeDependencies } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/analyzer.js";
 import { checkMissingDependencies } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/deps-mod.js";
+import { formatOutput } from "../../libs/sdk/sdk-impl/rules/reliverse/missing-deps/formatter.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";
@@ -18,10 +22,11 @@ import { displayCheckResults } from "../../libs/sdk/sdk-impl/rules/rules-mod.js"
 export default defineCommand({
   meta: {
     name: "check",
-    version: "1.0.0",
-    description: "check your codebase source and dists for any issues."
+    version: "2.0.0",
+    description: "Check your codebase for issues (deps, extensions, config, etc) or analyze dependencies."
   },
   args: defineArgs({
+    // --- check args ---
     directory: {
       type: "string",
       description: "directory to check (src, dist-npm, dist-jsr, dist-libs/npm, dist-libs/jsr, or all)"
@@ -37,9 +42,76 @@ export default defineCommand({
     json: {
       type: "boolean",
       description: "output results in JSON format"
+    },
+    // --- deps args ---
+    deps: {
+      type: "boolean",
+      description: "run dependency analysis instead of codebase checks"
+    },
+    all: {
+      type: "boolean",
+      description: "show all dependencies (both listed and not listed)"
+    },
+    ignore: {
+      type: "string",
+      description: "comma-separated patterns to ignore (for deps)"
+    },
+    builtins: {
+      type: "boolean",
+      description: "include Node.js built-in modules in the output (for deps)"
+    },
+    dev: {
+      type: "boolean",
+      description: "check devDependencies instead of dependencies (for deps)"
+    },
+    peer: {
+      type: "boolean",
+      description: "check peerDependencies instead of dependencies (for deps)"
+    },
+    optional: {
+      type: "boolean",
+      description: "check optionalDependencies instead of dependencies (for deps)"
+    },
+    fix: {
+      type: "boolean",
+      description: "automatically add missing dependencies to package.json (for deps)"
+    },
+    depth: {
+      type: "number",
+      description: "maximum directory depth to scan (0 for unlimited, for deps)",
+      default: 0
     }
   }),
   async run({ args }) {
+    if (args.deps) {
+      try {
+        const directory = path.resolve(args.directory ?? ".");
+        const ignorePatterns = args.ignore ? args.ignore.split(",") : [];
+        const options = {
+          directory,
+          showAll: args.all,
+          ignorePatterns,
+          json: args.json,
+          builtins: args.builtins,
+          dev: args.dev,
+          peer: args.peer,
+          optional: args.optional,
+          fix: args.fix,
+          depth: args.depth
+        };
+        console.log(re.gray(`Scanning directory: ${directory}`));
+        const result = await analyzeDependencies(options);
+        const output = formatOutput(result, options);
+        console.log(output);
+        if (result.missingDependencies.length > 0) {
+          process.exit(1);
+        }
+      } catch (error) {
+        console.error("Error:", error);
+        process.exit(1);
+      }
+      return;
+    }
     relinka(
       "info",
       "this command checks your codebase for extension and dependency issues."
@@ -70,9 +142,7 @@ export default defineCommand({
         title: "select a directory to check",
         options: [
           { label: "all directories", value: "all" },
-          // TODO: run this automatically BEFORE `dler build`
           { label: "src (typescript source)", value: "src" },
-          // TODO: run this automatically AFTER `dler build`
           { label: "dist-npm (compiled js)", value: "dist-npm" },
           { label: "dist-jsr (typescript)", value: "dist-jsr" },
           { label: "dist-libs/npm (compiled js)", value: "dist-libs/npm" },

package/bin/app/cmds.d.ts

@@ -1,21 +1,16 @@
 import type { Command } from "@reliverse/rempts";
-export declare const getCmdAgg: () => Promise<Command>;
-export declare function getCmdBuild(): Promise<Command>;
-export declare function getCmdCheck(): Promise<Command>;
-export declare function getCmdConv(): Promise<Command>;
-export declare function getCmdDeps(): Promise<Command>;
-export declare function getCmdInject(): Promise<Command>;
-export declare function getCmdInjectExpect(): Promise<Command>;
-export declare function getCmdLibs(): Promise<Command>;
-export declare function getCmdMerge(): Promise<Command>;
-export declare function getCmdMigrate(): Promise<Command>;
-export declare function getCmdPub(): Promise<Command>;
-export declare function getCmdRelifso(): Promise<Command>;
-export declare function getCmdRelifsoInit(): Promise<Command>;
-export declare function getCmdRelifsoRename(): Promise<Command>;
-export declare function getCmdRelinka(): Promise<Command>;
-export declare function getCmdRemptsCmd(): Promise<Command>;
-export declare function getCmdRemptsCmdsTs(): Promise<Command>;
-export declare function getCmdRemptsMigrate(): Promise<Command>;
-export declare function getCmdSpell(): Promise<Command>;
-export declare function getCmdSplit(): Promise<Command>;
+export declare const getAggCmd: () => Promise<Command>;
+export declare const getBuildCmd: () => Promise<Command>;
+export declare const getCheckCmd: () => Promise<Command>;
+export declare const getConvCmd: () => Promise<Command>;
+export declare const getCopyCmd: () => Promise<Command>;
+export declare const getInitCmd: () => Promise<Command>;
+export declare const getInjectCmd: () => Promise<Command>;
+export declare const getLibsCmd: () => Promise<Command>;
+export declare const getMergeCmd: () => Promise<Command>;
+export declare const getMigrateCmd: () => Promise<Command>;
+export declare const getPubCmd: () => Promise<Command>;
+export declare const getRemptsCmd: () => Promise<Command>;
+export declare const getRenameCmd: () => Promise<Command>;
+export declare const getSpellCmd: () => Promise<Command>;
+export declare const getSplitCmd: () => Promise<Command>;

package/bin/app/cmds.js

@@ -1,76 +1,16 @@
-import { relinka } from "@reliverse/relinka";
-import { createJiti } from "jiti";
-const jiti = createJiti(import.meta.url, {
-  debug: process.env.NODE_ENV === "development",
-  fsCache: true,
-  sourceMaps: true
-});
-async function loadCommand(path) {
-  try {
-    relinka("verbose", `Loading command from: ${path}`);
-    const cmd = await jiti.import(path, { default: true });
-    relinka("verbose", `Successfully loaded command from: ${path}`);
-    return cmd;
-  } catch (error) {
-    relinka("error", `Failed to load command from ${path}:`, error);
-    throw error;
-  }
-}
-export const getCmdAgg = async () => loadCommand("./agg/cmd");
-export async function getCmdBuild() {
-  return loadCommand("./build/cmd");
-}
-export async function getCmdCheck() {
-  return loadCommand("./check/cmd");
-}
-export async function getCmdConv() {
-  return loadCommand("./conv/cmd");
-}
-export async function getCmdDeps() {
-  return loadCommand("./deps/cmd");
-}
-export async function getCmdInject() {
-  return loadCommand("./inject/cmd");
-}
-export async function getCmdInjectExpect() {
-  return loadCommand("./inject/expect/cmd");
-}
-export async function getCmdLibs() {
-  return loadCommand("./libs/cmd");
-}
-export async function getCmdMerge() {
-  return loadCommand("./merge/cmd");
-}
-export async function getCmdMigrate() {
-  return loadCommand("./migrate/cmd");
-}
-export async function getCmdPub() {
-  return loadCommand("./pub/cmd");
-}
-export async function getCmdRelifso() {
-  return loadCommand("./relifso/cmd");
-}
-export async function getCmdRelifsoInit() {
-  return loadCommand("./relifso/init/cmd");
-}
-export async function getCmdRelifsoRename() {
-  return loadCommand("./relifso/rename/cmd");
-}
-export async function getCmdRelinka() {
-  return loadCommand("./relinka/cmd");
-}
-export async function getCmdRemptsCmd() {
-  return loadCommand("./rempts/cmd/cmd");
-}
-export async function getCmdRemptsCmdsTs() {
-  return loadCommand("./rempts/cmdsTs/cmd");
-}
-export async function getCmdRemptsMigrate() {
-  return loadCommand("./rempts/migrate/cmd");
-}
-export async function getCmdSpell() {
-  return loadCommand("./spell/cmd");
-}
-export async function getCmdSplit() {
-  return loadCommand("./split/cmd");
-}
+import { loadCommand } from "@reliverse/rempts";
+export const getAggCmd = async () => loadCommand("agg");
+export const getBuildCmd = async () => loadCommand("build");
+export const getCheckCmd = async () => loadCommand("check");
+export const getConvCmd = async () => loadCommand("conv");
+export const getCopyCmd = async () => loadCommand("copy");
+export const getInitCmd = async () => loadCommand("init");
+export const getInjectCmd = async () => loadCommand("inject");
+export const getLibsCmd = async () => loadCommand("libs");
+export const getMergeCmd = async () => loadCommand("merge");
+export const getMigrateCmd = async () => loadCommand("migrate");
+export const getPubCmd = async () => loadCommand("pub");
+export const getRemptsCmd = async () => loadCommand("rempts");
+export const getRenameCmd = async () => loadCommand("rename");
+export const getSpellCmd = async () => loadCommand("spell");
+export const getSplitCmd = async () => loadCommand("split");

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

@@ -1,9 +1,9 @@
 declare const _default: import("@reliverse/rempts").Command<{
-    source: {
+    s: {
         type: "string";
         description: string;
     };
-    destination: {
+    d: {
         type: "string";
         description: string;
     };
@@ -12,15 +12,20 @@ declare const _default: import("@reliverse/rempts").Command<{
         description: string;
         default: true;
     };
-    force: {
+    preserveStructure: {
         type: "boolean";
         description: string;
-        default: false;
+        default: true;
     };
-    preserveStructure: {
+    increment: {
         type: "boolean";
         description: string;
         default: true;
     };
+    concurrency: {
+        type: "number";
+        description: string;
+        default: number;
+    };
 }>;
 export default _default;