@reliverse/dler 1.2.5 → 1.3.0

package/bin/app/deps/impl/types.d.ts

@@ -0,0 +1,21 @@
+export type FileType = ".js" | ".jsx" | ".ts" | ".tsx";
+export type PackageJson = {
+    name?: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+};
+export type FinderOptions = {
+    directory: string;
+    showAll: boolean;
+    ignorePatterns: string[];
+    json: boolean;
+    builtins: boolean;
+};
+export type DependencyResult = {
+    missingDependencies: string[];
+    allDependencies: string[];
+    listedDependencies: string[];
+    builtinModules: string[];
+};

package/bin/app/inject/README.md

@@ -34,28 +34,19 @@ bun x @reliverse/inject
 
 ### Basic Usage
 
-**User config** in `inject.config.ts`:
-
-```ts
-export default {
-  injectComment: "// @ts-expect-error TODO: fix ts",
-  tscCommand: "tsc --project ./tsconfig.json --noEmit"
-}
-```
-
 **Running**:
 
 ```bash
 # 1) Automatic mode:
-inject ts-expect-error auto
+bun dler inject expect auto
 # => runs `tsc`, finds errors, injects comment above them.
 
 # 2) Lines-file mode:
-inject ts-expect-error linesA.txt linesB.txt
+bun dler inject expect linesA.txt linesB.txt
 # => no TSC, just parses references from lines files
 
 # 3) Mixed:
-inject ts-expect-error auto lines.txt
+bun dler inject expect auto lines.txt
 # => merges TSC errors with references in lines.txt
 ```
 

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

@@ -0,0 +1,12 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+    cwd: {
+        type: "string";
+        description: string;
+        required: false;
+    };
+}>;
+export default _default;

package/bin/app/inject/cmd.js

@@ -1,6 +1,6 @@
 import { relinka } from "@reliverse/relinka";
 import { defineCommand, runCmd, selectPrompt } from "@reliverse/rempts";
-import { getCmdInjectTsExpectError } from "../cmds.js";
+import { cmdInjectExpect } from "../cmds.js";
 export default defineCommand({
   meta: {
     name: "cli",
@@ -30,7 +30,7 @@ export default defineCommand({
       ]
     });
     if (cmd === "ts-expect-error") {
-      await runCmd(await getCmdInjectTsExpectError(), []);
+      await runCmd(await cmdInjectExpect(), []);
     }
   }
 });

package/bin/app/inject/expect/cmd.d.ts

@@ -0,0 +1,20 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+    files: {
+        type: "positional";
+        description: string;
+        default: string;
+    };
+    comment: {
+        type: "string";
+        description: string;
+    };
+    tscPaths: {
+        type: "string";
+        description: string;
+    };
+}>;
+export default _default;

package/bin/app/inject/expect/impl.d.ts

@@ -0,0 +1,5 @@
+export declare function useTsExpectError(args: {
+    files: string[];
+    comment?: string;
+    tscPaths?: string[];
+}): Promise<void>;

package/bin/app/merge/cmd.txt

@@ -1,5 +1,5 @@
 import { glob } from "@reliverse/reglob";
-import { readFile, writeFile, ensureDir } from "@reliverse/relifso";
+import { readFile, writeFile, ensureDir } from "fs-extra";
 import {
   defineCommand,
   runMain,

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

@@ -0,0 +1,7 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+}>;
+export default _default;

package/bin/app/pub/cmd.js

@@ -1,5 +1,6 @@
 import { defineArgs, defineCommand } from "@reliverse/rempts";
-import { dlerPub } from "../../cli.js";
+import { dlerPub } from "../../impl.js";
+import { ensureDlerConfig } from "../../init.js";
 export default defineCommand({
   meta: {
     name: "build",
@@ -12,6 +13,7 @@ export default defineCommand({
     }
   }),
   async run({ args }) {
+    await ensureDlerConfig(args.dev);
     await dlerPub(args.dev);
   }
 });

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

@@ -0,0 +1,12 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+    cwd: {
+        type: "string";
+        description: string;
+        required: false;
+    };
+}>;
+export default _default;

package/bin/app/relifso/cmd.js

@@ -1,6 +1,6 @@
 import { relinka } from "@reliverse/relinka";
 import { defineCommand, runCmd, selectPrompt } from "@reliverse/rempts";
