tecfu/tty-table

解決する問題

ターミナル環境、ブラウザコンソール、およびMCPサーバーを介して、データを整形されたASCIIまたはUnicodeテーブルとしてレンダリングする方法を提供します。絵文字や東アジア文字などの文字幅に関係なく、テキストの折り返しと整列が正しく行われることを保証します。

仕組み

このライブラリはファクトリーAPIを使用して、ヘッダー定義と行データ（配列またはオブジェクトとして）を受け取り、テーブルにレンダリングします。列幅は単純な文字列長ではなく、ターミナル表示列に基づいて計算され、breakwordライブラリを利用してUnicode 18.0.0の東アジア幅と絵文字表示の標準を処理します。

対象読者

• 構造化データを表示する必要があるCLIツールを開発する開発者。
• AIエージェント（ClaudeやCursorなど）が整形されたテーブルを出力できるようにするMCPサーバーを作成する開発者。
• ブラウザコンソールでターミナルスタイルのテーブルをレンダリングしたいWeb開発者。

主な特長

• MCPサーバーサポート: AIエージェント向けにrender_tableツールを公開する組み込みのMCPサーバーが含まれています。
• Unicode対応: 複雑な文字の表示幅を正確に測定し、テーブルが視覚的に崩れないようにします。
• 柔軟な入力: 配列ベースとオブジェクトベースの両方の行データをサポートします。
• マルチプラットフォーム: Node.js（v22以降）、ブラウザ、およびスタンドアロンのCLIツールとして動作します。
• ストリーミングサポート: ストリーミングデータからテーブルをレンダリングできます。