@k8ordo/ui 2.0.0 → 2.1.0

package/dist/helpers/merge-refs.mjs

@@ -19,37 +19,5 @@ const mergeRefs = (...refs) => (value) => {
 		for (const cleanup of cleanups) cleanup();
 	};
 };
-if (import.meta.vitest) describe("mergeRefs", () => {
-	it("オブジェクトrefと関数refの両方に値を設定する", () => {
-		const objectRef = { current: null };
-		const functionRef = vi.fn();
-		const element = {};
-		mergeRefs(objectRef, functionRef)(element);
-		expect(objectRef.current).toBe(element);
-		expect(functionRef).toHaveBeenCalledWith(element);
-	});
-	it("nullとundefinedのrefをスキップする", () => {
-		const objectRef = { current: null };
-		const element = {};
-		const cleanup = mergeRefs(null, void 0, objectRef)(element);
-		expect(objectRef.current).toBe(element);
-		expect(cleanup).toBeTypeOf("function");
-	});
-	it("クリーンアップでオブジェクトrefをnullに戻し、関数refをnullで呼ぶ", () => {
-		const objectRef = { current: null };
-		const functionRef = vi.fn();
-		mergeRefs(objectRef, functionRef)({})?.();
-		expect(objectRef.current).toBeNull();
-		expect(functionRef).toHaveBeenLastCalledWith(null);
-	});
-	it("クリーンアップ関数を返す関数refは、nullで再呼び出しせずそのクリーンアップを実行する", () => {
-		const refCleanup = vi.fn();
-		const functionRef = vi.fn(() => refCleanup);
-		mergeRefs(functionRef)({})?.();
-		expect(refCleanup).toHaveBeenCalledOnce();
-		expect(functionRef).toHaveBeenCalledOnce();
-		expect(functionRef).not.toHaveBeenCalledWith(null);
-	});
-});
 //#endregion
 export { mergeRefs };

package/dist/hooks/click-away/index.d.mts

@@ -1,5 +1,4 @@
 import { RefObject } from "react";
 //#region src/hooks/click-away/index.d.ts
-declare const useClickAway: <T extends Element = HTMLElement>(ref: RefObject<T | null>, callback: (e: Event) => void, enabled?: boolean) => void;
-//#endregion
-export { useClickAway };
+export declare const useClickAway: <T extends Element = HTMLElement>(ref: RefObject<T | null>, callback: (e: Event) => void, enabled?: boolean) => void;
+//#endregion

package/dist/hooks/controllable-state/index.d.mts

@@ -4,6 +4,5 @@ type UseControllableStateProps<T> = {
   defaultValue: T;
   onChange?: (value: T) => void;
 };
-declare const useControllableState: <T>({ value, defaultValue, onChange }: UseControllableStateProps<T>) => [T, (next: T | ((prev: T) => T)) => void];
-//#endregion
-export { useControllableState };
+export declare const useControllableState: <T>({ value, defaultValue, onChange }: UseControllableStateProps<T>) => [T, (next: T | ((prev: T) => T)) => void];
+//#endregion

package/dist/hooks/controllable-state/index.mjs

@@ -1,21 +1,19 @@
 "use client";
-import { useCallback, useRef, useState } from "react";
+import { useCallback, useState } from "react";
 //#region src/hooks/controllable-state/index.ts
 const useControllableState = ({ value, defaultValue, onChange }) => {
 	const isControlled = value !== void 0;
 	const [internalValue, setInternalValue] = useState(defaultValue);
 	const currentValue = isControlled ? value : internalValue;
-	const currentValueRef = useRef(currentValue);
-	currentValueRef.current = currentValue;
-	const onChangeRef = useRef(onChange);
-	onChangeRef.current = onChange;
-	const isControlledRef = useRef(isControlled);
-	isControlledRef.current = isControlled;
 	return [currentValue, useCallback((next) => {
-		const nextValue = typeof next === "function" ? next(currentValueRef.current) : next;
-		if (!isControlledRef.current) setInternalValue(nextValue);
-		onChangeRef.current?.(nextValue);
-	}, [])];
+		const nextValue = typeof next === "function" ? next(currentValue) : next;
+		if (!isControlled) setInternalValue(nextValue);
+		onChange?.(nextValue);
+	}, [
+		currentValue,
+		isControlled,
+		onChange
+	])];
 };
 //#endregion
 export { useControllableState };

