@reliverse/relico 1.2.0 → 1.3.1

package/examples/benchmarks/config.example.ts

@@ -0,0 +1,55 @@
+// Example configuration for relico benchmarks
+// Copy this file to config.ts and modify as needed
+
+import type { BenchmarkConfig } from "./config";
+
+// Custom configuration example
+export const customConfig: BenchmarkConfig = {
+  sourceDirs: {
+    src: "../../src", // Source TypeScript files
+    distNpmBin: "../../dist-npm/bin", // Binary distribution files
+  },
+
+  // Choose which directories to test
+  enabledDirs: ["src", "distNpmBin"], // Only test src and dist-npm/bin
+
+  performance: {
+    iterations: 50_000, // Reduce iterations for faster testing
+    warmupRuns: 500, // Reduce warmup runs
+  },
+
+  bundleAnalysis: {
+    includeSourceMaps: false, // Skip source map analysis
+    analyzeDependencies: true, // Include dependency analysis
+  },
+};
+
+// Example: Test only source files
+export const sourceOnlyConfig: BenchmarkConfig = {
+  ...customConfig,
+  enabledDirs: ["src"],
+};
+
+// Example: Test only built files
+export const builtOnlyConfig: BenchmarkConfig = {
+  ...customConfig,
+  enabledDirs: ["distNpmBin"],
+};
+
+// Example: High-performance testing
+export const highPerfConfig: BenchmarkConfig = {
+  ...customConfig,
+  performance: {
+    iterations: 1_000_000, // 1M iterations for accurate results
+    warmupRuns: 10_000, // 10K warmup runs
+  },
+};
+
+// Example: Quick testing
+export const quickConfig: BenchmarkConfig = {
+  ...customConfig,
+  performance: {
+    iterations: 10_000, // 10K iterations for quick results
+    warmupRuns: 100, // Minimal warmup
+  },
+};

package/examples/benchmarks/config.ts

@@ -0,0 +1,93 @@
+// Benchmark configuration for relico
+export interface BenchmarkConfig {
+  // Source directories to test
+  sourceDirs: {
+    src?: string;
+    distNpmBin: string;
+  };
+
+  // Which directories to include in testing
+  enabledDirs: ("src" | "distNpmBin")[];
+
+  // Performance test settings
+  performance: {
+    iterations: number;
+    warmupRuns: number;
+  };
+
+  // Bundle analysis settings
+  bundleAnalysis: {
+    includeSourceMaps: boolean;
+    analyzeDependencies: boolean;
+  };
+}
+
+// Default configuration
+export const defaultConfig: BenchmarkConfig = {
+  sourceDirs: {
+    src: "../../src",
+    distNpmBin: "../../dist-npm/bin", // Binary distribution (where .js and .d.ts files are)
+  },
+
+  // Test source directory by default since we don't have a built version
+  enabledDirs: ["src"],
+
+  performance: {
+    iterations: 100_000,
+    warmupRuns: 1000,
+  },
+
+  bundleAnalysis: {
+    includeSourceMaps: false,
+    analyzeDependencies: true,
+  },
+};
+
+// Helper function to get import path for a specific directory
+export function getImportPath(dir: keyof BenchmarkConfig["sourceDirs"], module = "mod"): string {
+  const config = defaultConfig;
+  const basePath = config.sourceDirs[dir];
+
+  switch (dir) {
+    case "src":
+      return `${basePath}/${module}.ts`;
+    case "distNpmBin":
+      return `${basePath}/${module}.js`;
+    default:
+      return `${basePath}/${module}.ts`;
+  }
+}
+
+// Helper function to get file paths for analysis (both .js and .d.ts files)
+export function getFilePaths(
+  dir: keyof BenchmarkConfig["sourceDirs"],
+  module = "mod",
+): { js?: string; dts?: string } {
+  const config = defaultConfig;
+  const basePath = config.sourceDirs[dir];
+
+  switch (dir) {
+    case "src":
+      return { js: `${basePath}/${module}.ts` };
+    case "distNpmBin":
+      return {
+        js: `${basePath}/${module}.js`,
+        dts: `${basePath}/${module}.d.ts`,
+      };
+    default:
+      return { js: `${basePath}/${module}.ts` };
+  }
+}
+
+// Helper to check if directory is enabled
+export function isDirEnabled(dir: keyof BenchmarkConfig["sourceDirs"]): boolean {
+  return defaultConfig.enabledDirs.includes(dir);
+}
+
+// Helper to get all enabled directories
+export function getEnabledDirs(): (keyof BenchmarkConfig["sourceDirs"])[] {
+  return defaultConfig.enabledDirs;
+}
+
+// Export the config for easy access
+export const config = defaultConfig;

package/examples/benchmarks/performance.ts

