Wording the components render on their own — close button labels, the required badge, the loading announcement — comes from a message dictionary. Replace the dictionary and the language changes without touching your own code.
Japanese by default
No setup required. UIProvider uses the Japanese dictionary, and components fall back to the same Japanese wording even without a provider.
Switching to English
Import en from @k8ordo/ui/i18n and pass it to messages. ja ships from the same entry point.
Overriding part of a dictionary
messages is a Partial<Messages>. Only the keys you pass are replaced; the rest fall back to the Japanese defaults. To start from English instead, spread en first and layer your changes on top.
Resolution order
Three sources can decide a string, and they win in the order prop > dictionary > default. Per-instance props (such as the Spinner label) always beat the dictionary, so reach for them when only one place should read differently.
Writing your own dictionary
Annotate with the Messages type and missing or misspelled keys become compile errors — including when the library adds a key.
Key reference
Every key in Messages. The values below are read from the shipped dictionaries themselves.
close
Used by: Alert / Dialog / Drawer
ja (default): 閉じる
en: Close
required
Used by: FormControl
ja (default): 必須
en: Required
loading
Used by: Spinner
ja (default): 読み込み中
en: Loading
avatar
Used by: Avatar
ja (default): アバター
en: Avatar
color
Used by: Code
ja (default): 色
en: Color
alertSuccess
Used by: Alert
ja (default): 成功
en: Success
alertInfo
Used by: Alert
ja (default): 情報
en: Information
alertWarning
Used by: Alert
ja (default): 警告
en: Warning
alertError
Used by: Alert
ja (default): エラー
en: Error
toastRegion
Used by: Toast
ja (default): 通知
en: Notifications
autocompletePlaceholder
Used by: Autocomplete
ja (default): 入力して絞り込めます
en: Type to filter
autocompleteRemoveTag
Used by: Autocomplete
ja (default): タグを削除
en: Remove tag
autocompleteClear
Used by: Autocomplete
ja (default): すべて削除
en: Clear all
autocompleteEmpty
Used by: Autocomplete
ja (default): 該当なし
en: No results
fileFieldRemove
Used by: FileField
ja (default): ファイルを削除
en: Remove file
fileFieldTrigger
Used by: FileField(生成 UI)
ja (default): ファイルを選択
en: Select files
numberFieldIncrement
Used by: NumberField
ja (default): 増やす
en: Increase
numberFieldDecrement
Used by: NumberField
ja (default): 減らす
en: Decrease
passwordShow
Used by: PasswordInput
ja (default): パスワードを表示
en: Show password
passwordHide
Used by: PasswordInput
ja (default): パスワードを非表示
en: Hide password
listBoxPlaceholder
Used by: ListBox
ja (default): 選択してください
en: Select an option
breadcrumb
Used by: Breadcrumb
ja (default): パンくずリスト
en: Breadcrumb
tabList
Used by: Tabs(生成 UI)
ja (default): タブ
en: Tabs
paginationLabel
Used by: Pagination
ja (default): ページネーション
en: Pagination
paginationPrevious
Used by: Pagination
ja (default): 前へ
en: Previous
paginationNext
Used by: Pagination
ja (default): 次へ
en: Next
chat
Used by: Conversation.Messages
ja (default): チャット
en: Chat
scrollToLatest
Used by: Conversation.ScrollButton
ja (default): 最新のメッセージへ移動
en: Scroll to latest message
reasoning
Used by: Reasoning
ja (default): 思考の過程
en: Reasoning
reasoningStreaming
Used by: Reasoning
ja (default): 思考中…
en: Thinking…
suggestions
Used by: Suggestion.List
ja (default): 候補
en: Suggestions
send
Used by: PromptInput
ja (default): 送信
en: Send
stop
Used by: PromptInput
ja (default): 停止
en: Stop
toolInput
Used by: ToolInvocation
ja (default): 入力
en: Input
toolOutput
Used by: ToolInvocation
ja (default): 出力
en: Output
toolError
Used by: ToolInvocation
ja (default): ツールの実行でエラーが発生しました。
en: The tool failed to run.
toolDenied
Used by: ToolInvocation
ja (default): ツールの実行は許可されませんでした。
en: The tool run was not approved.
responseCopied
Used by: Response
ja (default): コピーしました
en: Copied
responseCopyCode
Used by: Response
ja (default): コードをコピー
en: Copy code
responseCopyLink
Used by: Response
ja (default): リンクをコピー
en: Copy link
responseCopyTable
Used by: Response
ja (default): 表をコピー
en: Copy table
responseCopyTableAsCsv
Used by: Response
ja (default): 表を CSV でコピー
en: Copy table as CSV
responseCopyTableAsMarkdown
Used by: Response
ja (default): 表を Markdown でコピー
en: Copy table as Markdown
responseCopyTableAsTsv
Used by: Response
ja (default): 表を TSV でコピー
en: Copy table as TSV
responseDownloadDiagram
Used by: Response
ja (default): 図をダウンロード
en: Download diagram
responseDownloadDiagramAsMmd
Used by: Response
ja (default): 図を MMD でダウンロード
en: Download diagram as MMD
responseDownloadDiagramAsPng
Used by: Response
ja (default): 図を PNG でダウンロード
en: Download diagram as PNG
responseDownloadDiagramAsSvg
Used by: Response
ja (default): 図を SVG でダウンロード
en: Download diagram as SVG
responseDownloadFile
Used by: Response
ja (default): ファイルをダウンロード
en: Download file
responseDownloadImage
Used by: Response
ja (default): 画像をダウンロード
en: Download image
responseDownloadTable
Used by: Response
ja (default): 表をダウンロード
en: Download table
responseDownloadTableAsCsv
Used by: Response
ja (default): 表を CSV でダウンロード
en: Download table as CSV
responseDownloadTableAsMarkdown
Used by: Response
ja (default): 表を Markdown でダウンロード
en: Download table as Markdown
responseExitFullscreen
Used by: Response
ja (default): 全画面表示を終了
en: Exit fullscreen
responseViewFullscreen
Used by: Response
ja (default): 全画面表示
en: View fullscreen
responseImageNotAvailable
Used by: Response
ja (default): 画像を表示できません
en: Image not available
responseOpenExternalLink
Used by: Response
ja (default): 外部リンクを開きますか?
en: Open external link?
responseExternalLinkWarning
Used by: Response
ja (default): 外部サイトに移動しようとしています。
en: You're about to visit an external website.
responseOpenLink
Used by: Response
ja (default): リンクを開く
en: Open link
Key
Used by
ja (default)
en
close
Alert / Dialog / Drawer
閉じる
Close
required
FormControl
必須
Required
loading
Spinner
読み込み中
Loading
avatar
Avatar
アバター
Avatar
color
Code
色
Color
alertSuccess
Alert
成功
Success
alertInfo
Alert
情報
Information
alertWarning
Alert
警告
Warning
alertError
Alert
エラー
Error
toastRegion
Toast
通知
Notifications
autocompletePlaceholder
Autocomplete
入力して絞り込めます
Type to filter
autocompleteRemoveTag
Autocomplete
タグを削除
Remove tag
autocompleteClear
Autocomplete
すべて削除
Clear all
autocompleteEmpty
Autocomplete
該当なし
No results
fileFieldRemove
FileField
ファイルを削除
Remove file
fileFieldTrigger
FileField(生成 UI)
ファイルを選択
Select files
numberFieldIncrement
NumberField
増やす
Increase
numberFieldDecrement
NumberField
減らす
Decrease
passwordShow
PasswordInput
パスワードを表示
Show password
passwordHide
PasswordInput
パスワードを非表示
Hide password
listBoxPlaceholder
ListBox
選択してください
Select an option
breadcrumb
Breadcrumb
パンくずリスト
Breadcrumb
tabList
Tabs(生成 UI)
タブ
Tabs
paginationLabel
Pagination
ページネーション
Pagination
paginationPrevious
Pagination
前へ
Previous
paginationNext
Pagination
次へ
Next
chat
Conversation.Messages
チャット
Chat
scrollToLatest
Conversation.ScrollButton
最新のメッセージへ移動
Scroll to latest message
reasoning
Reasoning
思考の過程
Reasoning
reasoningStreaming
Reasoning
思考中…
Thinking…
suggestions
Suggestion.List
候補
Suggestions
send
PromptInput
送信
Send
stop
PromptInput
停止
Stop
toolInput
ToolInvocation
入力
Input
toolOutput
ToolInvocation
出力
Output
toolError
ToolInvocation
ツールの実行でエラーが発生しました。
The tool failed to run.
toolDenied
ToolInvocation
ツールの実行は許可されませんでした。
The tool run was not approved.
responseCopied
Response
コピーしました
Copied
responseCopyCode
Response
コードをコピー
Copy code
responseCopyLink
Response
リンクをコピー
Copy link
responseCopyTable
Response
表をコピー
Copy table
responseCopyTableAsCsv
Response
表を CSV でコピー
Copy table as CSV
responseCopyTableAsMarkdown
Response
表を Markdown でコピー
Copy table as Markdown
responseCopyTableAsTsv
Response
表を TSV でコピー
Copy table as TSV
responseDownloadDiagram
Response
図をダウンロード
Download diagram
responseDownloadDiagramAsMmd
Response
図を MMD でダウンロード
Download diagram as MMD
responseDownloadDiagramAsPng
Response
図を PNG でダウンロード
Download diagram as PNG
responseDownloadDiagramAsSvg
Response
図を SVG でダウンロード
Download diagram as SVG
responseDownloadFile
Response
ファイルをダウンロード
Download file
responseDownloadImage
Response
画像をダウンロード
Download image
responseDownloadTable
Response
表をダウンロード
Download table
responseDownloadTableAsCsv
Response
表を CSV でダウンロード
Download table as CSV
responseDownloadTableAsMarkdown
Response
表を Markdown でダウンロード
Download table as Markdown
responseExitFullscreen
Response
全画面表示を終了
Exit fullscreen
responseViewFullscreen
Response
全画面表示
View fullscreen
responseImageNotAvailable
Response
画像を表示できません
Image not available
responseOpenExternalLink
Response
外部リンクを開きますか?
Open external link?
responseExternalLinkWarning
Response
外部サイトに移動しようとしています。
You're about to visit an external website.
responseOpenLink
Response
リンクを開く
Open link
import { UIProvider } from '@k8ordo/ui';function App({ children }) { return <UIProvider>{children}</UIProvider>;}
import { UIProvider } from '@k8ordo/ui';import { en } from '@k8ordo/ui/i18n';function App({ children }) { return ( <UIProvider messages={en}> {children} </UIProvider> );}
import { en } from '@k8ordo/ui/i18n';<UIProvider messages={{ close: '閉じる (Esc)' }}> {children}</UIProvider><UIProvider messages={{ ...en, autocompleteEmpty: 'No matches' }}> {children}</UIProvider>