package/dist/hooks/index.d.mts

@@ -1,22 +1,4 @@
-import { useBreakpoint } from "./breakpoint/index.mjs";
 import { useClickAway } from "./click-away/index.mjs";
-import { useClient } from "./client/index.mjs";
-import { useClipboard } from "./clipboard/index.mjs";
 import { useControllableState } from "./controllable-state/index.mjs";
-import { DebouncedAction, useDebouncedTransition } from "./debounced-transition/index.mjs";
-import { useDeferredDebounce } from "./deferred-debounce/index.mjs";
-import { useDisclosure } from "./disclosure/index.mjs";
-import { useHover } from "./hover/index.mjs";
-import { useIntersectionObserver } from "./intersection-observer/use-intersection-observer.mjs";
-import { useInView } from "./intersection-observer/use-in-view.mjs";
-import "./intersection-observer/index.mjs";
-import { useInterval } from "./interval/index.mjs";
-import { useResize } from "./resize/index.mjs";
-import { useScrollDirection } from "./scroll-direction/index.mjs";
-import { useScrollLock } from "./scroll-lock/index.mjs";
-import { useStep } from "./step/index.mjs";
-import { useTimeout } from "./timeout/index.mjs";
-import { useWindowResize } from "./window-resize/index.mjs";
-import { useWindowSize } from "./window-size/index.mjs";
-import { WritingMode, useWritingMode } from "./writing-mode/index.mjs";
-export { type DebouncedAction, type WritingMode, useBreakpoint, useClickAway, useClient, useClipboard, useControllableState, useDebouncedTransition, useDeferredDebounce, useDisclosure, useHover, useInView, useIntersectionObserver, useInterval, useResize, useScrollDirection, useScrollLock, useStep, useTimeout, useWindowResize, useWindowSize, useWritingMode };
+import { WritingMode, readWritingMode, useWritingMode } from "./writing-mode/index.mjs";
+export { type WritingMode, readWritingMode, useClickAway, useControllableState, useWritingMode };

package/dist/hooks/index.mjs

@@ -1,21 +1,4 @@
-import { useBreakpoint } from "./breakpoint/index.mjs";
 import { useClickAway } from "./click-away/index.mjs";
-import { useClient } from "./client/index.mjs";
-import { useClipboard } from "./clipboard/index.mjs";
 import { useControllableState } from "./controllable-state/index.mjs";
-import { useDebouncedTransition } from "./debounced-transition/index.mjs";
-import { useDeferredDebounce } from "./deferred-debounce/index.mjs";
-import { useDisclosure } from "./disclosure/index.mjs";
-import { useHover } from "./hover/index.mjs";
-import { useIntersectionObserver } from "./intersection-observer/use-intersection-observer.mjs";
-import { useInView } from "./intersection-observer/use-in-view.mjs";
-import { useInterval } from "./interval/index.mjs";
-import { useResize } from "./resize/index.mjs";
-import { useScrollDirection } from "./scroll-direction/index.mjs";
-import { useScrollLock } from "./scroll-lock/index.mjs";
-import { useStep } from "./step/index.mjs";
-import { useTimeout } from "./timeout/index.mjs";
-import { useWindowResize } from "./window-resize/index.mjs";
-import { useWindowSize } from "./window-size/index.mjs";
-import { useWritingMode } from "./writing-mode/index.mjs";
-export { useBreakpoint, useClickAway, useClient, useClipboard, useControllableState, useDebouncedTransition, useDeferredDebounce, useDisclosure, useHover, useInView, useIntersectionObserver, useInterval, useResize, useScrollDirection, useScrollLock, useStep, useTimeout, useWindowResize, useWindowSize, useWritingMode };
+import { readWritingMode, useWritingMode } from "./writing-mode/index.mjs";
+export { readWritingMode, useClickAway, useControllableState, useWritingMode };

package/dist/hooks/writing-mode/index.d.mts

@@ -1,6 +1,16 @@
-import { RefObject } from "react";
 //#region src/hooks/writing-mode/index.d.ts
