@reliverse/dler 1.7.22 → 1.7.24

package/bin/app/cmds.d.ts

@@ -12,5 +12,5 @@ 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 getMagicCmd: () => Promise<Command>;
 export declare const getSplitCmd: () => Promise<Command>;

package/bin/app/cmds.js

@@ -12,5 +12,5 @@ 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 getMagicCmd = async () => loadCommand("magic");
 export const getSplitCmd = async () => loadCommand("split");

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

@@ -1,24 +0,0 @@
-declare const _default: import("@reliverse/rempts").Command<{
-    dev: {
-        type: "boolean";
-        description: string;
-    };
-    cwd: {
-        type: "string";
-        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/cmd.js

@@ -1,47 +0,0 @@
-import { relinka } from "@reliverse/relinka";
-import { defineArgs, defineCommand } from "@reliverse/rempts";
-import { useTsExpectError } from "./impl.js";
-export default defineCommand({
-  meta: {
-    name: "expect",
-    version: "1.0.0",
-    description: "Inject `@ts-expect-error` above lines where TS errors occur"
-  },
-  args: defineArgs({
-    dev: {
-      type: "boolean",
-      description: "Run the CLI in dev mode"
-    },
-    cwd: {
-      type: "string",
-      description: "The working directory to run the CLI in"
-    },
-    files: {
-      type: "positional",
-      description: `'auto' or path(s) to line references file(s)`,
-      default: "auto"
-    },
-    comment: {
-      type: "string",
-      description: "Override the comment line to insert. Default is `// @ts-expect-error TODO: fix ts`"
-    },
-    tscPaths: {
-      type: "string",
-      description: "Optional: specify path(s) to restrict TSC processing (only effective when using 'auto')"
-    }
-  }),
-  async run({ args }) {
-    if (args.dev) {
-      relinka("verbose", "Using dev mode");
-    }
-    let pathsTsc = args.tscPaths;
-    if (pathsTsc === void 0 && args.files === "auto") {
-      pathsTsc = "./tsconfig.json";
-    }
-    await useTsExpectError({
-      files: [args.files],
-      comment: args.comment,
-      tscPaths: [pathsTsc]
-    });
-  }
-});

package/bin/app/{spell → magic}/cmd.d.ts

@@ -11,10 +11,12 @@ declare const _default: import("@reliverse/rempts").Command<{
     concurrency: {
         type: "number";
         description: string;
+        default: number;
     };
     batchSize: {
         type: "number";
         description: string;
+        default: number;
     };
     stopOnError: {
         type: "boolean";

package/bin/app/magic/cmd.js

@@ -0,0 +1,101 @@
+import { defineArgs, defineCommand } from "@reliverse/rempts";
+import { applyMagicSpells } from "../../libs/sdk/sdk-impl/magic/apply.js";
+import { formatError } from "../../libs/sdk/sdk-impl/utils/utils-error-cwd.js";
+export default defineCommand({
+  meta: {
+    name: "magic",
+    version: "1.0.0",
+    description: `Apply magic directives to files.
+Target Types:
+1. Distribution Targets (dist-*):
+   - dist-npm: Process files in dist-npm/bin
+   - dist-jsr: Process files in dist-jsr/bin
+   - dist-libs: Process all libraries in dist-libs
+   - dist-libs/<lib>: Process specific library (e.g., dist-libs/sdk)
+   For dist-* targets, magic directives are first searched in src/ directory,
+   then applied to corresponding files in the distribution directories.
+2. Custom Targets:
+   - Any directory name that is not dist-* (e.g., "my-output", "custom-build")
+   For custom targets, magic directives are processed directly in the target files.
+   No source directory scanning is performed.
+Examples:
+  # Process all distribution targets
+  dler magic dist-npm dist-jsr dist-libs
+  # Process specific library
+  dler magic dist-libs/sdk
+  # Process custom target
+  dler magic my-custom-output
+  # Mix distribution and custom targets
+  dler magic dist-npm my-custom-output`
+  },
+  args: defineArgs({
+    targets: {
+      type: "array",
+      description: `Targets to process. Can be:
+- Distribution targets: dist-npm, dist-jsr, dist-libs, dist-libs/<lib>
+- Custom targets: any directory name that is not dist-*`,
+      required: true
+    },
+    lib: {
+      type: "string",
+      description: "Library name to process (e.g., sdk, cfg). Only valid with dist-libs target."
+    },
+    concurrency: {
+      type: "number",
+      description: "Number of files to process in parallel (default: 4)",
+      default: 4
+    },
+    batchSize: {
+      type: "number",
+      description: "Number of files to process in each batch (default: 100)",
+      default: 100
+    },
+    stopOnError: {
+      type: "boolean",
+      description: "Stop processing on first error (default: true)",
+      default: true
+    }
+  }),
+  async run({ args }) {
+    const { targets, lib, concurrency, batchSize, stopOnError } = args;
+    if (lib) {
+      if (!targets?.includes("dist-libs")) {
+        throw new Error(
+          "The 'lib' parameter can only be used with 'dist-libs' target. Example: dler magic dist-libs/sdk"
+        );
+      }
+      if (targets.some((t) => t.startsWith("dist-libs/") && t !== `dist-libs/${lib}`)) {
+        throw new Error(
+          "Cannot specify both 'lib' parameter and dist-libs/<lib> in targets. Use one or the other."
+        );
+      }
+    }
+    try {
+      const finalTargets = targets?.map(
+        (target) => target === "dist-libs" && lib ? `${target}/${lib}` : target
+      ) ?? [];
+      const distTargets = finalTargets.filter((t) => t.startsWith("dist-"));
+      const customTargets = finalTargets.filter((t) => !t.startsWith("dist-"));
+      if (distTargets.length > 0) {
+        console.log("\nProcessing distribution targets:");
+        for (const target of distTargets) {
+          console.log(`  - ${target} (will scan src/ for magic directives)`);
+        }
+      }
+      if (customTargets.length > 0) {
+        console.log("\nProcessing custom targets:");
+        for (const target of customTargets) {
+          console.log(`  - ${target} (will process magic directives directly in target files)`);
+        }
+      }
+      await applyMagicSpells(finalTargets, {
+        concurrency,
+        batchSize,
+        stopOnError
+      });
+      console.log("\n\u2728 Magic spells applied successfully!");
+    } catch (error) {
+      throw new Error(`\u274C Processing failed: ${formatError(error)}`);
+    }
+  }
+});

package/bin/app/pub/impl.js

@@ -4,8 +4,8 @@ import fs from "@reliverse/relifso";
 import { relinka } from "@reliverse/relinka";
 import { getConfigDler } from "../../libs/sdk/sdk-impl/config/load.js";
 import { processLibraryFlow } from "../../libs/sdk/sdk-impl/library-flow.js";
+import { applyMagicSpells } from "../../libs/sdk/sdk-impl/magic/apply.js";
 import { processRegularFlow } from "../../libs/sdk/sdk-impl/regular-flow.js";
-import { applyMagicSpells } from "../../libs/sdk/sdk-impl/spell/applyMagicSpells.js";
 import { finalizeBuildPub } from "../../libs/sdk/sdk-impl/utils/finalize.js";
 import { resolveAllCrossLibs } from "../../libs/sdk/sdk-impl/utils/resolve-cross-libs.js";
 import { removeDistFolders } from "../../libs/sdk/sdk-impl/utils/utils-clean.js";
@@ -45,7 +45,9 @@ export async function dlerPub(isDev, config) {
     await processRegularFlow(timer, isDev, effectiveConfig);
     await processLibraryFlow(timer, isDev, effectiveConfig);
     await resolveAllCrossLibs();
-    await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
+    if (isDev) {
+      await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
+    }
     relinka("log", "[processDistDirectory] dist-npm");
     await processDistDirectory("dist-npm", "~");
     relinka("log", "[processDistDirectory] dist-jsr");

package/bin/libs/cfg/cfg-mod.d.ts

@@ -10,7 +10,7 @@ export { DEFAULT_CONFIG_RSE, PROJECT_FRAMEWORK_FILES } from "./rse/rse-impl/rse-
 export { defineConfigRse } from "./rse/rse-impl/rse-define.js";
 export { detectProjectFramework, getPackageJson, getPackageJsonSafe, detectProject, detectProjectsWithRseConfig, detectFeatures, } from "./rse/rse-impl/rse-detect.js";
 export { generateConfigFiles, generateProjectConfigs } from "./rse/rse-impl/rse-gen-cfg.js";
-export { injectSectionComments } from "./rse/rse-impl/rse-inject.js";
+export { injectSectionComments } from "./rse/rse-impl/rse-comments.js";
 export { migrateRseConfig } from "./rse/rse-impl/rse-migrate.js";
 export { getRseConfigPath } from "./rse/rse-impl/rse-path.js";
 export { askRseConfigType } from "./rse/rse-impl/rse-prompts.js";

package/bin/libs/cfg/cfg-mod.js

@@ -49,7 +49,7 @@ export {
   detectFeatures
 } from "./rse/rse-impl/rse-detect.js";
 export { generateConfigFiles, generateProjectConfigs } from "./rse/rse-impl/rse-gen-cfg.js";
-export { injectSectionComments } from "./rse/rse-impl/rse-inject.js";
+export { injectSectionComments } from "./rse/rse-impl/rse-comments.js";
 export { migrateRseConfig } from "./rse/rse-impl/rse-migrate.js";
 export { getRseConfigPath } from "./rse/rse-impl/rse-path.js";
 export { askRseConfigType } from "./rse/rse-impl/rse-prompts.js";

package/bin/libs/cfg/rse/rse-impl/rse-create.js

@@ -5,12 +5,12 @@ import { confirmPrompt } from "@reliverse/rempts";
 import { Value } from "@sinclair/typebox/value";
 import { execaCommand } from "execa";
 import { addDevDependency } from "nypm";
+import { injectSectionComments } from "./rse-comments.js";
 import { cliDomainDocs } from "./rse-consts.js";
 import { UNKNOWN_VALUE, rseName, DEFAULT_DOMAIN, RSE_SCHEMA_DEV } from "./rse-consts.js";
 import { generateDefaultRulesForProject, getDefaultRseConfig } from "./rse-def-utils.js";
 import { DEFAULT_CONFIG_RSE } from "./rse-default.js";
 import { getPackageJson, detectFeatures } from "./rse-detect.js";
-import { injectSectionComments } from "./rse-inject.js";
 import { getRseConfigPath } from "./rse-path.js";
 import { readRseConfig } from "./rse-read.js";
 import { rseSchema } from "./rse-schema.js";

package/bin/libs/cfg/rse/rse-impl/rse-define.d.ts

@@ -1,20 +1,20 @@
 import type { RseConfig } from "./rse-types";
 export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
-    version?: string | undefined;
     $schema?: "./schema.json" | "https://reliverse.org/schema.json" | undefined;
     projectName?: string | undefined;
     projectAuthor?: string | undefined;
     projectDescription?: string | undefined;
+    version?: string | undefined;
     projectLicense?: string | undefined;
     projectRepository?: string | undefined;
     projectDomain?: string | undefined;
     projectGitService?: "none" | "github" | "gitlab" | "bitbucket" | undefined;
     projectDeployService?: "none" | "vercel" | "netlify" | "railway" | "deno" | undefined;
-    projectPackageManager?: "pnpm" | "bun" | "npm" | "yarn" | undefined;
-    projectState?: "creating" | "created" | undefined;
-    projectCategory?: "cli" | "unknown" | "website" | "vscode" | "browser" | "library" | "mobile" | undefined;
+    projectPackageManager?: "npm" | "bun" | "pnpm" | "yarn" | undefined;
+    projectState?: "created" | "creating" | undefined;
+    projectCategory?: "browser" | "cli" | "unknown" | "website" | "vscode" | "library" | "mobile" | undefined;
     projectSubcategory?: "unknown" | "e-commerce" | "tool" | undefined;
-    projectFramework?: "unknown" | "vscode" | "nextjs" | "vite" | "svelte" | "remix" | "astro" | "nuxt" | "solid" | "qwik" | "vue" | "wxt" | "lynx" | "react-native" | "expo" | "capacitor" | "ionic" | "electron" | "tauri" | "neutralino" | "rempts" | "citty" | "commander" | "cac" | "meow" | "yargs" | "webextension" | "browser-extension" | "npm-jsr" | undefined;
+    projectFramework?: "rempts" | "npm-jsr" | "unknown" | "vscode" | "nextjs" | "vite" | "svelte" | "remix" | "astro" | "nuxt" | "solid" | "qwik" | "vue" | "wxt" | "lynx" | "react-native" | "expo" | "capacitor" | "ionic" | "electron" | "tauri" | "neutralino" | "citty" | "commander" | "cac" | "meow" | "yargs" | "webextension" | "browser-extension" | undefined;
     projectTemplate?: "unknown" | "blefnk/relivator-nextjs-template" | "blefnk/relivator-docker-template" | "blefnk/next-react-ts-src-minimal" | "blefnk/all-in-one-nextjs-template" | "blefnk/create-t3-app" | "blefnk/create-next-app" | "blefnk/astro-starlight-template" | "blefnk/versator-nextjs-template" | "blefnk/relivator-lynxjs-template" | "blefnk/relivator-react-native-template" | "reliverse/template-browser-extension" | "microsoft/vscode-extension-samples" | "microsoft/vscode-extension-template" | "rsetarter-template" | "blefnk/deno-cli-tutorial" | undefined;
     projectTemplateDate?: string | undefined;
     features?: {
@@ -33,18 +33,17 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         themes?: string[] | undefined;
     } | undefined;
     preferredLibraries?: {
-        search?: "unknown" | "algolia" | undefined;
         i18n?: "unknown" | "next-intl" | undefined;
         analytics?: "unknown" | "vercel" | undefined;
         authentication?: "unknown" | "better-auth" | "clerk" | "next-auth" | "supabase-auth" | "auth0" | undefined;
         api?: "unknown" | "hono" | "trpc" | "graphql" | "rest" | undefined;
-        testing?: "unknown" | "bun" | "vitest" | "jest" | "playwright" | "cypress" | undefined;
+        testing?: "bun" | "unknown" | "vitest" | "jest" | "playwright" | "cypress" | undefined;
         stateManagement?: "unknown" | "zustand" | "jotai" | "redux-toolkit" | undefined;
         formManagement?: "unknown" | "react-hook-form" | "formik" | undefined;
         styling?: "unknown" | "tailwind" | "styled-components" | "css-modules" | "sass" | undefined;
         uiComponents?: "unknown" | "shadcn-ui" | "chakra-ui" | "material-ui" | undefined;
         databaseLibrary?: "unknown" | "drizzle" | "prisma" | "supabase" | undefined;
-        databaseProvider?: "unknown" | "pg" | "mysql" | "sqlite" | "mongodb" | undefined;
+        databaseProvider?: "sqlite" | "unknown" | "pg" | "mysql" | "mongodb" | undefined;
         linting?: "unknown" | "eslint" | undefined;
         formatting?: "unknown" | "biome" | undefined;
         payment?: "unknown" | "stripe" | undefined;
@@ -52,6 +51,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         logging?: "unknown" | "axiom" | undefined;
         forms?: "unknown" | "react-hook-form" | undefined;
         notifications?: "unknown" | "sonner" | undefined;
+        search?: "unknown" | "algolia" | undefined;
         uploads?: "unknown" | "uploadthing" | undefined;
         validation?: "unknown" | "zod" | "typebox" | "valibot" | undefined;
         documentation?: "unknown" | "starlight" | "nextra" | undefined;
@@ -75,7 +75,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         indentStyle?: "space" | "tab" | undefined;
         quoteMark?: "single" | "double" | undefined;
         semicolons?: boolean | undefined;
-        trailingComma?: "all" | "none" | "es5" | undefined;
+        trailingComma?: "none" | "es5" | "all" | undefined;
         bracketSpacing?: boolean | undefined;
         arrowParens?: "always" | "avoid" | undefined;
         tabWidth?: number | undefined;
@@ -83,7 +83,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         dontRemoveComments?: boolean | undefined;
         shouldAddComments?: boolean | undefined;
         typeOrInterface?: "type" | "interface" | "mixed" | undefined;
-        importOrRequire?: "import" | "mixed" | "require" | undefined;
+        importOrRequire?: "mixed" | "import" | "require" | undefined;
         cjsToEsm?: boolean | undefined;
         modernize?: {
             replaceFs?: boolean | undefined;
@@ -96,7 +96,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
         importSymbol?: string | undefined;
     } | undefined;
     monorepo?: {
-        type?: "none" | "turborepo" | "nx" | "pnpm" | "bun" | undefined;
+        type?: "bun" | "none" | "turborepo" | "nx" | "pnpm" | undefined;
         packages?: string[] | undefined;
         sharedPackages?: string[] | undefined;
     } | undefined;
@@ -113,7 +113,7 @@ export declare const defineConfigRse: (userConfig?: Partial<RseConfig>) => {
     repoBranch?: string | undefined;
     repoPrivacy?: "unknown" | "public" | "private" | undefined;
     projectArchitecture?: "unknown" | "fullstack" | "separated" | undefined;
-    projectRuntime?: "bun" | "deno" | "node" | undefined;
+    projectRuntime?: "bun" | "node" | "deno" | undefined;
     skipPromptsUseAutoBehavior?: boolean | undefined;
     deployBehavior?: "prompt" | "autoYes" | "autoNo" | undefined;
     depsBehavior?: "prompt" | "autoYes" | "autoNo" | undefined;

package/bin/libs/cfg/rse/rse-mod.d.ts

@@ -8,7 +8,7 @@ export * from "./rse-impl/rse-default";
 export * from "./rse-impl/rse-define";
 export * from "./rse-impl/rse-detect";
 export * from "./rse-impl/rse-gen-cfg";
-export * from "./rse-impl/rse-inject";
+export * from "./rse-impl/rse-comments";
 export * from "./rse-impl/rse-migrate";
 export * from "./rse-impl/rse-path";
 export * from "./rse-impl/rse-prompts";

package/bin/libs/cfg/rse/rse-mod.js

@@ -8,7 +8,7 @@ export * from "./rse-impl/rse-default.js";
 export * from "./rse-impl/rse-define.js";
 export * from "./rse-impl/rse-detect.js";
 export * from "./rse-impl/rse-gen-cfg.js";
-export * from "./rse-impl/rse-inject.js";
+export * from "./rse-impl/rse-comments.js";
 export * from "./rse-impl/rse-migrate.js";
 export * from "./rse-impl/rse-path.js";
 export * from "./rse-impl/rse-prompts.js";

package/bin/libs/sdk/sdk-impl/cmds/inject/inject-impl-mod.d.ts

@@ -0,0 +1,63 @@
+/**
+ * inject-impl-mod.ts
+ * -----------
+ * Utility for injecting content into files at specific line/column positions.
+ *
+ * Fully async -– works with Node, Bun, and other
+ * runtimes that support the `fs/promises` API.
+ *
+ * @author blefnk
+ */
+export interface InjectionConfig {
+    /** Absolute or relative path to target file. */
+    filePath: string;
+    /** 1-based line number (1 == first visible line in editors) */
+    line: number;
+    /** 1-based column number (1 == first visible column in editors) */
+    column?: number;
+    /** String or array of strings to inject. */
+    content: string | string[];
+    /** If `true`, inserts string (or first element of array) content on a new line AFTER the target line. */
+    createNewLine?: boolean;
+    /** Configuration for comment wrapping. */
+    commentsMode?: {
+        /** Whether to wrap content in comments. */
+        activate: boolean;
+        /** Whether to use JSDoc style for multiline comments. */
+        useJsdocForMultiline?: boolean;
+    };
+}
+export interface InjectionResult {
+    /** Absolute or relative path to target file. */
+    filePath: string;
+    /** Whether the injection was successful. */
+    success: boolean;
+    /** Error message if injection failed. */
+    error?: string;
+    /** Generated source map if available. */
+    sourcemap?: string;
+}
+/**
+ * Injects content into the given file at the requested location.
+ *
+ * @param filePath       Absolute or relative path to target file.
+ * @param line           1-based line number (1 == first visible line in editors, internally == 0).
+ * @param column         1-based column number (optional, 1 == first visible column in editors, internally == 0).
+ * @param content        String or array of strings to inject.
+ * @param createNewLine  If `true`, inserts string (or first element of array) content on a new line AFTER the target line.
+ * @param commentsMode   If `true`, wraps injected content in file-type comments.
+ * @param generateSourceMap If `true`, generates a source map for the transformation.
+ *
+ * @returns `true` on success, `false` on failure (errors are logged).
+ */
+export declare function injectAtLocation(filePath: string, line: number, column: number | undefined, content: string | string[], createNewLine?: boolean, commentsMode?: {
+    activate: boolean;
+}, generateSourceMap?: boolean): Promise<boolean>;
+/**
+ * Processes multiple injections efficiently by grouping by file and applying in reverse order.
+ *
+ * @param configs Array of {@link InjectionConfig}.
+ * @param generateSourceMaps If `true`, generates source maps for transformations.
+ * @returns Array of {@link InjectionResult} in the same order as `configs`.
+ */
+export declare function injectMultiple(configs: InjectionConfig[], generateSourceMaps?: boolean): Promise<InjectionResult[]>;