wimui 0.51.2 → 0.52.0

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.0 — 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.0 — 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