react-tools

@alneas/react-tools

スキーマフォーム、テーブル、CRUD、フィルター、レイアウトの公開Reactパッケージです。基本UIとテーマは @alneas/react-ui を正本とし、その公開版に依存します。このリポジトリが実装の正本で、ライセンスはISCです。現在の0.1.0は初回公開候補のソースです。

import { Button } from '@alneas/react-ui';
import { FormCompound, FormView } from '@alneas/react-tools/form';
import { DataTable } from '@alneas/react-tools/data-table';
import '@alneas/react-tools/styles';

ルートは基本UI、テーマ、エラー処理、共通hooks、LanguageSwitcherをexportします。フォームとテーブルは専用subpathから利用します。認証やDB接続を要求するAppProvider、 AI、PDF、Charts、Editor、Studioは今回の公開入口には含めません。

Node.js 24以降、React 19を対象とします。React、React DOM、Base UI、React Hook Form、 TanStack Queryを共有peerとして使います。CRUD契約はdata-access、汎用schemaと処理は data-engineから利用します。日本向け祝日プリセットはbusiness-jpを明示的に利用します。公開版の日付処理はホストのlocale/timezoneを基準とし、private版の地域別既定値とは区別します。

完成CSSを明示的にimportするため、利用アプリでTailwindをビルドする必要はありません。 /styles はpreflightを含まないスタイルとテーマです。全体resetが必要な場合だけ、その前に /reset.css をimportします。ThemeProviderはCSSを自動読み込みしません。フォントはシステムフォントを使い、この段階ではフォントバイナリーを配布しません。

使用例、開発、公開手順を参照してください。

パッケージ境界とStorybookに分割と検証方法をまとめています。

汎用UIは/kanban・/calendar・/gantt・/file-browser・/authで公開します。/chartと/barcodeはoptional peerを導入して利用します。

利用アプリのAI設定

ビルド時に正確なexports・peer依存・CSSパスをdist/ai/package-context.jsonへ生成します。設定のプレビューは次のコマンドで行います。

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

--writeを付けるとAGENTS.mdとCLAUDE.mdの境界付きブロックを更新し、既存の指示を保持します。手順はdist/ai/skills/に同梱します。

React／React DOM 19限定です。対応する19.xの最小バージョンはpeerDependenciesを参照してください。

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

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