kailogger 1.0.0-dark.red

package/README.md

@@ -0,0 +1,86 @@
+# 🌸 KaiLogger
+
+> The most **divine**, **beautiful**, and **elegant** logger for Node.js. 
+> Experience logging like never before with mesmerizing gradients, smooth animations, and a developer experience that feels like Zen.
+
+![KaiLogger](https://img.shields.io/npm/v/kailogger?style=for-the-badge&color=ff69b4)
+![TypeScript](https://img.shields.io/badge/Written%20In-TypeScript-blue?style=for-the-badge)
+![License](https://img.shields.io/npm/l/kailogger?style=for-the-badge&color=green)
+
+## Features
+
+- » **Divine Gradients**: Make your logs pop with stunning, automatically applied color gradients.
+- » **Beautiful Themes**: Switch between `Zen` (Nature), `Neon` (Cyberpunk), and `Pastel` (Soft) modes.
+- » **Smooth Animations**: Built-in loading spinners that just work.
+- » **High Performance**: Minimal overhead, maximum beauty.
+- » **TypeScript Native**: Fully typed for a superior developer experience.
+
+## Installation
+
+```bash
+npm install kailogger
+```
+
+## Usage
+
+Using KaiLogger is as simple as breathing.
+
+```typescript
+import { kai } from 'kailogger';
+
+// 🌿 Standard Logging
+kai.success('Database connected successfully');
+kai.info('Server started on port 3000');
+kai.warning('Memory usage is slightly elevated');
+kai.error('Connection to Redis failed');
+kai.debug('User payload received');
+
+// 🌀 Loading Animations
+kai.await('Connecting to the quantum realm...');
+
+setTimeout(() => {
+  kai.stop('Connection established!'); 
+  // or kai.stop() to just clear the spinner
+}, 2000);
+```
+
+## Themes
+
+Match your mood or your terminal's aesthetic.
+
+### **Zen Mode** (Default)
+Calming greens, blues, and nature-inspired gradients.
+```typescript
+kai.setTheme('zen');
+kai.info('Nature is efficient.');
+```
+
+### **Neon Mode**
+High-contrast, cyberpunk-inspired bright colors.
+```typescript
+kai.setTheme('neon');
+kai.info('System override active.');
+```
+
+### **Pastel Mode**
+Soft, easy-on-the-eyes colors for a gentle experience.
+```typescript
+kai.setTheme('pastel');
+kai.info('Soft cloud computing.');
+```
+
+## API Reference
+
+- » `kai.success(msg)`: Log a success message.
+- » `kai.error(msg)`: Log an error message.
+- » `kai.warning(msg)`: Log a warning.
+- » `kai.info(msg)`: Log an info message.
+- » `kai.debug(msg)`: Log a debug message.
+- » `kai.log(msg)`: detailed log without level badge.
+- » `kai.box(title, msg)`: Print a message inside a beautiful box.
+- » `kai.await(msg)`: Start a loading spinner.
+- » `kai.stop(msg?)`: Stop the spinner (optional: replace with a success message).
+
+## License
+
+MIT © Soblend

package/dist/core/Logger.d.ts

@@ -0,0 +1,20 @@
+import { ThemeName } from '../styles/palettes';
+export declare class KaiLogger {
+    theme: ThemeName;
+    private spinner;
+    constructor(theme?: ThemeName);
+    setTheme(theme: ThemeName): void;
+    private getTime;
+    private format;
+    success(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    warning(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    log(message: string): void;
+    box(title: string, message: string): void;
+    await(message: string): void;
+    stop(message?: string): void;
+    private stopSpinner;
+}
+export declare const kai: KaiLogger;

package/dist/core/Logger.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.kai = exports.KaiLogger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const gradients_1 = require("../styles/gradients");
+const spinner_1 = require("../utils/spinner");
+class KaiLogger {
+    constructor(theme = 'zen') {
+        this.theme = theme;
+        this.spinner = new spinner_1.KaiSpinner();
+        gradients_1.paint.setTheme(theme);
+    }
+    setTheme(theme) {
+        this.theme = theme;
+        gradients_1.paint.setTheme(theme);
+    }
+    getTime() {
+        const date = new Date();
+        return chalk_1.default.gray(`[${date.toLocaleTimeString()}]`);
+    }
+    format(level, message, ...args) {
+        const colors = gradients_1.paint.text[level];
+        const badge = gradients_1.paint.apply(` ${level.toUpperCase()} `, colors);
+        const formattedMsg = gradients_1.paint.apply(message, colors);
+        console.log(`${this.getTime()} ${chalk_1.default.bold(badge)} ${message}`, ...args);
+    }
+    success(message, ...args) {
+        this.stopSpinner();
+        const colors = gradients_1.paint.text.success;
+        console.log(`${this.getTime()} ${gradients_1.paint.apply(' ✔ SUCCESS ', colors)} ${message}`, ...args);
+    }
+    error(message, ...args) {
+        this.stopSpinner();
+        const colors = gradients_1.paint.text.error;
+        console.log(`${this.getTime()} ${gradients_1.paint.apply(' ✖ ERROR   ', colors)} ${message}`, ...args);
+    }
+    warning(message, ...args) {
+        this.stopSpinner();
+        const colors = gradients_1.paint.text.warning;
+        console.log(`${this.getTime()} ${gradients_1.paint.apply(' ⚠ WARNING ', colors)} ${message}`, ...args);
+    }
+    info(message, ...args) {
+        this.stopSpinner();
+        const colors = gradients_1.paint.text.info;
+        console.log(`${this.getTime()} ${gradients_1.paint.apply(' ℹ INFO    ', colors)} ${message}`, ...args);
+    }
+    debug(message, ...args) {
+        this.stopSpinner();
+        const colors = gradients_1.paint.text.debug;
+        console.log(`${this.getTime()} ${gradients_1.paint.apply(' ⚙ DEBUG   ', colors)} ${message}`, ...args);
+    }
+    log(message) {
+        this.stopSpinner();
+        console.log(`${this.getTime()} ${message}`);
+    }
+    box(title, message) {
+        this.stopSpinner();
+        const border = gradients_1.paint.apply('─'.repeat(message.length + 4), gradients_1.paint.text.info);
+        console.log(border);
+        console.log(`${gradients_1.paint.apply(`| ${title} |`, gradients_1.paint.text.info)}`);
+        console.log(border);
+        console.log(`| ${message} |`);
+        console.log(border);
+    }
+    await(message) {
+        this.spinner.start(message, gradients_1.paint.text.info[0]);
+    }
+    stop(message) {
+        this.spinner.stop('✔', message, gradients_1.paint.text.success[1]);
+    }
+    stopSpinner() {
+        // Just ensure no ghost spinner lines if we log something else
+        // this.spinner.stop(); 
+        // Actually we don't want to stop it on every log if it's running, 
+        // but usually logging interrupts the spinner. 
+        // Ideally usage is: start -> wait -> stop/success/fail.
+        // But if user does: start -> info -> stop, the info might break the spinner line.
+        // For now, let's keep it simple.
+    }
+}
+exports.KaiLogger = KaiLogger;
+exports.kai = new KaiLogger();

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './core/Logger';
+export * from './styles/palettes';
+export * from './styles/gradients';

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./core/Logger"), exports);
+__exportStar(require("./styles/palettes"), exports);
+__exportStar(require("./styles/gradients"), exports);

package/dist/styles/gradients.d.ts

@@ -0,0 +1,29 @@
+import { ThemeName } from './palettes';
+export declare class GradientEngine {
+    private currentTheme;
+    setTheme(theme: ThemeName): void;
+    get text(): {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+        light: string;
+        dim: string;
+    } | {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+    } | {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+    };
+    apply(text: string, colors: string[]): string;
+    multiline(text: string, colors: string[]): string;
+}
+export declare const paint: GradientEngine;

package/dist/styles/gradients.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paint = exports.GradientEngine = void 0;
+const gradient_string_1 = __importDefault(require("gradient-string"));
+const palettes_1 = require("./palettes");
+class GradientEngine {
+    constructor() {
+        this.currentTheme = 'zen';
+    }
+    setTheme(theme) {
+        if (palettes_1.palettes[theme]) {
+            this.currentTheme = theme;
+        }
+    }
+    get text() {
+        return palettes_1.palettes[this.currentTheme];
+    }
+    apply(text, colors) {
+        return (0, gradient_string_1.default)(colors)(text);
+    }
+    multiline(text, colors) {
+        return (0, gradient_string_1.default)(colors).multiline(text);
+    }
+}
+exports.GradientEngine = GradientEngine;
+exports.paint = new GradientEngine();

package/dist/styles/palettes.d.ts

@@ -0,0 +1,26 @@
+export declare const palettes: {
+    zen: {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+        light: string;
+        dim: string;
+    };
+    neon: {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+    };
+    pastel: {
+        success: string[];
+        error: string[];
+        warning: string[];
+        info: string[];
+        debug: string[];
+    };
+};
+export type ThemeName = keyof typeof palettes;

package/dist/styles/palettes.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.palettes = void 0;
+exports.palettes = {
+    zen: {
+        success: ['#00b09b', '#96c93d'],
+        error: ['#ff416c', '#ff4b2b'],
+        warning: ['#f7971e', '#ffd200'],
+        info: ['#2193b0', '#6dd5ed'],
+        debug: ['#8e2de2', '#4a00e0'],
+        light: '#ffffff',
+        dim: '#888888'
+    },
+    neon: {
+        success: ['#39FF14', '#00FF00'],
+        error: ['#FF00FF', '#FF0099'],
+        warning: ['#FFFF00', '#FFD700'],
+        info: ['#00FFFF', '#00BFFF'],
+        debug: ['#9D00FF', '#7F00FF']
+    },
+    pastel: {
+        success: ['#77DD77', '#55BB55'],
+        error: ['#FF6961', '#FF4444'],
+        warning: ['#FFB347', '#FF9933'],
+        info: ['#AEC6CF', '#88aabb'],
+        debug: ['#B39EB5', '#9988aa']
+    }
+};

package/dist/utils/spinner.d.ts

@@ -0,0 +1,10 @@
+export declare class KaiSpinner {
+    private timer;
+    private index;
+    private text;
+    private colorFn;
+    start(text: string, colorHex?: string): void;
+    stop(symbol?: string, endText?: string, colorHex?: string): void;
+    fail(text: string): void;
+    succeed(text: string): void;
+}

package/dist/utils/spinner.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KaiSpinner = void 0;
+const process_1 = __importDefault(require("process"));
+const chalk_1 = __importDefault(require("chalk"));
+const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+class KaiSpinner {
+    constructor() {
+        this.timer = null;
+        this.index = 0;
+        this.text = '';
+        this.colorFn = chalk_1.default.cyan;
+    }
+    start(text, colorHex = '#00FFFF') {
+        this.stop();
+        this.text = text;
+        this.colorFn = chalk_1.default.hex(colorHex);
+        process_1.default.stdout.write('\x1B[?25l');
+        this.timer = setInterval(() => {
+            const frame = frames[this.index = ++this.index % frames.length];
+            process_1.default.stdout.write(`\r${this.colorFn(frame)} ${this.text}`);
+        }, 80);
+    }
+    stop(symbol = '✔', endText, colorHex) {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            process_1.default.stdout.write('\r\x1B[K');
+            process_1.default.stdout.write('\x1B[?25h');
+            if (endText) {
+                const finalColor = colorHex ? chalk_1.default.hex(colorHex) : this.colorFn;
+                console.log(`${finalColor(symbol)} ${endText}`);
+            }
+        }
+    }
+    fail(text) {
+        this.stop('✖', text, '#FF0000');
+    }
+    succeed(text) {
+        this.stop('✔', text, '#00FF00');
+    }
+}
+exports.KaiSpinner = KaiSpinner;

package/examples/demo.ts

@@ -0,0 +1,28 @@
+import { kai } from '../src';
+
+console.log('\n--- Kai (Zen) Mode (Default) ---\n');
+kai.info('This is an info message');
+kai.success('Database connected successfully');
+kai.warning('Memory usage is high');
+kai.error('Connection timed out');
+kai.debug('Variable x = 10');
+
+console.log('\n--- Neon Mode ---\n');
+kai.setTheme('neon');
+kai.info('Neon Info');
+kai.success('Neon Success');
+kai.warning('Neon Warning');
+kai.error('Neon Error');
+
+console.log('\n--- Pastel Mode ---\n');
+kai.setTheme('pastel');
+kai.info('Pastel Info');
+kai.success('Pastel Success');
+
+console.log('\n--- Animation Test ---\n');
+kai.setTheme('zen');
+kai.await('Loading quantum matrix...');
+
+setTimeout(() => {
+    kai.stop('Matrix loaded!');
+}, 2000);

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "kailogger",
+  "version": "1.0.0-dark.red",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "gradient-string": "^3.0.0"
+  }
+}

package/src/core/Logger.ts

@@ -0,0 +1,81 @@
+import chalk from 'chalk';
+import { paint, GradientEngine } from '../styles/gradients';
+import { KaiSpinner } from '../utils/spinner';
+import { ThemeName } from '../styles/palettes';
+
+type LogLevel = 'success' | 'error' | 'warning' | 'info' | 'debug';
+export class KaiLogger {
+    private spinner = new KaiSpinner();
+    constructor(public theme: ThemeName = 'zen') {
+        paint.setTheme(theme);
+    }
+    public setTheme(theme: ThemeName) {
+        this.theme = theme;
+        paint.setTheme(theme);
+    }
+    private getTime() {
+        const date = new Date();
+        return chalk.gray(`[${date.toLocaleTimeString()}]`);
+    }
+    private format(level: LogLevel, message: string, ...args: any[]) {
+        const colors = paint.text[level];
+        const badge = paint.apply(` ${level.toUpperCase()} `, colors);
+        const formattedMsg = paint.apply(message, colors);
+        console.log(`${this.getTime()} ${chalk.bold(badge)} ${message}`, ...args);
+    }
+    public success(message: string, ...args: any[]) {
+        this.stopSpinner();
+        const colors = paint.text.success;
+        console.log(`${this.getTime()} ${paint.apply(' ✔ SUCCESS ', colors)} ${message}`, ...args);
+    }
+    public error(message: string, ...args: any[]) {
+        this.stopSpinner();
+        const colors = paint.text.error;
+        console.log(`${this.getTime()} ${paint.apply(' ✖ ERROR   ', colors)} ${message}`, ...args);
+    }
+    public warning(message: string, ...args: any[]) {
+        this.stopSpinner();
+        const colors = paint.text.warning;
+        console.log(`${this.getTime()} ${paint.apply(' ⚠ WARNING ', colors)} ${message}`, ...args);
+    }
+    public info(message: string, ...args: any[]) {
+        this.stopSpinner();
+        const colors = paint.text.info;
+        console.log(`${this.getTime()} ${paint.apply(' ℹ INFO    ', colors)} ${message}`, ...args);
+    }
+    public debug(message: string, ...args: any[]) {
+        this.stopSpinner();
+        const colors = paint.text.debug;
+        console.log(`${this.getTime()} ${paint.apply(' ⚙ DEBUG   ', colors)} ${message}`, ...args);
+    }
+    public log(message: string) {
+        this.stopSpinner();
+        console.log(`${this.getTime()} ${message}`);
+    }
+    public box(title: string, message: string) {
+        this.stopSpinner();
+        const border = paint.apply('─'.repeat(message.length + 4), paint.text.info);
+        console.log(border);
+        console.log(`${paint.apply(`| ${title} |`, paint.text.info)}`);
+        console.log(border);
+        console.log(`| ${message} |`);
+        console.log(border);
+    }
+    public await(message: string) {
+        this.spinner.start(message, paint.text.info[0]);
+    }
+    public stop(message?: string) {
+        this.spinner.stop('✔', message, paint.text.success[1]);
+    }
+    private stopSpinner() {
+        // Just ensure no ghost spinner lines if we log something else
+        // this.spinner.stop(); 
+        // Actually we don't want to stop it on every log if it's running, 
+        // but usually logging interrupts the spinner. 
+        // Ideally usage is: start -> wait -> stop/success/fail.
+        // But if user does: start -> info -> stop, the info might break the spinner line.
+        // For now, let's keep it simple.
+    }
+}
+
+export const kai = new KaiLogger();

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './core/Logger';
+export * from './styles/palettes';
+export * from './styles/gradients';

package/src/styles/gradients.ts

@@ -0,0 +1,22 @@
+import gradient from 'gradient-string';
+import { palettes, ThemeName } from './palettes';
+
+export class GradientEngine {
+    private currentTheme: ThemeName = 'zen';
+    setTheme(theme: ThemeName) {
+        if (palettes[theme]) {
+            this.currentTheme = theme;
+        }
+    }
+    get text() {
+        return palettes[this.currentTheme];
+    }
+    apply(text: string, colors: string[]) {
+        return gradient(colors)(text);
+    }
+    multiline(text: string, colors: string[]) {
+        return gradient(colors).multiline(text);
+    }
+}
+
+export const paint = new GradientEngine();

package/src/styles/palettes.ts

@@ -0,0 +1,27 @@
+export const palettes = {
+    zen: {
+        success: ['#00b09b', '#96c93d'],
+        error: ['#ff416c', '#ff4b2b'],
+        warning: ['#f7971e', '#ffd200'],
+        info: ['#2193b0', '#6dd5ed'],
+        debug: ['#8e2de2', '#4a00e0'],
+        light: '#ffffff',
+        dim: '#888888'
+    },
+    neon: {
+        success: ['#39FF14', '#00FF00'],
+        error: ['#FF00FF', '#FF0099'],
+        warning: ['#FFFF00', '#FFD700'],
+        info: ['#00FFFF', '#00BFFF'],
+        debug: ['#9D00FF', '#7F00FF']
+    },
+    pastel: {
+        success: ['#77DD77', '#55BB55'],
+        error: ['#FF6961', '#FF4444'],
+        warning: ['#FFB347', '#FF9933'],
+        info: ['#AEC6CF', '#88aabb'],
+        debug: ['#B39EB5', '#9988aa']
+    }
+};
+
+export type ThemeName = keyof typeof palettes;

package/src/utils/spinner.ts

@@ -0,0 +1,39 @@
+import process from 'process';
+import chalk from 'chalk';
+
+const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+export class KaiSpinner {
+    private timer: NodeJS.Timeout | null = null;
+    private index = 0;
+    private text = '';
+    private colorFn = chalk.cyan;
+    start(text: string, colorHex: string = '#00FFFF') {
+        this.stop();
+        this.text = text;
+        this.colorFn = chalk.hex(colorHex);
+        process.stdout.write('\x1B[?25l');
+        this.timer = setInterval(() => {
+            const frame = frames[this.index = ++this.index % frames.length];
+            process.stdout.write(`\r${this.colorFn(frame)} ${this.text}`);
+        }, 80);
+    }
+    stop(symbol: string = '✔', endText?: string, colorHex?: string) {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+            process.stdout.write('\r\x1B[K');
+            process.stdout.write('\x1B[?25h');
+            if (endText) {
+                const finalColor = colorHex ? chalk.hex(colorHex) : this.colorFn;
+                console.log(`${finalColor(symbol)} ${endText}`);
+            }
+        }
+    }
+    fail(text: string) {
+        this.stop('✖', text, '#FF0000');
+    }
+
+    succeed(text: string) {
+        this.stop('✔', text, '#00FF00');
+    }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "commonjs",
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "declaration": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "**/*.test.ts"
+    ]
+}