@reliverse/relico 1.3.9 → 1.4.1

package/examples/benchmarks/performance.ts

@@ -0,0 +1,172 @@
+// 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 {
+  re: any;
+  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/package.json

@@ -1,37 +1,25 @@
 {
-  "dependencies": {},
-  "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/cli",
-  "license": "MIT",
   "name": "@reliverse/relico",
-  "type": "module",
-  "version": "1.3.9",
   "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": {},
-  "exports": {
-    ".": "./bin/mod.js"
+  "version": "1.4.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.",
+  "scripts": {
+    "pub": "bun rse publish",
+    "dev": "bun examples/core.ts",
+    "perf": "bun bench && bun size",
+    "latest": "bun rse update && bun install",
+    "size": "bun examples/benchmarks/bundle-size.ts",
+    "bench": "bun examples/benchmarks/performance.ts",
+    "check": "bun tsc --noEmit && bun biome check --fix --unsafe"
   },
-  "files": [
-    "bin",
-    "package.json",
-    "README.md",
-    "LICENSE",
-    "LICENSES"
-  ],
-  "main": "./bin/mod.js",
-  "module": "./bin/mod.js",
-  "publishConfig": {
-    "access": "public"
+  "devDependencies": {
+    "@biomejs/biome": "2.2.2",
+    "@reliverse/rse": "^1.7.27",
+    "@total-typescript/ts-reset": "^0.6.1",
+    "@types/bun": "^1.2.21",
+    "@types/node": "^24.3.0",
+    "typescript": "^5.9.2",
+    "ultracite": "^5.2.17"
   }
 }

package/reliverse.ts

@@ -0,0 +1,399 @@
+import { defineConfig } from "./reltypes";
+
+/**
+ * Reliverse Bundler Configuration
+ * Hover over a field to see more details
+ * @see https://github.com/reliverse/dler
+ */
+export default defineConfig({
+  // Bump configuration
+  bumpDisable: false,
+  bumpFilter: ["package.json", "reliverse.ts"],
+  bumpMode: "patch",
+
+  // Common configuration
+  commonPubPause: false,
+  commonPubRegistry: "npm",
+  commonVerbose: true,
+
+  // Core configuration
+  coreBuildOutDir: "bin",
+  coreDeclarations: true,
+  coreDescription:
+    "@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.",
+  coreEntryFile: "mod.ts",
+  coreEntrySrcDir: "src",
+  coreIsCLI: { enabled: false, scripts: {} },
+
+  // Logs
+  displayBuildPubLogs: false,
+
+  // JSR-only config
+  distJsrAllowDirty: true,
+  distJsrBuilder: "jsr",
+  distJsrDirName: "dist-jsr",
+  distJsrDryRun: false,
+  distJsrFailOnWarn: false,
+  distJsrGenTsconfig: false,
+  distJsrOutFilesExt: "ts",
+  distJsrSlowTypes: true,
+
+  // NPM-only config
+  distNpmBuilder: "mkdist",
+  distNpmDirName: "dist-npm",
+  distNpmOutFilesExt: "js",
+
+  // Libraries Dler Plugin
+  // Publish specific dirs as separate packages
+  // This feature is experimental at the moment
+  // Please commit your changes before using it
+  libsActMode: "main-project-only",
+  libsDirDist: "dist-libs",
+  libsDirSrc: "src/libs",
+  libsList: {},
+
+  // Specifies what resources to send to npm and jsr registries.
+  // coreBuildOutDir (e.g. "bin") dir is automatically included.
+  // The following is also included if publishArtifacts is {}:
+  // - global: ["package.json", "README.md", "LICENSE"]
+  // - dist-jsr,dist-libs/jsr: ["jsr.json"]
+  publishArtifacts: {
+    global: ["package.json", "README.md", "LICENSE", "LICENSES"],
+    "dist-jsr": [],
+    "dist-npm": [],
+    "dist-libs": {},
+  },
+
+  // Files with these extensions will be built
+  // Any other files will be copied as-is to dist
+  buildPreExtensions: ["ts", "js"],
+  // If you need to exclude some ts/js files from being built,
+  // you can store them in the dirs with buildTemplatesDir name
+  buildTemplatesDir: "templates",
+
+  // Dependency filtering
+  // Global is always applied
+  filterDepsPatterns: {
+    global: [
+      "@types",
+      "biome",
+      "knip",
+      "eslint",
+      "prettier",
+      "typescript",
+      "@reliverse/rse",
+      "@reliverse/dler",
+      "!@reliverse/rse-sdk",
+      "!@reliverse/dler-sdk",
+    ],
+    "dist-npm": [],
+    "dist-jsr": [],
+    "dist-libs": {},
+  },
+
+  // Code quality tools
+  // Available: tsc, eslint, biome, knip, dler-check
+  runBeforeBuild: [],
+  // Available: dler-check
+  runAfterBuild: [],
+
+  // Build hooks
+  hooksBeforeBuild: [
+    // example plugin:
+    // async () => {
+    //   await myCoolPlugin({
+    //     /* plugin's options */
+    //   });
+    // },
+  ],
+  hooksAfterBuild: [
+    // example func:
+    // async () => {
+    //   await applyMagicSpells(["dist-jsr", "dist-npm", "dist-libs"]);
+    // }
+  ],
+
+  postBuildSettings: {
+    deleteDistTmpAfterBuild: true,
+  },
+
+  // Build setup
+  // transpileAlias: {},
+  // transpileClean: true,
+  // transpileEntries: [],
+  transpileEsbuild: "es2023",
+  // transpileExternals: [],
+  transpileFailOnWarn: false,
+  transpileFormat: "esm",
+  transpileMinify: true,
+  // transpileParallel: false,
+  transpilePublicPath: "/",
+  // transpileReplace: {},
+  // transpileRollup: {
+  //   alias: {},
+  //   commonjs: {},
+  //   dts: {},
+  //   esbuild: {},
+  //   json: {},
+  //   replace: {},
+  //   resolve: {},
+  // },
+  // transpileShowOutLog: false,
+  transpileSourcemap: "none",
+  transpileSplitting: false,
+  transpileStub: false,
+  // transpileStubOptions: { jiti: {} },
+  transpileTarget: "node",
+  transpileWatch: false,
+  // transpileWatchOptions: undefined,
+
+  // @reliverse/relinka logger setup
+  logsFileName: ".logs/relinka.log",
+  logsFreshFile: true,
+
+  // Integrated relinka configuration
+  // https://github.com/reliverse/relinka
+  relinka: {
+    verbose: true,
+
+    // Timestamp configuration
+    timestamp: {
+      enabled: false,
+      format: "HH:mm:ss",
+    },
+
+    // Control whether logs are saved to a file
+    saveLogsToFile: false,
+
+    // Disable colors in the console
+    disableColors: false,
+
+    // Log file configuration
+    logFile: {
+      outputPath: "logs.log",
+      nameWithDate: "disable",
+      freshLogFile: true,
+    },
+
+    // Dirs settings
+    dirs: {
+      maxLogFiles: 5,
+    },
+
+    levels: {
+      success: {
+        symbol: "✓",
+        fallbackSymbol: "[OK]",
+        color: "greenBright",
+        spacing: 3,
+      },
+      info: {
+        symbol: "i",
+        fallbackSymbol: "[i]",
+        color: "cyanBright",
+        spacing: 3,
+      },
+      error: {
+        symbol: "✖",
+        fallbackSymbol: "[ERR]",
+        color: "redBright",
+        spacing: 3,
+      },
+      warn: {
+        symbol: "⚠",
+        fallbackSymbol: "[WARN]",
+        color: "yellowBright",
+        spacing: 3,
+      },
+      fatal: {
+        symbol: "‼",
+        fallbackSymbol: "[FATAL]",
+        color: "redBright",
+        spacing: 3,
+      },
+      verbose: {
+        symbol: "✧",
+        fallbackSymbol: "[VERBOSE]",
+        color: "gray",
+        spacing: 3,
+      },
+      internal: {
+        symbol: "⚙",
+        fallbackSymbol: "[INTERNAL]",
+        color: "magentaBright",
+        spacing: 3,
+      },
+      log: { symbol: "│", fallbackSymbol: "|", color: "dim", spacing: 3 },
+      message: {
+        symbol: "🞠",
+        fallbackSymbol: "[MSG]",
+        color: "cyan",
+        spacing: 3,
+      },
+    },
+  },
+
+  // RELIVERSE CONFIG (https://docs.reliverse.org/cli)
+  // Restart the CLI to apply your config changes
+  $schema: "./schema.json",
+
+  // General project information
+  projectName: "@reliverse/relico",
+  projectAuthor: "reliverse",
+  projectDescription:
+    "relico is a library for creating beautiful and customizable console output in TypeScript and JavaScript projects.",
+  version: "1.4.0",
+  projectLicense: "MIT",
+  projectState: "creating",
+  projectRepository: "https://github.com/reliverse/relico",
+  projectDomain: "https://reliverse.org",
+  projectCategory: "unknown",
+  projectSubcategory: "unknown",
+  projectTemplate: "unknown",
+  projectTemplateDate: "unknown",
+  projectArchitecture: "unknown",
+  repoPrivacy: "unknown",
+  projectGitService: "github",
+  projectDeployService: "vercel",
+  repoBranch: "main",
+
+  // Primary tech stack/framework
+  projectFramework: "unknown",
+  projectPackageManager: "bun",
+  projectRuntime: "bun",
+  preferredLibraries: {
+    stateManagement: "unknown",
+    formManagement: "unknown",
+    styling: "unknown",
+    uiComponents: "unknown",
+    testing: "unknown",
+    authentication: "unknown",
+    databaseLibrary: "unknown",
+    databaseProvider: "unknown",
+    api: "unknown",
+    linting: "unknown",
+    formatting: "unknown",
+    payment: "unknown",
+    analytics: "unknown",
+    monitoring: "unknown",
+    logging: "unknown",
+    forms: "unknown",
+    notifications: "unknown",
+    search: "unknown",
+    uploads: "unknown",
+    validation: "unknown",
+    documentation: "unknown",
+    icons: "unknown",
+    mail: "unknown",
+    cache: "unknown",
+    storage: "unknown",
+    cdn: "unknown",
+    cms: "unknown",
+    i18n: "unknown",
+    seo: "unknown",
+    motion: "unknown",
+    charts: "unknown",
+    dates: "unknown",
+    markdown: "unknown",
+    security: "unknown",
+    routing: "unknown",
+  },
+  monorepo: {
+    type: "none",
+    packages: [],
+    sharedPackages: [],
+  },
+
+  // List dependencies to exclude from checks
+  ignoreDependencies: [],
+
+  // Provide custom additional project details
+  // always sent to Reliverse AI Chat & Agents
+  customRules: {},
+
+  // Project features
+  features: {
+    i18n: false,
+    analytics: false,
+    themeMode: "dark-light",
+    authentication: false,
+    api: false,
+    database: true,
+    testing: true,
+    docker: false,
+    ci: false,
+    commands: [
+      "db",
+      "pub",
+      "knip",
+      "latest",
+      "check",
+      "agg",
+      "dev:add",
+      "dev:ai",
+      "dev:clone",
+      "dev:cmod",
+    ],
+    webview: [],
+    language: ["typescript"],
+    themes: ["default", "eslint", "biome", "uploadthing", "zod", "typebox"],
+  },
+
+  // Code style preferences
+  codeStyle: {
+    dontRemoveComments: true,
+    shouldAddComments: true,
+    typeOrInterface: "type",
+    importOrRequire: "import",
+    quoteMark: "double",
+    semicolons: true,
+    lineWidth: 80,
+    indentStyle: "space",
+    indentSize: 2,
+    importSymbol: "~",
+    trailingCommas: "all",
+    bracketSpacing: true,
+    arrowParens: "always",
+    tabWidth: 2,
+    jsToTs: false,
+    cjsToEsm: false,
+    modernize: {
+      replaceFs: false,
+      replacePath: false,
+      replaceHttp: false,
+      replaceProcess: false,
+      replaceConsole: false,
+      replaceEvents: false,
+    },
+  },
+
+  // Settings for cloning an existing repo
+  multipleRepoCloneMode: false,
+  customUserFocusedRepos: [],
+  customDevsFocusedRepos: [],
+  hideRepoSuggestions: false,
+  customReposOnNewProject: false,
+
+  // Set to false to disable opening the browser during env composing
+  envComposerOpenBrowser: true,
+
+  // Enable auto-answering for prompts to skip manual confirmations.
+  // Make sure you have unknown values configured above.
+  skipPromptsUseAutoBehavior: false,
+
+  // Prompt behavior for deployment
+  // Options: prompt | autoYes | autoNo
+  deployBehavior: "prompt",
+  depsBehavior: "prompt",
+  gitBehavior: "prompt",
+  i18nBehavior: "prompt",
+  scriptsBehavior: "prompt",
+
+  // Behavior for existing GitHub repos during project creation
+  // Options: prompt | autoYes | autoYesSkipCommit | autoNo
+  existingRepoBehavior: "prompt",
+
+  // Behavior for Reliverse AI Chat & Agents
+  // Options: promptOnce | promptEachFile | autoYes
+  relinterConfirm: "promptOnce",
+});