tscircuitでTypeScriptから実回路の設計データを作る

回路をReactの部品として記述する発想

tscircuitは、TypeScriptとReactを使って実世界の電子回路を作るためのプロジェクトです。READMEはこれをReact for Circuitsと表現し、Web要素のdivを並べる代わりに、回路の要素をコードで組み立てる例を示しています。回路図や基板レイアウトを別々の画面だけで扱うのではなく、プログラムの構造を利用して部品を再利用できる点が入口になります。

READMEの説明には、ライブラリに加えてレジストリ、パッケージマネージャー、コマンドラインツール、AI電子設計スイートが含まれます。作成した回路を共有し、書き出し、製造へつなぐための周辺をまとめた構成です。これはTypeScriptで電子設計を始めやすくする方針を示しますが、Web開発の知識だけで電気設計の判断が済むわけではありません。部品定格、接続、製造上の制約は別に確認する必要があります。

CLIからプレビューまでの最短経路

READMEに示される最初の手順は、npm install -g tscircuitでCLIを入れ、tsci devを起動する流れです。ローカル開発用のコマンドから回路を表示し、コードを変更して結果を見る構成になっています。初回はグローバルに入ったCLIの版、Node.jsの環境、プロジェクト側の依存関係を保存しておくと、後で結果を比較しやすくなります。

導入時に確認する対象は、表示できるかだけではありません。抵抗やICなどの部品が意図した位置に置かれるか、接続名が崩れないか、配線を追加したときに別のネットへ触れないかを小さな回路で確認します。READMEは、tscircuitがReact Nativeやreact-three-fiberと同じ仕組みを使うと説明していますが、実装の細部やエラー処理をすべて説明しているわけではありません。表示結果と出力ファイルを分けて点検するのが現実的です。

自動配線と製造用ファイルの意味

More Featuresの一覧には、拡張可能なPCB自動配線、レジストリへのtsci push、Gerber、Pick and Place、BOMの出力が挙げられています。設計コードを書いたあと、製造に必要な複数の形式へ変換する道筋が用意されていることが分かります。部品表を別に手作業で作らずに済む可能性は、コードと成果物を対応づけたい場合に役立ちます。

一方、自動配線の結果が製造可能であることや、出力したBOMが発注先の形式にそのまま合うことは、機能一覧だけでは判断できません。基板の層数、クリアランス、部品の在庫、製造業者のデータ仕様を照合します。READMEにあるFully functional keyboardの例も、機能の射程を示す紹介であり、個別の設計を検証済みだという証明ではありません。初回は単純な回路で各成果物を開き、設計者と製造担当が同じネットと部品を確認してください。

ライブラリ、レジストリ、AIの役割を分ける

tscircuitは単一のUIライブラリとして完結するのではなく、回路を作るコード、共有先となるレジストリ、パッケージ管理、CLIを組み合わせます。パッケージを公開するためのtsci pushがあるため、回路部品を再利用する単位として管理する考え方が見えます。開発チーム内で部品を共有するときは、名前、版、ピンの意味をコードと一緒に残すと、回路の参照を追いやすくなります。

READMEはAI toolsにも触れていますが、AIが電気的な設計レビューを代行するとは説明していません。生成されたコードや配線案は、設計者が回路図、ネットリスト、製造ファイルを照合する対象です。特に電源、接地、極性、部品の定格は、見た目が正しくても別の確認が必要です。AIを使う場合も、コード生成と設計承認の担当を分けるほうが責任範囲を明確にできます。

MIT公開と文書にない互換条件

メタデータでは、tscircuitの主な言語はTypeScript、既定ブランチはmain、ライセンスはMITです。MITは表示と許諾文を保った利用、改変、配布を認めます。READMEは無償でMITライセンスのオープンソースだと説明します。ライセンスはコードの扱いを示しますが、基板の安全性、製造業者の保証、回路の動作を保証しません。

READMEだけでは、対応する基板製造サービスの一覧、配線性能の基準、ブラウザやNode.jsの互換表は確認できません。ここを推測で埋めると、ソフトウェアの出力と製造工程を混同します。導入前に、利用する部品ライブラリ、製造会社のファイル仕様、対象OS、CLIの版を固定し、同じ小規模回路を繰り返し出力して差分を残してください。

電子設計をコード化する人の選択肢

tscircuitは、回路設計をコードレビューやパッケージ再利用の流れに寄せたい人に合います。TypeScriptとReactに慣れた開発者が、キーボードのような複数部品の設計をコードで管理し、製造向けのファイルへ出力する道を試せます。対して、回路図を視覚的に編集することが前提のチームや、製造業者の厳密な入力形式を最初から満たす必要がある案件では、出力の検査工程を別に持つ必要があります。

取得時点のメタデータではstarは2,373、forkは293、open issueは21件、直近のリリース情報が用意されています。数値は活動の規模を読む材料にとどめます。まずnpm install -g tscircuitとtsci devで簡単な回路を表示し、部品、ネット、配線、Gerber、BOMを順に確認する。その結果を設計レビューへ回せる体制があるかを、採用判断の最初の条件にしてください。

編集部の結論

tscircuitは、Web開発に近いTypeScriptとReactの記法で電子回路を記述し、基板製造に使うGerber、Pick and Place、BOMを出力したい人に向きます。READMEにはCLIの導入方法やキーボードの例がありますが、製造業者ごとの受入条件、配線品質、電気的な正しさを保証する資料ではありません。小さな回路を実装し、生成物を設計者と製造工程の両方で確認してから利用範囲を広げてください。

公式情報源

1. Official documentation
2. Official README
3. Project repository