@reliverse/dler 1.7.86 → 1.7.87

package/README.md

@@ -2,7 +2,7 @@
 
 [sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/pb8ukbwpsj) — [github](https://github.com/reliverse/dler) — [npm](https://npmjs.com/@reliverse/dler)
 
-> @reliverse/dler (formerly relidler; `/ˈdiː.lər/`, dealer) is a unified package manager for typescript/javascript projects.
+> @reliverse/dler (formerly relidler; `/ˈdiː.lər/`, dealer) is both a unified package manager for typescript/javascript projects and a flexible framework for creating, building, and publishing js/ts libraries to npm and jsr.
 >
 > dler is your package manager’s best friend — it extends bun, deno (🔜), pnpm, yarn, and npm with powerful and modern features.
 >

package/bin/libs/cfg/cfg-impl/cfg-dler.d.ts

@@ -1,3 +1,111 @@
+/** Configuration for directory-related settings. */
+export interface RelinkaDirsConfig {
+    maxLogFiles?: number;
+}
+/** Log level types used by the logger. */
+export type LogLevel = "error" | "fatal" | "info" | "success" | "verbose" | "warn" | "log" | "internal" | "null" | "step" | "box" | "message";
+/** Configuration for a single log level. */
+export interface LogLevelConfig {
+    /**
+     * Symbol to display for this log level.
+     * @see https://symbl.cc
+     */
+    symbol: string;
+    /**
+     * Fallback symbol to use if Unicode is not supported.
+     */
+    fallbackSymbol: string;
+    /**
+     * Color to use for this log level.
+     */
+    color: string;
+    /**
+     * Number of spaces after the symbol/fallback
+     */
+    spacing?: number;
+}
+/** Configuration for all log levels. */
+export type LogLevelsConfig = Partial<Record<LogLevel, LogLevelConfig>>;
+/**
+ * Configuration options for the Relinka logger.
+ * All properties are optional to allow for partial configuration.
+ * Defaults will be applied during initialization.
+ */
+export interface RelinkaConfig {
+    /**
+     * Enables verbose (aka debug) mode for detailed logging.
+     *
+     * `true` here works only for end-users of CLIs/libs when theirs developers
+     * has been awaited for user's config via `@reliverse/relinka`'s `await relinkaConfig;`
+     */
+    verbose?: boolean;
+    /**
+     * Configuration for directory-related settings.
+     * - `maxLogFiles`: The maximum number of log files to keep before cleanup.
+     */
+    dirs?: RelinkaDirsConfig;
+    /**
+     * Disables color output in the console.
+     */
+    disableColors?: boolean;
+    /**
+     * Configuration for log file output.
+     */
+    logFile?: {
+        /**
+         * Path to the log file.
+         */
+        outputPath?: string;
+        /**
+         * How to handle date in the filename.
+         * - `disable`: No date prefix/suffix
+         * - `append-before`: Add date before the filename (e.g., "2024-01-15-log.txt")
+         * - `append-after`: Add date after the filename (e.g., "log-2024-01-15.txt")
+         */
+        nameWithDate?: "disable" | "append-before" | "append-after";
+        /**
+         * If true, clears the log file when relinkaConfig is executed with supportFreshLogFile: true.
+         * This is useful for starting with a clean log file on each run.
+         */
+        freshLogFile?: boolean;
+    };
+    /**
+     * If true, logs will be saved to a file.
+     */
+    saveLogsToFile?: boolean;
+    /**
+     * Configuration for timestamp in log messages.
+     */
+    timestamp?: {
+        /**
+         * If true, timestamps will be added to log messages.
+         */
+        enabled: boolean;
+        /**
+         * The format for timestamps. Default is YYYY-MM-DD HH:mm:ss.SSS
+         */
+        format?: string;
+    };
+    /**
+     * Allows to customize the log levels.
+     */
+    levels?: LogLevelsConfig;
+    /**
+     * Controls how often the log cleanup runs (in milliseconds)
+     * Default: 10000 (10 seconds)
+     */
+    cleanupInterval?: number;
+    /**
+     * Maximum size of the log write buffer before flushing to disk (in bytes)
+     * Default: 4096 (4KB)
+     */
+    bufferSize?: number;
+    /**
+     * Maximum time to hold logs in buffer before flushing to disk (in milliseconds)
+     * Default: 5000 (5 seconds)
+     */
+    maxBufferAge?: number;
+}
 /**
  * Defines the configuration for building and publishing packages. This includes: versioning,
  * build settings, publishing options, libraries-dler-plugin built-in plugin, and more.
@@ -504,6 +612,13 @@ export interface DlerConfig {
      * @default "templates"
      */
     buildTemplatesDir: string;
+    /**
+     * Integrated relinka logger configuration.
+     * @see https://github.com/reliverse/relinka
+     *
+     * @default See DEFAULT_RELINKA_CONFIG in defaults
+     */
+    relinka: RelinkaConfig;
 }
 export type BumpMode = "patch" | "minor" | "major" | "auto" | "manual";
 /**
@@ -693,4 +808,5 @@ export declare const defineConfig: (userConfig?: Partial<DlerConfig>) => {
     };
     buildPreExtensions: string[];
     buildTemplatesDir: string;
+    relinka: RelinkaConfig;
 };

package/bin/libs/cfg/cfg-impl/cfg-dler.js

@@ -79,7 +79,82 @@ export const DEFAULT_CONFIG_DLER = {
   buildPreExtensions: ["ts", "js"],
   // If you need to exclude some ts/js files from being built,
   // you can store them in the dirs with buildTemplatesDir name
-  buildTemplatesDir: "templates"
+  buildTemplatesDir: "templates",
+  // Integrated relinka logger configuration
+  relinka: {
+    verbose: false,
+    dirs: {
+      maxLogFiles: 5
+    },
+    disableColors: false,
+    logFile: {
+      outputPath: "logs.log",
+      nameWithDate: "disable",
+      freshLogFile: true
+    },
+    saveLogsToFile: true,
+    timestamp: {
+      enabled: false,
+      format: "HH:mm:ss"
+    },
+    cleanupInterval: 1e4,
+    // 10 seconds
+    bufferSize: 4096,
+    // 4KB
+    maxBufferAge: 5e3,
+    // 5 seconds
+    levels: {
+      success: {
+        symbol: "\u2713",
+        fallbackSymbol: "[OK]",
+        color: "greenBright",
+        spacing: 3
+      },
+      info: {
+        symbol: "i",
+        fallbackSymbol: "[i]",
+        color: "cyanBright",
+        spacing: 3
+      },
+      error: {
+        symbol: "\u2716",
+        fallbackSymbol: "[ERR]",
+        color: "redBright",
+        spacing: 3
+      },
+      warn: {
+        symbol: "\u26A0",
+        fallbackSymbol: "[WARN]",
+        color: "yellowBright",
+        spacing: 3
+      },
+      fatal: {
+        symbol: "\u203C",
+        fallbackSymbol: "[FATAL]",
+        color: "redBright",
+        spacing: 3
+      },
+      verbose: {
+        symbol: "\u2727",
+        fallbackSymbol: "[VERBOSE]",
+        color: "gray",
+        spacing: 3
+      },
+      internal: {
+        symbol: "\u2699",
+        fallbackSymbol: "[INTERNAL]",
+        color: "magentaBright",
+        spacing: 3
+      },
+      log: { symbol: "\u2502", fallbackSymbol: "|", color: "dim", spacing: 3 },
+      message: {
+        symbol: "\u{1F7A0}",
+        fallbackSymbol: "[MSG]",
+        color: "cyan",
+        spacing: 3
+      }
+    }
+  }
 };
 export const defineConfig = (userConfig = {}) => {
   return { ...DEFAULT_CONFIG_DLER, ...userConfig };

package/bin/libs/sdk/sdk-impl/config/default.js

@@ -77,7 +77,82 @@ export const DEFAULT_CONFIG_DLER = {
   buildPreExtensions: ["ts", "js"],
   // If you need to exclude some ts/js files from being built,
   // you can store them in the dirs with buildTemplatesDir name
-  buildTemplatesDir: "templates"
+  buildTemplatesDir: "templates",
+  // Integrated relinka logger configuration
+  relinka: {
+    verbose: false,
+    dirs: {
+      maxLogFiles: 5
+    },
+    disableColors: false,
+    logFile: {
+      outputPath: "logs.log",
+      nameWithDate: "disable",
+      freshLogFile: true
+    },
+    saveLogsToFile: true,
+    timestamp: {
+      enabled: false,
+      format: "HH:mm:ss"
+    },
+    cleanupInterval: 1e4,
+    // 10 seconds
+    bufferSize: 4096,
+    // 4KB
+    maxBufferAge: 5e3,
+    // 5 seconds
+    levels: {
+      success: {
+        symbol: "\u2713",
+        fallbackSymbol: "[OK]",
+        color: "greenBright",
+        spacing: 3
+      },
+      info: {
+        symbol: "i",
+        fallbackSymbol: "[i]",
+        color: "cyanBright",
+        spacing: 3
+      },
+      error: {
+        symbol: "\u2716",
+        fallbackSymbol: "[ERR]",
+        color: "redBright",
+        spacing: 3
+      },
+      warn: {
+        symbol: "\u26A0",
+        fallbackSymbol: "[WARN]",
+        color: "yellowBright",
+        spacing: 3
+      },
+      fatal: {
+        symbol: "\u203C",
+        fallbackSymbol: "[FATAL]",
+        color: "redBright",
+        spacing: 3
+      },
+      verbose: {
+        symbol: "\u2727",
+        fallbackSymbol: "[VERBOSE]",
+        color: "gray",
+        spacing: 3
+      },
+      internal: {
+        symbol: "\u2699",
+        fallbackSymbol: "[INTERNAL]",
+        color: "magentaBright",
+        spacing: 3
+      },
+      log: { symbol: "\u2502", fallbackSymbol: "|", color: "dim", spacing: 3 },
+      message: {
+        symbol: "\u{1F7A0}",
+        fallbackSymbol: "[MSG]",
+        color: "cyan",
+        spacing: 3
+      }
+    }
+  }
 };
 export const defineConfig = (userConfig = {}) => {
   return { ...DEFAULT_CONFIG_DLER, ...userConfig };

package/bin/libs/sdk/sdk-impl/config/info.js

@@ -1,5 +1,5 @@
 import { endPrompt, startPrompt } from "@reliverse/rempts";
-const version = "1.7.86";
+const version = "1.7.87";
 export async function showStartPrompt(isDev) {
   await startPrompt({
     titleColor: "inverse",

package/bin/libs/sdk/sdk-impl/config/types.d.ts

@@ -1,3 +1,111 @@
+/** Configuration for directory-related settings. */
+export interface RelinkaDirsConfig {
+    maxLogFiles?: number;
+}
+/** Log level types used by the logger. */
+export type LogLevel = "error" | "fatal" | "info" | "success" | "verbose" | "warn" | "log" | "internal" | "null" | "step" | "box" | "message";
+/** Configuration for a single log level. */
+export interface LogLevelConfig {
+    /**
+     * Symbol to display for this log level.
+     * @see https://symbl.cc
+     */
+    symbol: string;
+    /**
+     * Fallback symbol to use if Unicode is not supported.
+     */
+    fallbackSymbol: string;
+    /**
+     * Color to use for this log level.
+     */
+    color: string;
+    /**
+     * Number of spaces after the symbol/fallback
+     */
+    spacing?: number;
+}
+/** Configuration for all log levels. */
+export type LogLevelsConfig = Partial<Record<LogLevel, LogLevelConfig>>;
+/**
+ * Configuration options for the Relinka logger.
+ * All properties are optional to allow for partial configuration.
+ * Defaults will be applied during initialization.
+ */
+export interface RelinkaConfig {
+    /**
+     * Enables verbose (aka debug) mode for detailed logging.
+     *
+     * `true` here works only for end-users of CLIs/libs when theirs developers
+     * has been awaited for user's config via `@reliverse/relinka`'s `await relinkaConfig;`
+     */
+    verbose?: boolean;
+    /**
+     * Configuration for directory-related settings.
+     * - `maxLogFiles`: The maximum number of log files to keep before cleanup.
+     */
+    dirs?: RelinkaDirsConfig;
+    /**
+     * Disables color output in the console.
+     */
+    disableColors?: boolean;
+    /**
+     * Configuration for log file output.
+     */
+    logFile?: {
+        /**
+         * Path to the log file.
+         */
+        outputPath?: string;
+        /**
+         * How to handle date in the filename.
+         * - `disable`: No date prefix/suffix
+         * - `append-before`: Add date before the filename (e.g., "2024-01-15-log.txt")
+         * - `append-after`: Add date after the filename (e.g., "log-2024-01-15.txt")
+         */
+        nameWithDate?: "disable" | "append-before" | "append-after";
+        /**
+         * If true, clears the log file when relinkaConfig is executed with supportFreshLogFile: true.
+         * This is useful for starting with a clean log file on each run.
+         */
+        freshLogFile?: boolean;
+    };
+    /**
+     * If true, logs will be saved to a file.
+     */
+    saveLogsToFile?: boolean;
+    /**
+     * Configuration for timestamp in log messages.
+     */
+    timestamp?: {
+        /**
+         * If true, timestamps will be added to log messages.
+         */
+        enabled: boolean;
+        /**
+         * The format for timestamps. Default is YYYY-MM-DD HH:mm:ss.SSS
+         */
+        format?: string;
+    };
+    /**
+     * Allows to customize the log levels.
+     */
+    levels?: LogLevelsConfig;
+    /**
+     * Controls how often the log cleanup runs (in milliseconds)
+     * Default: 10000 (10 seconds)
+     */
+    cleanupInterval?: number;
+    /**
+     * Maximum size of the log write buffer before flushing to disk (in bytes)
+     * Default: 4096 (4KB)
+     */
+    bufferSize?: number;
+    /**
+     * Maximum time to hold logs in buffer before flushing to disk (in milliseconds)
+     * Default: 5000 (5 seconds)
+     */
+    maxBufferAge?: number;
+}
 /**
  * Defines the configuration for building and publishing packages. This includes: versioning,
  * build settings, publishing options, libraries-dler-plugin built-in plugin, and more.
@@ -504,6 +612,13 @@ export interface DlerConfig {
      * @default "templates"
      */
     buildTemplatesDir: string;
