asheeui 0.7.0 → 1.0.0

package/dist/components/menu/menu-navigation.d.ts

@@ -0,0 +1,38 @@
+import { MenuOption } from './menu-config';
+/**
+ * Positions of the options that can be reached by keyboard navigation.
+ *
+ * @param options - The rendered option list, in display order.
+ * @returns The indexes of the options that are not disabled.
+ */
+export declare function enabledOptionIndexes(options: MenuOption[]): number[];
+/**
+ * Resolves the option that a movement key lands on.
+ *
+ * Movement starts at the first option when nothing is current yet: forward
+ * movement lands on the first enabled option and backward movement on the last
+ * one. Once an option is current, movement wraps around the ends of the list.
+ *
+ * @param options - The rendered option list, in display order.
+ * @param currentIndex - The current option, or `null` when none is current.
+ * @param delta - Movement direction: `1` forward, `-1` backward.
+ * @returns The index to make current, or `null` when no option is reachable.
+ */
+export declare function nextOptionIndex(options: MenuOption[], currentIndex: number | null, delta: number): number | null;
+/**
+ * Resolves the first or last reachable option.
+ *
+ * @param options - The rendered option list, in display order.
+ * @param edge - Which end of the list to resolve.
+ * @returns The index to make current, or `null` when no option is reachable.
+ */
+export declare function edgeOptionIndex(options: MenuOption[], edge: "first" | "last"): number | null;
+/**
+ * Resolves the first reachable option whose label starts with `prefix`.
+ *
+ * @param options - The rendered option list, in display order.
+ * @param prefix - Characters typed so far, matched case insensitively.
+ * @returns The index to make current, or `null` when nothing matches.
+ */
+export declare function matchingOptionIndex(options: MenuOption[], prefix: string): number | null;
+//# sourceMappingURL=menu-navigation.d.ts.map

package/dist/components/menu/menu-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-navigation.d.ts","sourceRoot":"","sources":["../../../src/components/menu/menu-navigation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAKpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EAAE,EACrB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAaf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAMf"}

package/dist/components/menu/menu-navigation.js

@@ -0,0 +1,20 @@
+"use client";
+//#region src/components/menu/menu-navigation.ts
+function e(e) {
+	return e.reduce((e, t, n) => (t.disabled || e.push(n), e), []);
+}
+function t(t, n, r) {
+	let i = e(t);
+	if (i.length === 0) return null;
+	let a = n === null ? -1 : i.indexOf(n);
+	return i[a === -1 ? r > 0 ? 0 : i.length - 1 : (a + r + i.length) % i.length];
+}
+function n(t, n) {
+	let r = e(t);
+	return r.length === 0 ? null : n === "first" ? r[0] : r[r.length - 1];
+}
+function r(t, n) {
+	return e(t).find((e) => t[e].label.toLowerCase().startsWith(n.toLowerCase())) ?? null;
+}
+//#endregion
+export { n as edgeOptionIndex, e as enabledOptionIndexes, r as matchingOptionIndex, t as nextOptionIndex };

package/dist/components/{select-menu/use-select-floating.d.ts → menu/use-menu-floating.d.ts}

@@ -1,10 +1,10 @@
 import { UseInteractionsReturn, Placement, useFloating } from '@floating-ui/react';
 /**
- * Configuration options for the useSelectFloating hook.
+ * Configuration options for the useMenuFloating hook.
  * Controls the floating element's behavior, positioning, size, and
  * interaction wiring (click-to-open, dismiss, and ARIA role).
  */