-import { getCmdRelifsoInit } from "../cmds.js";
+import { cmdRelifsoInit } from "../cmds.js";
 export default defineCommand({
   meta: {
     name: "cli",
@@ -30,7 +30,7 @@ export default defineCommand({
       ]
     });
     if (cmd === "init") {
-      await runCmd(await getCmdRelifsoInit(), []);
+      await runCmd(await cmdRelifsoInit(), []);
     }
   }
 });

package/bin/app/relifso/init/cmd.d.ts

@@ -0,0 +1,36 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    dev: {
+        type: "boolean";
+        description: string;
+    };
+    fileType: {
+        type: "string";
+        description: string;
+        required: false;
+    };
+    destDir: {
+        type: "string";
+        description: string;
+        default: string;
+        required: false;
+    };
+    multiple: {
+        type: "boolean";
+        description: string;
+        required: false;
+        default: false;
+    };
+    parallel: {
+        type: "boolean";
+        description: string;
+        required: false;
+        default: false;
+    };
+    concurrency: {
+        type: "string";
+        description: string;
+        required: false;
+        default: string;
+    };
+}>;
+export default _default;

package/bin/app/relifso/init/impl/const.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Known file types with possible variations.
+ */
+export declare const FILE_TYPES: readonly [{
+    readonly type: "cfg:eslint";
+    readonly variations: readonly ["eslint.config.js"];
+}, {
+    readonly type: "cfg:knip";
+    readonly variations: readonly ["knip.json"];
+}, {
+    readonly type: "cfg:reliverse";
+    readonly variations: readonly [".config/rse.jsonc", ".config/rse.ts"];
+}, {
+    readonly type: "cfg:package.json";
+    readonly variations: readonly ["package.json"];
+}, {
+    readonly type: "cfg:tsconfig.json";
+    readonly variations: readonly ["tsconfig.json"];
+}, {
+    readonly type: "git:gitattributes";
+    readonly variations: readonly [".gitattributes"];
+}, {
+    readonly type: "git:gitignore";
+    readonly variations: readonly [".gitignore"];
+}, {
+    readonly type: "md:LICENSE";
+    readonly variations: readonly ["LICENSE.md", "LICENSE"];
+}, {
+    readonly type: "md:README";
+    readonly variations: readonly ["README.md", "README"];
+}];
+export declare const INIT_BEHAVIOURS: readonly ["create", "copy", "create-if-copy-failed"];
+export declare const DEST_FILE_EXISTS_BEHAVIOURS: readonly ["rewrite", "skip", "attach-index", "prompt"];
+export declare const CONTENT_CREATE_MODES: string[];

package/bin/app/relifso/init/impl/const.js

