wimui 0.58.1 → 0.60.0

package/dist/components/navigation/Pagination/Pagination.js

@@ -22,29 +22,29 @@ var g = u.forwardRef(({ asChild: n = !1, className: r, children: i, page: a, isA
 	children: n ? /* @__PURE__ */ m(t, { children: i }) : i
 }));
 g.displayName = "PaginationPage";
-var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, onPageSizeChange: te, siblingCount: x = 1, className: S, asChild: C = !1, children: w, renderPage: T, hideOnSinglePage: E = !1, simple: D = !1, showSizeChanger: O = !1, pageSizeOptions: k = [
+var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, onPageSizeChange: x, siblingCount: S = 1, className: C, asChild: w = !1, children: T, renderPage: E, hideOnSinglePage: te = !1, simple: ne = !1, showSizeChanger: D = !1, pageSizeOptions: O = [
 	10,
 	20,
 	50,
 	100
-], showTotal: A, showQuickJumper: j = !1, labels: M = {} }) => {
-	let { t: N } = n(r), { prevPage: P = N("a11y.go_to_prev_page"), nextPage: F = N("a11y.go_to_next_page"), pageAriaLabel: I = (e) => N("a11y.go_to_page", { page: String(e) }), itemsPerPage: L = N("pagination.items_per_page"), goTo: R = N("pagination.go_to"), go: z = N("pagination.go"), pageSizeAriaLabel: B = N("a11y.items_per_page"), jumpToPageAriaLabel: V = N("a11y.jump_to_page"), navAriaLabel: H = N("a11y.pagination_nav") } = M, [U, W] = f(v), [G, K] = f(""), q = U, J = Math.ceil(u / q), Y = d(() => {
-		if (x + 5 >= J) return Array.from({ length: J }, (e, t) => t + 1);
-		let e = Math.max(y - x, 1), t = Math.min(y + x, J), n = e > 2, r = t < J - 2, i = J;
+], showTotal: k, showQuickJumper: A = !1, labels: j = {}, "aria-label": M, "aria-labelledby": N }) => {
+	let { t: P } = n(r), { prevPage: F = P("a11y.go_to_prev_page"), nextPage: I = P("a11y.go_to_next_page"), pageAriaLabel: L = (e) => P("a11y.go_to_page", { page: String(e) }), itemsPerPage: R = P("pagination.items_per_page"), goTo: z = P("pagination.go_to"), go: B = P("pagination.go"), pageSizeAriaLabel: V = P("a11y.items_per_page"), jumpToPageAriaLabel: H = P("a11y.jump_to_page"), navAriaLabel: U = P("a11y.pagination_nav") } = j, [W, G] = f(v), [K, q] = f(""), J = W, Y = Math.ceil(u / J), X = d(() => {
+		if (S + 5 >= Y) return Array.from({ length: Y }, (e, t) => t + 1);
+		let e = Math.max(y - S, 1), t = Math.min(y + S, Y), n = e > 2, r = t < Y - 2, i = Y;
 		if (!n && r) {
-			let e = 3 + 2 * x;
+			let e = 3 + 2 * S;
 			return [
 				...Array.from({ length: e }, (e, t) => t + 1),
 				_,
-				J
+				Y
 			];
 		}
 		if (n && !r) {
-			let e = 3 + 2 * x;
+			let e = 3 + 2 * S;
 			return [
 				1,
 				_,
-				...Array.from({ length: e }, (t, n) => J - e + n + 1)
+				...Array.from({ length: e }, (t, n) => Y - e + n + 1)
 			];
 		}
 		return n && r ? [
@@ -55,45 +55,46 @@ var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, o
 			i
 		] : [];
 	}, [
-		J,
-		x,
+		Y,
+		S,
 		y
 	]);
-	if (E && J <= 1) return null;
-	let X = (e) => {
-		e < 1 || e > J || e === y || b?.(e, q);
-	}, Z = (e) => {
-		W(e), te?.(e), b?.(1, e);
+	if (te && Y <= 1) return null;
+	let Z = (e) => {
+		e < 1 || e > Y || e === y || b?.(e, J);
+	}, re = (e) => {
+		G(e), x?.(e), b?.(1, e);
 	}, Q = () => {
-		let e = parseInt(G);
-		!isNaN(e) && e >= 1 && e <= J && (X(e), K(""));
-	}, ne = (e) => {
+		let e = parseInt(K);
+		!isNaN(e) && e >= 1 && e <= Y && (Z(e), q(""));
+	}, ie = (e) => {
 		e.key === "Enter" && Q();
-	}, re = (y - 1) * q + 1, ie = Math.min(y * q, u), $ = C ? e : "nav", ae = (e) => {
+	}, ae = (y - 1) * J + 1, oe = Math.min(y * J, u), $ = w ? e : "nav", se = (e) => {
 		let t = {
 			page: e,
 			isActive: e === y,
-			onClick: () => X(e),
-			"aria-label": I(e)
+			onClick: () => Z(e),
+			"aria-label": L(e)
 		};
-		return T ? T(e, t) : /* @__PURE__ */ m(g, {
+		return E ? E(e, t) : /* @__PURE__ */ m(g, {
 			...t,
 			children: e
 		});
 	};
-	return D ? /* @__PURE__ */ h($, {
-		className: p("wim-pagination", l.root, l.simple, S),
-		"aria-label": H,
-		children: [/* @__PURE__ */ m(t, { children: w }), /* @__PURE__ */ h("ul", {
+	return ne ? /* @__PURE__ */ h($, {
+		className: p("wim-pagination", l.root, l.simple, C),
+		"aria-label": N ? void 0 : M ?? U,
+		"aria-labelledby": N,
+		children: [/* @__PURE__ */ m(t, { children: T }), /* @__PURE__ */ h("ul", {
 			className: l.root,
 			children: [
 				/* @__PURE__ */ m("li", {
 					className: p(l.item, y === 1 && l.disabled),
 					children: /* @__PURE__ */ m("button", {
 						className: l.button,
-						onClick: () => X(y - 1),
+						onClick: () => Z(y - 1),
 						disabled: y === 1,
-						"aria-label": P,
+						"aria-label": F,
 						children: /* @__PURE__ */ m(o, {
 							component: i,
 							size: "sm"
@@ -105,16 +106,16 @@ var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, o
 					children: /* @__PURE__ */ h("span", { children: [
 						y,
 						" / ",
-						J
+						Y
 					] })
 				}),
 				/* @__PURE__ */ m("li", {
-					className: p(l.item, y === J && l.disabled),
+					className: p(l.item, y === Y && l.disabled),
 					children: /* @__PURE__ */ m("button", {
 						className: l.button,
-						onClick: () => X(y + 1),
-						disabled: y === J,
-						"aria-label": F,
+						onClick: () => Z(y + 1),
+						disabled: y === Y,
+						"aria-label": I,
 						children: /* @__PURE__ */ m(o, {
 							component: a,
 							size: "sm"
@@ -124,27 +125,28 @@ var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, o
 			]
 		})]
 	}) : /* @__PURE__ */ m("div", {
-		className: p("wim-pagination", l.container, S),
+		className: p("wim-pagination", l.container, C),
 		children: /* @__PURE__ */ h("div", {
 			className: l.wrapper,
 			children: [
-				A && /* @__PURE__ */ m("div", {
+				k && /* @__PURE__ */ m("div", {
 					className: l.total,
-					children: A(u, [re, ie])
+					children: k(u, [ae, oe])
 				}),
 				/* @__PURE__ */ h($, {
 					className: l.root,
-					"aria-label": H,
-					children: [/* @__PURE__ */ m(t, { children: w }), /* @__PURE__ */ h("ul", {
+					"aria-label": N ? void 0 : M ?? U,
+					"aria-labelledby": N,
+					children: [/* @__PURE__ */ m(t, { children: T }), /* @__PURE__ */ h("ul", {
 						className: l.root,
 						children: [
 							/* @__PURE__ */ m("li", {
 								className: p(l.item, y === 1 && l.disabled),
 								children: /* @__PURE__ */ m("button", {
 									className: l.button,
-									onClick: () => X(y - 1),
+									onClick: () => Z(y - 1),
 									disabled: y === 1,
-									"aria-label": P,
+									"aria-label": F,
 									children: /* @__PURE__ */ m(o, {
 										component: i,
 										size: "sm"
@@ -156,24 +158,24 @@ var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, o
 								children: /* @__PURE__ */ h("span", { children: [
 									y,
 									" / ",
-									J
+									Y
 								] })
 							}),
-							Y.map((e, t) => e === _ ? /* @__PURE__ */ m("li", {
+							X.map((e, t) => e === _ ? /* @__PURE__ */ m("li", {
 								className: p(l.item, l.ellipsis),
 								"aria-hidden": "true",
 								children: _
 							}, `ellipsis-${t}`) : /* @__PURE__ */ m("li", {
 								className: p(l.item, l.number, e === y && l.active),
-								children: ae(e)
+								children: se(e)
 							}, e)),
 							/* @__PURE__ */ m("li", {
-								className: p(l.item, y === J && l.disabled),
+								className: p(l.item, y === Y && l.disabled),
 								children: /* @__PURE__ */ m("button", {
 									className: l.button,
-									onClick: () => X(y + 1),
-									disabled: y === J,
-									"aria-label": F,
+									onClick: () => Z(y + 1),
+									disabled: y === Y,
+									"aria-label": I,
 									children: /* @__PURE__ */ m(o, {
 										component: a,
 										size: "sm"
@@ -183,39 +185,39 @@ var _ = "...", v = ({ total: u, pageSize: v = 10, current: y = 1, onChange: b, o
 						]
 					})]
 				}),
-				O && /* @__PURE__ */ m("div", {
+				D && /* @__PURE__ */ m("div", {
 					className: l.sizeChanger,
 					children: /* @__PURE__ */ m(ee, {
-						value: String(q),
-						onChange: (e) => Z(Number(e)),
-						options: k.map((e) => ({
-							label: `${e} ${L}`,
+						value: String(J),
+						onChange: (e) => re(Number(e)),
+						options: O.map((e) => ({
+							label: `${e} ${R}`,
 							value: String(e)
 						})),
 						width: "auto",
-						"aria-label": B
+						"aria-label": V
 					})
 				}),
-				j && /* @__PURE__ */ h("div", {
+				A && /* @__PURE__ */ h("div", {
 					className: l.quickJumper,
 					children: [
-						/* @__PURE__ */ m("span", { children: R }),
+						/* @__PURE__ */ m("span", { children: z }),
 						/* @__PURE__ */ m(c, {
 							type: "number",
 							min: 1,
-							max: J,
-							value: G,
-							onChange: (e) => K(e.target.value),
-							onKeyDown: ne,
+							max: Y,
+							value: K,
+							onChange: (e) => q(e.target.value),
+							onKeyDown: ie,
 							width: "60px",
-							"aria-label": V
+							"aria-label": H
 						}),
 						/* @__PURE__ */ m(s, {
 							size: "sm",
 							variant: "outline",
 							onClick: Q,
-							disabled: !G,
-							children: z
+							disabled: !K,
+							children: B
 						})
 					]
 				})

package/dist/components/overlay/Menu/Menu.cjs

@@ -1,2 +1,2 @@
 "use client";
-const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("../../../node_modules/@radix-ui/react-slot/dist/index.cjs"),n=require("../../layout/Transition/Transition.cjs"),r=require("../../../icon/chevron-right.cjs"),i=require("../../media/Icon/Icon.cjs"),a=require("../../_internal/BaseListItem/BaseListItem.cjs"),o=require("./menu.module.cjs");let s=require("react");s=e.__toESM(s,1);let c=require("classnames");c=e.__toESM(c,1);let l=require("react/jsx-runtime");var u=s.default.createContext({expandedItems:new Set,toggleItem:()=>{},containerRef:{current:null},mode:`vertical`,focusedIndex:0,setFocusedIndex:()=>{},registerItem:()=>0}),d=()=>{let e=s.default.useContext(u);if(!e)throw Error(`Menu sub-components must be used within a Menu`);return e},f=({children:e,className:n,asChild:r=!1,mode:i=`vertical`,defaultOpenKeys:a=[]})=>{let[d,f]=(0,s.useState)(new Set(a)),[p,m]=(0,s.useState)(0),h=s.default.useRef(0);s.default.useEffect(()=>{h.current=0});let g=()=>{let e=h.current;return h.current+=1,e},_=e=>{f(t=>{let n=new Set(t);return n.has(e)?n.delete(e):n.add(e),n})},v=s.default.useRef(null),y=e=>{let t=Array.from(v.current?.querySelectorAll(`[role="menuitem"]:not([aria-disabled="true"])`)||[]),n=t.indexOf(document.activeElement);if(n!==-1){if(i===`vertical`||i===`inline`){if(e.key===`ArrowDown`)e.preventDefault(),t[(n+1)%t.length]?.focus();else if(e.key===`ArrowUp`)e.preventDefault(),t[(n-1+t.length)%t.length]?.focus();else if(e.key===`ArrowRight`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`false`&&(e.preventDefault(),r.click())}else if(e.key===`ArrowLeft`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`true`&&(e.preventDefault(),r.click())}}else if(i===`horizontal`){if(e.key===`ArrowRight`)e.preventDefault(),t[(n+1)%t.length]?.focus();else if(e.key===`ArrowLeft`)e.preventDefault(),t[(n-1+t.length)%t.length]?.focus();else if(e.key===`ArrowDown`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`false`&&(e.preventDefault(),r.click())}}e.key===`Home`?(e.preventDefault(),m(0),t[0]?.focus()):e.key===`End`&&(e.preventDefault(),m(t.length-1),t[t.length-1]?.focus())}},b=r?t.Root:`ul`;return(0,l.jsx)(u.Provider,{value:{expandedItems:d,toggleItem:_,containerRef:v,mode:i,focusedIndex:p,setFocusedIndex:m,registerItem:g},children:(0,l.jsx)(b,{ref:v,className:(0,c.default)(`wim-menu`,o.default.root,o.default[i],n),role:`menu`,onKeyDown:y,children:(0,l.jsx)(t.Slottable,{children:e})})})},p=({children:e,onClick:t,disabled:n=!1,danger:r=!1,className:i,icon:u,asChild:f=!1,...p})=>{let{focusedIndex:m,setFocusedIndex:h,registerItem:g}=d(),[_]=(0,s.useState)(()=>g()),v=m===_,y=e=>{e.stopPropagation(),!n&&t&&t()},b={className:(0,c.default)(o.default.item,i),onClick:y,onFocus:()=>h(_),disabled:n,danger:r,icon:u,role:`menuitem`,tabIndex:v?0:-1,onKeyDown:e=>{!n&&(e.key===`Enter`||e.key===` `)&&(e.preventDefault(),y(e))},...p};return f?(0,l.jsx)(`li`,{role:`none`,children:(0,l.jsx)(a.BaseListItem,{asChild:!0,...b,children:e})}):(0,l.jsx)(a.BaseListItem,{asChild:!0,...b,children:(0,l.jsx)(`li`,{children:e})})},m=({children:e,title:t,className:n})=>{let r=s.default.useId();return(0,l.jsxs)(`li`,{className:(0,c.default)(o.default.itemGroup,n),role:`none`,children:[t&&(0,l.jsx)(`div`,{id:r,className:o.default.itemGroupTitle,"aria-hidden":`true`,children:t}),(0,l.jsx)(`ul`,{className:o.default.itemGroupList,role:`group`,"aria-labelledby":t?r:void 0,children:e})]})},h=({children:e,title:t,className:u,icon:f,itemKey:p})=>{let{expandedItems:m,toggleItem:h,registerItem:g,focusedIndex:_,setFocusedIndex:v}=d(),y=m.has(p),[b]=(0,s.useState)(()=>g()),x=_===b,S=s.default.useId(),C=e=>{e.stopPropagation(),h(p)};return(0,l.jsxs)(`li`,{className:(0,c.default)(o.default.submenu,y&&o.default.open,u),role:`none`,children:[(0,l.jsx)(a.BaseListItem,{id:S,className:o.default.submenuTitle,onClick:C,onFocus:()=>v(b),icon:f,rightSection:(0,l.jsx)(`span`,{className:(0,c.default)(o.default.submenuArrow,y&&o.default.open),children:(0,l.jsx)(i.Icon,{component:r.default,size:`sm`})}),role:`menuitem`,"aria-haspopup":`true`,"aria-expanded":y,tabIndex:x?0:-1,onKeyDown:e=>{(e.key===`Enter`||e.key===` `)&&(e.preventDefault(),C(e))},children:t}),(0,l.jsx)(n.Transition,{show:y,preset:`fade`,className:o.default.submenuList,children:(0,l.jsx)(`ul`,{className:o.default.submenuList,role:`menu`,"aria-labelledby":S,children:e})})]})},g=({className:e})=>(0,l.jsx)(`li`,{className:(0,c.default)(o.default.divider,e),role:`separator`}),_=Object.assign(f,{Item:p,Group:m,SubMenu:h,Divider:g});exports.Menu=_,exports.default=_,exports.MenuDivider=g,exports.MenuItem=p,exports.MenuItemGroup=m,exports.SubMenu=h;
+const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("../../../node_modules/@radix-ui/react-slot/dist/index.cjs"),n=require("../../layout/Transition/Transition.cjs"),r=require("../../../icon/chevron-right.cjs"),i=require("../../media/Icon/Icon.cjs"),a=require("../../_internal/BaseListItem/BaseListItem.cjs"),o=require("./menu.module.cjs");let s=require("react");s=e.__toESM(s,1);let c=require("classnames");c=e.__toESM(c,1);let l=require("react/jsx-runtime");var u=s.default.createContext({expandedItems:new Set,toggleItem:()=>{},containerRef:{current:null},mode:`vertical`,focusedIndex:0,setFocusedIndex:()=>{},registerItem:()=>0}),d=()=>{let e=s.default.useContext(u);if(!e)throw Error(`Menu sub-components must be used within a Menu`);return e},f=({children:e,className:n,asChild:r=!1,mode:i=`vertical`,defaultOpenKeys:a=[],"aria-label":d,"aria-labelledby":f})=>{let[p,m]=(0,s.useState)(new Set(a)),[h,g]=(0,s.useState)(0),_=s.default.useRef(0);s.default.useEffect(()=>{_.current=0});let v=()=>{let e=_.current;return _.current+=1,e},y=e=>{m(t=>{let n=new Set(t);return n.has(e)?n.delete(e):n.add(e),n})},b=s.default.useRef(null),x=e=>{let t=Array.from(b.current?.querySelectorAll(`[role="menuitem"]:not([aria-disabled="true"])`)||[]),n=t.indexOf(document.activeElement);if(n!==-1){if(i===`vertical`||i===`inline`){if(e.key===`ArrowDown`)e.preventDefault(),t[(n+1)%t.length]?.focus();else if(e.key===`ArrowUp`)e.preventDefault(),t[(n-1+t.length)%t.length]?.focus();else if(e.key===`ArrowRight`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`false`&&(e.preventDefault(),r.click())}else if(e.key===`ArrowLeft`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`true`&&(e.preventDefault(),r.click())}}else if(i===`horizontal`){if(e.key===`ArrowRight`)e.preventDefault(),t[(n+1)%t.length]?.focus();else if(e.key===`ArrowLeft`)e.preventDefault(),t[(n-1+t.length)%t.length]?.focus();else if(e.key===`ArrowDown`){let r=t[n];r.getAttribute(`aria-haspopup`)===`true`&&r.getAttribute(`aria-expanded`)===`false`&&(e.preventDefault(),r.click())}}e.key===`Home`?(e.preventDefault(),g(0),t[0]?.focus()):e.key===`End`&&(e.preventDefault(),g(t.length-1),t[t.length-1]?.focus())}},S=r?t.Root:`ul`;return(0,l.jsx)(u.Provider,{value:{expandedItems:p,toggleItem:y,containerRef:b,mode:i,focusedIndex:h,setFocusedIndex:g,registerItem:v},children:(0,l.jsx)(S,{ref:b,className:(0,c.default)(`wim-menu`,o.default.root,o.default[i],n),role:`menu`,"aria-label":f?void 0:d,"aria-labelledby":f,onKeyDown:x,children:(0,l.jsx)(t.Slottable,{children:e})})})},p=({children:e,onClick:t,disabled:n=!1,danger:r=!1,className:i,icon:u,asChild:f=!1,...p})=>{let{focusedIndex:m,setFocusedIndex:h,registerItem:g}=d(),[_]=(0,s.useState)(()=>g()),v=m===_,y=e=>{e.stopPropagation(),!n&&t&&t()},b={className:(0,c.default)(o.default.item,i),onClick:y,onFocus:()=>h(_),disabled:n,danger:r,icon:u,role:`menuitem`,tabIndex:v?0:-1,onKeyDown:e=>{!n&&(e.key===`Enter`||e.key===` `)&&(e.preventDefault(),y(e))},...p};return f?(0,l.jsx)(`li`,{role:`none`,children:(0,l.jsx)(a.BaseListItem,{asChild:!0,...b,children:e})}):(0,l.jsx)(a.BaseListItem,{asChild:!0,...b,children:(0,l.jsx)(`li`,{children:e})})},m=({children:e,title:t,className:n})=>{let r=s.default.useId();return(0,l.jsxs)(`li`,{className:(0,c.default)(o.default.itemGroup,n),role:`none`,children:[t&&(0,l.jsx)(`div`,{id:r,className:o.default.itemGroupTitle,"aria-hidden":`true`,children:t}),(0,l.jsx)(`ul`,{className:o.default.itemGroupList,role:`group`,"aria-labelledby":t?r:void 0,children:e})]})},h=({children:e,title:t,className:u,icon:f,itemKey:p})=>{let{expandedItems:m,toggleItem:h,registerItem:g,focusedIndex:_,setFocusedIndex:v}=d(),y=m.has(p),[b]=(0,s.useState)(()=>g()),x=_===b,S=s.default.useId(),C=e=>{e.stopPropagation(),h(p)};return(0,l.jsxs)(`li`,{className:(0,c.default)(o.default.submenu,y&&o.default.open,u),role:`none`,children:[(0,l.jsx)(a.BaseListItem,{id:S,className:o.default.submenuTitle,onClick:C,onFocus:()=>v(b),icon:f,rightSection:(0,l.jsx)(`span`,{className:(0,c.default)(o.default.submenuArrow,y&&o.default.open),children:(0,l.jsx)(i.Icon,{component:r.default,size:`sm`})}),role:`menuitem`,"aria-haspopup":`true`,"aria-expanded":y,tabIndex:x?0:-1,onKeyDown:e=>{(e.key===`Enter`||e.key===` `)&&(e.preventDefault(),C(e))},children:t}),(0,l.jsx)(n.Transition,{show:y,preset:`fade`,className:o.default.submenuList,children:(0,l.jsx)(`ul`,{className:o.default.submenuList,role:`menu`,"aria-labelledby":S,children:e})})]})},g=({className:e})=>(0,l.jsx)(`li`,{className:(0,c.default)(o.default.divider,e),role:`separator`}),_=Object.assign(f,{Item:p,Group:m,SubMenu:h,Divider:g});exports.Menu=_,exports.default=_,exports.MenuDivider=g,exports.MenuItem=p,exports.MenuItemGroup=m,exports.SubMenu=h;

package/dist/components/overlay/Menu/Menu.d.ts

@@ -18,6 +18,10 @@ export type MenuProps = {
     defaultSelectedKeys?: string[];
     /** Default opened submenu keys */
     defaultOpenKeys?: string[];
+    /** Accessible name for the menu. */
+    "aria-label"?: string;
+    /** ID of the element that labels the menu. Takes precedence over `aria-label`. */
+    "aria-labelledby"?: string;
 };
 export type MenuItemProps = {
     children: ReactNode;

package/dist/components/overlay/Menu/Menu.js

@@ -21,21 +21,21 @@ var f = s.createContext({
 	let e = s.useContext(f);
 	if (!e) throw Error("Menu sub-components must be used within a Menu");
 	return e;
-}, m = ({ children: n, className: r, asChild: i = !1, mode: a = "vertical", defaultOpenKeys: d = [] }) => {
-	let [p, m] = c(new Set(d)), [h, g] = c(0), _ = s.useRef(0);
+}, m = ({ children: n, className: r, asChild: i = !1, mode: a = "vertical", defaultOpenKeys: d = [], "aria-label": p, "aria-labelledby": m }) => {
+	let [h, g] = c(new Set(d)), [_, v] = c(0), y = s.useRef(0);
 	s.useEffect(() => {
-		_.current = 0;
+		y.current = 0;
 	});
-	let v = () => {
-		let e = _.current;
-		return _.current += 1, e;
-	}, y = (e) => {
-		m((t) => {
+	let b = () => {
+		let e = y.current;
+		return y.current += 1, e;
+	}, x = (e) => {
+		g((t) => {
 			let n = new Set(t);
 			return n.has(e) ? n.delete(e) : n.add(e), n;
 		});
-	}, b = s.useRef(null), x = (e) => {
-		let t = Array.from(b.current?.querySelectorAll("[role=\"menuitem\"]:not([aria-disabled=\"true\"])") || []), n = t.indexOf(document.activeElement);
+	}, S = s.useRef(null), C = (e) => {
+		let t = Array.from(S.current?.querySelectorAll("[role=\"menuitem\"]:not([aria-disabled=\"true\"])") || []), n = t.indexOf(document.activeElement);
 		if (n !== -1) {
 			if (a === "vertical" || a === "inline") {
 				if (e.key === "ArrowDown") e.preventDefault(), t[(n + 1) % t.length]?.focus();
@@ -55,24 +55,26 @@ var f = s.createContext({
 					r.getAttribute("aria-haspopup") === "true" && r.getAttribute("aria-expanded") === "false" && (e.preventDefault(), r.click());
 				}
 			}
-			e.key === "Home" ? (e.preventDefault(), g(0), t[0]?.focus()) : e.key === "End" && (e.preventDefault(), g(t.length - 1), t[t.length - 1]?.focus());
+			e.key === "Home" ? (e.preventDefault(), v(0), t[0]?.focus()) : e.key === "End" && (e.preventDefault(), v(t.length - 1), t[t.length - 1]?.focus());
 		}
-	}, S = i ? e : "ul";
+	}, w = i ? e : "ul";
 	return /* @__PURE__ */ u(f.Provider, {
 		value: {
-			expandedItems: p,
-			toggleItem: y,
-			containerRef: b,
+			expandedItems: h,
+			toggleItem: x,
+			containerRef: S,
 			mode: a,
-			focusedIndex: h,
-			setFocusedIndex: g,
-			registerItem: v
+			focusedIndex: _,
+			setFocusedIndex: v,
+			registerItem: b
 		},
-		children: /* @__PURE__ */ u(S, {
-			ref: b,
+		children: /* @__PURE__ */ u(w, {
+			ref: S,
 			className: l("wim-menu", o.root, o[a], r),
 			role: "menu",
-			onKeyDown: x,
+			"aria-label": m ? void 0 : p,
+			"aria-labelledby": m,
+			onKeyDown: C,
 			children: /* @__PURE__ */ u(t, { children: n })
 		})
 	});

package/dist/llms-full.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.58.1 — 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.60.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
 
@@ -1075,6 +1075,8 @@ so the unit does not have to be repeated in the label.
     - `size: Extract<ComponentSize, "sm" | "md" | "lg">` = "md" — Size of the button
     - `className: string` — Additional class names
     - `aria-label: string` — Accessible label for the button
+    - `aria-labelledby: string` — ID of the element that labels the button. Takes precedence over `aria-label`.
+    - `aria-describedby: string` — ID of the element that describes the button.
     - `copyLabel: string` — Tooltip label before copying
     - `copiedLabel: string` — Tooltip label after copying
     - `asChild: boolean` = false — Whether to render as a child element.
@@ -1178,6 +1180,9 @@ them. Leave it undefined to let the area track its own selection.
     - `required: boolean` — Whether to show the required indicator
     - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
     - `size: InteractiveAreaProps["size"]` = "md" — Size of the drop area
+    - `aria-label: string` — Accessible name for the drop area when no visible `label` is provided.
+    - `aria-labelledby: string` — ID of the element that labels the drop area when no visible `label` is provided.
+    - `aria-describedby: string` — ID of the element that describes the drop area. Announced together with the error message.
 - **FieldError** — Validation messages
     - `content: string` (required) — Error message text
     - `className: string` — Additional class names
@@ -1225,6 +1230,9 @@ it undefined to let the field track its own selection.
     - `error: string` — Error message
     - `required: boolean` — Whether to show the required indicator
     - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
+    - `aria-label: string` — Accessible name for the choose-file button when no visible `label` is provided.
+    - `aria-labelledby: string` — ID of the element that labels the choose-file button when no visible `label` is provided.
+    - `aria-describedby: string` — ID of the element that describes the choose-file button. Announced together with the error message.
 - **FloatButton** — Floating action buttons
     - `asChild: boolean` = false — If true, the button will be rendered as its child, merging its props onto that child.
     - `iconName: "CircleIcon" | "SquareIcon" | "LoadingIcon" | "ExternalLinkIcon" | "ArrowUpIcon" | string` = "CircleIcon" — Icon name from the library
@@ -1507,6 +1515,9 @@ so the unit does not have to be repeated in the label.
     - `className: string` — Additional class name
     - `id: string` — Unique ID for the component
     - `labels: QueryBuilderLabels` = {} — Labels for internationalization
+    - `aria-label: string` — Accessible name for the query builder region. Takes precedence over `labels.regionAriaLabel`.
+    - `aria-labelledby: string` — ID of the element that labels the query builder region. Takes precedence over `aria-label`.
+    - `aria-describedby: string` — ID of the element that describes the query builder region.
 - **Radio** — Single choice
     - `asChild: boolean` = false — Whether to render as a child element.
     - `children: React.ReactNode` — Label content rendered next to the radio
@@ -1692,6 +1703,8 @@ so the unit does not have to be repeated in the label.
     - `required: boolean` — Whether to show the required indicator
     - `layout: "vertical" | "horizontal"` = "vertical" — Layout direction of label and field
     - `canvasAriaLabel: string` — Aria label for the canvas
+    - `aria-label: string` — Accessible name for the canvas when no visible `label` is provided. Takes precedence over `canvasAriaLabel`.
+    - `aria-labelledby: string` — ID of the element that labels the canvas when no visible `label` is provided.
 - **Slider** — An input to capture a numeric value from a specified range by dragging a knob
     - `value: number` — Current value (controlled)
     - `defaultValue: number` = 0 — Default value (uncontrolled)
@@ -1990,6 +2003,8 @@ origin while the card it was meant to cover was 1248x75.
     - `onClose: (id?: string) => void` — Callback when notification is closed
     - `closable: boolean` = true — Whether to show close button
     - `className: string` — Additional class name
+    - `aria-label: string` — Accessible name for the notification.
+    - `aria-labelledby: string` — ID of the element that labels the notification. Takes precedence over `aria-label`.
 - **Progress** — Progress bar
   - ⚠️ Not the same as elsewhere: Material's "Progress Indicator" covers indeterminate spinners as well. WIM's `Progress` is determinate and linear only — for the indeterminate case use `Spinner`.
     - `value: number` = 0 — Current value of the progress bar.
@@ -2103,6 +2118,8 @@ follows the theme and never needs a hand-mixed colour.
 @default true
     - `onClose: (id?: string) => void` — Called with the toast id when the toast is closed.
     - `className: string` — Additional CSS class name.
+    - `aria-label: string` — Accessible name for the toast.
+    - `aria-labelledby: string` — ID of the element that labels the toast. Takes precedence over `aria-label`.
 - **Tour** — Sequential guided walkthroughs to onboard users or highlight features
     - `steps: TourStep[]` (required) — Steps of the tour. Each step targets an element via a CSS selector.
     - `open: boolean` (required) — Whether the tour is shown.
@@ -2134,6 +2151,8 @@ follows the theme and never needs a hand-mixed colour.
     - `className: string` — Additional class names
     - `style: React.CSSProperties` — Style attribute
     - `aria-label: string` — Accessible label for the button
+    - `aria-labelledby: string` — ID of the element that labels the button. Takes precedence over `aria-label`.
+    - `aria-describedby: string` — ID of the element that describes the button.
     - `asChild: boolean` = false — Whether to render as a child element.
 - **Breadcrumb** — Location trace (aka Path Bar, Path Control)
     - `items: BreadcrumbItem[]` (required) — Items to display, from the root to the current page.
@@ -2209,6 +2228,8 @@ Useful for URL-based pagination (e.g. wrap with a Link via PaginationPage asChil
     - `showTotal: (total: number, range: [number, number]) => React.ReactNode` — Function to display the total count
     - `showQuickJumper: boolean` = false — Whether to show quick jumper
     - `labels: { prevPage?: string; nextPage?: string; pageAriaLabel?: (page: number) => string; itemsPerPage?: string; goTo?: string; go?: string; pageSizeAriaLabel?: string; jumpToPageAriaLabel?: string; navAriaLabel?: string; totalLabel?: string; }` = {} — Labels for internationalization
+    - `aria-label: string` — Accessible name for the navigation landmark. Takes precedence over `labels.navAriaLabel`.
+    - `aria-labelledby: string` — ID of the element that labels the navigation landmark. Takes precedence over `aria-label`.
 - **SpeedDial** — Floating action button that expands sub-actions on hover or click.
     - `actions: SpeedDialAction[]` (required) — Actions to display when SpeedDial is open
     - `icon: keyof typeof ALL_ICONS` = "PlusIcon" — Icon name for the main button when closed
@@ -2466,6 +2487,8 @@ drops secondary text below the AA contrast floor.
     - `infiniteScroll: { hasMore: boolean; onLoadMore: () => void; threshold?: number; }` — Infinite-scroll configuration for dynamic loading
     - `className: string` — Additional class names
     - `ariaLabel: string` — Accessibility label for the grid
+    - `aria-label: string` — Accessible name for the grid. Takes precedence over `ariaLabel`.
+    - `aria-labelledby: string` — ID of the element that labels the grid. Takes precedence over `aria-label`.
 - **DescriptionList** — Key-value pairs
     - `children: React.ReactNode` (required) — DescriptionListItem elements
     - `className: string` — Additional class names
@@ -2490,6 +2513,8 @@ in; use `"center"` only when the empty state is the only thing in its region.
 - left: title and description on the left, accordion on the right (desktop and up).
     - `accordionProps: Omit<AccordionProps, "children">` — Props passed to the inner Accordion component.
     - `className: string` — Additional class names.
+    - `aria-label: string` — Accessible name for the section. A named section is exposed as a region landmark.
+    - `aria-labelledby: string` — ID of the element that labels the section. Takes precedence over `aria-label`.
 - **InfiniteScroll** — Infinite scroll control
     - `children: React.ReactNode` (required) — Content to display.
     - `hasMore: boolean` = false — Whether there is more data to load.
@@ -2773,6 +2798,8 @@ anything is measured; long text is truncated and read in full by assistive techn
     - `virtualThreshold: number` = 100 — Node count threshold at which virtualization kicks in.
     - `labels: { searchPlaceholder?: string; searchAriaLabel?: string; expandLabel?: (label: string) => string; collapseLabel?: (label: string) => string; treeAriaLabel?: string; }` = {} — Labels for internationalization
     - `labelId: string` — Accessibility label ID
+    - `aria-label: string` — Accessible name for the tree. Takes precedence over `labels.treeAriaLabel`.
+    - `aria-labelledby: string` — ID of the element that labels the tree. Takes precedence over `aria-label`.
     - `styles: { root?: string; item?: string; search?: string; searchInput?: string; labelContainer?: string; iconWrapper?: string; expandBtn?: string; checkbox?: string; icon?: string; }` — Custom styles for internal parts
 - **VirtualList** — Efficiently renders large lists by virtualizing off-screen items
     - `items: T[]` (required) — Array of items to display
@@ -2785,6 +2812,7 @@ anything is measured; long text is truncated and read in full by assistive techn
     - `role: string` = "list" — Role of the whole list (for accessibility)
     - `aria-label: string` — Accessible label
     - `aria-labelledby: string` — ID of the element that labels the list
+    - `aria-describedby: string` — ID of the element that describes the list
 
 ### overlay — `import { … } from "wimui/overlay"`
 
@@ -2855,6 +2883,8 @@ dismissed by an outside click or Escape.
     - `mode: "vertical" | "horizontal" | "inline"` = "vertical" — Mode of the menu
     - `defaultSelectedKeys: string[]` — Default selected keys
     - `defaultOpenKeys: string[]` = [] — Default opened submenu keys
+    - `aria-label: string` — Accessible name for the menu.
+    - `aria-labelledby: string` — ID of the element that labels the menu. Takes precedence over `aria-label`.
 - **Popconfirm** — Confirmation overlay
     - `title: ReactNode` (required) — The title of the confirmation box
     - `description: ReactNode` — The description of the confirmation box
@@ -3470,6 +3500,8 @@ written in the markdown. Default `"2xl"` keeps the historical mapping
     - `index: number` — Numeric citation index shown as a badge (e.g. 1, 2, 3)
     - `domain: string` — Domain label shown below the title (auto-derived from url when omitted)
     - `className: string` — Additional CSS class
+    - `aria-label: string` — Accessible name for the citation.
+    - `aria-labelledby: string` — ID of the element that labels the citation. Takes precedence over `aria-label`.
 - **StreamingText** — Renders text with a typewriter-like animation, ideal for AI chat responses.
     - `content: string` (required) — The markdown text content to render
     - `isStreaming: boolean` = false — When true, a blinking cursor is shown at the end of the content

package/dist/llms.txt

@@ -4,7 +4,7 @@
 
 ## What this is
 
-**wimui** v0.58.1 — 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.60.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