@reliverse/relico 1.4.0 → 1.4.1

package/.vscode/extensions.json

@@ -0,0 +1,8 @@
+{
+  "recommendations": [
+    "fabiospampinato.vscode-open-multiple-files",
+    "davidanson.vscode-markdownlint",
+    "usernamehw.errorlens",
+    "yoavbls.pretty-ts-errors"
+  ]
+}

package/.vscode/settings.json

@@ -0,0 +1,45 @@
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.addMissingImports.ts": "never",
+    "source.biome": "explicit",
+    "source.fixAll.biome": "explicit",
+    "source.fixAll.ts": "never",
+    "source.organizeImports.biome": "explicit",
+    "source.organizeImports": "never",
+    "source.removeUnused.ts": "never",
+    "source.removeUnusedImports": "never",
+    "source.sortImports": "never"
+  },
+  "editor.defaultFormatter": "biomejs.biome",
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "DavidAnson.vscode-markdownlint"
+  },
+  "markdownlint.config": {
+    "MD033": false,
+    "MD024": false
+  },
+  "json.schemaDownload.enable": true,
+  "css.lint.unknownAtRules": "ignore",
+  "emmet.showExpandedAbbreviation": "never",
+  "typescript.preferences.importModuleSpecifier": "shortest",
+  "typescript.updateImportsOnFileMove.enabled": "never",
+  "javascript.updateImportsOnFileMove.enabled": "never",
+  "typescript.updateImportsOnPaste.enabled": false,
+  "javascript.updateImportsOnPaste.enabled": false
+}

package/README.md

@@ -1,8 +1,12 @@
 # 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.
