@reliverse/relinka 1.4.7 → 1.5.0

package/README.md

@@ -69,6 +69,10 @@ export async function main() {
     "verbose",
     "This SYNC verbose message can be seen only if verbose=true (in user config) AND config was loaded ",
   );
+  // --- BOX LEVEL EXAMPLES ---
+  relinka("box", "This is a boxed message using direct syntax!");
+  relinka.box("This is a boxed message using method syntax!");
+  // --- LOG LEVEL EXAMPLES ---
   relinka("log", "Hello! 👋");
   relinka("log", "Great to see you here!");
   relinka("info", "Everything is running smoothly");

package/bin/alias.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Alias exports for the relinka logger
+ * Provides convenient aliases for common logging needs
+ */
+import { relinka } from "./impl.js";
+export { relinka as log, relinka as logger };
+export declare function message(msg: string, ...args: unknown[]): void;
+export declare function step(msg: string, ...args: unknown[]): void;

package/bin/alias.js

@@ -0,0 +1,8 @@
+import { relinka } from "./impl.js";
+export { relinka as log, relinka as logger };
+export function message(msg, ...args) {
+  relinka.log(msg, ...args);
+}
+export function step(msg, ...args) {
+  relinka.step(msg, ...args);
+}

package/bin/impl.d.ts