-export interface UseSelectFloatingProps {
+export interface UseMenuFloatingProps {
     /**
      * Whether the floating element is open.
      * Controls visibility and triggers positioning calculations.
@@ -52,8 +52,8 @@ export interface UseSelectFloatingProps {
     matchReferenceWidth?: boolean;
     /**
      * ARIA role applied to the floating element via useRole.
-     * "listbox" fits Select/MultiSelect/Autocomplete; a component like
-     * DatePicker reusing this hook can pass "dialog" instead.
+     * "listbox" fits Dropmenu/MultiSelect/Autocomplete; a component like
+     * Calendar reusing this hook can pass "dialog" instead.
      *
      * @default "listbox"
      */
@@ -69,11 +69,11 @@ export interface UseSelectFloatingProps {
     zIndex?: number;
 }
 /**
- * Return value of useSelectFloating. Combines Floating UI's positioning
+ * Return value of useMenuFloating. Combines Floating UI's positioning
  * context with the resolved interaction prop-getters, so consumers don't
  * need to wire useClick/useDismiss/useRole/useInteractions themselves.
  */
-export interface UseSelectFloatingReturn<T extends HTMLElement> {
+export interface UseMenuFloatingReturn<T extends HTMLElement> {
     refs: ReturnType<typeof useFloating<T>>["refs"];
     context: ReturnType<typeof useFloating<T>>["context"];
     floatingStyles: React.CSSProperties;
@@ -109,7 +109,7 @@ export interface UseSelectFloatingReturn<T extends HTMLElement> {
  * @example
  * ```tsx
  * const { refs, context, floatingStyles, getReferenceProps, getFloatingProps } =
- *   useSelectFloating({
+ *   useMenuFloating({
  *     isOpen,
  *     onOpenChange: setIsOpen,
  *     disabled: props.disabled,
@@ -128,7 +128,7 @@ export interface UseSelectFloatingReturn<T extends HTMLElement> {
  * ```
  *
  * @see useFloating - The underlying Floating UI hook.
- * @see Select - The select component that uses this hook.
+ * @see Dropmenu - The select component that uses this hook.
  */
-export declare function useSelectFloating<T extends HTMLElement = HTMLElement>({ isOpen, onOpenChange, disabled, placement, offsetDistance, padding, matchReferenceWidth, role, zIndex, }: UseSelectFloatingProps): UseSelectFloatingReturn<T>;
-//# sourceMappingURL=use-select-floating.d.ts.map
+export declare function useMenuFloating<T extends HTMLElement = HTMLElement>({ isOpen, onOpenChange, disabled, placement, offsetDistance, padding, matchReferenceWidth, role, zIndex, }: UseMenuFloatingProps): UseMenuFloatingReturn<T>;
+//# sourceMappingURL=use-menu-floating.d.ts.map

package/dist/components/menu/use-menu-floating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-menu-floating.d.ts","sourceRoot":"","sources":["../../../src/components/menu/use-menu-floating.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAIL,KAAK,SAAS,EAKd,WAAW,EAGZ,MAAM,oBAAoB,CAAC;AAI5B;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAEnE;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,WAAW;IAC1D,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;IAC9D,gBAAgB,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACnE,MAAM,EACN,YAAY,EACZ,QAAgB,EAChB,SAA0B,EAC1B,cAAkB,EAClB,OAAW,EACX,mBAA0B,EAC1B,IAAgB,EAChB,MAA6B,GAC9B,EAAE,oBAAoB,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAmDjD"}

package/dist/components/{select-menu/use-select-floating.js → menu/use-menu-floating.js}

@@ -3,7 +3,7 @@
 import { ASHEE_LAYER as e } from "../../utils/stacking.js";
 import { useFloatingZIndex as t } from "../../libs/use-floating-z-index.js";
 import { autoUpdate as n, flip as r, offset as i, shift as a, size as o, useClick as s, useDismiss as c, useFloating as l, useInteractions as u, useRole as d } from "@floating-ui/react";
-//#region src/components/select-menu/use-select-floating.ts
+//#region src/components/menu/use-menu-floating.ts
 function f({ isOpen: f, onOpenChange: p, disabled: m = !1, placement: h = "bottom-start", offsetDistance: g = 4, padding: _ = 8, matchReferenceWidth: v = !0, role: y = "listbox", zIndex: b = e.dropdown }) {
 	let x = l({
 		open: f,
@@ -40,4 +40,4 @@ function f({ isOpen: f, onOpenChange: p, disabled: m = !1, placement: h = "botto
 	};
 }
 //#endregion
-export { f as useSelectFloating };
+export { f as useMenuFloating };

package/dist/components/modal/Modal.d.ts

@@ -63,9 +63,14 @@ export interface ModalProps extends BaseModalProps {
  *
  * Modal renders a dialog that appears over the page content with a backdrop.
  * It supports size, position, radius, animation, and behavior options. The
- * component automatically locks body scroll when open, handles Escape key
+ * dialog renders in a portal, locks body scroll while open, handles Escape key
  * dismissal, and supports click-outside-to-close functionality.
  *
+ * While the dialog is open, focus moves into it, cannot leave it, and returns
+ * to the element that was focused before it opened. The dialog element is the
+ * content box, so a consumer names the dialog with the standard `aria-label` or
+ * `aria-labelledby` attribute.
+ *
  * The modal manages its own animation states using a two-phase rendering
  * approach: it renders the modal with an enter animation when opened, and
  * plays an exit animation before removing from the DOM when closed.

package/dist/components/modal/Modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/components/modal/Modal.tsx"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AAUf,OAAO,EAEL,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAGxB,KAAK,cAAc,GAAG,WAAW,GAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EG;AACH,wBAAgB,KAAK,CAAC,EACpB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,EACN,IAAI,EACJ,QAAQ,EAAE,YAAY,EACtB,MAAM,EACN,QAAQ,EAAE,YAAY,EACtB,oBAAoB,EAAE,wBAAwB,EAC9C,aAAa,EAAE,iBAAiB,EAChC,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,sCAkKZ;yBAnLe,KAAK"}
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/components/modal/Modal.tsx"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAYf,OAAO,EAEL,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAGxB,KAAK,cAAc,GAAG,WAAW,GAC/B,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,wBAAgB,KAAK,CAAC,EACpB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,KAAK,EACL,MAAM,EACN,IAAI,EACJ,QAAQ,EAAE,YAAY,EACtB,MAAM,EACN,QAAQ,EAAE,YAAY,EACtB,oBAAoB,EAAE,wBAAwB,EAC9C,aAAa,EAAE,iBAAiB,EAChC,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,EACL,GAAG,KAAK,EACT,EAAE,UAAU,sCAmMZ;yBApNe,KAAK"}

package/dist/components/modal/Modal.js

@@ -2,58 +2,75 @@
 "use client";
 import { cn as e } from "../../utils/cn.js";
 import { ASHEE_GLOBAL_LAYER as t } from "../../utils/stacking.js";
-import { useAsheeConfig as n } from "../../libs/context.js";
-import { RADIUS_CLASS as r } from "../../shared/radius.js";
-import { resolveCascade as i, resolveClassKey as a, resolveRadiusKey as o } from "../../utils/resolve-token.js";
-import { FALLBACK_MODAL_CONFIG as s } from "./modal-config.js";
-import { MODAL_MAX_WIDTH_CLASS as c, MODAL_POSITION_CLASS as l } from "./modal-styles.js";
-import { useEffect as u, useState as d } from "react";
-import { jsx as f, jsxs as p } from "react/jsx-runtime";
+import { RADIUS_CLASS as n } from "../../shared/radius.js";
+import { useAsheeConfig as r } from "../../libs/context.js";
+import { resolveCascade as i, resolveClassKey as a, resolveRadiusKey as ee } from "../../utils/resolve-token.js";
+import { useBodyScrollLock as o } from "../../libs/use-body-scroll-lock.js";
+import { useDialogOverlay as s } from "../../libs/use-dialog-overlay.js";
+import { FALLBACK_MODAL_CONFIG as c } from "./modal-config.js";
+import { MODAL_MAX_WIDTH_CLASS as l, MODAL_POSITION_CLASS as u } from "./modal-styles.js";
+import { useCallback as d, useEffect as f, useRef as p, useState as m } from "react";
+import { jsx as h, jsxs as te } from "react/jsx-runtime";
+import { FloatingFocusManager as g, FloatingPortal as _ } from "@floating-ui/react";
 //#region src/components/modal/Modal.tsx
-function m({ isOpen: m, onClose: h, children: g, width: _, height: v, size: y, position: b, radius: x, animated: S, closeOnBackdropClick: C, closeOnEscape: w, overlay: T, content: E, className: D, style: O, ...k }) {
-	let A = n(), j = A.components?.modal, [M, N] = d(!1), [P, F] = d(m), I = i(y, j?.size, void 0, s.size), L = i(b, j?.position, void 0, s.position), R = i(C, j?.closeOnBackdropClick, void 0, s.closeOnBackdropClick), z = i(w, j?.closeOnEscape, void 0, s.closeOnEscape), B = o(x, j?.radius, A.defaultRadius, s.radius), V = i(S, j?.animated, void 0, s.animated), H = _ ? "" : a(I, c, s.size), U = a(B, r, s.radius), W = l[L] ?? l.center;
-	if (u(() => {
-		if (m) N(!1), F(!0);
-		else if (V) {
-			N(!0);
+function v({ isOpen: v, onClose: y, children: b, width: x, height: S, size: C, position: w, radius: T, animated: E, closeOnBackdropClick: D, closeOnEscape: O, overlay: k, content: A, className: j, style: M, ...N }) {
+	let P = r(), F = P.components?.modal, [I, L] = m(!1), [R, z] = m(v), B = i(C, F?.size, void 0, c.size), V = i(w, F?.position, void 0, c.position), H = i(D, F?.closeOnBackdropClick, void 0, c.closeOnBackdropClick), U = i(O, F?.closeOnEscape, void 0, c.closeOnEscape), W = ee(T, F?.radius, P.defaultRadius, c.radius), G = i(E, F?.animated, void 0, c.animated), { context: K, setDialogRef: q } = s(v), J = p(null), Y = d((e) => {
+		J.current = e, q(e);
+	}, [q]);
+	o(v);
+	let X = x ? "" : a(B, l, c.size), Z = a(W, n, c.radius), Q = u[V] ?? u.center;
+	if (f(() => {
+		if (v) L(!1), z(!0);
+		else if (G) {
+			L(!0);
 			let e = setTimeout(() => {
-				F(!1);
+				z(!1);
 			}, 200);
 			return () => clearTimeout(e);
-		} else F(!1);
-	}, [m, V]), u(() => {
-		if (!m || !z || !h) return;
+		} else z(!1);
+	}, [v, G]), f(() => {
+		if (!v || !U || !y) return;
 		let e = (e) => {
-			e.key === "Escape" && h();
+			e.key === "Escape" && y();
 		};
 		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
 	}, [
-		m,
-		z,
-		h
-	]), !P) return null;
-	let G = () => V ? M ? "animate-backdrop-out" : "animate-backdrop-in" : "";
-	return /* @__PURE__ */ p("div", {
-		role: "dialog",
-		"aria-modal": "true",
-		className: e("fixed inset-0 flex items-center justify-center p-4 sm:p-6 h-screen w-screen scrollbar-hide", G()),
-		style: { zIndex: t.overlay },
-		children: [/* @__PURE__ */ f("button", {
-			type: "button",
-			onClick: R ? h : void 0,
-			className: e("fixed inset-0 bg-background/80 backdrop-blur-xs dark:bg-black/70", T?.className, G())
-		}), /* @__PURE__ */ f("div", {
-			className: e("relative z-10 w-full bg-background text-foreground overflow-y-auto max-h-[90vh]", W, H, U, E?.className, V ? M ? "animate-modal-out" : "animate-modal-in" : "", D),
-			style: {
-				width: _,
-				height: v,
-				...O
-			},
-			...k,
-			children: g
-		})]
-	});
+		v,
+		U,
+		y
+	]), !R) return null;
+	let $ = () => G ? I ? "animate-backdrop-out" : "animate-backdrop-in" : "";
+	return /* @__PURE__ */ h(_, { children: /* @__PURE__ */ h(g, {
+		context: K,
+		modal: !0,
+		initialFocus: J,
+		returnFocus: !0,
+		closeOnFocusOut: !1,
+		children: /* @__PURE__ */ te("div", {
+			className: e("fixed inset-0 flex items-center justify-center p-4 sm:p-6 h-screen w-screen scrollbar-hide", $()),
+			style: { zIndex: t.overlay },
+			children: [/* @__PURE__ */ h("div", {
+				"data-ashee-backdrop": "",
+				"aria-hidden": "true",
+				onClick: H ? y : void 0,
+				className: e("fixed inset-0 bg-background/80 backdrop-blur-xs", k?.className, $())
+			}), /* @__PURE__ */ h("div", {
+				ref: Y,
+				role: "dialog",
+				"aria-modal": "true",
+				tabIndex: -1,
+				className: e("relative z-10 w-full bg-background text-foreground overflow-y-auto max-h-[90vh] outline-none", Q, X, Z, A?.className, G ? I ? "animate-modal-out" : "animate-modal-in" : "", j),
+				style: {
+					width: x,
+					height: S,
+					...M
+				},
+				...N,
+				children: b
+			})]
+		})
+	}) });
 }
-m.displayName = "Modal";
+v.displayName = "Modal";
 //#endregion
-export { m as Modal };
+export { v as Modal };

package/dist/components/multi-select/MultiSelect.d.ts

@@ -1,7 +1,7 @@
 import { ReactNode } from 'react';
 import { InputProps } from '../input/Input';
-import { SelectMenuOption } from '../select-menu';
-import { MenuProps } from '../select-menu/SelectMenu';
+import { MenuOption } from '../menu';
+import { MenuProps } from '../menu/Menu';
 import { MultiSelectChipConfig, MultiSelectConfig } from './multi-select-config';
 /**
  * Field-related props that MultiSelect inherits from Input.
@@ -32,10 +32,11 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
      * Available options to select from.
      * Each option must have a label and a unique value.
      */
-    options: SelectMenuOption[];
+    options: MenuOption[];
     /**
      * Controlled selected values.
-     * Array of selected option values.
+     * Array of selected option values. When omitted, the component keeps the
+     * accumulated selection itself and reports every change through `onChange`.
      */
     value?: (string | number)[];
     /**
@@ -46,7 +47,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
     /**
      * Label shown in the trigger when no items are selected.
      *
-     * @default "Select Options..."
+     * @default "Dropmenu Options..."
      */
     InputLabel?: string;
     /**
@@ -76,7 +77,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
      * Custom chip options for legacy or external control.
      * When provided, this overrides the derived chips from value.
      */
-    chipOptions?: SelectMenuOption[];
+    chipOptions?: MenuOption[];
     /**
      * Custom handler for removing a chip.
      * For legacy or external control patterns.
@@ -86,7 +87,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
      * Custom handler for adding a chip.
      * For legacy or external control patterns.
      */
-    handleAddChip?: (item: SelectMenuOption) => void;
+    handleAddChip?: (item: MenuOption) => void;
     /**
      * Label shown above the chip list.
      */
@@ -147,7 +148,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
  * @param props.options - Available options to select from.
  * @param props.value - Controlled selected values.
  * @param props.onChange - Callback fired when selection changes.
- * @param props.InputLabel - Label shown in trigger. Defaults to "Select Options...".
+ * @param props.InputLabel - Label shown in trigger. Defaults to "Dropmenu Options...".
  * @param props.isSearch - Whether search is enabled. Defaults to true.
  * @param props.searchPlaceholder - Search placeholder. Defaults to "Search...".
  * @param props.searchInputName - Name attribute for the search input. Defaults to "multiselect-search".
@@ -195,7 +196,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
  *       options={options}
  *       value={values}
  *       onChange={setValues}
- *       label="Select Frameworks"
+ *       label="Dropmenu Frameworks"
  *       InputLabel="Choose frameworks..."
  *     />
  *   );
@@ -224,7 +225,7 @@ export interface MultiSelectProps extends MultiSelectFieldProps, MultiSelectCont
  * @see MultiSelectConfig - The configuration type for component defaults.
  * @see Input - The input component that provides field capabilities.
  * @see Button - The button component used as the trigger.
- * @see SelectMenu - The dropdown menu component.
+ * @see Menu - The dropdown menu component.
  * @see Chip - The chip component for selected items.
  * @see FieldShell - The wrapper component for label and validation.
  */

package/dist/components/multi-select/MultiSelect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/multi-select/MultiSelect.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,KAAK,gBAAgB,EAAqB,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAU/B;;;GAGG;AACH,KAAK,qBAAqB,GAAG,IAAI,CAC/B,UAAU,EACR,OAAO,GACP,aAAa,GACb,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,IAAI,GACJ,OAAO,CACV,CAAC;AAEF;;GAEG;AACH,KAAK,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBACf,SAAQ,qBAAqB,EAC3B,uBAAuB,EACvB,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;OAGG;IACH,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAEjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwGG;AACH,eAAO,MAAM,WAAW,gHAwYvB,CAAC"}
+{"version":3,"file":"MultiSelect.d.ts","sourceRoot":"","sources":["../../../src/components/multi-select/MultiSelect.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,KAAK,SAAS,EAAQ,MAAM,cAAc,CAAC;AACpD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAU/B;;;GAGG;AACH,KAAK,qBAAqB,GAAG,IAAI,CAC/B,UAAU,EACR,OAAO,GACP,aAAa,GACb,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,IAAI,GACJ,OAAO,CACV,CAAC;AAEF;;GAEG;AACH,KAAK,uBAAuB,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBACf,SAAQ,qBAAqB,EAC3B,uBAAuB,EACvB,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC;IAEjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAE3B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwGG;AACH,eAAO,MAAM,WAAW,gHAybvB,CAAC"}