@reliverse/relinka 1.3.1 → 1.3.3

package/{dist-npm → bin/deprecated}/types/mod.d.ts

@@ -1,149 +1,150 @@
-import type { LogLevel, LogType } from "../components/levels/levels.js";
-export type RelinkaOptions = {
-    /**
-     * An array of RelinkaReporter instances used to handle and output log messages.
-     */
-    reporters: RelinkaReporter[];
-    /**
-     * A record mapping LogType to InputLogObject, defining the log configuration for each log type.
-     * See {@link LogType} and {@link InputLogObject}.
-     */
-    types: Record<LogType, InputLogObject>;
-    /**
-     * The minimum log level to output. See {@link LogLevel}.
-     */
-    level: LogLevel;
-    /**
-     * Default properties applied to all log messages unless overridden. See {@link InputLogObject}.
-     */
-    defaults: InputLogObject;
-    /**
-     * The maximum number of times a log message can be repeated within a given timeframe.
-     */
-    throttle: number;
-    /**
-     * The minimum time in milliseconds that must elapse before a throttled log message can be logged again.
-     */
-    throttleMin: number;
-    /**
-     * The Node.js writable stream for standard output. See {@link NodeJS.WriteStream}.
-     * @optional
-     */
-    stdout?: NodeJS.WriteStream;
-    /**
-     * The Node.js writeable stream for standard error output. See {@link NodeJS.WriteStream}.
-     * @optional
-     */
-    stderr?: NodeJS.WriteStream;
-    /**
-     * A function that allows you to mock log messages for testing purposes.
-     * @optional
-     */
-    mockFn?: (type: LogType, defaults: InputLogObject) => (...args: any) => void;
-    /**
-     * Configuration options for formatting log messages. See {@link FormatOptions}.
-     */
-    formatOptions: FormatOptions;
-};
-/**
- * @see https://nodejs.org/api/util.html#util_util_inspect_object_showhidden_depth_colors
- */
-export type FormatOptions = {
-    /**
-     * The maximum number of columns to output, affects formatting.
-     * @optional
-     */
-    columns?: number;
-    /**
-     * Whether to include timestamp information in log messages.
-     * @optional
-     */
-    date?: boolean;
-    /**
-     * Whether to use colors in the output.
-     * @optional
-     */
-    colors?: boolean;
-    /**
-     * Specifies whether or not the output should be compact. Accepts a boolean or numeric level of compactness.
-     * @optional
-     */
-    compact?: boolean | number;
-    /**
-     * Allows additional custom formatting options.
-     */
-    [key: string]: unknown;
-};
-export type InputLogObject = {
-    /**
-     * The logging level of the message. See {@link LogLevel}.
-     * @optional
-     */
-    level?: LogLevel;
-    /**
-     * A string tag to categorize or identify the log message.
-     * @optional
-     */
-    tag?: string;
-    /**
-     * The type of log message, which affects how it's processed and displayed. See {@link LogType}.
-     * @optional
-     */
-    type?: LogType;
-    /**
-     * The main log message text.
-     * @optional
-     */
-    message?: string;
-    /**
-     * Additional text or texts to be logged with the message.
-     * @optional
-     */
-    additional?: string | string[];
-    /**
-     * Additional arguments to be logged with the message.
-     * @optional
-     */
-    args?: any[];
-    /**
-     * The date and time when the log message was created.
-     * @optional
-     */
-    date?: Date;
-};
-export type LogObject = {
-    /**
-     * The logging level of the message, overridden if required. See {@link LogLevel}.
-     */
-    level: LogLevel;
-    /**
-     * The type of log message, overridden if required. See {@link LogType}.
-     */
-    type: LogType;
-    /**
-     * A string tag to categorize or identify the log message, overridden if necessary.
-     */
-    tag: string;
-    /**
-     * Additional arguments to be logged with the message, overridden if necessary.
-     */
-    args: any[];
-    /**
-     * The date and time the log message was created, overridden if necessary.
-     */
-    date: Date;
-    /**
-     * Allows additional custom properties to be set on the log object.
-     */
-    [key: string]: unknown;
-} & InputLogObject;
-export type RelinkaReporter = {
-    /**
-     * Defines how a log message is processed and displayed by this reporter.
-     * @param logObj The LogObject containing the log information to process. See {@link LogObject}.
-     * @param ctx An object containing context information such as options. See {@link RelinkaOptions}.
-     */
-    log: (logObj: LogObject, ctx: {
-        options: RelinkaOptions;
-    }) => void;
-};
+/// <reference types="node" />
+import type { LogLevel, LogType } from "../components/levels/levels.js";
+export type RelinkaOptions = {
+    /**
+     * An array of RelinkaReporter instances used to handle and output log messages.
+     */
+    reporters: RelinkaReporter[];
+    /**
+     * A record mapping LogType to InputLogObject, defining the log configuration for each log type.
+     * See {@link LogType} and {@link InputLogObject}.
+     */
+    types: Record<LogType, InputLogObject>;
+    /**
+     * The minimum log level to output. See {@link LogLevel}.
+     */
+    level: LogLevel;
+    /**
+     * Default properties applied to all log messages unless overridden. See {@link InputLogObject}.
+     */
+    defaults: InputLogObject;
+    /**
+     * The maximum number of times a log message can be repeated within a given timeframe.
+     */
+    throttle: number;
+    /**
+     * The minimum time in milliseconds that must elapse before a throttled log message can be logged again.
+     */
+    throttleMin: number;
+    /**
+     * The Node.js writable stream for standard output. See {@link NodeJS.WriteStream}.
+     * @optional
+     */
+    stdout?: NodeJS.WriteStream;
+    /**
+     * The Node.js writeable stream for standard error output. See {@link NodeJS.WriteStream}.
+     * @optional
+     */
+    stderr?: NodeJS.WriteStream;
+    /**
+     * A function that allows you to mock log messages for testing purposes.
+     * @optional
+     */
+    mockFn?: (type: LogType, defaults: InputLogObject) => (...args: any) => void;
+    /**
+     * Configuration options for formatting log messages. See {@link FormatOptions}.
+     */
+    formatOptions: FormatOptions;
+};
+/**
+ * @see https://nodejs.org/api/util.html#util_util_inspect_object_showhidden_depth_colors
+ */
+export type FormatOptions = {
+    /**
+     * The maximum number of columns to output, affects formatting.
+     * @optional
+     */
+    columns?: number;
+    /**
+     * Whether to include timestamp information in log messages.
+     * @optional
+     */
+    date?: boolean;
+    /**
+     * Whether to use colors in the output.
+     * @optional
+     */
+    colors?: boolean;
+    /**
+     * Specifies whether or not the output should be compact. Accepts a boolean or numeric level of compactness.
+     * @optional
+     */
+    compact?: boolean | number;
+    /**
+     * Allows additional custom formatting options.
+     */
+    [key: string]: unknown;
+};
+export type InputLogObject = {
+    /**
+     * The logging level of the message. See {@link LogLevel}.
+     * @optional
+     */
+    level?: LogLevel;
+    /**
+     * A string tag to categorize or identify the log message.
+     * @optional
+     */
+    tag?: string;
+    /**
+     * The type of log message, which affects how it's processed and displayed. See {@link LogType}.
+     * @optional
+     */
+    type?: LogType;
+    /**
+     * The main log message text.
+     * @optional
+     */
+    message?: string;
+    /**
+     * Additional text or texts to be logged with the message.
+     * @optional
+     */
+    additional?: string | string[];
+    /**
+     * Additional arguments to be logged with the message.
+     * @optional
+     */
+    args?: any[];
+    /**
+     * The date and time when the log message was created.
+     * @optional
+     */
+    date?: Date;
+};
+export type LogObject = {
+    /**
+     * The logging level of the message, overridden if required. See {@link LogLevel}.
+     */
+    level: LogLevel;
+    /**
+     * The type of log message, overridden if required. See {@link LogType}.
+     */
+    type: LogType;
+    /**
+     * A string tag to categorize or identify the log message, overridden if necessary.
+     */
+    tag: string;
+    /**
+     * Additional arguments to be logged with the message, overridden if necessary.
+     */
+    args: any[];
+    /**
+     * The date and time the log message was created, overridden if necessary.
+     */
+    date: Date;
+    /**
+     * Allows additional custom properties to be set on the log object.
+     */
+    [key: string]: unknown;
+} & InputLogObject;
+export type RelinkaReporter = {
+    /**
+     * Defines how a log message is processed and displayed by this reporter.
+     * @param logObj The LogObject containing the log information to process. See {@link LogObject}.
+     * @param ctx An object containing context information such as options. See {@link RelinkaOptions}.
+     */
+    log: (logObj: LogObject, ctx: {
+        options: RelinkaOptions;
+    }) => void;
+};

