@yahlex/jolilogs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ton Pseudo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# jolilogs
+
+[![npm version](https://img.shields.io/npm/v/@yahlex/jolilogs.svg)](https://www.npmjs.com/package/@yahlex/jolilogs)
+[![license](https://img.shields.io/npm/l/@yahlex/jolilogs.svg)](./LICENSE)
+
+> Logs Node.js stylés : couleurs ANSI, icônes, cadres ASCII et bannières. **Zéro dépendance.**
+
+Une petite librairie pour rendre les logs de tes scripts Node.js (CLI, serveurs, scripts de déploiement…) lisibles et jolis en un import.
+
+```
+╭─────────────────────────────────────────────╮
+│ [14:32:01] ✅ SUCCESS  Serveur démarré      │
+╰─────────────────────────────────────────────╯
+```
+
+## Installation
+
+```bash
+npm install @yahlex/jolilogs
+```
+
+## Utilisation rapide
+
+```js
+import { success, error, warn, info, debug, box, banner, divider } from "@yahlex/jolilogs";
+
+banner("Mon Application v1.0");
+
+success("Serveur démarré sur le port 3000");
+info("Mode développement activé");
+warn("Cache expiré");
+error("Connexion DB perdue");
+debug("user = { id: 42 }");
+
+divider();
+
+box("Hello, monde !");
+```
+
+## API
+
+### Logs avec niveau
+
+Chaque fonction prend un message et un objet d'options optionnel.
+
+| Fonction | Icône | Couleur |
+|---|---|---|
+| `success(msg, opts?)` | ✅ | vert |
+| `error(msg, opts?)` | ❌ | rouge |
+| `warn(msg, opts?)` | ⚠️ | jaune |
+| `info(msg, opts?)` | ℹ️ | cyan |
+| `debug(msg, opts?)` | 🔍 | gris |
+
+**Options :**
+- `timestamp` *(boolean, défaut `true`)* — affiche l'heure devant le message
+- `box` *(boolean, défaut `false`)* — entoure le log d'un cadre coloré
+
+```js
+success("Build réussi", { box: true });
+info("Sans horodatage", { timestamp: false });
+```
+
+### `box(message, options?)`
+
+Encadre un texte (mono ou multi-lignes).
+
+**Options :**
+- `style` — `"simple"` (┌─┐) · `"double"` (╔═╗) · `"rounded"` (╭─╮) · `"bold"` (┏━┓). Défaut : `"rounded"`.
+- `color` — `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `gray`. Défaut : aucune.
+- `padding` — espacement intérieur en nombre de caractères. Défaut : `1`.
+
+```js
+box("Important !", { style: "double", color: "red", padding: 2 });
+box("Sur\nplusieurs\nlignes");
+```
+
+### `banner(message, options?)`
+
+Comme `box`, mais en MAJUSCULES, avec plus de padding et un style double par défaut. Idéal pour l'écran de démarrage d'une CLI.
+
+```js
+banner("MyApp v2.0", { color: "magenta" });
+```
+
+### `divider(options?)`
+
+Affiche une ligne de séparation.
+
+**Options :** `char` (défaut `"─"`), `length` (défaut `60`), `color` (défaut `"gray"`).
+
+```js
+divider();
+divider({ char: "═", length: 40, color: "cyan" });
+```
+
+## Désactiver les couleurs
+
+`jolilogs` respecte la convention [NO_COLOR](https://no-color.org/) et désactive automatiquement les codes ANSI si la sortie n'est pas un terminal (redirection vers un fichier, CI, etc.).
+
+```bash
+NO_COLOR=1 node mon-script.js
+```
+
+## Exemple complet
+
+```js
+import { banner, success, error, divider, box } from "@yahlex/jolilogs";
+
+banner("Déploiement Prod");
+
+success("Tests passés (124/124)");
+success("Build terminé en 8.3s");
+error("Échec du push sur le registry");
+
+divider();
+
+box("Annulation du déploiement.\nVérifiez vos credentials Docker.", {
+  style: "double",
+  color: "red",
+});
+```
+
+## Versions
+
+Ce projet suit [Semantic Versioning](https://semver.org/lang/fr/).
+
+- **1.0.0** — Version initiale : `success`, `error`, `warn`, `info`, `debug`, `box`, `banner`, `divider`.
+
+## Licence
+
+[MIT](./LICENSE)

package/index.js

@@ -0,0 +1,157 @@
+// jolilogs — logs et cadres ASCII stylés, zéro dépendance.
+// MIT License
+
+// =====================================================
+//  Couleurs ANSI
+// =====================================================
+const COLORS = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  cyan: "\x1b[36m",
+  white: "\x1b[37m",
+  gray: "\x1b[90m",
+};
+
+// Désactive les couleurs si NO_COLOR est défini (convention standard)
+// ou si la sortie n'est pas un terminal (ex: redirection vers un fichier)
+const COLOR_ENABLED =
+  !process.env.NO_COLOR && process.stdout && process.stdout.isTTY !== false;
+
+function colorize(text, color) {
+  if (!COLOR_ENABLED || !color || !COLORS[color]) return text;
+  return `${COLORS[color]}${text}${COLORS.reset}`;
+}
+
+// =====================================================
+//  Styles de cadres
+// =====================================================
+const BOX_STYLES = {
+  simple: { tl: "┌", tr: "┐", bl: "└", br: "┘", h: "─", v: "│" },
+  double: { tl: "╔", tr: "╗", bl: "╚", br: "╝", h: "═", v: "║" },
+  rounded: { tl: "╭", tr: "╮", bl: "╰", br: "╯", h: "─", v: "│" },
+  bold: { tl: "┏", tr: "┓", bl: "┗", br: "┛", h: "━", v: "┃" },
+};
+
+// Calcule la longueur visible d'une chaîne (ignore les codes ANSI)
+function visibleLength(str) {
+  return String(str).replaceAll(/\x1b\[[0-9;]*m/g, "").length;
+}
+
+// =====================================================
+//  Cadre (box)
+// =====================================================
+export function box(message, options = {}) {
+  const {
+    style = "rounded",
+    color = null,
+    padding = 1,
+    print = true,
+  } = options;
+  const chars = BOX_STYLES[style] || BOX_STYLES.rounded;
+
+  const lines = String(message).split("\n");
+  const maxLen = Math.max(...lines.map(visibleLength));
+  const innerWidth = maxLen + padding * 2;
+
+  const top = colorize(chars.tl + chars.h.repeat(innerWidth) + chars.tr, color);
+  const bottom = colorize(
+    chars.bl + chars.h.repeat(innerWidth) + chars.br,
+    color
+  );
+  const v = colorize(chars.v, color);
+
+  const middle = lines
+    .map((line) => {
+      const pad = " ".repeat(maxLen - visibleLength(line));
+      return `${v}${" ".repeat(padding)}${line}${pad}${" ".repeat(padding)}${v}`;
+    })
+    .join("\n");
+
+  const result = `${top}\n${middle}\n${bottom}`;
+  if (print) console.log(result);
+  return result;
+}
+
+// =====================================================
+//  Bannière (gros cadre stylé)
+// =====================================================
+export function banner(message, options = {}) {
+  const { color = "cyan", style = "double", padding = 3 } = options;
+  return box(String(message).toUpperCase(), { style, color, padding });
+}
+
+// =====================================================
+//  Ligne de séparation
+// =====================================================
+export function divider(options = {}) {
+  const { char = "─", length = 60, color = "gray" } = options;
+  console.log(colorize(char.repeat(length), color));
+}
+
+// =====================================================
+//  Logs avec niveau
+// =====================================================
+function timestamp() {
+  const d = new Date();
+  const p = (n) => String(n).padStart(2, "0");
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+
+function formatLog(level, icon, color, message, options = {}) {
+  const showTime = options.timestamp !== false;
+  const time = showTime ? colorize(`[${timestamp()}]`, "gray") + " " : "";
+  const tag = colorize(level.padEnd(7), color);
+  return `${time}${icon} ${tag} ${message}`;
+}
+
+const LEVELS = {
+  success: { icon: "✅", color: "green", boxStyle: "rounded" },
+  error: { icon: "❌", color: "red", boxStyle: "double" },
+  warn: { icon: "⚠️ ", color: "yellow", boxStyle: "simple" },
+  info: { icon: "ℹ️ ", color: "cyan", boxStyle: "simple" },
+  debug: { icon: "🔍", color: "gray", boxStyle: "simple" },
+};
+
+function makeLogger(level) {
+  const cfg = LEVELS[level];
+  return function (message, options = {}) {
+    const line = formatLog(
+      level.toUpperCase(),
+      cfg.icon,
+      cfg.color,
+      message,
+      options
+    );
+    if (options.box) {
+      box(line, { style: cfg.boxStyle, color: cfg.color });
+    } else {
+      console.log(line);
+    }
+  };
+}
+
+export const success = makeLogger("success");
+export const error = makeLogger("error");
+export const warn = makeLogger("warn");
+export const info = makeLogger("info");
+export const debug = makeLogger("debug");
+
+// =====================================================
+//  Export par défaut
+// =====================================================
+export default {
+  success,
+  error,
+  warn,
+  info,
+  debug,
+  box,
+  banner,
+  divider,
+};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@yahlex/jolilogs",
+  "version": "1.0.0",
+  "description": "Logs Node.js stylés : couleurs ANSI, icônes, cadres ASCII et bannières. Zéro dépendance.",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "demo": "node demo.js"
+  },
+  "keywords": [
+    "console",
+    "log",
+    "logger",
+    "ansi",
+    "color",
+    "couleur",
+    "box",
+    "cadre",
+    "banner",
+    "cli",
+    "terminal",
+    "pretty",
+    "français",
+    "zero-dependency"
+  ],
+  "author": "Ton Pseudo <ton.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yahlex/jolilogs.git"
+  },
+  "homepage": "https://github.com/yahlex/jolilogs#readme",
+  "bugs": {
+    "url": "https://github.com/yahlex/jolilogs/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}