react-ui

@alneas/react-ui

Base UI、Tailwindテーマ、基本部品、controlledな検索Selectを持つ独立パッケージです。 Node 24以降、React 19を対象とし、共有peerはReact・React DOM・Base UIだけです。 Buttonだけの導入にschema・CRUD・React Hook Form・Query・Table・DnDは入りません。

import { Button, ThemeProvider } from '@alneas/react-ui';
import '@alneas/react-ui/styles';
<ThemeProvider><Button>保存</Button></ThemeProvider>

合成は render に統一しています。スキーマフォーム、CRUD連携、DataTable、 CSV/Excelダイアログ、日付処理は @alneas/react-tools が担当します。 両パッケージでテーマの実装・Contextは共有されます。

使い方と合成、開発・検証を参照してください。 Storybookは開発専用で、a11y違反をCIのエラーとして扱います。 現在はローカルの初回公開候補で、npm公開は別途行います。

/hooksのuseGPSはマウント後に位置情報を1回要求します。未取得・拒否・未対応ではundefinedを返し、アンマウント後の応答は無視します。利用側で位置情報の許可と安全な実行環境を用意してください。

利用アプリのAI設定

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

node node_modules/@alneas/react-ui/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-ui/dist/ai/setup.mjs --project .