tecfu/tty-table

해결하는 문제

터미널 환경, 브라우저 콘솔 및 MCP 서버를 통해 데이터를 형식화된 ASCII 또는 Unicode 테이블로 렌더링하는 방법을 제공하며, 이모지나 동아시아 문자와 같은 문자 폭에 관계없이 텍스트 줄바꿈과 정렬이 올바르게 이루어지도록 보장합니다.

작동 방식

이 라이브러리는 팩토리 API를 사용하여 헤더 정의와 행 데이터(배열 또는 객체)를 받아 테이블로 렌더링합니다. 단순한 문자열 길이가 아닌 터미널 표시 열을 기준으로 열 너비를 계산하며, breakword 라이브러리를 사용하여 Unicode 18.0.0의 동아시아 문자 폭 및 이모지 표현 표준을 처리합니다.

대상 사용자

• 구조화된 데이터를 표시해야 하는 CLI 도구를 개발하는 개발자.
• AI 에이전트(예: Claude 또는 Cursor)가 형식화된 테이블을 출력할 수 있도록 MCP 서버를 만드는 개발자.
• 브라우저 콘솔에서 터미널 스타일 테이블을 렌더링하려는 웹 개발자.

주요 기능

• MCP 서버 지원: AI 에이전트를 위한 render_table 도구를 노출하는 내장 MCP 서버가 포함되어 있습니다.
• 유니코드 인식: 복잡한 문자의 표시 너비를 정확히 측정하여 테이블이 시각적으로 깨지지 않도록 합니다.
• 유연한 입력: 배열 기반 및 객체 기반 행 데이터를 모두 지원합니다.
• 멀티 플랫폼: Node.js(v22 이상), 브라우저 및 독립 실행형 CLI 도구로 작동합니다.
• 스트리밍 지원: 스트리밍 데이터에서 테이블을 렌더링할 수 있습니다.