react-ai

@alneas/react-ai

Generative UI、提案レビュー、人が確認して実行するアクション向けのReactコンポーネントとフックです。MITライセンスで、このPublicリポジトリが正本です。 @alneas/ai-core の公開npm版へ依存します。

npm install @alneas/react-ai react react-dom

React/React DOM 18以降、Node.jsで使う場合は24以降が必要です。 /generative-ui、/proposal、/action を個別にimportできます。ルートは3つをまとめてexportします。ESM・CommonJSとそれぞれの型定義を配布します。 UIはheadlessで、見た目・保存・認証情報・実行権限の確認はアプリ側が担当します。

Generative UIでは、利用可能なコンポーネントを明示的に登録し、生成されたJSONデータを同期的で副作用のないバリデーターで検証します。モデルの出力に実行コード・HTML・認証情報・コールバックを含めません。dataSchema で扱えるのはai-coreが対応するinline JSON Schemaの範囲です。構造の検証だけでは業務上の妥当性や実行権限を保証しません。すべての登録にスキーマがある場合だけ、registryから documentSchema を取得できます。

英語READMEの使用例と ai-coreの仕様・利用条件を確認してください。APIの引数・戻り値の詳細はソースのJSDocを参照します。

開発・検証は CONTRIBUTING.md、初回の依存解決とnpm公開は RELEASING.md に記載しています。privateリポジトリからのソース同期は行いません。

DOM操作テストはReact 19と隔離したReact 18.3.1で実行し、StrictMode登録・最新callback・unmount中止・連打・proposal/batch切替・hydration・error boundaryを確認します。React peerは検証対象の18/19系に限定します。jsdomでの操作検証であり、storageは別途実Chromiumで確認します。

React 18.3/19で、実際のGenerativeUIRenderer・ScreenActionProvider・hookを使うSSR→hydration→click→文書再描画→unmountと、hook操作を検証します。配布tarballも両React型環境で全export・renderer propsをESM/CJS、Node型の有無双方で型検査します。サーバー・クライアントは同じ初期input・registryを使用してください。validatorは純粋な処理にし、登録コンポーネント自体もSSR/hydrationに対応させてください。利用側のブラウザー専用コンポーネントまでサーバー実行可能にする機能ではありません。

AI SDK 7の任意チャット連携

React 18／19に対応します。18.3.1の専用互換テストを維持します。

AI利用ガイドは配布物の dist/ai/SKILL.md と package-context.json に同梱します。次のコマンドはプロジェクトの指示ファイルへの追記をプレビューします。確認後に --write を付けると既存の指示を保持して反映します。

node node_modules/@alneas/react-ai/dist/ai/setup.mjs --project .