terminal-prettier 1.0.0

package/README.md

@@ -0,0 +1,44 @@
+# terminal-pretty-logger
+
+A small TypeScript logger for terminals: ISO timestamps, emoji level icons, and optional ANSI colors—aimed at command-line tools and local development.
+
+## Installation
+
+```bash
+npm install terminal-pretty-logger
+```
+
+## Usage
+
+```typescript
+import logger from 'terminal-pretty-logger';
+
+logger.info('Application started');
+logger.debug('Debug information', { key: 'value' });
+logger.warn('Warning message');
+logger.error('Error occurred', new Error('Something went wrong'));
+logger.fatal('Fatal error');
+```
+
+## Log levels
+
+| Level   | Purpose                 |
+| ------- | ----------------------- |
+| `trace` | Very detailed tracing   |
+| `debug` | Debugging               |
+| `info`  | General information     |
+| `warn`  | Warnings                |
+| `error` | Errors                  |
+| `fatal` | Unrecoverable failures  |
+
+## Features
+
+- Per-level colors in supported terminals
+- Emoji icons for quick scanning
+- ISO-8601 timestamps on each line
+- Written in TypeScript with bundled type declarations
+- No runtime dependencies beyond Node
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+declare class Logger {
+    private colors;
+    private levelIcons;
+    private formatTimestamp;
+    private formatMessage;
+    trace(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    fatal(message: string, ...args: unknown[]): void;
+    log(level: LogLevel, message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export default logger;

package/dist/index.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+class Logger {
+    constructor() {
+        this.colors = {
+            reset: '\x1b[0m',
+            trace: '\x1b[90m',
+            debug: '\x1b[36m',
+            info: '\x1b[32m',
+            warn: '\x1b[33m',
+            error: '\x1b[31m',
+            fatal: '\x1b[35m',
+        };
+        this.levelIcons = {
+            trace: '🔍',
+            debug: '🐛',
+            info: 'ℹ️',
+            warn: '⚠️',
+            error: '❌',
+            fatal: '💀',
+        };
+    }
+    formatTimestamp() {
+        const now = new Date();
+        return now.toISOString();
+    }
+    formatMessage(level, message, options = {}) {
+        const { timestamp = true, colorize = true } = options;
+        const color = colorize ? this.colors[level] : '';
+        const reset = colorize ? this.colors.reset : '';
+        const icon = this.levelIcons[level];
+        const time = timestamp ? `[${this.formatTimestamp()}]` : '';
+        const levelStr = level.toUpperCase().padEnd(5);
+        return `${color}${time} ${icon} ${levelStr}${reset} ${message}`;
+    }
+    trace(message, ...args) {
+        console.log(this.formatMessage('trace', message), ...args);
+    }
+    debug(message, ...args) {
+        console.log(this.formatMessage('debug', message), ...args);
+    }
+    info(message, ...args) {
+        console.log(this.formatMessage('info', message), ...args);
+    }
+    warn(message, ...args) {
+        console.warn(this.formatMessage('warn', message), ...args);
+    }
+    error(message, ...args) {
+        console.error(this.formatMessage('error', message), ...args);
+    }
+    fatal(message, ...args) {
+        console.error(this.formatMessage('fatal', message), ...args);
+    }
+    log(level, message, ...args) {
+        switch (level) {
+            case 'trace':
+                this.trace(message, ...args);
+                break;
+            case 'debug':
+                this.debug(message, ...args);
+                break;
+            case 'info':
+                this.info(message, ...args);
+                break;
+            case 'warn':
+                this.warn(message, ...args);
+                break;
+            case 'error':
+                this.error(message, ...args);
+                break;
+            case 'fatal':
+                this.fatal(message, ...args);
+                break;
+        }
+    }
+}
+exports.logger = new Logger();
+exports.default = exports.logger;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "terminal-prettier",
+  "version": "1.0.0",
+  "description": "Pretty terminal logger for CLIs: ISO timestamps, level icons, and colorized output with zero runtime deps",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "ts-node index.ts"
+  },
+  "keywords": [
+    "logger",
+    "cli",
+    "console",
+    "terminal",
+    "logging",
+    "colorized",
+    "pretty",
+    "formatter",
+    "timestamp"
+  ],
+  "author": "snapbar",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}