@@ -0,0 +1,174 @@
+// Performance benchmarks for relico optimizations
+
+import { dirname, resolve } from "path";
+import { performance } from "perf_hooks";
+import { fileURLToPath } from "url";
+import { config, getEnabledDirs, getImportPath } from "./config";
+
+// Constants
+const MILLISECONDS_PER_SECOND = 1000;
+const COLOR_LEVEL_BASIC = 1;
+const COLOR_LEVEL_TRUECOLOR = 3;
+const MULTILINE_TEST_SIZE = 50;
+
+// Get the directory where this benchmark file is located
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Dynamic imports for different source directories
+async function importFromDir(dir: string) {
+  try {
+    const resolvedPath = resolve(__dirname, dir);
+    const module = await import(resolvedPath);
+    return module;
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.warn(`⚠️  Could not import from ${dir}:`, errorMessage);
+    return null;
+  }
+}
+
+interface ModuleExports {
+  // biome-ignore lint/suspicious/noExplicitAny: <>
+  re: any;
+  // biome-ignore lint/suspicious/noExplicitAny: <>
+  chain: any;
+  setColorLevel: (level: number) => void;
+}
+
+// Run benchmarks for a specific module
+function runBenchmarks(module: ModuleExports) {
+  const { re, chain, setColorLevel } = module;
+  const { iterations, warmupRuns } = config.performance;
+
+  function benchmark(name: string, fn: () => void, iterCount = iterations) {
+    // Warmup runs
+    for (let i = 0; i < warmupRuns; i++) {
+      fn();
+    }
+
+    const start = performance.now();
+    for (let i = 0; i < iterCount; i++) {
+      fn();
+    }
+    const end = performance.now();
+    const time = end - start;
+    const opsPerSec = Math.round((iterCount * MILLISECONDS_PER_SECOND) / time);
+    console.log(`  ${name}: ${time.toFixed(2)}ms (${opsPerSec.toLocaleString()} ops/sec)`);
+  }
+
+  // Test basic color operations
+  benchmark("Basic color access", () => {
+    re.red("test");
+  });
+
+  benchmark("Chained colors", () => {
+    re.bold.red.underline("test");
+  });
+
+  benchmark("Extended named colors", () => {
+    re.orange("test");
+  });
+
+  benchmark("Bright color variants", () => {
+    re.redBright("test");
+  });
+
+  benchmark("Chain function", () => {
+    chain(re.bold, re.red, re.underline)("test");
+  });
+
+  benchmark("Background colors", () => {
+    re.bgRed.white("test");
+  });
+
+  benchmark("Bright background colors", () => {
+    re.bgRedBright.white("test");
+  });
+
+  benchmark("Complex style combinations", () => {
+    re.bold.italic.underline.red("test");
+  });
+
+  benchmark("Style methods", () => {
+    re.dim.strikethrough("test");
+  });
+
+  benchmark("Color level changes", () => {
+    setColorLevel(COLOR_LEVEL_BASIC);
+    re.red("test");
+    setColorLevel(COLOR_LEVEL_TRUECOLOR); // Reset to truecolor
+  });
+
+  benchmark("Multiline text (small)", () => {
+    re.red("line1\nline2\nline3");
+  });
+
+  benchmark("Multiline text (large)", () => {
+    const largeText = new Array(MULTILINE_TEST_SIZE).fill("text").join("\n");
+    re.red(largeText);
+  });
+
+  benchmark("Mixed background and foreground", () => {
+    re.bgBlue.yellow.bold("test");
+  });
+
+  benchmark("All basic colors iteration", () => {
+    const colors = ["red", "green", "blue", "yellow", "magenta", "cyan", "white", "black"];
+    for (const color of colors) {
+      re[color]("test");
+    }
+  });
+
+  benchmark("Extended colors iteration", () => {
+    const extendedColors = [
+      "orange",
+      "pink",
+      "purple",
+      "teal",
+      "lime",
+      "brown",
+      "navy",
+      "maroon",
+      "olive",
+      "silver",
+    ];
+    for (const color of extendedColors) {
+      re[color]("test");
+    }
+  });
+
+  console.log("\n  📊 Bundle Size Test:");
+  console.log(`  Core exports imported: ${Object.keys({ re, chain, setColorLevel }).length}`);
+}
+
+// Test all enabled directories
+async function runBenchmarksForAllDirs() {
+  const enabledDirs = getEnabledDirs();
+
+  for (const dir of enabledDirs) {
+    const importPath = getImportPath(dir);
+    console.log(`\n🔍 Testing ${dir.toUpperCase()} directory: ${importPath}`);
+    console.log("=".repeat(60));
+
+    const module = await importFromDir(importPath);
+    if (!module) {
+      continue;
+    }
+
+    // Run benchmarks for this directory
+    runBenchmarks(module);
+  }
+}
+
+// Main execution
+console.log("🚀 Relico Performance Benchmarks");
+console.log("=".repeat(50));
+
+runBenchmarksForAllDirs()
+  .then(() => {
+    console.log("\n✅ All benchmarks completed!");
+  })
+  .catch((error) => {
+    console.error("❌ Benchmark error:", error);
+  });

package/examples/core.ts