+> @reliverse/dler-colors 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)
+[sponsor](https://github.com/sponsors/blefnk) — [discord](https://discord.gg/Pb8uKbwpsJ) — [repo](https://github.com/reliverse/relico) — [npm](https://npmjs.com/@reliverse/dler-colors)
+
+---
+
+‼️Attention! The latest implementation of `@reliverse/relico` now lives in the framework repository for building libraries — `@reliverse/dler`. Please use [@reliverse/dler-colors](https://github.com/reliverse/dler/tree/main/packages/colors) instead of `@reliverse/relico`.
 
 ## Why Relico?
 
@@ -24,7 +28,7 @@ Because terminal styling shouldn't feel like duct tape. **Relico** brings design
 ## Installation
 
 ```bash
-bun add @reliverse/relico
+bun add @reliverse/dler-colors
 # bun • pnpm • yarn • npm
 ```
 
@@ -91,7 +95,7 @@ The readme will be updated soon.
 **If you're end-user OR developer, create `relico.config.ts` in your root**:
 
 ```ts
-import { defineConfig } from "@reliverse/relico";
+import { defineConfig } from "@reliverse/dler-colors";
 
 export default defineConfig({
   colorLevel: 3, // 0 = off, 1 = basic, 2 = 256, 3 = truecolor
@@ -108,7 +112,7 @@ export default defineConfig({
 **If you're developer, initialize in your app (optional)**:
 
 ```ts
-import { initUserConfig, re } from "@reliverse/relico";
+import { initUserConfig, re } from "@reliverse/dler-colors";
 
 // Use this to override Relico's 
 // default settings for your app
@@ -120,7 +124,7 @@ console.log(re.info("Custom config loaded!"));
 ## API Sneak Peek
 
 ```ts
-import { re, rgb } from "@reliverse/relico";
+import { re, rgb } from "@reliverse/dler-colors";
 
 console.log(re.red("Red!"));
 console.log(re.bold(re.green("Bold green")));
@@ -171,7 +175,7 @@ console.log(boldRed("This text is bold and red"));
 ### Want to Get Only Certain Colors?
 
 ```ts
-import type { DefaultColorKeys } from "@reliverse/relico";
+import type { DefaultColorKeys } from "@reliverse/dler-colors";
 const brandColors: DefaultColorKeys[] = ["magentaBright", "maroon"];
 ```
 
@@ -180,7 +184,7 @@ const brandColors: DefaultColorKeys[] = ["magentaBright", "maroon"];
 Relico detects your terminal's capability:
 
 ```ts
-import { colorSupport } from "@reliverse/relico";
+import { colorSupport } from "@reliverse/dler-colors";
 
 console.log(colorSupport.terminalName); // iTerm2, Windows Terminal, etc.
 console.log(colorSupport.level); // 0, 1, 2, or 3
@@ -196,7 +200,7 @@ console.log(colorSupport.level); // 0, 1, 2, or 3
 ### Custom RGB + Hex
 
 ```ts
-import { rgb, bgHex, hex } from "@reliverse/relico";
+import { rgb, bgHex, hex } from "@reliverse/dler-colors";
 
 console.log(rgb(255, 105, 180)("Hot pink"));
 console.log(bgHex("#1e90ff")("Dodger blue background"));
@@ -205,7 +209,7 @@ console.log(bgHex("#1e90ff")("Dodger blue background"));
 ### Gradients & Rainbow
 
 ```ts
-import { gradient, multiGradient, rainbow } from "@reliverse/relico";
+import { gradient, multiGradient, rainbow } from "@reliverse/dler-colors";
 
 console.log(rainbow("🎉 Woohoo!"));
 console.log(gradient("From red to blue", "#ff0000", "#0000ff"));
@@ -218,7 +222,7 @@ This function allows you to combine multiple color formatters into a single form
 ## Basic Usage
 
 ```typescript
-import { re, chain } from "@reliverse/relico";
+import { re, chain } from "@reliverse/dler-colors";
 
 // Create a custom style that combines bold and red text
 const boldRed = chain(re.bold, re.red);
@@ -236,7 +240,7 @@ console.log(importantError("CRITICAL ERROR: System failure"));
 ## Creating Theme Combinations
 
 ```typescript
-import { re, chain } from "@reliverse/relico";
+import { re, chain } from "@reliverse/dler-colors";
 
 // Create themed message styles
 const successStyle = chain(re.bold, re.green);
@@ -254,7 +258,7 @@ console.log(warnStyle("⚠ API rate limit approaching"));
 ## Custom RGB Combinations
 
 ```typescript
-import { re, rgb, bgRgb, chain } from "@reliverse/relico";
+import { re, rgb, bgRgb, chain } from "@reliverse/dler-colors";
 
 // Create a custom color scheme with RGB values
 const customHeader = chain(
@@ -278,7 +282,7 @@ console.log(danger("Danger: High voltage detected!"));
 The `chain()` function automatically handles multiline text to prevent style leakage:
 
 ```typescript
-import { re, chain } from "@reliverse/relico";
+import { re, chain } from "@reliverse/dler-colors";
 
 const highlight = chain(re.bgYellow, re.black, re.bold);
 
@@ -293,7 +297,7 @@ console.log(highlight(multilineText));
 ## Creating a Simple Logger
 
 ```typescript
-import { re, chain } from "@reliverse/relico";
+import { re, chain } from "@reliverse/dler-colors";
 
 // Create logger styles
 const styles = {

package/biome.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.2.2/schema.json",
+  "extends": ["ultracite"],
+  "vcs": {
+    "enabled": false,
+    "clientKind": "git",
+    "useIgnoreFile": false
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "maxSize": 1700000,
+    "includes": [
+      "**",
+      "!**/.js",
+      "!**/.d.ts",
+      "!**/_generated",
+      "!**/.basehub",
+      "!**/.expo",
+      "!**/.next",
+      "!**/.nuxt",
+      "!**/.react-email",
+      "!**/.source",
+      "!**/.turbo",
+      "!**/.vercel",
+      "!**/.wrangler",
+      "!**/.zed",
+      "!**/dev-dist",
+      "!**/dist-npm",
+      "!**/dist",
+      "!**/drizzle/migrations",
+      "!**/node_modules",
+      "!**/routeTree.gen.ts",
+      "!**/src-tauri"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "lineWidth": 100
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noConsole": "off",
+        "noVar": "off",
+        "noExplicitAny": "off"
+      },
+      "style": {
+        "useNodejsImportProtocol": "off",
+        "noMagicNumbers": "off",
+        "useBlockStatements": "off"
+      },
+      "complexity": { "noExcessiveLinesPerFunction": "off" },
+      "nursery": {
+        "useConsistentTypeDefinitions": {
+          "level": "off",
+          "options": { "style": "interface" }
+        }
+      }
+    }
+  },
+  "javascript": {
+    "globals": ["Bun"],
+    "formatter": {
+      "jsxQuoteStyle": "double",
+      "quoteProperties": "asNeeded",
+      "trailingCommas": "all",
+      "semicolons": "always",
+      "arrowParentheses": "always",
+      "bracketSpacing": true,
+      "bracketSameLine": false,
+      "quoteStyle": "double",
+      "attributePosition": "auto"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
+}

package/examples/benchmarks/bundle-size.ts

@@ -0,0 +1,143 @@
+// Bundle size analysis for relico
+import { readFileSync, statSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath } from "url";
+import { config, getEnabledDirs, getFilePaths, getImportPath } from "./config";
+
+// Get the directory where this benchmark file is located
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Constants for size formatting
+const BYTES_PER_KB = 1024;
+const BYTES_PER_MB = 1024 * 1024;
+const NEWLINE_LENGTH = 1;
+const PERCENT_MULTIPLIER = 100;
+const DECIMAL_PLACES = 1;
+const SEPARATOR_LENGTH = 60;
+
+function getFileSize(path: string): number {
+  try {
+    const stats = statSync(path);
+    return stats.size;
+  } catch {
+    return 0;
+  }
+}
+
+function formatSize(bytes: number): string {
+  if (bytes < BYTES_PER_KB) {
+    return `${bytes}B`;
+  }
+  if (bytes < BYTES_PER_MB) {
+    return `${(bytes / BYTES_PER_KB).toFixed(DECIMAL_PLACES)}KB`;
+  }
+  return `${(bytes / BYTES_PER_MB).toFixed(DECIMAL_PLACES)}MB`;
+}
+
+function analyzeFile(filePath: string): { types: number; constants: number; logic: number } {
+  try {
+    const sourceCode = readFileSync(filePath, "utf8");
+    const lines = sourceCode.split("\n");
+
+    let typeDefinitions = 0;
+    let constants = 0;
+    let logic = 0;
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+
+      // Type definitions
+      if (trimmed.includes("type ") || trimmed.includes("interface ")) {
+        typeDefinitions += line.length + NEWLINE_LENGTH;
+        continue;
+      }
+
+      // Constants and color data
+      if (
+        trimmed.includes("const ") ||
+        trimmed.includes("COLOR_LEVEL") ||
+        trimmed.includes("SGR_")
+      ) {
+        constants += line.length + NEWLINE_LENGTH;
+        continue;
+      }
+
+      // Everything else is logic
+      if (trimmed.length > 0) {
+        logic += line.length + NEWLINE_LENGTH;
+      }
+    }
+
+    return { types: typeDefinitions, constants, logic };
+  } catch (error) {
+    console.warn(`⚠️  Could not analyze ${filePath}:`, error);
+    return { types: 0, constants: 0, logic: 0 };
+  }
+}
+
+function analyzeSingleDirectory(dir: "src" | "distNpmBin"): void {
+  const importPath = getImportPath(dir);
+  const filePaths = getFilePaths(dir);
+
+  console.log(`\n🔍 Analyzing ${dir.toUpperCase()} directory: ${importPath}`);
+  console.log("=".repeat(SEPARATOR_LENGTH));
+
+  // Analyze JavaScript/TypeScript file
+  if (filePaths.js) {
+    const jsFilePath = resolve(__dirname, filePaths.js);
+    console.log(`📄 JavaScript/TypeScript file: ${filePaths.js}`);
+    console.log(`Resolved path: ${jsFilePath}`);
+
+    const jsFileSize = getFileSize(jsFilePath);
+    if (jsFileSize === 0) {
+      console.log(`❌ File not found or empty: ${jsFilePath}`);
+    } else {
+      console.log(`File size: ${formatSize(jsFileSize)}`);
+
+      const jsAnalysis = analyzeFile(jsFilePath);
+
+      console.log("\nBreakdown:");
+      console.log(
+        `- Types: ${formatSize(jsAnalysis.types)} (${((jsAnalysis.types / jsFileSize) * PERCENT_MULTIPLIER).toFixed(DECIMAL_PLACES)}%)`,
+      );
+      console.log(
+        `- Constants: ${formatSize(jsAnalysis.constants)} (${((jsAnalysis.constants / jsFileSize) * PERCENT_MULTIPLIER).toFixed(DECIMAL_PLACES)}%)`,
+      );
+      console.log(
+        `- Logic: ${formatSize(jsAnalysis.logic)} (${((jsAnalysis.logic / jsFileSize) * PERCENT_MULTIPLIER).toFixed(DECIMAL_PLACES)}%)`,
+      );
+
+      if (config.bundleAnalysis.analyzeDependencies) {
+        console.log("\n📊 Additional Info:");
+        try {
+          const sourceCode = readFileSync(jsFilePath, "utf8");
+          const lines = sourceCode.split("\n");
+          console.log(`- Total lines: ${lines.length}`);
+          console.log("- File type: TypeScript");
+        } catch (error) {
+          console.log(`- Could not read file for line count: ${error}`);
+        }
+      }
+    }
+  }
+}
+
+function analyzeAllDirectories(): void {
+  const enabledDirs = getEnabledDirs();
+
+  for (const dir of enabledDirs) {
+    analyzeSingleDirectory(dir);
+  }
+}
+
+// Main execution
+console.log("📦 Relico Bundle Size Analysis");
+console.log("=".repeat(50));
+
+console.log("Starting analysis...");
+analyzeAllDirectories();
+console.log("\n✅ All analyses completed!");
+console.log("Starting analysis...");
+analyzeAllDirectories();
+console.log("\n✅ All analyses completed!");

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;