wimui 0.51.2 → 0.52.2

package/dist/i18n/instance.js

@@ -1,47 +1,45 @@
 "use client";
-import { wimNamespaces as e, wimResources as t } from "./generated/resources.js";
+import { wimLocales as e } from "./generated/locales.js";
 //#region src/i18n/instance.ts
-var n = Object.keys(t), r = "en", i = "common", a = n.includes(r) ? r : n[0] ?? r, o = /* @__PURE__ */ new Set();
-function s() {
-	return a;
+var t = "en", n = e.includes(t) ? t : e[0] ?? t, r = /* @__PURE__ */ new Set();
+function i() {
+	return n;
 }
-function c(e) {
-	let t = typeof e == "string" ? e.split("-")[0] : "", r = n.includes(e) ? e : n.includes(t) ? t : e;
-	if (r !== a) {
-		a = r;
-		for (let e of o) e();
+function a(t) {
+	let i = typeof t == "string" ? t.split("-")[0] : "", a = e.includes(t) ? t : e.includes(i) ? i : t;
+	if (a !== n) {
+		n = a;
+		for (let e of r) e();
 	}
 }
-function l(e) {
-	return o.add(e), () => o.delete(e);
+function o(e) {
+	return r.add(e), () => r.delete(e);
 }
-function u(e, t) {
+function s(e, t) {
 	return t.split(".").reduce((e, t) => {
 		if (e && typeof e == "object") return e[t];
 	}, e);
 }
-function d(e, n, r) {
-	let i = t[e];
-	if (!i) return;
-	let a = r.indexOf(":");
-	if (a !== -1) {
-		let e = r.slice(0, a), t = r.slice(a + 1), n = u(i[e], t);
-		if (n !== void 0) return n;
+function c(e, t, n) {
+	let r = n.indexOf(":");
+	if (r !== -1) {
+		let i = s(t.find((e) => e.name === n.slice(0, r))?.resources[e], n.slice(r + 1));
+		if (i !== void 0) return i;
 	}
-	for (let e of n) {
-		let t = u(i[e], r);
+	for (let r of t) {
+		let t = s(r.resources[e], n);
 		if (t !== void 0) return t;
 	}
 }
-function f(e, t) {
+function l(e, t) {
 	return t ? e.replace(/\{\{\s*([\w.]+)\s*\}\}/g, (e, n) => {
 		let r = t[n];
 		return r == null ? e : String(r);
 	}) : e;
 }
-function p(t, n, o) {
-	let s = t == null ? [i] : Array.isArray(t) ? [...t] : [t], c = [...s, ...e.filter((e) => !s.includes(e))], l = d(a, c, n);
-	return l === void 0 && a !== r && (l = d(r, c, n)), typeof l == "string" ? f(l, o) : o?.defaultValue ?? n;
+function u(e, r, i) {
+	let a = c(n, e, r);
+	return a === void 0 && n !== t && (a = c(t, e, r)), typeof a == "string" ? l(a, i) : i?.defaultValue ?? r;
 }
 //#endregion
-export { s as getWimLocale, c as setWimLocale, l as subscribeWimLocale, p as wimTranslate };
+export { i as getWimLocale, a as setWimLocale, o as subscribeWimLocale, u as wimTranslate };

package/dist/i18n/useWimTranslation.cjs

@@ -1,2 +1,2 @@
 "use client";
-const e=require("./instance.cjs");let t=require("react");function n(n){let r=(0,t.useSyncExternalStore)(e.subscribeWimLocale,e.getWimLocale,e.getWimLocale),i=Array.isArray(n)?n.join(`,`):n;return{t:(0,t.useCallback)((t,r)=>e.wimTranslate(n,t,r),[i]),i18n:{language:r,changeLanguage:e.setWimLocale}}}exports.useWimTranslation=n;
+const e=require("./instance.cjs");let t=require("react");var n=[];function r(r){let i=(0,t.useSyncExternalStore)(e.subscribeWimLocale,e.getWimLocale,e.getWimLocale),a=r==null?n:Array.isArray(r)?r:[r],o=a.map(e=>e.name).join(`,`);return{t:(0,t.useCallback)((t,n)=>e.wimTranslate(a,t,n),[o]),i18n:{language:i,changeLanguage:e.setWimLocale}}}exports.useWimTranslation=r;

package/dist/i18n/useWimTranslation.d.ts

@@ -1,14 +1,13 @@
-import { setWimLocale, WimTranslateOptions } from './instance';
-import { WimI18nKey } from './generated/keys';
-type Namespace = string | readonly string[];
-export interface WimTFunction {
-    (key: WimI18nKey, options?: WimTranslateOptions): string;
+import { setWimLocale, WimNamespace, WimTranslateOptions } from './instance';
+/** 名前空間が受けるキー（bare と "ns:key" の両方）。 */
+export type WimKeyOf<N> = N extends WimNamespace<infer Name, infer Key> ? Key | `${Name}:${Key}` : never;
+export interface WimTFunction<Key extends string = string> {
+    (key: Key, options?: WimTranslateOptions): string;
 }
-export declare function useWimTranslation(ns?: Namespace): {
-    t: WimTFunction;
+export declare function useWimTranslation<N extends WimNamespace = never>(ns?: N | readonly N[]): {
+    t: WimTFunction<WimKeyOf<N>>;
     i18n: {
         language: string;
         changeLanguage: typeof setWimLocale;
     };
 };
-export {};

package/dist/i18n/useWimTranslation.js

@@ -2,15 +2,16 @@
 import { getWimLocale as e, setWimLocale as t, subscribeWimLocale as n, wimTranslate as r } from "./instance.js";
 import { useCallback as i, useSyncExternalStore as a } from "react";
 //#region src/i18n/useWimTranslation.ts
-function o(o) {
-	let s = a(n, e, e), c = Array.isArray(o) ? o.join(",") : o;
+var o = [];
+function s(s) {
+	let c = a(n, e, e), l = s == null ? o : Array.isArray(s) ? s : [s], u = l.map((e) => e.name).join(",");
 	return {
-		t: i((e, t) => r(o, e, t), [c]),
+		t: i((e, t) => r(l, e, t), [u]),
 		i18n: {
-			language: s,
+			language: c,
 			changeLanguage: t
 		}
 	};
 }
 //#endregion
-export { o as useWimTranslation };
+export { s as useWimTranslation };

package/dist/llms-full.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.51.2 — a React 19 component library: 228 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.52.2 — a React 19 component library: 228 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup
 
@@ -835,7 +835,7 @@ does:
 ```tsx
 const [open, setOpen] = useState(false);
 
-<HamburgerMenu visibleBelow="md" open={open} onClick={() => setOpen((o) => !o)} />
+<HamburgerMenu visibleBelow="md" open={open} onOpenChange={setOpen} />
 <Sidebar mobileOpen={open} onOverlayClick={() => setOpen(false)}>…</Sidebar>
 ```
 
@@ -1240,7 +1240,8 @@ SCSS には誰も付けない `.default_intent` が「temporary name」のまま
     - `visibilityHeight: number` = 400 — Visibility threshold for backTop (in pixels)
     - `className: string` — Additional class names
     - `style: React.CSSProperties` — Style attribute
-    - `aria-label: string` — Aria label for accessibility
+    - `aria-label: string` — Accessible name. Required when there is no string `label`: an icon-only button has no
+text to take a name from, and the icon name is not used as one.
 - **IconButton** — A square button containing only an icon without a text label.
     - `iconName: React.ComponentProps<typeof Icon>["name"]` (required) — Icon name to display
     - `aria-label: string` (required) — Accessible label for the icon-only button
@@ -2120,6 +2121,9 @@ follows the theme and never needs a hand-mixed colour.
     - `asChild: boolean` = false — If true, merge button props onto the child element.
     - `open: boolean` = false — Whether the menu is open
     - `onClick: React.MouseEventHandler<HTMLButtonElement>` — Callback function when the menu is toggled
+    - `onOpenChange: (open: boolean) => void` — Called with the next open state: the opposite of `open` when the button is pressed, and
+false when Escape is pressed while the menu is open. Escape also moves focus back to the
+button. Without this callback the button cannot close on Escape, because `open` is controlled.
     - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the hamburger menu
     - `color: string` — Color of the bars
     - `visibleBelow: "xs" | "sm" | "md" | "lg" | "xl"` — Show only below the given breakpoint (e.g. "md" matches Sidebar's mobile drawer range)

package/dist/llms.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.51.2 — a React 19 component library: 228 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
+**wimui** v0.52.2 — a React 19 component library: 228 documented components across 10 categories, with design tokens, dark mode, i18n (en/ja/pt-BR) and WAI-ARIA compliant a11y. Peer deps: react ^19, react-dom ^19 (plus optional peers for specific components — see package.json).
 
 ## Install & required setup
 

package/dist/locales/en/common.json

@@ -328,7 +328,7 @@
     "speed_dial_best_practice_1": "Place in a consistent location, typically the bottom-right corner.",
     "speed_dial_best_practice_2": "Ensure sufficient contrast between the button and the background.",
     "speed_dial_responsive_desc": "Maintains position relative to viewport or container. Scales well on smaller screens.",
-    "speed_dial_keyboard_desc": "Focus moves through action buttons when open. Escape closes the menu.",
+    "speed_dial_keyboard_desc": "Enter or Space on the trigger opens the menu and moves focus to the first action. Running an action from the keyboard closes the menu and returns focus to the trigger. Escape closes the menu.",
     "speed_dial_i18n_desc": "Action labels and tooltips are localized via translation keys.",
     "swipe_action_design_intent": "Offer a mobile-native gesture-based way to perform quick actions on list items.",
     "swipe_action_choice_matrix_desc": "Use for common list actions like delete or archive in mobile-first applications.",

package/dist/locales/ja/common.json

@@ -335,7 +335,7 @@
     "speed_dial_desc": "ホバーまたはクリックでサブアクションを展開する、フローティングアクションボタン。",
     "speed_dial_design_intent": "モバイルや高密度なUIで、主要なアクションを省スペースで表示するための手段を提供します。",
     "speed_dial_i18n_desc": "アクションのラベルやツールチップは、翻訳キーを介してローカライズされます。",
-    "speed_dial_keyboard_desc": "展開時はフォーカスがアクションボタン間を移動します。Escape キーでメニューを閉じることができます。",
+    "speed_dial_keyboard_desc": "引き金で Enter か Space を押すとメニューが開き、最初のアクションへフォーカスが移ります。キーボードでアクションを実行すると、メニューが閉じて引き金へフォーカスが戻ります。Escape キーでもメニューを閉じることができます。",
     "speed_dial_motion_desc": "アクションボタンが順次展開・格納されるスタッガードアニメーションにより、プレミアムな操作感を実現します。",
     "speed_dial_responsive_desc": "ビューポートまたはコンテナに対する相対位置を維持します。小さな画面でも適切にスケールします。",
     "speed_dial_scenario_1": "写真、動画、アンケートなど、異なるメディアタイプを選択して投稿を作成する場合。",

package/dist/locales/pt/common.json

@@ -334,7 +334,7 @@
     "speed_dial_desc": "Botão de ação flutuante que expande sub-ações ao passar o mouse ou clicar.",
     "speed_dial_design_intent": "Fornecer uma forma econômica de espaço para exibir ações principais em uma UI móvel ou de alta densidade.",
     "speed_dial_i18n_desc": "Rótulos de ação e tooltips são localizados via chaves de tradução.",
-    "speed_dial_keyboard_desc": "O foco percorre os botões de ação quando aberto. Escape fecha o menu.",
+    "speed_dial_keyboard_desc": "Enter ou Espaço no botão principal abre o menu e move o foco para a primeira ação. Executar uma ação pelo teclado fecha o menu e devolve o foco ao botão principal. Escape fecha o menu.",
     "speed_dial_motion_desc": "Animações de entrada/saída escalonadas para os botões de ação, criando uma sensação premium.",
     "speed_dial_responsive_desc": "Mantém a posição em relação à viewport ou ao contêiner. Escala bem em telas menores.",
     "speed_dial_scenario_1": "Criação de publicações em redes sociais com diferentes tipos de mídia (foto, vídeo, enquete).",