textbringer-tree-sitter 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 3db9faa01f7e0e122ecf363a3817feca949f4e1792efbc4b45287d61f78da2d3
+  data.tar.gz: 8c3a66c4f5471534404f1c9832681cc98921b3ddb9e5ef40cdfb53a8192fb943
+SHA512:
+  metadata.gz: 8457d2c8b25b8061fe3771a58a5e40e53d2aec3cdae3c16b95646684bdd0000596da53d337d802f52fd4116c5059f732b2fbeec398fc901de2d95b4a981612b1
+  data.tar.gz: 8f5a6c6f52ce92bda387f6d52978485c10a89a339692d0a4d8db57f5e72574046d9ff0e22ca0205b59570150cad46ccce71e71285e26054cb5837858aaec4949

data/CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## プロジェクト概要
+
+Textbringer（Ruby製ターミナルエディタ）に Tree-sitter ベースのシンタックスハイライトを提供するプラグイン gem。textbringer-rouge の代替として、より正確な構文解析を実現する（特に Terraform/HCL で Rouge の lexer に問題があるため）。
+
+## 開発コマンド
+
+```bash
+bundle install
+bundle exec rake test
+bundle exec ruby -Ilib:test test/test_*.rb  # 単一テスト
+bundle exec rake build
+bundle exec rubocop
+```
+
+## アーキテクチャ
+
+### 構造
+
+```
+lib/
+├── textbringer/
+│   ├── tree_sitter_adapter.rb    # Window モンキーパッチ + アダプター
+│   ├── tree_sitter_config.rb     # Parser ロード、フェイス定義
+│   └── tree_sitter/
+│       ├── version.rb
+│       └── node_maps/            # 言語ごとのノードマッピング
+│           ├── ruby.rb
+│           └── hcl.rb
+└── textbringer_plugin.rb         # エントリポイント
+parsers/                          # プリビルド parser (.dylib/.so)
+├── darwin-arm64/
+└── linux-x64/
+```
+
+### 主要コンポーネント
+
+- **TreeSitterAdapter**: Window クラスをモンキーパッチして `custom_highlight` を実装
+- **TreeSitterConfig**: プラットフォーム判定と parser ロード
+- **NodeMaps**: 言語固有のノードタイプ → Face マッピング
+
+### 依存関係
+
+- `ruby_tree_sitter` (~> 2.0) - Faveod/ruby-tree-sitter
+- `textbringer` (>= 1.0)
+
+## Tree-sitter Parser
+
+### LANGUAGE_VERSION 互換性
+
+ruby_tree_sitter 2.0.0 は LANGUAGE_VERSION 6-14 をサポート。parser ビルド時は互換性を確認：
+
+```bash
+grep LANGUAGE_VERSION src/parser.c | head -1
+```
+
+### HCL Parser のビルド
+
+mitchellh/tree-sitter-hcl を使用（LANGUAGE_VERSION 13）：
+
+```bash
+git clone https://github.com/mitchellh/tree-sitter-hcl.git
+cd tree-sitter-hcl
+c++ -shared -fPIC -O2 -std=c++14 -Isrc src/parser.c src/scanner.cc -o libtree-sitter-hcl.dylib
+```
+
+### プリビルド parser の取得
+
+Faveod/tree-sitter-parsers から取得可能：bash, c, javascript, json, python, ruby, rust 等
+
+## 参考実装
+
+- [textbringer-rouge](https://github.com/yancya/textbringer-rouge) - Window モンキーパッチの実装パターン

data/LICENSE.txt

@@ -0,0 +1,13 @@
+DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

data/README.md

@@ -0,0 +1,125 @@
+# textbringer-tree-sitter
+
+Tree-sitter による Textbringer のシンタックスハイライトプラグイン。
+
+## 特徴
+
+- Tree-sitter による正確な構文解析
+- Rouge で認識されない Terraform/HCL の `for`, `in`, 関数呼び出しを正しくハイライト
+- Emacs 風の feature-based レベル制御
+- カスタマイズ可能なノードマッピング
+
+## インストール
+
+```ruby
+gem 'textbringer-tree-sitter'
+```
+
+gem install 時に以下の parser が自動でダウンロードされます:
+- Ruby, Python, JavaScript, JSON, Bash
+
+### 追加 Parser のインストール
+
+```bash
+# 利用可能な parser を確認
+textbringer-tree-sitter list
+
+# HCL (Terraform) parser をビルド＆インストール
+textbringer-tree-sitter get hcl
+
+# YAML parser をビルド＆インストール
+textbringer-tree-sitter get yaml
+
+# Go parser をビルド＆インストール
+textbringer-tree-sitter get go
+
+# プリビルド済み parser をすべてインストール
+textbringer-tree-sitter get-all
+```
+
+### Parser の配置場所
+
+Parser は `~/.textbringer/parsers/{platform}/` に配置されます。
+
+```bash
+# 配置先を確認
+textbringer-tree-sitter path
+```
+
+## 使い方
+
+Mode で `use_tree_sitter` を呼ぶだけ:
+
+```ruby
+class RubyMode < ProgrammingMode
+  extend Textbringer::TreeSitterAdapter::ClassMethods
+  use_tree_sitter :ruby
+end
+```
+
+## カスタマイズ
+
+### ハイライトレベル (Emacs 風)
+
+```ruby
+# ~/.textbringer.rb
+
+# Level 1: comment, string のみ
+# Level 2: + keyword, type, constant
+# Level 3: + function_name, variable, number (デフォルト)
+# Level 4: + operator, punctuation, builtin
+
+CONFIG[:tree_sitter_highlight_level] = 4
+```
+
+### 個別 Feature 指定
+
+```ruby
+CONFIG[:tree_sitter_enabled_features] = [:comment, :string, :keyword]
+```
+
+### カスタムノードマッピング
+
+```ruby
+Textbringer::TreeSitter::NodeMaps.register(:ruby, {
+  my_custom_node: :keyword
+})
+```
+
+### カスタム Parser パス
+
+```ruby
+CONFIG[:tree_sitter_parser_dir] = "/path/to/your/parsers"
+```
+
+## サポート言語
+
+### 自動インストール（プリビルド）
+
+| 言語 | 状態 |
+|------|------|
+| Ruby | ✓ 自動 |
+| Python | ✓ 自動 |
+| JavaScript | ✓ 自動 |
+| JSON | ✓ 自動 |
+| Bash | ✓ 自動 |
+| C | `get c` |
+| Java | `get java` |
+| Rust | `get rust` |
+| HTML | `get html` |
+| PHP | `get php` |
+
+### 要ビルド（コマンドで取得）
+
+| 言語 | コマンド |
+|------|----------|
+| HCL (Terraform) | `textbringer-tree-sitter get hcl` |
+| YAML | `textbringer-tree-sitter get yaml` |
+| Go | `textbringer-tree-sitter get go` |
+| TypeScript | `textbringer-tree-sitter get typescript` |
+| C# | `textbringer-tree-sitter get csharp` |
+| Groovy | `textbringer-tree-sitter get groovy` |
+
+## ライセンス
+
+WTFPL

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+end
+
+task default: :test