@@ -34,7 +34,7 @@ export type LogLevelConfig = {
 /** Configuration for all log levels. */
 export type LogLevelsConfig = Partial<Record<LogLevel, LogLevelConfig>>;
 /** Log level types used by the logger. */
-export type LogLevel = "error" | "fatal" | "info" | "success" | "verbose" | "warn" | "log" | "internal" | "null";
+export type LogLevel = "error" | "fatal" | "info" | "success" | "verbose" | "warn" | "log" | "internal" | "null" | "step" | "box";
 /**
  * Configuration options for the Relinka logger.
  * All properties are optional to allow for partial configuration.
@@ -131,11 +131,33 @@ export declare function truncateString(msg: string, maxLength?: number): string;
  * Exhaustiveness check. If we land here, we missed a union case.
  */
 export declare function casesHandled(unexpectedCase: never): never;
+/**
+ * Enhanced relinka function type that supports both traditional and method syntax
+ */
+export type RelinkaFunction = {
+    (type: LogLevel | "clear", message: string, ...args: unknown[]): undefined | never;
+    error(message: string, ...args: unknown[]): void;
+    fatal(message: string, ...args: unknown[]): never;
+    info(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+    verbose(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    log(message: string, ...args: unknown[]): void;
+    internal(message: string, ...args: unknown[]): void;
+    null(message: string, ...args: unknown[]): void;
+    step(message: string, ...args: unknown[]): void;
+    box(message: string, ...args: unknown[]): void;
+    clear(): void;
+};
 /**
  * Logs a message synchronously using the current config.
  * If type === "fatal", logs a fatal error and throws (never returns).
+ *
+ * Can be used in two ways:
+ * - relinka("level", message, ...args) - traditional syntax
+ * - relinka.level(message, ...args) - method syntax
  */
-export declare function relinka(type: LogLevel | "clear", message: string, ...args: unknown[]): undefined | never;
+export declare const relinka: RelinkaFunction;
 /**
  * Logs a message asynchronously, waiting for the config to be fully loaded.
  * If type === "fatal", logs a fatal error and throws (never returns).
@@ -145,3 +167,7 @@ export declare function relinkaAsync(type: LogLevel, message: string, ...args: u
  * Type helper for user config files.
  */
 export declare function defineConfig(config: Partial<RelinkaConfig>): Partial<RelinkaConfig>;
+/**
+ * Simple box formatting function
+ */
+export declare function formatBox(text: string): string;

package/bin/impl.js

@@ -74,6 +74,18 @@ const DEFAULT_RELINKA_CONFIG = {
       spacing: 3
     },
     log: { symbol: "\u2502", fallbackSymbol: "|", color: "dim", spacing: 3 },
+    step: {
+      symbol: "\u2192",
+      fallbackSymbol: "[STEP]",
+      color: "blueBright",
+      spacing: 3
+    },
+    box: {
+      symbol: "\u25A0",
+      fallbackSymbol: "[BOX]",
+      color: "whiteBright",
+      spacing: 1
+    },
     null: { symbol: "", fallbackSymbol: "", color: "dim", spacing: 0 }
   }
 };
@@ -84,7 +96,7 @@ function isUnicodeSupported() {
   if (process.platform === "win32") {
     const osRelease = os.release();
     const match = /(\d+)\.(\d+)/.exec(osRelease);
-    if (match && Number.parseInt(match[1], 10) >= 10) {
+    if (match && Number.parseInt(match[1] ?? "0", 10) >= 10) {
       return true;
     }
     if (process.env.TERM_PROGRAM === "mintty") {
@@ -170,34 +182,34 @@ initializeConfig().catch((err) => {
   }
 });
 function isVerboseEnabled(config) {
-  return config.verbose ?? DEFAULT_RELINKA_CONFIG.verbose;
+  return config.verbose ?? DEFAULT_RELINKA_CONFIG.verbose ?? false;
 }
 function isColorEnabled(config) {
   return !(config.disableColors ?? DEFAULT_RELINKA_CONFIG.disableColors);
 }
 function getLogDir(config) {
-  return config.dirs?.logDir ?? DEFAULT_RELINKA_CONFIG.dirs.logDir;
+  return config.dirs?.logDir ?? DEFAULT_RELINKA_CONFIG.dirs?.logDir ?? "logs";
 }
 function isDailyLogsEnabled(config) {
-  return config.dirs?.dailyLogs ?? DEFAULT_RELINKA_CONFIG.dirs.dailyLogs;
+  return config.dirs?.dailyLogs ?? DEFAULT_RELINKA_CONFIG.dirs?.dailyLogs ?? false;
 }
 function shouldSaveLogs(config) {
-  return config.saveLogsToFile ?? DEFAULT_RELINKA_CONFIG.saveLogsToFile;
+  return config.saveLogsToFile ?? DEFAULT_RELINKA_CONFIG.saveLogsToFile ?? false;
 }
 function getMaxLogFiles(config) {
-  return config.dirs?.maxLogFiles ?? DEFAULT_RELINKA_CONFIG.dirs.maxLogFiles;
+  return config.dirs?.maxLogFiles ?? DEFAULT_RELINKA_CONFIG.dirs?.maxLogFiles ?? 0;
 }
 function getBaseLogName(config) {
-  return config.logFilePath ?? DEFAULT_RELINKA_CONFIG.logFilePath;
+  return config.logFilePath ?? DEFAULT_RELINKA_CONFIG.logFilePath ?? "relinka.log";
 }
 function getBufferSize(config) {
-  return config.bufferSize ?? DEFAULT_RELINKA_CONFIG.bufferSize;
+  return config.bufferSize ?? DEFAULT_RELINKA_CONFIG.bufferSize ?? 4096;
 }
 function getMaxBufferAge(config) {
-  return config.maxBufferAge ?? DEFAULT_RELINKA_CONFIG.maxBufferAge;
+  return config.maxBufferAge ?? DEFAULT_RELINKA_CONFIG.maxBufferAge ?? 5e3;
 }
 function getCleanupInterval(config) {
-  return config.cleanupInterval ?? DEFAULT_RELINKA_CONFIG.cleanupInterval;
+  return config.cleanupInterval ?? DEFAULT_RELINKA_CONFIG.cleanupInterval ?? 1e4;
 }
 function isDevEnv() {
   return process.env.NODE_ENV === "development";
@@ -273,7 +285,11 @@ function formatLogMessage(config, level, msg, details) {
   const { symbol, spacing } = getLevelStyle(config, level);
   const symbolWithSpaces = symbol ? `${symbol}${" ".repeat(spacing)}` : "";
   const prefix = timestamp ? `[${timestamp}] ` : "";
-  return `${prefix}${symbolWithSpaces}${msg}${detailsStr}`;
+  let content = `${prefix}${symbolWithSpaces}${msg}${detailsStr}`;
+  if (level === "box") {
+    content = formatBox(content);
+  }
+  return content;
 }
 const consoleMethodMap = {
   error: console.error,
@@ -283,6 +299,8 @@ const consoleMethodMap = {
   success: console.log,
   verbose: console.log,
   log: console.log,
+  step: console.log,
+  box: console.log,
   null: console.log
 };
 function logToConsole(config, level, formattedMessage) {
@@ -526,7 +544,7 @@ function registerExitHandlers() {
   process.once("SIGTERM", sigtermHandler);
 }
 registerExitHandlers();
-export function relinka(type, message, ...args) {
+export const relinka = (type, message, ...args) => {
   if (type === "clear") {
     console.clear();
     return;
@@ -571,7 +589,19 @@ export function relinka(type, message, ...args) {
       });
     }
   }
-}
+};
+relinka.error = (message, ...args) => relinka("error", message, ...args);
+relinka.fatal = (message, ...args) => relinka("fatal", message, ...args);
+relinka.info = (message, ...args) => relinka("info", message, ...args);
+relinka.success = (message, ...args) => relinka("success", message, ...args);
+relinka.verbose = (message, ...args) => relinka("verbose", message, ...args);
+relinka.warn = (message, ...args) => relinka("warn", message, ...args);
+relinka.log = (message, ...args) => relinka("log", message, ...args);
+relinka.internal = (message, ...args) => 
+relinka.null = (message, ...args) => relinka("null", message, ...args);
+relinka.step = (message, ...args) => relinka("step", message, ...args);
+relinka.box = (message, ...args) => relinka("box", message, ...args);
+relinka.clear = () => relinka("clear", "");
 export async function relinkaAsync(type, message, ...args) {
   if (message === "") {
     console.log();
@@ -612,3 +642,17 @@ export async function relinkaAsync(type, message, ...args) {
 export function defineConfig(config) {
   return config;
 }
+export function formatBox(text) {
+  const lines = text.split("\n");
+  const maxWidth = Math.max(...lines.map((line) => line.length));
+  const width = maxWidth + 4;
+  const top = `\u250C${"\u2500".repeat(width)}\u2510`;
+  const bottom = `\u2514${"\u2500".repeat(width)}\u2518`;
+  const content = lines.map((line) => {
+    const padding = width - line.length;
+    return `\u2502  ${line}${" ".repeat(padding)}\u2502`;
+  }).join("\n");
+  return `${top}
+${content}
+${bottom}`;
+}

package/bin/mod.d.ts

@@ -1,2 +1,3 @@
-export type { RelinkaSpecialDirsConfig, RelinkaDirsConfig, LogLevelConfig, LogLevelsConfig, LogLevel, RelinkaConfig, LogFileInfo, } from "./impl.js";
-export { relinkaConfig, relinkaShutdown, flushAllLogBuffers, shouldNeverHappen, truncateString, casesHandled, relinka, relinkaAsync, defineConfig, } from "./impl.js";
+export { message, step, log, logger } from "./alias.js";
+export type { RelinkaSpecialDirsConfig, RelinkaDirsConfig, LogLevelConfig, LogLevelsConfig, LogLevel, RelinkaConfig, LogFileInfo, RelinkaFunction, } from "./impl.js";
+export { relinkaConfig, relinkaShutdown, flushAllLogBuffers, shouldNeverHappen, truncateString, casesHandled, relinka, relinkaAsync, defineConfig, formatBox, } from "./impl.js";

package/bin/mod.js

@@ -1,3 +1,4 @@
+export { message, step, log, logger } from "./alias.js";
 export {
   relinkaConfig,
   relinkaShutdown,
@@ -7,5 +8,6 @@ export {
   casesHandled,
   relinka,
   relinkaAsync,
-  defineConfig
+  defineConfig,
+  formatBox
 } from "./impl.js";

package/package.json

@@ -1,8 +1,8 @@
 {
   "dependencies": {
-    "@reliverse/pathkit": "^1.1.5",
+    "@reliverse/pathkit": "^1.3.4",
     "@reliverse/relico": "^1.1.2",
-    "@reliverse/relifso": "^1.2.10",
+    "@reliverse/relifso": "^1.4.5",
     "c12": "^3.0.4"
   },
   "description": "@reliverse/relinka is a modern, minimal logging library that actually feels right. It's not just pretty output — it's a system: smart formatting, file-safe logging, runtime config support, and a fatal mode built for developers who care about correctness.",
@@ -10,7 +10,7 @@
   "license": "MIT",
   "name": "@reliverse/relinka",
   "type": "module",
-  "version": "1.4.7",
+  "version": "1.5.0",
   "keywords": [
     "logger",
     "consola",
@@ -27,31 +27,7 @@
     "unified",
     "universal"
   ],
-  "devDependencies": {
-    "@biomejs/biome": "1.9.4",
-    "@eslint/js": "^9.27.0",
-    "@reliverse/dler": "^1.4.6",
-    "@reliverse/repris": "^1.0.0",
-    "@reliverse/runtime": "^1.0.3",
-    "@stylistic/eslint-plugin": "^4.2.0",
-    "@total-typescript/ts-reset": "^0.6.1",
-    "@types/bun": "^1.2.14",
-    "@types/node": "^22.15.21",
-    "@types/sentencer": "^0.2.3",
-    "defu": "^6.1.4",
-    "eslint": "^9.27.0",
-    "eslint-plugin-no-relative-import-paths": "^1.6.1",
-    "eslint-plugin-perfectionist": "^4.13.0",
-    "jiti": "^2.4.2",
-    "knip": "^5.57.2",
-    "pathe": "^2.0.3",
-    "sentencer": "^0.2.1",
-    "std-env": "^3.9.0",
-    "string-width": "^7.2.0",
-    "tsx": "^4.19.4",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1"
-  },
+  "devDependencies": {},
   "exports": {
     ".": "./bin/mod.js"
   },