@reliverse/relico 1.1.1 → 1.2.0

package/README.md

@@ -1,9 +1,9 @@
 # Reliverse Relico
 
-[📚 Docs](.github/DOCS.md) • [📦 NPM](https://npmjs.com/package/@reliverse/relico) • [🌌 GitHub](https://github.com/reliverse/relico)
-
 > @reliverse/relico is a themeable, chainable, typed, truecolor-powered terminal styling toolkit — built for humans, not just terminals. It makes your CLI output beautiful, accessible, and expressive — with developer-first ergonomics, smart config, and blazing-fast performance.
 
+[sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/Pb8uKbwpsJ) — [repo](https://github.com/reliverse/relico) — [npm](https://npmjs.com/@reliverse/relico)
+
 ## 🌟 Why Relico?
 
 Because terminal styling shouldn’t feel like duct tape. **Relico** brings design-system-level polish to your CLI logs, banners, errors, and output — without battling your runtime, shell, or platform. Terminal styling should be *fun*, not frustrating. Relico makes it feel *right*.
@@ -19,7 +19,7 @@ Because terminal styling shouldn’t feel like duct tape. **Relico** brings desi
 - 🎯 **Precision-crafted ANSI output** — every color, reset, and style code is finely tuned for contrast, legibility, and glitch-free rendering — even in flaky terminals (as far as Node.js permits)
 - 🦾 **Relico isn’t just about color** — it’s about communication — make your CLI users' output more than readable — make it feel *intentional*.
 
-<img src="example.png" width="50%" alt="Available Relico colors" />
+<img src="./example/example.png" width="50%" alt="Available Relico colors" />
 
 ## Installation
 
@@ -62,11 +62,10 @@ console.log(re.info("Custom config loaded!"));
 ## API Sneak Peek
 
 ```ts
-import { re, colorize, rgb } from "@reliverse/relico";
+import { re, rgb } from "@reliverse/relico";
 
 console.log(re.red("Red!"));
 console.log(re.bold(re.green("Bold green")));
-console.log(colorize("magenta", "Hello!"));
 
 console.log(rgb(250, 128, 114)("This is salmon"));
 ```
@@ -275,7 +274,7 @@ bun i
 bun dev
 ```
 
-Check `examples/e-mod.ts` for all the fun.
+Check `example/e-mod.ts` for all the fun.
 
 ## Use Cases
 

package/bin/mod.d.ts

@@ -137,11 +137,9 @@ export declare function configure(userInput: unknown): void;
  * Returns a color function by name (or `reset` or identity if not found).
  * Uses cached functions for better performance.
  */
-export declare function getColor(name: string): (text: string | number) => string;
 /**
  * Colorizes text with a color function.
  */
-export declare function colorize(name: string, text: string | number): string;
 /**
  * Sets the color level (0=none, 1=basic, 2=256, 3=truecolor).
  */
@@ -333,11 +331,6 @@ export declare function colorizeJson(obj: unknown, options?: {
     indent?: number;
     compact?: boolean;
 }): string;
-/**
- * Initialize user configuration with optional programmatic overrides
- * @param programmaticConfig Optional configuration to override default settings
- * @param userSettingsPrecedence If true, user file settings take precedence over programmatic
- */
 /**
  * Initialize user configuration with optional programmatic overrides
  * @param programmaticConfig Optional configuration to override settings

package/bin/mod.js

@@ -99,9 +99,7 @@ export const defaultColorKeys = [
 const argv = typeof process === "undefined" ? [] : process.argv;
 const isDisabled = Boolean(env.NO_COLOR) || argv.includes("--no-color");
 const isForced = Boolean(env.FORCE_COLOR) || argv.includes("--color");
-const isCI = Boolean(
-  env.CI && (env.GITHUB_ACTIONS || env.GITLAB_CI || env.CIRCLECI)
-);
+const isCI = Boolean(env.CI && (env.GITHUB_ACTIONS || env.GITLAB_CI || env.CIRCLECI));
 const isOtherCI = Boolean(
   env.CI && (env.TRAVIS || env.APPVEYOR || env.JENKINS_URL || env.BITBUCKET_BUILD_NUMBER || env.TEAMCITY_VERSION)
 );
@@ -465,9 +463,7 @@ function hexToAnsiBasic(hex2, isBg = false) {
   const distanceKey = `${r},${g},${b}`;
   let distances;
   if (colorDistances.has(distanceKey)) {
-    distances = colorDistances.get(distanceKey) ?? shouldNeverHappen(
-      "Relico expected to use a color cache, but it's missing."
-    );
+    distances = colorDistances.get(distanceKey) ?? shouldNeverHappen("Relico expected to use a color cache, but it's missing.");
   } else {
     distances = basicColors.map((color) => {
       const dr = r - color.rgb.r;
@@ -582,9 +578,7 @@ function initColorFunctions() {
   for (const [key, [open, close]] of Object.entries(colorMap)) {
     const cacheKey = `formatter:${open}:${close}`;
     if (formatterCache.has(cacheKey)) {
-      colorFunctions[key] = formatterCache.get(cacheKey) ?? shouldNeverHappen(
-        "Relico expected to use a formatter cache, but it's missing."
-      );
+      colorFunctions[key] = formatterCache.get(cacheKey) ?? shouldNeverHappen("Relico expected to use a formatter cache, but it's missing.");
     } else {
       const formatter = createFormatter(open, close);
       formatterCache.set(cacheKey, formatter);
@@ -626,12 +620,6 @@ export function configure(userInput) {
     config = newConfig;
   }
 }
-export function getColor(name) {
-  return colorFunctions[name] || colorFunctions.reset || identityColor;
-}
-export function colorize(name, text) {
-  return getColor(name)(text);
-}
 export function setColorLevel(level) {
   if (config.colorLevel !== level) {
     configure({ colorLevel: level });
@@ -802,9 +790,7 @@ export function chain(...formatters) {
   if (formatters.length === 0) return identityColor;
   if (formatters.length === 1) return formatters[0];
   if (config.colorLevel === 0) return identityColor;
-  const cacheKey = `chain:${formatters.map(
-    (f) => f.name || formatterCache.entries().next().value?.[0] || "custom"
-  ).join(",")}`;
+  const cacheKey = `chain:${formatters.map((f) => f.name || formatterCache.entries().next().value?.[0] || "custom").join(",")}`;
   if (formatterCache.has(cacheKey)) {
     return formatterCache.get(cacheKey);
   }
@@ -859,9 +845,7 @@ export function multiGradient(text, colors, options) {
   if (chars.length === 0) return "";
   const smoothing = options?.smoothing ?? 1;
   const distribution = options?.distribution ?? "even";
-  const rgbColors = colors.map(
-    (color) => hexToRGB(normalizeColor(color))
-  );
+  const rgbColors = colors.map((color) => hexToRGB(normalizeColor(color)));
   let result = "";
   for (let i = 0; i < chars.length; i++) {
     let gradientPos;
@@ -876,15 +860,9 @@ export function multiGradient(text, colors, options) {
     const segmentOffset = segmentPos - segmentIndex;
     const startColor = rgbColors[segmentIndex];
     const endColor = rgbColors[segmentIndex + 1];
-    const r = Math.round(
-      startColor.r + segmentOffset * (endColor.r - startColor.r)
-    );
-    const g = Math.round(
-      startColor.g + segmentOffset * (endColor.g - startColor.g)
-    );
-    const b = Math.round(
-      startColor.b + segmentOffset * (endColor.b - startColor.b)
-    );
+    const r = Math.round(startColor.r + segmentOffset * (endColor.r - startColor.r));
+    const g = Math.round(startColor.g + segmentOffset * (endColor.g - startColor.g));
+    const b = Math.round(startColor.b + segmentOffset * (endColor.b - startColor.b));
     const colorFn = rgb(r, g, b);
     result += colorFn(chars[i]);
   }
@@ -898,9 +876,7 @@ export function blend(color1, color2, ratio = 0.5) {
   ratio = Math.max(0, Math.min(1, ratio));
   if (ratio === 0) return hex(color1);
   if (ratio === 1) return hex(color2);
-  const cacheKey = `blend:${normalizeColor(color1)}:${normalizeColor(
-    color2
-  )}:${ratio.toFixed(3)}`;
+  const cacheKey = `blend:${normalizeColor(color1)}:${normalizeColor(color2)}:${ratio.toFixed(3)}`;
   if (formatterCache.has(cacheKey)) {
     return formatterCache.get(cacheKey);
   }
@@ -1146,10 +1122,7 @@ export function colorizeJson(obj, options) {
   }
   const indent = options?.indent ?? 2;
   const json = JSON.stringify(obj, null, options?.compact ? 0 : indent);
-  return json.replace(/"(\\.|[^"\\])*"(?=\s*:)/g, (match) => re.cyan(match)).replace(
-    /:\s*"(\\.|[^"\\])*"/g,
-    (match) => `: ${re.green(match.slice(match.indexOf('"')))}`
-  ).replace(
+  return json.replace(/"(\\.|[^"\\])*"(?=\s*:)/g, (match) => re.cyan(match)).replace(/:\s*"(\\.|[^"\\])*"/g, (match) => `: ${re.green(match.slice(match.indexOf('"')))}`).replace(
     /:\s*\b(true|false|null)\b/g,
     (match) => `: ${re.yellow(match.slice(match.indexOf(":") + 1))}`
   ).replace(

package/package.json

@@ -1,7 +1,7 @@
 {
   "dependencies": {
     "@reliverse/runtime": "^1.0.3",
-    "c12": "^3.0.3",
+    "c12": "^3.1.0",
     "pathe": "^2.0.3"
   },
   "description": "@reliverse/relico is a themeable, chainable, typed, truecolor-powered, modern terminal styling toolkit. Designed to make your CLI output colorful, accessible, and human-friendly. It gives you a flexible way to apply colors and styles — with reliability and a smart developer experience baked in. Built for humans, not just terminals.",
@@ -9,7 +9,7 @@
   "license": "MIT",
   "name": "@reliverse/relico",
   "type": "module",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "author": "reliverse",
   "bugs": {
     "email": "blefnk@gmail.com",
@@ -22,23 +22,7 @@
     "type": "git",
     "url": "git+https://github.com/reliverse/relico.git"
   },
-  "devDependencies": {
-    "@biomejs/biome": "1.9.4",
-    "@eslint/js": "^9.26.0",
-    "@reliverse/relidler-cfg": "^1.1.3",
-    "@stylistic/eslint-plugin": "^4.2.0",
-    "@total-typescript/ts-reset": "^0.6.1",
-    "@types/bun": "^1.2.13",
-    "@types/node": "^22.15.17",
-    "eslint": "^9.26.0",
-    "eslint-plugin-no-relative-import-paths": "^1.6.1",
-    "eslint-plugin-perfectionist": "^4.13.0",
-    "jiti": "^2.4.2",
-    "knip": "^5.55.1",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1",
-    "vitest": "^3.1.3"
-  },
+  "devDependencies": {},
   "exports": {
     ".": "./bin/mod.js"
   },
@@ -53,4 +37,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}