@renpwn/simplelog 0.0.3 → 0.0.5

package/README.md

@@ -46,9 +46,12 @@ npm install
 
 ```js
 import { simpleLog } from '@renpwn/simplelog'
-
 const log = simpleLog()
 
+OR
+
+import { simpleLog as log} from '@renpwn/simplelog'
+
 log.log('hello')
 log.info('info message')
 log.warn('warning')
@@ -77,12 +80,96 @@ log.debug('Debug message')
 log.info('Server started')
 log.warn('Memory usage high')
 log.error({ code: 500, msg: 'Fatal error' })
+
+OR just
+...
+  color: true,      // enable ANSI color (TTY only)
+  time: true,       // default values locale ID & position PREFIX
+....
 ```
 
 **Notes**
 - `level` → minimum log level to display
 - `color` → auto-disabled in non-TTY / CI
 - `time` → compact and consistent timestamp
+  - true → default { locale: 'id', position: 'prefix' }
+  - object → fully configurable (locale, position)
+
+---
+
+#### ⏱️ Custom Time Template
+
+By default, `simpleLog` uses a compact, locale-based timestamp:
+
+```
+[SEN|31.DES|10:15:04]
+```
+
+You can now fully customize the timestamp format using a **template string**.
+
+##### Basic Usage
+
+```js
+const log = simpleLog({
+  time: {
+    template: '[{HH}:{mm}:{ss}]'
+  }
+})
+```
+
+Output:
+```
+[10:15:04] Server started
+```
+
+---
+
+##### Supported Time Tokens
+
+Assume the following datetime:
+```
+Monday, 31 December 2026 — 10:15:04.123
+```
+
+| Token | Output | Description |
+|------|--------|------------|
+| `{TIME}` | `10:15:04` | Full time (HH:mm:ss) |
+| `{HH}` | `10` | Hour |
+| `{mm}` | `15` | Minute |
+| `{ss}` | `04` | Second |
+| `{ms}` | `123` | Millisecond |
+| `{YYYY}` | `2026` | Year |
+| `{MM}` | `12` | Month (number) |
+| `{DD}` | `31` | Day of month |
+| `{DAY}` | `SEN` / `MON` | Locale-based weekday |
+| `{MON}` | `DES` / `DEC` | Locale-based month |
+| `{iso}` | `2026-12-31T10:15:04.123Z` | ISO 8601 |
+
+---
+
+##### Locale-aware Template
+
+```js
+time: {
+  locale: 'en',
+  template: '{DAY} {DD} {MON} {TIME}'
+}
+```
+
+Output:
+```
+MON 31 DEC 10:15:04
+```
+
+---
+
+##### Default Behavior (Unchanged)
+
+If no template is provided, `simpleLog` keeps using the original format:
+
+```js
+[{DAY}|{DD}.{MON}|{TIME}]
+```
 
 ---
 