+    /**
+     * Integrated relinka logger configuration.
+     * @see https://github.com/reliverse/relinka
+     *
+     * @default See DEFAULT_RELINKA_CONFIG in defaults
+     */
+    relinka: RelinkaConfig;
 }
 export type BumpMode = "patch" | "minor" | "major" | "auto" | "manual";
 /**

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

@@ -42,7 +42,7 @@ export { DEFAULT_CONFIG_DLER, defineConfig } from "./sdk-impl/config/default.js"
 export { showStartPrompt, showEndPrompt } from "./sdk-impl/config/info.js";
 export { getConfigDler, getConfigBunfig } from "./sdk-impl/config/load.js";
 export { ensureDlerConfig, prepareDlerEnvironment } from "./sdk-impl/config/prepare.js";
-export type { DlerConfig, BumpMode, BundlerName, NpmOutExt, LibConfig, Esbuild, transpileFormat, Sourcemap, transpileTarget, } from "./sdk-impl/config/types.js";
+export type { DlerConfig, BumpMode, BundlerName, NpmOutExt, LibConfig, Esbuild, transpileFormat, Sourcemap, transpileTarget, RelinkaConfig, LogLevel, LogLevelConfig, LogLevelsConfig, RelinkaDirsConfig, } from "./sdk-impl/config/types.js";
 export { IGNORE_PATTERNS } from "./sdk-impl/constants.js";
 export { library_buildFlow, library_pubFlow, libraries_build, libraries_publish, } from "./sdk-impl/library-flow.js";
 export type { ApplyMagicSpellsOptions, ApplyMagicSpellsResult, FileWithSpells, } from "./sdk-impl/magic/magic-apply.js";

package/package.json

@@ -5,7 +5,7 @@
     "@reliverse/reglob": "^1.0.0",
     "@reliverse/relico": "^1.2.0",
     "@reliverse/relifso": "^1.4.5",
-    "@reliverse/relinka": "^1.5.3",
+    "@reliverse/relinka": "^1.5.4",
     "@reliverse/rempts": "^1.7.44",
     "@rollup/plugin-alias": "^5.1.1",
     "@rollup/plugin-commonjs": "^28.0.6",
@@ -52,7 +52,7 @@
   "license": "MIT",
   "name": "@reliverse/dler",
   "type": "module",
-  "version": "1.7.86",
+  "version": "1.7.87",
   "keywords": [
     "reliverse",
     "cli",