@@ -0,0 +1,62 @@
+import { chain, re, setColorLevel } from "~/mod";
+
+const COLOR_LEVEL_TRUECOLOR = 3;
+
+function main() {
+  setColorLevel(COLOR_LEVEL_TRUECOLOR);
+
+  console.log("--- Basic Color Examples ---");
+  console.log(re.bold.red.underline("Hello"));
+  console.log(chain(re.bold, re.red)("world"));
+
+  // Additional color tests
+  console.log("\n--- Named Color Examples ---");
+  console.log(re.blue("Blue text"));
+  console.log(re.green.bold("Bold green text"));
+  console.log(re.yellow.underline("Yellow underlined text"));
+  console.log(re.magenta.italic("Magenta italic text"));
+  console.log(re.bgRed.white("White text on red background"));
+  console.log(re.bgBlue.yellow("Yellow text on blue background"));
+
+  console.log("\n--- Extended Named Colors ---");
+  console.log(re.orange.bold("Orange text"));
+  console.log(re.pink.underline("Pink text"));
+  console.log(re.purple.italic("Purple text"));
+  console.log(re.teal.bold("Teal text"));
+  console.log(re.lime("Lime text"));
+  console.log(re.brown("Brown text"));
+  console.log(re.navy("Navy text"));
+  console.log(re.maroon("Maroon text"));
+  console.log(re.olive("Olive text"));
+  console.log(re.silver("Silver text"));
+
+  console.log("\n--- Bright Color Variants ---");
+  console.log(re.redBright("Bright red text"));
+  console.log(re.greenBright.bold("Bold bright green text"));
+  console.log(re.blueBright.underline("Underlined bright blue text"));
+  console.log(re.yellowBright.italic("Italic bright yellow text"));
+
+  console.log("\n--- Background Colors ---");
+  console.log(re.bgOrange.white("White text on orange background"));
+  console.log(re.bgPink.black("Black text on pink background"));
+  console.log(re.bgPurple.white("White text on purple background"));
+  console.log(re.bgTeal.white("White text on teal background"));
+
+  console.log("\n--- Bright Background Colors ---");
+  console.log(re.bgRedBright.white("White text on bright red background"));
+  console.log(re.bgGreenBright.black("Black text on bright green background"));
+  console.log(re.bgBlueBright.white("White text on bright blue background"));
+
+  console.log("\n--- Style Combinations ---");
+  console.log(re.bold.italic.underline.red("Bold italic underlined red text"));
+  console.log(re.dim.strikethrough.cyan("Dim strikethrough cyan text"));
+  console.log(re.inverse.magenta("Inverse magenta text"));
+  console.log(re.hidden("Hidden text (you might not see this)"));
+
+  console.log("\n--- Chaining Examples ---");
+  console.log(chain(re.bold, re.red, re.underline)("Chained formatting"));
+  console.log(chain(re.italic, re.blue, re.bgYellow)("Blue italic on yellow background"));
+  console.log(chain(re.dim, re.green)("Dim green text"));
+}
+
+main();

package/knip.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "project": ["**/*.{ts,js}"],
+  "entry": [".*/**/*.ts", "*.{config,cfg}.{ts,js}", "src/mod.ts"],
+  "ignore": [
+    "node_modules",
+    "dist-jsr",
+    "dist-npm",
+    "dist-libs",
+    "tests/mod.test.ts"
+  ],
+  "ignoreBinaries": ["dler"]
+}

package/package.json

@@ -1,40 +1,32 @@
 {
-  "dependencies": {
-    "@reliverse/runtime": "^1.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.",
-  "homepage": "https://docs.reliverse.org",
-  "license": "MIT",
   "name": "@reliverse/relico",
-  "type": "module",
-  "version": "1.2.0",
   "author": "reliverse",
-  "bugs": {
-    "email": "blefnk@gmail.com",
-    "url": "https://github.com/reliverse/relico/issues"
-  },
-  "keywords": [
-    "reliverse"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/reliverse/relico.git"
-  },
-  "devDependencies": {},
+  "version": "1.3.1",
+  "type": "module",
+  "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.",
   "exports": {
-    ".": "./bin/mod.js"
+    ".": "./src/mod.ts"
   },
-  "files": [
-    "bin",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "main": "./bin/mod.js",
-  "module": "./bin/mod.js",
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "pub": "dler pub",
+    "dev": "bun examples/core.ts",
+    "latest": "bun update --latest && bun check",
+    "check": "tsc --noEmit && biome check --fix --unsafe",
+    "bench": "bun examples/benchmarks/performance.ts",
+    "size": "bun examples/benchmarks/bundle-size.ts",
+    "perf": "bun bench && bun size"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.2.0",
+    "@reliverse/dler": "^1.7.92",
+    "@reliverse/rse-cfg": "^1.7.12",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/bun": "^1.2.20",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "ultracite": "^5.1.5"
   }
-}
+}

package/reset.d.ts

@@ -0,0 +1 @@
+import "@total-typescript/ts-reset";