package/{dist-npm → bin/deprecated}/utils/box.d.ts

@@ -1,114 +1,114 @@
-export type BoxBorderStyle = {
-    /**
-     * Top left corner
-     * @example `┌`
-     * @example `╔`
-     * @example `╓`
-     */
-    tl: string;
-    /**
-     * Top right corner
-     * @example `┐`
-     * @example `╗`
-     * @example `╖`
-     */
-    tr: string;
-    /**
-     * Bottom left corner
-     * @example `└`
-     * @example `╚`
-     * @example `╙`
-     */
-    bl: string;
-    /**
-     * Bottom right corner
-     * @example `┘`
-     * @example `╝`
-     * @example `╜`
-     */
-    br: string;
-    /**
-     * Horizontal line
-     * @example `─`
-     * @example `═`
-     * @example `─`
-     */
-    h: string;
-    /**
-     * Vertical line
-     * @example `│`
-     * @example `║`
-     * @example `║`
-     */
-    v: string;
-};
-declare const boxStylePresets: Record<string, BoxBorderStyle>;
-export type BoxStyle = {
-    /**
-     * The border color
-     * @default 'white'
-     */
-    borderColor: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright";
-    /**
-     * The border style
-     * @default 'solid'
-     * @example 'single-double-rounded'
-     * @example
-     * ```ts
-     * {
-     *   tl: '┌',
-     *   tr: '┐',
-     *   bl: '└',
-     *   br: '┘',
-     *   h: '─',
-     *   v: '│',
-     * }
-     * ```
-     */
-    borderStyle: BoxBorderStyle | keyof typeof boxStylePresets;
-    /**
-     * The vertical alignment of the text
-     * @default 'center'
-     */
-    valign: "top" | "center" | "bottom";
-    /**
-     * The padding of the box
-     * @default 2
-     */
-    padding: number;
-    /**
-     * The left margin of the box
-     * @default 1
-     */
-    marginLeft: number;
-    /**
-     * The top margin of the box
-     * @default 1
-     */
-    marginTop: number;
-    /**
-     * The top margin of the box
-     * @default 1
-     */
-    marginBottom: number;
-};
-/**
- * The border options of the box
- */
-export type BoxOpts = {
-    /**
-     * Title that will be displayed on top of the box
-     * @example 'Hello World'
-     * @example 'Hello {name}'
-     */
-    title?: string;
-    style?: Partial<BoxStyle>;
-};
-/**
- * Creates a styled box with text content, customizable via options.
- * @param {string} text - The text to display in the box.
- * @param {BoxOpts} [_opts={}] - Optional settings for the appearance and behavior of the box. See {@link BoxOpts}.
- * @returns {string} The formatted box as a string, ready for printing or logging.
- */
-export declare function box(text: string, _opts?: BoxOpts): string;
-export {};
+export type BoxBorderStyle = {
+    /**
+     * Top left corner
+     * @example `┌`
+     * @example `╔`
+     * @example `╓`
+     */
+    tl: string;
+    /**
+     * Top right corner
+     * @example `┐`
+     * @example `╗`
+     * @example `╖`
+     */
+    tr: string;
+    /**
+     * Bottom left corner
+     * @example `└`
+     * @example `╚`
+     * @example `╙`
+     */
+    bl: string;
+    /**
+     * Bottom right corner
+     * @example `┘`
+     * @example `╝`
+     * @example `╜`
+     */
+    br: string;
+    /**
+     * Horizontal line
+     * @example `─`
+     * @example `═`
+     * @example `─`
+     */
+    h: string;
+    /**
+     * Vertical line
+     * @example `│`
+     * @example `║`
+     * @example `║`
+     */
+    v: string;
+};
+declare const boxStylePresets: Record<string, BoxBorderStyle>;
+export type BoxStyle = {
+    /**
+     * The border color
+     * @default 'white'
+     */
+    borderColor: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white" | "gray" | "blackBright" | "redBright" | "greenBright" | "yellowBright" | "blueBright" | "magentaBright" | "cyanBright" | "whiteBright";
+    /**
+     * The border style
+     * @default 'solid'
+     * @example 'single-double-rounded'
+     * @example
+     * ```ts
+     * {
+     *   tl: '┌',
+     *   tr: '┐',
+     *   bl: '└',
+     *   br: '┘',
+     *   h: '─',
+     *   v: '│',
+     * }
+     * ```
+     */
+    borderStyle: BoxBorderStyle | keyof typeof boxStylePresets;
+    /**
+     * The vertical alignment of the text
+     * @default 'center'
+     */
+    valign: "top" | "center" | "bottom";
+    /**
+     * The padding of the box
+     * @default 2
+     */
+    padding: number;
+    /**
+     * The left margin of the box
+     * @default 1
+     */
+    marginLeft: number;
+    /**
+     * The top margin of the box
+     * @default 1
+     */
+    marginTop: number;
+    /**
+     * The top margin of the box
+     * @default 1
+     */
+    marginBottom: number;
+};
+/**
+ * The border options of the box
+ */
+export type BoxOpts = {
+    /**
+     * Title that will be displayed on top of the box
+     * @example 'Hello World'
+     * @example 'Hello {name}'
+     */
+    title?: string;
+    style?: Partial<BoxStyle>;
+};
+/**
+ * Creates a styled box with text content, customizable via options.
+ * @param {string} text - The text to display in the box.
+ * @param {BoxOpts} [_opts={}] - Optional settings for the appearance and behavior of the box. See {@link BoxOpts}.
+ * @returns {string} The formatted box as a string, ready for printing or logging.
+ */
+export declare function box(text: string, _opts?: BoxOpts): string;
+export {};

package/{dist-npm → bin/deprecated}/utils/box.js

@@ -87,7 +87,7 @@ export function box(text, _opts = {}) {
   const boxLines = [];
   const _color = getColor(opts.style.borderColor);
   const borderStyle = {
-    ...typeof opts.style.borderStyle === "string" ? boxStylePresets[opts.style.borderStyle] || boxStylePresets["solid"] : opts.style.borderStyle
+    ...typeof opts.style.borderStyle === "string" ? boxStylePresets[opts.style.borderStyle] || boxStylePresets.solid : opts.style.borderStyle
   };
   if (_color) {
     for (const key in borderStyle) {