@k8ordo/state

このページで動いています

下の操作は本物のURLを書き換えます。definePageState の update がこのサイトのルーター（Navigation API を intercept する @k8ordo/router）を通って流れます。ヘッダーのテーマ切り替えの保存先も defineLocalState で、その現在値が theme の行です。

特徴

• 置き場所で宣言するURL・履歴エントリ・localStorage・メモリ。状態の寿命と共有範囲を決めるのはコードの書き方ではなく、定義した場所です。
• 出所はスキーマ1つparseUrl・リンク生成・古いデータのサルベージまで、書いたスキーマから導かれます。検索フォームの制約（@k8ordo/form）と同じスキーマを共有できます。
• Navigation APIに載るURLと隠れたエントリ状態は、同じ履歴エントリの2つの面です。1回の navigate で原子的に更新され、戻るで両方が一緒に戻ります。
• キー単位の購読購読するキーを列挙すれば、それ以外のフィールドの更新では再レンダーされません。スキーマがキー集合を固定しているので、判定は正確です。
• 不正な値は表示されないupdate はその場でスキーマを通り、URL に手で書かれた不正値はフィールド単位で default に落ちます。default の値はクエリから省かれるので、同じ状態は常に同じ URL になります。
• サーバーが読めるURL 状態は RSC が parseUrl で型付きに読めます。リンクと GET フォームはどのルーターでも、JavaScript なしでも動きます。

ドキュメント

設計ガイドとリファレンスは npm パッケージに同梱されています。AIコーディングエージェントは node_modules/@k8ordo/state/docs/ からインストールした版そのものを読みます。