パッケージ
- @k8ordo/uiボタンもダイアログもServer Componentに置けるReactのコンポーネント集です。メニューやツールチップはPopover APIで最前面に開くので、
z-indexを調整する必要はありません。 - @k8ordo/formzodのスキーマから、HTMLの制約属性とサーバーの検証を作るReactのフォームライブラリです。制約はHTMLの属性に入るので、JavaScriptの読み込み前からブラウザが入力を確かめます。
- @k8ordo/stateURLや履歴エントリ、localStorage、Cookieの値を
useStateのように読み書きします。どこに置いた値もzodのスキーマで型付けし、同じフックで扱えます。 - @k8ordo/routerNavigation APIでページを切り替えるReactのルーターです。
hrefとnavigateToはルート表の型で検査され、リンクは<a>のまま書けます。 - @k8ordo/frameworkReact Server ComponentsのアプリをViteでビルドするフレームワークです。同じ書き方のまま、
mode: 'static'でサーバーなしのアプリに、mode: 'server'でサーバーありのアプリにできます。src/routes/のディレクトリが、そのままURLになります。 - @k8ordo/i18n文言を関数として書き、Server ComponentでもClient Componentでも同じ1行で呼ぶReactの国際化です。
defineLocalesに書いたロケールの一覧で、訳し忘れを型で検査します。言語の選択とURLのロケールの付け外しも、この一覧を使います。 - @k8ordo/color-scheme訪問者が選んだ配色をlocalStorageに保存し、OSの設定と合わせて
<html>のdarkクラスに反映するReactのダークモードです。ルートレイアウトの<head>に置くスクリプトが、最初の描画の前にdarkクラスを付けます。そのあとはプロバイダが、OSの設定や保存した選択の変化に合わせてクラスを更新します。
共通の前提
Baselineだけ
主要な4つのブラウザがすべて対応した時点(Baseline newly available)で、新しい機能を使います。その30か月後のwidely availableは待ちません。ポリフィルとフォールバックは持たないので、古いブラウザでは動きません。
Reactの最新に追従する
React 19とServer Componentsを前提にし、新しい書き方が出れば取り入れます。互換性のために古い書き方は残しません。どのパッケージも書き方は1つです。
TypeScript Safe
間違った使い方は、書いた時点で型エラーになるように作っています。ドキュメントや生成物も型から作るので、実装と食い違いません。
エージェントが読める
どのパッケージも、自分のドキュメントをnpmパッケージに同梱しています。エージェントは
node_modules/@k8ordo/<name>/docs/から、インストールしたバージョンのドキュメントを読めます。