hexlogger 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,290 @@
+A premium, zero-dependency JavaScript console logging library for Node.js with beautiful colored output, multiple themes, gradient text, panels, tables, progress bars, and spinners.
+
+---
+
+```bash
+npm install hexlogger
+```
+
+---
+
+```javascript
+const logger = require('hexlogger');
+
+logger.success(" BOT READY ");
+logger.info("Logged in as: MyBot#1234");
+logger.info("Bot Name: MyBot");
+logger.info("Bot ID: 987654321098765432");
+logger.info("Shards: 4");
+logger.info("Connected to: 128 guilds");
+logger.info("Connected to: 94,210 users");
+logger.warn("Rate limit hit on /api/messages");
+logger.error("Failed to fetch guild: 403 Forbidden");
+logger.critical("Shard 2 disconnected unexpectedly");
+logger.fatal("Token invalidated — shutting down");
+```
+
+**Output:**
+```
+[-(14:30:00)-] [ ● ] SUCCESS »   BOT READY
+[-(14:30:00)-] [ ● ] INFO »  Logged in as: MyBot#1234
+[-(14:30:00)-] [ ● ] INFO »  Bot Name: MyBot
+[-(14:30:00)-] [ ● ] INFO »  Bot ID: 987654321098765432
+[-(14:30:00)-] [ ● ] INFO »  Shards: 4
+[-(14:30:00)-] [ ● ] INFO »  Connected to: 128 guilds
+[-(14:30:00)-] [ ● ] INFO »  Connected to: 94,210 users
+[-(14:30:00)-] [ ● ] WARNING »  Rate limit hit on /api/messages
+[-(14:30:00)-] [ ● ] ERROR »  Failed to fetch guild: 403 Forbidden
+[-(14:30:00)-] [ ● ] CRITICAL »  Shard 2 disconnected unexpectedly
+[-(14:30:00)-] [ ● ] FATAL »  Token invalidated — shutting down
+```
+
+---
+
+| Function | Level |
+|---|---|
+| `trace(msg)` | TRACE |
+| `debug(msg)` | DEBUG |
+| `info(msg)` | INFO |
+| `success(msg)` | SUCCESS |
+| `warn(msg)` / `warning(msg)` | WARNING |
+| `error(msg)` | ERROR |
+| `critical(msg)` | CRITICAL |
+| `fatal(msg)` | FATAL |
+
+---
+
+Nine display styles are available. All styles respond to the active theme for color. Switch styles with `logger.setstyle(name)`.
+
+```javascript
+logger.setstyle("default");
+```
+
+```javascript
+logger.setstyle("box");
+```
+
+```javascript
+logger.setstyle("modern");
+```
+
+```javascript
+logger.setstyle("bracket");
+```
+
+```javascript
+logger.setstyle("arrow");
+```
+
+```javascript
+logger.setstyle("pipe");
+```
+
+```javascript
+logger.setstyle("tag");
+```
+
+```javascript
+logger.setstyle("dots");
+```
+
+```javascript
+logger.setstyle("clean");
+```
+
+---
+
+Six built-in themes control the colors applied to every style. Themes do not affect the structure of the output — only the palette.
+
+```javascript
+logger.settheme("default");   // Soft blue/green palette
+logger.settheme("neon");      // Vivid cyan/magenta palette
+logger.settheme("minimal");   // Muted grays, abbreviated labels
+logger.settheme("hacker");    // Green-on-black matrix palette
+logger.settheme("sunset");    // Warm orange/red palette
+logger.settheme("ocean");     // Deep blue/teal palette
+```
+
+The `minimal` theme also uses abbreviated level labels:
+
+```
+[-(14:30:00)-] [ ● ] OK »   BOT READY
+[-(14:30:00)-] [ ● ] INF »  Logged in as: MyBot#1234
+...
+```
+
+### Custom Themes
+
+```javascript
+const { rgb } = require('hexlogger');
+
+logger.getConfig().addTheme("mytheme", {
+    "timestamp": rgb(0, 100, 200),
+    "bracket":   rgb(0, 80, 160),
+    "dot":       rgb(0, 200, 255),
+    "separator": rgb(0, 150, 200),
+    "debug":     rgb(100, 180, 255),
+    "info":      rgb(0, 200, 255),
+    "success":   rgb(0, 255, 200),
+    "warning":   rgb(255, 200, 0),
+    "error":     rgb(255, 80, 80),
+    "critical":  rgb(255, 0, 50),
+    "fatal":     rgb(200, 0, 0),
+    "trace":     rgb(100, 150, 200),
+    "divider":   rgb(0, 60, 100),
+    "label_debug":    "DEBUG",
+    "label_info":     "INFO",
+    "label_success":  "SUCCESS",
+    "label_warning":  "WARNING",
+    "label_error":    "ERROR",
+    "label_critical": "CRITICAL",
+    "label_fatal":    "FATAL",
+    "label_trace":    "TRACE",
+});
+
+logger.settheme("mytheme");
+```
+
+---
+
+```javascript
+logger.divider();
+logger.divider("═", 80);
+```
+
+```javascript
+logger.section("RESULTS");
+logger.rule("Settings", "═");
+logger.blank(2);
+```
+
+```javascript
+logger.banner("HexLogger\nv1.0.1");
+```
+
+```javascript
+logger.panel(
+    "Server: online\nPing: 42ms\nUptime: 99.9%",
+    "Status",
+    50,
+    null,
+    "rounded"
+);
+```
+
+Available panel styles: `rounded`, `sharp`, `double`, `heavy`, `ascii`
+
+```javascript
+logger.box("Deployment complete.", 50, "double", null, null, "center");
+```
+
+Available box styles: `rounded`, `sharp`, `double`, `heavy`, `ascii`, `stars`, `dashes`
+
+```javascript
+logger.table(
+    ["Name", "Status", "Ping"],
+    [
+        ["Server 1", "Online",  "12ms"],
+        ["Server 2", "Offline", "---"],
+        ["Server 3", "Online",  "45ms"],
+    ]
+);
+```
+
+```javascript
+logger.pair("Logged in as", "MyBot#1234");
+logger.pair("Bot ID",       "987654321098765432");
+```
+
+---
+
+```javascript
+logger.gprint("Hello World!", [255, 0, 100], [100, 0, 255]);
+logger.rbprint("Rainbow text!");
+
+const text  = logger.gtext("Custom gradient", [0, 255, 200], [255, 0, 100]);
+const multi = logger.mgtext("Multi-stop", [[255,0,0], [0,255,0], [0,0,255]]);
+```
+
+```javascript
+const { bold, italic, uline, clr, Colors } = require('hexlogger');
+
+console.log(bold("Bold text"));
+console.log(italic("Italic text"));
+console.log(uline("Underlined text"));
+console.log(clr("Cyan text", Colors.CYAN));
+```
+
+```javascript
+const { rgb, bgrgb, hexclr, bghex } = require('hexlogger');
+
+const color    = rgb(255, 128, 0);
+const bg       = bgrgb(30, 30, 30);
+const fromHex = hexclr("#FF8800");
+const bgHex   = bghex("#1E1E1E");
+```
+
+---
+
+```javascript
+const progress = new logger.Progress(100, 40, "Downloading");
+for (let i = 1; i <= 100; i++) {
+    // ... logic
+    progress.update();
+}
+```
+
+---
+
+```javascript
+const spinner = new logger.Spinner("Loading data...", "dots");
+spinner.start();
+// ... logic
+spinner.stop("Done!");
+```
+
+Available styles: `dots`, `line`, `arrow`, `bounce`, `box`, `circle`
+
+---
+
+```javascript
+const timer = new logger.Timer("Database query");
+timer.start();
+// ... logic
+timer.stop();
+```
+
+---
+
+```javascript
+logger.settheme("neon");
+logger.setstyle("modern");
+logger.setlog("app.log");
+logger.setlevel("warning");
+
+const config = logger.getConfig();
+config.timeFormat = "YYYY-MM-DD HH:mm:ss";
+config.showTime   = false;
+```
+
+Available levels: `trace`, `debug`, `info`, `success`, `warning`, `error`, `critical`, `fatal`
+
+---
+
+- Zero dependencies
+- 6 built-in themes with full custom theme support
+- 9 display styles
+- RGB, background, and hex color helpers
+- Gradient and rainbow text
+- Panels, tables, banners, and boxes
+- Progress bars with ETA
+- Animated spinners in 6 styles
+- Timer utility
+- File logging with automatic ANSI stripping
+- Thread-safe output
+- Node.js 14+
+- Cross-platform support (Windows, Linux, macOS)
+
+---
+
+MIT License — Created by Itz Montage

package/index.js

@@ -9,7 +9,7 @@ const { Progress, Spinner, Timer } = require("./src/progress");
 const { stripAnsi, clr, bold, italic, uline } = require("./src/utils");
 
 module.exports = {
-    __version__: "1.0.0",
+    __version__: "1.0.1",
     __author__: "Montage",
     Colors, rgb, bgrgb, hexclr, bghex,
     Theme, THEMES, LEVEL_ICONS, LogLevel, LoggerConfig, getConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hexlogger",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "Premium console logging library with themes, gradients, panels, tables, progress bars, and spinners.",
     "main": "index.js",
     "exports": {