-type WritingMode = 'horizontal' | 'vertical';
-declare const useWritingMode: (ref: RefObject<Element | null>) => WritingMode;
-//#endregion
-export { WritingMode, useWritingMode };
+export type WritingMode = 'horizontal' | 'vertical';
+export declare const readWritingMode: (element: Element) => WritingMode;
+/**
+ * 要素の書字方向を返し、切り替わったら追従する。
+ *
+ * 描くたびに算出スタイルから読むので、最初の描画から今の向きを返す
+ * （ResizeObserver の最初の通知を待つと、それまでの描画は横書きになる）。
+ * 描き直すきっかけには、writing-mode の変化を知らせるイベントが無いので、
+ * ResizeObserver で要素の論理サイズの変化を使う。これが効くのは inline 軸
+ * いっぱいに広がる要素だけで、ボタンのように中身に合わせて縮む要素は縦横が
+ * 入れ替わっても論理サイズが変わらず、切り替えを見逃す。そういう要素は
+ * 使う瞬間に readWritingMode で読む。
+ */
+export declare const useWritingMode: (element: Element | null) => WritingMode;
+//#endregion

package/dist/hooks/writing-mode/index.mjs

@@ -1,24 +1,31 @@
 "use client";
 import { useCallback, useSyncExternalStore } from "react";
 //#region src/hooks/writing-mode/index.ts
-const getServerSnapshot = () => "horizontal";
-const resolve = (value) => value.startsWith("vertical") || value.startsWith("sideways") ? "vertical" : "horizontal";
-const useWritingMode = (ref) => {
+const readWritingMode = (element) => {
+	const value = getComputedStyle(element).writingMode;
+	return value.startsWith("vertical") || value.startsWith("sideways") ? "vertical" : "horizontal";
+};
+/**
+* 要素の書字方向を返し、切り替わったら追従する。
+*
+* 描くたびに算出スタイルから読むので、最初の描画から今の向きを返す
+* （ResizeObserver の最初の通知を待つと、それまでの描画は横書きになる）。
+* 描き直すきっかけには、writing-mode の変化を知らせるイベントが無いので、
+* ResizeObserver で要素の論理サイズの変化を使う。これが効くのは inline 軸
+* いっぱいに広がる要素だけで、ボタンのように中身に合わせて縮む要素は縦横が
+* 入れ替わっても論理サイズが変わらず、切り替えを見逃す。そういう要素は
+* 使う瞬間に readWritingMode で読む。
+*/
+const useWritingMode = (element) => {
 	const subscribe = useCallback((onChange) => {
-		const el = ref.current;
-		if (!el) return () => {};
+		if (!element) return () => void 0;
 		const observer = new ResizeObserver(onChange);
-		observer.observe(el);
+		observer.observe(element);
 		return () => {
 			observer.disconnect();
 		};
-	}, [ref]);
-	const getSnapshot = useCallback(() => {
-		const el = ref.current;
-		if (!el) return "horizontal";
-		return resolve(getComputedStyle(el).writingMode);
-	}, [ref]);
-	return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+	}, [element]);
+	return useSyncExternalStore(subscribe, () => element ? readWritingMode(element) : "horizontal", () => "horizontal");
 };
 //#endregion
-export { useWritingMode };
+export { readWritingMode, useWritingMode };

package/dist/i18n/current.d.mts

@@ -0,0 +1,23 @@
+import { Messages } from "./messages.mjs";
+import { RegisteredLocale } from "@k8ordo/i18n";
+//#region src/i18n/current.d.ts
+/**
+ * Registers the built-in text for one locale — a locale `ja` and `en` do not
+ * cover, or one of them with some keys replaced (`{ ...en, close: 'Dismiss' }`).
+ * Call it next to `defineLocales`, in the module both the server and the
+ * browser import; the last registration for a locale wins.
+ */
+export declare const registerMessages: (locale: RegisteredLocale, messages: Messages) => void;
+/**
+ * The locale the components speak: `@k8ordo/i18n`'s current locale, or `en`
+ * when the application has defined no locale set. Not a hook.
+ */
+export declare const getLocale: () => string;
+/**
+ * The built-in text in the locale the components speak. A registered
+ * dictionary wins over a built-in one; a regional tag without one of its own
+ * (`en-US`) reads its language's (`en`). Not a hook: a Server Component
+ * calls it as readily as a Client Component.
+ */
+export declare const getMessages: () => Messages;
+//#endregion

