@reliverse/relinka 1.3.5 → 1.3.7

package/README.md

@@ -1,116 +1,154 @@
-# Relidler: Reliverse Bundler
+# Relinka: Stylish Logging Made Simple
 
 [💖 GitHub Sponsors](https://github.com/sponsors/blefnk) • [💬 Discord](https://discord.gg/Pb8uKbwpsJ) • [✨ Repo](https://github.com/reliverse/relinka-logger) • [📦 NPM](https://npmjs.com/@reliverse/relinka) • [📚 Docs](https://docs.reliverse.org)
 
-**@reliverse/relinka** is your next powerful logger, which allows you to style your terminal or browser console like never before.
+**@reliverse/relinka** is your next favorite logging library — built to make your terminal (and browser console — soon) output look good, stay clean, and be actually helpful. It’s styled, structured, and smart. Oh, and it works with configs, files, and colors out of the box.
 
-## Features
+## 🌟 Features
 
-- 😘 Drop-in replacement for `consola`
-- ⚡ `relinka` works via CLI and SDK
-- 📦 Automated NPM/JSR publishing
-- ✅ Ensures reliable JS/TS builds
-- 🔄 Handles automatic version bumps
-- 🔧 Eliminates `package.json` headaches
-- 🎯 Optimized for speed and modern workflows
-- 🛠️ Converts TypeScript aliases to relative paths
-- ✨ Packed with powerful features under the hood
-- 📝 Highly configurable flow via a configuration file
-- 🔌 Plugin system with one built-in plugin included
+- 🧙 Drop-in replacement for `node:console` and `consola`
+- 💬 `relinka` supports: `info`, `warn`, `success`, `error`, `verbose`
+- 🎨 Beautiful, color-coded logs in the terminal
+- 🧠 Auto-formats messages, objects, and errors
+- 📁 Save logs to file (with daily logs, cleanup, and rotation)
+- 📦 Use it programmatically or through CLI-compatible tools
+- ⚙️ Smart customization via config
+- ✨ Extensible and future-proof
 
-## Getting Started
+## 🚀 Getting Started
 
-Ensure [Git](https://git-scm.com/downloads), [Node.js](https://nodejs.org), and a package manager ([bun](https://bun.sh)/[pnpm](https://pnpm.io)/[yarn](https://yarnpkg.com)/[npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)) are installed. Then follow these steps:
+### 1. Install
 
-### Example Playground
+```bash
+bun add @reliverse/relinka
+```
+
+And, optionally, install the CLI globally to manage your config:
 
-Want to test Relinka before integrating it into your project? Clone the repo and launch the example:
+```bash
+bun i -g @reliverse/relinka-cli
+```
 
-```sh
-git clone https://github.com/reliverse/relinka-logger.git
-cd relinka-logger
-bun i
-bun dev # bun examples/e-main.ts
+### 2. Basic Usage
+
+```ts
+import { relinkaConfig, relinka } from "@reliverse/relinka";
+export async function main() {
+  await relinkaConfig;
+  relinka(
+    "verbose",
+    "This message can be seen only if config was loaded AND debug is enabled",
+  );
+  relinka("info", "Everything is running smoothly");
+  relinka("warn", "This might be a problem");
+  relinka("error", "Uh oh, something broke");
+  relinka("success", "Thanks for using Relinka! 👋");
+}
+await main();
 ```
 
-### Relidler Usage
+## 🧪 Advanced Usage
+
+Want a clean blank line?
 
-1. **Install globally**:
+```ts
+relinka("info", ""); // Just prints a newline
+```
 
-    ```sh
-    bun i -g @reliverse/relidler
-    ```
+🔜 Use the async logger if you want some advanced features (like typing text animation - soon):
 
-    **Or update as needed**:
+```ts
+import { relinkaAsync } from "@reliverse/relinka";
 
-    ```sh
-    bun -g update --latest
-    ```
+await relinkaAsync("info", "Something happened", { animate: true });
+```
 
-2. **Prepare your project**:
+## ⚙️ Configuration
+
+Create a `relinka.config.ts` file with a content like:
+
+```ts
+import { defineConfig } from "@reliverse/relinka";
+export default defineConfig({
+  // Enable debug to see verbose logs
+  debug: true,
+  // Show timestamp in each log message
+  withTimestamp: false,
+  // Control whether logs are saved to a file
+  saveLogsToFile: true,
+  // Disable colors in the console
+  disableColors: false,
+  // Log file path
+  logFilePath: "relinka.log",
+  // Directory settings
+  dirs: {
+    dailyLogs: true,
+    logDir: ".reliverse/logs", // store logs in a custom folder
+    maxLogFiles: 5, // keep only the 5 most recent log files
+    specialDirs: {
+      distDirNames: [],
+      useParentConfigInDist: true,
+    },
+  },
+});
+```
 
-    a. **Configure `.gitignore`**:
+Supported config file names:
 
-    ```sh
-    echo "*.log" >> .gitignore
-    echo "dist-npm" >> .gitignore
-    echo "dist-jsr" >> .gitignore
-    echo "dist-libs" >> .gitignore
-    ```
+- `relinka.config.ts`
+- 🔜 `.relinka.config.js`
+- 🔜 `.relinkarc`
+- 🔜 or any other supported by c12
 
-    b. **Install config intellisense**:
+## 📁 Log Files
 
-    ```sh
-    bun add -D @reliverse/relidler-cfg
-    ```
+- Stored in `.reliverse/logs/` by default
+- Filename: `relinka.log` or `YYYY-MM-DD-relinka.log` if daily logs are enabled
+- Auto-rotates based on `maxLogFiles`
 
-    c. **Initialize `relidler.cfg.ts`**:
+## 📚 API Summary
 
-    ```sh
-    relidler
-    ```
+### relinka(level, message, ...args)
 
-    - The `relidler.cfg.ts` file is created automatically on the first run.
-    - **It's recommended to customize this file according to your needs.**
-    - Supported names: `relidler.cfg.ts` • `relidler.config.ts` • `build.pub.ts` • `build.cfg.ts`.
+Logs synchronously. Skips debug logs if `debug: false`.
 
-3. **Run and enjoy**:
+### relinkaAsync(level, message, ...args)
 
-    ```sh
-    relidler
-    ```
+Async logger that waits for config automatically, and provides some additional advanced features.
 
-## Plugins & SDK
+### defineConfig(config)
 
-Relidler includes a plugin system, with the following official built-in plugin already available:
+Helper to define typed config in `relinka.config.ts`
 
-- **`libraries-relidler-plugin`**: Builds and publishes specified subdirectories of your main project as separate packages.
+## 🧰 Utilities
 
-### API (for advanced users)
+✅ Timestamping  
+✅ Log file rotation  
+✅ File-safe formatting  
+✅ ANSI color support  
+✅ Error object handling
 
-The SDK allows you to create new Relidler plugins and even extend your own CLI functionality.
+## 💡 Tips
 
-```sh
-bun add -D @reliverse/relidler-sdk
-```
+- Want `@ts-expect-error` auto-injection? Check out [`@reliverse/reinject`](https://npmjs.com/@reliverse/reinject).
+- Using this in a CLI tool? Combine with [`@reliverse/prompts`](https://npmjs.com/@reliverse/prompts).
 
-## TODO
+## ✅ TODO
 
-- [x] ~~Implement stable `regular` build and publish~~
-- [ ] Implement stable `library` build and publish
-- [ ] Allow to minify dist with comments preserved
-- [ ] Achieve full drop-in replacement for `unbuild`
-- [ ] Support auto migration from `build.config.ts`
-- [ ] Allow plugins to extend Relidler's `defineConfig`
-- [ ] Support configuration via `reliverse.{ts,jsonc}`
-- [ ] Make config file optional with sensible defaults
+- [x] File-based logging
+- [x] Timestamp support
+- [x] Daily logs
+- [x] Smart config
+- [x] Log rotation
+- [ ] CLI interface (optional)
+- [ ] Plugin support (custom formatters, log levels, etc)
 
-## Related
+## 🙌 Shoutout
 
-Kudos to the following project that made Relinka possible:
+Relinka was inspired by this gem:
 
 - [unjs/consola](https://github.com/unjs/consola#readme)
 
-## License
+## 📄 License
 
-🩷 [MIT](./LICENSE) © [blefnk Nazar Kornienko](https://github.com/blefnk)
+💖 MIT © [blefnk (Nazar Kornienko)](https://github.com/blefnk)

package/bin/main.d.ts

@@ -1 +1,22 @@
-export * from "./libs/core/core-main.js";
+export { LogLevelsDeprecated, LogTypesDeprecated, } from "./relinka-impl/deprecated/components/levels/levels.js";
+export { createRelinkaBaseDeprecated, relinkaBasicDeprecated, } from "./relinka-impl/deprecated/components/modes/basic.js";
+export { createRelinkaBrowserDeprecatedDeprecated, relinkaBrowserDeprecated, } from "./relinka-impl/deprecated/components/modes/browser.js";
+export { relinkaDeprecated } from "./relinka-impl/deprecated/components/relinka-deprecated/logger.js";
+export { createRelinkaSharedDeprecated, relinkaInstanceDeprecated, } from "./relinka-impl/deprecated/components/relinka-deprecated/mod.js";
+export type { LogFn, RelinkaInstanceDeprecated, } from "./relinka-impl/deprecated/components/relinka-deprecated/relinka.js";
+export { RelinkaInterface, createRelinkaDeprecated, } from "./relinka-impl/deprecated/components/relinka-deprecated/relinka.js";
+export { BasicReporter } from "./relinka-impl/deprecated/components/reporters/basic.js";
+export { BrowserReporter } from "./relinka-impl/deprecated/components/reporters/browser.js";
+export { TYPE_COLOR_MAP, LEVEL_COLOR_MAP, FancyReporter, } from "./relinka-impl/deprecated/components/reporters/fancy.js";
+export type { BoxBorderStyle, BoxStyle, BoxOpts, } from "./relinka-impl/deprecated/utils/box.js";
+export { box } from "./relinka-impl/deprecated/utils/box.js";
+export type { ColorName, ColorFunction, } from "./relinka-impl/deprecated/utils/deprecatedColors.js";
+export { colors, getColor, colorize, } from "./relinka-impl/deprecated/utils/deprecatedColors.js";
+export { parseStack } from "./relinka-impl/deprecated/utils/error.js";
+export { compileFormat, formatString, } from "./relinka-impl/deprecated/utils/format.js";
+export { isPlainObject, isLogObj, } from "./relinka-impl/deprecated/utils/log.js";
+export { writeStream } from "./relinka-impl/deprecated/utils/stream.js";
+export { stripAnsi, centerAlign, rightAlign, leftAlign, align, } from "./relinka-impl/deprecated/utils/string.js";
+export type { TreeItemObject, TreeItem, TreeOptions, } from "./relinka-impl/deprecated/utils/tree.js";
+export { formatTree } from "./relinka-impl/deprecated/utils/tree.js";
+export { relinkaConfig, relinka, relinkaAsync, defineConfig, } from "./relinka-impl/impl-mod.js";

package/bin/main.js

@@ -1 +1,58 @@
-export * from "./libs/core/core-main.js";
+export {
+  LogLevelsDeprecated,
+  LogTypesDeprecated
+} from "./relinka-impl/deprecated/components/levels/levels.js";
+export {
+  createRelinkaBaseDeprecated,
+  relinkaBasicDeprecated
+} from "./relinka-impl/deprecated/components/modes/basic.js";
+export {
+  createRelinkaBrowserDeprecatedDeprecated,
+  relinkaBrowserDeprecated
+} from "./relinka-impl/deprecated/components/modes/browser.js";
+export { relinkaDeprecated } from "./relinka-impl/deprecated/components/relinka-deprecated/logger.js";
+export {
+  createRelinkaSharedDeprecated,
+  relinkaInstanceDeprecated
+} from "./relinka-impl/deprecated/components/relinka-deprecated/mod.js";
+export {
+  RelinkaInterface,
+  createRelinkaDeprecated
+} from "./relinka-impl/deprecated/components/relinka-deprecated/relinka.js";
+export { BasicReporter } from "./relinka-impl/deprecated/components/reporters/basic.js";
+export { BrowserReporter } from "./relinka-impl/deprecated/components/reporters/browser.js";
+export {
+  TYPE_COLOR_MAP,
+  LEVEL_COLOR_MAP,
+  FancyReporter
+} from "./relinka-impl/deprecated/components/reporters/fancy.js";
+export { box } from "./relinka-impl/deprecated/utils/box.js";
+export {
+  colors,
+  getColor,
+  colorize
+} from "./relinka-impl/deprecated/utils/deprecatedColors.js";
+export { parseStack } from "./relinka-impl/deprecated/utils/error.js";
+export {
+  compileFormat,
+  formatString
+} from "./relinka-impl/deprecated/utils/format.js";
+export {
+  isPlainObject,
+  isLogObj
+} from "./relinka-impl/deprecated/utils/log.js";
+export { writeStream } from "./relinka-impl/deprecated/utils/stream.js";
+export {
+  stripAnsi,
+  centerAlign,
+  rightAlign,
+  leftAlign,
+  align
+} from "./relinka-impl/deprecated/utils/string.js";
+export { formatTree } from "./relinka-impl/deprecated/utils/tree.js";
+export {
+  relinkaConfig,
+  relinka,
+  relinkaAsync,
+  defineConfig
+} from "./relinka-impl/impl-mod.js";

package/bin/relinka-impl/deprecated/components/levels/levels.d.ts

@@ -0,0 +1,13 @@
+import type { LogObject, LogTypeDeprecated } from "../../../../relinka-types.js";
+/**
+ * A mapping of `LogTypeDeprecated` to its corresponding numeric log level.
+ *
+ * @type {Record<LogTypeDeprecated, number>} LogLevelsDeprecated - key-value pairs of log types to their numeric levels. See {@link LogTypeDeprecated}.
+ */
+export declare const LogLevelsDeprecated: Record<LogTypeDeprecated, number>;
+/**
+ * Maps `LogTypeDeprecated` to a `Partial<LogObject>`, primarily defining the log level.
+ *
+ * @type {Record<LogTypeDeprecated, Partial<LogObject>>} LogTypesDeprecated - key-value pairs of log types to partial log objects, specifying log levels. See {@link LogTypeDeprecated} and {@link LogObject}.
+ */
+export declare const LogTypesDeprecated: Record<LogTypeDeprecated, Partial<LogObject>>;

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/modes/basic.d.ts

@@ -1,13 +1,13 @@
 import type { RelinkaInstanceDeprecated } from "../relinka-deprecated/relinka.js";
-import type { RelinkaOptions } from "../../../../core-types.js";
+import type { RelinkaOptionsDeprecated } from "../../../../relinka-types.js";
 export * from "./shared.js";
 /**
  * Factory function to create a new Relinka instance
  *
- * @param {Partial<RelinkaOptions & { fancy: boolean }>} [options={}] - Optional configuration options. See {@link RelinkaOptions}.
+ * @param {Partial<RelinkaOptionsDeprecated & { fancy: boolean }>} [options={}] - Optional configuration options. See {@link RelinkaOptionsDeprecated}.
  * @returns {RelinkaInstanceDeprecated} A new Relinka instance configured with the given options.
  */
-export declare function createRelinkaBaseDeprecated(options?: Partial<RelinkaOptions & {
+export declare function createRelinkaBaseDeprecated(options?: Partial<RelinkaOptionsDeprecated & {
     fancy: boolean;
 }>): RelinkaInstanceDeprecated;
 /**

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/modes/browser.d.ts

@@ -1,15 +1,15 @@
-import type { RelinkaOptions } from "../../../../core-types.js";
+import type { RelinkaOptionsDeprecated } from "../../../../relinka-types.js";
 import { type RelinkaInstanceDeprecated } from "../relinka-deprecated/relinka.js";
 export * from "./shared.js";
 /**
  * Creates a new Relinka instance configured specifically for browser environments.
  * This function sets up default reporters and a prompt method tailored to the browser's dialogue APIs.
  *
- * @param {Partial<RelinkaOptions>} [options={}] - Optional configuration options.
- * The options can override the default reporter and prompt behavior. See {@link RelinkaOptions}.
+ * @param {Partial<RelinkaOptionsDeprecated>} [options={}] - Optional configuration options.
+ * The options can override the default reporter and prompt behavior. See {@link RelinkaOptionsDeprecated}.
  * @returns {RelinkaInstanceDeprecated} A new Relinka instance optimized for use in browser environments.
  */
-export declare function createRelinkaBrowserDeprecatedDeprecated(options?: Partial<RelinkaOptions>): any;
+export declare function createRelinkaBrowserDeprecatedDeprecated(options?: Partial<RelinkaOptionsDeprecated>): any;
 /**
  * A standard Relinka instance created with browser-specific configurations.
  * This instance can be used throughout a browser-based project.

package/bin/relinka-impl/deprecated/components/modes/shared.d.ts

@@ -0,0 +1,2 @@
+export { LogLevelsDeprecated, LogTypesDeprecated, } from "../levels/levels.js";
+export type * from "../../../../relinka-types.js";

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/relinka-deprecated/mod.d.ts

@@ -1,14 +1,14 @@
-import type { RelinkaOptions } from "../../../../core-types.js";
+import type { RelinkaOptionsDeprecated } from "../../../../relinka-types.js";
 import type { RelinkaInstanceDeprecated } from "./relinka.js";
 export * from "../modes/shared.js";
 /**
  * Factory function to create a new Relinka instance tailored for use in different environments.
  * It automatically adjusts logging levels based on environment variables and execution context.
  *
- * @param {Partial<RelinkaOptions & { fancy: boolean }>} [options={}] - Optional configuration options. See {@link RelinkaOptions}.
+ * @param {Partial<RelinkaOptionsDeprecated & { fancy: boolean }>} [options={}] - Optional configuration options. See {@link RelinkaOptionsDeprecated}.
  * @returns {RelinkaInstanceDeprecated} A new Relinka instance with configurations based on the given options and the execution environment.
  */
-export declare function createRelinkaSharedDeprecated(options?: Partial<RelinkaOptions & {
+export declare function createRelinkaSharedDeprecated(options?: Partial<RelinkaOptionsDeprecated & {
     fancy: boolean;
 }>): RelinkaInstanceDeprecated;
 /**

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/relinka-deprecated/relinka.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import type { LogTypeDeprecated } from "../levels/levels.js";
-import type { InputLogObject, LogObject, RelinkaOptions, RelinkaReporter } from "../../../../core-types.js";
+import type { LogTypeDeprecated } from "../../../../relinka-types.js";
+import type { InputLogObject, LogObject, RelinkaOptionsDeprecated, RelinkaReporterDeprecated } from "../../../../relinka-types.js";
 /**
  * Relinka class for logging management with support for pause/resume, mocking and customizable reporting.
  * Provides flexible logging capabilities including level-based logging, custom reporters and integration options.
@@ -8,7 +8,7 @@ import type { InputLogObject, LogObject, RelinkaOptions, RelinkaReporter } from
  * @class Relinka
  */
 export declare class RelinkaInterface {
-    options: RelinkaOptions;
+    options: RelinkaOptionsDeprecated;
     _lastLog: {
         serialized?: string;
         object?: LogObject;
@@ -18,13 +18,13 @@ export declare class RelinkaInterface {
     };
     _paused: boolean;
     _queue: any[];
-    _mockFn?: RelinkaOptions["mockFn"];
+    _mockFn?: RelinkaOptionsDeprecated["mockFn"];
     /**
      * Creates an instance of Relinka with specified options or defaults.
      *
-     * @param {Partial<RelinkaOptions>} [options={}] - Configuration options for the Relinka instance.
+     * @param {Partial<RelinkaOptionsDeprecated>} [options={}] - Configuration options for the Relinka instance.
      */
-    constructor(options?: Partial<RelinkaOptions>);
+    constructor(options?: Partial<RelinkaOptionsDeprecated>);
     /**
      * Gets the current log level of the Relinka instance.
      *
@@ -40,10 +40,10 @@ export declare class RelinkaInterface {
     /**
      * Creates a new instance of Relinka, inheriting options from the current instance, with possible overrides.
      *
-     * @param {Partial<RelinkaOptions>} options - Optional overrides for the new instance. See {@link RelinkaOptions}.
+     * @param {Partial<RelinkaOptionsDeprecated>} options - Optional overrides for the new instance. See {@link RelinkaOptionsDeprecated}.
      * @returns {RelinkaInstanceDeprecated} A new Relinka instance. See {@link RelinkaInstanceDeprecated}.
      */
-    create(options: Partial<RelinkaOptions>): RelinkaInstanceDeprecated;
+    create(options: Partial<RelinkaOptionsDeprecated>): RelinkaInstanceDeprecated;
     /**
      * Creates a new Relinka instance with the specified default log object properties.
      *
@@ -62,25 +62,25 @@ export declare class RelinkaInterface {
      * Adds a custom reporter to the Relinka instance.
      * Reporters will be called for each log message, depending on their implementation and log level.
      *
-     * @param {RelinkaReporter} reporter - The reporter to add. See {@link RelinkaReporter}.
+     * @param {RelinkaReporterDeprecated} reporter - The reporter to add. See {@link RelinkaReporterDeprecated}.
      * @returns {Relinka} The current Relinka instance.
      */
-    addReporter(reporter: RelinkaReporter): this;
+    addReporter(reporter: RelinkaReporterDeprecated): this;
     /**
      * Removes a custom reporter from the Relinka instance.
      * If no reporter is specified, all reporters will be removed.
      *
-     * @param {RelinkaReporter} reporter - The reporter to remove. See {@link RelinkaReporter}.
+     * @param {RelinkaReporterDeprecated} reporter - The reporter to remove. See {@link RelinkaReporterDeprecated}.
      * @returns {Relinka} The current Relinka instance.
      */
-    removeReporter(reporter: RelinkaReporter): any;
+    removeReporter(reporter: RelinkaReporterDeprecated): any;
     /**
      * Replaces all reporters of the Relinka instance with the specified array of reporters.
      *
-     * @param {RelinkaReporter[]} reporters - The new reporters to set. See {@link RelinkaReporter}.
+     * @param {RelinkaReporterDeprecated[]} reporters - The new reporters to set. See {@link RelinkaReporterDeprecated}.
      * @returns {Relinka} The current Relinka instance.
      */
-    setReporters(reporters: RelinkaReporter[]): this;
+    setReporters(reporters: RelinkaReporterDeprecated[]): this;
     wrapAll(): void;
     restoreAll(): void;
     /**
@@ -120,9 +120,9 @@ export declare class RelinkaInterface {
     /**
      * Replaces logging methods with mocks if a mock function is provided.
      *
-     * @param {RelinkaOptions["mockFn"]} mockFn - The function to use for mocking logging methods. See {@link RelinkaOptions["mockFn"]}.
+     * @param {RelinkaOptionsDeprecated["mockFn"]} mockFn - The function to use for mocking logging methods. See {@link RelinkaOptionsDeprecated["mockFn"]}.
      */
-    mockTypes(mockFn?: RelinkaOptions["mockFn"]): void;
+    mockTypes(mockFn?: RelinkaOptionsDeprecated["mockFn"]): void;
     _wrapLogFn(defaults: InputLogObject, isRaw?: boolean): (...args: any[]) => boolean;
     _logFn(defaults: InputLogObject, args: any[], isRaw?: boolean): boolean;
     _log(logObj: LogObject): void;
@@ -135,7 +135,7 @@ export type RelinkaInstanceDeprecated = RelinkaInterface & Record<LogTypeDepreca
 /**
  * Utility for creating a new Relinka instance with optional configuration.
  *
- * @param {Partial<RelinkaOptions>} [options={}] - Optional configuration options for the new Relinka instance. See {@link RelinkaOptions}.
+ * @param {Partial<RelinkaOptionsDeprecated>} [options={}] - Optional configuration options for the new Relinka instance. See {@link RelinkaOptionsDeprecated}.
  * @returns {RelinkaInstanceDeprecated} A new instance of RelinkaInterface. See {@link RelinkaInstanceDeprecated}.
  */
-export declare function createRelinkaDeprecated(options?: Partial<RelinkaOptions>): RelinkaInstanceDeprecated;
+export declare function createRelinkaDeprecated(options?: Partial<RelinkaOptionsDeprecated>): RelinkaInstanceDeprecated;

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/relinka-deprecated/relinka.js

@@ -11,7 +11,7 @@ export class RelinkaInterface {
   /**
    * Creates an instance of Relinka with specified options or defaults.
    *
-   * @param {Partial<RelinkaOptions>} [options={}] - Configuration options for the Relinka instance.
+   * @param {Partial<RelinkaOptionsDeprecated>} [options={}] - Configuration options for the Relinka instance.
    */
   constructor(options = {}) {
     const types = options.types || LogTypesDeprecated;
@@ -72,7 +72,7 @@ export class RelinkaInterface {
   /**
    * Creates a new instance of Relinka, inheriting options from the current instance, with possible overrides.
    *
-   * @param {Partial<RelinkaOptions>} options - Optional overrides for the new instance. See {@link RelinkaOptions}.
+   * @param {Partial<RelinkaOptionsDeprecated>} options - Optional overrides for the new instance. See {@link RelinkaOptionsDeprecated}.
    * @returns {RelinkaInstanceDeprecated} A new Relinka instance. See {@link RelinkaInstanceDeprecated}.
    */
   create(options) {
@@ -115,7 +115,7 @@ export class RelinkaInterface {
    * Adds a custom reporter to the Relinka instance.
    * Reporters will be called for each log message, depending on their implementation and log level.
    *
-   * @param {RelinkaReporter} reporter - The reporter to add. See {@link RelinkaReporter}.
+   * @param {RelinkaReporterDeprecated} reporter - The reporter to add. See {@link RelinkaReporterDeprecated}.
    * @returns {Relinka} The current Relinka instance.
    */
   addReporter(reporter) {
@@ -126,7 +126,7 @@ export class RelinkaInterface {
    * Removes a custom reporter from the Relinka instance.
    * If no reporter is specified, all reporters will be removed.
    *
-   * @param {RelinkaReporter} reporter - The reporter to remove. See {@link RelinkaReporter}.
+   * @param {RelinkaReporterDeprecated} reporter - The reporter to remove. See {@link RelinkaReporterDeprecated}.
    * @returns {Relinka} The current Relinka instance.
    */
   removeReporter(reporter) {
@@ -143,7 +143,7 @@ export class RelinkaInterface {
   /**
    * Replaces all reporters of the Relinka instance with the specified array of reporters.
    *
-   * @param {RelinkaReporter[]} reporters - The new reporters to set. See {@link RelinkaReporter}.
+   * @param {RelinkaReporterDeprecated[]} reporters - The new reporters to set. See {@link RelinkaReporterDeprecated}.
    * @returns {Relinka} The current Relinka instance.
    */
   setReporters(reporters) {
@@ -250,7 +250,7 @@ export class RelinkaInterface {
   /**
    * Replaces logging methods with mocks if a mock function is provided.
    *
-   * @param {RelinkaOptions["mockFn"]} mockFn - The function to use for mocking logging methods. See {@link RelinkaOptions["mockFn"]}.
+   * @param {RelinkaOptionsDeprecated["mockFn"]} mockFn - The function to use for mocking logging methods. See {@link RelinkaOptionsDeprecated["mockFn"]}.
    */
   mockTypes(mockFn) {
     const _mockFn = mockFn || this.options.mockFn;

package/bin/relinka-impl/deprecated/components/relinka-deprecated/relinka.test.d.ts

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

package/bin/relinka-impl/deprecated/components/relinka-deprecated/relinka.test.js

@@ -0,0 +1,57 @@
+import { describe, test, expect } from "vitest";
+import { createRelinkaDeprecated } from "./relinka.js";
+import {
+  LogLevelsDeprecated
+} from "./mod.js";
+describe("relinka", () => {
+  test("can set level", () => {
+    const relinka = createRelinkaDeprecated();
+    expect(relinka.level).toBe(1);
+    for (let i = 0; i <= 5; i++) {
+      relinka.level = i;
+      expect(relinka.level).toBe(i);
+    }
+  });
+  test("silent log level does't print logs", async () => {
+    const logs = [];
+    const TestReporter = {
+      log(logObj) {
+        logs.push(logObj);
+      }
+    };
+    const relinka = createRelinkaDeprecated({
+      throttle: 100,
+      level: LogLevelsDeprecated.silent,
+      reporters: [TestReporter]
+    });
+    for (let i = 0; i < 10; i++) {
+      relinka.log("SPAM");
+    }
+    await wait(200);
+    expect(logs.length).toBe(0);
+  });
+  test("can see spams without ending log", async () => {
+    const logs = [];
+    const TestReporter = {
+      log(logObj) {
+        logs.push(logObj);
+      }
+    };
+    const relinka = createRelinkaDeprecated({
+      throttle: 100,
+      level: LogLevelsDeprecated.info,
+      reporters: [TestReporter]
+    });
+    for (let i = 0; i < 10; i++) {
+      relinka.log("SPAM");
+    }
+    await wait(300);
+    expect(logs.length).toBe(7);
+    expect(logs.at(-1).args).toEqual(["SPAM", "(repeated 4 times)"]);
+  });
+});
+function wait(delay) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, delay);
+  });
+}

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/reporters/basic.d.ts

@@ -1,11 +1,11 @@
-import type { LogObject, RelinkaReporter, FormatOptions, RelinkaOptions } from "../../../../core-types.js";
-export declare class BasicReporter implements RelinkaReporter {
+import type { LogObject, RelinkaReporterDeprecated, FormatOptions, RelinkaOptionsDeprecated } from "../../../../relinka-types.js";
+export declare class BasicReporter implements RelinkaReporterDeprecated {
     formatStack(stack: string): string;
     formatArgs(args: any[], opts: FormatOptions): string;
     formatDate(date: Date, opts: FormatOptions): string;
     filterAndJoin(arr: any[]): string;
     formatLogObj(logObj: LogObject, opts: FormatOptions): string;
     log(logObj: LogObject, ctx: {
-        options: RelinkaOptions;
+        options: RelinkaOptionsDeprecated;
     }): any;
 }

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/reporters/browser.d.ts

@@ -1,4 +1,4 @@
-import type { LogObject } from "../../../../core-types.js";
+import type { LogObject } from "../../../../relinka-types.js";
 export declare class BrowserReporter {
     options: any;
     defaultColor: string;

package/bin/{libs/core/core-impl → relinka-impl}/deprecated/components/reporters/fancy.d.ts

@@ -1,5 +1,5 @@
-import type { LogLevelDeprecated, LogTypeDeprecated } from "../levels/levels.js";
-import type { FormatOptions, LogObject } from "../../../../core-types.js";
+import type { LogLevelDeprecated, LogTypeDeprecated } from "../../../../relinka-types.js";
+import type { FormatOptions, LogObject } from "../../../../relinka-types.js";
 import { BasicReporter } from "./basic.js";
 export declare const TYPE_COLOR_MAP: Partial<Record<LogTypeDeprecated, string>>;
 export declare const LEVEL_COLOR_MAP: Partial<Record<LogLevelDeprecated, string>>;