@0xkahi/pi-qol 0.0.5 → 0.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0xkahi/pi-qol",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "quality of life pi extensions",
   "type": "module",
   "keywords": [
@@ -54,6 +54,7 @@
     "typescript": "^5"
   },
   "dependencies": {
+    "@0xkahi/cli-dye": "^1.1.0",
     "zod": "^4.4.3"
   }
 }

package/src/extensions/custom-footer/codemap.md

@@ -45,5 +45,5 @@ The extension is feature-gated by the `custom_footer` config flag and can dynami
 - **`@earendil-works/pi-tui`**: Implements the `Component` contract and uses `truncateToWidth`, `visibleWidth`, and `TUI.requestRender`.
 - **`../../config-loader`**: Reads the `custom_footer` feature flag and full footer config (colors, icons, display toggles) via `ConfigLoader`.
 - **`../../schemas/config.schema`**: `CustomFooterConfig` is derived from the `Config` schema's `custom_footer` shape.
-- **`../../utils/crayon.util`**: Applies custom ANSI colors to directory text, model name, and subscription usage labels.
+- **`@0xkahi/cli-dye`**: Applies configured truecolor ANSI styling to directory text, model name, and subscription usage labels.
 - **`../../libs/subscription-usage/**`**: Delegates OAuth usage fetching and reset formatting to `SubscriptionUsageApi` and provider-specific strategies.

package/src/extensions/custom-footer/footer-component.ts

@@ -1,7 +1,7 @@
 import { basename } from 'node:path';
+import { dye } from '@0xkahi/cli-dye';
 import type { Component } from '@earendil-works/pi-tui';
 import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
-import { crayon } from '../../utils/crayon.util';
 import { pickSubscriptionUsageWindow, resolveSupportedProvider, SubscriptionUsageManager } from './subscription-usage-manager';
 import { buildStatsLeft, buildSubscriptionUsageSegment, calculateUsageTotals } from './token-stats';
 import type { CustomFooterComponentDeps, CustomFooterConfig } from './types';