package/dist/i18n/current.mjs

@@ -0,0 +1,43 @@
+import { en } from "./en.mjs";
+import { ja } from "./ja.mjs";
+import { currentLocale } from "@k8ordo/i18n";
+//#region src/i18n/current.ts
+const BUILT_IN = {
+	ja,
+	en
+};
+const REGISTRY_KEY = Symbol.for("@k8ordo/ui/messages");
+const registry = () => {
+	const global = globalThis;
+	global[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
+	return global[REGISTRY_KEY];
+};
+/**
+* Registers the built-in text for one locale — a locale `ja` and `en` do not
+* cover, or one of them with some keys replaced (`{ ...en, close: 'Dismiss' }`).
+* Call it next to `defineLocales`, in the module both the server and the
+* browser import; the last registration for a locale wins.
+*/
+const registerMessages = (locale, messages) => {
+	registry().set(locale, messages);
+};
+/**
+* The locale the components speak: `@k8ordo/i18n`'s current locale, or `en`
+* when the application has defined no locale set. Not a hook.
+*/
+const getLocale = () => currentLocale() ?? "en";
+const find = (tag) => registry().get(tag) ?? BUILT_IN[tag];
+/**
+* The built-in text in the locale the components speak. A registered
+* dictionary wins over a built-in one; a regional tag without one of its own
+* (`en-US`) reads its language's (`en`). Not a hook: a Server Component
+* calls it as readily as a Client Component.
+*/
+const getMessages = () => {
+	const locale = getLocale();
+	const messages = find(locale) ?? find(new Intl.Locale(locale).language);
+	if (messages === void 0) throw new TypeError(`@k8ordo/ui: no built-in text for ${JSON.stringify(locale)} — register it with registerMessages(${JSON.stringify(locale)}, …) from '@k8ordo/ui/i18n'`);
+	return messages;
+};
+//#endregion
+export { getLocale, getMessages, registerMessages };

package/dist/i18n/en.d.mts

@@ -1,5 +1,4 @@
 import { Messages } from "./messages.mjs";
 //#region src/i18n/en.d.ts
-declare const en: Messages;
-//#endregion
-export { en };
+export declare const en: Messages;
+//#endregion

package/dist/i18n/en.mjs

@@ -10,14 +10,34 @@ const en = {
 	alertWarning: "Warning",
 	alertError: "Error",
 	toastRegion: "Notifications",
+	copy: "Copy",
+	copied: "Copied",
+	copyFailed: "Could not copy",
 	autocompletePlaceholder: "Type to filter",
 	autocompleteRemoveTag: "Remove tag",
 	autocompleteClear: "Clear all",
 	autocompleteEmpty: "No results",
+	comboboxToggle: "Show options",
+	comboboxEmpty: "No results",
+	comboboxFailed: "Could not load options",
 	fileFieldRemove: "Remove file",
 	fileFieldTrigger: "Select files",
+	fileFieldDrop: "Drop files here",
 	numberFieldIncrement: "Increase",
 	numberFieldDecrement: "Decrease",
+	numberFieldRangeUnderflow: "Enter {min} or more",
+	numberFieldRangeOverflow: "Enter {max} or less",
+	rangeSliderStart: "minimum",
+	rangeSliderEnd: "maximum",
+	calendarPreviousMonth: "Previous month",
+	calendarNextMonth: "Next month",
+	datePickerOpen: "Choose from calendar",
+	datePickerDialog: "Choose a date",
+	colorPickerHue: "Hue",
+	colorPickerSaturation: "Saturation",
+	colorPickerLightness: "Lightness",
+	colorPickerSwatches: "Swatches",
+	colorPickerOpen: "Choose from palette",
 	passwordShow: "Show password",
 	passwordHide: "Hide password",
 	listBoxPlaceholder: "Select an option",
@@ -26,6 +46,20 @@ const en = {
 	paginationLabel: "Pagination",
 	paginationPrevious: "Previous",
 	paginationNext: "Next",
+	stepperComplete: "completed",
+	dataTableColumns: "Columns",
+	dataTableSelectAll: "Select all rows",
+	dataTableSelectRow: "Select row",
+	codeBlockCopy: "Copy code",
+	carousel: "Carousel",
+	carouselSlide: "Slide",
+	carouselPrevious: "Previous slide",
+	carouselNext: "Next slide",
+	resizablePanelsHandle: "Panel size",
+	tableOfContents: "Contents",
+	commandPalette: "Commands",
+	commandPaletteSearch: "Search commands",
+	commandPaletteEmpty: "No matching commands",
 	chat: "Chat",
 	scrollToLatest: "Scroll to latest message",
 	reasoning: "Reasoning",
@@ -33,10 +67,22 @@ const en = {
 	suggestions: "Suggestions",
 	send: "Send",
 	stop: "Stop",
+	attach: "Attach files",
+	attachments: "Attachments",
+	attachmentRemove: "Remove attachment",
+	attachmentImage: "Attached image",
+	sources: "Sources",
+	messageActions: "Message actions",
+	regenerate: "Regenerate",
+	feedbackPositive: "Good response",
+	feedbackNegative: "Bad response",
 	toolInput: "Input",
 	toolOutput: "Output",
 	toolError: "The tool failed to run.",
 	toolDenied: "The tool run was not approved.",
+	toolApprovalRequest: "Allow this tool to run?",
+	toolApprove: "Allow",
+	toolDeny: "Deny",
 	responseCopied: "Copied",
 	responseCopyCode: "Copy code",
 	responseCopyLink: "Copy link",

package/dist/i18n/index.d.mts

@@ -1,5 +1,6 @@
 import { Messages } from "./messages.mjs";
-import { useMessages } from "./context.mjs";
+import { getMessages, registerMessages } from "./current.mjs";
 import { en } from "./en.mjs";
 import { ja } from "./ja.mjs";
-export { type Messages, en, ja, useMessages };
+import { messageUsage } from "./usage.mjs";
+export { type Messages, en, getMessages, ja, messageUsage, registerMessages };

package/dist/i18n/index.mjs

@@ -1,4 +1,5 @@
-import { ja } from "./ja.mjs";
-import { useMessages } from "./context.mjs";
 import { en } from "./en.mjs";
-export { en, ja, useMessages };
+import { ja } from "./ja.mjs";
+import { getMessages, registerMessages } from "./current.mjs";
+import { messageUsage } from "./usage.mjs";
+export { en, getMessages, ja, messageUsage, registerMessages };

package/dist/i18n/ja.d.mts

@@ -1,5 +1,4 @@
 import { Messages } from "./messages.mjs";
 //#region src/i18n/ja.d.ts
-declare const ja: Messages;
-//#endregion
-export { ja };
+export declare const ja: Messages;
+//#endregion

package/dist/i18n/ja.mjs

@@ -10,14 +10,34 @@ const ja = {
 	alertWarning: "警告",
 	alertError: "エラー",
 	toastRegion: "通知",
+	copy: "コピー",
+	copied: "コピーしました",
+	copyFailed: "コピーできませんでした",
 	autocompletePlaceholder: "入力して絞り込めます",
 	autocompleteRemoveTag: "タグを削除",
 	autocompleteClear: "すべて削除",
 	autocompleteEmpty: "該当なし",
+	comboboxToggle: "候補を開く",
+	comboboxEmpty: "該当なし",
+	comboboxFailed: "候補を読み込めませんでした",
 	fileFieldRemove: "ファイルを削除",
 	fileFieldTrigger: "ファイルを選択",
+	fileFieldDrop: "ここにファイルをドロップ",
 	numberFieldIncrement: "増やす",
 	numberFieldDecrement: "減らす",
+	numberFieldRangeUnderflow: "{min} 以上で入力してください",
+	numberFieldRangeOverflow: "{max} 以下で入力してください",
+	rangeSliderStart: "最小",
+	rangeSliderEnd: "最大",
+	calendarPreviousMonth: "前の月",
+	calendarNextMonth: "次の月",
+	datePickerOpen: "カレンダーから選ぶ",
+	datePickerDialog: "日付を選ぶ",
+	colorPickerHue: "色相",
+	colorPickerSaturation: "彩度",
+	colorPickerLightness: "明度",
+	colorPickerSwatches: "色の見本",
+	colorPickerOpen: "パレットから選ぶ",
 	passwordShow: "パスワードを表示",
 	passwordHide: "パスワードを非表示",
 	listBoxPlaceholder: "選択してください",
@@ -26,6 +46,20 @@ const ja = {
 	paginationLabel: "ページネーション",
 	paginationPrevious: "前へ",
 	paginationNext: "次へ",
+	stepperComplete: "完了",
+	dataTableColumns: "表示する列",
+	dataTableSelectAll: "すべての行を選択",
+	dataTableSelectRow: "行を選択",
+	codeBlockCopy: "コードをコピー",
+	carousel: "カルーセル",
+	carouselSlide: "スライド",
+	carouselPrevious: "前のスライド",
+	carouselNext: "次のスライド",
+	resizablePanelsHandle: "パネルの大きさ",
+	tableOfContents: "目次",
+	commandPalette: "コマンド",
+	commandPaletteSearch: "コマンドを検索",
+	commandPaletteEmpty: "一致するコマンドはありません",
 	chat: "チャット",
 	scrollToLatest: "最新のメッセージへ移動",
 	reasoning: "思考の過程",
@@ -33,10 +67,22 @@ const ja = {
 	suggestions: "候補",
 	send: "送信",
 	stop: "停止",
+	attach: "ファイルを添付",
+	attachments: "添付ファイル",
+	attachmentRemove: "添付を外す",
+	attachmentImage: "添付画像",
+	sources: "出典",
+	messageActions: "メッセージの操作",
+	regenerate: "再生成",
+	feedbackPositive: "良い回答",
+	feedbackNegative: "良くない回答",
 	toolInput: "入力",
 	toolOutput: "出力",
 	toolError: "ツールの実行でエラーが発生しました。",
 	toolDenied: "ツールの実行は許可されませんでした。",
+	toolApprovalRequest: "このツールの実行を許可しますか？",
+	toolApprove: "許可",
+	toolDeny: "拒否",
 	responseCopied: "コピーしました",
 	responseCopyCode: "コードをコピー",
 	responseCopyLink: "リンクをコピー",

package/dist/i18n/messages.d.mts

@@ -1,5 +1,5 @@
 //#region src/i18n/messages.d.ts
-type Messages = {
+export type Messages = {
   /** Alert / Dialog / Drawer の閉じるボタン */
   close: string;
   /** FormControl の必須バッジ */
@@ -17,6 +17,11 @@ type Messages = {
   alertError: string;
   /** Toast のビューポート（region ランドマーク）名 */
   toastRegion: string;
+  /** CopyButton の既定のラベル */
+  copy: string;
+  /** CopyButton が押した結果として読み上げる文言 */
+  copied: string;
+  copyFailed: string;
   autocompletePlaceholder: string;
   /** 選択済みタグ 1 件の解除 */
   autocompleteRemoveTag: string;
@@ -24,10 +29,40 @@ type Messages = {
   autocompleteClear: string;
   /** 絞り込み結果が空のときの表示 */
   autocompleteEmpty: string;
+  /** Combobox の候補を開くボタン */
+  comboboxToggle: string;
+  /** Combobox の候補が見つからなかったとき */
+  comboboxEmpty: string;
+  /** Combobox の search が失敗したとき */
+  comboboxFailed: string;
   fileFieldRemove: string;
   fileFieldTrigger: string;
+  /** FileField.Dropzone の既定の案内 */
+  fileFieldDrop: string;
   numberFieldIncrement: string;
   numberFieldDecrement: string;
+  /** NumberField の値が min を下回ったときの検証メッセージ。`{min}` が min の値に置き換わる */
+  numberFieldRangeUnderflow: string;
+  /** NumberField の値が max を上回ったときの検証メッセージ。`{max}` が max の値に置き換わる */
+  numberFieldRangeOverflow: string;
+  /** RangeSlider の下側のつまみ。部品の名前（aria-label など）の後に続けて読まれる */
+  rangeSliderStart: string;
+  /** RangeSlider の上側のつまみ */
+  rangeSliderEnd: string;
+  calendarPreviousMonth: string;
+  calendarNextMonth: string;
+  /** DatePicker のカレンダーを開くボタン */
+  datePickerOpen: string;
+  /** DatePicker が開くポップオーバー（dialog）の名前 */
+  datePickerDialog: string;
+  /** ColorPicker の HSL のつまみ */
+  colorPickerHue: string;
+  colorPickerSaturation: string;
+  colorPickerLightness: string;
+  /** ColorPicker の見本のボタンをまとめる group の名前 */
+  colorPickerSwatches: string;
+  /** ColorPicker の欄の横の色。押すとブラウザの色選びを開く */
+  colorPickerOpen: string;
   passwordShow: string;
   passwordHide: string;
   /** ListBox の未選択時に Trigger が示す値 */
@@ -39,6 +74,31 @@ type Messages = {
   paginationLabel: string;
   paginationPrevious: string;
   paginationNext: string;
+  /** Stepper の済んだ段に添える読み上げ専用の文言 */
+  stepperComplete: string;
+  /** DataTable の列の表示を切り替えるボタンと、その一覧の見出し */
+  dataTableColumns: string;
+  /** DataTable の見出しの行の、表示中の行をまとめて選ぶチェックボックス */
+  dataTableSelectAll: string;
+  /** DataTable の各行のチェックボックス。行の見出しが後に続く */
+  dataTableSelectRow: string;
+  /** CodeBlock のコピーボタン */
+  codeBlockCopy: string;
+  /** Carousel の aria-roledescription（region と各スライド） */
+  carousel: string;
+  carouselSlide: string;
+  carouselPrevious: string;
+  carouselNext: string;
+  /** TableOfContents の見出し（nav の名前にもなる） */
+  tableOfContents: string;
+  /** CommandPalette の dialog の名前 */
+  commandPalette: string;
+  /** CommandPalette の検索欄の名前と placeholder */
+  commandPaletteSearch: string;
+  /** CommandPalette で一致するコマンドが無いとき */
+  commandPaletteEmpty: string;
+  /** ResizablePanels.Handle の既定の名前。値は 1 枚目の大きさ */
+  resizablePanelsHandle: string;
   /** Conversation.Messages の log ランドマーク名 */
   chat: string;
   scrollToLatest: string;
@@ -48,10 +108,29 @@ type Messages = {
   suggestions: string;
   send: string;
   stop: string;
+  /** PromptInput.Attach の開くボタン */
+  attach: string;
+  /** Attachment.List / PromptInput.Attachments の list 名 */
+  attachments: string;
+  /** 添付 1 件を外すボタン。どの添付かは aria-describedby のファイル名で補う */
+  attachmentRemove: string;
+  /** 画像の添付に filename が無いときの代替テキスト */
+  attachmentImage: string;
+  /** Source.List の list 名 */
+  sources: string;
+  /** Message.Actions の group 名 */
+  messageActions: string;
+  regenerate: string;
+  feedbackPositive: string;
+  feedbackNegative: string;
   toolInput: string;
   toolOutput: string;
   toolError: string;
   toolDenied: string;
+  /** ToolInvocation の承認待ちで、requestReason が無いときの問いかけ */
+  toolApprovalRequest: string;
+  toolApprove: string;
+  toolDeny: string;
   /**
    * Response が描画する Markdown のコントロール文言。
    * 書式名（Markdown / CSV / TSV / SVG / PNG / MMD）は翻訳対象にしない
@@ -80,5 +159,4 @@ type Messages = {
   responseExternalLinkWarning: string;
   responseOpenLink: string;
 };
-//#endregion
-export { Messages };
+//#endregion

package/dist/i18n/usage.d.mts

@@ -0,0 +1,8 @@
+import { Messages } from "./messages.mjs";
+//#region src/i18n/usage.d.ts
+/**
+ * Where each key is drawn: the component, or the part of one, by the name it
+ * is imported under.
+ */
+export declare const messageUsage: Readonly<Record<keyof Messages, readonly string[]>>;
+//#endregion