@k8ordo/ui

ボタンもダイアログもServer Componentに置けるReactのコンポーネント集

bash
npm install @k8ordo/ui @k8ordo/i18n
main.tsx
import '@k8ordo/ui/styles.css';
subscribe-form.tsx
<FormControl
  label="Email"
  renderInput={(props) => (
    <TextField {...props} type="email" />
  )}
/>
<Button type="submit" variant="solid">
  Subscribe
</Button>

最前面に開くメニューとツールチップ

メニューやツールチップはPopover APIで最前面に開き、位置はCSS Anchor Positioningで指定します。z-indexを調整する必要はありません。

使うのはBaselineに入ったブラウザの機能だけです。polyfillも、古いブラウザのための分岐もありません。

Playground

メニューとツールチップのデモ

どちらも@k8ordo/uiのコンポーネントをそのまま置いています。

最後に選んだ操作
—

試してみる

  1. 「操作」を押してメニューを開きます。矢印キーで項目を移動し、Escキーで閉じます。
  2. 封筒のボタンにポインタを合わせるか、Tabキーでフォーカスを移します。ボタンの名前がツールチップで表示されます。

縦書きでも同じコンポーネント

writing-vを付けた要素の中では、コンポーネントも縦書きで表示されます。propsを渡す必要はありません。

日本語を縦書きで組むページのために、ボタンやカードを別に用意する必要はありません。

Playground

縦書きのデモ

スイッチで、下のカードのwriting-modeを切り替えます。

お知らせ

縦書きの紙面

同じコンポーネントが、文字の向きに合わせて組み替わります。

エージェント用の文書と生成UIのカタログ

設計の指針とリファレンスはnpmパッケージに同梱しています。エージェントはnode_modules/@k8ordo/ui/docs/から、インストールしたバージョンのドキュメントを読めます。

LLMに画面を組み立てさせるときは、json-renderかOpenUIのカタログを使います。カタログはコンポーネントのpropsの型と照合しているので、実装と食い違いません。

gen-ui.tsx
const systemPrompt = catalog.prompt({
  customRules: [...uiRules],
});

const result = validateGeneratedSpec(JSON.parse(llmOutput));
if (result.ok) return <JsonRenderUI spec={result.spec} />;