@@ -74,7 +74,7 @@ export class CustomFooterComponent implements Component {
 
     let line: string;
     if (config.colors.directory) {
-      line = crayon.colorize(directoryText, { fg: config.colors.directory });
+      line = dye.colorize(directoryText, { fg: dye.hex(config.colors.directory) });
       if (branch) line += this.deps.theme.fg('dim', ` (${branch})`);
       if (sessionName) line += this.deps.theme.fg('dim', ` • ${sessionName}`);
     } else {
@@ -140,7 +140,7 @@ export class CustomFooterComponent implements Component {
     const model = this.deps.ctx.model;
     const modelName = model?.id ?? 'no-model';
     const modelNameSegment = config.colors.modelName
-      ? crayon.colorize(modelName, { fg: config.colors.modelName })
+      ? dye.colorize(modelName, { fg: dye.hex(config.colors.modelName) })
       : this.deps.theme.fg('dim', modelName);
 
     if (!model?.reasoning) return modelNameSegment;

package/src/extensions/custom-footer/token-stats.ts

@@ -1,5 +1,5 @@
+import { dye } from '@0xkahi/cli-dye';
 import type { ContextUsage, SessionEntry } from '@earendil-works/pi-coding-agent';
-import { crayon } from '../../utils/crayon.util';
 import { clampPercent, renderProgressBar } from './progress-bar';
 import type { CustomFooterColors, CustomFooterDisplay, CustomFooterIcons, FooterTheme, SupportedProvider, UsageTotals } from './types';
 
@@ -71,14 +71,15 @@ export function buildSubscriptionUsageSegment({
   const pct = clampPercent(usage.usedPercent);
   const roundedPercent = Math.round(pct).toString();
   const bar = renderProgressBar(pct);
+  const foreground = dye.hex(providerColor);
 
   const resetParts = usage.resetDescription ? [icons.refresh, usage.resetDescription].filter(Boolean).join(' ') : '';
 
   return [
-    crayon.colorize(usage.responseLabel, { fg: providerColor }),
-    crayon.colorize(usage.windowLabel, { fg: providerColor }),
-    `${crayon.colorize(bar.filled, { fg: providerColor })}${theme.fg('dim', bar.empty)}`,
-    crayon.colorize(`${roundedPercent}%`, { fg: providerColor }),
+    dye.colorize(usage.responseLabel, { fg: foreground }),
+    dye.colorize(usage.windowLabel, { fg: foreground }),
+    `${dye.colorize(bar.filled, { fg: foreground })}${theme.fg('dim', bar.empty)}`,
+    dye.colorize(`${roundedPercent}%`, { fg: foreground }),
     resetParts ? theme.fg('dim', resetParts) : undefined,
   ]
     .filter((part): part is string => Boolean(part))

package/src/utils/codemap.md

@@ -4,7 +4,6 @@
 
 This folder contains low-level, reusable helpers used across the `pi-qol` extension. They are pure utility modules with no business logic or UI concerns.
 
-- **`crayon.util.ts`** — ANSI terminal styling: colorize text with hex foreground/background colors, apply reverse video, and strip ANSI escape sequences.
 - **`model-resolver.util.ts`** — Resolve a concrete AI model and its authentication credentials from a configured `ModelConfig` or the active session model.
 - **`raw-data-parser.util.ts`** — Type-safe coercion helpers for `unknown` runtime values into `Record<string, unknown>`, trimmed `string`, or finite `number`.
 - **`path.util.ts`** — Locate extension-specific files on disk: generic file existence checks, global/project extension `config.json`, and the shared `auth.json` file.
@@ -13,30 +12,24 @@ This folder contains low-level, reusable helpers used across the `pi-qol` extens
 
 - **Static utility classes** (`RawDataParser`, `PathUtil`) group related stateless functions under a clear namespace.
 - **Service class with injected context** (`ModelResolver`) receives an `ExtensionContext` dependency rather than importing global state, keeping it testable and decoupled.
-- **Object-as-namespace export** (`crayon`) exposes a small, discoverable API surface while hiding internal helpers (`hexToRgb`, `fgAnsi`, `bgAnsi`, `ANSI_ESCAPE_REGEX`).
 - **Result/Option types** (`ResolveModelResult`, `FileSearchResult`) avoid exceptions and force callers to handle success and failure paths explicitly.
 - **Function overloads** (`PathUtil.findExtensionConfig`) provide type-safe, domain-driven entry points for global vs. project lookups.
-- **Defensive validation** (`RawDataParser`, `crayon.colorize`) silently returns `undefined` or the original input when data is invalid instead of throwing.
+- **Defensive validation** (`RawDataParser`) silently returns `undefined` when data is invalid instead of throwing.
 
 ## Data & Control Flow
 
-1. **Terminal styling**
-   - `crayon.colorize(text, { fg?, bg? })` validates hex strings against `COLOR_HEX_REGEX`.
-   - Valid colors are converted to RGB and wrapped in ANSI escape codes; the text is returned unchanged if no valid colors are provided.
-   - `crayon.stripAnsi(text)` removes all ANSI escape sequences using a compiled regex.
-
-2. **Model resolution**
+1. **Model resolution**
    - `ModelResolver.resolveModel(configModel?)` builds a candidate list in priority order: configured model first, then the active session model (deduplicated).
    - For each candidate it calls `ctx.modelRegistry.getApiKeyAndHeaders(model)`.
    - The first candidate with successful auth is returned as a `ResolvedModel`, including the API key, headers, reasoning settings, and OAuth flag.
    - If all candidates fail, a consolidated error string is returned.
 
-3. **Raw data parsing**
+2. **Raw data parsing**
    - `RawDataParser.asRecord` checks for non-null, non-array objects.
    - `stringValue` returns only non-empty trimmed strings.
    - `numberValue` coerces strings/numbers and returns only finite values.
 
-4. **Path resolution**
+3. **Path resolution**
    - `PathUtil.findFile` checks `existsSync` and returns both existence and the resolved path.
    - `findExtensionConfig({ type: 'global' })` resolves to `<agentDir>/extensions/<EXTENSION_ID>/config.json`.
    - `findExtensionConfig({ type: 'project', cwd })` resolves to `<cwd>/.pi/extensions/<EXTENSION_ID>/config.json`.
@@ -50,7 +43,6 @@ This folder contains low-level, reusable helpers used across the `pi-qol` extens
 - `@earendil-works/pi-ai`
   - `Model<Api>` is the resolved entity returned by `ModelResolver`.
 - `../constants`
-  - `COLOR_HEX_REGEX` drives hex validation in `crayon`.
   - `EXTENSION_ID` is used by `PathUtil` to build config directory paths.
 - `../schemas/shared-config.schema`
   - `ModelConfig` and its `reasoning` field are consumed by `ModelResolver`.

package/src/utils/crayon.util.ts

@@ -1,58 +0,0 @@
-import { COLOR_HEX_REGEX } from '../constants';
-
-type ColorizeOptions = {
-  bg?: string;
-  fg?: string;
-};
-
-function hexToRgb(hex: string): { r: number; g: number; b: number } {
-  return {
-    r: Number.parseInt(hex.slice(1, 3), 16),
-    g: Number.parseInt(hex.slice(3, 5), 16),
-    b: Number.parseInt(hex.slice(5, 7), 16),
-  };
-}
-
-function fgAnsi(hex: string): string {
-  const { r, g, b } = hexToRgb(hex);
-  return `\x1b[38;2;${r};${g};${b}m`;
-}
-
-function bgAnsi(hex: string): string {
-  const { r, g, b } = hexToRgb(hex);
-  return `\x1b[48;2;${r};${g};${b}m`;
-}
-
-function colorize(text: string, { bg, fg }: ColorizeOptions = {}): string {
-  const hasFg = fg !== undefined && COLOR_HEX_REGEX.test(fg);
-  const hasBg = bg !== undefined && COLOR_HEX_REGEX.test(bg);
-
-  if (!hasFg && !hasBg) {
-    return text;
-  }
-
-  const prefix = `${hasBg ? bgAnsi(bg) : ''}${hasFg ? fgAnsi(fg) : ''}`;
-  const suffix = `${hasFg ? '\x1b[39m' : ''}${hasBg ? '\x1b[49m' : ''}`;
-
-  return `${prefix}${text}${suffix}`;
-}
-
-const ANSI_ESCAPE_REGEX = new RegExp(`${String.fromCharCode(27)}\\[[0-?]*[ -/]*[@-~]`, 'g');
-
-function stripAnsi(text: string): string {
-  return text.replace(ANSI_ESCAPE_REGEX, '');
-}
-
-export const crayon = {
-  colorize(text: string, opts: ColorizeOptions = {}): string {
-    return colorize(text, opts);
-  },
-
-  reverseVideo(text: string): string {
-    return `\x1b[7m${text}\x1b[27m`;
-  },
-
-  stripAnsi(text: string): string {
-    return stripAnsi(text);
-  },
-};