CLAUDE.md - Terminal Package

This package provides terminal utilities for the ccusage toolchain.

Package Overview

Name: @ccusage/terminal Description: Terminal utilities for ccusage Type: Internal library package (private)

Development Commands

Testing and Quality:

• pnpm run test - Run all tests using vitest
• pnpm run lint - Lint code using ESLint
• pnpm run format - Format and auto-fix code with ESLint
• pnpm typecheck - Type check with TypeScript

Architecture

This package contains terminal utilities used across the ccusage monorepo:

Key Modules:

• src/table.ts - Table formatting and rendering utilities
• src/utils.ts - General terminal utilities

Exports:

• ./table - Table formatting utilities
• ./utils - Terminal utility functions

Dependencies

Runtime Dependencies:

• @oxc-project/runtime - Runtime utilities
• ansi-escapes - ANSI escape sequences for terminal manipulation
• cli-table3 - Table formatting for terminal output
• es-toolkit - Modern JavaScript utility library
• picocolors - Terminal color support
• string-width - Get the visual width of strings

Dev Dependencies:

• vitest - Testing framework
• eslint - Linting and formatting

Testing Guidelines

• In-Source Testing: Tests are written in the same files using if (import.meta.vitest != null) blocks
• Vitest Globals Enabled: Use describe, it, expect directly without imports
• CRITICAL: NEVER use await import() dynamic imports anywhere, especially in test blocks

Code Style

Follow the same code style guidelines as the main ccusage package:

• Error Handling: Prefer functional error handling patterns
• Imports: Use .ts extensions for local imports
• Exports: Only export what's actually used
• No console.log: Terminal output should be handled through proper utilities

Post-Change Workflow: Always run these commands in parallel after code changes:

• pnpm run format - Auto-fix and format
• pnpm typecheck - Type checking
• pnpm run test - Run tests

Important Notes

This is a private internal package and should not be published to npm. It exists solely to provide terminal utilities for other packages in the monorepo.