@@ -170,6 +257,10 @@ const timer = setInterval(() => {
 **Notes**
 - Progress bars are shown only in TTY
 - Normal logs temporarily clear progress and redraw it
+- Each slot name acts as a unique key
+- `log.updateProgress(name, ...)` updates the progress state for that key
+- Only slots defined in `progress.slots` are rendered
+- Progress is stateful and does not auto-finish or auto-remove
 
 ---
 
@@ -257,6 +348,41 @@ gold sky mint coral indigo brown olive navy maroon aqua chartreuse plum salmon s
 
 ---
 
+#### 🎨 Advanced Styles & Manual Colors
+
+The `style` object now supports **manual color definitions**, in addition to named palettes.
+
+##### Supported Style Inputs
+
+| Type | Example |
+|----|--------|
+| Named palette | `{ color: 'softBlue' }` |
+| ANSI basic | `{ color: 31 }` |
+| ANSI 256 | `{ color: 196 }` |
+| HEX color | `{ color: '#ff0000' }` |
+| RGB string | `{ color: 'rgb(255,0,0)' }` |
+| RGB array | `{ color: [255, 0, 0] }` |
+
+All formats also work for `bg` (background).
+
+---
+
+##### HEX & RGB Examples
+
+```js
+log.info('HEX red', {
+  color: '#ff0000',
+  bold: true
+})
+
+log.warn('RGB blue', {
+  bg: 'rgb(30,144,255)',
+  color: '#ffffff'
+})
+```
+
+---
+
 ### 🟢 Single Style (Always Applied)
 
 ```js
@@ -463,6 +589,24 @@ Perfect for:
 - Workers / queues
 - Base libraries (`simpleStore`, `simpleFetch`, etc.)
 
+Works Everywhere
+
+- Linux / macOS terminals
+- Windows Terminal
+- VSCode integrated terminal
+- Termux (Android)
+
+If truecolor is not supported, the terminal will gracefully fallback.
+
+---
+
+### ✅ Summary
+
+- ⏱️ Fully customizable time format with tokens
+- 🎨 Manual color support (HEX / RGB / ANSI)
+- 🧩 Backward compatible
+- 🚀 Safe for minor releases
+
 ---
 
 ## 🔗 Links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renpwn/simplelog",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Lightweight, safe, audit-friendly logger for CLI tools and long-running Node.js processes",
   "type": "module",
   "main": "./src/index.js",

package/src/Formatter.js

@@ -61,6 +61,60 @@ const BG = Object.assign({
   brightBlue:104, brightMagenta:105, brightCyan:106, brightWhite:107
 }, EXT)
 
+function parseRgbString(str) {
+  const m = str.match(/^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i)
+  if (!m) return null
+  return m.slice(1).map(n => Math.max(0, Math.min(255, Number(n))))
+}
+
+function hexToRgb(hex) {
+  hex = hex.replace('#', '')
+  if (hex.length === 3)
+    hex = hex.split('').map(c => c + c).join('')
+  const num = parseInt(hex, 16)
+  if (Number.isNaN(num)) return null
+  return [(num >> 16) & 255, (num >> 8) & 255, num & 255]
+}
+
+function resolveColor(val, isBg = false) {
+  if (val == null) return null
+  const prefix = isBg ? 48 : 38
+
+  // 🔹 RGB array [r,g,b]
+  if (Array.isArray(val) && val.length === 3) {
+    const [r, g, b] = val.map(n => Math.max(0, Math.min(255, n)))
+    return `${prefix};2;${r};${g};${b}`
+  }
+
+  // 🔹 rgb(255,0,0)
+  if (typeof val === 'string' && val.startsWith('rgb')) {
+    const rgb = parseRgbString(val)
+    if (rgb) return `${prefix};2;${rgb.join(';')}`
+  }
+
+  // 🔹 hex '#rrggbb'
+  if (typeof val === 'string' && val.startsWith('#')) {
+    const rgb = hexToRgb(val)
+    if (rgb) return `${prefix};2;${rgb.join(';')}`
+  }
+
+  // 🔹 numeric ANSI / 256-color
+  if (typeof val === 'number') {
+    return val <= 107 ? val : `${prefix};5;${val}`
+  }
+
+  // 🔹 named palette
+  if (typeof val === 'string') {
+    const table = isBg ? BG : COLORS
+    if (val in table) {
+      const c = table[val]
+      return c <= 107 ? c : `${prefix};5;${c}`
+    }
+  }
+
+  return null
+}
+
 export function format(text, style, tty = true) {
   if (!tty || !style) return text
 
@@ -68,13 +122,11 @@ export function format(text, style, tty = true) {
   if (style.bold) codes.push(1)
   if (style.dim) codes.push(2)
   
-  // foreground
-  const c = COLORS[style.color]
-  style.color in COLORS && codes.push(c <= 97 ? c : `38;5;${c}`)
+  const fg = resolveColor(style.color, false)
+  const bg = resolveColor(style.bg, true)
 
-  // background
-  const b = BG[style.bg]
-  style.bg in BG && codes.push(b <= 107 ? b : `48;5;${b}`)
+  if (fg) codes.push(fg)
+  if (bg) codes.push(bg)
   
   return codes.length
     ? `\x1b[${codes.join(';')}m${text}\x1b[0m`

package/src/Logger.js

@@ -7,23 +7,22 @@ import { ProgressManager } from './Progress/ProgressManager.js'
 
 export class Logger {
   constructor(opts = {}) {
-    this.level = normalizeLevel(opts.level)
-    this.color = !!opts.color
+    const { level, color, truncate, maxLength, file, progress } = opts
+    const time = opts.time === true ? {} : (opts.time || {})
+  
+    this.level = normalizeLevel(level)
+    this.color = !!color
     this.tty = process.stdout.isTTY && !process.env.CI
 
-    this.time = !!opts.time
-    this.timeLocale = opts.time?.locale || 'id'
-    this.timePos = opts.time?.position || 'prefix'
+    this.time = !!time
+    this.timeLocale = time?.locale
+    this.template = time?.template
+    this.timePos = time?.position || 'prefix'
 
-    this.stringify = createStringifier(
-      opts.truncate || { maxLength: opts.maxLength }
-    )
+    this.stringify = createStringifier( truncate || { maxLength } )
+    this.file = new FileSink(file || {})
 
-    this.file = new FileSink(opts.file || {})
-
-    this.progress = opts.progress
-      ? new ProgressManager(opts.progress.slots || [], opts.progress.theme)
-      : null
+    this.progress = progress ? new ProgressManager(progress.slots || [], progress.theme) : null
 
     this.lastProgressLines = 0
   }
@@ -39,13 +38,13 @@ export class Logger {
 
   /* ================= PROGRESS API ================= */
 
-  updateProgress(name, cur, total, text) {
+  update(name, cur, total, text) {
     if (!this.progress) return
     this.progress.update(name, cur, total, text)
     this.renderProgress()
   }
 
-  removeProgress(name) {
+  remove(name) {
     if (!this.progress) return
     this.progress.remove(name)
     this.renderProgress()
@@ -87,7 +86,7 @@ export class Logger {
     if (!this.allow(type)) return
 
     const msg = args.map(this.stringify.toStr).join(' ')
-    const t = this.time ? formatTime(this.timeLocale) : null
+    const t = this.time ? formatTime({locale: this.timeLocale, template: this.template}) : null
 
     const out =
       t && this.timePos === 'suffix'

package/src/Time.js

@@ -9,9 +9,36 @@ const LOCALES = {
   }
 }
 
-export function formatTime(locale = 'id', date = new Date()) {
+
+export function formatTime({
+  locale = 'id',
+  date = new Date(),
+  template ='[{DAY}|{DD}.{MON}|{TIME}]'
+} = {}) {
   const l = LOCALES[locale] || LOCALES.id
   const d = date
+  
+  const pad = n => String(n).padStart(2, '0')
+  
+  const map = {
+    iso: d.toISOString(),
+    
+    HH: pad(d.getHours()),
+    mm: pad(d.getMinutes()),
+    ss: pad(d.getSeconds()),
+    ms: d.getMilliseconds(),
+    
+    TIME: d.toTimeString().split(' ')[0],
+    
+    YYYY: d.getFullYear(),
+    MM: pad(d.getMonth() + 1),
+    DD: pad(d.getDate()),
+
+    // locale-based tokens
+    DAY: l.days[d.getDay()],
+    MON: l.mons[d.getMonth()]
+  }
+  
 
-  return `${l.days[d.getDay()]}|${String(d.getDate()).padStart(2,'0')}.${l.mons[d.getMonth()]}|${d.toTimeString().split(' ')[0]}`
+  return template.replace(/\{(\w+)\}/g, (_, k) => map[k] ?? '')
 }