Repository navigation
Releases
@k8ordo/ui@3.0.0
3.0.0
Major Changes
-
トークンの
--color-logo-primaryと--color-logo-secondaryを消しました。Tailwindの橋の*-logo-primary、*-logo-secondaryと、@k8ordo/ui/tokensのDTCGの文書からも無くなります。ロゴを描く部品をuiが持たなくなったので、ロゴの色も使う側で持ちます。これまでの値は、ライトがteal-700とteal-600、ダークがteal-400とteal-500でした。 -
アイコンを自作の線画に替え、入口を
@k8ordo/ui/iconsに分けました。lucide-reactへの依存は無くなります。アイコンは1つずつ別のモジュールになり、どれもServer Componentのまま描けます(lucideのアイコンはcontextを読むClient Componentでした)。- rootの入口(
@k8ordo/ui)はアイコンをexportしなくなりました。import { XIcon } from '@k8ordo/ui/icons'と書きます。 - 名前を用途から形に改めました。
CloseIcon→XIcon、ViewIcon→EyeIcon、ViewOffIcon→EyeClosedIcon、DarkModeIcon→MoonIcon、LightModeIcon→SunIcon、PublishDateIcon→CalendarIcon、UpdateDateIcon→ClockIcon、SubscribeIcon→BookmarkIcon、NewsIcon→BellIcon、PrepareIcon→RocketIcon、BlogIcon→BookTextIcon、SlideIcon→PresentationIcon、LocationIcon→MapPinIcon、CodeXmlIcon→CodeIcon、RSSIcon→RssIcon、HorizontalWritingIcon→TextHorizontalIcon、VerticalWritingIcon→TextVerticalIcon、GoodIcon→ThumbsUpIcon、BadIcon→ThumbsDownIcon、InterestingIcon→SmileIcon、InformativeIcon→LightbulbIcon、MixedColorIcon→BlendIcon、ColorInfoIcon→PaintBucketIcon、ColorContrastIcon→ContrastIcon、AIIcon→BotIcon、AssistantIcon→BotMessageIcon、NavigationMenuIcon→MenuIcon、ForkIcon→GitForkIcon、FullscreenIcon→MaximizeIcon。意味から絵を選ぶのはAlertIcon(status)とChevronIcon(direction)だけです。 FormIcon、AccessibilityIcon、AtomIcon、BoringIcon、EasyIcon、DifficultIcon、ShallowIconを消しました。- ロゴ(
Logo、LogoIcon、GitHubIcon、TwitterIcon、QiitaIcon、ChromeIcon、EdgeIcon、FirefoxIcon、SafariIcon)を外しました。ロゴは使う側で持ちます。BaseIconを@k8ordo/ui/iconsから出したので、自分の<svg>にほかのアイコンと同じsizeの刻みを付けられます。 - 検索、設定、人、家、鉛筆、ごみ箱、矢印、ダウンロードなど、どのアプリケーションでも使う形を足しました。全部で102個と、
AlertIcon、ChevronIconです。 - 生成UIのカタログでは、
Iconのnameがsizeだけで描けるアイコンの全部になりました。名前はアイコンの名前をケバブケースにしたもので、closeはx、publish-dateはcalendar、view-offはeye-closedです。logo、github、twitter、qiitaと、消したアイコンの名前は使えません。
- rootの入口(
Minor Changes
@json-render/coreと@json-render/reactのpeerの範囲を、0.21系(>=0.21.0 <0.22.0)から0.22系(>=0.22.0 <0.23.0)に移しました。0.21系を使っている場合は、2つのパッケージを一緒に0.22系へ上げてください。json-render 0.22.0のリリースノートに挙がっている変更は@json-render/chatの追加だけで、@k8ordo/ui/json-renderと@k8ordo/ui/json-render/registryの使い方は変わりません。
Patch Changes
-
docsのコンポーネントカタログに、制御された欄がhydrateの前の入力を
onChangeで受け取らないことを書きました。サーバーが描いたHTMLの欄はReactが付く前から打てますが、Reactは打たれた値を欄に残すだけでonChangeを呼ばないので、valueの元の状態は次のキー入力まで古いままです。refで欄と状態を比べて拾う書き方を載せています。コンポーネントの動きは変えていません。Reactが同じ直し(hydrate時のchangeの送り直し)をexperimentalで持っていて、ここで別に直すと、それが入った版でonChangeが2回呼ばれるためです。 -
Updated dependencies:
- @k8ordo/i18n@3.0.0
@k8ordo/state@3.0.0
3.0.0
Minor Changes
-
definePageStateにhashを足しました。URLのフラグメントを、ページの状態の3つ目の置き場所として読み書きできます。フラグメントは1本の文字列なので、hashにはフィールドのオブジェクトではなく値1つ分のスキーマを渡し、値は状態のhashというフィールドになります。update({ hash: 4 })は#4を書き、既定値を書くとフラグメントが消え、href()にもhashを渡せます。スキーマが受け付けないフラグメント(#mainのようなページ内リンク)はこの状態の値として扱わず、既定値で読んでURLに残します。これまでは、フラグメントに置く値をhistory.replaceStateで自分で書くしかなく、そうすると同じ履歴エントリのentryの状態が消えていました。 -
テスト用の入口
@k8ordo/state/testingと、そのmountPageUrl()を足しました。URLやフラグメントを書くupdate()は、どのリスナーも横取りしなければ文書の読み込みになり、テストを動かしているページごと移動します。mountPageUrl()は@k8ordo/routerと同じ条件でルーターの代わりに横取りし、{ search, hash }でテストを始めるURLを決めます。返す関数は後始末で、resetStateRegistry()を呼んで待っている書き込みごとストアを消し、URLと履歴エントリの状態を元に戻します。VitestのbeforeEachにもStorybookのbeforeEachにも、そのまま返せます。これまでは、横取りするリスナーと後始末をテストごとに手で書く必要がありました。
Patch Changes
-
URLの値を続けて書いても、WebKitのnavigateの上限に届かないようにしました。WebKitは同じ文書へのnavigateを10秒に200回までしか通さず、超えた分を
QuotaExceededErrorで断ります。スライダーのように入力ごとにupdate()する部品は数秒でそこに届き、以降の書き込みがURLに載りませんでした。今は、URLの値を変えるreplaceの書き込みが前の書き込みから100msたっていなければ、残りの時間を待ち、そのあいだのupdate()を1回のnavigateにまとめます。画面の値はこれまでどおりupdate()のたびにすぐ変わります。history: 'push'の書き込みは待たせません。待っているあいだにページを離れた書き込みは書かれず、そのハンドルはAbortErrorで断られます。これまでは、update()の直後に同じハンドラで別のページへ移ると、その値が移った先のURLに書かれていました。 -
Updated dependencies:
- @k8ordo/router@3.0.0
@k8ordo/router@3.0.0
3.0.0
Patch Changes
-
URLからfragmentを外す移動(
/docs#apiから/docs)を、WebKitでも横取りするようにしました。WebKitはこの移動のnavigateイベントにもhashChangeを立てますが、行き先を同じ文書とは知らせず、横取りしなければ文書を読み込み直します。routerはhashChangeだけを見てブラウザに任せていたので、Safariではfragmentの付いたページからそのページ自身へのリンクをたどると、文書が読み込み直されていました。今は、文書の中のfragmentへの移動だけをブラウザに任せます。<Router>とuseInterceptedNavigation、それを使う@k8ordo/frameworkのランタイムに効きます。 -
ページが画面に出たときから、そのページでたどるリンクを横取りするようにしました。これまでは
navigateイベントを聞き始めるのがuseEffectの中で、Reactはページを画面に出してから一度ブラウザに処理を返し、そのあとでuseEffectを走らせます。そのあいだにたどったリンクは横取りされず、文書の読み込みになっていました。今はページを画面に出すcommitの中で聞き始めます。<Router>とuseInterceptedNavigation、それを使う@k8ordo/frameworkのランタイムに効きます。ハイドレーションの前にたどったリンクは、これまでどおりブラウザが文書を読み込みます。
@k8ordo/i18n@3.0.0
3.0.0
Major Changes
- staticモードで、パラメータの値を
framework()のpathsオプションではなく、パラメータのディレクトリに置くpaths.tsから読むようにしました。src/routes/blog/[slug]/paths.tsは、slugの値を配列かそのPromiseで返す関数をdefault exportします(型は@k8ordo/frameworkのPaths<'/blog/:slug'>)。これまではvite.config.tsの中で値を並べていたので、アプリのエイリアスやserver-onlyのモジュールを素直に読めず、URLの情報の一部がroutes/の外にありました。paths.tsはページと同じモジュールグラフで実行されるので、ページと同じデータの読み方をそのまま使えます。値はそのディレクトリより下のすべてに使われ、/blog/:slug/og.pngのようなroute.tsやredirect.tsのパターンを手で展開する必要はありません。関数は上のディレクトリのパラメータを引数として受け取り、上の値の組み合わせごとに1回呼ばれます。値はエスケープする前の文字列で返します。fallback.tsxのシェルの場所も、上のpaths.tsが返す値ごとに自動で決まります([locale]/paths.tsがjaとenを返せば/ja/posts/:idと/en/posts/:id)。fallback.tsxと同じディレクトリにpaths.tsを置くと、返した値はページとして書き出され、残りの値にシェルが答えます。vite devは、どのpaths.tsも返さなかった値にビルドしたサイトと同じく答えるようになりました。fallback.tsxがあればシェルで、無ければ404です。これまでは、どの値もpage.tsxで描画していました。@k8ordo/i18nのlocales.pathsは削除しました。移行するには、vite.config.tsからpathsを消し(残っていると設定を読んだ時点でエラーになります)、パラメータのディレクトリごとにpaths.tsを置きます。paths: locales.pathsを渡していたアプリは、src/routes/[locale]/paths.tsでlocales.allを返します。
@k8ordo/framework@3.0.0
3.0.0
Major Changes
- staticモードで、パラメータの値を
framework()のpathsオプションではなく、パラメータのディレクトリに置くpaths.tsから読むようにしました。src/routes/blog/[slug]/paths.tsは、slugの値を配列かそのPromiseで返す関数をdefault exportします(型は@k8ordo/frameworkのPaths<'/blog/:slug'>)。これまではvite.config.tsの中で値を並べていたので、アプリのエイリアスやserver-onlyのモジュールを素直に読めず、URLの情報の一部がroutes/の外にありました。paths.tsはページと同じモジュールグラフで実行されるので、ページと同じデータの読み方をそのまま使えます。値はそのディレクトリより下のすべてに使われ、/blog/:slug/og.pngのようなroute.tsやredirect.tsのパターンを手で展開する必要はありません。関数は上のディレクトリのパラメータを引数として受け取り、上の値の組み合わせごとに1回呼ばれます。値はエスケープする前の文字列で返します。fallback.tsxのシェルの場所も、上のpaths.tsが返す値ごとに自動で決まります([locale]/paths.tsがjaとenを返せば/ja/posts/:idと/en/posts/:id)。fallback.tsxと同じディレクトリにpaths.tsを置くと、返した値はページとして書き出され、残りの値にシェルが答えます。vite devは、どのpaths.tsも返さなかった値にビルドしたサイトと同じく答えるようになりました。fallback.tsxがあればシェルで、無ければ404です。これまでは、どの値もpage.tsxで描画していました。@k8ordo/i18nのlocales.pathsは削除しました。移行するには、vite.config.tsからpathsを消し(残っていると設定を読んだ時点でエラーになります)、パラメータのディレクトリごとにpaths.tsを置きます。paths: locales.pathsを渡していたアプリは、src/routes/[locale]/paths.tsでlocales.allを返します。
Minor Changes
-
framework()にheadersを足しました。書いたヘッダーは、ページ、ビルドのファイル、404、リダイレクトのどの応答にも付きます。これまで全応答のヘッダーはvercel()のルートにしか書けず、当てるのはVercelだけだったので、vite devやvite previewではアプリが自分でプラグインを書いて同じ値を付けていました。今は1度書けば、vite dev、vite preview、serveが送り、vercel()がどちらのモードでもルートとして書き、staticモードのビルドがNetlifyとCloudflareの読むdist/client/_headersに書きます(public/_headersはその後ろに残ります)。serverモードではハンドラも自分の応答に足し、guard.tsやroute.tsが同じ名前で書いたヘッダーはそのまま残します。扱うのは全応答に付く1組だけで、一部のパスだけのヘッダーは今までどおりvercel()のルートやpublic/_headersに書きます。HTTPで送れない名前や値は、設定を読んだ時点で断ります。 -
.mdxのファイルがimportしたCSSが、そのファイルを描くページのHTMLに載るようにしました。RSCのプラグインは、CSSをimportするモジュールがexportした部品を包んでページにスタイルシートを載せますが、包むのはファイル名が.js・.jsx・.ts・.tsxのモジュールだけです。アプリのプラグインがコンパイルした.mdxは名前で外れるので、これまではimportのすべてに?vite-rsc-css-export=defaultを付ける必要があり、付け忘れるとスタイルの無いページが黙って書き出されていました。今は、CSSを静的にimportする.mdx(と.md)にframeworkが同じ変換を当てます。クエリは要りません。付けたままでも、これまでどおり動きます。MDXのコンパイラは、今までどおりアプリがenforce: 'pre'でViteのプラグインに足します。docsのRoutingにMDXの節を足しました。 -
staticモードで、アプリが
sitemap.xmlをroute.tsで書いているときは、siteを渡していてもビルドがsitemap.xmlを書かないようにしました。これまでは両方があるとビルドが止まり、更新日や並びを自分で決めたいアプリはsiteを外すしかありませんでした。siteを外すと、route.tsが受け取るrequest.urlからもサイトの配信元が消えます。今はroutes/のroute.tsがそのURLの答えになり、siteは渡したままにできます。404.htmlやclient-files.jsonのように、ビルドが自分で書くほかのファイルにroute.tsを置いたときは、これまでどおりビルドが止まります。
Patch Changes
-
docsに、エラーの報告のしかたとページビューの数え方を足しました。エラーは
error.tsxが受け取るerrorから報告します。ルートのerror.tsxはルートレイアウト自身の部品の失敗を受けないので、その扱いと、レイアウトの中に自分のエラー境界を置く方法を書きました。ページビューは、ページの切り替えが終わったことを知らせるnavigatesuccessで数えます。usePathname()はURLに従い、次のページが届く前に変わるので、そこで数えると前のページの<title>を送ります。 -
タッチの端末で画面に入ったリンクを先読みする仕組みが、先読みの終わる前のタップを前より遅くしていたのを直しました。先読みの部品(
<link rel="modulepreload">と<link rel="preload" as="style">)は、ペイロードと同じ低い優先度で取ります。ページの切り替えを読み込んでいるあいだは新しく先読みせず、ほかのページへの先読みは取り消して、次のページが表示されてから取り直します。先読みを始めるのは、文書のloadイベントのあと、client-files.jsonを読み終えてからで、画面に1秒とどまったリンクだけを取ります。 -
reactCompiler: trueで使う任意のpeerのoxc-transform-reactの範囲を、^0.152.0から>=0.152.0 <0.157.0に広げました。フレームワークが使う@vitejs/plugin-reactを6.2.1に上げ、そのpeerの範囲に合わせています。0.152系を入れているアプリはそのまま動き、0.156系まで上げられます。 -
staticモードのビルドが書く
client-files.jsonに、ページごとのServer ComponentのCSSも並べるようにしました。先読みしていないページへ移るとき、これまではペイロードの最初の部分が届いてからServer ComponentのCSSを取り始め、ページの切り替えがその1往復を待っていました。今はペイロードと同時に、ペイロードと同じ優先度で取り始めます。ページはこれまでどおり、そのCSSが届いてから切り替わります。 -
staticモードのビルドが、ページを1回の描画で書き出すようにしました。これまではページごとにハンドラを2回呼び、
index.htmlとindex.rscを別々の描画から書いていました。Reactのcache()は描画をまたがないので、ページが読むデータベースやファイルはビルドの中で2回読まれ、2回の描画で違う値を読めば、HTMLとペイロードが食い違うこともありえました。今は、HTMLを描いたペイロードをそのままindex.rscに書きます。書き出されるファイルは変わりません。ページのデータの読み込みは、ビルドごとに1回になります。 -
Updated dependencies:
- @k8ordo/router@3.0.0
@k8ordo/form@3.0.0
Release @k8ordo/form@3.0.0.
@k8ordo/color-scheme@3.0.0
3.0.0
Patch Changes
-
ColorSchemeScriptをClient Componentにして、スクリプトの中身がページのペイロードに載らないようにしました。これまではServer Componentとして描いた<script>の中身が、各ページの.rscと、HTMLに埋め込むペイロードにも入っていました。遷移で届いた<script>は実行されないので、使われないバイトでした。今はペイロードにthemeColorなどのpropsだけが載り、サーバーの描画とハイドレーションが同じ中身を作ります。props、HTMLに書くスクリプト、colorSchemeScriptHash()が返すハッシュは変わりません。 -
Updated dependencies:
- @k8ordo/state@3.0.0
@k8ordo/ui@2.3.1
2.3.1
Patch Changes
@k8ordo/*のパッケージを、すべて同じバージョンで出すようにしました。これまで@k8ordo/uiだけは別にバージョンを上げていたので、ほかのパッケージは2.0.0から2.3.1へ飛びます。このリリースに中身の変更はありません。
@k8ordo/ui@2.3.0
2.3.0
Minor Changes
-
印刷では、
.darkが付いていても、色のトークンとcolor-schemeをライトの値に戻すようにしました。ブラウザは既定で背景を刷らないので、ダークのまま刷ると、白い紙に明るい文字が出ていました。@media printのとき、.darkが上書きする色のトークンは:rootの値になり、color-schemeはlightになります。prefers-contrast: moreのときは、ライトのハイコントラストの値になります。tailwind.cssのdark:とlight:のバリアントも、印刷ではトークンと同じく切り替わります。- 背景ごと刷るスライドのように、画面の配色のまま刷りたいときは、
print-as-shownクラスを付けた要素を置きます。この要素を含む.darkは、印刷でもダークの値のままです。背景を刷るには、print-color-adjust: exactも指定します。 @k8ordo/ui/tokensには、印刷の2つのモードが修飾子として加わります。
Patch Changes
-
強制カラーで、
Proseの本文のリンクにフォーカスがあっても、見た目が変わらなかったのを直しました。フォーカスリングをbox-shadowだけで描いていたため、強制カラーでは影と一緒に消えていました。強制カラーのときは、リンクの周りにシステムカラーで2pxの線を引きます。 -
強制カラーで、
SliderとRangeSliderとColorPickerのつまみにフォーカスがあっても、見た目が変わらなかったのを直しました。フォーカスリングをbox-shadowだけで描いていたため、強制カラーでは影と一緒に消えていました。強制カラーのときは、フォーカスのあるつまみの周りに、システムカラーで2pxの線を引きます。線はつまみの周りに引くので、RangeSliderではどちらのつまみにフォーカスがあるかも分かります。 -
Select・PasswordInput・DatePickerで、invalidの赤い枠線がフォーカス中に消えていたのを直しました。フォーカスの輪は、不正な値の欄(aria-invalid="true"の要素か、それを中に持つ枠)の枠線を消さなくなりました。TextField・Textarea・DateField・ColorPicker・Autocomplete・Comboboxの見た目は変わりません。NumberFieldは、読み取り専用や送信中にフォーカスしたとき、ほかの欄と同じく輪の内側の枠線が消えるようになりました。これまでは無効のときの色の枠線が残っていました。 -
Dialog.Content・Dialog.Headerの閉じるボタン・Drawerの中身と閉じるボタンで、クリックの伝わりを止めないようにしました。中のクリックが祖先のonClickやdocumentのリスナーに届きます。モーダルが閉じるのはこれまでどおり枠外(<dialog>自身)を押したときだけです。 -
Textareaで、キー入力の伝わりを止めないようにしました。これまではkeydownをすべて止めていたので、Popoverの中のTextareaではEscapeでPopoverが閉じませんでした(TextFieldなら閉じます)。祖先のonKeyDownやwindowのリスナーにもキー入力が届きます。 -
閉じた
Toastを、畳むtransitionが終わったところでDOMから外すようにしました。これまでは--duration-moderateと手で合わせた200msのタイマーで外していたので、トークンを変えると演出の途中で消えたり、終わってから残ったりしました。動きを減らす設定ではtransitionが無いので、閉じるとすぐに外れます。 -
Updated dependencies:
- @k8ordo/i18n@2.0.0
@k8ordo/state@2.3.1
2.3.1
Patch Changes
@k8ordo/*のパッケージを、すべて同じバージョンで出すようにしました。これまで@k8ordo/uiだけは別にバージョンを上げていたので、ほかのパッケージは2.0.0から2.3.1へ飛びます。このリリースに中身の変更はありません。