@@ -10,7 +10,7 @@ export const FILE_TYPES = [
   { type: "git:gitattributes", variations: [".gitattributes"] },
   { type: "git:gitignore", variations: [".gitignore"] },
   { type: "md:LICENSE", variations: ["LICENSE.md", "LICENSE"] },
-  { type: "md:README", variations: ["README.md"] }
+  { type: "md:README", variations: ["README.md", "README"] }
 ];
 export const INIT_BEHAVIOURS = [
   "create",

package/bin/app/relifso/init/impl/mod.d.ts

@@ -0,0 +1,17 @@
+import type { FileType, InitFileRequest, InitFileResult, ReinitUserConfig } from "./types.js";
+/**
+ * Creates a file from scratch, including parent directories,
+ * basing the file content on the fileType.
+ */
+export declare function createFileFromScratch(destPath: string, fileType: FileType, contentCreateMode?: string): Promise<void>;
+/**
+ * Single-file initialization using the merged config.
+ */
+export declare function initFile(req: InitFileRequest, userCfg?: Partial<ReinitUserConfig>): Promise<InitFileResult>;
+/**
+ * Multi-file version with parallel processing support.
+ */
+export declare function initFiles(items: InitFileRequest[], options?: {
+    parallel?: boolean;
+    concurrency?: number;
+}, userCfg?: Partial<ReinitUserConfig>): Promise<InitFileResult[]>;

package/bin/app/relifso/init/impl/templates/t-gitignore.d.ts

@@ -0,0 +1 @@
+export declare const gitignoreTemplate = "*.log\n.env\n.DS_Store\n.eslintcache\nnode_modules\ndist-jsr\ndist-libs\ndist-npm\n";

package/bin/app/relifso/init/impl/templates/t-license.d.ts

@@ -0,0 +1 @@
+export declare const licenseTemplate = "# MIT License\n\nCopyright (c) Nazar Kornienko (blefnk), Reliverse\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n";

package/bin/app/relifso/init/impl/templates/t-readme.d.ts

@@ -0,0 +1 @@
+export declare const readmeTemplate = "# \uD83D\uDE80 Project Name\n\nWelcome! This project was bootstrapped with [@reliverse/reinit](https://www.npmjs.com/package/@reliverse/reinit).  \nIt's already got the basics \u2014 now it's your turn to make it awesome \u2728\n\n## \uD83D\uDD27 Tech Stack\n\n- \u2699\uFE0F Framework: _<Add your framework here>_\n- \uD83D\uDEE0\uFE0F Tools: _<Add your tooling, CLIs, etc>_\n- \uD83E\uDDEA Tests: _<Vitest, Jest, or something else?>_\n- \uD83E\uDDE0 Linting: _ESLint, Biome, etc_\n- \uD83C\uDF10 Deployment: _<Vercel, Netlify, Railway?>_\n\n## \uD83D\uDE80 Getting Started\n\nClone the repo and install dependencies:\n\n'''bash\nbun install\nbun dev\n'''\n\nOr if you're using another package manager:\n\n'''bash\nnpm install && npm run dev\n# or\npnpm i && pnpm dev\n'''\n\n## \uD83D\uDDC2\uFE0F Project Structure\n\n'''bash\nsrc/\n\u251C\u2500\u2500 components/\n\u251C\u2500\u2500 pages/\n\u251C\u2500\u2500 lib/\n\u2514\u2500\u2500 styles/\n'''\n\nFeel free to tweak the structure to your liking.\n\n## \uD83E\uDDE9 Customize it\n\nThis project is just a starting point. You can add:\n\n- \uD83E\uDDD9\u200D\u2642\uFE0F Your own components and UI\n- \uD83D\uDCE6 APIs, auth, i18n, analytics, whatever you need\n- \uD83E\uDD16 AI integrations using [Reliverse CLI](https://www.npmjs.com/package/@reliverse/rse)\n\n## \uD83E\uDEF6 Credits\n\nMade with \u2764\uFE0F using [@reliverse/reinit](https://reliverse.org)  \nNeed help? [Join the Discord](https://discord.gg/Pb8uKbwpsJ)\n\n## \uD83D\uDCC4 License\n\nMIT \u00A9 YourNameHere\n";

package/bin/app/relifso/init/impl/types.d.ts

@@ -0,0 +1,41 @@
+import type { DEST_FILE_EXISTS_BEHAVIOURS, FILE_TYPES, INIT_BEHAVIOURS } from "./const.js";
+export type FileType = (typeof FILE_TYPES)[number]["type"];
+export type InitBehaviour = (typeof INIT_BEHAVIOURS)[number];
+export type DestFileExistsBehaviour = (typeof DEST_FILE_EXISTS_BEHAVIOURS)[number];
+/** Library-level interface for hooking into the file init process. */
+export type ReinitUserConfig = {
+    /** The default approach for copying vs. creating. */
+    defaultInitBehaviour?: InitBehaviour;
+    /** Default approach if a file already exists. */
+    defaultDestFileExistsBehaviour?: DestFileExistsBehaviour;
+    /** Whether `initFiles` should run in parallel by default. */
+    parallelByDefault?: boolean;
+    /** Concurrency limit for parallel tasks. If omitted, 4 is used. */
+    parallelConcurrency?: number;
+    /** Called before each file operation. */
+    onFileStart?: (req: InitFileRequest) => void;
+    /** Called after each file operation. */
+    onFileComplete?: (res: InitFileResult) => void;
+};
+/** Data describing a single request to initFile. */
+export type InitFileRequest = {
+    fileType: FileType;
+    destDir: string;
+    initBehaviour?: InitBehaviour;
+    destFileExistsBehaviour?: DestFileExistsBehaviour;
+    options?: InitFileOptions;
+};
+/** Extended per-file options. */
+export type InitFileOptions = {
+    destFileName?: string;
+    srcCopyMode?: string;
+    contentCreateMode?: string;
+    fallbackSource?: string;
+};
+/** The result of a single initFile operation. */
+export type InitFileResult = {
+    requested: InitFileRequest;
+    finalPath?: string;
+    status: "created" | "copied" | "skipped" | "error";
+    error?: any;
+};

package/bin/app/relifso/init/impl/utils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Escapes custom markdown code blocks (''' → ```).
+ * Useful for safely embedding markdown in template literals.
+ */
+export declare function escapeMarkdownCodeBlocks(input: string): string;

package/bin/app/rempts/init/cmd/cmd.d.ts

@@ -0,0 +1,14 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    cmd: {
+        type: "array";
+        required: true;
+        description: string;
+        options: string[];
+    };
+    force: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+}>;
+export default _default;

package/bin/app/rempts/init/cmd/cmd.js

@@ -33,7 +33,9 @@ export default defineCommand({
         );
         continue;
       }
-      fs.mkdirSync(dirPath, { recursive: true });
+      fs.mkdirSync(dirPath, {
+        recursive: true
+      });
       const content = generateCommandTemplate(cmdName);
       fs.writeFileSync(filePath, content, "utf-8");
       relinka("log", `\u2705 Created new command: ${filePath}`);

package/bin/app/rempts/init/cmds/cmd.d.ts

@@ -0,0 +1,19 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    outFile: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    cmdDirs: {
+        type: "array";
+        description: string;
+        default: never[];
+        options: string[];
+    };
+    force: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+}>;
+export default _default;

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

@@ -0,0 +1,14 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    provider: {
+        type: "string";
+        description: string;
+        required: true;
+        allowed: string[];
+    };
+    input: {
+        type: "string";
+        description: string;
+        required: true;
+    };
+}>;
+export default _default;

package/bin/app/rempts/migrate/impl/commander.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Main function to transform Commander commands to Rempts format
+ */
+export declare function commanderToRempts(targetDirectory: string): Promise<void>;

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

@@ -0,0 +1,18 @@
+declare const _default: import("@reliverse/rempts").Command<{
+    spells: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    files: {
+        type: "string";
+        description: string;
+        default: string;
+    };
+    dryRun: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>;
+export default _default;

package/bin/app/spell/cmd.js

@@ -0,0 +1,51 @@
+import { defineArgs, defineCommand } from "@reliverse/rempts";
+import { spells } from "../../libs/sdk/sdk-impl/spell/spell-mod.js";
+export default defineCommand({
+  meta: {
+    name: "spells",
+    version: "1.0.0",
+    description: "Execute magic spells in your codebase"
+  },
+  args: defineArgs({
+    spells: {
+      type: "string",
+      description: "Comma-separated list of spells to execute (or 'all')",
+      default: "all"
+    },
+    files: {
+      type: "string",
+      description: "Comma-separated list of files to process (or all if not specified)",
+      default: ""
+    },
+    dryRun: {
+      type: "boolean",
+      description: "Preview changes without applying them",
+      default: false
+    }
+  }),
+  async run({ args }) {
+    const requestedSpells = args.spells ? args.spells.split(",") : ["all"];
+    const files = args.files ? args.files.split(",") : [];
+    console.log(`Triggering spells: ${requestedSpells.join(", ")}`);
+    if (files.length) {
+      console.log(`On files: ${files.join(", ")}`);
+    } else {
+      console.log("On all files");
+    }
+    if (args.dryRun) {
+      console.log("DRY RUN - No changes will be applied");
+    }
+    const results = await spells({
+      spells: requestedSpells,
+      files,
+      dryRun: args.dryRun
+    });
+    console.log("\nResults:");
+    for (const result of results) {
+      const status = result.success ? "\u2713" : "\u2717";
+      console.log(
+        `${status} ${result.file}: ${result.spell.type} - ${result.message}`
+      );
+    }
+  }
+});

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

@@ -0,0 +1,11 @@
+/**
+ * This script:
+ * 1) Reads all *.ts or *.js files from a directory.
+ * 2) Splits files larger than a specified line threshold.
+ * 3) Splits functions larger than a specified line threshold into smaller helpers.
+ *
+ * Usage:
+ *   bun src/split-large-files.ts --dir ./example --file-threshold 30 --func-threshold 20
+ *
+ * Warning: This script is experimental and might break code. A more stable version will be available in the future.
+ */

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

@@ -0,0 +1,25 @@
+type SplitOptions = {
+    directory: string;
+    fileLineThreshold: number;
+    funcLineThreshold: number;
+};
+export declare function parseCommandLineArgs(): SplitOptions;
+/**
+ * 1) Reads all *.ts or *.js files from the given directory (recursively).
+ * 2) Returns their file paths.
+ */
+export declare function getAllSourceFiles(dir: string): string[];
+/**
+ * Splits a file by line threshold. For instance, if a file has 1000 lines and threshold=300,
+ * it will generate multiple chunks (e.g., 300 lines, 300 lines, 300 lines, 100 lines).
+ * Returns the new file paths after splitting.
+ */
+export declare function splitLargeFileByLines(filePath: string, threshold: number): string[];
+/**
+ * Splits large functions found in the source file into smaller helper functions.
+ * - Parse the file with TypeScript to find function declarations and line counts.
+ * - If a function is over a threshold, attempt to break it into two smaller functions.
+ * - Currently this is naive. It basically splits the function body roughly in the middle.
+ */
+export declare function splitLargeFunctions(filePath: string, funcLineThreshold: number): void;
+export {};

package/bin/default.d.ts

@@ -0,0 +1,5 @@
+import type { BuildPublishConfig } from "./types.js";
+/**
+ * Default configuration for the build and publish logic.
+ */
+export declare const DEFAULT_CONFIG: BuildPublishConfig;

package/bin/{libs/cfg/cfg-default.js → default.js}

@@ -9,7 +9,11 @@ export const DEFAULT_CONFIG = {
   coreDescription: "",
   coreEntryFile: "mod.ts",
   coreEntrySrcDir: "src",
-  coreIsCLI: false,
+  coreBuildOutDir: "bin",
+  coreIsCLI: {
+    enabled: false,
+    scripts: {}
+  },
   distJsrAllowDirty: true,
   distJsrBuilder: "jsr",
   distJsrCopyRootFiles: ["README.md", "LICENSE"],
@@ -47,7 +51,5 @@ export const DEFAULT_CONFIG = {
   transpileSplitting: false,
   transpileStub: false,
   transpileTarget: "node",
-  transpileWatch: false,
-  injectComment: "// @ts-expect-error TODO: fix ts",
-  tscCommand: "tsc --project ./tsconfig.json --noEmit"
+  transpileWatch: false
 };

package/bin/dler.d.ts

@@ -0,0 +1 @@
+export {};

package/bin/dler.js

@@ -0,0 +1,60 @@
+import { relinka } from "@reliverse/relinka";
+import {
+  runMain,
+  defineCommand,
+  defineArgs,
+  selectPrompt,
+  showUsage,
+  runCmd
+} from "@reliverse/rempts";
+import { promptAggCommand } from "./addons.js";
+import { cmdBuild, cmdPub } from "./app/cmds.js";
+import { showEndPrompt, showStartPrompt } from "./info.js";
+const INTERACTIVE_CMDS = ["agg", "build", "pub"];
+const main = defineCommand({
+  meta: {
+    name: "dler",
+    description: `Interactively runs selected dler's command.
+However, NI (non-interactive) mode is more powerful, to see NI mode available commands and arguments: 'dler --help' (or 'dler <command> --help')
+Available interactive commands: ${INTERACTIVE_CMDS.join(", ")}`
+  },
+  args: defineArgs({
+    dev: {
+      type: "boolean",
+      description: "Runs the CLI in dev mode"
+    }
+  }),
+  async run({ args }) {
+    const isCI = process.env.CI === "true";
+    const isNonInteractive = !process.stdout.isTTY;
+    if (isCI || isNonInteractive) {
+      relinka(
+        "error",
+        "Non-interactive mode was detected. Please use `dler --help` to see available non-interactive commands and options."
+      );
+      showUsage(main);
+      process.exit(0);
+    }
+    await showStartPrompt(args.dev);
+    const cmdToRun = await selectPrompt({
+      title: "Select a command to run",
+      options: [
+        { value: "agg", label: "agg" },
+        { value: "build", label: "build" },
+        { value: "pub", label: "pub" }
+      ]
+    });
+    if (cmdToRun === "agg") {
+      await promptAggCommand();
+    }
+    if (cmdToRun === "build") {
+      await runCmd(await cmdBuild(), [`--dev=${args.dev}`]);
+    }
+    if (cmdToRun === "pub") {
+      await runCmd(await cmdPub(), [`--dev=${args.dev}`]);
+    }
+    relinka("log", " ");
+    await showEndPrompt();
+  }
+});
+await runMain(main);

package/bin/impl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Main entry point for the dler build and publish process.
+ * Handles building and publishing for both main project and libraries.
+ */
+export declare function dlerBuild(isDev: boolean): Promise<void>;
+/**
+ * Main entry point for the dler build and publish process.
+ * Handles building and publishing for both main project and libraries.
+ */
+export declare function dlerPub(isDev: boolean): Promise<void>;